=============================================================================
         HƯỚNG DẪN TRIỂN KHAI MÁY CHỦ ĐỒNG BỘ CLOUD POS ONLINE 24/24
   (Bao Gồm Toàn Bộ 10 Phân Hệ: Bán Hàng Web POS, Nhập Hàng, Nhân Sự, v.v.)
=============================================================================

MÁY CHỦ CLOUD POS ONLINE 24/24 ĐÃ ĐƯỢC NÂNG CẤP ĐỒNG BỘ ĐẦY ĐỦ 10 PHÂN HỆ:
  1. 📊 Tổng quan (Dashboard): Doanh thu, lợi nhuận, tồn kho, công nợ thời gian thực.
  2. 🛒 BÁN HÀNG WEB POS: Bán hàng trực tiếp trên trình duyệt điện thoại/máy tính bảng/laptop
     - Tìm kiếm mã vạch/tên SP (F2), giỏ hàng tăng giảm số lượng, chọn khách lẻ / khách nợ.
     - Thanh toán nhanh (F9), gợi ý mệnh giá tiền, xem trước & in hóa đơn bán lẻ chuẩn đẹp.
  3. 📑 Hóa đơn bán hàng: Xem lịch sử, chi tiết từng hóa đơn, hủy đơn và hoàn kho tự động.
  4. 📦 Nhập hàng từ NCC: Tạo phiếu nhập hàng, quản lý công nợ NCC và lịch sử nhập hàng.
  5. 🏷️ Kho & Danh mục: Quản lý sản phẩm, tồn kho, giá vốn, giá bán, cảnh báo hàng sắp hết.
  6. 👥 Khách hàng & Nhà cung cấp: Danh sách đối tác, công nợ 2 chiều, thông tin liên hệ.
  7. 💰 Sổ quỹ Thu - Chi: Dòng tiền mặt, tài khoản ngân hàng, phiếu thu, phiếu chi.
  8. 📈 Báo cáo thống kê: Phân tích doanh thu, lợi nhuận theo mốc thời gian, mặt hàng bán chạy.
  9. 👤 Quản lý Nhân sự & Chấm công: 
     - Quản lý hồ sơ nhân viên, phân quyền tài khoản.
     - Cổng chấm công nhân viên qua Wi-Fi cửa hàng.
     - Tạm ứng lương (chuẩn xác 0đ, không tự động gán khống).
     - Bảng tính lương tự động (công chuẩn 24 ngày, BHXH 10.5% lương cơ bản hoặc part-time).
 10. 🔄 Cài đặt & Đồng bộ 2 chiều (Cloud Pending Events):
     - Mọi đơn hàng bán từ Web POS, phiếu nhập, tạm ứng... đều được đồng bộ về App Desktop.
     - Mọi dữ liệu từ App Desktop đều được đồng bộ tự động lên Cloud.

-----------------------------------------------------------------------------
1. CÁCH 1: TRIỂN KHAI TRÊN HOSTING WEB PHP (cPanel / DirectAdmin / Shared Host)
   (Khuyến nghị: Đơn giản, chi phí rẻ hoặc có sẵn tên miền)
   - Bước 1: Mở cPanel / DirectAdmin -> File Manager -> vào thư mục "public_html".
   - Bước 2: Upload các file trong gói zip: "index.php", "sync.php", ".htaccess".
   - Bước 3: 
     * Link Web quản lý & Bán hàng POS: https://tenmien.com/ (hoặc https://tenmien.com/sync.php)
     * Link API nhập vào app desktop: https://tenmien.com/ (hoặc https://tenmien.com/sync.php)
     * Link Cổng chấm công nhân viên: https://tenmien.com/?page=cham-cong
   - Mã bảo mật mặc định: cuahang123 (có thể đổi trực tiếp trên web hoặc trong file).

2. CÁCH 2: TRIỂN KHAI MIỄN PHÍ TRÊN RENDER.COM (Cloud Python HTTPS)
   - Bước 1: Đăng ký tài khoản miễn phí tại https://render.com
   - Bước 2: Tạo "New Web Service" -> Kết nối kho Git chứa:
     * cloud_sync_server.py
     * Procfile
     * requirements.txt
   - Bước 3: Start Command: python cloud_sync_server.py --port $PORT --secret cuahang123
   - Render cấp link HTTPS miễn phí hoạt động 24/24 (VD: https://cuahang-pos.onrender.com).

3. CÁCH 3: CHẠY TRÊN VPS RIÊNG (Linux Ubuntu / Windows Server)
   - Trên Linux:
     nohup python3 cloud_sync_server.py --port 8000 --secret cuahang123 > sync.log 2>&1 &
   - Trên Windows Server / Máy chủ mini:
     Nhấp đúp chuột vào file "start_server.bat".

4. CẤU HÌNH TỰ ĐỘNG ĐỒNG BỘ TRÊN APP DESKTOP (app.exe):
   - Vào menu "Cài đặt & Sao lưu" -> chọn tab "Đồng Bộ Online (24/24)".
   - Tích chọn: "Kích hoạt chế độ Tự động Đồng bộ lên Máy chủ Online".
   - Nhập Địa chỉ Máy chủ (URL) và Mã bảo mật (cuahang123).
   - Bấm "Kiểm Tra Kết Nối" -> "Lưu Cấu Hình Đồng Bộ" -> "Đồng Bộ Ngay Bây Giờ".
   - App Desktop sẽ tự động kéo các đơn bán Web POS, phiếu nhập, tạm ứng... về máy
     và đẩy toàn bộ dữ liệu cục bộ mới nhất lên Cloud định kỳ.
=============================================================================