mirror of
https://github.com/fastapiadmin/FastapiAdmin.git
synced 2026-09-22 13:05:18 +00:00
zhangtao
4e2b668d7b
本次提交包含多项优化和修复： 1. 修复CRUD初始化参数传递、搜索参数处理逻辑 2. 更新环境配置中的大模型相关参数 3. 重构部分服务方法命名，统一代码风格 4. 新增多个枚举类型，补充模型关联关系和加载选项 5. 优化查询参数类实现，完善字段校验逻辑 6. 调整Pydantic模型字段注释和类型定义 7. 简化并移除冗余的CRUD方法实现 8. 新增超级管理员权限装饰器 9. 修复邮件日志模型的租户关联和字段定义
247 lines
11 KiB
Python
247 lines
11 KiB
Python
from dataclasses import dataclass
|
|
from typing import Literal
|
|
|
|
from fastapi import Query
|
|
from pydantic import BaseModel, ConfigDict, Field, field_validator, model_validator
|
|
|
|
from app.common.enums import QueueEnum
|
|
from app.core.base_params import BaseQueryParam
|
|
from app.core.base_schema import BaseSchema
|
|
from app.core.validator import menu_request_validator
|
|
|
|
|
|
class MenuCreateSchema(BaseModel):
|
|
"""菜单创建模型"""
|
|
|
|
name: str = Field(..., min_length=1, max_length=50, description="菜单名称")
|
|
type: int = Field(..., ge=1, le=4, description="菜单类型(1:目录 2:菜单 3:按钮 4:外链)")
|
|
order: int = Field(..., ge=0, description="显示顺序")
|
|
permission: str | None = Field(default=None, max_length=100, description="权限标识")
|
|
icon: str | None = Field(default=None, max_length=50, description="菜单图标")
|
|
route_name: str | None = Field(default=None, max_length=100, description="路由名称")
|
|
route_path: str | None = Field(default=None, max_length=200, description="路由地址")
|
|
component_path: str | None = Field(default=None, max_length=200, description="组件路径")
|
|
redirect: str | None = Field(default=None, max_length=200, description="重定向地址")
|
|
hidden: bool = Field(default=False, description="是否隐藏")
|
|
keep_alive: bool = Field(default=True, description="是否缓存")
|
|
always_show: bool = Field(default=False, description="是否始终显示")
|
|
title: str | None = Field(default=None, max_length=50, description="菜单标题")
|
|
params: list[dict[str, str]] | None = Field(
|
|
default=None,
|
|
description="路由参数，格式为[{key: string, value: string}]",
|
|
)
|
|
affix: bool = Field(default=False, description="是否固定标签页")
|
|
parent_id: int | None = Field(default=None, ge=1, description="父菜单ID")
|
|
status: int = Field(default=0, ge=0, le=1, description="状态(0:启动 1:停用)")
|
|
description: str | None = Field(default=None, max_length=255, description="描述")
|
|
client: Literal["pc", "app"] = Field(
|
|
default="pc",
|
|
description="终端(pc:管理端桌面 app:移动端)",
|
|
)
|
|
link: str | None = Field(default=None, max_length=500, description="外链地址(仅type=4)")
|
|
is_iframe: bool = Field(default=False, description="是否嵌入iframe")
|
|
is_hide_tab: bool = Field(default=False, description="是否隐藏标签页")
|
|
active_path: str | None = Field(default=None, max_length=200, description="激活菜单路径")
|
|
show_badge: bool = Field(default=False, description="是否显示红点角标")
|
|
show_text_badge: str | None = Field(default=None, max_length=20, description="文字角标内容")
|
|
scope: Literal["platform", "tenant"] = Field(
|
|
default="tenant",
|
|
description="菜单可见范围(platform:仅平台 tenant:租户可用)",
|
|
)
|
|
|
|
@field_validator("status")
|
|
@classmethod
|
|
def _validate_status(cls, v: int) -> int:
|
|
if v not in {0, 1}:
|
|
raise ValueError("状态仅支持 0(正常) 或 1(禁用)")
|
|
return v
|
|
|
|
@model_validator(mode="before")
|
|
@classmethod
|
|
def _normalize(cls, values):
|
|
if isinstance(values, dict):
|
|
for k in [
|
|
"name",
|
|
"icon",
|
|
"permission",
|
|
"route_name",
|
|
"route_path",
|
|
"component_path",
|
|
"redirect",
|
|
"title",
|
|
"description",
|
|
"link",
|
|
"active_path",
|
|
"show_text_badge",
|
|
]:
|
|
if k in values and isinstance(values[k], str):
|
|
stripped = values[k].strip()
|
|
values[k] = stripped or None
|
|
if "client" in values and isinstance(values["client"], str):
|
|
cv = values["client"].strip()
|
|
values["client"] = cv if cv in ("pc", "app") else "pc"
|
|
if "parent_id" in values and isinstance(values["parent_id"], str):
|
|
try:
|
|
values["parent_id"] = int(values["parent_id"].strip())
|
|
except (ValueError, TypeError):
|
|
pass
|
|
if "component_path" in values and isinstance(values["component_path"], str):
|
|
cp = values["component_path"]
|
|
if cp and cp.startswith("/"):
|
|
raise ValueError("组件路径不能以 / 开头")
|
|
return values
|
|
|
|
@model_validator(mode="after")
|
|
def validate_fields(self):
|
|
"""
|
|
统一校验菜单请求字段（委托到 `menu_request_validator`）。
|
|
|
|
返回:
|
|
- MenuCreateSchema: 校验后的同一实例。
|
|
|
|
异常:
|
|
- CustomException: 字段不满足菜单类型约束时抛出。
|
|
"""
|
|
return menu_request_validator(self)
|
|
|
|
|
|
class MenuUpdateSchema(BaseModel):
|
|
"""菜单更新模型 — 所有字段可选"""
|
|
|
|
name: str | None = Field(default=None, min_length=1, max_length=50, description="菜单名称")
|
|
type: int | None = Field(default=None, ge=1, le=4, description="菜单类型(1:目录 2:菜单 3:按钮 4:外链)")
|
|
order: int | None = Field(default=None, ge=0, description="显示顺序")
|
|
permission: str | None = Field(default=None, max_length=100, description="权限标识")
|
|
icon: str | None = Field(default=None, max_length=50, description="菜单图标")
|
|
route_name: str | None = Field(default=None, max_length=100, description="路由名称")
|
|
route_path: str | None = Field(default=None, max_length=200, description="路由地址")
|
|
component_path: str | None = Field(default=None, max_length=200, description="组件路径")
|
|
redirect: str | None = Field(default=None, max_length=200, description="重定向地址")
|
|
hidden: bool | None = Field(default=None, description="是否隐藏")
|
|
keep_alive: bool | None = Field(default=None, description="是否缓存")
|
|
always_show: bool | None = Field(default=None, description="是否始终显示")
|
|
title: str | None = Field(default=None, max_length=50, description="菜单标题")
|
|
params: list[dict[str, str]] | None = Field(default=None, description="路由参数")
|
|
affix: bool | None = Field(default=None, description="是否固定标签页")
|
|
parent_id: int | None = Field(default=None, ge=1, description="父菜单ID")
|
|
status: int | None = Field(default=None, ge=0, le=1, description="状态(0:启动 1:停用)")
|
|
description: str | None = Field(default=None, max_length=255, description="描述")
|
|
client: Literal["pc", "app"] | None = Field(default=None, description="终端(pc:管理端桌面 app:移动端)")
|
|
link: str | None = Field(default=None, max_length=500, description="外链地址(仅type=4)")
|
|
is_iframe: bool | None = Field(default=None, description="是否嵌入iframe")
|
|
is_hide_tab: bool | None = Field(default=None, description="是否隐藏标签页")
|
|
active_path: str | None = Field(default=None, max_length=200, description="激活菜单路径")
|
|
show_badge: bool | None = Field(default=None, description="是否显示红点角标")
|
|
show_text_badge: str | None = Field(default=None, max_length=20, description="文字角标内容")
|
|
scope: Literal["platform", "tenant"] | None = Field(
|
|
default=None,
|
|
description="菜单可见范围(platform:仅平台 tenant:租户可用)",
|
|
)
|
|
parent_name: str | None = Field(default=None, max_length=50, description="父菜单名称")
|
|
|
|
@field_validator("status")
|
|
@classmethod
|
|
def _validate_status(cls, v: int | None) -> int | None:
|
|
if v is None:
|
|
return v
|
|
if v not in {0, 1}:
|
|
raise ValueError("状态仅支持 0(正常) 或 1(禁用)")
|
|
return v
|
|
|
|
@model_validator(mode="before")
|
|
@classmethod
|
|
def _normalize(cls, values):
|
|
if isinstance(values, dict):
|
|
for k in [
|
|
"name",
|
|
"icon",
|
|
"permission",
|
|
"route_name",
|
|
"route_path",
|
|
"component_path",
|
|
"redirect",
|
|
"title",
|
|
"description",
|
|
"link",
|
|
"active_path",
|
|
"show_text_badge",
|
|
]:
|
|
if k in values and isinstance(values[k], str):
|
|
stripped = values[k].strip()
|
|
values[k] = stripped or None
|
|
if "client" in values and isinstance(values["client"], str):
|
|
cv = values["client"].strip()
|
|
values["client"] = cv if cv in ("pc", "app") else None
|
|
if "parent_id" in values and isinstance(values["parent_id"], str):
|
|
try:
|
|
values["parent_id"] = int(values["parent_id"].strip())
|
|
except (ValueError, TypeError):
|
|
pass
|
|
if "component_path" in values and isinstance(values["component_path"], str) and values["component_path"]:
|
|
if values["component_path"].startswith("/"):
|
|
raise ValueError("组件路径不能以 / 开头")
|
|
return values
|
|
|
|
@model_validator(mode="after")
|
|
def validate_fields(self):
|
|
if self.type is None:
|
|
return self
|
|
return menu_request_validator(self)
|
|
|
|
|
|
class MenuOutSchema(MenuCreateSchema, BaseSchema):
|
|
"""菜单详情响应模型（不含 children，用于详情和更新）"""
|
|
|
|
model_config = ConfigDict(from_attributes=True)
|
|
|
|
parent_name: str | None = Field(default=None, max_length=50, description="父菜单名称")
|
|
|
|
|
|
class MenuTreeOutSchema(MenuOutSchema):
|
|
"""菜单树形响应模型（含 children，用于树形列表）"""
|
|
|
|
children: list["MenuTreeOutSchema"] | None = Field(default=None, description="子菜单列表")
|
|
|
|
|
|
@dataclass
|
|
class MenuQueryParam(BaseQueryParam):
|
|
"""菜单管理查询参数（菜单为平台级资源，无用户归属）"""
|
|
|
|
def __init__(
|
|
self,
|
|
name: str | None = Query(None, description="菜单名称"),
|
|
route_path: str | None = Query(None, description="路由地址"),
|
|
component_path: str | None = Query(None, description="组件路径"),
|
|
type: Literal[1, 2, 3, 4] | None = Query(None, description="菜单类型(1:目录 2:菜单 3:按钮 4:外链)"),
|
|
permission: str | None = Query(None, description="权限标识"),
|
|
description: str | None = Query(None, description="描述"),
|
|
status: str | None = Query(None, description="是否启用"),
|
|
menu_client: Literal["pc", "app"] | None = Query(
|
|
None,
|
|
description="管理端 Tab：pc=桌面端菜单 app=移动端菜单；不传则不过滤终端",
|
|
),
|
|
scope: Literal["tenant"] | None = Query(
|
|
None,
|
|
description="菜单范围过滤：tenant=仅租户可用菜单",
|
|
),
|
|
*args,
|
|
**kwargs,
|
|
) -> None:
|
|
super().__init__(*args, **kwargs)
|
|
if name:
|
|
self.name = (QueueEnum.like.value, name)
|
|
if route_path:
|
|
self.route_path = (QueueEnum.like.value, route_path)
|
|
if component_path:
|
|
self.component_path = (QueueEnum.like.value, component_path)
|
|
if permission:
|
|
self.permission = (QueueEnum.like.value, permission)
|
|
if description:
|
|
self.description = (QueueEnum.like.value, description)
|
|
if status:
|
|
self.status = (QueueEnum.eq.value, status)
|
|
if menu_client in ("pc", "app"):
|
|
self.client = (QueueEnum.eq.value, menu_client)
|
|
if scope == "tenant":
|
|
self.scope = (QueueEnum.eq.value, "tenant")
|