@hed-hog/lms 0.0.331 → 0.0.347

package/hedhog/frontend/messages/pt.json

@@ -1544,7 +1544,20 @@
         "description": {
           "label": "Descrição",
           "placeholder": "Descreva a formação...",
-          "required": true
+          "required": false
+        },
+        "progressionMode": {
+          "label": "Fluxo da Trilha",
+          "placeholder": "Selecione o fluxo",
+          "required": true,
+          "options": {
+            "sequential": "Exigir ordem dos passos",
+            "free": "Liberar navegação entre passos"
+          },
+          "help": {
+            "sequential": "O aluno precisa concluir cada etapa da trilha antes de avançar para a próxima.",
+            "free": "O aluno pode abrir qualquer etapa da trilha a qualquer momento, sem bloqueio de sequência."
+          }
         },
         "area": {
           "label": "Área",
@@ -2916,6 +2929,11 @@
           "subFree": "{count} vagas livres",
           "subFull": "Lotada"
         },
+        "nextClass": "Próxima Aula",
+        "noClass": "Sem aula",
+        "createNext": "Crie a próxima aula",
+        "calendar": "Calendário",
+        "completed": "{count} concluída(s)",
         "avgAttendance": {
           "label": "Presença Média",
           "sub": "frequência geral"
@@ -3547,10 +3565,92 @@
       "studentRemoveError": "Falha ao remover aluno."
     },
     "form": {
+      "title": {
+        "create": "Criar Novo Curso",
+        "edit": "Editar Curso"
+      },
+      "description": {
+        "create": "Preencha os dados para criar um novo curso. Após criar, você será redirecionado para a página do curso.",
+        "edit": "Atualize as informações do curso abaixo."
+      },
+      "fields": {
+        "internalName": {
+          "label": "Nome Interno",
+          "placeholder": "Ex: React Avançado",
+          "description": "Nome interno do curso para uso administrativo"
+        },
+        "slug": {
+          "label": "Slug",
+          "placeholder": "Ex: react-avancado",
+          "description": "Identificador único na URL (letras minúsculas, números e hífens)"
+        },
+        "commercialTitle": {
+          "label": "Título Comercial",
+          "placeholder": "Ex: React Avançado"
+        },
+        "description": {
+          "label": "Descrição",
+          "placeholder": "Descreva o conteúdo e objetivos do curso..."
+        },
+        "level": {
+          "label": "Nível",
+          "placeholder": "Selecione"
+        },
+        "status": {
+          "label": "Status",
+          "placeholder": "Selecione"
+        },
+        "categories": {
+          "label": "Categorias",
+          "description": "Selecione uma ou mais categorias",
+          "createAction": "Criar categoria",
+          "selectPlaceholder": "Selecione uma categoria",
+          "removeAction": "Remover categoria",
+          "searchPlaceholder": "Digite para buscar categoria...",
+          "noResults": "Nenhuma categoria encontrada",
+          "selectedCount": "categoria(s) selecionada(s)"
+        },
+        "primaryColor": {
+          "label": "Cor Primária",
+          "placeholder": "#1D4ED8"
+        },
+        "secondaryColor": {
+          "label": "Cor Secundária",
+          "placeholder": "#111827"
+        },
+        "logo": {
+          "label": "Logo do Curso",
+          "alt": "Logo do curso",
+          "upload": "Carregar logo",
+          "replace": "Substituir logo",
+          "remove": "Remover",
+          "description": "Imagem opcional para identificar o curso"
+        }
+      },
+      "validation": {
+        "internalNameMinLength": "Nome interno deve ter pelo menos 3 caracteres",
+        "slugPattern": "Slug deve conter apenas letras minúsculas, números e hífens"
+      },
+      "actions": {
+        "cancel": "Cancelar",
+        "save": "Salvar Alterações",
+        "create": "Criar Curso"
+      },
       "toasts": {
         "courseCreated": "Curso criado com sucesso! Redirecionando...",
         "courseCreateError": "Não foi possível criar o curso."
       }
+    },
+    "levels": {
+      "beginner": "Iniciante",
+      "intermediate": "Intermediário",
+      "advanced": "Avançado"
+    },
+    "status": {
+      "active": "Ativo",
+      "inactive": "Inativo",
+      "draft": "Rascunho",
+      "archived": "Arquivado"
     }
   },
   "InstructorsPage": {
@@ -3661,9 +3761,17 @@
       "classes": {
         "emptyTitle": "Nenhuma turma encontrada",
         "emptyDescription": "Este instrutor ainda não está vinculado a nenhuma turma.",
+        "searchPlaceholder": "Buscar turma por nome, código ou curso...",
+        "statusFilterPlaceholder": "Filtrar por status",
+        "allStatuses": "Todos os status",
         "start": "Início:",
         "end": "Fim:",
-        "students": "{count} aluno(s)"
+        "students": "{count} aluno(s)",
+        "studentsOfCapacity": "{count} / {total} aluno(s)",
+        "actions": {
+          "editAriaLabel": "Editar turma",
+          "openAriaLabel": "Abrir página da turma"
+        }
       },
       "evaluations": {
         "comingSoonTitle": "Avaliações — funcionalidade em breve",
@@ -3713,23 +3821,17 @@
       "current": "Skills de Instrutor"
     },
     "filters": {
-      "searchPlaceholder": "Buscar por slug ou nome..."
+      "searchPlaceholder": "Buscar por slug..."
     },
     "table": {
       "slug": "Slug",
-      "namePt": "Nome (PT)",
-      "nameEn": "Nome (EN)",
       "status": "Status"
     },
     "form": {
       "slug": "Slug",
       "slugPlaceholder": "ex.: javascript, react-js",
-      "namePt": "Nome (PT)",
-      "namePtPlaceholder": "Nome em português",
-      "nameEn": "Nome (EN)",
-      "nameEnPlaceholder": "Nome em inglês (opcional)",
       "status": "Status",
-      "statusPlaceholder": "Selecione o status",
+      "statusPlaceholder": "Selecione um status",
       "validation": {
         "required": "Obrigatório",
         "max100": "Máximo 100 caracteres",
@@ -3942,7 +4044,8 @@
       },
       "actions": {
         "create": "Criar nova turma",
-        "add": "Adicionar"
+        "add": "Adicionar",
+        "edit": "Editar"
       },
       "empty": {
         "title": "Nenhuma turma encontrada.",
@@ -3950,6 +4053,7 @@
       },
       "table": {
         "class": "Turma",
+        "instructor": "Instrutor",
         "status": "Status",
         "period": "Período",
         "capacity": "Capacidade"

package/hedhog/table/enterprise_student_license_event.yaml

@@ -0,0 +1,30 @@
+columns:
+  - type: pk
+  - name: enterprise_id
+    type: fk
+    references:
+      table: enterprise
+      column: id
+      onDelete: CASCADE
+  - name: person_id
+    type: fk
+    references:
+      table: person
+      column: id
+      onDelete: CASCADE
+  - name: event_type
+    type: enum
+    values: [assigned, revoked, status_changed]
+  - name: previous_status
+    type: varchar
+    length: 32
+    isNullable: true
+  - name: next_status
+    type: varchar
+    length: 32
+    isNullable: true
+  - type: created_at
+
+indices:
+  - columns: [enterprise_id, created_at]
+  - columns: [person_id, created_at]

package/hedhog/table/instructor_skill.yaml

@@ -2,17 +2,6 @@ columns:
   - type: pk
   - name: slug
     isUnique: true
-  - name: name
-    type: locale_varchar
-    locale:
-      pt: Nome
-      en: Name
-  - name: description
-    type: locale_text
-    isNullable: true
-    locale:
-      pt: Descrição
-      en: Description
   - name: status
     type: enum
     values: [active, inactive]

package/hedhog/table/learning_path.yaml

@@ -24,6 +24,10 @@ columns:
     type: enum
     values: [draft, active, archived]
     default: draft
+  - name: progress_mode
+    type: enum
+    values: [sequential, free]
+    default: sequential
   - name: primary_color
     type: varchar
     length: 9

package/package.json

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

package/src/course/course.controller.ts

@@ -28,6 +28,7 @@ export class CourseController {
     @Query('status') status?: string,
     @Query('level') level?: string,
     @Query('category') category?: string,
+    @Query('offeringTypes') offeringTypes?: string | string[],
   ) {
     return this.courseService.list({
       page: page ? Number(page) : 1,
@@ -36,9 +37,26 @@ export class CourseController {
       status,
       level,
       category,
+      offeringTypes: this.toArray(offeringTypes),
     });
   }
 
+  private toArray(value?: string | string[]) {
+    if (Array.isArray(value)) {
+      return value
+        .flatMap((item) => String(item).split(','))
+        .map((item) => item.trim())
+        .filter(Boolean);
+    }
+    if (typeof value === 'string') {
+      return value
+        .split(',')
+        .map((item) => item.trim())
+        .filter(Boolean);
+    }
+    return [];
+  }
+
   @Get('stats')
   stats() {
     return this.courseService.stats();

package/src/course/course.service.ts

@@ -94,6 +94,35 @@ export class CourseService {
     return this.normalizeOptionalText(title) ?? slug;
   }
 
+  private async resolveCertificateTemplateId(value?: string | null) {
+    if (value === undefined) {
+      return undefined;
+    }
+
+    const normalized = String(value ?? '').trim();
+
+    if (!normalized) {
+      return null;
+    }
+
+    const numericId = Number(normalized);
+    const template = await this.prisma.certificate_template.findFirst({
+      where:
+        Number.isInteger(numericId) && numericId > 0
+          ? {
+              OR: [{ id: numericId }, { slug: normalized }],
+            }
+          : { slug: normalized },
+      select: { id: true },
+    });
+
+    if (!template) {
+      throw new BadRequestException('Certificate template not found');
+    }
+
+    return template.id;
+  }
+
   async list(params: {
     page?: number;
     pageSize?: number;
@@ -101,6 +130,7 @@ export class CourseService {
     status?: string;
     level?: string;
     category?: string;
+    offeringTypes?: string[];
   }) {
     const page = Math.max(Number(params.page) || 1, 1);
     const pageSize = Math.max(Number(params.pageSize) || 12, 1);
@@ -128,6 +158,9 @@ export class CourseService {
         some: { category: { slug: params.category } },
       };
     }
+    if (params.offeringTypes && params.offeringTypes.length > 0) {
+      where.offering_type = { in: params.offeringTypes };
+    }
 
     const [courses, total] = await Promise.all([
       this.prisma.course.findMany({
@@ -244,6 +277,9 @@ export class CourseService {
             },
           },
         },
+        certificate_template: {
+          select: { id: true, slug: true },
+        },
         _count: {
           select: {
             course_enrollment: true,
@@ -318,9 +354,18 @@ export class CourseService {
   }
 
   async create(dto: CreateCourseDto) {
-    const { categorySlugs, logoFileId, bannerFileId, instructorIds, ...data } = dto;
+    const {
+      categorySlugs,
+      logoFileId,
+      bannerFileId,
+      instructorIds,
+      certificateModel,
+      ...data
+    } = dto;
     const normalizedSlug = data.slug.trim();
     const resolvedTitle = this.resolveCourseTitle(data.title, normalizedSlug);
+    const certificateTemplateId =
+      await this.resolveCertificateTemplateId(certificateModel);
 
     const categories = categorySlugs?.length
       ? await this.prisma.category.findMany({
@@ -365,6 +410,9 @@ export class CourseService {
         ...(data.certificateWorkload !== undefined && {
           certificate_workload: data.certificateWorkload,
         }),
+        ...(certificateTemplateId !== undefined && {
+          certificate_template_id: certificateTemplateId,
+        }),
         ...(data.primaryColor !== undefined && {
           primary_color: data.primaryColor,
         }),
@@ -427,6 +475,9 @@ export class CourseService {
             },
           },
         },
+        certificate_template: {
+          select: { id: true, slug: true },
+        },
         _count: { select: { course_enrollment: true } },
       },
     });
@@ -457,7 +508,14 @@ export class CourseService {
   }
 
   async update(id: number, dto: UpdateCourseDto) {
-    const { categorySlugs, logoFileId, bannerFileId, instructorIds, ...data } = dto;
+    const {
+      categorySlugs,
+      logoFileId,
+      bannerFileId,
+      instructorIds,
+      certificateModel,
+      ...data
+    } = dto;
     let existingSlug: string | undefined;
 
     if (
@@ -478,6 +536,8 @@ export class CourseService {
       data.title !== undefined
         ? this.resolveCourseTitle(data.title, resolvedSlug ?? existingSlug ?? '')
         : undefined;
+    const certificateTemplateId =
+      await this.resolveCertificateTemplateId(certificateModel);
 
     const categories = categorySlugs?.length
       ? await this.prisma.category.findMany({
@@ -535,6 +595,9 @@ export class CourseService {
         ...(data.certificateWorkload !== undefined && {
           certificate_workload: data.certificateWorkload,
         }),
+        ...(certificateTemplateId !== undefined && {
+          certificate_template_id: certificateTemplateId,
+        }),
         ...(data.primaryColor !== undefined && {
           primary_color: data.primaryColor,
         }),
@@ -589,6 +652,9 @@ export class CourseService {
             },
           },
         },
+        certificate_template: {
+          select: { id: true, slug: true },
+        },
         _count: { select: { course_enrollment: true } },
       },
     });
@@ -731,6 +797,11 @@ export class CourseService {
       averageCompletion: Math.round(metrics?.averageCompletion ?? 0),
       certificatesIssued:
         metrics?.certificatesIssued ?? c._count?.certificate ?? 0,
+      certificateModel:
+        c.certificate_template?.slug ??
+        (c.certificate_template_id
+          ? String(c.certificate_template_id)
+          : null),
       progressByModule: metrics?.progressByModule ?? [],
       instructors: (c.course_instructor ?? []).map((ci: any) => ({
         id: ci.instructor_id,
@@ -808,51 +879,39 @@ export class CourseService {
     id: number,
     data: PersistCourseExtrasInput,
   ) {
-    const sets: string[] = [];
-    const params: Array<string | boolean | number> = [];
+    const updateData: Record<string, string | boolean> = {};
 
     if (data.name !== undefined) {
-      params.push(data.name);
-      sets.push(`name = $${params.length}`);
+      updateData.name = data.name;
     }
 
     if (data.isFeatured !== undefined) {
-      params.push(data.isFeatured);
-      sets.push(`is_featured = $${params.length}`);
+      updateData.is_featured = data.isFeatured;
     }
 
     if (data.hasCertificate !== undefined) {
-      params.push(data.hasCertificate);
-      sets.push(`has_certificate = $${params.length}`);
+      updateData.has_certificate = data.hasCertificate;
     }
 
     if (data.isListed !== undefined) {
-      params.push(data.isListed);
-      sets.push(`is_listed = $${params.length}`);
+      updateData.is_listed = data.isListed;
     }
 
     if (data.offeringType !== undefined) {
-      params.push(data.offeringType);
-      sets.push(`offering_type = $${params.length}`);
+      updateData.offering_type = data.offeringType;
     }
 
-    if (sets.length === 0) {
+    if (Object.keys(updateData).length === 0) {
       return;
     }
 
-    params.push(id);
-
     try {
-      await this.prisma.$executeRawUnsafe(
-        `
-          UPDATE course
-          SET ${sets.join(', ')}, updated_at = NOW()
-          WHERE id = $${params.length}
-        `,
-        ...params,
-      );
+      await this.prisma.course.update({
+        where: { id },
+        data: updateData as any,
+      });
     } catch {
-      // Columns may not exist yet in environments with outdated schema.
+      // Some environments may still be behind the current course schema.
     }
   }
 

package/src/course/dto/create-course.dto.ts

@@ -99,6 +99,10 @@ export class CreateCourseDto {
   @IsOptional()
   categorySlugs?: string[];
 
+  @IsString()
+  @IsOptional()
+  certificateModel?: string | null;
+
   @IsArray()
   @IsInt({ each: true })
   @IsOptional()

package/src/enterprise/enterprise.controller.ts

@@ -126,6 +126,11 @@ export class EnterpriseController {
     return { profiles };
   }
 
+  @Get(':id/overview')
+  getOverview(@Param('id', ParseIntPipe) id: number) {
+    return this.enterpriseService.getOverview(id);
+  }
+
   @Get(':id')
   getById(@Param('id', ParseIntPipe) id: number) {
     return this.enterpriseService.getById(id);