[URECA-56] Feat: 스웨거 문서 정리

src/main/java/com/ureca/unity/domain/auth/controller/AuthSessionController.java

@@ -2,12 +2,17 @@
 
 import com.ureca.unity.domain.auth.dto.MeResponse;
 import com.ureca.unity.domain.auth.service.AuthSessionService;
+import io.swagger.v3.oas.annotations.tags.Tag;
 import jakarta.servlet.http.HttpServletRequest;
 import lombok.RequiredArgsConstructor;
 import org.springframework.web.bind.annotation.GetMapping;
 import org.springframework.web.bind.annotation.RequestMapping;
 import org.springframework.web.bind.annotation.RestController;
 
+@Tag(
+        name = "1. Auth",
+        description = "회원가입 및 로그인 관련 API"
+)
 @RestController
 @RequestMapping("/api/auth")
 @RequiredArgsConstructor

src/main/java/com/ureca/unity/domain/auth/controller/LogoutController.java

@@ -2,12 +2,17 @@
 
 import com.ureca.unity.domain.auth.service.LogoutService;
 import com.ureca.unity.global.util.CookieUtils;
+import io.swagger.v3.oas.annotations.tags.Tag;
 import jakarta.servlet.http.HttpServletResponse;
 import lombok.RequiredArgsConstructor;
 import org.springframework.beans.factory.annotation.Value;
 import org.springframework.http.HttpStatus;
 import org.springframework.web.bind.annotation.*;
 
+@Tag(
+        name = "1. Auth",
+        description = "회원가입 및 로그인 관련 API"
+)
 @RestController
 @RequestMapping("/api/auth")
 @RequiredArgsConstructor

src/main/java/com/ureca/unity/domain/auth/controller/OAuthController.java

@@ -6,6 +6,7 @@
 import com.ureca.unity.domain.auth.dto.OAuthLoginResult;
 import com.ureca.unity.domain.auth.service.OAuthService;
 import com.ureca.unity.global.util.CookieUtils;
+import io.swagger.v3.oas.annotations.tags.Tag;
 import jakarta.servlet.http.Cookie;
 import jakarta.servlet.http.HttpServletResponse;
 import jakarta.validation.constraints.NotBlank;
@@ -14,6 +15,10 @@
 import org.springframework.validation.annotation.Validated;
 import org.springframework.web.bind.annotation.*;
 
+@Tag(
+        name = "1. Auth",
+        description = "회원가입 및 로그인 관련 API"
+)
 @RestController
 @RequestMapping("/api/auth")
 @RequiredArgsConstructor

src/main/java/com/ureca/unity/domain/auth/controller/RefreshTokenController.java

@@ -2,11 +2,16 @@
 
 import com.ureca.unity.domain.auth.dto.TokenResponse;
 import com.ureca.unity.domain.auth.service.RefreshTokenService;
+import io.swagger.v3.oas.annotations.tags.Tag;
 import jakarta.servlet.http.HttpServletRequest;
 import jakarta.servlet.http.HttpServletResponse;
 import lombok.RequiredArgsConstructor;
 import org.springframework.web.bind.annotation.*;
 
+@Tag(
+        name = "1. Auth",
+        description = "회원가입 및 로그인 관련 API"
+)
 @RestController
 @RequestMapping("/api/auth")
 @RequiredArgsConstructor

src/main/java/com/ureca/unity/domain/example/controller/ExampleController.java

@@ -2,12 +2,14 @@
 
 import com.ureca.unity.domain.example.dto.response.ExampleResponse;
 import com.ureca.unity.domain.example.service.ExampleService;
+import io.swagger.v3.oas.annotations.tags.Tag;
 import lombok.RequiredArgsConstructor;
 import org.springframework.web.bind.annotation.GetMapping;
 import org.springframework.web.bind.annotation.RestController;
 
 import java.util.List;
 
