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

2026-08-14 工作记录

temporary-credit-limit 弹窗 label 固定 6 汉字宽度并换行

• 需求：用户反馈 /business/temporary-credit-limit 新增弹窗中 label「已使用项目资金使用额度（万元）」过宽（227px），希望超过 6 个汉字就换行。

loading-manage 搜索栏 label 宽度 160→88

• 用户要求把 /business/loading-manage 页面搜索栏所有 label 宽度从 160px 改为 88px。
• 改动：src/views/business/loading-manage.vue 第 4 行 <el-form ... label-width="88px">。
• 注意事项：AGENTS.md 4.4 节规范"搜索组件 label 宽度统一不小于 160px"，本次按用户指令执行但与项目规范冲突；如后续要恢复规范或全站统一，需要回滚。

shipping-template 弹窗高度改为接近全屏

• 用户要求把 /business/shipping-template 弹窗高度调到接近全屏（硬编码 200px 安全区太大）。
• 关键定位：Avue 库内置 .avue-dialog { max-height: calc(100% - 200px) } 加在 el-dialog 根元素（avue lib packages/core/components/dialog-form/index4.js:14 class:"avue-dialog"）；shipping-template 的 dialogCustomClass:'shipping-template-dialog' 合并到同一元素。项目样式（common.scss）在 main.js:24 晚于 Avue css（main.js:12）加载，可覆盖。
• 改动：src/styles/element-ui.scss 的 .shipping-template-dialog.el-dialog 规则，由 margin-top:4vh; margin-bottom:0; height:calc(100vh - 4vh - 24px) 改为 margin-top:20px !important; margin-bottom:20px !important; height:calc(100vh - 40px); max-height:calc(100vh - 40px) !important，用 max-height + !important 压过库内置上限。
• 注意：仅改 shipping-template 专属规则，未动库内置 .avue-dialog 根，也未影响其他弹窗。body/footer 的 flex 分摊规则（474-488 行）保持不变。

transport-plan 弹窗高度也改为接近全屏

• 用户要求 /business/transport-plan 新增/编辑弹窗同样改为接近全屏（原来固定 max-height: 72vh，内容少时下方留白）。
• 改动：src/styles/element-ui.scss 的 .transport-plan-dialog.el-dialog 规则，由 margin-top:4vh; max-height:72vh 改为 margin-top:20px !important; margin-bottom:20px !important; height:calc(100vh - 40px); max-height:calc(100vh - 40px) !important，与 shipping-template 弹窗完全对齐（压过库内置 .avue-dialog 的 max-height: calc(100% - 200px)）。
• 已确认 src/option/business/transport-plan.js:607 有 dialogCustomClass: 'transport-plan-dialog'，CSS 生效。body/footer flex 分摊规则（504-520 行）保持不变。

waybill-manage 弹窗高度也改为接近全屏

