Skip to content

UC-006: Detalhe do Slot — Navegação por Atividade

UC-006: Detalhe do Slot — Navegação por Atividade

Status: EM REVISÃO Data: 2026-04-29 Domínio: platform / engine.session Ator: Aluno Terms: Atividade, Sessão de Execução, Sessão de Questionário, Sessão de Flashcards, Diagnóstico Inicial (DI), Simulado de Verificação de Desempenho (SVD), Estudo Dirigido, Prática com Flashcards, Simulado Escrito, Simulado Objetivo, Revisão Geral, Tópico de Conteúdo, Snapshot de Unidade, Flashcard Atual, Resposta do Flashcard, Questão Atual, Resposta do Questionário, Opção Não Sei, Devolutiva do Simulado Escrito, Folha Espelho, Artefato do Caderno Online, Critério de Feedback do Questionário

Contexto

Quando o Aluno clica em um slot no Roteiro de Estudos (UC-005) e navega para /roteiro-de-estudos/{slot_id}, o Frontend precisa de dados enriquecidos para renderizar a atividade e permitir a execução.

O slot listing (GET /study/{id}) retorna contexto resumido. O detalhe retorna contexto completo: questões, flashcards, conteúdo de estudo, instruções, regras.

A Session (estado do Aluno) é um sub-recurso separado do slot. O slot contém o contrato estático da atividade; a session contém o estado dinâmico (respostas, progresso, tempo gasto).

Premissas aplicadas: Slot agnóstico (REF-90-A §7), context{} como campo de extensão (§9), scope[] flexível (§8), Backend agrupa (§16), sem timer forçado — tempo é telemetria (D-06).

Endpoints

SLOT (contrato estático)
GET  /platform/study/{enrolment_id}/slots/{slot_id}            → Detalhe do slot
POST /platform/study/{enrolment_id}/slots/{slot_id}            → Submissão final

SESSION (sub-recurso dinâmico — telemetria + estado)
GET  /platform/study/{enrolment_id}/slots/{slot_id}/session    → Estado da sessão
POST /platform/study/{enrolment_id}/slots/{slot_id}/session    → Ações operacionais

Controller: slot_api_controller.php

GET /platform/study/{enrolment_id}/slots/{slot_id} — Detalhe

GET /platform/study/{enrolment_id}/slots/{slot_id}
Authorization: Bearer {wstoken}

Reutiliza a estrutura agnóstica do slot (REF-90-A §7), com context{} enriquecido pelo tipo de atividade:

{
  "id": "550e8400-0001-0000-0000-000000000001",
  "order": 1,
  "type": "diagnostic_initial",
  "status": "not_started",
  "label": "Diagnóstico Inicial",
  "scope": [
    { "type": "discipline", "id": 5, "name": "Direito Constitucional" }
  ],
  "context": {
    "questions_count": 20,
    "estimated_minutes": 30,
    "has_not_sure_option": true,
    "feedback_criteria": "after_submit",
    "questions": [
      {
        "id": 1,
        "order": 1,
        "statement_html": "<p>O controle difuso de constitucionalidade pode ser exercido por qualquer juiz ou tribunal.</p>",
        "alternatives": [
          { "key": "V", "label": "Verdadeiro" },
          { "key": "F", "label": "Falso" }
        ]
      }
    ]
  },
  "result": null,
  "locked": null,
  "action": {
    "type": "navigate",
    "label": "Começar",
    "route": "/roteiro-de-estudos/550e8400-0001-0000-0000-000000000001"
  }
}

Context por tipo de atividade

Cada tipo de atividade define seu próprio context{}. O Frontend renderiza genericamente com base em slot.type. Detalhes completos em uc-005-anexo-atividades.md.

Tipos reconhecidos (identifiers canônicos)

type Term Bloco típico
diagnostic_initial Diagnóstico Inicial (DI) Bloco CDA
diagnostic_verify Simulado de Verificação de Desempenho (SVD) Bloco CDA
guided_study Estudo Dirigido (Resumo, Leitura, Reforço) Bloco CDA
exam_written Simulado Escrito Bloco Simulados Escritos
exam_objective Simulado Objetivo Bloco Simulado Objetivo
flashcard_practice Prática com Flashcards Bloco Revisão do Módulo
general_review Revisão Geral Bloco Revisão Geral

Nota: module_review é tipo de BLOCO (não slot). O Bloco de Revisão do Módulo contém N slots flashcard_practice (1 por disciplina). Igualmente, o Bloco de Revisão Geral contém N slots general_review (1 por unidade/disciplina).

Resumo do context por tipo

