系统配置

系统配置集中管理 OARS 的系统级设置，包括菜单、数据源、消息通道、消息模板、模型提供商等。

配置管理

以下配置项在系统设置中维护（/sys 目录下多个页面）：

配置项	访问路径	用途说明
菜单管理	/sys/menu	维护系统菜单和按钮，设置路由、权限标识和显示状态
数据源	/sys/data-source	管理字典、业务数据、外部 API 和 SQL 数据源
WebAPI	/sys/web-api	维护第三方和内部 API 的地址和参数配置
字段元数据	/sys/field-metadata	管理业务字段编码、类型和推荐组件
消息模板	/messageTemplate	配置站内消息、邮件、短信的模板内容
消息通道	/messageChannel	配置站内信、邮件、短信等消息发送通道
登录通道	/loginChannel	配置钉钉、企业微信等第三方登录参数
模型提供商	/sys/model-provider	管理 AI 模型接入配置（OpenAI、DeepSeek 等）
外部数据库	/sys/database	维护 JDBC 外部数据库连接
服务监控	/sys/monitor/server	查看服务运行状态

配置说明

菜单管理

菜单类型包括目录、普通菜单、内嵌页面、外链和按钮。按钮必须设置权限标识，否则无法在角色中授权。

数据源

支持字典、业务数据（部门/用户/角色）、外部 API、外部 SQL 和内部 API。系统预置了部门、用户等常用业务数据源，一般无需改动即可被表单引用。

字段元数据

字段类型包括文本、数字、日期、布尔、枚举、用户、组织。枚举或业务选择字段可通过选项源编码绑定统一数据源（见 数据字典）。

消息模板

支持站内消息、邮件、短信三种模板。系统默认启用站内信相关能力；邮件、短信模板需在通道就绪后再使用。

消息通道

用于启停和配置发送方式。站内信为默认通道；邮件、短信等需完成项目参数配置后再启用。业务侧使用说明见 消息中心。

登录通道

提供钉钉、企业微信等第三方登录参数配置。字段以页面为准；其他登录方式按项目扩展。

模型提供商

系统预置多家常见模型供应商条目，默认未启用。需要 AI 相关能力时，在本页启用并指定默认提供商，再按实施约定填写密钥与地址。

外部数据库

通过 JDBC 地址、账号、密码等维护外部库连接，供数据源或报表类能力使用。可用库类型取决于部署环境中的驱动与网络。

接口限流（管理员需知）

系统会对接口访问做按 IP 的限流保护。短时间请求过多时，客户端可能收到「请求过于频繁」类提示（HTTP 429）。

管理员侧注意：

• 正常业务操作一般不会触发；批量导入、脚本刷接口、错误重试过密时可能触发。
• 经反向代理部署时，须正确转发客户端真实 IP，否则可能误伤整站或限流失效。
• 阈值与排除路径由部署侧配置，现场调整请联系实施/运维，参见 部署、故障排查。

权限说明

系统配置属于后台管理能力，只应授权给管理员。数据源、WebAPI、外部数据库、模型提供商等含连接与凭据，不要授予普通业务用户。

注意事项

• 修改菜单或角色后，受影响用户可能需要重新登录才看到完整变化。
• 禁用消息通道或模板后，相关通知将不再按原方式送达，先确认业务是否仍依赖站内信以外的通道。
• 外部连接类配置变更前，建议在测试环境验证连通性。

常见问题

模型提供商都灰着用不了？
条目默认未启用。打开对应提供商，填写密钥/地址并启用，再设为默认。

配了邮件通道仍发不出？
确认通道已启用、模板已绑定该通道，且服务器出网与邮件服务参数正确；站内信不依赖外网。

服务监控里看不到数据？
确认当前账号有监控菜单权限，且后端服务正常；仍异常时交运维查进程与健康检查。