tms-erp-web/.workbuddy/memory/2026-08-27.md

2026-08-27 工作日志

全站底部操作栏「返回」按钮统一改为「取消」

• 起因：用户访问 /vehicle/customer-archive/form 独立表单页，指出底部「返回」按钮应全站统一为「取消」。
• 改动文件（模板/逻辑中的「返回」→「取消」）：
  • src/views/vehicle/customer-archive.vue：主表单页 footer 逻辑 readonly ? '关闭' : isArchivePage ? '返回' : '取消' → readonly ? '关闭' : '取消'；4 处子弹窗（contact/receipt/invoice/score）>返回</el-button> → >取消</el-button>（replace_all）。
  • src/views/payment/invoice-receipt-form.vue、payment-application-form.vue、payment/payment-application-form.vue：goBack 返回按钮 →「取消」。
  • src/views/business/components/master-order-editor.vue、master-order-dispatch.vue、master-order-detail.vue：$emit('back') 返回按钮 →「取消」。
  • src/views/business/components/business-crud-page.vue：运输计划导入弹窗关闭按钮 →「取消」。
  • src/views/system/user.vue：用户弹窗关闭按钮 →「取消」。
  • src/views/business/project-apply.vue：独立表单页（isProjectFormPage）closeProjectForm 返回按钮 ×2 →「取消」。
• 未改动：src/lang/zh.js 登录 i18n 段 back: '返回'（无 $t('back') 引用，属登录流程返回，非业务 footer 操作栏）。
• 规范固化：更新 MEMORY.md「弹窗 / 独立表单页底栏按钮统一规则」，明确全站底部操作栏「返回」统一为「取消」，仅只读查看 / 纯关闭场景保留「关闭」。

发货模板独立表单页（shipping-template/form）footer 缺「取消」+ 去图标

• 起因：用户访问 /business/shipping-template/form?mode=add，指出底部按钮缺「取消」且不需要图标（统一只要文字）。
• 该页极薄，仅 <business-crud-page standalone-form-page>，footer 由 business-crud-page.vue 的 PageAvueForm 渲染。
• 改动（src/views/business/components/business-crud-page.vue）：
  • #menu-form-before 次要按钮 关闭 → 取消（条件 isStandaloneFormPage && !showTransportPlanCreateActions），影响 /waybill-manage/form、/transport-plan/form、/shipping-template/form 三处独立表单页。
  • #menu-form 的运输计划创建模式次要按钮 关闭 → 取消。
  • 新增样式 :global(.business-crud-form-page-dialog .avue-form__menu .el-icon){display:none}：Avue 的 avue-form 提交/清空按钮内置图标（submitIcon:'el-icon-check'、emptyIcon:'el-icon-delete'），且 Avue 源码用 || 兜底无法通过 option 去除，故用 CSS 在独立表单页容器内统一隐藏图标，仅保留文字，不影响其它弹窗。
• 规范固化：MEMORY.md「弹窗 / 独立表单页底栏按钮统一规则」补充「独立表单页 Avue 表单 footer 去图标（统一纯文字）」说明。

底部操作栏按钮间距统一去 gap

• 起因：用户指出这些底部按钮间距不一致，要求统一，并把用了 gap 的全部去掉。
• 方案：所有底部操作栏（footer / __actions / page-actions）移除 gap，间距统一回落到 Element Plus 全局默认的相邻按钮 .el-button+.el-button{margin-left:12px}（恒为 12px），不再散落 gap:8/12/16px。
• 全局对齐：.el-dialog__footer .el-button + .el-button 由 margin-left:8px 改为 12px（src/styles/element-ui.scss），使弹窗 footer 也与之一致。
• 已去 gap 的 footer 容器：vehicle/customer-archive.vue(.archive-form__footer)、business/components/master-order-editor.vue(footer)、business/components/master-order-dispatch.vue(.segment-actions/.pending-actions)、business/project-apply.vue(.project-apply-dialog__footer)、business/components/business-crud-page.vue(.business-crud-form-page-dialog .avue-form__menu)、payment 6 个表单页(*__actions)、settlement/components/pre-settlement-editor.vue(&__page-actions)、settlement/components/formal-settlement-editor.vue(.formal-editor__page-actions)、settlement/receivable-payable-detail.vue(.settlement-detail-page__actions)。
• 风控：确认 Avue 的 .avue-form__menu/.avue-dialog__footer 自身不带按钮间距，去掉 gap 后由 EP 默认 12px margin 接管（不会贴死）。
• 范围说明：本次聚焦近几轮在统一的模块（vehicle/payment/business/settlement）。若要把 loading-manage、contract-manage、transit 等其它模块的底部栏也纳入，需再处理。

客商档案搜索区「所属组织」从扁平下拉改为树形下拉

