@hed-hog/lms 0.0.318 → 0.0.320

package/hedhog/frontend/messages/en.json

@@ -2372,6 +2372,11 @@
           "label": "Lesson title",
           "placeholder": "e.g. Live class session"
         },
+        "sessionAccess": {
+          "label": "Lesson location / access link",
+          "placeholder": "Room 201 or https://meet.google.com/...",
+          "description": "Optional. When filled, it will be applied to every lesson generated for this class."
+        },
         "schedule": {
           "label": "Schedule",
           "placeholder": "7:00 PM - 10:00 PM"
@@ -2420,13 +2425,13 @@
             "yearly": "year"
           },
           "days": {
-            "MO": "M",
-            "TU": "T",
-            "WE": "W",
-            "TH": "T",
-            "FR": "F",
-            "SA": "S",
-            "SU": "S"
+            "MO": "Mon",
+            "TU": "Tue",
+            "WE": "Wed",
+            "TH": "Thu",
+            "FR": "Fri",
+            "SA": "Sat",
+            "SU": "Sun"
           }
         }
       },
@@ -2809,17 +2814,103 @@
         "studentUpdated": "Student updated successfully!",
         "lessonUpdated": "Lesson updated successfully!",
         "lessonCreated": "Lesson created successfully!",
+        "attendanceSaving": "Saving attendance...",
         "attendanceSaved": "Attendance saved successfully!",
         "error": "An error occurred. Please try again."
       }
     }
   },
+  "EvaluationTopicsPage": {
+    "title": "Evaluation Topics",
+    "description": "Manage evaluation topics grouped by target type.",
+    "breadcrumbs": {
+      "home": "Home",
+      "lms": "LMS",
+      "evaluations": "Evaluation Topics"
+    },
+    "newTopic": "New Topic",
+    "kpi": {
+      "total": "Total Topics",
+      "totalDesc": "All evaluation topics",
+      "active": "Active",
+      "activeDesc": "Currently active topics",
+      "inactive": "Inactive",
+      "inactiveDesc": "Deactivated topics",
+      "withRatings": "With Ratings",
+      "withRatingsDesc": "Topics that have received ratings"
+    },
+    "filters": {
+      "searchPlaceholder": "Search by name or description…",
+      "clear": "Clear"
+    },
+    "tabs": {
+      "all": "All"
+    },
+    "targetType": {
+      "course": "Course",
+      "course_lesson": "Lesson",
+      "course_class_session": "Session",
+      "question": "Question",
+      "exam": "Exam"
+    },
+    "columns": {
+      "name": "Name",
+      "targetType": "Target Type",
+      "order": "Order",
+      "ratings": "Ratings",
+      "status": "Status"
+    },
+    "status": {
+      "active": "Active",
+      "inactive": "Inactive"
+    },
+    "empty": {
+      "title": "No topics found",
+      "description": "Create an evaluation topic to get started."
+    },
+    "delete": {
+      "title": "Delete Topic",
+      "description": "Are you sure you want to delete \"{name}\"? This action cannot be undone.",
+      "cancel": "Cancel",
+      "confirm": "Delete",
+      "deleting": "Deleting…",
+      "success": "Topic deleted.",
+      "error": "Failed to delete topic.",
+      "disabledTooltip": "Cannot delete a topic that already has ratings."
+    },
+    "reorder": {
+      "success": "Order saved.",
+      "error": "Failed to save order."
+    },
+    "form": {
+      "editTitle": "Edit Topic",
+      "createTitle": "New Topic",
+      "name": "Name",
+      "namePlaceholder": "Enter topic name",
+      "description": "Description",
+      "descriptionPlaceholder": "Optional description",
+      "targetType": "Target Type",
+      "targetTypeReadonly": "Target type cannot be changed after creation.",
+      "order": "Display Order",
+      "orderPlaceholder": "e.g. 1",
+      "isActive": "Active",
+      "isActiveDesc": "Visible to evaluators",
+      "cancel": "Cancel",
+      "save": "Save Changes",
+      "create": "Create Topic",
+      "saving": "Saving…",
+      "createdSuccess": "Topic created successfully.",
+      "updatedSuccess": "Topic updated successfully.",
+      "saveError": "Failed to save topic."
+    }
+  },
   "EvaluationsPage": {
     "title": "Evaluations",
     "description": "Browse and filter all evaluation ratings submitted by students.",
     "breadcrumbs": {
       "home": "Home",
       "lms": "LMS",
+      "reports": "Reports",
       "evaluations": "Evaluations"
     },
     "filters": {

package/hedhog/frontend/messages/pt.json

@@ -2379,6 +2379,11 @@
           "label": "Título das aulas",
           "placeholder": "Ex.: Aula ao vivo da turma"
         },
+        "sessionAccess": {
+          "label": "Local / link das aulas",
+          "placeholder": "Sala 201 ou https://meet.google.com/...",
+          "description": "Opcional. Quando preenchido, será aplicado a todas as aulas geradas para esta turma."
+        },
         "schedule": {
           "label": "Horário",
           "placeholder": "19:00 - 22:00"
@@ -2427,13 +2432,13 @@
             "yearly": "ano"
           },
           "days": {
-            "MO": "S",
-            "TU": "T",
-            "WE": "Q",
-            "TH": "Q",
-            "FR": "S",
-            "SA": "S",
-            "SU": "D"
+            "MO": "Seg",
+            "TU": "Ter",
+            "WE": "Qua",
+            "TH": "Qui",
+            "FR": "Sex",
+            "SA": "Sáb",
+            "SU": "Dom"
           }
         }
       },
