后台添加swagger支持

2026-04-10 10:47:51 +08:00
parent b8d9aec4ca
commit c3308e069d
2 changed files with 1444 additions and 0 deletions
--- a/docs/superpowers/plans/2026-04-09-swagger-shiro-toggle.md
+++ b/docs/superpowers/plans/2026-04-09-swagger-shiro-toggle.md
--- a/src/main/java/com/label/common/config/OpenApiConfig.java
+++ b/src/main/java/com/label/common/config/OpenApiConfig.java
@@ -0,0 +1,33 @@
+package com.label.common.config;
+
+import io.swagger.v3.oas.models.Components;
+import io.swagger.v3.oas.models.OpenAPI;
+import io.swagger.v3.oas.models.info.Info;
+import io.swagger.v3.oas.models.security.SecurityRequirement;
+import io.swagger.v3.oas.models.security.SecurityScheme;
+import org.springframework.context.annotation.Bean;
+import org.springframework.context.annotation.Configuration;
+
+/**
+ * SpringDoc OpenAPI 全局配置：API 基本信息 + Bearer Token 安全方案。
+ */
+@Configuration
+public class OpenApiConfig {
+
+    @Bean
+    public OpenAPI openAPI() {
+        return new OpenAPI()
+                .info(new Info()
+                        .title("Label Backend API")
+                        .version("1.0.0")
+                        .description("知识图谱智能标注平台后端接口文档"))
+                .addSecurityItem(new SecurityRequirement().addList("BearerAuth"))
+                .components(new Components()
+                        .addSecuritySchemes("BearerAuth",
+                                new SecurityScheme()
+                                        .type(SecurityScheme.Type.HTTP)
+                                        .scheme("bearer")
+                                        .bearerFormat("UUID")
+                                        .description("登录后返回的 Token，格式：Bearer {uuid}")));
+    }
+}