Especificacion UI Consolidada - Notificaciones Inteligentes

Modulo: MTS-NTF-001 - Notificaciones Inteligentes Version: 1.0.0 Fecha: 2025-12-05 Autor: MobileUxUiDrone (Eight of Eight) Estado: Especificado FASE: 2 - Value

---

1. Vision General del Modulo UI

1.1. Proposito

Este documento consolida la especificacion de interfaz de usuario para el modulo de Notificaciones Inteligentes, que utiliza machine learning on-device (CoreML/TensorFlow Lite) para optimizar recordatorios de medicamentos basandose en patrones de comportamiento del usuario.

PRINCIPIO FUNDAMENTAL - 100% OFFLINE (OBS-066): Todas las funcionalidades de este modulo operan completamente offline. El procesamiento ML se ejecuta en el dispositivo del usuario, garantizando privacidad total.

1.2. Pantallas del Modulo

ID	Nombre	Tipo	Prioridad	Tier
SCR-NTF-001	Dashboard de Insights	Full Screen	Alta	Pro/Perfect
SCR-NTF-002	Patrones Detectados	Full Screen	Media	Pro/Perfect
SCR-NTF-003	Sugerencia de Ajuste	Bottom Sheet	Alta	Pro/Perfect
SCR-NTF-004	Alertas Predictivas	Full Screen	Media	Perfect
SCR-NTF-005	Configuracion Modo Inteligente	Full Screen	Alta	Pro/Perfect
SCR-NTF-006	Historial de Predicciones	Full Screen	Baja	Pro/Perfect
SCR-NTF-007	Feedback de Prediccion	Bottom Sheet	Media	Pro/Perfect
SCR-NTF-008	Preferencias de ML	Full Screen	Baja	Perfect

1.3. Disponibilidad por Tier

Funcionalidad	Free	Pro	Perfect
Alertas estandar	Si	Si	Si
Deteccion de patrones	No	Basico	Completo
Sugerencias de horario	No	Si	Si
Alertas predictivas	No	No	Si
Dashboard de insights	No	Basico	Completo
Configuracion ML avanzada	No	No	Si

---

2. Flujo de Navegacion

2.1. Diagrama Principal

flowchart TD
    subgraph Entry["Puntos de Entrada"]
        CONFIG[Configuracion App]
        SUGGEST[Sugerencia Push]
        ALERT[Alerta Predictiva]
        SETTINGS[Tab Settings]
    end

    subgraph MainFlow["Flujo Principal"]
        DASH[SCR-NTF-001<br/>Dashboard Insights]
        PATTERNS[SCR-NTF-002<br/>Patrones Detectados]
        SUGGESTION[SCR-NTF-003<br/>Sugerencia Ajuste]
        PREDICTIVE[SCR-NTF-004<br/>Alertas Predictivas]
    end

    subgraph ConfigFlow["Flujo de Configuracion"]
        MODE[SCR-NTF-005<br/>Modo Inteligente]
        MLPREFS[SCR-NTF-008<br/>Preferencias ML]
    end

    subgraph FeedbackFlow["Flujo de Feedback"]
        HISTORY[SCR-NTF-006<br/>Historial]
        FEEDBACK[SCR-NTF-007<br/>Feedback]
    end

    CONFIG --> MODE
    SUGGEST --> SUGGESTION
    ALERT --> DASH
    SETTINGS --> DASH

    DASH -->|Ver patrones| PATTERNS
    DASH -->|Ver alertas| PREDICTIVE
    DASH -->|Sugerencia activa| SUGGESTION
    DASH -->|Configurar| MODE

    PATTERNS -->|Tap patron| SUGGESTION
    PATTERNS -->|Ver historial| HISTORY

    SUGGESTION -->|Aceptar| APPLY[Aplicar cambio]
    SUGGESTION -->|Rechazar| FEEDBACK
    APPLY --> DASH

    MODE -->|Avanzado| MLPREFS
    HISTORY -->|Tap item| FEEDBACK

