@hed-hog/lms 0.0.275 → 0.0.276

package/README.md

@@ -1,4 +1,3 @@
-```markdown
 # @hed-hog/lms
 
 ## 1. Visão geral do módulo
@@ -64,6 +63,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.
 - **Índices:** único em `verification_code`.
 
 ### certificate_template
@@ -77,6 +79,9 @@ O módulo `@hed-hog/lms` é responsável pela gestão do sistema de Learning Man
   - `template_content` (text)
   - `status` (enum: `draft`, `active`, `inactive`, default `draft`)
   - `created_at`, `updated_at`
+- **Defaults:** `status` default `draft`.
+- **Nulabilidade:** `description` nullable.
+- **Integridade:** -
 - **Índices:** único em `slug`.
 
 ### course
@@ -96,6 +101,9 @@ O módulo `@hed-hog/lms` é responsável pela gestão do sistema de Learning Man
   - `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
@@ -106,6 +114,9 @@ O módulo `@hed-hog/lms` é responsável pela gestão do sistema de Learning Man
   - `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
@@ -119,6 +130,9 @@ O módulo `@hed-hog/lms` é responsável pela gestão do sistema de Learning Man
   - `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
@@ -141,6 +155,9 @@ O módulo `@hed-hog/lms` é responsável pela gestão do sistema de Learning Man
   - `location` (text, nullable)
   - `virtual_room_url` (varchar 500, nullable)
   - `created_at`, `updated_at`
+- **Defaults:** `status` default `open`, `capacity` default 30.
+- **Nulabilidade:** Campos opcionais indicados.
+- **Integridade:** FK com onDelete CASCADE.
 - **Índices:** único em `code`.
 
 ### course_class_session
@@ -158,6 +175,9 @@ O módulo `@hed-hog/lms` é responsável pela gestão do sistema de Learning Man
   - `meeting_url` (varchar 500, nullable)
   - `status` (enum: `scheduled`, `completed`, `cancelled`, default `scheduled`)
   - `created_at`, `updated_at`
+- **Defaults:** `status` default `scheduled`.
+- **Nulabilidade:** Campos opcionais indicados.
+- **Integridade:** FK com onDelete CASCADE.
 - **Índices:** combinação `course_class_group_id` + `session_date`.
 
 ### course_class_session_instructor
@@ -169,6 +189,8 @@ O módulo `@hed-hog/lms` é responsável pela gestão do sistema de Learning Man
   - `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
@@ -185,6 +207,9 @@ O módulo `@hed-hog/lms` é responsável pela gestão do sistema de Learning Man
   - `progress_percent` (int, default 0)
   - `final_score` (int, nullable)
   - `created_at`, `updated_at`
+- **Defaults:** `status` default `active`, `progress_percent` default 0.
+- **Nulabilidade:** Campos opcionais indicados.
+- **Integridade:** FK com onDelete conforme descrito.
 - **Índices:** único em combinação `person_id` + `course_class_group_id`.
 
 ### course_image
@@ -198,6 +223,8 @@ O módulo `@hed-hog/lms` é responsável pela gestão do sistema de Learning Man
   - `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
@@ -214,6 +241,8 @@ O módulo `@hed-hog/lms` é responsável pela gestão do sistema de Learning Man
   - `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
@@ -225,6 +254,8 @@ O módulo `@hed-hog/lms` é responsável pela gestão do sistema de Learning Man
   - `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
@@ -236,6 +267,8 @@ O módulo `@hed-hog/lms` é responsável pela gestão do sistema de Learning Man
   - `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
@@ -252,6 +285,9 @@ O módulo `@hed-hog/lms` é responsável pela gestão do sistema de Learning Man
   - `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
@@ -263,6 +299,7 @@ O módulo `@hed-hog/lms` é responsável pela gestão do sistema de Learning Man
   - `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
@@ -276,6 +313,8 @@ O módulo `@hed-hog/lms` é responsável pela gestão do sistema de Learning Man
   - `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
@@ -289,6 +328,8 @@ O módulo `@hed-hog/lms` é responsável pela gestão do sistema de Learning Man
   - `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
@@ -301,6 +342,8 @@ O módulo `@hed-hog/lms` é responsável pela gestão do sistema de Learning Man
   - `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
