📖 Hướng dẫn Sử dụng: Biểu mẫu & Khảo sát Động FormX

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

• Tên tính năng: Biểu mẫu Khảo sát & Thu thập Dữ liệu Thực địa FormX (FormX Dynamic Form Engine).
• Phân hệ áp dụng: 🌐 Web Dashboard (Thiết kế form, quản lý trường, xem phản hồi) / 📱 Zalo Mini App & Mobile App (Điền form, chụp ảnh đính kèm, nộp báo cáo).
• Vấn đề giải quyết: Thay thế các biểu mẫu giấy hoặc biểu mẫu cứng nhắc bằng công cụ thiết kế form động, gắn trực tiếp vào từng bước trong quy trình công việc ngoài hiện trường, tự động kiểm tra tính hợp lệ dữ liệu ngay khi Worker nhập liệu.
• Lợi ích mang lại:
  • Tùy biến linh hoạt 9+ loại trường dữ liệu (văn bản, số điện thoại, định lượng, phần trăm, ảnh chụp, trắc nghiệm, cặp khóa-giá trị).
  • Tự động đóng băng cấu hình biểu mẫu (Snapshot) tại thời điểm giao việc để bảo toàn tính nhất quán.
  • Hỗ trợ cơ chế nộp lại độc lập (needs_revision) khi chỉ một biểu mẫu trong bước bị từ chối.

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)

• FormX Form: Bản thiết kế biểu mẫu khảo sát, chứa danh sách các trường và nhóm trường.
• Field Group: Nhóm các trường dữ liệu liên quan để phân tách rõ ràng trên giao diện nhập liệu.
• Schema Snapshot: Bản chụp nguyên trạng cấu hình form lúc xuất bản việc làm, đảm bảo form không bị thay đổi trong suốt ca làm.
• FormX Submission: Bản ghi phản hồi thực tế của Worker gửi về kèm giá trị từng trường và số lần nộp (attempt_number).

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: Tạo Biểu mẫu & Thêm Trường Dữ liệu trên Web Dashboard

1. Truy cập vào mục Mẫu biểu FormX trong menu quản trị hoặc tab Mẫu biểu bên trong từng Folder.
2. Nhấn nút + Tạo mẫu biểu mới, nhập tên biểu mẫu và mô tả.
3. Nhấn vào biểu mẫu vừa tạo để vào giao diện thiết kế:
   • Nhấn + Thêm trường để chọn loại trường (Số điện thoại, Văn bản, Số lượng, Hình ảnh, Trắc nghiệm…).
   • Đặt nhãn hiển thị, gợi ý nhập liệu và đánh dấu Bắt buộc nếu cần.
   • Thiết lập cấu hình nâng cao: Giới hạn min/max, danh sách lựa chọn hoặc yêu cầu đóng dấu ảnh (Timemark).

[!TIP] Bạn có thể tạo các Nhóm trường (Field Groups) để chia biểu mẫu dài thành nhiều phần giúp Worker dễ theo dõi trên màn hình di động.

🔹 Bước 2: Gắn FormX vào Quy trình Công việc (Task Graph)

1. Mở trang chi tiết việc làm (Job Detail) và chuyển sang tab Quy trình tác vụ.
2. Thêm một bước công việc mới và chọn loại nhiệm vụ là Biểu mẫu FormX.
3. Chọn mẫu biểu đã tạo và kiểm tra xem trước giao diện.
4. Tiến hành Xuất bản việc làm.

[!IMPORTANT] Khi xuất bản, hệ thống sẽ tự động đóng băng toàn bộ cấu hình form thành Schema Snapshot. Mọi chỉnh sửa trên biểu mẫu gốc sau đó sẽ không ảnh hưởng đến các ca làm đang chạy.

🔹 Bước 3: Điền & Nộp Biểu mẫu trên Zalo Mini App

1. Worker vào ca làm thực tế và nhấn vào bước có biểu mẫu FormX.
2. Hệ thống mở màn hình Điền Form Khảo sát với đầy đủ các trường yêu cầu.
3. Nhập dữ liệu, chụp ảnh đính kèm (ảnh tự động giữ lại tọa độ GPS và thời gian EXIF).
4. Nhấn Gửi báo cáo để hoàn tất bước.

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