Flujo de Navegacion - Motor de Adherencia¶

Identificador: UIF-ADH-001 Modulo: MTS-ADH-001 - Motor de Adherencia Version: 1.0.0 Fecha: 2025-12-05 Autor: MobileUxUiDrone (Eight of Eight) FASE: 2 - Value

1. Resumen del Flujo¶

Este documento especifica el flujo de navegacion completo para el modulo Motor de Adherencia, que permite a pacientes y cuidadores visualizar, analizar y mejorar el cumplimiento del tratamiento farmacologico.

1.1. Pantallas del Modulo¶

ID	Nombre	Proposito	Prioridad
SCR-ADH-001	Dashboard de Adherencia	Vista principal con porcentaje circular y racha	Alta
SCR-ADH-002	Adherencia por Medicamento	Barras horizontales por medicamento	Alta
SCR-ADH-003	Tendencias Semanales/Mensuales	Graficos de evolucion temporal	Media
SCR-ADH-004	Patrones por Dia/Hora	Heatmap de adherencia	Media
SCR-ADH-005	Reportar Anomalia	Formulario de problemas con medicamento	Alta
SCR-ADH-006	Detalle de Dia Especifico	Vista drill-down de un dia	Media
SCR-ADH-007	Insights y Recomendaciones	Sugerencias personalizadas del sistema	Media
SCR-ADH-008	Comparativa Historica	Comparacion entre periodos	Baja
SCR-ADH-009	Logros de Adherencia	Gamificacion y badges	Media
SCR-ADH-010	Reporte para Medico	Generacion de PDF/exportacion	Alta

2. Diagrama de Flujo Principal¶

flowchart TD
    subgraph Entry["Puntos de Entrada"]
        HOME[Tab Estadisticas]
        NOTIF[Notificacion Insight]
        DEEP[Deep Link]
        WIDGET[Widget Racha]
    end

    subgraph MainFlow["Flujo Principal"]
        DASH[SCR-ADH-001<br/>Dashboard Adherencia]
        BYMED[SCR-ADH-002<br/>Por Medicamento]
        TRENDS[SCR-ADH-003<br/>Tendencias]
        PATTERNS[SCR-ADH-004<br/>Patrones]
    end

    subgraph DetailFlow["Flujo de Detalle"]
        DAYDET[SCR-ADH-006<br/>Detalle de Dia]
        ANOMALY[SCR-ADH-005<br/>Reportar Anomalia]
    end

    subgraph InsightFlow["Flujo de Insights"]
        INSIGHTS[SCR-ADH-007<br/>Insights]
        COMPARE[SCR-ADH-008<br/>Comparativa]
        ACHIEVE[SCR-ADH-009<br/>Logros]
    end

    subgraph ExportFlow["Flujo de Exportacion"]
        REPORT[SCR-ADH-010<br/>Reporte Medico]
    end

    %% Entry Points
    HOME --> DASH
    NOTIF --> INSIGHTS
    DEEP --> DASH
    WIDGET --> DASH

    %% Main Navigation
    DASH -->|Tab Por Medicamento| BYMED
    DASH -->|Tab Tendencias| TRENDS
    DASH -->|Ver patrones| PATTERNS
    DASH -->|Ver insights| INSIGHTS
    DASH -->|Ver logros| ACHIEVE
    DASH -->|Generar reporte| REPORT

    %% From Dashboard
    DASH -->|Tap dia en calendario| DAYDET
    DASH -->|Tap racha| ACHIEVE

    %% From By Medication
    BYMED -->|Tap medicamento| DAYDET
    BYMED -->|Reportar problema| ANOMALY

    %% From Trends
    TRENDS -->|Tap punto en grafico| DAYDET
    TRENDS -->|Comparar periodos| COMPARE

    %% From Patterns
    PATTERNS -->|Tap celda heatmap| DAYDET

    %% From Day Detail
    DAYDET -->|Reportar anomalia| ANOMALY
    DAYDET -->|Ver medicamento| BYMED

    %% From Insights
    INSIGHTS -->|Aplicar sugerencia| DASH
    INSIGHTS -->|Ver detalle| TRENDS

    %% Export
    REPORT -->|Compartir| SHARE[Share Sheet]
    REPORT -->|Preview| PREVIEW[PDF Preview]

    %% Styling
    classDef entry fill:#E3F2FD,stroke:#1976D2
    classDef main fill:#E8F5E9,stroke:#388E3C
    classDef detail fill:#FFF3E0,stroke:#F57C00
    classDef insight fill:#F3E5F5,stroke:#7B1FA2
    classDef export fill:#E0F7FA,stroke:#00796B

    class HOME,NOTIF,DEEP,WIDGET entry
    class DASH,BYMED,TRENDS,PATTERNS main
    class DAYDET,ANOMALY detail
    class INSIGHTS,COMPARE,ACHIEVE insight
    class REPORT,SHARE,PREVIEW export

