FAQ — Offline & đồng bộ

import { Aside } from ‘@astrojs/starlight/components’;

Bán offline trên desktop nhưng trình duyệt không

Đúng như thiết kế. Outbox (hàng đợi đơn) là tính năng chỉ có trên Vendor Desktop (Electron). Trình duyệt:

Khi nào dùng gì:

Môi trường	Offline OK?
Vendor Desktop (Electron)	✅ Có — SQLite + outbox
Trình duyệt vendor web	❌ Không — cần mạng để đặt đơn

Nguyên nhân: Khi mạng chập chờn, outbox gửi đơn 2 lần. Hệ thống cố gắng dedupe bằng client_order_id nhưng đôi khi thất bại.

Cách xử lý:

Không bấm “Thanh toán” lần hai khi spinner đang quay — đó là dấu hiệu đơn đã vào outbox.
Khi mạng lên, kiểm tra Đơn hàng với cùng client_order_id hoặc mã hiển thị trên bill.
Nếu thực sự trùng, báo chủ cửa hàng để hủy 1 đơn từ dashboard.

Phòng tránh:

Cách xử lý (2 phương án):

Phương án	Cách làm	Khi nào dùng
Refresh nhẹ	Kéo xuống ở lưới sản phẩm, hoặc đổi cửa hàng rồi đổi lại	Nghi ngờ catalog chưa sync
Reset cache	Cài đặt → Dữ liệu local → Đặt lại cache	Cache lỗi nặng, nhiều sản phẩm sai

Lưu ý: Reset cache sẽ tạo bản sao lưu trong thư mục user data. Có thể khôi phục nếu cần.

Phân loại:

Loại nháp	Lưu ở đâu	Mất khi nào
Nháp server (`submit_as: draft`)	Database trên server	Bị hủy bởi cashier khác, hoặc bị xóa từ dashboard
Nháp local có tên	SQLite trên Vendor Desktop	Clear browser data, reset DB local, hoặc cài lại app

Khôi phục:

Nháp server: hỏi chủ cửa hàng restore từ log.
Nháp local: không thể khôi phục sau khi reset. Bài học: đặt tên có ý nghĩa cho nháp quan trọng (ví dụ: “Bàn 5 - Anh Tuấn”).

Nguyên nhân: Reset cache xoá SQLite catalog. Một số prefs (như sản phẩm ghim, thứ tự tab) lưu cùng DB local.

Cách xử lý:

Phòng tránh: trước khi reset, vào Cài đặt → Dữ liệu local → click “Sao lưu” để tạo snapshot.
Khôi phục: cùng trang → “Khôi phục từ sao lưu” → chọn file gần nhất.

Gửi chủ cửa hàng hoặc support@lionpos.com.