docs/打印标签维护/头程箱唛-SKU展示修正.md

头程箱唛 SKU 展示修正

2026-09-20 用户确认：头程箱唛没有 SKU，SKU 只在一件代发 A4 托盘信息单中展示。本次覆盖普通订单和一件代发订单的头程箱唛，退货标签按其独立业务记录处理。

原因与修正

旧箱唛模板 INBOUND_MARK_V1 在收到 skuCode 时额外绘制 SKU 行。该行位于距页面顶部约 55 mm，落在二维码约 48.7–84 mm 的区域内，造成截图中的文字与二维码重叠。

• 删除箱唛 SKU 绘制逻辑，并从 Print 箱唛 DTO、校验及 OpenAPI 中删除 skuCode。
• Firstleg 箱唛打印调用不再发送 SKU，后台、客户端、单票及批量打印共用这条映射。
• 一件代发 A4 的 SKU 明细、箱内 SKU 快照和 PDA 清点/组托数据保持原有业务含义。
• 箱唛继续为 100×100 mm，展示入仓码、仓库、箱序、线路、二维码、稳定箱码文字和产地；二维码内容不变。
• 本次为去除错误展示与遮挡的修正，沿用现有箱唛接口和模板标识，没有新旧版并行。

验证与发布

回归覆盖：含 SKU 的业务标签不会把 SKU 发送至 Print；生成 PDF 不含 SKU；二维码反向解码、页数、尺寸、字体与页序；一件代发 A4 仍含 SKU 明细。

2026-09-20 离线验证通过：Print 模块测试 63 项中 62 通过、1 项可选最大容量测试跳过；Firstleg 箱唛/一件代发打印定向测试 8 项通过；Mapper 合同、Gateway 路由合同（5 项）、AGENTS 索引合同（1071 项）均通过。已使用实际 Print 渲染代码生成脱敏箱唛并目检，SKU 消失且二维码无文字遮挡。样张为工作区 output/pdf/carton-label-no-sku.pdf，属于可重新生成的验收产物。

发布单元：print-service 和 firstleg-service。无需改数据库、前端或 Gateway 路由。本轮只做本地修改和离线验证，不部署、不执行真实 HTTP。旧 PDF 不会自动更新，部署后需重新下载箱唛；人工实打及 PDA 扫码待确认。