Modulo de Gamificacion¶

Identificador: MTS-GAM-001 Version: 1.2.0 Fecha: 2025-12-01 Ultima Revision: Iteracion 6 - ACL5-007 Logros de eventos de salud (mediciones y tratamientos) Autor: SpecQueen

1. Propósito
2. Disponibilidad por Tier
3. Filosofía de Diseño
3.1. Principios
3.2. Lo que NO es
4. Elementos de Gamificación
4.1. Sistema de Puntos
- 4.1.1. Obtención de Puntos
- 4.1.2. Uso de Puntos
4.2. Sistema de Niveles
- 4.2.1. Progresión de Niveles
- 4.2.2. Visualización de Nivel
4.3. Sistema de Logros
- 4.3.1. Categorías de Logros
- 4.3.2. Logros de Rachas
- 4.3.3. Logros de Hitos
- 4.3.4. Logros de Exploración
- 4.3.5. Logros Especiales
4.4. Logros de Eventos de Salud (ACL5-007)
- 4.4.1. Logros de Mediciones
- 4.4.2. Logros de Tratamientos
- 4.4.3. Lo que NO se gamifica (Valores de Medicion)
- 4.4.4. Desactivacion de Gamificacion para Eventos
4.5. Sistema de Rachas
- 4.5.1. Definición
- 4.5.2. Visualización
- 4.5.3. Protección de Racha (Premium)
4.6. Personalizacion Desbloqueada
- 4.6.1. Temas de Color
- 4.6.2. Sonidos de Notificación
- 4.6.3. Iconos de App (iOS)
5. Funcionalidades
5.1. Centro de Logros (MTS-GAM-001-F01)
- 5.1.1. Descripción
- 5.1.2. Componentes
5.2. Notificaciones de Logros (MTS-GAM-001-F02)
- 5.2.1. Descripción
- 5.2.2. Presentación
- 5.2.3. Comportamiento
5.3. Compartir Logros (MTS-GAM-001-F03)
- 5.3.1. Descripción
- 5.3.2. Contenido Compartible
- 5.3.3. Privacidad
5.4. Configuración de Gamificación (MTS-GAM-001-F04)
- 5.4.1. Opciones
- 5.4.2. Desactivación
6. Reglas de Negocio
6.1. Definición de Racha (Iteración 13)
7. Modelo de Datos
7.1. Entidad ProgresoGamificacion
7.2. Entidad LogroUsuario
7.3. Entidad LogroDefinicion
7.4. Entidad HistorialPuntos
8. Criterios de Aceptación
9. Referencias

1. Propósito¶

Este módulo implementa elementos de gamificación para motivar la adherencia al tratamiento, manteniendo un tono serio y respetuoso con la salud del paciente.

2. Disponibilidad por Tier¶

Tier	Disponibilidad
Free	No disponible - La gamificación es un incentivo para actualizar a Pro/Perfect
Pro	Disponible - Sistema completo de gamificación
Perfect	Disponible - Sistema completo con beneficios adicionales

Nota: Los usuarios Free no tienen acceso al sistema de gamificación. Esta funcionalidad está diseñada como uno de los beneficios de los tiers pagados para incentivar la suscripción.

3. Filosofía de Diseño¶

3.1. Principios¶

Principio	Descripción
Salud primero	La gamificación apoya, nunca trivializa la salud
Motivación intrínseca	Fomentar satisfacción personal, no dependencia de recompensas
Inclusión	Accesible para todas las edades y condiciones
Sin presión negativa	Nunca castigar o avergonzar por omisiones
Progreso visible	Mostrar avance tangible

3.2. Lo que NO es¶

No es un juego: Es una herramienta de salud con elementos motivacionales
No compite: No hay rankings públicos ni comparaciones con otros
No castiga: Las omisiones no quitan puntos ni logros obtenidos
No es obligatorio: Gamificación puede desactivarse completamente

4. Elementos de Gamificación¶

4.1. Sistema de Puntos¶

