unify controller dir: migrate api/v1 to Api/V1, remove PSR-4 workaround

2026-04-15 09:41:51 +08:00
parent e925ec76dc
commit 4809ad03e4
11 changed files with 0 additions and 1 deletions
@@ -0,0 +1,63 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Controller\Api\V1;
+
+use App\Controller\AbstractController;
+use App\Middleware\AuthMiddleware;
+use App\Middleware\PermissionMiddleware;
+use App\Model\Platform;
+use Hyperf\HttpServer\Annotation\Controller;
+use Hyperf\HttpServer\Annotation\Middleware;
+use Hyperf\HttpServer\Annotation\RequestMapping;
+use OpenApi\Attributes as OA;
+
+#[OA\Tag(name: 'Platforms', description: '平台管理')]
+#[Controller(prefix: "/api/v1/platforms")]
+class PlatformController extends AbstractController
+{
+    /**
+     * 平台列表（全局数据，不过滤）
+     */
+    #[OA\Get(
+        path: '/platforms',
+        summary: '平台列表',
+        description: '获取全部平台列表（全局数据，不过滤）',
+        security: [['bearerAuth' => []]],
+        tags: ['Platforms'],
+        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', type: 'array', items: new OA\Items(
+                        properties: [
+                            new OA\Property(property: 'id', type: 'integer', example: 1),
+                            new OA\Property(property: 'developer_id', type: 'integer', example: 1),
+                            new OA\Property(property: 'created_at', type: 'string', format: 'date-time'),
+                            new OA\Property(property: 'updated_at', type: 'string', format: 'date-time'),
+                        ],
+                        type: 'object'
+                    )),
+                ])
+            ),
+            new OA\Response(response: 401, description: '未认证', content: new OA\JsonContent(ref: '#/components/schemas/ErrorResponse')),
+        ]
+    )]
+    #[RequestMapping(path: "", methods: "GET")]
+    #[Middleware(AuthMiddleware::class)]
+    #[Middleware(PermissionMiddleware::class)]
+    public function index(): array
+    {
+        $platforms = Platform::query()->orderBy('id')->get();
+
+        return [
+            'code' => 0,
+            'message' => '获取成功',
+            'data' => $platforms,
+        ];
+    }
+}