2026-10-21-mobile-contract-line-picker.md 4.7 KB

移动合同产品选择弹窗 Implementation Plan

使用 subagent-driven-development,单一生产写者,规格与质量审查后实际375/414验收。用户已明确要求改成移动展示并继续八页验收;不另设审批或提交步骤。

Goal: 将运输表单移动入口的合同产品宽表替换为可检索、多选卡片,桌面原表格保持不变。

Architecture: 在 pl-plan-form-dialog/index.vue 对 isPageVariant 增加独立移动Sheet。复用现有合同行数据、linePickerSelected 与添加行处理器,不按productId合并不同合同明细。

Tech Stack: Vue3、Vant、现有TypeScript业务类型与SFC提取测试。

设计和范围

新建 web-admin/src/views/m/pl/plan/ContractLinePickerSheet.vue,父 web-admin/src/components/business/pl-plan-form-dialog/index.vue 只作显式移动分支与事件接线。移动为底部约90vh圆角弹层、固定标题/搜索与底栏、中间卡片列表滚动。不得让桌面ElDialog同时挂载在移动入口。

每卡产品名完整换行,合同号独立显示;型号、产品编号、单位、包装、合同量、剩余量双列,品牌/别名按长度换行,税率和状态保留。卡片整块可勾选,44px按钮与清楚的已选视觉反馈。零数量显示0,缺失显示—,字典沿用原格式函数。三墙绿,仅作用于移动。

搜索产品名称/标准名、型号、产品编号、合同号、品牌/别名,trim且大小写不敏感。搜索不丢已选项;底部“已选N项”计全量选择,空选禁确认,取消不向业务表单添加任何行。关闭重开按父现有新选择会话清空,不带上一次检索。

选择身份以contractId+合同行id确定,同一productId跨合同或包规仍可分别选择。不重新实现运输payload,不扩大为整个运输表单改版。父异步确认期间避免重复点击;如发现旧await向已切换段添加产品,先向root报告并限定移动保护。

实施与验收

  • 保存涉及文件当前基线,保留已完成R1保护;不得以HEAD覆盖工作区。
  • 新增 web-admin/scripts/mobile-pl-contract-line-picker.test.ts:真实组件计算/选择逻辑覆盖名称/型号/合同检索、空白大小写、跨搜索选择、不同合同同产品、取消重开、0/缺失、父事件交付保持原行对象;新增前运行RED。
  • 实现独立移动Sheet与父条件分支。桌面原ElDialog仅加 v-else,保留所有列、formatter、selection-change、确认逻辑。
  • 跑专项与R1相关小集,SFC编译与本批lint增量,不跑既有全量tsc。独立规格/质量审查。
  • 浏览器375/414实际打开装货与送货入口;无el-table、无整页横溢,长产品名/合同号可读、左右间距、所有选择及底栏触区至少44px。截图必须实际查看,不能以DOM尺寸替代。
  • 用已审批合成合同002/003验证同品两行可分别选择;检索切换保留选中数、取消不添加、重复选择不新增重复合同行。只在本轮测试计划操作。
  • Web原弹窗只读检查仍为原列式展示,不保存任何真实业务。

同批移动视觉复测新增:详情底部锚点

真实414点击备注,滚至底部后高亮回危化品证;原因末段短,不能到顶部probe。仅修改 web-admin/src/views/m/pl/plan/detail.vue 的滚动定位计算,参照已验收CRM合同详情 syncActiveTabFromScroll:可滚动且已到底部、末段可见时高亮末段;非底部继续按实际最近分区;不能仅以末段可见就误判。沿用点击锁与卸载清理,保持375/414单行和10px边距。生产函数回归覆盖底部短备注、Home恢复基础、短页未滚不误判、点击锁、缺少末段;实际截图验证点击备注、向上滚和回顶部。其他详情字段补全仍归R5。

八页视觉验收补充(用户指出漏检后的统一标准)

每个页面和弹窗均检查首屏/中段/底部及展开状态:桌面宽表或过密控件、文本换行与裁切、两侧间距、短字段双列与长字段通栏、44px触区、固定头尾遮挡、搜索/多选/空态/错误态、键盘弹出后的可达性。通过需同时有实际截图检查和交互证据。电脑H5键盘不等于微信软键盘验证。

截图使用统一browser viewport,避免叠加raw设备尺寸;保存实际viewport元数据,优先标准tab.screenshot。375/414分别观察截图,不把失真或裁切图当布局通过证据。

最终规格/质量PASS;180相关+25独立复现通过。Web原弹窗模板已做字节一致核对(只加v-else),Web实际1440px只读补看完成:原12业务列、两条合同、取消/确认保持,已取消返回,无保存。证据WEB-contract-line-picker-unchanged-1440.png/txt。