3. User Journeys¶

3.1. Journey: Paciente Independiente (PI) - Revisar mi Adherencia¶

Persona: Maria, 52 anos, diabetes tipo 2, quiere entender su cumplimiento del tratamiento.

journey
    title Maria revisa su adherencia semanal
    section Acceso
      Abre app: 5: Maria
      Tap tab Estadisticas: 5: Maria
      Ve dashboard adherencia: 5: Maria
    section Analisis
      Ve circulo 87% amarillo: 4: Maria
      Identifica racha de 5 dias: 5: Maria
      Nota patron de omisiones: 3: Maria
    section Investigacion
      Tap dia con omision: 4: Maria
      Ve que omitio toma de mediodia: 4: Maria
      Entiende el problema: 5: Maria
    section Accion
      Ve insight sobre almuerzo: 5: Maria
      Considera ajustar horario: 4: Maria

3.1.1. Pasos Detallados - PI¶

Paso	Pantalla	Accion	Siguiente	Notas UX
1	HOME	Tap tab Estadisticas	SCR-ADH-001	Badge si hay nuevo logro
2	SCR-ADH-001	Vista dashboard	-	Circulo animado al cargar
3	SCR-ADH-001	Ve porcentaje 87%	-	Color amarillo (80-94%)
4	SCR-ADH-001	Ve racha "5 dias"	-	Icono fuego animado
5	SCR-ADH-001	Ve calendario semanal	-	Dias con color por adherencia
6	SCR-ADH-001	Tap dia rojo (omision)	SCR-ADH-006	Transicion drill-down
7	SCR-ADH-006	Ve tomas del dia	-	Lista cronologica
8	SCR-ADH-006	Identifica omision 14:00	-	Marcada en rojo
9	SCR-ADH-006	Back a dashboard	SCR-ADH-001	-
10	SCR-ADH-001	Tap "Ver insights"	SCR-ADH-007	Card destacada
11	SCR-ADH-007	Lee sugerencia horario	-	Texto empathico
12	SCR-ADH-007	Tap "Aplicar"	Ajuste config	Navegacion a config

3.1.2. Consideraciones Accesibilidad - PI¶

Circulo de porcentaje anunciado por VoiceOver: "87%, adherencia buena"
Colores siempre acompanados de texto e iconos
Graficos con alternativa tabular accesible
Touch targets minimo 48x48dp en calendario
Animaciones respetan prefers-reduced-motion

3.2. Journey: Cuidador Responsable (CR) - Revisar Adherencia de Dependiente¶

Persona: Carlos, 38 anos, monitorea a su madre de 72 anos con multiples condiciones.

journey
    title Carlos revisa adherencia de su madre
    section Acceso
      Abre app: 5: Carlos
      Selecciona perfil de madre: 4: Carlos
      Tap tab Estadisticas: 5: Carlos
    section Revision
      Ve dashboard 78% naranja: 3: Carlos
      Preocupado por baja adherencia: 2: Carlos
      Revisa por medicamento: 4: Carlos
    section Analisis
      Ve Omeprazol en 65%: 3: Carlos
      Identifica patron mananas: 4: Carlos
      Entiende que olvida desayuno: 5: Carlos
    section Accion
      Genera reporte para medico: 5: Carlos
      Descarga PDF: 5: Carlos
      Envia a WhatsApp medico: 5: Carlos

3.2.1. Pasos Detallados - CR¶

Paso	Pantalla	Accion	Siguiente	Notas UX
1	HOME	Selector de perfil	-	Avatar de madre visible
2	HOME	Selecciona dependiente	Dashboard	Confirmacion visual
3	SCR-ADH-001	Ve dashboard madre	-	Etiqueta "Viendo: Mama"
4	SCR-ADH-001	Ve 78% naranja	-	Warning visual sutil
5	SCR-ADH-001	Tap "Por medicamento"	SCR-ADH-002	Tab switch
6	SCR-ADH-002	Ve lista medicamentos	-	Barras horizontales
7	SCR-ADH-002	Identifica Omeprazol 65%	-	Barra mas corta
8	SCR-ADH-002	Tap Omeprazol	SCR-ADH-006	Detalle del medicamento
9	SCR-ADH-006	Ve patron omisiones	-	Calendar con patron
10	SCR-ADH-001	Tap "Generar reporte"	SCR-ADH-010	FAB o menu
11	SCR-ADH-010	Configura periodo	-	30 dias default
12	SCR-ADH-010	Tap "Generar PDF"	Preview	Loading state
13	Preview	Ve preview PDF	-	Scrollable
14	Preview	Tap "Compartir"	Share sheet	Sistema nativo

3.2.2. Permisos del Cuidador para Adherencia¶

