Repository navigation
B02 · Modularizar com internachi/modular e teste de arquitetura #4
Description
Contexto
Decisão registrada: usar apenas a ideia de módulos e eventos do internachi/modular, sem template base pesado. Os módulos conversam por eventos de domínio e contratos, nunca por chamada direta entre models.
Escopo
- Instalar
internachi/modulare criar a convençãoapp-modules/<nome>com namespacePHPeste\<Nome> - Criar os módulos vazios: Identity, Community, Branding, Cfp, Program, Ticketing, Payments, CheckIn, Notifications, Sponsors, Suppliers, Finance, Tasks, Engagement, Audit
- Definir pasta padrão de cada módulo:
Models,Actions,Data,Events,Listeners,Contracts,Http,database/migrations,tests - Escrever teste de arquitetura em Pest que falha se um módulo importar
Modelsde outro - Documentar em
docs/adr/a decisão e como criar um módulo novo (php artisan make:module)
Critérios de aceite
- Os 15 módulos existem, com service provider carregando rotas, migrations e testes de cada um
- Teste de arquitetura falha ao introduzir dependência proibida entre módulos
- ADR publicado em
docs/adr/
Notas técnicas
- Comunicação entre módulos: eventos (
Illuminate\Events) para efeitos colaterais e interfaces emContractspara consultas síncronas - Cada módulo roda seus testes isoladamente
Depende de
Definição de pronto
- Testes passando na CI
- Lint e análise estática sem erros
- Documentação atualizada (OpenAPI via Scramble no backend, ou README do módulo no front)
- Revisado por pelo menos uma pessoa
Metadata
Metadata
Assignees
Type
Projects
- Status
Activity
tecrodrigocastro commentedon Nov 4, 2026
Progresso no PR #1 (merged) + #2:
internachi/modularinstalado, convençãoapp-modules/<nome>com namespacePHPeste\<Nome>.App\.Falta pra fechar:
App\)docs/adr/documentando a decisãoDeixando em In Progress.
tecrodrigocastro commentedon Nov 4, 2026
Pendências fechadas no PR #85:
Models/Actions/Data/Events/Listeners/Contracts/HttpModelsde um módulo só é usado dentro dele mesmo (além do teste que já existia de nenhum módulo usarApp\)docs/adr/0002-modularizacao-internachi-modular.mdpest --group=archcobre os 15 módulos. Marcando como Done.