Monorepo Architecture Diagram

filament-core/ (monorepo)
├─ packages/
│  ├─ contracts/              ←  Interfaces / Enums / DTOs / Eventos
│  ├─ invoices/               ←  Faturas, Pagamentos, PDF, UI Filament
│  │  └─ Gateways/
│  │     └─ InfinityPay/      ←  Gateway Infinity Pay
│  ├─ people/                 ←  Pessoa física/jurídica, papéis, eventos
│  └─ communications/         ←  Broker de mensagens e templates
├─ composer.json              ←  Gerencia workspaces e autoload
└─ tests/                     ←  Testes de integração cross-module

Princípios da Arquitetura

• Isolamento por namespaces: Cada módulo usa namespace próprio (FilamentCore\{Module})
• Dependência unidirecional: Todos dependem de packages/contracts, mas não entre si
• Comunicação via eventos: Módulos se comunicam apenas através de eventos definidos em Contracts
• Composer Workspaces: Cada pacote tem seu composer.json próprio

Use este diagrama ASCII em páginas que mencionem a topologia geral do ecossistema. Atualize-o sempre que novos pacotes forem criados ou quando contratos mudarem a relação entre módulos.

Referência principal: Roadmap Técnico do Filament Core Suite.