@hed-hog/lms 0.0.350 → 0.0.351

package/hedhog/frontend/messages/pt.json

@@ -242,13 +242,19 @@
         "certification": "Certificação",
         "flags": "Flags"
       },
+      "sectionDescriptions": {
+        "basicInfo": "Os identificadores e a comunicação principal do curso ficam aqui.",
+        "relations": "Agrupe os vínculos que ajudam a encontrar, operar e ensinar este curso.",
+        "certification": "Escolha o modelo usado na emissão e deixe o impacto desse vínculo explícito."
+      },
       "title": "Dados do Curso",
       "description": "Edite as informações do curso abaixo. Os campos com * são obrigatórios.",
       "fields": {
         "code": {
-          "label": "Código *",
-          "placeholder": "Ex: REACT-ADV",
-          "description": "Identificador único (letras, números e hífens)"
+          "label": "Código de Edição",
+          "placeholder": "Ex: REACT2024",
+          "description": "Somente letras maiúsculas e números, sem espaços (mínimo 2)",
+          "sectionTitle": "Código de Edição"
         },
         "internalName": {
           "label": "Nome Interno *",
@@ -291,9 +297,18 @@
           "selectPlaceholder": "Selecione uma categoria",
           "searchPlaceholder": "Digite para buscar categoria...",
           "noResults": "Nenhuma categoria encontrada",
+          "emptyHint": "Nenhuma categoria vinculada ainda.",
           "selectedCount": "categoria(s) selecionada(s)",
           "removeAction": "Remover categoria",
-          "createAction": "Criar categoria"
+          "createAction": "Criar categoria",
+          "createTitle": "Criar categoria",
+          "createDescription": "Cadastre uma categoria rapidamente sem sair da edição do curso.",
+          "createFields": {
+            "name": {
+              "label": "Nome da categoria",
+              "placeholder": "Ex: Desenvolvimento Web"
+            }
+          }
         },
         "instructors": {
           "label": "Instrutores",
@@ -302,7 +317,16 @@
           "selectPlaceholder": "Selecione um instrutor",
           "searchPlaceholder": "Digite para buscar instrutor...",
           "noResults": "Nenhum instrutor encontrado",
-          "removeAction": "Remover instrutor"
+          "emptyHint": "Nenhum instrutor vinculado ainda.",
+          "removeAction": "Remover instrutor",
+          "createAction": "Cadastrar instrutor"
+        },
+        "operationsProject": {
+          "label": "Projeto vinculado",
+          "placeholder": "Selecione um projeto do Operations",
+          "searchPlaceholder": "Buscar projeto...",
+          "entityLabel": "projeto",
+          "noResults": "Nenhum projeto encontrado"
         },
         "prerequisites": {
           "label": "Pré-requisitos",
@@ -328,7 +352,21 @@
         "certificateModel": {
           "label": "Modelo de Certificado",
           "description": "Selecione um único modelo para emissão do certificado",
-          "placeholder": "Selecione um modelo"
+          "placeholder": "Selecione um modelo",
+          "entityLabel": "modelo de certificado",
+          "createAction": "Criar modelo",
+          "createTitle": "Criar modelo de certificado",
+          "createDescription": "Crie um modelo base e já o vincule ao curso sem sair desta página.",
+          "createFields": {
+            "name": {
+              "label": "Nome do modelo",
+              "placeholder": "Ex: Certificado institucional"
+            },
+            "description": {
+              "label": "Descrição",
+              "placeholder": "Resumo interno para identificar o template"
+            }
+          }
         }
       },
       "media": {
@@ -389,7 +427,76 @@
         "media": "Mídia",
         "resources": "Recursos",
         "extra": "Extra",
-        "publish": "Publicação"
+        "publish": "Publicação",
+        "videoProfiles": "Vídeos"
+      },
+      "structureTab": {
+        "summary": {
+          "title": "Resumo do conteúdo",
+          "stats": {
+            "sessions": "Sessões",
+            "lessons": "Aulas",
+            "duration": "Duração",
+            "published": "Publicadas"
+          }
+        },
+        "mainInfo": {
+          "title": "Dados principais",
+          "fields": {
+            "title": "Título",
+            "internalName": "Nome Interno",
+            "slug": "Slug"
+          }
+        },
+        "description": {
+          "title": "Descrição"
+        }
+      },
+      "resources": {
+        "title": "Recursos para download do curso",
+        "dropzoneAriaLabel": "Soltar arquivo ou clicar para selecionar",
+        "uploading": "Enviando arquivos...",
+        "saving": "Salvando recursos...",
+        "idle": "Arraste arquivos para adicionar",
+        "helper": "Clique para selecionar arquivos",
+        "empty": "Nenhum recurso de curso cadastrado ainda.",
+        "attachedFile": "Arquivo anexado",
+        "downloadAria": "Baixar {name}",
+        "removeAria": "Remover {name}"
+      },
+      "videoProfiles": {
+        "title": "Perfis de Resolução de Vídeo",
+        "placeholder": "Selecionar perfil de vídeo...",
+        "createTitle": "Novo perfil de vídeo",
+        "createFields": {
+          "name": {
+            "label": "Nome",
+            "placeholder": "Ex: 1080p Full HD"
+          },
+          "ffmpegParams": {
+            "label": "Parâmetros FFmpeg",
+            "placeholder": "-vf \"scale=1920:1080\" -c:v libx264 ..."
+          }
+        },
+        "createError": "Não foi possível criar o perfil.",
+        "empty": "Nenhum perfil de resolução adicionado.",
+        "fallbackName": "Perfil #{id}",
+        "editAria": "Editar perfil",
+        "removeAria": "Remover perfil",
+        "sheet": {
+          "title": "Editar perfil de vídeo",
+          "description": "Atualize o nome e os parâmetros FFmpeg deste perfil de resolução.",
+          "actions": {
+            "cancel": "Cancelar",
+            "save": "Salvar",
+            "saving": "Salvando..."
+          }
+        }
+      },
+      "footer": {
+        "cancel": "Cancelar",
+        "newSession": "Nova sessão",
+        "save": "Salvar"
       },
       "publishChecklist": {
         "title": "Checklist de publicação",
@@ -441,7 +548,8 @@
       "statusRequired": "Selecione um status",
       "offeringTypeRequired": "Selecione o formato do curso",
       "categoryRequired": "Selecione pelo menos uma categoria",
-      "colorInvalid": "Informe uma cor hexadecimal válida (ex: #107f46)"
+      "colorInvalid": "Informe uma cor hexadecimal válida (ex: #107f46)",
+      "editionCodeFormat": "Somente letras maiúsculas e números, sem espaços (mínimo 2)"
     }
   },
   "CoursesPage": {
@@ -616,6 +724,10 @@
           "replace": "Substituir logo",
           "remove": "Remover",
           "description": "Imagem opcional para identificar o curso"
+        },
+        "code": {
+          "label": "Código de Edição",
+          "placeholder": "Ex: REACT2024"
         }
       },
       "flags": {
@@ -649,7 +761,8 @@
         "levelRequired": "Selecione um nível",
         "statusRequired": "Selecione um status",
         "categoriesRequired": "Selecione pelo menos uma categoria",
-        "colorInvalid": "Informe uma cor HEX válida"
+        "colorInvalid": "Informe uma cor HEX válida",
+        "editionCodePattern": "Somente letras maiúsculas e números, mínimo 2 caracteres"
       }
     },
     "deleteDialog": {
@@ -936,6 +1049,7 @@
         "update": "Atualizar",
         "save": "Salvar aula",
         "tabData": "Dados",
+        "tabVideos": "Vídeos",
         "tabTranscription": "Transcrição",
         "tabResources": "Recursos",
         "videoProvider": "Provedor de vídeo",
@@ -959,6 +1073,70 @@
         "videoResolutionPlaceholder": "Ex.: 1080p",
         "uploadVideoForResolution": "Enviar vídeo para esta resolução",
         "noResolutionVideosYet": "Nenhum vídeo por resolução enviado ainda.",
+        "loadingVideoProfiles": "Carregando perfis de vídeo do curso...",
+        "videoProfilesLoadError": "Não foi possível carregar os perfis de vídeo do curso.",
+        "retryLoadVideoProfiles": "Tentar carregar novamente",
+        "noVideoProfilesConfigured": "Configure os perfis de vídeo na aba Vídeos do curso antes de anexar vídeos File Storage.",
+        "originalVideoTitle": "Vídeo original em alta resolução",
+        "originalVideoHint": "Envie um original para gerar automaticamente os vídeos dos perfis do curso.",
+        "originalVideoPurpose": "Este arquivo original é usado apenas para gerar as versões de vídeo do curso.",
+        "fileStorageVideoHint": "Use o vídeo original abaixo para gerar automaticamente as versões por perfil do curso.",
+        "uploadOriginalForConversion": "Enviar original para conversão",
+        "videoUploadBlockedWhileProcessing": "O upload de original fica bloqueado enquanto a conversão atual estiver em andamento.",
+        "videoUploadMaxSizeError": "O vídeo excede o limite de {size}.",
+        "videoConversionQueued": "Conversão de vídeo enviada para a fila #{id}.",
+        "videoConversionFailed": "Não foi possível enviar o vídeo para conversão.",
+        "videoConversionJob": "Conversão na fila #{id}",
+        "videoJobFeedbackTitle": "Acompanhamento da conversão",
+        "videoJobLoading": "Carregando andamento da conversão...",
+        "videoJobPendingLoad": "Preparando acompanhamento do job de conversão...",
+        "videoJobLoadError": "Não foi possível carregar o andamento da conversão.",
+        "retryLoadVideoJob": "Tentar novamente",
+        "videoJobIdLabel": "Job",
+        "videoJobAttemptsLabel": "Tentativas",
+        "videoJobAttemptsValue": "{current} de {total}",
+        "videoJobCreatedAt": "Enviado em",
+        "videoJobStartedAt": "Iniciado em",
+        "videoJobFinishedAt": "Finalizado em",
+        "videoJobLatestAttempt": "Última tentativa",
+        "videoJobAttemptValue": "Tentativa {count}",
+        "videoJobLastError": "Último erro",
+        "videoJobRecentEvents": "Eventos recentes",
+        "videoJobNoEvents": "Nenhum evento registrado ainda.",
+        "videoProfilesLockedWhileProcessing": "Os vídeos por perfil ficam bloqueados enquanto a conversão do original está ativa.",
+        "videoJobStatuses": {
+          "pending": "Na fila",
+          "scheduled": "Agendado",
+          "processing": "Processando",
+          "completed": "Concluído",
+          "failed": "Falhou",
+          "retrying": "Tentando novamente",
+          "canceled": "Cancelado",
+          "dead_letter": "Falha definitiva"
+        },
+        "videoAttemptStatuses": {
+          "processing": "Em execução",
+          "completed": "Concluída",
+          "failed": "Falhou",
+          "canceled": "Cancelada"
+        },
+        "videoJobEvents": {
+          "created": "Criado",
+          "scheduled": "Agendado",
+          "locked": "Reservado para worker",
+          "started": "Iniciado",
+          "completed": "Concluído",
+          "failed": "Falhou",
+          "retry_scheduled": "Nova tentativa agendada",
+          "canceled": "Cancelado",
+          "moved_to_dead_letter": "Movido para falha definitiva",
+          "requeued": "Reenfileirado",
+          "unlocked": "Liberado"
+        },
+        "videoProfileMissing": "Nenhum vídeo enviado para este perfil.",
+        "playVideoAria": "Reproduzir vídeo {name}",
+        "videoPreviewTitle": "Pré-visualização do vídeo: {name}",
+        "replaceVideo": "Substituir",
         "openVideoAria": "Abrir vídeo {name}",
         "downloadVideoAria": "Baixar vídeo {name}",
         "removeVideoAria": "Remover vídeo {name}",
@@ -3866,6 +4044,8 @@
         }
       },
       "evaluations": {
+        "emptyTitle": "Avaliações — funcionalidade em breve",
+        "emptyDescription": "Em breve você poderá visualizar as avaliações recebidas pelos alunos.",
         "comingSoonTitle": "Avaliações — funcionalidade em breve",
         "comingSoonDescription": "Em breve você poderá visualizar as avaliações recebidas pelos alunos."
       },
