---
name: financeiro_cards_e_contas
description: Estado atual do financeiro - cards, contas, pendências e decisões tomadas na sessão de 2026-03-20
type: project
---

## Cards do Financeiro (atualizado 2026-03-20)

**Linha 1 - 4 cards (somente PJ, clicáveis com modal de lista):**
- Faturamento Previsto (mensalidades + taxas geradas no mês, qualquer status)
- Faturamento Recebido (mensalidades + taxas pagas no mês)
- A Receber (mensalidades pendentes do mês)
- Inadimplentes (mensalidades vencidas e não pagas do mês, alunos distintos)

**Linha 2 - 3 cards KPIs DRE:**
- Margem de Contribuição (%)
- Ponto de Equilíbrio
- Lucro do Mês (DRE) = Receita - Custos Variáveis - Despesas Fixas - Investimentos

**Regra:** Previsto = Recebido + A Receber (sempre bate)
**Regra:** Excluir matrículas canceladas/trancadas de todos os cálculos
**Regra:** Em PF (ambiente 2), esconder cards de Faturamento Previsto, A Receber e Inadimplentes

## Filtro de mês
- Seletor `input type="month"` no topo ao lado do PJ/PF
- Backend `apiDashboardFinanceiro` aceita parâmetro `?mes=2026-03`

## Abas do Financeiro
- Resumo (barras + 3 gauges: Recebimento, Margem, Inadimplência + mini cards alunos em dia/atraso)
- Histórico (comissões pagas)
- Transações (filtro por data, tipo, conta, busca)
- **Detalhamento** (NOVA - receitas do mês agrupadas por categoria com tabela)
- Gestão (DRE, Contas, Cartões, Simulador, Feedback, Segurança)

## Contas Financeiras (PJ - ambiente 1)
- Bradesco CC (banco) - saldo_inicial: 9092.56
- Caixa - Dinheiro (caixa) - saldo_inicial: 7670.00
- Máquininha (conta_transitoria) - saldo_inicial: 0
- Crédito (cartao_credito) - saldo_inicial: 0

## Contas Financeiras (PF - ambiente 2)
- Pessoa Física (banco)
- Carteira (caixa)

## Pendência: Lançamentos sem conta vinculada
- 9 comissões pagas em março (R$ 9.619,92) sem conta_financeira_id
- 100 mensalidades débito (R$ 19.711,20) sem conta - são controle, não precisam de conta
- **Decisão pendente:** usuário precisa dizer em qual conta vincular as comissões já pagas

## Transferência entre contas
- Endpoint: POST /direcao/api/financeiro/transferir-entre-contas
- Botão "Transferir" na sub-aba Contas
- Cria débito na origem + crédito no destino (mesmo ambiente)

## Comissão - Conta de saída
- Campo "Conta de saída" adicionado no modal de calcular comissão E no modal de confirmar pagamento
- Pré-seleciona a conta escolhida no primeiro modal
- Backend já recebe e salva conta_financeira_id

## Validação PJ/PF
- Backend impede lançar com conta de outro ambiente
- Ao trocar ambiente, reseta filtro de contas nas transações