@digiforce-nc/plugin-custom-variables

Plugin biến tùy chỉnh — định nghĩa và sử dụng biến (variables) trong workflow, template, formula và các nơi cần giá trị động.

Plugin này làm gì?

Thay vì hardcode giá trị (tên công ty, email admin, ngưỡng cảnh báo...) vào từng nơi, plugin cho phép định nghĩa biến tùy chỉnh tại một chỗ, sử dụng ở nhiều nơi. Khi giá trị thay đổi, chỉ cần cập nhật biến — tất cả nơi sử dụng tự động nhận giá trị mới.

Cơ chế hoạt động

Tính năng chính

#	Tính năng	Mô tả
1	Key-value	Biến dạng key-value với kiểu dữ liệu
2	Typed	Hỗ trợ string, number, boolean, JSON
3	Scoped	Biến global hoặc scoped theo collection
4	Reference	Sử dụng trong workflow, template, formula
5	Audit	Lịch sử thay đổi giá trị biến
6	Default values	Giá trị mặc định khi biến chưa được set

API endpoints

Endpoint	Mô tả
`customVariables` CRUD	Tạo, sửa, xóa, liệt kê biến
`customVariables:resolve`	Lấy giá trị biến theo name
`customVariables:bulkResolve`	Lấy nhiều biến cùng lúc

Database

Bảng	Mô tả
`customVariables`	Định nghĩa biến (name, value, type, scope)
`customVariableHistory`	Lịch sử thay đổi giá trị

Thành phần client

Thành phần	Mô tả
`VariableList`	Danh sách biến với tìm kiếm và lọc
`VariableForm`	Form tạo/sửa biến (name, type, value)
`VariablePicker`	Popup chọn biến trong workflow/template editor
`VariableTag`	Tag hiển thị biến (VD: [companyName])

Dependencies

Package	Vai trò
`@digiforce-nc/server`	Server framework
`@digiforce-nc/database`	Database ORM
`@digiforce-nc/client`	Client UI framework
`@digiforce-nc/cache`	Cache giá trị biến hay dùng