<aside> <img src="/icons/checklist_green.svg" alt="/icons/checklist_green.svg" width="40px" />

</aside>

Persistence Model

Table modules [note: 'Bảng quản lý module (chủ đề) trong mỗi khóa học'] 
{
  id                uuid                    [pk, note: 'Khóa chính của module']  
  course_id         uuid                    [ref: > courses.product_id, note: 'Thuộc khóa nào']  
  title             varchar                 [not null, note: 'Tên module']
  short_description text                    [not null]  
  order             int                     [default: 0, note: 'Thứ tự module trong course']
  status            enum                    [default: 'draft']
  created_at        timestamp               [default: `now()`, note: 'Tạo lúc nào']  
  updated_at        timestamp               [default: `now()`, note: 'Cập nhật lần cuối']  
  deleted_at        timestamp               [null, note: 'Soft-delete']  
}

Domain Rules

Quan hệ Module – Course

• course_id phải tham chiếu tới courses.product_id của một Course tồn tại và deleted_at = null.
• Không được phép tạo Module rỗng (không thuộc Course nào).
• Khi Course bị archived hoặc soft-deleted (deleted_at ≠ null), tất cả Module của Course đó cần được soft-deleted cascade.

Tiêu đề & Mô tả

• title
  • Bắt buộc; độ dài 1–150 ký tự.
• short_description
  • Bắt buộc; độ dài tối đa 255 ký tự.

Thứ tự hiển thị (order)

• Là số nguyên ≥ 0.
• Trong cùng một Course (course_id giống nhau), giá trị order phải unique.
• Khi chèn/sửa thứ tự, hệ thống cần tự động điều chỉnh (reindex) hoặc từ chối nếu trùng.

Soft-delete & Cascade

• Module bị soft-deleted, không hiển thị.
• Khi soft-delete một Module, tất cả Lesson con (lessons.module_id = module.id) phải soft-deleted cascade.
• Restore Module phải restore đồng bộ Lesson con.

Quyền sở hữu & Phân quyền