update backend route group

2026-03-23 16:24:17 +08:00
parent f5847b392c
commit b97fd3f59b
4 changed files with 424 additions and 1 deletions
@@ -54,6 +54,9 @@ class AppInstall extends HyperfCommand
                $this->line('Fixed: username corrected to "administrator".', 'info');
            }

+            $this->call('route:sync');
+            $this->call('route-group:seed');
+
            return 0;
        }

@@ -81,8 +84,11 @@ class AppInstall extends HyperfCommand
            $this->line('');
            $this->warn('Please change the default password after first login!');

+            $this->call('route:sync');
+            $this->call('route-group:seed');
+
            return 0;
-        } catch (\Exception $e) {
+        } catch (\Throwable $e) {
            $this->error('Failed to create admin user: ' . $e->getMessage());
            return 1;
        }
@@ -0,0 +1,71 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Command;
+
+use App\Model\Route;
+use App\Model\RouteGroup;
+use Hyperf\Command\Annotation\Command;
+use Hyperf\Command\Command as HyperfCommand;
+use Psr\Container\ContainerInterface;
+
+#[Command]
+class RouteGroupSeedCommand extends HyperfCommand
+{
+    public function __construct(protected ContainerInterface $container)
+    {
+        parent::__construct('route-group:seed');
+    }
+
+    public function configure(): void
+    {
+        parent::configure();
+        $this->setDescription('创建默认路由组并按前缀自动分配路由');
+    }
+
+    public function handle(): void
+    {
+        $default_groups = [
+            ['name' => 'store-management',    'label' => '店铺管理',   'sort_order' => 1,  'patterns' => ['/api/v1/stores']],
+            ['name' => 'company-management',  'label' => '公司管理',   'sort_order' => 2,  'patterns' => ['/api/v1/companies']],
+            ['name' => 'product-management',  'label' => '产品管理',   'sort_order' => 3,  'patterns' => ['/api/v1/products']],
+            ['name' => 'order-management',    'label' => '订单管理',   'sort_order' => 4,  'patterns' => ['/api/v1/orders', '/api/v1/order-items']],
+            ['name' => 'refund-management',   'label' => '退款管理',   'sort_order' => 5,  'patterns' => ['/api/v1/refunds', '/api/v1/refund-items']],
+            ['name' => 'raw-data',            'label' => '原始数据',   'sort_order' => 6,  'patterns' => ['/api/v1/raw/']],
+            ['name' => 'log-management',      'label' => '日志管理',   'sort_order' => 7,  'patterns' => ['/api/v1/logs/']],
+            ['name' => 'user-permission',     'label' => '用户与权限', 'sort_order' => 8,  'patterns' => ['/api/v1/users', '/api/v1/roles', '/api/v1/route-groups', '/api/v1/routes']],
+            ['name' => 'platform-management', 'label' => '平台管理',   'sort_order' => 9,  'patterns' => ['/api/v1/platforms']],
+            ['name' => 'system',              'label' => '系统功能',   'sort_order' => 10, 'patterns' => ['/api/v1/me/', '/api/v1/dashboard', '/api/v1/mq', '/api/v1/failed-messages', '/api/v1/auth/']],
+        ];
+
+        $group_count = 0;
+        $route_count = 0;
+
+        foreach ($default_groups as $config) {
+            $patterns = $config['patterns'];
+            unset($config['patterns']);
+
+            $group = RouteGroup::query()->updateOrCreate(
+                ['name' => $config['name']],
+                ['label' => $config['label'], 'sort_order' => $config['sort_order']]
+            );
+            $group_count++;
+
+            // 按前缀匹配路由并分配到组
+            foreach ($patterns as $pattern) {
+                $affected = Route::query()
+                    ->where('path', 'like', $pattern . '%')
+                    ->update(['group_id' => $group->id]);
+                $route_count += $affected;
+            }
+        }
+
+        $this->info("Seeded {$group_count} route groups, assigned {$route_count} routes.");
+
+        $unassigned = Route::query()->whereNull('group_id')->count();
+        if ($unassigned > 0) {
+            $this->warn("Warning: {$unassigned} routes remain unassigned.");
+        }
+    }
+}
@@ -9,6 +9,7 @@ use App\Middleware\AuthMiddleware;
 use App\Middleware\PermissionMiddleware;
 use App\Model\Route;
 use App\Model\RouteGroup;
