@digiforce-nc/plugin-system-settings

Plugin cài đặt hệ thống — quản lý title, logo, favicon, banner, ngôn ngữ, và các thiết lập toàn cục của ứng dụng.

Plugin này làm gì?

plugin-system-settings là bảng điều khiển trung tâm cho branding và cấu hình toàn cục. Khi bạn muốn đổi tên ứng dụng, logo, favicon, hoặc ngôn ngữ mặc định — đây là plugin chịu trách nhiệm.

Ba nhiệm vụ chính

#	Nhiệm vụ	Chi tiết
1	Lưu cấu hình	Title, logo, squareLogo, favicon, banner, loader, appLang, enabledLanguages, brand, headerStyle, options
2	Serve public	API `systemSettings:get` trả về cấu hình cho mọi client (không cần đăng nhập)
3	Seed mặc định	Khi cài đặt, tự upload logo/favicon mặc định qua plugin-file-manager

Database

Bảng `systemSettings`

Field	Kiểu	Mô tả
`title`	string (hỗ trợ i18n)	Tên ứng dụng
`showLogoOnly`	boolean	Chỉ hiện logo, ẩn title
`allowSignUp`	boolean (mặc định: true)	Cho phép đăng ký tài khoản mới
`smsAuthEnabled`	boolean (mặc định: false)	Bật xác thực SMS
`logo`	belongsTo (attachments)	Logo chính
`squareLogo`	belongsTo (attachments)	Logo vuông (mobile, favicon fallback)
`favicon`	belongsTo (attachments)	Favicon (tab trình duyệt)
`banner`	belongsTo (attachments)	Banner trang đăng nhập
`loader`	belongsTo (attachments)	Animation loading
`brand`	string	HTML brand text (footer)
`headerStyle`	string (mặc định: `appLauncher`)	Kiểu header
`appLang`	string	Ngôn ngữ mặc định
`enabledLanguages`	json	Danh sách ngôn ngữ được bật
`options`	json	Cấu hình mở rộng

API endpoints

Endpoint	Quyền	Mô tả
`systemSettings:get`	Public	Lấy cấu hình (title, logo, favicon, ngôn ngữ, v.v.)
`systemSettings:put`	Admin (snippet `pm.system-settings.system-settings`)	Cập nhật cấu hình

Dependencies

Package	Vai trò
`@digiforce-nc/server`	Server framework
`@digiforce-nc/database`	Database ORM
`@digiforce-nc/client`	Client framework
`@digiforce-nc/plugin-file-manager`	Upload và quản lý ảnh (logo, favicon, banner)