@hed-hog/lms 0.0.304 → 0.0.306

package/README.md

@@ -16,10 +16,135 @@ O módulo `@hed-hog/lms` é responsável pela gestão do sistema de Learning Man
 - Organização de trilhas de aprendizagem e seus passos.
 - Suporte a imagens e arquivos relacionados a cursos, exames e trilhas.
 - Avaliações e feedbacks sobre tópicos específicos do LMS.
+- Gestão de turmas (class groups), sessões e presença.
+- Administração de empresas (enterprises) e seus usuários, cursos, turmas e leads.
+- Dashboard com KPIs e estatísticas do LMS.
 
 ## 3. Endpoints
 
-> **Nota:** O código fonte fornecido não expõe endpoints REST ou GraphQL diretamente. Este módulo é consumido via serviços internos ou APIs do HedHog que integram com o LMS.
+### Certificados
+
+| Método | Path                                      | Autenticação | Descrição                                                                                      | Params/Query/Body                                                                                   | Resposta                                                                                   | Erros Comuns                              |
+|--------|-------------------------------------------|--------------|------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------|------------------------------------------|
+| GET    | /lms/certificates/templates               | Sim          | Lista templates de certificados com paginação e filtros.                                       | Query: `page` (número), `pageSize` (número), `search` (string), `status` (draft|active|inactive)   | Paginação com lista de templates e seus dados básicos.                                    | Status inválido, parâmetros inválidos     |
+| GET    | /lms/certificates/templates/:id           | Sim          | Obtém template de certificado pelo ID.                                                        | Param: `id` (número)                                                                              | Dados do template de certificado.                                                         | Template não encontrado                   |
+| POST   | /lms/certificates/templates               | Sim          | Cria um novo template de certificado.                                                         | Body: `CreateCertificateTemplateDto`                                                              | Template criado com dados completos.                                                      | JSON inválido em templateContent, slug duplicado |
+| PATCH  | /lms/certificates/templates/:id           | Sim          | Atualiza template existente.                                                                   | Param: `id` (número), Body: `UpdateCertificateTemplateDto`                                        | Template atualizado.                                                                       | Template não encontrado, JSON inválido   |
+| DELETE | /lms/certificates/templates/:id           | Sim          | Remove template de certificado pelo ID.                                                       | Param: `id` (número)                                                                              | `{ success: true }`                                                                         | Template não encontrado, restrição de exclusão |
+| POST   | /lms/certificates/templates/background-image | Sim        | Upload de imagem de fundo para template.                                                      | Form-data: campo `file` (imagem)                                                                  | Dados do arquivo enviado (id, url, filename, etc).                                       | Arquivo ausente, tipo inválido            |
+| GET    | /lms/certificates/issued                  | Sim          | Lista certificados emitidos com paginação e filtros.                                          | Query: `page`, `pageSize`, `search`, `type` (course|exam|course_class_group|learning_path)         | Paginação com lista de certificados emitidos e dados relacionados.                        | Tipo inválido                            |
+
+### Turmas (Class Groups)
+
+| Método | Path                                   | Autenticação | Descrição                                                                                      | Params/Query/Body                                                                                   | Resposta                                                                                   | Erros Comuns                              |
+|--------|----------------------------------------|--------------|------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------|------------------------------------------|
+| GET    | /lms/classes                          | Sim          | Lista turmas com paginação e filtros.                                                         | Query: `page`, `pageSize`, `search`, `status` (open|ongoing|completed|cancelled), `deliveryMode` (presential|online|hybrid), `courseId` | Paginação com lista de turmas e dados resumidos.                                         | Status ou deliveryMode inválidos          |
+| GET    | /lms/classes/stats                    | Sim          | Estatísticas gerais das turmas.                                                                | -                                                                                                 | Estatísticas como total, vagas abertas, taxa de ocupação, etc.                            | -                                        |
+| GET    | /lms/classes/:id                      | Sim          | Obtém turma pelo ID.                                                                           | Param: `id` (número)                                                                              | Dados detalhados da turma, incluindo resumo de sessões.                                  | Turma não encontrada                      |
+| POST   | /lms/classes                          | Sim          | Cria nova turma.                                                                              | Body: `CreateClassGroupDto`                                                                        | Dados da turma criada.                                                                    | Curso ou instrutor não encontrados, conflito de código |
+| PATCH  | /lms/classes/:id                      | Sim          | Atualiza turma.                                                                               | Param: `id` (número), Body: `UpdateClassGroupDto`                                                | Dados da turma atualizada.                                                                | Turma não encontrada, conflito de código |
+| DELETE | /lms/classes/:id                      | Sim          | Remove turma pelo ID.                                                                         | Param: `id` (número)                                                                              | `{ success: true }`                                                                         | Turma não encontrada                      |
+
+#### Pessoas na turma (estudantes e instrutores)
+
+| Método | Path                                   | Autenticação | Descrição                                                                                      | Params/Query/Body                                                                                   | Resposta                                                                                   | Erros Comuns                              |
+|--------|----------------------------------------|--------------|------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------|------------------------------------------|
+| GET    | /lms/classes/:id/people/search        | Sim          | Pesquisa pessoas para adicionar na turma.                                                     | Param: `id` (número), Query: `q` (string)                                                        | Lista de pessoas com flags de instrutor e matrícula.                                     | Turma não encontrada                      |
+| GET    | /lms/classes/:id/students             | Sim          | Lista estudantes matriculados na turma.                                                      | Param: `id` (número), Query: `search` (string)                                                  | Lista de estudantes com dados de contato e status.                                      | Turma não encontrada                      |
+| POST   | /lms/classes/:id/students             | Sim          | Matricula estudante existente na turma.                                                     | Param: `id` (número), Body: `{ personId: number }`                                              | Dados da matrícula criada ou atualizada.                                               | Turma ou estudante não encontrados, matrícula duplicada |
+| POST   | /lms/classes/:id/students/create      | Sim          | Cria pessoa e matricula na turma.                                                           | Param: `id` (número), Body: `CreateStudentAndEnrollDto`                                        | Dados da pessoa criada e matriculada.                                                  | Turma não encontrada, dados inválidos    |
+| GET    | /lms/classes/:id/students/:personId  | Sim          | Obtém perfil do estudante na turma.                                                        | Param: `id` (número), `personId` (número)                                                      | Dados do estudante com contatos e status.                                              | Matrícula não encontrada                  |
+| PATCH  | /lms/classes/:id/students/:personId  | Sim          | Atualiza perfil do estudante na turma.                                                     | Param: `id` (número), `personId` (número), Body: `UpdateStudentProfileDto`                      | Dados atualizados do estudante.                                                        | Matrícula não encontrada, dados inválidos |
+| DELETE | /lms/classes/:id/students/:personId  | Sim          | Remove estudante da turma (status cancelado).                                              | Param: `id` (número), `personId` (número)                                                      | `{ success: true }`                                                                       | Matrícula não encontrada                  |
+
+#### Sessões da turma
+
+| Método | Path                                   | Autenticação | Descrição                                                                                      | Params/Query/Body                                                                                   | Resposta                                                                                   | Erros Comuns                              |
+|--------|----------------------------------------|--------------|------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------|------------------------------------------|
+| GET    | /lms/classes/:id/sessions             | Sim          | Lista sessões da turma.                                                                       | Param: `id` (número)                                                                             | Lista de sessões com dados detalhados.                                                 | Turma não encontrada                      |
+| POST   | /lms/classes/:id/sessions             | Sim          | Cria sessão na turma.                                                                         | Param: `id` (número), Body: `CreateSessionDto`                                                  | Dados da sessão criada.                                                                 | Turma ou instrutor não encontrados, dados inválidos |
+| PATCH  | /lms/classes/:id/sessions/:sessionId  | Sim          | Atualiza sessão.                                                                             | Param: `id` (número), `sessionId` (número), Body: `UpdateSessionDto`                            | Dados da sessão atualizada.                                                             | Sessão não encontrada, dados inválidos   |
+| DELETE | /lms/classes/:id/sessions/:sessionId  | Sim          | Remove sessão.                                                                               | Param: `id` (número), `sessionId` (número), Query: `scope` = `single` ou `series`                | `{ success: true }`                                                                       | Sessão não encontrada                      |
+
+#### Presença em sessões
+
+| Método | Path                                           | Autenticação | Descrição                                                                                      | Params/Query/Body                                                                                   | Resposta                                                                                   | Erros Comuns                              |
+|--------|------------------------------------------------|--------------|------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------|------------------------------------------|
+| GET    | /lms/classes/:id/sessions/:sessionId/attendance | Sim          | Obtém lista de presenças na sessão.                                                          | Param: `id` (número), `sessionId` (número)                                                      | Lista de presenças com dados do estudante e status de presença.                          | Sessão não encontrada                      |
+| POST   | /lms/classes/:id/sessions/:sessionId/attendance | Sim          | Salva presenças.                                                                             | Param: `id` (número), `sessionId` (número), Body: `SaveAttendanceDto`                           | `{ success: true }`                                                                       | Sessão não encontrada                      |
+
+### Cursos
+
+| Método | Path                  | Autenticação | Descrição                                                                                      | Params/Query/Body                                                                                   | Resposta                                                                                   | Erros Comuns                              |
+|--------|-----------------------|--------------|------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------|------------------------------------------|
+| GET    | /lms/courses          | Sim          | Lista cursos com paginação e filtros.                                                        | Query: `page`, `pageSize`, `search`, `status` (draft|published|archived), `level` (beginner|intermediate|advanced), `category` (slug) | Paginação com lista de cursos e dados resumidos.                                        | Status ou level inválidos                  |
+| GET    | /lms/courses/stats    | Sim          | Estatísticas gerais dos cursos.                                                               | -                                                                                                 | KPIs como total, publicados, estudantes, etc.                                           | -                                        |
+| GET    | /lms/courses/:id      | Sim          | Obtém curso pelo ID.                                                                          | Param: `id` (número)                                                                              | Dados detalhados do curso, incluindo módulos, aulas e instrutores.                      | Curso não encontrado                      |
+| POST   | /lms/courses          | Sim          | Cria novo curso.                                                                             | Body: `CreateCourseDto`                                                                           | Dados do curso criado.                                                                   | Dados inválidos, slug duplicado           |
+| PATCH  | /lms/courses/:id      | Sim          | Atualiza curso.                                                                              | Param: `id` (número), Body: `UpdateCourseDto`                                                   | Dados do curso atualizado.                                                              | Curso não encontrado, dados inválidos     |
+| DELETE | /lms/courses/:id      | Sim          | Remove curso pelo ID.                                                                        | Param: `id` (número)                                                                              | `{ success: true }`                                                                       | Curso não encontrado                      |
+
+### Estrutura do curso
+
+| Método | Path                                         | Autenticação | Descrição                                                                                      | Params/Query/Body                                                                                   | Resposta                                                                                   | Erros Comuns                              |
+|--------|----------------------------------------------|--------------|------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------|------------------------------------------|
+| GET    | /lms/courses/:id/structure                   | Sim          | Obtém estrutura do curso (módulos e aulas).                                                  | Param: `id` (número)                                                                              | Estrutura com sessões (módulos) e aulas detalhadas.                                      | Curso não encontrado                      |
+| POST   | /lms/courses/:id/structure/sessions          | Sim          | Cria módulo (sessão) no curso.                                                               | Param: `id` (número), Body: `CreateCourseStructureSessionDto`                                   | Dados do módulo criado.                                                                  | Curso não encontrado, dados inválidos     |
+| PATCH  | /lms/courses/:id/structure/sessions/:sessionId | Sim        | Atualiza módulo.                                                                             | Param: `id` (número), `sessionId` (número), Body: `UpdateCourseStructureSessionDto`             | Dados do módulo atualizado.                                                             | Módulo não encontrado                     |
+| DELETE | /lms/courses/:id/structure/sessions/:sessionId | Sim        | Remove módulo.                                                                              | Param: `id` (número), `sessionId` (número)                                                     | `{ success: true }`                                                                       | Módulo não encontrado                     |
+| POST   | /lms/courses/:id/structure/sessions/:sessionId/lessons | Sim | Cria aula no módulo.                                                                         | Param: `id` (número), `sessionId` (número), Body: `CreateCourseStructureLessonDto`             | Dados da aula criada.                                                                    | Módulo não encontrado, dados inválidos    |
+| PATCH  | /lms/courses/:id/structure/sessions/:sessionId/lessons/:lessonId | Sim | Atualiza aula.                                                                             | Param: `id` (número), `sessionId` (número), `lessonId` (número), Body: `UpdateCourseStructureLessonDto` | Dados da aula atualizada.                                                                | Aula não encontrada                       |
+| DELETE | /lms/courses/:id/structure/sessions/:sessionId/lessons/:lessonId | Sim | Remove aula.                                                                              | Param: `id` (número), `sessionId` (número), `lessonId` (número)                               | `{ success: true }`                                                                       | Aula não encontrada                       |
+
+### Exames (tentativas)
+
+| Método | Path                                         | Autenticação | Descrição                                                                                      | Params/Query/Body                                                                                   | Resposta                                                                                   | Erros Comuns                              |
+|--------|----------------------------------------------|--------------|------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------|------------------------------------------|
+| GET    | /lms/exams/:id/attempt                        | Sim          | Obtém estado da tentativa de exame para usuário.                                              | Param: `id` (número), Query opcional: `studentId` (número)                                       | Estado atual da tentativa ou nulo.                                                      | Exame não encontrado                      |
+| POST   | /lms/exams/:id/attempt/start                  | Sim          | Inicia tentativa de exame.                                                                   | Param: `id` (número), Body: `StartExamAttemptDto`                                                | Dados da tentativa iniciada.                                                           | Exame não encontrado                      |
+| PATCH  | /lms/exams/:id/attempt/:attemptId/answers    | Sim          | Salva respostas da tentativa.                                                                | Param: `id` (número), `attemptId` (número), Body: `SaveExamAttemptAnswersDto`                    | Dados atualizados da tentativa.                                                       | Tentativa não encontrada                  |
+| POST   | /lms/exams/:id/attempt/:attemptId/submit     | Sim          | Submete tentativa de exame.                                                                  | Param: `id` (número), `attemptId` (número), Body: `SubmitExamAttemptDto`                         | Resultado da submissão.                                                               | Tentativa não encontrada                  |
+
+### Dashboard
+
+| Método | Path            | Autenticação | Descrição                                                                                      | Params/Query/Body | Resposta                                                                                   | Erros Comuns |
+|--------|-----------------|--------------|------------------------------------------------------------------------------------------------|------------------|--------------------------------------------------------------------------------------------|--------------|
+| GET    | /lms/dashboard  | Sim          | Obtém dados do dashboard do LMS com KPIs, gráficos, eventos, matrículas recentes e próximas turmas. | Header: `accept-language` (opcional) | Dados agregados para dashboard do LMS.                                                  | -            |
+
+### Enterprise (Empresas)
+
+| Método | Path                         | Autenticação | Descrição                                                                                      | Params/Query/Body                                                                                   | Resposta                                                                                   | Erros Comuns                              |
+|--------|------------------------------|--------------|------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------|------------------------------------------|
+| GET    | /lms/enterprise              | Sim          | Lista empresas com paginação e filtros.                                                      | Query: `page`, `pageSize`, `search`, `status`, `crmPersonId`                                     | Paginação com lista de empresas.                                                        | -                                        |
+| POST   | /lms/enterprise              | Sim          | Cria nova empresa.                                                                           | Body: `CreateEnterpriseDto`                                                                       | Dados da empresa criada.                                                                | Dados inválidos                          |
+| GET    | /lms/enterprise/:id          | Sim          | Obtém empresa pelo ID.                                                                       | Param: `id` (número)                                                                              | Dados da empresa.                                                                       | Empresa não encontrada                   |
+| PATCH  | /lms/enterprise/:id          | Sim          | Atualiza empresa.                                                                            | Param: `id` (número), Body: `UpdateEnterpriseDto`                                               | Dados da empresa atualizada.                                                           | Empresa não encontrada                   |
+| DELETE | /lms/enterprise/:id          | Sim          | Remove empresa pelo ID.                                                                      | Param: `id` (número)                                                                              | `{ success: true }`                                                                       | Empresa não encontrada                   |
+
+#### Usuários da empresa
+
+| Método | Path                         | Autenticação | Descrição                                                                                      | Params/Query/Body                                                                                   | Resposta                                                                                   | Erros Comuns                              |
+|--------|------------------------------|--------------|------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------|------------------------------------------|
+| GET    | /lms/enterprise/:id/users    | Sim          | Lista usuários da empresa com paginação e filtro.                                            | Param: `id` (número), Query: `page`, `pageSize`, `search`                                        | Paginação com lista de usuários.                                                        | Empresa não encontrada                   |
+| POST   | /lms/enterprise/:id/users    | Sim          | Adiciona usuário à empresa.                                                                  | Param: `id` (número), Body: `AddEnterpriseUserDto`                                              | Dados do usuário adicionado.                                                           | Empresa não encontrada, dados inválidos  |
+| PATCH  | /lms/enterprise/:id/users/:userId | Sim      | Atualiza usuário da empresa.                                                                 | Param: `id` (número), `userId` (número), Body: `UpdateEnterpriseUserDto`                        | Dados do usuário atualizado.                                                           | Usuário ou empresa não encontrados       |
+| DELETE | /lms/enterprise/:id/users/:userId | Sim      | Remove usuário da empresa.                                                                   | Param: `id` (número), `userId` (número)                                                        | `{ success: true }`                                                                       | Usuário ou empresa não encontrados       |
+
+#### Cursos da empresa
+
+| Método | Path                         | Autenticação | Descrição                                                                                      | Params/Query/Body                                                                                   | Resposta                                                                                   | Erros Comuns                              |
+|--------|------------------------------|--------------|------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------|------------------------------------------|
+| GET    | /lms/enterprise/:id/courses  | Sim          | Lista cursos da empresa com paginação e filtro.                                              | Param: `id` (número), Query: `page`, `pageSize`, `search`                                        | Paginação com lista de cursos.                                                          | Empresa não encontrada                   |
+| POST   | /lms/enterprise/:id/courses  | Sim          | Adiciona curso à empresa.                                                                    | Param: `id` (número), Body: `AddEnterpriseCourseDto`                                            | Dados do curso adicionado.                                                             | Empresa não encontrada, dados inválidos  |
+| DELETE | /lms/enterprise/:id/courses/:courseId | Sim    | Remove curso da empresa.                                                                     | Param: `id` (número), `courseId` (número)                                                      | `{ success: true }`                                                                       | Curso ou empresa não encontrados         |
+
+#### Turmas da empresa
+
+| Método | Path                         | Autenticação | Descrição                                                                                      | Params/Query/Body                                                                                   | Resposta                                                                                   | Erros Comuns                              |
+|--------|------------------------------|--------------|------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------|------------------------------------------|
+| GET    | /lms/enterprise/:id/classes  | Sim          | Lista turmas da empresa com paginação e filtro.                                              | Param: `id` (número), Query: `page`, `pageSize`, `search`                                        | Paginação com lista de turmas.                                                          | Empresa não encontrada                   |
+| POST   | /lms/enterprise/:id/classes  | Sim          | Adiciona turma à empresa.                                                                    | Param: `id` (número), Body: `AddEnterpriseClassGroupDto`                                        | Dados da turma adicionada.                                                             | Empresa não encontrada, dados inválidos  |
+| DELETE | /lms/enterprise/:id/classes/:classGroupId | Sim | Remove turma da empresa.                                                                     | Param: `id` (número), `classGroupId` (número)                                                  | `{ success: true }`                                                                       | Turma ou empresa não encontrados         |
 
 ## 4. Regras de autenticação e autorização
 
