Metas

Uma meta é o objetivo financeiro principal do usuário. Cada usuário Ozzie tem uma meta ativa por vez, e ela impulsiona tudo: o plano financeiro, a cadência dos Money Moves e o tom do coaching.

Dois tipos de meta

savings — O usuário está construindo em direção a algo: um fundo de emergência, uma viagem, uma entrada para imóvel, ou simplesmente segurança financeira geral.

debt — O usuário está pagando algo: saldo de cartão de crédito, empréstimo pessoal, financiamento de carro. O plano foca em acelerar o pagamento.

Atributos da meta

Campo	Descrição
goal_type	"savings" ou "debt"
goal_name	Rótulo legível, ex: "Fundo de Emergência" ou "Pagar Cartão Visa"
target_amount	A linha de chegada na moeda do usuário
starting_amount	Onde eles começam (poupança atual ou saldo de dívida atual)
cadence	Com que frequência querem agir
next_move_date	Quando o próximo Money Move é agendado

Opções de cadência

Cadência	Frequência
weekly	A cada 7 dias
biweekly	A cada 14 dias
twice_monthly	Dias 1 e 15 de cada mês
monthly	Uma vez por mês

A cadência determina com que frequência o Ozzie gera novos ciclos de Money Move. Um usuário que quer progresso agressivo escolhe weekly; um que quer um toque mais leve escolhe monthly.

Como as metas impulsionam o sistema

Meta (tipo + alvo + cadência)
    │
    ├── Geração do plano (cronograma, alocações)
    │       └── "Você atingirá sua meta em 14 meses"
    │
    └── Money Moves (tarefas DO com valores)
            └── "Transfira R$200 para poupança esta semana"

A meta é a âncora. Mude a meta → regenere o plano → novos Money Moves.

Progresso da meta

O progresso é rastreado implicitamente através de tarefas de Money Move concluídas e transações. Não existe um endpoint separado de "progresso" — o coach de chat e o plano refletem o progresso atual com base nos dados acumulados.

Recomendações para integradores

• Sempre crie uma meta após o intake financeiro e a geração do plano — o plano precisa de renda/despesas para calcular um cronograma realista.
• Se seu fluxo de onboarding captura informações de meta antecipadamente, agrupe: criar usuário → enviar intake → criar meta → gerar plano.
• Você pode atualizar uma meta chamando POST /goals novamente — ela substitui a meta ativa.

→ Veja Referência da API de Metas