D↗
DATADONGBO · MYSQL & GOOGLE SHEETS
Trung tâm dữ liệu
Theo dõi dữ liệu, lịch đồng bộ và kết nối hệ thống chấm công.
DATADONGBO · MYSQL & GOOGLE SHEETS
Theo dõi dữ liệu, lịch đồng bộ và kết nối hệ thống chấm công.
MYSQL → GOOGLE SHEETS
Đang tải dữ liệu...
Ghi nhận yêu cầu API đã xác thực từ backend và HDoi. Không có truy cập gần đây không đồng nghĩa mất kết nối. Cập nhật mỗi 10 giây khi mở tab; lịch sử từ lúc API khởi động. Nhãn dịch vụ do client gửi kèm token hợp lệ.
| Dịch vụ | Trạng thái | Yêu cầu cuối | Thành công cuối | Lỗi cuối | HTTP cuối | Số yêu cầu |
|---|
Các kết nối đã xác thực trong 15 phút gần đây. Cập nhật cùng bảng tổng quan mỗi 10 giây khi mở tab.
| Tài khoản / Nguồn | Mã kết nối | Hoạt động | Tài nguyên / Thao tác | Yêu cầu | Số lượt | Truy cập cuối |
|---|
Dữ liệu được lưu trước, đồng bộ Google Sheets ở nền.
| Tài nguyên / Tab | Khởi tạo | Bản ghi | Chờ ghi | Đồng bộ gần nhất | Lỗi gần nhất |
|---|
| Bắt đầu | Tài nguyên | Loại | Trạng thái | Số dòng | Kết thúc / Lỗi |
|---|
| Thời gian | Loại / Tài nguyên | Trạng thái | Số lần lỗi | Lỗi / Xử lý |
|---|
MySQL là nguồn dữ liệu chính. Google Sheets nhận các thay đổi theo lô. Không chỉnh tay vị trí dòng, cột ID và các cột __dd_* của tab đang liên kết.
Xóa cuốn chiếu chỉ áp dụng cho tài nguyên đã bật lưu trữ, bản ghi đã hoàn tất, đã đồng bộ phiên bản mới nhất và không thay đổi trong thời hạn lưu. Dữ liệu danh mục/tài khoản nên giữ vĩnh viễn.
Chạy một lần cho từng tài nguyên, kể cả tab trống. Quá trình này đọc theo lô và chặn ghi vào tài nguyên đến khi hoàn tất. Nếu lỗi, sửa cấu hình/quyền truy cập rồi thử lại tác vụ.
Token chỉ đặt trong backend, không đưa vào frontend hoặc biến VITE_. Xem token trong file .env trên máy chủ.
DATA_DONG_BO_URL=https://data.tenmien.vn DATA_DONG_BO_TOKEN=<API_TOKEN của DataDongBo>
Dùng client tại client/datadongbo.mjs. Lưu giữ requestId khi thử lại. API chỉ trả thành công sau khi giao dịch MySQL được commit; kết quả Sheets hiển thị riêng.
POST /v1/batch
Authorization: Bearer <API_TOKEN>
{
"requestId": "ma-yeu-cau-co-dinh",
"operations": [{
"action": "create", "entity": "Attendance",
"id": "ATT-uuid", "data": {"FullName": "Nguyễn Văn A"}
}]
}Đọc dữ liệu: GET /v1/entities/Attendance/records?limit=200. Sửa/xóa gửi expectedVersion. Tra cứu kết quả khi mất phản hồi: GET /v1/requests/:requestId.
Việc tạo dịch vụ này chưa chuyển dự án chấm công hiện tại sang MySQL. Cần tích hợp adapter và kiểm thử nghiệp vụ trước khi chuyển nguồn dữ liệu.