@@ -29,8 +154,212 @@ O módulo `@hed-hog/lms` é responsável pela gestão do sistema de Learning Man
 
 ## 5. Estruturas de request/response
 
-- Não aplicável diretamente, pois o módulo não expõe endpoints REST no código fornecido.
-- Operações são realizadas via serviços internos ou APIs que consomem este módulo.
+### Exemplos principais de DTOs usados nos endpoints
+
+- **CreateCertificateTemplateDto**
+
+  ```ts
+  {
+    name: string; // obrigatório, max 255
+    slug?: string; // opcional, max 255
+    description?: string; // opcional
+    templateContent: string; // obrigatório, JSON válido
+    status?: 'draft' | 'active' | 'inactive'; // opcional
+  }
+  ```
+
+- **CreateClassGroupDto**
+
+  ```ts
+  {
+    code: string; // obrigatório, max 50
+    courseId: number; // obrigatório
+    instructorId?: number; // opcional
+    title: string; // obrigatório, max 255
+    description?: string; // opcional
+    deliveryMode: 'presential' | 'online' | 'hybrid'; // obrigatório
+    status?: 'open' | 'ongoing' | 'completed' | 'cancelled'; // opcional
+    startDate: string; // obrigatório, ISO8601
+    endDate?: string; // opcional, ISO8601
+    startTime?: string; // opcional, formato HH:mm
+    endTime?: string; // opcional, formato HH:mm
+    weekDays?: string; // opcional
+    capacity?: number; // opcional, mínimo 1
+    location?: string; // opcional
+    virtualRoomUrl?: string; // opcional, URL
+    sessionTemplate?: {
+      title: string;
+      description?: string;
+      location?: string;
+      meetingUrl?: string;
+      color?: string; // formato #RRGGBB
+      recurrence?: {
+        frequency: 'daily' | 'weekly' | 'monthly' | 'yearly';
+        interval?: number;
+        until: string; // ISO8601
+        daysOfWeek?: Array<'MO' | 'TU' | 'WE' | 'TH' | 'FR' | 'SA' | 'SU'>;
+      };
+    };
+  }
+  ```
+
+- **EnrollStudentDto**
+
+  ```ts
+  {
+    personId: number; // obrigatório
+  }
+  ```
+
+- **SaveAttendanceDto**
+
+  ```ts
+  {
+    attendance: Array<{
+      studentId: number; // obrigatório
+      present: boolean; // obrigatório
+      justification?: string; // opcional
+    }>;
+  }
+  ```
+
+- **CreateCourseDto**
+
+  ```ts
+  {
+    code?: string; // opcional, max 32
+    slug: string; // obrigatório, max 255
+    title?: string; // opcional, max 255
+    description?: string; // opcional
+    requirements?: string; // opcional
+    objectives?: string; // opcional
+    targetAudience?: string; // opcional
+    durationHours?: number; // opcional
+    certificateWorkload?: number; // opcional
+    level?: 'beginner' | 'intermediate' | 'advanced'; // opcional
+    status?: 'draft' | 'published' | 'archived'; // opcional
+    offeringType?: 'scheduled' | 'on_demand' | 'blended'; // opcional
+    isFeatured?: boolean; // opcional
+    hasCertificate?: boolean; // opcional
+    isListed?: boolean; // opcional
+    primaryColor?: string; // opcional, formato #RRGGBB
+    primaryContrastColor?: string; // opcional, formato #RRGGBB
+    secondaryColor?: string; // opcional, formato #RRGGBB
+    secondaryContrastColor?: string; // opcional, formato #RRGGBB
+    categorySlugs?: string[]; // opcional
+    instructorIds?: number[]; // opcional
+    logoFileId?: number; // opcional
+    bannerFileId?: number; // opcional
+  }
+  ```
+
+- **CreateCourseStructureLessonDto**
+
+  ```ts
+  {
+    codigo?: string; // opcional, max 32
+    titulo: string; // obrigatório, max 255
+    descricaoPublica?: string; // opcional
+    descricaoPrivada?: string; // opcional
+    tipo: 'video' | 'questao' | 'post' | 'exercicio'; // obrigatório
+    duracao: number; // obrigatório, minutos
+    videoProvedor?: 'youtube' | 'vimeo' | 'bunny' | 'custom'; // opcional
+    videoUrl?: string; // opcional
+    duracaoAutomatica?: boolean; // opcional
+    transcricao?: string; // opcional
+    exameVinculado?: number; // opcional
+    conteudoPost?: string; // opcional
+    instructorIds?: number[]; // opcional
+    recursos?: Array<{
+      nome: string; // obrigatório
+      fileId?: number; // opcional
+      tipo?: string; // opcional
+      publico?: boolean; // opcional
+    }>;
+  }
+  ```
+
+- **CreateSessionDto**
+
+  ```ts
+  {
+    title: string; // obrigatório, max 255
+    description?: string; // opcional
+    sessionDate: string; // obrigatório, ISO8601
+    startTime: string; // obrigatório, formato HH:mm
+    endTime: string; // obrigatório, formato HH:mm
+    location?: string; // opcional
+    meetingUrl?: string; // opcional, max 500
+    color?: string; // opcional, formato #RRGGBB
+    status?: 'scheduled' | 'completed' | 'cancelled'; // opcional
+    instructorId?: number; // opcional
+    recurrence?: {
+      frequency: 'daily' | 'weekly' | 'monthly' | 'yearly';
+      interval?: number;
+      until: string; // ISO8601
+      daysOfWeek?: Array<'MO' | 'TU' | 'WE' | 'TH' | 'FR' | 'SA' | 'SU'>;
+    }; // opcional
+  }
+  ```
+
+- **StartExamAttemptDto**
+
+  ```ts
+  {
+    studentId?: number; // opcional
+  }
+  ```
+
+- **SaveExamAttemptAnswersDto**
+
+  ```ts
+  {
+    answers: Array<{
+      questionId: number;
+      examOptionId?: number | null;
+      answerText?: string | null;
+      matchingPairs?: Array<{
+        leftId: string;
+        rightId: string;
+      }>;
+    }>;
+  }
+  ```
+
+- **SubmitExamAttemptDto**
+
+  Extende `SaveExamAttemptAnswersDto` com:
+
+  ```ts
+  {
+    force?: boolean; // opcional
+  }
+  ```
+
+- **CreateEnterpriseDto**
+
+  ```ts
+  {
+    name: string; // obrigatório, max 255
+    slug?: string; // opcional, max 255
+    status?: 'active' | 'trial' | 'inactive' | 'suspended'; // opcional
+    crmPersonId?: number | null; // opcional
+    portalEnabled?: boolean; // opcional
+    licenseLimit?: number | null; // opcional
+    notes?: string; // opcional
+  }
+  ```
+
+- **AddEnterpriseUserDto**
+
+  ```ts
+  {
+    userId: number; // obrigatório
+    personId?: number | null; // opcional
+    role: 'student' | 'hr_manager' | 'enterprise_admin' | 'viewer'; // obrigatório
+    status?: 'active' | 'inactive' | 'pending'; // opcional
+  }
+  ```
 
 ## 6. Erros comuns
 
