Especificacion UI Consolidada - Alertas y Notificaciones¶

Identificador: UI-MTS-ALT-001 Modulo: MTS-ALT-001 - Alertas y Notificaciones Version: 1.0.0 Fecha: 2025-12-05 Autor: MobileUxUiDrone (Eight of Eight) Estado: Especificado

1. Resumen Ejecutivo¶

Este documento consolida la especificacion completa de interfaz de usuario para el modulo de Alertas y Notificaciones de MedTime. El modulo es el corazon del sistema de recordatorios y representa la funcionalidad mas critica para la adherencia al tratamiento.

1.1. Metricas del Modulo¶

Metrica	Valor
Total de pantallas	15
Pantallas criticas	5 (SCR-ALT-001, 005, 007, 008, 009)
Pantallas alta prioridad	6
Pantallas media prioridad	3
Pantallas baja prioridad	1
User journeys documentados	4
Flujos Mermaid	8
Componentes unicos	18
Nivel WCAG	AA (con elementos AAA para criticos)

2. Inventario de Pantallas¶

2.1. Pantallas Criticas (Prioridad Maxima)¶

ID	Nombre	Tipo	Archivo
SCR-ALT-001	Recordatorio de Toma	System Notification	SCR-ALT-001
SCR-ALT-005	Alerta de Emergencia	Full Screen Modal	SCR-ALT-005
SCR-ALT-007	Alerta de Interaccion	Modal / Full Screen	SCR-ALT-007
SCR-ALT-008	Alerta de Valores Criticos	Full Screen Modal	SCR-ALT-008
SCR-ALT-009	Centro de Notificaciones	Tab Screen	SCR-ALT-009

2.2. Pantallas de Alta Prioridad¶

ID	Nombre	Tipo	Archivo
SCR-ALT-002	Detalle de Alerta Pendiente	Full Screen / Bottom Sheet	SCR-ALT-002
SCR-ALT-004	Configuracion de Notificaciones	Settings Screen	SCR-ALT-004
SCR-ALT-006	Configuracion de Cuidadores	Settings Screen	SCR-ALT-006
SCR-ALT-012	Contactos de Emergencia	Settings Screen	SCR-ALT-012
SCR-ALT-013	Vista Cuidador - Alertas	Tab Screen Variant	SCR-ALT-013
SCR-ALT-015	Confirmacion de Accion	Bottom Sheet Modal	SCR-ALT-015

2.3. Pantallas de Media Prioridad¶

ID	Nombre	Tipo	Archivo
SCR-ALT-003	Historial de Alertas	List Screen	SCR-ALT-003
SCR-ALT-010	Configuracion de Sonidos	Settings Screen	SCR-ALT-010
SCR-ALT-011	Modo No Molestar	Settings Screen	SCR-ALT-011

2.4. Pantallas de Baja Prioridad¶

ID	Nombre	Tipo	Archivo
SCR-ALT-014	Resumen Diario	Notification + Detail	SCR-ALT-014

3. Flujos de Navegacion¶

3.1. Flujo Principal¶

Documentado en: UIF-ALT-001

flowchart LR
    NOTIF[Notificacion] --> ACTION[Quick Action]
    NOTIF --> CENTER[Centro Notif]
    CENTER --> DETAIL[Detalle]
    CENTER --> HISTORY[Historial]
    CENTER --> CONFIG[Configuracion]
    ACTION --> CONFIRM[Confirmacion]

3.2. Puntos de Entrada¶

Punto	Destino	Contexto
Push notification	SCR-ALT-001 / SCR-ALT-002	Recordatorio de toma
Local notification	SCR-ALT-001 / SCR-ALT-002	Recordatorio offline
Bottom nav tab	SCR-ALT-009	Centro de notificaciones
Widget home	SCR-ALT-005	Boton de panico
Shake gesture	SCR-ALT-005	Emergencia rapida
Deep link	Varias	Ver seccion deep links

4. User Journeys¶

4.1. Resumen de Journeys¶

ID	Persona	Nombre	Pantallas
JRN-ALT-PI	Paciente Independiente	Recibir recordatorio de medicamento	SCR-ALT-001, 002, 015
JRN-ALT-PD	Paciente Dependiente	Recordatorio simplificado	SCR-ALT-001 (full screen mode)
JRN-ALT-CS	Cuidador Secundario	Recibir alerta de paciente	SCR-ALT-013, 002
JRN-ALT-CR	Cuidador Responsable	Gestionar alertas de dependientes	SCR-ALT-006, 012, 013

4.2. Flujos Criticos¶

4.2.1. Flujo de Toma de Medicamento¶

Usuario recibe notificacion
    |
    v