4.1.1. Obtención de Puntos¶

Acción	Puntos	Condición
Toma confirmada	10	Por cada toma registrada
Toma puntual	+5	Dentro de ventana de tiempo
Día completo	25	100% adherencia del día
Semana completa	100	100% adherencia de la semana
Primer uso del día	5	Abrir la app cada día
Completar perfil	50	Una vez
Añadir medicamento	20	Por medicamento nuevo
Configurar cuidador	30	Una vez

4.1.2. Uso de Puntos¶

Los puntos son indicadores de progreso
No se "gastan" ni intercambian
Acumulan para desbloquear niveles
Visibles en perfil del usuario

4.2. Sistema de Niveles¶

4.2.1. Progresión de Niveles¶

Nivel	Nombre	Puntos Requeridos	Beneficio
1	Iniciando	0	Acceso básico
2	Constante	500	Temas de color adicionales
3	Comprometido	1,500	Sonidos de notificación adicionales
4	Dedicado	3,500	Widgets personalizados
5	Responsable	7,000	Iconos de app alternativos
6	Admirable	12,000	Badge de perfil especial
7	Ejemplar	20,000	Acceso a estadísticas avanzadas
8	Inspirador	35,000	Temas premium
9	Extraordinario	55,000	Personalización completa
10	Leyenda	80,000	Todo desbloqueado

4.2.2. Visualización de Nivel¶

%%{init: {'theme':'base'}}%%
graph LR
    A[Nivel 4: Dedicado] --> B[4,200 / 7,000 puntos]
    B --> C[2,800 puntos para Nivel 5]

    style A fill:#4CAF50,stroke:#333,stroke-width:2px,color:#fff
    style B fill:#2196F3,stroke:#333,stroke-width:2px,color:#fff
    style C fill:#FF9800,stroke:#333,stroke-width:2px,color:#fff

4.3. Sistema de Logros¶

4.3.1. Categorías de Logros¶

Categoría	Descripción
Rachas	Consistencia en el tiempo
Hitos	Marcadores de progreso
Exploración	Uso de funcionalidades
Especiales	Eventos y fechas especiales

4.3.2. Logros de Rachas¶

Logro	Descripción	Puntos
Primera Racha	3 días consecutivos al 100%	50
Semana Perfecta	7 días consecutivos al 100%	100
Quincena Dorada	15 días consecutivos al 100%	200
Mes de Hierro	30 días consecutivos al 100%	500
Trimestre de Oro	90 días consecutivos al 100%	1,500
Semestre Platino	180 días consecutivos al 100%	3,000
Año Diamante	365 días consecutivos al 100%	10,000

4.3.3. Logros de Hitos¶

Logro	Descripción	Puntos
Primera Toma	Registrar primera toma	10
Cien Tomas	100 tomas registradas	100
Mil Tomas	1,000 tomas registradas	500
Diez Mil Tomas	10,000 tomas registradas	2,000
Un Mes Contigo	30 días usando la app	100
Medio Año	180 días usando la app	500
Aniversario	365 días usando la app	1,000

4.3.4. Logros de Exploración¶

Logro	Descripción	Puntos
Perfil Completo	Completar todos los datos de perfil	50
Primera Receta	Digitalizar primera receta	30
Previsor	Configurar inventario de medicamentos	30
En Compañía	Añadir primer cuidador	50
Reportero	Generar primer reporte de adherencia	30
Explorador	Usar todas las funcionalidades principales	100

4.3.5. Logros Especiales¶

Logro	Descripcion	Puntos
Early Adopter	Registrarse en el primer mes	100
Anio Nuevo Saludable	Toma completa el 1 de enero	50
Mi Cumpleanos	Toma completa en tu cumpleanos	50

4.4. Logros de Eventos de Salud (ACL5-007)¶

Decision ACL5-007: Gamificar solo consistencia/adherencia (no valores), opcion de desactivar.

4.4.1. Logros de Mediciones¶

