Módulo de Adherencia al Tratamiento¶

Identificador: MTS-ADH-001 Versión: 1.0.0 Fecha: 2025-12-01
Autor: SpecQueen

1. Propósito
2. Actores
3. Métricas de Adherencia
3.1. Métrica Principal: Porcentaje de Adherencia
- 3.1.1. Variantes de Cálculo
3.2. Rangos de Adherencia
3.3. Métricas Secundarias
4. Funcionalidades
4.1. Dashboard de Adherencia (MTS-ADH-001-F01)
4.2. Adherencia por Medicamento (MTS-ADH-001-F02)
4.3. Patrones y Tendencias (MTS-ADH-001-F03)
4.4. Registro de Anomalías (MTS-ADH-001-F04)
4.5. Reportes de Adherencia (MTS-ADH-001-F05)
4.6. Insights y Recomendaciones (MTS-ADH-001-F06)
5. Reglas de Negocio
6. Modelo de Datos
7. Criterios de Aceptación
8. Referencias

1. Propósito¶

Este módulo calcula, analiza y presenta estadísticas de adherencia al tratamiento, permitiendo al paciente y cuidadores entender patrones y mejorar el cumplimiento.

2. Actores¶

Actor	Descripción
Paciente	Consulta su adherencia y recibe insights
Cuidador	Monitorea adherencia del paciente (con permiso)
Sistema	Calcula métricas y genera reportes

3. Métricas de Adherencia¶

3.1. Métrica Principal: Porcentaje de Adherencia¶

Adherencia (%) = (Tomas Confirmadas / Tomas Programadas) x 100

3.1.1. Variantes de Cálculo¶

Variante	Fórmula	Uso
Adherencia Simple	Tomadas / Programadas	Vista general
Adherencia Puntual	Tomadas a tiempo / Programadas	Precisión horaria
Adherencia por Medicamento	Tomadas[med] / Programadas[med]	Análisis individual
Adherencia Ponderada	Sum(Tomadas x Peso) / Sum(Programadas x Peso)	Medicamentos críticos

3.2. Rangos de Adherencia¶

Rango	Porcentaje	Indicador	Descripción
Excelente	>= 95%	🟢	Adherencia óptima
Buena	80-94%	🟡	Adherencia aceptable
Regular	60-79%	🟠	Necesita mejora
Baja	< 60%	🔴	Adherencia insuficiente

3.3. Métricas Secundarias¶

Métrica	Descripción	Cálculo
Racha actual	Días consecutivos con 100%	Contador desde última omisión
Racha máxima	Mayor racha histórica	Máximo histórico
Hora promedio de toma	Desviación del horario	Promedio de diferencia
Tomas tardías	Tomadas fuera de ventana	Contador
Motivos de omisión	Distribución de razones	Frecuencia por motivo

4. Funcionalidades¶

4.1. Dashboard de Adherencia (MTS-ADH-001-F01)¶

4.1.1. Descripción¶

Vista principal con resumen de adherencia del paciente.

4.1.2. Componentes del Dashboard¶

┌────────────────────────────────────────┐
│         ADHERENCIA HOY                 │
│                                        │
│      ┌──────────────┐                  │
│      │            │                    │
│      │    92%     │  🟡 Buena          │
│      │            │                    │
│      └──────────────┘                  │
│      11 de 12 tomas                    │
│                                        │
├────────────────────────────────────────┤
│  Racha actual: 5 días 🔥               │
│  Mejor racha: 23 días                  │
├────────────────────────────────────────┤
│  Últimos 7 días:                       │
│  L   M   M   J   V   S   D             │
│  █   █   ▓   █   █   █   ▓             │
│  95  98  82  100 95  97  88            │
├────────────────────────────────────────┤
│  [Ver detalle] [Ver por medicamento]   │
└────────────────────────────────────────┘

4.1.3. Períodos de Visualización¶

Período	Descripción	Granularidad
Hoy	Día actual	Por toma
Semana	Últimos 7 días	Por día
Mes	Últimos 30 días	Por día
Trimestre	Últimos 90 días	Por semana
Año	Últimos 365 días	Por mes
Personalizado	Rango seleccionado	Variable

4.2. Adherencia por Medicamento (MTS-ADH-001-F02)¶

4.2.1. Descripción 4.2¶

Análisis detallado de adherencia para cada medicamento.

4.2.2. Vista por Medicamento¶

