Khách hàng & CRM Phase P1 Built

Tài liệu nghiệp vụ (BA)

UC — Use Case · SRS — Đặc tả yêu cầu · UI — Đặc tả giao diện

Khách hàng & CRM là nguồn dữ liệu khách hàng trung tâm của sân Pickleball: lưu hồ sơ khách, phân biệt khách lẻ với member, vận hành chương trình thành viên theo bậc và tích điểm/voucher. Mọi quầy POS, lịch đặt sân và sự kiện đều tra cứu khách từ đây; sau mỗi giao dịch dữ liệu chi tiêu và điểm được cập nhật ngược về hồ sơ.

Trạng thái: Built (P1) · Map từ: OW-06 · Người dùng chính: Thu ngân · Quản lý ca · Chủ sân · Rà soát: 2026-06-15

1. Định danh

Thuộc tính	Giá trị
Module ID	OW-06
Hạng	Core
Trạng thái	Built
Giai đoạn	P1 (hồ sơ, lookup, lịch sử, công nợ) · P2 (member theo bậc, điểm, voucher)
Ưu tiên	HIGH
Người dùng chính	Thu ngân · Quản lý ca · Chủ sân · Viewer

2. Mục đích & Phạm vi

Bao gồm	Loại trừ
Hồ sơ khách: tên · SĐT · email · ngày sinh · ghi chú nội bộ	Gắn khách vào đơn & tạo đơn (do Bán hàng POS sở hữu)
Khách lẻ (walk-in) vs member có hồ sơ	Tính giá & áp giảm trên giỏ (do Bảng giá sở hữu)
4 bậc thành viên (Standard / Silver / Gold / VIP) theo tổng chi tiêu	Phát hành booking & giữ slot (do Đặt sân sở hữu)
Tích điểm, đổi điểm lấy voucher / giờ chơi	Vòng đời đơn hàng POS (do Bán hàng POS sở hữu)
Lịch sử giao dịch: đặt sân · mua hàng · sự kiện · nợ · điểm	Báo cáo doanh thu tổng hợp (do Báo cáo sở hữu)
Quản lý công nợ: ghi nợ, thu nợ, cảnh báo nợ quá hạn
Cảnh báo churn: khách không quay lại sau 90 ngày

3. Năng lực

Năng lực	Người dùng làm được gì	Trạng thái
Hồ sơ khách	Thêm/sửa khách, gắn tag phân nhóm (VIP/Thường xuyên/Khách mới)	Built
Lookup theo SĐT	Tra cứu khách trong POS/đặt sân, tự điền tên + bậc + điểm	Built
Khách lẻ vs member	Đơn mặc định "Khách Lẻ"; gắn member để hưởng ưu đãi	Built
4 bậc thành viên	Tự nâng/giữ bậc theo tổng chi tiêu, ưu đãi theo bậc	In-progress
Tích / đổi điểm	Cộng điểm sau mỗi đơn; đổi điểm lấy voucher / giờ chơi	In-progress
Gắn khách vào đơn POS	Chọn member trong POS để áp voucher, điểm và cộng điểm	Built
Lịch sử giao dịch	Xem timeline đặt sân, mua hàng, sự kiện, tổng chi tiêu	Built
Quản lý công nợ	Ghi nợ khi thiếu tiền, thu nợ, cảnh báo nợ quá hạn	Built
Cảnh báo churn	Đánh dấu khách INACTIVE sau 90 ngày không giao dịch	In-progress

4. Phụ thuộc Module

Phụ thuộc vào	Lý do
Phân quyền	Giới hạn phạm vi chi nhánh; chỉ Owner cấu hình bậc & tỉ lệ điểm
Bán hàng POS	Gắn khách vào đơn; nhận dữ liệu chi tiêu & điểm sau mỗi giao dịch
Đặt sân	Lookup khách khi đặt; ghi lịch sử đặt sân vào hồ sơ
Sự kiện	Danh sách người đăng ký giải đấu lấy từ hồ sơ khách

5. Backend Packages

Chi tiết triển khai nằm trong tài liệu lập trình viên - mục này chỉ ánh xạ module tới các service vận hành nó.

Package	Vai trò	Tài liệu lập trình viên
@nx/customer	Sở hữu hồ sơ khách, lookup, lịch sử giao dịch, công nợ	customer
@nx/loyalty	Bậc thành viên, tích/đổi điểm, voucher	loyalty

6. Luồng người dùng chính

Lookup & gắn khách trong POS

Tích điểm sau thanh toán

7. Vai trò & Phân quyền

Vai trò	Được phép	Không được phép
Chủ sân (Owner)	Toàn quyền · cấu hình bậc thành viên, tỉ lệ điểm, giới hạn nợ	-
Quản lý ca (Manager)	Xem/thêm/sửa khách, quản lý nợ, đổi điểm, gắn tag	Cấu hình bậc & tỉ lệ điểm
Thu ngân (Cashier)	Tìm/tạo khách, ghi nợ trong hạn mức, thu nợ, đổi điểm tại POS	Cấu hình bậc · gắn tag · ghi nợ vượt hạn mức
Viewer	Xem danh sách & lịch sử khách (read-only)	Thêm/sửa khách, công nợ, điểm

8. Trạng thái & Lộ trình

Giai đoạn	Năng lực
P1	Hồ sơ khách, lookup theo SĐT, lịch sử giao dịch, ghi/thu nợ, ghi chú nội bộ, tag
P2	4 bậc thành viên tự nâng, tích/đổi điểm, voucher, thẻ thành viên QR, cảnh báo nợ quá hạn, segment marketing
P3	Customer 360 (LTV · churn risk score), AI dự đoán churn & gợi ý ưu đãi giữ chân

9. Trang liên quan

• Bán hàng POS · Đặt sân · Sự kiện
• Bảng giá · Báo cáo · Phân quyền
• Tài liệu lập trình viên: Customer Service