• 起因：用户截图 /vehicle/customer-archive 搜索区，指出「所属组织」是扁平下拉，要求统一按新增/编辑表单（多选 el-tree-select）实现。
• 原 column 配置：prop: 'deptName' + search: true + searchType: 'select' + dicData: [{label:'全部',value:''}, ...flattenDept]，initDeptTree() 异步把 dicData 写回 column（数据已加载，只是渲染风格不一致）。
• 改动：
  • column 移除 searchType: 'select'、searchValue: ''、dicData，仅保留 search: true, searchOrder: 1。
  • initDeptTree() 中改写 deptColumn.renderSearch = scope => this.renderDeptSearch(scope)。
  • 新增 methods.renderDeptSearch(scope)：通过 vue 的 h 函数返回一个 el-tree-select vnode（多选 + check-strictly + 树形 + 折叠 tag + 全宽），onUpdate 时把 ID 数组按 deptOptions 查 rawLabel，逗号拼接写入 scope.row.deptName（即 searchForm.deptName），保持后端接口字段不变。
  • searchChange/searchReset 链路无需改：onLoad 已通过 query 透传 deptName 到后端。
  • src/styles/element-ui.scss 新增 .avue-crud__search .el-form-item__content > .el-tree-select { width:100%; max-width:100%; }：搜索区树形下拉全宽兜底，不影响新增/编辑表单（用 el-col :span=6 栅格自然分开）。
• 方案说明：Avue-crud 搜索 form-temp 内部 render 函数支持 column.renderSearch 自定义渲染（header-search2.mjs 行 93 render: ele.renderSearch），不需要重写整个搜索区；自定义 slot <template #search-deptName> 在 el-input 等自闭合组件上无法落地（slot 名不会被 el-input 识别），所以走 renderSearch。
• 选择项：用户确认「仅替换所属组织一格」「多选」「传 deptName」三项。
• 排查「出不来了」反馈：主人实测搜索区只有 label，控件区域空白。原因 h('el-tree-select', {...}) 传字符串时 Vue 3 _createVNode 直接把 type 当 ELEMENT（shapeFlag=1）处理，不会调用 resolveComponent，结果浏览器渲染出未知标签 <el-tree-select>，内容为空。
• 修复：从 element-plus import ElTreeSelect 组件对象，h(ElTreeSelect, {...}) 走组件 vnode 路径；同时把 modelValue 默认值改为 []（多选模式数组要求，避免 el-tree-select 警告）。
• 教训：Avue column.render/renderSearch 等接受 vnode 的字段，传字符串组件名时 Vue 不会 resolve，必须直接 import 组件对象或在 setup 内 resolveComponent()。
• 排查「选中不了」反馈：控件显示出来了，但点击树节点无法选中/再选。根因 onUpdate:modelValue 里把 scope.row.deptName 写成了名字字符串，而该字段正是 el-tree-select 的 modelValue（多选模式必须是ID 数组），第一次选中后 modelValue 变字符串，el-tree-select 内部状态错乱，后续点击无法更新。
• 修复：renderDeptSearch 的 onUpdate:modelValue 只把 scope.row.deptName 写成 ID 数组（保留数组形态）；在 searchChange(params, done) 里把 Avue 拷贝出来的 params.deptName 数组（注意：filterParams 走 deepClone，params 与 scope.row 是不同引用，改它不破坏搜索框显示）按 deptOptions 查 rawLabel 再 join(',') 转成名字字符串写入 query，后端字段 deptName 不变。重置由 Avue resetForm 清空 scope.row.deptName 为 ''，renderDeptSearch 读到非数组回退 [] 显示空，无需额外处理。

船舶表单「安放龙骨日期/建造完工日期」label 收窄并换行

• 起因：用户截图 transportCapacity/ship 新增船舶弹窗，指出该字段 label 宽达 185px，要求最大 88px 并允许换行。
• 改动：src/views/transportCapacity/ship.vue 第 169 行，给该 el-form-item 增加 label-width="88px" 覆盖全局 label-width="100"；全局 .ship-form :deep(.el-form-item__label) 已设置 white-space: normal; line-height: 20px，换行已支持。

船舶证书信息两块表单改 4 列

• 起因：用户截图 transportCapacity/ship 船舶证书信息，指出「船舶所有权证书」「内河船舶安全与环保证书」两块想改成 4 列。
• 改动：src/views/transportCapacity/ship.vue
  • 「船舶所有权证书」5 个字段：第一行 登记号码/初次登记号码/船舶所有人/取得所有权日期 4 列，第二行 船舶识别号 1 列（所有 el-col :span="8" → :span="6"）。
  • 「内河船舶安全与环保证书」4 个字段：合并为一行 4 列（总吨/净吨/船检登记号/船舶类型），el-col :span="8" → :span="6"。
• 未改动：船舶国籍证书、最低安全配员证书（日期范围，保持 span=16 整行）、光船租赁登记证明书、船舶营业运输证书（用户未要求）。