|
|
@@ -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，属版式而非业务填写，保留。
|
