URD: Khách hàng thân thiết
| Module | EXT-01 | Phiên bản | v0.1 |
|---|---|---|---|
| Status | In-progress | Ngày | 2026-05-30 |
1. Mục đích
Thưởng cho khách quay lại để họ ghé thường xuyên hơn và chi nhiều hơn. Module biến đơn mua hoàn tất thành điểm, cho khách thăng hạng và đổi điểm lấy phần thưởng.
2. Phạm vi
| Bao gồm | Loại trừ |
|---|---|
| Tích điểm trên đơn hoàn tất | Chia sẻ điểm liên nhà bán |
| Hạng, danh mục phần thưởng, đổi điểm | Tính phí thành viên trả phí |
| Phần thưởng giới thiệu & sinh nhật | Gửi tin nhắn (do Marketing xử lý) |
3. Định nghĩa
| Thuật ngữ | Định nghĩa |
|---|---|
| Point | Đơn vị giá trị thân thiết kiếm được khi chi tiêu; có thể đổi phần thưởng |
| Tier | Cấp thành viên (ví dụ Bronze/Silver/Gold) đem lại lợi ích |
| Earning rate | Tỷ lệ quy đổi giá trị đơn thành điểm, đặt theo từng nhà bán |
| Redemption | Dùng điểm để giảm giá hoặc đổi phần thưởng |
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 customer-points.
5. Yêu cầu chức năng
Mức ưu tiên = MoSCoW. Tất cả trừ tích điểm đều chưa được xây dựng.
5.1 Tích điểm (PTS)
| ID | P | Yêu cầu | Trạng thái |
|---|---|---|---|
| URD-PTS-001 | M | Cộng điểm khi đơn hoàn tất thanh toán | In-progress |
| URD-PTS-002 | M | Tích điểm phải idempotent theo từng đơn (không cộng đôi) | In-progress |
| URD-PTS-003 | S | Tỷ lệ tích điểm cấu hình được theo từng nhà bán | In-progress |
5.2 Đổi điểm & Hạng (RDM)
| ID | P | Yêu cầu | Trạng thái |
|---|---|---|---|
| URD-RDM-001 | S | Đổi điểm để giảm giá khi thanh toán | Planned |
| URD-RDM-002 | C | Gán khách vào hạng theo điểm tích lũy trọn đời | Planned |
| URD-RDM-003 | C | Cấu hình danh mục phần thưởng | Planned |
6. Tiêu chí chấp nhận
AC-PTS-01: Cộng điểm khi đơn hoàn tất
| Cho trước | Khi nào | Thì |
|---|---|---|
| Một đơn gắn khách với tỷ lệ tích khác 0 | Đơn hoàn tất thanh toán | Điểm = tổng × tỷ lệ được cộng một lần vào số dư khách |
7. Ràng buộc & Không thuộc phạm vi
Ràng buộc
| ID | Ràng buộc |
|---|---|
| C-01 | Điểm chỉ tích cho khách đã định danh (đơn ẩn danh không tích) |
| C-02 | Một đơn cộng điểm nhiều nhất một lần |
Không thuộc phạm vi
- Gộp điểm liên nhà bán hoặc toàn chuỗi nhượng quyền
- Gửi tin nhắn marketing (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; tích điểm đã hoạt động, phần còn lại theo kế hoạch | v0.1 |