优化

warehouse/src/main/resources/openapi/supplier-frontend-handoff.md

@@ -45,7 +45,6 @@
 | `page` | integer | 否 | 默认 `1`，最小 `1` |
 | `size` | integer | 否 | 默认 `20`，范围 `1..200` |
 | `category` | enum | 否 | 供应商分类 |
-| `scope` | enum | 否 | 仅订舱分类适用 |
 | `region` | string | 否 | 地区精确匹配，最长 80 |
 | `status` | enum | 否 | 合作状态 |
 | `keyword` | string | 否 | 按供应商名称或联系人模糊匹配 |
@@ -72,7 +71,6 @@
 | `tenantId` | string | 固定为 `0` |
 | `name` | string | 供应商名称，平台内唯一 |
 | `category` | enum | 分类 |
-| `scope` | enum/null | 订舱供应商必填；其他分类为 `null` |
 | `region` | string | 地区 |
 | `legalRepresentative` | string | 法人代表 |
 | `contactName` | string | 联系人 |
@@ -101,7 +99,6 @@
 {
   "name": "示例供应商有限公司",
   "category": "BOOKING",
-  "scope": "DOMESTIC",
   "region": "宁波",
   "legalRepresentative": "张三",
   "contactName": "李经理",
@@ -116,7 +113,7 @@
 }
 ```
 
-必填字段：`name`、`category`、`region`、`legalRepresentative`、`contactName`、`phone`、`status`、`settlementPeriod`。`BOOKING` 时 `scope` 必填；其他分类 `scope` 必须传 `null` 或省略。
+必填字段：`name`、`category`、`region`、`legalRepresentative`、`contactName`、`phone`、`status`、`settlementPeriod`。订舱供应商不区分国内或国外。
 
 新增成功的 `data` 是供应商 ID 字符串。编辑成功的 `data` 为 `null`。
 
@@ -152,13 +149,6 @@
 | `TRUCKING` | 拖车 |
 | `CERTIFICATE` | 证书 |
 
-订舱范围：
-
-| 值 | 展示文案 |
-|---|---|
-| `DOMESTIC` | 国内 |
-| `INTERNATIONAL` | 国外 |
-
 合作状态：
 
 | 值 | 展示文案 |
@@ -187,7 +177,7 @@
 | `A0403` | 非平台用户或缺少对应权限 | 显示无权限 |
 | `A0404` | 供应商不存在 | 提示记录不存在并刷新列表 |
 | `A0409` | 供应商名称重复或并发唯一键冲突 | 保留表单并提示名称已存在 |
-| `A0422` | 字段校验失败、订舱范围规则不满足 | 使用 `message`/`data` 显示字段错误 |
+| `A0422` | 字段校验失败 | 使用 `message`/`data` 显示字段错误 |
 | `S0500` | 未预期服务异常 | 展示通用错误并记录 `requestId/traceId` |
 | `S0503` | Warehouse 数据库不可用 | 展示稍后重试并记录 `requestId/traceId` |
 

warehouse/src/main/resources/openapi/supplier-v1.yaml

@@ -11,7 +11,6 @@ paths:
         - { name: page, in: query, schema: { type: integer, minimum: 1, default: 1 } }
         - { name: size, in: query, schema: { type: integer, minimum: 1, maximum: 200, default: 20 } }
         - { name: category, in: query, schema: { $ref: '#/components/schemas/Category' } }
-        - { name: scope, in: query, description: 仅订舱供应商适用, schema: { $ref: '#/components/schemas/Scope' } }
         - { name: region, in: query, schema: { type: string } }
         - { name: status, in: query, schema: { $ref: '#/components/schemas/Status' } }
         - { name: keyword, in: query, description: 供应商名称或联系人, schema: { type: string } }
@@ -57,13 +56,12 @@ paths:
   /internal/warehouse/v1/suppliers/{supplierId}:
     get:
       summary: 内部服务查询并校验供应商快照
-      description: 仅服务间调用，需 X-Internal-Service-Token；不经 Gateway。可要求 ACTIVE，并校验类别与订舱范围。
+      description: 仅服务间调用，需 X-Internal-Service-Token；不经 Gateway。可要求 ACTIVE，并校验供应商类别。
       security: [{ internalServiceToken: [] }]
       parameters:
         - { name: supplierId, in: path, required: true, schema: { type: integer, format: int64, minimum: 1 } }
         - { name: requireActive, in: query, schema: { type: boolean, default: false } }
         - { name: category, in: query, schema: { $ref: '#/components/schemas/Category' } }
-        - { name: scope, in: query, schema: { $ref: '#/components/schemas/Scope' } }
       responses:
         '200': { description: 成功, content: { application/json: { schema: { $ref: '#/components/schemas/InternalSnapshotResponse' } } } }
         '403': { $ref: '#/components/responses/Forbidden' }
@@ -74,7 +72,6 @@ components:
     RequiredTenantId: { name: tenantId, in: query, required: true, schema: { type: integer, format: int64, enum: [0] } }
   schemas:
     Category: { type: string, enum: [BOOKING, CUSTOMS, TRUCKING, CERTIFICATE] }
-    Scope: { type: string, enum: [DOMESTIC, INTERNATIONAL] }
     Status: { type: string, enum: [ACTIVE, INACTIVE] }
     SupplierSave:
       type: object
@@ -82,7 +79,6 @@ components:
       properties:
         name: { type: string, maxLength: 160 }
         category: { $ref: '#/components/schemas/Category' }
-        scope: { $ref: '#/components/schemas/Scope', description: BOOKING 必填，其他分类必须为空 }
         region: { type: string, maxLength: 80 }
         legalRepresentative: { type: string, maxLength: 80 }
         contactName: { type: string, maxLength: 80 }
@@ -140,7 +136,6 @@ components:
         supplierId: { type: integer, format: int64 }
         name: { type: string }
         category: { $ref: '#/components/schemas/Category' }
-        scope: { $ref: '#/components/schemas/Scope' }
         status: { $ref: '#/components/schemas/Status' }
     InternalSnapshotResponse:
       allOf: [{ $ref: '#/components/schemas/ApiResponse' }, { type: object, properties: { data: { $ref: '#/components/schemas/InternalSnapshot' } } }]