Files
FastapiAdmin/backend/app/api/v1/module_task/cronjob/job/schema.py
T
zhangtao 5ff72b086f refactor: 重构项目模块结构与代码细节优化
1.  调整后端模块路由与插件文件结构,迁移部分模块代码至api/v1目录
2.  优化代码注释格式与文档字符串,简化冗余代码
3.  添加监控仪表盘、工单评论等新模块功能
4.  修复前端部分组件交互逻辑与类型定义
5.  清理冗余的初始化数据与废弃配置文件
6.  新增租户注册表单字段与国际化支持
7.  优化HTTP请求拦截器与快捷键功能
2026-07-10 00:18:11 +08:00

80 lines
3.3 KiB
Python

from pydantic import (
BaseModel,
ConfigDict,
Field,
field_validator,
model_validator,
)
from app.common.enums import QueueEnum
from app.core.base_schema import BaseQueryParam, BaseSchema, TenantByQueryParam, TenantBySchema, UserByQueryParam, UserBySchema
class JobCreateSchema(BaseModel):
"""执行日志创建模型"""
job_id: str = Field(..., max_length=64, description="任务ID")
job_name: str | None = Field(default=None, max_length=128, description="任务名称")
trigger_type: str | None = Field(default=None, max_length=32, description="触发方式")
status: int = Field(default=0, ge=0, le=5, description="执行状态(0:待执行 1:执行中 2:成功 3:失败 4:超时 5:已取消)")
next_run_time: str | None = Field(default=None, description="下次执行时间")
job_state: str | None = Field(default=None, description="任务状态信息")
result: str | None = Field(default=None, description="执行结果")
error: str | None = Field(default=None, description="错误信息")
@field_validator("job_id")
@classmethod
def validate_job_id(cls, v: str) -> str:
v = v.strip()
if len(v) < 1 or len(v) > 64:
raise ValueError("任务ID长度必须在1-64个字符之间")
return v
@field_validator("trigger_type")
@classmethod
def validate_trigger_type(cls, v: str | None) -> str | None:
if v is None:
return v
allowed = {"cron", "interval", "date", "manual"}
v = v.strip()
if v not in allowed:
raise ValueError(f"触发方式必须为 {allowed}")
return v
class JobUpdateSchema(BaseModel):
"""执行日志更新模型"""
status: int | None = Field(default=None, ge=0, le=5, description="执行状态(0:待执行 1:执行中 2:成功 3:失败 4:超时 5:已取消)")
next_run_time: str | None = Field(default=None, description="下次执行时间")
job_state: str | None = Field(default=None, description="任务状态信息")
result: str | None = Field(default=None, description="执行结果")
error: str | None = Field(default=None, description="错误信息")
class JobOutSchema(JobCreateSchema, BaseSchema, UserBySchema, TenantBySchema):
"""执行日志响应模型"""
model_config = ConfigDict(from_attributes=True)
class JobQueryParam(BaseQueryParam, UserByQueryParam, TenantByQueryParam):
"""执行日志查询参数"""
job_id: str | tuple[str, str] | None = Field(None, description="任务ID")
job_name: str | tuple[str, str] | None = Field(None, description="任务名称")
trigger_type: str | tuple[str, str] | None = Field(None, description="触发方式")
status: int | tuple[str, int] | None = Field(None, ge=0, le=5, description="执行状态(0:待执行 1:执行中 2:成功 3:失败 4:超时 5:已取消)")
@model_validator(mode="after")
def validate_query_params(self) -> "JobQueryParam":
if self.job_id is not None:
self.job_id = (QueueEnum.eq.value, str(self.job_id))
if isinstance(self.job_name, str):
self.job_name = (QueueEnum.like.value, self.job_name)
if isinstance(self.trigger_type, str):
self.trigger_type = (QueueEnum.eq.value, self.trigger_type)
if isinstance(self.status, int):
self.status = (QueueEnum.eq.value, self.status)
return self