REF-70-A: Mapeamento de Enums do Domínio Metrics
ADR: ADR-70 Status: Aceito Data: 2026-04-24
Contexto
O domínio metrics usa enums técnicos para níveis, fontes de classificação, escopos de relatório e dimensões de análise. Este REF mapeia cada enum ao term canônico correspondente em .vigim/ddd/terms/terms-metrics.yaml.
level
| Enum | Term canônico | Uso |
|---|---|---|
basic |
Básico | Abaixo do limiar inferior (< 50%) |
intermediate |
Intermediário | Entre os dois limiares (50%-79%) |
advanced |
Avançado | Acima do limiar superior (≥ 80%) |
Limiares são defaults globais com override por Trilha.
classification_source
| Enum | Term canônico | Uso |
|---|---|---|
diagnostic_initial |
Diagnóstico Inicial | Classificação originada do Segmento DI |
diagnostic_verify |
Verificação de Desempenho | Classificação originada do Segmento SVD |
objective_exam |
Simulado Objetivo | Classificação originada de Simulado Objetivo |
reclassification |
Reclassificação | Reavaliação que muda nível em relação ao anterior |
report_scope
| Enum | Term canônico | Uso |
|---|---|---|
student |
Aluno | Relatório individual do Aluno |
discipline |
Disciplina | Relatório por Disciplina |
module |
Módulo | Relatório por Módulo |
product |
Produto | Relatório consolidado do Produto |
report_status
| Enum | Term canônico | Uso |
|---|---|---|
generated |
Gerado | Relatório válido, disponível para consulta |
invalidated |
Invalidado | Novos dados tornaram o relatório obsoleto |
dimension_type
| Enum | Term canônico | Uso |
|---|---|---|
discipline |
Disciplina | Desempenho agregado por Disciplina |
module |
Módulo | Desempenho agregado por Módulo |
source_type |
Tipo de Fonte | Desempenho por origem (Lei, Jurisp., Dout.) |
exam_type |
Tipo de Simulado | Desempenho por tipo (VF, Objetivo, Escrito) |
Regras de uso
- Os enums acima são os únicos valores válidos nos contracts JSON do metrics
- O código PHP deve usar constantes derivadas destes enums (padrão MIDDAG)
- Novos valores devem ser adicionados primeiro nos terms, depois neste REF, depois nos contracts
- O mapeamento term → enum é 1:1 — não criar aliases