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 operacionaisController: 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/jsonRequest 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_practicepor disciplina - D-03:
general_reviewé tipo de BLOCO com N slotsgeneral_reviewpor unidade/disciplina - D-04: Session é sub-recurso separado do slot (GET/POST /session)
- D-05: Novo
slot_api_controller.phpseparado dostudy_api_controller - D-06: Sem timer forçado — tempo é telemetria. Exceção:
exam_writtentem 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