1. Tổng quan Kiến trúc & Nguyên lý Offline-First
Cốt lõi hệ thốngCơ chế hoạt động độc lập không phụ thuộc Internet: 1 máy chủ SQLite tại quán phục vụ toàn bộ thiết bị qua mạng LAN nội bộ.
📌 Các bước thực hiện nhanh:
- Mỗi quán chỉ cần đúng 1 máy chủ lưu trữ dữ liệu SQLite (data/hovi.hv).
- Mọi thiết bị khác (desktop thu ngân phụ, điện thoại nhân viên, máy in) kết nối vào máy chủ này qua mạng LAN.
- Mất mạng Internet không ảnh hưởng: Việc mở bàn, gọi món, in bill và thanh toán vẫn diễn ra bình thường 100%.
- Khi có Internet trở lại, hệ thống tự động đẩy dữ liệu lên đám mây MongoDB HoviFlow Gateway sau mỗi 15 giây.
Khác biệt lớn nhất của Hovi-POS là mô hình Offline-First đích thực. Ứng dụng chạy trực tiếp trên máy tính tại quán với cơ sở dữ liệu SQLite nhúng (file hovi.hv), sử dụng cơ chế Write-Ahead Logging (WAL) cho tốc độ ghi cực nhanh và độ tin cậy tuyệt đối.
💡 Điểm mấu chốt khi vận hành tại quán:
- Không gián đoạn bán hàng: Dù đứt cáp quang hay sự cố nhà mạng, quán của bạn vẫn phục vụ khách bình thường.
- Bảo mật & Chủ động: Dữ liệu bán hàng, công thức món và sổ quỹ thuộc quyền kiểm soát của quán trên máy tính cục bộ.
- Đồng bộ đám mây an toàn: Dữ liệu đồng bộ 1 chiều từ SQLite → HoviFlow Dashboard → MongoDB qua giao thức HTTPS mã hóa, chỉ tài khoản Admin trên Dashboard mới nắm cấu hình database.
MÁY CHỦ QUÁN (HOST)Desktop Windows (x64)Chứa SQLite (data/hovi.hv) + NestJS API
Mạng LAN nội bộ (Wi-Fi quán)
⟷
MÁY KHÁCHDesktop phụ / Máy tính BarKết nối qua IP:Cổng + Mã thiết bị
ORDER TẠI BÀNĐiện thoại Android (Hovi Staff)Nhân viên phục vụ gọi món tức thời