Módulo 4 - Faturamento & Inteligência Financeira (billing)

Módulo 4: Faturamento & Inteligência Financeira (billing)

O módulo Billing gerencia o faturamento fiscal dos serviços executados, calcula a rentabilidade líquida por limpeza e controla a quitação das faturas dos clientes.

---

💰 1. Cálculo de Rentabilidade (ProfitLogic)

Para cada serviço executado, o ProfitLogic apura a margem financeira real:

$$\text{Lucro Líquido} = \text{Valor Pago pelo Cliente} - \text{Custo da Funcionária} - \text{Imposto (VAT)} - \text{Taxa de Material/Logística}$$

• Margem de Lucro (%): $(\text{Lucro Líquido} / \text{Valor Total}) \times 100$.
• Alerta de Margem Baixa: Se a margem de lucro de um cliente ficar abaixo de 35%, o sistema gera um alerta visual no painel financeiro para revisão de tarifa.

---

📑 2. Ciclo de Vida da Fatura (InvoiceStateLogic)

stateDiagram-v2
    [*] --> DRAFT: Limpeza concluída
    DRAFT --> ISSUED: Fatura emitida pelo sistema/gerente
    ISSUED --> SENT: Fatura enviada via E-mail / WhatsApp
    SENT --> PAID: Pagamento confirmado (BACS / Cartão / Wallet)
    SENT --> OVERDUE: Vencimento sem pagamento
    OVERDUE --> PAID: Quitação com juros/multa
    ISSUED --> CANCELLED: Fatura cancelada / Estornada

---

🛠️ 3. Arquivos Principais do Módulo

• Lógica de Lucro: src/features/billing/services/ProfitLogic.ts
• Máquina de Estados da Fatura: src/features/billing/services/InvoiceStateLogic.ts
• Pool de Faturamento: src/features/billing/services/BillingPoolService.ts
• Painel Financeiro: src/pages/BillingHub.tsx