Chẩn đoán lỗi tích hợp

1. 404 hoặc sai tenant: kiểm tra tên miền con và đường dẫn giao thức; mỗi tenant là một database riêng. Với API di động, unknown_company cho biết không chọn được công ty.
2. 401: kiểm tra đúng loại khoá, thời hạn, header, tài khoản còn hoạt động và có cần mã 2FA hay không. Không đưa khoá vào log khi chẩn đoán.
3. 403: kiểm tra nhóm người dùng, công ty được phép, quyền model và quy tắc bản ghi. Với MCP, kiểm tra thêm cờ đọc hoặc ghi của model; với di động, đọc /me.features.
4. Dữ liệu không khớp: dùng cùng tài khoản mở bản ghi trên giao diện, đối chiếu model, id, domain, công ty hiện hành và múi giờ.
5. Mạng đứt hoặc timeout: xác định request ghi đã thành công chưa bằng cách đọc lại trước khi gửi lại. Riêng agent chấm công gửi lại cùng Idempotency-Key của lô.

Khi cần hỗ trợ, cung cấp thời điểm, tenant, endpoint, mã HTTP, code hoặc thông báo lỗi, id bản ghi thử và request đã che khoá. MCP có nhật ký riêng tại Kỹ thuật → MCP → MCP Logs; máy chấm công có Nhật ký đồng bộ trên hồ sơ máy.