@@ -38,16 +367,23 @@ O módulo `@hed-hog/lms` é responsável pela gestão do sistema de Learning Man
 - **Duplicidade de registros únicos:** como códigos únicos de certificado, slugs de cursos ou templates.
 - **Status inválidos:** ao definir valores fora dos enums para status de cursos, exames, matrículas, etc.
 - **Campos obrigatórios ausentes:** como títulos, slugs e chaves primárias.
+- **Datas ou horários inválidos:** datas mal formatadas ou horários inconsistentes (ex: hora fim antes da hora início).
+- **Tentativa de matrícula duplicada:** ao tentar matricular estudante já matriculado ativo.
+- **Arquivo inválido no upload:** ao enviar arquivo não-imagem para upload de background de template.
+- **Entidades não encontradas:** ao referenciar IDs inexistentes (curso, turma, sessão, usuário, etc).
+- **Conflito de código:** ao tentar criar ou atualizar turma com código já existente.
 
 ## 7. Banco de dados (tabelas YAML)
 
+> Abaixo estão as principais tabelas do módulo LMS com suas finalidades e detalhes.
+
 ### certificate
 
 - **Finalidade:** Armazena certificados emitidos para estudantes em cursos, exames, grupos de aulas ou trilhas de aprendizagem.
 - **Colunas:**
   - `id` (PK)
   - `verification_code` (varchar 50, único): código para verificação do certificado.