┌────────────────────────────────────────┐
│  Metformina 850mg                      │
│  █████████████████████████▓▓ 94%       │
│                                        │
│  Lisinopril 10mg                       │
│  ████████████████████████████ 98%      │
│                                        │
│  Atorvastatina 20mg                    │
│  █████████████████████▓▓▓▓ 85%         │
│                                        │
│  Omeprazol 20mg                        │
│  ██████████████████▓▓▓▓▓▓ 78%          │
└────────────────────────────────────────┘

4.2.3. Análisis Individual¶

Métrica	Descripción
Adherencia total	% desde inicio del tratamiento
Tendencia	Mejorando/Empeorando/Estable
Horario problemático	Toma con más omisiones
Día problemático	Día de semana con más omisiones
Tiempo en tratamiento	Días desde inicio

4.3. Patrones y Tendencias (MTS-ADH-001-F03)¶

4.3.1. Descripción 4.3¶

Identificación de patrones en el comportamiento de adherencia.

4.3.2. Patrones Detectados¶

Patrón	Descripción	Insight
Día de semana	Adherencia varía por día	"Los lunes tienes 15% menos adherencia"
Hora del día	Horarios problemáticos	"Las tomas de mediodía se omiten más"
Fin de semana	Diferencia laboral/descanso	"Tu adherencia baja 20% los fines de semana"
Ciclo mensual	Patrones mensuales	"Final de mes tienes más omisiones"
Inicio de tratamiento	Curva de adopción	"La adherencia mejora después del día 14"

4.3.3. Visualización de Tendencias¶

%%{init: {'theme':'base'}}%%
graph LR
    subgraph "Tendencia de Adherencia (30 días)"
        S1["Sem 1<br/>85%"]
        S2["Sem 2<br/>92%"]
        S3["Sem 3<br/>88%"]
        S4["Sem 4<br/>95%"]

        S1 -->|↗| S2
        S2 -->|↘| S3
        S3 -->|↗| S4
    end

    style S1 fill:#f9f,stroke:#333
    style S2 fill:#9f9,stroke:#333
    style S3 fill:#ff9,stroke:#333
    style S4 fill:#9f9,stroke:#333

Tendencia: ↗ Mejorando (+5%)

4.4. Registro de Anomalías (MTS-ADH-001-F04)¶

4.4.1. Descripción 4.4¶

Registro de problemas o situaciones anómalas con medicamentos.

4.4.2. Tipos de Anomalías¶

Tipo	Descripción	Severidad
Efecto secundario	Reacción adversa al medicamento	Variable
Olvido sistemático	Patrón repetido de omisión	Media
Agotamiento	Medicamento no disponible	Alta
Confusión	Toma incorrecta (dosis/medicamento)	Alta
Interacción percibida	Malestar al combinar	Media

4.4.3. Flujo: Reportar Anomalía¶

Paciente accede a medicamento o toma
Paciente selecciona "Reportar problema"
Sistema muestra opciones de anomalía
Paciente selecciona tipo
Sistema solicita detalles:
Descripción (texto libre)
Severidad percibida
Fecha/hora de ocurrencia
Foto (opcional)
Paciente envía reporte
Sistema registra anomalía
Sistema sugiere acciones según tipo:
Efecto secundario grave: "Consulta a tu médico"
Agotamiento: "Programa reabasto"

4.4.4. Historial de Anomalías¶

Lista cronológica de problemas reportados
Filtro por medicamento
Filtro por tipo de anomalía
Exportable para compartir con médico

4.5. Reportes de Adherencia (MTS-ADH-001-F05)¶

4.5.1. Descripción 4.5¶

Generación de reportes formales para compartir con profesionales de salud.

4.5.2. Contenido del Reporte¶

Sección	Contenido
Resumen	Período, adherencia general, tendencia
Por medicamento	Adherencia individual, observaciones
Calendario	Vista mensual con indicadores
Patrones	Insights detectados
Anomalías	Lista de problemas reportados
Gráficos	Visualizaciones de tendencias

4.5.3. Formatos de Exportación¶

Formato	Uso
PDF	Compartir con médico, imprimir
CSV	Análisis externo
HL7 FHIR	Interoperabilidad con sistemas de salud

4.5.4. Flujo: Generar Reporte¶

