Especificacion UI Consolidada - MTS-INT-002¶

Identificador: UI-MTS-INT-002 Modulo Funcional: MTS-INT-002 - Interacciones Medicamentos-Estudios Version: 1.0.0 Fecha: 2025-12-05 Autor: MobileUxUiDrone (Eight of Eight) Estado: Completado Prioridad: ALTA (Seguridad del Paciente)

1. Resumen Ejecutivo¶

1.1. Alcance¶

Este documento consolida la especificacion completa de interfaz de usuario para el modulo de Interacciones Medicamento-Estudio (MTS-INT-002). Este modulo detecta cuando medicamentos activos pueden afectar resultados de estudios clinicos o requieren suspension antes de procedimientos.

1.2. Metricas del Modulo¶

Metrica	Valor
Total de pantallas	6
Pantallas criticas	2 (SCR-IES-002, SCR-IES-003)
Pantallas alta prioridad	3 (SCR-IES-001, SCR-IES-005, SCR-IES-006)
Pantallas media prioridad	1 (SCR-IES-004)
User journeys documentados	1
Flujos Mermaid	6
Nivel WCAG	AA (AAA para SCR-IES-003)
Cobertura de accesibilidad	100%

1.3. Pantallas Incluidas¶

ID	Nombre	Prioridad	Estado	Tipo
SCR-IES-001	Alerta AFE (Afecta Resultado)	ALTA	Especificado	Modal
SCR-IES-002	Alerta SUS (Requiere Suspension)	CRITICA	Especificado	Full Screen
SCR-IES-003	Alerta INC (Incompatibilidad)	CRITICA	Especificado	Full Screen Bloqueante
SCR-IES-004	Alerta POS (Restriccion Post)	MEDIA	Especificado	Bottom Sheet
SCR-IES-005	Calendario de Suspension	ALTA	Especificado	Full Screen
SCR-IES-006	Confirmacion Post-Estudio	ALTA	Especificado	Full Screen

2. Diferencias con MTS-INT-001¶

Este modulo complementa a MTS-INT-001 pero tiene un enfoque diferente:

Aspecto	MTS-INT-001 (Med-Med)	MTS-INT-002 (Med-Estudio)
Trigger	Agregar medicamento	Agendar cita de estudio
Enfoque	Combinacion permanente	Suspension temporal
Temporalidad	Mientras toma ambos	Ventana pre/post procedimiento
Colores	Rojo/Naranja/Amarillo/Azul	AFE/SUS/INC/POS
Accion	Evitar combinacion	Suspender temporalmente
Recordatorios	No aplicable	Criticos para adherencia

3. Tipos de Interaccion¶

3.1. Codigo de Colores¶

Tipo	Codigo	Color Primario	Significado
AFE	Afecta Resultado	#FFCC00 (Amarillo)	Puede falsear resultados
SUS	Requiere Suspension	#FF8C00 (Naranja)	Debe suspenderse antes
INC	Incompatibilidad	#FF4444 (Rojo)	No puede realizarse sin protocolo
POS	Restriccion Post	#4444FF (Azul)	Restriccion despues del procedimiento

3.2. Comportamiento por Tipo¶

Tipo	Bloqueo	Recordatorios	Calendario	Post-Check
AFE	No	Opcional	No	No
SUS	Parcial	Automaticos	Si	Si
INC	Total	Automaticos	Si	Si
POS	No	Automatico dia de	No	Si

4. User Journey¶

4.1. Paciente Independiente (PI) - Prepararse para Estudio¶

Persona: Maria, 58 anos con diabetes tipo 2, toma Metformina 850mg.

Escenario: Maria agenda una TAC abdominal con contraste.

Objetivo: Prepararse correctamente suspendiendo medicamento y reiniciandolo de forma segura.

Flujo completo:

Abre app -> Citas -> Nueva cita
Selecciona "TAC Abdominal con Contraste"
Ingresa fecha: 20 de Diciembre
Motor detecta Metformina activa -> Interaccion INC
[ALERTA INC] Pantalla bloqueante incompatibilidad
Lee riesgo de acidosis lactica
Ve protocolo de suspension
Marca checkboxes de confirmacion
Ve calendario de suspension
Activa recordatorios
Confirma cita
Recibe recordatorio T-2 dias
Ultima dosis de Metformina
Recibe recordatorio dia procedimiento
Realiza TAC
[POST-ESTUDIO] 48h despues
Responde preguntas de verificacion
Reinicia Metformina

