Plano Financeiro

Um plano financeiro é o roteiro personalizado do Ozzie para um usuário. Ele responde à pergunta: "Dado o que ganho, o que gasto e o que quero — como chego lá e quanto tempo vai levar?"

Entradas

O plano é calculado a partir de três fontes:

Entrada	Fonte	Obrigatório
Renda e despesas mensais	POST /financial-intake	✅ Sim
Objetivo financeiro (tipo + valor)	POST /goals	✅ Sim
Perfil de personalidade	POST /personality	Opcional (melhora a qualidade)

Você deve enviar o intake financeiro antes de gerar um plano. Se o intake estiver faltando, a API retorna INTAKE_REQUIRED.

O que um plano contém

{
  "timeline_months": 14,
  "allocations": {
    "needs":   0.60,
    "wants":   0.20,
    "savings": 0.15,
    "debt":    0.05
  },
  "key_metrics": {
    "monthly_savings_target": 750,
    "projected_goal_date": "2025-07-01",
    "savings_rate_pct": 15
  },
  "action_items": [
    "Reduza as refeições fora de casa para liberar R$120/mês",
    "Configure transferência automática de R$750 no dia do pagamento",
    "Construa um fundo de emergência de 3 meses antes de investir"
  ]
}

timeline_months

Quantos meses até o usuário atingir sua meta na taxa atual de economia/pagamento.

allocations

Uma divisão percentual de como a renda do usuário deve ser distribuída entre quatro grupos. Estes são alvos — não restrições.

Grupo	Significado
needs	Despesas fixas não negociáveis (aluguel, utilidades, comida)
wants	Gastos discricionários (entretenimento, refeições fora)
savings	Indo para a meta
debt	Pagamentos mínimos + extra de dívida

key_metrics

Projeções calculadas: meta de economia mensal, data estimada de conclusão da meta, taxa de economia atual, etc.

action_items

Recomendações específicas e priorizadas geradas pela IA do Ozzie com base nos números reais do usuário.

Quando regenerar um plano

Regenere o plano quando:

• O usuário enviar um novo intake financeiro (renda mudou, grande despesa adicionada)
• O usuário mudar sua meta
• O usuário completar sua avaliação de personalidade
• Um tempo significativo se passou (atualização mensal é um bom padrão)

Basta chamar POST /plan novamente — ele sempre usa o intake e a meta mais recentes.

Plano vs realidade

O plano é o alvo. As transações revelam o comportamento real. Com o tempo, o coach de chat os compara:

"Seu plano diz gastar R$800 em comida este mês. Você registrou R$1.200 em transações de comida até agora."

Essa comparação só funciona se você estiver alimentando transações regularmente — por isso o endpoint de Transações é tão importante junto com o plano.

→ Veja Referência da API de Plano