Skip to content

ADR-02: Ciclo de vida pedagógico em 4 fases

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.

Navigation

Type to search…

↑↓ navigate↵ selectEsc close