-  - `student_id` (FK para `person.id`, onDelete CASCADE): estudante que recebeu o certificado.
+  - `student_id` (FK para `person.id`, onDelete CASCADE)
   - `course_enrollment_id` (FK opcional para `course_enrollment.id`, onDelete SET NULL)
   - `course_id` (FK opcional para `course.id`, onDelete SET NULL)
   - `exam_id` (FK opcional para `exam.id`, onDelete SET NULL)
@@ -64,9 +400,9 @@ O módulo `@hed-hog/lms` é responsável pela gestão do sistema de Learning Man
   - `verification_url` (varchar 500, nullable)
   - `pdf_url` (varchar 500, nullable)
   - `created_at`, `updated_at`
-- **Defaults:** Não possui defaults além dos timestamps.
-- **Nulabilidade:** Campos opcionais indicados.
-- **Integridade:** Chaves estrangeiras com regras onDelete conforme descrito.
+- **Defaults:** timestamps automáticos.
+- **Nulabilidade:** campos opcionais indicados.
+- **Integridade:** chaves estrangeiras com regras onDelete conforme descrito.
 - **Índices:** único em `verification_code`.
 
 ### certificate_template
@@ -85,57 +421,6 @@ O módulo `@hed-hog/lms` é responsável pela gestão do sistema de Learning Man
 - **Integridade:** -
 - **Índices:** único em `slug`.
 
