Files
shanxia2.0/openspec/changes/transport-plan-management/specs/transport-order/spec.md
T
2026-06-21 09:19:07 +08:00

3.7 KiB

Transport Order (运输单管理)

ADDED Requirements

Requirement: 运输安排

系统 SHALL 支持运输安排,包括选择车辆类型、车辆、司机,填写运输信息。

Scenario: 选择自有车辆

  • WHEN 用户选择车辆类型为"自有"
  • THEN 系统 SHALL 仅显示自有车辆列表
  • AND 用户选择具体车辆后
  • THEN 系统 SHALL 自动带出该车辆的默认司机

Scenario: 选择承运商车辆

  • WHEN 用户选择车辆类型为"承运商"
  • THEN 系统 SHALL 仅显示承运商车辆列表
  • AND 用户选择承运商后
  • THEN 系统 SHALL 仅显示该承运商名下的车辆
  • AND 用户选择具体车辆后
  • THEN 系统 SHALL 自动带出该车辆的默认司机

Scenario: 运输信息填写

  • WHEN 用户完成运输安排
  • THEN 系统 SHALL 生成运输编号(格式:SXYS######,每月重置)
  • AND 系统 SHALL 将运输安排状态从"待安排"更新为"已安排"

Requirement: 车辆归属唯一性

系统 SHALL 确保同一辆车只能属于一种类型(自有 或 承运商)。

Scenario: 车辆归属约束

  • WHEN 管理员新增或编辑车辆
  • THEN 系统 SHALL 要求选择车辆归属类型(自有/承运商)
  • AND 系统 SHALL 确保同一辆车只能选择一个归属类型
  • AND 系统 SHALL 禁止同一车牌号同时属于自有和承运商

Requirement: 二维码生成与分发

系统 SHALL 支持生成二维码供司机/现场人员扫码。

Scenario: 二维码生成

  • WHEN 用户点击"生成二维码"
  • THEN 系统 SHALL 生成包含运输单信息的二维码
  • AND 系统 SHALL 显示有效期设置(默认不设期限,用户可手动填写)
  • AND 系统 SHALL 提供下载二维码图片功能

Scenario: 二维码分发

  • WHEN 用户下载二维码图片
  • THEN 系统 SHALL 提示用户截图发送给司机/现场人员
  • AND 二维码 SHALL 包含运输单号、产品信息、目的地等关键信息

Requirement: 司机扫码回传

系统 SHALL 支持司机扫描二维码回传运输信息,无需登录。

Scenario: 司机扫码

  • WHEN 司机扫描运输单二维码
  • THEN 系统 SHALL 允许无需登录即可访问回传页面
  • AND 系统 SHALL 允许回传以下信息:
    • 运输单据照片
    • 运输数量
    • 其他信息(备注等)

Scenario: 现场人员扫码

  • WHEN 现场人员扫描二维码
  • THEN 系统 SHALL 要求登录验证权限
  • AND 系统 SHALL 显示完整的单据详情供查看

Requirement: 运输与计划关系

系统 SHALL 支持计划与运输的 N:N 关系。

Scenario: 1:1 关系

  • WHEN 一个计划对应一趟运输
  • THEN 系统 SHALL 允许直接关联

Scenario: 1:N 关系(分车装运)

  • WHEN 一个计划需要多趟运输(分车装运)
  • THEN 系统 SHALL 允许创建多个运输单关联同一计划

Scenario: N:1 关系(拼车)

  • WHEN 多个计划合并一趟运输(拼车)
  • THEN 系统 SHALL 允许一个运输单关联多个计划

Requirement: 待入库/待出库单据同步

系统 SHALL 支持待入库/待出库单据的自动同步。

Scenario: 单据自动生成

  • WHEN 计划状态流转至"待入库"或"待出库"
  • THEN 系统 SHALL 自动生成地磅单
  • AND 系统 SHALL 通过系统消息通知现场工作人员
  • AND 系统 SHALL 支持复制文本通过微信发送

Scenario: 地磅数据录入

  • WHEN 现场工作人员确认地磅数据
  • THEN 系统 SHALL 允许手动填写地磅数据(不对接硬件)
  • AND 系统 SHALL 允许上传单据和附件