feat: add article and production modules

2026-08-31 13:16:46 +08:00
parent ac3da246b2
commit 5c586a1a95
334 changed files with 34419 additions and 1 deletions
@@ -0,0 +1,87 @@
+<?php
+/**
+ * article 插件路由配置
+ * 使用 Swagger 注解自动生成路由
+ */
+
+use Webman\Route;
+use WebmanTech\Swagger\Swagger;
+use OpenApi\Annotations as OA;
+
+/**
+ * 注册 API 路由
+ */
+Route::group('/api', function () {
+    Swagger::create()->registerRoute([
+        'route_prefix'   => '/article/openapi',
+        'register_route' => true,
+        'openapi_doc'    => [
+            'scan_path' => [
+                base_path('plugin/article/app/api'),
+            ],
+            'modify'    => function (OA\OpenApi $openapi) {
+                $openapi->info->title   = '文章管理 API';
+                $openapi->info->version = '1.0.0';
+                $openapi->servers       = [
+                    new OA\Server(
+                        [
+                            'url'         => '/api',
+                            'description' => request()->host(),
+                        ]
+                    ),
+                ];
+                /** @phpstan-ignore-next-line */
+                if (!$openapi->components instanceof OA\Components) {
+                    $openapi->components = new OA\Components([]);
+                }
+                $openapi->components->securitySchemes = [
+                    new OA\SecurityScheme([
+                        'securityScheme' => 'api_key',
+                        'type'           => 'apiKey',
+                        'name'           => config('core.jwt.app.token_name', 'Authorization'),
+                        'in'             => 'header',
+                    ]),
+                ];
+            },
+        ],
+    ]);
+});
+
+/**
+ * 注册 AdminAPI 路由
+ */
+Route::group('/adminapi', function () {
+    Swagger::create()->registerRoute([
+        'route_prefix'   => '/article/openapi',
+        'register_route' => true,
+        'openapi_doc'    => [
+            'scan_path' => [
+                base_path('plugin/article/app/adminapi'),
+            ],
+            'modify'    => function (OA\OpenApi $openapi) {
+                $openapi->info->title   = '文章管理 API';
+                $openapi->info->version = '1.0.0';
+                $openapi->servers       = [
+                    new OA\Server(
+                        [
+                            'url'         => '/adminapi',
+                            'description' => request()->host(),
+                        ]
+                    ),
+                ];
+                /** @phpstan-ignore-next-line */
+                if (!$openapi->components instanceof OA\Components) {
+                    $openapi->components = new OA\Components([]);
+                }
+                $openapi->components->securitySchemes = [
+                    new OA\SecurityScheme([
+                        'securityScheme' => 'api_key',
+                        'type'           => 'apiKey',
+                        'name'           => config('core.jwt.app.token_name', 'Authorization'),
+                        'in'             => 'header',
+                    ]),
+                ];
+            },
+        ],
+    ]);
+});