From 830ea8fa1918bd48a4a43e4a2f72f7d3fde16e51 Mon Sep 17 00:00:00 2001 From: zhengwr Date: Fri, 12 Jun 2026 08:48:29 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20F2-17=20=E5=9F=BA=E6=9C=AC=E6=93=8D?= =?UTF-8?q?=E4=BD=9C=E4=BF=AE=E5=A4=8D=E6=8A=A5=E5=91=8A(amis=20=E6=8E=A5?= =?UTF-8?q?=E7=BA=BF=E5=9B=9B=E5=9D=91)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Fable 5 --- docs/P1/F2-17基本操作修复报告.md | 44 ++++++++++++++++++++++++++++++++ 1 file changed, 44 insertions(+) create mode 100644 docs/P1/F2-17基本操作修复报告.md diff --git a/docs/P1/F2-17基本操作修复报告.md b/docs/P1/F2-17基本操作修复报告.md new file mode 100644 index 0000000..8d01486 --- /dev/null +++ b/docs/P1/F2-17基本操作修复报告.md @@ -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 验证,不能停在「弹窗出现」。