Arquitetura
Esta seção descreve, passo a passo, como a plataforma HÉLICO implementa a metodologia pedagógica. Cada página conta uma parte da história — do momento em que o conteúdo entra no sistema até a entrega dos resultados ao aluno.
Mapa de leitura
| Passo | Página | Domínio | O que responde | Status |
|---|---|---|---|---|
| — | Plataforma HÉLICO | (cross-domain) | Nivelamento: stack, domínios, glossário mínimo | Pendente |
| 1–3 | Content | content | Como o conteúdo entra, é estruturado e evolui | Especificado |
| 4 | Product | product | Como a Trilha é configurada a partir do conteúdo | Especificado |
| 5 | Engine — Compilação | engine.algorithm/plan | Como a Trilha vira Plano de Estudo | Especificado |
| 6 | Engine — Acesso | engine.access/onboarding | Como Matrícula, Vigência e Plano do Aluno nascem | Especificado |
| 7 | Engine — Execução | engine.plan/session | Como blocos, fluxos e CDA funcionam em runtime | Especificado |
| 8 | Activity | activity | Como cada tipo de atividade é executado pelo aluno | Especificado |
| 9 | Metrics | metrics | Como desempenho e nível são computados | Especificado |
| 10 | Platform | platform | Como o NextJS consome tudo via gateway | Especificado |
Princípio narrativo
Cada página segue a mesma estrutura:
- Narrativa — o que acontece, quem faz, em que ordem
- Entidades e componentes — tabela de referência técnica
- Signals emitidos — o que habilita o próximo passo
- Referências — ADRs, REFs e contratos JSON relacionados
A leitura é sequencial: cada passo depende do anterior e habilita o próximo.
Páginas complementares
Explicam uma regra específica que atravessa mais de um passo, fora da sequência acima.
| Página | Domínio | O que responde | Status |
|---|---|---|---|
| Retrospectiva — dias do ciclo | engine.access / engine.plan | Como a Retrospectiva conta a Duração do Ciclo e os Dias de Preparação | Em revisão |
Decisões arquiteturais
As decisões técnicas que sustentam esta especificação estão registradas nos ADRs. As specs de implementação (pseudocódigo, algoritmos, critérios de aceitação) estão nos REFs vinculados a cada ADR.