2.2. Deep Links

Deep Link	Destino	Parametros
medtime://notifications/smart	SCR-NTF-001	-
medtime://notifications/suggestion/{id}	SCR-NTF-003	suggestion_id
medtime://notifications/patterns	SCR-NTF-002	-
medtime://notifications/config	SCR-NTF-005	-

---

3. User Journeys

3.1. Journey: Paciente Independiente (PI) - Configurar Notificaciones Inteligentes

Persona: Juan, 58 anos, toma 3 medicamentos y olvida frecuentemente la toma de mediodia.

journey
    title Juan configura notificaciones inteligentes
    section Descubrimiento
      Ve sugerencia en dashboard: 4: Juan
      Lee descripcion del patron: 5: Juan
      Interesado en la optimizacion: 5: Juan
    section Configuracion
      Tap en sugerencia: 5: Juan
      Ve datos de su patron: 4: Juan
      Lee recomendacion: 5: Juan
    section Decision
      Revisa nuevo horario propuesto: 4: Juan
      Acepta cambio de 14:00 a 13:00: 5: Juan
      Ve confirmacion: 5: Juan
    section Seguimiento
      Recibe notificacion optimizada: 5: Juan
      Mejor adherencia en mediodia: 5: Juan

3.1.1. Pasos Detallados

Paso	Pantalla	Accion	Siguiente
1	SCR-ADH-001	Ve insight card de patron	-
2	SCR-NTF-001	Tap "Ver detalles"	SCR-NTF-001
3	SCR-NTF-001	Ve resumen de patrones	-
4	SCR-NTF-001	Tap sugerencia activa	SCR-NTF-003
5	SCR-NTF-003	Lee datos del patron	-
6	SCR-NTF-003	Ve horario sugerido	-
7	SCR-NTF-003	Tap "Aceptar cambio"	Confirmacion
8	SCR-NTF-001	Ve confirmacion	-

---

4. Catalogo de Pantallas

4.1. SCR-NTF-001 - Dashboard de Insights

Proposito: Vista principal de patrones detectados y estado de notificaciones inteligentes.

Estados:

• Activo (>= 14 dias datos)
• Recopilando (< 14 dias)
• Desactivado

Wireframe (Estado Activo):

+------------------------------------------+
|  [<]    Notificaciones Inteligentes       |
+------------------------------------------+
|                                           |
|  [Cerebro]  Sistema activo               |
|             Aprendiendo hace 28 dias     |
|                              [ON/OFF]    |
|                                           |
|  RESUMEN SEMANAL                          |
|  +-----------------------------------------+
|  |  Tomas a tiempo:     45/52 (87%)      |
|  |  Tiempo promedio:    4.2 min          |
|  |  Mejor dia:          Martes (95%)     |
|  |  Dia a mejorar:      Sabado (72%)     |
|  +-----------------------------------------+
|                                           |
|  SUGERENCIA ACTIVA                        |
|  +-----------------------------------------+
|  |  Ajustar horario recomendado          |
|  |  Metformina: 08:00 -> 07:30           |
|  |  Confianza: 94%                       |
|  |  [Ver detalles]  [Aplicar]            |
|  +-----------------------------------------+
|                                           |
|  PATRONES DETECTADOS                      |
|  +-----------------------------------------+
|  |  Horario consistente  [>]             |
|  |  Sabado problematico  [>]             |
|  |  Respuesta lenta      [>]             |
|  +-----------------------------------------+
+------------------------------------------+

4.2. SCR-NTF-002 - Patrones Detectados

Proposito: Lista detallada de todos los patrones de comportamiento identificados.

Tipos de Patrones:

Tipo	Icono	Descripcion
HORARIO_CONSISTENTE	Reloj	Usuario toma a hora diferente a configurada
DIA_PROBLEMATICO	Calendario	Dia especifico con baja adherencia
RESPUESTA_LENTA	Cronometro	Demora en responder alertas
POSPONEDOR_SERIAL	Flechas	Pospone frecuentemente
HORARIO_VARIABLE	Random	Sin patron consistente

