Design
P1
Flujos de Usuario
Para qué

Rutas completas del usuario a través del producto, incluyendo happy paths, error paths y priorización.

Audiencia

Diseño, ingeniería y QA.

Flow: Alert System

Notificaciones Inteligentes de Cambios Importantes

JTBD: “Quiero saber si algo importante cambió”
Actor: Usuario (cualquier fase)
Trigger: Engine detecta cambio, RCV, o fecha importante
Priority: P1 (High) — Safety + Engagement
Duration: Alert → Resolución


Alert Types & Triggers

Tipo 1: Biomarcador Fuera de Rango

Trigger: Nuevo resultado de lab cargado, está fuera de rango
Severidad: LOW | MEDIUM | HIGH | CRITICAL

Ejemplo:
  Glucosa: 126 mg/dL (rango normal: 70-100)
  Severidad: MEDIUM (revisar)
  
Alert:
  Título: "Tu glucosa subió"
  Descripción: "126 mg/dL, un poco alta. Típicamente está aquí..."
  CTA: [Ver Detalle] [Chat Health Coach]

Tipo 2: RCV Detectado (Cambio Real)

Trigger: Comparación entre mediciones, cambio > RCV
Severidad: MEDIUM

Ejemplo:
  Colesterol: 245 → 198 (-19%)
  RCV threshold: 15%
  Cambio es REAL (no variación biológica)
  
Alert:
  Título: "¡Tu colesterol mejoró significativamente!"
  Descripción: "Cambio de 19% detectado. Este cambio es REAL."
  CTA: [Celebrar] [Ver Detalle]

Tipo 3: Adherencia Baja

Trigger: <50% check-ins en última semana
Severidad: MEDIUM

Alert:
  Título: "Rompiste tu streak, vuelve"
  Descripción: "Llevabas 18 días, el plan funciona mejor con constancia"
  CTA: [Hacer Check-in Ahora]

Tipo 4: Cita Próxima

Trigger: Cita agendada, 7 días antes
Severidad: LOW

Alert:
  Título: "Cita en 7 días"
  Descripción: "Laboratorio de Control, 15 Ene 8:00am"
  CTA: [Ver Detalles] [Recordatorio SMS]

Tipo 5: Recomendación Ajuste

Trigger: Health Coach IA detecta oportunidad
Severidad: LOW

Alert:
  Título: "Cambio recomendado"
  Descripción: "Tu nutrición está 20% abajo. Más proteína podría ayudar"
  CTA: [Ver Recomendación] [Chat]

Alert Journey

Recorrido de una alerta desde creacion hasta resolucion


Alert UI Patterns

En Dashboard (Card o Banner)


  NUEVAS ALERTAS (2)                    ← Click para expandir

                                          
 1⃣ Tu glucosa subió                    
    126 mg/dL (rango: 70-100)            
    [VER DETALLE] [DESCARTAR]            
                                          
 2⃣ Rompiste tu streak                  
    Volvía a estar en 18 días             
    [HACER CHECK-IN] [DESCARTAR]         
                                          
 [Ver todas las alertas histórico]        

En Notificación (Push/Email)

 PUSH NOTIFICATION:
Title: "Tu glucosa subió"
Body: "126 mg/dL, un poco alta. Tap para ver detalles"
Action: [VER] [IGNORAR]

 EMAIL:
From: alerts@aden.run
Subject: Alerta: Tu glucosa subió

Hola María,

Tus últimos exámenes muestran:
Glucosa: 126 mg/dL (rango normal: 70-100)

Esto no es crítico, pero conviene monitorearlo.

[VER DETALLE EN APP] [CHAT CON HEALTH COACH]

---
Gestiona tus alertas: [AJUSTES → NOTIFICACIONES]

Detail View (Cuando Usuario Abre)


 ← [Atrás]           Alerta: Tu Glucosa 

                                          
  Tu Glucosa Subió                     ← Titular
 126 mg/dL, un poco elevada               ← Descripción
                                          
  CONTEXTO     
 Rango óptimo: 70-100 mg/dL               
 Tu valor: 126 mg/dL                      
 Cambio vs. 30 días: +12 mg/dL (+10%)    
                                          
  POR QUÉ      
 Causas comunes:                          
 • Dieta alta en carbohidratos            
 • Estrés                                 
 • Sedentarismo                           
                                          
  QUÉ HACER     
 1. Reducir azúcares refinados            
 2. Aumentar actividad física 20-30 min   
 3. Re-medirse en 30 días                 
 4. Si sigue alto, consultar médico      
                                          
  TENDENCIA     
 [Gráfico: últimos 90 días, rojo]        
                                          
 [ VER DETALLE COMPLETO]               
 [ CHAT CON HEALTH COACH]              
 [ MARCAR COMO RESUELTA]                
                                          


Notification Frequency Rules

Critical Alerts:

  • Inmediato (push + email + SMS)
  • Repetir cada 2 horas si no abierta
  • No silenciar

High Alerts:

  • Push inmediato
  • Email 2 horas después
  • Si no abierta en 24h, SMS

Medium Alerts:

  • Push solo
  • Máximo 2 por día (agregar si hay múltiples)

Low Alerts:

  • Solo en dashboard
  • Sin notificación

Constraint: Máximo 1-2 notificaciones por día (consolidar si hay múltiples)


User Preferences

AJUSTES → NOTIFICACIONES

 Biomarcadores fuera de rango
    Critical
    High
    Medium (desactivar si spam)

 RCV Detectado (cambios buenos)

 Adherencia baja (streak roto)

 Citas próximas

 Recomendaciones

CANALES:
 Push (móvil)
 Email
 SMS (si disponible)

HORARIO:
No notificaciones entre: 22:00 - 08:00

Success Metrics

Métrica Meta
Alert Open Rate (CRITICAL) >90%
Alert Open Rate (HIGH) >70%
Alert Open Rate (MEDIUM) >40%
Action Taken After Alert >50%
False Positive Rate <5%
User Satisfaction (Alert Usefulness) >7/10 NPS

Implementation Notes

Deduplication: No 2 alertas idénticas en 24h
Grouping: Si >3 alerts tipo “biomarcador”, agrupar
Timing: No enviar push a las 3am
Escalation: CRITICAL → Sugerir call con médico real
Privacy: Nunca valores sensibles en notificación (solo en app)
Fallback: Si IA falla, mostrar engine output directo


Próximo: navigation — Information Architecture