ADR-02: Ciclo de vida pedagógico em 4 fases
Status: Aceito Data: 2026-04-17
Contexto
O ciclo de vida pedagógico na HÉLICO não é uma operação única. Existem 4 fases distintas com responsabilidades, estados e componentes próprios. Tratar essas fases como um fluxo monolítico mistura estados, responsabilidades e efeitos, dificultando rastreabilidade e evolução independente.
Decisão
O ciclo de vida pedagógico é composto por 4 fases distintas:
Fase 1 — Configuração
O Admin configura a Trilha Pedagógica: 88+ parâmetros, templates, validação via JSON-Logic. Nesta fase não há artefato executável — apenas a definição paramétrica da Trilha.
Fase 2 — Publicação / Compilação
O CompilationEngine processa a configuração da Trilha e gera o Plano de Estudo — um artefato estático e versionado. Se já existir um Plano de Estudo ativo, ele é arquivado (status arquivado). O novo Plano assume status ativo. Detalhes de versionamento em ADR-11.
Fase 3 — Instanciação
Inscrição do Aluno gera Matrícula + Vigência. O Aluno passa pelo Onboarding e recebe o Plano do Aluno — uma cópia executável do Plano de Estudo ativo no momento da instanciação.
Fase 4 — Execução do Aluno
O Motor Pedagógico executa o Plano do Aluno: progressão entre blocos, seleção de atividades, classificação de nível, métricas de desempenho.
Regras práticas:
- Uma mudança na Configuração (Fase 1) não afeta automaticamente Planos de Estudo já compilados.
- Uma recompilação (Fase 2) gera novo Plano de Estudo sem afetar Planos do Aluno já instanciados.
- Cada fase pode evoluir independentemente em termos de modelagem e código.
- Estados derivados devem ser rastreáveis à sua origem (Configuração → Plano de Estudo → Plano do Aluno).
Consequências
- Clareza sobre o impacto de cada tipo de mudança em cada fase.
- Alunos ativos não são afetados por republicação da Trilha.
- Novos alunos recebem a versão mais recente do Plano de Estudo.
- Possibilidade de recompilar sem afetar execuções ativas.
- Rastreabilidade entre configuração, artefato compilado e estado executado.
ADRs relacionados
- Depende de ADR-01 (separação de responsabilidades e fronteira com middag).
- Detalhada por ADR-11 (versionamento snapshot imutável).
- Informa ADR-04 (eventos) sobre transições entre fases (ex:
TrilhaPublicada,PlanoCompilado,AlunoInstanciado).
Histórico
Renumerado de ADR-103.