4.3. SCR-NTF-003 - Sugerencia de Ajuste

Proposito: Mostrar propuesta de cambio basada en patrones con opcion de aceptar/rechazar.

Tipos de Sugerencia:

• Ajuste de hora
• Recordatorio extra
• Alerta anticipada

Reglas de Negocio:

Accion	Comportamiento
Aceptar	Cambia horario, registra para ML
Mantener	No cambia, no sugiere por 30 dias
Ignorar	No cambia, reintenta en 7 dias

4.4. SCR-NTF-004 - Alertas Predictivas

Proposito: Configuracion de alertas proactivas basadas en prediccion de omision. Disponibilidad: Solo Perfect tier.

Niveles de Riesgo:

Nivel	Porcentaje	Color
Bajo	< 40%	Verde
Medio	40-60%	Amarillo
Alto	> 60%	Rojo

4.5. SCR-NTF-005 - Configuracion Modo Inteligente

Proposito: Settings completos de notificaciones inteligentes.

Modos Disponibles:

Modo	Free	Pro	Perfect
Estandar	Si	Si	Si
Inteligente	No	Si	Si
Agresivo	No	Si	Si

4.6. SCR-NTF-006 - Historial de Predicciones

Proposito: Registro de predicciones pasadas y su precision.

Estados de Resultado:

Estado	Color	Descripcion
Pendiente	Gris	Aun no evaluado
Acertada	Verde	Prediccion correcta
Falsa alarma	Amarillo	Alerta innecesaria
No detectada	Rojo	Omision no prevista

4.7. SCR-NTF-007 - Feedback de Prediccion

Proposito: Retroalimentacion del usuario para mejorar el modelo ML.

Tipos de Feedback:

• Falsa alarma: Dia especial, Cambio rutina, Sin sentido
• Prediccion acertada: Ayudo a recordar, No la vi, Iba a tomar

4.8. SCR-NTF-008 - Preferencias de ML

Proposito: Configuracion avanzada del modelo de machine learning local. Disponibilidad: Solo Perfect tier.

Opciones:

• Frecuencia de reentrenamiento (Diario/Semanal/Mensual)
• Reiniciar modelo
• Exportar/Borrar datos de entrenamiento
• Ver metricas del modelo (precision, recall)

---

5. Componentes Nuevos

5.1. Catalogo de Componentes del Modulo

ID	Nombre	Tipo	Usado en
CMP-NTF-001	SmartStatusCard	Card	SCR-NTF-001
CMP-NTF-002	WeeklySummaryCard	Card	SCR-NTF-001
CMP-NTF-003	SuggestionCard	Card	SCR-NTF-001
CMP-NTF-004	PatternListItem	List Item	SCR-NTF-001, SCR-NTF-002
CMP-NTF-005	PatternCardExpanded	Card	SCR-NTF-002
CMP-NTF-006	ConfidenceBadge	Badge	SCR-NTF-002, SCR-NTF-003
CMP-NTF-007	AnalysisDataCard	Card	SCR-NTF-003
CMP-NTF-008	TimeComparison	Display	SCR-NTF-003
CMP-NTF-009	PredictiveHeaderCard	Card	SCR-NTF-004
CMP-NTF-010	RiskPredictionCard	Card	SCR-NTF-004
CMP-NTF-011	PredictionSummaryCard	Card	SCR-NTF-006
CMP-NTF-012	PredictionHistoryItem	List Item	SCR-NTF-006

5.2. Especificacion de Componentes Clave

5.2.1. CMP-NTF-001 - SmartStatusCard

Estados Visuales:
| Estado | Color BG | Icono | Texto |
|--------|----------|-------|-------|
| Activo | success.50 | Cerebro activo | "Sistema activo" |
| Aprendiendo | warning.50 | Cerebro loading | "Aprendiendo..." |
| Desactivado | neutral.100 | Cerebro dormido | "Desactivado" |

