ADEN App — Flows, Screens, Features y States

Versión: 2.0 Fecha: 2026-04-05 Total: 121 pantallas, 19 flows Prototipo web: apps/prototypes/src/pages/ Formato: Flow → Screens → Features → States

Estado de cobertura

Flow 1: Primera Impresión

Objetivo: El usuario entiende ADEN en 30 segundos. Trigger: Primera apertura de la app. Personas: Todas. Prioridad: P0. Métrica: >60% avanza al registro.

Screen: Splash

Prototipo: No existe

• Feature: Mostrar logo aden con loading
• State: Loading → Loaded → Redirect a intro o login

Screen: Intro — Qué es ADEN

Prototipo: No existe

• Feature: Slide con propuesta de valor
• Feature: Dot indicators de progreso (1 de 3)
• Feature: Saltar intro
• State: Primera vez (muestra) | Returning user (skip)

Screen: Intro — Qué analizamos

Prototipo: No existe

• Feature: Slide “72+ biomarcadores”
• Feature: Avanzar/retroceder
• State: Default

Screen: Intro — Qué recibes

Prototipo: No existe

• Feature: Slide “Plan personalizado”
• Feature: CTA “Crear cuenta” / “Ya tengo cuenta”
• State: Default

Flow 2: Autenticación

Objetivo: Acceso seguro sin contraseñas. Trigger: CTA desde intro o reapertura. Personas: Todas. Pedro necesita Face ID. Prioridad: P0. Métrica: <2 min login, >95% éxito.

Screen: Login

Prototipo: auth/index.astro

• Feature: Input email
• Feature: Enviar código de acceso
• Feature: Face ID / Touch ID
• Feature: Link a registro
• State: Default | Enviando código | Error email inválido | Face ID no disponible

Screen: Registro

Prototipo: auth/register.astro

• Feature: Input nombre + email
• Feature: Enviar código de verificación
• Feature: Link a login existente
• State: Default | Enviando | Error email ya existe | Error validación

Screen: Código Enviado

Prototipo: No existe (reemplaza forgot-password)

• Feature: Input 6 dígitos
• Feature: Reenviar código
• Feature: Timer expiración 15 min
• State: Esperando input | Verificando | Código incorrecto | Código expirado | Éxito

Screen: Verificar Email

Prototipo: auth/verify-email.astro

• Feature: Estado de verificación
• Feature: Reenviar enlace
• Feature: Abrir app de correo
• State: Pendiente | Verificado | Error | Spam hint

Screen: MFA Setup

Prototipo: No existe

• Feature: Elegir método (App/SMS/Correo)
• Feature: Mostrar QR para authenticator
• Feature: Input código de verificación
• State: Selección método | Escaneando QR | Verificando | Activado | Error

Screen: Política de Privacidad

Prototipo: auth/privacy.astro

• Feature: Texto scrollable por secciones
• Feature: Aceptar
• State: Default | Aceptado

Screen: Términos de Servicio

Prototipo: auth/terms.astro

• Feature: Texto scrollable por secciones
• Feature: Aceptar
• State: Default | Aceptado

Flow 3: Adquisición

Objetivo: Elegir plan y pagar, o aceptar invitación. Trigger: Post-registro o link de invitación. Personas: María (paga), Roberto (trial/empresa). Prioridad: P0. Métrica: >40% conversión registro→pago.

Screen: Selección de Plan

Prototipo: No existe

• Feature: Comparar 3 planes (Esencial $99k, Control Total $199k, Premium $349k)
• Feature: Badge “Popular” en plan recomendado
• Feature: Ver detalle de cada plan
• State: Default | Plan seleccionado

Screen: Checkout

Prototipo: No existe

• Feature: Elegir método de pago (tarjeta/PSE/Nequi)
• Feature: Input datos de tarjeta
• Feature: Ver resumen del pedido
• Feature: Pagar
• State: Default | Procesando pago | Pago exitoso | Pago rechazado | Error de red

Screen: Invitación Corporativa

Prototipo: invitación.astro (root, no en paciente)

• Feature: Ver plan cubierto por empresa
• Feature: Ver quién invitó
• Feature: Aceptar / rechazar
• State: Invitación válida | Invitación expirada | Ya aceptada

Screen: Prueba Gratuita

Prototipo: No existe

• Feature: Probar 7 días sin tarjeta
• Feature: Ver qué incluye la prueba
• Feature: Link a planes si quiere pagar directo
• State: Default | Trial activo | Trial expirado

Flow 4: Onboarding Clínico

Objetivo: Recopilar datos para calibrar el engine. <5 min. Trigger: Post-pago. Personas: Todas. Pedro con ayuda de Carolina. Prioridad: P0. Métrica: >90% completion, <5 min.

Screen: Welcome

Prototipo: onboarding/index.astro

• Feature: 3 value props animados
• Feature: Tiempo estimado “5 minutos”
• Feature: CTA comenzar
• State: Primera vez | Retorno (sin animación)

