User Story 5 – Quản lý Avatar (Avatar Management)

Mã tài liệu:	EZD-PRD-ADM-US-05	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ể chọn một avatar từ thư viện có sẵn và áp dụng cho AI Booth,
Để Booth luôn có hình ảnh đại diện phù hợp, nhất quán với thương hiệu.

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

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

graph TD
    A(LOGIN-01: Đăng nhập Dashboard) --> B(AVT-01: Vào module Avatar);
    B --> C(AVT-02: Chọn avatar từ thư viện có sẵn);
    C --> D(AVT-03: Lưu & áp dụng avatar);
    D --> E(AVT-04: Booth hiển thị avatar mới);
    E --> F(AVT-05: Chọn avatar khác từ thư viện);
    F --> G(AVT-06: Cập nhật & hiển thị avatar mới);
    G --> H(AVT-07: Xóa avatar đã chọn);
    H --> I(AVT-08: Booth trở về avatar mặc định);

2.2. Fail Path 1 – Asset avatar không hợp lệ

graph TD
    A(AVT-02: Chọn avatar từ thư viện) --> B(AVT-ERR-01: Asset bị lỗi hoặc không load được);
    B --> C(MSG-01: Hiển thị cảnh báo 'Không thể tải avatar, vui lòng chọn lại');
    C --> D(RETRY-01: Người dùng chọn avatar khác);

Acceptance: Hệ thống chỉ hiển thị avatar hợp lệ trong thư viện.

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

graph TD
    A(AVT-03: Lưu & áp dụng) --> B(SYNC-ERR-01: Booth không nhận avatar 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ị avatar mới trong vòng ≤ 1 phút; nếu lỗi thì có retry.

3. Guardrails Định lượng

Avatar apply success rate: ≥ 98%.
Avatar sync latency (Select/Update/Delete): ≤ 1 phút từ khi thao tác đến khi Booth phản ánh.
Invalid asset load: = 0 (không có asset lỗi hiển thị cho người dùng).
Avatar delete propagation: 100% xóa avatar phải đưa Booth về mặc định trong ≤ 1 phút.

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

Tenant có thể chọn / đổi / xóa avatar từ thư viện có sẵn.
Booth phản ánh avatar được chọn trong vòng ≤ 1 phút.
Asset trong thư viện luôn hợp lệ và load đúng.
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	Avatar load hợp lệ	Không hiển thị asset lỗi trong thư viện	EZD-PRD-ADM Epic	[ ] ✔ / [ ] ✘
2	Áp dụng avatar thành công	Booth hiển thị avatar 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	Avatar apply success rate	≥ 98% thành công	EZD-QMS-P01	[ ] ✔ / [ ] ✘
5	Avatar delete propagation	Booth về mặc định trong ≤ 1 phút khi xóa	EZD-PJT-FLW 3.2	[ ] ✔ / [ ] ✘