@digiforce-nc/plugin-user-data-sync

Plugin đồng bộ dữ liệu người dùng — sync thông tin user từ hệ thống bên ngoài (LDAP, Active Directory, HR system, HTTP API) vào Digiforce theo cơ chế pull/push.

Plugin này làm gì?

Khi tổ chức đã có hệ thống quản lý nhân sự, plugin tự động đồng bộ user từ nguồn bên ngoài vào Digiforce: tạo user mới, cập nhật thông tin, theo dõi trạng thái đồng bộ. Plugin sử dụng kiến trúc mở rộng với SyncSourceManager (quản lý loại nguồn), UserDataResourceManager (quản lý resource types), và UserDataSyncService (thực hiện đồng bộ).

Tính năng chính

#	Tính năng	Chi tiết
1	Pull	Kéo dữ liệu từ nguồn bên ngoài vào Digiforce
2	Push	Nhận dữ liệu đẩy từ nguồn bên ngoài (webhook/API)
3	Retry	Thử lại đồng bộ thất bại cho từng record
4	Multi-source	Nhiều nguồn đồng bộ cùng lúc, mỗi nguồn cấu hình riêng
5	Task tracking	Theo dõi mỗi lần đồng bộ: trạng thái, thời gian, lỗi
6	Extensible	Đăng ký source type và resource type tùy chỉnh

API Resources

Action	Mô tả
`userData:listSyncTypes`	Liệt kê các loại nguồn đồng bộ đã đăng ký
`userData:pull`	Kéo dữ liệu từ nguồn theo tên
`userData:push`	Nhận dữ liệu đẩy vào hệ thống
`userData:retry`	Thử lại đồng bộ cho record thất bại

Database

Collection	Mô tả
`userDataSyncSources`	Cấu hình các nguồn đồng bộ (tên, loại, options, enabled)
`userDataSyncTasks`	Lịch sử các lần đồng bộ (batch, status, cost, message)
`userDataSyncRecords`	Chi tiết từng record đồng bộ
`userDataSyncRecordsResources`	Liên kết record sync với resource

Dependencies

Package	Vai trò
`@digiforce-nc/server`	Server framework
`@digiforce-nc/database`	Database ORM
`@digiforce-nc/logger`	Logging — ghi log đồng bộ riêng biệt