Screen: Datos Personales

Prototipo: onboarding/step1.astro

• Feature: Inputs nombre, fecha nacimiento, peso, sexo
• Feature: Dropdown EPS, ciudad
• Feature: Edad auto-calculada
• Feature: Medicina prepagada (condicional)
• State: Default | Validando | Error campo requerido | Edad < 18 (oculta estado civil)

Screen: Historial Médico

Prototipo: onboarding/step2.astro

• Feature: Checkboxes condiciones médicas
• Feature: Checkboxes antecedentes familiares
• Feature: Input medicamentos actuales
• Feature: Input alergias
• Feature: Checkboxes sustancias
• State: Default | “Ninguna” seleccionado (desmarca otros)

Screen: Estilo de Vida

Prototipo: onboarding/step3.astro

• Feature: Pills sueño, ejercicio, alcohol, dieta, estrés
• Feature: Checkboxes objetivos de salud
• Feature: Textarea notas opcionales
• State: Default | Múltiples seleccionados

Screen: Panel de Análisis

Prototipo: onboarding/step4.astro

• Feature: Tabs por objetivo (Control Total, Energía, Rendimiento, etc.)
• Feature: Categorías con toggle (10 categorías)
• Feature: Accordion para ver biomarcadores por categoría
• Feature: Contador “X de 10 categorías”
• State: Tab seleccionado | Personalizado (manual) | Todas seleccionadas

Screen: Agendar Cita

Prototipo: onboarding/step5.astro

• Feature: Selector de clínica
• Feature: Date picker con sugerencias (Mañana, En 3 días, Próxima semana)
• Feature: Slots de horarios disponibles
• Feature: Dirección para kit a domicilio
• Feature: Upload resultados previos (opcional)
• State: Buscando slots | Slots disponibles | Sin disponibilidad | Slot seleccionado | Alerta ayuno

Screen: Confirmación

Prototipo: onboarding/step6.astro

• Feature: Timeline de 6 próximos pasos
• Feature: Tarjeta de cita agendada
• Feature: Recordatorio de ayuno
• Feature: CTA “Ir a mi perfil”
• State: Default | Sin cita (solo perfil)

Flow 5: Post-Onboarding

Objetivo: Mantener informado al usuario mientras espera resultados. Trigger: Onboarding completado, labs pendientes. Personas: María (sube labs), Pedro (espera). Prioridad: P1. Métrica: <5% abandono en espera.

Screen: Perfil Pendiente

Prototipo: onboarding/perfil-pendiente.astro

• Feature: Estado del proceso (esperando exámenes)
• Feature: Próxima cita con dirección
• Feature: Reagendar / ver en mapa
• Feature: Recordatorio activado
• Feature: Tracking del kit (enviado, en camino)
• State: Esperando cita | Kit enviado | Labs en proceso | Resultados listos

Screen: Upload Resultados

Prototipo: No existe

• Feature: Upload PDF/foto desde galería
• Feature: Cámara para fotografiar resultado
• Feature: Lista de archivos subidos con estados
• Feature: Formatos aceptados y límite de tamaño
• State: Vacío | Subiendo | Procesando (OCR) | Procesado | Error formato

Screen: Processing

Prototipo: No existe

• Feature: Estado de procesamiento OCR en 3 pasos
• Feature: Lista de archivos recibidos
• Feature: Notificación al terminar
• State: En cola | Extrayendo datos | Validando | Analizando | Completado | Error OCR

Flow 6: Dashboard

Objetivo: Ver estado de salud de un vistazo en <5 segundos. Trigger: Login exitoso, apertura diaria. Personas: Todas. Pedro solo ve el número grande. Prioridad: P0. Métrica: >80% ven dashboard diariamente.

Screen: Dashboard Principal

Prototipo: paciente/index.astro

• Feature: Health Score prominente
• Feature: Alertas activas con badge
• Feature: Biomarcadores clave con valores y estados
• Feature: Próximas acciones numeradas
• Feature: Señales detectadas (SPIKE, improving)
• Feature: Notificación bell
• State: Con datos | Sin datos (primer uso) | Loading | Error de red

Screen: Dashboard Alternativo

Prototipo: No existe

• Feature: Plan del día como focal (checklist)
• Feature: Próxima cita compacta
• Feature: Progreso semanal + racha
• Feature: Edad biológica compacta
• Feature: 1 alerta activa
• State: Mismo que principal

Screen: Cumplimiento Semanal

Prototipo: No existe

• Feature: Porcentaje total prominente (87%)
• Feature: Desglose por categoría con progress bars
• Feature: Tendencia mensual (4 semanas)
• Feature: Comparativa vs semana pasada
• Feature: Recomendación personalizada
• State: Con datos | Sin datos suficientes (<3 días) | Semana perfecta (100%)

Flow 7: Progreso y Salud

