@hed-hog/lms 0.0.366 → 0.0.370

package/src/course/course-export-scorm12.service.ts

@@ -7,6 +7,7 @@ import { promises as fs } from 'fs';
 import { join } from 'path';
 import { finished } from 'stream/promises';
 import { CourseExportService, VideoLessonWithFile } from './course-export.service';
+import { balanceSubtitleLines } from './subtitle.util';
 import {
   ADLCP_ROOTV1P2_XSD,
   IMSCP_ROOTV1P1P2_XSD,
@@ -25,7 +26,7 @@ export type ScormVisualOptions = {
 
 export type Scorm12BuildParams = {
   courseId: number;
-  settings: { visual?: ScormVisualOptions };
+  settings: { visual?: ScormVisualOptions; subtitleLocaleIds?: number[] };
   workDir: string;
   onProgress: (pct: number, msg: string) => Promise<void>;
 };
@@ -35,6 +36,7 @@ type LessonData = {
   title: string;
   duration: number | null;
   src: string;
+  subtitles: Array<{ code: string; name: string; vttFile: string }>;
 };
 
 type ModuleData = {
@@ -128,7 +130,39 @@ export class CourseExportScorm12Service {
       }
     }
 
-    const courseData = this.buildCourseData(courseTitle, lessons, videoSrcMap);
+    const subtitleLocaleIds = settings.subtitleLocaleIds ?? [];
+    const subtitleMap: Record<number, Array<{ code: string; name: string; vttFile: string }>> = {};
+    const vttFileList: string[] = [];
+
+    if (subtitleLocaleIds.length > 0) {
+      await onProgress(72, 'Gerando arquivos de legenda...');
+      const locales = await (this.prisma as any).locale.findMany({
+        where: { id: { in: subtitleLocaleIds } },
+        select: { id: true, code: true, name: true },
+      }) as Array<{ id: number; code: string; name: string }>;
+      const localeMap = new Map(locales.map((l: { id: number; code: string; name: string }) => [l.id, l]));
+
+      for (const lesson of lessons) {
+        for (const localeId of subtitleLocaleIds) {
+          const locale = localeMap.get(localeId);
+          if (!locale) continue;
+          const segments = await (this.prisma as any).course_lesson_transcription_segment.findMany({
+            where: { course_lesson_id: lesson.id, locale_id: localeId },
+            select: { start_seconds: true, end_seconds: true, text: true },
+            orderBy: { start_seconds: 'asc' },
+          }) as Array<{ start_seconds: number; end_seconds: number; text: string }>;
+          if (segments.length === 0) continue;
+          const vttContent = this.generateVttContent(segments);
+          const vttName = `assets/lesson_${lesson.id}_${locale.code}.vtt`;
+          archive.append(Buffer.from(vttContent, 'utf-8'), { name: vttName });
+          vttFileList.push(vttName);
+          if (!subtitleMap[lesson.id]) subtitleMap[lesson.id] = [];
+          subtitleMap[lesson.id].push({ code: locale.code, name: locale.name, vttFile: vttName });
+        }
+      }
+    }
+
+    const courseData = this.buildCourseData(courseTitle, lessons, videoSrcMap, subtitleMap);
 
     archive.append(Buffer.from(this.generateScormApiJs()), { name: 'SCORM12API.js' });
     archive.append(Buffer.from(IMS_XML_XSD), { name: 'ims_xml.xsd' });
@@ -140,7 +174,7 @@ export class CourseExportScorm12Service {
     );
     archive.append(Buffer.from(this.generateShellHtml(courseData, visual)), { name: 'index.html' });
 
-    const manifestXml = this.generateManifest(courseTitle, embeddedLessonIds);
+    const manifestXml = this.generateManifest(courseTitle, embeddedLessonIds, vttFileList);
     archive.append(Buffer.from(manifestXml), { name: 'imsmanifest.xml' });
 
     await onProgress(80, 'Finalizando pacote ZIP...');
@@ -166,6 +200,7 @@ export class CourseExportScorm12Service {
     courseTitle: string,
     lessons: VideoLessonWithFile[],
     videoSrcMap: Record<number, string>,
+    subtitleMap: Record<number, Array<{ code: string; name: string; vttFile: string }>>,
   ): CourseData {
     const sessionMap = new Map<number, ModuleData>();
 
@@ -184,6 +219,7 @@ export class CourseExportScorm12Service {
         title: lesson.title,
         duration: lesson.duration_seconds,
         src: videoSrcMap[lesson.id] || '',
+        subtitles: subtitleMap[lesson.id] ?? [],
       });
     }
 
@@ -204,10 +240,13 @@ export class CourseExportScorm12Service {
   private generateManifest(
     courseTitle: string,
     embeddedLessonIds: number[],
+    vttFiles: string[],
   ): string {
     const manifestId = `manifest-${Date.now()}`;
-    const assetFiles = embeddedLessonIds.length
-      ? embeddedLessonIds.map((id) => `      <file href="assets/lesson_${id}.mp4"/>`).join('\n') + '\n'
+    const videoLines = embeddedLessonIds.map((id) => `      <file href="assets/lesson_${id}.mp4"/>`);
+    const vttLines = vttFiles.map((f) => `      <file href="${f}"/>`);
+    const assetFiles = [...videoLines, ...vttLines].length
+      ? [...videoLines, ...vttLines].join('\n') + '\n'
       : '';
 
     return `<?xml version="1.0" encoding="UTF-8"?>
@@ -347,6 +386,10 @@ ${this.generateCss(visual)}
         <div class="footer-meta" id="footerMeta"></div>
       </div>
       <div class="footer-nav">
+        <div class="sub-ctrl" id="subCtrl" style="display:none">
+          <button class="nav-btn" id="subtitleBtn" title="Legendas">CC</button>
+          <div id="subtitleMenu" class="subtitle-menu"></div>
+        </div>
         <button class="nav-btn" id="prevBtn" disabled>&#8592; Anterior</button>
         <button class="nav-btn primary" id="nextBtn" disabled>Pr&#243;xima &#8594;</button>
       </div>
@@ -436,6 +479,11 @@ ${this.generateJs(courseJson, visual.progressStyle)}
     .nav-btn.primary:hover:not(:disabled){filter:brightness(.85)}
     .menu-toggle{display:none;position:fixed;top:10px;z-index:30;width:34px;height:34px;border-radius:8px;background:rgba(0,0,0,.75);color:#fff;border:none;cursor:pointer;font-size:1rem;align-items:center;justify-content:center}
     .overlay{display:none;position:fixed;inset:0;background:rgba(0,0,0,.5);z-index:9}
+    .sub-ctrl{position:relative}
+    .subtitle-menu{display:none;position:absolute;bottom:calc(100% + 6px);right:0;background:#1f2937;border:1px solid #374151;border-radius:6px;min-width:140px;overflow:hidden;z-index:20}
+    .sub-item{padding:7px 12px;cursor:pointer;font-size:${fs.xs};color:#f3f4f6;white-space:nowrap}
+    .sub-item:hover{background:#374151}
+    .sub-item.active-sub{color:${pri};font-weight:600}
     @media(max-width:768px){
       .menu-toggle{display:flex}
       .sidebar{position:fixed;top:0;bottom:0;${isRtl ? 'right:0;left:auto' : 'left:0;right:auto'};transform:${isRtl ? 'translateX(100%)' : 'translateX(-100%)'}}
@@ -453,6 +501,7 @@ ${this.generateJs(courseJson, visual.progressStyle)}
     var currentIdx=-1;
     var allLessons=[];
     var _api=null;
+    var currentSubCode=null;
 
     COURSE.modules.forEach(function(m){
       m.lessons.forEach(function(l){l._mod=m.title;allLessons.push(l);});
@@ -554,6 +603,63 @@ ${this.generateJs(courseJson, visual.progressStyle)}
       });
     }
 
+    function applySubtitle(video,code){
+      var tracks=video.textTracks;
+      for(var i=0;i<tracks.length;i++){
+        tracks[i].mode=(code&&tracks[i].language===code)?'showing':'hidden';
+      }
+      var btn=document.getElementById('subtitleBtn');
+      if(btn)btn.style.opacity=code?'1':'0.5';
+    }
+
+    function highlightSubMenu(){
+      var menu=document.getElementById('subtitleMenu');
+      if(!menu)return;
+      menu.querySelectorAll('.sub-item').forEach(function(el){
+        el.classList.toggle('active-sub',(el.getAttribute('data-code')||null)===currentSubCode);
+      });
+    }
+
+    function buildSubMenu(subtitles,video){
+      var menu=document.getElementById('subtitleMenu');
+      if(!menu)return;
+      var html='<div class="sub-item" data-code="">Desligado</div>';
+      subtitles.forEach(function(sub){
+        html+='<div class="sub-item" data-code="'+sub.code+'">'+esc(sub.name)+'</div>';
+      });
+      menu.innerHTML=html;
+      menu.querySelectorAll('.sub-item').forEach(function(el){
+        el.addEventListener('click',function(e){
+          e.stopPropagation();
+          var code=el.getAttribute('data-code')||null;
+          currentSubCode=code;
+          applySubtitle(video,currentSubCode);
+          menu.style.display='none';
+          highlightSubMenu();
+        });
+      });
+      highlightSubMenu();
+    }
+
+    function updateSubtitleTracks(lesson,video){
+      var oldTracks=video.querySelectorAll('track');
+      oldTracks.forEach(function(t){video.removeChild(t);});
+      var subCtrl=document.getElementById('subCtrl');
+      if(!subCtrl)return;
+      if(!lesson.subtitles||!lesson.subtitles.length){subCtrl.style.display='none';return;}
+      subCtrl.style.display='';
+      lesson.subtitles.forEach(function(sub){
+        var t=document.createElement('track');
+        t.kind='subtitles';
+        t.src=sub.vttFile;
+        t.srclang=sub.code;
+        t.label=sub.name;
+        video.appendChild(t);
+      });
+      applySubtitle(video,currentSubCode);
+      buildSubMenu(lesson.subtitles,video);
+    }
+
     function navigateTo(idx){
       if(idx<0||idx>=allLessons.length)return;
       if(currentIdx>=0&&idx!==currentIdx)markCompleted(allLessons[currentIdx].id);
@@ -572,6 +678,7 @@ ${this.generateJs(courseJson, visual.progressStyle)}
         empty.textContent='Esta aula n\\u00e3o possui v\\u00eddeo dispon\\u00edvel';
         empty.style.display='block';
       }
+      updateSubtitleTracks(lesson,video);
       document.getElementById('footerTitle').textContent=lesson.title;
       var meta=[];
       if(lesson._mod)meta.push(lesson._mod);
@@ -610,6 +717,21 @@ ${this.generateJs(courseJson, visual.progressStyle)}
     document.getElementById('prevBtn').addEventListener('click',function(){navigateTo(currentIdx-1);});
     document.getElementById('nextBtn').addEventListener('click',function(){navigateTo(currentIdx+1);});
 
+    (function(){
+      var sbtn=document.getElementById('subtitleBtn');
+      var smenu=document.getElementById('subtitleMenu');
+      if(sbtn&&smenu){
+        sbtn.addEventListener('click',function(e){
+          e.stopPropagation();
+          smenu.style.display=smenu.style.display==='block'?'none':'block';
+          highlightSubMenu();
+        });
+      }
+      document.addEventListener('click',function(){
+        if(smenu)smenu.style.display='none';
+      });
+    })();
+
     (function(){
       var sidebar=document.getElementById('sidebar');
       var overlay=document.getElementById('overlay');
@@ -650,6 +772,28 @@ ${this.generateJs(courseJson, visual.progressStyle)}
     });`;
   }
 
+  private generateVttContent(
+    segments: Array<{ start_seconds: number; end_seconds: number; text: string }>,
+  ): string {
+    const lines = ['WEBVTT', ''];
+    for (const seg of segments) {
+      lines.push(
+        `${this.secondsToVttTime(seg.start_seconds)} --> ${this.secondsToVttTime(seg.end_seconds)}`,
+        balanceSubtitleLines(seg.text),
+        '',
+      );
+    }
+    return lines.join('\n');
+  }
+
+  private secondsToVttTime(s: number): string {
+    const total = Math.max(0, s);
+    const h = Math.floor(total / 3600);
+    const m = Math.floor((total % 3600) / 60);
+    const sec = total % 60;
+    return `${String(h).padStart(2, '0')}:${String(m).padStart(2, '0')}:${sec.toFixed(3).padStart(6, '0')}`;
+  }
+
   private escapeXml(str: string): string {
     return str
       .replace(/&/g, '&amp;')

package/src/course/course-export.service.ts

@@ -109,6 +109,7 @@ export class CourseExportService {
   ) {
     const settings = {
       visual: { ...(dto.visualSettings ?? {}) },
+      subtitleLocaleIds: dto.subtitleLocaleIds ?? [],
     };
 
     const exportRecord = await this.prisma.course_export.create({

package/src/course/course-lesson.controller.ts

@@ -1,24 +1,65 @@
 import { Role } from '@hed-hog/api';
-import { Body, Controller, Get, Param, ParseIntPipe, Post, Put } from '@nestjs/common';
+import { Body, Controller, Delete, Get, Param, ParseIntPipe, Post, Put, Query } from '@nestjs/common';
+import { PlatformaVideoService } from '../platforma/platforma-video.service';
 import { CourseStructureService } from './course-structure.service';
 import { UpdateTranscriptionSegmentsDTO } from './dto/update-transcription-segments.dto';
 
 @Role()
 @Controller('lms/lessons')
 export class CourseLessonController {
-  constructor(private readonly courseStructureService: CourseStructureService) {}
+  constructor(
+    private readonly courseStructureService: CourseStructureService,
+    private readonly platformaVideoService: PlatformaVideoService,
+  ) {}
 
   @Get(':id/transcription-segments')
-  getTranscriptionSegments(@Param('id', ParseIntPipe) id: number) {
-    return this.courseStructureService.getTranscriptionSegments(id);
+  getTranscriptionSegments(
+    @Param('id', ParseIntPipe) id: number,
+    @Query('locale_id') localeId?: string,
+  ) {
+    const parsedLocaleId =
+      localeId === 'null' ? null : localeId !== undefined ? parseInt(localeId, 10) : undefined;
+    return this.courseStructureService.getTranscriptionSegments(id, parsedLocaleId);
+  }
+
+  @Get(':id/transcription-locales')
+  getTranscriptionLocales(@Param('id', ParseIntPipe) id: number) {
+    return this.courseStructureService.getAvailableTranscriptionLocales(id);
   }
 
   @Put(':id/transcription-segments')
   updateTranscriptionSegments(
     @Param('id', ParseIntPipe) id: number,
     @Body() dto: UpdateTranscriptionSegmentsDTO,
+    @Query('locale_id') localeId?: string,
+  ) {
+    const parsedLocaleId =
+      localeId === 'null' ? null : localeId !== undefined ? parseInt(localeId, 10) : undefined;
+    return this.courseStructureService.updateTranscriptionSegments(id, dto, parsedLocaleId);
+  }
+
+  @Delete(':id/transcription-segments')
+  deleteTranscriptionLocale(
+    @Param('id', ParseIntPipe) id: number,
+    @Query('locale_id') localeId?: string,
+  ) {
+    const parsedLocaleId =
+      localeId === 'null' ? null : localeId !== undefined ? parseInt(localeId, 10) : null;
+    return this.courseStructureService.deleteTranscriptionLocale(id, parsedLocaleId);
+  }
+
+  @Get(':id/preview/hls-token')
+  getAdminHlsToken(@Param('id', ParseIntPipe) id: number) {
+    return this.platformaVideoService.generateAdminHlsToken(id);
+  }
+
+  @Get(':id/preview/subtitles-token')
+  getAdminSubtitlesToken(
+    @Param('id', ParseIntPipe) id: number,
+    @Query('locale_id') localeId?: string,
   ) {
-    return this.courseStructureService.updateTranscriptionSegments(id, dto);
+    const parsedLocaleId = localeId !== undefined ? parseInt(localeId, 10) : undefined;
+    return this.platformaVideoService.generateAdminSubtitlesToken(id, parsedLocaleId);
   }
 
   @Get(':id/audio-files')
@@ -30,4 +71,16 @@ export class CourseLessonController {
   startTranscription(@Param('id', ParseIntPipe) id: number) {
     return this.courseStructureService.startTranscription(id);
   }
-}
+
+  @Post(':id/transcription/translate')
+  translateTranscription(
+    @Param('id', ParseIntPipe) id: number,
+    @Body() body: { targetLocaleId: number; sourceLocaleId?: number | null },
+  ) {
+    return this.courseStructureService.translateTranscription(
+      id,
+      body.sourceLocaleId ?? null,
+      body.targetLocaleId,
+    );
+  }
+}

package/src/course/course-structure.controller.ts

@@ -238,6 +238,21 @@ export class CourseStructureController {
     return this.courseStructureService.getVideoProcessingStats(courseId);
   }
 
+  @Get('transcription-locales')
+  getCourseTranscriptionLocales(@Param('id', ParseIntPipe) courseId: number) {
+    return this.courseStructureService.getCourseTranscriptionLocales(courseId);
+  }
+
+  @Delete('transcription-segments')
+  deleteAllCourseTranscriptions(@Param('id', ParseIntPipe) courseId: number) {
+    return this.courseStructureService.deleteAllCourseTranscriptions(courseId);
+  }
+
+  @Get('ai-costs')
+  getCourseAiCosts(@Param('id', ParseIntPipe) courseId: number) {
+    return this.courseStructureService.getCourseAiCosts(courseId);
+  }
+
   @Post('bulk-jobs')
   createBulkJobs(
     @User() user: any,
@@ -249,6 +264,7 @@ export class CourseStructureController {
       dto.jobType,
       user?.id ?? 0,
       dto.reprocessAlreadyProcessed,
+      dto.targetLocaleId,
     );
   }
 }

package/src/course/course-structure.service.ts

@@ -3,6 +3,7 @@ import { FileService } from '@hed-hog/core';
 import { QueueJobService } from '@hed-hog/queue';
 import { BadRequestException, Injectable, Logger, NotFoundException } from '@nestjs/common';
 import { InstructorService } from '../instructor/instructor.service';
+import { CourseAiUsageService } from './course-ai-usage.service';
 import { CourseOperationsIntegrationService } from './course-operations-integration.service';
 import { CourseVideoHlsService } from './course-video-hls.service';
 import { CreateCourseLessonFrameDto } from './dto/create-course-lesson-frame.dto';
@@ -45,8 +46,13 @@ export class CourseStructureService {
     private readonly operationsIntegration: CourseOperationsIntegrationService,
     private readonly queueJob: QueueJobService,
     private readonly courseVideoHlsService: CourseVideoHlsService,
+    private readonly aiUsageService: CourseAiUsageService,
   ) {}
 
+  getCourseAiCosts(courseId: number) {
+    return this.aiUsageService.getCourseAiCosts(courseId);
+  }
+
   async getStructure(courseId: number) {
     await this.ensureCourseExists(courseId);
 
@@ -61,7 +67,9 @@ export class CourseStructureService {
           course_lesson: {
             orderBy: { order: 'asc' },
             include: {
-              course_lesson_file: true,
+              course_lesson_file: {
+                include: { file: { select: { size: true } } },
+              },
               course_lesson_video_frame: {
                 orderBy: { id: 'asc' },
                 include: {
@@ -162,11 +170,12 @@ export class CourseStructureService {
             parsedContent?.statusProducao,
           ),
           published: lessonPublishedById.get(lesson.id) ?? false,
+          temTranscricao: Boolean((lesson as any).has_transcription),
           recursos: lesson.course_lesson_file.map((fileLink) => ({
             id: String(fileLink.id),
             nome: fileLink.title,
             fileId: fileLink.file_id,
-            tamanho: '',
+            tamanho: fileLink.file?.size ?? 0,
             type: this.readLessonFileType(fileLink),
             is_public: this.readLessonFileVisibility(fileLink),
           })),
@@ -1114,12 +1123,17 @@ export class CourseStructureService {
     return { lessons: result };
   }
 
-  async getTranscriptionSegments(lessonId: number) {
+  async getTranscriptionSegments(lessonId: number, localeId?: number | null) {
+    const where: Record<string, any> = { course_lesson_id: lessonId };
+    if (localeId !== undefined) {
+      where.locale_id = localeId ?? null;
+    }
     return (this.prisma as any).course_lesson_transcription_segment.findMany({
-      where: { course_lesson_id: lessonId },
+      where,
       orderBy: { start_seconds: 'asc' },
       select: {
         id: true,
+        locale_id: true,
         start_seconds: true,
         end_seconds: true,
         text: true,
@@ -1127,17 +1141,44 @@ export class CourseStructureService {
     });
   }
 
+  async getAvailableTranscriptionLocales(lessonId: number) {
+    const rows = await (this.prisma as any).course_lesson_transcription_segment.findMany({
+      where: { course_lesson_id: lessonId },
+      select: { locale_id: true },
+      distinct: ['locale_id'],
+    });
+
+    const localeIds: (number | null)[] = rows.map((r: any) => r.locale_id);
+
+    const locales = await Promise.all(
+      localeIds.map(async (id) => {
+        if (id === null) return { id: null, code: null, name: null, region: null };
+        const locale = await (this.prisma as any).locale.findUnique({
+          where: { id },
+          select: { id: true, code: true, name: true, region: true },
+        });
+        return locale ?? { id, code: null, name: null, region: null };
+      }),
+    );
+
+    return locales;
+  }
+
   async updateTranscriptionSegments(
     lessonId: number,
     dto: UpdateTranscriptionSegmentsDTO,
+    localeId?: number | null,
   ) {
+    const where: Record<string, any> = { course_lesson_id: lessonId };
+    if (localeId !== undefined) {
+      where.locale_id = localeId ?? null;
+    }
     return this.prisma.$transaction([
-      (this.prisma as any).course_lesson_transcription_segment.deleteMany({
-        where: { course_lesson_id: lessonId },
-      }),
+      (this.prisma as any).course_lesson_transcription_segment.deleteMany({ where }),
       (this.prisma as any).course_lesson_transcription_segment.createMany({
         data: (dto.segments ?? []).map((segment) => ({
           course_lesson_id: lessonId,
+          locale_id: localeId ?? null,
           start_seconds: segment.startSeconds,
           end_seconds: segment.endSeconds,
           text: segment.text,
@@ -1146,6 +1187,69 @@ export class CourseStructureService {
     ]);
   }
 
+  async deleteTranscriptionLocale(lessonId: number, localeId: number | null) {
+    const result = await (this.prisma as any).course_lesson_transcription_segment.deleteMany({
+      where: { course_lesson_id: lessonId, locale_id: localeId },
+    });
+    return { success: true, deleted: result.count };
+  }
+
+  async deleteAllCourseTranscriptions(courseId: number) {
+    const lessons = await (this.prisma as any).course_lesson.findMany({
+      where: { course_module: { course_id: courseId } },
+      select: { id: true },
+    });
+    const lessonIds = lessons.map((l: any) => l.id);
+    if (lessonIds.length === 0) {
+      return { success: true, deleted: 0 };
+    }
+    const result = await (this.prisma as any).course_lesson_transcription_segment.deleteMany({
+      where: { course_lesson_id: { in: lessonIds } },
+    });
+    return { success: true, deleted: result.count };
+  }
+
+  async translateTranscription(
+    lessonId: number,
+    sourceLocaleId: number | null,
+    targetLocaleId: number,
+    notificationId?: number,
+    notificationUserId?: number,
+  ) {
+    const lesson = await (this.prisma as any).course_lesson.findUnique({
+      where: { id: lessonId },
+      select: { id: true },
+    });
+
+    if (!lesson) {
+      throw new NotFoundException(`Lesson ${lessonId} not found`);
+    }
+
+    const job = await this.queueJob.enqueue({
+      type: 'lms.transcription.translate',
+      queueName: 'lms.transcription.translate',
+      payload: {
+        lessonId,
+        sourceLocaleId,
+        targetLocaleId,
+        ...(notificationId != null ? { notificationId } : {}),
+        ...(notificationUserId != null ? { notificationUserId } : {}),
+      },
+      sourceModule: 'lms',
+      sourceEntity: 'course_lesson',
+      sourceEntityId: `${lessonId}:${targetLocaleId}`,
+      maxAttempts: 3,
+    });
+
+    const startedOnDemand = await this.startTranscriptionOnDemandIfNeeded(job.id);
+
+    if (startedOnDemand) {
+      return { queueJobId: job.id, status: 'processing' };
+    }
+
+    return { queueJobId: job.id, status: job.status };
+  }
+
   async getAudioFiles(lessonId: number) {
     return (this.prisma as any).course_lesson_file.findMany({
       where: {
@@ -1270,9 +1374,10 @@ export class CourseStructureService {
 
   async bulkEnqueueJobs(
     courseId: number,
-    jobType: 'transcription' | 'xp_recalculation' | 'video_processing',
+    jobType: 'transcription' | 'xp_recalculation' | 'video_processing' | 'translate_transcription',
     userId: number,
     reprocessAlreadyProcessed?: boolean,
+    targetLocaleId?: number,
   ): Promise<{
     queued: number;
     skipped: number;
@@ -1363,7 +1468,7 @@ export class CourseStructureService {
           skipped++;
         }
       }
-    } else {
+    } else if (jobType === 'xp_recalculation') {
       for (const lesson of lessons) {
         const segments = await (this.prisma as any).course_lesson_transcription_segment.findFirst({
           where: { course_lesson_id: lesson.id },
@@ -1409,11 +1514,78 @@ export class CourseStructureService {
           `${skippedWithoutTranscription} aula(s) sem transcrição foram ignoradas. Gere a transcrição antes de recalcular o XP.`,
         );
       }
+    } else if (jobType === 'translate_transcription') {
+      if (!targetLocaleId) {
+        warnings.push('targetLocaleId é obrigatório para o job de tradução em massa.');
+        return { queued, skipped, skippedWithoutTranscription, warnings };
+      }
+
+      for (const lesson of lessons) {
+        const sourceSegment = await (this.prisma as any).course_lesson_transcription_segment.findFirst({
+          where: {
+            course_lesson_id: lesson.id,
+            NOT: { locale_id: targetLocaleId },
+          },
+          select: { id: true, locale_id: true },
+          orderBy: { id: 'asc' },
+        });
+
+        if (!sourceSegment) {
+          skipped++;
+          skippedWithoutTranscription++;
+          continue;
+        }
+
+        await this.queueJob.enqueue({
+          type: 'lms.transcription.translate',
+          queueName: 'lms.transcription.translate',
+          payload: {
+            lessonId: lesson.id,
+            sourceLocaleId: sourceSegment.locale_id ?? null,
+            targetLocaleId,
+          },
+          sourceModule: 'lms',
+          sourceEntity: 'course_lesson',
+          sourceEntityId: `${lesson.id}:${targetLocaleId}`,
+          maxAttempts: 3,
+        });
+        queued++;
+      }
+
+      if (skippedWithoutTranscription > 0) {
+        warnings.push(
+          `${skippedWithoutTranscription} aula(s) sem transcrição foram ignoradas.`,
+        );
+      }
     }
 
     return { queued, skipped, skippedWithoutTranscription, warnings };
   }
 
+  async getCourseTranscriptionLocales(courseId: number) {
+    const rows = await (this.prisma as any).course_lesson_transcription_segment.findMany({
+      where: {
+        course_lesson: {
+          course_module: { course_id: courseId },
+        },
+      },
+      select: { locale_id: true },
+      distinct: ['locale_id'],
+    });
+
+    const localeIds = (rows as Array<{ locale_id: number | null }>)
+      .map((r) => r.locale_id)
+      .filter((id): id is number => id !== null);
+
+    if (localeIds.length === 0) return [];
+
+    return (this.prisma as any).locale.findMany({
+      where: { id: { in: localeIds } },
+      select: { id: true, code: true, name: true, region: true },
+      orderBy: { name: 'asc' },
+    });
+  }
+
   private async syncLessonRelations(
     lessonId: number,
     dto: Partial<
@@ -1510,7 +1682,9 @@ export class CourseStructureService {
             },
           },
         },
-        course_lesson_file: true,
+        course_lesson_file: {
+          include: { file: { select: { size: true } } },
+        },
         course_lesson_question: {
           orderBy: { order: 'asc' },
         },