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

</aside>

Persistence Model

Table product_related {
  product_id uuid [not null, ref: > products.id]
  related_id uuid [not null, ref: > products.id]
  order int [not null, default: 0]
  notes text
  deleted_at timestamp null
}

Domain Rules

Quan hệ giữa product_related và products

• Mỗi product_related.product_id phải tham chiếu đến một products.id tồn tại và deleted_at IS NULL.
• Mỗi product_related.related_id phải tham chiếu đến một products.id tồn tại và deleted_at IS NULL.
• Không cho phép product_id = related_id (không tự liên kết bản thân).
• Bộ đôi (product_id, related_id) phải là duy nhất trong bảng (không trùng lặp).

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

• order là số nguyên ≥ 0, dùng để xác định vị trí của Related Course khi hiển thị.
• Trong mỗi nhóm cùng product_id, giá trị order nên là duy nhất để tránh xung đột thứ tự; nếu trùng, service phải reindex hoặc trả lỗi.

Ghi chú (notes)

• notes là trường tùy chọn, dùng để lưu thông tin bổ sung về mối quan hệ (ví dụ: “được mua cùng”, “cùng chuyên đề”, v.v.).
• Không có ràng buộc bắt buộc, nhưng độ dài nếu cần có thể giới hạn theo business (ví dụ tối đa 500 ký tự).

Soft-delete và Cascade

• Khi một Product bị soft-delete (products.deleted_at ≠ NULL), tất cả các bản ghi product_related mà product_id = <id> hoặc related_id = <id> phải được soft-delete (hoặc service chỉ load các record có cả hai bên deleted_at IS NULL).
• Khi một Product được restore (xóa bỏ soft-delete), các liên kết trước đó có thể được restore theo cùng chính sách cascade.

Hiển thị và xử lý

• Khi hiển thị danh sách Related Courses cho một product_id, chỉ lấy các record có deleted_at IS NULL ở cả product_related lẫn sản phẩm liên quan.