修茈科技 LogoXCAGI企业业务自动化平台
ERP 与业务文件 / 单据与打印

标签打印

部分验证Web · 已验证代码更新于 2026-09-30

单张标签打印与工作流批量标签调度，支持产品查找联动，面向生产现场贴标场景。

返回 ERP 与业务文件

功能价值

单张标签打印与工作流批量标签调度，支持产品查找联动，面向生产现场贴标场景。

使用方式

在对话或工作流中触发标签打印；打印机按车间配置。

所属模块

ERP 与业务文件 / 单据与打印

适用平台

Web · 已验证

已知限制

  • 打印机型号适配以现场联调为准

平台验证状态

本项适用于 1 个平台，逐平台独立判定：平台状态只由该平台的实机验收记录产生，总体状态由平台状态自动汇总，目录与页面都不存放可手写的状态。验收结论仅覆盖记录所列版本、Git SHA 与产物；当前源码或新安装包仍需独立验收。

Web

已验证

验收结果：PASS；通过 3 / 失败 0；产品版本 1.0.0.5；Git SHA 086a98f1fbad9f9b357692a85e656d8972cb6bc3；验证时间 2026-09-29。Acceptance JSON SHA-256 d16e9beffc22d34c2ed64feaef13937ca1a6f4a639c08b701d648fe557128074

实机录像 / 操作流程

媒体内容已复核，记录结论：验收结果：通过；画面内容：本轮真实浏览器会话录像（webm）：管理端登录 → 标签员工状态 → 打印事件发布 → 旧接口负例。；SHA-256：c394ce4438bca52e1d37c79f2bcbf55b735e7535e84b50a224caa2ad50554685（原始文件：FHD/docs/evidence/e2e/feature-acceptance-webadmin-20260929/tools/runs/erp-label/video/erp-label-web-20260929-152143.webm） 下载原始录像

实机截图

标签打印 已复核截图
媒体内容已复核，记录结论：验收结果：通过；画面内容：管理端登录页「XCMAX 服务器后台 · 管理员登录」，账号框已填 admin、密码框为掩码。；SHA-256：414431fe7c69a21a2a1ef30b66120404bce84b51051110e5dee1c3977f037958（原始文件：FHD/docs/evidence/e2e/feature-acceptance-webadmin-20260929/tools/runs/erp-label/shot/00-login-form.png） 查看原图
标签打印 已复核截图
媒体内容已复核，记录结论：验收结果：通过；画面内容：浏览器渲染标签打印员工 status 真实 JSON（ok、summary、meta）。；SHA-256：42acadb63544dee05ce811bfa7a52db96c76d73443849cc5ac32afc31bf61757（原始文件：FHD/docs/evidence/e2e/feature-acceptance-webadmin-20260929/tools/runs/erp-label/shot/LB1-label-employee.png） 查看原图
标签打印 已复核截图
媒体内容已复核，记录结论：验收结果：通过；画面内容：浏览器渲染打印作业事件发布真实响应：200、job_id、event=print.job.submitted、run_id。；SHA-256：0a9134e293ca35e51d738217eea078ae68cc344b9ad8d073c0a81405ee620baf（原始文件：FHD/docs/evidence/e2e/feature-acceptance-webadmin-20260929/tools/runs/erp-label/shot/LB2-label-print-event.png） 查看原图
标签打印 已复核截图
媒体内容已复核，记录结论：验收结果：通过；画面内容：浏览器渲染旧打印接口 /api/print/templates、/label、/printers 的 403 fail-closed。；SHA-256：901fec8ab939ecafa265d4a1f7fbcb2623aa750d1dae87a2310947327329d205（原始文件：FHD/docs/evidence/e2e/feature-acceptance-webadmin-20260929/tools/runs/erp-label/shot/LB3-label-legacy-denied.png） 查看原图

运行日志

下载原件：erp-label-web-20260929-152143.log；SHA-256：4bb1e6c98485c769c691fadbcf7048a0a2c74f302645fd5680236495d4aa677e（仓库路径：FHD/docs/evidence/e2e/feature-acceptance-webadmin-20260929/tools/runs/erp-label/log/erp-label-web-20260929-152143.log）

安装包 / 部署产物 SHA-256：cfa52148ab19fd69e6bea715cc2b9ad046f9607dbdee31033cb9d5357d3c7368 · 交付身份 JSON

实现与测试（平台无关）

图片内容复核（2026-09-30，Mac 1.0.0.5）：画面停在智能对话，没有实体标签出纸。

源码实现

  • FHD/app/fastapi_routes/print_routes.py
  • FHD/app/fastapi_routes/label_jobs.py

API 端点

  • POST /api/print/single_label
  • POST /api/print/workflow/label-print/dispatch

自动化测试

  • FHD/tests/routes/test_print_routes_5xx.py

CI 门禁：FHD/.github/workflows/ci-cd.yml

CI 工作流定义

  • FHD/.github/workflows/ci-cd.yml

未标注平台的补充资料

下列资料未绑定到具体平台，仅作实现与历史资料参考，不计入任何平台状态，也不构成实机验收。

实机截图

标签打印 已复核截图
记录结论：资料收录（未绑定平台验收）；SHA-256：1ae11035044673214f12f5b958b1195f660bbbd5e705d78cedb6e1d1777917bf（原始文件：FHD/docs/evidence/capabilities/erp-label-01-label-editor.png） 查看原图
标签打印 已复核截图
记录结论：资料收录（未绑定平台验收）；SHA-256：65698cdf59246aaeb8adc7e695605f86e73fd8e40c8e0de9395082d6110f24d7（原始文件：FHD/docs/evidence/capabilities/erp-label-02-label-print.png） 查看原图

关联文档

  • FHD/docs/FEATURE_MAP.md

证据原件存放于私有对象存储，页面通过短时效签名地址读取原图与原始录像； 「核验哈希」会对照本页登记的 SHA-256 与存储对象元数据。对象存储不可用时自动改用站内副本， 也可下载原件后用 sha256sum 自行核对。