Objetivo: Explorar datos sin sentirse abrumado. Progressive disclosure. Trigger: Tap en Health Score, tab Progreso. Personas: Andrés (todo), María (quick view), Roberto (contexto simple). Prioridad: P1. Métrica: >60% exploran 2+ niveles.

Screen: Progreso Overview

Prototipo: paciente/progreso/index.astro

• Feature: Health Score con tendencia
• Feature: Edad biológica vs cronológica
• Feature: Dominios de salud con scores
• Feature: Tendencia general
• State: Con datos | Solo 1 medición (sin tendencia) | Loading

Screen: Nivel de Salud

Prototipo: paciente/progreso/nivel-salud.astro

• Feature: Score 77/100 con breakdown
• Feature: 6 dominios con progress bars
• Feature: Cómo mejorar (acciones específicas)
• Feature: Histórico (3 timepoints)
• State: Con datos | Sin desglose (datos insuficientes)

Screen: Edad Biológica

Prototipo: paciente/progreso/edad-biológica.astro

• Feature: Número grande + badge “-X años más joven”
• Feature: Explicación PhenoAge con referencia científica
• Feature: 6 biomarcadores que lo calculan con estados
• Feature: Evolución temporal
• Feature: Proyección a 6 meses
• State: Más joven (verde) | Más viejo (rojo) | Igual (neutral) | Sin datos previos

Screen: Escenarios

Prototipo: paciente/progreso/escenarios.astro

• Feature: 4 tarjetas de proyección (1/3 años con/sin plan)
• Feature: Health Score proyectado con delta
• Feature: Puntos clave por escenario
• State: Con datos | Sin datos suficientes para proyectar

Screen: Dominio Detail

Prototipo: No existe

• Feature: Score del dominio (ej: Cardiovascular 5/20)
• Feature: Lista de biomarcadores del dominio con estados
• Feature: Recomendaciones específicas
• Feature: Tendencia del dominio
• State: Riesgo alto (rojo) | Moderado (amber) | Óptimo (verde)

Screen: Resumen Semanal

Prototipo: No existe

• Feature: 4 métricas con progress bars (check-ins, suplementos, ejercicio, sueño)
• Feature: Racha con mejor histórica
• Feature: Comparativa vs semana pasada
• Feature: Recomendación personalizada
• Feature: Navegación entre semanas
• State: Con datos | Semana incompleta | Semana perfecta

Screen: Nivel de Salud (dedicado)

Prototipo: No existe (variante de acceso directo desde dashboard)

• Feature: Mismo contenido que Nivel de Salud
• State: Mismo

Screen: Edad Biológica (dedicado)

Prototipo: No existe (variante de acceso directo)

• Feature: Mismo contenido que Edad Biológica
• State: Mismo

Screen: Escenarios (dedicado)

Prototipo: No existe (variante de acceso directo)

• Feature: Mismo contenido que Escenarios
• State: Mismo

Flow 8: Laboratorios

Objetivo: Ver, entender y exportar resultados. Trigger: Notificación “resultados listos”, tab Labs. Personas: Todas. Andrés exporta CSV. Prioridad: P0. Métrica: >85% revisan en <24h.

Screen: Results List

Prototipo: paciente/laboratorios/index.astro

• Feature: Lista de biomarcadores con valores y estados
• Feature: Date pills para cambiar entre mediciones
• Feature: Filtros (Todos, Elevados, Bajos, Normal)
• Feature: Conteo de biomarcadores
• State: Con datos | Sin datos | Loading | Filtro activo (lista reducida)

Screen: Resultados Index

Prototipo: paciente/resultados/index.astro

• Feature: Lista de análisis por fecha
• Feature: Conteo de biomarcadores por análisis
• Feature: Estado de cada análisis
• State: Con historial | Solo 1 análisis | Sin análisis

Screen: Biomarker Detail

Prototipo: No existe como página independiente

• Feature: Valor actual prominente con status
• Feature: Chart de tendencia con reference range
• Feature: Time range selector (6M, 1A, 2A, Todo)
• Feature: Stats (cambio %, RCV, rango)
• Feature: Historial con deltas
• Feature: Insight IA
• State: Elevado | Bajo | Normal | Sin historial (1 dato) | SPIKE detectado

Screen: Exportar Biomarcadores

Prototipo: No existe

• Feature: Selector de qué exportar (checkboxes)
• Feature: Formato (CSV/JSON/PDF)
• Feature: Rango de fechas
• Feature: Vista previa del archivo
• Feature: Descargar + enviar por correo
• State: Default | Generando archivo | Descarga lista | Error

Flow 9: Check-in y Plan Diario

Objetivo: Engagement diario. Saber qué hacer hoy en <30 seg. Trigger: 8-10am push, apertura de app. Personas: Todas. Pedro versión simplificada. Prioridad: P0. Métrica: >70% daily check-in, >45 días streak.

Screen: Check-in Diario

Prototipo: No existe (definido como modal en flows, aquí es pantalla)

