platforma

A Platforma (a palavra portuguesa para "plataforma" — note que a classe do controller é literalmente `PlataformaController`, enquanto cada arquivo, serviço e o prefixo de rota `/lms/platforma` usam a grafia em inglês, uma inconsistência de nomenclatura pré-existente na base de código) é estruturalmente única entre os submódulos do LMS: ela não tem um `*.module.ts` dedicado. O `PlataformaController` e todos os seus cinco serviços de apoio (`PlatformaService`, `PlatformaVideoService`, `PlatformaHeartbeatService`, `PlatformaPerformanceService`, `PlatformaSearchService`) mais dois handlers de fila/evento são registrados diretamente no `LmsModule` raiz, em vez de cada submódulo ter seu próprio arquivo de módulo, como em todo o resto desta library.

O controller é decorado com `@NoRole()` em vez de `@Role()` — qualquer usuário autenticado pode chamá-lo, sem exigir uma role específica de plataforma — exceto por um grupo de rotas de streaming (`/video/:token`, `/hls/:token/...`, `/subtitles/:token/captions.vtt`) que são `@Public()`: o modelo de segurança para a entrega de vídeo é o próprio token assinado e com tempo limitado, e não uma verificação de sessão, já que um player de vídeo ou uma tag `<video>` não pode anexar um header Authorization a uma requisição de manifesto/segmento. Os tokens são cunhados pelos endpoints `@NoRole()` (`video-token`, `hls-token`, `subtitles-token`) e então entregues aos endpoints públicos de streaming.

Além do vídeo, a Platforma agrega vários outros submódulos por trás de uma superfície amigável ao aluno: notificações (listar/contagem de não lidas/marcar como lida/excluir, mais um endpoint SSE `GET /notifications/stream` para push ao vivo), a sequência de aprendizado e o registro de suas atividades, a submissão de avaliação de aula (delegando a `EvaluationService.getCourseLessonTopics`/`getMyLessonRatings`/`submitLessonRatings`, que não são de outra forma expostos pelo próprio controller do submódulo Evaluations), uma visão self-service da carteira BitCode e um endpoint de transação, uma busca entre entidades por cursos/trilhas/exames/turmas/instrutores, e um endpoint de heartbeat de tempo assistido que enfileira jobs assíncronos (ip/user-agent/posição/sessão) consumidos pelo `LessonHeartbeatHandler` para alimentar analytics de engajamento e o dashboard de desempenho. Dois endpoints (submissão de avaliação de aula e registro de atividade de sequência) aceitam formatos de body inline sem nenhum DTO com class-validator por trás.