PRD: KH Doanh nghiệp & Nhóm khách
| Module | Khách hàng | PRD ID | PRD-BIZ-001 |
| Trạng thái | Sẵn sàng dev | FEAT | BIZ · BANA-1427 |
| Epic | BANA-1322 | Plane | BANA-1535 |
| Ngày | 2026-06-11 | Phiên bản | v0.1 |
| Gói | @nx/identity | URD | BIZ |
| Surface | Client · Chủ/QL | ||
| Phụ trách | Hải Cao · Khoa Nguyễn · Phát Nguyễn | ||
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ó khái niệm nhóm. Điều đó chặn B2B lặp lại được: đường hóa đơn đã mang được MST người mua, nhập ad-hoc lúc phát hành, nhưng không lấy từ một hồ sơ khách đã lưu, nên chưa có khách doanh nghiệp tái sử dụng để ra HĐ VAT công ty đúng cho từng đơn. Việc thiếu trường khách cũng chặn giá theo phân khúc (E10) - cần nhóm tồn tại trước. Màn khách cơ bản (list/detail/create/edit) đã có sẵn trên các bề mặt nhân viên và chỉ cần mở rộng với trường doanh nghiệp và nhóm.
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 khách cho chủ quán và vận hành (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. Câu chuyện người dùng
- 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 thì MST tự lên hóa đơn.
9. Dữ liệu & Miền nghiệp vụ
- Mở rộng hồ sơ khách với trường doanh nghiệp; thêm khái niệm nhóm khách hàng + membership.
- Đường hóa đơn đã mang MST người mua ad-hoc; việc này lấy MST đó từ hồ sơ khách được chọn (phía người mua, khác với luồng tax-info 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) | Bên dùng nhóm - mô hình nhóm 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