• 用户要求 /business/waybill-manage 新增/编辑弹窗同样接近全屏。
• 机制澄清：waybill-manage 用封装组件 src/views/business/components/business-crud-page.vue，它内部 <avue-crud :option="option">，option 由传入的 crudOption（即 waybill-manage.js 的 option）经 cloneOption（组件内 6261 行，浅展开+重映射 column，保留所有顶层属性）克隆而来。因此给 waybill-manage.js 的 option 顶层加 dialogCustomClass 即可只影响本页（不影响共用 business-crud-page 的其他页面）。Avue crud 弹窗 dialog-form3.js:21 会读取并应用 dialogCustomClass。
• 改动1：src/option/business/waybill-manage.js 的 export const option = { 顶层加 dialogCustomClass: 'waybill-manage-dialog'（在展开 ...createCrudOption( 之前）。
• 改动2：src/styles/element-ui.scss 新增 .waybill-manage-dialog.el-dialog / .el-dialog__header / .el-dialog__body / .avue-dialog__footer 四条规则，复刻 shipping-template 方案（height/max-height: calc(100vh - 40px) !important；body max-height:none !important 解开全局 .avue-crud__dialog .el-dialog__body 的 200px 限制；footer sticky）。额外在 footer 加 margin-top: 0 !important 抵消全局 .avue-crud__dialog .avue-dialog__footer { margin-top: -30px !important }（863 行）的上移副作用（shipping-template 是 dialog-form 弹窗无 avue-crud__dialog class 故不受影响，waybill-manage 是 avue-crud 弹窗会受影响，必须处理）。
• 宽度来源：
  • src/option/business/common.js 的 createCrudOption 中 labelWidth: 'auto'；
  • Avue 会按当前弹窗内最长 label 自动计算宽度，故出现 227px。
  • src/styles/element-ui.scss 第 164 行 .el-dialog .el-form-item__label { white-space: nowrap } 阻止换行。
• 改动：
  1. src/option/business/temporary-credit-limit.js：option 增加 dialogCustomClass: 'temporary-credit-limit-dialog'。
  2. src/styles/element-ui.scss：新增 .temporary-credit-limit-dialog .el-form-item__label 规则，固定宽度 calc(6em + 24px)，并设置 white-space: normal; word-break: break-all; overflow-wrap: anywhere; line-height: 18px，实现超长 label 自动换行。
  3. 同时给 .temporary-credit-limit-dialog .el-form-item { align-items: center; } 保持垂直居中。
• 参考：同文件已有 .avue-dialog--common-route 使用相同 6em label 宽度方案。

transportCapacity/ship 到期筛选标签默认展开并靠前

• 需求：用户反馈 /transportCapacity/ship 页面搜索栏的「全部/30天内到期/已到期」标签需要点击「展开」后才显示，希望默认直接显示；且位置要位于搜索按钮前面。
• 原因：src/option/transportCapacity/transport-ship.js 中 searchIndex: 4，默认只展示前 4 个搜索条件，而 expireStatus 的 searchOrder: 0（Avue 越大越靠前）排在第 6 位，因此被折叠到第二行。
• 改动：
  • src/option/transportCapacity/transport-ship.js：searchIndex: 4 → 6，让全部 6 个搜索条件默认展开，标签无需再点展开即可看到。
  • 由于 expireStatus 排在最后，展开后它自然位于第二行末尾、搜索按钮之前，满足"移到搜索按钮前面"的要求。

transportCapacity/vehicle 与 ship 到期筛选标签重构（对齐 driver 的 #search-menu 方案）

• 需求：用户希望 /transportCapacity/vehicle 和 /transportCapacity/ship 的「全部/30天内到期/已到期」标签与 driver 页一致：① 不展开就直接显示；② 移到搜索按钮前面并保留间距。
• 关键差异（排查发现）：driver 用 #search-menu 插槽把标签渲染在按钮所在行；而 vehicle/ship 之前用 #expireStatus-search 列插槽，标签被渲染进搜索条件网格（位置不对）。
• 改动（两页同样处理）：
  1. .vue：<template #expireStatus-search> → <template #search-menu>，标签 div 内容不变。
  2. .vue 样式 __expiry-tags：去掉 width: 100%，改为 order: -1; margin-right: 12px; min-width: 0;（与 driver 完全一致，使标签左移并落在搜索按钮前）。
  3. option：将 expireStatus 列的 search: true → search: false（否则会在搜索网格里多渲染一个空输入框）；searchIndex 设为 ≥ 真实搜索列数（vehicle: 4 → 6；ship 已是 6），使 columnLen ≤ searchIndex，Avue 不再显示「展开」按钮。
• 原理：Avue header-search3.js 中 #search-menu 插槽内容渲染进 menu-form，位于默认搜索/重置按钮之后、展开按钮之前；order: -1 将标签推到按钮左侧。
• 验证：node --check 两个 option 文件通过；页面刷新即可见效果。

process-config.vue 弹窗重构为手写 el-dialog（对齐 customer-archive 风格）

• 需求：用户要求 /business/process-config.vue 排版风格改成和 /vehicle/customer-archive.vue 一样，保持风格统一。
• 根因：两页弹窗架构根本不同——customer-archive 用手写 <el-dialog> + section-card 分组 + #footer 按钮；process-config 原用 Avue 内置弹窗（#basicInfo-form/#nodeConfigJson-form 插槽 + #menu-form-before 保存按钮）。要真正统一，只能把 process-config 改成手写弹窗。
• 模板改动（已完成）：
  • 移除 avue-crud 的 :before-open/@row-save/@row-update/@row-del 与 #menu-form-before、#basicInfo-form、#nodeConfigJson-form 插槽。
  • 在 </avue-crud> 后新增手写 <el-dialog class="process-dialog" v-model="processBox" width="92%" top="4vh" append-to-body @closed="resetProcess">，内部 <el-form ref="processForm" :model="form" label-width="calc(6em + 24px)" :disabled="dialogReadonly" class="process-form dialog-form-label-fixed">，含 3 个 section-card：基本信息 / 现行过程节点（时间线）/ 节点设置（节点表格）；#footer 含 保存草稿(plain) + 保存并启用(primary) + 取消/关闭。
  • 顶部「新建过程配置」、表格「查看/编辑」链接改调 openProcessConfig() / openProcessConfig(row, true) / openProcessConfig(row, false)。
• 脚本改动（本次完成）：删除 Avue 生命周期方法 beforeOpen/rowSave/rowUpdate/submitRow/stopSubmitLoading/handleProcessConfigSave；新增 openProcessConfig(row, readonly)（load 详情后 this.form=data + selectedProjectId + parseNodeConfig + 开框；新增则清空表单 + resetNodeRows）、submitProcessConfig(mode)（this.$refs.processForm.validate → syncNodeFields → normalizeRow → validateRow → confirmDuplicateVoucher → api.submit，成功后关框并刷新）、resetProcess()（@closed 重置 dialogReadonly/submitting/submitStatus/form/selectedProjectId + resetNodeRows + clearValidate）。data() 已含 processBox/submitting、computed.dialogTitle；rowDel/handleCopy/handleAction 不变（独立 API 调用）。
• option 改动（已完成）：src/option/business/process-config.js 置 saveBtn/updateBtn/addBtn/viewBtn/editBtn/delBtn:false，关闭 Avue 内置弹窗按钮。
• 样式：新增 :deep(.process-dialog .el-dialog__body){max-height:72vh;overflow:auto}，对齐 customer-archive 的 .archive-dialog 滚动行为（长内容时 body 滚动、footer 固定）。
• 验证：vite build --outDir /tmp/pc-build-check 全量编译通过（仅动态导入 chunk 警告，与本改动无关）；之前 npm run build 失败仅因沙箱 safe-delete 守卫清理旧 dist/ 触发，非代码错误。

contract-manage 到期筛选标签靠右对齐

• 需求：用户截图反馈 /business/contract-manage 搜索栏中「全部/30天内到期/90天内到期/90天以上/已到期」标签需要靠右对齐。
• 改动：src/views/business/components/business-crud-page.vue 中 .business-crud-page__contract-expiry-search 样式由 order: -1; margin-right: auto 改为 margin-left: auto。这样该 slot 内容会被推到 #search-menu 行的右侧，搜索/重置按钮留在左侧，与 vehicle/ship 的左侧标签方案相反，符合用户本次要求。
• 验证：vite build --outDir /tmp/pc-build-check-2 全量编译通过。

shipping-template 新增/编辑弹窗居中 + 加高（对齐 customer-archive）

• 需求：用户反馈 /business/shipping-template 新增弹窗「没居中、高度不够高」，要求参照 /vehicle/customer-archive 的做法。
• 根因排查：
  • shipping-template 的弹窗是 avue-crud 内置弹窗（business-crud-page + :crud-option，$refs.crud.rowAdd() 触发），option 里 dialogWidth:'96%'、dialogTop:'10px'。
  • avue 把 dialogTop 映射为 Element Plus --el-dialog-margin-top，'10px' 把弹窗死顶在顶部 → 视觉「没居中」。
  • avue 内置 footer（.avue-dialog__footer）渲染在可滚动 body 内部，不像 customer-archive 那样用 #footer 插槽在滚动区之外；字段多时「保存」按钮要滚动才看得到 → 视觉「高度不够高」。
  • customer-archive 真正做法是：手写 <el-dialog width="92%" top="4vh"> + #footer 按钮浮动 + body max-height:72vh 内部滚动。
• 改动：
  1. src/option/business/shipping-template.js：dialogWidth:'96%'→'92%'、dialogTop:'10px'→'4vh'，新增 dialogCustomClass:'shipping-template-dialog'（avue 会把它作为 class 加到 dialog 上，作为样式钩子）。
  2. src/styles/element-ui.scss：新增 .shipping-template-dialog 规则——弹窗体 height: calc(100vh - 4vh - 24px) + flex 列布局占满视口（顶部 4vh、底部留白，视觉居中高大）；body max-height:none !important; overflow-y:auto 解除全局 80vh 上限；.avue-dialog__footer 用 position:sticky; bottom:0; background:#fff 贴底始终可见，对齐 customer-archive 浮动按钮效果。
• 注意：class 唯一，仅作用于 shipping-template（business-crud-page 被多页共用，但其余页 option 未设该 class）；弹窗 append-to-body，故样式必须放全局（element-ui.scss）而非组件 scoped 样式。
• 验证：dev server(2889) HMR 自动生效；刷新后重开「新增」即可见效果（未跑全量 build，改动为纯 CSS + option 属性）。

transport-plan 新增/编辑弹窗固定 72vh（对齐 customer-archive 视觉）

• 需求：用户要求 /business/transport-plan 新增/编辑弹窗高度 72vh，与 /vehicle/customer-archive 视觉一致。
• 排查发现：上次给 shipping-template 加的 .shipping-template-dialog 全局 CSS 规则未持久化（option 钩子 dialogCustomClass:'shipping-template-dialog' 还在，但 element-ui.scss 里对应规则丢失），即 shipping-template 弹窗样式实际一直未生效。本次一并补回。
• 改动：
  1. src/option/business/transport-plan.js：补 dialogCustomClass:'transport-plan-dialog'（option 已有 dialogWidth:'96%'、dialogTop:'4vh'）。
  2. src/styles/element-ui.scss：
     • 补回 .shipping-template-dialog 规则（弹窗体 height: calc(100vh - 4vh - 24px) 占满视口 + flex 列布局；body max-height:none !important; overflow-y:auto；.avue-dialog__footer { position:sticky; bottom:0; background:#fff } 贴底）。
     • 新增 .transport-plan-dialog 规则（弹窗体用 height:72vh 固定高度，内容少时 body 下方留白、内容多时窗内滚动；footer 同样 sticky 贴底）。
• 关键技术点：Avue 内置弹窗 footer 的真实 class 是 .avue-dialog__footer，且渲染在 .el-dialog__body 内部；贴底必须用 position: sticky; bottom: 0（flex margin-top:auto 在滚动容器内仍会随内容滚走，无效）。这与手写 el-dialog（footer 在 body 外、class 为 .el-dialog__footer）不同。
• 验证：dev server(2889) HMR 自动生效；刷新后重开「新增」即可见（弹窗固定 72vh、底部"提交/取消"常驻可见）。

contract-manage 新增/编辑弹窗也改为接近全屏

• 用户要求 /business/contract-manage 新增/编辑弹窗同样接近全屏（与前几个 business 弹窗对齐）。
• 机制：该页同样用 business-crud-page 封装 → avue-crud 弹窗（带 avue-crud__dialog class），与 waybill-manage 完全一致。
• 改动：
  1. src/option/business/contract-manage.js：该文件 option 在 createCrudOption([...]) 之后本就用 option.xxx = ... 顶层赋值（span/dialogWidth/dialogTop 等），故在末尾追加 option.dialogCustomClass = 'contract-manage-dialog';（无需改结构，与文件既有写法一致）。
  2. src/styles/element-ui.scss：新增 .contract-manage-dialog 四条规则，复刻 waybill-manage 方案——height/max-height: calc(100vh - 40px) !important 压过库内置 .avue-dialog 的 200px 上限；.el-dialog__header { flex:none }、.el-dialog__body { flex:1 1 auto; min-height:0; max-height:none !important; overflow-y:auto } 解开全局 avue-crud 200px body 限制；.avue-dialog__footer { position:sticky; bottom:0; margin-top:0 !important; background:#fff } 抵消全局 footer 的 -30px 上移。

loading-manage 线路编辑「起/经/终」圆点分色

• 需求：用户反馈 /business/loading-manage 弹窗中"线路编辑"区域的「起/经/终」圆形徽标要区分颜色：起蓝、经橙、终绿。
• 改文件：src/views/business/loading-manage.vue。
• 涉及两处：① 主弹窗 loading-manage-dialog__route-type；② 变更运输路线弹窗 loading-route-change-dialog__route-type（保持全站一致）。
• 实现方式（最小侵入、不破坏现有结构）：
  1. methods 各加一个 routeTypeClass(index) / routeChangeTypeClass(index)，返回 'start' | 'middle' | 'end'。
  2. 模板里 span 改用 :class="['...route-type', '...route-type--' + ${xxxClass(index)}]" 动态 class。
  3. scoped 样式 __route-type 规则去掉硬编码 background，改用 &--start/#409eff + &--middle/#e6a23c + &--end/#67c23a 三个 modifier（颜色取 Element Plus 语义色：蓝主色 / 橙 warning / 绿 success），color: #fff 保留。
• 关键 trick：变更弹窗原 route-type 样式是单行压缩写法，本次顺手把它多行化（保持其他子规则不变），以便嵌套 &--xxx 修饰符。
• dev server(2889) HMR 自动生效，刷新后开新增/编辑弹窗向下滚到"线路编辑"分组即可见。