UC-004: Área do Aluno (Dashboard + Estudo)
Status: EM REVISÃO Data: 2026-04-29 Domínio: platform / engine.plan Ator: Aluno Terms: Área do Aluno, Próximas Atividades, Roteiro de Estudos, Disciplina no Roteiro de Estudos, Fluxo Atual, Bloco Atual, Módulo, Sequência do Plano de Estudo, Plano do Aluno, Status da Disciplina no Roteiro, Notificação do Aluno
Contexto
Após UC-002 confirmar Matrícula ativa com Onboarding completo e Plano do Aluno ativo, o Frontend carrega a Área do Aluno. A Área do Aluno é composta por componentes independentes que consomem endpoints separados em paralelo.
IMPORTANTE: O Plano do Aluno é entidade autônoma após criação. Não depende mais do Plano de Estudo para consultas. Todos os dados de execução vêm do Plano do Aluno diretamente.
Arquitetura de endpoints
Dois namespaces:
/platform/dashboard ← resumo cross-product
/platform/notifications ← notificações do sistema (bell icon)
/platform/study/{enrolment_id}/* ← exige contexto da matrícula ativa- Dashboard: resumo geral, não depende de produto selecionado.
- Notifications: notificações do sistema, cross-product (bell icon no Header).
- Study: dados do estudo, exige
enrolment_id(contexto ativo no Frontend).
Endpoints
GET /platform/dashboard
Resumo cross-product do Aluno.
GET /platform/dashboard
Authorization: Bearer {wstoken}Resposta:
{
"enrolments_active": 1,
"has_pending_onboarding": false,
"unread_notifications": 3,
"last_activity": "2026-04-28T14:30:00Z"
}GET /platform/notifications
Notificações do sistema (bell icon no Header). Cross-product.
GET /platform/notifications?unread_only=false
Authorization: Bearer {wstoken}Resposta:
{
"unread_count": 2,
"notifications": [
{
"id": "notif-001",
"title": "Conteúdo atualizado em Direito Constitucional",
"body": "A Unidade 3 foi atualizada com novas questões.",
"read": false,
"created_at": "2026-04-28T10:00:00Z",
"action": {
"type": "navigate_with_context",
"label": "Ver alterações",
"route": "/roteiro-de-estudos",
"params": { "discipline_id": 5, "unit_id": 3 }
}
}
]
}Term: Notificação do Aluno. Diferente de alertas do estudo (tarefas acionáveis).
GET /platform/study/{enrolment_id}/alerts
Alertas acionáveis do estudo — per-enrollment.
GET /platform/study/{enrolment_id}/alerts
Authorization: Bearer {wstoken}Resposta:
{
"alerts": [
{
"id": "alert-001",
"title": "Novas correções disponíveis",
"variant": "info",
"action": {
"type": "navigate",
"label": "Acessar",
"route": "/caderno-online"
}
},
{
"id": "alert-002",
"title": "Simulado disponível para revisão",
"variant": "success",
"action": {
"type": "navigate_with_context",
"label": "Revisar agora",
"route": "/simulados/revisao",
"params": { "exam_id": 42, "attempt_id": 7 }
}
},
{
"id": "alert-003",
"title": "Confirme sua disponibilidade semanal",
"variant": "warning",
"action": {
"type": "modal",
"label": "Ajustar",
"modal_key": "weekly_hours_edit"
}
},
{
"id": "alert-004",
"title": "Material complementar disponível",
"variant": "info",
"action": {
"type": "external",
"label": "Abrir",
"url": "https://biblioteca.helico.com.br/material/123"
}
}
]
}Tipos de action:
action.type |
Descrição | Campos |
|---|---|---|
navigate |
Página interna simples | label, route |
navigate_with_context |
Página interna com dados | label, route, params{} |
modal |
Abre modal no Frontend | label, modal_key |
external |
Link externo | label, url |
dismiss |
Apenas dispensar alerta | label |
Variants: info, success, warning, error.
Diferente de Notificação do Aluno (ícone no Header) — alertas são tarefas acionáveis na Área do Aluno.
GET /platform/study/{enrolment_id}/progress
“Seu Andamento” — progresso do módulo atual no produto ativo.
GET /platform/study/{enrolment_id}/progress
Authorization: Bearer {wstoken}Resposta:
{
"student_plan": {
"id": 500,
"status": "active"
},
"current_module": {
"id": 1,
"name": "Módulo 1",
"block_id": 15
},
"trail_name": "Promotor de Justiça — Curso Regular Extensivo",
"progress": {
"percentage": 35,
"completed_blocks": 7,
"total_blocks": 20
},
"action": {
"type": "navigate",
"label": "Continuar",
"route": "/roteiro-de-estudos"
}
}Mapeamento terms:
current_module→ Módulo (nome amigável do Fluxo Atual)current_module.block_id→ Bloco Atualtrail_name→ nome amigável da Trilha Pedagógica (cargo/carreira)progress→ derivado do Plano do Aluno (blocos concluídos / total)action→ navega para Roteiro de Estudos (Começar/Continuar)
GET /platform/study/{enrolment_id}/disciplines
Disciplinas do fluxo atual, agrupadas pelo Backend.
GET /platform/study/{enrolment_id}/disciplines
Authorization: Bearer {wstoken}Resposta:
{
"disciplines": [
{
"id": 5,
"name": "Direito Constitucional",
"status": "in_progress",
"units_total": 12,
"units_completed": 4
},
{
"id": 8,
"name": "Direito Penal",
"status": "not_started",
"units_total": 15,
"units_completed": 0
}
]
}Status (term: Status da Disciplina no Roteiro):
not_started→ Disciplina no Roteiro Não Iniciadain_progress→ Disciplina no Roteiro Em Execuçãoblocked→ Disciplina no Roteiro Bloqueadacompleted→ Disciplina no Roteiro Concluída
Notas:
- Backend agrupa unidades do fluxo atual por disciplina (corte pela carga horária do aluno)
- Frontend mostra “Em andamento” e “Não Iniciadas” por padrão
- “Concluídas” disponíveis no contrato mas omitidas no Frontend atual (ponto de atenção para outros produtos)
Fluxo no Frontend
Frontend carrega Área do Aluno (/)
│
├── Calls paralelas:
│ ├── GET /platform/dashboard (resumo cross-product)
│ ├── GET /platform/notifications (bell icon)
│ ├── GET /platform/study/{enrolment_id}/progress (Seu Andamento)
│ ├── GET /platform/study/{enrolment_id}/disciplines (Disciplinas)
│ └── GET /platform/study/{enrolment_id}/alerts (Alertas do estudo)
│
├── Componente "Seu Andamento":
│ └── Módulo atual + trail name + % progresso + botão Continuar
│
├── Componente "Disciplinas":
│ └── Cards por disciplina (Em andamento / Não Iniciadas)
│
├── Componente "Alertas":
│ └── Lista de alertas com ações dinâmicas
│
└── Componente "Desempenho Geral" (UC futuro):
└── Gráficos e métricas — /platform/study/{enrolment_id}/performanceEndpoints futuros sob /platform/study/{enrolment_id}
| Endpoint | Descrição |
|---|---|
GET .../study-guide |
Roteiro de Estudos completo |
GET .../activities/{block_id} |
Atividades de um bloco |
GET .../performance |
Desempenho do produto |
GET .../flashcards |
Flashcards por disciplina |
GET .../exams |
Simulados e revisões |
Erros esperados
| HTTP | Código | Situação |
|---|---|---|
| 401 | unauthorized |
Token inválido ou expirado |
| 404 | enrolment_not_found |
enrolment_id não existe ou não pertence ao usuário |
| 403 | plan_not_active |
Plano do Aluno não está ativo para esta inscrição |
Decisões
- D-01: Três namespaces:
/platform/dashboard(cross-product),/platform/notifications(bell icon),/platform/study/{id}/*(per-enrollment) - D-02: Notificações (
/platform/notifications) são avisos do sistema (bell icon). Alertas (/platform/study/{id}/alerts) são tarefas acionáveis do estudo - D-03: Agrupamento de disciplinas feito no Backend (cache compartilhado, Frontend puro renderizador)
- D-04: Alertas e notificações com action dinâmica (navigate, navigate_with_context, modal, external, dismiss)
- D-05: Plano do Aluno é autônomo — dados de execução não passam pelo Plano de Estudo
- D-06: “Disciplinas Concluídas” disponíveis no contrato mas omitidas no Frontend atual
- D-07: Desempenho Geral tratado em UC separado