Money Moves

Money Moves são tarefas financeiras agendadas e acionáveis entregues aos usuários em uma cadência regular. Eles são o motor que transforma um plano financeiro em comportamento real.

Os três tipos de tarefa

Cada ciclo de Money Move contém uma mistura de três tipos de tarefa:

Tipo	Código	Propósito	Pontos
Fazer	do	Uma ação financeira concreta com um valor em dinheiro	50
Aprender	learn	Uma tarefa educacional para construir conhecimento financeiro	10
Refletir	mind	Um exercício de mentalidade ou journaling	10

Exemplo de ciclo (semanal, meta de poupança):

• FAZER: "Transfira R$150 para o seu fundo de emergência" — amount_cents: 15000
• APRENDER: "Leia: a diferença entre necessidades e desejos"
• REFLETIR: "Escreva um hábito financeiro que você quer construir esta semana"

Ciclos

Um ciclo é um período agendado. Cada ciclo tem:

• Uma due_date — quando o usuário deve completá-lo
• Um status — scheduled, available, completed ou skipped
• Uma lista de tarefas — as ações específicas para esse período

Ciclo (vencimento: 2024-01-15, status: available)
├── Tarefa: DO   — Transferir R$150 para poupança  [pending]
├── Tarefa: LEARN — Ler sobre fundos de emergência [pending]
└── Tarefa: MIND  — Reflexão de journaling          [done]

Ciclo de vida

POST /money-moves/generate
        │
        ▼
   Ciclo criado (status: scheduled)
        │
        ▼  (data de vencimento chega)
   Ciclo disponível (status: available)
        │
        ▼  (usuário completa as tarefas)
   Ciclo concluído (status: completed)

Ciclos são gerados sob demanda via POST /money-moves/generate. O Ozzie cria o próximo ciclo com base na meta, plano, cadência e personalidade do usuário.

Pontos e gamificação

Cada tarefa concluída concede pontos:

• Tarefa DO: 50 pontos
• Tarefa LEARN: 10 pontos
• Tarefa MIND: 10 pontos
• Primeira conclusão (bônus de boas-vindas): 150 pontos extras

Os pontos se acumulam no perfil do usuário e podem ser exibidos na sua UI para impulsionar o engajamento.

O que impulsiona a geração dos moves

Os Money Moves são personalizados usando:

1. Tipo e valor da meta — moves de poupança vs. moves de pagamento de dívida diferem significativamente
2. Plano financeiro — o valor da tarefa DO vem da alocação alvo do plano
3. Perfil de personalidade — tom, ritmo e tipos de tarefa variam por personalidade
4. Conclusões anteriores — o Ozzie evita repetir os mesmos moves em ciclos consecutivos

Padrão de integração

Fluxo de integração típico:

1. Usuário completa o onboarding (intake + meta + plano)
2. Chame POST /money-moves/generate para criar o primeiro ciclo
3. Exiba o ciclo e suas tarefas na sua UI
4. Quando o usuário completar uma tarefa, chame PATCH /money-moves/{move_id} para marcá-la como concluída
5. Quando o ciclo estiver concluído ou ignorado, gere o próximo

→ Veja Referência da API de Money Moves