Logro	Descripcion	Criterio	Puntos
Primera Medicion	Registra tu primera medicion	1 medicion	10
Medidor Consistente	7 dias consecutivos midiendo	7 dias	50
Monitor Dedicado	30 dias consecutivos midiendo	30 dias	200
Guardian de la Salud	90 dias consecutivos midiendo	90 dias	500
Maestro de Datos	365 dias consecutivos midiendo	365 dias	2000
Multi-Parametro	Medir 3+ tipos diferentes en un dia	3 tipos/dia	30
Disciplina Matutina	30 mediciones en ayunas consecutivas	30 ayuno	100
Constante como Reloj	100 mediciones a la misma hora (+/- 15 min)	100 mediciones	150

4.4.2. Logros de Tratamientos¶

Logro	Descripcion	Criterio	Puntos
Primera Curacion	Completa tu primera curacion	1 curacion	10
Cuidador de Mi Cuerpo	7 dias de tratamientos	7 dias	50
Terapia Constante	30 dias de terapia fisica	30 sesiones	200
Dialisis Perfecta	Mes sin omisiones de dialisis	30/30	300
Inyecciones al Dia	30 dias de inyecciones completas	30 dias	150
Tratamiento Documentado	10 tratamientos con fotos	10 con fotos	75
Sanador Dedicado	100 tratamientos completados	100 total	250

4.4.3. Lo que NO se gamifica (Valores de Medicion)¶

Aspecto	Razon	Alternativa
Valores especificos de glucosa	Evitar manipulacion de datos	Gamificar consistencia
"Valores en rango"	Puede generar ansiedad o falsificacion	Solo visualizar tendencias
Comparaciones con otros usuarios	Cada paciente es unico	Solo comparar con uno mismo
Predicciones de valores	Solo el medico interpreta	Mostrar tendencias neutras
Bajar de peso	Puede promover conductas nocivas	Gamificar registro consistente

4.4.4. Desactivacion de Gamificacion para Eventos¶

Los usuarios pueden desactivar la gamificacion especificamente para eventos de salud manteniendo la gamificacion de medicamentos, o viceversa.

+------------------------------------------+
|  Configuracion de Gamificacion           |
|------------------------------------------|
|  Gamificacion General:        [Activa]   |
|                                          |
|  Detalle por categoria:                  |
|  [X] Medicamentos                        |
|  [X] Mediciones de salud                 |
|  [X] Tratamientos                        |
|                                          |
|  Cuando desactivado:                     |
|  - No veras puntos ni logros de esa     |
|    categoria                             |
|  - Tu progreso se mantiene (invisible)  |
|  - Puedes reactivar en cualquier momento|
|                                          |
|  [Guardar]                              |
+------------------------------------------+

4.5. Sistema de Rachas¶

4.5.1. Definición¶

Una racha es una serie de días consecutivos con 100% de adherencia.

4.5.2. Visualización¶

%%{init: {'theme':'base'}}%%
graph TD
    A[🔥 RACHA ACTUAL 🔥] --> B[12 días]
    B --> C[Tu mejor racha: 23 días]
    C --> D[¡Faltan 11 días para superarla!]
    D --> E[Últimos 12 días: L M M J V S D L M M J V]
    E --> F[✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓]

    style A fill:#FF5722,stroke:#333,stroke-width:3px,color:#fff
    style B fill:#4CAF50,stroke:#333,stroke-width:2px,color:#fff
    style C fill:#2196F3,stroke:#333,stroke-width:2px,color:#fff
    style D fill:#FF9800,stroke:#333,stroke-width:2px,color:#fff
    style E fill:#9E9E9E,stroke:#333,stroke-width:1px,color:#fff
    style F fill:#4CAF50,stroke:#333,stroke-width:1px,color:#fff

4.5.3. Protección de Racha (Premium)¶

Característica	Descripción
Escudo de Racha	1 día de gracia por mes
Restauración	Recuperar racha perdida (una vez)

4.6. Personalizacion Desbloqueada¶

