Sản phẩm Phase A Built
Module Sản phẩm là danh mục những thứ sân bán ngoài giờ thuê sân - đồ uống và đồ ăn (FNB), dụng cụ thi đấu (vợt, bóng, phụ kiện) và các item dịch vụ. Chủ sân và quản lý ca định nghĩa sản phẩm, các biến thể bán được dưới mỗi sản phẩm, giá (fares) mà các biến thể đó mang, nhóm hàng để gom chúng lại, và các mã (SKU, barcode, QR) dùng để tra cứu tại quầy. Mọi thứ bán qua POS tại sân đều bắt đầu từ đây.
1. Định danh
| Thuộc tính | Giá trị |
|---|---|
| Module ID | CORE-05 |
| Tier | Core |
| Trạng thái | Built |
| Phase | P1 (danh mục) · P2 (biến thể + fares) · P3 (loại nâng cao + khuyến mãi) |
| Mức ưu tiên | HIGH |
| Người dùng chính | Chủ sân / Quản lý ca (thiết lập danh mục) · Thu ngân (tra cứu tại quầy) |
2. Mục đích & Phạm vi
| Bao gồm | Loại trừ |
|---|---|
| Sản phẩm FNB, dụng cụ, item dịch vụ, nhóm hàng và hình ảnh sản phẩm | Định mức nguyên vật liệu (BOM) / công thức pha chế → Kho |
| Biến thể (đơn vị bán) + loại biến thể | Mức tồn dụng cụ/đồ uống theo địa điểm → Kho |
| Định giá qua fares (cơ bản, theo bậc, theo thời gian/số lượng/kênh) | Xử lý đơn POS & thanh toán → Đơn hàng |
| Định danh sản phẩm & biến thể (SYSTEM, SLUG, SKU, BARCODE, QRCODE) | Thuế suất & hóa đơn điện tử → Thuế & Hóa đơn |
| Khả dụng theo kênh bán (quầy sân, đặt sân online) | Nhập hàng loạt / CSV (Dự kiến) |
| Bundle (combo nước + đồ ăn, add-on thuê vợt) | Tính chiết khấu khuyến mãi (Đang thực hiện) |
3. Năng lực
| Năng lực | Người dùng có thể làm gì |
|---|---|
| Danh mục sản phẩm | Tạo, cập nhật, vô hiệu hóa, lưu trữ, và kích hoạt lại sản phẩm (đồ uống, dụng cụ, dịch vụ) |
| Thông tin đa ngôn ngữ | Tên & mô tả theo từng sản phẩm / biến thể bằng nhiều ngôn ngữ |
| Nhóm hàng | Gom nhóm sản phẩm (Nước, Đồ ăn, Vợt, Bóng, Phụ kiện); đánh dấu nhóm là add-on |
| Hình ảnh sản phẩm | Đính kèm media cho sản phẩm và biến thể |
| Biến thể mặc định | Mỗi sản phẩm tự động có một biến thể khi tạo |
| Định danh | Tra cứu theo SYSTEM, SLUG, SKU, BARCODE, QRCODE |
| Biến thể | Thêm nhiều biến thể bán được cho mỗi sản phẩm (ví dụ vợt theo độ cứng, nước theo dung tích) |
| Loại biến thể | STORABLE, CONSUMABLE, SERVICE, KIT, COMBO, MANUFACTURED, ENTITLEMENT |
| Tùy chọn sản phẩm | Định nghĩa trục option & giá trị có thứ tự; mỗi biến thể liên kết một giá trị mỗi trục, tổ hợp duy nhất |
| Đơn vị đo lường | Đơn vị cơ sở / mua / bán lưu theo từng biến thể |
| Khả dụng theo kênh bán | Kiểm soát sản phẩm nào hiển thị ở kênh nào (quầy sân, đặt sân online) |
| Fares (định giá) | Một bộ fare cho mỗi biến thể; giá theo bậc theo số lượng, thời gian, kênh |
| Bundle | Quan hệ combo, add-on, và thường-mua-cùng (ví dụ thuê vợt + ống bóng) |
| Khoảng thời gian hiệu lực | Biến thể chỉ khả dụng trong cửa sổ hiệu lực |
| Endpoint đọc giá biến thể | Lấy giá đã giải quyết của một biến thể một cách độc lập |
| Khuyến mãi | Chiến dịch chiết khấu (tạo/quản lý) |
| Quy đổi đơn vị | Mua theo đơn vị này (thùng nước), bán theo đơn vị khác (chai) |
| Nhập hàng loạt / CSV | Tải danh mục từ bảng tính |
Khuyến mãi có thể được tạo và quản lý hiện tại, nhưng engine tính chiết khấu đang bị tắt - chiết khấu chưa được áp dụng tự động tại thời điểm định giá. Xem tài liệu Khuyến mãi cho lập trình viên.
4. Phụ thuộc Module
| Phụ thuộc vào | Lý do |
|---|---|
| Commerce | Sản phẩm và nhóm hàng được giới hạn theo merchant (sân) |
| Kho | Biến thể quản lý tồn (đồ uống, dụng cụ) sinh ra mục kho; BOM nằm ở đây |
| Đơn hàng | Biến thể là thứ được bán trong một đơn POS tại sân |
| Thuế & Hóa đơn | Nhóm thuế được áp cho sản phẩm |
5. Backend Packages
Chi tiết triển khai nằm trong tài liệu lập trình viên - phần 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/commerce | Sản phẩm, biến thể, nhóm hàng, định danh, bundle, kênh bán | commerce |
@nx/pricing | Bộ fare, fares, rules, chọn fare, khuyến mãi | pricing |
@nx/core | Schema dùng chung cho mọi thực thể danh mục | core |
Engineering Mapping (Feature ⇄ Package)
Trục ngang của Feature Spine - mỗi tính năng nghiệp vụ (
<AREA>trong URD) ánh xạ tới nơi triển khai của nó. Đối ứng: tài liệu package liên kết ngược về đây.
| Tính năng | Package | Trạng thái |
|---|---|---|
PRD Danh mục Sản phẩm | @nx/commerce · @nx/core | Built |
CAT Nhóm hàng | @nx/commerce | Built |
PID Định danh | @nx/commerce | Built |
ACC Kiểm soát Truy cập | @nx/commerce | Built |
VAR Biến thể | @nx/commerce | Built |
BND Combo & Gói bán kèm | @nx/core · @nx/commerce · @nx/sale | Built |
OPT Tùy chọn Sản phẩm | @nx/commerce · @nx/core | Built |
FAR Fares / Định giá | @nx/pricing · @nx/commerce | Built |
SCH Kênh bán hàng | @nx/commerce · @nx/core · @nx/search | Built |
CMP Khuyến mãi | @nx/pricing | In-progress |
6. Luồng Người dùng Chính
Tạo sản phẩm (aggregate)
Giải quyết fare (khi bán)
7. Vai trò & Quyền hạn
| Vai trò | Có thể | Không thể |
|---|---|---|
| Chủ sân | Quản lý đầy đủ danh mục trong các sân của mình | Xem sản phẩm của tổ chức khác |
| Quản lý ca / Thu ngân | Xem và tra cứu sản phẩm trong các sân được phân công | Xem các sân không được phân công |
| Admin / Super Admin | Xem xuyên suốt mọi tổ chức (bỏ qua lọc theo vai trò) | - |
8. Trạng thái & Lộ trình
| Phase | Năng lực |
|---|---|
| P1 | CRUD sản phẩm, nhóm hàng, hình ảnh, biến thể mặc định, fare cơ bản, định danh SYSTEM/SLUG |
| P2 | Nhiều biến thể (aggregate), định danh đa lược đồ, fares theo bậc (ngày/số lượng), khả dụng theo kênh bán, bundle |
| P3 | Loại biến thể nâng cao (KIT/COMBO/MANUFACTURED với BOM), UOM, engine chiết khấu khuyến mãi, nhập CSV |
Loại biến thể và lưu trữ UOM đã được xây dựng; các hành vi tiêu hao BOM, quy đổi đơn vị, và chiết khấu khuyến mãi hoàn thiện P3 vẫn đang chờ - xem bảng Năng lực.
9. Trang Liên quan
- URD
- PRDs
- Module Commerce · Module Kho
- Lập trình viên: package commerce · package pricing