-### course
-
-- **Finalidade:** Cursos disponíveis no LMS.
-- **Colunas:**
-  - `id` (PK)
-  - `title` (varchar 255)
-  - `slug` (varchar 255, único)
-  - `description` (text, nullable)
-  - `short_description` (varchar 500, nullable)
-  - `level` (enum: `beginner`, `intermediate`, `advanced`, default `beginner`)
-  - `duration_hours` (int, default 0)
-  - `status` (enum: `draft`, `published`, `archived`, default `draft`)
-  - `primary_color`, `primary_contrast_color`, `secondary_color`, `secondary_contrast_color` (varchar 9, nullable)
-  - `certificate_workload` (int, nullable)
-  - `certificate_template_id` (FK opcional para `certificate_template.id`, onDelete SET NULL)
-  - `requirements`, `objectives`, `target_audience` (text, nullable)
-  - `created_at`, `updated_at`
-- **Defaults:** `level` default `beginner`, `duration_hours` default 0, `status` default `draft`.
-- **Nulabilidade:** Campos opcionais indicados.
-- **Integridade:** FK para `certificate_template` com onDelete SET NULL.
-- **Índices:** único em `slug`.
-
-### course_category
-
-- **Finalidade:** Associação entre cursos e categorias.
-- **Colunas:**
-  - `id` (PK)
-  - `course_id` (FK para `course.id`, onDelete CASCADE)
-  - `category_id` (FK para `category.id`, onDelete CASCADE)
-  - `created_at`, `updated_at`
-- **Defaults:** -
-- **Nulabilidade:** -
-- **Integridade:** FK com onDelete CASCADE.
-- **Índices:** único em combinação `course_id` + `category_id`.
-
-### course_class_attendance
-
-- **Finalidade:** Registro de presença dos estudantes em sessões de aula.
-- **Colunas:**
-  - `id` (PK)
-  - `course_class_session_id` (FK para `course_class_session.id`, onDelete CASCADE)
-  - `student_id` (FK para `person.id`, onDelete CASCADE)
-  - `present` (boolean, default false)
-  - `justification` (text, nullable)
-  - `recorded_by_id` (FK opcional para `person.id`, onDelete SET NULL)
-  - `created_at`, `updated_at`
-- **Defaults:** `present` default false.
-- **Nulabilidade:** `justification` e `recorded_by_id` opcionais.
-- **Integridade:** FK com onDelete conforme descrito.
-- **Índices:** único em combinação `course_class_session_id` + `student_id`.
-
 ### course_class_group
 
 - **Finalidade:** Grupos de aulas de um curso.
@@ -157,7 +442,7 @@ O módulo `@hed-hog/lms` é responsável pela gestão do sistema de Learning Man
   - `virtual_room_url` (varchar 500, nullable)
   - `created_at`, `updated_at`
 - **Defaults:** `status` default `open`, `capacity` default 30.
-- **Nulabilidade:** Campos opcionais indicados.
+- **Nulabilidade:** campos opcionais indicados.
 - **Integridade:** FK com onDelete CASCADE.
 - **Índices:** único em `code`.
 
@@ -175,25 +460,17 @@ O módulo `@hed-hog/lms` é responsável pela gestão do sistema de Learning Man
   - `location` (text, nullable)
   - `meeting_url` (varchar 500, nullable)
   - `status` (enum: `scheduled`, `completed`, `cancelled`, default `scheduled`)
-  - `created_at`, `updated_at`
-- **Defaults:** `status` default `scheduled`.
-- **Nulabilidade:** Campos opcionais indicados.
+  - `recurrence_id` (uuid, nullable)
+  - `recurrence_rule` (text, nullable)
+  - `occurrence_index` (int, nullable)
+  - `is_exception` (boolean, default false)
+  - `parent_session_id` (FK opcional para `course_class_session.id`, onDelete SET NULL)
+  - `created_at`, `updated_at`
+- **Defaults:** `status` default `scheduled`, `is_exception` default false.
+- **Nulabilidade:** campos opcionais indicados.
 - **Integridade:** FK com onDelete CASCADE.
 - **Índices:** combinação `course_class_group_id` + `session_date`.
 
-### course_class_session_instructor
-
-- **Finalidade:** Instrutores vinculados a sessões de aula.
-- **Colunas:**
-  - `id` (PK)
-  - `course_class_session_id` (FK para `course_class_session.id`, onDelete CASCADE)
-  - `instructor_id` (FK para `instructor.id`, onDelete CASCADE)
-  - `role` (enum: `lead`, `assistant`, default `assistant`)
-  - `created_at`, `updated_at`
-- **Defaults:** `role` default `assistant`.
-- **Integridade:** FK com onDelete CASCADE.
-- **Índices:** único em combinação `course_class_session_id` + `instructor_id`.
-
 ### course_enrollment
 
 - **Finalidade:** Matrículas de pessoas em cursos ou grupos de aula.
@@ -209,292 +486,30 @@ O módulo `@hed-hog/lms` é responsável pela gestão do sistema de Learning Man
   - `final_score` (int, nullable)
   - `created_at`, `updated_at`
 - **Defaults:** `status` default `active`, `progress_percent` default 0.
-- **Nulabilidade:** Campos opcionais indicados.
+- **Nulabilidade:** campos opcionais indicados.
 - **Integridade:** FK com onDelete conforme descrito.
 - **Índices:** único em combinação `person_id` + `course_class_group_id`.
 