5.2.2. CMP-NTF-003 - SuggestionCard

Propiedades:
- Border: 2dp primary.500 pulsante (si activa)
- Icono: Bombilla
- Contenido: Medicamento, hora actual vs sugerida
- Confianza: Badge con porcentaje
- Actions: "Ver detalles", "Aplicar"

5.2.3. CMP-NTF-010 - RiskPredictionCard

Niveles:
| Nivel | Porcentaje | Color | Icono |
|-------|-----------|-------|-------|
| Bajo | < 40% | success.500 | Circulo verde |
| Medio | 40-60% | warning.500 | Circulo amarillo |
| Alto | > 60% | error.500 | Circulo rojo |

---

6. Datos y Modelos

6.1. Estructura de Datos Principal

interface SmartNotificationsData {
  // Estado del sistema
  isEnabled: boolean;
  status: 'ACTIVE' | 'LEARNING' | 'DISABLED';
  daysCollecting: number;
  daysRequired: number;           // 14

  // Resumen semanal
  weeklySummary?: WeeklySummary;

  // Sugerencia activa
  activeSuggestion?: Suggestion;

  // Patrones detectados
  patterns: DetectedPattern[];

  // Adherencia por dia
  dayAdherence: DayAdherence[];

  // Progreso de aprendizaje
  learningProgress: number;
  daysRemaining: number;
}

interface Suggestion {
  id: string;
  type: 'ADJUST_TIME' | 'ADD_REMINDER' | 'DAY_SPECIFIC';
  medicationId: string;
  medicationName: string;
  currentTime: string;
  suggestedTime: string;
  confidence: number;
  reason: string;
}

interface Pattern {
  id: string;
  type: PatternType;
  title: string;
  description: string;
  metrics: PatternMetric[];
  confidence: number;
  suggestedAction: {
    label: string;
    type: string;
    payload: any;
  };
}

type PatternType =
  | 'HORARIO_CONSISTENTE'
  | 'HORARIO_VARIABLE'
  | 'DIA_PROBLEMATICO'
  | 'RESPUESTA_LENTA'
  | 'POSPONEDOR_SERIAL';

6.2. Eventos de Output

Pantalla	Evento	Payload
SCR-NTF-001	onToggle	enabled
SCR-NTF-001	onSuggestionTap	suggestion_id
SCR-NTF-001	onApplySuggestion	suggestion_id
SCR-NTF-003	onAccept	suggestion_id
SCR-NTF-003	onReject	suggestion_id
SCR-NTF-004	onThresholdChange	threshold
SCR-NTF-005	onModeChange	mode
SCR-NTF-007	onFeedbackSubmit	feedback_data

---

7. Accesibilidad

7.1. Cumplimiento WCAG 2.1 AA

Criterio	Implementacion
1.1.1 Non-text Content	Todos los iconos tienen labels descriptivos
1.3.1 Info and Relationships	Estructura semantica correcta
1.4.3 Contrast	Minimo 4.5:1 para texto
2.1.1 Keyboard	Navegacion completa con teclado
2.4.6 Headings and Labels	Titulos descriptivos por seccion
4.1.2 Name, Role, Value	Componentes con roles ARIA correctos

7.2. Labels de Accesibilidad

Pantalla	Elemento	accessibilityLabel
SCR-NTF-001	Toggle	"Notificaciones inteligentes, {estado}"
SCR-NTF-001	Suggestion	"Sugerencia: cambiar {med} de {hora1} a {hora2}"
SCR-NTF-003	Accept	"Aceptar cambio de horario"
SCR-NTF-004	Risk level	"Riesgo de omision: {nivel}, {porcentaje}%"
SCR-NTF-006	History item	"Prediccion {estado}: {medicamento}"

---

8. Metricas y Analytics

8.1. KPIs del Modulo

