TDD — Classe de Domínio `EbdClass`

Status

Aprovado para implementação da classe (sem integração de uso)

Objetivo

Registrar a definição técnica da classe EbdClass e seus objetos auxiliares no domínio, seguindo ADR-0005, ADR-0007 e ADR-0025.

Escopo desta etapa

Criar apenas a classe de domínio e tipos auxiliares.
Não integrar em repository, use case, DI, UI ou backend nesta etapa.

Contrato da classe `EbdClass`

Arquivo alvo de código:

frontend/lib/domain/entities/ebd_class.dart

Campos previstos (com tipo):

id: String
unitId: String
name: String
description: String?
ageGroup: EbdClassAgeGroup?
displayOrder: int
status: EbdClassStatus
active: bool
defaultTeacher: ChurchPersonRef?
defaultAssistant: ChurchPersonRef?
room: String?
additionalInfo: String?
peopleRoles: List<EbdClassPersonRole>

Domínio de `status` (`EbdClassStatus`)

O campo status deve armazenar o código da situação da classe.

Código	Descrição amigável
`ACTIVE`	Ativa
`INACTIVE`	Inativa
`PENDING`	Pendente
`BLOCKED`	Bloqueada
`ARCHIVED`	Arquivada

Domínio de posição na classe (`EbdClassRolePosition`)

Posições padrão permitidas:

Código	Descrição amigável
`teacher`	Professor(a)
`assistant`	Assistente
`student`	Aluno(a)
`visitor`	Visitante
`support`	Apoio
`other`	Outro

Objetos auxiliares da classe

`EbdClassPersonRole`

userId: String
name: String
classRole: EbdClassRolePosition
approvedRoleIds: List<String>
isActive: bool
notes: String?

`EbdClassAgeGroup`

Enum para faixa etária/tipo da classe.

Valores:

nursery
kindergarten
garden
juniors
teenagers
youngAdults
levites
baptism
evangelism
integration
workers
couples
adults
masters
none

Regra de negócio registrada

Somente pessoas com perfil (role) aprovado podem compor peopleRoles.

Observação arquitetural:

Nesta etapa, apenas o contrato de dados será criado em domínio.
A validação autoritativa permanece no backend (ADR-0001 e ADR-0003).

Regras desta fase

Sem toMap/fromMap nesta primeira versão.
Sem regras de negócio de autorização executadas no frontend.
Classe deve permanecer pura de domínio (sem Flutter/Firebase).

Fora de escopo (neste TDD)

Persistência Firestore.
Mapeadores em infrastructure.
Ajustes de tela de classes.
Migração de dados.

Referências

docs/architecture/adrs/adr-0005-modelo-de-dominio-conceitual.md
docs/architecture/adrs/adr-0007-padrao-de-organizacao-de-codigo.md
docs/architecture/adrs/adr-0025-padrao-de-classes-de-referencia-no-dominio.md
docs/architecture/tdd/data-model/tdd-classe-church.md