Expande notificacion (opcional)
    |
    +---> Tap "Tomado" --> Confirmacion --> Cierra
    |
    +---> Tap "Posponer" --> Selector tiempo --> Nueva notificacion
    |
    +---> Tap "Ver" --> SCR-ALT-002 --> Acciones completas

4.2.2. Flujo de Emergencia¶

Activacion (shake/widget/menu)
    |
    v
Countdown 5 segundos
    |
    +---> Cancelar --> Registrar, cerrar
    |
    +---> Timeout --> Enviar alertas
                         |
                         v
                      Confirmacion
                         |
                         +---> Llamar 911
                         +---> Cerrar

5. Componentes UI Utilizados¶

5.1. Componentes Nuevos del Modulo¶

ID	Nombre	Uso Principal
CMP-CRD-010	Alert Banner	Banner critico en centro notif
CMP-CRD-011	Alert Card	Card de alerta en listas
CMP-CRD-012	Escalated Alert Card	Alerta para cuidadores
CMP-CRD-013	Schedule Card	Horarios de silencio
CMP-CRD-014	Status Banner	DND activo
CMP-CRD-015	Emergency Contact Card	Contactos emergencia
CMP-CRD-016	Escalated Alert	Alerta escalada
CMP-CRD-017	Summary Card	Resumen paciente
CMP-CRD-018	Stat Card	Estadisticas
CMP-DAT-009	Circular Progress	Adherencia %
CMP-DAT-010	Mini Bar Chart	Tendencia semanal
CMP-INP-013	Pill Selector	Selector tiempo posponer
CMP-ANM-001	Success Animation	Confirmacion toma

5.2. Componentes Reutilizados¶

ID	Nombre	De Modulo
CMP-NAV-001	Bottom Navigation	Shared
CMP-NAV-002	Top App Bar	Shared
CMP-BTN-001	Primary Button	Shared
CMP-CRD-001	Medication Card	MTS-MED-001
CMP-INP-003	Text Area	Shared
CMP-INP-008	Radio Group	Shared

6. Auditoria de Accesibilidad WCAG 2.1 AA¶

6.1. Resumen de Cumplimiento¶

Criterio	Estado	Notas
1.1.1 Non-text Content	Cumple	Alt text en todos los iconos
1.3.1 Info and Relationships	Cumple	Estructura semantica correcta
1.4.1 Use of Color	Cumple	Nunca solo color para informacion
1.4.3 Contrast (Minimum)	Cumple	4.5:1 minimo
1.4.11 Non-text Contrast	Cumple	3:1 para controles
2.1.1 Keyboard	Cumple	Toda funcionalidad accesible
2.4.3 Focus Order	Cumple	Orden logico documentado
2.4.6 Headings and Labels	Cumple	Labels descriptivos
2.4.7 Focus Visible	Cumple	Indicador de foco visible
3.2.1 On Focus	Cumple	Sin cambios automaticos
3.3.1 Error Identification	Cumple	Errores claramente indicados
4.1.2 Name, Role, Value	Cumple	ARIA labels correctos

6.2. Pantallas con Requisitos Especiales (AAA)¶

Las siguientes pantallas tienen requisitos de accesibilidad elevados debido a su naturaleza critica:

Pantalla	Requisito	Implementacion
SCR-ALT-005	Alto contraste 7:1	Fondo blanco, texto negro/rojo
SCR-ALT-005	Touch target 64dp	Botones enormes
SCR-ALT-005	TTS automatico	Lee alerta al abrir
SCR-ALT-007	Checkbox obligatorio	Confirmar lectura de riesgo
SCR-ALT-008	Timer accesible	Anuncios cada segundo
SCR-ALT-001 (PD)	Modo simplificado	Texto 24sp+, 1 boton

6.3. Consideraciones por Discapacidad¶

Tipo	Consideraciones Implementadas
Visual	Alto contraste, texto grande, iconos claros
Auditiva	Vibracion, LED, texto siempre visible
Motriz	Touch targets grandes, sin gestos complejos
Cognitiva	Lenguaje simple, acciones claras, confirmaciones

7. Consideraciones por Tier¶

7.1. Matriz de Funcionalidades UI¶

Funcionalidad UI	Free	Pro	Perfect
Notificaciones locales	Si	Si	Si
Acciones desde notificacion	Si	Si	Si
Centro de notificaciones	Si	Si	Si
Historial (90 dias)	Si	-	-
Historial (1 ano)	-	Si	-
Historial (6 anos)	-	-	Si
Configuracion basica	Si	Si	Si
Sonidos adicionales	-	Si	Si
Sonido personalizado	-	-	Si
Modo DND multiples	-	Si	Si
Vista cuidador	-	Si	Si
Escalamiento	-	Si	Si
Contactos (2)	Si	-	-
Contactos (10)	-	Si	Si
SMS servidor	-	Si	Si
Resumen a cuidadores	-	Si	Si
Export PDF	-	-	Si

