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>
5.7 KiB
5.7 KiB
运输计划 · 空白单据打印 — 设计文档
日期: 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() 行为
- 不调用
planApi.get/get*SlipTemplate/ensureSubpackSlipNo htmlContent = generate*SlipTemplate()(默认模板)- 用空业务数据做
replace*SlipPlaceholders(或等价全空替换) - 送(提)货:
showRedSeal = false,并确保内容无印章 img - 打开弹窗;标题可区分如「预览空白入库单」或沿用现标题(实现时择一,保持三类一致)
后端
本期 无 后端变更。
验收标准
- 未勾选任何计划时,「打印单据」可点;原三项灰;三个空白项可打开对应弹窗。
- 空白入库单:无业务数据、无「暂无产品信息」、有空行;可打印/PDF。
- 空白送(提)货单:无业务数据、无印章、有空行;可打印/PDF。
- 空白分装单:无业务数据、分装单号为空、有空行;不产生新分装单号;可打印/PDF。
- 勾选计划后,原三项填数打印行为与现网一致;空白三项仍出空白单且不带入勾选数据。
- 空白模式下无法「保存模板」到计划。
风险与注意
- 入库/送提货现网空产品会渲染「暂无产品信息」,空白模式必须绕开该分支。
- 已保存的计划模板可能含历史数据;空白路径 禁止 读取计划模板,避免脏数据。
- 公司名等常量来自模板 defaults,属版式而非业务填写,保留。