@@ -2816,17 +2821,103 @@
         "studentUpdated": "Aluno atualizado com sucesso!",
         "lessonUpdated": "Aula atualizada com sucesso!",
         "lessonCreated": "Aula criada com sucesso!",
+        "attendanceSaving": "Salvando presença...",
         "attendanceSaved": "Presença salva com sucesso!",
         "error": "Ocorreu um erro. Tente novamente."
       }
     }
   },
+  "EvaluationTopicsPage": {
+    "title": "Tópicos de Avaliação",
+    "description": "Gerencie os tópicos de avaliação agrupados por tipo.",
+    "breadcrumbs": {
+      "home": "Início",
+      "lms": "LMS",
+      "evaluations": "Tópicos de Avaliação"
+    },
+    "newTopic": "Novo Tópico",
+    "kpi": {
+      "total": "Total de Tópicos",
+      "totalDesc": "Todos os tópicos de avaliação",
+      "active": "Ativos",
+      "activeDesc": "Tópicos ativos no momento",
+      "inactive": "Inativos",
+      "inactiveDesc": "Tópicos desativados",
+      "withRatings": "Com Avaliações",
+      "withRatingsDesc": "Tópicos que já receberam avaliações"
+    },
+    "filters": {
+      "searchPlaceholder": "Buscar por nome ou descrição…",
+      "clear": "Limpar"
+    },
+    "tabs": {
+      "all": "Todos"
+    },
+    "targetType": {
+      "course": "Curso",
+      "course_lesson": "Aula",
+      "course_class_session": "Sessão",
+      "question": "Questão",
+      "exam": "Exame"
+    },
+    "columns": {
+      "name": "Nome",
+      "targetType": "Tipo",
+      "order": "Ordem",
+      "ratings": "Avaliações",
+      "status": "Status"
+    },
+    "status": {
+      "active": "Ativo",
+      "inactive": "Inativo"
+    },
+    "empty": {
+      "title": "Nenhum tópico encontrado",
+      "description": "Crie um tópico de avaliação para começar."
+    },
+    "delete": {
+      "title": "Excluir Tópico",
+      "description": "Tem certeza que deseja excluir \"{name}\"? Esta ação não pode ser desfeita.",
+      "cancel": "Cancelar",
+      "confirm": "Excluir",
+      "deleting": "Excluindo…",
+      "success": "Tópico excluído.",
+      "error": "Falha ao excluir o tópico.",
+      "disabledTooltip": "Não é possível excluir um tópico que já possui avaliações."
+    },
+    "reorder": {
+      "success": "Ordem salva.",
+      "error": "Falha ao salvar a ordem."
+    },
+    "form": {
+      "editTitle": "Editar Tópico",
+      "createTitle": "Novo Tópico",
+      "name": "Nome",
+      "namePlaceholder": "Informe o nome do tópico",
+      "description": "Descrição",
+      "descriptionPlaceholder": "Descrição opcional",
+      "targetType": "Tipo de Alvo",
+      "targetTypeReadonly": "O tipo de alvo não pode ser alterado após a criação.",
+      "order": "Ordem de Exibição",
+      "orderPlaceholder": "ex.: 1",
+      "isActive": "Ativo",
+      "isActiveDesc": "Visível para avaliadores",
+      "cancel": "Cancelar",
+      "save": "Salvar Alterações",
+      "create": "Criar Tópico",
+      "saving": "Salvando…",
+      "createdSuccess": "Tópico criado com sucesso.",
+      "updatedSuccess": "Tópico atualizado com sucesso.",
+      "saveError": "Falha ao salvar o tópico."
+    }
+  },
   "EvaluationsPage": {
     "title": "Avaliações",
     "description": "Visualize e filtre todas as avaliações enviadas pelos alunos.",
     "breadcrumbs": {
       "home": "Início",
       "lms": "LMS",
+      "reports": "Relatórios",
       "evaluations": "Avaliações"
     },
     "filters": {

package/hedhog/table/course_class_group_material.yaml

@@ -0,0 +1,45 @@
+columns:
+  - type: pk
+  - name: course_class_group_id
+    type: fk
+    references:
+      table: course_class_group
+      column: id
+      onDelete: CASCADE
+  - name: course_class_session_id
+    type: fk
+    references:
+      table: course_class_session
+      column: id
+      onDelete: SET NULL
+    isNullable: true
+  - name: title
+    type: varchar
+    length: 255
+  - name: description
+    type: text
+    isNullable: true
+  - name: material_type
+    type: enum
+    values: [file, link]
+  - name: file_id
+    type: fk
+    isNullable: true
+    references:
+      table: file
+      column: id
+      onDelete: SET NULL
+  - name: url
+    type: varchar
+    length: 500
+    isNullable: true
+  - name: sort_order
+    type: int
+    default: 0
+  - type: created_at
+  - type: updated_at
+
+indices:
+  - columns: [course_class_group_id]
+  - columns: [course_class_session_id]
+  - columns: [material_type]

package/package.json

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

package/src/class-group/class-group.controller.ts

@@ -19,6 +19,7 @@ import {
     SaveAttendanceDto,
     UpdateStudentProfileDto,
 } from './dto/enrollment.dto';
+import { CreateMaterialDto } from './dto/material.dto';
 import { UpdateClassGroupDto } from './dto/update-class-group.dto';
 import { UpdateSessionDto } from './dto/update-session.dto';
 
@@ -186,4 +187,33 @@ export class ClassGroupController {
   ) {
     return this.classGroupService.saveAttendance(id, sessionId, dto.attendance);
   }
+
+  // ── Materials ───────────────────────────────────────────────────────────────
+
+  @Get(':id/materials')
+  listMaterials(
+    @Param('id', ParseIntPipe) id: number,
+    @Query('sessionId') sessionId?: string,
+  ) {
+    return this.classGroupService.listMaterials(
+      id,
+      sessionId ? Number(sessionId) : undefined,
+    );
+  }
+
+  @Post(':id/materials')
+  createMaterial(
+    @Param('id', ParseIntPipe) id: number,
+    @Body() dto: CreateMaterialDto,
+  ) {
+    return this.classGroupService.createMaterial(id, dto);
+  }
+
+  @Delete(':id/materials/:materialId')
+  deleteMaterial(
+    @Param('id', ParseIntPipe) id: number,
+    @Param('materialId', ParseIntPipe) materialId: number,
+  ) {
+    return this.classGroupService.deleteMaterial(id, materialId);
+  }
 }

package/src/class-group/class-group.service.ts

@@ -9,9 +9,9 @@ import { Prisma } from '@prisma/client';
 import { PrismaClientKnownRequestError } from '@prisma/client/runtime/library';
 import { randomUUID } from 'node:crypto';
 import {
-  CreateClassGroupDto,
-  type ClassGroupSessionRecurrenceDto,
-  type ClassGroupSessionTemplateDto,
+    CreateClassGroupDto,
+    type ClassGroupSessionRecurrenceDto,
+    type ClassGroupSessionTemplateDto,
 } from './dto/create-class-group.dto';
 import { CreateSessionDto, type SessionRecurrenceDto } from './dto/create-session.dto';
 import { UpdateClassGroupDto } from './dto/update-class-group.dto';
@@ -73,6 +73,19 @@ export class ClassGroupService {
           id: true,
           title: true,
           primary_color: true,
+          course_image: {
+            where: { image_type: { slug: 'course-logo' } },
+            orderBy: { order: 'asc' as const },
+            take: 1,
+            select: {
+              file_id: true,
+              file: {
+                select: {
+                  id: true,
+                },
+              },
+            },
+          },
         },
       },
       _count: {
@@ -91,6 +104,7 @@ export class ClassGroupService {
           person: {
             select: {
               name: true,
+              avatar_id: true,
             },
           },
         },
@@ -112,6 +126,7 @@ export class ClassGroupService {
               person: {
                 select: {
                   name: true,
+                  avatar_id: true,
                 },
               },
             },
@@ -550,6 +565,8 @@ export class ClassGroupService {
       item.instructorName?.trim?.() ??
       item.professorName?.trim?.() ??
       '';
+    const instructorAvatarId = item.instructor?.person?.avatar_id ?? null;
+    const courseLogo = item.course?.course_image?.[0] ?? null;
 
     return {
       id: item.id,
@@ -568,11 +585,13 @@ export class ClassGroupService {
       virtualRoomUrl: item.virtual_room_url,
       courseId: item.course_id,
       instructorId: item.instructor_id ?? item.instructor?.id ?? null,
+      instructorAvatarId,
       instructorName,
       instructor: instructorName,
       professorName: instructorName,
       professor: instructorName,
       courseTitle: item.course?.title ?? '',
+      logoFileId: courseLogo?.file?.id ?? courseLogo?.file_id ?? null,
       primaryColor: item.course?.primary_color ?? null,
       enrolledCount: item._count?.course_enrollment ?? 0,
       sessionCount: item._count?.course_class_session ?? 0,
@@ -658,6 +677,17 @@ export class ClassGroupService {
     }
   }
 
+  private async assertClassGroupExists(classGroupId: number) {
+    const exists = await this.prisma.course_class_group.findUnique({
+      where: { id: classGroupId },
+      select: { id: true },
+    });
+
+    if (!exists) {
+      throw new NotFoundException('Class group not found');
+    }
+  }
+
   // ── Students ────────────────────────────────────────────────────────────────
 
   async listStudents(classGroupId: number, search?: string) {
@@ -677,6 +707,7 @@ export class ClassGroupService {
           select: {
             id: true,
             name: true,
+            avatar_id: true,
             contact: {
               select: { value: true, contact_type: { select: { code: true } } },
             },
@@ -698,6 +729,7 @@ export class ClassGroupService {
         nome: e.person.name,
         email,
         telefone: phone,
+        avatarId: e.person.avatar_id,
         matriculadoEm: e.enrolled_at,
         progresso: e.progress_percent,
         status: e.status,
@@ -728,15 +760,17 @@ export class ClassGroupService {
     });
     if (existing) {
       if (existing.status === 'cancelled') {
-        return this.prisma.course_enrollment.update({
+        const updated = await this.prisma.course_enrollment.update({
           where: { id: existing.id },
           data: { status: 'active', enrolled_at: new Date() },
         });
+        await this.ensureEnterpriseStudent(classGroupId, personId);
+        return updated;
       }
       throw new ConflictException('Student already enrolled');
     }
 
-    return this.prisma.course_enrollment.create({
+    const enrollment = await this.prisma.course_enrollment.create({
       data: {
         person_id: personId,
         course_class_group_id: classGroupId,
@@ -745,6 +779,28 @@ export class ClassGroupService {
         enrolled_at: new Date(),
       },
     });
+    await this.ensureEnterpriseStudent(classGroupId, personId);
+    return enrollment;
+  }
+
+  private async ensureEnterpriseStudent(classGroupId: number, personId: number) {
+    const enterpriseLinks = await this.prisma.enterprise_class_group.findMany({
+      where: { course_class_group_id: classGroupId },
+      select: { enterprise_id: true },
+    });
+    if (enterpriseLinks.length === 0) return;
+
+    for (const { enterprise_id } of enterpriseLinks) {
+      const exists = await this.prisma.enterprise_student.findFirst({
+        where: { enterprise_id, person_id: personId },
+        select: { id: true },
+      });
+      if (!exists) {
+        await this.prisma.enterprise_student.create({
+          data: { enterprise_id, person_id: personId, status: 'active' },
+        });
+      }
+    }
   }
 
   async createAndEnrollStudent(
@@ -894,6 +950,7 @@ export class ClassGroupService {
           select: {
             id: true,
             name: true,
+            avatar_id: true,
             contact: {
               select: {
                 id: true,
@@ -923,6 +980,7 @@ export class ClassGroupService {
       nome: enrollment.person.name,
       email,
       telefone: phone,
+      avatarId: enrollment.person.avatar_id,
       matriculadoEm: enrollment.enrolled_at,
       progresso: enrollment.progress_percent,
       status: enrollment.status,
@@ -1120,6 +1178,7 @@ export class ClassGroupService {
       return {
         id: p.id,
         nome: p.name,
+        avatarId: p.avatar_id,
         email:
           p.contact.find((c) => this.isEmailCode(c.contact_type.code))
             ?.value ?? '',
@@ -1526,6 +1585,8 @@ export class ClassGroupService {
       instructorId: sessionInstructor?.instructor_id ?? null,
       instructorName:
         sessionInstructor?.instructor?.person?.name ?? '',
+      instructorAvatarId:
+        sessionInstructor?.instructor?.person?.avatar_id ?? null,
       recurrenceId: s.recurrence_id ?? null,
       occurrenceIndex: s.occurrence_index ?? null,
       isException: Boolean(s.is_exception),
@@ -1799,4 +1860,114 @@ export class ClassGroupService {
 
     throw error;
   }
+
+  // ── Materials ─────────────────────────────────────────────────────────────
+
+  async listMaterials(classGroupId: number, sessionId?: number) {
+    await this.assertClassGroupExists(classGroupId);
+
+    const where: any = { course_class_group_id: classGroupId };
+    if (sessionId !== undefined) {
+      where.course_class_session_id = sessionId;
+    }
+
+    return this.prisma.course_class_group_material.findMany({
+      where,
+      include: {
+        file: {
+          select: {
+            id: true,
+            filename: true,
+            path: true,
+            size: true,
+          },
+        },
+        course_class_session: {
+          select: {
+            id: true,
+            title: true,
+          },
+        },
+      },
+      orderBy: [{ sort_order: 'asc' }, { created_at: 'asc' }],
+    });
+  }
+
+  async createMaterial(
+    classGroupId: number,
+    dto: import('./dto/material.dto').CreateMaterialDto,
+  ) {
+    await this.assertClassGroupExists(classGroupId);
+
+    if (dto.sessionId) {
+      const session = await this.prisma.course_class_session.findFirst({
+        where: { id: dto.sessionId, course_class_group_id: classGroupId },
+        select: { id: true },
+      });
+      if (!session) {
+        throw new NotFoundException('Session not found for this class group');
+      }
+    }
+
+    return this.prisma.course_class_group_material.create({
+      data: {
+        course_class_group_id: classGroupId,
+        course_class_session_id: dto.sessionId ?? null,
+        title: dto.title,
+        description: dto.description ?? null,
+        material_type: dto.materialType as any,
+        file_id: dto.fileId ?? null,
+        url: dto.url ?? null,
+        sort_order: dto.sortOrder ?? 0,
+      },
+      include: {
+        file: {
+          select: {
+            id: true,
+            filename: true,
+            path: true,
+            size: true,
+          },
+        },
+      },
+    });
+  }
+
+  async deleteMaterial(classGroupId: number, materialId: number) {
+    await this.assertClassGroupExists(classGroupId);
+
+    const material = await this.prisma.course_class_group_material.findFirst({
+      where: { id: materialId, course_class_group_id: classGroupId },
+      select: { id: true },
+    });
+
+    if (!material) {
+      throw new NotFoundException('Material not found');
+    }
+
+    await this.prisma.course_class_group_material.delete({
+      where: { id: materialId },
+    });
+
+    return { success: true };
+  }
+
+  async countMaterialsBySession(classGroupId: number): Promise<Record<number, number>> {
+    const counts = await this.prisma.course_class_group_material.groupBy({
+      by: ['course_class_session_id'],
+      where: {
+        course_class_group_id: classGroupId,
+        course_class_session_id: { not: null },
+      },
+      _count: { id: true },
+    });
+
+    const result: Record<number, number> = {};
+    for (const row of counts) {
+      if (row.course_class_session_id !== null) {
+        result[row.course_class_session_id] = row._count.id;
+      }
+    }
+    return result;
+  }
 }