平台功能（自研）可视化配置
网站配置
网站配置决定前台展示的品牌信息，保存在 sys_config 的 website 分类下。保存后刷新前台页面即可看到变化。
网站配置（截图占位）
/images/docs/settings-website.png建议 1920 × 1080，截站点名称、Logo、备案号与客服信息。
页面可维护的字段
| 字段 | 配置键 | 说明 | 约束 |
|---|---|---|---|
| 站点 Logo | website.logo | 顶部导航与登录页使用 | PNG / JPG / SVG，≤ 2 MB |
| 浏览器图标 | website.favicon | 浏览器标签页图标 | PNG / JPG / ICO，≤ 2 MB |
| 背景图 | website.backgroundImage | 登录页 / 首页背景 | PNG / JPG / WEBP，≤ 5 MB |
| 站点名称 | website.name | 中文名称，显示在标题与页头 | ≤ 50 字 |
| 英文名称 | website.nameEn | 国际化场景使用 | ≤ 50 字 |
| 站点描述 | website.description | SEO 描述与首页副标题 | ≤ 200 字 |
| 版权信息 | website.copyright | 页脚版权文案 | ≤ 200 字 |
| ICP 备案号 | website.icp | 页脚备案信息 | ≤ 50 字 |
图片上传走平台统一的 OSS 能力，所以先确认存储配置可用，否则上传会失败。见存储配置。
完整配置键
以下键已登记在 sys_config，供前台、开放接口或应用读取；部分内容型字段（如关于我们、用户协议）目前通过「参数设置」维护：
| 配置键 | 用途 |
|---|---|
website.name / website.nameEn | 站点中英文名称 |
website.description | 站点描述 |
website.logo / website.favicon / website.backgroundImage | 品牌图片 |
website.copyright / website.icp | 页脚信息 |
website.keywords / website.author | SEO 关键词与作者 |
website.email / website.phone / website.address | 联系方式 |
website.aboutTitle / website.aboutContent | 关于我们 |
website.helpTitle / website.helpContent | 帮助中心 |
website.userAgreement / website.privacyPolicy | 用户协议与隐私政策 |
website.notificationGuide | 通知引导文案 |
website.customerServiceWechat / customerServicePhone / customerServiceEmail | 客服信息 |
website.siteUrl | 站点对外地址，用于拼接回调与分享链接 |
读取方式
- 后台 / 前台宿主：启动或切租户时读取站点配置，缓存在前端
websitestore 中；保存后刷新页面即可重新拉取。 - 应用后端：通过
sys_config服务读取，或在自己的migrations里写入config_category = <appCode>的站点配置，再由/open/<appCode>/config暴露。 - 第三方：使用开放接口读取应用级配置，而不是直接读平台表。
多租户
sys_config 带 tenant_id。每个租户可以维护自己的站点名称、Logo、客服信息；平台租户（000000）的值作为默认值。
切换租户后如果页面仍显示旧品牌信息，先确认前端是否重新拉取了站点配置，而不是去改数据库。
常见问题
上传 Logo 成功但页面没变？
浏览器可能缓存了旧图片；同时确认保存的是当前租户的配置。
备案号显示为空？
检查 website.icp 是否为空字符串；空串会覆盖默认值。
想改登录页背景但没生效？
登录页背景使用 website.backgroundImage，确认图片可公开访问，且没有被浏览器缓存。