Skip to content

REF-70-A: Mapeamento de Enums do Domínio Metrics

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

  1. Os enums acima são os únicos valores válidos nos contracts JSON do metrics
  2. O código PHP deve usar constantes derivadas destes enums (padrão MIDDAG)
  3. Novos valores devem ser adicionados primeiro nos terms, depois neste REF, depois nos contracts
  4. O mapeamento term → enum é 1:1 — não criar aliases
Navigation

Type to search…

↑↓ navigate↵ selectEsc close