Appearance
系统配置
系统配置集中管理 OARS 的系统级设置，包括菜单、数据源、消息通道、消息模板、模型提供商等。
配置管理
以下配置项在系统设置中维护（/sys 目录下多个页面）：
| 配置项 | 访问路径 | 用途说明 |
|---|---|---|
| 菜单管理 | /sys/menu | 维护系统菜单和按钮，设置路由、权限标识和显示状态 |
| 数据源 | /sys/data-source | 管理字典、业务数据、外部 API 和 SQL 数据源 |
| WebAPI | /sys/web-api | 维护第三方和内部 API 的地址和参数配置 |
| 字段元数据 | /sys/field-metadata | 管理业务字段编码、类型和推荐组件 |
| 消息推送 | /messagePush | 配置站内信通道与消息模板 |
| 登录通道 | /loginChannel | 配置钉钉、企业微信等第三方登录参数 |
| 模型提供商 | /sys/model-provider | 管理 AI 模型接入配置（OpenAI、DeepSeek 等） |
| 外部数据库 | /sys/database | 维护 JDBC 外部数据库连接 |
| 操作日志 | /sys/operation-log | 查看角色变更、表单发布、流程办理等写操作记录 |
| 登录日志 | /sys/login-log | 查看账号登录成功与失败 |
| 服务监控 | /sys/monitor/server | 查看 CPU、内存、JVM、磁盘等运行状态；只授给运维角色 |
配置说明
菜单管理
菜单类型包括目录、普通菜单、内嵌页面、外链和按钮。按钮必须设置权限标识，否则无法在角色中授权。
快速挂载页面（选中目录后）可将按业务实体动态生成的入口挂到侧栏，并可选同步授予当前角色。挂载类型包括：
- 表单数据管理页（每个已上线表单一条）
- 单流程实例列表页（每个已发布流程一条）
- 单流程统计分析页（每个已发布流程一条）
- 大屏播放页（每个已发布大屏项目一条，侧栏直达播放页）
不在此挂载：系统预置菜单（如大屏设计器列表、流程模板、文档中心、待办/已办等）。这些入口已存在，位置调整请用菜单树的拖拽或编辑父级。
全组织流程分析（Dashboard「分析」）为独立平台菜单，见 流程分析，不是「快速挂载」项。
其他能力：拖拽调整排序与父级、图标选择、已挂载项定位、表单按钮权限同步与站内消息提醒等，详见 角色权限 — 菜单配置注意。
数据源
支持字典、业务数据（部门/用户/角色）、外部 API、外部 SQL 和内部 API。系统预置了部门、用户等常用业务数据源，一般无需改动即可被表单引用。选项每次按当前配置查询，保存后立即生效；可用「最大行数」限制返回条数。删除后可以用同一编码重新创建。
字段元数据
字段类型包括文本、数字、日期、布尔、枚举、用户、组织。枚举或业务选择字段可通过选项源编码绑定统一数据源（见 数据字典）。
在表单设计器中把组件绑定到某条目录后：
- 必填（目录开关或校验配置里的
required）会在提交和流程办理时校验 - 默认配置
{"value":"...","placeholder":"..."}：新建时填入默认值，并显示占位提示 - 校验配置 支持
maxLength、minLength、pattern，数字类型还可配min/max
草稿仍可先保存不完整内容；点提交或办理发送时才会按上述规则拦住。
消息模板
支持站内消息模板。邮件、短信模板页可以查看，但当前不会按这些通道发出。
消息通道
当前只发送站内信，该通道不能关闭。邮件、短信等通道不能启用来发信。业务侧见 消息中心。
登录通道
提供钉钉、企业微信等第三方登录参数配置。字段以页面为准；其他登录方式按项目扩展。
模型提供商
页面路径：/sys/model-provider。
系统预置 OpenAI、DeepSeek、OpenRouter、Ollama 和自定义兼容接口等条目，默认未启用。通义千问、GLM 等可按 OpenAI 兼容协议走「自定义兼容接口」。
需要使用 AI 能力 时：
- 打开对应提供商，填写名称、类型、接口地址、密钥、模型名。
- 启用该提供商，并指定一家为默认。
- 表单 AI 与业务应用生成都走这里的配置，不在各功能里分散配密钥。
有本页权限的账号，在 AI 创建表单时还可以临时指定本次使用的提供商；未指定则用默认提供商。
密钥与地址含凭据，只授给管理员。条目都灰着时，按下面「常见问题」启用。
外部数据库
通过 JDBC 地址、账号、密码等维护外部库连接，供数据源或报表类能力使用。可用库类型取决于部署环境中的驱动与网络。
接口限流（管理员需知）
系统会对接口访问做按 IP 的限流保护，多节点共用同一套计数。短时间请求过多时，客户端可能收到「请求过于频繁」类提示（HTTP 429）。
管理员侧注意：
- 正常业务操作一般不会触发；批量导入、脚本刷接口、错误重试过密时可能触发。
- 经反向代理部署时，须正确转发客户端真实 IP，否则可能误伤整站或限流失效。
- 阈值与排除路径由部署侧配置，现场调整请联系实施/运维，参见 部署、故障排查。
权限说明
系统配置属于后台管理能力，只应授权给管理员。数据源、WebAPI、外部数据库、模型提供商等含连接与凭据，不要授予普通业务用户。
注意事项
- 修改菜单或角色后，受影响用户可能需要重新登录才看到完整变化。
- 禁用站内信模板后，相关通知将不再发送，先确认业务是否仍需要这些提醒。
- 外部连接类配置变更前，建议在测试环境验证连通性。生产环境不允许把外部接口或外部库指到本机；若必须访问指定内网主机，由实施在部署配置中放行。
常见问题
模型提供商都灰着用不了？
条目默认未启用。打开对应提供商，填写密钥/地址并启用，再设为默认。未启用时，AI 创建表单和生成业务应用都无法调用模型。
配了邮件通道仍发不出？
当前只发送站内信，邮件通道不能用来发信。流程消息请改用站内消息。
服务监控里看不到数据？
确认当前账号有监控菜单权限，且后端服务正常；仍异常时交运维查进程与健康检查。