Some checks failed
ci / build-test-parity (push) Has been cancelled
- 从工作区根 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>
6.4 KiB
6.4 KiB
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:
- 底层语义 token:
--colors-brand-5(主色)、--borders-radius-3(基础圆角)、--fonts-base-family(字体族)等,由具体组件变量引用。 - 组件变量:
--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 回归预期无回归(见终验结果)。