Optimize routes to better align with RESTful (#673)

* Optimize routes to better align with RESTful

* Add codes endpoint description

* Update jinja templates

* fix typo

* fix sql

backend/app/task/api/v1/task.py

@@ -14,12 +14,6 @@ from backend.common.security.rbac import DependsRBAC
 router = APIRouter()
 
 
-@router.get('', summary='获取可执行任务', dependencies=[DependsJwtAuth])
-async def get_all_tasks() -> ResponseSchemaModel[list[str]]:
-    tasks = await task_service.get_list()
-    return response_base.success(data=tasks)
-
-
 @router.get(
     '/{tid}',
     summary='获取任务详情',
@@ -27,12 +21,18 @@ async def get_all_tasks() -> ResponseSchemaModel[list[str]]:
     description='此接口被视为作废，建议使用 flower 查看任务详情',
     dependencies=[DependsJwtAuth],
 )
-async def get_task_detail(tid: Annotated[str, Path(description='任务 UUID')]) -> ResponseSchemaModel[TaskResult]:
-    status = task_service.get_detail(tid=tid)
+async def get_task(tid: Annotated[str, Path(description='任务 UUID')]) -> ResponseSchemaModel[TaskResult]:
+    status = task_service.get(tid=tid)
     return response_base.success(data=status)
 
 
-@router.post(
+@router.get('', summary='获取所有任务', dependencies=[DependsJwtAuth])
+async def get_all_tasks() -> ResponseSchemaModel[list[str]]:
+    tasks = await task_service.get_all()
+    return response_base.success(data=tasks)
+
+
+@router.delete(
     '/{tid}',
     summary='撤销任务',
     dependencies=[
@@ -46,8 +46,8 @@ async def revoke_task(tid: Annotated[str, Path(description='任务 UUID')]) -> R
 
 
 @router.post(
-    '',
-    summary='执行任务',
+    '/runs',
+    summary='运行任务',
     dependencies=[
         Depends(RequestPermission('sys:task:run')),
         DependsRBAC,

backend/app/task/service/task_service.py

@@ -11,16 +11,7 @@ from backend.common.exception import errors
 
 class TaskService:
     @staticmethod
-    async def get_list() -> list[str]:
-        """获取所有已注册的 Celery 任务列表"""
-        registered_tasks = await run_in_threadpool(celery_app.control.inspect().registered)
-        if not registered_tasks:
-            raise errors.ForbiddenError(msg='Celery 服务未启动')
-        tasks = list(registered_tasks.values())[0]
-        return tasks
-
-    @staticmethod
-    def get_detail(*, tid: str) -> TaskResult:
+    def get(*, tid: str) -> TaskResult:
         """
         获取指定任务的详细信息
 
@@ -43,6 +34,15 @@ class TaskService:
             queue=result.queue,
         )
 
+    @staticmethod
+    async def get_all() -> list[str]:
+        """获取所有已注册的 Celery 任务列表"""
+        registered_tasks = await run_in_threadpool(celery_app.control.inspect().registered)
+        if not registered_tasks:
+            raise errors.ForbiddenError(msg='Celery 服务未启动')
+        tasks = list(registered_tasks.values())[0]
+        return tasks
+
     @staticmethod
     def revoke(*, tid: str) -> None:
         """