Skip to content

Entrega ao Aluno

Especificação técnica — como o NextJS consome tudo via API e apresenta ao Aluno

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 / Perfil

API 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

Navigation

Type to search…

↑↓ navigate↵ selectEsc close