docs: F2-17 基本操作修复报告(amis 接线四坑)

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
2026-06-12 08:48:29 +08:00
parent 29199e6ead
commit 830ea8fa19

View File

@@ -0,0 +1,44 @@
# 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 验证,不能停在「弹窗出现」。