type Campos principais do context
diagnostic_initial questions[], estimated_minutes, has_not_sure_option, feedback_criteria
diagnostic_verify Mesma estrutura de diagnostic_initial
guided_study format, instruction, content.topics[], estimated_minutes
exam_written subtype, submission_rules{}, instruction_html, mirror_sheet_url
exam_objective questions[] (alternativas ABCDE), estimated_minutes, feedback_criteria
flashcard_practice cards[], cards_count, session_type
general_review content.topics[], notebook_entries[], editable, review_scope

GET /platform/study/{enrolment_id}/slots/{slot_id}/session — Estado

GET /platform/study/{enrolment_id}/slots/{slot_id}/session
Authorization: Bearer {wstoken}

Retorna o estado dinâmico do Aluno na atividade: respostas, progresso, tempo gasto. A session é criada via POST action=start e persiste até o submit. Pause/resume opera na mesma session.

Resposta (exemplo para diagnostic_initial):

{
  "id": "a1b2c3d4-0000-0000-0000-000000000001",
  "status": "in_progress",
  "started_at": "2026-04-29T14:00:00Z",
  "paused_at": null,
  "time_spent_seconds": 420,
  "current_question_index": 5,
  "answers": [
    { "question_id": 1, "answer": "V", "not_sure": false },
    { "question_id": 2, "answer": "F", "not_sure": false },
    { "question_id": 3, "answer": null, "not_sure": true },
    { "question_id": 4, "answer": "V", "not_sure": false },
    { "question_id": 5, "answer": "F", "not_sure": false }
  ],
  "feedback": null
}

Session por tipo

type Campos da session
diagnostic_initial / diagnostic_verify answers[], current_question_index, feedback
guided_study draft{} (rascunho salvo)
exam_written submission{}, feedback{} (Devolutiva)
exam_objective answers[], current_question_index, feedback
flashcard_practice responses[], current_index
general_review edits[] (edições nos Tópicos de Conteúdo)

Campos comuns a todas as sessions: id, status, started_at, paused_at, time_spent_seconds.

Status da session: not_started, in_progress, paused, completed.

POST /platform/study/{enrolment_id}/slots/{slot_id}/session — Ações

POST /platform/study/{enrolment_id}/slots/{slot_id}/session
Authorization: Bearer {wstoken}
Content-Type: application/json

Request body:

{
  "action": "start",
  "data": {}
}

Ações disponíveis

action Descrição Transição de status
start Iniciar sessão (sem session) → in_progress
save Salvar progresso in_progress → in_progress
pause Pausar sessão in_progress → paused
resume Retomar sessão paused → in_progress

Resposta:

{
  "success": true,
  "session": {
    "id": "a1b2c3d4-0000-0000-0000-000000000001",
    "status": "in_progress",
    "started_at": "2026-04-29T14:00:00Z"
  }
}

save data por tipo

type data esperado no save
diagnostic_initial / diagnostic_verify / exam_objective { "answers": [...], "current_question_index": 5 }
guided_study { "draft": { "content": "Texto parcial..." } }
flashcard_practice { "responses": [...], "current_index": 5 }
exam_written { "submission": { "file_id": "upload-uuid", "pages": 4 } }
general_review { "edits": [{ "topic_id": 1, "content": "Texto editado..." }] }

POST /platform/study/{enrolment_id}/slots/{slot_id} — Submissão final

Já definido no UC-005. Transiciona o slot para completed e retorna result + effects[].

POST /platform/study/{enrolment_id}/slots/{slot_id}
Authorization: Bearer {wstoken}
Content-Type: application/json

{ "action": "submit", "data": { ... } }

A session correspondente também transiciona para completed.

Erros esperados

HTTP Código Situação
401 unauthorized Token inválido ou expirado
404 enrolment_not_found Matrícula não encontrada
404 slot_not_found Slot não existe ou não pertence à matrícula
403 slot_locked Slot locked — não pode ser acessado para execução
404 session_not_found GET /session antes de POST start
409 slot_already_completed Tentativa de start/submit em slot já completed
409 session_already_active Tentativa de start com session já ativa
422 invalid_action Ação inválida para o estado atual da session

Decisões

  • D-01: Slot detail reutiliza estrutura agnóstica do slot (context{} enriquecido por type)
  • D-02: module_review é tipo de BLOCO, não slot. Slots dentro = flashcard_practice por disciplina
  • D-03: general_review é tipo de BLOCO com N slots general_review por unidade/disciplina
  • D-04: Session é sub-recurso separado do slot (GET/POST /session)
  • D-05: Novo slot_api_controller.php separado do study_api_controller
  • D-06: Sem timer forçado — tempo é telemetria. Exceção: exam_written tem deadline
  • D-07: Slot types usam identifier canônico de terms*.yaml
  • D-08: Pause/resume opera na mesma session — 1 session por slot por vez
Navigation

Type to search…

↑↓ navigate↵ selectEsc close