Card 27 [M5] Relatórios Gerenciais (M5 COMPLETO)

Implementado

Backend — master.reports (5 procedures)

• enrollments — total, ativos, byStatus (funil), byCourse (filtros branchId/date)
• financial — totalAmount, paidAmount, pendingAmount, overdueAmount, inadimplenciaRate, byBranch, byMonth
• pedagogico — averageGrade, totalGrades, bySubject (top 15), attendance (present/absent/justified/late + rate)
• branchComparison — ranking filiais: activeStudents (via class_.branchId), teachers (User PROFESSOR), revenue (Payment PAID anual)
• exportCsv — auditoria EXPORT report (CSV gerado no frontend)

Frontend — /master/relatorios (REESCRITA)

• Seletor tipo (4 relatórios) + filial (dropdown) + ano (input number)
• Matrículas: 3 KPIs (total, ativos, taxa conversão) + PieChart status + lista por curso
• Financeiro: 5 KPIs (previsto, recebido, pendente, inadimplência, taxa) + BarChart receita por filial
• Pedagógico: 4 KPIs (média geral, alunos, avaliações, frequência) + BarChart horizontal médias por matéria + 4 cards frequência
• Comparativo: tabela ranking (medalha top 3) + BarChart receita
• Export CSV dinâmico por tipo (Blob download com BOM UTF-8)
• Recharts: PieChart, BarChart (vertical e horizontal)

4 defaults aplicados (decisoes.md)

1. Prioridade: 3 relatórios + comparativo de filiais
2. Formato: CSV (PDF via Puppeteer fica M7 Go-Live — complexidade alta, VPS ARM64)
3. Relatório mensal automático email: Job Bull futuro (M7)
4. Layout PDF: white-label cores da filial (M7)

Deploy

• Commit: a8999b3
• URL: https://sistemaescolar.wellka.com.br/master/relatorios

🎉 M5 (Cards 22-27) COMPLETO

• Card 22: Dashboard Master da Rede ✅
• Card 23: Gestão de Filiais ✅
• Card 24: White-Label & Configuração de Marca ✅
• Card 25: Gestão de Usuários & RBAC ✅
• Card 26: Auditoria & Logs ✅
• Card 27: Relatórios Gerenciais ✅

Próximo: Card 28 [M6] Integração WhatsApp Business API (início do M6)