Đơn hàng Phase A In-progress

Đơn hàng là trái tim giao dịch của POS: một đơn hàng đóng cả vai trò giỏ và đơn đã cam kết, di chuyển từ nháp qua checkout tới thanh toán. Với merchant F&B nó thêm phiếu bếp, đặt bàn, tách hóa đơn, và phiên ca thu ngân.

1. Định danh

Thuộc tính	Giá trị
Module ID	CORE-07
Tier	Core
Trạng thái	In-progress
Phase	P1 (đơn hàng cơ bản) · P2 (bếp, phiên, đặt bàn, tách)
Mức ưu tiên	HIGH
Người dùng chính	Thu ngân · Nhân viên bếp · Lễ tân · Quản lý · Chủ

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

Bao gồm	Loại trừ
Vòng đời sale order (DRAFT → PROCESSING → PARTIAL → COMPLETED / CANCELLED)	Biến đổi tồn (do Kho sở hữu)
Mục đơn hàng — sản phẩm (gồm fan-out combo) và dòng tùy chỉnh	Tích hợp nhà cung cấp thanh toán (do Thanh toán sở hữu)
Checkout, revert, cancel, gộp / tách đơn	Engine tính thuế & phát hành hóa đơn điện tử (Thuế & Hóa đơn)
Tách hóa đơn (sale checks)	Flow hoàn / trả hàng (Dự kiến)
Phiếu bếp & trạm (F&B, KDS)	Menu hướng khách hàng
Phiên / ca POS với báo cáo X/Z	Engine phần thưởng loyalty (chỉ tích điểm nằm ở đây)
Đặt bàn	In hóa đơn (mối quan tâm frontend)
Tích điểm loyalty trên đơn hoàn tất
Cập nhật real-time tới bếp & dashboard

3. Năng lực

Năng lực	Người dùng có thể làm gì	Trạng thái
Đơn nháp (giỏ)	Tạo một đơn, thêm / cập nhật / gỡ mục — chỉ sửa được ở DRAFT	Built
Mục combo	Thêm một sản phẩm combo; nó fan-out thành các dòng con có giá tự động	Built
Checkout	Khóa giá và chuyển DRAFT → PROCESSING sẵn sàng cho thanh toán	Built
Revert về giỏ	Hủy một checkout: PROCESSING → DRAFT	Built
Cancel đơn	Cancel từ DRAFT, PROCESSING, hoặc PARTIAL	Built
Thanh toán một phần & đủ	PARTIAL khi trả thiếu, COMPLETED khi trả đủ	Built
Tách / gộp đơn	Tách một nháp thành nhiều, hoặc gộp nhiều nháp (chỉ DRAFT)	Built
Liên kết khách hàng	Đính một khách hàng vào đơn	Built
Đa tiền tệ	Đặt tiền tệ + tỉ giá theo từng đơn (mặc định VND)	Built
Tách hóa đơn	Chia một hóa đơn thành các check trả độc lập	Built
Phiếu bếp	Gửi mục tới bếp; theo dõi trạng thái phiếu & mục; cập nhật KDS live	Built
Trạm bếp	Định tuyến nhóm hàng tới các trạm có tên với cấu hình máy in	Built
Phiên POS	Mở / đóng một ca theo từng thiết bị với đối chiếu tiền mặt và báo cáo X/Z	Built
Đặt bàn	Đặt một bàn cho thời gian tương lai; check in để sinh một đơn	Built
Điểm loyalty	Tích điểm trên đơn hoàn tất	Built
Flow hoàn tiền	Hoàn tiền có cấu trúc với trả tồn	Planned

4. Phụ thuộc Module

Phụ thuộc vào	Lý do
Sản phẩm	Mục đơn hàng tham chiếu biến thể sản phẩm; combo mở rộng qua bundle sản phẩm
Kho	Tồn được reserve khi thêm-vào-giỏ và tiêu thụ khi thanh toán / phục vụ
Thanh toán	Event thanh toán điều khiển chuyển PARTIAL / COMPLETED / CANCELLED

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/sale	Sở hữu vòng đời giỏ-và-đơn, checkout, check, bếp, phiên, đặt bàn, điểm	sale

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

Vòng đời đơn hàng

Checkout

Phiếu bếp

Phiên POS

7. Vai trò & Quyền hạn

Vai trò	Có thể	Không thể
Thu ngân	Tạo / sửa nháp, checkout, nhận thanh toán, gửi tới bếp, mở / đóng phiên của mình	Duyệt hoàn tiền (Dự kiến)
Nhân viên bếp	Xem hàng đợi phiếu, tiến mục đang nấu → sẵn sàng → đã phục vụ, void	Nhận thanh toán, sửa giá
Lễ tân	Tạo và quản lý đặt bàn, check in khách	Nhận thanh toán
Quản lý / Chủ	Mọi hành động thu ngân cộng xem báo cáo X/Z và đối chiếu ca	—

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

Phase	Năng lực
P1	Đơn nháp, quản lý mục, checkout / revert, cancel, thanh toán một phần & đủ
P2	Fan-out combo, tách / gộp đơn, tách hóa đơn, phiếu bếp & trạm, phiên POS, đặt bàn, tích điểm loyalty, cập nhật real-time
P3	Flow hoàn / trả hàng, app KDS chuyên biệt, quản lý sơ đồ bàn, theo dõi giao hàng, template đơn hàng

9. Trang Liên quan

• URD
• Test Cases
• PRDs
• Sản phẩm · Kho · Thanh toán
• Tài liệu lập trình viên: Sale Service