PRD: KH Doanh nghiệp & Nhóm khách
| Module | Khách hàng (CORE-09) | PRD ID | PRD-BIZ-001 |
| Trạng thái | Planned | Owner | Hải Cao · Khoa Nguyễn · Phát Nguyễn |
| Ngày | 2026-06-11 | Phiên bản | v0.1 (draft) |
| Packages | @nx/identity · apps/client · apps/bo | URD | BIZ |
| Epic | BANA-1322 | Khung thời gian | Tháng 7/2026 |
TL;DR
Merchant bán cho công ty: hồ sơ khách mang MST và tên công ty người mua, để HĐ VAT công ty đúng chuẩn - và khách xếp được vào nhóm (VIP, member) cho định giá và marketing nhắm tới. Một trong ba lý do cốt lõi Phase 2 tồn tại.
1. Bối cảnh & Vấn đề
Hồ sơ khách hôm nay có tên/SĐT/email/điểm - không MST, không tên công ty, và chưa có thực thể nhóm. Điều đó chặn B2B: HĐ VAT công ty không mang được MST người mua. Nó cũng chặn giá theo phân khúc (E10) - cần nhóm tồn tại trước. Màn client (list/detail/create/edit) có sẵn để mở rộng; BO chưa có.
2. Mục tiêu & Loại trừ
Mục tiêu - trường doanh nghiệp MST + công ty (URD-BIZ-001) · phân biệt DN/cá nhân (002) · MST lên HĐ VAT (003) · nhóm + gán (004) · nhóm mở cho pricing (005) · màn client + BO (006).
Loại trừ - thay đổi loyalty · quy tắc gán tự động (007, Could) · công nợ (Finance PRD-LDG-001).
3. Thước đo thành công
| Thước đo | Mục tiêu |
|---|---|
| Hóa đơn B2B | HĐ VAT công ty mang MST + tên công ty, end-to-end |
| Nhóm | Pricing dùng được ở T8 không phải sửa lại |
4. Persona & Tình huống
Chủ quán bán cho công ty (cần hóa đơn chuẩn) · Thu ngân chọn đúng người mua nhanh · Marketing/pricing nhắm theo nhóm.
5. User Story
- Là chủ quán, tôi thêm "Cty TNHH ABC" với MST một lần; mọi hóa đơn sau cho họ đều đúng.
- Là chủ quán, tôi xếp khách quen vào "VIP" và đặt giá cho nhóm đó vào T8.
6. Yêu cầu chức năng
Giao URD BIZ URD-BIZ-001…006 (Must 001-004).
7. Yêu cầu phi chức năng
- MST validate khi nhập (định dạng + tra cứu nếu có); lọc nhóm nhanh trên danh sách khách lớn.
8. UX & Luồng
- Form khách: toggle loại (cá nhân/doanh nghiệp) → doanh nghiệp hiện MST + công ty; validate MST tại chỗ.
- Nhóm: quản lý nhóm, gán từ danh sách/chi tiết (chọn nhiều).
- Thanh toán/hóa đơn: chọn khách doanh nghiệp là MST theo lên hóa đơn.
9. Dữ liệu & Miền nghiệp vụ
- Mở rộng schema khách với trường doanh nghiệp; thực thể CustomerGroup + membership mới.
- Đường hóa đơn tiêu thụ MST của khách (đối ứng luồng taxInfo của merchant phía bán).
10. Phụ thuộc & Giả định
| Phụ thuộc | Vì sao |
|---|---|
| Đường phát hành hóa đơn (đã ship) | Nơi MST đáp xuống |
| Pricing (T8) | Người tiêu thụ nhóm - schema phải ổn định trước cuối T7 |
11. Rủi ro & Câu hỏi mở
- Nguồn validate MST (checksum hay tra cứu đăng ký) - chốt khi design.
- Migrate khách cũ: mặc định tất cả là cá nhân.
12. Kế hoạch phát hành & Tiêu chí
Build T7 (WK27-31). Ra mắt: AC-BIZ-01 pass - một đơn B2B thật ra HĐ VAT công ty chuẩn; nhóm gán được.
13. FAQ
- Nhóm có ảnh hưởng giá ngay không? T7 chưa - Pricing tiêu thụ ở T8 (E10).
Tham chiếu
URD BIZ · Giai đoạn 2 - Theo tháng · Epic BANA-1322