Money Moves

Los Money Moves son tareas financieras programadas y accionables entregadas a los usuarios en una cadencia regular. Son el motor que convierte un plan financiero en comportamiento real.

Los tres tipos de tarea

Cada ciclo de Money Move contiene una mezcla de tres tipos de tarea:

Tipo	Código	Propósito	Puntos
Hacer	do	Una acción financiera concreta con un monto en dinero	50
Aprender	learn	Una tarea educativa para construir conocimiento financiero	10
Reflexionar	mind	Un ejercicio de mentalidad o journaling	10

Ejemplo de ciclo (semanal, meta de ahorro):

• HACER: "Transfiere $150 a tu fondo de emergencia" — amount_cents: 15000
• APRENDER: "Lee: la diferencia entre necesidades y deseos"
• REFLEXIONAR: "Escribe un hábito financiero que quieres construir esta semana"

Ciclos

Un ciclo es un período programado. Cada ciclo tiene:

• Una due_date — cuándo el usuario debe completarlo
• Un status — scheduled, available, completed o skipped
• Una lista de tareas — las acciones específicas para ese período

Ciclo (vencimiento: 2024-01-15, status: available)
├── Tarea: DO   — Transferir $150 a ahorros      [pending]
├── Tarea: LEARN — Leer sobre fondos de emergencia [pending]
└── Tarea: MIND  — Reflexión de journaling          [done]

Ciclo de vida

POST /money-moves/generate
        │
        ▼
   Ciclo creado (status: scheduled)
        │
        ▼  (fecha de vencimiento llega)
   Ciclo disponible (status: available)
        │
        ▼  (usuario completa las tareas)
   Ciclo completado (status: completed)

Los ciclos se generan bajo demanda vía POST /money-moves/generate. Ozzie crea el siguiente ciclo basándose en la meta, plan, cadencia y personalidad del usuario.

Puntos y gamificación

Cada tarea completada otorga puntos:

• Tarea DO: 50 puntos
• Tarea LEARN: 10 puntos
• Tarea MIND: 10 puntos
• Primera completación (bono de bienvenida): 150 puntos extra

Los puntos se acumulan en el perfil del usuario y pueden mostrarse en tu UI para impulsar el compromiso.

Qué impulsa la generación de moves

Los Money Moves se personalizan usando:

1. Tipo y monto de la meta — los moves de ahorro vs. pago de deuda difieren significativamente
2. Plan financiero — el monto de la tarea DO proviene de la asignación objetivo del plan
3. Perfil de personalidad — el tono, ritmo y tipos de tarea varían por personalidad
4. Completaciones anteriores — Ozzie evita repetir los mismos moves en ciclos consecutivos

Patrón de integración

Flujo de integración típico:

1. Usuario completa el onboarding (intake + meta + plan)
2. Llama a POST /money-moves/generate para crear el primer ciclo
3. Muestra el ciclo y sus tareas en tu UI
4. Cuando el usuario complete una tarea, llama a PATCH /money-moves/{move_id} para marcarla como hecha
5. Cuando el ciclo esté completo o saltado, genera el siguiente

→ Ver Referencia de la API de Money Moves