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/module_business/controller/customer_controller.py

@@ -14,8 +14,10 @@ from common.vo import DataResponseModel, PageResponseModel, ResponseBaseModel
 from module_admin.entity.vo.user_vo import CurrentUserModel
 from module_business.dependency.test_batch_dependency import TestBatchScopeDependency
 from module_business.domain.test_batch_scope import TestBatchScope
+from module_business.entity.vo.master_summary_vo import CustomerDetailModel, CustomerListItemModel
 from module_business.entity.vo.master_vo import CustomerModel, CustomerPageQueryModel, DeleteCustomerModel
 from module_business.service.master_service import MasterService
+from module_business.service.master_summary_service import MasterSummaryService
 from utils.response_util import ResponseUtil
 
 customer_controller = APIRouterPro(
@@ -27,7 +29,7 @@ customer_controller = APIRouterPro(
     '/list',
     summary='获取客户分页列表接口',
     description='用于获取客户分页列表',
-    response_model=PageResponseModel[CustomerModel],
+    response_model=PageResponseModel[CustomerListItemModel],
     dependencies=[UserInterfaceAuthDependency('master:customer:list')],
 )
 async def get_master_customer_list(
@@ -37,6 +39,9 @@ async def get_master_customer_list(
     scope: Annotated[TestBatchScope, TestBatchScopeDependency()],
 ) -> Response:
     customer_page_query_result = await MasterService.list_customer(query_db, customer_page_query, scope, is_page=True)
+    customer_page_query_result = await MasterSummaryService.enrich_page(
+        query_db, 'customer', customer_page_query_result, scope
+    )
 
     return ResponseUtil.success(model_content=customer_page_query_result)
 
@@ -45,7 +50,7 @@ async def get_master_customer_list(
     '/{customer_id}',
     summary='获取客户详情接口',
     description='用于获取指定客户的详细信息',
-    response_model=DataResponseModel[CustomerModel],
+    response_model=DataResponseModel[CustomerDetailModel],
     dependencies=[UserInterfaceAuthDependency('master:customer:query')],
 )
 async def query_detail_master_customer(
@@ -55,6 +60,7 @@ async def query_detail_master_customer(
     scope: Annotated[TestBatchScope, TestBatchScopeDependency()],
 ) -> Response:
     customer_detail_result = await MasterService.detail_customer(query_db, customer_id, scope)
+    customer_detail_result = await MasterSummaryService.customer_detail(query_db, customer_detail_result, scope)
 
     return ResponseUtil.success(data=customer_detail_result)