---
tags: [ag-music, financeiro, dashboard]
created: 2026-03-20
updated: 2026-03-20
parent: "[[AG-Music]]"
---

# Financeiro - Cards e Contas

## Cards do Financeiro

### Linha 1 - 4 cards (somente PJ, clicaveis com modal de lista)
- **Faturamento Previsto** (mensalidades + taxas geradas no mes, qualquer status)
- **Faturamento Recebido** (mensalidades + taxas pagas no mes)
- **A Receber** (mensalidades pendentes do mes)
- **Inadimplentes** (mensalidades vencidas e nao pagas do mes, alunos distintos)

### Linha 2 - 3 cards KPIs DRE
- **Margem de Contribuicao** (%)
- **Ponto de Equilibrio**
- **Lucro do Mes** (DRE) = Receita - Custos Variaveis - Despesas Fixas - Investimentos

### Regras
- Previsto = Recebido + A Receber (sempre bate)
- Excluir matriculas canceladas/trancadas de todos os calculos
- Em PF (ambiente 2), esconder cards de Faturamento Previsto, A Receber e Inadimplentes

## Filtro de Mes
- Seletor `input type="month"` no topo ao lado do PJ/PF
- Backend `apiDashboardFinanceiro` aceita parametro `?mes=2026-03`

## Abas do Financeiro
- **Resumo** (barras + 3 gauges: Recebimento, Margem, Inadimplencia + mini cards alunos em dia/atraso)
- **Historico** (comissoes pagas)
- **Transacoes** (filtro por data, tipo, conta, busca)
- **Detalhamento** (receitas do mes agrupadas por categoria com tabela)
- **Gestao** (DRE, Contas, Cartoes, Simulador, Feedback, Seguranca)

## Contas Financeiras

### PJ (ambiente 1)
| Conta | Tipo | Saldo Inicial |
|-------|------|---------------|
| Bradesco CC | banco | R$ 9.092,56 |
| Caixa - Dinheiro | caixa | R$ 7.670,00 |
| Maquininha | conta_transitoria | R$ 0 |
| Credito | cartao_credito | R$ 0 |

### PF (ambiente 2)
| Conta | Tipo |
|-------|------|
| Pessoa Fisica | banco |
| Carteira | caixa |

## Transferencia entre Contas
- Endpoint: `POST /direcao/api/financeiro/transferir-entre-contas`
- Botao "Transferir" na sub-aba Contas
- Cria debito na origem + credito no destino (mesmo ambiente)

## Comissao - Conta de Saida
- Campo "Conta de saida" no modal de calcular comissao E no modal de confirmar pagamento
- Pre-seleciona a conta escolhida no primeiro modal
- Backend recebe e salva `conta_financeira_id`

## Validacao PJ/PF
- Backend impede lancar com conta de outro ambiente
- Ao trocar ambiente, reseta filtro de contas nas transacoes

## Pendencia
- 9 comissoes pagas em marco (R$ 9.619,92) sem `conta_financeira_id`
- 100 mensalidades debito (R$ 19.711,20) sem conta - sao controle, nao precisam de conta

## Ver tambem
- [[AG-Music]] - visao geral do projeto
- [[Comissoes]] - sistema de comissoes