technical-hub · in-progress
Componentes técnicos
Índice dos componentes de aplicação já existentes e dos seus checklists de manutenção.
Esta nota é o inventário do código transversal do projeto novo. Cada componente tem uma nota própria com responsabilidade, contrato, uso atual, testes e pendências.
Inventário
| Área | Estado | Detalhamento |
|---|---|---|
| Casts | 🟡 Em uso | Casts |
| Helpers | 🟡 Em uso | Helpers |
| Concerns | 🟡 Em uso | Concerns |
| Actions | 🟡 Em uso | Actions |
| Services | 🟡 Planejado | Services |
| Models | 🟡 Em uso | Model — User |
| Providers | 🟡 Em uso | Providers |
| Schedules | 🟡 Planejado | Schedules |
| Seeders | 🟢 Implementado | Migration 01A — cities |
| Testes | 🟡 Em uso | Testes existentes |
| Bootstrap/configuração | 🟡 Em uso | Configuração e bootstrap |
Regra de manutenção
- Toda classe nova deve ter uma nota se representar decisão transversal ou contrato reutilizado.
- Toda alteração em cast/helper/concern deve atualizar sua nota e o teste correspondente.
- Toda função pública deve registrar entrada, saída, fallback e exceções.
- Não duplicar regra de normalização ou formatação em Livewire, Blade, Model e helper.
- Preferir serviços/Actions para efeitos colaterais; manter helpers puros quando possível.
- Rodar a suíte do projeto depois de alterar um componente compartilhado.