@digiforce-nc/plugin-refresh-collection-field

Plugin làm mới field collection — đồng bộ lại metadata field từ database thực tế vào CollectionManager khi schema thay đổi ngoài hệ thống Digiforce.

Plugin này làm gì?

Khi schema database thay đổi từ bên ngoài (DBA thêm cột, migration tool đổi kiểu dữ liệu, công cụ khác tạo bảng mới...), Digiforce không tự nhận biết. Plugin cung cấp Refresh — quét database thực tế, so sánh với metadata hiện tại, và đồng bộ lại cho khớp.

Năm tính năng chính

#	Tính năng	Chi tiết
1	Refresh fields	Đồng bộ field metadata từ database thực tế
2	Detect changes	Phát hiện: cột mới, cột đã xóa, kiểu dữ liệu thay đổi
3	Per-collection	Refresh từng collection riêng lẻ
4	Bulk refresh	Refresh tất cả collections cùng lúc
5	Preview changes	Xem trước danh sách thay đổi trước khi apply

---

Kiến trúc

Luồng refresh

Loại thay đổi phát hiện được

Loại	Ví dụ	Hành động
Cột mới	DBA thêm cột phone	Tạo field mới trong metadata
Cột bị xóa	DBA xóa cột fax	Đánh dấu field removed (không tự xóa metadata)
Type thay đổi	VARCHAR(50) → VARCHAR(255)	Cập nhật type trong metadata
Nullable thay đổi	NOT NULL → NULL	Cập nhật constraint
Default thay đổi	Default value mới	Cập nhật default trong metadata

Thành phần client

Thành phần	Mô tả
RefreshButton	Nút refresh trong collection manager toolbar
ChangePreview	Modal preview thay đổi: bảng added/removed/changed fields
BulkRefresh	Nút refresh tất cả collections (batch)
DiffViewer	Hiển thị diff chi tiết cho từng field (before/after)

Dependencies

Package	Vai trò
@digiforce-nc/server	Server framework
@digiforce-nc/database	Database introspection API
@digiforce-nc/client	Client UI framework

Mục lục chi tiết

(Xem trang tổng quan ở trên)