mirror of
https://github.com/fastapiadmin/FastapiAdmin.git
synced 2026-09-22 13:05:18 +00:00
zhangtao
0b38612cb2
- 重构API路由与请求路径，统一批量状态更新接口 - 优化类型导入与参数继承逻辑，简化基础查询参数实现 - 修复日志格式化与权限校验细节问题 - 新增多模块接口测试用例，完善测试覆盖 - 调整环境配置与初始化脚本细节 - 简化服务层方法命名，统一代码风格
94 lines
2.9 KiB
Python
94 lines
2.9 KiB
Python
import json
|
||
|
||
from fastapi import Query
|
||
|
||
from app.common.enums import QueueEnum
|
||
from app.core.validator import DateTimeStr
|
||
|
||
|
||
class PaginationQueryParam:
|
||
"""分页查询参数基类"""
|
||
|
||
def __init__(
|
||
self,
|
||
page_no: int = Query(default=1, description="当前页码", ge=1),
|
||
page_size: int = Query(default=10, description="每页数量", ge=1, le=100),
|
||
order_by: str | None = Query(
|
||
default=None,
|
||
description="排序字段,格式:[{'field1': 'asc'}, {'field2': 'desc'}]",
|
||
),
|
||
) -> None:
|
||
"""
|
||
初始化分页查询参数。
|
||
|
||
参数:
|
||
- page_no (int | None): 当前页码，默认 None。
|
||
- page_size (int | None): 每页数量，默认 None，最大 100。
|
||
- order_by (str | None): 排序字段，格式 'field,asc;field2,desc'。
|
||
|
||
返回:
|
||
- None
|
||
"""
|
||
self.page_no = page_no
|
||
self.page_size = page_size
|
||
# 将字符串格式的order_by转换为服务层需要的List[Dict[str, str]]格式
|
||
if order_by:
|
||
try:
|
||
self.order_by = json.loads(order_by)
|
||
except ValueError:
|
||
# 如果解析失败，使用默认排序
|
||
self.order_by = [{"id": "desc"}]
|
||
else:
|
||
self.order_by = [{"id": "desc"}]
|
||
|
||
|
||
class BaseQueryParam:
|
||
"""基础查询字段 Mixin（created_time + updated_time）"""
|
||
|
||
def __init__(
|
||
self,
|
||
created_time: list[DateTimeStr] | None = Query(
|
||
None,
|
||
description="创建时间范围",
|
||
examples=["2025-01-01 00:00:00", "2025-12-31 23:59:59"],
|
||
),
|
||
updated_time: list[DateTimeStr] | None = Query(
|
||
None,
|
||
description="更新时间范围",
|
||
examples=["2025-01-01 00:00:00", "2025-12-31 23:59:59"],
|
||
),
|
||
) -> None:
|
||
super().__init__()
|
||
# 时间范围查询
|
||
if created_time and len(created_time) == 2:
|
||
self.created_time = (QueueEnum.between.value, (created_time[0], created_time[1]))
|
||
if updated_time and len(updated_time) == 2:
|
||
self.updated_time = (QueueEnum.between.value, (updated_time[0], updated_time[1]))
|
||
|
||
|
||
class UserByQueryParam:
|
||
"""审计字段 Mixin（created_id + updated_id）"""
|
||
|
||
def __init__(
|
||
self,
|
||
created_id: int | None = Query(None, description="创建人"),
|
||
updated_id: int | None = Query(None, description="更新人"),
|
||
) -> None:
|
||
super().__init__()
|
||
if created_id:
|
||
self.created_id = (QueueEnum.eq.value, created_id)
|
||
if updated_id:
|
||
self.updated_id = (QueueEnum.eq.value, updated_id)
|
||
|
||
|
||
class TenantByQueryParam:
|
||
"""租户字段 Mixin（tenant_id）"""
|
||
|
||
def __init__(
|
||
self,
|
||
tenant_id: int | None = Query(None, description="租户ID"),
|
||
) -> None:
|
||
super().__init__()
|
||
if tenant_id:
|
||
self.tenant_id = (QueueEnum.eq.value, tenant_id)
|