Skip to content

UC-004: Área do Aluno (Dashboard + Estudo)

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 Atual
  • trail_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 Iniciada
  • in_progress → Disciplina no Roteiro Em Execução
  • blocked → Disciplina no Roteiro Bloqueada
  • completed → 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}/performance

Endpoints 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
Navigation

Type to search…

↑↓ navigate↵ selectEsc close