tdd-objetos-de-referencia

Matriz de decisão

Objeto	Classe *Ref	Classe operacional	Coleção de referência	Coleção real	Observação
User	Não (por padrão)	Sim	N/A	users	Usuário é majoritariamente operacional
Ministry	Sim (MinistryRef)	Sim (Ministry)	ministry_ref (quando houver)	platform/ministrys/{id}/config	Ref útil para catálogo multi-tenant
Church	Sim (ChurchRef)	Sim (Church)	church_ref	churchs	Já existe uso de church_ref na plataforma
PlatformConfig	Não	Sim (PlatformConfig)	N/A	platform/config	Config é fonte direta da plataforma
ClassGroup	Sim (ClassGroupRef)	Sim (ClassGroup)	class_ref	churchs/{unit}/classes	Recomendado para replicação por igreja
Material	Sim (MaterialRef)	Sim (Material)	material_ref (planejado)	materials (planejado)	Base para catálogo didático
Ebd	Sim (EbdRef)	Opcional (agregado)	ebd_ref	ebds	Ref para modelo/base de ocorrência
EbdSession	Não (por padrão)	Sim (EbdSession)	N/A	ebds/{sessionId}	Sessão é ocorrência operacional

---

Estrutura mínima recomendada por classe *Ref

Base comum (BaseRef)

• id
• ministryId (quando aplicável)
• sourcePath
• sourceId
• refKind
• updatedAt

ChurchRef

• unitId
• name
• status (opcional)

ClassGroupRef

• unitId
• classId
• name
• ageGroup (opcional)
• displayOrder (opcional)
• active (opcional)

EbdRef

• unitId
• date (modelo de data/referência)
• type (opcional)
• status (opcional)
• weatherType (opcional)
• temperature (opcional)

MaterialRef (planejado)

• code/materialId
• publisher
• edition
• name
• referencePeriod

---

Fluxo de construção para novos objetos

1. Classificar o objeto: referência ou operacional.
2. Confirmar coleção Firestore (*_ref vs real).
3. Criar classe no domínio:
   • *Ref para referência
   • classe operacional para uso real
4. Criar mapeadores em infrastructure.
5. Validar checklist:
   • naming
   • camada correta
   • ausência de regra de negócio em presentation

---

Regras de naming

• Classe referência: PascalCase + Ref
• Arquivo referência: snake_case_ref.dart ou *_ref.dart conforme padrão local
• Coleção referência: snake_case_ref
• Coleção real: sem _ref

---

Backlog recomendado (curto prazo)

1. Introduzir ChurchRef no frontend domain.
2. Introduzir ClassGroupRef no frontend domain.
3. Introduzir EbdRef no frontend domain (apenas se houver consumo direto).
4. Definir roadmap de MaterialRef e materials.

---

Referências

• ADR-0025 — Padrão de classes de referência no domínio
• ADR-0005 — Modelo de domínio conceitual
• ADR-0007 — Organização de código
• docs/architecture/data-model/padrao-referencias-firestore.md