Files
shanxia2.0/openspec/changes/pl-contract-cert-quota-control/specs/contract-cert-quota/spec.md
T

4.8 KiB

contract-cert-quota

ADDED Requirements

Requirement: 两种可编辑建档方式

系统 SHALL 支持无图片手工录入,以及图片解析后人工编辑确认;两方式共用档案与额度。

Scenario: 图片误识别

  • WHEN 100吨被识别为1000千克
  • THEN 用户可修改数量为100、单位为吨,保存使用确认值;识别本身不创建占用。

Scenario: 补传图片

  • WHEN 已有使用记录的手工档案补图
  • THEN 保留原档案及子明细ID、合同关联、余额与历史,不自动覆盖关键字段。

Requirement: 合同产品和两种证多对多

系统 SHALL 允许多个合同产品共用多张购买证、运输证;每张证仅有一个共享额度。

Scenario: 不同浓度共享

  • WHEN 合同50%和98%硫酸各运输10、20吨且均在同证适用范围
  • THEN 同单位证需求为30吨,不折纯、不复制额度、不为未选产品扣减。

Requirement: 自动跨证分配与原子预占

系统 SHALL 在安排提交时校验全部匹配条件并逐证原子预占,预览不占用;两类证均支持跨证。

Scenario: 单证不足

  • WHEN 本次30吨且匹配的第一张证仅余20吨、第二张可覆盖10吨
  • THEN 依次预占20和10;购买证及运输证均遵守此规则。

Scenario: 并发或任一证不足

  • WHEN 并发计划竞争同一份余额或一张证校验失败
  • THEN 不超占,失败请求不产生部分预占或运输安排,重复请求不重复扣减。

Scenario: 关联条件约束

  • WHEN 可选证余额总和足够但产品范围或运输引用关系无法覆盖全部需求
  • THEN 返回具体不匹配原因,不以总余额直接放行;存在可行重新分配时采用可行组合。

Requirement: 运输证多车共享

系统 SHALL 允许证面列出的多辆车共享同证总量。

Scenario: 三辆车共同使用

  • WHEN 总量100吨,A已用20、B预占30、C预占10
  • THEN 全证余40,所有车共用40;未列车辆不能使用,不能按车复制额度。

Requirement: 实际量按原顺序核销

系统 SHALL 保存原分配顺序,同单位按来源产品实际数量逐证结转并释放未用量。

Scenario: 三十预占二十九实运

  • WHEN 第一证预占20、第二证预占10,实际29
  • THEN 第一证已用增加20,第二证增加9,分别清除本次预占20和10,第二证释放未用1;两类证均适用。

Scenario: 异单位或超预占

  • WHEN 单位不同或实际量超过预占
  • THEN 异单位重新人工确认,超额部分重新校验补分配;不足保留真实差异并进入异常处理,不篡改实运量。

Requirement: 退出证书齐备开关

系统 SHALL 移除人工齐备及附件完整放行逻辑,额度与条件校验作为本次两证控制的唯一依据。

Scenario: 旧标记不可旁路

  • WHEN 旧hazard_cert_ready为1或两张图片均已上传但可用额度不足
  • THEN 安排失败并返回逐证缺口;新客户端没有齐备按钮,旧写接口不改变任何状态。

Scenario: 动态结果与自身占用

  • WHEN 已安排计划查询用证情况
  • THEN 展示已持有占用,不能把其自身占用误判为额度缺口;归档按实际用量核销。

Requirement: 历史、权限与身份保持

系统 SHALL 保持租户/数据权限、幂等及子数据身份,迁移时核实期初与在途记录。

Scenario: 历史齐备无量

  • WHEN 历史记录只有附件和齐备标记
  • THEN 不自动创建全额余额或虚构已用量,需补齐档案和有依据的期初。

Scenario: 子集合遗漏

  • WHEN 补图请求没有提交合同产品或引用证号集合
  • THEN 原集合和ID保持不变;显式清空仍先执行引用保护。

Requirement: 合法使用证明独立后补且不阻断运输

系统 SHALL 为易制爆产品提供独立合法使用证明资料界面,允许后续上传;证明缺失 SHALL NOT 阻断运输安排或影响购买证、运输证额度。

Scenario: 纯易制爆缺少证明

  • WHEN 计划仅含无需购买证/运输证控制的易制爆产品且合法使用证明尚未上传
  • THEN 其他正常运输条件满足即可安排,不要求点齐备或虚构两证额度,独立资料页面显示待上传。

Scenario: 混合计划额度控制

  • WHEN 混合计划合法使用证明未上传
  • THEN 需证产品的购买证/运输证额度不足仍拒绝安排;额度与匹配条件满足则不因合法使用证明缺失拒绝。

Scenario: 安排后补资料

  • WHEN 用户在安排或归档后通过独立页面补传合法使用证明
  • THEN 按租户和数据权限更新对应原计划产品附件,保留原明细ID和用量/结算数据,不重新安排、核销或标记齐备。

Scenario: 资料待办与额度待办分离

  • WHEN 计划已成功预占但合法使用证明仍待上传
  • THEN 可在待补资料列表跟进,不能将其作为运输额度不足或不可安排计划。