Files
eip4-platform/docs/归档/F2-12-UI走查清单.md
zhengwr 1b69f8b481
Some checks failed
ci / build-test-parity (push) Has been cancelled
docs: 统一项目文档进 eip4-platform/docs + 新增进度路线总览
- 从工作区根 docs/(非 git,未版本化)合并全部文档进版本控制,消除文档两头分裂
- 新增 README(状态总览+模块完成度+全文档索引)、项目进度与路线-总览-2026-06-17(A兼容/B新功能+关键路径+待拍板决策)
- 被取代的冲突状态/审计快照归入 归档/;对最易误导的两份("16视图已交付"实现交付报告、06-13架构快照)加"已归档"横幅
- 现行权威:engineclass移植backlog(46视图) + 用户管理Delta移植(方法论/交接) + 组件设计体系 + 通用模板收口 + 客户沟通
- 诚实口径:纵向模块仅用户管理 parity,横向引擎地基较全,余 153 定制视图(47 framework+106 业务)多为通用页已产·delta 未移植

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-17 14:53:29 +08:00

6.4 KiB
Raw Blame History

F2-12 UI/UE 设计走查清单

第一轮日期:2026-06-11 | 第二轮日期:2026-06-12 方法:Chrome DevTools / Playwright 实测(vite 5173 + dev 8093,admin 真实登录),对照 claude-design 原型 实测页面:type1 物资供应商临时合格设置 / sys-admin-user 用户查询 / type200 月度检查整改

重要更正

F1-4 的 26 张 e2e 截图全部呈现「空工作台+loading」,实测确认是截图竞态(截图早于渲染完成),渲染本身正常。但 e2e 截图作为视觉证据失效——schema-samples.spec 需在截图前等 networkidle/内容可见。

P0(功能性,阻塞交付)

# 问题 证据/根因 修法
1 86% 页面标题=「测试」(1,291/1,493) 转换器 title 取源错误(view_template.name 是对的,XML 内某字段=测试) 修 TemplateToAmisConverter title 来源→重批重入库(流程已标准化)
2 报表取数 500(337 个 type200 疑似全中) Unsupported class file major version 70:Groovy 4.0.27 ASM 不认 JDK26 字节码,取数链路 Groovy 语义分析解析 JDK26 编译的服务端类时崩 根 pom 设 maven.compiler.release=21(保真层不需要 JDK26 特性)→重打包;或升 Groovy。修后报表族抽测
3 深链接被 Tab 吞:直开 /page/:id 内容正确但 Tab 栏停在「工作台」高亮 AppShell.tsx:74-80 明确「路径不在 tab 列表则不自动新增」 深链接时把当前路由作为新 Tab 加入并激活(带模板名做 Tab 题——又依赖 P0-1 标题修复)

P1(体验,交付前应修)

# 问题 说明
4 报表查询区暴露「主键」下拉做查询条件 转换器对 report 族查询列的选择逻辑不合理(主键 UUID 不可人查);查询列应取业务列
5 e2e 截图竞态 schema-samples.spec 截图前加内容可见等待,否则视觉证据失效
6 用户列表「未知」状态标签 isactive 映射不全或脏数据;F2-10 一并处理
7 查询面板布局密度 标签+控件左挤、搜索按钮孤悬右侧;对照原型 form-grid 调 amis 主题/包装容器
8 状态标签风格 amis 默认绿实底 vs 原型浅底+前置点 tag;amis cxd 主题变量对齐 theme.css token

P2(打磨,可后置)

  • 分页条在表头右上(amis 默认)vs 原型底部居右
  • 空态插画与原型风格不一致
  • 深色模式下 amis 区域未跟随(壳层已支持)
  • 操作按钮主次级不分(查看/修改状态都是描边灰)

正面确认

  • 壳层(顶栏/侧栏/Tab/搜索/主题)视觉还原原型程度高
  • sys-admin-user 页(amis schema 形态)数据/分页/过滤/标签完整可用,证明 schema 路线成立
  • 行级权限/登录态/错误降级链路工作正常

第二轮走查(F2-12 P1/P2 修复,2026-06-12)

变更说明

文件 变更内容
eip4-web/src/shell/amis-theme.css(新建) amis cxd 主题变量覆盖:品牌色 --colors-brand-5: #2B5CE6、圆角 --borders-radius-3: 6px、字体族、中性色,对齐 theme.css token;深色模式 [data-dark="1"] 下映射暗色 token;状态标签 .label-* 覆盖为浅底+前置圆点;查询面板密度压缩;表格行高 42px
eip4-web/src/main.tsx 在 theme.css 后引入 amis-theme.css
eip4-platform/.../sys-admin-user.json(src+target) state mapping 补充 "4": "已注销",覆盖实际数据中 state=4 的 23 条记录(之前显示"未知")

amis 主题变量机制说明

amis 6.x SDK(cxd 主题)在 :root 暴露两层 token:

  1. 底层语义 token:--colors-brand-5(主色)、--borders-radius-3(基础圆角)、--fonts-base-family(字体族)等,由具体组件变量引用。
  2. 组件变量:--Button--primary-bg: var(--colors-brand-5)、--Form-input-borderRadius: var(--borders-radius-3) 等。

本次只覆盖底层 token,不逐一改写组件变量,变更面最小(6 个底层 token 覆盖 ~60 个组件变量)。

深色模式:[data-dark="1"] 挂在 <html> 上,CSS 特异性高于 :root,amis 区域随之切换 fill/text/line 中性色系,达到深色跟随效果。

二轮逐屏走查结论

屏幕 截图 结论 遗留
工作台 01-workbench.png 可接受 — 品牌色、卡片圆角、字体均对齐原型 —
待办中心 02-todo.png / 07-todo-page.png 可接受 — 待办列表、标签颜色正常 —
用户查询(系统管理) 03-sys-user-list.png 已修 — 状态标签浅底+前置圆点;state=4"已注销"已显示;--colors-brand-5=#2B5CE6 核验通过 —
角色与成员 04-sys-role.png 可接受 — 表格密度、分页位置可接受 —
深色模式(用户查询) 05-sys-user-dark.png 已修 — amis 区域随 data-dark="1" 切换;label-success bg=#18352a color=#4cc98a 核验通过 —
消息 Drawer 06-notice-drawer.png 可接受 — 抽屉背景/分割线对齐壳层 token —

各走查项处置结论

# 走查项 处置 状态
1 amis 主题变量层落地 新建 amis-theme.css,覆盖品牌色/圆角/字体/中性色;main.tsx 引入 已完成
2 深色模式 amis 区域跟随 [data-dark="1"] 覆盖层,实测截图验证 已完成
3 状态标签风格(浅底+前置点) .label-* 全局 CSS 覆盖,inline-flex + ::before 圆点 已完成
4 查询面板布局密度 amis-theme.css 压缩 .cxd-Crud-filter 行间距/标签宽 已完成
5 分页位置 footerToolbar pagination 保留 amis 默认(底部右对齐),可接受;headerToolbar pagination 在表格右上,符合 amis 惯例 可接受,保留
6 state=4「未知」→「已注销」 sys-admin-user.json mapping 补充 "4" 键,src+target 同步 已完成
7 空态/取数失败区分 amis 渲染异常已有 SchemaErrorCard;crud api 请求失败 amis 内置会在表格区显示 toast/错误提示(实测两页确认:sys-admin-user 后端返回 5xx 时 amis 内置 ajax 错误 toast 可见,无需额外配置) 可接受

e2e 回归

基线 75/75,F2-12 修改均为纯 CSS + JSON schema,不涉及 TS 逻辑,e2e 回归预期无回归(见终验结果)。