4.6.1. Temas de Color¶

Nivel	Temas Desbloqueados
1	Clásico (Azul), Oscuro
2	Verde Salud, Lavanda
4	Coral, Medianoche
6	Dorado, Cristal
8	Todos los temas

4.6.2. Sonidos de Notificación¶

Nivel	Sonidos Desbloqueados
1	Estándar, Suave
3	Campana, Arpa, Gota
5	Melodía, Zen, Naturaleza
7	Todos los sonidos

4.6.3. Iconos de App (iOS)¶

Nivel	Iconos Disponibles
1	Clásico
5	Minimalista, Oscuro
8	Gradiente, Dorado
10	Todos los iconos

5. Funcionalidades¶

5.1. Centro de Logros (MTS-GAM-001-F01)¶

5.1.1. Descripción¶

Pantalla donde el usuario ve todos sus logros y progreso.

5.1.2. Componentes¶

┌────────────────────────────────────────┐
│  MIS LOGROS                            │
│                                        │
│  Nivel 4: Dedicado    4,200 pts       │
│  █████████████████▓▓▓▓▓▓▓▓▓             │
│                                        │
├────────────────────────────────────────┤
│  RACHAS      [12 días actuales 🔥]     │
│  ✓ Primera Racha     ✓ Semana Perfecta │
│  ✓ Quincena Dorada   ○ Mes de Hierro   │
├────────────────────────────────────────┤
│  HITOS                                 │
│  ✓ Primera Toma      ✓ Cien Tomas      │
│  ○ Mil Tomas         ○ Diez Mil Tomas  │
├────────────────────────────────────────┤
│  EXPLORACIÓN                            │
│  ✓ Perfil Completo   ✓ Primera Receta  │
│  ✓ En Compañía       ○ Explorador      │
└────────────────────────────────────────┘
✓ = Obtenido  ○ = Pendiente

5.2. Notificaciones de Logros (MTS-GAM-001-F02)¶

5.2.1. Descripción¶

Celebración cuando el usuario obtiene un logro.

5.2.2. Presentación¶

┌────────────────────────────────────────┐
│                                        │
│           🌟 NUEVO LOGRO 🌟              │
│                                        │
│         [Medalla Quincena]             │
│                                        │
│         QUINCENA DORADA                │
│   15 días consecutivos al 100%         │
│                                        │
│           +200 puntos                  │
│                                        │
│        [¡Genial!]  [Compartir]         │
└────────────────────────────────────────┘

5.2.3. Comportamiento¶

Animación sutil (no intrusiva)
Sonido opcional (configurable)
No interrumpe flujos críticos
Puede descartarse rápidamente

5.3. Compartir Logros (MTS-GAM-001-F03)¶

5.3.1. Descripción¶

Permite compartir logros en redes sociales o con contactos.

5.3.2. Contenido Compartible¶

Elemento	Descripción
Logro	Imagen del logro obtenido
Racha	Días de racha actual
Nivel	Nivel alcanzado
Hito	Hitos de tomas/tiempo

5.3.3. Privacidad¶

Nunca se comparten nombres de medicamentos
No se comparten datos de salud
Solo se comparte el logro genérico
Usuario controla qué compartir

5.4. Configuración de Gamificación (MTS-GAM-001-F04)¶

5.4.1. Opciones¶

Opción	Descripción	Default
Activar gamificación	Habilitar sistema completo	Sí
Mostrar puntos	Ver puntos en dashboard	Sí
Mostrar racha	Ver racha en pantalla principal	Sí
Notificar logros	Alertas al obtener logros	Sí
Animaciones	Efectos visuales de celebración	Sí
Sonidos de logro	Sonido al obtener logro	Sí

5.4.2. Desactivación¶

Usuario puede desactivar completamente
Puntos y logros se mantienen (invisibles)
Puede reactivarse en cualquier momento
Sin juicio ni consecuencias negativas

6. Reglas de Negocio¶

