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>
91 lines
6.4 KiB
Markdown
91 lines
6.4 KiB
Markdown
# 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 回归预期无回归(见终验结果)。
|