-### course_image
-
-- **Finalidade:** Imagens associadas a cursos.
-- **Colunas:**
-  - `id` (PK)
-  - `course_id` (FK para `course.id`, onDelete CASCADE)
-  - `file_id` (FK para `file.id`, onDelete CASCADE)
-  - `image_type_id` (FK para `image_type.id`, onDelete CASCADE)
-  - `order` (int)
-  - `is_primary` (boolean, default false)
-  - `created_at`, `updated_at`
-- **Defaults:** `is_primary` default false.
-- **Integridade:** FK com onDelete CASCADE.
-- **Índices:** único em combinação `course_id` + `image_type_id` + `order`.
-
-### course_lesson
-
-- **Finalidade:** Aulas dentro de módulos de curso.
-- **Colunas:**
-  - `id` (PK)
-  - `course_module_id` (FK para `course_module.id`, onDelete CASCADE)
-  - `title` (varchar 255)
-  - `description` (text, nullable)
-  - `type` (enum: `video`, `text`, `quiz`, default `video`)
-  - `content` (text, nullable)
-  - `duration_seconds` (int, default 0)
-  - `order` (int)
-  - `is_released` (boolean, default true)
-  - `created_at`, `updated_at`
-- **Defaults:** `type` default `video`, `duration_seconds` default 0, `is_released` default true.
-- **Integridade:** FK com onDelete CASCADE.
-- **Índices:** único em combinação `course_module_id` + `order`.
-
-### course_lesson_file
-
-- **Finalidade:** Arquivos vinculados a aulas.
-- **Colunas:**
-  - `id` (PK)
-  - `course_lesson_id` (FK para `course_lesson.id`, onDelete CASCADE)
-  - `file_id` (FK opcional para `file.id`, onDelete SET NULL)
-  - `title` (varchar 255)
-  - `created_at`, `updated_at`
-- **Nulabilidade:** `file_id` opcional.
-- **Integridade:** FK com onDelete conforme descrito.
-- **Índices:** em `course_lesson_id`.
-
-### course_lesson_instructor
-
-- **Finalidade:** Instrutores vinculados a aulas.
-- **Colunas:**
-  - `id` (PK)
-  - `course_lesson_id` (FK para `course_lesson.id`, onDelete CASCADE)
-  - `instructor_id` (FK para `instructor.id`, onDelete CASCADE)
-  - `role` (enum: `lead`, `assistant`, default `assistant`)
-  - `created_at`, `updated_at`
-- **Defaults:** `role` default `assistant`.
-- **Integridade:** FK com onDelete CASCADE.
-- **Índices:** único em combinação `course_lesson_id` + `instructor_id`.
-
-### course_lesson_progress
-
-- **Finalidade:** Progresso dos estudantes em aulas.
-- **Colunas:**
-  - `id` (PK)
-  - `course_enrollment_id` (FK para `course_enrollment.id`, onDelete CASCADE)
-  - `course_lesson_id` (FK para `course_lesson.id`, onDelete CASCADE)
-  - `status` (enum: `not_started`, `in_progress`, `completed`, default `not_started`)
-  - `progress_percent` (int, default 0)
-  - `video_progress_seconds` (int, default 0)
-  - `started_at` (datetime, nullable)
-  - `completed_at` (datetime, nullable)
-  - `time_spent_seconds` (int, default 0)
-  - `created_at`, `updated_at`
-- **Defaults:** `status` default `not_started`, `progress_percent` default 0, `video_progress_seconds` default 0, `time_spent_seconds` default 0.
-- **Nulabilidade:** `started_at` e `completed_at` opcionais.
-- **Integridade:** FK com onDelete CASCADE.
-- **Índices:** único em combinação `course_enrollment_id` + `course_lesson_id`.
-
-### course_lesson_question
-
-- **Finalidade:** Questões associadas a aulas do tipo quiz.
-- **Colunas:**
-  - `id` (PK)
-  - `course_lesson_id` (FK para `course_lesson.id`, onDelete CASCADE)
-  - `question_id` (FK para `question.id`, onDelete CASCADE)
-  - `order` (int)
-  - `created_at`, `updated_at`
-- **Integridade:** FK com onDelete CASCADE.
-- **Índices:** únicos em combinações `course_lesson_id` + `question_id` e `course_lesson_id` + `order`.
-
-### course_module
-
-- **Finalidade:** Módulos dentro de cursos.
-- **Colunas:**
-  - `id` (PK)
-  - `course_id` (FK para `course.id`, onDelete CASCADE)
-  - `title` (varchar 255)
-  - `description` (text, nullable)
-  - `order` (int)
-  - `duration_minutes` (int, default 0)
-  - `created_at`, `updated_at`
-- **Defaults:** `duration_minutes` default 0.
-- **Integridade:** FK com onDelete CASCADE.
-- **Índices:** único em combinação `course_id` + `order`.
-
-### course_prerequisite
-
-- **Finalidade:** Pré-requisitos para cursos.
-- **Colunas:**
-  - `id` (PK)
-  - `course_id` (FK para `course.id`, onDelete CASCADE)
-  - `prerequisite_type` (enum: `course`, `learning_path`, `exam`, default `course`)
-  - `prerequisite_course_id` (FK opcional para `course.id`, onDelete CASCADE)
-  - `prerequisite_learning_path_id` (FK opcional para `learning_path.id`, onDelete CASCADE)
-  - `prerequisite_exam_id` (FK opcional para `exam.id`, onDelete CASCADE)
-  - `created_at`, `updated_at`
-- **Defaults:** `prerequisite_type` default `course`.
-- **Integridade:** FK com onDelete CASCADE.
-- **Índices:** únicos para combinações de curso e pré-requisitos.
-
-### evaluation_rating
-
-- **Finalidade:** Avaliações e notas dadas a tópicos de avaliação.
-- **Colunas:**
-  - `id` (PK)
-  - `evaluation_topic_id` (FK para `evaluation_topic.id`, onDelete CASCADE)
-  - `evaluator_id` (FK opcional para `person.id`, onDelete SET NULL)
-  - `score` (decimal 2,1)
-  - `comment` (text, nullable)
-  - `created_at`, `updated_at`
-- **Nulabilidade:** `evaluator_id` e `comment` opcionais.
-- **Integridade:** FK com onDelete conforme descrito.
-- **Índices:** único em combinação `evaluation_topic_id` + `evaluator_id`.
-
-### evaluation_topic
-
-- **Finalidade:** Tópicos para avaliação dentro do LMS.
-- **Colunas:**
-  - `id` (PK)
-  - `name` (varchar 255)
-  - `description` (text, nullable)
-  - `target_type` (enum: `course`, `course_lesson`, `course_class_session`, `question`, `exam`)
-  - `course_id` (FK opcional para `course.id`, onDelete SET NULL)
-  - `course_lesson_id` (FK opcional para `course_lesson.id`, onDelete SET NULL)
-  - `course_class_session_id` (FK opcional para `course_class_session.id`, onDelete SET NULL)
-  - `question_id` (FK opcional para `question.id`, onDelete SET NULL)
-  - `exam_id` (FK opcional para `exam.id`, onDelete SET NULL)
-  - `order` (int)
-  - `is_active` (boolean, default true)
-  - `created_at`, `updated_at`
-- **Defaults:** `is_active` default true.
-- **Nulabilidade:** Campos opcionais indicados.
-- **Integridade:** FK com onDelete SET NULL.
-- **Índices:** únicos para combinações de alvo e ordem.
-
-### exam
+### course
 
