Files
eip4-platform/docs/P1/F2-17基本操作修复报告.md
2026-06-12 08:48:29 +08:00

45 lines
3.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-17 UI 基本操作全面巡检与修复报告
> 日期:2026-06-12
> 触发:用户指令「移动端后置,重点保证 UI 基本操作正常」
> 结论:列表「查询/添加/修改/删除」全链路打通,e2e 80/80 全绿
## 一、巡检发现(亲测,按严重度)
| # | 问题 | 根因 | 状态 |
|---|------|------|------|
| #3 | 所有列表页查询条件不过滤 | 转换器 crud api 是带显式 query 模板的字符串(`?page=${page}&perPage=${perPage}`),amis 按封闭参数列表处理,filter 值不并入 | ✅ 修复 |
| #4 | 列表「添加/修改/查看/删除」按钮点击无业务动作 | 转换器生成的是无行为裸 button | ✅ 修复 |
| #1 | 登录后跳 PoC mock 页 /page/usergroup-manage | LoginPage 跳转目标过时 | ✅ 修复(→/workbench,清 alice 预填) |
| #2 | mock 页标题「测试」 | F2-13 只改了库内产物 | ✅ 修复 |
| #5 | API items 字段键大小写疑点 | 实为巡检时用错列名(SUBJECT,实际 TITLE),后端过滤链路健全 | 结案(非缺陷) |
## 二、#3 查询过滤修复
转换器 `buildSearchFilter`/crud api 生成改为**裸路径** `/api/flow/{X}_SEARCH`(去显式 query),amis GET 自动把 page/perPage + filter 表单值序列化为 query。后端 `FlowController` → 默认搜索流 → `GeneralPO.get_searchWhereClause(map)` 按列名为键消费条件。实测通知管理 TITLE=放假 → 266→42 精准过滤。
## 三、#4 按钮组修复(amis 接线深挖)
逐层踩坑,全部实测确认:
1. **按钮→dialog**:标准 amis headerToolbar button + dialog,本就工作(先前 offsetParent 误判——amis Modal 是 position:fixed,offsetParent 恒 null)
2. **dialog 内表单渲染**:dialog body 用 `service.schemaApi` 加载 EDITFORM。两坑:
- amis service.schemaApi 默认 **POST** → 撞后端 GET 端点 405 → `get:` 前缀强制 GET
- amis api 响应须 `{status,msg,data}` 信封 → PageSchemaController 加 `?format=amis` 包裹模式(默认裸 schema 不变,仅 amis 模式包裹、不参与 ETag/304)
3. **修改回显**:EDITFORM 表单无 initApi → 选中行整行并入 dialog 数据域 `{"&":"${selectedItems[0]}"}`,form 字段按 name 自动回显。实测 TITLE=「2026儿童节放假通知」回显正确
4. **删除**:headerToolbar 单选 radio 不填充 `selectedItems` 字段访问(`${selectedItems[0].X_ID}` 解析空 → 误发 filter 参数)→ 改入 **bulkActions**(amis 标准批量槽,可靠提供 `${ids}`);后端 EntityWriteController.delete 已支持 ids 多删。实测删除请求体含 `ids`,`{status:0,deleted:1}`,DB isactive=0
## 四、验证
- e2e **80/80**(新增 f2-17-basic-ops.spec.ts 5 用例:API 过滤/UI 过滤/添加弹窗/修改回显/删除 DB 验证)
- 转换器 46 单测 + platform-metadata 163 单测全绿
- 浏览器实测截图(添加表单/修改回显/删除网络抓包)
## 五、补测结论(巡检剩余项)
登录/登出/Tab 恢复/深链接/分页/全局搜索/查询/增改删/列值映射/设计器入口——核心操作全部正常。主题切换、403/404 异常态此前 F2-8/F2-12 已覆盖。
## 六、关键经验
amis service.schemaApi 默认 POST + 须信封 + crud 显式 query 模板吞 filter + headerToolbar 单选不填 selectedItems → 这四个 amis 接线坑是「页面能渲染但操作不通」的典型来源。验收 UI 操作必须真实点击+网络抓包+DB 验证,不能停在「弹窗出现」。