• Feature: Selector de ánimo (5 niveles)
• Feature: Sueño (horas + calidad)
• Feature: Checklist suplementos tomados
• Feature: Síntomas (ninguno o reportar)
• Feature: Notas opcionales
• Feature: Streak counter
• State: No completado | Parcial | Completado | Ya hecho hoy

Screen: Plan del Día

Prototipo: No existe

• Feature: Timeline por horario (mañana/mediodía/noche)
• Feature: Checklist interactivo de tareas
• Feature: Progreso (X de Y completadas)
• Feature: Insight motivacional
• State: Inicio del día | Parcial | Todo completado | Sin plan activo

Screen: Plan Overview

Prototipo: paciente/plan/index.astro

• Feature: Ciclo actual (día X de 90)
• Feature: Suplementos activos con horarios
• Feature: Próxima medición
• State: Ciclo activo | Entre ciclos | Sin plan

Screen: Plan Completo 90 Días

Prototipo: No existe

• Feature: Suplementos con dosis y adherencia
• Feature: Plan de ejercicio con progreso semanal
• Feature: Guías nutricionales
• Feature: Objetivo de sueño vs promedio
• Feature: Monitoreo requerido
• State: Ciclo activo | Ciclo completado (read-only)

Screen: Suplemento Detail

Prototipo: paciente/plan/suplemento/[id]/index.astro

• Feature: Nombre, dosis, formato
• Feature: Por qué lo tomas (tu nivel está en X)
• Feature: Horario y cómo tomarlo
• Feature: Adherencia mensual
• Feature: Historial últimos 7 días
• State: Activo | Pausado | Completado (ciclo terminó)

Flow 10: Consulta Médica

Objetivo: Experiencia completa de visita médica. Trigger: 7 días antes de cita. Personas: María (activa), Pedro (Carolina gestiona). Prioridad: P1. Métrica: >90% check-in digital, >85% califica.

Screen: Recordatorio

Prototipo: No existe

• Feature: Info de la cita (fecha, hora, clínica, médico)
• Feature: Checklist de preparación
• Feature: Timeline de recordatorios (7d, 1d, 2h)
• Feature: Cómo llegar
• Feature: Confirmar asistencia
• State: 7 días antes | 1 día antes | Día de la cita | Cita pasada sin confirmar

Screen: Confirmación Pre-Cita

Prototipo: No existe

• Feature: Datos de la cita prominentes
• Feature: Checklist preparación interactivo
• Feature: Necesidades especiales (silla, intérprete, acompañante)
• Feature: Confirmar / reprogramar
• Feature: Compartir dirección
• State: Sin confirmar | Confirmada | Reprogramada | Cancelada

Screen: Check-in

Prototipo: No existe

• Feature: Confirmar llegada al centro médico
• Feature: Tiempo estimado de espera
• Feature: Checklist preparación (completado)
• State: Pre-llegada | Llegó (check-in exitoso) | Llegó tarde

Screen: Sala de Espera

Prototipo: No existe

• Feature: Posición en cola y tiempo estimado
• Feature: “Tu médico ya está preparando tu consulta”
• Feature: Escribir preguntas para el médico
• Feature: Reportar síntomas recientes
• Feature: Revisar último análisis
• State: En espera | Próximo turno | Médico atrasado | Llamado

Screen: En Consulta

Prototipo: No existe

• Feature: Status “En consulta con Dr. X”
• Feature: Duración timer
• Feature: Qué está revisando el médico (Health Score, biomarcadores, plan)
• Feature: Placeholder para notas
• State: En curso | Finalizada

Screen: Resumen Post-Consulta

Prototipo: No existe

• Feature: Consulta completada (fecha, duración, médico)
• Feature: Diagnóstico
• Feature: Lo que hablamos (bullet points)
• Feature: Acciones del médico (órdenes, receta, plan ajustado)
• Feature: CTA calificar
• State: Con órdenes | Sin órdenes | Solo seguimiento

Screen: Recomendaciones

Prototipo: No existe

• Feature: Cambios en medicación (ajustado/nuevo/retirado)
• Feature: Estilo de vida (bullets)
• Feature: Seguimiento (próxima cita, labs requeridos)
• State: Con cambios de medicación | Solo estilo de vida | Sin cambios

Screen: Órdenes Médicas

Prototipo: No existe

• Feature: Órdenes activas con estado (pendiente/completada)
• Feature: Detalle de cada orden (qué incluye)
• Feature: Agendar toma de muestra
• Feature: Descargar orden
• State: Con órdenes pendientes | Todas completadas | Sin órdenes

Screen: Receta Digital

Prototipo: No existe

• Feature: Medicamentos con dosis y duración
• Feature: QR para farmacia
• Feature: Farmacias cercanas
• Feature: Descargar PDF
• Feature: Firma digital del médico
• State: Receta activa | Receta vencida (>30 días) | Sin receta

Screen: Calificar Médico

Prototipo: No existe

