ERP 与业务文件 / 进销存

发货单与出货管理

已验证Web · 已验证代码更新于 2026-10-25

从销售订单到出货单、单据生成的一体化流程,支持产品解析校验与文档自动产出。

功能价值

从销售订单到出货单、单据生成的一体化流程,支持产品解析校验与文档自动产出。

使用方式

业务员工在订单页创建发货单,系统自动生成单据并可打印。

所属模块

ERP 与业务文件 / 进销存

适用平台

Web · 已验证

已知限制

  • 暂未记录

平台验证状态

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

Web

已验证

验收结果:PASS;通过 4 / 失败 0;产品版本 1.0.0.5;Git SHA 086a98f1fbad9f9b357692a85e656d8972cb6bc3;验证时间 2026-09-29。Acceptance JSON SHA-256 ef7a71c4d27f332cc8bd19bf2b9a98afa1c64e43672b86dcb1d5708b33552cb1

实机录像 / 操作流程

媒体内容已复核,记录结论:验收结果:通过;画面内容:本轮真实浏览器会话录像(webm):管理端登录 → 发货事件发布 → 出货记录读取 → 员工状态 → 负例。;SHA-256:b3081acd6f55cab5be2c51c85839e52511f899c17752d2af7214cb7b6154d247(原始文件:FHD/docs/evidence/e2e/feature-acceptance-webadmin-20260929/tools/runs/erp-shipment/video/erp-shipment-web-20260929-151648.webm) 下载原始录像

实机截图

发货单与出货管理 已复核截图
媒体内容已复核,记录结论:验收结果:通过;画面内容:管理端登录页「XCMAX 服务器后台 · 管理员登录」,账号框已填 admin、密码框为掩码。;SHA-256:eae3c5728a67ec32b0f48bab8f99560d4fd394bc2a9f793c114b147ad38d2f26(原始文件:FHD/docs/evidence/e2e/feature-acceptance-webadmin-20260929/tools/runs/erp-shipment/shot/00-login-form.png) 查看原图
发货单与出货管理 已复核截图
媒体内容已复核,记录结论:验收结果:通过;画面内容:浏览器渲染发货单事件发布真实响应:200、published=true、event=shipment.created、run_id。;SHA-256:1e362591ec16ae867b8d14209272c78a90c05acc32e4228908a1ffaf67a82965(原始文件:FHD/docs/evidence/e2e/feature-acceptance-webadmin-20260929/tools/runs/erp-shipment/shot/SH1-shipment-create.png) 查看原图
发货单与出货管理 已复核截图
媒体内容已复核,记录结论:验收结果:通过;画面内容:浏览器渲染出货记录与单位读取的真实 JSON(租户安全门面)。;SHA-256:d89605e341b68456a49d42bac0071151344fed95ac8bfa4fa384d9b048b17f17(原始文件:FHD/docs/evidence/e2e/feature-acceptance-webadmin-20260929/tools/runs/erp-shipment/shot/SH2-shipment-records.png) 查看原图
发货单与出货管理 已复核截图
媒体内容已复核,记录结论:验收结果:通过;画面内容:浏览器渲染出货管理员工 status 真实 JSON(ok、summary、meta)。;SHA-256:a59f9e9611954c8750a34667b6e1b535f416d751bcc39055e4e4b2036a4a5b21(原始文件:FHD/docs/evidence/e2e/feature-acceptance-webadmin-20260929/tools/runs/erp-shipment/shot/SH3-shipment-employee.png) 查看原图
发货单与出货管理 已复核截图
媒体内容已复核,记录结论:验收结果:通过;画面内容:浏览器渲染缺 unit_name 的 422 validation_error 与旧 /api/shipment/orders 403 fail-closed。;SHA-256:26f0242f8e3d4de29cc2908ee69b423df3bc113ea0c38289e5fe96cd3860e79d(原始文件:FHD/docs/evidence/e2e/feature-acceptance-webadmin-20260929/tools/runs/erp-shipment/shot/SH4-shipment-negative.png) 查看原图

运行日志

下载原件:erp-shipment-web-20260929-151648.log;SHA-256:1cf5dbcaf2c174e0d7861a146cba20eb2144f64eeb12322f178a3fa161105248(仓库路径:FHD/docs/evidence/e2e/feature-acceptance-webadmin-20260929/tools/runs/erp-shipment/log/erp-shipment-web-20260929-151648.log)

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

实现与测试(平台无关)

图片内容复核(2026-09-30,Mac 1.0.0.5):出货记录页提示先选择购买单位,当前列表暂无数据。

源码实现

  • FHD/app/application/shipment_app_service.py
  • FHD/app/fastapi_routes/shipment
  • FHD/app/application/shipment_document_workflows.py

API 端点

  • POST /api/shipment/create
  • POST /api/shipment/list

自动化测试

  • FHD/tests/domain/test_shipment_product_parser.py

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

CI 工作流定义

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

未标注平台的补充资料

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

实机截图

发货单与出货管理 已复核截图
记录结论:资料收录(未绑定平台验收);SHA-256:8c279f5495751afe75fa9c4921bcda054001cb47c27dfc94d837ab8bedb942e0(原始文件:FHD/docs/evidence/capabilities/erp-shipment-01-shipment-records.png) 查看原图

关联文档

  • FHD/docs/FEATURE_MAP.md

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