User Story 4 – Quản lý Branding (Branding Management)

Mã tài liệu:	EZD-PRD-ADM-US-04	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ể tuỳ chỉnh branding (logo, màu sắc chủ đạo) trên AI Booth,
Để hình ảnh hiển thị trên Booth đồng nhất với bộ nhận diện thương hiệu của TTTM.

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

2.1. Happy Path – Quản lý Branding thành công

graph TD
    A(LOGIN-01: Đăng nhập Dashboard) --> B(BR-01: Vào module Branding);
    B --> C(BR-02: Upload logo mới);
    C --> D(BR-03: Chọn màu chủ đạo);
    D --> E(BR-04: Lưu & áp dụng branding);
    E --> F(BR-05: Booth hiển thị branding mới);
    F --> G(BR-06: Chọn branding đã có để chỉnh sửa);
    G --> H(BR-07: Cập nhật logo/màu & lưu lại);
    H --> I(BR-08: Booth hiển thị branding đã chỉnh sửa);
    I --> J(BR-09: Chọn branding đã có để xóa);
    J --> K(BR-10: Xác nhận xóa branding);
    K --> L(BR-11: Booth trở về branding mặc định);

2.2. Fail Path 1 – Upload logo không hợp lệ

graph TD
    A(BR-02: Upload logo) --> B(BR-ERR-01: File định dạng sai/kích thước quá lớn);
    B --> C(MSG-01: Hiển thị cảnh báo 'Logo không hợp lệ, vui lòng chọn file PNG/JPG ≤ 2MB');
    C --> D(RETRY-01: Người dùng chọn file hợp lệ);

Acceptance: Chỉ chấp nhận file PNG/JPG ≤ 2MB, tỉ lệ tối thiểu 1:1.

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

graph TD
    A(BR-04: Lưu & áp dụng) --> B(SYNC-ERR-01: Booth không nhận branding mới);
    B --> C(MSG-02: Hiển thị thông báo 'Áp dụng thất bại, vui lòng thử lại');
    C --> D(RETRY-02: Người dùng thử lại trong 60s);

Acceptance: Booth phải hiển thị branding mới trong vòng ≤ 1 phút; nếu lỗi thì có retry.

3. Guardrails Định lượng

Branding update success rate: ≥ 98%.
Branding sync latency (Create/Update/Delete): ≤ 1 phút từ khi thao tác đến khi Booth phản ánh.
Invalid logo upload: = 0 (không có file sai chuẩn được lưu).
Branding delete propagation: 100% xóa branding phải đưa Booth về mặc định trong ≤ 1 phút.
Branding update consistency: ≥ 99% Booth hiển thị đúng branding mới sau khi cập nhật.

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

Tenant có thể tạo/sửa/xóa branding qua dashboard.
Booth phản ánh branding mới trong vòng ≤ 1 phút.
Chỉ chấp nhận logo hợp lệ (PNG/JPG ≤ 2MB, tỷ lệ phù hợp).
Khi chỉnh sửa: Booth hiển thị logo/màu mới nhất trong ≤ 1 phút.
Khi xóa: Booth trở về trạng thái mặc định trong ≤ 1 phút.
Có cơ chế retry nếu Booth sync thất bại.

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	Upload logo hợp lệ	Chỉ nhận PNG/JPG ≤ 2MB, tỉ lệ phù hợp	EZD-PRD-ADM Epic	[ ] ✔ / [ ] ✘
2	Áp dụng branding thành công	Booth hiển thị logo + màu trong ≤ 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	Branding update success rate	≥ 98% thành công	EZD-QMS-P01	[ ] ✔ / [ ] ✘
5	Branding hiển thị đúng trên Booth	Logo + màu nhất quán với Dashboard	EZD-DSGN-STD	[ ] ✔ / [ ] ✘
6	Update consistency	≥ 99% Booth sửa branding hiển thị đúng	EZD-PJT-FLW 3.2	[ ] ✔ / [ ] ✘
7	Delete propagation	100% xóa branding → Booth về mặc định ≤ 1 phút	EZD-PJT-FLW 3.2	[ ] ✔ / [ ] ✘