@@ -319,6 +362,9 @@ O módulo `@hed-hog/lms` é responsável pela gestão do sistema de Learning Man
   - `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
@@ -347,6 +393,9 @@ O módulo `@hed-hog/lms` é responsável pela gestão do sistema de Learning Man
   - `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
@@ -362,6 +411,9 @@ O módulo `@hed-hog/lms` é responsável pela gestão do sistema de Learning Man
   - `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
@@ -380,6 +432,9 @@ O módulo `@hed-hog/lms` é responsável pela gestão do sistema de Learning Man
   - `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
@@ -393,6 +448,8 @@ O módulo `@hed-hog/lms` é responsável pela gestão do sistema de Learning Man
   - `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
@@ -406,6 +463,9 @@ O módulo `@hed-hog/lms` é responsável pela gestão do sistema de Learning Man
   - `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
@@ -417,6 +477,7 @@ O módulo `@hed-hog/lms` é responsável pela gestão do sistema de Learning Man
   - `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
@@ -431,6 +492,8 @@ O módulo `@hed-hog/lms` é responsável pela gestão do sistema de Learning Man
   - `applies_to_learning_path` (boolean, default false)
   - `status` (enum: `active`, `inactive`, default `active`)
   - `created_at`, `updated_at`
+- **Defaults:** booleanos default false, `status` default `active`.
+- **Integridade:** -
 - **Índices:** único em `slug`.
 
 ### instructor
@@ -442,6 +505,8 @@ O módulo `@hed-hog/lms` é responsável pela gestão do sistema de Learning Man
   - `status` (enum: `active`, `inactive`, default `active`)
   - `can_teach_courses` (boolean, default true)
   - `created_at`, `updated_at`
+- **Defaults:** `status` default `active`, `can_teach_courses` default true.
+- **Integridade:** FK único com onDelete CASCADE.
 - **Índices:** único em `person_id`.
 
 ### learning_path
@@ -458,6 +523,9 @@ O módulo `@hed-hog/lms` é responsável pela gestão do sistema de Learning Man
   - `status` (enum: `draft`, `active`, `archived`, default `draft`)
   - `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.
+- **Integridade:** -
 - **Índices:** único em `slug`.
 
 ### learning_path_enrollment
@@ -472,6 +540,9 @@ O módulo `@hed-hog/lms` é responsável pela gestão do sistema de Learning Man
   - `enrolled_at` (datetime)
   - `completed_at` (datetime, nullable)
   - `created_at`, `updated_at`
+- **Defaults:** `status` default `active`, `progress_percent` default 0.
+- **Nulabilidade:** `completed_at` opcional.
+- **Integridade:** FK com onDelete CASCADE.
 - **Índices:** único em combinação `learning_path_id` + `person_id`.
 
 ### learning_path_image
@@ -485,6 +556,8 @@ O módulo `@hed-hog/lms` é responsável pela gestão do sistema de Learning Man
   - `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
@@ -499,6 +572,8 @@ O módulo `@hed-hog/lms` é responsável pela gestão do sistema de Learning Man
   - `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
@@ -511,6 +586,8 @@ O módulo `@hed-hog/lms` é responsável pela gestão do sistema de Learning Man
   - `explanation` (text, nullable)
   - `points` (int, default 1)
   - `created_at`, `updated_at`
+- **Defaults:** `points` default 1.
+- **Nulabilidade:** `explanation` opcional.
 
 ## 8. Regras de negócio relevantes
 
@@ -599,4 +676,3 @@ const certificado = await prisma.certificate.create({
 ---
 
 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`.
-```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hed-hog/lms",
-  "version": "0.0.275",
+  "version": "0.0.276",
   "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/core": "0.0.275",
+    "@hed-hog/core": "0.0.276",
     "@hed-hog/api": "0.0.4",
-    "@hed-hog/finance": "0.0.275",
     "@hed-hog/api-types": "0.0.1",
     "@hed-hog/api-pagination": "0.0.6",
-    "@hed-hog/contact": "0.0.275",
+    "@hed-hog/contact": "0.0.276",
+    "@hed-hog/category": "0.0.276",
     "@hed-hog/api-prisma": "0.0.5",
-    "@hed-hog/api-locale": "0.0.13",
-    "@hed-hog/category": "0.0.275"
+    "@hed-hog/finance": "0.0.276",
+    "@hed-hog/api-locale": "0.0.13"
   },
   "exports": {
     ".": {