@@ -4418,5 +4598,66 @@
         "deleteError": "Erro ao excluir itens"
       }
     }
+  },
+  "VideoResolutionProfilesPage": {
+    "title": "Perfis de Vídeo",
+    "description": "Gerencie perfis de codificação FFmpeg para transcodificação de vídeos.",
+    "breadcrumbs": {
+      "home": "Início",
+      "lms": "LMS",
+      "current": "Perfis de Vídeo"
+    },
+    "table": {
+      "name": "Nome",
+      "ffmpegParams": "Parâmetros FFmpeg",
+      "status": "Status"
+    },
+    "form": {
+      "name": "Nome",
+      "namePlaceholder": "Ex: 1080p Full HD",
+      "ffmpegParams": "Parâmetros FFmpeg",
+      "ffmpegParamsPlaceholder": "-vf \"scale=1920:1080\" -c:v libx264 ...",
+      "status": "Status",
+      "statusPlaceholder": "Selecione o status",
+      "validation": {
+        "required": "Este campo é obrigatório.",
+        "max100": "Máximo de 100 caracteres."
+      }
+    },
+    "sheet": {
+      "createTitle": "Novo Perfil de Vídeo",
+      "editTitle": "Editar Perfil de Vídeo"
+    },
+    "status": {
+      "active": "Ativo",
+      "inactive": "Inativo"
+    },
+    "actions": {
+      "create": "Novo Perfil",
+      "edit": "Editar",
+      "delete": "Excluir",
+      "save": "Salvar",
+      "saving": "Salvando...",
+      "cancel": "Cancelar",
+      "deleting": "Excluindo..."
+    },
+    "filters": {
+      "searchPlaceholder": "Buscar perfis..."
+    },
+    "empty": {
+      "title": "Nenhum perfil de vídeo",
+      "description": "Crie o primeiro perfil de resolução de vídeo para iniciar a transcodificação."
+    },
+    "messages": {
+      "createSuccess": "Perfil criado com sucesso.",
+      "updateSuccess": "Perfil atualizado com sucesso.",
+      "deleteSuccess": "Perfil excluído com sucesso.",
+      "saveError": "Erro ao salvar o perfil.",
+      "deleteError": "Erro ao excluir o perfil."
+    },
+    "deleteDialog": {
+      "title": "Excluir perfil",
+      "description": "Tem certeza que deseja excluir o perfil \"{name}\"? Esta ação não pode ser desfeita."
+    }
   }
 }