Metrica	Objetivo	Medicion
Tasa activacion inteligentes	> 60%	analytics
Sugerencias aceptadas	> 50%	analytics
Precision prediccion	> 70%	ML metrics
Tasa desactivacion	< 10%	analytics

8.2. Eventos de Analytics

Evento	Pantalla	Parametros
screen_view	Todas	screen_name
smart_toggle	SCR-NTF-001	enabled, days_collected
suggestion_view	SCR-NTF-003	suggestion_id, confidence
suggestion_accept	SCR-NTF-003	suggestion_id, time_to_decide
suggestion_reject	SCR-NTF-003	suggestion_id
pattern_action	SCR-NTF-002	pattern_id, action_type
predictive_toggle	SCR-NTF-004	enabled
mode_change	SCR-NTF-005	from, to, tier
feedback_submit	SCR-NTF-007	prediction_id, feedback_code
model_reset	SCR-NTF-008	days_lost

---

9. Transiciones y Animaciones

9.1. Transiciones Entre Pantallas

De	A	Tipo	Duracion
DASH	PATTERNS	Slide right	300ms
DASH	SUGGESTION	Modal bottom sheet	300ms
DASH	MODE	Slide right	300ms
SUGGESTION	Aplicar	Scale down + check	500ms
SUGGESTION	FEEDBACK	Slide up	300ms

9.2. Animaciones Especificas

Elemento	Animacion	Trigger
Grafico patrones	Draw line	onMount
Sugerencia card	Pulse border	Si nueva
Confianza %	Count up	onMount
Toggle inteligente	Expand/collapse	onChange

---

10. Integracion con Otros Modulos

10.1. Dependencias

Modulo	Tipo	Descripcion
MTS-ALT-001	Extiende	Sistema de alertas base
MTS-ADH-001	Consume	Datos de tomas para patrones
MTS-MED-001	Modifica	Horarios de medicamentos
MTS-USR-001	Consume	Configuracion por perfil

10.2. Componentes Reutilizados

Componente	De Modulo	Uso
CMP-ADH-006	MTS-ADH-001	Barras de adherencia por dia
CMP-CRD-001	Core	Cards de medicamentos
CMP-FBK-004	Core	Banners informativos
CMP-BTN-001/002/003	Core	Botones de accion
CMP-INP-009	Core	Segmented controls

---

11. Estados del Sistema

11.1. Estados de Notificaciones Inteligentes

Estado	Condicion	Indicador UI
Desactivado	Toggle OFF	Gris, sin datos
Recopilando	< 14 dias datos	Amarillo, barra progreso
Activo	>= 14 dias	Verde, funcionando
Sugerencia pendiente	Hay sugerencia	Badge azul pulsante

11.2. Flujo de Estados

stateDiagram-v2
    [*] --> Desactivado: Primera vez
    Desactivado --> Recopilando: Toggle ON
    Recopilando --> Activo: 14 dias datos
    Activo --> Desactivado: Toggle OFF
    Desactivado --> Activo: Toggle ON (si >= 14 dias previos)

---

12. Referencias

12.1. Documentos de Especificacion

• MTS-NTF-001 - Especificacion Funcional
• UIF-NTF-001 - Flujo de Navegacion

12.2. Pantallas Individuales

• SCR-NTF-001 - Dashboard de Insights
• SCR-NTF-002 - Patrones Detectados
• SCR-NTF-003 - Sugerencia de Ajuste
• SCR-NTF-004 - Alertas Predictivas
• SCR-NTF-005 - Configuracion Modo Inteligente
• SCR-NTF-006 - Historial de Predicciones
• SCR-NTF-007 - Feedback de Prediccion
• SCR-NTF-008 - Preferencias de ML

12.3. Guias de Diseno

• 02-component-library.md
• 03-accessibility-guidelines.md

---

Documento generado por MobileUxUiDrone (Eight of Eight) "Notificaciones que aprenden son notificaciones que funcionan."