布局与主题

本文面向需要调整项目品牌、布局主题或站点展示配置的研发人员。它用于区分前端默认配置与后端可覆盖配置，避免修改位置不一致。

两层配置来源

商业版前端的展示配置主要来自两层：

1. 前端静态默认配置

主要位于：

• src/config/index.ts
• src/config/setting.ts

这里控制：

• 系统名称默认值
• 可选主题样式
• 菜单布局模式
• 顶部栏能力
• 快捷入口
• 设置面板默认值

2. 后端公开站点配置

前端启动后会加载站点公开配置，并覆盖默认展示值。典型内容包括：

• 站点名称
• 登录欢迎文案
• SEO 标题和描述
• 水印文本
• 是否允许注册

常见可调整项

目标	优先修改位置
默认系统名	src/config/index.ts
默认菜单布局	src/config/setting.ts
默认主题色	src/config/index.ts
登录页品牌文案	后端站点配置，必要时再改前端默认值
顶部栏功能开关	src/config/modules/headerBar.ts

商业版相对开源版更值得注意的地方

• 菜单布局和品牌展示更强调产品体验，建议优先复用现有设计，不要一开始就大改框架层
• 站点配置支持从后端动态下发，适合做项目定制品牌定制
• 设置面板默认值较多，扩展开发前最好先梳理哪些需要开放给项目团队，哪些只保留给研发

修改建议

只想改项目品牌

优先改后端站点配置，不要先动前端静态常量。

想统一改默认外观

优先改：

• src/config/index.ts
• src/config/setting.ts
• 对应主题样式文件

想新增一种布局或主题

除了配置项本身，还要检查：

• 设置面板是否支持切换
• 相关枚举是否补齐
• 对应组件样式是否已覆盖

相关阅读

• 更通用的主题能力：看开源文档 主题配置
• 更通用的系统配置：看开源文档 系统配置

检查清单

完成主题或品牌调整后，建议确认：

• 登录页、系统标题、水印和 SEO 文案符合项目要求。
• 前端静态默认值与后端站点配置不存在互相覆盖的误解。
• 需要后台维护的内容已优先放到站点配置中。