package/hedhog/table/course.yaml

@@ -79,6 +79,10 @@ columns:
   - name: operations_project_id
     type: int
     isNullable: true
+  - name: code
+    type: varchar
+    length: 32
+    isNullable: true
   - type: created_at
   - type: updated_at
 

package/hedhog/table/course_lesson_file.yaml

@@ -16,8 +16,16 @@ columns:
   - name: title
     type: varchar
     length: 255
+  - name: tipo
+    type: varchar
+    length: 80
+    isNullable: true
+  - name: publico
+    type: boolean
+    default: true
   - type: created_at
   - type: updated_at
 
 indices:
   - columns: [course_lesson_id]
+  - columns: [course_lesson_id, tipo]

package/hedhog/table/course_video_resolution_profile.yaml

@@ -0,0 +1,22 @@
+columns:
+  - type: pk
+  - name: course_id
+    type: fk
+    references:
+      table: course
+      column: id
+      onDelete: CASCADE
+  - name: video_resolution_profile_id
+    type: fk
+    references:
+      table: video_resolution_profile
+      column: id
+      onDelete: CASCADE
+  - type: created_at
+  - type: updated_at
+
+indices:
+  - columns: [course_id, video_resolution_profile_id]
+    isUnique: true
+  - columns: [course_id]
+  - columns: [video_resolution_profile_id]

