Merge branch 'main' of https://git.devjun.net/AX-HUB/ax_hub_mcp_tool

build.gradle

@@ -1,60 +1,88 @@
+// 루트 Gradle 설정: 모든 Gateway/Tool Pod 모듈이 공유하는 빌드 기준을 정의합니다.
 plugins {
+    // Java 컴파일, 테스트, JAR 생성 기능을 제공합니다.
     id 'java'
-    id 'org.springframework.boot' version '4.0.5' apply false
+
+    // 하위 실행 모듈에서 bootRun/bootJar를 사용하기 위한 Spring Boot 플러그인입니다.
+    // 루트 프로젝트에는 적용하지 않으므로 apply false를 사용합니다.
+    id 'org.springframework.boot' version '3.5.11' apply false
+
+    // Spring Boot / Spring AI BOM에 정의된 라이브러리 버전을 일관되게 적용합니다.
     id 'io.spring.dependency-management' version '1.1.6' apply false
 }
 
+// 모든 모듈이 공유하는 Maven 식별자입니다.
 allprojects {
     group = 'io.shinhanlife'
     version = '0.0.1-SNAPSHOT'
 }
 
+// dap-gateway, dap-was-lib, dap-was-oth, dap-was-sms에 공통 적용합니다.
 subprojects {
     apply plugin: 'java'
     apply plugin: 'io.spring.dependency-management'
 
     java {
+        // 프로젝트 표준 Java 버전입니다.
         sourceCompatibility = '21'
     }
 
     repositories {
+        // 현재 공개 정식 라이브러리 저장소입니다.
+        // 폐쇄망 적용 시 사내 Nexus Proxy URL로 교체합니다.
         mavenCentral()
-        maven { url 'https://repo.spring.io/milestone' }
-        maven { url 'https://repo.spring.io/snapshot' }
     }
 
     dependencyManagement {
         imports {
+            // Spring Boot 3.5.11과 호환되는 Spring/Jackson/Tomcat 등의 버전을 관리합니다.
             mavenBom org.springframework.boot.gradle.plugin.SpringBootPlugin.BOM_COORDINATES
-            mavenBom "org.springframework.ai:spring-ai-bom:2.0.0"
+
+            // Spring AI, MCP, OpenAI 연동 라이브러리의 호환 버전을 1.1.8로 고정합니다.
+            mavenBom 'org.springframework.ai:spring-ai-bom:1.1.8'
         }
     }
 
     dependencies {
+        // Lombok은 컴파일 시 getter/builder 등 반복 코드를 생성하며 실행 JAR에는 포함하지 않습니다.
         compileOnly 'org.projectlombok:lombok:1.18.32'
         annotationProcessor 'org.projectlombok:lombok:1.18.32'
-        annotationProcessor 'org.projectlombok:lombok-mapstruct-binding:0.2.0'
+        testCompileOnly 'org.projectlombok:lombok:1.18.32'
+        testAnnotationProcessor 'org.projectlombok:lombok:1.18.32'
+
+        // Tool DTO와 MCI 요청/응답 객체 간 Converter 구현체를 컴파일 시 자동 생성합니다.
         implementation 'org.mapstruct:mapstruct:1.5.5.Final'
+        annotationProcessor 'org.projectlombok:lombok-mapstruct-binding:0.2.0'
         annotationProcessor 'org.mapstruct:mapstruct-processor:1.5.5.Final'
+
+        // 모든 모듈의 JUnit 5 기반 테스트 공통 의존성입니다.
         testImplementation 'org.springframework.boot:spring-boot-starter-test'
         testRuntimeOnly 'org.junit.platform:junit-platform-launcher'
     }
 
     tasks.withType(JavaCompile) {
+        // 리플렉션/MCP Schema 생성 시 메서드 파라미터명을 사용할 수 있도록 보존합니다.
         options.compilerArgs << '-parameters'
+
+        // MapStruct 구현체를 Spring Bean으로 생성해 생성자 주입으로 사용할 수 있게 합니다.
         options.compilerArgs << '-Amapstruct.defaultComponentModel=spring'
     }
 
     tasks.withType(Test) {
+        // JUnit 5 테스트 플랫폼을 사용합니다.
         useJUnitPlatform()
     }
 }
 
+// Tool 이름 중복 검사 프로그램이 포함된 공통 라이브러리 모듈입니다.
 def toolCoreProject = project(':dap-was-lib')
 
+// 전체 Tool Pod의 @McpTool(name) 중복을 배포 산출물 생성 전에 차단합니다.
 tasks.register('validateMcpToolNames', JavaExec) {
     group = 'verification'
-    description = 'Checks duplicate @McpFunction names across all Tool modules before packaging.'
+    description = 'Checks duplicate @McpTool names across all Tool modules before packaging.'
+
+    // 검사 Runner를 실행하기 전에 dap-was-lib 클래스를 먼저 컴파일합니다.
     dependsOn toolCoreProject.tasks.named('classes')
     classpath = toolCoreProject.sourceSets.main.runtimeClasspath
     mainClass.set('io.shinhanlife.dap.lib.validation.McpToolNameValidationRunner')
@@ -62,7 +90,8 @@ tasks.register('validateMcpToolNames', JavaExec) {
 }
 
 subprojects {
+    // 배포용 Spring Boot JAR 생성 전에 Tool 이름 중복 검증을 강제합니다.
     tasks.matching { it.name == 'bootJar' }.configureEach {
         dependsOn rootProject.tasks.named('validateMcpToolNames')
     }
-}
+}