Tiempo total del flujo: ~4-5 dias

Resultado esperado: Paciente completa estudio de forma segura y reinicia medicamento correctamente.

5. Arquitectura de Navegacion¶

5.1. Diagrama de Flujo¶

flowchart TD
    subgraph Trigger["Punto de Entrada"]
        CIT[MTS-CIT-001<br/>Agendar Cita]
    end

    subgraph Detection["Motor MTS-INT-002"]
        DETECT[Verificar<br/>Interacciones]
    end

    subgraph TypeBranch["Por Tipo"]
        AFE[Tipo AFE]
        SUS[Tipo SUS]
        INC[Tipo INC]
        POS[Tipo POS]
    end

    subgraph Screens["Pantallas"]
        S1[SCR-IES-001<br/>Alerta AFE]
        S2[SCR-IES-002<br/>Alerta SUS]
        S3[SCR-IES-003<br/>Alerta INC]
        S4[SCR-IES-004<br/>Alerta POS]
        S5[SCR-IES-005<br/>Calendario]
        S6[SCR-IES-006<br/>Post-Estudio]
    end

    subgraph Flow["Flujo Temporal"]
        CONFIRM[Confirmar Cita]
        REMIND[Recordatorios]
        PROC[Procedimiento]
        POST[Post-Procedimiento]
    end

    CIT --> DETECT
    DETECT --> AFE --> S1 --> CONFIRM
    DETECT --> SUS --> S2 --> S5
    DETECT --> INC --> S3 --> S5
    DETECT --> POS --> S4

    S5 --> REMIND --> CONFIRM
    CONFIRM --> PROC --> POST
    POST --> S6
    S4 -.-> POST

    style S3 fill:#FF4444,color:#FFF
    style S2 fill:#FF8C00,color:#FFF
    style S1 fill:#FFCC00,color:#000
    style S4 fill:#4444FF,color:#FFF

5.2. Deep Links¶

Ruta	Destino	Uso
`medtime://study-interactions`	Lista general	Menu
`medtime://study-interactions/{event_id}`	Detalle por cita	Notificacion
`medtime://study-interactions/calendar/{event_id}`	SCR-IES-005	Recordatorio
`medtime://study-interactions/post/{event_id}`	SCR-IES-006	Post-procedimiento

6. Componentes Utilizados¶

6.1. Componentes del Design System¶

Componente	ID	Uso en Modulo
Top App Bar	CMP-NAV-002	Pantallas full screen
Bottom Sheet	CMP-FBK-003	SCR-IES-004
Modal Dialog	CMP-FBK-002	SCR-IES-001, SCR-IES-003
Primary Button	CMP-BTN-001	Todas
Outlined Button	CMP-BTN-002	Acciones secundarias
Checkbox	CMP-INP-007	Confirmaciones
Radio Buttons	CMP-INP-XXX	SCR-IES-006
Switch Toggle	CMP-INP-XXX	Recordatorios
Calendar View	CMP-DAT-XXX	SCR-IES-005

6.2. Componentes Personalizados (Nuevos)¶

Componente	Descripcion	Pantalla
InteractionTypeBadge	Badge AFE/SUS/INC/POS	Todas
SuspensionTimeline	Timeline vertical de fechas	SCR-IES-002, SCR-IES-005
CalendarHighlight	Dias destacados por tipo	SCR-IES-005
ReminderList	Lista de recordatorios toggle	SCR-IES-005
VerificationQuestions	Preguntas con radio y campo	SCR-IES-006
ResultCard	Card de resultado dinamico	SCR-IES-006

7. Flujo de Recordatorios¶

7.1. Timeline de Recordatorios¶

gantt
    title Timeline de Recordatorios - Metformina + TAC
    dateFormat  YYYY-MM-DD
    section Preparacion
    Aviso previo           :a1, 2025-12-17, 1d
    ULTIMA DOSIS           :crit, a2, 2025-12-18, 1d
    No tomar               :active, a3, 2025-12-19, 1d
    section Procedimiento
    DIA DEL ESTUDIO        :milestone, 2025-12-20, 0d
    section Post
    Esperar                :a4, 2025-12-21, 1d
    Verificar reinicio     :a5, 2025-12-22, 1d

7.2. Tipos de Recordatorio¶

