update route service

backend/app/Controller/api/v1/RouteGroupController.php

@@ -9,6 +9,7 @@ use App\Middleware\AuthMiddleware;
 use App\Middleware\PermissionMiddleware;
 use App\Model\Route;
 use App\Model\RouteGroup;
+use App\Service\RouteSyncService;
 use Hyperf\DbConnection\Db;
 use Hyperf\HttpServer\Annotation\Controller;
 use Hyperf\HttpServer\Annotation\Middleware;
@@ -641,4 +642,46 @@ class RouteGroupController extends AbstractController
             'data' => $group,
         ];
     }
+
+    /**
+     * 同步注解路由到数据库
+     *
+     * 将 Hyperf 注解定义的 API 路由同步到 routes 表，管理员专用
+     */
+    #[OA\Post(
+        path: '/routes/sync',
+        summary: '同步注解路由到数据库',
+        description: '将 Hyperf 注解定义的 API 路由同步到 routes 表，支持重复调用（幂等）',
+        security: [['bearerAuth' => []]],
+        tags: ['Route Groups'],
+        responses: [
+            new OA\Response(
+                response: 200,
+                description: '同步成功',
+                content: new OA\JsonContent(properties: [
+                    new OA\Property(property: 'code', type: 'integer', example: 0),
+                    new OA\Property(property: 'message', type: 'string', example: '同步成功'),
+                    new OA\Property(property: 'data', properties: [
+                        new OA\Property(property: 'synced', type: 'integer', description: '同步的路由数量', example: 50),
+                        new OA\Property(property: 'total', type: 'integer', description: '总路由数量', example: 50),
+                    ], type: 'object'),
+                ])
+            ),
+            new OA\Response(response: 401, description: '未认证', content: new OA\JsonContent(ref: '#/components/schemas/ErrorResponse')),
+            new OA\Response(response: 403, description: '无权限', content: new OA\JsonContent(ref: '#/components/schemas/ErrorResponse')),
+        ]
+    )]
+    #[RequestMapping(path: "/api/v1/routes/sync", methods: "POST")]
+    #[Middleware(AuthMiddleware::class)]
+    #[Middleware(PermissionMiddleware::class)]
+    public function sync(): array
+    {
+        $result = $this->container->get(RouteSyncService::class)->sync();
+
+        return [
+            'code' => 0,
+            'message' => '同步成功',
+            'data' => $result,
+        ];
+    }
 }