Roadmap Técnico do Filament Core Suite
Visão Geral
O Filament Core Suite unifica faturamento, gestão de pessoas e comunicações em um ecossistema Laravel modular. O objetivo é compartilhar contratos, eventos e DTOs entre pacotes independentes para manter coerência e possibilitar evolução isolada por domínio.
Arquitetura Monorepo
A fundação está em packages/contracts, responsável por interfaces, enums e eventos globais. Cada módulo — packages/invoices, packages/people, packages/communications — implementa apenas os contratos que consome e expõe integrações via eventos. Consulte docs/snippets/monorepo-architecture.md para o diagrama ASCII completo. Nenhum pacote de domínio depende diretamente de outro; a comunicação é feita por eventos e DTOs compartilhados. Todos os módulos vivem no mesmo repositório, facilitando refatorações atômicas e sincronização de mudanças em contratos.
Fases Principais
- Fase 0 — Setup e padrões DevOps: pipeline CI/CD, automação de testes e guidelines de qualidade.
- Fase 1 — Contracts / Enums / DTOs: definição de contratos e eventos públicos compartilhados.
- Fases 2-3 — Invoices / UI / PDF: criação do módulo de faturas com UI Filament e geração de PDFs.
- Fase 4 — InfinityPay Gateway: implementação do primeiro gateway externo integrado aos contratos.
- Fase 7 — People / Identidade: consolidação de pessoas físicas/jurídicas e sincronização de eventos.
- Fase 8 — Communications / Broker: implantação do broker de mensagens multi-canal baseado em eventos, com drivers plugáveis semelhantes aos gateways de pagamento.
Princípios Operacionais
- Estratégia contracts-first: contratos evoluem antes da implementação para minimizar quebras.
- Arquitetura de eventos: todo módulo publica e consome eventos documentados na mesma linguagem ubíqua.
- UI desacoplada: o painel Filament consome APIs públicas, permitindo que outros clientes façam o mesmo.