+use Hyperf\DbConnection\Db;
 use Hyperf\HttpServer\Annotation\Controller;
 use Hyperf\HttpServer\Annotation\Middleware;
 use Hyperf\HttpServer\Annotation\RequestMapping;
@@ -552,4 +553,92 @@ class RouteGroupController extends AbstractController
            'data' => $route,
        ];
    }
+
+    /**
+     * 批量同步路由到路由组
+     *
+     * 替换式同步：先清空旧归属，再设置新归属，事务保证原子性
+     *
+     * @param int $id 路由组 ID
+     */
+    #[OA\Put(
+        path: '/route-groups/{id}/routes',
+        summary: '批量同步路由到路由组',
+        description: '替换式同步：提交 route_ids 数组，组内路由将被完全替换为指定路由。提交空数组清空组内所有路由。若指定路由已属于其他组，将自动从原组移出。',
+        security: [['bearerAuth' => []]],
+        tags: ['Route Groups'],
+        parameters: [
+            new OA\Parameter(name: 'id', in: 'path', required: true, description: '路由组 ID', schema: new OA\Schema(type: 'integer')),
+        ],
+        requestBody: new OA\RequestBody(
+            required: true,
+            content: new OA\JsonContent(
+                required: ['route_ids'],
+                properties: [
+                    new OA\Property(property: 'route_ids', type: 'array', items: new OA\Items(type: 'integer'), description: '路由 ID 数组，空数组表示清空', example: [1, 2, 3]),
+                ]
+            )
+        ),
+        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: 'id', type: 'integer', example: 1),
+                        new OA\Property(property: 'name', type: 'string', example: 'user-management'),
+                        new OA\Property(property: 'label', type: 'string', nullable: true, example: '用户管理'),
+                        new OA\Property(property: 'routes_count', type: 'integer', example: 5),
+                    ], type: 'object'),
+                ])
+            ),
+            new OA\Response(response: 401, description: '未认证', content: new OA\JsonContent(ref: '#/components/schemas/ErrorResponse')),
+            new OA\Response(response: 404, description: '路由组不存在', content: new OA\JsonContent(ref: '#/components/schemas/ErrorResponse')),
+            new OA\Response(response: 422, description: '参数校验失败', content: new OA\JsonContent(ref: '#/components/schemas/ErrorResponse')),
+        ]
+    )]
+    #[RequestMapping(path: "{id}/routes", methods: "PUT")]
+    #[Middleware(AuthMiddleware::class)]
+    #[Middleware(PermissionMiddleware::class)]
+    public function syncRoutes(int $id): ResponseInterface|array
+    {
+        $group = RouteGroup::query()->find($id);
+
+        if (!$group) {
+            return $this->response->json([
+                'code' => 404,
+                'message' => '路由组不存在',
+            ])->withStatus(404);
+        }
+
+        $body = $this->request->getParsedBody();
+        if (!array_key_exists('route_ids', $body) || !is_array($body['route_ids'])) {
+            return $this->response->json([
+                'code' => 422,
+                'message' => 'route_ids 必须为数组',
+            ])->withStatus(422);
+        }
+
+        $route_ids = array_values(array_map('intval', array_filter($body['route_ids'], 'is_numeric')));
+
+        Db::transaction(function () use ($id, $route_ids): void {
+            // 清空旧归属
+            Route::query()->where('group_id', $id)->update(['group_id' => null]);
+
+            // 设置新归属
+            if ($route_ids !== []) {
+                Route::query()->whereIn('id', $route_ids)->update(['group_id' => $id]);
+            }
+        });
+
+        $group->loadCount('routes');
+
+        return [
+            'code' => 0,
+            'message' => '同步成功',
+            'data' => $group,
+        ];
+    }
 }