dashboard-reports

O endpoint do Dashboard de admin (`GET /lms/dashboard`) e o endpoint de Reports (`GET /lms/reports`) são ambos visões únicas, fortemente agregadas e somente leitura, em vez de coleções de recursos CRUD granulares. O dashboard retorna KPIs do estado atual (alunos/cursos/turmas ativos, certificados emitidos, taxas de conclusão/aprovação, cada um com variações mês a mês), quatro gráficos (crescimento de alunos, engajamento semanal, principais cursos por acesso, distribuição por categoria), um calendário de ±14/+30 dias de sessões de turma e feeds de matrículas recentes/próximas turmas — tudo o que um admin precisa no primeiro login sem navegação adicional. O Reports recebe um parâmetro de query `period` (7d, 30d, 6m ou 12m) e retorna as métricas equivalentes comparadas com o período anterior de mesma duração: tendência de matrículas, rankings por curso e por categoria, um detalhamento de status dos alunos, um radar de qualidade de seis eixos (engajamento, conclusão, satisfação, recomendação, retenção, desempenho) e séries de atividade/evolução de notas semanais. Ambos leem o header `Accept-Language` para localizar os rótulos (normalizado para `pt-BR` ou `en-US`), em vez de receber um parâmetro de query `locale`.

Realtime é uma preocupação separada e muito menor: um ring buffer em memória (últimos 500 eventos) que respalda um endpoint de polling por cursor (`GET /realtime/cursor`, para que um cliente possa verificar de forma barata "algo mudou desde a última vez que olhei") e um verdadeiro canal de push (`GET /realtime/activity/stream`, Server-Sent Events) que filtra o barramento especificamente para eventos `lesson_view`, com um ping de heartbeat de 25 segundos para manter a conexão viva através de proxies. De forma incomum para esta base de código, nenhum dos endpoints de realtime carrega um decorator explícito `@Role()`/`@NoRole()` no código-fonte; o endpoint de cursor, ainda assim, é semeado com roles (`admin`, `admin-lms`, `lms-enterprise-admin`, `lms-instructor`, `lms-student`) no sistema de permissões, enquanto o endpoint de stream SSE não tem nenhuma entrada de permissão de rota.

Uma funcionalidade de "Video Resolution Profiles" (presets de codificação FFmpeg) residia anteriormente nesta área, mas seu controller, serviço, ferramentas MCP e UI de admin foram totalmente removidos em um commit posterior que substituiu a conversão de vídeo por perfil de resolução fixa por streaming HLS adaptativo (agora parte dos submódulos Courses e Platforma). Ela é intencionalmente omitida desta documentação, já que o código de apoio não existe mais — quaisquer referências a `/lms/video-resolution-profiles` em outros lugares (docs antigas, permissões de rota/MCP obsoletas semeadas por migration) estão órfãs.