7.2. Upsell Points¶

Lugares en la UI donde se muestran opciones de upgrade:

Pantalla	Contexto	CTA
SCR-ALT-004	Opciones bloqueadas	Ver planes
SCR-ALT-006	Limite sync alcanzado	Ver Perfect
SCR-ALT-010	Sonidos premium	Pro badge
SCR-ALT-012	Limite contactos	Ver Pro

8. Estados de Error¶

8.1. Errores Comunes¶

Error	Pantalla	Manejo UI
Sin conexion	Todas	Banner offline, datos cache
Fallo envio SMS	SCR-ALT-005	Retry + fallback push
Numero invalido	SCR-ALT-012	Inline error + sugerencia
Permiso denegado	SCR-ALT-001	Modal explicativo + settings
Timeout API	SCR-ALT-009	Retry button + snackbar

8.2. Fallbacks¶

Situacion	Fallback
Push falla	Local notification
SMS falla	Push + Email
Servidor caido	Notificaciones locales
App cerrada	Background service (Android), UNNotification (iOS)

9. Metricas y Analytics¶

9.1. KPIs del Modulo¶

KPI	Objetivo	Medicion
Tiempo respuesta a alerta	< 60s	Promedio
Tasa confirmacion desde notif	> 70%	%
Tasa uso posponer	< 20%	%
Alertas escaladas	< 5%	%
Falsas alarmas emergencia	< 1%	%
Completitud configuracion	> 80%	% usuarios

9.2. Eventos a Trackear¶

Categoria	Eventos
Notificaciones	shown, action, dismissed, response_time
Centro	view, filter, tap_alert, history_view
Emergencia	activated, cancelled, sent, 911_call
Configuracion	changed, tested, carer_added
Cuidador	alert_received, action_taken, response_time

10. Dependencias¶

10.1. Modulos Relacionados¶

Modulo	Relacion
MTS-MED-001	Medicamentos a recordar
MTS-CAL-001	Calendario de tomas
MTS-FAM-001	Perfiles de cuidadores
MTS-EVT-001	Eventos de salud
MTS-INT-001	Interacciones
MTS-ADH-001	Calculo de adherencia

10.2. Servicios Externos¶

Servicio	Uso
FCM (Firebase)	Push Android
APNS	Push iOS
Twilio	SMS (Pro/Perfect)
Email provider	Alertas email

11. Archivos Generados¶

11.1. Flujos¶

Archivo	Descripcion
`flows/UIF-ALT-001-alertas-notificaciones.md`	Flujo principal completo

11.2. Pantallas¶

Archivo	Descripcion
`screens/SCR-ALT-001-recordatorio-toma.md`	Notificacion de recordatorio
`screens/SCR-ALT-002-detalle-alerta.md`	Detalle de alerta
`screens/SCR-ALT-003-historial-alertas.md`	Historial
`screens/SCR-ALT-004-configuracion-notificaciones.md`	Configuracion
`screens/SCR-ALT-005-alerta-emergencia.md`	Emergencia
`screens/SCR-ALT-006-configuracion-cuidadores.md`	Cuidadores
`screens/SCR-ALT-007-alerta-interaccion.md`	Interacciones
`screens/SCR-ALT-008-alerta-valores-criticos.md`	Valores criticos
`screens/SCR-ALT-009-centro-notificaciones.md`	Centro notificaciones
`screens/SCR-ALT-010-configuracion-sonidos.md`	Sonidos
`screens/SCR-ALT-011-modo-no-molestar.md`	DND
`screens/SCR-ALT-012-contactos-emergencia.md`	Contactos
`screens/SCR-ALT-013-vista-cuidador-alertas.md`	Vista cuidador
`screens/SCR-ALT-014-resumen-diario.md`	Resumen
`screens/SCR-ALT-015-confirmacion-accion.md`	Confirmacion

12. Historial de Cambios¶

Version	Fecha	Cambios
1.0.0	2025-12-05	Version inicial con 15 pantallas, 4 journeys, auditoria WCAG

13. Firmas¶

Rol	Nombre	Estado
Autor	MobileUxUiDrone	Completado
Revision UX	Pendiente	-
Revision Accesibilidad	Pendiente	-
Aprobacion	Pendiente	-

Documento generado por MobileUxUiDrone (Eight of Eight) "Las alertas son el latido del sistema - nunca deben fallar."