Permiso	CR Puede	CR No Puede
Ver dashboard adherencia	Si	-
Ver por medicamento	Si	-
Ver tendencias y patrones	Si	-
Ver insights	Si	-
Generar reportes	Si	-
Exportar datos	Si	-
Reportar anomalia	Configurable	Por defecto no
Modificar configuracion	No	Siempre bloqueado

4. Arquitectura de Navegacion¶

4.1. Estructura de Tabs en Dashboard¶

flowchart LR
    subgraph ADH_TABS["SCR-ADH-001 - Tabs"]
        T1[General]
        T2[Por Med]
        T3[Tendencias]
    end

    T1 --> GENERAL[Vista circular + racha + calendario]
    T2 --> BYMED[Barras horizontales por medicamento]
    T3 --> TRENDS[Grafico lineal temporal]

4.2. Deep Links¶

Deep Link	Destino	Parametros
`medtime://adherence`	SCR-ADH-001	-
`medtime://adherence/day/{date}`	SCR-ADH-006	date (YYYY-MM-DD)
`medtime://adherence/medication/{id}`	SCR-ADH-002	medication_id
`medtime://adherence/insights`	SCR-ADH-007	-
`medtime://adherence/achievements`	SCR-ADH-009	-
`medtime://adherence/report`	SCR-ADH-010	-

5. Transiciones y Animaciones¶

5.1. Transiciones Entre Pantallas¶

De	A	Tipo	Duracion	Ease
DASH	BYMED	Tab slide	200ms	ease-out
DASH	TRENDS	Tab slide	200ms	ease-out
DASH	DAYDET	Zoom in desde dia	300ms	ease-out
BYMED	DAYDET	Slide right	300ms	ease-out
DASH	INSIGHTS	Modal bottom sheet	300ms	ease-out
DASH	ACHIEVE	Full screen push	300ms	ease-out
DASH	REPORT	Full screen push	300ms	ease-out

5.2. Animaciones del Dashboard¶

Elemento	Animacion	Duracion	Trigger
Circulo porcentaje	Fill circular	800ms	onMount
Numero porcentaje	Count up	600ms	onMount, delayed 200ms
Racha fuego	Flame flicker	Loop	Si racha >= 3
Calendario dias	Stagger fade in	50ms/item	onMount
Insight cards	Slide up	300ms	onScroll into view

5.3. Preferencias de Movimiento Reducido¶

Cuando prefers-reduced-motion esta activo:

Circulo aparece lleno inmediatamente (sin animacion fill)
Numero muestra valor final sin count up
Fuego estatico (sin flicker)
Transiciones < 100ms
Sin parallax en scroll

6. Estados de Pantalla¶

6.1. SCR-ADH-001 - Dashboard¶

Estado	Condicion	Visualizacion
Loading	Calculando metricas	Skeleton circular + bars
Empty	< 3 dias de datos	Empty state "Necesitamos mas datos"
Insufficient	3-13 dias	Datos parciales + mensaje
Loaded	>= 14 dias	Dashboard completo
Error	Fallo calculo	Error card + reintentar

6.2. Rangos de Adherencia (Visual)¶

Rango	Porcentaje	Color	Icono
Excelente	>= 95%	Verde (success.500)	Check doble
Buena	80-94%	Amarillo (warning.500)	Check simple
Regular	60-79%	Naranja (warning.700)	Alerta suave
Baja	< 60%	Rojo (error.500)	Alerta

7. Integracion con Otros Modulos¶

7.1. MTS-ALT-001 (Alertas)¶

Datos de confirmacion de tomas alimentan calculo
Tomas tardias se marcan pero cuentan

7.2. MTS-GAM-001 (Gamificacion)¶

SCR-ADH-009 muestra logros de adherencia
Rachas generan badges
Mejoras mes a mes desbloquean achievements

7.3. MTS-NTF-001 (Notificaciones Inteligentes)¶

Insights alimentan sugerencias de notificaciones
Patrones detectados informan ajustes de horario

8. Metricas de UX¶

8.1. KPIs del Flujo¶

Metrica	Objetivo	Medicion
Tiempo en dashboard	> 30s promedio	analytics
Tap rate en insights	> 40%	analytics
Reportes generados/mes	> 1 por usuario activo	analytics
Retorno a tab adherencia	> 3x/semana	analytics
Completion rate anomaly form	> 80%	funnel

8.2. Puntos de Friccion Identificados¶

Punto	Riesgo	Mitigacion
Grafico confuso	Medio	Tooltips explicativos
Datos insuficientes	Alto	Onboarding + empty states claros
Porcentaje desmotivador	Alto	Mensajes positivos, enfoque en mejora
Exportacion compleja	Medio	One-tap para PDF default

9. Referencias¶

10. Historial de Cambios¶

Version	Fecha	Cambios
1.0.0	2025-12-05	Version inicial completa

Documento generado por MobileUxUiDrone (Eight of Eight) "La adherencia visible es adherencia mejorable."