docs[member]: swagger 문서에 출력되는 컨트롤러 순서 지정 코드 추가

Author: asowjdan

backend/src/main/java/com/ai/lawyer/global/springDoc/SpringDocConfig.java

@@ -4,10 +4,19 @@
 import io.swagger.v3.oas.annotations.enums.SecuritySchemeType;
 import io.swagger.v3.oas.annotations.info.Info;
 import io.swagger.v3.oas.annotations.security.SecurityScheme;
+import io.swagger.v3.oas.models.Operation;
+import io.swagger.v3.oas.models.PathItem;
+import org.springdoc.core.customizers.OpenApiCustomizer;
 import org.springdoc.core.models.GroupedOpenApi;
 import org.springframework.context.annotation.Bean;
 import org.springframework.context.annotation.Configuration;
 
+import java.util.Comparator;
+import java.util.LinkedHashMap;
+import java.util.Map;
+import java.util.regex.Matcher;
+import java.util.regex.Pattern;
+
 @Configuration
 @OpenAPIDefinition(info = @Info(title = "AI Lawyer API", version = "beta", description = "AI 변호사 서비스 API 문서입니다."))
 @SecurityScheme(
@@ -24,6 +33,7 @@ public GroupedOpenApi memberApi() {
                 .group("Member API")
                 .pathsToMatch("/api/auth/**")
                 .packagesToScan("com.ai.lawyer.domain.member.controller")
+                .addOpenApiCustomizer(orderBySummaryNumber())
                 .build();
     }
 
@@ -53,4 +63,33 @@ public GroupedOpenApi allApi() {
                 .packagesToScan("com.ai.lawyer.domain")
                 .build();
     }
+
+    private OpenApiCustomizer orderBySummaryNumber() {
+        return openApi -> {
+            if (openApi.getPaths() == null) return;
+
+            Map<String, PathItem> sortedPaths = new LinkedHashMap<>();
+
+            // 정렬을 위해 summary 안에 있는 번호 추출
+            Pattern pattern = Pattern.compile("^(\\d+)\\..*");
+
+            openApi.getPaths().entrySet().stream()
+                    .sorted(Comparator.comparingInt(e -> {
+                        PathItem pathItem = e.getValue();
+                        // POST, GET, 등등 중 첫 번째 Operation의 summary 사용
+                        Operation op = pathItem.readOperations().stream().findFirst().orElse(null);
+                        if (op == null || op.getSummary() == null) return Integer.MAX_VALUE;
+
+                        Matcher matcher = pattern.matcher(op.getSummary());
+                        if (matcher.find()) {
+                            return Integer.parseInt(matcher.group(1));
+                        }
+                        return Integer.MAX_VALUE;
+                    }))
+                    .forEachOrdered(entry -> sortedPaths.put(entry.getKey(), entry.getValue()));
+
+            openApi.setPaths(new io.swagger.v3.oas.models.Paths());
+            sortedPaths.forEach(openApi.getPaths()::addPathItem);
+        };
+    }
 }