liuwenxinandClaude Code
5ece9f6dab
仓储层的 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>
71 lines
2.6 KiB
Python
71 lines
2.6 KiB
Python
"""归属变更留痕的共享数据访问（客户/业务两维度共用）。
|
|
|
|
owner_type 与引用列由调用方参数化 —— 此前客户、业务两侧各持一套逐行
|
|
同构的 list/count/add，排序口径与 join 兜底的调整须同步两处；收口后
|
|
「被删人员留痕仍可读」「翻页稳定双键倒序」等口径单点维护。
|
|
"""
|
|
|
|
from dataclasses import dataclass
|
|
from typing import Any
|
|
|
|
from sqlalchemy import Row, func, select
|
|
from sqlalchemy.orm import Session, aliased
|
|
|
|
from app.models import OwnershipChangeLog, Personnel
|
|
|
|
|
|
@dataclass(frozen=True, slots=True)
|
|
class OwnershipLogRef:
|
|
"""归属留痕的引用锚点（维度类型 + 引用列 + 引用 ID）。
|
|
|
|
引用列是 SQLAlchemy 列表达式（如 ``OwnershipChangeLog.customer_id``），
|
|
不是可序列化值 —— 故用冻结 dataclass 而非 Pydantic 模型。
|
|
"""
|
|
|
|
owner_type: int
|
|
ref_column: Any
|
|
ref_id: int
|
|
|
|
|
|
def list_by_ref(
|
|
session: Session,
|
|
ref: OwnershipLogRef,
|
|
*,
|
|
offset: int,
|
|
limit: int,
|
|
) -> list[Row]:
|
|
"""查某引用对象的归属留痕，行内容为 (留痕, 旧归属人名, 新归属人名)。
|
|
|
|
人员删除后 join 出 None，留痕固化 ID 兜底可读。按 (create_time, id)
|
|
双键倒序：create_time 是秒级精度，同一秒内多条排序不确定，id 兜底
|
|
保证翻页稳定（与操作日志同一理由）。
|
|
"""
|
|
old_person = aliased(Personnel)
|
|
new_person = aliased(Personnel)
|
|
stmt = (
|
|
select(OwnershipChangeLog, old_person.personnel_name, new_person.personnel_name)
|
|
.outerjoin(old_person, OwnershipChangeLog.old_owner_personnel_id == old_person.id)
|
|
.outerjoin(new_person, OwnershipChangeLog.new_owner_personnel_id == new_person.id)
|
|
.where(OwnershipChangeLog.owner_type == ref.owner_type, ref.ref_column == ref.ref_id)
|
|
.order_by(OwnershipChangeLog.create_time.desc(), OwnershipChangeLog.id.desc())
|
|
.offset(offset)
|
|
.limit(limit)
|
|
)
|
|
return list(session.execute(stmt).all())
|
|
|
|
|
|
def count_by_ref(session: Session, ref: OwnershipLogRef) -> int:
|
|
"""统计某引用对象的归属留痕总数，供分页使用。"""
|
|
stmt = select(func.count(OwnershipChangeLog.id)).where(
|
|
OwnershipChangeLog.owner_type == ref.owner_type,
|
|
ref.ref_column == ref.ref_id,
|
|
)
|
|
return int(session.execute(stmt).scalar_one())
|
|
|
|
|
|
def add(session: Session, log: OwnershipChangeLog) -> OwnershipChangeLog:
|
|
"""写入一条归属变更留痕。只 flush 不 commit，与主表归属更新同事务提交。"""
|
|
session.add(log)
|
|
session.flush()
|
|
return log
|