• Feature: Rating (5 dots/estrellas)
• Feature: Highlights seleccionables (puntualidad, empatía, claridad)
• Feature: Comentario opcional
• Feature: Anónimo
• State: Sin calificar | Calificación enviada | Ya calificado (editar)

Screen: Reportar Síntomas

Prototipo: No existe

• Feature: Grid de síntomas comunes (selección múltiple)
• Feature: Intensidad (leve/moderada/severa)
• Feature: Duración (hoy, 2-3 días, 1 semana, +1 semana)
• Feature: Notas adicionales
• State: Sin síntomas | Síntomas seleccionados | Reporte enviado

Screen: Mi Transcripción

Prototipo: No existe

• Feature: Lo que reporté (síntomas, preguntas)
• Feature: Lo que me respondió el médico
• Feature: Decisiones tomadas
• Feature: Descargar transcripción
• State: Completa | Parcial (médico no completó) | Sin transcripción

Screen: Próximos Pasos

Prototipo: No existe

• Feature: Tareas por plazo (esta semana, 2 semanas, 3 meses)
• Feature: Checkboxes interactivos
• Feature: Links a farmacias, labs
• Feature: Recordatorios configurados
• State: Con tareas | Sin tareas | Todas completadas

Screen: Historial de Consultas

Prototipo: No existe

• Feature: Lista de consultas pasadas
• Feature: Fecha, médico, motivo, duración, rating
• Feature: Tap para ver detalle
• State: Con historial | Sin consultas previas

Screen: Nota Clínica

Prototipo: No existe

• Feature: Nota completa del médico
• Feature: Diagnósticos CIE-10
• Feature: Documentos adjuntos (receta, orden)
• Feature: Firma digital verificada
• State: Nota disponible | Sin nota (médico no completó) | Pendiente de firma

Flow 11: Citas

Objetivo: Gestionar citas sin llamar a la clínica. Trigger: Necesidad de análisis o control. Personas: María (ella misma), Carolina (para Pedro). Prioridad: P1. Métrica: >70% citas desde la app.

Screen: Lista de Citas

Prototipo: paciente/citas/index.astro

• Feature: Filtro próximas / pasadas
• Feature: Estado (confirmada, completada, cancelada)
• Feature: Detalle al tap
• State: Con citas | Sin citas | Solo pasadas

Screen: Detalle de Cita

Prototipo: paciente/citas/[id].astro

• Feature: Fecha, hora, clínica, tipo, médico
• Feature: Status badge
• Feature: Preparación (checklist)
• Feature: Reagendar / cancelar
• State: Próxima (acciones disponibles) | Pasada (read-only) | Cancelada

Screen: Solicitar Cita

Prototipo: paciente/citas/solicitar.astro

• Feature: Selector de clínica
• Feature: Calendario con date picker
• Feature: Horarios disponibles
• Feature: Dirección para kit
• Feature: Confirmar cita
• State: Seleccionando | Buscando slots | Slots disponibles | Sin disponibilidad | Confirmada

Flow 12: Alertas y Genómica

Objetivo: Notificar cambios importantes. Mostrar perfil genético. Trigger: Engine detecta cambio significativo. Personas: Pedro (alerta senior → Carolina notificada). Prioridad: P0. Métrica: >90% alertas vistas en <4h.

Screen: Lista de Alertas

Prototipo: paciente/alertas/[id].astro (solo detalle)

• Feature: Filtros por severidad
• Feature: Dot de color por severidad
• Feature: Acción por alerta
• Feature: Timestamp
• State: Con alertas | Sin alertas | Filtro activo

Screen: Detalle de Alerta

Prototipo: paciente/alertas/[id].astro

• Feature: Severidad prominente
• Feature: Descripción clara
• Feature: Acciones recomendadas numeradas
• Feature: Biomarcadores relacionados con valores
• Feature: Marcar como revisada
• State: Nueva (no leída) | Revisada | Resuelta

Screen: Alertas Resueltas

Prototipo: No existe

• Feature: Historial de alertas resueltas
• Feature: Fecha resolución y explicación
• State: Con historial | Sin alertas resueltas

Screen: Configuración de Alertas

Prototipo: No existe

• Feature: Toggles por tipo de alerta
• Feature: Severidad mínima (pills)
• Feature: Horario silencioso
• Feature: Canal (push/email/SMS)
• State: Default | Todo silenciado | Personalizado

Screen: Alerta Senior Personalizada

Prototipo: No existe

• Feature: Texto grande (16px min) y lenguaje simple
• Feature: Qué hacer en pasos numerados simples
• Feature: Notificación automática al cuidador
• Feature: CTA “Llamar a [cuidador]”
• State: Alerta nueva | Cuidador notificado | Cuidador contactado

Screen: Genómica Overview

Prototipo: No existe (genómica no está en paciente/)

• Feature: Colisiones gen-fármaco con severidad
• Feature: Riesgos poligénicos (PRS) con porcentajes
• Feature: Genotipos farmacogenómicos por gen
• Feature: Protein viewer placeholder
• State: Con datos genómicos | Sin genómica (plan no incluye) | Pendiente de procesamiento

