KingstonVN - Sa Bàn Điều Hành Đóng Gói Đa Thùng & Trừ Kho MES (MES-PKG v2)

📍 Chọn Kịch Bản Thử Nghiệm:

Trạng thái Đơn hàng: CONFIGURED (VALID)

📋 Cụm Linh Kiện & BOM Pool

Đơn hàng: 10 Bộ

Bảng kiểm chéo ma trận định mức BOM tiêu chuẩn (Strict Validation Hard Block). Tổng số linh kiện chia vào các thùng phải bằng đúng 100% định mức 1 bộ sản phẩm:

Hạng Mục BOM	Loại	Cần (1 Bộ)	Đã Chia	Khớp

✓ Cấu hình khớp 100% định mức BOM. Sẵn sàng sản xuất!

🛠️ Configurator Chia Thùng (OrderItem Specs)

⚠️ Cấu hình chia thùng và phân bổ linh kiện áp dụng cho đúng 1 đơn vị bộ sản phẩm/Set. Số thùng sản xuất thực tế sẽ tự động nhân lên theo quy mô đơn hàng.

Lập kế hoạch quy cách đóng gói

🏭 Quét Barcode & Trừ Kho MES

Trạm PKG

📊 Tiến Độ Bộ Sản Phẩm Hoàn Chỉnh Unit-Level

Sẵn sàng xuất xưởng giao hàng: 0 / 10 Bộ (0%)

Nhật ký quét barcode thùng thực tế tại xưởng PKG:

📦 Tồn Kho Xưởng Đóng Gói (PKG) *Backflushing trừ kho real-time

Mã Hạng Mục	Tồn Kho	An Toàn

🔄 Sơ Đồ Luồng Tích Hợp Data Flow & API RESTful Endpoints

Quy trình xử lý dữ liệu từ Sales Order -> Lập quy cách chia thùng -> Quét barcode xưởng PKG -> Trừ kho backflushing & Tự động cập nhật OrderItem.status.

📌 Danh Sách Endpoints REST API Khai Báo trong Backend (api-kingston):

GET /api/admin/orders/:orderId/packing-specs — Lấy cấu hình đóng gói thực tế và tiến độ của cả đơn hàng.
PUT /api/admin/orders/:orderId/packing-specs — Planner lưu cấu hình đóng gói thực tế cho đơn hàng (Thực thi kiểm tra validateOrderPackingConfig).
POST /api/admin/orders/packing-specs/:specId/report-progress — Xưởng PKG báo cáo hoàn thành thùng đóng gói { quantityPackedChange: number } (Trừ kho backflushing real-time).