URD: Chiến dịch
| Module | EXT-03 | Phiên bản | v0.1 |
|---|---|---|---|
| Status | In-progress | Ngày | 2026-05-30 |
1. Mục đích
Cho phép nhà bán thúc đẩy doanh số bằng khuyến mãi nhắm mục tiêu — giảm giá, combo và ưu đãi BuyGet — áp tự động hoặc qua mã giảm, giới hạn theo khách, sản phẩm và ngày.
2. Phạm vi
| Bao gồm | Loại trừ |
|---|---|
| Thiết lập khuyến mãi, quy tắc, vòng đời | Điểm thân thiết (module Khách hàng thân thiết) |
| BuyGet, combo, mã giảm | Gửi tin nhắn (module Marketing) |
| Áp giảm giá khi thanh toán | Tính thuế (engine thuế của Pricing) |
3. Định nghĩa
| Thuật ngữ | Định nghĩa |
|---|---|
| Promotion | Một chiến dịch với quy tắc điều kiện và một phương thức giảm giá |
| Method | Cách hoạt động của giảm giá (phần trăm/cố định, mục tiêu, phân bổ) |
| Rule | Một điều kiện kiểm soát ai/cái gì đủ điều kiện |
| BuyGet | Ưu đãi có điều kiện "mua X, tặng Y" |
4. Mô hình khái niệm
Chỉ mang tính khái niệm — schema đầy đủ nằm trong tài liệu lập trình viên promotion.
5. Yêu cầu chức năng
Mức ưu tiên = MoSCoW. Thiết lập/vòng đời đã được xây dựng; việc áp là kế hoạch.
5.1 Thiết lập & Vòng đời khuyến mãi (PRM)
| ID | P | Yêu cầu | Trạng thái |
|---|---|---|---|
| URD-PRM-001 | M | Tạo khuyến mãi với phương thức và quy tắc một cách nguyên tử | In-progress |
| URD-PRM-002 | M | Chuyển khuyến mãi qua DRAFT → ACTIVATED → DEACTIVATED/EXPIRED/ARCHIVED | In-progress |
| URD-PRM-003 | S | Định nghĩa quy tắc điều kiện, nguồn và mục tiêu | In-progress |
| URD-PRM-004 | S | Thực thi giới hạn sử dụng theo từng khuyến mãi | In-progress |
5.2 Áp giảm giá (APP)
| ID | P | Yêu cầu | Trạng thái |
|---|---|---|---|
| URD-APP-001 | M | Tự động áp khuyến mãi đủ điều kiện khi thanh toán | Planned |
| URD-APP-002 | S | Áp mã giảm thủ công khi thanh toán | Planned |
| URD-APP-003 | C | Báo cáo mức dùng khuyến mãi và ROI | Planned |
6. Tiêu chí chấp nhận
AC-PRM-01: Tạo khuyến mãi nguyên tử
| Cho trước | Khi nào | Thì |
|---|---|---|
| Payload khuyến mãi, phương thức và quy tắc | Lệnh tạo aggregate được gửi | Tất cả thực thể được tạo cùng nhau, hoặc không tạo gì khi lỗi |
7. Ràng buộc & Không thuộc phạm vi
Ràng buộc
| ID | Ràng buộc |
|---|---|
| C-01 | Một khuyến mãi phải có phương thức hợp lệ trước khi kích hoạt |
| C-02 | Xóa một khuyến mãi sẽ cascade tới phương thức và quy tắc của nó |
Không thuộc phạm vi
- Tích/đổi điểm thân thiết (thuộc Khách hàng thân thiết)
- Gửi tin nhắn khuyến mãi (thuộc Marketing)
8. Lịch sử phiên bản
| Ngày | Tác giả | Mô tả | Ver |
|---|---|---|---|
| 2026-05-30 | PM | Bản khởi tạo; thiết lập/vòng đời đã hoạt động, việc áp theo kế hoạch | v0.1 |