fix(file): make ocean booking documents platform owned

This commit is contained in:
2026-09-09 11:16:28 +08:00
parent 3627239708
commit 156520b560
6 changed files with 50 additions and 31 deletions
@@ -3,9 +3,9 @@ info:
title: Ocean Booking Document Internal API
version: 1.0.0
description: >-
订舱文件归属订舱聚合,不归属拖车。固定ownerScope=CUSTOMER、tenantId=订舱customerId、
订舱文件归属订舱聚合,不归属拖车。固定ownerScope=PLATFORM、tenantId=0、
businessType=OCEAN_BOOKING_DOCUMENT、businessId=oceanBookingId。BOOKING_CONFIRMATION与
BILL_OF_LADING文档类型、版本和有效状态归Firstleg;File不判断订舱业务状态。
BILL_OF_LADING文档类型、版本和有效状态归Firstleg;File不判断订舱业务状态。客户为可选快照,有值、为空或清空均不改变文件归属,客户作用域上传读取一律拒绝。
x-firstleg-document-types: [BOOKING_CONFIRMATION, BILL_OF_LADING]
x-lifecycle-owner: FIRSTLEG
x-file-object-semantics: IMMUTABLE_CREATE_ONLY
@@ -70,8 +70,8 @@ components:
name: tenantId
in: path
required: true
description: 订舱customerId
schema: {$ref: '#/components/schemas/Id'}
description: 平台固定0,与订舱客户快照无关
schema: {type: string, enum: ['0']}
OceanBookingId:
name: oceanBookingId
in: path
@@ -100,10 +100,11 @@ components:
required: [fileId, ownerScope, tenantId, businessType, businessId, fileName, sha256, contentType, sizeBytes]
properties:
fileId: {$ref: '#/components/schemas/Id'}
ownerScope: {type: string, enum: [CUSTOMER]}
ownerScope: {type: string, enum: [PLATFORM]}
tenantId:
allOf: [{$ref: '#/components/schemas/Id'}]
description: 订舱customerId
type: string
enum: ['0']
description: 平台固定0,与订舱客户快照无关
businessType: {type: string, enum: [OCEAN_BOOKING_DOCUMENT]}
businessId:
allOf: [{$ref: '#/components/schemas/Id'}]