feat: redesign system configuration workspace

This commit is contained in:
2026-08-04 15:07:01 +08:00
parent c4de4e8c56
commit 3b9215cc3d
8 changed files with 901 additions and 153 deletions

View File

@@ -51,6 +51,54 @@ final result: passed
---
# 系统配置页面重构验收2026-08-04
- 源页面截图:`development_records/ui-evidence/system-config-2026-08-04/before.png`
- 实现页面截图:`development_records/ui-evidence/system-config-2026-08-04/after.png`
- 同屏对比图:`development_records/ui-evidence/system-config-2026-08-04/comparison.jpg`
- 验收地址:`http://localhost:5174/`
- 状态:管理员已登录 / 系统配置 / 用户与登录
- 视口1280 × 720 CSS px设备像素密度 1
- 源页面完整截图1280 × 1998 px实现页面完整截图1280 × 1572 px
- 归一化方式:两张截图均保持 1280 px 原始宽度和相同像素密度,不缩放;对比图仅在实现图底部补白至相同高度
## 完整视图与重点区域证据
- 修复前同时铺开 29 项配置,分散在三列高度不一的卡片中,阅读路径长、首屏没有重点,底部留白失衡。
- 修复后增加运行摘要、左侧分类导航和右侧聚焦编辑区;一次只展示一个顶级分类,并在分类内按业务语义分组。
- “用户与登录、AI 问答、外部服务、系统开关”四个分类均已逐项打开验证29 项现有配置全部保留。
- 首屏摘要展示短信模式、AI 模式、上下文消息数和最大并发数,管理员无需进入字段即可了解关键运行状态。
## 必查视觉面
- 字体与排版:标题、摘要值、分组标题、字段标签和说明形成稳定层级;长说明自然换行,不与控件挤压。
- 间距与布局:左侧导航吸附,右侧表单采用统一双列网格;开关类配置使用整行设置项,控件垂直居中。
- 颜色与设计令牌:沿用后台现有深墨绿、浅雾绿和蓝色主操作色,没有新增图片或大面积装饰色块。
- 图片与资源:页面完全使用现有组件与 CSS不依赖新增图片资产。
- 文案:保留原配置名称和说明;新增“配置已同步 / 有未保存修改”状态,敏感字段增加提示标识。
## 交互与工程检查
- 已验证四个分类导航均可切换,并显示对应分组和配置数量。
- 已验证 AI 超时从 60 改为 61 后出现“有未保存修改”且保存按钮启用;恢复为 60 后状态回到“配置已同步”且按钮禁用。
- 本次验收未实际保存配置,未修改现有运行参数。
- 保存流程已补充重复提交保护、保存中状态和失败提示,接口与原有配置读写逻辑保持不变。
- 1280 px 视口下文档、页面容器和配置工作区 `scrollWidth` 均等于 `clientWidth`,无横向滚动。
- 浏览器控制台错误和警告0。
- `npm run build`:通过。
## 对比历史
1. [P1] 初始问题:全部配置同时展示,三列信息密度过高,管理员难以定位配置且页面高度失控。
2. 修复:按任务域拆成四个分类和十个业务分组,增加关键状态摘要与聚焦编辑工作区。
3. [P2] 初始问题:保存按钮始终可点击,缺少未保存状态、保存中反馈和错误处理。
4. 修复:增加基线对比、脏状态提示、按钮禁用规则、重复提交保护与真实失败提示。
5. 复验:完整视图信息层级清晰,分类切换、状态恢复、响应式宽度和构建均通过;未发现剩余 P0、P1、P2 问题。
final result: passed
---
# Markdown 长回答排版修复验收2026-07-17
## 对照范围