为 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>
192 lines
7.7 KiB
Python
192 lines
7.7 KiB
Python
from datetime import datetime
|
|
from typing import Annotated
|
|
|
|
from fastapi import Path, Query, Request, Response
|
|
from sqlalchemy.ext.asyncio import AsyncSession
|
|
|
|
from common.annotation.log_annotation import Log
|
|
from common.aspect.db_seesion import DBSessionDependency
|
|
from common.aspect.interface_auth import UserInterfaceAuthDependency
|
|
from common.aspect.pre_auth import CurrentUserDependency, PreAuthDependency
|
|
from common.enums import BusinessType
|
|
from common.router import APIRouterPro
|
|
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 WarehouseListItemModel
|
|
from module_business.entity.vo.master_vo import (
|
|
BusinessUserOptionModel,
|
|
DeleteWarehouseModel,
|
|
UserAssignModel,
|
|
WarehouseModel,
|
|
WarehousePageQueryModel,
|
|
)
|
|
from module_business.service.master_service import MasterService
|
|
from module_business.service.master_summary_service import MasterSummaryService
|
|
from module_business.service.pallet_service import PalletService
|
|
from utils.response_util import ResponseUtil
|
|
|
|
ASSIGN_LOG = Log
|
|
ASSIGN_CURRENT_USER = CurrentUserDependency
|
|
|
|
warehouse_controller = APIRouterPro(
|
|
prefix='/master/warehouse', tags=['基础资料-仓库管理'], dependencies=[PreAuthDependency()]
|
|
)
|
|
warehouse_user_controller = APIRouterPro(
|
|
prefix='/master/warehouse', tags=['基础资料-仓库用户分配'], dependencies=[PreAuthDependency()]
|
|
)
|
|
|
|
|
|
@warehouse_user_controller.get(
|
|
'/{warehouse_id}/users',
|
|
summary='获取仓库可分配用户接口',
|
|
description='获取启用且未删除的用户及仓库分配状态',
|
|
response_model=DataResponseModel[list[BusinessUserOptionModel]],
|
|
dependencies=[UserInterfaceAuthDependency('master:warehouse:assign')],
|
|
)
|
|
async def get_master_warehouse_users(
|
|
request: Request,
|
|
warehouse_id: Annotated[int, Path(gt=0, description='仓库ID')],
|
|
query_db: Annotated[AsyncSession, DBSessionDependency()],
|
|
scope: Annotated[TestBatchScope, TestBatchScopeDependency()],
|
|
) -> Response:
|
|
users = await PalletService.list_warehouse_users(query_db, warehouse_id, scope)
|
|
return ResponseUtil.success(data=users)
|
|
|
|
|
|
@warehouse_user_controller.put(
|
|
'/{warehouse_id}/users',
|
|
summary='分配仓库用户接口',
|
|
description='完整替换仓库的用户关联',
|
|
response_model=ResponseBaseModel,
|
|
dependencies=[UserInterfaceAuthDependency('master:warehouse:assign')],
|
|
)
|
|
@ASSIGN_LOG(title='仓库用户分配', business_type=BusinessType.GRANT)
|
|
async def assign_master_warehouse_users(
|
|
request: Request,
|
|
warehouse_id: Annotated[int, Path(gt=0, description='仓库ID')],
|
|
assignment: UserAssignModel,
|
|
query_db: Annotated[AsyncSession, DBSessionDependency()],
|
|
current_user: Annotated[CurrentUserModel, ASSIGN_CURRENT_USER()],
|
|
scope: Annotated[TestBatchScope, TestBatchScopeDependency(write=True)],
|
|
) -> Response:
|
|
result = await PalletService.assign_warehouse_users(query_db, warehouse_id, assignment, current_user, scope)
|
|
return ResponseUtil.success(msg=result.message)
|
|
|
|
|
|
@warehouse_controller.get(
|
|
'/list',
|
|
summary='获取仓库分页列表接口',
|
|
description='用于获取仓库分页列表',
|
|
response_model=PageResponseModel[WarehouseListItemModel],
|
|
dependencies=[UserInterfaceAuthDependency('master:warehouse:list')],
|
|
)
|
|
async def get_master_warehouse_list(
|
|
request: Request,
|
|
warehouse_page_query: Annotated[WarehousePageQueryModel, Query()],
|
|
query_db: Annotated[AsyncSession, DBSessionDependency()],
|
|
scope: Annotated[TestBatchScope, TestBatchScopeDependency()],
|
|
) -> Response:
|
|
warehouse_page_query_result = await MasterService.list_warehouse(
|
|
query_db,
|
|
warehouse_page_query,
|
|
scope,
|
|
is_page=True,
|
|
)
|
|
warehouse_page_query_result = await MasterSummaryService.enrich_page(
|
|
query_db, 'warehouse', warehouse_page_query_result, scope
|
|
)
|
|
|
|
return ResponseUtil.success(model_content=warehouse_page_query_result)
|
|
|
|
|
|
@warehouse_controller.get(
|
|
'/{warehouse_id}',
|
|
summary='获取仓库详情接口',
|
|
description='用于获取指定仓库的详细信息',
|
|
response_model=DataResponseModel[WarehouseModel],
|
|
dependencies=[UserInterfaceAuthDependency('master:warehouse:query')],
|
|
)
|
|
async def query_detail_master_warehouse(
|
|
request: Request,
|
|
warehouse_id: Annotated[int, Path(gt=0, description='仓库ID')],
|
|
query_db: Annotated[AsyncSession, DBSessionDependency()],
|
|
scope: Annotated[TestBatchScope, TestBatchScopeDependency()],
|
|
) -> Response:
|
|
warehouse_detail_result = await MasterService.detail_warehouse(query_db, warehouse_id, scope)
|
|
|
|
return ResponseUtil.success(data=warehouse_detail_result)
|
|
|
|
|
|
@warehouse_controller.post(
|
|
'',
|
|
summary='新增仓库接口',
|
|
description='用于新增仓库',
|
|
response_model=ResponseBaseModel,
|
|
dependencies=[UserInterfaceAuthDependency('master:warehouse:add')],
|
|
)
|
|
@Log(title='仓库管理', business_type=BusinessType.INSERT)
|
|
async def add_master_warehouse(
|
|
request: Request,
|
|
add_warehouse: WarehouseModel,
|
|
query_db: Annotated[AsyncSession, DBSessionDependency()],
|
|
current_user: Annotated[CurrentUserModel, CurrentUserDependency()],
|
|
scope: Annotated[TestBatchScope, TestBatchScopeDependency(write=True)],
|
|
) -> Response:
|
|
current_time = datetime.now()
|
|
add_warehouse.create_by = current_user.user.user_name
|
|
add_warehouse.create_time = current_time
|
|
add_warehouse.update_by = current_user.user.user_name
|
|
add_warehouse.update_time = current_time
|
|
add_warehouse_result = await MasterService.add_warehouse(query_db, add_warehouse, current_user, scope)
|
|
|
|
return ResponseUtil.success(msg=add_warehouse_result.message)
|
|
|
|
|
|
@warehouse_controller.put(
|
|
'',
|
|
summary='编辑仓库接口',
|
|
description='用于编辑仓库',
|
|
response_model=ResponseBaseModel,
|
|
dependencies=[UserInterfaceAuthDependency('master:warehouse:edit')],
|
|
)
|
|
@Log(title='仓库管理', business_type=BusinessType.UPDATE)
|
|
async def edit_master_warehouse(
|
|
request: Request,
|
|
edit_warehouse: WarehouseModel,
|
|
query_db: Annotated[AsyncSession, DBSessionDependency()],
|
|
current_user: Annotated[CurrentUserModel, CurrentUserDependency()],
|
|
scope: Annotated[TestBatchScope, TestBatchScopeDependency(write=True)],
|
|
) -> Response:
|
|
edit_warehouse.update_by = current_user.user.user_name
|
|
edit_warehouse.update_time = datetime.now()
|
|
edit_warehouse_result = await MasterService.edit_warehouse(query_db, edit_warehouse, current_user, scope)
|
|
|
|
return ResponseUtil.success(msg=edit_warehouse_result.message)
|
|
|
|
|
|
@warehouse_controller.delete(
|
|
'/{warehouse_ids}',
|
|
summary='兼容旧接口,固定拒绝,请使用测试数据批次清理',
|
|
description='兼容旧接口,固定拒绝单条物理删除,请使用测试数据批次清理',
|
|
response_model=ResponseBaseModel,
|
|
dependencies=[UserInterfaceAuthDependency('master:warehouse:list')],
|
|
)
|
|
@Log(title='仓库管理', business_type=BusinessType.DELETE)
|
|
async def delete_master_warehouse(
|
|
request: Request,
|
|
warehouse_ids: Annotated[
|
|
str,
|
|
Path(pattern=r'^[1-9]\d*(,[1-9]\d*)*$', description='需要删除的仓库ID'),
|
|
],
|
|
query_db: Annotated[AsyncSession, DBSessionDependency()],
|
|
current_user: Annotated[CurrentUserModel, CurrentUserDependency()],
|
|
) -> Response:
|
|
delete_warehouse = DeleteWarehouseModel(
|
|
warehouseIds=[int(warehouse_id) for warehouse_id in warehouse_ids.split(',')]
|
|
)
|
|
delete_warehouse_result = await MasterService.remove_warehouse(query_db, delete_warehouse)
|
|
|
|
return ResponseUtil.success(msg=delete_warehouse_result.message)
|