🚀 HƯỚNG DẪN TRIỂN KHAI MÁY CHỦ ĐỒNG BỘ ONLINE 24/24

Giải pháp giám sát bán hàng từ xa cho Chủ cửa hàng • Tương thích mọi loại Hosting
Kiến trúc Offline-First:
• Tại cửa hàng: Nhân viên dùng app máy tính (.exe). Dù mất mạng vẫn bán hàng offline 100%, không bị đơ gián đoạn.
• Khi có mạng: Dữ liệu tự động nén và đẩy lên hosting 24/24.
• Chủ cửa hàng: Ở xa mở trình duyệt trên Điện thoại/Laptop là xem được ngay Doanh thu, Lợi nhuận, Đơn vừa bán, Tồn kho, Công nợ.

1 Cách 1: Triển khai trên Hosting Web PHP (cPanel / DirectAdmin / Shared Host) Dễ nhất

Nếu bạn đang có sẵn hosting web thông thường (như Hostinger, Tenten, PA Vietnam, BKNS, v.v.):

  1. Đăng nhập vào cPanel / DirectAdmin -> Mở mục File Manager (Quản lý tệp) -> vào thư mục public_html.
  2. Tải lên file sync.php và file .htaccess có trong gói zip này.
  3. (Tùy chọn) Mở file sync.php chỉnh sửa biến $SYNC_SECRET = 'cuahang123'; nếu muốn đổi mật mã.
  4. Địa chỉ truy cập của bạn sẽ là:
    • Web quản lý cho Chủ: https://tenmiencuaban.com/sync.php
    • API cấu hình trên App: https://tenmiencuaban.com/sync.php

2 Cách 2: Triển khai Miễn Phí 100% trên Render.com (Cloud Server) Khuyên dùng

Render.com cho phép bạn chạy máy chủ Python online 24/24 hoàn toàn miễn phí, có sẵn tên miền HTTPS bảo mật:

  1. Đăng ký tài khoản miễn phí tại render.com (hoặc đăng nhập bằng Google/GitHub).
  2. Bấm New + -> Chọn Web Service.
  3. Tải code lên từ GitHub hoặc liên kết repository chứa file cloud_sync_server.py, Procfile, requirements.txt.
  4. Cấu hình:
    • Runtime: Python 3
    • Start Command: python cloud_sync_server.py --port $PORT --secret cuahang123
  5. Bấm Deploy Web Service. Render sẽ cấp cho bạn một đường link miễn phí như: https://my-pos-store.onrender.com.

3 Cách 3: Chạy trên VPS Linux (Ubuntu / CentOS) hoặc VPS Windows

Nếu bạn thuê VPS riêng (DigitalOcean, Vultr, Linode, OVH, v.v.):

Trên Linux (Ubuntu):

# 1. Tải thư mục lên VPS và chạy ngầm máy chủ bằng lệnh:
nohup python3 cloud_sync_server.py --port 8000 --secret cuahang123 > sync_server.log 2>&1 &

# 2. Mở cổng tường lửa (nếu có):
sudo ufw allow 8000/tcp

Trên Windows VPS:

Chỉ cần nhấp đúp vào file start_server.bat để chạy máy chủ.

4 Cấu hình kết nối trên App Máy Tính tại Cửa Hàng

  1. Mở ứng dụng POS trên máy tính tại cửa hàng.
  2. Vào mục ⚙️ Cài đặt & Sao lưu -> chọn tab 🌐 Đồng Bộ Online (24/24).
  3. Tích chọn: Kích hoạt chế độ Tự động Đồng bộ lên Máy chủ Online (24/24).
  4. Điền thông tin:
    • Địa chỉ Máy chủ (URL): Nhập địa chỉ bạn vừa cài (VD: https://my-pos.onrender.com hoặc https://tenmien.com/sync.php hoặc http://IP_VPS:8000).
    • Mã bảo mật (Secret Key): Nhập mã bảo mật bạn đã đặt (Mặc định: cuahang123).
    • Chu kỳ đồng bộ: Chọn 15 giây hoặc 30 giây.
  5. Bấm nút 🔌 Kiểm Tra Kết Nối (khi báo thành công) -> bấm 💾 Lưu Cấu Hình Đồng Bộ.
  6. Bấm ⚡ Đồng Bộ Ngay Bây Giờ để đẩy toàn bộ hàng hóa, khách hàng, tồn kho hiện tại lên mây ngay lập tức.

5 Cách Chủ Cửa Hàng Theo Dõi Từ Xa

Rất đơn giản:
• Chủ cửa hàng chỉ cần mở điện thoại di động (iPhone / Android) hoặc máy tính bảng / laptop.
• Mở trình duyệt web truy cập địa chỉ máy chủ (VD: https://tenmien.com/sync.php hoặc https://my-pos.onrender.com).
• Nhập Mã bảo mật (VD: cuahang123) và bấm 🔑 Đăng Nhập.
• Màn hình sẽ hiện toàn bộ doanh thu hôm nay, lợi nhuận, danh sách đơn hàng vừa xuất, tồn kho hàng hóa và công nợ 24/24. Trang web sẽ tự động cập nhật liên tục mỗi 20 giây!

6 Cổng Chấm Công Nhân Viên (Xác Thực Wi-Fi Cửa Hàng)

Dành cho Nhân viên đi làm:
• Truy cập link chấm công: https://tenmien.com/cham-cong (hoặc https://tenmien.com/?page=cham-cong).
• Đăng nhập bằng Tài khoản và Mật khẩu do Quản lý tạo và cấp từ App Desktop.
• Thiết bị phải kết nối đúng Wi-Fi cửa hàng để hệ thống xác nhận IP hợp lệ (thẻ xanh).
• Bấm 🟢 VÀO CA khi bắt đầu làm việc và bấm 🔴 HẾT CA khi kết thúc ca để tự động tính tổng giờ công.
• Quản lý theo dõi trực tiếp và xuất Excel bảng công tại App Desktop (Menu 👥 Quản lý nhân sự → Tab Bảng Chấm Công).
Hệ thống Đồng Bộ Online 24/24 • Tương thích 100% Offline POS