Tipo	Cuando	Mensaje	Prioridad
AVISO_PREVIO	T-3 o T-2 dias	"Manana es su ultima dosis de [med]"	Media
ULTIMA_DOSIS	Dia de ultima dosis	"HOY es su ultima dosis de [med] antes del estudio"	Alta
NO_TOMAR	Dias de suspension	"Recuerde: NO tome [med] hoy"	Alta
DIA_ESTUDIO	Dia del procedimiento	"NO tome [med] - Dia del procedimiento"	Critica
VERIFICAR_REINICIO	Horas post indicadas	"Puede ser momento de reiniciar [med]"	Alta

8. Auditoria de Accesibilidad WCAG 2.1¶

8.1. Resumen de Cumplimiento¶

Pantalla	Nivel Base	Nivel Alcanzado	Notas
SCR-IES-001	AA	AA	Alerta informativa
SCR-IES-002	AA	AA	Alerta de suspension
SCR-IES-003	AA	AAA	Alerta critica bloqueante
SCR-IES-004	AA	AA	Bottom sheet informativo
SCR-IES-005	AA	AA	Calendario navegable
SCR-IES-006	AA	AA	Formulario de verificacion

8.2. Criterios Especiales¶

8.2.1. SCR-IES-003 (Critica)¶

Contraste AAA: 7:1 para texto critico
aria-live="assertive": Anuncio inmediato
Bloqueo intencional: No se puede cerrar sin accion
Doble confirmacion: 2 checkboxes requeridos

8.2.2. SCR-IES-005 (Calendario)¶

Navegacion por teclado: Dias focusables
Screen reader: Anuncia tipo de cada dia
Alto contraste: Colores + texto + icono

9. Responsive Design¶

9.1. Breakpoints¶

Ancho	Adaptacion
< 360dp	Compacto, texto reducido
360-600dp	Mobile standard
600-840dp	Tablet portrait
> 840dp	Tablet landscape

9.2. Adaptaciones Especificas¶

Pantalla	Mobile	Tablet
SCR-IES-003	Full screen bloqueante	Centered modal 500dp
SCR-IES-005	Calendario + timeline vertical	Side by side
SCR-IES-006	Scroll vertical	2 columnas

10. Estados de Error¶

10.1. Errores Especificos¶

Error	Codigo	UI	Fallback
Estudio no reconocido	ERR-IES-001	Advertencia generica	Sugerir consulta medico
Sin conexion	ERR-IES-002	Guardado offline	Verificar al reconectar
Recordatorio fallido	ERR-IES-003	Retry automatico	Notificar al usuario
Calendario no sincronizado	ERR-IES-004	Usar fechas locales	Sync al reconectar

11. Metricas de UX¶

11.1. KPIs del Modulo¶

Metrica	Objetivo	Medicion
Recordatorios activados	> 90%	De citas con interaccion SUS/INC
Post-check completado	> 85%	De procedimientos con suspension
Tiempo reinicio	< 72h post-check	Promedio
Reprogramacion INC	> 40%	De alertas INC mostradas

11.2. Eventos de Analytics¶

Evento	Parametros	Prioridad
`study_interaction_detected`	type, med_id, study_id	Alta
`suspension_calendar_viewed`	med_id, event_id	Alta
`reminders_enabled`	count, event_id	Alta
`inc_alert_overridden`	med_id, both_checked	Critica
`post_check_completed`	med_id, result, days_after	Alta
`medication_restarted`	med_id, delay_days	Alta

12. Archivos del Modulo¶

12.1. Flujos¶

flows/UIF-INT-002-interacciones-estudios.md

12.2. Pantallas¶

screens/SCR-IES-001-alerta-afe.md
screens/SCR-IES-002-alerta-sus.md
screens/SCR-IES-003-alerta-inc.md
screens/SCR-IES-004-alerta-pos.md
screens/SCR-IES-005-calendario-suspension.md
screens/SCR-IES-006-confirmacion-post-estudio.md

12.3. Especificacion Consolidada¶

specs/UI-MTS-INT-002.md (este documento)

13. Referencias¶

13.1. Especificacion Funcional¶

MTS-INT-002 - Interacciones Med-Estudio

13.2. Modulos Relacionados¶

13.3. Design System¶

14. Historial de Cambios¶

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

15. Aprobaciones¶

Rol	Nombre	Estado	Fecha
UX Lead	MobileUxUiDrone	Completado	2025-12-05
A11y Review	Pendiente	-	-
Product Owner	Pendiente	-	-
Clinical Review	Pendiente	-	-

Documento generado por MobileUxUiDrone (Eight of Eight) "Preparacion informada, resultados confiables."