Kho Phase A In-progress
Kho là nơi merchant theo dõi tồn vật lý — họ có bao nhiêu, nó nằm ở đâu, và mọi biến động ra vào. Chủ nhận hàng qua đơn mua hàng, vận hành kho qua phiếu, và (với F&B) tự động trừ nguyên liệu qua công thức. Mọi thay đổi được ghi vào một audit trail bất biến.
1. Định danh
| Thuộc tính | Giá trị |
|---|---|
| Module ID | CORE-06 |
| Tier | Core |
| Trạng thái | In-progress |
| Phase | P1 (Tồn đơn giản) · P2 (Đa địa điểm) · P3 (BOM + Nâng cao) |
| Mức ưu tiên | HIGH |
| Người dùng chính | Chủ / Quản lý / Thu ngân (đọc khả dụng) |
2. Mục đích & Phạm vi
| Bao gồm | Loại trừ |
|---|---|
| Mức tồn theo từng mục theo từng địa điểm (on-hand, reserved, available) | Định giá tồn đa tiền tệ |
| Địa điểm kho (warehouse) với phân cấp + mặc-định-mỗi-merchant | BOM đa cấp / cụm lắp ráp con |
| Audit trail bất biến của mọi biến động tồn | Phần trăm hao hụt / sản lượng công thức |
| Catalog vendor + đơn mua hàng với nhận hàng | Tích hợp quét barcode đầy đủ |
| Phiếu kho (chuyển, điều chỉnh, kiểm kê, trả hàng, hủy bỏ) | Chuyển tồn giữa các merchant |
| Catalog nguyên vật liệu + công thức (BOM) + explosion runtime | Báo cáo định giá tồn (AVCO/FIFO/LIFO) |
| Lệnh sản xuất + catalog đơn vị đo lường | Bắt buộc lot / serial / hạn dùng |
3. Năng lực
| Năng lực | Người dùng có thể làm gì | Trạng thái |
|---|---|---|
| Theo dõi tồn | Xem số lượng on-hand, reserved, và available theo từng mục theo từng địa điểm. | Built |
| Tự trừ khi bán | Tồn giảm tự động khi một thanh toán thành công. | Built |
| Điều chỉnh thủ công | Sửa mức tồn bằng biến động có kiểu, có mã lý do. | Built |
| Địa điểm mặc định | Một kho mặc định được tạo tự động cho mỗi merchant. | Built |
| Quản lý vendor | Duy trì catalog nhà cung cấp theo từng merchant. | Built |
| Đơn mua hàng | Tạo PO, nhận hàng, và cập nhật tồn qua một vòng đời đầy đủ. | Built |
| Audit trail bất biến | Mọi biến động được ghi log với số lượng trước/sau; không bao giờ sửa. | Built |
| Nhiều kho | Tạo và quản lý nhiều địa điểm kho theo từng merchant. | In-progress |
| Phiếu kho | Chạy thao tác chuyển, điều chỉnh, kiểm kê, trả hàng, và hủy bỏ. | In-progress |
| Catalog nguyên vật liệu (BOM) | Theo dõi nguyên liệu thô tách biệt với sản phẩm bán được. | In-progress |
| Công thức nguyên vật liệu (BOM) | Đính kèm công thức có phiên bản vào biến thể sản phẩm. | In-progress |
| BOM explosion runtime | Tự trừ nguyên liệu khi một mục phiếu bếp đổi trạng thái. | In-progress |
| Lệnh sản xuất | Theo dõi sản xuất với số lượng kế hoạch / thực tế / hao hụt. | Planned |
| Quy đổi đơn vị đo lường | Quy đổi đơn vị 3 cấp đầy đủ vượt khỏi tỉ lệ cơ sở. | Planned |
| Cảnh báo tồn thấp | Thông báo khi tồn rớt dưới ngưỡng (hạ tầng sẵn sàng, UI đang chờ). | In-progress |
4. Phụ thuộc Module
| Phụ thuộc vào | Lý do |
|---|---|
| Sản phẩm | Tồn được theo dõi theo từng biến thể sản phẩm. |
| Commerce | Địa điểm và vendor thuộc về một merchant. |
| Thanh toán | Một thanh toán thành công kích hoạt trừ tồn. |
| Được dùng bởi | Lý do |
|---|---|
| Đơn hàng | Tồn được trừ khi bán. |
| Chi phí | Nhận hàng PO ghi một chi phí finance. |
| Báo cáo | Phân tích kho và báo cáo tồn. |
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/inventory | Sở hữu tồn, địa điểm, theo dõi, vendor, PO, nguyên vật liệu/BOM, phiếu; tiêu thụ event bán/bếp. | inventory |
6. Luồng Người dùng Chính
Nhận hàng (Đơn mua hàng)
Trừ tồn khi bán
BOM Explosion (Bếp F&B)
7. Vai trò & Quyền hạn
| Vai trò | Có thể | Không thể |
|---|---|---|
| Chủ / Quản lý | Tạo địa điểm, vendor, PO, phiếu, nguyên vật liệu, công thức; nhận hàng; điều chỉnh tồn. | Sửa hoặc xóa các mục audit-trail. |
| Thu ngân | Xem khả dụng sản phẩm tại điểm bán. | Biến đổi tồn, PO, hoặc phiếu trực tiếp. |
| Hệ thống | Tự trừ khi bán; explode công thức khi có event bếp; tự tạo địa điểm mặc định. | — |
8. Trạng thái & Lộ trình
| Phase | Năng lực |
|---|---|
| P1 | Theo dõi tồn, tự trừ khi bán, điều chỉnh thủ công, địa điểm mặc định, vendor, đơn mua hàng, audit trail bất biến. |
| P2 | Nhiều kho, phân cấp địa điểm, phiếu kho (6 loại), inventory rules, landed cost. |
| P3 | Catalog nguyên vật liệu, công thức (BOM), BOM explosion runtime, lệnh sản xuất, quy đổi UOM, theo dõi lot/serial. |
Nguyên vật liệu, công thức, và BOM explosion đã được ship hiện tại nhưng phân loại P3 vì chúng nhắm đến mảng dọc F&B; lệnh sản xuất và quy đổi UOM đầy đủ vẫn đang dự kiến.