UC-010: Flashcards (Browse por Disciplina)
Status: EM REVISÃO Data: 2026-04-29 Domínio: platform / activity.formative Ator: Aluno Terms: Prática com Flashcards, Flashcards Acumulados, Desempenho da Prática com Flashcards, Sessão de Flashcards
Contexto
Visão de browse dos flashcards disponíveis por disciplina. Permite ao Aluno visualizar estatísticas de prática e iniciar sessões avulsas de revisão. Diferente dos slots flashcard_practice no Roteiro de Estudos — esta visão é cross-blocos e voltada para prática livre.
Endpoint
GET /platform/study/{enrolment_id}/flashcards
Authorization: Bearer {wstoken}Controller: flashcard_api_controller.php
Resposta
{
"total_cards": 240,
"total_sessions": 12,
"overall_accuracy": 73,
"disciplines": [
{
"discipline_id": 5,
"name": "Direito Constitucional",
"cards_available": 80,
"cards_reviewed": 60,
"accuracy": 75,
"last_session_at": "2026-04-28T15:00:00Z",
"action": {
"type": "navigate_with_context",
"label": "Praticar",
"route": "/flashcards/praticar",
"params": { "discipline_id": 5 }
}
},
{
"discipline_id": 8,
"name": "Direito Penal",
"cards_available": 45,
"cards_reviewed": 20,
"accuracy": 68,
"last_session_at": "2026-04-27T10:00:00Z",
"action": {
"type": "navigate_with_context",
"label": "Praticar",
"route": "/flashcards/praticar",
"params": { "discipline_id": 8 }
}
}
]
}Mapeamento de terms
| Term | Campo | Nota |
|---|---|---|
| Flashcards Acumulados | total_cards |
Total de cards disponíveis cross-blocos |
| Desempenho da Prática com Flashcards | overall_accuracy |
Consolidado de todas as sessões |
| Sessão de Flashcards | total_sessions |
Quantidade de sessões realizadas |
Erros esperados
| HTTP | Código | Situação |
|---|---|---|
| 401 | unauthorized |
Token inválido ou expirado |
| 404 | enrolment_not_found |
Matrícula não encontrada |
Decisões
- D-01: Agrupamento por disciplina no Backend (§16)
- D-02: Execução de sessão avulsa = decisão deferida para implementação (pode criar slot dinâmico ou reutilizar mecanismo existente)
- D-03:
cards_availableinclui todos os cards de unidades já estudadas (não apenas do bloco atual)