courses

O submódulo Courses é o maior do LMS e é dono de todo o pipeline de autoria de um curso, do registro de catálogo até os frames de vídeo individuais dentro de uma aula. O `CourseController` expõe operações no nível do catálogo — criar/atualizar/excluir, listagem filtrável por status/nível/categoria/tipo de oferta, estatísticas agregadas, um endpoint de visão geral de conteúdo que reporta contagens de módulos/aulas e cobertura de transcrição/XP, jobs de limpeza de armazenamento com escopo por categoria de arquivo e gerenciamento de jobs de exportação SCORM 1.2 com temática visual configurável (cores, fontes, layout da barra lateral).

O `CourseStructureController` é a superfície de edição para a árvore aninhada sessão → aula que compõe o conteúdo de um curso. Sessões (módulos) contêm aulas; aulas carregam um `tipo` de vídeo, questao (exame vinculado) ou post, além de metadata rica para o provedor de vídeo (YouTube, Vimeo, armazenamento de arquivo interno, Bunny ou custom), status de produção e uma lista de recursos opcional. Reordenação, duplicação, movimentações entre sessões e colar da área de transferência são todas operações de primeira classe, em vez de serem reconstruídas no cliente a partir de PATCHes da árvore completa — isso mantém árvores de curso grandes editáveis sem reenviar a estrutura inteira a cada mudança. Frames (imagens estáticas extraídas de um vídeo de aula em um timestamp) são gerenciados como seu próprio sub-recurso, suportando casos de uso como thumbnails gerados automaticamente ou marcadores de capítulo. Um endpoint dedicado de bulk-jobs permite que um editor redispare transcrição, recálculo de XP, processamento de vídeo ou tradução de transcrição em cada aula de um curso em uma única chamada, retornando um detalhamento por aula de enfileirado/pulado.

O tratamento de vídeo abrange três controllers trabalhando juntos: o `CourseStructureController` expõe video-processing-stats e enfileira jobs de conversão HLS por aula; o `CourseLessonController` (montado em `/lms/lessons`) é dono dos segmentos de transcrição (legendas com código de tempo), dos arquivos de áudio da aula e dispara jobs de transcrição/tradução em segundo plano; o `LmsBulkUploadController` fornece o pipeline de upload direto-para-S3 usado para ingerir arquivos de vídeo grandes — emitindo credenciais STS temporárias, verificando a conclusão do upload, rastreando o progresso de sessão/item para a UI de admin e vinculando um upload concluído diretamente a uma aula para disparar a conversão automatizada. O `LmsSettingController` expõe a superfície resultante de feature-flags (se transcrição, extração de imagens, embedding de YouTube/Vimeo e upload em massa estão habilitados, além da configuração resolvida de bucket S3/IAM), de modo que o frontend de admin possa renderizar condicionalmente a UI de upload/transcrição.

Notavelmente, vários dos endpoints mais novos (tradução de transcrição de aula, a maioria dos endpoints de sessão/webhook de upload em massa) aceitam formatos de body inline em TypeScript puro, em vez de DTOs com class-validator, portanto não recebem validação de payload em tempo de execução — uma lacuna deliberada ou incidental que vale conhecer antes de construir contratos estritos do lado do cliente contra eles.