📖 Hướng dẫn Sử dụng: Check-in GPS & Giám sát Ca làm Real-time

1. 📌 Định nghĩa & Mục đích Tính năng (Overview)

• Tên tính năng: Check-in GPS & Giám sát Thực thi Thực địa Real-time (Field Execution & GPS Monitoring).
• Phân hệ áp dụng: 📱 Zalo Mini App / 📱 Mobile App / 🌐 Web Dashboard.
• Vấn đề giải quyết: Giúp Worker xác thực vị trí làm việc chuẩn xác qua vệ tinh GPS, thực hiện từng bước nhiệm vụ thực địa (chụp ảnh bằng chứng, khảo sát FormX, quét mã QR), đồng thời cung cấp giao diện Live Monitor trực quan cho Quản lý theo dõi tiến độ và duyệt bằng chứng theo từng nhiệm vụ độc lập.
• Lợi ích mang lại:
  • Loại bỏ hoàn toàn gian lận vị trí với cơ chế Geofence bán kính thông minh.
  • Hỗ trợ nghiệm thu linh hoạt theo từng nhiệm vụ (review_task_proof), tránh việc từ chối toàn bộ ca làm khi chỉ có một lỗi nhỏ.
  • Quy trình nộp lại mượt mà (needs_revision) giúp Worker bổ sung bằng chứng thiếu sót ngay tại điểm bán.

2. 👥 Đối tượng Sử dụng & Quyền Hạn (Target Audience & IAM)

3. 📖 Thuật ngữ & Khái niệm Nghiệp vụ (Glossary)

• Check-in GPS: Thao tác xác thực tọa độ vị trí thực tế của Worker so với tọa độ được giao ca trong bán kính hợp lệ.
• Geofence Radius: Bán kính dung sai cho phép (mặc định từ 50m đến 200m tùy cấu hình công việc).
• Task Proof: Bằng chứng hoàn thành nhiệm vụ (ảnh chụp có watermark thời gian/vị trí, dữ liệu biểu mẫu FormX, mã vạch).
• Needs Revision: Trạng thái nhiệm vụ bị Quản lý yêu cầu nộp lại do bằng chứng chưa đạt chuẩn.

4. 🔄 Luồng Trải nghiệm Người dùng (User Flow)

5. 🛠 Các Bước Thực hiện Chi tiết (Step-by-Step Guide)

🔹 Bước 1: Check-in Ca làm trên Zalo Mini App / Mobile App

1. Đến điểm làm việc được giao ca.
2. Mở ứng dụng, vào mục Lịch làm việc hoặc Ca của tôi, chọn ca đang diễn ra.
3. Nhấn Check-in vị trí GPS. Hệ thống sẽ kiểm tra tọa độ hiện tại với địa điểm làm việc.
4. Khi màn hình báo thành công, danh sách các bước công việc sẽ được kích hoạt.

🔹 Bước 2: Thực hiện Nhiệm vụ & Nộp Bằng chứng

1. Nhấn vào từng bước trong quy trình:
   • Nhiệm vụ Chụp ảnh: Chụp ảnh trực tiếp bằng camera trong app (hệ thống tự động lưu vị trí GPS và thời gian EXIF).
   • Nhiệm vụ FormX: Điền đầy đủ các trường khảo sát và thông số yêu cầu.
   • Nhiệm vụ Quét mã: Quét mã QR/Barcode sản phẩm hoặc thẻ địa điểm.
2. Kiểm tra lại dữ liệu và nhấn Hoàn thành bước.

🔹 Bước 3: Giám sát & Duyệt Bằng chứng trên Web Dashboard

1. Quản lý truy cập vào mục Giám sát trực tiếp (Live Monitor) (/monitoring).
2. Xem danh sách các Worker đang trong ca làm việc, thời gian check-in và tiến độ hoàn thành các bước.
3. Nhấn vào ca làm để mở Chi tiết ca thực thi (Execution Detail):
   • Xem hình ảnh bằng chứng phóng to, kiểm tra vị trí chụp ảnh trên bản đồ.
   • Xem chi tiết phản hồi biểu mẫu FormX.
   • Nhấn Duyệt (Approve) hoặc Từ chối (Reject) cho từng nhiệm vụ riêng biệt.
   • Nếu từ chối, nhập lý do và bật tùy chọn Yêu cầu nộp lại để Worker bổ sung.
   • Nếu từ chối mà không bật yêu cầu nộp lại, Worker không thể tự gửi lại bằng chứng; Quản lý cần dùng quy trình reset được phân quyền nếu muốn mở lại ca.

🚨 6. Xử lý Lỗi Thường gặp (Troubleshooting & FAQs)