2026-10-06-pl-plan-list-excel-merge-design.md 6.8 KB

运输计划类列表:一行一产品 + 两级合并单元格

日期:2026-10-06
状态:已确认
对照 Demo:docs/superpowers/demos/2026-10-06-pl-plan-list-excel-merge-demo.html(方案 A)
取代:docs/superpowers/specs/2026-09-30-pl-plan-archive-pair-list-design.md 中「段上列格内装/送叠放」;保留「装货客户 | 送货客户」两列,以及「一行对应一个装货×一个送货」的配对关系(再按产品拆行)。

背景与目标

运输计划、运输归档、危化品证上传(以及同源的合同完善)列表已经把计划级字段做了 rowspan,但段上信息仍挤在同一格里:

  • 地址/时间、合同、数量、地磅等用虚线上下叠「装 / 送」;
  • 产品列按合同涂绿/蓝底,一格多件货。

扫读对不齐,色块语义也不清。改为 Excel 习惯:左边合并计划/送货客户,右边一行一件货;装货量与送货量分列。

已确认决策

项 决策
方案 Demo 方案 A:一行一产品 + 两级合并
范围页 运输计划、运输归档、危化品证上传、合同完善;合同详情「关联运输计划」同源列表一并改
行模型 一行 = 供或需的一份合同下的一个产品(先列全部供合同×产品,再列全部需合同×产品)
产品对齐 先 planProductId,否则 productId,到装货段找同一件货
视觉 去掉格内虚线叠放(pl-plan-pair-stack)和产品合同色块
勾选 / 序号 / 分页 仍按计划,不是按产品行;仅计划第一行可勾选
后端 不改接口、不分页算法;前端展平已返回的整单
小程序 不改;flattenPlanListRows(一段一行)留给小程序卡片

行模型

对每个计划:

  1. 解析装货段 load 与送货段列表 deliveries(无送货时保留 1 个空送货占位,与现配对行一致)。
  2. 按现有装货客户 / 送货客户关键字过滤送货段(筛选后对侧客户仍在,因装货列来自 pairLoad)。
  3. 先展开装货(供)产品:按合同排序,同一合同的产品相邻。
  4. 再展开各送货段(需)产品:同样按合同排序;无合同的需产品连续,合同列合并为一格。
  5. 每个产品生成一行,挂上:
    • kind = load(供)或 delivery(需)
    • plan、pairLoad、本侧 stop
    • 供行:loadProduct;需行:deliveryProduct
    • 单列「合同」只读本行这一侧,前缀 供/需 Tag
  6. 计算:
    • planRowSpan = 该计划供+需产品行总数
    • deliveryRowSpan = 同一送货段连续行(仅 1 个送货时含供行一起合)
    • productContractRowSpan = 同侧连续相同合同的行数
    • isPlanFirstRow / isPlanLastRow / isDeliveryFirstRow / isProductContractFirstRow

数量 / 单价 / 金额: 不再分装货列、送货列。本行产品直接显示计划量、实际量、入库、出库、单价、金额。

产品名列头筛选:只保留命中产品行,并重算两级 rowspan。

两级合并

Element Plus span-method 按列所属层级合并:

计划级(isPlanFirstRow 时 rowspan = planRowSpan,否则 0):勾选、序号、计划编号,以及现有 PLAN_MERGE_COLUMN_PROPS(跟进状态、日期、送货时间、单据类型、车牌、人员、跟进人、链接复制、归档状态、ERP、计划附件、承运商、证书齐备等),加上 装货客户、装货地址/时间、装货地磅、装货合同缺口。

送货段级(isDeliveryFirstRow 时 rowspan = deliveryRowSpan):送货客户、送货地址/时间、送货地磅、送货合同缺口。

合同级(同侧连续相同合同):单列 合同 合并;格内「供」或「需」Tag + 合同号。无合同的需行合并为一格。

不合并: 产品名称、型号/规格、包装规格、单位、装/送计划量、装/送实际量、装/送入库、装/送出库、装/送单价、装/送金额、该行危化证。

计划斑马纹与计划块底部分隔线(pl-plan-list-row--plan-end)保持按计划,不按产品。

列拆分

现列 改为 合并
地址 / 时间 装货地址/时间、送货地址/时间 计划 / 送货段
合同 单列「合同」(供或需 Tag + 本行合同) 同侧连续相同合同 rowspan
计划数量 / 实际数量 / 入库 / 出库 / 单价 / 金额 各一列,跟本行产品 不合并
地磅 装货地磅、送货地磅 计划 / 送货段
合同缺口 装货缺口、送货缺口(补充按钮仍分侧) 送货段级只合送货侧;装货缺口计划级

入出库仍按本行侧别:供行按装货客户判断入/出库;需行按送货客户。该方向无值则 —。

产品名称旁保留毒/爆 el-tag。不再按合同给产品格涂绿/蓝底。单列「合同」格内一行:供 或 需 Tag + 本行合同号(可点击打开合同详情)。

列设置:用新 prop 替换被拆掉的旧列;计划页入库/出库仍默认隐藏。

导出

与列表同行:一行一条货;装/送客户、地址、合同、数量分列;不再把多件货或装/送两段用换行拼进一个单元格。

实现要点

  • 主逻辑:web-admin/src/utils/pl-plan-list-display-rows.ts 的 flattenPlanArchivePairRows(可改名但须保持 archivePairMode 调用方兼容)+ buildPlPlanListSpanMethod(按列 prop 或列分区判断计划级 / 送货段级,不能再假设「左侧连续 N 列全是计划级」而不包含装货拆列)。
  • 组合:usePlPlanMergeListTable 继续给四页和 pl-contract-linked-plans-panel。
  • 页面去掉 pl-plan-pair-stack。产品格改为单件展示(可瘦身 PlPlanListProductCell 为单产品,或页面直接绑 deliveryProduct 字段)。
  • 不修改:后端、小程序、flattenPlanListRows、计划表单/归档弹窗。
  • 合同用量弹窗 flattenPlanListRowsForProduct:已按单产品过滤;若仍走配对列表外壳,改为同一套「送货×产品」展平(该场景每段通常只剩一件货)。

测试

单测覆盖展平与 span-method:

  • 2 装货产品 + 2 送货各若干产品 → 供行在前、需行在后;计划 rowspan=总行数
  • 合同 A(供 a、b)+ 合同 B(供 c)再 4 条无合同需产品 → 供合同 rowspan 2、1;需合同 rowspan 4
  • 产品筛选后 rowspan 重算
  • 计划量/实际量/单价/金额不再分装送,跟本行产品

手测:三页 + 合同完善;多送货多产品;勾选/序号按计划;导出一行一货;列设置显隐后合并不错位。

非目标

  • 不改列表接口与服务端分页(仍按计划条数)
  • 不改小程序运输计划卡片
  • 不做方案 B/C(一段一行、或客户列不合并的拍扁表)
  • 不恢复段次列「装货 / 送货 #n」