From ed939097f0ccb64bceb84ef4660d2712a7d0e03d Mon Sep 17 00:00:00 2001 From: zlwu <704541015@qq.com> Date: Sat, 22 Aug 2026 11:18:31 +0800 Subject: [PATCH] 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 --- ...6-08-22-pl-plan-blank-slip-print-design.md | 120 ++++++++++++++++++ 1 file changed, 120 insertions(+) create mode 100644 docs/superpowers/specs/2026-08-22-pl-plan-blank-slip-print-design.md diff --git a/docs/superpowers/specs/2026-08-22-pl-plan-blank-slip-print-design.md b/docs/superpowers/specs/2026-08-22-pl-plan-blank-slip-print-design.md new file mode 100644 index 000000000..a770eb84b --- /dev/null +++ b/docs/superpowers/specs/2026-08-22-pl-plan-blank-slip-print-design.md @@ -0,0 +1,120 @@ +# 运输计划 · 空白单据打印 — 设计文档 + +> **日期**: 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，属版式而非业务填写，保留。