仓储层的 list_*/count_* 此前以 keyword/status/offset/limit 四五个散参数 传参,调用点重复铺开、易漏传且不可扩展;按项目「参数 >4 封装 DTO」的 约定统一收敛为各模块的 Query 对象(如 RoleQuery、BusinessQuery), 服务层与测试调用同步调整,行为不变。 - repositories 层查询方法签名改为 (session, query),分页与筛选条件 由 Query 承载,_apply_filters 同步收口 - schemas 层补齐各模块 Query 模型(approval/business_role/report 等) - services 层调用点同步改为传 Query - tests 随之调整;新增用例:待办角色流转(财务通过后领导出现待办)、 参数预览顺序稳定 验证:全量 pytest 900 passed(11:08);单元 526 passed;ruff check 绿。 Co-Authored-By: Claude Code <noreply@anthropic.com>
35 lines
1.3 KiB
Python
35 lines
1.3 KiB
Python
"""岗位下拉选项(基础数据与报表筛选共用)。
|
||
|
||
岗位管理本身仅管理员可用(FR-006),但报表的「岗位」筛选对财务/领导
|
||
开放(FR-029)。为避免把管理接口整体放开,这里提供只读、登录即可的
|
||
启用岗位选项;写操作仍走 `/system/business-roles` 的管理员端点。
|
||
"""
|
||
|
||
from typing import Annotated
|
||
|
||
from fastapi import APIRouter, Depends
|
||
|
||
from app.api.deps import DbSession, get_current_user
|
||
from app.core.response import ApiResponse, ok
|
||
from app.models import User
|
||
from app.schemas.business_role import BusinessRoleOptionOut
|
||
from app.services import business_role_service
|
||
|
||
router = APIRouter(prefix="/business-roles", tags=["人员管理"])
|
||
|
||
# 基础数据是业务操作:登录即可,不要求管理员
|
||
CurrentUser = Annotated[User, Depends(get_current_user)]
|
||
|
||
|
||
@router.get(
|
||
"/options",
|
||
response_model=ApiResponse[list[BusinessRoleOptionOut]],
|
||
summary="岗位下拉选项",
|
||
)
|
||
def list_options(session: DbSession, _: CurrentUser) -> ApiResponse[list[BusinessRoleOptionOut]]:
|
||
"""岗位选项(登录即可;含停用——人员档案可能仍引用停用岗位)。
|
||
|
||
岗位规模有限(内置 + 自定义),一次取全量,不做分页。
|
||
"""
|
||
return ok(business_role_service.list_options(session))
|