</aside>

Persistence Model

Categories Table

Table categories [note: 'Bảng lưu trữ danh mục khóa học (CNTT, Kinh doanh, Ngôn ngữ, ...)'] 
{
  id                uuid                    [pk, increment] // Khóa chính, tự tăng
  parent_id         uuid                    [null, ref: > categories.id]
  title             varchar                 [not null, note: 'Tên danh mục']  
  slug              varchar                 [unique, not null, note: 'Đường dẫn thân thiện (URL)']  
  // short_description text                    [not null, note: 'Mô tả ngắn cho danh mục']  
  order             int                     [default: 0]
  status            product_status          [default: 'draft']
  created_at        timestamp               [default: `now()`, note: 'Thời điểm tạo']  
  updated_at        timestamp               [default: `now()`, note: 'Thời điểm cập nhật lần cuối']  
  deleted_at        timestamp               [null, note: 'Thời điểm xóa (soft-delete)'] 
}

Trường	Kiểu dữ liệu	Ràng buộc	Mô tả
`id`	`UUID`	PRIMARY KEY	Khóa chính, tự sinh
`parent_id`	`UUID`	REFERENCES `categories(id)`, NULLABLE	Tham chiếu đến danh mục cha (nếu có)
`title`	`VARCHAR`	NOT NULL	Tên danh mục (1–150 ký tự)
`slug`	`VARCHAR`	UNIQUE, NOT NULL	Đường dẫn thân thiện (URL)
`short_description`	`TEXT`	NOT NULL	Mô tả ngắn cho danh mục
`order`	`INT`	NOT NULL, DEFAULT `0`	Thứ tự hiển thị trong giao diện
`status`	`ENUM`	NOT NULL, DEFAULT `'draft'`	Trạng thái (`draft`
`created_at`	`TIMESTAMP`	NOT NULL, DEFAULT `NOW()`	Thời điểm bản ghi được tạo
`updated_at`	`TIMESTAMP`	NOT NULL, DEFAULT `NOW()`	Thời điểm bản ghi được cập nhật lần cuối
`deleted_at`	`TIMESTAMP`	NULLABLE	Thời điểm xóa logic (soft-delete)

Domain Rules

Quan hệ phân cấp

parent_id có thể NULL hoặc trỏ tới một id tồn tại trong categories chưa bị soft-delete
Chỉ có tối đa 2 cấp

Slug duy nhất

slug phải là unique trên bảng categories
Có thể sinh tự động từ title theo chuẩn:
- Lowercase
- Bỏ dấu, thay ký tự không phải chữ/số thành -
- Nếu trùng lặp, thêm hậu tố -{Date.now().toString(36)}

Trạng thái danh mục

Enum: draft, published, archived
Khi trạng thái là published , category sẽ được hiển thị cho user cuối

Thứ tự hiển thị

order là số nguyên ≥ 0
Trong cùng cấp (parent_id giống nhau), không trùng order; có thể reindex tự động.

Soft-Delete Cascade

Không được phép xóa nếu đang có Course thuộc category này hoặc category con