Yêu cầu Sản phẩm (PRD) cho Admin Webapp MVP

Mã tài liệu:	EZD-PRD-ADM	Phiên bản:	1.0
Ngày hiệu lực:	14/09/2025	Người soạn:	Stephen
Người phê duyệt:	Stephen	Trang:	1/X

Tổng quan: Tài liệu này định nghĩa các yêu cầu cho Sản phẩm Khả dụng Tối thiểu (MVP) của Admin Webapp - một công cụ dựa trên web được thiết kế dành riêng cho Đối tác (Tenant). Mục tiêu của Admin Webapp là cung cấp cho đối tác, mà đại diện là persona "Anh Phong - Giám đốc Marketing", khả năng tự chủ trong việc quản lý nội dung, cá nhân hóa thương hiệu và theo dõi hiệu quả của AI Booth.

Các Epic Chính

Epic 1: Quản trị Nội dung & Theo dõi Hiệu quả AI Booth

Là một người Quản lý Vận hành/Marketing của Tenant, Tôi muốn có một công cụ web để dễ dàng quản lý các nội dung động (bản đồ, khuyến mãi, nhân vật đại diện thương hiệu, cá nhân hóa thương hiệu, FAQ) và xem các báo cáo tương tác cơ bản, Để tôi có thể chủ động cập nhật thông tin cho khách hàng, cá nhân hóa thương hiệu, tối đa hóa hiệu quả của AI Booth và chứng minh giá trị đầu tư của nó.

Epic 2: Quản lý Truy cập và Phân quyền Hệ thống

Là một Quản trị viên Hệ thống (Super Admin), Tôi muốn có khả năng tạo và quản lý các vai trò (roles) và gán các quyền hạn (permissions) một cách linh hoạt, Để đảm bảo an toàn, phân tách trách nhiệm và sẵn sàng cho việc mở rộng các nhóm người dùng trong tương lai.

Các Câu chuyện Người dùng (User Stories) Cốt lõi cho MVP:

Dưới đây là những năng lực tối thiểu mà Admin Webapp PHẢI cung cấp cho "Anh Phong" trong phiên bản MVP.

1. User Story: Theo dõi Hiệu quả (Dashboard)

• Với vai trò là một Giám đốc Marketing,
• Tôi muốn xem một trang tổng quan (dashboard) hiển thị các chỉ số tương tác chính và log các câu hỏi gần đây,
• Để tôi có thể nhanh chóng nắm bắt được mức độ hiệu quả của AI Booth và hiểu được khách hàng đang quan tâm điều gì nhất.
• Tiêu chí Chấp nhận:
  • Dashboard phải hiển thị biểu đồ cột về số lượt tương tác trong 7 ngày gần nhất.
  • Phải có biểu đồ tròn (hoặc bảng) hiển thị top 10 chủ đề/câu hỏi phổ biến nhất.
  • Vẫn phải có một khu vực hiển thị danh sách (log) các câu hỏi-đáp gần nhất.
  • Giao diện phải chuyên nghiệp, sạch sẽ, tuân thủ EZD-DSGN-STD.

2. User Story: Quản lý Khuyến mãi (CMS)

• Với vai trò là một Quản lý Vận hành,
• Tôi muốn có thể dễ dàng thêm, sửa, và xóa các chương trình khuyến mãi,
• Để đảm bảo thông tin ưu đãi tại booth luôn được cập nhật chính xác và kịp thời.
• Tiêu chí Chấp nhận:
  • Hệ thống phải có một giao diện hiển thị danh sách các khuyến mãi hiện có.
  • Phải có một form cho phép người dùng nhập đầy đủ thông tin: Tiêu đề, mô tả, ngày bắt đầu/kết thúc, và tải lên hình ảnh đại diện.
  • Các thay đổi phải được phản ánh ra Booth App gần như ngay lập tức.

3. User Story: Quản lý Thông tin Chung (CMS - FAQ)

• Với vai trò là một Quản lý Vận hành,
• Tôi muốn có thể quản lý danh sách các câu hỏi thường gặp (FAQ),
• Để cung cấp các câu trả lời chuẩn xác cho các thắc mắc phổ biến của khách hàng.
• Tiêu chí Chấp nhận:
  • Hệ thống phải cho phép người dùng thêm/sửa/xóa các cặp câu hỏi - câu trả lời.

4. User Story: Cá nhân hóa Thương hiệu (CMS - Branding)

• Với vai trò là một Giám đốc Marketing,
• Tôi muốn tải lên logo thương hiệu của mình và chọn một màu chủ đạo,
• Để Admin Webapp và Booth App mang đúng nhận diện thương hiệu của Tenant.
• Tiêu chí Chấp nhận:
  • Admin Webapp phải có khu vực cho phép tải lên logo của Tenant để hiển thị trên Sidebar.
  • Cung cấp một bảng màu cơ bản để Tenant có thể chọn màu nhấn cho các link và nút bấm.

5. User Story: Tùy chỉnh Nhân vật Đại diện (CMS - Avatar)

• Với vai trò là một Giám đốc Marketing,
• Tôi muốn lựa chọn một nhân vật đại diện từ một thư viện có sẵn,
• Để nhân vật ảo tại booth phù hợp với hình ảnh thương hiệu của chúng tôi và khác biệt với đối thủ.
• Tiêu chí Chấp nhận:
  • Hệ thống phải cung cấp một thư viện với tối thiểu 3 mẫu nhân vật 3D khác nhau để Tenant lựa chọn.
  • Việc lựa chọn phải được áp dụng cho Avatar hiển thị tại Booth App.

User Story 6: Quản lý Vai trò & Quyền hạn (RBAC)

• Với vai trò là một Super Admin,
• Tôi muốn có thể tạo, xem, sửa, và xóa các vai trò (ví dụ: TENANT_ADMIN, CONTENT_EDITOR),
• Để tôi có thể định nghĩa các nhóm quyền hạn khác nhau cho người dùng trong hệ thống.
• Tiêu chí Chấp nhận:
  • Hệ thống phải có giao diện để quản lý CRUD (Tạo, Đọc, Sửa, Xóa) cho các Vai trò (Roles).
  • Khi tạo/sửa một vai trò, tôi phải có khả năng gán một danh sách các Quyền hạn (Permissions) cụ thể cho vai trò đó từ một danh sách quyền hạn đã được định nghĩa sẵn trong hệ thống.
  • Hệ thống phải có sẵn 2 vai trò ban đầu: SUPER_ADMIN và TENANT_ADMIN.

Những gì KHÔNG làm trong MVP của Admin Webapp

• KHÔNG có các báo cáo phân tích sâu: Sẽ không có các biểu đồ phức tạp, phân tích xu hướng hay so sánh theo thời gian. Dashboard chỉ hiển thị dữ liệu thô và các bộ đếm cơ bản.
• KHÔNG có giao diện cho Tenant tự tạo vai trò mới: Chức năng quản lý RBAC trong MVP chỉ dành cho vai trò SUPER_ADMIN. Tenant chỉ có thể sử dụng các vai trò đã được tạo sẵn.
• KHÔNG có trình chỉnh sửa bản đồ 3D trực quan: Việc quản lý bản đồ sẽ được thực hiện ở mức độ đơn giản, ví dụ như tải lên một file đã được định dạng sẵn. Sẽ không có công cụ kéo-thả để chỉnh sửa bản đồ trực tiếp trên web.