feat(firstleg): expose smart-loading channel directory

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

@@ -382,6 +382,27 @@ paths:
         - {name: bookingId, in: query, required: true, schema: {type: string, pattern: '^[1-9][0-9]*$'}}
         - {name: warehouseId, in: query, required: true, schema: {type: string, pattern: '^[1-9][0-9]*$'}}
       responses: {'200': {description: Candidates filtered by the server to the booking channel}}
+  /api/platform/v1/first-leg/smart-loading/channels:
+    get:
+      summary: 查询当前仓库智能装柜渠道目录及统计
+      description: >-
+        需要 platform:firstleg:smart-loading:list 权限。渠道目录只来自平台当前唯一 ACTIVE 价格版本中
+        对该国内仓存在 ACTIVE 价格行的渠道；候选入仓码数、可用箱数及可编排柜次数由 Firstleg 当前事实聚合。
+        零候选或零可用柜次的有效渠道仍返回，Admin 可展示空态；实际分配仍由服务端重新校验仓库、渠道和资格。
+      parameters:
+        - {name: warehouseId, in: query, required: true, schema: {type: string, pattern: '^[1-9][0-9]*$'}}
+      responses:
+        '200':
+          description: 成功；无 ACTIVE 价格版本时 data 为空数组
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  code: {type: string}
+                  message: {type: string}
+                  data: {type: array, items: {$ref: '#/components/schemas/SmartLoadingChannelSummary'}}
+        '403': {description: 无智能装柜查询权限}
   /api/platform/v1/first-leg/smart-loading/inbound-candidates:
     get:
       summary: 按入仓码查询智能装柜候选
@@ -1700,6 +1721,16 @@ components:
             required: [itemId]
             properties:
               itemId: {type: string, pattern: '^[1-9][0-9]*$'}
+    SmartLoadingChannelSummary:
+      type: object
+      additionalProperties: false
+      required: [channelCode, channelName, candidateInboundCount, availablePackageCount, availableContainerCount]
+      properties:
+        channelCode: {type: string, minLength: 1, maxLength: 64}
+        channelName: {type: string, minLength: 1, maxLength: 128}
+        candidateInboundCount: {type: integer, format: int64, minimum: 0, description: 当前可分配的唯一入仓码数量}
+        availablePackageCount: {type: integer, format: int64, minimum: 0, description: 当前候选规格剩余可分配箱数合计}
+        availableContainerCount: {type: integer, format: int64, minimum: 0, description: 当前 WAIT_LOADING、EDITING 或 LOADING 可编排柜次数量}
     SmartLoadingPlan:
       type: object
       required: [id, planNo, status, bookingId, version, canAssign, canEdit, finalCompletionStatus, items]