{
	"info": {
		"_postman_id": "b2c3d4e5-helico-platform-api-v1",
		"name": "HÉLICO — Platform API",
		"description": "Coleção oficial da Platform API HÉLICO consumida pelo Frontend NextJS.\n\n## Mudanças em relação à versão `_archive`\n\n- **Auth via wstoken**: a coleção antiga usava cookie de sessão Moodle (`POST /login/index.php`). A versão atual segue UC-001 — login retorna `wstoken`, usado em `Authorization: Bearer` ou `?wstoken=` query param.\n- **BASE_PATH limpo**: paths agora são `/local/helico/ajax.php/api/v1/platform/*` (sem o `helico/` redundante).\n- **Localização oficial**: o artefato vivo passou a ser `docs/plataforma/api-integracoes/postman/`.\n\n## Estrutura\n\nCada pasta agrupa um recurso/dimensão do contrato. As pastas estão ordenadas para seguir o **happy path do Aluno** (login → identidade → onboarding → roteiro → atividade → métricas), mas também são navegáveis de forma independente.\n\n## Pré-requisitos\n\n1. Backend rodando em `{{base_url}}` (default: `http://moodle.helico.localhost`).\n2. Web service `moodle_mobile_app` habilitado no Moodle (alvo de `service` em `/login/token.php`).\n3. Usuário de teste matriculado em pelo menos um Curso-Produto com Trilha Pedagógica `active`.\n4. Para Cenário 2 (login social): provedor SSO (Google) configurado no MIDDAG e credenciais OAuth válidas.\n\n## Variáveis automáticas\n\nOs scripts de teste populam estas variáveis ao executar a sequência:\n\n- `wstoken` ← `0. Auth / POST /login/token.php` ou `0. Auth / POST /local/middag/api/auth/login`\n- `enrolment_id` ← `1. Identidade / GET /enrolments`\n- `student_plan_id` ← `2. Onboarding / POLL /enrolments`\n- `slot_id` ← `4. Roteiro / GET /study/{enrolment_id}` (primeiro slot `not_started`)\n- `submission_id` ← `Admin Correção / GET /admin/corrections/pending` (quando houver fila)\n\n## Convenções\n\n- Todas as chamadas autenticadas usam `Authorization: Bearer {{wstoken}}` no header.\n- Variante `?wstoken={{wstoken}}` documentada inline em cada request (ver descrição).\n- Erros seguem `{ error: <slug>, message?, errors[]? }` (ver OpenAPI por response code).\n- Polling de `/enrolments` segue o contrato P1: intervalo mínimo 2s, backoff exponencial até 30s.\n\n## Referências\n\n- [autenticacao.md](../autenticacao.md)\n- [openapi.yaml](../openapi.yaml)\n- [UC-001](../../../operacao/uc-001-login.md)",
		"schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
	},
	"variable": [
		{
			"key": "base_url",
			"value": "https://moodle.helico.dev",
			"type": "string"
		},
		{
			"key": "api_prefix",
			"value": "/local/helico/ajax.php/api/v1/platform",
			"type": "string"
		},
		{
			"key": "username",
			"value": "equipefront",
			"type": "string"
		},
		{
			"key": "password",
			"value": "Equipefront1@",
			"type": "string"
		},
		{
			"key": "wstoken",
			"value": "",
			"type": "string"
		},
		{
			"key": "enrolment_id",
			"value": "",
			"type": "string"
		},
		{
			"key": "student_plan_id",
			"value": "",
			"type": "string"
		},
		{
			"key": "slot_id",
			"value": "",
			"type": "string"
		},
		{
			"key": "submission_id",
			"value": "",
			"type": "string"
		},
		{
			"key": "artifact_id",
			"value": "",
			"type": "string"
		},
		{
			"key": "your_secret_token",
			"value": "",
			"type": "string"
		}
	],
	"auth": {
		"type": "bearer",
		"bearer": [
			{
				"key": "token",
				"value": "{{wstoken}}",
				"type": "string"
			}
		]
	},
	"item": [
		{
			"name": "0. Auth",
			"description": "Obtenção do `wstoken` via Moodle nativo (email+senha) ou MIDDAG (social/SSO). Variante `?wstoken=` documentada inline.",
			"item": [
				{
					"name": "POST /login/token.php (Moodle nativo, email+senha)",
					"event": [
						{
							"listen": "test",
							"script": {
								"type": "text/javascript",
								"exec": [
									"pm.test('200 OK', () => pm.response.to.have.status(200));",
									"const json = pm.response.json();",
									"if (json.errorcode) {",
									"    pm.test('Sem errorcode', () => pm.expect.fail('errorcode=' + json.errorcode));",
									"} else {",
									"    pm.test('Tem token', () => pm.expect(json.token).to.be.a('string').and.not.empty);",
									"    pm.collectionVariables.set('wstoken', json.token);",
									"    console.log('wstoken gravado.');",
									"}"
								]
							}
						}
					],
					"request": {
						"auth": {
							"type": "noauth"
						},
						"method": "POST",
						"header": [
							{
								"key": "Content-Type",
								"value": "application/x-www-form-urlencoded"
							}
						],
						"body": {
							"mode": "urlencoded",
							"urlencoded": [
								{
									"key": "username",
									"value": "{{username}}"
								},
								{
									"key": "password",
									"value": "{{password}}"
								},
								{
									"key": "service",
									"value": "moodle_mobile_app"
								}
							]
						},
						"url": {
							"raw": "{{base_url}}/login/token.php",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"login",
								"token.php"
							]
						},
						"description": "**O que faz:** autentica via Moodle nativo, devolve `wstoken` HÉLICO.\n\n**Body:** form-encoded com `username` + `password` + `service=moodle_mobile_app`.\n\n**Response 200 (sucesso):** `{ token, privatetoken }`. O test script grava `token` na variável `wstoken`.\n\n**Response 200 com `errorcode`:** Moodle retorna 200 mesmo em falha — inspecionar `errorcode` (ex: `invalidlogin`).\n\nVer [autenticacao.md#cenário-1](../autenticacao.md)."
					}
				},
				{
					"name": "POST /local/middag/api/auth/login (social, doc-first)",
					"event": [
						{
							"listen": "test",
							"script": {
								"type": "text/javascript",
								"exec": [
									"pm.test('200 OK', () => pm.response.to.have.status(200));",
									"const json = pm.response.json();",
									"if (json.token) {",
									"    pm.collectionVariables.set('wstoken', json.token);",
									"    console.log('wstoken (MIDDAG) gravado. User:', json.user && json.user.id);",
									"} else {",
									"    console.warn('B-pend-1: MIDDAG não retornou token ainda. Use Cenário 1 enquanto isso.');",
									"}"
								]
							}
						}
					],
					"request": {
						"auth": {
							"type": "noauth"
						},
						"method": "POST",
						"header": [
							{
								"key": "Content-Type",
								"value": "application/json"
							}
						],
						"body": {
							"mode": "raw",
							"raw": "{\n  \"provider\": \"google\",\n  \"code\": \"<authorization-code-from-OAuth-callback>\",\n  \"redirect_uri\": \"https://helico.com.br/auth/callback\"\n}"
						},
						"url": {
							"raw": "{{base_url}}/local/middag/api/auth/login",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"local",
								"middag",
								"api",
								"auth",
								"login"
							]
						},
						"description": "**O que faz:** troca código OAuth (do callback do provedor SSO) por `wstoken` HÉLICO + dados básicos do usuário.\n\n**Body:** JSON com `provider`, `code` (ou `idtoken`), `redirect_uri`.\n\n**Response 200 (esperado, doc-first):** `{ token, user: { id, fullname, email, avatar_url } }`.\n\n**Status atual (B-pend-1):** MIDDAG ainda não retorna `token` no payload — implementação em desenvolvimento. Até subir, o request retorna apenas `user`. Use o Cenário 1 (Moodle nativo) enquanto isso.\n\nVer [autenticacao.md#cenário-2](../autenticacao.md)."
					}
				},
				{
					"name": "(referência) variante: ?wstoken= em URL",
					"request": {
						"auth": {
							"type": "noauth"
						},
						"method": "GET",
						"url": {
							"raw": "{{base_url}}{{api_prefix}}/me?wstoken={{wstoken}}",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"{{api_prefix}}",
								"me"
							],
							"query": [
								{
									"key": "wstoken",
									"value": "{{wstoken}}"
								}
							]
						},
						"description": "**Referência apenas.** Demonstra que `?wstoken=` na query string é equivalente ao header `Authorization: Bearer`. Usar quando o cliente não pode controlar headers (download direto, iframe, EventSource).\n\n**Tradeoff:** token aparece em access logs e header `Referer`. Preferir Bearer quando possível.\n\nVer [autenticacao.md#uso-do-wstoken-nas-requisições](../autenticacao.md)."
					}
				}
			]
		},
		{
			"name": "1. Identidade",
			"description": "Quem é o usuário autenticado e quais matrículas ele possui. Decide o roteamento pós-login.",
			"item": [
				{
					"name": "GET /me",
					"event": [
						{
							"listen": "test",
							"script": {
								"type": "text/javascript",
								"exec": [
									"pm.test('200 OK', () => pm.response.to.have.status(200));",
									"const json = pm.response.json();",
									"pm.test('Tem id + email', () => {",
									"    pm.expect(json).to.have.property('id');",
									"    pm.expect(json).to.have.property('email');",
									"});"
								]
							}
						}
					],
					"request": {
						"method": "GET",
						"url": {
							"raw": "{{base_url}}{{api_prefix}}/me",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"{{api_prefix}}",
								"me"
							]
						},
						"description": "**O que faz:** retorna `{ id, fullname, email, avatar_url }` do usuário autenticado.\n\n**Quando usar:** após login Cenário 1 (Moodle nativo não retorna user info). Pular se login foi via Cenário 2 (MIDDAG já retornou)."
					}
				},
				{
					"name": "GET /enrolments (captura enrolment_id)",
					"event": [
						{
							"listen": "test",
							"script": {
								"type": "text/javascript",
								"exec": [
									"pm.test('200 OK', () => pm.response.to.have.status(200));",
									"const json = pm.response.json();",
									"pm.test('Tem enrolments[]', () => pm.expect(json.enrolments).to.be.an('array'));",
									"if (json.enrolments && json.enrolments.length) {",
									"    const e = json.enrolments[0];",
									"    pm.collectionVariables.set('enrolment_id', e.id);",
									"    if (e.student_plan && e.student_plan.id) {",
									"        pm.collectionVariables.set('student_plan_id', e.student_plan.id);",
									"    }",
									"    console.log('enrolment_id:', e.id, '| student_plan:', e.student_plan);",
									"}"
								]
							}
						}
					],
					"request": {
						"method": "GET",
						"url": {
							"raw": "{{base_url}}{{api_prefix}}/enrolments",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"{{api_prefix}}",
								"enrolments"
							]
						},
						"description": "**O que faz:** lista matrículas do Aluno autenticado, com estado do `student_plan` (`creating | active | failed`).\n\n**Roteamento Frontend:**\n- sem matrícula → catálogo / aguardando configuração comercial\n- onboarding pendente (`student_plan` ausente) → fluxo de Onboarding\n- `student_plan.status=active` → Área do Aluno\n- `student_plan.status=failed` → erro + retry (T3)"
					}
				}
			]
		},
		{
			"name": "2. Onboarding",
			"description": "Questionário de Onboarding. Backend define steps; Frontend renderiza genericamente.",
			"item": [
				{
					"name": "GET /onboarding/{enrolment_id}",
					"event": [
						{
							"listen": "test",
							"script": {
								"type": "text/javascript",
								"exec": [
									"pm.test('200 OK', () => pm.response.to.have.status(200));",
									"const json = pm.response.json();",
									"pm.test('Tem steps[]', () => pm.expect(json.steps).to.be.an('array'));"
								]
							}
						}
					],
					"request": {
						"method": "GET",
						"url": {
							"raw": "{{base_url}}{{api_prefix}}/onboarding/{{enrolment_id}}",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"{{api_prefix}}",
								"onboarding",
								"{{enrolment_id}}"
							]
						},
						"description": "**O que faz:** retorna configuração dos steps do Onboarding para a fase pendente da matrícula (`general` ou `complement`).\n\n**Tipos de input no nível do step:** `multi_select`, `single_select`, `slider`. Cada `option` pode declarar `label_template` + `inputs[]` para renderização inline. Frontend NÃO hardcoda steps."
					}
				},
				{
					"name": "POST /onboarding/{enrolment_id}/submit",
					"event": [
						{
							"listen": "test",
							"script": {
								"type": "text/javascript",
								"exec": [
									"pm.test('200 OK', () => pm.response.to.have.status(200));",
									"const json = pm.response.json();",
									"if (json.onboarding_completed && json.student_plan) {",
									"    console.log('Onboarding concluído. student_plan:', json.student_plan);",
									"}"
								]
							}
						}
					],
					"request": {
						"method": "POST",
						"header": [
							{
								"key": "Content-Type",
								"value": "application/json"
							}
						],
						"body": {
							"mode": "raw",
							"raw": "{\n  \"answers\": [\n    { \"key\": \"weekly_hours\", \"value\": 25 },\n    { \"key\": \"areas_of_interest\", \"value\": [\"penal\", \"constitucional\"] },\n    { \"key\": \"experience\", \"value\": { \"option\": \"yes\", \"inputs\": { \"years\": 3 } } }\n  ]\n}"
						},
						"url": {
							"raw": "{{base_url}}{{api_prefix}}/onboarding/{{enrolment_id}}/submit",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"{{api_prefix}}",
								"onboarding",
								"{{enrolment_id}}",
								"submit"
							]
						},
						"description": "**O que faz:** envia respostas e conclui a fase atual. `value` em `answers[]` é heterogêneo: number (slider), string ou `{option, inputs?}` (single_select), array de string ou de `{option, inputs?}` (multi_select).\n\n**Resposta na conclusão (último submit):** `{ onboarding_completed: true, student_plan: { id: null, status: 'creating' } }`. Frontend então polleia `/enrolments` (próxima request).\n\n**Idempotência (T2):** submit duplicado retorna mesmo resultado, sem re-emitir signal."
					}
				},
				{
					"name": "POLL /enrolments (aguarda student_plan_id)",
					"event": [
						{
							"listen": "test",
							"script": {
								"type": "text/javascript",
								"exec": [
									"const json = pm.response.json();",
									"const e = (json.enrolments || []).find(x => x.id == pm.collectionVariables.get('enrolment_id'));",
									"if (e && e.student_plan && e.student_plan.id) {",
									"    pm.collectionVariables.set('student_plan_id', e.student_plan.id);",
									"    console.log('student_plan_id pronto:', e.student_plan.id);",
									"} else if (e && e.student_plan && e.student_plan.status === 'failed') {",
									"    console.warn('student_plan.status=failed:', e.student_plan.error_message);",
									"} else {",
									"    console.log('student_plan ainda creating — repetir request seguindo backoff.');",
									"}"
								]
							}
						}
					],
					"request": {
						"method": "GET",
						"url": {
							"raw": "{{base_url}}{{api_prefix}}/enrolments",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"{{api_prefix}}",
								"enrolments"
							]
						},
						"description": "**Polling P1:** repetir manualmente até `student_plan.id` aparecer, respeitando intervalo mínimo 2s + backoff exponencial até 30s, máx 60 tentativas.\n\nEm Newman, executar com retries via `--iteration-count` ou wrapper script. Em Postman GUI, basta clicar Send periodicamente.\n\n**Estados:** `creating` (continuar polling), `active` (sucesso, redirecionar Roteiro), `failed` (mostrar erro + retry)."
					}
				}
			]
		},
		{
			"name": "3. Dashboard & Notificações",
			"item": [
				{
					"name": "GET /dashboard",
					"request": {
						"method": "GET",
						"url": {
							"raw": "{{base_url}}{{api_prefix}}/dashboard",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"{{api_prefix}}",
								"dashboard"
							]
						},
						"description": "Resumo cross-product do Aluno. **Status atual:** retorna mock — F6.dashboard pendente."
					}
				},
				{
					"name": "GET /notifications",
					"request": {
						"method": "GET",
						"url": {
							"raw": "{{base_url}}{{api_prefix}}/notifications",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"{{api_prefix}}",
								"notifications"
							]
						},
						"description": "Notificações do sistema para o Aluno. **Status atual:** retorna mock — F6.notification pendente."
					}
				}
			]
		},
		{
			"name": "4. Roteiro de Estudos",
			"item": [
				{
					"name": "GET /study/{enrolment_id}",
					"event": [
						{
							"listen": "test",
							"script": {
								"type": "text/javascript",
								"exec": [
									"pm.test('200 OK', () => pm.response.to.have.status(200));",
									"const json = pm.response.json();",
									"const slot = (json.slots || json.weeks?.flatMap(w => w.slots) || []).find(s => s && s.status === 'not_started');",
									"if (slot) {",
									"    pm.collectionVariables.set('slot_id', slot.id);",
									"    console.log('slot_id:', slot.id);",
									"}"
								]
							}
						}
					],
					"request": {
						"method": "GET",
						"url": {
							"raw": "{{base_url}}{{api_prefix}}/study/{{enrolment_id}}",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"{{api_prefix}}",
								"study",
								"{{enrolment_id}}"
							]
						},
						"description": "Visão completa do Roteiro de Estudos para a matrícula."
					}
				},
				{
					"name": "GET /study/{enrolment_id}/performance",
					"request": {
						"method": "GET",
						"url": {
							"raw": "{{base_url}}{{api_prefix}}/study/{{enrolment_id}}/performance",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"{{api_prefix}}",
								"study",
								"{{enrolment_id}}",
								"performance"
							]
						},
						"description": "Métricas agregadas de desempenho do Aluno na matrícula — todas as dimensões em uma resposta (Motor de Consolidação, ADR-70). Contrato detalhado: [performance.md](../contratos/performance.md).\n\n**Auth:** `Authorization: Bearer {{wstoken}}` (ou `?wstoken={{wstoken}}`).\n\n## Response 200 (shape)\n\n```json\n{\n  \"enrolment_id\": 123,\n  \"overall\": { \"score\": 72.5, \"trend\": \"up\", \"trend_delta\": 3.1, \"total_activities\": 48, \"total_time_minutes\": 1260 },\n  \"by_discipline\": [ { \"discipline_id\": 100, \"name\": \"Direito Civil\", \"score\": 70.0, \"trend\": \"stable\", \"units_studied\": 8, \"units_total\": 8 } ],\n  \"by_module\": [ { \"module_id\": 1, \"module_name\": \"Módulo 1\", \"score\": 76.7, \"units_studied\": 12,\n                   \"by_discipline\": [ { \"discipline_id\": 100, \"name\": \"Direito Civil\", \"score\": 70.0 } ] } ],\n  \"by_exam_type\": [ { \"type\": \"exam_objective\", \"label\": \"Simulado Objetivo\", \"score\": 80.0, \"count\": 5 } ],\n  \"by_source\": [ { \"source\": \"legislation\", \"total\": 120, \"correct\": 90, \"score\": 75.0 },\n                 { \"source\": \"doctrine\", \"total\": 40, \"correct\": 28, \"score\": 70.0 },\n                 { \"source\": \"jurisprudence\", \"total\": 30, \"correct\": 18, \"score\": 60.0 } ],\n  \"flashcard_practice\": { \"sessions_total\": 12, \"cards_reviewed\": 340, \"cards_correct\": 270, \"cards_incorrect\": 70, \"accuracy\": 79.4, \"trend\": \"up\" },\n  \"progress\": { \"percentage\": 41.2, \"units_studied\": 33, \"units_total\": 80, \"units_exempted\": 4 },\n  \"weekly\": {\n    \"current\":  { \"week\": \"2026-22\", \"avg_score\": 74.0, \"avg_exam_time_min\": 38, \"units_completed\": 6, \"units_reviewed\": 2 },\n    \"previous\": { \"week\": \"2026-21\", \"avg_score\": 68.0, \"avg_exam_time_min\": 42, \"units_completed\": 4, \"units_reviewed\": 1 },\n    \"deltas\":   { \"avg_score\": 6.0, \"avg_exam_time_min\": -4, \"units_completed\": 2, \"units_reviewed\": 1 }\n  }\n}\n```\n\n## Dimensões\n\n- **overall** — Desempenho Geral: Média Aritmética Simples das NAs por Unidade. `score`, `trend`, `total_activities`, `total_time_minutes`.\n- **by_discipline[]** — média das NAs das Unidades estudadas por Disciplina.\n- **by_module[]** — Desempenho por Módulo (NA por execução; RG excluído); quebra por Disciplina em `by_discipline[]`. Ordenado por `module_id`.\n- **by_exam_type[]** — média de `nota_real` por tipo de Simulado (DI/SVD/objetivo/VF/escrito/RG).\n- **by_source[]** — Desempenho por Fonte: `legislation`/`doctrine`/`jurisprudence`. Conta toda Resposta elegível; acerto = `correct=1 & notsure=0`.\n- **flashcard_practice** — Estatísticas Gerais de Flashcards (acurácia acumulada).\n- **progress** — Progresso do Plano; `units_exempted` = Unidades Economizadas (Dispensa, total cumulativo).\n- **weekly** — semana calendário ISO (Seg–Dom), atual vs anterior + `deltas`: `avg_score` (nota_real das avaliações da semana), `avg_exam_time_min`, `units_completed`, `units_reviewed`.\n\n> `weekly.*.avg_score` usa `nota_real` (avaliações da semana) — distinto de `overall.score` (NA consolidada).\n> Unidades Economizadas não têm recorte semanal (Dispensa sem timestamp); total em `progress.units_exempted`.\n\n**Cache:** snapshot lazy + invalidação por `activity_completed` + frescor por semana ISO. 1º read pós-submit/virada-de-semana recomputa; demais = SELECT.\n\n**Erros:** `401 unauthorized`, `404 enrolment_not_found`."
					}
				},
				{
					"name": "GET /study/{enrolment_id}/results",
					"request": {
						"method": "GET",
						"url": {
							"raw": "{{base_url}}{{api_prefix}}/study/{{enrolment_id}}/results",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"{{api_prefix}}",
								"study",
								"{{enrolment_id}}",
								"results"
							]
						},
						"description": "Resultados detalhados do estudo (histórico). Ver `openapi.yaml` para schema completo."
					}
				},
				{
					"name": "GET /study/{enrolment_id}/progress",
					"request": {
						"method": "GET",
						"url": {
							"raw": "{{base_url}}{{api_prefix}}/study/{{enrolment_id}}/progress",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"{{api_prefix}}",
								"study",
								"{{enrolment_id}}",
								"progress"
							]
						},
						"description": "Progresso atual do Aluno no produto ativo."
					}
				},
				{
					"name": "GET /study/{enrolment_id}/disciplines",
					"request": {
						"method": "GET",
						"url": {
							"raw": "{{base_url}}{{api_prefix}}/study/{{enrolment_id}}/disciplines",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"{{api_prefix}}",
								"study",
								"{{enrolment_id}}",
								"disciplines"
							]
						},
						"description": "Disciplinas do fluxo atual agrupadas por status."
					}
				},
				{
					"name": "GET /study/{enrolment_id}/alerts",
					"request": {
						"method": "GET",
						"url": {
							"raw": "{{base_url}}{{api_prefix}}/study/{{enrolment_id}}/alerts",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"{{api_prefix}}",
								"study",
								"{{enrolment_id}}",
								"alerts"
							]
						},
						"description": "Alertas acionáveis do estudo (per-enrollment)."
					}
				},
				{
					"name": "GET /study/{enrolment_id}/retrospective",
					"request": {
						"method": "GET",
						"url": {
							"raw": "{{base_url}}{{api_prefix}}/study/{{enrolment_id}}/retrospective",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"{{api_prefix}}",
								"study",
								"{{enrolment_id}}",
								"retrospective"
							]
						},
						"description": "Dados agregados da retrospectiva do ciclo — só disponível quando o plano está `completed`."
					}
				},
				{
					"name": "POST /study/{enrolment_id}/retrospective/ack",
					"request": {
						"method": "POST",
						"url": {
							"raw": "{{base_url}}{{api_prefix}}/study/{{enrolment_id}}/retrospective/ack",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"{{api_prefix}}",
								"study",
								"{{enrolment_id}}",
								"retrospective",
								"ack"
							]
						},
						"description": "Marca o popup automático da retrospectiva como já exibido (idempotente)."
					}
				}
			]
		},
		{
			"name": "5. Slot Lifecycle",
			"item": [
				{
					"name": "GET /study/{enrolment_id}/slots/{slot_id}",
					"request": {
						"method": "GET",
						"url": {
							"raw": "{{base_url}}{{api_prefix}}/study/{{enrolment_id}}/slots/{{slot_id}}",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"{{api_prefix}}",
								"study",
								"{{enrolment_id}}",
								"slots",
								"{{slot_id}}"
							]
						},
						"description": "Detalhe do slot: configuração da atividade, sessão atual, recursos."
					}
				},
				{
					"name": "GET /study/{enrolment_id}/slots/{slot_id}/session",
					"request": {
						"method": "GET",
						"url": {
							"raw": "{{base_url}}{{api_prefix}}/study/{{enrolment_id}}/slots/{{slot_id}}/session",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"{{api_prefix}}",
								"study",
								"{{enrolment_id}}",
								"slots",
								"{{slot_id}}",
								"session"
							]
						},
						"description": "Estado da sessão de execução do Aluno: respostas, progresso, tempo. `data` traz payload inicial (questões selecionadas em DI/SVD)."
					}
				},
				{
					"name": "POST /study/{enrolment_id}/slots/{slot_id}/session (action)",
					"request": {
						"method": "POST",
						"header": [
							{
								"key": "Content-Type",
								"value": "application/json"
							}
						],
						"body": {
							"mode": "raw",
							"raw": "{\n  \"action\": \"start\",\n  \"data\": {}\n}"
						},
						"url": {
							"raw": "{{base_url}}{{api_prefix}}/study/{{enrolment_id}}/slots/{{slot_id}}/session",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"{{api_prefix}}",
								"study",
								"{{enrolment_id}}",
								"slots",
								"{{slot_id}}",
								"session"
							]
						},
						"description": "Ações operacionais na sessão: `action` ∈ `start | save | pause | resume`. Shape de `data` varia por slot.type e action.\n\n**Status atual:** apenas `action=start` implementado."
					}
				},
				{
					"name": "POST /study/{enrolment_id}/slots/{slot_id} (submit — diagnostic)",
					"request": {
						"method": "POST",
						"header": [
							{
								"key": "Content-Type",
								"value": "application/json"
							}
						],
						"body": {
							"mode": "raw",
							"raw": "{\n  \"action\": \"submit\",\n  \"data\": {\n    \"units\": [\n      {\n        \"unit_id\": 12,\n        \"responses\": [\n          {\"question_id\": 101, \"answer\": \"V\", \"not_sure\": false, \"timems\": 4200},\n          {\"question_id\": 102, \"answer\": \"F\", \"not_sure\": true, \"timems\": 8100}\n        ]\n      }\n    ]\n  }\n}"
						},
						"url": {
							"raw": "{{base_url}}{{api_prefix}}/study/{{enrolment_id}}/slots/{{slot_id}}",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"{{api_prefix}}",
								"study",
								"{{enrolment_id}}",
								"slots",
								"{{slot_id}}"
							]
						},
						"description": "Submissão final de `diagnostic_initial` / `diagnostic_verify`. Shape: `{ units: [{ unit_id, responses: [{question_id, answer: 'V'|'F', not_sure, timems}] }] }`."
					}
				},
				{
					"name": "POST /study/{enrolment_id}/slots/{slot_id} (submit — objective/truefalse/general_review)",
					"request": {
						"method": "POST",
						"header": [
							{
								"key": "Content-Type",
								"value": "application/json"
							}
						],
						"body": {
							"mode": "raw",
							"raw": "{\n  \"action\": \"submit\",\n  \"data\": {\n    \"responses\": [\n      {\"question_id\": 301, \"answer\": \"B\", \"not_sure\": false, \"timems\": 5400},\n      {\"question_id\": 302, \"answer\": \"A\", \"timems\": 3100}\n    ]\n  }\n}"
						},
						"url": {
							"raw": "{{base_url}}{{api_prefix}}/study/{{enrolment_id}}/slots/{{slot_id}}",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"{{api_prefix}}",
								"study",
								"{{enrolment_id}}",
								"slots",
								"{{slot_id}}"
							]
						},
						"description": "Submissão de `exam_objective`, `exam_truefalse` e `general_review`. Shape: `{ responses: [{question_id, answer, not_sure?, timems?}] }`. Para `general_review` aceita opcional `rg_number`."
					}
				},
				{
					"name": "POST /study/{enrolment_id}/slots/{slot_id} (submit — flashcard_practice)",
					"request": {
						"method": "POST",
						"header": [
							{
								"key": "Content-Type",
								"value": "application/json"
							}
						],
						"body": {
							"mode": "raw",
							"raw": "{\n  \"action\": \"submit\",\n  \"data\": {\n    \"responses\": [\n      {\"card_id\": 4201, \"knew\": true, \"timems\": 4500},\n      {\"card_id\": 4202, \"knew\": false, \"timems\": 7200}\n    ]\n  }\n}"
						},
						"url": {
							"raw": "{{base_url}}{{api_prefix}}/study/{{enrolment_id}}/slots/{{slot_id}}",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"{{api_prefix}}",
								"study",
								"{{enrolment_id}}",
								"slots",
								"{{slot_id}}"
							]
						},
						"description": "Submissão de `flashcard_practice` (per-Unit). Cada response: `{card_id (int), knew (bool), timems (int, opcional)}`.\n\n**Mapeamento server-side:**\n- `knew: true` → `answer = 'right'`, `correct = 1`\n- `knew: false` → `answer = 'wrong'`, `correct = 0`\n\nEnum canônico: `flashcard_answer_status` (`right` / `wrong`).\n\nAceito também `responses` top-level (sem `data` wrapper) e `time_ms` em vez de `timems` (legacy).\n\n**Response 200:**\n```json\n{\n  \"success\": true,\n  \"slot\": {\n    \"id\": \"<uuid>\",\n    \"status\": \"completed\",\n    \"result\": {\n      \"slot_id\": 0,\n      \"session_id\": 0,\n      \"result_id\": 0,\n      \"nota_real\": null,\n      \"signals_emitted\": [\"activity_completed\"],\n      \"extra\": {\"cards_total\": 0, \"cards_knew\": 0, \"cards_not_knew\": 0}\n    }\n  },\n  \"effects\": [\"activity_completed\"]\n}\n```"
					}
				},
				{
					"name": "POST /study/{enrolment_id}/slots/{slot_id} (submit — flashcard_practice_random)",
					"request": {
						"method": "POST",
						"header": [
							{
								"key": "Content-Type",
								"value": "application/json"
							}
						],
						"body": {
							"mode": "raw",
							"raw": "{\n  \"action\": \"submit\",\n  \"data\": {\n    \"responses\": [\n      {\"card_id\": 4201, \"unit_id\": 15, \"knew\": true, \"timems\": 4500},\n      {\"card_id\": 4305, \"unit_id\": 17, \"knew\": false, \"timems\": 6100}\n    ]\n  }\n}"
						},
						"url": {
							"raw": "{{base_url}}{{api_prefix}}/study/{{enrolment_id}}/slots/{{slot_id}}",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"{{api_prefix}}",
								"study",
								"{{enrolment_id}}",
								"slots",
								"{{slot_id}}"
							]
						},
						"description": "Submissão de `flashcard_practice_random` (cross-Unit — Sessão Aleatória do Módulo). Mesma shape do `flashcard_practice` mais `unit_id` (origem do card) em cada response.\n\n**Comportamento pós-submit:**\n1. Slot RANDOM vira `completed`.\n2. Para cada Unidade respondida onde `cards_answered >= cards_total`, o slot `flashcard_practice` per-Unit do mesmo Bloco também vira `completed` automaticamente.\n3. Unidades parcialmente respondidas ficam intactas — Aluno pode complementar via slot per-Unit individual.\n\nMapeamento server-side usa o mesmo enum `flashcard_answer_status` (`right` / `wrong`)."
					}
				},
				{
					"name": "POST /study/{enrolment_id}/slots/{slot_id} (submit — exam_written)",
					"request": {
						"method": "POST",
						"header": [
							{
								"key": "Content-Type",
								"value": "application/json"
							}
						],
						"body": {
							"mode": "raw",
							"raw": "{\n  \"action\": \"submit\",\n  \"data\": {\n    \"text\": \"Texto completo da redação do Aluno...\"\n  }\n}"
						},
						"url": {
							"raw": "{{base_url}}{{api_prefix}}/study/{{enrolment_id}}/slots/{{slot_id}}",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"{{api_prefix}}",
								"study",
								"{{enrolment_id}}",
								"slots",
								"{{slot_id}}"
							]
						},
						"description": "Submissão de `exam_written` (Simulado Escrito — redação). Após submit, slot transiciona para `pending_correction` (aguarda Tutor)."
					}
				},
				{
					"name": "POST /study/{enrolment_id}/slots/{slot_id} (submit — guided_study)",
					"request": {
						"method": "POST",
						"header": [
							{
								"key": "Content-Type",
								"value": "application/json"
							}
						],
						"body": {
							"mode": "raw",
							"raw": "{\n  \"action\": \"submit\",\n  \"data\": {\n    \"content_html\": \"<p>Resumo do Aluno em HTML...</p>\",\n    \"scenario\": \"resumo\",\n    \"source_origin\": \"student\",\n    \"unit_id\": 12\n  }\n}"
						},
						"url": {
							"raw": "{{base_url}}{{api_prefix}}/study/{{enrolment_id}}/slots/{{slot_id}}",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"{{api_prefix}}",
								"study",
								"{{enrolment_id}}",
								"slots",
								"{{slot_id}}"
							]
						},
						"description": "Submissão de `guided_study` (Estudo Dirigido). Persiste o resumo / artefato produzido pelo Aluno."
					}
				}
			]
		},
		{
			"name": "6. Atividades — Exam",
			"description": "Listagem de simulados com 4 variantes via query param `type`:\n- sem `type` → shape legado (3 buckets cross-tipo)\n- `?type=truefalse` → V/F particionado por DI/SVD com disciplines[]\n- `?type=objective` → Objetivos com level + disciplines[]\n- `?type=written` → Escritos com status do pipeline de correção\n\nEnvio de pendentes (Objetivo/Escrito) reusa endpoints da pasta `5. Atividades — Slot` via `POST /slots/{slot_id}`.\n\nContrato: docs/plataforma/api-integracoes/contratos/exam.md",
			"item": [
				{
					"name": "GET /study/{enrolment_id}/exams (legacy, sem type)",
					"request": {
						"method": "GET",
						"header": [
							{
								"key": "Authorization",
								"value": "Bearer {{wstoken}}"
							}
						],
						"url": {
							"raw": "{{base_url}}{{api_prefix}}/study/{{enrolment_id}}/exams",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"{{api_prefix}}",
								"study",
								"{{enrolment_id}}",
								"exams"
							]
						},
						"description": "Shape **legado**: 3 buckets cross-tipo (`available`, `pending_correction`, `corrected`). Mantido para retrocompat até frontend migrar para shape por tipo. Será deprecado (ver TODO-B no plano)."
					}
				},
				{
					"name": "GET /study/{enrolment_id}/exams?type=truefalse",
					"event": [
						{
							"listen": "test",
							"script": {
								"type": "text/javascript",
								"exec": [
									"pm.test('200 OK', () => pm.response.to.have.status(200));",
									"const json = pm.response.json();",
									"pm.test('type=truefalse', () => pm.expect(json.type).to.eql('truefalse'));",
									"pm.test('groups é array flat', () => pm.expect(json.groups).to.be.an('array'));",
									"if (json.groups.length > 0) {",
									"    const g = json.groups[0];",
									"    pm.test('group tem category', () => pm.expect(['diagnostic_initial','diagnostic_verify']).to.include(g.category));",
									"    pm.test('group tem module/module_id/module_ref', () => {",
									"        pm.expect(g.module).to.be.a('string');",
									"        pm.expect(g.module_id).to.be.a('number');",
									"        pm.expect(g.module_ref).to.be.a('string');",
									"    });",
									"    pm.test('group tem submitted_at + overall_score', () => {",
									"        pm.expect(g).to.have.property('submitted_at');",
									"        pm.expect(g.overall_score).to.be.a('number');",
									"    });",
									"    pm.test('items são disciplinas agregadas (sem slot_id)', () => {",
									"        pm.expect(g.items).to.be.an('array');",
									"        if (g.items.length > 0) {",
									"            pm.expect(g.items[0]).to.have.all.keys('discipline_id','name','correct','total','percentage');",
									"        }",
									"    });",
									"}",
									"const cats = json.groups.map(g => g.category);",
									"const lastDi = cats.lastIndexOf('diagnostic_initial');",
									"const firstSvd = cats.indexOf('diagnostic_verify');",
									"if (lastDi !== -1 && firstSvd !== -1) {",
									"    pm.test('ordem DI antes de SVD', () => pm.expect(lastDi).to.be.lessThan(firstSvd));",
									"}"
								]
							}
						}
					],
					"request": {
						"method": "GET",
						"header": [
							{
								"key": "Authorization",
								"value": "Bearer {{wstoken}}"
							}
						],
						"url": {
							"raw": "{{base_url}}{{api_prefix}}/study/{{enrolment_id}}/exams?type=truefalse",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"{{api_prefix}}",
								"study",
								"{{enrolment_id}}",
								"exams"
							],
							"query": [
								{
									"key": "type",
									"value": "truefalse",
									"description": "Particiona Simulados V/F em DI / SVD"
								}
							]
						},
						"description": "Simulados Verdadeiro/Falso COMPLETADOS.\n\n`groups[]` é **FLAT** — 1 group por combinação (category × módulo). DIs de módulos diferentes ocupam groups separados; idem para SVD. Ordem: todos `diagnostic_initial` primeiro, depois todos `diagnostic_verify`.\n\nCada group tem: `category`, `module`, `module_id`, `module_ref`, `submitted_at`, `overall_score`, `items[]`.\n\n**`items[]` agrega disciplines de TODOS slots daquela combinação** — não há `slot_id`. Cada item = 1 disciplina com `correct`, `total`, `percentage` somados cross-slots.\n\nSlots pendentes não entram nesta view — contagem em `/exams/pending-summary`."
					}
				},
				{
					"name": "GET /study/{enrolment_id}/exams?type=objective",
					"event": [
						{
							"listen": "test",
							"script": {
								"type": "text/javascript",
								"exec": [
									"pm.test('200 OK', () => pm.response.to.have.status(200));",
									"const json = pm.response.json();",
									"pm.test('type=objective', () => pm.expect(json.type).to.eql('objective'));",
									"pm.test('exams é array', () => pm.expect(json.exams).to.be.an('array'));",
									"pm.test('sem pending', () => pm.expect(json).to.not.have.property('pending'));",
									"if (json.exams.length > 0) {",
									"    pm.test('level em ['+'basico, intermediario, avancado'+']', () => pm.expect(['basico','intermediario','avancado']).to.include(json.exams[0].level));",
									"}"
								]
							}
						}
					],
					"request": {
						"method": "GET",
						"header": [
							{
								"key": "Authorization",
								"value": "Bearer {{wstoken}}"
							}
						],
						"url": {
							"raw": "{{base_url}}{{api_prefix}}/study/{{enrolment_id}}/exams?type=objective",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"{{api_prefix}}",
								"study",
								"{{enrolment_id}}",
								"exams"
							],
							"query": [
								{
									"key": "type",
									"value": "objective"
								}
							]
						},
						"description": "Simulados Objetivos COMPLETADOS. Cada item expõe `overall_score` + `level` (basico/intermediario/avancado via thresholds 50/80) + `disciplines[]`.\n\nResposta: `exams[]` (Objetivos completados com classificação). Slots pendentes não entram aqui — contagem em `/exams/pending-summary`."
					}
				},
				{
					"name": "GET /study/{enrolment_id}/exams?type=written",
					"event": [
						{
							"listen": "test",
							"script": {
								"type": "text/javascript",
								"exec": [
									"pm.test('200 OK', () => pm.response.to.have.status(200));",
									"const json = pm.response.json();",
									"pm.test('type=written', () => pm.expect(json.type).to.eql('written'));",
									"pm.test('exams é array', () => pm.expect(json.exams).to.be.an('array'));",
									"if (json.exams.length > 0) {",
									"    pm.test('status em [pending, in_correction, corrected]', () => pm.expect(['pending','in_correction','corrected']).to.include(json.exams[0].status));",
									"}"
								]
							}
						}
					],
					"request": {
						"method": "GET",
						"header": [
							{
								"key": "Authorization",
								"value": "Bearer {{wstoken}}"
							}
						],
						"url": {
							"raw": "{{base_url}}{{api_prefix}}/study/{{enrolment_id}}/exams?type=written",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"{{api_prefix}}",
								"study",
								"{{enrolment_id}}",
								"exams"
							],
							"query": [
								{
									"key": "type",
									"value": "written"
								}
							]
						},
						"description": "Simulados Escritos com `status` público do pipeline de correção.\n\nResposta por item: `slot_id`, `label`, `module`, `status`, `started_at`, `submitted_at`, `deadline`, `overall_score`.\n\n**Status enum:**\n- `pending` — aluno ainda não enviou (use `POST /slots/{slot_id}` multipart pra enviar)\n- `in_correction` — submetido, em pipeline (IA/Tutor)\n- `corrected` — devolutiva disponível em `GET /exams/{slot_id}`\n\nSem `disciplines[]` — correção é por critérios. `overall_score` só presente quando `corrected`.\n\n**Notas:**\n- `started_at`: ISO 8601 (fuso servidor) da session ativa do slot (quando Aluno abre a tela); `null` se ainda sem session.\n- `submitted_at`: ISO 8601 da `exam_submission`; `null` para `pending`.\n- `deadline`: prazo de envio. Cálculo placeholder: `slot.timecreated + 7 dias`. Fonte canônica (study_block/sequence config) ainda não definida — TODO.\n- Status `expired` (prazo esgotado) fora do V1 — ver TODO-A."
					}
				},
				{
					"name": "GET /study/{enrolment_id}/exams?type=foo (400 invalid_type)",
					"event": [
						{
							"listen": "test",
							"script": {
								"type": "text/javascript",
								"exec": [
									"pm.test('400 Bad Request', () => pm.response.to.have.status(400));",
									"pm.test('error=invalid_type', () => pm.expect(pm.response.json().error).to.eql('invalid_type'));"
								]
							}
						}
					],
					"request": {
						"method": "GET",
						"header": [
							{
								"key": "Authorization",
								"value": "Bearer {{wstoken}}"
							}
						],
						"url": {
							"raw": "{{base_url}}{{api_prefix}}/study/{{enrolment_id}}/exams?type=foo",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"{{api_prefix}}",
								"study",
								"{{enrolment_id}}",
								"exams"
							],
							"query": [
								{
									"key": "type",
									"value": "foo",
									"description": "Valor fora do enum {truefalse, objective, written}"
								}
							]
						},
						"description": "Verifica que `type` inválido retorna 400 com `{ \"error\": \"invalid_type\" }`. Valores aceitos: `truefalse`, `objective`, `written`."
					}
				},
				{
					"name": "GET /study/{enrolment_id}/exams/pending-summary (badges)",
					"event": [
						{
							"listen": "test",
							"script": {
								"type": "text/javascript",
								"exec": [
									"pm.test('200 OK', () => pm.response.to.have.status(200));",
									"const json = pm.response.json();",
									"pm.test('tem truefalse counter', () => pm.expect(json.truefalse).to.be.a('number'));",
									"pm.test('tem objective counter', () => pm.expect(json.objective).to.be.a('number'));",
									"pm.test('tem written counter', () => pm.expect(json.written).to.be.a('number'));",
									"pm.test('total = soma', () => pm.expect(json.total).to.eql(json.truefalse + json.objective + json.written));"
								]
							}
						}
					],
					"request": {
						"method": "GET",
						"header": [
							{
								"key": "Authorization",
								"value": "Bearer {{wstoken}}"
							}
						],
						"url": {
							"raw": "{{base_url}}{{api_prefix}}/study/{{enrolment_id}}/exams/pending-summary",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"{{api_prefix}}",
								"study",
								"{{enrolment_id}}",
								"exams",
								"pending-summary"
							]
						},
						"description": "Contagens de simulados pendentes por tipo para alimentar badges na UI. Endpoint leve — sem disciplines, sem labels, sem submitted_at.\n\nResposta:\n```json\n{\n  \"enrolment_id\": 123,\n  \"truefalse\": 2,\n  \"objective\": 1,\n  \"written\": 3,\n  \"total\": 6\n}\n```\n\nCritérios de 'pendente':\n- `truefalse`: DI/SVD com status `not_started`/`in_progress`/`skipped`\n- `objective`: Simulado Objetivo mesmos status\n- `written`: Simulado Escrito sem `exam_submission`"
					}
				},
				{
					"name": "GET /study/{enrolment_id}/exams/truefalse/review?module_id=&category=",
					"request": {
						"method": "GET",
						"header": [
							{
								"key": "Authorization",
								"value": "Bearer {{wstoken}}"
							}
						],
						"url": {
							"raw": "{{base_url}}{{api_prefix}}/study/{{enrolment_id}}/exams/truefalse/review?module_id=&category=diagnostic_initial",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"{{api_prefix}}",
								"study",
								"{{enrolment_id}}",
								"exams",
								"truefalse",
								"review"
							],
							"query": [
								{
									"key": "module_id",
									"value": "",
									"description": "ID do study_flow (Módulo). Obrigatório."
								},
								{
									"key": "category",
									"value": "diagnostic_initial",
									"description": "diagnostic_initial OR diagnostic_verify. Obrigatório."
								}
							]
						},
						"description": "Revisão dos slots V/F (DI ou SVD) de UM módulo, **particionados por Disciplina**. Cada item de `disciplines[]` carrega `discipline_id`, `name`, `correct`, `total`, `percentage`, `cda_level` (basico/intermediario/avancado via thresholds 50/80) e `slots[]` filtrados — apenas questões daquela disciplina.\n\nCada slot em `discipline.slots[]`: `slot_id`, `started_at`, `submitted_at`, `time_spent_seconds` (cronometragem cliente), `overall_score` (subset), `stats` (subset), `questions[]` com `statement_html`, alternativas V/F, `student_answer`, `correct_answer`, `is_correct`, `not_sure`, `comment_html`.\n\nResposta top-level: `enrolment_id`, `module_id`, `module`, `module_ref`, `category`, `label`, `overall_score`, `disciplines[]`.\n\nErrors: 400 invalid_params, 404 not_found."
					}
				},
				{
					"name": "GET /study/{enrolment_id}/exams/objective/review?module_id=",
					"request": {
						"method": "GET",
						"header": [
							{
								"key": "Authorization",
								"value": "Bearer {{wstoken}}"
							}
						],
						"url": {
							"raw": "{{base_url}}{{api_prefix}}/study/{{enrolment_id}}/exams/objective/review?module_id=",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"{{api_prefix}}",
								"study",
								"{{enrolment_id}}",
								"exams",
								"objective",
								"review"
							],
							"query": [
								{
									"key": "module_id",
									"value": "",
									"description": "ID do study_flow. Obrigatório."
								}
							]
						},
						"description": "Revisão dos Simulados Objetivos de UM módulo, **particionados por Disciplina**. Cada item de `disciplines[]`: `discipline_id`, `name`, `correct`, `total`, `percentage`, `cda_level` (50/80) e `slots[]` filtrados.\n\nCada slot em `discipline.slots[]`: `slot_id`, `label`, `started_at`, `submitted_at`, `time_spent_seconds` (cronometragem cliente), `overall_score` (subset), `stats` (subset), `questions[]` (múltipla escolha) com `statement_html`, `alternatives`, `student_answer`, `correct_answer`, `is_correct`, `not_sure`, `comment_html`.\n\nResposta top-level: `enrolment_id`, `module_id`, `module`, `module_ref`, `overall_score`, `disciplines[]`.\n\nErrors: 400 invalid_params, 404 not_found."
					}
				},
				{
					"name": "GET /study/{enrolment_id}/exams/objective/{slot_id}/review",
					"request": {
						"method": "GET",
						"header": [
							{
								"key": "Authorization",
								"value": "Bearer {{wstoken}}"
							}
						],
						"url": {
							"raw": "{{base_url}}{{api_prefix}}/study/{{enrolment_id}}/exams/objective/{{slot_id}}/review",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"{{api_prefix}}",
								"study",
								"{{enrolment_id}}",
								"exams",
								"objective",
								"{{slot_id}}",
								"review"
							]
						},
						"description": "Revisão de UM Simulado Objetivo (slot) — passa o `slot_id` (UUID) no path. Retorna o slot achatado no topo (sem wrapper `slots[]`), particionado por Disciplina:\n- `enrolment_id`, `slot_id`, `module_id`, `module`, `module_ref`, `label`, `started_at`, `submitted_at`, `time_spent_seconds`, `overall_score`\n- `disciplines[]` — cada uma com `discipline_id`, `name`, `correct`, `total`, `percentage`, `cda_level` (50/80) e `questions[]` (múltipla escolha) com `statement_html`, `alternatives`, `student_answer`, `correct_answer`, `is_correct`, `not_sure`, `comment_html`.\n\n`is_correct` vem do flag `response.correct` (submit), não da comparação answer-vs-gabarito.\n\nErrors: 404 not_found (slot inexistente, de outro plano, ou não-exam_objective)."
					}
				},
				{
					"name": "GET /study/{enrolment_id}/exams/written/review?module_id=",
					"request": {
						"method": "GET",
						"header": [
							{
								"key": "Authorization",
								"value": "Bearer {{wstoken}}"
							}
						],
						"url": {
							"raw": "{{base_url}}{{api_prefix}}/study/{{enrolment_id}}/exams/written/review?module_id=",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"{{api_prefix}}",
								"study",
								"{{enrolment_id}}",
								"exams",
								"written",
								"review"
							],
							"query": [
								{
									"key": "module_id",
									"value": "",
									"description": "ID do study_flow. Obrigatório."
								}
							]
						},
						"description": "Revisão dos Simulados Escritos de UM módulo. Cada slot expõe:\n- `slot_id`, `label`, `status`, `started_at`, `submitted_at`\n- `questions[]` — uma por Questão Escrita em scope: `question_id`, `unit_id`, `discipline_id`, `discipline_name`, `statement_html`, `format`, `expected_topics[]`, `max_lines`, `answer_key_html` (espelho/justificativa), `answer_images[]` (folhas do Aluno daquela Questão: `filename`, `mimetype`, `filesize`, `url` pluginfile), e `ai_correction`/`tutor_correction` (correção por Questão).\n- `ai_correction` / `tutor_correction` — `string|null`, por Questão (`questions[].*`). **Sempre `null` por enquanto** (pipeline de correção IA + Tutor não implementado).\n\nErrors: 400 invalid_params, 404 not_found."
					}
				},
				{
					"name": "GET /study/{enrolment_id}/exams/written/{slot_id}/review",
					"request": {
						"method": "GET",
						"header": [
							{
								"key": "Authorization",
								"value": "Bearer {{wstoken}}"
							}
						],
						"url": {
							"raw": "{{base_url}}{{api_prefix}}/study/{{enrolment_id}}/exams/written/{{slot_id}}/review",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"{{api_prefix}}",
								"study",
								"{{enrolment_id}}",
								"exams",
								"written",
								"{{slot_id}}",
								"review"
							]
						},
						"description": "Revisão de UM Simulado Escrito (slot) — passa o `slot_id` (UUID) no path. Retorna o objeto do slot achatado no topo (sem wrapper `slots[]`):\n- `enrolment_id`, `slot_id`, `module_id`, `module`, `module_ref`, `label`, `status`, `started_at`, `submitted_at`\n- `questions[]` — uma por Questão Escrita, com espelho (`statement_html`, `expected_topics[]`, `answer_key_html`, `max_lines`), `answer_images[]` (folhas do Aluno daquela Questão, URLs pluginfile) e `ai_correction`/`tutor_correction` (correção por Questão).\n- `ai_correction` / `tutor_correction` — `string|null`, por Questão (`questions[].*`), **null** (pipeline de correção não implementado).\n\nErrors: 404 not_found (slot inexistente, de outro plano, ou não-exam_written)."
					}
				},
				{
					"name": "GET /study/{enrolment_id}/exams/{slot_id}",
					"request": {
						"method": "GET",
						"header": [
							{
								"key": "Authorization",
								"value": "Bearer {{wstoken}}"
							}
						],
						"url": {
							"raw": "{{base_url}}{{api_prefix}}/study/{{enrolment_id}}/exams/{{slot_id}}",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"{{api_prefix}}",
								"study",
								"{{enrolment_id}}",
								"exams",
								"{{slot_id}}"
							]
						},
						"description": "Detalhe do simulado.\n\n**Questionários** (DI/SVD/Objetivo/V/F): bloco `review` com questões + gabarito + respostas + stats.\n**Simulado Escrito**: bloco `feedback` com `feedback_html` + critérios + totais (ou `null` se ainda em correção).\n\nNão muda com o novo `?type=` — endpoint único."
					}
				}
			]
		},
		{
			"name": "7. Atividades — Flashcard / Notebook",
			"item": [
				{
					"name": "GET /study/{enrolment_id}/flashcards",
					"request": {
						"method": "GET",
						"header": [
							{
								"key": "Authorization",
								"value": "Bearer {{wstoken}}"
							}
						],
						"url": {
							"raw": "{{base_url}}{{api_prefix}}/study/{{enrolment_id}}/flashcards",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"{{api_prefix}}",
								"study",
								"{{enrolment_id}}",
								"flashcards"
							]
						},
						"description": "Flashcards disponíveis cross-block agrupados por Disciplina → Unidade, com **Estatísticas Gerais de Flashcards** (global), **Estatísticas de Flashcards por Disciplina** e **Estatísticas de Flashcards por Unidade**.\n\nTermos DDD (`terms-metrics.yaml`): `flashcard_genstats`, `flashcard_discstats`, `flashcard_unitstats`.\n\n**Invariantes:**\n- `cards_reviewed == cards_correct + cards_incorrect` em todos os níveis.\n- `accuracy == round(cards_correct / cards_reviewed * 100)`.\n- Soma das unidades = stats da disciplina; soma das disciplinas = globais.\n\n**Response shape:**\n\n```json\n{\n  \"enrolment_id\": 0,\n  \"total_cards\": 0,\n  \"total_sessions\": 0,\n  \"total_reviewed\": 0,\n  \"total_correct\": 0,\n  \"total_incorrect\": 0,\n  \"overall_accuracy\": 0,\n  \"disciplines\": [\n    {\n      \"discipline_id\": 0,\n      \"name\": \"\",\n      \"cards_available\": 0,\n      \"cards_reviewed\": 0,\n      \"cards_correct\": 0,\n      \"cards_incorrect\": 0,\n      \"accuracy\": 0,\n      \"last_session_at\": null,\n      \"action\": { \"kind\": \"open_flashcards\", \"label\": \"Praticar\", \"params\": { \"discipline_id\": \"0\" } },\n      \"units\": [\n        {\n          \"unit_id\": 0,\n          \"shortname\": \"\",\n          \"name\": \"\",\n          \"cards_available\": 0,\n          \"cards_reviewed\": 0,\n          \"cards_correct\": 0,\n          \"cards_incorrect\": 0,\n          \"accuracy\": 0,\n          \"last_session_at\": null,\n          \"incidence\": \"INCIDENCIA_ALTA\",\n          \"importance\": \"RELEVANCIA_MEDIA\",\n          \"action\": { \"kind\": \"open_flashcards\", \"label\": \"Praticar\", \"params\": { \"unit_id\": \"0\" } }\n        }\n      ]\n    }\n  ]\n}\n```\n\n**Critério de Unidade:** `incidence` e `importance` vêm da Etapa 5 (Configuração das Unidades) da Trilha Pedagógica e são propagados ao Plano do Aluno via `sequence.unit_config[]`. Retornados no padrão cru persistido (`INCIDENCIA_BAIXA|MEDIA|ALTA`, `RELEVANCIA_BAIXA|MEDIA|ALTA`); string vazia quando a Unidade não tem critério configurado.\n\n**Ver também:**\n- `GET /study/{enrolment_id}/flashcards/disciplines/{discipline_id}` — cards de uma Disciplina (prática livre).\n- `GET /study/{enrolment_id}/flashcards/units/{unit_id}` — cards de uma Unidade.\n- `docs/operacao/uc-010-flashcards.md`"
					}
				},
				{
					"name": "GET /study/{enrolment_id}/flashcards/disciplines/{discipline_id}",
					"request": {
						"method": "GET",
						"header": [
							{
								"key": "Authorization",
								"value": "Bearer {{wstoken}}"
							}
						],
						"url": {
							"raw": "{{base_url}}{{api_prefix}}/study/{{enrolment_id}}/flashcards/disciplines/{{discipline_id}}",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"{{api_prefix}}",
								"study",
								"{{enrolment_id}}",
								"flashcards",
								"disciplines",
								"{{discipline_id}}"
							]
						},
						"description": "Cards da Disciplina (prática livre cross-Unit). Retorna lista de Flashcards agrupados por Unidade da Disciplina + estatísticas (`flashcard_discstats`).\n\n`discipline_id` = `idnumber` da Disciplina (ex.: `DIREITO_CIVIL_REAIS_V1`)."
					}
				},
				{
					"name": "GET /study/{enrolment_id}/flashcards/units/{unit_id}",
					"request": {
						"method": "GET",
						"header": [
							{
								"key": "Authorization",
								"value": "Bearer {{wstoken}}"
							}
						],
						"url": {
							"raw": "{{base_url}}{{api_prefix}}/study/{{enrolment_id}}/flashcards/units/{{unit_id}}",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"{{api_prefix}}",
								"study",
								"{{enrolment_id}}",
								"flashcards",
								"units",
								"{{unit_id}}"
							]
						},
						"description": "Cards de uma Unidade específica. Retorna Flashcards + estatísticas (`flashcard_unitstats`).\n\n`unit_id` = `helico_unit.id` (mesma referência usada em `unit_snapshot.source_unit_id`)."
					}
				},
				{
					"name": "POST /study/{enrolment_id}/flashcard/random/session",
					"request": {
						"method": "POST",
						"header": [
							{
								"key": "Content-Type",
								"value": "application/json"
							}
						],
						"body": {
							"mode": "raw",
							"raw": ""
						},
						"url": {
							"raw": "{{base_url}}{{api_prefix}}/study/{{enrolment_id}}/flashcard/random/session",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"{{api_prefix}}",
								"study",
								"{{enrolment_id}}",
								"flashcard",
								"random",
								"session"
							]
						},
						"description": "Inicia Sessão Aleatória de Flashcards (Revisão do Módulo cross-Unit). Resolve o slot `flashcard_practice_random` do Bloco `module_review` atual, embaralha cards cross-Unit em `session.data` e cria a session via `session_service::start`.\n\n**Sem body** — só POST + `enrolment_id` na URL.\n\n**Response 200:**\n```json\n{\n  \"success\": true,\n  \"session\": {\n    \"id\": 9559,\n    \"slot_id\": \"<uuid-do-slot-random>\",\n    \"status\": \"in_progress\",\n    \"started_at\": 1779211748,\n    \"last_resumed_at\": null,\n    \"paused_at\": null,\n    \"time_spent_seconds\": 0,\n    \"data\": {\n      \"cards\": [\n        {\"card_id\": 4201, \"unit_id\": 15}\n      ]\n    }\n  }\n}\n```\n\n**Erros:**\n- 404 `student_plan_not_found` / `no_current_flow` / `no_current_block` / `random_slot_not_found`\n- 422 `block_not_module_review` (Aluno não está no Bloco de Revisão do Módulo)\n\nSubmit posterior em `POST /study/{enrolment_id}/slots/{slot_id}` com `slot_id` = uuid retornado em `session.slot_id`."
					}
				},
				{
					"name": "GET /study/{enrolment_id}/notebook",
					"request": {
						"method": "GET",
						"url": {
							"raw": "{{base_url}}{{api_prefix}}/study/{{enrolment_id}}/notebook",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"{{api_prefix}}",
								"study",
								"{{enrolment_id}}",
								"notebook"
							]
						},
						"description": "Caderno Online — artefatos produtivos do Aluno."
					}
				},
				{
					"name": "GET /study/{enrolment_id}/notebook/{artifact_id}",
					"request": {
						"method": "GET",
						"url": {
							"raw": "{{base_url}}{{api_prefix}}/study/{{enrolment_id}}/notebook/{{artifact_id}}",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"{{api_prefix}}",
								"study",
								"{{enrolment_id}}",
								"notebook",
								"{{artifact_id}}"
							]
						},
						"description": "Conteúdo completo de um artefato do Caderno Online. `type` ∈ `resumo | leitura | reforco | hibrido`."
					}
				},
				{
					"name": "GET /study/{enrolment_id}/notebook/disciplines",
					"request": {
						"method": "GET",
						"url": {
							"raw": "{{base_url}}{{api_prefix}}/study/{{enrolment_id}}/notebook/disciplines",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"{{api_prefix}}",
								"study",
								"{{enrolment_id}}",
								"notebook",
								"disciplines"
							]
						},
						"description": "Index leve do Caderno por Disciplina. Lista Disciplinas dos Módulos já atravessados pelo Aluno com units_count e artifacts_count (visibility_scope=notebook).\n\n**Response 200:**\n```json\n{\n  \"current_module_ordinal\": 3,\n  \"disciplines\": [\n    {\n      \"id\": 5,\n      \"name\": \"Direito Constitucional\",\n      \"units_count\": 8,\n      \"artifacts_count\": 7\n    }\n  ]\n}\n```\n\n**Erros:** 401 unauthorized, 404 enrolment_not_found."
					}
				},
				{
					"name": "GET /study/{enrolment_id}/notebook/disciplines/{discipline_id}/units",
					"request": {
						"method": "GET",
						"url": {
							"raw": "{{base_url}}{{api_prefix}}/study/{{enrolment_id}}/notebook/disciplines/{{discipline_id}}/units",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"{{api_prefix}}",
								"study",
								"{{enrolment_id}}",
								"notebook",
								"disciplines",
								"{{discipline_id}}",
								"units"
							]
						},
						"description": "Primeira Unidade detalhada (shape completo do drill) + sumário das demais. Ordem definida pelo student_plan.sequence.\n\n**Response 200:**\n```json\n{\n  \"discipline\": { \"id\": 5, \"name\": \"Direito Constitucional\" },\n  \"first_unit\": {},\n  \"other_units\": [\n    {\n      \"id\": 13,\n      \"name\": \"Princípios fundamentais II\",\n      \"order\": 2,\n      \"module_ordinal\": 2,\n      \"level\": \"intermediate\",\n      \"score\": 6.5,\n      \"source\": \"svd\",\n      \"has_artifacts\": true\n    }\n  ]\n}\n```\n\nfirst_unit pode ser null quando o Aluno ainda não atravessou Unidades dessa Disciplina. other_units[].level é basic|intermediate|advanced ou null sem classificação.\n\n**Erros:** 401 unauthorized, 404 enrolment_not_found, 404 discipline_not_in_enrolment."
					}
				},
				{
					"name": "GET /study/{enrolment_id}/notebook/disciplines/{discipline_id}/units/{unit_id}",
					"request": {
						"method": "GET",
						"url": {
							"raw": "{{base_url}}{{api_prefix}}/study/{{enrolment_id}}/notebook/disciplines/{{discipline_id}}/units/{{unit_id}}",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"{{api_prefix}}",
								"study",
								"{{enrolment_id}}",
								"notebook",
								"disciplines",
								"{{discipline_id}}",
								"units",
								"{{unit_id}}"
							]
						},
						"description": "Drill completo da Unidade: classification CDA, performance por simulado (reusa general_review_performance_view_service), tópicos com has_artifact/has_observation (annotations via ADR-91 lexical_mark_walker), e summary de Flashcards.\n\n**Response 200:**\n```json\n{\n  \"discipline\": { \"id\": 5, \"name\": \"Direito Constitucional\" },\n  \"unit\": { \"id\": 12, \"name\": \"Princípios fundamentais\", \"order\": 1, \"module_ordinal\": 1 },\n  \"classification\": {\n    \"level\": \"advanced\",\n    \"score\": 8.7,\n    \"source\": \"svd\",\n    \"classified_at\": null\n  },\n  \"performance\": {\n    \"unit_score\": { \"latest_truefalse\": 8.0, \"latest_objective\": 7.5, \"latest_written\": 7.0 },\n    \"exam_truefalse\": [],\n    \"exam_objective\": [],\n    \"exam_written\": []\n  },\n  \"topics\": {\n    \"total\": 8,\n    \"with_artifact\": 3,\n    \"with_observation\": 2,\n    \"items\": [\n      {\n        \"id\": 101,\n        \"title\": \"Hierarquia das normas\",\n        \"order\": 1,\n        \"has_artifact\": true,\n        \"artifact_id\": 555,\n        \"artifact_type\": \"resumo\",\n        \"has_observation\": true,\n        \"preview\": \"Normas constitucionais ocupam o topo...\"\n      }\n    ]\n  },\n  \"flashcards\": {\n    \"total\": 24,\n    \"reviewed\": 18,\n    \"last_accuracy\": 75.0,\n    \"last_practiced_at\": 1779000000\n  }\n}\n```\n\nclassification é null quando ainda não há classificação. flashcards.last_accuracy e last_practiced_at são null quando a Unidade nunca foi praticada.\n\n**Erros:** 401 unauthorized, 404 enrolment_not_found, 404 discipline_not_in_enrolment, 404 unit_not_in_enrolment."
					}
				},
				{
					"name": "POST /study/{enrolment_id}/notebook/disciplines/{discipline_id}/units/{unit_id}/topics/{topic_id} (autosave full)",
					"request": {
						"method": "POST",
						"header": [
							{
								"key": "Content-Type",
								"value": "application/json"
							}
						],
						"body": {
							"mode": "raw",
							"raw": "{\n  \"action\": \"autosave\",\n  \"data\": {\n    \"editor_state\": { \"root\": { \"type\": \"root\", \"children\": [] } },\n    \"annotations\": [\n      { \"id\": \"obs_10944568\", \"mark_id\": \"obs_10944568\", \"note\": \"DSD\", \"x_pct\": 10.25, \"y_pct\": 17.87 }\n    ],\n    \"content_html\": \"<p>...</p>\",\n    \"scenario\": \"resumo\"\n  }\n}",
							"options": {
								"raw": {
									"language": "json"
								}
							}
						},
						"url": {
							"raw": "{{base_url}}{{api_prefix}}/study/{{enrolment_id}}/notebook/disciplines/{{discipline_id}}/units/{{unit_id}}/topics/{{topic_id}}",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"{{api_prefix}}",
								"study",
								"{{enrolment_id}}",
								"notebook",
								"disciplines",
								"{{discipline_id}}",
								"units",
								"{{unit_id}}",
								"topics",
								"{{topic_id}}"
							]
						},
						"description": "Autosave do artefato do Caderno Online (full). Cria o artifact quando o Tópico ainda não tem um (escopo notebook, status draft, source_type=scenario) ou atualiza preservando identidade/escopo. annotations[] aceita o shape de observação posicionada (id/mark_id como key, note, x_pct/y_pct).\n\n**Response 200:** draft consolidado (artifact_id, version, status, editor_state, content_html, annotations[], annotation_count, last_saved_at).\n\n**Erros:** 401 unauthorized, 404 enrolment_not_found, 422 invalid_editor_state, 422 invalid_payload."
					}
				},
				{
					"name": "POST /study/{enrolment_id}/notebook/disciplines/{discipline_id}/units/{unit_id}/topics/{topic_id} (autosave patch incremental)",
					"request": {
						"method": "POST",
						"header": [
							{
								"key": "Content-Type",
								"value": "application/json-patch+json"
							}
						],
						"body": {
							"mode": "raw",
							"raw": "{\n  \"action\": \"autosave\",\n  \"data\": {\n    \"base_version\": 3,\n    \"patch_editor_state\": [\n      { \"op\": \"add\", \"path\": \"/root/children/-\", \"value\": { \"type\": \"mark\", \"ids\": [\"obs_1\"], \"children\": [{ \"type\": \"text\", \"text\": \"novo\" }] } }\n    ],\n    \"annotations_delta\": {\n      \"upsert\": [ { \"id\": \"obs_1\", \"mark_id\": \"obs_1\", \"note\": \"x\", \"x_pct\": 5, \"y_pct\": 9 } ],\n      \"remove\": []\n    }\n  }\n}",
							"options": {
								"raw": {
									"language": "json"
								}
							}
						},
						"url": {
							"raw": "{{base_url}}{{api_prefix}}/study/{{enrolment_id}}/notebook/disciplines/{{discipline_id}}/units/{{unit_id}}/topics/{{topic_id}}",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"{{api_prefix}}",
								"study",
								"{{enrolment_id}}",
								"notebook",
								"disciplines",
								"{{discipline_id}}",
								"units",
								"{{unit_id}}",
								"topics",
								"{{topic_id}}"
							]
						},
						"description": "Autosave incremental (Content-Type application/json-patch+json): patch_editor_state (JSON Patch) + annotations_delta + base_version, com optimistic concurrency. Exige artifact existente — a criação inicial é via full save.\n\n**Erros:** 409 version_conflict (carrega current_version), 409 invalid_patch (sem artifact), 422 invalid_editor_state, 401 unauthorized, 404 enrolment_not_found."
					}
				}
			]
		},
		{
			"name": "8. Admin — Correção de Simulado Escrito",
			"description": "Endpoints de Tutor para correção da fila de Simulados Escritos.",
			"item": [
				{
					"name": "GET /admin/corrections/pending",
					"event": [
						{
							"listen": "test",
							"script": {
								"type": "text/javascript",
								"exec": [
									"const json = pm.response.json();",
									"if (json.submissions && json.submissions.length) {",
									"    pm.collectionVariables.set('submission_id', json.submissions[0].id);",
									"    console.log('submission_id:', json.submissions[0].id);",
									"}"
								]
							}
						}
					],
					"request": {
						"method": "GET",
						"url": {
							"raw": "{{base_url}}{{api_prefix}}/admin/corrections/pending?limit=50",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"{{api_prefix}}",
								"admin",
								"corrections",
								"pending"
							],
							"query": [
								{
									"key": "limit",
									"value": "50"
								}
							]
						},
						"description": "Fila de submissions textuais aguardando correção."
					}
				},
				{
					"name": "POST /admin/corrections/{submission_id}/claim",
					"request": {
						"method": "POST",
						"url": {
							"raw": "{{base_url}}{{api_prefix}}/admin/corrections/{{submission_id}}/claim",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"{{api_prefix}}",
								"admin",
								"corrections",
								"{{submission_id}}",
								"claim"
							]
						},
						"description": "Tutor reivindica a correção (status → in_review)."
					}
				},
				{
					"name": "GET /admin/corrections/{submission_id}",
					"request": {
						"method": "GET",
						"url": {
							"raw": "{{base_url}}{{api_prefix}}/admin/corrections/{{submission_id}}",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"{{api_prefix}}",
								"admin",
								"corrections",
								"{{submission_id}}"
							]
						},
						"description": "Detalhe da submission incluindo `submitted_text` e estado de correção."
					}
				},
				{
					"name": "POST /admin/corrections/{submission_id} (submeter correção)",
					"request": {
						"method": "POST",
						"header": [
							{
								"key": "Content-Type",
								"value": "application/json"
							}
						],
						"body": {
							"mode": "raw",
							"raw": "{\n  \"feedback_html\": \"<p>Excelente argumentação...</p>\",\n  \"criteria\": [\n    { \"criterion_name\": \"Clareza\", \"score\": 8.5, \"max\": 10, \"weight\": 0.3, \"comment\": \"\" },\n    { \"criterion_name\": \"Argumentação jurídica\", \"score\": 7.0, \"max\": 10, \"weight\": 0.5, \"comment\": \"\" },\n    { \"criterion_name\": \"Coesão\", \"score\": 9.0, \"max\": 10, \"weight\": 0.2, \"comment\": \"\" }\n  ]\n}"
						},
						"url": {
							"raw": "{{base_url}}{{api_prefix}}/admin/corrections/{{submission_id}}",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"{{api_prefix}}",
								"admin",
								"corrections",
								"{{submission_id}}"
							]
						},
						"description": "Persiste a correção. Backend dispara listener que gera `activity_result` retroativo."
					}
				}
			]
		},
		{
			"name": "9. HÉLICO Teach — Áudio / TTS",
			"item": [
				{
					"name": "POST Audio Transcription (TTS)",
					"request": {
						"auth": {
							"type": "noauth"
						},
						"method": "POST",
						"header": [
							{
								"key": "x-api-key",
								"value": "Bearer sk-prod-...",
								"type": "text"
							},
							{
								"key": "x-api-key",
								"value": "{{your_secret_token}}",
								"type": "text"
							},
							{
								"key": "x-tenant-id",
								"value": "tenant-law-school",
								"type": "text"
							},
							{
								"key": "Content-Type",
								"value": "application/json",
								"type": "text"
							}
						],
						"body": {
							"mode": "raw",
							"raw": "{\n  \"key\": \"flash-card-42\",\n  \"text\": \"O controle de constitucionalidade brasileiro admite formas concentrada e difusa.\",\n  \"language\": \"pt-BR\",\n  \"voice\": \"Kore\",\n  \"model\": \"gemini-2.5-flash-preview-tts\",\n  \"ttlSeconds\": 86400\n}",
							"options": {
								"raw": {
									"language": "json"
								}
							}
						},
						"url": {
							"raw": "https://helico-teach.dev.evtit.com/v1/external/law-school/audio-transcription",
							"protocol": "https",
							"host": [
								"helico-teach",
								"dev",
								"evtit",
								"com"
							],
							"path": [
								"v1",
								"external",
								"law-school",
								"audio-transcription"
							]
						},
						"description": "Gera transcrição/áudio (TTS) via serviço HÉLICO Teach.\n\nServiço externo (não a Platform API Moodle): auth por `x-api-key`, não Bearer wstoken.\nO segundo `x-api-key` usa a variável `{{your_secret_token}}`.\n\nDoc: https://helico-teach.dev.evtit.com/v1/docs#tag/helico/POST/v1/external/law-school/audio-transcription"
					},
					"response": []
				}
			]
		}
	]
}