Files
shanxia2.0/docs/superpowers/specs/2026-08-22-pl-plan-blank-slip-print-design.md
T
zlwuandCursor ed939097f0 docs(pl): add blank slip print design for transport plans
Document toolbar blank inbound/delivery/subpack print via openBlank(),
including empty fields, no seal on delivery blanks, and no selection required.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-08-22 11:18:31 +08:00

5.7 KiB
Raw Blame History

运输计划 · 空白单据打印 — 设计文档

日期: 2026-08-22
状态: 待实施
前置: docs/superpowers/specs/2026-07-26-pl-print-slip-dropdown-design.md;docs/superpowers/specs/2026-07-27-pl-plan-batch-print-merge-design.md;现网入库单 / 送(提)货单 / 分装单模版与打印弹窗

目标

运输计划列表支持打印 空白 入库单、送(提)货单、分装单:保留版式骨架,不填业务数据,供现场手写。与「按勾选计划填数打印」并存。

已确认决策

# 决策 说明
D1 方案 A:openBlank() 三个打印弹窗各增空白打开路径;与填数打印隔离,不伪造业务态混入现有 open(planIds)
D2 入口仅列表工具栏 「打印单据」下拉增加三项空白;查看弹窗、安排成功底栏不加空白项
D3 未勾选也可点 「打印单据」按钮始终可点;未勾选时原三项灰掉,仅三个空白项可用
D4 勾选时两项并存 原三项仍按 planType / 合打规则启用;空白三项始终可点(忽略所选计划数据)
D5 空白入库单 业务字段全空(含单据编号等);版式骨架保留;印章随默认模板(不特意关闭)
D6 空白送(提)货单 业务字段全空;默认不显示印章
D7 空白分装单 业务字段全空;分装单号也不填;不调用 ensureSubpackSlipNo
D8 产品区 使用若干空行便于手写;不得展示「暂无产品信息」
D9 不读计划模板 / 不占号 空白模式使用内置默认模板生成;不拉计划详情;不读写计划上已存模板内容;不占分装单号
D10 保存模板 空白模式下隐藏或禁用「保存模板」,避免误写到计划

非目标(本期不做)

  • 后端空白单专用 API
  • 独立空白打印页面 / 路由
  • 空白单合打、按计划覆盖空白字段
  • 修改富文本模版列结构或条款文案
  • 查看弹窗、安排运输成功栏的空白打印入口

交互(列表工具栏)

打印单据 ▾          ← 始终可点(不依赖勾选)
├─ 入库单           ← 需勾选且 canBatchPrintSlip(..., 'inbound')
├─ 送(提)货单       ← 需勾选且 canBatchPrintSlip(..., 'delivery')
├─ 分装单           ← 需勾选且 canBatchPrintSlip(..., 'subpack')
├─ 空白入库单       ← 始终可点 → inboundSlipPrintRef.openBlank()
├─ 空白送(提)货单   ← 始终可点 → deliverySlipPrintRef.openBlank()
└─ 空白分装单       ← 始终可点 → subpackSlipPrintRef.openBlank()
  • 未勾选:原三项 disabled,空白三项可点。
  • 已勾选:原三项按现网规则;空白三项仍可点,且 不使用 勾选行数据。

空白内容规则

保留(版式骨架)

  • Logo、公司名称、单据标题(入库单 / 送(提)货单 / 分装单)
  • 信息区标签与下划线框、物料表表头、空行网格
  • 条款、签字栏等固定版式(各模板现有结构)

清空(业务数据)

  • 客户/单位、日期、人员、车辆、备注、联系方式等占位字段 → 空
  • 物料单元格 → 空
  • 单据编号 / 计划号 / 分装单号 → 空
  • 送(提)货单:showRedSeal = false,打开时不注入印章图

产品空行

单据 空行策略
入库单 / 送(提)货单 空白模式生成固定数量空网格行(建议与分装单最小行数对齐,或不少于 5 行);禁止「暂无产品信息」合并单元格文案
分装单 复用现有 SUBPACK_SLIP_PRODUCT_MIN_ROWS 空行填充逻辑,产品数组为空即可

技术要点

前端改动面

文件 改动
web-admin/src/views/pl/plan/index.vue 工具栏:按钮去掉「未选禁用」;下拉增加三个空白 command;handler 调 openBlank()
pl-inbound-slip-print-dialog/index.vue openBlank();空白态禁用保存模板;产品空行
pl-delivery-slip-print-dialog/index.vue 同上;打开时默认关章
pl-subpack-slip-print-dialog/index.vue 同上;不请求分装单号
pl-*-slip-template.ts(按需) 支持「空 Plan + 空 ctx」替换;入库/送提货 buildProductRows 增加空白模式空行(或由弹窗传入空行 HTML)

openBlank() 行为

  1. 不调用 planApi.get / get*SlipTemplate / ensureSubpackSlipNo
  2. htmlContent = generate*SlipTemplate()(默认模板)
  3. 用空业务数据做 replace*SlipPlaceholders(或等价全空替换)
  4. 送(提)货:showRedSeal = false,并确保内容无印章 img
  5. 打开弹窗;标题可区分如「预览空白入库单」或沿用现标题(实现时择一,保持三类一致)

后端

本期 无 后端变更。


验收标准

  1. 未勾选任何计划时,「打印单据」可点;原三项灰;三个空白项可打开对应弹窗。
  2. 空白入库单:无业务数据、无「暂无产品信息」、有空行;可打印/PDF。
  3. 空白送(提)货单:无业务数据、无印章、有空行;可打印/PDF。
  4. 空白分装单:无业务数据、分装单号为空、有空行;不产生新分装单号;可打印/PDF。
  5. 勾选计划后,原三项填数打印行为与现网一致;空白三项仍出空白单且不带入勾选数据。
  6. 空白模式下无法「保存模板」到计划。

风险与注意

  • 入库/送提货现网空产品会渲染「暂无产品信息」,空白模式必须绕开该分支。
  • 已保存的计划模板可能含历史数据;空白路径 禁止 读取计划模板,避免脏数据。
  • 公司名等常量来自模板 defaults,属版式而非业务填写,保留。