REF-50-A: Mapeamento de Enums da Sequence do Plano de Estudo
ADR: ADR-50 Status: Aceito Data: 2026-04-23
Contexto
O campo sequence.execution do Plano de Estudo (plan) usa enums técnicos (flow_type, block_type) que são identifiers de código. Este REF mapeia cada enum ao term canônico correspondente em .vigim/ddd/terms/.
flow_type
| Enum | Term canônico | Uso |
|---|---|---|
main |
Fluxo Completo | Fluxo principal com CDA, Simulado Escrito e Revisão do Módulo |
review |
Fluxo de Revisão | Fluxo revisional com Revisão Geral e Simulado Objetivo |
static_reading |
Fluxo Estático de Leitura | Fluxo estático com apenas Leitura |
static_written_exam |
Fluxo Estático de Simulados Escritos | Fluxo estático com apenas Simulados Escritos |
static_standalone |
Fluxo Estático de Simulado Avulso | Fluxo estático para Simulados Avulsos (VF, Objetivos, Flashcards) |
block_type
| Enum | Term canônico | Uso |
|---|---|---|
cda |
Bloco CDA | Ciclo Diagnóstico Avaliativo (DI + SVD) |
written_exam |
Bloco de Simulado Escrito | Simulados Escritos no fluxo principal |
module_review |
Bloco de Revisão do Módulo | Prática com Flashcards ao final do módulo |
general_review |
Bloco de Revisão Geral | Revisão por ciclos de 4 módulos com Janela de Revisão |
objective_exam |
Bloco de Simulado Objetivo | Simulado Objetivo adaptativo após Revisão Geral |
flashcard |
Bloco de Flashcards | Prática isolada com Flashcards (Simulados Avulsos) |
reading |
Bloco de Leitura | Leitura isolada (fluxo estático) |
standalone_exam |
Bloco de Simulado Avulso | Simulado VF, Objetivo ou Flashcard avulso |
activities (Atividades-base admissíveis por bloco)
| Enum | Term canônico | Identifier |
|---|---|---|
di |
Diagnóstico Inicial | initial_diagnosis |
svd |
Simulado Verdadeiro ou Falso Diagnóstico | diagnostic_true_false |
reading |
Leitura | reading |
reinforcement_reading |
Leitura de Reforço | reinforcement_reading |
written_exam |
Simulado Escrito | written_exam |
flashcard |
Prática com Flashcards | flashcard_session |
objective_exam |
Simulado Objetivo | objective_exam |
true_false_exam |
Simulado Verdadeiro ou Falso | true_false_exam |
Regras de uso
- Os enums acima são os únicos valores válidos nos contracts JSON do
plan - O código PHP deve usar constantes derivadas destes enums (padrão MIDDAG)
- Novos tipos de fluxo, bloco ou atividade devem ser adicionados primeiro nos terms, depois neste REF, depois nos contracts
- O mapeamento term → enum é 1:1 — não criar aliases