Feat: 后端新增基础资料与业务管理只读汇总接口

为 Web 端改版提供名称、统计和看板数据。只新增只读查询、扩展列表与详情
返回字段；写接口、托盘状态机和幂等键规则均未改动，未新增权限标识。

- 基础资料：列表补充名称与汇总，客户详情返回现场树，托盘详情返回最近流转，
  托盘列表支持按流转阶段筛选和二维码精确匹配；新增现场、产线、隧道的上级
  资料选项接口；Excel 导入支持 preview 只校验不写入
- 发货出库：列表支持 keyword、receiptState 筛选并补充名称、托盘数、包数和
  菌种构成；详情明细补充托盘号、菌种、批次
- 首次入库：列表与详情补充名称、托盘数、托盘当前状态；新增 /summary
- 托盘退回：列表支持 keyword 并补充名称与托盘汇总，详情补充托盘号和隧道；
  新增 /summary、/site-options
- 工厂装填：列表支持 keyword 并补充托盘号、仓库、操作人；新增 /summary、
  /batches、/batches/detail
- 客户现场使用：列表支持 keyword、fifoSkipped 并补充名称和被跳过的先到托盘号；
  新增 /site-options、/site-board 以及 usage-fifo 的 /queue
- 先到先用 DAO 抽出公共候选条件与排序，建议查询生成的 SQL 与改动前一致
- 新增各汇总 DAO 的单元测试，同步更新路由权限与模型字段契约测试

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

shierfeng-fastapi-backend/tests/module_business/test_usage_service.py

@@ -30,6 +30,7 @@ from module_business.dao.access_dao import AccessDao
 from module_business.dao.inventory_dao import InventoryDao
 from module_business.dao.master_dao import MasterDao
 from module_business.dao.operation_dao import OperationDao
+from module_business.dao.usage_summary_dao import UsageSummaryDao
 from module_business.domain.enums import PalletEventType, PalletFlowState
 from module_business.domain.test_batch_scope import TestBatchScope
 from module_business.entity.do.master_do import BizCustomerSite, BizPallet, BizProductionLine, BizTunnel
@@ -45,8 +46,11 @@ from module_business.entity.vo.operation_vo import (
     PalletScanResponseModel,
     TunnelEntrySuccessResponseModel,
     UsageCreateModel,
+    UsageListItemModel,
     UsageModel,
     UsagePageQueryModel,
+    UsageSiteBoardModel,
+    UsageSiteOptionModel,
     UsageSuccessResponseModel,
 )
 from module_business.service.access_service import AccessService
@@ -381,6 +385,7 @@ class TestUsageReadServices(unittest.IsolatedAsyncioTestCase):
         with (
             patch.object(AccessDao, 'list_user_site_ids', new=AsyncMock(return_value=[11, 9, 9])),
             patch.object(OperationDao, 'get_usage_list', new=get_list),
+            patch.object(UsageSummaryDao, 'get_list_summaries', new=AsyncMock(return_value={})),
         ):
             result = await UsageService.get_usage_list_services(self.db, query, self.user, TestBatchScope.formal())
 
@@ -648,6 +653,8 @@ class TestUsageControllerContract(unittest.TestCase):
             ('/business/usage/list', 'get'),
             ('/business/usage/line-options', 'get'),
             ('/business/usage/tunnel-options', 'get'),
+            ('/business/usage/site-options', 'get'),
+            ('/business/usage/site-board', 'get'),
             ('/business/usage/enter-tunnel', 'post'),
             ('/business/usage/scan/{qr_token}', 'get'),
             ('/business/usage/{usage_id}', 'get'),
@@ -674,7 +681,15 @@ class TestUsageControllerContract(unittest.TestCase):
         )
 
         routes = self._routes()
-        self.assertEqual(PageResponseModel[UsageModel], routes[('/business/usage/list', 'GET')].response_model)
+        self.assertEqual(PageResponseModel[UsageListItemModel], routes[('/business/usage/list', 'GET')].response_model)
+        self.assertEqual(
+            DataResponseModel[list[UsageSiteOptionModel]],
+            routes[('/business/usage/site-options', 'GET')].response_model,
+        )
+        self.assertEqual(
+            DataResponseModel[UsageSiteBoardModel],
+            routes[('/business/usage/site-board', 'GET')].response_model,
+        )
         self.assertEqual(
             DataResponseModel[list[BusinessOptionModel]],
             routes[('/business/usage/line-options', 'GET')].response_model,
@@ -717,6 +732,8 @@ class TestUsageControllerContract(unittest.TestCase):
         detail_index = paths.index('/business/usage/{usage_id}')
         self.assertLess(paths.index('/business/usage/line-options'), detail_index)
         self.assertLess(paths.index('/business/usage/tunnel-options'), detail_index)
+        self.assertLess(paths.index('/business/usage/site-options'), detail_index)
+        self.assertLess(paths.index('/business/usage/site-board'), detail_index)
         self.assertLess(paths.index('/business/usage/enter-tunnel'), detail_index)
         self.assertLess(paths.index('/business/usage/scan/{qr_token}'), detail_index)
 
@@ -725,6 +742,8 @@ class TestUsageControllerContract(unittest.TestCase):
             ('/business/usage/list', 'GET'): 'business:usage:list',
             ('/business/usage/line-options', 'GET'): 'business:usage:query',
             ('/business/usage/tunnel-options', 'GET'): 'business:usage:query',
+            ('/business/usage/site-options', 'GET'): 'business:usage:list',
+            ('/business/usage/site-board', 'GET'): 'business:usage:query',
             ('/business/usage/enter-tunnel', 'POST'): 'business:usage:add',
             ('/business/usage/scan/{qr_token}', 'GET'): 'business:usage:query',
             ('/business/usage/{usage_id}', 'GET'): 'business:usage:query',