Flow 13: IA y Coach

Objetivo: Responder preguntas con contexto clínico. Trigger: Duda sobre resultados, suplementos, plan. Personas: María (específica), Roberto (convencerse), Andrés (papers). Prioridad: P1. Métrica: >4/5 satisfacción, <3s respuesta.

Screen: Interpretación IA

Prototipo: No existe como página separada de paciente

• Feature: Monitoreo activo con estado
• Feature: Narrativa clínica del engine
• Feature: Hipótesis con domain/priority tags
• Feature: Hallazgos clave
• State: Con interpretación | Procesando | Sin datos suficientes

Screen: Chat Asistente

Prototipo: paciente/asistente/index.astro

• Feature: Chat conversacional
• Feature: Mensaje de bienvenida contextual
• Feature: Respuestas con chips de acción
• Feature: Input bar con send
• State: Primera conversación | Conversación activa | Sin conexión | Rate limited

Screen: Historial Coach

Prototipo: No existe

• Feature: Lista de conversaciones pasadas por tema
• Feature: Fecha y conteo de mensajes
• Feature: Preview del tema
• Feature: Retomar conversación
• State: Con historial | Sin conversaciones previas

Flow 14: Familia y Consentimientos

Objetivo: Gestionar salud de múltiples personas. Controlar privacidad. Trigger: Agregar familiar, gestionar permisos. Personas: Carolina (gestiona Pedro y Sofía). Prioridad: P2 (Familia), P1 (Consentimientos). Métrica: >20% agregan familiar en 6 meses.

Screen: Familia Index

Prototipo: paciente/familia/index.astro

• Feature: Lista de miembros con roles
• Feature: Agregar miembro
• State: Con miembros | Sin grupo familiar | Invitaciones pendientes

Screen: Agregar Miembro

Prototipo: paciente/familia/agregar.astro

• Feature: Nombre, parentesco, rol
• Feature: Envío por WhatsApp/SMS/correo
• State: Default | Invitación enviada | Error (email inválido)

Screen: Miembro Detail

Prototipo: paciente/familia/[id].astro

• Feature: Health Score del familiar
• Feature: Alertas activas
• Feature: Última medición
• Feature: Acciones rápidas (ver resultados, alertas, plan)
• State: Con datos | Sin datos (recién agregado) | Invitación pendiente

Screen: Modo Cuidador

Prototipo: paciente/familia/modo-cuidador.astro

• Feature: Toggle activar/desactivar
• Feature: Permisos por acción (ver resultados, agendar, modificar plan)
• State: Activo | Inactivo | Revocado por el dependiente

Screen: Permisos

Prototipo: paciente/familia/permisos.astro

• Feature: Permisos por persona (médico, familiar)
• Feature: Datos compartidos (checkboxes)
• State: Default | Sin permisos otorgados

Screen: Dependiente Dashboard

Prototipo: paciente/familia/dependiente/dashboard.astro

• Feature: Mini-dashboard del familiar
• Feature: Alertas, biomarcadores recientes
• Feature: Agendar cita para el familiar
• State: Con datos | Sin datos | Permisos insuficientes

Screen: Invitar Senior

Prototipo: No existe

• Feature: Beneficios de la app simplificada
• Feature: Formulario (nombre, parentesco, teléfono)
• Feature: Envío por WhatsApp/SMS/correo
• State: Default | Invitación enviada | Familiar ya tiene cuenta

Screen: Vista Simplificada

Prototipo: No existe

• Feature: Todo en texto grande (16-20px min)
• Feature: Solo: score, suplementos del día, próxima cita
• Feature: Botón grande “Llamar a [cuidador]”
• Feature: Sin tab bar complejo
• State: Con datos | Sin datos | Alerta activa (prominente)

Screen: Tracking

Prototipo: No existe

• Feature: Último check-in del familiar con timestamp
• Feature: Suplementos del día con estados
• Feature: Check-in diario del familiar
• Feature: Citas próximas
• Feature: Alertas activas
• State: Familiar activo (check-in reciente) | Inactivo (>3 días) | Alerta activa

Screen: Pago Compartido

Prototipo: No existe

• Feature: Plan de cada familiar con precio
• Feature: Radio selector de quién paga
• Feature: Método de pago actual
• Feature: Resumen mensual total
• State: Default | Pago rechazado | Cambio de método pendiente

Screen: Consentimientos Index

Prototipo: paciente/consentimientos/index.astro

• Feature: Lista con estados (aceptado/pendiente/rechazado)
• Feature: Fecha de cada consentimiento
• State: Todos aceptados | Pendientes | Rechazado

Screen: Compartir Datos

Prototipo: paciente/consentimientos/compartir-datos.astro

• Feature: Qué datos se comparten
• Feature: Quién accede
• Feature: Duración
• Feature: Toggle autorización
• State: Autorizado | No autorizado | Expirado

