fix(dispatch): invalidate resource evidence and bind uploads to review rounds
This commit is contained in:
@@ -2,7 +2,7 @@ openapi: 3.0.3
|
||||
info:
|
||||
title: 排车装车资料(Admin/PDA共用)
|
||||
version: 1.0.0
|
||||
description: 理货审核通过时,将本趟已核验驾驶证和车辆照片复制到空的司机驾驶证、车牌照片类别(每类最多5份),来源未变的已有照片保持不变;保存车辆、司机或证照来源变更时,对应类别旧资料与资源保存同事务失效并保留历史,重审通过后带入新资料;PDF驾驶证保留原件并计为一份。GET只读,不对存量记录补写。LOADING阶段即可同步上传并保存五个整车照片框;照片齐全不会提前发车。装车确认时资料已齐则直接进入DELIVERING,否则进入AFTER_LOADING,最后一次绑定自动生成派送并进入DELIVERING。触发推进的装车确认或照片绑定与派送同事务,失败保留先前已保存资料。复用车队照片记录,技术槽位沿用原文件归属,按顺序对应司机驾驶证、车牌照片、装车完成、封车照片、BOL司机签字;每类1至5张,允许追加或指定replaceFileId精确替换,不代表驾驶证审核或真实签收。PDA每次核验Token冻结仓,平台list只读、edit写;原键仅原操作者恢复。
|
||||
description: 理货审核通过时,将本趟已核验驾驶证和车辆照片复制到空的司机驾驶证、车牌照片类别(每类最多5份),来源未变的已有照片保持不变;保存车辆、司机或证照来源变更时,对应类别旧资料与资源保存同事务失效并保留历史;换车另失效装车完成及封车照片,换司机另失效BOL签字,重审通过后只带入驾驶证与车牌资料;PDF驾驶证保留原件并计为一份。GET只读,不对存量记录补写。LOADING阶段即可同步上传并保存五个整车照片框;照片齐全不会提前发车。装车确认时资料已齐则直接进入DELIVERING,否则进入AFTER_LOADING,最后一次绑定自动生成派送并进入DELIVERING。触发推进的装车确认或照片绑定与派送同事务,失败保留先前已保存资料。复用车队照片记录,技术槽位沿用原文件归属,按顺序对应司机驾驶证、车牌照片、装车完成、封车照片、BOL司机签字;每类1至5张,允许追加或指定replaceFileId精确替换,不代表驾驶证审核或真实签收。PDA每次核验Token冻结仓,平台list只读、edit写;原键仅原操作者恢复。上传须携当前reviewRound并将轮次写入上传账本;绑定须携uploadKey核对原上传文件、分类、操作者及当前审核轮次,不允许用最新资料版本重绑旧轮次上传。
|
||||
security:
|
||||
- bearerAuth: []
|
||||
paths:
|
||||
@@ -80,11 +80,16 @@ paths:
|
||||
required:
|
||||
- file
|
||||
- idempotencyKey
|
||||
- reviewRound
|
||||
properties:
|
||||
file:
|
||||
type: string
|
||||
format: binary
|
||||
description: 非空JPG/PNG,司机驾驶证(LOADING_SCENE)也支持PDF,最大10MiB
|
||||
reviewRound:
|
||||
type: string
|
||||
pattern: "^[1-9][0-9]*$"
|
||||
description: 选择照片时看到的审核轮次;不得在上传后改用新轮次。
|
||||
idempotencyKey:
|
||||
type: string
|
||||
minLength: 8
|
||||
@@ -120,11 +125,16 @@ paths:
|
||||
required:
|
||||
- file
|
||||
- idempotencyKey
|
||||
- reviewRound
|
||||
properties:
|
||||
file:
|
||||
type: string
|
||||
format: binary
|
||||
description: 非空JPG/PNG,司机驾驶证(LOADING_SCENE)也支持PDF,最大10MiB
|
||||
reviewRound:
|
||||
type: string
|
||||
pattern: "^[1-9][0-9]*$"
|
||||
description: 选择照片时看到的审核轮次;不得在上传后改用新轮次。
|
||||
idempotencyKey:
|
||||
type: string
|
||||
minLength: 8
|
||||
@@ -359,6 +369,7 @@ components:
|
||||
- editable
|
||||
- photos
|
||||
- dispatchRecordVersion
|
||||
- reviewRound
|
||||
- stage
|
||||
- complete
|
||||
properties:
|
||||
@@ -374,6 +385,9 @@ components:
|
||||
$ref: '#/components/schemas/Photo'
|
||||
dispatchRecordVersion:
|
||||
type: string
|
||||
reviewRound:
|
||||
type: string
|
||||
pattern: "^[1-9][0-9]*$"
|
||||
stage:
|
||||
type: string
|
||||
enum:
|
||||
@@ -389,11 +403,17 @@ components:
|
||||
required:
|
||||
- recordVersion
|
||||
- idempotencyKey
|
||||
- uploadKey
|
||||
- fileId
|
||||
properties:
|
||||
recordVersion:
|
||||
type: string
|
||||
pattern: ^(0|[1-9][0-9]*)$
|
||||
uploadKey:
|
||||
type: string
|
||||
minLength: 8
|
||||
maxLength: 128
|
||||
description: 本文件原上传请求的幂等键;与当前审核轮次及操作者一致。
|
||||
idempotencyKey:
|
||||
type: string
|
||||
minLength: 8
|
||||
|
||||
Reference in New Issue
Block a user