Entrega ao Aluno
Esta página responde a uma pergunta central: como todo o processamento feito pelo backend — conteúdo, Trilhas, Planos, execução, métricas — chega até o Aluno no frontend?
A HÉLICO opera em arquitetura separada: o Backend (Moodle LMS + plugin local_helico) concentra regras de negócio, persistência e processamento; o Frontend (Plataforma HÉLICO, aplicação NextJS) consome os dados via API REST e os apresenta ao Aluno. Essa separação é fundamental — o frontend nunca executa regras pedagógicas, apenas consome contratos de dados.
O domínio platform organiza as entidades de interface, a API e a arquitetura técnica.
Arquitetura de entrega
Backend (Moodle + local_helico) Frontend (NextJS)
───────────────────────────────── ──────────────────
Motor de Compilação Área do Aluno
Motor de Execução ──── API REST ──→ Roteiro de Estudos
Motor de Consolidação Simulados (visão)
Persistência EAV Desempenho (visão)
Signals + Jobs Caderno Online
Biblioteca Online
Comunidade
FAQ / PerfilAPI REST HÉLICO
A API REST HÉLICO é o conjunto de contratos de comunicação que conecta Frontend e Backend. Ela expõe dados e operações ligados a:
- Produtos e Trilhas Pedagógicas
- Plano de Estudo e Plano do Aluno
- Fluxos, Blocos e Atividades (estado de execução)
- Simulados (questões, respostas, resultados)
- Métricas e classificações
- Conteúdo (via Snapshots de Unidade)
- Caderno Online (artefatos do Aluno)
- Notificações e comunicações
O backend controla autenticação via tokens Moodle e autoriza operações conforme o estado da Matrícula e do Plano do Aluno.
Visões do Aluno
Área do Aluno
Visão principal pós-Onboarding. Organiza a entrada operacional no estudo com componentes como:
- Próximas Atividades — resumo do Bloco Atual e atividades elegíveis
- Acesso Rápido — atalhos para Roteiro de Estudos, Simulados, Desempenho, Biblioteca
- Notificações — alterações pedagógicas, campanhas, avisos do Gestor
Roteiro de Estudos
Visão operacional central da execução. É onde o Aluno enxerga:
- o Fluxo Atual e o Bloco Atual
- os próximos passos já elegíveis
- os conteúdos e atividades liberados para o momento
- o progresso acumulado
O Roteiro de Estudos é alimentado pelo Motor de Execução. Cada interação do Aluno (iniciar atividade, responder questão, concluir bloco) gera um Evento de Execução do Plano de Estudo que atualiza o estado visível.
Disciplina no Roteiro de Estudos
Dentro do Roteiro, o Aluno navega por Disciplina. Cada Disciplina mostra:
- Módulos em que a Disciplina aparece
- Notas e classificação por Unidade
- Importância e Incidência configuradas
- Acesso ao conteúdo da Unidade (via Snapshot)
Caderno Online
Recurso pedagógico permanente que reúne os Artefatos do Caderno Online gerados pelo Aluno:
- Sínteses produzidas no Resumo
- Anotações e grifos da Leitura
- Interações revisadas na Leitura de Reforço
Regra de visibilidade
Somente os conteúdos das Atividades já concluídas ficam disponíveis na visão global do Caderno Online. Os conteúdos das Atividades do Bloco Atual ficam limitados à visualização no Roteiro de Estudos (decisão A-09).
Desempenho (Visão)
Dashboards com Nota Real, progresso, classificação por Disciplina/Módulo, gráficos de evolução. Consome as métricas consolidadas pelo Motor de Consolidação.
Simulados (Visão)
Visão de acesso aos simulados do Produto (VF, Objetivo, Escrito, Flashcards). Organiza por tipo, status (pendente, em andamento, concluído) e resultados.
Outros recursos
| Recurso | Papel | Condição |
|---|---|---|
| Biblioteca Online | Acervo complementar de materiais | Recurso Opcional habilitado pelo Produto |
| Comunidade | Espaço de interação entre Alunos | Recurso Opcional |
| FAQ do Aluno | Perguntas frequentes do Produto | Sempre disponível |
| Perfil do Usuário | Dados cadastrais e preferências | Sempre disponível |
Notificações
O sistema de notificações conecta o backend à experiência do Aluno:
| Tipo | Canal | Origem |
|---|---|---|
| Alteração pedagógica | Badge no Caderno Online (via API → NextJS) | Oferta de atualização de tópico (sinal notebook_topic_update_offered; o badge ainda não foi construído) |
| Campanha de Comunicação | Web, mobile, e-mail (conforme configuração) | Evento de Comunicação + Vínculo Produto-Campanha |
| Conflito resolvido | Notificação ao Gestor | Cascata de content_conflict_resolved |
| Flashcards gerados | Notificação ao Gestor | flashcard_job_persisted |
O Gestor decide quando uma alteração chega ao Aluno ao aprovar o item; o Aluno é quem decide levar o texto novo ao próprio Caderno, aceitando ou recusando a oferta. O aviso da oferta ainda não foi construído: existe apenas o sinal que o dispara.
Modelo de dados
Entidades de interface
| # | Identifier | Tipo | Subdomain | Papel |
|---|---|---|---|---|
| 1 | student_area |
screen | platform | Área do Aluno — visão principal |
| 2 | rest_api |
technical_component | platform | API REST — contratos de comunicação |
| 3 | study_roadmap |
screen | platform | Roteiro de Estudos |
| 4 | online_notebook |
screen | platform | Caderno Online |
| 5 | performance_view |
screen | platform | Desempenho (Visão) |
O que esta página não define
- Detalhes de implementação do NextJS (framework, componentes, state management)
- Contratos de API endpoint por endpoint (→ documentação de API em
docs/plataforma/api-integracoes/) - Specs de UI/UX (wireframes, telas, responsividade)
- Specs dos épicos Jira HELICO-6 e HELICO-15 (→ specs de implementação, fora do escopo desta seção)
Referências
- Motor de Execução — como o backend conduz o percurso (Passo 7)
- Métricas e Classificação — como as métricas são computadas (Passo 9)
- Atividades — como cada tipo de atividade funciona (Passo 8)
- Execução do Aluno (Metodologia) — fundamentos do Roteiro de Estudos
- Terms: platform — vocabulário canônico da plataforma e API