refactor: 重构项目模块结构与代码细节优化

1.  调整后端模块路由与插件文件结构,迁移部分模块代码至api/v1目录
2.  优化代码注释格式与文档字符串,简化冗余代码
3.  添加监控仪表盘、工单评论等新模块功能
4.  修复前端部分组件交互逻辑与类型定义
5.  清理冗余的初始化数据与废弃配置文件
6.  新增租户注册表单字段与国际化支持
7.  优化HTTP请求拦截器与快捷键功能
This commit is contained in:
zhangtao
2026-07-10 00:18:11 +08:00
parent 349ab7b525
commit 5ff72b086f
323 changed files with 7633 additions and 15306 deletions
@@ -1,6 +1,6 @@
from typing import Annotated
from fastapi import APIRouter, Body, Depends, Path, Query
from fastapi import APIRouter, Body, Path, Query, Security, status
from fastapi.responses import JSONResponse
from fastapi_cache import FastAPICache
from fastapi_cache.decorator import cache
@@ -10,25 +10,35 @@ from app.core.base_schema import AuthSchema, BatchSetAvailable, PageResultSchema
from app.core.dependencies import AuthPermission
from app.core.router_class import OperationLogRoute
from .schema import PackageCreateSchema, PackageMenuSetSchema, PackageOutSchema, PackagePluginSetSchema, PackageQueryParam, PackageUpdateSchema
from .schema import PackageCreateSchema, PackageMenuSetSchema, PackageOutSchema, PackageQueryParam, PackageUpdateSchema
from .service import PackageService
PackageRouter = APIRouter(route_class=OperationLogRoute, prefix="/package", tags=["套餐管理"])
_PKG_NS = "package"
@PackageRouter.get("/options", summary="获取套餐下拉选项", response_model=ResponseSchema[list[dict[str, int | str]]])
async def get_package_options_controller(
auth: Annotated[AuthSchema, Security(AuthPermission(["module_package:package:query"]))],
) -> JSONResponse:
options = await PackageService(auth).get_options()
return SuccessResponse(data=options, msg="获取套餐选项成功")
@PackageRouter.get("/detail/{id}", summary="获取套餐详情", response_model=ResponseSchema[PackageOutSchema])
@cache(expire=300, namespace=_PKG_NS)
async def get_obj_detail_controller(
auth: Annotated[AuthSchema, Depends(AuthPermission(["module_package:package:query"]))],
auth: Annotated[AuthSchema, Security(AuthPermission(["module_package:package:query"]))],
id: Annotated[int, Path(description="套餐ID", ge=1)],
) -> JSONResponse:
result_dict = await PackageService(auth).detail(id=id)
return SuccessResponse(data=result_dict, msg="获取套餐详情成功")
@PackageRouter.get("/list", summary="获取套餐列表", response_model=ResponseSchema[PageResultSchema[PackageOutSchema]])
async def get_obj_list_controller(
auth: Annotated[AuthSchema, Depends(AuthPermission(["module_package:package:query"]))],
auth: Annotated[AuthSchema, Security(AuthPermission(["module_package:package:query"]))],
page: Annotated[PaginationQueryParam, Query(description="分页参数")],
search: Annotated[PackageQueryParam, Query(description="查询参数")],
) -> JSONResponse:
@@ -40,18 +50,20 @@ async def get_obj_list_controller(
)
return SuccessResponse(data=result_dict, msg="查询成功")
@PackageRouter.post("/create", summary="创建套餐", response_model=ResponseSchema[PackageOutSchema])
@PackageRouter.post("/create", status_code=status.HTTP_201_CREATED, summary="创建套餐", response_model=ResponseSchema[PackageOutSchema])
async def create_obj_controller(
auth: Annotated[AuthSchema, Depends(AuthPermission(["module_package:package:create"]))],
auth: Annotated[AuthSchema, Security(AuthPermission(["module_package:package:create"]))],
data: Annotated[PackageCreateSchema, Body(description="套餐信息")],
) -> JSONResponse:
result_dict = await PackageService(auth).create(data=data)
await FastAPICache.clear(namespace=_PKG_NS)
return SuccessResponse(data=result_dict, msg="创建成功")
@PackageRouter.put("/update/{id}", summary="更新套餐", response_model=ResponseSchema[PackageOutSchema])
async def update_obj_controller(
auth: Annotated[AuthSchema, Depends(AuthPermission(["module_package:package:update"]))],
auth: Annotated[AuthSchema, Security(AuthPermission(["module_package:package:update"]))],
id: Annotated[int, Path(description="套餐ID", ge=1)],
data: Annotated[PackageUpdateSchema, Body(description="套餐信息")],
) -> JSONResponse:
@@ -59,18 +71,20 @@ async def update_obj_controller(
await FastAPICache.clear(namespace=_PKG_NS)
return SuccessResponse(data=result_dict, msg="更新成功")
@PackageRouter.delete("/delete", summary="删除套餐", response_model=ResponseSchema)
async def delete_obj_controller(
auth: Annotated[AuthSchema, Depends(AuthPermission(["module_package:package:delete"]))],
auth: Annotated[AuthSchema, Security(AuthPermission(["module_package:package:delete"]))],
ids: Annotated[list[int], Body(description="ID列表")],
) -> JSONResponse:
await PackageService(auth).delete(ids=ids)
await FastAPICache.clear(namespace=_PKG_NS)
return SuccessResponse(msg="删除成功")
@PackageRouter.patch("/status/batch", summary="批量修改状态", response_model=ResponseSchema)
async def set_available_controller(
auth: Annotated[AuthSchema, Depends(AuthPermission(["module_package:package:update"]))],
auth: Annotated[AuthSchema, Security(AuthPermission(["module_package:package:update"]))],
data: Annotated[BatchSetAvailable, Body(description="状态设置")],
) -> JSONResponse:
for id in data.ids:
@@ -78,36 +92,21 @@ async def set_available_controller(
await FastAPICache.clear(namespace=_PKG_NS)
return SuccessResponse(msg="状态设置成功")
@PackageRouter.get("/menus/{package_id}", summary="获取套餐菜单", response_model=ResponseSchema[list[int]])
async def get_menus_controller(
auth: Annotated[AuthSchema, Depends(AuthPermission(["module_package:package:query"]))],
auth: Annotated[AuthSchema, Security(AuthPermission(["module_package:package:query"]))],
package_id: Annotated[int, Path(description="套餐ID", ge=1)],
) -> JSONResponse:
result = await PackageService(auth).get_menus(package_id=package_id)
return SuccessResponse(data=result, msg="获取成功")
@PackageRouter.post("/menus/{package_id}/set", summary="设置套餐菜单", response_model=ResponseSchema)
async def set_menus_controller(
auth: Annotated[AuthSchema, Depends(AuthPermission(["module_package:package:update"]))],
auth: Annotated[AuthSchema, Security(AuthPermission(["module_package:package:update"]))],
package_id: Annotated[int, Path(description="套餐ID", ge=1)],
data: Annotated[PackageMenuSetSchema, Body(description="菜单列表")],
) -> JSONResponse:
await PackageService(auth).set_menus(package_id=package_id, data=data)
return SuccessResponse(msg="设置成功")
@PackageRouter.get("/plugins/{package_id}", summary="获取套餐插件", response_model=ResponseSchema[list[int]])
async def get_plugins_controller(
auth: Annotated[AuthSchema, Depends(AuthPermission(["module_package:package:query"]))],
package_id: Annotated[int, Path(description="套餐ID", ge=1)],
) -> JSONResponse:
result = await PackageService(auth).get_plugins(package_id=package_id)
return SuccessResponse(data=result, msg="获取成功")
@PackageRouter.post("/plugins/{package_id}/set", summary="设置套餐插件", response_model=ResponseSchema)
async def set_plugins_controller(
auth: Annotated[AuthSchema, Depends(AuthPermission(["module_package:package:update"]))],
package_id: Annotated[int, Path(description="套餐ID", ge=1)],
data: Annotated[PackagePluginSetSchema, Body(description="插件列表")],
) -> JSONResponse:
await PackageService(auth).set_plugins(package_id=package_id, data=data)
return SuccessResponse(msg="设置成功")