Sản phẩm Phase A Built
Module Sản phẩm là danh mục hàng hóa của merchant. Chủ cửa hàng và quản lý định nghĩa thứ họ bán — sản phẩm, các biến thể bán được nằm 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. Mọi thứ bán qua POS, online, hay bất kỳ kênh nào đề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ủ / Quản lý (thiết lập danh mục) · Thu ngân / Nhân viên (tra cứu tại POS) |
2. Mục đích & Phạm vi
| Bao gồm | Loại trừ |
|---|---|
| Sản phẩm, nhóm hàng, và hình ảnh sản phẩm | Định mức nguyên vật liệu (BOM) / quản lý công thức → Kho |
| Biến thể (đơn vị bán) + loại biến thể | Mức tồn 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 hàng & 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 | Nhập hàng loạt / CSV (Dự kiến) |
| Bundle (combo, add-on, thường-mua-cùng) | 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ì | Trạng thái |
|---|---|---|
| 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 | Built |
| 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ữ | Built |
| Nhóm hàng | Gom nhóm sản phẩm; đánh dấu nhóm là add-on | Built |
| Hình ảnh sản phẩm | Đính kèm media cho sản phẩm và biến thể | Built |
| Biến thể mặc định | Mỗi sản phẩm tự động có một biến thể khi tạo | Built |
| Định danh | Tra cứu theo SYSTEM, SLUG, SKU, BARCODE, QRCODE | Built |
| Biến thể | Thêm nhiều biến thể bán được cho mỗi sản phẩm (nguyên tử cùng info, fares, IDs) | Built |
| Loại biến thể | STORABLE, CONSUMABLE, SERVICE, KIT, COMBO, MANUFACTURED | Built |
| Đơn vị đo lường | Đơn vị cơ sở / mua / bán lưu theo từng biến thể | Built |
| 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 | Built |
| 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 | Built |
| Bundle | Quan hệ combo, add-on, và thường-mua-cùng | Built |
| Khoảng thời gian hiệu lực | Biến thể chỉ khả dụng trong cửa sổ hiệu lực | Built |
| 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 | Planned |
| Khuyến mãi | Chiến dịch chiết khấu (tạo/quản lý) | In-progress |
| Quy đổi đơn vị | Mua theo đơn vị này, bán theo đơn vị khác | Planned |
| Nhập hàng loạt / CSV | Tải danh mục từ bảng tính | Planned |
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 |
| Kho | Biến thể quản lý tồn sinh ra mục kho; BOM nằm ở đây |
| Đơn hàng | Biến thể là thứ được bán trong một đơn hàng |
| 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 |
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ủ | Quản lý đầy đủ danh mục trong các merchant của mình | Xem sản phẩm của tổ chức khác |
| Quản lý / Nhân viên | Xem và tra cứu sản phẩm trong các merchant được phân công | Xem các merchant 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
- Test Cases
- PRDs
- Module Commerce · Module Kho
- Lập trình viên: package commerce · package pricing