优化

firstleg/src/main/resources/db/phase2-inbound-schema.sql

@@ -558,7 +558,7 @@ CREATE TABLE IF NOT EXISTS fl_price_book_version (
   original_file_name VARCHAR(255) NOT NULL COMMENT '原始Excel文件名',
   source_file_id BIGINT UNSIGNED NULL COMMENT 'File服务原始文件ID',
   source_sha256 CHAR(64) NULL COMMENT '原始文件SHA-256',
-  status VARCHAR(24) NOT NULL DEFAULT 'PENDING_CONFIRMATION' COMMENT '价格版本状态：PENDING_CONFIRMATION待确认、ACTIVE已生效、SUPERSEDED已被替代、FAILED解析失败',
+  status VARCHAR(24) NOT NULL DEFAULT 'PENDING_CONFIRMATION' COMMENT '价格版本状态：PENDING_CONFIRMATION待确认、ACTIVE已生效、SUPERSEDED已被替代、VOIDED已作废、FAILED解析失败',
   blocking_error_count INT UNSIGNED NOT NULL DEFAULT 0 COMMENT '阻断错误数',
   warning_count INT UNSIGNED NOT NULL DEFAULT 0 COMMENT '警告数',
   parse_issues_json JSON NULL COMMENT '上传解析问题及待确认重新校验结果',
@@ -569,6 +569,9 @@ CREATE TABLE IF NOT EXISTS fl_price_book_version (
   published_by BIGINT UNSIGNED NULL COMMENT '确认并发布价格版本的操作人ID',
   published_at DATETIME(3) NULL COMMENT '确认并生效时间',
   superseded_at DATETIME(3) NULL COMMENT '被下一版本替换时间',
+  voided_by BIGINT UNSIGNED NULL COMMENT '作废操作人ID',
+  voided_at DATETIME(3) NULL COMMENT '作废时间',
+  void_reason VARCHAR(500) NULL COMMENT '作废原因',
   updated_by BIGINT UNSIGNED NOT NULL COMMENT '最后修改人ID',
   updated_at DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3) ON UPDATE CURRENT_TIMESTAMP(3) COMMENT '最后更新时间',
   deleted TINYINT(1) NOT NULL DEFAULT 0 COMMENT '逻辑删除标记：0未删除、1已删除',

firstleg/src/main/resources/openapi/fba-pricing-v1.yaml

@@ -112,6 +112,13 @@ paths:
       parameters: [{$ref: '#/components/parameters/VersionId'}]
       requestBody: {required: true, content: {application/json: {schema: {$ref: '#/components/schemas/PriceBookConfirmationRequest'}}}}
       responses: {'200': {description: 成功或业务失败}, '403': {description: 无权限}}
+  /api/platform/v1/fba-pricing/carrier-rates/price-books/{versionId}/void:
+    post:
+      summary: 作废待确认船期价格表版本
+      description: 仅允许作废 PENDING_CONFIRMATION 版本；保留版本、原始文件和审计记录，作废后不可再确认生效。需要 firstleg:fba-pricing:rate:edit 权限。
+      parameters: [{$ref: '#/components/parameters/VersionId'}]
+      requestBody: {required: true, content: {application/json: {schema: {$ref: '#/components/schemas/PriceBookVoidRequest'}}}}
+      responses: {'200': {description: 成功或业务失败}, '403': {description: 无权限}}
   /api/platform/v1/fba-pricing/carrier-rates/price-books/{versionId}/source:
     get:
       summary: 下载船期价格表原始文件
@@ -528,7 +535,7 @@ components:
         effectiveTo: {type: string, format: date-time, nullable: true}
     PriceBookStatus:
       type: string
-      enum: [PENDING_CONFIRMATION, ACTIVE, SUPERSEDED, FAILED]
+      enum: [PENDING_CONFIRMATION, ACTIVE, SUPERSEDED, VOIDED, FAILED]
     PriceModel:
       type: string
       enum: [FBA_WAREHOUSE_RATE, REGION_WEIGHT_TIER]
@@ -564,6 +571,9 @@ components:
         publishedBy: {type: string, pattern: '^[1-9][0-9]*$', nullable: true}
         publishedAt: {type: string, format: date-time, nullable: true}
         supersededAt: {type: string, format: date-time, nullable: true}
+        voidedBy: {type: string, pattern: '^[1-9][0-9]*$', nullable: true}
+        voidedAt: {type: string, format: date-time, nullable: true}
+        voidReason: {type: string, maxLength: 500, nullable: true}
     PriceBookVersionDetail:
       type: object
       required: [version, channels, rates, issues]
@@ -600,6 +610,11 @@ components:
           type: array
           maxItems: 2
           items: {$ref: '#/components/schemas/PriceBookOverseasMapping'}
+    PriceBookVoidRequest:
+      type: object
+      required: [reason]
+      properties:
+        reason: {type: string, minLength: 1, maxLength: 500, description: 人工作废原因}
     PriceBookOriginMapping:
       type: object
       required: [originWarehouseCode, warehouseId]