refactor: 完成项目大规模代码重构与依赖清理

这是一次综合性的重构更新，包含以下主要变更：
1.  升级Python版本到3.12，更新依赖配置
2.  替换旧的.j2模板为.jinja2格式，新增代码生成模板
3.  重构权限过滤策略，更新权限枚举与模型配置
4.  移除Prefect依赖，替换为自研拓扑并行执行引擎
5.  重构认证与上下文管理，拆分租户/请求上下文
6.  简化响应模型、CRUD与服务层代码
7.  清理废弃的支付网关模块，重构订单定时任务
8.  更新在线用户、监控等模块的接口与路由
9.  优化邮件模板与工具类，新增邮件模板文件
10. 修复数据库会话配置与类型提示

backend/app/api/v1/module_system/ticket/controller.py

@@ -1,6 +1,6 @@
 from typing import Annotated
 
-from fastapi import APIRouter, Body, Depends, Path
+from fastapi import APIRouter, Depends
 from fastapi.responses import JSONResponse
 
 from app.common.response import ResponseSchema, SuccessResponse
@@ -18,28 +18,15 @@ from .schema import (
 )
 from .service import TicketService
 
-TicketRouter = APIRouter(route_class=OperationLogRoute, prefix="/ticket", tags=["工单管理"])
-
+TicketRouter = APIRouter(route_class=OperationLogRoute, prefix="/ticket", tags=["系统管理", "工单管理"])
 
 @TicketRouter.get("/list", summary="工单列表", response_model=ResponseSchema[PageResultSchema[TicketOutSchema]])
 async def ticket_list_controller(
-    page: Annotated[PaginationQueryParam, Depends()],
     search: Annotated[TicketQueryParam, Depends()],
-    auth: Annotated[AuthSchema, Depends(AuthPermission(["module_system:ticket:query"]))],
+    page: Annotated[PaginationQueryParam, Depends()],
+    auth: Annotated[AuthSchema, Depends(AuthPermission(["module_system:ticket:list"]))],
 ) -> JSONResponse:
-    """
-    工单列表
-
-    参数:
-    - page (PaginationQueryParam): 分页查询参数。
-    - search (TicketQueryParam): 查询筛选参数。
-    - auth (AuthSchema): 认证信息模型。
-
-    返回:
-    - JSONResponse: 包含分页工单列表的 JSON 响应。
-    """
-    result = await TicketService.page_service(
-        auth=auth,
+    result = await TicketService(auth).page(
         page_no=page.page_no,
         page_size=page.page_size,
         search=search,
@@ -47,99 +34,43 @@ async def ticket_list_controller(
     )
     return SuccessResponse(data=result, msg="查询成功")
 
-
-@TicketRouter.get("/detail/{id}", summary="工单详情", response_model=ResponseSchema[TicketOutSchema])
+@TicketRouter.get("/detail/{id}", summary="获取工单详情", response_model=ResponseSchema[TicketOutSchema])
 async def ticket_detail_controller(
-    id: Annotated[int, Path(description="ID")],
-    auth: Annotated[AuthSchema, Depends(AuthPermission(["module_system:ticket:query"]))],
+    id: int,
+    auth: Annotated[AuthSchema, Depends(AuthPermission(["module_system:ticket:detail"]))],
 ) -> JSONResponse:
-    """
-    工单详情
-
-    参数:
-    - id (int): 工单 ID。
-    - auth (AuthSchema): 认证信息模型。
-
-    返回:
-    - JSONResponse: 包含工单详情的 JSON 响应。
-    """
-    result = await TicketService.detail_service(auth=auth, id=id)
+    result = await TicketService(auth).detail(id=id)
     return SuccessResponse(data=result, msg="查询成功")
 
-
 @TicketRouter.post("/create", summary="创建工单", response_model=ResponseSchema[TicketOutSchema])
 async def ticket_create_controller(
     data: TicketCreateSchema,
     auth: Annotated[AuthSchema, Depends(AuthPermission(["module_system:ticket:create"]))],
 ) -> JSONResponse:
-    """
-    创建工单
-
-    参数:
-    - data (TicketCreateSchema): 工单创建参数。
-    - auth (AuthSchema): 认证信息模型。
-
-    返回:
-    - JSONResponse: 包含创建后的工单详情的 JSON 响应。
-    """
-    result = await TicketService.create_service(auth=auth, data=data)
+    result = await TicketService(auth).create(data=data)
     return SuccessResponse(data=result, msg="创建成功")
 
-
 @TicketRouter.put("/update/{id}", summary="更新工单", response_model=ResponseSchema[TicketOutSchema])
 async def ticket_update_controller(
-    id: Annotated[int, Path(description="ID")],
+    id: int,
     data: TicketUpdateSchema,
     auth: Annotated[AuthSchema, Depends(AuthPermission(["module_system:ticket:update"]))],
 ) -> JSONResponse:
-    """
-    更新工单
-
-    参数:
-    - id (int): 工单 ID。
-    - data (TicketUpdateSchema): 工单更新参数。
-    - auth (AuthSchema): 认证信息模型。
-
-    返回:
-    - JSONResponse: 包含更新后的工单详情的 JSON 响应。
-    """
-    result = await TicketService.update_service(auth=auth, id=id, data=data)
+    result = await TicketService(auth).update(id=id, data=data)
     return SuccessResponse(data=result, msg="更新成功")
 
-
 @TicketRouter.put("/batch", summary="批量更新工单", response_model=ResponseSchema)
 async def ticket_batch_update_controller(
     data: TicketBatchSchema,
     auth: Annotated[AuthSchema, Depends(AuthPermission(["module_system:ticket:update"]))],
 ) -> JSONResponse:
-    """
-    批量更新工单
-
-    参数:
-    - data (TicketBatchSchema): 批量更新参数（ID 列表 + 状态）。
-    - auth (AuthSchema): 认证信息模型。
-
-    返回:
-    - JSONResponse: 操作结果。
-    """
-    await TicketService.batch_service(auth=auth, data=data)
-    return SuccessResponse(msg="批量更新成功")
-
+    await TicketService(auth).batch(data=data)
+    return SuccessResponse(msg="批量操作成功")
 
 @TicketRouter.delete("/delete", summary="删除工单", response_model=ResponseSchema[None])
 async def ticket_delete_controller(
-    ids: Annotated[list[int], Body()],
+    ids: list[int],
     auth: Annotated[AuthSchema, Depends(AuthPermission(["module_system:ticket:delete"]))],
 ) -> JSONResponse:
-    """
-    删除工单
-
-    参数:
-    - ids (list[int]): 工单 ID 列表。
-    - auth (AuthSchema): 认证信息模型。
-
-    返回:
-    - JSONResponse: 删除结果。
-    """
-    await TicketService.delete_service(auth=auth, ids=ids)
+    await TicketService(auth).delete(ids=ids)
     return SuccessResponse(msg="删除成功")