Screen: Consentimiento Detail

Prototipo: paciente/consentimientos/[tipo].astro

• Feature: Descripción legal completa
• Feature: Qué incluye (bullet points)
• Feature: Aceptar / rechazar
• State: Pendiente | Aceptado | Rechazado | Revocado

Flow 15: Médico

Objetivo: Conectar paciente con su médico directamente. Trigger: Necesidad de consulta, pregunta, cambio de médico. Personas: María (busca especialista), Carolina (para Pedro). Prioridad: P1. Métrica: >50% contactan desde la app.

Screen: Mi Médico de Cabecera

Prototipo: No existe

• Feature: Perfil del doctor asignado
• Feature: Rating y experiencia
• Feature: Disponibilidad (horarios)
• Feature: Contactar / Agendar cita
• Feature: Cambiar médico
• State: Médico asignado | Sin médico (elegir) | Médico no disponible

Screen: Directorio

Prototipo: No existe

• Feature: Búsqueda por nombre o especialidad
• Feature: Filtros (EPS, rating, disponibilidad)
• Feature: Lista de doctores con disponibilidad
• State: Con resultados | Sin resultados | Loading

Screen: Perfil Doctor

Prototipo: No existe

• Feature: Bio, especialidades, idiomas
• Feature: Rating con opiniones
• Feature: EPS aceptadas
• Feature: Opiniones de otros pacientes
• Feature: Agendar cita
• State: Default | Sin opiniones | No acepta mi EPS

Screen: Contactar

Prototipo: No existe

• Feature: Chat (respuesta en ~2h)
• Feature: Llamar (horario laboral)
• Feature: Videollamada (requiere cita)
• Feature: Dejar mensaje
• Feature: Urgencias (123)
• State: Disponible | Fuera de horario | En consulta | Urgencia

Screen: Historial de Médicos

Prototipo: No existe

• Feature: Lista de todos los médicos que me han atendido
• Feature: Conteo de consultas y fechas
• Feature: Rating dado
• Feature: Badge “Médico de cabecera”
• State: Con historial | Sin consultas previas

Screen: Mis Calificaciones

Prototipo: No existe

• Feature: Ratings pasados con tags y comentarios
• Feature: Editar calificación
• State: Con calificaciones | Sin calificaciones

Flow 16: Perfil, Ajustes e Historia Clínica

Objetivo: Control total de la experiencia. Acceso seguro a HC. Trigger: Editar datos, cambiar preferencias, compartir historia. Personas: Todas. Pedro necesita PIN simple. Prioridad: P1. Métrica: >95% datos correctos.

Screen: Perfil Overview

Prototipo: paciente/perfil/index.astro

• Feature: Datos personales, salud, plan ADEN
• Feature: Salir de cuenta
• State: Completo | Incompleto (campos vacíos)

Screen: Ajustes Index

Prototipo: paciente/ajustes/index.astro

• Feature: Secciones agrupadas (cuenta, notif, privacidad, dispositivos, app)
• Feature: Navegación a cada sección
• State: Default

Screen: Datos Personales

Prototipo: paciente/ajustes/datos-personales.astro

• Feature: Editar nombre, correo, teléfono, ciudad
• Feature: Badge verificado en correo
• Feature: Guardar cambios
• State: Default | Editando | Guardado | Error validación

Screen: Notificaciones

Prototipo: paciente/ajustes/notificaciones.astro

• Feature: 6 toggles por tipo
• Feature: Descripción de cada tipo
• State: Todas on | Todas off | Personalizado

Screen: Dispositivos

Prototipo: paciente/ajustes/dispositivos.astro

• Feature: Lista de wearables (conectado/no conectado)
• Feature: Datos sincronizados
• Feature: Conectar nuevo
• State: Con dispositivos | Sin dispositivos | Sincronizando

Screen: Sesiones Activas

Prototipo: No existe

• Feature: Dispositivos con sesión activa
• Feature: Cerrar sesión individual
• Feature: Cerrar todas las sesiones
• State: 1 sesión | Múltiples sesiones | Sesión desconocida (alerta)

Screen: Descargar Datos

Prototipo: No existe

• Feature: Solicitar descarga (JSON/PDF)
• Feature: Rectificar datos (link)
• Feature: Eliminar cuenta (destructivo)
• Feature: Referencia Ley 1581
• State: Default | Descarga solicitada (24-48h) | Cuenta en proceso de eliminación

Screen: Ayuda y Soporte

Prototipo: No existe

• Feature: Búsqueda en FAQ
• Feature: Preguntas frecuentes expandibles
• Feature: Chat con soporte
• Feature: Correo y WhatsApp
• Feature: Versión de la app
• State: Default | Chat activo | Sin conexión

Screen: Notificaciones Centro

Prototipo: paciente/notificaciones/index.astro

• Feature: Agrupadas por fecha (hoy, semana, anterior)
• Feature: Estado leído/no leído (dot)
• Feature: Tipos (alerta, cita, resultado, plan)
• State: Con notificaciones | Sin notificaciones | Todas leídas

