mirror of
https://github.com/fastapiadmin/FastapiAdmin.git
synced 2026-09-21 04:46:26 +00:00
zhangtao
5ff72b086f
1. 调整后端模块路由与插件文件结构，迁移部分模块代码至api/v1目录 2. 优化代码注释格式与文档字符串，简化冗余代码 3. 添加监控仪表盘、工单评论等新模块功能 4. 修复前端部分组件交互逻辑与类型定义 5. 清理冗余的初始化数据与废弃配置文件 6. 新增租户注册表单字段与国际化支持 7. 优化HTTP请求拦截器与快捷键功能
118 lines
4.9 KiB
Python
118 lines
4.9 KiB
Python
from pydantic import BaseModel, ConfigDict, Field, field_validator, model_validator
|
|
|
|
from app.common.enums import QueueEnum, TicketTypeEnum
|
|
from app.core.base_schema import (
|
|
BaseQueryParam,
|
|
BaseSchema,
|
|
CommonSchema,
|
|
TenantByQueryParam,
|
|
TenantBySchema,
|
|
UserByQueryParam,
|
|
UserBySchema,
|
|
)
|
|
|
|
|
|
class TicketCreateSchema(BaseModel):
|
|
"""创建工单"""
|
|
|
|
title: str = Field(..., min_length=1, max_length=200, description="工单标题")
|
|
ticket_content: str = Field(default="", description="工单内容（富文本）")
|
|
summary: str | None = Field(default=None, description="工单内容（纯文本摘要）")
|
|
ticket_type: TicketTypeEnum = Field(default=TicketTypeEnum.SUGGESTION, description="工单类型(suggestion/bug/optimize/other)")
|
|
images: str | None = Field(default=None, description="图片URL列表(JSON数组)")
|
|
description: str | None = Field(default=None, max_length=255, description="工单描述")
|
|
|
|
@field_validator("title")
|
|
@classmethod
|
|
def _validate_title(cls, v: str) -> str:
|
|
v = v.strip()
|
|
if not v:
|
|
raise ValueError("工单标题不能为空")
|
|
return v
|
|
|
|
|
|
class TicketUpdateSchema(BaseModel):
|
|
"""更新工单"""
|
|
|
|
title: str | None = Field(default=None, max_length=200, description="工单标题")
|
|
ticket_content: str | None = Field(default=None, description="工单内容（富文本）")
|
|
summary: str | None = Field(default=None, description="工单内容（纯文本摘要）")
|
|
ticket_type: TicketTypeEnum | None = Field(default=None, description="工单类型")
|
|
status: int | None = Field(default=None, ge=0, le=3, description="状态(0:待处理 1:处理中 2:已完成 3:已关闭)")
|
|
reply: str | None = Field(default=None, description="回复内容")
|
|
assigned_id: int | None = Field(default=None, gt=0, description="处理人ID")
|
|
description: str | None = Field(default=None, max_length=255, 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, 2, 3}:
|
|
raise ValueError("工单状态仅支持 0(待处理)、1(处理中)、2(已完成)、3(已关闭)")
|
|
return v
|
|
|
|
|
|
class TicketOutSchema(BaseSchema, UserBySchema, TenantBySchema):
|
|
"""工单响应"""
|
|
|
|
model_config = ConfigDict(from_attributes=True)
|
|
|
|
title: str = Field(..., description="工单标题")
|
|
ticket_content: str | None = Field(default=None, description="工单内容")
|
|
summary: str | None = Field(default=None, description="摘要")
|
|
ticket_type: TicketTypeEnum = Field(..., description="工单类型")
|
|
status: int = Field(..., description="状态(0:待处理 1:处理中 2:已完成 3:已关闭)")
|
|
images: str | None = Field(default=None, description="图片")
|
|
reply: str | None = Field(default=None, description="回复内容")
|
|
assigned_id: int | None = Field(default=None, description="指派人ID")
|
|
assigned_by: CommonSchema | None = Field(default=None, description="指派人")
|
|
|
|
|
|
class TicketBatchSchema(BaseModel):
|
|
"""批量更新工单"""
|
|
|
|
ids: list[int] = Field(..., min_length=1, description="工单ID列表")
|
|
status: int = Field(..., ge=0, le=3, description="状态(0:待处理 1:处理中 2:已完成 3:已关闭)")
|
|
|
|
@field_validator("status")
|
|
@classmethod
|
|
def _validate_status(cls, v: int) -> int:
|
|
if v not in {0, 1, 2, 3}:
|
|
raise ValueError("工单状态仅支持 0(待处理)、1(处理中)、2(已完成)、3(已关闭)")
|
|
return v
|
|
|
|
|
|
class TicketQueryParam(BaseQueryParam, UserByQueryParam, TenantByQueryParam):
|
|
"""工单查询参数"""
|
|
|
|
title: str | tuple[str, str] | None = Field(None, description="工单标题")
|
|
ticket_type: str | tuple[str, str] | None = Field(None, description="工单类型")
|
|
assigned_id: int | tuple[str, int] | None = Field(None, description="处理人ID")
|
|
status: int | tuple[str, int] | None = Field(None, ge=0, le=3, description="状态(0:待处理 1:处理中 2:已完成 3:已关闭)")
|
|
|
|
@model_validator(mode="after")
|
|
def validate_query_params(self) -> "TicketQueryParam":
|
|
if isinstance(self.title, str):
|
|
self.title = (QueueEnum.like.value, self.title)
|
|
if isinstance(self.ticket_type, str):
|
|
self.ticket_type = (QueueEnum.like.value, self.ticket_type)
|
|
if isinstance(self.assigned_id, int):
|
|
self.assigned_id = (QueueEnum.eq.value, self.assigned_id)
|
|
if isinstance(self.status, int):
|
|
self.status = (QueueEnum.eq.value, self.status)
|
|
return self
|
|
|
|
|
|
class TicketCommentCreateSchema(BaseModel):
|
|
"""创建评论"""
|
|
content: str = Field(..., min_length=1, description="评论内容")
|
|
|
|
|
|
class TicketCommentOutSchema(BaseSchema, UserBySchema):
|
|
"""评论响应"""
|
|
model_config = ConfigDict(from_attributes=True)
|
|
ticket_id: int
|
|
content: str
|
|
created_by_name: str | None = None
|