refactor(backend): 调整模块结构、调度器逻辑与健康检查路由

backend/app/modules/workflow/source/controller.py

@@ -0,0 +1,128 @@
+from typing import Annotated
+
+from fastapi import APIRouter, Body, Depends, Path, Query, Security, status
+from fastapi.responses import JSONResponse
+from sqlalchemy.ext.asyncio import AsyncSession
+
+from app.common.response import ResponseSchema, SuccessResponse
+from app.core.base_schema import AuthSchema, PageResultSchema, PaginationQueryParam
+from app.core.dependencies import AuthPermission, db_getter
+from app.core.router_class import OperationLogRoute
+from app.modules.workflow.core.base import (
+    ADVANCED_FIELD_DEFS,
+    DEFAULT_PORTS,
+    AdvancedFieldDefSchema,
+    StorageProtocol,
+    StorageProtocolDefSchema,
+)
+
+from .schema import StorageSourceCreateSchema, StorageSourceOutSchema, StorageSourceQueryParam, StorageSourceTestSchema, StorageSourceUpdateSchema
+from .service import StorageSourceService
+
+StorageSourceRouter = APIRouter(route_class=OperationLogRoute, prefix="/source", tags=["存储源管理"])
+
+
+@StorageSourceRouter.get("/protocols", summary="查询支持的存储协议", response_model=ResponseSchema[list[StorageProtocolDefSchema]])
+async def get_storage_protocols_controller(
+    auth: Annotated[AuthSchema, Security(AuthPermission(["module_task:workflow:node:query"]))],
+) -> JSONResponse:
+    result: list[StorageProtocolDefSchema] = [
+        StorageProtocolDefSchema(protocol=p.value, name=p.name, default_port=DEFAULT_PORTS[p])
+        for p in StorageProtocol
+    ]
+    return SuccessResponse(data=result, msg="查询存储协议成功")
+
+
+@StorageSourceRouter.get("/advanced-fields", summary="查询存储 SDK 高级配置字段定义", response_model=ResponseSchema[dict[str, list[AdvancedFieldDefSchema]]])
+async def get_advanced_fields_controller(
+    auth: Annotated[AuthSchema, Security(AuthPermission(["module_task:workflow:node:query"]))],
+) -> JSONResponse:
+    """返回按协议分组的 SDK 高级配置字段元数据，供前端「高级设置」面板按协议动态渲染。"""
+    return SuccessResponse(data=ADVANCED_FIELD_DEFS, msg="查询高级配置字段成功")
+
+
+@StorageSourceRouter.get("/page", summary="分页查询存储源", response_model=ResponseSchema[PageResultSchema[StorageSourceOutSchema]])
+async def get_storage_source_page_controller(
+    auth: Annotated[AuthSchema, Security(AuthPermission(["module_task:workflow:node:query"]))],
+    db: Annotated[AsyncSession, Depends(db_getter)],
+    page: Annotated[PaginationQueryParam, Depends()],
+    search: Annotated[StorageSourceQueryParam, Query()],
+) -> JSONResponse:
+    result: PageResultSchema[StorageSourceOutSchema] = await StorageSourceService(auth, db).page(
+        search=search,
+        page_no=page.page_no,
+        page_size=page.page_size,
+        order_by=page.order_by,
+    )
+    return SuccessResponse(data=result, msg="查询存储源分页成功")
+
+
+@StorageSourceRouter.get("/list", summary="查询存储源列表", response_model=ResponseSchema[list[StorageSourceOutSchema]])
+async def get_storage_source_list_controller(
+    auth: Annotated[AuthSchema, Security(AuthPermission(["module_task:workflow:node:query"]))],
+    db: Annotated[AsyncSession, Depends(db_getter)],
+    search: Annotated[StorageSourceQueryParam, Query()],
+) -> JSONResponse:
+    result: list[StorageSourceOutSchema] = await StorageSourceService(auth, db).get_list(search=search)
+    return SuccessResponse(data=result, msg="查询存储源列表成功")
+
+
+@StorageSourceRouter.get("/detail/{id}", summary="查询存储源详情", response_model=ResponseSchema[StorageSourceOutSchema])
+async def get_storage_source_detail_controller(
+    auth: Annotated[AuthSchema, Security(AuthPermission(["module_task:workflow:node:query"]))],
+    db: Annotated[AsyncSession, Depends(db_getter)],
+    id: Annotated[int, Path(description="存储源ID", ge=1)],
+) -> JSONResponse:
+    result: StorageSourceOutSchema = await StorageSourceService(auth, db).detail(id=id)
+    return SuccessResponse(data=result, msg="查询存储源详情成功")
+
+
+@StorageSourceRouter.post("/create", status_code=status.HTTP_201_CREATED, summary="创建存储源", response_model=ResponseSchema[StorageSourceOutSchema])
+async def create_storage_source_controller(
+    auth: Annotated[AuthSchema, Security(AuthPermission(["module_task:workflow:node:create"]))],
+    db: Annotated[AsyncSession, Depends(db_getter)],
+    data: Annotated[StorageSourceCreateSchema, Body(description="存储源创建参数")],
+) -> JSONResponse:
+    result: StorageSourceOutSchema = await StorageSourceService(auth, db).create(data=data)
+    return SuccessResponse(data=result, msg="创建存储源成功")
+
+
+@StorageSourceRouter.put("/update/{id}", summary="修改存储源", response_model=ResponseSchema[StorageSourceOutSchema])
+async def update_storage_source_controller(
+    auth: Annotated[AuthSchema, Security(AuthPermission(["module_task:workflow:node:update"]))],
+    db: Annotated[AsyncSession, Depends(db_getter)],
+    id: Annotated[int, Path(description="存储源ID", ge=1)],
+    data: Annotated[StorageSourceUpdateSchema, Body(description="存储源修改参数")],
+) -> JSONResponse:
+    result: StorageSourceOutSchema = await StorageSourceService(auth, db).update(id=id, data=data)
+    return SuccessResponse(data=result, msg="修改存储源成功")
+
+
+@StorageSourceRouter.delete("/delete", summary="删除存储源", response_model=ResponseSchema[None])
+async def delete_storage_source_controller(
+    auth: Annotated[AuthSchema, Security(AuthPermission(["module_task:workflow:node:delete"]))],
+    db: Annotated[AsyncSession, Depends(db_getter)],
+    ids: Annotated[list[int], Body(description="存储源ID列表")],
+) -> JSONResponse:
+    await StorageSourceService(auth, db).delete(ids=ids)
+    return SuccessResponse(msg="删除存储源成功")
+
+
+@StorageSourceRouter.post("/test/{id}", summary="测试存储源连接", response_model=ResponseSchema[bool])
+async def test_storage_source_controller(
+    auth: Annotated[AuthSchema, Security(AuthPermission(["module_task:workflow:node:query"]))],
+    db: Annotated[AsyncSession, Depends(db_getter)],
+    id: Annotated[int, Path(description="存储源ID", ge=1)],
+) -> JSONResponse:
+    result: bool = await StorageSourceService(auth, db).test_connection(id=id)
+    return SuccessResponse(data=result, msg="连接成功")
+
+
+@StorageSourceRouter.post("/test", summary="测试存储源连接(配置)", response_model=ResponseSchema[bool])
+async def test_storage_source_config_controller(
+    auth: Annotated[AuthSchema, Security(AuthPermission(["module_task:workflow:node:query"]))],
+    db: Annotated[AsyncSession, Depends(db_getter)],
+    data: Annotated[StorageSourceTestSchema, Body(description="存储源连接配置")],
+) -> JSONResponse:
+    result: bool = await StorageSourceService(auth, db).test_config(data=data)
+    return SuccessResponse(data=result, msg="连接成功")