系统设置元数据

系统设置位于系统项目 sysdata/settings/settings.json，定义整个 SuccApp 部署环境的全局运行边界。它包括系统名称、Logo、域名、CDN、登录认证、安全策略、日志、调度、文档服务、文件存储和其他全局能力，影响所有项目和应用。

当配置会影响所有项目、所有应用、登录入口、静态资源、系统路由、外部服务或运维能力时，应维护系统设置。普通项目自己的数据源范围和显示格式放在 项目设置（项目/settings/settings.json）；单个应用的首页和短路由放在 应用设置（xxxx.app/settings.json）。

此文件只描述 sysdata 下的系统设置，不描述普通项目的 settings/settings.json。

字段形态

系统设置是一个扁平对象。大量配置项使用带点号的 key，例如 sys.basic.name、security.password.minLength、log.sys.settings。这些点号是属性名的一部分，不表示 JSON 嵌套对象。

涉及密钥、密码、令牌和第三方服务凭据时，不在文档示例或普通 Git 提交中暴露真实值。域名、登录、安全、文件存储和日志配置会影响全局，修改前应确认目标环境和影响范围。

DTS 入口

• 根结构：types/meta/file-types/sys-settings.d.ts
• 文件类型入口：types/meta/file-types/index.d.ts
• 系统运行时类型：sys/sys.types.d.ts