Đơn hàng

Trang Đơn hàng (/app/orders) quản lý toàn bộ đơn — AI tự tạo từ tin nhắn khách + operator tạo tay. Đây là vòng lặp revenue cốt lõi.

AI tự tạo đơn

Khi khách chốt mua trong chat + Agent có tool “Tạo đơn” bật → AI tự tạo đơn → vào tab Chờ duyệt. Bạn chỉ việc duyệt.

Bố cục

• Tiêu đề: “Đơn hàng” (orders.page_title) — mô tả “Quản lý và theo dõi toàn bộ đơn hàng từ AI và nhân viên.”.
• Nút: Xuất / Làm mới / Tạo đơn.
• 5 tab trạng thái + 5 stat card (bấm card cũng chuyển tab).
• Priority message — banner trên cùng thay đổi theo context: “X đơn cần duyệt…” / “Tất cả đơn đã được xử lý” / “Chưa có đơn hàng nào”.
• Filter (tab Tất cả): Tìm khách + Lọc theo trạng thái.

5 tab + 5 stat card

Tab key	Label (trans)	Icon	Stat label	Stat sub	Tone
all	orders.tab_all	📋	orders.stat_all	orders.stat_all_sub	primary
pending	orders.tab_pending	⏰	orders.stat_pending	orders.stat_pending_sub	warning
confirmed	orders.tab_confirmed	✅	orders.stat_confirmed	orders.stat_confirmed_sub	info
completed	orders.tab_completed	☑️	orders.stat_completed	orders.stat_completed_sub	success
cancelled	orders.tab_cancelled	❌	orders.stat_cancelled	orders.stat_cancelled_sub	destructive

Status badges

Status key	Trans key	Badge class
pending	orders.status_pending	warning
confirmed	orders.status_confirmed	info
completed	orders.status_completed	success
cancelled	orders.status_cancelled	destructive

Bảng đơn — cột

Mã đơn · Khách hàng · Sản phẩm · Trạng thái · Vận chuyển · Tổng tiền · Thao tác.

Sản phẩm trong bảng link sang /app/products?search=....

Nút thao tác theo tab

Tab	Nút	Label (trans)	Hành động	Quyền
pending	✅	orders.btn_approve	Duyệt đơn	admin
pending	✏	orders.btn_edit_notes	Sửa ghi chú trước khi duyệt	admin
pending	❌	orders.btn_reject	Mở modal lý do từ chối	admin
pending (toolbar)		orders.approve_all	Duyệt tất cả pending	admin
pending (toolbar)		orders.approval_queue	→ /app/approvals	admin
confirmed	✈	orders.btn_send_confirm	Gửi tin xác nhận cho khách	admin
confirmed	🚚	orders.btn_ship	Mở modal tạo vận đơn	admin
confirmed	✅	orders.btn_complete	Đánh dấu hoàn thành	admin
Tất cả	🗑	orders.btn_delete	Xóa đơn (confirm dialog)	admin

Quyền admin

Các nút thao tác chỉ hiện cho tài khoản có quyền admin (is_account_admin hoặc is_platform_admin). Member thường chỉ xem, không thao tác.

Tạo đơn thủ công

Bấm Tạo đơn → modal orders.modal_create_title:

• Subscriber ID * — chọn khách hàng.
• Sản phẩm từ catalog (select, hiện khi có products) hoặc Mặt hàng tùy chỉnh (Tên + Đơn giá + Số lượng).
• Trạng thái khởi tạo — mặc định pending.
• Ghi chú.
• Feedback: hiện thông báo thành công/lỗi ngay trong modal.

Tạo vận đơn từ đơn

Trong tab confirmed, đơn có nút 🚚 Tạo đơn vận chuyển → modal:

• Kho lấy hàng (select từ kho đã setup).
• Khối lượng (gram).
• Chọn nhà xe — bấm Lấy báo giá → hiện danh sách nhà xe + phí + thời gian.
• ☑ Giao hỏa tốc (on-demand) — AhaMove (mã 1) / GrabExpress (mã 2):
  • Thêm field: Pickup Lat/Lng, Delivery Lat/Lng, Delivery Address.
• Bấm Tạo đơn → vận đơn sinh ra, theo dõi tại Vận chuyển.

Xuất dữ liệu

Bấm Xuất → modal ExportModal cho phép xuất CSV/Excel.

Theo dõi vận chuyển

Đơn có vận đơn → nút Theo dõi → mở modal ShipmentTrackModal hiện trạng thái realtime.

Workflow duyệt đơn hằng ngày

5 phút mỗi sáng

1. Mở Đơn hàng → tab Chờ duyệt.
2. Xem từng đơn AI tạo — kiểm tra sản phẩm/số lượng/địa chỉ.
3. Đúng → ✅ Duyệt đơn (hoặc Duyệt tất cả).
4. Sai → ✏ sửa hoặc ❌ từ chối.
5. Đơn đã duyệt → ✈ Gửi xác nhận cho khách → 🚚 Tạo vận đơn.

Bước tiếp theo

• Vận chuyển — theo dõi vận đơn.
• Sản phẩm — catalog.
• Dashboard — Đơn hàng (7 ngày).
• Playbook — tạo đơn end-to-end — luồng đầy đủ.