Paciente accede a "Generar Reporte"
Sistema muestra opciones:
Período (predefinido o personalizado)
Medicamentos a incluir
Secciones a incluir
Formato de salida
Paciente configura reporte
Sistema genera reporte
Sistema muestra preview
Paciente puede:
Descargar
Enviar por email
Compartir enlace temporal

4.6. Insights y Recomendaciones (MTS-ADH-001-F06)¶

4.6.1. Descripción 4.6¶

Sugerencias personalizadas basadas en análisis de datos.

4.6.2. Tipos de Insights¶

Tipo	Ejemplo
Patrón detectado	"Olvidas más las tomas de las 2pm"
Mejora sugerida	"Cambia la toma al almuerzo para recordar mejor"
Logro	"¡Tu adherencia mejoró 10% este mes!"
Alerta	"Tu adherencia a la Metformina bajó esta semana"
Motivación	"Estás a 2 días de tu mejor racha"

4.6.3. Frecuencia de Insights¶

Trigger	Insight
Diario	Resumen del día anterior
Semanal	Patrones de la semana
Por evento	Logros, alertas
Por hito	Records, metas alcanzadas

5. Reglas de Negocio¶

ID	Regla
RN-ADH-001	Adherencia se calcula solo sobre tomas programadas confirmadas
RN-ADH-002	Tomas pospuestas y luego tomadas cuentan como adherencia
RN-ADH-003	Tomas tardías (fuera de ventana) cuentan para adherencia pero se marcan
RN-ADH-004	Racha se reinicia con cualquier toma omitida
RN-ADH-005	Patrones requieren mínimo 14 días de datos
RN-ADH-006	Medicamentos pausados no afectan cálculo de adherencia
RN-ADH-007	Historial de adherencia se mantiene indefinidamente
RN-ADH-008	Reportes máximo 365 días por generación
RN-ADH-009	Anomalías se asocian al medicamento y fecha
RN-ADH-010	Cuidador solo ve adherencia si tiene permiso explícito

6. Modelo de Datos¶

erDiagram
    EstadisticaAdherencia {
        UUID id PK
        UUID usuario_id FK
        date fecha
        integer tomas_programadas
        integer tomas_confirmadas
        integer tomas_omitidas
        integer tomas_tardias
        decimal porcentaje_adherencia
        integer racha_actual
        timestamp created_at
        timestamp updated_at
    }

    EstadisticaMedicamento {
        UUID id PK
        UUID medicamento_paciente_id FK
        date fecha
        integer tomas_programadas
        integer tomas_confirmadas
        integer tomas_omitidas
        integer tomas_tardias
        decimal porcentaje_adherencia
        timestamp created_at
    }

    Anomalia {
        UUID id PK
        UUID usuario_id FK
        UUID medicamento_paciente_id FK
        enum tipo "EFECTO_SECUNDARIO, OLVIDO, AGOTAMIENTO, CONFUSION, INTERACCION, OTRO"
        text descripcion "encrypted"
        enum severidad "LEVE, MODERADA, SEVERA"
        timestamp fecha_ocurrencia
        string imagen_url
        text acciones_tomadas
        timestamp created_at
    }

    ReporteGenerado {
        UUID id PK
        UUID usuario_id FK
        enum tipo "ADHERENCIA, MEDICAMENTOS, COMPLETO"
        date fecha_inicio
        date fecha_fin
        jsonb configuracion
        string archivo_url
        enum formato "PDF, CSV, FHIR"
        timestamp expira_at
        timestamp created_at
    }

    EstadisticaAdherencia ||--o{ EstadisticaMedicamento : "agrupa"
    EstadisticaAdherencia ||--o{ Anomalia : "registra"
    EstadisticaAdherencia ||--o{ ReporteGenerado : "genera"

7. Criterios de Aceptación¶

ID	Criterio
AC-001	Dashboard muestra adherencia del día con indicador visual
AC-002	Paciente puede ver adherencia por período (día/semana/mes)
AC-003	Paciente puede ver adherencia por medicamento individual
AC-004	Sistema detecta y muestra patrones de comportamiento
AC-005	Paciente puede reportar anomalías con descripción
AC-006	Paciente puede generar reportes en PDF
AC-007	Reportes exportables en formato FHIR
AC-008	Sistema muestra racha actual y mejor racha
AC-009	Cuidador puede ver adherencia con permiso
AC-010	Historial de adherencia accesible sin límite de tiempo

8. Referencias¶

Documento generado por SpecQueen - La especificación funcional ES el sistema.