feat: implementa ecossistema de compras parceladas no cartão

[Senavictors]

Resumo

Implementa a Phase 36 com o ecossistema completo de parcelamento no cartão de crédito.

Essa PR introduz um agregado dedicado para compras no cartão, suporta 1x..24x, cria uma transação real no ledger para cada parcela, adiciona o fluxo de adiantamento manual de parcelas, integra o comportamento com a wishlist e ajusta os módulos de leitura para que parcelas futuras não sejam contabilizadas como realizado antes da data.

O que mudou

• Adição dos novos modelos e migration:
  • CreditCardPurchase
  • CreditCardPurchaseInstallment
  • CreditCardInstallmentAdvance
  • CreditCardPurchaseSource
• Criação do módulo credit-card-purchases na camada de application, com:
  • criação de compra no cartão
  • detalhe da compra
  • adiantamento de parcelas
  • exclusão estruturada do plano inteiro
• Atualização do POST /api/transactions para criar compras no cartão pelo novo agregado
• Atualização do fluxo de compra da wishlist para suportar parcelamento em contas CREDIT_CARD
• Criação dos novos endpoints:
  • GET /api/credit-card-purchases/[id]
  • POST /api/credit-card-purchases/[id]/advances
• Criação da tela de detalhe da compra parcelada com histórico das parcelas e formulário de adiantamento
• Atualização das telas de transações e faturas para exibir status de parcela e adiantamento
• Bloqueio da edição direta de transações que representam parcelas e exclusão redirecionada para a compra inteira
• Ajustes em monthly summary, goals, forecast, score e insights para usar a janela observada do período no cálculo do realizado
• Refatoração do seed/reset demo para incluir:
  • compra no cartão à vista
  • compra parcelada
  • adiantamento de parcelas
  • compra de wishlist no cartão com parcelamento
• Criação da ADR-015 e atualização de README / CONTEXT / CHANGELOG / task da Phase 36

Validação executada

• npx prisma migrate deploy
• npx prisma generate
• npm run format
• npm test
• npm run lint
• npm run build
• npx prisma db seed

Observações

• Durante a validação local, a migration da Phase 36 precisou ser recuperada de um estado parcial no banco local e reaplicada corretamente.
• O estado final do banco local ficou sincronizado e a migration foi aplicada com sucesso.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
finance-controller	Ready	Preview, Comment	Apr 22, 2026 1:53pm