-- **Finalidade:** Exames vinculados a cursos ou grupos de aula.
+- **Finalidade:** Cursos disponíveis no LMS.
 - **Colunas:**
   - `id` (PK)
-  - `course_id` (FK opcional para `course.id`, onDelete SET NULL)
-  - `course_class_group_id` (FK opcional para `course_class_group.id`, onDelete SET NULL)
   - `title` (varchar 255)
+  - `slug` (varchar 255, único)
   - `description` (text, nullable)
-  - `instructions` (text, nullable)
-  - `exam_type` (enum: `quiz`, `test`, `assignment`, `project`)
-  - `status` (enum: `draft`, `published`, `closed`, `archived`, default `draft`)
+  - `short_description` (varchar 500, nullable)
+  - `level` (enum: `beginner`, `intermediate`, `advanced`, default `beginner`)
+  - `duration_hours` (int, default 0)
+  - `status` (enum: `draft`, `published`, `archived`, default `draft`)
   - `primary_color`, `primary_contrast_color`, `secondary_color`, `secondary_contrast_color` (varchar 9, nullable)
-  - `starts_at` (datetime, nullable)
-  - `ends_at` (datetime, nullable)
-  - `time_limit_minutes` (int, nullable)
-  - `attempts_allowed` (int, default 1)
-  - `min_score` (int, default 60)
-  - `max_score` (int, default 100)
-  - `shuffle_questions` (boolean, default false)
-  - `shuffle_options` (boolean, default false)
-  - `show_result` (boolean, default true)
-  - `show_answer_key` (boolean, default false)
-  - `show_explanation_after_answer` (boolean, default false)
-  - `require_all_questions_answered_to_finish` (boolean, default false)
-  - `created_at`, `updated_at`
-- **Defaults:** `status` default `draft`, `attempts_allowed` 1, `min_score` 60, `max_score` 100, boolean flags default conforme descrito.
-- **Nulabilidade:** Campos opcionais indicados.
-- **Integridade:** FK com onDelete SET NULL.
-- **Índices:** em `course_id`, `course_class_group_id` e `status`.
-
-### exam_answer
-
-- **Finalidade:** Respostas dadas em tentativas de exame.
-- **Colunas:**
-  - `id` (PK)
-  - `exam_attempt_id` (FK para `exam_attempt.id`, onDelete CASCADE)
-  - `question_id` (FK para `question.id`, onDelete CASCADE)
-  - `exam_option_id` (FK opcional para `exam_option.id`, onDelete SET NULL)
-  - `answer_text` (text, nullable)
-  - `is_correct` (boolean, nullable)
-  - `points_awarded` (int, default 0)
-  - `teacher_feedback` (text, nullable)
-  - `created_at`, `updated_at`
-- **Defaults:** `points_awarded` default 0.
-- **Nulabilidade:** Campos opcionais indicados.
-- **Integridade:** FK com onDelete conforme descrito.
-- **Índices:** único em combinação `exam_attempt_id` + `question_id`.
-
-### exam_attempt
-
-- **Finalidade:** Tentativas de realização de exames por estudantes.
-- **Colunas:**
-  - `id` (PK)
-  - `exam_id` (FK para `exam.id`, onDelete CASCADE)
-  - `student_id` (FK para `person.id`, onDelete CASCADE)
-  - `course_enrollment_id` (FK opcional para `course_enrollment.id`, onDelete SET NULL)
-  - `attempt_number` (int, default 1)
-  - `started_at` (datetime)
-  - `finished_at` (datetime, nullable)
-  - `duration_seconds` (int, nullable)
-  - `score` (int, nullable)
-  - `status` (enum: `in_progress`, `completed`, `abandoned`, `voided`, default `in_progress`)
-  - `ip_address` (varchar 45, nullable)
-  - `created_at`, `updated_at`
-- **Defaults:** `attempt_number` default 1, `status` default `in_progress`.
-- **Nulabilidade:** Campos opcionais indicados.
-- **Integridade:** FK com onDelete conforme descrito.
-- **Índices:** único em combinação `exam_id` + `student_id` + `attempt_number`.
-
-### exam_image
-
-- **Finalidade:** Imagens associadas a exames.
-- **Colunas:**
-  - `id` (PK)
-  - `exam_id` (FK para `exam.id`, onDelete CASCADE)
-  - `file_id` (FK para `file.id`, onDelete CASCADE)
-  - `image_type_id` (FK para `image_type.id`, onDelete CASCADE)
-  - `order` (int)
-  - `is_primary` (boolean, default false)
-  - `created_at`, `updated_at`
-- **Defaults:** `is_primary` default false.
-- **Integridade:** FK com onDelete CASCADE.
-- **Índices:** único em combinação `exam_id` + `image_type_id` + `order`.
-
-### exam_option
-
-- **Finalidade:** Opções de resposta para questões de exame.
-- **Colunas:**
-  - `id` (PK)
-  - `question_id` (FK para `question.id`, onDelete CASCADE)
-  - `option_text` (text)
-  - `is_correct` (boolean, default false)
-  - `position` (int, default 0)
-  - `feedback` (text, nullable)
-  - `created_at`, `updated_at`
-- **Defaults:** `is_correct` default false, `position` default 0.
-- **Nulabilidade:** `feedback` opcional.
-- **Integridade:** FK com onDelete CASCADE.
-- **Índices:** único em combinação `question_id` + `position`.
-
-### exam_question
-
-- **Finalidade:** Questões associadas a exames.
-- **Colunas:**
-  - `id` (PK)
-  - `exam_id` (FK para `exam.id`, onDelete CASCADE)
-  - `question_id` (FK para `question.id`, onDelete CASCADE)
-  - `order` (int)
-  - `created_at`, `updated_at`
-- **Integridade:** FK com onDelete CASCADE.
-- **Índices:** únicos em combinações `exam_id` + `question_id` e `exam_id` + `order`.
-
-### image_type
-
-- **Finalidade:** Tipos de imagens aplicáveis a cursos, exames e trilhas.
-- **Colunas:**
-  - `id` (PK)
-  - `name` (varchar 100)
-  - `slug` (varchar 100, único)
-  - `applies_to_course` (boolean, default false)
-  - `applies_to_exam` (boolean, default false)
-  - `applies_to_learning_path` (boolean, default false)
-  - `status` (enum: `active`, `inactive`, default `active`)
+  - `certificate_workload` (int, nullable)
+  - `certificate_template_id` (FK opcional para `certificate_template.id`, onDelete SET NULL)
+  - `requirements`, `objectives`, `target_audience` (text, nullable)
   - `created_at`, `updated_at`