dap-was-lib/build.gradle

@@ -1,50 +1,55 @@
 plugins {
+    // Gateway와 모든 Tool Pod가 의존하는 공통 라이브러리 모듈입니다.
     id 'java-library'
 }
 
 dependencies {
+    // 공통 REST Controller, HTTP Client, 예외 처리 기반입니다.
     api 'org.springframework.boot:spring-boot-starter-web'
+
+    // Tool Request DTO의 Bean Validation을 지원합니다.
     api 'org.springframework.boot:spring-boot-starter-validation'
+
+    // Tool Manifest/Registry 캐시 및 Redis 기반 공통 기능을 제공합니다.
     api 'org.springframework.boot:spring-boot-starter-data-redis'
-    
+
+    // Tool SLA, 로깅, 공통 Aspect를 적용합니다.
+    api 'org.springframework.boot:spring-boot-starter-aop'
+
+    // MCI/DB 연동에 필요한 JDBC 공통 기능입니다.
+    api 'org.springframework.boot:spring-boot-starter-jdbc'
+
+    // Tool 호출의 Circuit Breaker, Rate Limit, Retry 등 복원력 기능입니다.
     api 'io.github.resilience4j:resilience4j-spring-boot3:2.2.0'
     api 'io.github.resilience4j:resilience4j-core:2.2.0'
     api 'io.github.resilience4j:resilience4j-circuitbreaker:2.2.0'
     api 'io.github.resilience4j:resilience4j-ratelimiter'
     api 'io.github.resilience4j:resilience4j-retry:2.2.0'
-    api 'org.springframework.boot:spring-boot-starter-aop:3.3.0'
 
-    api 'org.springframework.boot:spring-boot-starter-jdbc'
+    // MCI/업무 데이터 접근을 위한 MyBatis 지원입니다.
     api 'org.mybatis.spring.boot:mybatis-spring-boot-starter:3.0.3'
+
+    // 현재 로컬 테스트 DB 및 SQL 로그 처리에 사용합니다.
     api 'com.h2database:h2'
     api 'p6spy:p6spy:3.9.1'
+
+    // Spring Data Redis가 사용하는 Redis Client를 공통 모듈에서 직접 참조합니다.
     api 'io.lettuce:lettuce-core:6.6.0.RELEASE'
 
-    api "org.mapstruct:mapstruct:1.5.5.Final"
+    // MCI XML 전문, JSON Tool Schema/Manifest 처리에 사용합니다.
-    
     api 'com.fasterxml.jackson.dataformat:jackson-dataformat-xml:2.17.1'
     api 'com.fasterxml.jackson.core:jackson-databind:2.17.1'
     api 'com.networknt:json-schema-validator:3.0.0'
+
+    // Tool Pod의 /mcp Streamable HTTP Server와 MCP SDK를 제공합니다.
     api 'org.springframework.ai:spring-ai-starter-mcp-server-webmvc'
+
+    // Spring AI 1.1.x에서 @McpTool, @McpToolParam, metaProvider를 제공합니다.
+    api 'org.springaicommunity:mcp-annotations:0.9.0'
+
+    // 이벤트 기반 확장이 필요한 Tool의 공통 Kafka 연동 기능입니다.
     api 'org.springframework.kafka:spring-kafka:3.2.0'
+
+    // Tool Pod REST API 문서 및 Swagger UI를 제공합니다.
     api 'org.springdoc:springdoc-openapi-starter-webmvc-ui:2.5.0'
 }
-
-dependencies {
-    compileOnly 'org.projectlombok:lombok:1.18.32'
-    annotationProcessor 'org.projectlombok:lombok:1.18.32'
-    
-    testImplementation 'org.springframework.boot:spring-boot-starter-test'
-    testCompileOnly 'org.projectlombok:lombok:1.18.32'
-    testAnnotationProcessor 'org.projectlombok:lombok:1.18.32'
-}
-
-
-jar {
-    enabled = true
-}
-
-tasks.matching { it.name == 'bootJar' }.configureEach {
-    enabled = false
-}
-

dap-was-oth/build.gradle

@@ -1,12 +1,9 @@
 plugins {
+    // OTH Tool Pod를 독립 실행 가능한 Spring Boot JAR로 생성합니다.
     id 'org.springframework.boot'
 }
 
 dependencies {
+    // MCP Server, Tool 공통 처리, MCI/EAI 연동 기반은 dap-was-lib에서 상속합니다.
     implementation project(':dap-was-lib')
 }
-
-dependencies {
-    compileOnly 'org.projectlombok:lombok:1.18.32'
-    annotationProcessor 'org.projectlombok:lombok:1.18.32'
-}

dap-was-sms/build.gradle

@@ -1,12 +1,9 @@
 plugins {
+    // SMS Tool Pod를 독립 실행 가능한 Spring Boot JAR로 생성합니다.
     id 'org.springframework.boot'
 }
 
 dependencies {
+    // MCP Server, Tool 공통 처리, MCI/EAI 연동 기반은 dap-was-lib에서 상속합니다.
     implementation project(':dap-was-lib')
 }
-
-dependencies {
-    compileOnly 'org.projectlombok:lombok:1.18.32'
-    annotationProcessor 'org.projectlombok:lombok:1.18.32'
-}