feat(warehouse): provide bounded internal historical metadata batch

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

@@ -3,6 +3,49 @@ info:
   title: Warehouse catalog and receiving options
   version: 1.0.0
 paths:
+  /internal/warehouses/platform-metadata/batch:
+    post:
+      summary: 内部批量读取公共仓库历史展示资料
+      description: 只读；必须验证X-Internal-Service-Token，不经公网Gateway。固定tenant_id=0，包含ACTIVE和INACTIVE，已删除、非公共和不存在的ID统一返回missingIds。不返回联系人、电话、地址或客户资料。原timezone保留原值/空值，不猜测或修复；消费者必须自行核对地点时区和国家。每批最多2000个不重复正数ID，一次SQL查询。
+      parameters:
+        - {name: X-Internal-Service-Token, in: header, required: true, schema: {type: string}}
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              required: [warehouseIds]
+              properties:
+                warehouseIds: {type: array, minItems: 1, maxItems: 2000, uniqueItems: true, items: {type: string, pattern: '^[1-9][0-9]*$'}}
+      responses:
+        '200':
+          description: 成功业务响应code为200，按请求顺序返回可读记录及缺失ID
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  code: {type: string}
+                  data:
+                    type: object
+                    required: [records, missingIds]
+                    properties:
+                      missingIds: {type: array, items: {type: string}}
+                      records:
+                        type: array
+                        items:
+                          type: object
+                          properties:
+                            id: {type: string}
+                            warehouseCode: {type: string}
+                            warehouseName: {type: string}
+                            warehouseType: {type: string}
+                            countryCode: {type: string, nullable: true}
+                            timezone: {type: string, nullable: true}
+                            status: {type: string}
+        '403': {description: 内部服务凭据错误或缺失}
+        '422': {description: ID为空、非正数、重复或超过2000个}
   /api/platform/v1/warehouse-admin/overseas-receiving-options:
     get:
       summary: 分页查询启用的公共海外收货仓