feat(firstleg): support customer price books

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

@@ -533,7 +533,7 @@ CREATE TABLE IF NOT EXISTS fl_price_warehouse_mapping (
 
 CREATE TABLE IF NOT EXISTS fl_price_book_version (
   id BIGINT UNSIGNED NOT NULL COMMENT '整表价格版本ID',
-  tenant_id BIGINT UNSIGNED NOT NULL DEFAULT 0 COMMENT '平台公共价格作用域固定为0',
+  tenant_id BIGINT UNSIGNED NOT NULL DEFAULT 0 COMMENT '报价作用域：0平台公共，正数为客户专属',
   version_no INT UNSIGNED NOT NULL COMMENT '整表版本号',
   original_file_name VARCHAR(255) NOT NULL COMMENT '原始Excel文件名',
   source_file_id BIGINT UNSIGNED NULL COMMENT 'File服务原始文件ID',

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

@@ -72,6 +72,7 @@ paths:
       summary: 查询船期价格表版本
       description: 需要 firstleg:fba-pricing:rate:view 权限；返回待确认上传、当前生效和历史替换版本。
       parameters:
+        - {name: customerId, in: query, schema: {type: string, pattern: '^(0|[1-9][0-9]*)$', default: '0'}, description: 0 表示公共报价；正数表示客户专属报价}
         - {name: status, in: query, schema: {$ref: '#/components/schemas/PriceBookStatus'}}
       responses:
         '200':
@@ -84,7 +85,9 @@ paths:
         '403': {description: 无权限}
     post:
       summary: 上传船期价格表并生成待确认记录
-      description: 仅上传和解析，生成待确认上传记录，不改变当前生效版本；需要 firstleg:fba-pricing:rate:edit 权限。
+      description: 仅上传和解析，生成待确认上传记录，不改变当前生效版本；customerId=0 为公共报价，customerId>0 为该客户的专属报价；需要 firstleg:fba-pricing:rate:edit 权限。
+      parameters:
+        - {name: customerId, in: query, schema: {type: string, pattern: '^(0|[1-9][0-9]*)$', default: '0'}}
       requestBody:
         required: true
         content:
@@ -105,7 +108,7 @@ paths:
   /api/platform/v1/fba-pricing/carrier-rates/price-books/{versionId}/publish:
     post:
       summary: 确认并立即生效船期价格表版本
-      description: 只确认上传表中的仓库映射，不允许在线改价；阻断错误必须为零。发布事务将上一 ACTIVE 版本标记为 SUPERSEDED，始终只保留一份 ACTIVE。
+      description: 只确认上传表中的仓库映射，不允许在线改价；阻断错误必须为零。发布事务只替换同 customerId 作用域的上一 ACTIVE 版本。计价时优先使用客户专属 ACTIVE 版本，不存在时回退公共 ACTIVE 版本。
       parameters: [{$ref: '#/components/parameters/VersionId'}]
       requestBody: {required: true, content: {application/json: {schema: {$ref: '#/components/schemas/PriceBookConfirmationRequest'}}}}
       responses: {'200': {description: 成功或业务失败}, '403': {description: 无权限}}
@@ -545,6 +548,7 @@ components:
       type: object
       properties:
         id: {type: string, pattern: '^[1-9][0-9]*$'}
+        customerId: {type: string, pattern: '^(0|[1-9][0-9]*)$', description: 0 为公共报价，正数为客户专属报价}
         versionNo: {type: integer}
         originalFileName: {type: string, maxLength: 255}
         sourceFileId: {type: string, pattern: '^[1-9][0-9]*$', nullable: true}