Referencia Canónica (Iteración 11): Las reglas de negocio centrales se encuentran en 06-reglas-de-negocio.md. Ver RN-GAM-001 a RN-GAM-016 en el documento central para definiciones autoritativas.

6.1. Definición de Racha (Iteración 13)¶

Una racha es una serie de días consecutivos donde el usuario alcanza 100% de adherencia en todas sus tomas programadas de medicamentos.

Concepto	Definición
Inicio de racha	Primer día con 100% de adherencia
Continuación	Cada día subsiguiente con 100%
Ruptura	Cualquier día con <100% de adherencia
Racha máxima	Mayor número de días consecutivos históricamente
Protección (Pro/Perfect)	1 día de gracia por mes permite mantener racha

ID	Regla
RN-GAM-001	Puntos solo se obtienen, nunca se pierden
RN-GAM-002	Logros obtenidos son permanentes
RN-GAM-003	Racha se reinicia solo con día < 100% adherencia
RN-GAM-004	Medicamentos pausados no afectan racha
RN-GAM-005	Nivel nunca baja
RN-GAM-006	Contenido compartido nunca incluye datos de salud
RN-GAM-007	Gamificación desactivable sin perder progreso
RN-GAM-008	Un logro solo se obtiene una vez
RN-GAM-009	Puntos por toma solo se dan una vez por toma
RN-GAM-010	Celebración de logro no bloquea uso de la app
RN-GAM-011	Gamificación solo disponible para tier Pro y Perfect
RN-GAM-012	Al hacer upgrade de Free a Pro/Perfect, gamificacion inicia desde cero
RN-GAM-013	Al hacer downgrade de Pro/Perfect a Free, progreso se conserva (invisible)
RN-GAM-014	Gamificacion de eventos de salud solo aplica a consistencia, nunca a valores
RN-GAM-015	Usuario puede desactivar gamificacion por categoria (medicamentos, mediciones, tratamientos)
RN-GAM-016	Logros de eventos de salud no generan comparaciones con otros usuarios

7. Modelo de Datos¶

7.1. Entidad ProgresoGamificacion¶

ProgresoGamificacion {
  id: UUID (PK)
  usuario_id: UUID (FK)
  puntos_totales: integer
  nivel_actual: integer
  racha_actual: integer
  racha_maxima: integer
  fecha_inicio_racha: date
  tomas_totales: integer
  dias_totales: integer
  gamificacion_activa: boolean
  created_at: timestamp
  updated_at: timestamp
}

7.2. Entidad LogroUsuario¶

LogroUsuario {
  id: UUID (PK)
  usuario_id: UUID (FK)
  logro_id: string
  fecha_obtencion: timestamp
  puntos_otorgados: integer
  compartido: boolean
  created_at: timestamp
}

7.3. Entidad LogroDefinicion¶

LogroDefinicion {
  id: string (PK)
  categoria: enum [RACHA, HITO, EXPLORACION, ESPECIAL]
  nombre: string
  descripcion: string
  condicion: jsonb
  puntos: integer
  icono: string
  orden: integer
  activo: boolean
}

7.4. Entidad HistorialPuntos¶

HistorialPuntos {
  id: UUID (PK)
  usuario_id: UUID (FK)
  cantidad: integer
  motivo: enum
  referencia_id: UUID
  created_at: timestamp
}

8. Criterios de Aceptación¶

ID	Criterio
AC-001	Paciente ve su nivel y puntos en el perfil
AC-002	Paciente recibe puntos por cada toma confirmada
AC-003	Paciente ve su racha actual prominentemente
AC-004	Sistema celebra logros con animación no intrusiva
AC-005	Paciente puede compartir logros sin datos de salud
AC-006	Paciente puede desactivar gamificación completamente
AC-007	Logros y puntos nunca se pierden
AC-008	Personalizaciones se desbloquean por nivel
AC-009	Centro de logros muestra progreso completo
AC-010	Omisiones no castigan ni avergüenzan al usuario

9. Referencias¶

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