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

91 lines
6.4 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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 回归预期无回归(见终验结果)。