package/hedhog/table/video_resolution_profile.yaml

@@ -0,0 +1,18 @@
+columns:
+  - type: pk
+  - name: name
+    type: varchar
+    length: 100
+  - name: ffmpeg_params
+    type: text
+  - name: status
+    type: enum
+    values: [active, inactive]
+    default: active
+  - type: created_at
+  - type: updated_at
+
+indices:
+  - columns: [name]
+    isUnique: true
+  - columns: [status]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hed-hog/lms",
-  "version": "0.0.350",
+  "version": "0.0.351",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "dependencies": {
@@ -9,15 +9,16 @@
     "@nestjs/core": "^11",
     "@nestjs/jwt": "^11",
     "@nestjs/mapped-types": "*",
-    "@hed-hog/api-locale": "0.0.14",
     "@hed-hog/api-prisma": "0.0.6",
+    "@hed-hog/api-locale": "0.0.14",
     "@hed-hog/api-pagination": "0.0.7",
     "@hed-hog/api-types": "0.0.1",
     "@hed-hog/api": "0.0.8",
-    "@hed-hog/core": "0.0.350",
-    "@hed-hog/category": "0.0.350",
-    "@hed-hog/finance": "0.0.350",
-    "@hed-hog/contact": "0.0.350"
+    "@hed-hog/core": "0.0.351",
+    "@hed-hog/category": "0.0.351",
+    "@hed-hog/queue": "0.0.351",
+    "@hed-hog/finance": "0.0.351",
+    "@hed-hog/crm": "0.0.351"
   },
   "exports": {
     ".": {

package/src/certificate/certificate.controller.ts

@@ -1,16 +1,17 @@
 import { Role } from '@hed-hog/api';
 import {
-  Body,
-  Controller,
-  Delete,
-  Get,
-  Param,
-  ParseIntPipe,
-  Patch,
-  Post,
-  Query,
-  UploadedFile,
-  UseInterceptors,
+    Body,
+    Controller,
+    Delete,
+    Get,
+    Headers,
+    Param,
+    ParseIntPipe,
+    Patch,
+    Post,
+    Query,
+    UploadedFile,
+    UseInterceptors,
 } from '@nestjs/common';
 import { FileInterceptor } from '@nestjs/platform-express';
 import { LmsCertificateService } from './certificate.service';
@@ -52,8 +53,9 @@ export class LmsCertificateController {
   updateTemplate(
     @Param('id', ParseIntPipe) id: number,
     @Body() dto: UpdateCertificateTemplateDto,
+    @Headers('accept-language') locale?: string,
   ) {
-    return this.certificateService.updateTemplate(id, dto);
+    return this.certificateService.updateTemplate(id, dto, locale);
   }
 
   @Post('templates/background-image')
@@ -63,8 +65,11 @@ export class LmsCertificateController {
   }
 
   @Delete('templates/:id')
-  deleteTemplate(@Param('id', ParseIntPipe) id: number) {
-    return this.certificateService.deleteTemplate(id);
+  deleteTemplate(
+    @Param('id', ParseIntPipe) id: number,
+    @Headers('accept-language') locale?: string,
+  ) {
+    return this.certificateService.deleteTemplate(id, locale);
   }
 
   @Get('issued')

package/src/certificate/certificate.service.ts

@@ -1,11 +1,11 @@
 import { PrismaService } from '@hed-hog/api-prisma';
 import { FileService, IntegrationDeveloperApiService } from '@hed-hog/core';
 import {
-  BadRequestException,
-  Inject,
-  Injectable,
-  NotFoundException,
-  forwardRef,
+    BadRequestException,
+    Inject,
+    Injectable,
+    NotFoundException,
+    forwardRef,
 } from '@nestjs/common';
 import { CreateCertificateTemplateDto } from './dto/create-certificate-template.dto';
 import { UpdateCertificateTemplateDto } from './dto/update-certificate-template.dto';
@@ -27,6 +27,13 @@ type ListCertificateTemplatesParams = {
   status?: string;
 };
 
+type TemplateLike = {
+  objects?: Array<{
+    type?: string;
+    image?: { file_id?: number | null };
+  }>;
+};
+
 @Injectable()
 export class LmsCertificateService {
   constructor(
@@ -134,16 +141,33 @@ export class LmsCertificateService {
     return this.mapTemplate(template);
   }
 
-  async updateTemplate(id: number, dto: UpdateCertificateTemplateDto) {
-    await this.ensureTemplateExists(id);
+  async updateTemplate(
+    id: number,
+    dto: UpdateCertificateTemplateDto,
+    locale?: string,
+  ) {
+    const existingTemplate = await this.ensureTemplateExists(id);
 
     const payload = this.prepareTemplatePayload(dto, true);
 
+    const previousFileIds = this.extractTemplateImageFileIds(
+      existingTemplate.template_content,
+    );
+    const nextFileIds =
+      payload.template_content !== undefined
+        ? this.extractTemplateImageFileIds(payload.template_content)
+        : previousFileIds;
+    const removedFileIds = previousFileIds.filter(
+      (fileId) => !nextFileIds.includes(fileId),
+    );
+
     const template = await this.prisma.certificate_template.update({
       where: { id },
       data: payload,
     });
 
+    await this.deleteFilesIfExist(removedFileIds, locale);
+
     await this.integrationApi.publishEvent({
       eventName: 'lms.certificate_template.updated',
       sourceModule: 'lms',
@@ -155,8 +179,11 @@ export class LmsCertificateService {
     return this.mapTemplate(template);
   }
 
-  async deleteTemplate(id: number) {
-    await this.ensureTemplateExists(id);
+  async deleteTemplate(id: number, locale?: string) {
+    const existingTemplate = await this.ensureTemplateExists(id);
+    const fileIdsToDelete = this.extractTemplateImageFileIds(
+      existingTemplate.template_content,
+    );
 
     try {
       await this.prisma.certificate_template.delete({
@@ -166,6 +193,8 @@ export class LmsCertificateService {
       throw new BadRequestException('Certificate template cannot be removed');
     }
 
+    await this.deleteFilesIfExist(fileIdsToDelete, locale);
+
     await this.integrationApi.publishEvent({
       eventName: 'lms.certificate_template.deleted',
       sourceModule: 'lms',
@@ -462,14 +491,80 @@ export class LmsCertificateService {
     return normalized.slice(0, 255);
   }
 
+  private extractTemplateImageFileIds(templateContent: string): number[] {
+    try {
+      const parsed = JSON.parse(templateContent) as TemplateLike;
+      if (!Array.isArray(parsed?.objects)) {
+        return [];
+      }
+
+      const unique = new Set<number>();
+      for (const obj of parsed.objects) {
+        if (!obj || obj.type !== 'image') {
+          continue;
+        }
+
+        const fileId = obj.image?.file_id;
+        if (
+          typeof fileId === 'number' &&
+          Number.isInteger(fileId) &&
+          fileId > 0
+        ) {
+          unique.add(fileId);
+        }
+      }
+
+      return [...unique];
+    } catch {
+      return [];
+    }
+  }
+
+  private normalizeLocale(locale?: string) {
+    const value = String(locale || '').trim();
+    if (!value) {
+      return 'en';
+    }
+
+    return value.split(',')[0]?.trim() || 'en';
+  }
+
+  private async deleteFilesIfExist(fileIds: number[], locale?: string) {
+    if (!Array.isArray(fileIds) || fileIds.length === 0) {
+      return;
+    }
+
+    const existingFiles = await this.prisma.file.findMany({
+      where: {
+        id: { in: fileIds },
+      },
+      select: { id: true },
+    });
+
+    const existingIds = existingFiles.map((file) => file.id);
+    if (existingIds.length === 0) {
+      return;
+    }
+
+    await this.fileService.delete(this.normalizeLocale(locale), {
+      ids: existingIds,
+    });
+  }
+
   private async ensureTemplateExists(id: number) {
-    const count = await this.prisma.certificate_template.count({
+    const template = await this.prisma.certificate_template.findUnique({
       where: { id },
+      select: {
+        id: true,
+        template_content: true,
+      },
     });
 
-    if (!count) {
+    if (!template) {
       throw new NotFoundException('Certificate template not found');
     }
+
+    return template;
   }
 
   private async ensureCertificateExists(id: number) {