+@Tag(name = "2. Exam")
 @RestController
 @RequiredArgsConstructor
 public class ExampleController {

src/main/java/com/ureca/unity/domain/stt/controller/SttController.java

@@ -2,9 +2,14 @@
 
 import com.ureca.unity.domain.stt.model.SttJob;
 import com.ureca.unity.domain.stt.service.SttService;
+import io.swagger.v3.oas.annotations.tags.Tag;
 import lombok.RequiredArgsConstructor;
 import org.springframework.web.bind.annotation.*;
 
+@Tag(
+        name = "3. STT",
+        description = "음성 인식(STT) API"
+)
 @RestController
 @RequiredArgsConstructor
 @RequestMapping("/counselings")

src/main/java/com/ureca/unity/domain/summary/controller/SummaryController.java

@@ -3,10 +3,16 @@
 import com.ureca.unity.domain.summary.dto.request.SummaryRequest;
 import com.ureca.unity.domain.summary.dto.response.SummaryResponse;
 import com.ureca.unity.domain.summary.service.SummaryService;
+import io.swagger.v3.oas.annotations.tags.Tag;
 import jakarta.validation.Valid;
 import lombok.RequiredArgsConstructor;
 import org.springframework.web.bind.annotation.*;
 
+@Tag(
+        name = "4. Summary",
+        description = "요약 관련 API"
+)
+
 @RestController
 @RequiredArgsConstructor
 @RequestMapping("/api/summaries")

src/main/java/com/ureca/unity/domain/user/controller/UserController.java

@@ -2,13 +2,18 @@
 
 import com.ureca.unity.domain.user.service.UserService;
 import com.ureca.unity.global.util.CookieUtils;
+import io.swagger.v3.oas.annotations.tags.Tag;
 import jakarta.servlet.http.HttpServletResponse;
 import lombok.RequiredArgsConstructor;
 import org.springframework.beans.factory.annotation.Value;
 import org.springframework.http.HttpStatus;
 import org.springframework.security.core.Authentication;
 import org.springframework.web.bind.annotation.*;
 
+@Tag(
+        name = "1. Auth",
+        description = "회원가입 및 로그인 관련 API"
+)
 @RestController
 @RequestMapping("/api/users")
 @RequiredArgsConstructor

src/main/java/com/ureca/unity/global/config/SwaggerConfig.java

@@ -0,0 +1,36 @@
+package com.ureca.unity.global.config;
+
+import io.swagger.v3.oas.models.OpenAPI;
+import io.swagger.v3.oas.models.Components;
+import io.swagger.v3.oas.models.security.SecurityScheme;
+import io.swagger.v3.oas.models.security.SecurityRequirement;
+import org.springframework.context.annotation.Bean;
+import org.springframework.context.annotation.Configuration;
+
+import java.util.List;
+
+@Configuration
+public class SwaggerConfig {
+
+    @Bean
+    public OpenAPI openAPI() {
+        return new OpenAPI()
+                .tags(List.of(
+                        new io.swagger.v3.oas.models.tags.Tag().name("1. Auth"),
+                        new io.swagger.v3.oas.models.tags.Tag().name("2. Exam"),
+                        new io.swagger.v3.oas.models.tags.Tag().name("3. STT"),
+                        new io.swagger.v3.oas.models.tags.Tag().name("4. Summary")
+                ))
+                .components(new Components()
+                        .addSecuritySchemes("bearerAuth",
+                                new SecurityScheme()
+                                        .type(SecurityScheme.Type.HTTP)
+                                        .scheme("bearer")
+                                        .bearerFormat("JWT")
+                        )
+                )
+                .addSecurityItem(
+                        new SecurityRequirement().addList("bearerAuth")
+                );
+    }
+}

src/main/resources/application.yml

@@ -34,11 +34,13 @@ springdoc:
   swagger-ui:
     enabled: true
     path: /swagger-ui.html
+    tags-sorter: alpha
+    operations-sorter: alpha
   api-docs:
     path: /v3/api-docs
 
 cors:
-  allowed-origins: http://localhost:3000
+  allowed-origins: ${CORS_ALLOWED_ORIGINS:http://localhost:3000}
 
 cookie:
-  secure: false
+  secure: ${COOKIE_SECURE:false}