PRD: Cổng Backoffice
| Module | Commerce (CORE-03) | PRD ID | PRD-BOP-001 |
| Trạng thái | Planned | Owner | Hải Cao · Phát Nguyễn |
| Ngày | 2026-06-11 | Phiên bản | v0.1 (draft) |
| Packages | @nx/commerce · @nx/helpdesk · apps/bo | URD | BOP |
| Epic | BANA-1337 | Khung thời gian | T6 (onboard+cấu hình) · T7 (import) · T8 (hỗ trợ+dashboard) |
TL;DR
Vận hành viên chạy một client end-to-end chỉ từ BO: onboard (org → merchant MST → kênh → loại hình), cấu hình mọi thứ client cần, import catalog từ một file Excel, xử lý phiếu hỗ trợ, và theo dõi mức sử dụng trên dashboard quản trị.
1. Bối cảnh & Vấn đề
Các mảnh đã có nhưng chưa thành một cổng: BE onboarding và wizard BO đã có; màn cấu hình đã có cho mẫu danh mục, nhóm thuế, licensing - nhưng cấu hình thanh toán và tra cứu giao dịch đang chôn ở phạm vi merchant; import Excel hoàn toàn chưa có; helpdesk backend giàu tính năng và client đã có UI phiếu nhưng BO chưa có dashboard phiếu; và chưa có cái nhìn quản trị về cửa hàng/giao dịch. Vận hành một client hôm nay đồng nghĩa nhảy giữa các công cụ và nhờ dev.
2. Mục tiêu & Loại trừ
Mục tiêu - onboard chỉ từ BO (URD-BOP-001) · cấu hình đủ từ BO (002, 008) · tra cứu giao dịch cấp quản trị (003) · import Excel báo lỗi theo dòng + import lại không trùng (004) · Support Center trong BO (005, 006) · dashboard quản trị (007).
Loại trừ - màn phía client (merchant) · analytics hành vi ngoài 2 view dashboard · nhật ký API (sau).
3. Thước đo thành công
| Thước đo | Mục tiêu |
|---|---|
| Thời gian onboard + cấu hình 1 client | Một phiên BO, không cần dev |
| Import catalog | Bảng tính → catalog bán được, dòng lỗi báo theo dòng |
4. Persona & Tình huống
Vận hành BO (NEXPANDO/VNPAY ops): onboard & hỗ trợ client · Quản trị: theo dõi mức dùng (cửa hàng, giao dịch).
5. User Story
- Là vận hành, tôi onboard một client vừa ký và cấu hình gói, mẫu, nhóm thuế trong một lần ngồi.
- Là vận hành, tôi import danh sách sản phẩm của client từ Excel và chỉ sửa các dòng nó báo.
- Là agent hỗ trợ, tôi xử lý phiếu (danh sách → chi tiết → đóng) ngay trong BO.
6. Yêu cầu chức năng
Giao URD BOP URD-BOP-001…008 (Must 001-005).
7. Yêu cầu phi chức năng
- Import xử lý hàng nghìn dòng với tiến trình rõ; mọi thao tác BO tuân thủ phân quyền per-merchant (E11).
8. UX & Luồng
- Onboard (T6): wizard org → merchant (MST) → kênh → loại hình → checklist hoàn tất.
- Cấu hình (T6): gói & giấy phép · lĩnh vực & mẫu danh mục · nhóm thuế · phương thức thanh toán (cấp quản trị) · tra cứu giao dịch (cấp quản trị).
- Import (T7): upload Excel → validate → lỗi theo dòng → áp → import lại an toàn.
- Hỗ trợ + giám sát (T8): danh sách/chi tiết phiếu, cấu hình SLA/danh mục/agent; dashboard cửa hàng theo ngành + giao dịch theo cửa hàng.
9. Dữ liệu & Miền nghiệp vụ
- Onboard tái dùng endpoint atomic sẵn có; import là pipeline Excel mới (danh mục → sản phẩm/variant → giá → thuế, theo thứ tự phụ thuộc); hỗ trợ tái dùng backend helpdesk.
10. Phụ thuộc & Giả định
| Phụ thuộc | Vì sao |
|---|---|
| Phân quyền per-merchant + tách user BO (E11, T6) | Vai trò operator/admin gác cổng |
| Mẫu Retail (PRD-RTL-001) | Cấu hình mẫu lĩnh vực phủ bán lẻ |
| Backend helpdesk | Mặt tiền Support Center |
11. Rủi ro & Câu hỏi mở
- Định dạng file import: chốt template sớm (1 sheet hay nhiều sheet).
- Package helpdesk từng lỗi build - verify trước lát cắt T8.
12. Kế hoạch phát hành & Tiêu chí
T6: lát onboard + cấu hình. T7: import. T8: hỗ trợ + dashboard. Ra mắt: AC-BOP-01 pass - một client được onboard, cấu hình và import chỉ từ BO.
13. FAQ
- Có phải app mới không? Không - là hoàn thiện
apps/bothành cổng vận hành thực thụ.
Tham chiếu
URD BOP · Giai đoạn 2 - Theo tháng · Epic BANA-1337