-- **Defaults:** booleanos default false, `status` default `active`.
-- **Integridade:** -
+- **Defaults:** `level` default `beginner`, `duration_hours` default 0, `status` default `draft`.
+- **Nulabilidade:** campos opcionais indicados.
+- **Integridade:** FK para `certificate_template` com onDelete SET NULL.
 - **Índices:** único em `slug`.
 
 ### instructor
@@ -525,7 +540,7 @@ O módulo `@hed-hog/lms` é responsável pela gestão do sistema de Learning Man
   - `primary_color`, `primary_contrast_color`, `secondary_color`, `secondary_contrast_color` (varchar 9, nullable)
   - `created_at`, `updated_at`
 - **Defaults:** `level` default `beginner`, `duration_hours` default 0, `status` default `draft`.
-- **Nulabilidade:** Campos opcionais indicados.
+- **Nulabilidade:** campos opcionais indicados.
 - **Integridade:** -
 - **Índices:** único em `slug`.
 
@@ -546,50 +561,6 @@ O módulo `@hed-hog/lms` é responsável pela gestão do sistema de Learning Man
 - **Integridade:** FK com onDelete CASCADE.
 - **Índices:** único em combinação `learning_path_id` + `person_id`.
 
-### learning_path_image
-
-- **Finalidade:** Imagens associadas a trilhas de aprendizagem.
-- **Colunas:**
-  - `id` (PK)
-  - `learning_path_id` (FK para `learning_path.id`, onDelete CASCADE)
-  - `file_id` (FK para `file.id`, onDelete CASCADE)
-  - `image_type_id` (FK para `image_type.id`, onDelete CASCADE)
-  - `order` (int)
-  - `is_primary` (boolean, default false)
-  - `created_at`, `updated_at`
-- **Defaults:** `is_primary` default false.
-- **Integridade:** FK com onDelete CASCADE.
-- **Índices:** único em combinação `learning_path_id` + `image_type_id` + `order`.
-
-### learning_path_step
-
-- **Finalidade:** Passos dentro de uma trilha, podendo ser cursos ou exames.
-- **Colunas:**
-  - `id` (PK)
-  - `learning_path_id` (FK para `learning_path.id`, onDelete CASCADE)
-  - `step_type` (enum: `course`, `exam`)
-  - `course_id` (FK opcional para `course.id`, onDelete CASCADE)
-  - `exam_id` (FK opcional para `exam.id`, onDelete CASCADE)
-  - `order` (int)
-  - `is_required` (boolean, default true)
-  - `created_at`, `updated_at`
-- **Defaults:** `is_required` default true.
-- **Integridade:** FK com onDelete CASCADE.
-- **Índices:** únicos para combinações de trilha e ordem, curso ou exame.
-
-### question
-
-- **Finalidade:** Questões para avaliações e quizzes.
-- **Colunas:**
-  - `id` (PK)
-  - `question_type` (enum: `multiple_choice`, `true_false`, `essay`, `fill_blank`, `matching`)
-  - `statement` (text)
-  - `explanation` (text, nullable)
-  - `points` (int, default 1)
-  - `created_at`, `updated_at`
-- **Defaults:** `points` default 1.
-- **Nulabilidade:** `explanation` opcional.
-
 ## 8. Regras de negócio relevantes
 
 - Certificados são vinculados a estudantes e podem estar associados a diferentes tipos de atividades (curso, exame, grupo de aula, trilha).
@@ -600,12 +571,21 @@ O módulo `@hed-hog/lms` é responsável pela gestão do sistema de Learning Man
 - Trilhas de aprendizagem são compostas por passos ordenados que podem ser cursos ou exames, podendo ser obrigatórios ou opcionais.
 - Progresso em aulas e cursos é monitorado para permitir acompanhamento detalhado do aluno.
 - Imagens e arquivos são organizados por tipo e podem ser marcados como primários para exibição.
+- Turmas possuem capacidade máxima e status que impactam matrículas e ocupação.
+- Sessões podem ser recorrentes com regras de recorrência definidas e exceções.
+- Presença em sessões é registrada individualmente com possibilidade de justificativas.
+- Ao criar ou atualizar templates de certificado, o conteúdo deve ser JSON válido.
+- Slugs de templates são únicos e gerados automaticamente se não fornecidos.
+- Ao matricular estudantes, verifica-se se já existe matrícula ativa para evitar duplicidade.
+- Atualizações em séries de sessões podem ser aplicadas a uma única sessão ou a toda a série.
+- Empresas (enterprises) gerenciam usuários, cursos, turmas e leads com papéis e status específicos.
+- Dashboard agrega dados e estatísticas para monitoramento do LMS.
 
 ## 9. Guia rápido de uso (exemplos)
 
-> Como o módulo não expõe endpoints diretamente, o uso típico envolve integração via serviços internos ou APIs do HedHog.
+> Como o módulo é consumido via APIs internas do HedHog, os exemplos abaixo ilustram chamadas típicas usando Prisma ORM.
 
-### Exemplo: Criar um novo curso
+### Criar um novo curso
 
 ```ts
 const novoCurso = await prisma.course.create({
@@ -620,12 +600,13 @@ const novoCurso = await prisma.course.create({
 });
 ```
 
-### Exemplo: Matricular um estudante em um curso
+### Matricular um estudante em uma turma
 
 ```ts
 const matricula = await prisma.course_enrollment.create({
   data: {
     person_id: estudanteId,
+    course_class_group_id: turmaId,
     course_id: cursoId,
     status: 'active',
     enrolled_at: new Date(),
@@ -633,7 +614,7 @@ const matricula = await prisma.course_enrollment.create({
 });
 ```
 
-### Exemplo: Registrar presença em uma sessão de aula
+### Registrar presença em uma sessão de aula
 
 ```ts
 const presenca = await prisma.course_class_attendance.upsert({
@@ -652,7 +633,7 @@ const presenca = await prisma.course_class_attendance.upsert({
 });
 ```
 
-### Exemplo: Emitir um certificado
+### Emitir um certificado
 
 ```ts
 const certificado = await prisma.certificate.create({
@@ -674,6 +655,37 @@ const certificado = await prisma.certificate.create({
 });
 ```
 
+### Criar uma turma (class group)
+
+```ts
+const turma = await prisma.course_class_group.create({
+  data: {
+    code: 'TURMA001',
+    course_id: cursoId,
+    title: 'Turma de Exemplo',
+    delivery_mode: 'online',
+    status: 'open',
+    start_date: new Date('2024-07-01'),
+    capacity: 30,
+  },
+});
+```
+
+### Criar sessão em turma
+
+```ts
+const sessao = await prisma.course_class_session.create({
+  data: {
+    course_class_group_id: turma.id,
+    title: 'Sessão 1',
+    session_date: new Date('2024-07-02'),
+    start_time: '09:00',
+    end_time: '11:00',
+    status: 'scheduled',
+  },
+});
+```
+
 ---
 
 Para mais detalhes sobre integração e uso, consulte a documentação geral do HedHog e os serviços que consomem o módulo `@hed-hog/lms`.