feat(finance): eixo caixa no realizado + DFC pessoal (fases 1 e 2)

[alanrezendeee]

Fases 1 e 2 do plano de profissionalização contábil, juntas neste PR.

Fase 1 — um fato, dois eixos, cada medida declara o seu

Medida	Eixo	Data
Previsto, a pagar, a receber	competência	due_date (sem mudança)
Realizado (cards, série anual, categorias, drill-down)	caixa	COALESCE(DATE(paid_at), due_date)

O sistema aplicava competência até no realizado — regime híbrido não declarado, invisível enquanto se paga perto do vencimento. A antecipação de uma parcela de financiamento expôs a distorção dupla: o mês do pagamento escondia o desembolso real, e o mês do vencimento mostraria "realizado" sem dinheiro sair.

• Summary: totais divididos em duas queries, uma por eixo
• MonthlySeries: dois GROUP BY (um por eixo) mesclados em memória — um lançamento pode contribuir para meses diferentes nas duas medidas
• Categorias e drill-down: cláusula por status, idêntica nos dois pontos — o modal continua batendo com a barra por construção
• Fallback em due_date para liquidações antigas sem paid_at

Fase 2 — DFC pessoal

GET /finance/dashboard/cashflow?year&family_member_id

Saldo inicial + entradas pagas − saídas pagas = saldo final, mês a mês. A abertura é o líquido de todos os fluxos realizados antes de 1º de janeiro — o caixa que o histórico registrado construiu (fluxos do ledger, não saldo bancário). 12 meses sempre preenchidos, saldo acumulado atravessando meses sem movimento.

Teste da identidade contábil: abertura + soma dos líquidos = fechamento.

Fase 3 — toda liquidação grava paid_at

O Confirm tinha um atalho sem carimbo: sem campos no body, só mudava o status e paid_at ficava NULL — o "Confirmar recebimento" de Receitas usa exatamente esse caminho, então o eixo caixa degradaria em silêncio daqui pra frente. Atalho removido: caminho único carimba paid_at (default: agora) e paid_amount_cents em toda liquidação. Efeito colateral correto: confirmar lançamento cancelado passa a ser rejeitado. setStatus virou código morto e foi removido.

Impacto nos dados

Nenhum — sem migração, nenhum lançamento alterado. Números exibidos mudam apenas onde mês do pagamento ≠ mês do vencimento.

Front: retech-meufin-admin #96 (mesma branch).

🤖 Generated with Claude Code

[alanrezendeee]

Fase 4 adicionada — trilha de eventos + imutabilidade.

• finance_entry_events (migration 000042, append-only): confirmed/settled com data e valor, reopened, cancelled com motivo, due_date_changed com o vencimento original preservado. Ator vem do token via context (appctx); rotinas automáticas ficam com actor nulo. GET /finance/entries/:id/events.
• Imutabilidade: lançamento pago não muda valor, vencimento, natureza nem status via edição — só rótulos. A propagação de dia em série deixa de tocar parcelas pagas.
• Backfill executado em prod à parte (dados): 513 realizadas sem paid_at ganharam paid_at = updated_at — verificado antes que 100% tinham updated_at no mesmo mês do vencimento e sem contaminação dos renames; nenhum mês de agregação se moveu.
• Seed dos 128 marcadores de saúde aplicado em prod (93 novos).