User Story 2 – Quản lý Khuyến mãi (Promotion Management)

Mã tài liệu:	EZD-PRD-ADM-US-02	Phiên bản:	1.0
Epic liên quan:	Quản trị và Theo dõi Hiệu quả AI Booth	Persona:	Anh Phong – Giám đốc Marketing
Ngày hiệu lực:	14/09/2025	Người tạo:	Stephen
Tài liệu Flow:	EZD-PJT-FLW, mục 3.2	Người phê duyệt:	Stephen

1. Mô tả

Với vai trò là một Giám đốc Marketing,
Tôi muốn có thể tạo và quản lý khuyến mãi hiển thị trên AI Booth,
Để tôi có thể tăng mức độ quan tâm và thúc đẩy khách hàng mua sắm tại Tenant.

2. Luồng Người dùng (User Flow)

2.1. Happy Path – Tạo khuyến mãi thành công

graph TD
    A(LOGIN-01: Đăng nhập Dashboard) --> B(PROMO-01: Vào module Khuyến mãi);
    B --> C(PROMO-02: Nhấn 'Tạo khuyến mãi mới');
    C --> D(PROMO-03: Nhập thông tin khuyến mãi);
    D --> E(PROMO-04: Lưu & xuất bản);
    E --> F(PROMO-05: Booth hiển thị khuyến mãi mới);
    F --> G(PROMO-06: Chọn khuyến mãi đã có để chỉnh sửa);
    G --> H(PROMO-07: Cập nhật thông tin & lưu lại);
    H --> I(PROMO-08: Booth hiển thị khuyến mãi đã chỉnh sửa);
    I --> J(PROMO-09: Chọn khuyến mãi đã có để xóa);
    J --> K(PROMO-10: Xác nhận xóa khuyến mãi);
    K --> L(PROMO-11: Booth không còn hiển thị khuyến mãi đó);

2.2. Fail Path 1 – Thiếu thông tin bắt buộc

graph TD
    A(PROMO-03: Nhập thông tin khuyến mãi) --> B(PROMO-ERR-01: Bỏ sót trường bắt buộc);
    B --> C(MSG-01: Hiển thị cảnh báo 'Vui lòng nhập đầy đủ thông tin');
    C --> D(RETRY-01: Người dùng bổ sung và lưu lại);

Acceptance: Không cho phép lưu khi thiếu field bắt buộc (tiêu đề, nội dung, thời gian).

2.3. Fail Path 2 – Đồng bộ Booth thất bại

graph TD
    A(PROMO-04: Lưu & xuất bản) --> B(SYNC-ERR-01: Booth không nhận được dữ liệu);
    B --> C(MSG-02: Hiển thị thông báo 'Xuất bản thất bại, vui lòng thử lại');
    C --> D(RETRY-02: Người dùng thử lại trong 60s);

Acceptance: Đồng bộ với Booth phải hoàn tất ≤ 1 phút; nếu lỗi thì có retry.

3. Guardrails Định lượng

Promo publish success rate: ≥ 98%.
Promo sync latency (Create/Update/Delete): ≤ 1 phút từ khi thao tác đến khi Booth phản ánh.
Invalid promo save: = 0 (không có bản ghi thiếu field được lưu).
Promo delete propagation: 100% khuyến mãi bị xóa phải biến mất khỏi Booth trong vòng ≤ 1 phút.
Promo update consistency: ≥ 99% khuyến mãi sau khi sửa phải hiển thị đúng thông tin mới.

4. Tiêu chí Chấp nhận Tổng thể

Tenant có thể tạo/sửa/xóa khuyến mãi qua dashboard.
Booth phản ánh tất cả thay đổi (create, update, delete) trong vòng ≤ 1 phút.
Thông tin khuyến mãi hiển thị: tiêu đề, mô tả, thời gian hiệu lực, hình ảnh (tùy chọn).
Không cho phép lưu khi thiếu field bắt buộc.
Có cơ chế retry nếu Booth sync thất bại.
Khi chỉnh sửa: Booth phải hiển thị thông tin mới nhất trong ≤ 1 phút, không có trường hợp hiển thị cũ.
Khi xóa: Booth không còn hiển thị khuyến mãi đó trong ≤ 1 phút.

5. Checklist ISO 9001

STT	Tiêu chí Kiểm tra	Tiêu chí Chấp nhận	Nguồn tham chiếu	Kết quả
1	Tạo khuyến mãi đầy đủ field	Không cho lưu khi thiếu field bắt buộc	EZD-PRD-ADM Epic	[ ] ✔ / [ ] ✘
2	Xuất bản thành công	Sync Booth ≤ 1 phút	EZD-PJT-FLW 3.2	[ ] ✔ / [ ] ✘
3	Retry khi sync thất bại	Cho phép retry trong 60s	EZD-PJT-FLW 3.2	[ ] ✔ / [ ] ✘
4	Promo publish success rate	≥ 98% thành công	EZD-QMS-P01	[ ] ✔ / [ ] ✘
5	Promo hiển thị đúng trên Booth	Tiêu đề + mô tả + thời gian	EZD-DSGN-STD	[ ] ✔ / [ ] ✘
6	Update consistency	≥ 99% khuyến mãi sửa phải hiển thị đúng thông tin mới	EZD-PJT-FLW 3.2	[ ] ✔ / [ ] ✘
7	Delete propagation	100% khuyến mãi xóa biến mất khỏi Booth ≤ 1 phút	EZD-PJT-FLW 3.2	[ ] ✔ / [ ] ✘