Skip to content

UC-010: Flashcards (Browse por Disciplina)

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_available inclui todos os cards de unidades já estudadas (não apenas do bloco atual)
Navigation

Type to search…

↑↓ navigate↵ selectEsc close