Screen: Historia Clínica — PIN

Prototipo: No existe

• Feature: Teclado numérico 4 dígitos
• Feature: Face ID alternativo
• Feature: Recuperar PIN
• State: Input | Verificando | Correcto | Incorrecto (3 intentos) | Bloqueado

Screen: Historia Clínica — Resumen

Prototipo: No existe

• Feature: Datos del paciente (CC, RH, EPS)
• Feature: Condiciones activas con fechas
• Feature: Medicamentos actuales con horarios
• Feature: Alergias
• Feature: Cirugías
• Feature: Antecedentes familiares
• State: Completa | Incompleta (campos vacíos) | Solo lectura

Screen: Historia Clínica — Cronología

Prototipo: No existe

• Feature: Timeline vertical de eventos médicos
• Feature: Filtros (consultas, labs, diagnósticos)
• Feature: Dot de color por tipo de evento
• State: Con eventos | Sin historial | Filtro activo

Screen: Historia Clínica — Compartir

Prototipo: No existe

• Feature: Duración del acceso (1h, 24h, 7d, 30d)
• Feature: Qué incluir (checkboxes)
• Feature: Generar QR
• Feature: Copiar enlace / enviar por correo / WhatsApp
• Feature: Revocar acceso
• State: Sin QR activo | QR generado | QR expirado | Acceso revocado

Flow 17: Trayectoria y Ciclos

Objetivo: Visualizar evolución y transicionar entre ciclos. Trigger: Fin de ciclo, curiosidad sobre progreso. Personas: María (comparte reporte), Andrés (analiza cada dato). Prioridad: P1. Métrica: >70% renuevan a Ciclo 2.

Screen: Trayectoria

Prototipo: paciente/trayectoria/index.astro

• Feature: Timeline T1→T2→T3 vertical
• Feature: Resumen por timepoint
• Feature: Próxima medición
• State: 1 medición | 2+ mediciones | Sin mediciones

Screen: Reporte de Ciclo

Prototipo: paciente/ciclo/[id]/reporte.astro

• Feature: Día X/90, adherencia total
• Feature: Biomarcadores mejorados/empeorados
• Feature: Recomendación
• State: Ciclo en curso | Ciclo completado | Sin datos suficientes

Screen: Reporte PDF

Prototipo: No existe

• Feature: Vista previa del reporte
• Feature: Antes/después (Health Score, Edad Bio)
• Feature: Biomarcadores mejorados
• Feature: Descargar / Compartir WhatsApp / Enviar a médico
• State: Preview | Descargando | Enviado

Screen: Iniciar Ciclo 2

Prototipo: No existe

• Feature: Resumen Ciclo 1 completado
• Feature: Qué cambia en Ciclo 2 (ajustado/nuevo/retirado)
• Feature: Nuevas áreas de enfoque
• Feature: CTA iniciar
• State: Ciclo 1 completo (puede iniciar) | Ya iniciado | Sin datos para nuevo ciclo

Flow 18: Engagement y Wearables

Objetivo: Gamificación, dispositivos, estados del sistema. Trigger: Logros, conectar dispositivo, sin conexión. Personas: Andrés (wearables), María (badges). Prioridad: P2. Métrica: >45 días streak, >30% conecta wearable.

Screen: Logros / Badges

Prototipo: No existe

• Feature: Stats (racha, adherencia, total logros)
• Feature: Badges desbloqueados con fecha
• Feature: Próximos logros (opacidad reducida)
• State: Con logros | Sin logros (primer día) | Logro recién desbloqueado (celebración)

Screen: Conectar Wearable

Prototipo: No existe

• Feature: Flujo paso a paso (3 steps)
• Feature: Toggles de datos a sincronizar
• Feature: CTA conectar
• State: No conectado | Conectando | Conectado | Error de conexión | Sin wearable compatible

Screen: Vista Previa PDF

Prototipo: No existe

• Feature: Preview compacto del reporte
• Feature: Descargar / Compartir / Enviar
• State: Preview listo | Generando | Error

Screen: Sin Conexión

Prototipo: No existe

• Feature: Funciones disponibles offline (check-in, plan, resultados cache, score)
• Feature: Funciones que requieren conexión (chat, upload, citas)
• Feature: Mensaje de sincronización pendiente
• State: Offline | Reconectando | Sincronizando datos pendientes

Flow 19: V2 — Exploración Visual

Objetivo: Versiones alternativas para A/B testing. Nota: No para producción inmediata. Prioridad: P3.

Resumen de Cobertura

Referencias

• design/personas — 6 personas con lifecycle
• design/intentions — 33 intentions, 12 escenarios
• design/flows/*.md — 12 flujos de usuario
• design/navigation — Information architecture
• design/architecture — OOUX objects matrix
• design/jtbd — 7 jobs principales
• design/states — Estados globales
• design/edge-cases — Validaciones y recovery