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

3.4 KiB
Raw Blame History

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 验证,不能停在「弹窗出现」。