Merge branch 'main' of https://git.devjun.net/kimhyungsik/ax_hub_mcp_tool into DEV-SRTEST

This reverts commit a46943ca23.

.agents/AGENTS.md

@@ -5,9 +5,10 @@
 
 ##  개발 가이드라인
 * 패키지명은 `controller` 대신 `presentation`을 사용합니다.
-* MapStruct 사용 시, 테스트 환경 에러를 방지하기 위해 생성자(`new ...Impl()`) 대신 `Mappers.getMapper(인터페이스명.class)` 방식으로 인스턴스를 가져옵니다.
+* MapStruct 사용 시, Spring DI를 활용하여 의존성 주입(`private final Converter converter;`)을 받는 방식을 권장합니다. (단위 테스트 시에는 `@MockBean` 또는 직접 구현체를 주입하여 테스트)
 
 ##  명심해야 할 규칙 추가란
+* `application.yml` 등 설정 파일 수정 시 한글이 깨지지 않도록 항상 UTF-8 인코딩을 유지하고, 깨진 문자열(`?\uFFFD` 등)이 발생하지 않도록 각별히 주의한다.
 * 이모지는 무조건 넣지 않는다
 * import 할것 무조건 한다
 * Git commit과 push는 사용자의 명시적인 허락(지시) 없이는 절대 수행하지 않는다.
@@ -16,13 +17,13 @@
  * @package io.shinhanlife.axhub.biz.mcp.tool.sms
  * @className AxHubToolSmsApplication
  * @description AX HUB 시스템 처리 클래스
- * @author 김형식
+ * @author 0986406
  * @create 2026.09.01
  * <pre>
  * ---------- 개정이력 ----------
  * 수정일      수정자    수정내용
  * ---------- -------- ---------------------------
- * 2026.09.01  김형식    최초생성
+ * 2026.09.01  0986406    최초생성
  * 
  * </pre>
  */
@@ -30,3 +31,9 @@
   * 현재 개발 대상은 **대내MCI / EAI (JSON)** 연동으로 한정한다. (대외MCI FixedLength 연동은 범위에서 제외)
   * 통신 노선, 데이터 변환 규격, 시스템별 연계 방식 등은 MCI/EIMS 상에서 관리되므로 코드 레벨에서 식별하거나 분기 처리하지 않는다. (단순 통합 JSON 요청만 수행)
   * 처리계 UI ↔ 처리계 AP 구간: `HTTPS` / `SSV`를 사용하며, FW에서 x-api를 통해 SSV↔DTO 변환을 수행한다.
+
+* 신한라이프 표준 로그 기준 (Logback 설정):
+  * **로그 생성 경로:** `/swlog/어플리케이션명(모듈명)/코드명/` (예: `/swlog/dap-gateway/A01/`)
+  * **로그 네이밍 규칙:** `${HOSTNAME}_코드명_yyyyMMdd.log` (예: `${HOSTNAME}_A01_20260722.log`)
+  * **기본 로그 구분 코드:** 시스템 운영기록 가동기록의 경우 `A01`을 기본으로 사용한다.
+  * **호스트명 동적 할당:** Logback 설정 시 `<property name="HOSTNAME" value="${HOSTNAME}" />` 를 선언하여 사용한다.

.dockerignore

@@ -0,0 +1,10 @@
+.git
+.gradle
+.idea
+/build/
+target/
+*/target/
+bin/
+*/bin/
+out/
+*/out/

.gitea/workflows/deploy.yml

@@ -0,0 +1,67 @@
+name: Deploy to OCIWP
+
+on:
+  push:
+    branches:
+      - main
+      - master
+  workflow_dispatch:
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    steps:
+
+      - name: Prepare Environment (Install Node.js & Git & Java 21)
+        run: |
+          if command -v apt-get &> /dev/null; then
+            apt-get update
+            apt-get install -y nodejs git openjdk-21-jdk rsync
+          elif command -v apk &> /dev/null; then
+            apk add --no-cache nodejs git openjdk21 rsync
+          fi
+
+      - name: Checkout Code
+        uses: actions/checkout@v3
+
+      - name: Sync Code to Host Volume
+        run: |
+          echo "Copying latest code to /app (Host Volume) and removing stale files..."
+          if command -v rsync &> /dev/null; then
+            rsync -a --delete --exclude='.git' . /app/
+          else
+            rm -rf /app/dap-* /app/src /app/build.gradle /app/settings.gradle
+            cp -a . /app/
+          fi
+
+      - name: Deploy Task on Host
+        run: |
+          echo "Starting Standard CI/CD Deploy pipeline..."
+          
+          # 1. runner에 설치된 java로 직접 빌드! (격리된 환경 문제 해결)
+          cd /app
+          chmod +x gradlew
+          ./gradlew bootJar -x test
+          
+          # 2. 빌드 결과 plain jar 아카이브 정리
+          find /app -name "*-plain.jar" -delete
+          
+          # 3. 좀비 컨테이너 청소 (현재 우리가 쓸 포트를 점유 중인 옛날 컨테이너들만 정확히 색출해서 사살)
+          echo "Finding and killing zombie containers holding our ports..."
+          for port in 6379 8080 8089 8281 8282 8283 8284 8285 8288; do
+            cid=$(docker ps -q --filter "publish=$port")
+            if [ ! -z "$cid" ]; then
+              echo "Force killing container $cid using port $port"
+              docker rm -f $cid
+            fi
+          done
+
+          # 4. 마운트된 /app 디렉토리로 이동하여 호스트의 도커 컴포즈 제어!
+          cd /app
+          docker system prune -f
+          ACTIVE_PROFILE=dev docker compose up -d --build --remove-orphans gateway redis mci-mock dozzle tool-sms tool-oth
+          
+          # 5. 배포 후 대롱대롱 매달려 있는 가비지 이미지 자동 소거 청소!
+          docker image prune -f
+          
+          echo "CI/CD Deploy Success!"

.gitignore

@@ -56,11 +56,69 @@ build/
 # ===== VS Code =====
 .vscode/
 
+# ===== 鍮뚮뱶 寃곌낵臾?=====
+target/
+!**/src/main/**/target/
+!**/src/test/**/target/
+*.class
+*.jar
+!gradle/wrapper/gradle-wrapper.jar
+*.war
+*.ear
+*.nar
+
+# ===== 濡쒓렇 =====
+*.log
+logs/
+spring-shell.log
+
+# ===== Maven =====
+.mvn/wrapper/maven-wrapper.jar
+pom.xml.tag
+pom.xml.releaseBackup
+pom.xml.versionsBackup
+pom.xml.next
+release.properties
+dependency-reduced-pom.xml
+buildNumber.properties
+.mvn/timing.properties
+
+# ===== IntelliJ IDEA =====
+.idea/
+*.iws
+*.iml
+*.ipr
+out/
+
+# ===== Eclipse / STS =====
+.apt_generated
+.classpath
+.factorypath
+.project
+.settings
+.springBeans
+.sts4-cache
+bin/
+
+# ===== NetBeans =====
+/nbproject/private/
+/nbbuild/
+/dist/
+/nbdist/
+/.nb-gradle/
+build/
+.gradle/
+!**/src/main/**/build/
+!**/src/test/**/build/
+
+# ===== VS Code =====
+.vscode/
+
 # ===== OS =====
 .DS_Store
 Thumbs.db
 ehthumbs.db
 
 # ===== ?섍꼍?ㅼ젙 (誘쇨컧?뺣낫 遺꾨━ ?? =====
-# application-local.properties
-# application-secret.properties
+# application-local.yml
+# application-secret.yml

Dockerfile

@@ -1,30 +1,31 @@
-# 1. 鍮뚮뱶 ?섍꼍 (JDK 21)
+# 1. ??<3F><><EFBFBD>???<3F>꼍 (JDK 21)
 FROM eclipse-temurin:21-jdk-alpine AS builder
 WORKDIR /app
 
-# Gradle ?섑띁?€ ?뚯뒪 蹂듭궗
+# Gradle ??<3F>띁?? ???<3F><> 蹂듭<EFBFBD>?
 COPY gradlew .
 COPY gradle gradle
 COPY build.gradle settings.gradle ./
 COPY src src
 
-# 沅뚰븳 遺€??諛?鍮뚮뱶 (?뚯뒪???쒖쇅)
+# 沅뚰<EFBFBD>??<3F>€??<3F>???<3F><><EFBFBD>?(???<3F><>????<3F>쇅)
 RUN chmod +x gradlew
 RUN ./gradlew clean build -x test
 
-# 2. ?ㅽ뻾 ?섍꼍 (JRE 21)
+# 2. ??<3F>뻾 ??<3F>꼍 (JRE 21)
 FROM eclipse-temurin:21-jre-alpine
 WORKDIR /app
 
-# ?€?꾩〈 ?ㅼ젙 (?쒓뎅 ?쒓컙)
+# ???꾩<EFBFBD>???<3F>젙 (??<3F>뎅 ??<3F>컙)
 RUN apk add --no-cache tzdata
 ENV TZ=Asia/Seoul
 
-# 鍮뚮뱶??JAR ?뚯씪 蹂듭궗
+# ??<3F><><EFBFBD>??JAR ???<3F><> 蹂듭<EFBFBD>?
 COPY --from=builder /app/build/libs/*.jar app.jar
 
-# 湲곕낯 ?ы듃 ?몄텧
+# 湲곕???????몄텧
 EXPOSE 8081
 
-# 而⑦뀒?대꼫 ?ㅽ뻾 ??JAR ?ㅽ뻾
+# ?<3F>⑦???<3F><>???<3F>뻾 ??JAR ??<3F>뻾
 ENTRYPOINT ["java", "-jar", "app.jar"]
+

McpBridge.java

@@ -2,13 +2,13 @@
  * @package io.shinhanlife
  * @className McpBridge
  * @description AX HUB 시스템 처리 클래스
- * @author 김형식
+ * @author 0986406
  * @create 2026.09.01
  * <pre>
  * ---------- 개정이력 ----------
  * 수정일      수정자    수정내용
  * ---------- -------- ---------------------------
- * 2026.09.01  김형식    최초생성
+ * 2026.09.01  0986406    최초생성
  * 
  * </pre>
  */

README.md

@@ -1,164 +1,154 @@
-# DAP Backend
-
-Spring Boot 기반 DAP 관리자 백엔드 API 서버 및 MCP(Model Context Protocol) Gateway / Tool 분산 서버 프로젝트입니다.
-
----
-
-##  아키텍처 개요 (Architecture Overview)
-
-DAP Backend는 2개의 주요 애플리케이션으로 분리 운영됩니다:
-
-1. **MCP Gateway (`DapGatewayApplication`)**: 외부 LLM(Claude, GPT 등) 서버의 MCP 통신을 받아, 내부 Tool 서버들로 분배(라우팅)하는 허브 서버이자 관리자 웹(Scaffolder)을 제공하는 통합 서버 (포트: 8081)
-2. **MCP Tool (`DapTool*Application`)**: 실제 레거시 시스템(MCI, EAI 등)과 통신하여 비즈니스 로직(결제, 휴가신청 등)을 수행하는 어댑터 서버 (포트: 8082~8085 등 분산 구성 가능)
-
----
-
-##  환경 (Environment)
-
-| 항목 | 버전 |
-|------|------|
-| Java | 21 |
-| Spring Boot | 4.0.5 |
-| Build Tool | Gradle |
-| 주요 기술 스택 | MyBatis, Lombok, MapStruct, P6Spy |
-| 데이터베이스 | H2 (in-memory, 로컬 개발용) |
-| 세션/캐시 저장소 | Redis |
-| **장애 격리 / 제어** | **Resilience4j (RateLimiter, CircuitBreaker, Retry)** |
-| **메시지 큐** | **Kafka (트래픽 폭주 시 대기열 전환용)** |
-
----
-
-## ▶ 실행 방법 (How to Run)
-
-### 1. Gateway & Tool 서버 실행 (MCP 연동용)
-- **Gateway 서버 기동:**
-  - `./gradlew :dap-gateway:bootRun`
-- **Tool 서버 기동:**
-  - `./gradlew :dap-tool-other:bootRun` (또는 dap-tool-payment 등)
-  - Tool 서버가 기동되면 자동으로 Gateway(8081)에 자신을 등록(Auto-Registration)합니다.
-  - **(선택) 특정 Tool 그룹만 실행하기:** 
-    - 업무 특성에 따라 세분화된 그룹에 속한 Tool만 띄우고 싶다면, 실행 인수에 `--mcp.tool.target=그룹명`을 추가합니다.
-    - **지원되는 그룹명:**
-      - `NOTIFICATION`: 이메일, SMS 발송
-      - `CLAIM`: 청구 처리, 심사 상태 조회
-      - `POLICY`: 증권 발행, 발행 가능 여부 조회
-      - `HR`: 휴가 등록, 연차 갯수 조회
-      - `CONTRACT`: 계약 상태, 계약 상세 조회
-      - `CUSTOMER`: 고객 등급, 고객 상세 정보 조회
-    - IntelliJ IDEA: `Run/Debug Configurations`에서 `DapTool*Application` 의 `Program arguments` 에 `--mcp.tool.target=NOTIFICATION` 입력
-
-
----
-
-## 🤖 AI Agent 연동 아키텍처 (MCP & Agent Builder)
-
-본 시스템은 **투트랙(Two-Track) AI 연동 아키텍처**를 제공하여 로컬 개발 환경과 프로덕션 환경 모두를 완벽하게 지원합니다.
-
-### 1. 로컬 코딩 AI (Antigravity, Cursor, Claude Desktop 등) 연동
-표준 MCP 통신(Stdio)을 요구하는 로컬 AI 에이전트를 위해 자바 기반의 브릿지 스크립트(`McpBridge.java`)를 내장하고 있습니다. 브릿지가 Stdio 요청을 HTTP로 변환하여 로컬 환경의 Gateway(포트: 8281)로 전달합니다.
-
-- **설정 방법**: IDE의 `mcp_config.json` 설정 파일에 아래와 같이 등록합니다.
-  ```json
-  "mcpServers": {
-    "dap-gateway": {
-      "command": "java",
-      "args": ["C:/절대경로/dap-backend-main/McpBridge.java"]
-    }
-  }
-  ```
-- **특정 카테고리 툴 필터링**: `McpBridge.java` 내부의 URI 파라미터(`?categoryKey=common`)를 수정하여 원하는 도메인의 툴만 선택적으로 AI에게 학습시킬 수 있습니다.
-
-### 2. 프로덕션 클라우드 AI (Google Cloud Agent Builder 등) 연동
-실제 라이브 서비스에서 동작하는 클라우드 Agent Builder는 REST API 기반의 OpenAPI Spec을 요구합니다. 
-`dap-gateway`는 이미 **Agent Builder 규격의 REST API(`/mcp/api/v1/tools/call`)를 네이티브로 제공**하므로, 별도의 브릿지나 어댑터 없이 Endpoint URL과 Swagger(OpenAPI) 문서만 클라우드 콘솔에 등록하면 즉시 라이브 챗봇/에이전트로 서비스할 수 있습니다.
-
----
-
-##  비공개 Tool 관리 및 Fallback 연동 (Visibility & Routing)
-
-저희 시스템은 MSA 보안 및 아키텍처 원칙에 따라 Tool의 **레지스트리 등록 여부(라우팅)**와 **API 노출 여부(가시성)**를 완벽히 분리하여 관리합니다.
-
-1. **`visible = false`**: 
-   레지스트리에 정상적으로 등록되어 게이트웨이가 동적으로 라우팅하지만, 클라이언트에게 제공되는 `/tools/list` API 목록에서는 숨겨집니다.
-2. **`register = false`**: 
-   내부 레지스트리(Redis)에 툴 정보를 등록하지 않습니다 (외부 레지스트리를 독자적으로 사용할 경우 등). 
-   이 경우 게이트웨이는 `application.properties`의 `mcp.gateway.fallback.routes` 설정을 참조하여 **Fallback 정적 라우팅**을 수행하므로 연동이 100% 보장됩니다.
-
-```java
-@McpFunction(
-    name = "secret_tool",
-    visible = false, // 목록 숨김 여부 (기본값: true)
-    register = false // 내부 Redis 등록 여부 (기본값: true)
-)
-```
-
----
-
-## 🛡️ 시스템 안정성 및 네트워크 제어 (Resilience & Network)
-
-MSA 및 외부 시스템(MCI) 연동 환경의 안정성을 위해 완벽한 3-Tier 방어 체계를 구축했습니다.
-
-1. **Gateway 라우팅 방어 (Timeout & Fallback):**
-   - MCP 라우터(`McpRouterController`) 단에 1초 타임아웃을 강제 적용하여 특정 Tool Pod의 응답 지연이 전체 시스템 장애로 이어지는 것을 방지하고 신속하게 정적 Fallback 라우팅으로 전환합니다.
-2. **MCI 네트워크 안정화 (HTTP/1.1 Downgrade):**
-   - 기존 HTTP/2 사용 시 레거시 시스템 연동 중 간헐적으로 발생하던 `RST_STREAM` 오류를 원천 차단하기 위해, MCI 전용 `HttpEimsSender`에는 고도로 최적화된 **HTTP/1.1 전용 커넥션 풀(Factory)**이 고정 적용되어 네트워크 단절을 방지합니다.
-3. **Resilience4j 기반 트래픽 제어:**
-   - **Gateway 계층 (동적 방어):** Tool 등록 시 제출된 SLA 메타데이터를 기반으로 동적 CircuitBreaker 및 RateLimiter를 가동하며, 한계치 초과 시 Kafka 큐로 비동기 전환합니다.
-   - **Tool 계층 (정적 방어):** 레거시 커넥터 내부에 `@CircuitBreaker`, `@RateLimiter` 어노테이션 기반의 장애 전파 차단 로직이 2차적으로 가동됩니다.
-
----
-
-##  모듈(Pod) 및 Tool 코드 자동 생성 (Scaffolders)
-
-새로운 도메인의 기능을 추가할 때 발생하는 반복적인 설정(보일러플레이트, 설정 파일 복사 등)을 1초 만에 자동화하기 위해 **DAP Developer Portal (Web UI)** 및 **CLI 스캐폴더 2종**을 제공합니다.
-
-###  1. DAP Developer Portal (Web UI) - 가장 추천하는 방식!
-이제 더 이상 터미널에서 명령어를 칠 필요가 없습니다. Gateway 모듈에 내장된 웹 화면에서 빈칸만 채우면 코드가 마법처럼 찍혀 나옵니다.
-
-1. **접속 방법**: Gateway 서버 기동 후 브라우저에서 `http://localhost:8081/admin/scaffold.html` 접속
-2. **Pod (모듈) 생성 탭**: 모듈명(예: hr)과 포트만 입력하면 독립적인 Spring Boot 모듈이 디렉토리부터 빌드 스크립트까지 완벽히 생성됩니다.
-3. **Tool (기능) 생성 탭**: 생성된 모듈에 새로운 툴(서비스/DTO) 코드를 자동으로 주입합니다.
-
-### 2. CLI 스캐폴더 (기존 터미널 방식)
-웹 화면을 사용할 수 없는 환경이거나 터미널이 익숙한 경우, 아래 명령어를 통해 CLI 마법사를 사용할 수 있습니다.
-
-### 1⃣ 새로운 Pod(모듈) 전체를 생성할 때: `PodScaffolder`
-새로운 도메인(예: 결제, HR)을 위한 완전히 독립적인 Spring Boot 모듈을 생성합니다. 폴더 구조, 빌드 스크립트, 각종 프로퍼티 및 도커 설정까지 완벽하게 세팅됩니다.
-
-```bash
-# 사용법: javac로 컴파일 후 실행
-javac -encoding UTF-8 dap-common/src/main/java/io/shinhanlife/dap/common/util/PodScaffolder.java
-java -cp dap-common/src/main/java io.shinhanlife.dap.common.util.PodScaffolder [모듈명] [포트번호]
-
-# 실행 예시 (dap-tool-hr 모듈을 8086 포트로 생성)
-java -cp dap-common/src/main/java io.shinhanlife.dap.common.util.PodScaffolder hr 8086
-```
-
-### 2⃣ 생성된 모듈에 새로운 툴(Function)을 추가할 때: `ToolScaffolder`
-어노테이션(`@McpTool`, `@McpFunction`)이 완벽히 달린 Service와 입출력 DTO 코드를 지정된 모듈 패키지 룰에 맞춰 자동 생성합니다.
-
-```bash
-# 사용법: javac로 컴파일 후 실행
-javac -encoding UTF-8 dap-common/src/main/java/io/shinhanlife/dap/common/util/ToolScaffolder.java
-java -cp dap-common/src/main/java io.shinhanlife.dap.common.util.ToolScaffolder [Tool이름] [인터페이스ID] "[기능설명]" "[그룹명]" "[통신방식]" "[모듈명]"
-
-# 실행 예시 (payment 모듈에 결제 승인 기능 추가)
-java -cp dap-common/src/main/java io.shinhanlife.dap.common.util.ToolScaffolder PaymentApproval PAY_001 "결제 승인 처리 기능" "COMMON" "HTTP" "dap-tool-payment"
-```
-
----
-
-##  패키지 구조 (Package Structure)
-
-```text
-dap-backend-main (Root)
-├── dap-gateway           #  MCP 라우팅 허브 서버 (외부 LLM과 통신 및 Tool 분배)
-├── dap-common            # 공통 모듈 (Security, Session, Config 등)
-├── dap-tool-core         # Tool 공통 기능 (AbstractMcpToolService, Annotation, Scaffolder)
-├── dap-tool-email        # [Tool] 이메일 발송 특화 어댑터 모듈
-├── dap-tool-sms          # [Tool] SMS 발송 특화 어댑터 모듈
-├── dap-tool-payment      # [Tool] 결제 비즈니스 어댑터 모듈 (Scaffolded)
-└── dap-tool-other        # [Tool] 기타 비즈니스(청구, 계약, 고객, HR 등) 어댑터 모듈
-```
-
-*(참고: 기존 단일 모듈 프로젝트에서 마이크로서비스 확장을 위해 모듈별로 분리되었으며, 각 Tool 서버는 독립적으로 확장 및 배포할 수 있습니다.)*
+# DAP Backend
+
+Spring Boot 기반 DAP 관리자 백엔드 API 서버 및 MCP(Model Context Protocol) Gateway / Tool 분산 서버 프로젝트 입니다.
+
+---
+
+##  아키텍처 개요 (Architecture Overview)
+
+DAP Backend는 2개의 주요 애플리케이션으로 분리 운영됩니다:
+
+1. **MCP Gateway (`DapGatewayApplication`)**: 외부 LLM(Claude, GPT 등) 서버의 MCP 통신을 받아, 내부 Tool 서버들로 분배(라우팅)하는 허브 서버이자 관리자 웹(Scaffolder)을 제공하는 통합 서버 (포트: 8081)
+2. **MCP Tool (`DapTool*Application`)**: 실제 레거시 시스템(MCI, EAI 등)과 통신하여 비즈니스 로직(결제, 휴가신청 등)을 수행하는 어댑터 서버 (포트: 8082~8085 등 분산 구성 가능)
+
+---
+
+##  환경 (Environment)
+
+| 항목 | 버전 |
+|------|------|
+| Java | 21 |
+| Spring Boot | 4.0.5 |
+| Build Tool | Gradle |
+| 주요 기술 스택 | MyBatis, Lombok, MapStruct, P6Spy |
+| 데이터베이스 | H2 (in-memory, 로컬 개발용) |
+| 세션/캐시 저장소 | Redis |
+| **장애 격리 / 제어** | **Resilience4j (RateLimiter, CircuitBreaker, Retry)** |
+| **메시지 큐** | **Kafka (트래픽 폭주 시 대기열 전환용)** |
+
+---
+
+## ▶ 실행 방법 (How to Run)
+
+### 1. Gateway & Tool 서버 실행 (MCP 연동용)
+- **Gateway 서버 기동:**
+  - `./gradlew :dap-gateway:bootRun`
+- **Tool 서버 기동:**
+  - `./gradlew :dap-tool-oth:bootRun` (또는 dap-tool-payment 등)
+  - Tool 서버가 기동되면 자동으로 Gateway(8081)에 자신을 등록(Auto-Registration)합니다.
+  - **(선택) 특정 Tool 그룹만 실행하기:** 
+    - 업무 특성에 따라 세분화된 그룹에 속한 Tool만 띄우고 싶다면, 실행 인수에 `--mcp.tool.target=그룹명`을 추가합니다.
+    - **지원되는 그룹명:**
+      - `NOTIFICATION`: 이메일, SMS 발송
+      - `CLAIM`: 청구 처리, 심사 상태 조회
+      - `POLICY`: 증권 발행, 발행 가능 여부 조회
+      - `HR`: 휴가 등록, 연차 갯수 조회
+      - `CONTRACT`: 계약 상태, 계약 상세 조회
+      - `CUSTOMER`: 고객 등급, 고객 상세 정보 조회
+      - `SAMPLE`: 날씨, 환율, 명언 조회 등 외부 연동 샘플
+    - IntelliJ IDEA: `Run/Debug Configurations`에서 `DapTool*Application` 의 `Program arguments` 에 `--mcp.tool.target=NOTIFICATION` 입력
+
+
+---
+
+## 🤖 AI Agent 연동 아키텍처 (MCP & Agent Builder)
+
+본 시스템은 **투트랙(Two-Track) AI 연동 아키텍처**를 제공하여 로컬 개발 환경과 프로덕션 환경 모두를 완벽하게 지원합니다.
+
+### 1. 로컬 코딩 AI (Antigravity, Cursor, Claude Desktop 등) 연동
+표준 MCP 통신(Stdio)을 요구하는 로컬 AI 에이전트를 위해 자바 기반의 브릿지 스크립트(`McpBridge.java`)를 내장하고 있습니다. 브릿지가 Stdio 요청을 HTTP로 변환하여 로컬 환경의 Gateway(포트: 8281)로 전달합니다.
+
+- **설정 방법**: IDE의 `mcp_config.json` 설정 파일에 아래와 같이 등록합니다.
+  ```json
+  "mcpServers": {
+    "dap-gateway": {
+      "command": "java",
+      "args": ["C:/절대경로/dap-backend-main/McpBridge.java"]
+    }
+  }
+  ```
+- **특정 카테고리 툴 필터링**: `McpBridge.java` 내부의 URI 파라미터(`?categoryKey=sample` 등)를 수정하여 원하는 도메인의 툴만 선택적으로 AI에게 학습시킬 수 있습니다.
+
+### 2. 프로덕션 클라우드 AI (Google Cloud Agent Builder 등) 연동
+실제 라이브 서비스에서 동작하는 클라우드 Agent Builder는 REST API 기반의 OpenAPI Spec을 요구합니다. 
+`dap-gateway`는 이미 **Agent Builder 규격의 REST API(`/mcp/api/v1/tools/call`)를 네이티브로 제공**하므로, 별도의 브릿지나 어댑터 없이 Endpoint URL과 Swagger(OpenAPI) 문서만 클라우드 콘솔에 등록하면 즉시 라이브 챗봇/에이전트로 서비스할 수 있습니다.
+
+---
+
+##  비공개 Tool 관리 및 Fallback 연동 (Visibility & Routing)
+
+저희 시스템은 MSA 보안 및 아키텍처 원칙에 따라 Tool의 **레지스트리 등록 여부(라우팅)**와 **API 노출 여부(가시성)**를 완벽히 분리하여 관리합니다.
+
+1. **`visible = false`**: 
+   레지스트리에 정상적으로 등록되어 게이트웨이가 동적으로 라우팅하지만, 클라이언트에게 제공되는 `/tools/list` API 목록에서는 숨겨집니다.
+2. **`register = false`**: 
+   내부 레지스트리(Redis)에 툴 정보를 등록하지 않습니다 (외부 레지스트리를 독자적으로 사용할 경우 등). 
+   이 경우 게이트웨이는 `application.yml`의 `mcp.gateway.fallback.routes` 설정을 참조하여 **Fallback 정적 라우팅**을 수행하므로 연동이 100% 보장됩니다.
+
+```java
+@McpFunction(
+    name = "secret_tool",
+    visible = false, // 목록 숨김 여부 (기본값: true)
+    register = false // 내부 Redis 등록 여부 (기본값: true)
+)
+```
+
+---
+
+## 🛡️ 시스템 안정성 및 네트워크 제어 (Resilience & Network)
+
+MSA 및 외부 시스템(MCI) 연동 환경의 안정성을 위해 완벽한 3-Tier 방어 체계를 구축했습니다.
+
+1. **Gateway 라우팅 방어 (Timeout & Fallback):**
+   - MCP 라우터(`McpRouterController`) 단에 1초 타임아웃을 강제 적용하여 특정 Tool Pod의 응답 지연이 전체 시스템 장애로 이어지는 것을 방지하고 신속하게 정적 Fallback 라우팅으로 전환합니다.
+2. **MCI 네트워크 안정화 (HTTP/1.1 Downgrade):**
+   - 기존 HTTP/2 사용 시 레거시 시스템 연동 중 간헐적으로 발생하던 `RST_STREAM` 오류를 원천 차단하기 위해, MCI 전용 `HttpEimsSender`에는 고도로 최적화된 **HTTP/1.1 전용 커넥션 풀(Factory)**이 고정 적용되어 네트워크 단절을 방지합니다.
+3. **Resilience4j 기반 트래픽 제어:**
+   - **Gateway 계층 (동적 방어):** Tool 등록 시 제출된 SLA 메타데이터를 기반으로 동적 CircuitBreaker 및 RateLimiter를 가동하며, 한계치 초과 시 Kafka 큐로 비동기 전환합니다.
+   - **Tool 계층 (정적 방어):** 레거시 커넥터 내부에 `@CircuitBreaker`, `@RateLimiter` 어노테이션 기반의 장애 전파 차단 로직이 2차적으로 가동됩니다.
+
+---
+
+##  모듈(Pod) 및 Tool 코드 자동 생성 (Scaffolders)
+
+새로운 도메인의 기능을 추가할 때 발생하는 반복적인 설정(보일러플레이트, 설정 파일 복사 등)을 1초 만에 자동화하기 위해 **DAP Developer Portal (Web UI)** 및 **CLI 스캐폴더 2종**을 제공합니다.
+
+###  1. DAP Developer Portal (Web UI) - 가장 추천하는 방식!
+이제 더 이상 터미널에서 명령어를 칠 필요가 없습니다. Gateway 모듈에 내장된 웹 화면에서 빈칸만 채우면 신한라이프 패키지 개발 가이드에 맞춘 코드가 마법처럼 찍혀 나옵니다.
+
+1. **접속 방법**: Gateway 서버 기동 후 브라우저에서 `http://localhost:8081/admin/scaffold.html` 접속
+2. **Pod (모듈) 생성 탭**: 모듈명(예: hr)과 포트만 입력하면 독립적인 Spring Boot 모듈이 디렉토리부터 빌드 스크립트까지 완벽히 생성됩니다.
+3. **Tool (기능) 생성 탭**: 생성된 모듈에 새로운 툴 코드를 자동으로 주입합니다.
+   - **MCI 연동 기반 툴 생성**: 4자리 시스템 코드(예: `nclg`)를 기반으로 알맞은 패키지에 `MciNclgClient`, `Converter`, `_I`, `_O` 파일이 정확하게 생성됩니다.
+   - **완벽한 보일러플레이트 자동화**: `UseCaseImpl` 내부에 컴포넌트(`Client`, `Converter`)가 자동으로 의존성 주입되며, Java 15 Text Block을 활용해 들여쓰기(Indentation)까지 완벽히 정렬된 코드를 제공합니다.
+
+### 2. CLI 스캐폴더 (기존 터미널 방식)
+웹 화면을 사용할 수 없는 환경이거나 터미널이 익숙한 경우, 아래 명령어를 통해 CLI 마법사를 사용할 수 있습니다.
+
+### 1⃣ 새로운 Pod(모듈) 전체를 생성할 때: `PodScaffolder`
+새로운 도메인(예: 결제, HR)을 위한 완전히 독립적인 Spring Boot 모듈을 생성합니다. 폴더 구조, 빌드 스크립트, 각종 프로퍼티 및 도커 설정까지 완벽하게 세팅됩니다.
+
+```bash
+# 사용법: javac로 컴파일 후 실행
+javac -encoding UTF-8 dap-common/src/main/java/io/shinhanlife/dap/common/util/PodScaffolder.java
+java -cp dap-common/src/main/java io.shinhanlife.dap.lib.util.PodScaffolder [모듈명] [포트번호]
+
+# 실행 예시 (dap-tool-hr 모듈을 8086 포트로 생성)
+java -cp dap-common/src/main/java io.shinhanlife.dap.lib.util.PodScaffolder hr 8086
+```
+
+### 2⃣ 생성된 모듈에 새로운 툴(Function)을 추가할 때: `ToolScaffolder`
+어노테이션(`@McpTool`, `@McpFunction`)이 완벽히 달린 Service와 입출력 DTO 코드를 지정된 모듈 패키지 룰에 맞춰 자동 생성합니다.
+
+```bash
+# 사용법: javac로 컴파일 후 실행
+javac -encoding UTF-8 dap-common/src/main/java/io/shinhanlife/dap/common/util/ToolScaffolder.java
+java -cp dap-common/src/main/java io.shinhanlife.dap.lib.util.ToolScaffolder [Tool이름] [인터페이스ID] "[기능설명]" "[그룹명]" "[통신방식]" "[모듈명]"
+
+# 실행 예시 (payment 모듈에 결제 승인 기능 추가)
+java -cp dap-common/src/main/java io.shinhanlife.dap.lib.util.ToolScaffolder PaymentApproval PAY_001 "결제 승인 처리 기능" "COMMON" "HTTP" "dap-tool-payment"
+```
+
+---
+
+

add_javadoc.py

@@ -1,125 +0,0 @@
-import os
-import re
-
-JAVADOC_FILES = [
-    r'.\McpBridge.java',
-    r'.\dap-common\src\main\java\io\shinhanlife\dap\common\mcp\exception\GlobalExceptionHandler.java',
-    r'.\dap-common\src\main\java\io\shinhanlife\dap\common\util\ToolSourceUpdater.java',
-    r'.\dap-common\src\main\java\io\shinhanlife\glow\GlowAppServiceId.java',
-    r'.\dap-common\src\main\java\io\shinhanlife\glow\GlowControllerId.java',
-    r'.\dap-common\src\main\java\io\shinhanlife\glow\GlowIndexPaging.java',
-    r'.\dap-common\src\main\java\io\shinhanlife\glow\GlowMciFieldInfo.java',
-    r'.\dap-common\src\main\java\io\shinhanlife\glow\GlowMybatisMapper.java',
-    r'.\dap-common\src\main\java\io\shinhanlife\glow\GlowServiceGroupId.java',
-    r'.\dap-common\src\main\java\io\shinhanlife\glow\GlowTrgmField.java',
-    r'.\dap-common\src\test\java\io\shinhanlife\glow\util\GlowMciParserTest.java',
-    r'.\dap-gateway\src\main\java\io\shinhanlife\dap\biz\mcp\gateway\DapGatewayApplication.java',
-    r'.\dap-gateway\src\main\java\io\shinhanlife\dap\biz\mcp\gateway\audit\AuditLogService.java',
-    r'.\dap-gateway\src\main\java\io\shinhanlife\dap\biz\mcp\gateway\config\AgentResponseBudgetProperties.java',
-    r'.\dap-gateway\src\main\java\io\shinhanlife\dap\biz\mcp\gateway\config\McpGatewayProperties.java',
-    r'.\dap-gateway\src\main\java\io\shinhanlife\dap\biz\mcp\gateway\guardrail\GuardrailService.java',
-    r'.\dap-gateway\src\main\java\io\shinhanlife\dap\biz\mcp\gateway\guardrail\SensitiveDataMasker.java',
-    r'.\dap-gateway\src\main\java\io\shinhanlife\dap\biz\mcp\gateway\guardrail\ToolResponseGuardrailService.java',
-    r'.\dap-gateway\src\main\java\io\shinhanlife\dap\biz\mcp\gateway\presentation\ChatController.java',
-    r'.\dap-gateway\src\main\java\io\shinhanlife\dap\biz\mcp\gateway\presentation\McpRouterController.java',
-    r'.\dap-gateway\src\main\java\io\shinhanlife\dap\biz\mcp\gateway\presentation\ScaffoldingController.java',
-    r'.\dap-gateway\src\main\java\io\shinhanlife\dap\biz\mcp\gateway\redis\McpMonitorEventService.java',
-    r'.\dap-gateway\src\main\java\io\shinhanlife\dap\biz\mcp\gateway\redis\RedisToolTraceService.java',
-    r'.\dap-gateway\src\main\java\io\shinhanlife\dap\biz\mcp\gateway\resilience\CircuitBreaker.java',
-    r'.\dap-gateway\src\main\java\io\shinhanlife\dap\biz\mcp\gateway\resilience\CircuitBreakerMonitorController.java',
-    r'.\dap-gateway\src\main\java\io\shinhanlife\dap\biz\mcp\gateway\resilience\CircuitBreakerService.java',
-    r'.\dap-gateway\src\main\java\io\shinhanlife\dap\biz\mcp\gateway\resilience\CircuitBreakerSnapshot.java',
-    r'.\dap-gateway\src\main\java\io\shinhanlife\dap\biz\mcp\gateway\resilience\CircuitBreakerState.java',
-    r'.\dap-gateway\src\main\java\io\shinhanlife\dap\biz\mcp\gateway\resilience\FailureType.java',
-    r'.\dap-gateway\src\main\java\io\shinhanlife\dap\biz\mcp\gateway\resilience\RetryPolicy.java',
-    r'.\dap-gateway\src\main\java\io\shinhanlife\dap\biz\mcp\gateway\resilience\ToolExecutionException.java',
-    r'.\dap-gateway\src\main\java\io\shinhanlife\dap\biz\mcp\gateway\security\McpRequestContext.java',
-    r'.\dap-gateway\src\main\java\io\shinhanlife\dap\biz\mcp\gateway\security\McpRequestContextResolver.java',
-    r'.\dap-gateway\src\main\java\io\shinhanlife\dap\biz\mcp\gateway\security\ToolAuthorizationService.java',
-    r'.\dap-gateway\src\main\java\io\shinhanlife\dap\biz\mcp\gateway\service\ExecuteService.java',
-    r'.\dap-gateway\src\main\java\io\shinhanlife\dap\biz\mcp\gateway\sync\DynamicMcpController.java',
-    r'.\dap-gateway\src\main\java\io\shinhanlife\dap\biz\mcp\gateway\sync\DynamicMcpServerManager.java',
-    r'.\dap-gateway\src\main\java\io\shinhanlife\dap\biz\mcp\gateway\sync\RegistryMcpToolSpecificationFactory.java',
-    r'.\dap-gateway\src\main\java\io\shinhanlife\dap\biz\mcp\gateway\tool\large\AgentResponseBudgetService.java',
-    r'.\dap-gateway\src\main\java\io\shinhanlife\dap\biz\mcp\gateway\tool\large\LargeToolResponseService.java',
-    r'.\dap-gateway\src\main\java\io\shinhanlife\dap\biz\mcp\gateway\tool\large\PaginationRequestValidator.java',
-    r'.\dap-gateway\src\main\java\io\shinhanlife\dap\biz\mcp\gateway\tool\result\ToolExecutionResult.java',
-    r'.\dap-gateway\src\main\java\io\shinhanlife\dap\biz\mcp\gateway\tool\result\ToolExecutionResultFormatter.java',
-    r'.\dap-gateway\src\main\java\io\shinhanlife\dap\biz\mcp\gateway\transport\HttpToolInvoker.java',
-    r'.\dap-gateway\src\main\java\io\shinhanlife\dap\biz\mcp\gateway\transport\ToolInvoker.java',
-    r'.\dap-gateway\src\test\java\io\shinhanlife\dap\biz\mcp\gateway\DapGatewayApplicationTests.java',
-    r'.\dap-gateway\src\test\java\io\shinhanlife\dap\biz\mcp\gateway\tool\large\PaginationRequestValidatorTest.java',
-    r'.\dap-tool-core\src\main\java\io\shinhanlife\dap\biz\mcp\sample\converter\SampleLegacyConverter.java',
-    r'.\dap-tool-core\src\main\java\io\shinhanlife\dap\biz\mcp\sample\dto\SampleAiReqDto.java',
-    r'.\dap-tool-core\src\main\java\io\shinhanlife\dap\biz\mcp\tool\annotation\McpFunction.java',
-    r'.\dap-tool-core\src\main\java\io\shinhanlife\dap\biz\mcp\tool\annotation\McpParameter.java',
-    r'.\dap-tool-core\src\main\java\io\shinhanlife\dap\biz\mcp\tool\annotation\McpTool.java',
-    r'.\dap-tool-core\src\main\java\io\shinhanlife\dap\biz\mcp\tool\aop\ToolSlaMonitoringAspect.java',
-    r'.\dap-tool-core\src\main\java\io\shinhanlife\dap\biz\mcp\tool\presentation\BusinessToolController.java',
-    r'.\dap-tool-core\src\main\java\io\shinhanlife\dap\biz\mcp\tool\service\ToolRegistryHeartbeatSender.java',
-    r'.\dap-tool-core\src\main\java\io\shinhanlife\dap\biz\mcp\tool\util\JsonSchemaGenerator.java',
-    r'.\dap-tool-core\src\test\java\io\shinhanlife\dap\biz\mcp\sample\converter\SampleLegacyConverterTest.java',
-    r'.\dap-tool-email\src\main\java\io\shinhanlife\dap\biz\mcp\tool\email\DapToolEmailApplication.java',
-    r'.\dap-tool-other\src\main\java\io\shinhanlife\dap\biz\mcp\tool\dto\BalanceReq.java',
-    r'.\dap-tool-other\src\main\java\io\shinhanlife\dap\biz\mcp\tool\dto\BalanceRes.java',
-    r'.\dap-tool-other\src\main\java\io\shinhanlife\dap\biz\mcp\tool\other\DapToolOtherApplication.java',
-    r'.\dap-tool-other\src\main\java\io\shinhanlife\dap\biz\mcp\tool\service\BalanceService.java',
-    r'.\dap-tool-payment\src\main\java\io\shinhanlife\dap\biz\mcp\tool\payment\DapToolPaymentApplication.java',
-    r'.\dap-tool-sms\src\main\java\io\shinhanlife\dap\biz\mcp\tool\sms\DapToolSmsApplication.java',
-    r'.\dap-tool-sms\src\main\java\io\shinhanlife\dap\biz\mcp\tool\sms\converter\SmsLegacyConverter.java',
-    r'.\dap-tool-sms\src\main\java\io\shinhanlife\dap\biz\mcp\tool\sms\dto\SmsLegacyReqDto.java',
-]
-
-JAVADOC_TEMPLATE = '''/**
- * @package {package}
- * @className {classname}
- * @description AX HUB 시스템 처리 클래스
- * @author 김형식
- * @create 2026.09.01
- * <pre>
- * ---------- 개정이력 ----------
- * 수정일      수정자    수정내용
- * ---------- -------- ---------------------------
- * 2026.09.01  김형식    최초생성
- * 
- * </pre>
- */'''
-
-def get_package_and_class(content, filename):
-    pkg_match = re.search(r'^package\s+([^\s;]+)', content, re.MULTILINE)
-    package = pkg_match.group(1) if pkg_match else 'io.shinhanlife'
-    classname = os.path.splitext(filename)[0]
-    return package, classname
-
-def add_javadoc(file_path):
-    if not os.path.exists(file_path):
-        print(f'SKIP (not found): {file_path}')
-        return
-    with open(file_path, 'r', encoding='utf-8') as f:
-        content = f.read()
-
-    if '@className' in content or '@author' in content:
-        print(f'SKIP (already has javadoc): {file_path}')
-        return
-
-    filename = os.path.basename(file_path)
-    package, classname = get_package_and_class(content, filename)
-    javadoc = JAVADOC_TEMPLATE.format(package=package, classname=classname)
-
-    # Insert after package declaration
-    pkg_pattern = re.compile(r'^(package\s+[^\s;]+;\s*\n)', re.MULTILINE)
-    match = pkg_pattern.search(content)
-    if match:
-        insert_pos = match.end()
-        new_content = content[:insert_pos] + '\n' + javadoc + '\n' + content[insert_pos:]
-    else:
-        new_content = javadoc + '\n' + content
-
-    with open(file_path, 'w', encoding='utf-8') as f:
-        f.write(new_content)
-    print(f'OK: {file_path}')
-
-for f in JAVADOC_FILES:
-    add_javadoc(f)
-
-print('\nDone!')

dap-common/build.gradle

@@ -1,35 +0,0 @@
-plugins {
-    id 'java-library'
-}
-
-dependencies {
-    api 'org.springframework.boot:spring-boot-starter-web'
-    api 'org.springframework.boot:spring-boot-starter-validation'
-    api 'org.springframework.boot:spring-boot-starter-data-redis'
-    
-    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'
-    api 'org.mybatis.spring.boot:mybatis-spring-boot-starter:3.0.3'
-    api 'com.h2database:h2'
-    api 'p6spy:p6spy:3.9.1'
-    api 'io.lettuce:lettuce-core:6.6.0.RELEASE'
-
-    api "org.mapstruct:mapstruct:1.5.5.Final"
-    
-    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:1.4.0'
-    api 'org.springframework.kafka:spring-kafka:3.2.0'
-    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'
-}

dap-common/src/main/java/io/shinhanlife/dap/common/integration/mci/dto/ShinhanCommonHeaderDto.java

@@ -1,40 +0,0 @@
-package io.shinhanlife.dap.common.integration.mci.dto;
-
-import lombok.AllArgsConstructor;
-import lombok.Builder;
-import lombok.Data;
-import lombok.NoArgsConstructor;
-
-/**
- * @package io.shinhanlife.dap.common.integration.mci.dto
- * @className ShinhanCommonHeaderDto
- * @description AX HUB 시스템 처리 클래스
- * @author 김형식
- * @create 2026.09.01
- * <pre>
- * ---------- 개정이력 ----------
- * 수정일      수정자    수정내용
- * ---------- -------- ---------------------------
- * 2026.09.01  김형식    최초생성
- * 
- * </pre>
- */
-@Data
-@Builder
-@NoArgsConstructor
-@AllArgsConstructor
-public class ShinhanCommonHeaderDto {
-
-    private String envrTypeCd;          // 환경유형코드 (D, T, R)
-    private String glbId;               // 전사공통키 (37 Byte)
-    private String pgrsSriaNo;          // 진행일련번호
-    private String trgmVrsnInfoValu;    // 전문버전정보값
-    private String tgrmEncrYn;          // 전문암호화여부
-    private String gpcpCd;              // 글로벌법인코드
-    private String appliDutjCd;         // 어플리케이션업무코드
-    private String rcvSvcId;            // 수신서비스ID
-    private String reqRspnScCd;         // 요청응답구분코드 (S:요청, R:응답)
-    private String inqrTraTypeCd;       // 조회거래유형코드
-    private String reqTgrmTnsmDtptDt;   // 요청전문전송일시
-    private String itrIfId;             // 인터페이스ID
-}

dap-common/src/main/java/io/shinhanlife/dap/common/util/ToolScaffolder.java

@@ -1,372 +0,0 @@
-package io.shinhanlife.dap.common.util;
-
-import java.io.IOException;
-import java.nio.file.Files;
-import java.nio.file.Path;
-import java.nio.file.Paths;
-import java.time.LocalDate;
-import java.time.format.DateTimeFormatter;
-import java.util.Scanner;
-
-/**
- * MCP Tool 코드를 자동 생성(Scaffolding)하는 유틸리티 클래스
- * 
- * [실행 방법]
- * 방법 1. IDE(IntelliJ 등)에서 직접 실행 (대화형 모드 추천 ⭐)
- *  - 이 클래스(ToolScaffolder.java)를 열고 main 메서드를 직접 실행(Run)합니다.
- *  - 콘솔 창에 뜨는 질문에 차례대로 값을 입력하기만 하면 파일이 생성됩니다.
- * 
- * 방법 2. 커맨드라인(터미널)에서 실행 (명령어 기반)
- *  - 컴파일: javac -encoding UTF-8 dap-tool-core/src/main/java/io/shinhanlife/dap/mcc/util/ToolScaffolder.java
- *  - 실행: java -cp dap-tool-core/src/main/java io.shinhanlife.dap.mcc.util.ToolScaffolder [이름] [ID] "[설명]" "[그룹]" "[통신방식]" "[모듈명]"
- */
-/**
- * @package io.shinhanlife.dap.mcc.util
- * @className ToolScaffolder
- * @description AX HUB 시스템 처리 클래스
- * @author 김형식
- * @create 2026.09.01
- * <pre>
- * ---------- 개정이력 ----------
- * 수정일      수정자    수정내용
- * ---------- -------- ---------------------------
- * 2026.09.01  김형식    최초생성
- * 
- * </pre>
- */
-public class ToolScaffolder {
-
-    private static final String BASE_PACKAGE = "io.shinhanlife.dap.mcc";
-    private static final String BASE_PACKAGE_PATH = "src/main/java/io/shinhanlife/dap/mcc";
-
-    public static void main(String[] args) throws IOException {
-        Scanner scanner = new Scanner(System.in);
-
-        System.out.println("=========================================");
-        System.out.println("   MCP Tool Scaffolder (Java CLI)   ");
-        System.out.println("=========================================\n");
-
-        String baseName = getOrAsk(args, 0, scanner, "1. 생성할 Tool의 기본 이름 (예: ExchangeRate) [영문 PascalCase]: ");
-        String interfaceId = getOrAsk(args, 1, scanner, "2. 레거시 API 인터페이스 ID (예: EXCH_001): ");
-        String description = getOrAsk(args, 2, scanner, "3. Tool 기능 설명 (예: 환율 조회): ");
-        String group = getOrAsk(args, 3, scanner, "4. Tool 소속 그룹 (예: NOTIFICATION, CLAIM, POLICY, HR, CONTRACT, CUSTOMER 등): ");
-        if (group.isEmpty()) group = "COMMON";
-        String routingType = getOrAsk(args, 4, scanner, "5. 통신 프로토콜 (예: HTTP, TCP, MCI, EAI): ");
-        if (routingType.trim().isEmpty()) {
-            routingType = "HTTP";
-        }
-        String moduleName = getOrAsk(args, 5, scanner, "6. 코드를 생성할 모듈 (기본: dap-tool-other): ");
-        if (moduleName.trim().isEmpty()) {
-            moduleName = "dap-tool-other";
-        }
-        
-        String defaultAuthor = System.getProperty("user.name");
-        String defaultDate = LocalDate.now().format(DateTimeFormatter.ofPattern("yyyy.MM.dd"));
-
-        String author = getOrAsk(args, 6, scanner, "7. 작성자 (엔터 입력 시 '" + defaultAuthor + "'): ");
-        if (author.trim().isEmpty()) author = defaultAuthor;
-        String createDate = getOrAsk(args, 7, scanner, "8. 작성일 (엔터 입력 시 '" + defaultDate + "'): ");
-        if (createDate.trim().isEmpty()) createDate = defaultDate;
-
-        String result = scaffold(baseName, interfaceId, description, group, routingType, moduleName, author, createDate, true);
-        System.out.println(result);
-    }
-
-    private static String getOrAsk(String[] args, int index, Scanner scanner, String prompt) {
-        if (args.length > index) {
-            return args[index];
-        }
-        System.out.print(prompt);
-        return scanner.nextLine().trim();
-    }
-
-    public static String scaffold(String baseName, String interfaceId, String description, String group, String routingType, String moduleName, String author, String createDate, boolean register) throws IOException {
-        baseName = toPascalCase(baseName);
-        String envSourceDir = System.getenv("AXHUB_SOURCE_DIR");
-        Path rootDir = envSourceDir != null ? Paths.get(envSourceDir) : Paths.get(".");
-        
-        Path serviceDir = rootDir.resolve(Paths.get(moduleName, BASE_PACKAGE_PATH, "service"));
-        Path dtoDir = rootDir.resolve(Paths.get(moduleName, BASE_PACKAGE_PATH, "dto"));
-
-        String shortName = moduleName.replace("dap-tool-", "").replace("-", "");
-        Path legacyDtoDir = rootDir.resolve(Paths.get(moduleName, BASE_PACKAGE_PATH, shortName, "dto"));
-        Path converterDir = rootDir.resolve(Paths.get(moduleName, BASE_PACKAGE_PATH, shortName, "converter"));
-
-        Files.createDirectories(serviceDir);
-        Files.createDirectories(dtoDir);
-        Files.createDirectories(legacyDtoDir);
-        Files.createDirectories(converterDir);
-
-        StringBuilder log = new StringBuilder();
-
-        // Generate Req DTO
-        String reqContent = """
-            package %s.dto;
-
-            import com.fasterxml.jackson.annotation.JsonInclude;
-            import lombok.Data;
-
-            /**
-             * @package %s.dto
-             * @className %sReq
-             * @description AX HUB 시스템 처리 클래스
-             * @author %s
-             * @create %s
-             * <pre>
-             * ---------- 개정이력 ----------
-             * 수정일      수정자    수정내용
-             * ---------- -------- ---------------------------
-             * %s  %s    최초생성
-             * 
-             * </pre>
-             */
-            @Data
-            @JsonInclude(JsonInclude.Include.NON_NULL)
-            public class %sReq {
-                // TODO: Add request fields here
-            }
-            """.formatted(BASE_PACKAGE, BASE_PACKAGE, baseName, author, createDate, createDate, author, baseName);
-        Files.writeString(dtoDir.resolve(baseName + "Req.java"), reqContent);
-
-        // Generate Res DTO
-        String resContent = """
-            package %s.dto;
-
-            import com.fasterxml.jackson.annotation.JsonInclude;
-            import lombok.Data;
-
-            /**
-             * @package %s.dto
-             * @className %sRes
-             * @description AX HUB 시스템 처리 클래스
-             * @author %s
-             * @create %s
-             * <pre>
-             * ---------- 개정이력 ----------
-             * 수정일      수정자    수정내용
-             * ---------- -------- ---------------------------
-             * %s  %s    최초생성
-             * 
-             * </pre>
-             */
-            @Data
-            @JsonInclude(JsonInclude.Include.NON_NULL)
-            public class %sRes {
-                private String status;
-                private String message;
-                // TODO: Add response fields here
-            }
-            """.formatted(BASE_PACKAGE, BASE_PACKAGE, baseName, author, createDate, createDate, author, baseName);
-        Files.writeString(dtoDir.resolve(baseName + "Res.java"), resContent);
-
-        String toolName = baseName.isEmpty() ? baseName : Character.toLowerCase(baseName.charAt(0)) + baseName.substring(1);
-
-        // Generate Service
-        String serviceContent = """
-            package %s.service;
-
-            import %s.annotation.McpFunction;
-            import %s.annotation.McpTool;
-            import %s.dto.%sReq;
-            import %s.dto.%sRes;
-            import %s.%s.converter.%sLegacyConverter;
-            import org.springframework.stereotype.Service;
-            import org.mapstruct.factory.Mappers;
-
-            /**
-             * @package %s.service
-             * @className %sService
-             * @description AX HUB 시스템 처리 클래스
-             * @author %s
-             * @create %s
-             * <pre>
-             * ---------- 개정이력 ----------
-             * 수정일      수정자    수정내용
-             * ---------- -------- ---------------------------
-             * %s  %s    최초생성
-             * 
-             * </pre>
-             */
-            @Service
-            @McpTool(
-                routingType = "%s",
-                categoryKey = "%s"
-            )
-            public class %sService extends AbstractMcpToolService {
-
-                private final %sLegacyConverter converter = Mappers.getMapper(%sLegacyConverter.class);
-
-                @McpFunction(
-                    displayName = "%s 툴",
-                    name = "%s",
-                    description = "%s",
-                    prompt = "%s",
-                    mappingId = "%s",
-                    register = %s,
-                    requiresApproval = false
-                )
-                public Object execute(%sReq req) {
-                    // %sLegacyReq legacyReq = converter.toLegacyReq(req);
-                    return executeLegacy("%s", "%s", req); // Or pass legacyReq
-                }
-            }
-            """.formatted(
-                BASE_PACKAGE,
-                BASE_PACKAGE,
-                BASE_PACKAGE,
-                BASE_PACKAGE, baseName,
-                BASE_PACKAGE, baseName,
-                BASE_PACKAGE, shortName, baseName,
-                BASE_PACKAGE,
-                baseName,
-                author,
-                createDate,
-                createDate, author,
-                routingType, group.toLowerCase(),
-                baseName,
-                baseName, baseName,
-                baseName, toolName, description, description + " 해줘.", interfaceId, register,
-                baseName,
-                baseName,
-                routingType, interfaceId
-            );
-        
-        Files.writeString(serviceDir.resolve(baseName + "Service.java"), serviceContent);
-
-
-
-        // Generate Legacy Req DTO
-        String legacyReqContent = """
-            package %s.%s.dto;
-
-            import lombok.Data;
-
-            /**
-             * @package %s.%s.dto
-             * @className %sLegacyReq
-             * @description AX HUB 시스템 처리 클래스
-             * @author %s
-             * @create %s
-             * <pre>
-             * ---------- 개정이력 ----------
-             * 수정일      수정자    수정내용
-             * ---------- -------- ---------------------------
-             * %s  %s    최초생성
-             * 
-             * </pre>
-             */
-            @Data
-            public class %sLegacyReq {
-                // TODO: Add legacy request fields here
-            }
-            """.formatted(BASE_PACKAGE, shortName, BASE_PACKAGE, shortName, baseName, author, createDate, createDate, author, baseName);
-        Files.writeString(legacyDtoDir.resolve(baseName + "LegacyReq.java"), legacyReqContent);
-
-        // Generate Legacy Res DTO
-        String legacyResContent = """
-            package %s.%s.dto;
-
-            import lombok.Data;
-
-            /**
-             * @package %s.%s.dto
-             * @className %sLegacyRes
-             * @description AX HUB 시스템 처리 클래스
-             * @author %s
-             * @create %s
-             * <pre>
-             * ---------- 개정이력 ----------
-             * 수정일      수정자    수정내용
-             * ---------- -------- ---------------------------
-             * %s  %s    최초생성
-             * 
-             * </pre>
-             */
-            @Data
-            public class %sLegacyRes {
-                // TODO: Add legacy response fields here
-            }
-            """.formatted(BASE_PACKAGE, shortName, BASE_PACKAGE, shortName, baseName, author, createDate, createDate, author, baseName);
-        Files.writeString(legacyDtoDir.resolve(baseName + "LegacyRes.java"), legacyResContent);
-
-        // Generate Legacy Converter
-        String converterContent = """
-            package %s.%s.converter;
-
-            import %s.dto.%sReq;
-            import %s.dto.%sRes;
-            import %s.%s.dto.%sLegacyReq;
-            import %s.%s.dto.%sLegacyRes;
-            import org.mapstruct.Mapper;
-            import org.mapstruct.Mapping;
-            import org.mapstruct.factory.Mappers;
-
-            /**
-             * @package %s.%s.converter
-             * @className %sLegacyConverter
-             * @description AX HUB 시스템 처리 클래스
-             * @author %s
-             * @create %s
-             * <pre>
-             * ---------- 개정이력 ----------
-             * 수정일      수정자    수정내용
-             * ---------- -------- ---------------------------
-             * %s  %s    최초생성
-             * 
-             * </pre>
-             */
-            @Mapper(componentModel = "spring")
-            public interface %sLegacyConverter {
-
-                // @Mapping(source = "sourceField", target = "targetField")
-                %sLegacyReq toLegacyReq(%sReq req);
-                
-                %sRes toRes(%sLegacyRes legacyRes);
-            }
-            """.formatted(
-                BASE_PACKAGE, shortName,
-                BASE_PACKAGE, baseName,
-                BASE_PACKAGE, baseName,
-                BASE_PACKAGE, shortName, baseName,
-                BASE_PACKAGE, shortName, baseName,
-                BASE_PACKAGE, shortName, baseName, author, createDate, createDate, author,
-                baseName, baseName, baseName, baseName, baseName, baseName
-            );
-        Files.writeString(converterDir.resolve(baseName + "LegacyConverter.java"), converterContent);
-
-        log.append("\n=========================================\n");
-        log.append(" Scaffolding Complete!\n");
-        log.append("=========================================\n");
-        log.append("[Service] ").append(serviceDir.resolve(baseName + "Service.java")).append("\n");
-        log.append("[Req DTO] ").append(dtoDir.resolve(baseName + "Req.java")).append("\n");
-        log.append("[Res DTO] ").append(dtoDir.resolve(baseName + "Res.java")).append("\n");
-        log.append("[Legacy Req DTO] ").append(legacyDtoDir.resolve(baseName + "LegacyReq.java")).append("\n");
-        log.append("[Legacy Res DTO] ").append(legacyDtoDir.resolve(baseName + "LegacyRes.java")).append("\n");
-        log.append("[Legacy Converter] ").append(converterDir.resolve(baseName + "LegacyConverter.java")).append("\n");
-        log.append("\n Tip: ").append(interfaceId).append(" 목업 데이터를 mock-responses.json에 추가하세요.\n");
-        
-        return log.toString();
-    }
-
-    private static String toPascalCase(String str) {
-        if (str == null || str.isEmpty()) {
-            return str;
-        }
-        StringBuilder result = new StringBuilder();
-        boolean capitalizeNext = true;
-        for (char c : str.toCharArray()) {
-            if (c == '_' || c == '-' || c == ' ') {
-                capitalizeNext = true;
-            } else if (capitalizeNext) {
-                result.append(Character.toUpperCase(c));
-                capitalizeNext = false;
-            } else {
-                result.append(c);
-            }
-        }
-        if (result.length() > 0) {
-            result.setCharAt(0, Character.toUpperCase(result.charAt(0)));
-        }
-        return result.toString();
-    }
-}

dap-gateway/Dockerfile

@@ -1,17 +1,8 @@
-FROM eclipse-temurin:21-jdk-alpine AS builder
-WORKDIR /app
-COPY gradlew .
-COPY gradle gradle
-COPY build.gradle settings.gradle ./
-COPY dap-common dap-common
-COPY dap-gateway dap-gateway
-RUN chmod +x gradlew
-RUN ./gradlew :dap-gateway:build -x test
-
 FROM eclipse-temurin:21-jre-alpine
 WORKDIR /app
 RUN apk add --no-cache tzdata
 ENV TZ=Asia/Seoul
-COPY --from=builder /app/dap-gateway/build/libs/*-SNAPSHOT.jar app.jar
+COPY dap-gateway/build/libs/*-SNAPSHOT.jar app.jar
 EXPOSE 8081
 ENTRYPOINT ["java", "-jar", "app.jar"]
+

dap-gateway/build.gradle

@@ -3,7 +3,7 @@ plugins {
 }
 
 dependencies {
-    implementation project(':dap-common')
+    implementation project(':dap-tool-core')
     
     implementation 'org.springframework.boot:spring-boot-starter-web'
     implementation 'org.springframework.boot:spring-boot-starter-data-redis'

dap-gateway/src/main/java/io/shinhanlife/dap/mcg/DapGatewayApplication.java

@@ -5,13 +5,13 @@ package io.shinhanlife.dap.mcg;
  * @package io.shinhanlife.dap.mcg
  * @className DapGatewayApplication
  * @description AX HUB 시스템 처리 클래스
- * @author 김형식
+ * @author 0986406
  * @create 2026.09.01
  * <pre>
  * ---------- 개정이력 ----------
  * 수정일      수정자    수정내용
  * ---------- -------- ---------------------------
- * 2026.09.01  김형식    최초생성
+ * 2026.09.01  0986406    최초생성
  * 
  * </pre>
  */
@@ -19,10 +19,12 @@ import org.springframework.boot.SpringApplication;
 import org.springframework.boot.autoconfigure.SpringBootApplication;
 import org.springframework.boot.context.properties.ConfigurationPropertiesScan;
 import org.springframework.cache.annotation.EnableCaching;
+import org.springframework.scheduling.annotation.EnableScheduling;
 
-@SpringBootApplication(scanBasePackages = {"io.shinhanlife.dap.mcg", "io.shinhanlife.dap.common.mcp", "io.shinhanlife.dap.common.config"})
-@ConfigurationPropertiesScan(basePackages = {"io.shinhanlife.dap.mcg", "io.shinhanlife.dap.common.mcp", "io.shinhanlife.dap.common.config"})
+@SpringBootApplication(scanBasePackages = {"io.shinhanlife.dap.mcg", "io.shinhanlife.dap.lib.mcp", "io.shinhanlife.dap.lib.config"})
+@ConfigurationPropertiesScan(basePackages = {"io.shinhanlife.dap.mcg", "io.shinhanlife.dap.lib.mcp", "io.shinhanlife.dap.lib.config"})
 @EnableCaching
+@EnableScheduling
 public class DapGatewayApplication {
     public static void main(String[] args) {
         SpringApplication.run(DapGatewayApplication.class, args);

dap-gateway/src/main/java/io/shinhanlife/dap/mcg/aop/GatewayLoggingAspect.java

@@ -11,13 +11,13 @@ import org.springframework.util.StopWatch;
  * @package io.shinhanlife.dap.mcg.aop
  * @className GatewayLoggingAspect
  * @description AX HUB 시스템 처리 클래스
- * @author 김형식
+ * @author 0986406
  * @create 2026.09.01
  * <pre>
  * ---------- 개정이력 ----------
  * 수정일      수정자    수정내용
  * ---------- -------- ---------------------------
- * 2026.09.01  김형식    최초생성
+ * 2026.09.01  0986406    최초생성
  * 
  * </pre>
  */

dap-gateway/src/main/java/io/shinhanlife/dap/mcg/audit/AuditLogService.java

@@ -5,13 +5,13 @@ package io.shinhanlife.dap.mcg.audit;
  * @package io.shinhanlife.dap.mcg.audit
  * @className AuditLogService
  * @description AX HUB 시스템 처리 클래스
- * @author 김형식
+ * @author 0986406
  * @create 2026.09.01
  * <pre>
  * ---------- 개정이력 ----------
  * 수정일      수정자    수정내용
  * ---------- -------- ---------------------------
- * 2026.09.01  김형식    최초생성
+ * 2026.09.01  0986406    최초생성
  * 
  * </pre>
  */

dap-gateway/src/main/java/io/shinhanlife/dap/mcg/config/AgentResponseBudgetProperties.java

@@ -5,13 +5,13 @@ package io.shinhanlife.dap.mcg.config;
  * @package io.shinhanlife.dap.mcg.config
  * @className AgentResponseBudgetProperties
  * @description AX HUB 시스템 처리 클래스
- * @author 김형식
+ * @author 0986406
  * @create 2026.09.01
  * <pre>
  * ---------- 개정이력 ----------
  * 수정일      수정자    수정내용
  * ---------- -------- ---------------------------
- * 2026.09.01  김형식    최초생성
+ * 2026.09.01  0986406    최초생성
  * 
  * </pre>
  */

dap-gateway/src/main/java/io/shinhanlife/dap/mcg/config/GatewayFallbackProperties.java

@@ -11,13 +11,13 @@ import java.util.Map;
  * @package io.shinhanlife.dap.mcg.config
  * @className GatewayFallbackProperties
  * @description AX HUB 시스템 처리 클래스
- * @author 김형식
+ * @author 0986406
  * @create 2026.09.01
  * <pre>
  * ---------- 개정이력 ----------
  * 수정일      수정자    수정내용
  * ---------- -------- ---------------------------
- * 2026.09.01  김형식    최초생성
+ * 2026.09.01  0986406    최초생성
  * 
  * </pre>
  */

dap-gateway/src/main/java/io/shinhanlife/dap/mcg/config/McpGatewayProperties.java

@@ -5,13 +5,13 @@ package io.shinhanlife.dap.mcg.config;
  * @package io.shinhanlife.dap.mcg.config
  * @className McpGatewayProperties
  * @description AX HUB 시스템 처리 클래스
- * @author 김형식
+ * @author 0986406
  * @create 2026.09.01
  * <pre>
  * ---------- 개정이력 ----------
  * 수정일      수정자    수정내용
  * ---------- -------- ---------------------------
- * 2026.09.01  김형식    최초생성
+ * 2026.09.01  0986406    최초생성
  * 
  * </pre>
  */
@@ -25,7 +25,7 @@ import java.util.stream.Collectors;
 @Component
 @ConfigurationProperties(prefix = "mcp")
 /**
- * application.properties의 mcp.* 설정을 Java 코드에서 사용하기 위한 설정 클래스입니다.
+ * application.yml의 mcp.* 설정을 Java 코드에서 사용하기 위한 설정 클래스입니다.
  *
  * API Key, 허용 Tool, 감사 로그, Redis Trace, Retry, Circuit Breaker,
  * EIMS/Tool 서버 주소 같은 MCP Gateway 운영 설정을 한 곳에서 관리합니다.

dap-gateway/src/main/java/io/shinhanlife/dap/mcg/config/RedisConfig.java

@@ -13,13 +13,13 @@ import org.springframework.data.redis.serializer.StringRedisSerializer;
  * @package io.shinhanlife.dap.mcg.config
  * @className RedisConfig
  * @description AX HUB 시스템 처리 클래스
- * @author 김형식
+ * @author 0986406
  * @create 2026.09.01
  * <pre>
  * ---------- 개정이력 ----------
  * 수정일      수정자    수정내용
  * ---------- -------- ---------------------------
- * 2026.09.01  김형식    최초생성
+ * 2026.09.01  0986406    최초생성
  * 
  * </pre>
  */

dap-gateway/src/main/java/io/shinhanlife/dap/mcg/dto/OperationType.java

@@ -4,13 +4,13 @@ package io.shinhanlife.dap.mcg.dto;
  * @package io.shinhanlife.dap.mcg.dto
  * @className OperationType
  * @description AX HUB 시스템 처리 클래스
- * @author 김형식
+ * @author 0986406
  * @create 2026.09.01
  * <pre>
  * ---------- 개정이력 ----------
  * 수정일      수정자    수정내용
  * ---------- -------- ---------------------------
- * 2026.09.01  김형식    최초생성
+ * 2026.09.01  0986406    최초생성
  * 
  * </pre>
  */

dap-gateway/src/main/java/io/shinhanlife/dap/mcg/dto/ToolMetadata.java

@@ -20,13 +20,13 @@ import java.util.HashSet;
  * @package io.shinhanlife.dap.mcg.dto
  * @className ToolMetadata
  * @description AX HUB 시스템 처리 클래스
- * @author 김형식
+ * @author 0986406
  * @create 2026.09.01
  * <pre>
  * ---------- 개정이력 ----------
  * 수정일      수정자    수정내용
  * ---------- -------- ---------------------------
- * 2026.09.01  김형식    최초생성
+ * 2026.09.01  0986406    최초생성
  * 
  * </pre>
  */

dap-gateway/src/main/java/io/shinhanlife/dap/mcg/guardrail/GuardrailService.java

@@ -5,13 +5,13 @@ package io.shinhanlife.dap.mcg.guardrail;
  * @package io.shinhanlife.dap.mcg.guardrail
  * @className GuardrailService
  * @description AX HUB 시스템 처리 클래스
- * @author 김형식
+ * @author 0986406
  * @create 2026.09.01
  * <pre>
  * ---------- 개정이력 ----------
  * 수정일      수정자    수정내용
  * ---------- -------- ---------------------------
- * 2026.09.01  김형식    최초생성
+ * 2026.09.01  0986406    최초생성
  * 
  * </pre>
  */

dap-gateway/src/main/java/io/shinhanlife/dap/mcg/guardrail/SensitiveDataMasker.java

@@ -5,13 +5,13 @@ package io.shinhanlife.dap.mcg.guardrail;
  * @package io.shinhanlife.dap.mcg.guardrail
  * @className SensitiveDataMasker
  * @description AX HUB 시스템 처리 클래스
- * @author 김형식
+ * @author 0986406
  * @create 2026.09.01
  * <pre>
  * ---------- 개정이력 ----------
  * 수정일      수정자    수정내용
  * ---------- -------- ---------------------------
- * 2026.09.01  김형식    최초생성
+ * 2026.09.01  0986406    최초생성
  * 
  * </pre>
  */

dap-gateway/src/main/java/io/shinhanlife/dap/mcg/guardrail/ToolResponseGuardrailService.java

@@ -5,13 +5,13 @@ package io.shinhanlife.dap.mcg.guardrail;
  * @package io.shinhanlife.dap.mcg.guardrail
  * @className ToolResponseGuardrailService
  * @description AX HUB 시스템 처리 클래스
- * @author 김형식
+ * @author 0986406
  * @create 2026.09.01
  * <pre>
  * ---------- 개정이력 ----------
  * 수정일      수정자    수정내용
  * ---------- -------- ---------------------------
- * 2026.09.01  김형식    최초생성
+ * 2026.09.01  0986406    최초생성
  * 
  * </pre>
  */

dap-gateway/src/main/java/io/shinhanlife/dap/mcg/messaging/KafkaProducerService.java

@@ -13,13 +13,13 @@ import java.util.UUID;
  * @package io.shinhanlife.dap.mcg.messaging
  * @className KafkaProducerService
  * @description AX HUB 시스템 처리 클래스
- * @author 김형식
+ * @author 0986406
  * @create 2026.09.01
  * <pre>
  * ---------- 개정이력 ----------
  * 수정일      수정자    수정내용
  * ---------- -------- ---------------------------
- * 2026.09.01  김형식    최초생성
+ * 2026.09.01  0986406    최초생성
  * 
  * </pre>
  */

dap-gateway/src/main/java/io/shinhanlife/dap/mcg/presentation/ChatController.java

@@ -5,13 +5,13 @@ package io.shinhanlife.dap.mcg.presentation;
  * @package io.shinhanlife.dap.mcg.presentation
  * @className ChatController
  * @description AX HUB 시스템 처리 클래스
- * @author 김형식
+ * @author 0986406
  * @create 2026.09.01
  * <pre>
  * ---------- 개정이력 ----------
  * 수정일      수정자    수정내용
  * ---------- -------- ---------------------------
- * 2026.09.01  김형식    최초생성
+ * 2026.09.01  0986406    최초생성
  * 
  * </pre>
  */
@@ -41,6 +41,7 @@ public class ChatController {
     private final ObjectMapper objectMapper;
     private final RedisRegistryService registryService;
     private final ChatClient.Builder chatClientBuilder;
+    private final McpRouterController mcpRouterController;
 
     @PostMapping(produces = MediaType.TEXT_EVENT_STREAM_VALUE)
     public SseEmitter chatStream(@RequestBody Map<String, String> request,
@@ -54,9 +55,16 @@ public class ChatController {
 
         try {
             List<ToolCallback> callbacks = new ArrayList<>();
-            for (ToolMetadata meta : registryService.getAllTools()) {
-                if (Boolean.TRUE.equals(meta.getVisible())) {
-                    callbacks.add(new DynamicMcpToolCallback(meta, executeService, objectMapper, effectiveTenantId));
+            io.shinhanlife.dap.lib.adapter.dto.JsonRpcResponse toolsResponse = mcpRouterController.listTools(null).getBody();
+            if (toolsResponse != null && toolsResponse.getResult() instanceof Map) {
+                Map<String, Object> resultMap = (Map<String, Object>) toolsResponse.getResult();
+                if (resultMap.containsKey("tools")) {
+                    List<ToolMetadata> allTools = (List<ToolMetadata>) resultMap.get("tools");
+                    for (ToolMetadata meta : allTools) {
+                        if (Boolean.TRUE.equals(meta.getVisible())) {
+                            callbacks.add(new DynamicMcpToolCallback(meta, executeService, objectMapper, effectiveTenantId));
+                        }
+                    }
                 }
             }
 

dap-gateway/src/main/java/io/shinhanlife/dap/mcg/presentation/KillSwitchController.java

@@ -11,13 +11,13 @@ import java.util.Map;
  * @package io.shinhanlife.dap.mcg.presentation
  * @className KillSwitchController
  * @description AX HUB 시스템 처리 클래스
- * @author 김형식
+ * @author 0986406
  * @create 2026.09.01
  * <pre>
  * ---------- 개정이력 ----------
  * 수정일      수정자    수정내용
  * ---------- -------- ---------------------------
- * 2026.09.01  김형식    최초생성
+ * 2026.09.01  0986406    최초생성
  * 
  * </pre>
  */

dap-gateway/src/main/java/io/shinhanlife/dap/mcg/presentation/McpRouterController.java

@@ -5,25 +5,25 @@ package io.shinhanlife.dap.mcg.presentation;
  * @package io.shinhanlife.dap.mcg.presentation
  * @className McpRouterController
  * @description AX HUB 시스템 처리 클래스
- * @author 김형식
+ * @author 0986406
  * @create 2026.09.01
  * <pre>
  * ---------- 개정이력 ----------
  * 수정일      수정자    수정내용
  * ---------- -------- ---------------------------
- * 2026.09.01  김형식    최초생성
+ * 2026.09.01  0986406    최초생성
  * 
  * </pre>
  */
 import com.fasterxml.jackson.databind.ObjectMapper;
-import io.shinhanlife.dap.common.adapter.dto.JsonRpcRequest;
-import io.shinhanlife.dap.common.adapter.dto.JsonRpcResponse;
-import io.shinhanlife.dap.common.adapter.dto.Params;
+import io.shinhanlife.dap.lib.adapter.dto.JsonRpcRequest;
+import io.shinhanlife.dap.lib.adapter.dto.JsonRpcResponse;
+import io.shinhanlife.dap.lib.adapter.dto.Params;
 import io.shinhanlife.dap.mcg.config.GatewayFallbackProperties;
 import io.shinhanlife.dap.mcg.dto.ToolMetadata;
 import io.shinhanlife.dap.mcg.registry.RedisRegistryService;
 import io.shinhanlife.dap.mcg.service.ExecuteService;
-import io.shinhanlife.dap.common.mcp.security.SecurityProperties;
+import io.shinhanlife.dap.lib.mcp.security.SecurityProperties;
 import io.swagger.v3.oas.annotations.Operation;
 import io.swagger.v3.oas.annotations.tags.Tag;
 import java.time.LocalDateTime;
@@ -91,7 +91,7 @@ public class McpRouterController {
         try {
             Object result = executeService.execute(payload, effectiveTenantId);
             
-            io.shinhanlife.dap.common.adapter.dto.JsonRpcResponse response = new io.shinhanlife.dap.common.adapter.dto.JsonRpcResponse();
+            io.shinhanlife.dap.lib.adapter.dto.JsonRpcResponse response = new io.shinhanlife.dap.lib.adapter.dto.JsonRpcResponse();
             response.setJsonrpc("2.0");
             response.setId(payload.containsKey("id") ? String.valueOf(payload.get("id")) : UUID.randomUUID().toString());
             response.setResult(result);
@@ -112,9 +112,7 @@ public class McpRouterController {
         }
     }
 
-    @GetMapping("/tools/list")
-    public ResponseEntity<JsonRpcResponse> listTools(
-            @RequestParam(value = "categoryKey", required = false) String categoryKey) {
+    private List<ToolMetadata> fetchAllActiveTools() {
         List<ToolMetadata> activeTools = redisRegistryService.getAllTools()
                 .stream()
                 .filter(ToolMetadata::getVisible)
@@ -148,6 +146,14 @@ public class McpRouterController {
                 log.warn("Failed to fetch local tools from fallback URL: {}", url);
             }
         }
+        return activeTools;
+    }
+
+    @GetMapping("/tools/list")
+    public ResponseEntity<JsonRpcResponse> listTools(
+            @RequestParam(value = "categoryKey", required = false) String categoryKey) {
+        
+        List<ToolMetadata> activeTools = fetchAllActiveTools();
         
         if (categoryKey != null && !categoryKey.trim().isEmpty()) {
             activeTools = activeTools.stream()
@@ -161,12 +167,10 @@ public class McpRouterController {
         
         return ResponseEntity.ok(response);
     }
+
     @GetMapping(value = "/tools/docs/markdown", produces = "text/markdown;charset=UTF-8")
     public ResponseEntity<String> generateToolsMarkdown() {
-        List<ToolMetadata> tools = redisRegistryService.getAllTools()
-                .stream()
-                .filter(ToolMetadata::getVisible)
-                .collect(Collectors.toList());
+        List<ToolMetadata> tools = fetchAllActiveTools();
         
         StringBuilder md = new StringBuilder();
         md.append("# \uD83E\uDD16 Shinhan AI Tool Catalog\n\n");

dap-gateway/src/main/java/io/shinhanlife/dap/mcg/presentation/ScaffoldingController.java

@@ -5,19 +5,19 @@ package io.shinhanlife.dap.mcg.presentation;
  * @package io.shinhanlife.dap.mcg.presentation
  * @className ScaffoldingController
  * @description AX HUB 시스템 처리 클래스
- * @author 김형식
+ * @author 0986406
  * @create 2026.09.01
  * <pre>
  * ---------- 개정이력 ----------
  * 수정일      수정자    수정내용
  * ---------- -------- ---------------------------
- * 2026.09.01  김형식    최초생성
+ * 2026.09.01  0986406    최초생성
  * 
  * </pre>
  */
-import io.shinhanlife.dap.common.util.PodScaffolder;
-import io.shinhanlife.dap.common.util.ToolScaffolder;
-import io.shinhanlife.dap.common.util.ToolSourceUpdater;
+import io.shinhanlife.dap.lib.util.PodScaffolder;
+import io.shinhanlife.dap.lib.util.ToolScaffolder;
+import io.shinhanlife.dap.lib.util.ToolSourceUpdater;
 import java.io.File;
 import java.time.LocalDate;
 import java.time.format.DateTimeFormatter;
@@ -34,7 +34,7 @@ public class ScaffoldingController {
     @PostMapping("/pod")
     public String scaffoldPod(@RequestBody Map<String, String> req) {
         try {
-            String moduleName = req.getOrDefault("moduleName", "dap-tool-other");
+            String moduleName = req.getOrDefault("moduleName", "dap-tool-oth");
             if (!moduleName.startsWith("dap-tool-")) moduleName = "dap-tool-" + moduleName;
             String port = req.getOrDefault("port", "8085");
             String shortName = moduleName.replace("dap-tool-", "").replace("-", "");
@@ -57,14 +57,15 @@ public class ScaffoldingController {
             String description = req.get("description");
             String group = req.getOrDefault("categoryKey", req.getOrDefault("group", "COMMON"));
             String routingType = req.getOrDefault("routingType", "HTTP");
-            String moduleName = req.getOrDefault("moduleName", "dap-tool-other");
+            String moduleName = req.getOrDefault("moduleName", "dap-tool-oth");
             String author = req.get("author");
             if (author == null || author.trim().isEmpty()) author = System.getProperty("user.name");
             String date = req.get("date");
             if (date == null || date.trim().isEmpty()) date = LocalDate.now().format(DateTimeFormatter.ofPattern("yyyy.MM.dd"));
             boolean register = Boolean.parseBoolean(req.getOrDefault("register", "true"));
+            String clientSystemCode = req.get("clientSystemCode");
             
-            return ToolScaffolder.scaffold(baseName, interfaceId, description, group, routingType, moduleName, author, date, register);
+            return ToolScaffolder.scaffold(baseName, interfaceId, description, group, routingType, moduleName, author, date, register, clientSystemCode);
         } catch (Exception e) {
             return "오류 발생: " + e.getMessage();
         }
@@ -95,11 +96,13 @@ public class ScaffoldingController {
             File dir = new File(sourceDir);
             File[] files = dir.listFiles(f -> f.isDirectory() && f.getName().startsWith("dap-tool-") && !f.getName().equals("dap-tool-core"));
             
-            if (files == null) return List.of("dap-tool-other");
+            if (files == null || files.length == 0) {
+                return List.of("dap-tool-oth", "dap-tool-hr", "dap-tool-sms");
+            }
             
             return Arrays.stream(files).map(File::getName).sorted().collect(Collectors.toList());
         } catch (Exception e) {
-            return List.of("dap-tool-other");
+            return List.of("dap-tool-oth", "dap-tool-hr", "dap-tool-sms");
         }
     }
 }

dap-gateway/src/main/java/io/shinhanlife/dap/mcg/redis/McpMonitorEventService.java

@@ -5,13 +5,13 @@ package io.shinhanlife.dap.mcg.redis;
  * @package io.shinhanlife.dap.mcg.redis
  * @className McpMonitorEventService
  * @description AX HUB 시스템 처리 클래스
- * @author 김형식
+ * @author 0986406
  * @create 2026.09.01
  * <pre>
  * ---------- 개정이력 ----------
  * 수정일      수정자    수정내용
  * ---------- -------- ---------------------------
- * 2026.09.01  김형식    최초생성
+ * 2026.09.01  0986406    최초생성
  * 
  * </pre>
  */

dap-gateway/src/main/java/io/shinhanlife/dap/mcg/redis/RedisToolTraceService.java

@@ -5,13 +5,13 @@ package io.shinhanlife.dap.mcg.redis;
  * @package io.shinhanlife.dap.mcg.redis
  * @className RedisToolTraceService
  * @description AX HUB 시스템 처리 클래스
- * @author 김형식
+ * @author 0986406
  * @create 2026.09.01
  * <pre>
  * ---------- 개정이력 ----------
  * 수정일      수정자    수정내용
  * ---------- -------- ---------------------------
- * 2026.09.01  김형식    최초생성
+ * 2026.09.01  0986406    최초생성
  * 
  * </pre>
  */

dap-gateway/src/main/java/io/shinhanlife/dap/mcg/registry/RedisRegistryService.java

@@ -16,13 +16,13 @@ import java.util.Objects;
  * @package io.shinhanlife.dap.mcg.registry
  * @className RedisRegistryService
  * @description AX HUB 시스템 처리 클래스
- * @author 김형식
+ * @author 0986406
  * @create 2026.09.01
  * <pre>
  * ---------- 개정이력 ----------
  * 수정일      수정자    수정내용
  * ---------- -------- ---------------------------
- * 2026.09.01  김형식    최초생성
+ * 2026.09.01  0986406    최초생성
  * 
  * </pre>
  */

dap-gateway/src/main/java/io/shinhanlife/dap/mcg/resilience/CircuitBreaker.java

@@ -5,13 +5,13 @@ package io.shinhanlife.dap.mcg.resilience;
  * @package io.shinhanlife.dap.mcg.resilience
  * @className CircuitBreaker
  * @description AX HUB 시스템 처리 클래스
- * @author 김형식
+ * @author 0986406
  * @create 2026.09.01
  * <pre>
  * ---------- 개정이력 ----------
  * 수정일      수정자    수정내용
  * ---------- -------- ---------------------------
- * 2026.09.01  김형식    최초생성
+ * 2026.09.01  0986406    최초생성
  * 
  * </pre>
  */

dap-gateway/src/main/java/io/shinhanlife/dap/mcg/resilience/CircuitBreakerMonitorController.java

@@ -5,13 +5,13 @@ package io.shinhanlife.dap.mcg.resilience;
  * @package io.shinhanlife.dap.mcg.resilience
  * @className CircuitBreakerMonitorController
  * @description AX HUB 시스템 처리 클래스
- * @author 김형식
+ * @author 0986406
  * @create 2026.09.01
  * <pre>
  * ---------- 개정이력 ----------
  * 수정일      수정자    수정내용
  * ---------- -------- ---------------------------
- * 2026.09.01  김형식    최초생성
+ * 2026.09.01  0986406    최초생성
  * 
  * </pre>
  */

dap-gateway/src/main/java/io/shinhanlife/dap/mcg/resilience/CircuitBreakerService.java

@@ -5,13 +5,13 @@ package io.shinhanlife.dap.mcg.resilience;
  * @package io.shinhanlife.dap.mcg.resilience
  * @className CircuitBreakerService
  * @description AX HUB 시스템 처리 클래스
- * @author 김형식
+ * @author 0986406
  * @create 2026.09.01
  * <pre>
  * ---------- 개정이력 ----------
  * 수정일      수정자    수정내용
  * ---------- -------- ---------------------------
- * 2026.09.01  김형식    최초생성
+ * 2026.09.01  0986406    최초생성
  * 
  * </pre>
  */

dap-gateway/src/main/java/io/shinhanlife/dap/mcg/resilience/CircuitBreakerSnapshot.java

@@ -5,13 +5,13 @@ package io.shinhanlife.dap.mcg.resilience;
  * @package io.shinhanlife.dap.mcg.resilience
  * @className CircuitBreakerSnapshot
  * @description AX HUB 시스템 처리 클래스
- * @author 김형식
+ * @author 0986406
  * @create 2026.09.01
  * <pre>
  * ---------- 개정이력 ----------
  * 수정일      수정자    수정내용
  * ---------- -------- ---------------------------
- * 2026.09.01  김형식    최초생성
+ * 2026.09.01  0986406    최초생성
  * 
  * </pre>
  */

dap-gateway/src/main/java/io/shinhanlife/dap/mcg/resilience/CircuitBreakerState.java

@@ -5,13 +5,13 @@ package io.shinhanlife.dap.mcg.resilience;
  * @package io.shinhanlife.dap.mcg.resilience
  * @className CircuitBreakerState
  * @description AX HUB 시스템 처리 클래스
- * @author 김형식
+ * @author 0986406
  * @create 2026.09.01
  * <pre>
  * ---------- 개정이력 ----------
  * 수정일      수정자    수정내용
  * ---------- -------- ---------------------------
- * 2026.09.01  김형식    최초생성
+ * 2026.09.01  0986406    최초생성
  * 
  * </pre>
  */

dap-gateway/src/main/java/io/shinhanlife/dap/mcg/resilience/FailureType.java

@@ -5,13 +5,13 @@ package io.shinhanlife.dap.mcg.resilience;
  * @package io.shinhanlife.dap.mcg.resilience
  * @className FailureType
  * @description AX HUB 시스템 처리 클래스
- * @author 김형식
+ * @author 0986406
  * @create 2026.09.01
  * <pre>
  * ---------- 개정이력 ----------
  * 수정일      수정자    수정내용
  * ---------- -------- ---------------------------
- * 2026.09.01  김형식    최초생성
+ * 2026.09.01  0986406    최초생성
  * 
  * </pre>
  */

dap-gateway/src/main/java/io/shinhanlife/dap/mcg/resilience/RetryPolicy.java

@@ -5,13 +5,13 @@ package io.shinhanlife.dap.mcg.resilience;
  * @package io.shinhanlife.dap.mcg.resilience
  * @className RetryPolicy
  * @description AX HUB 시스템 처리 클래스
- * @author 김형식
+ * @author 0986406
  * @create 2026.09.01
  * <pre>
  * ---------- 개정이력 ----------
  * 수정일      수정자    수정내용
  * ---------- -------- ---------------------------
- * 2026.09.01  김형식    최초생성
+ * 2026.09.01  0986406    최초생성
  * 
  * </pre>
  */

dap-gateway/src/main/java/io/shinhanlife/dap/mcg/resilience/ToolExecutionException.java

@@ -5,13 +5,13 @@ package io.shinhanlife.dap.mcg.resilience;
  * @package io.shinhanlife.dap.mcg.resilience
  * @className ToolExecutionException
  * @description AX HUB 시스템 처리 클래스
- * @author 김형식
+ * @author 0986406
  * @create 2026.09.01
  * <pre>
  * ---------- 개정이력 ----------
  * 수정일      수정자    수정내용
  * ---------- -------- ---------------------------
- * 2026.09.01  김형식    최초생성
+ * 2026.09.01  0986406    최초생성
  * 
  * </pre>
  */

dap-gateway/src/main/java/io/shinhanlife/dap/mcg/security/McpRequestContext.java

@@ -5,13 +5,13 @@ package io.shinhanlife.dap.mcg.security;
  * @package io.shinhanlife.dap.mcg.security
  * @className McpRequestContext
  * @description AX HUB 시스템 처리 클래스
- * @author 김형식
+ * @author 0986406
  * @create 2026.09.01
  * <pre>
  * ---------- 개정이력 ----------
  * 수정일      수정자    수정내용
  * ---------- -------- ---------------------------
- * 2026.09.01  김형식    최초생성
+ * 2026.09.01  0986406    최초생성
  * 
  * </pre>
  */

dap-gateway/src/main/java/io/shinhanlife/dap/mcg/security/McpRequestContextResolver.java

@@ -5,13 +5,13 @@ package io.shinhanlife.dap.mcg.security;
  * @package io.shinhanlife.dap.mcg.security
  * @className McpRequestContextResolver
  * @description AX HUB 시스템 처리 클래스
- * @author 김형식
+ * @author 0986406
  * @create 2026.09.01
  * <pre>
  * ---------- 개정이력 ----------
  * 수정일      수정자    수정내용
  * ---------- -------- ---------------------------
- * 2026.09.01  김형식    최초생성
+ * 2026.09.01  0986406    최초생성
  * 
  * </pre>
  */

dap-gateway/src/main/java/io/shinhanlife/dap/mcg/security/ToolAuthorizationService.java

@@ -5,13 +5,13 @@ package io.shinhanlife.dap.mcg.security;
  * @package io.shinhanlife.dap.mcg.security
  * @className ToolAuthorizationService
  * @description AX HUB 시스템 처리 클래스
- * @author 김형식
+ * @author 0986406
  * @create 2026.09.01
  * <pre>
  * ---------- 개정이력 ----------
  * 수정일      수정자    수정내용
  * ---------- -------- ---------------------------
- * 2026.09.01  김형식    최초생성
+ * 2026.09.01  0986406    최초생성
  * 
  * </pre>
  */

dap-gateway/src/main/java/io/shinhanlife/dap/mcg/service/ExecuteService.java

@@ -5,13 +5,13 @@ package io.shinhanlife.dap.mcg.service;
  * @package io.shinhanlife.dap.mcg.service
  * @className ExecuteService
  * @description AX HUB 시스템 처리 클래스
- * @author 김형식
+ * @author 0986406
  * @create 2026.09.01
  * <pre>
  * ---------- 개정이력 ----------
  * 수정일      수정자    수정내용
  * ---------- -------- ---------------------------
- * 2026.09.01  김형식    최초생성
+ * 2026.09.01  0986406    최초생성
  * 
  * </pre>
  */
@@ -162,22 +162,53 @@ public class ExecuteService {
             long elapsedMillis = elapsedMillis(startedAt);
             
             String responseText = "";
-            try { responseText = objectMapper.writeValueAsString(result); } catch (Exception ignore) {}
+            long originalSize = 0;
+            try { 
+                responseText = objectMapper.writeValueAsString(result); 
+                originalSize = responseText.getBytes(java.nio.charset.StandardCharsets.UTF_8).length;
+            } catch (Exception ignore) {}
+            
+            Map<String, Object> finalResult = new java.util.LinkedHashMap<>();
+            finalResult.put("status", "ok");
+            finalResult.put("result", result);
+            finalResult.put("error_code", null);
+            finalResult.put("error_message", null);
+            finalResult.put("elapsed_ms", elapsedMillis);
+            finalResult.put("truncated", false);
+            finalResult.put("original_size", originalSize);
             
             auditLogService.toolFinished(context, metadata.getName(), elapsedMillis, true, "");
             redisTrace.finished(context, metadata, argumentsNode, elapsedMillis, true, "", responseText);
             
-            return result;
+            return finalResult;
         } catch (ToolExecutionException error) {
             long elapsedMillis = elapsedMillis(startedAt);
             auditLogService.toolFinished(context, toolName, elapsedMillis, false, error.failureType().name());
             redisTrace.finished(context, metadata, argumentsNode, elapsedMillis, false, error.failureType().name(), "");
-            throw error;
+            
+            Map<String, Object> errorResult = new java.util.LinkedHashMap<>();
+            errorResult.put("status", "error");
+            errorResult.put("result", null);
+            errorResult.put("error_code", error.failureType().name());
+            errorResult.put("error_message", error.getMessage());
+            errorResult.put("elapsed_ms", elapsedMillis);
+            errorResult.put("truncated", false);
+            errorResult.put("original_size", 0);
+            return errorResult;
         } catch (Exception error) {
             long elapsedMillis = elapsedMillis(startedAt);
             auditLogService.toolFinished(context, toolName, elapsedMillis, false, FailureType.INTERNAL_ERROR.name());
             redisTrace.finished(context, metadata, argumentsNode, elapsedMillis, false, FailureType.INTERNAL_ERROR.name(), "");
-            throw new ToolExecutionException(FailureType.INTERNAL_ERROR, "Tool execution failed: " + toolName, error);
+            
+            Map<String, Object> errorResult = new java.util.LinkedHashMap<>();
+            errorResult.put("status", "error");
+            errorResult.put("result", null);
+            errorResult.put("error_code", FailureType.INTERNAL_ERROR.name());
+            errorResult.put("error_message", error.getMessage());
+            errorResult.put("elapsed_ms", elapsedMillis);
+            errorResult.put("truncated", false);
+            errorResult.put("original_size", 0);
+            return errorResult;
         }
     }
 
@@ -230,20 +261,17 @@ public class ExecuteService {
                     if (metadata.getPodUrl() != null && !metadata.getPodUrl().isEmpty()) {
                         targetUrl = metadata.getPodUrl();
                     }
-                    String executeApiUrl = targetUrl + "/mcp/api/v1/tools/call";
+                    String executeApiUrl = targetUrl + "/mcp/" + metadata.getName();
+                    
+                    Map<String, String> headers = new java.util.HashMap<>();
+                    headers.put("trace-id", context.requestId());
+                    headers.put("request-id", java.util.UUID.randomUUID().toString());
                     
                     ObjectNode pageArguments = paginationValidator.normalize(arguments);
                     LargeToolResponseService.Collector collector = largeResponses.newCollector(metadata.getName(), context.requestId());
 
                     while (true) {
-                        Map<String, Object> pagePayload = new HashMap<>(payload);
-                        if (pagePayload.containsKey("params")) {
-                            Map<String, Object> params = new HashMap<>((Map<String, Object>) pagePayload.get("params"));
-                            params.put("arguments", objectMapper.convertValue(pageArguments, Map.class));
-                            pagePayload.put("params", params);
-                        } else {
-                            pagePayload.put("arguments", objectMapper.convertValue(pageArguments, Map.class));
-                        }
+                        Map<String, Object> pagePayload = objectMapper.convertValue(pageArguments, Map.class);
                         
                         try {
                             log.info(" [ExecuteService] 요청 페이로드(마스킹 적용): {}", objectMapper.writeValueAsString(dataMasker.mask(objectMapper.valueToTree(pagePayload))));
@@ -251,13 +279,16 @@ public class ExecuteService {
                         
                         JsonNode data = null;
                         try {
-                            data = toolInvoker.invoke(pagePayload, executeApiUrl);
+                            data = toolInvoker.invoke(pagePayload, executeApiUrl, headers);
+                        } catch (org.springframework.web.client.RestClientResponseException e) {
+                            // HTTP 4xx, 5xx 에러는 연결 오류가 아니라 비즈니스 로직 오류이거나 검증 실패이므로 원본 에러를 그대로 반환
+                            throw new ToolExecutionException(FailureType.SERVER_ERROR, "Tool Pod HTTP 에러 (" + e.getStatusCode() + "): " + e.getResponseBodyAsString());
                         } catch (Exception e) {
                             if (executeApiUrl.contains("http://tool-")) {
                                 String fallbackUrl = executeApiUrl.replaceAll("http://tool-[a-zA-Z0-9-]+", "http://localhost");
                                 log.warn(" [ExecuteService] 호스트를 찾을 수 없어 localhost로 재시도합니다: {}", fallbackUrl);
                                 try {
-                                    data = toolInvoker.invoke(pagePayload, fallbackUrl);
+                                    data = toolInvoker.invoke(pagePayload, fallbackUrl, headers);
                                 } catch (Exception ex) {
                                     throw new ToolExecutionException(FailureType.SERVER_ERROR, "Tool Pod 호출 실패 (localhost 재시도 포함): " + ex.getMessage());
                                 }

dap-gateway/src/main/java/io/shinhanlife/dap/mcg/service/KillSwitchService.java

@@ -9,13 +9,13 @@ import org.springframework.stereotype.Service;
  * @package io.shinhanlife.dap.mcg.service
  * @className KillSwitchService
  * @description AX HUB 시스템 처리 클래스
- * @author 김형식
+ * @author 0986406
  * @create 2026.09.01
  * <pre>
  * ---------- 개정이력 ----------
  * 수정일      수정자    수정내용
  * ---------- -------- ---------------------------
- * 2026.09.01  김형식    최초생성
+ * 2026.09.01  0986406    최초생성
  * 
  * </pre>
  */

dap-gateway/src/main/java/io/shinhanlife/dap/mcg/service/ToolPlanner.java

@@ -1,6 +1,6 @@
 package io.shinhanlife.dap.mcg.service;
 
-import io.shinhanlife.dap.common.mcp.security.SecurityProperties;
+import io.shinhanlife.dap.lib.mcp.security.SecurityProperties;
 import io.shinhanlife.dap.mcg.registry.RedisRegistryService;
 import io.shinhanlife.dap.mcg.dto.ToolMetadata;
 import io.shinhanlife.dap.mcg.config.GatewayFallbackProperties;
@@ -15,13 +15,13 @@ import java.util.Map;
  * @package io.shinhanlife.dap.mcg.service
  * @className ToolPlanner
  * @description AX HUB 시스템 처리 클래스
- * @author 김형식
+ * @author 0986406
  * @create 2026.09.01
  * <pre>
  * ---------- 개정이력 ----------
  * 수정일      수정자    수정내용
  * ---------- -------- ---------------------------
- * 2026.09.01  김형식    최초생성
+ * 2026.09.01  0986406    최초생성
  * 
  * </pre>
  */

dap-gateway/src/main/java/io/shinhanlife/dap/mcg/sync/CustomWebMvcSseServerTransportProvider.java

@@ -4,13 +4,13 @@ package io.shinhanlife.dap.mcg.sync;
  * @package io.shinhanlife.dap.mcg.sync
  * @className CustomWebMvcSseServerTransportProvider
  * @description AX HUB MCP Gateway SSE 전송 제공자 - SSE 기반의 MCP 서버 트랜스포트를 구현하는 클래스
- * @author 김형식
+ * @author 0986406
  * @create 2026.09.01
  * <pre>
  * ---------- 개정이력 ----------
  * 수정일      수정자    수정내용
  * ---------- -------- ---------------------------
- * 2026.09.01  김형식    최초생성
+ * 2026.09.01  0986406    최초생성
  *
  * </pre>
  */
@@ -95,8 +95,8 @@ public class CustomWebMvcSseServerTransportProvider implements McpServerTranspor
         McpServerSession session = sessionFactory.create(sessionTransport);
         sessions.put(sessionId, session);
 
-        emitter.onCompletion(() -> sessions.remove(sessionId));
-        emitter.onTimeout(() -> sessions.remove(sessionId));
+        // emitter.onCompletion(() -> sessions.remove(sessionId));
+        // emitter.onTimeout(() -> sessions.remove(sessionId));
 
         new Thread(() -> {
             try {
@@ -179,8 +179,8 @@ public class CustomWebMvcSseServerTransportProvider implements McpServerTranspor
             log.info("Message sent to session handler");
             
             if (emitter != null && !map.containsKey("id")) {
-                emitter.complete();
-                log.info("Completed emitter for notification");
+                // emitter.complete();
+                log.info("Completed emitter for notification (disabled for keep-alive)");
             }
             
             return ResponseEntity.ok().build();
@@ -220,7 +220,7 @@ public class CustomWebMvcSseServerTransportProvider implements McpServerTranspor
                         
                         // Custom 프로토콜: 1회 요청당 1응답 후 종료 (스트림을 닫아버림)
                         // 클라이언트가 한 번의 POST 후 응답을 받고 연결을 끊기 때문
-                        this.emitter.complete();
+                        // this.emitter.complete();
                     }
                 } catch (Exception e) {
                     log.error("Error sending message to SSE emitter", e);

dap-gateway/src/main/java/io/shinhanlife/dap/mcg/sync/DynamicMcpController.java

@@ -5,13 +5,13 @@ package io.shinhanlife.dap.mcg.sync;
  * @package io.shinhanlife.dap.mcg.sync
  * @className DynamicMcpController
  * @description AX HUB 시스템 처리 클래스
- * @author 김형식
+ * @author 0986406
  * @create 2026.09.01
  * <pre>
  * ---------- 개정이력 ----------
  * 수정일      수정자    수정내용
  * ---------- -------- ---------------------------
- * 2026.09.01  김형식    최초생성
+ * 2026.09.01  0986406    최초생성
  * 
  * </pre>
  */
@@ -84,4 +84,19 @@ public class DynamicMcpController {
                 .header("Mcp-Session-Id", activeSessionId)
                 .body(emitter);
     }
+
+    @org.springframework.web.bind.annotation.DeleteMapping("/mcp/sse/{category}")
+    public ResponseEntity<Void> handleDeleteSse(@PathVariable("category") String category) {
+        return ResponseEntity.ok().build();
+    }
+
+    @GetMapping("/.well-known/oauth-protected-resource")
+    public ResponseEntity<java.util.Map<String, Object>> handleOauthProtectedResource() {
+        return ResponseEntity.ok().body(java.util.Map.of());
+    }
+
+    @GetMapping("/.well-known/oauth-protected-resource/**")
+    public ResponseEntity<java.util.Map<String, Object>> handleOauthProtectedResourceWildcard() {
+        return ResponseEntity.ok().body(java.util.Map.of());
+    }
 }

dap-gateway/src/main/java/io/shinhanlife/dap/mcg/sync/DynamicMcpServerManager.java

@@ -5,13 +5,13 @@ package io.shinhanlife.dap.mcg.sync;
  * @package io.shinhanlife.dap.mcg.sync
  * @className DynamicMcpServerManager
  * @description AX HUB 시스템 처리 클래스
- * @author 김형식
+ * @author 0986406
  * @create 2026.09.01
  * <pre>
  * ---------- 개정이력 ----------
  * 수정일      수정자    수정내용
  * ---------- -------- ---------------------------
- * 2026.09.01  김형식    최초생성
+ * 2026.09.01  0986406    최초생성
  * 
  * </pre>
  */
@@ -53,7 +53,8 @@ public class DynamicMcpServerManager {
         getOrCreateServer("payment");
         getOrCreateServer("sms");
         getOrCreateServer("email");
-        getOrCreateServer("other");
+        getOrCreateServer("oth");
+        getOrCreateServer("sample");
     }
 
     private McpSyncServer getOrCreateServer(String categoryKey) {

dap-gateway/src/main/java/io/shinhanlife/dap/mcg/sync/RegistryMcpToolSpecificationFactory.java

@@ -5,13 +5,13 @@ package io.shinhanlife.dap.mcg.sync;
  * @package io.shinhanlife.dap.mcg.sync
  * @className RegistryMcpToolSpecificationFactory
  * @description AX HUB 시스템 처리 클래스
- * @author 김형식
+ * @author 0986406
  * @create 2026.09.01
  * <pre>
  * ---------- 개정이력 ----------
  * 수정일      수정자    수정내용
  * ---------- -------- ---------------------------
- * 2026.09.01  김형식    최초생성
+ * 2026.09.01  0986406    최초생성
  * 
  * </pre>
  */

dap-gateway/src/main/java/io/shinhanlife/dap/mcg/sync/RegistryMcpToolSynchronizer.java

@@ -22,13 +22,13 @@ import java.util.stream.Collectors;
  * @package io.shinhanlife.dap.mcg.sync
  * @className RegistryMcpToolSynchronizer
  * @description AX HUB 시스템 처리 클래스
- * @author 김형식
+ * @author 0986406
  * @create 2026.09.01
  * <pre>
  * ---------- 개정이력 ----------
  * 수정일      수정자    수정내용
  * ---------- -------- ---------------------------
- * 2026.09.01  김형식    최초생성
+ * 2026.09.01  0986406    최초생성
  * 
  * </pre>
  */

dap-gateway/src/main/java/io/shinhanlife/dap/mcg/tool/large/AgentResponseBudgetService.java

@@ -5,13 +5,13 @@ package io.shinhanlife.dap.mcg.tool.large;
  * @package io.shinhanlife.dap.mcg.tool.large
  * @className AgentResponseBudgetService
  * @description AX HUB 시스템 처리 클래스
- * @author 김형식
+ * @author 0986406
  * @create 2026.09.01
  * <pre>
  * ---------- 개정이력 ----------
  * 수정일      수정자    수정내용
  * ---------- -------- ---------------------------
- * 2026.09.01  김형식    최초생성
+ * 2026.09.01  0986406    최초생성
  * 
  * </pre>
  */

dap-gateway/src/main/java/io/shinhanlife/dap/mcg/tool/large/LargeToolResponseService.java

@@ -5,13 +5,13 @@ package io.shinhanlife.dap.mcg.tool.large;
  * @package io.shinhanlife.dap.mcg.tool.large
  * @className LargeToolResponseService
  * @description AX HUB 시스템 처리 클래스
- * @author 김형식
+ * @author 0986406
  * @create 2026.09.01
  * <pre>
  * ---------- 개정이력 ----------
  * 수정일      수정자    수정내용
  * ---------- -------- ---------------------------
- * 2026.09.01  김형식    최초생성
+ * 2026.09.01  0986406    최초생성
  * 
  * </pre>
  */

dap-gateway/src/main/java/io/shinhanlife/dap/mcg/tool/large/PaginationRequestValidator.java

@@ -5,13 +5,13 @@ package io.shinhanlife.dap.mcg.tool.large;
  * @package io.shinhanlife.dap.mcg.tool.large
  * @className PaginationRequestValidator
  * @description AX HUB 시스템 처리 클래스
- * @author 김형식
+ * @author 0986406
  * @create 2026.09.01
  * <pre>
  * ---------- 개정이력 ----------
  * 수정일      수정자    수정내용
  * ---------- -------- ---------------------------
- * 2026.09.01  김형식    최초생성
+ * 2026.09.01  0986406    최초생성
  * 
  * </pre>
  */

dap-gateway/src/main/java/io/shinhanlife/dap/mcg/tool/result/ToolExecutionResult.java

@@ -5,13 +5,13 @@ package io.shinhanlife.dap.mcg.tool.result;
  * @package io.shinhanlife.dap.mcg.tool.result
  * @className ToolExecutionResult
  * @description AX HUB 시스템 처리 클래스
- * @author 김형식
+ * @author 0986406
  * @create 2026.09.01
  * <pre>
  * ---------- 개정이력 ----------
  * 수정일      수정자    수정내용
  * ---------- -------- ---------------------------
- * 2026.09.01  김형식    최초생성
+ * 2026.09.01  0986406    최초생성
  * 
  * </pre>
  */

dap-gateway/src/main/java/io/shinhanlife/dap/mcg/tool/result/ToolExecutionResultFormatter.java

@@ -5,13 +5,13 @@ package io.shinhanlife.dap.mcg.tool.result;
  * @package io.shinhanlife.dap.mcg.tool.result
  * @className ToolExecutionResultFormatter
  * @description AX HUB 시스템 처리 클래스
- * @author 김형식
+ * @author 0986406
  * @create 2026.09.01
  * <pre>
  * ---------- 개정이력 ----------
  * 수정일      수정자    수정내용
  * ---------- -------- ---------------------------
- * 2026.09.01  김형식    최초생성
+ * 2026.09.01  0986406    최초생성
  * 
  * </pre>
  */

dap-gateway/src/main/java/io/shinhanlife/dap/mcg/transport/HttpToolInvoker.java

@@ -5,13 +5,13 @@ package io.shinhanlife.dap.mcg.transport;
  * @package io.shinhanlife.dap.mcg.transport
  * @className HttpToolInvoker
  * @description AX HUB 시스템 처리 클래스
- * @author 김형식
+ * @author 0986406
  * @create 2026.09.01
  * <pre>
  * ---------- 개정이력 ----------
  * 수정일      수정자    수정내용
  * ---------- -------- ---------------------------
- * 2026.09.01  김형식    최초생성
+ * 2026.09.01  0986406    최초생성
  * 
  * </pre>
  */
@@ -40,14 +40,17 @@ public class HttpToolInvoker implements ToolInvoker {
     }
 
     @Override
-    public JsonNode invoke(Map<String, Object> payload, String targetUrl) {
+    public JsonNode invoke(Map<String, Object> payload, String targetUrl, Map<String, String> headers) {
         try {
-            Object httpResult = restClient.post()
+            RestClient.RequestBodySpec requestSpec = restClient.post()
                     .uri(targetUrl)
-                    .contentType(MediaType.APPLICATION_JSON)
-                    // TODO: Use actual tenant's key
-                    .header("X-Trace-Id", UUID.randomUUID().toString())
-                    .body(payload)
+                    .contentType(MediaType.APPLICATION_JSON);
+                    
+            if (headers != null) {
+                headers.forEach(requestSpec::header);
+            }
+            
+            Object httpResult = requestSpec.body(payload)
                     .retrieve()
                     .body(Object.class);
             

dap-gateway/src/main/java/io/shinhanlife/dap/mcg/transport/ToolInvoker.java

@@ -5,13 +5,13 @@ package io.shinhanlife.dap.mcg.transport;
  * @package io.shinhanlife.dap.mcg.transport
  * @className ToolInvoker
  * @description AX HUB 시스템 처리 클래스
- * @author 김형식
+ * @author 0986406
  * @create 2026.09.01
  * <pre>
  * ---------- 개정이력 ----------
  * 수정일      수정자    수정내용
  * ---------- -------- ---------------------------
- * 2026.09.01  김형식    최초생성
+ * 2026.09.01  0986406    최초생성
  * 
  * </pre>
  */
@@ -22,5 +22,5 @@ import java.util.Map;
  * Tool 서버 호출 transport의 최소 공통 인터페이스입니다.
  */
 public interface ToolInvoker {
-    JsonNode invoke(Map<String, Object> payload, String targetUrl);
+    JsonNode invoke(Map<String, Object> payload, String targetUrl, Map<String, String> headers);
 }

dap-gateway/src/main/java/io/shinhanlife/dap/sample/converter/SampleConverter.java

@@ -1,37 +0,0 @@
-package io.shinhanlife.dap.sample.converter;
-
-import io.shinhanlife.dap.sample.domain.model.AppliSystNtfyPatiModel;
-import io.shinhanlife.dap.sample.dto.AppliSystNtfyRgiInDTO;
-import io.shinhanlife.dap.sample.dto.StrnTermListInDTO;
-import io.shinhanlife.dap.sample.dto.StrnTermListOutDTO;
-import io.shinhanlife.dap.sample.presentation.io.AppliSystNtfyPatiRequest;
-import io.shinhanlife.dap.sample.presentation.io.StrnTermRequest;
-import io.shinhanlife.dap.sample.presentation.io.StrnTermResponse;
-import org.mapstruct.Mapper;
-
-/**
- * @package io.shinhanlife.dap.sample.converter
- * @className SampleConverter
- * @description AX HUB 시스템 처리 클래스
- * @author 김형식
- * @create 2026.09.01
- * <pre>
- * ---------- 개정이력 ----------
- * 수정일      수정자    수정내용
- * ---------- -------- ---------------------------
- * 2026.09.01  김형식    최초생성
- * 
- * </pre>
- */
-@Mapper(componentModel = "spring")
-public abstract class SampleConverter {
-
-    public abstract StrnTermListInDTO convertRequestToDto(StrnTermRequest req);
-
-    public abstract StrnTermResponse convertDtoToResponse(StrnTermListOutDTO outDto);
-
-    public abstract AppliSystNtfyPatiModel convertDtoToModel(AppliSystNtfyRgiInDTO inDto);
-
-    public abstract AppliSystNtfyRgiInDTO convertAppliRequestToDto(AppliSystNtfyPatiRequest request);
-
-}

dap-gateway/src/main/java/io/shinhanlife/dap/sample/domain/model/AppliSystNtfyPatiModel.java

@@ -1,35 +0,0 @@
-package io.shinhanlife.dap.sample.domain.model;
-
-import io.shinhanlife.glow.db.dto.AuditInfo;
-import lombok.*;
-
-/**
- * @package io.shinhanlife.dap.sample.domain.model
- * @className AppliSystNtfyPatiModel
- * @description AX HUB 시스템 처리 클래스
- * @author 김형식
- * @create 2026.09.01
- * <pre>
- * ---------- 개정이력 ----------
- * 수정일      수정자    수정내용
- * ---------- -------- ---------------------------
- * 2026.09.01  김형식    최초생성
- * 
- * </pre>
- */
-@Getter
-@Builder
-@AllArgsConstructor
-@NoArgsConstructor(access = AccessLevel.PROTECTED)
-public class AppliSystNtfyPatiModel extends AuditInfo {
-    private String appliSystNtfyPatiId;
-    private String appliSystNtfyKdCd;
-    private String appliDutjCd;
-    private String appliDutjPrjcCd;
-    private String ntfyMsgCt;
-    private String ntfyOccDt;
-    private String ntfyCfmDt;
-    private String ntfyTrgtPrafNo;
-    private String shmsPmlYn;
-    private String ntfyCfmYn;
-}

dap-gateway/src/main/java/io/shinhanlife/dap/sample/domain/repository/GlowSampleRepository.java

@@ -1,34 +0,0 @@
-package io.shinhanlife.dap.sample.domain.repository;
-
-import io.shinhanlife.dap.sample.domain.model.AppliSystNtfyPatiModel;
-import io.shinhanlife.dap.sample.dto.StrnTermListInDTO;
-import io.shinhanlife.dap.sample.dto.StrnTermListOutDTO;
-import io.shinhanlife.glow.GlowIndexPaging;
-import io.shinhanlife.glow.GlowMybatisMapper;
-import io.shinhanlife.glow.PageInfo;
-
-import java.util.List;
-
-/**
- * @package io.shinhanlife.dap.sample.domain.repository
- * @className GlowSampleRepository
- * @description AX HUB 시스템 처리 클래스
- * @author 김형식
- * @create 2026.09.01
- * <pre>
- * ---------- 개정이력 ----------
- * 수정일      수정자    수정내용
- * ---------- -------- ---------------------------
- * 2026.09.01  김형식    최초생성
- * 
- * </pre>
- */
-@GlowMybatisMapper
-public interface GlowSampleRepository {
-
-    @GlowIndexPaging
-    List<StrnTermListOutDTO.StrnTerm> selectStrnTerm(StrnTermListInDTO inDto, PageInfo pageInfo);
-
-    int insertAppliSystNtfyPati(AppliSystNtfyPatiModel appliSystNtfyPatiModel);
-
-}

dap-gateway/src/main/java/io/shinhanlife/dap/sample/domain/service/GlowSampleService.java

@@ -1,25 +0,0 @@
-package io.shinhanlife.dap.sample.domain.service;
-
-import io.shinhanlife.dap.sample.dto.AppliSystNtfyRgiInDTO;
-import io.shinhanlife.dap.sample.dto.StrnTermListInDTO;
-import io.shinhanlife.dap.sample.dto.StrnTermListOutDTO;
-import io.shinhanlife.glow.PageInfo;
-
-/**
- * @package io.shinhanlife.dap.sample.domain.service
- * @className GlowSampleService
- * @description AX HUB 시스템 처리 클래스
- * @author 김형식
- * @create 2026.09.01
- * <pre>
- * ---------- 개정이력 ----------
- * 수정일      수정자    수정내용
- * ---------- -------- ---------------------------
- * 2026.09.01  김형식    최초생성
- * 
- * </pre>
- */
-public interface GlowSampleService {
-    StrnTermListOutDTO getStrnTerms(StrnTermListInDTO inDto, PageInfo pageInfo);
-    int insertAppliSystNtfyPati(AppliSystNtfyRgiInDTO inDto);
-}

dap-gateway/src/main/java/io/shinhanlife/dap/sample/domain/service/impl/GlowSampleServiceImpl.java

@@ -1,55 +0,0 @@
-package io.shinhanlife.dap.sample.domain.service.impl;
-
-import io.shinhanlife.dap.sample.converter.SampleConverter;
-import io.shinhanlife.dap.sample.domain.model.AppliSystNtfyPatiModel;
-import io.shinhanlife.dap.sample.domain.repository.GlowSampleRepository;
-import io.shinhanlife.dap.sample.domain.service.GlowSampleService;
-import io.shinhanlife.dap.sample.dto.AppliSystNtfyRgiInDTO;
-import io.shinhanlife.dap.sample.dto.StrnTermListInDTO;
-import io.shinhanlife.dap.sample.dto.StrnTermListOutDTO;
-import io.shinhanlife.glow.GlowLogger;
-import io.shinhanlife.glow.GlowLogTarget;
-import io.shinhanlife.glow.PageInfo;
-import lombok.RequiredArgsConstructor;
-import org.springframework.stereotype.Service;
-import java.util.List;
-
-/**
- * @package io.shinhanlife.dap.sample.domain.service.impl
- * @className GlowSampleServiceImpl
- * @description AX HUB 시스템 처리 클래스
- * @author 김형식
- * @create 2026.09.01
- * <pre>
- * ---------- 개정이력 ----------
- * 수정일      수정자    수정내용
- * ---------- -------- ---------------------------
- * 2026.09.01  김형식    최초생성
- * 
- * </pre>
- */
-@Service
-@RequiredArgsConstructor
-public class GlowSampleServiceImpl implements GlowSampleService {
-
-    @GlowLogTarget(GlowLogTarget.Target.FILE)
-    private final GlowLogger log;
-    private final GlowSampleRepository glowSampleRepository;
-    private final SampleConverter sampleConverter;
-
-    @Override
-    public StrnTermListOutDTO getStrnTerms(StrnTermListInDTO inDto, PageInfo pageInfo) {
-        List<StrnTermListOutDTO.StrnTerm> out = glowSampleRepository.selectStrnTerm(inDto, pageInfo);
-        return StrnTermListOutDTO.builder()
-                .strnTerms(out)
-                .pageInfo(pageInfo)
-                .build();
-    }
-
-    @Override
-    public int insertAppliSystNtfyPati(AppliSystNtfyRgiInDTO inDto) {
-        AppliSystNtfyPatiModel appliSystNtfyPatiModel = sampleConverter.convertDtoToModel(inDto);
-        return glowSampleRepository.insertAppliSystNtfyPati(appliSystNtfyPatiModel);
-    }
-
-}

dap-gateway/src/main/java/io/shinhanlife/dap/sample/dto/AppliSystNtfyRgiInDTO.java

@@ -1,41 +0,0 @@
-package io.shinhanlife.dap.sample.dto;
-
-import lombok.Getter;
-import lombok.Setter;
-import lombok.Builder;
-import lombok.NoArgsConstructor;
-import lombok.AllArgsConstructor;
-
-import lombok.*;
-
-/**
- * @package io.shinhanlife.dap.sample.dto
- * @className AppliSystNtfyRgiInDTO
- * @description AX HUB 시스템 처리 클래스
- * @author 김형식
- * @create 2026.09.01
- * <pre>
- * ---------- 개정이력 ----------
- * 수정일      수정자    수정내용
- * ---------- -------- ---------------------------
- * 2026.09.01  김형식    최초생성
- * 
- * </pre>
- */
-@Getter
-@Setter
-@Builder
-@NoArgsConstructor
-@AllArgsConstructor
-public class AppliSystNtfyRgiInDTO {
-    private String appliSystNtfyPatiId;
-    private String appliSystNtfyKdCd;
-    private String appliDutjCd;
-    private String appliDutjPrjcCd;
-    private String ntfyMsgCt;
-    private String ntfyOccDt;
-    private String ntfyCfmDt;
-    private String ntfyTrgtPrafNo;
-    private String shmsPmlYn;
-    private String ntfyCfmYn;
-}

dap-gateway/src/main/java/io/shinhanlife/dap/sample/dto/StrnTermListInDTO.java

@@ -1,31 +0,0 @@
-package io.shinhanlife.dap.sample.dto;
-
-import lombok.NoArgsConstructor;
-import lombok.AllArgsConstructor;
-
-import lombok.Builder;
-import lombok.Getter;
-import lombok.Setter;
-
-/**
- * @package io.shinhanlife.dap.sample.dto
- * @className StrnTermListInDTO
- * @description AX HUB 시스템 처리 클래스
- * @author 김형식
- * @create 2026.09.01
- * <pre>
- * ---------- 개정이력 ----------
- * 수정일      수정자    수정내용
- * ---------- -------- ---------------------------
- * 2026.09.01  김형식    최초생성
- * 
- * </pre>
- */
-@Getter
-@Setter
-@Builder
-@NoArgsConstructor
-@AllArgsConstructor
-public class StrnTermListInDTO {
-    private String strnTermHanNm;
-}

dap-gateway/src/main/java/io/shinhanlife/dap/sample/dto/StrnTermListOutDTO.java

@@ -1,46 +0,0 @@
-package io.shinhanlife.dap.sample.dto;
-
-import lombok.NoArgsConstructor;
-import lombok.AllArgsConstructor;
-
-
-import io.shinhanlife.glow.PageInfo;
-import lombok.Builder;
-import lombok.Getter;
-import lombok.Setter;
-
-import java.util.List;
-
-/**
- * @package io.shinhanlife.dap.sample.dto
- * @className StrnTermListOutDTO
- * @description AX HUB 시스템 처리 클래스
- * @author 김형식
- * @create 2026.09.01
- * <pre>
- * ---------- 개정이력 ----------
- * 수정일      수정자    수정내용
- * ---------- -------- ---------------------------
- * 2026.09.01  김형식    최초생성
- * 
- * </pre>
- */
-@Builder
-@Getter
-@Setter
-@NoArgsConstructor
-@AllArgsConstructor
-public class StrnTermListOutDTO {
-    private List<StrnTerm> strnTerms;
-    private PageInfo pageInfo;
-
-    @Builder
-    @Getter
-    @Setter
-    public static class StrnTerm{
-        private String strnTermHanNm;
-        private String strnTermEngcAbrNm;
-        private String strnTermEngNm;
-        private String strnTermScrnTermNm;
-    }
-}

dap-gateway/src/main/java/io/shinhanlife/dap/sample/presentation/GlowSampleController.java

@@ -1,52 +0,0 @@
-package io.shinhanlife.dap.sample.presentation;
-
-
-import io.shinhanlife.dap.sample.presentation.io.AppliSystNtfyPatiRequest;
-import io.shinhanlife.dap.sample.presentation.io.AppliSystNtfyPatiResponse;
-import io.shinhanlife.dap.sample.presentation.io.StrnTermRequest;
-import io.shinhanlife.dap.sample.presentation.io.StrnTermResponse;
-import io.shinhanlife.dap.sample.usecase.GlowSampleUseCase;
-import io.shinhanlife.glow.*;
-import lombok.RequiredArgsConstructor;
-import org.springframework.http.ResponseEntity;
-import org.springframework.web.bind.annotation.PostMapping;
-import org.springframework.web.bind.annotation.RequestBody;
-import org.springframework.web.bind.annotation.RestController;
-
-/**
- * @package io.shinhanlife.dap.sample.presentation
- * @className GlowSampleController
- * @description AX HUB 시스템 처리 클래스
- * @author 김형식
- * @create 2026.09.01
- * <pre>
- * ---------- 개정이력 ----------
- * 수정일      수정자    수정내용
- * ---------- -------- ---------------------------
- * 2026.09.01  김형식    최초생성
- * 
- * </pre>
- */
-@RestController
-@RequiredArgsConstructor
-
-public class GlowSampleController {
-    @GlowLogTarget({GlowLogTarget.Target.CONSOLE, GlowLogTarget.Target.FILE})
-    private final GlowLogger log;
-    private final GlowSampleUseCase glowSampleUseCase;
-
-    @GlowControllerId(value = "selectStrnTerm")
-    @PostMapping("/selectStrnTerm")
-    public ResponseEntity<BaseResponse<StrnTermResponse>> getStrnTerms(@RequestBody StrnTermRequest request) {
-        return ResponseUtil.ok(glowSampleUseCase.getStrnTerms(request));
-    }
-
-
-    @GlowControllerId(value = "insertAp")
-    @PostMapping("/insertAppliSystNtfyPati")
-    public ResponseEntity<BaseResponse<AppliSystNtfyPatiResponse>> insertAppliSystNtfyPati(@RequestBody AppliSystNtfyPatiRequest request) {
-        return ResponseUtil.ok(glowSampleUseCase.insertAppliSystNtfyPati(request));
-    }
-
-
-}

dap-gateway/src/main/java/io/shinhanlife/dap/sample/presentation/io/AppliSystNtfyPatiRequest.java

@@ -1,34 +0,0 @@
-package io.shinhanlife.dap.sample.presentation.io;
-
-import lombok.*;
-
-/**
- * @package io.shinhanlife.dap.sample.presentation.io
- * @className AppliSystNtfyPatiRequest
- * @description AX HUB 시스템 처리 클래스
- * @author 김형식
- * @create 2026.09.01
- * <pre>
- * ---------- 개정이력 ----------
- * 수정일      수정자    수정내용
- * ---------- -------- ---------------------------
- * 2026.09.01  김형식    최초생성
- * 
- * </pre>
- */
-@Getter
-@Builder
-@NoArgsConstructor(access = AccessLevel.PROTECTED)
-@AllArgsConstructor
-public class AppliSystNtfyPatiRequest {
-    private String appliSystNtfyPatiId;
-    private String appliSystNtfyKdCd;
-    private String appliDutjCd;
-    private String appliDutjPrjcCd;
-    private String ntfyMsgCt;
-    private String ntfyOccDt;
-    private String ntfyCfmDt;
-    private String ntfyTrgtPrafNo;
-    private String shmsPmlYn;
-    private String ntfyCfmYn;
-}

dap-gateway/src/main/java/io/shinhanlife/dap/sample/presentation/io/AppliSystNtfyPatiResponse.java

@@ -1,26 +0,0 @@
-package io.shinhanlife.dap.sample.presentation.io;
-
-import lombok.*;
-
-/**
- * @package io.shinhanlife.dap.sample.presentation.io
- * @className AppliSystNtfyPatiResponse
- * @description AX HUB 시스템 처리 클래스
- * @author 김형식
- * @create 2026.09.01
- * <pre>
- * ---------- 개정이력 ----------
- * 수정일      수정자    수정내용
- * ---------- -------- ---------------------------
- * 2026.09.01  김형식    최초생성
- * 
- * </pre>
- */
-@Getter
-@Builder
-@NoArgsConstructor(access = AccessLevel.PROTECTED)
-@AllArgsConstructor
-public class AppliSystNtfyPatiResponse {
-    private String successYn;
-    private String msg;
-}

dap-gateway/src/main/java/io/shinhanlife/dap/sample/presentation/io/StrnTermRequest.java

@@ -1,28 +0,0 @@
-package io.shinhanlife.dap.sample.presentation.io;
-
-import io.shinhanlife.glow.PageInfo;
-import lombok.*;
-
-/**
- * @package io.shinhanlife.dap.sample.presentation.io
- * @className StrnTermRequest
- * @description AX HUB 시스템 처리 클래스
- * @author 김형식
- * @create 2026.09.01
- * <pre>
- * ---------- 개정이력 ----------
- * 수정일      수정자    수정내용
- * ---------- -------- ---------------------------
- * 2026.09.01  김형식    최초생성
- * 
- * </pre>
- */
-@Getter
-@Builder
-@NoArgsConstructor(access = AccessLevel.PROTECTED)
-@AllArgsConstructor
-public class StrnTermRequest {
-    private PageInfo pageInfo;
-
-    private String strnTermHanNm;
-}

dap-gateway/src/main/java/io/shinhanlife/dap/sample/presentation/io/StrnTermResponse.java

@@ -1,41 +0,0 @@
-package io.shinhanlife.dap.sample.presentation.io;
-
-import io.shinhanlife.glow.PageInfo;
-import lombok.*;
-
-import java.util.List;
-
-/**
- * @package io.shinhanlife.dap.sample.presentation.io
- * @className StrnTermResponse
- * @description AX HUB 시스템 처리 클래스
- * @author 김형식
- * @create 2026.09.01
- * <pre>
- * ---------- 개정이력 ----------
- * 수정일      수정자    수정내용
- * ---------- -------- ---------------------------
- * 2026.09.01  김형식    최초생성
- * 
- * </pre>
- */
-@Getter
-@Builder
-@NoArgsConstructor(access = AccessLevel.PROTECTED)
-@AllArgsConstructor
-public class StrnTermResponse {
-
-    private List<StrnTerm> strnTerms;
-    private PageInfo pageInfo;
-
-    @Builder
-    @Getter
-    @NoArgsConstructor
-    @AllArgsConstructor
-    public static class StrnTerm{
-        private String strnTermHanNm;
-        private String strnTermEngcAbrNm;
-        private String strnTermEngNm;
-        private String strnTermScrnTermNm;
-    }
-}

dap-gateway/src/main/java/io/shinhanlife/dap/sample/usecase/GlowSampleUseCase.java

@@ -1,25 +0,0 @@
-package io.shinhanlife.dap.sample.usecase;
-
-import io.shinhanlife.dap.sample.presentation.io.AppliSystNtfyPatiRequest;
-import io.shinhanlife.dap.sample.presentation.io.AppliSystNtfyPatiResponse;
-import io.shinhanlife.dap.sample.presentation.io.StrnTermRequest;
-import io.shinhanlife.dap.sample.presentation.io.StrnTermResponse;
-
-/**
- * @package io.shinhanlife.dap.sample.usecase
- * @className GlowSampleUseCase
- * @description AX HUB 시스템 처리 클래스
- * @author 김형식
- * @create 2026.09.01
- * <pre>
- * ---------- 개정이력 ----------
- * 수정일      수정자    수정내용
- * ---------- -------- ---------------------------
- * 2026.09.01  김형식    최초생성
- * 
- * </pre>
- */
-public interface GlowSampleUseCase {
-    StrnTermResponse getStrnTerms(StrnTermRequest req);
-    AppliSystNtfyPatiResponse insertAppliSystNtfyPati(AppliSystNtfyPatiRequest req);
-}

dap-gateway/src/main/java/io/shinhanlife/dap/sample/usecase/impl/GlowSampleUseCaseImpl.java

@@ -1,57 +0,0 @@
-package io.shinhanlife.dap.sample.usecase.impl;
-
-import io.shinhanlife.dap.sample.converter.SampleConverter;
-import io.shinhanlife.dap.sample.domain.service.GlowSampleService;
-import io.shinhanlife.dap.sample.dto.StrnTermListOutDTO;
-import io.shinhanlife.dap.sample.presentation.io.AppliSystNtfyPatiRequest;
-import io.shinhanlife.dap.sample.presentation.io.AppliSystNtfyPatiResponse;
-import io.shinhanlife.dap.sample.presentation.io.StrnTermRequest;
-import io.shinhanlife.dap.sample.presentation.io.StrnTermResponse;
-import io.shinhanlife.dap.sample.usecase.GlowSampleUseCase;
-import io.shinhanlife.glow.GlowAppServiceId;
-import io.shinhanlife.glow.GlowLogTarget;
-import io.shinhanlife.glow.GlowLogger;
-import io.shinhanlife.glow.GlowServiceGroupId;
-import lombok.RequiredArgsConstructor;
-import org.springframework.stereotype.Service;
-
-/**
- * @package io.shinhanlife.dap.sample.usecase.impl
- * @className GlowSampleUseCaseImpl
- * @description AX HUB 시스템 처리 클래스
- * @author 김형식
- * @create 2026.09.01
- * <pre>
- * ---------- 개정이력 ----------
- * 수정일      수정자    수정내용
- * ---------- -------- ---------------------------
- * 2026.09.01  김형식    최초생성
- * 
- * </pre>
- */
-@Service
-@RequiredArgsConstructor
-@GlowServiceGroupId(value = "GlowSample", description="GlowSampleUseCase")
-public class GlowSampleUseCaseImpl implements GlowSampleUseCase {
-    @GlowLogTarget(GlowLogTarget.Target.FILE)
-    private final GlowLogger log;
-    private final GlowSampleService glowSampleService;
-    private final SampleConverter converter;
-
-    @GlowAppServiceId(value = "SAMPLE-DB-0001", description = "표준용어조회(DB)")
-    public StrnTermResponse getStrnTerms(StrnTermRequest req) {
-        StrnTermListOutDTO outDto = glowSampleService.getStrnTerms(converter.convertRequestToDto(req), req.getPageInfo());
-
-        return converter.convertDtoToResponse(outDto);
-    }
-
-    @GlowAppServiceId(value = "SAMPLE-DB-0002", description = "어플리케이션시스템알림내역등록")
-    public AppliSystNtfyPatiResponse insertAppliSystNtfyPati(AppliSystNtfyPatiRequest req) {
-        int rtn = glowSampleService.insertAppliSystNtfyPati(converter.convertAppliRequestToDto(req));
-
-        return AppliSystNtfyPatiResponse.builder()
-                .successYn(rtn > 0 ? "Y" : "N")
-                .msg(rtn > 0 ? "성공적으로 처리 되었습니다." : "처리중 오류발생!!")
-                .build();
-    }
-}

dap-gateway/src/main/resources/SOATM0100_DDL.sql

@@ -1,160 +0,0 @@
--- ============================================================
--- AX HUB 역할-Tool/지식 권한 관리 DDL
--- 대상 스키마 : 프로젝트 AP 스키마 (S_EIAM_TIS 는 읽기전용 참조)
--- 작성일 : 2026-06-25
--- ============================================================
-
--- ① Tool 마스터
-CREATE TABLE AX_TOOL_MST (
-    TOOL_ID          VARCHAR(20)  NOT NULL,   -- Tool ID (PK)
-    TOOL_NM          VARCHAR(100) NOT NULL,   -- Tool명
-    TOOL_DS          VARCHAR(500),            -- Tool설명
-    TOOL_TYPE_CD     VARCHAR(20),             -- Tool유형코드 (MCP / FUNC / EXT)
-    PUSE_YN          VARCHAR(1)   DEFAULT 'Y',-- 사용여부
-    SYST_RGI_DT      DATE,
-    SYST_RGI_PRAF_NO VARCHAR(8),
-    SYST_RGI_OGNZ_NO VARCHAR(7),
-    SYST_RGI_SYST_CD VARCHAR(3),
-    SYST_RGI_PRGR_ID VARCHAR(100),
-    SYST_CHG_DT      DATE,
-    SYST_CHG_PRAF_NO VARCHAR(8),
-    SYST_CHG_OGNZ_NO VARCHAR(7),
-    SYST_CHG_SYST_CD VARCHAR(3),
-    SYST_CHG_PRGR_ID VARCHAR(100),
-    CONSTRAINT PK_AX_TOOL_MST PRIMARY KEY (TOOL_ID)
-);
-
-COMMENT ON TABLE  AX_TOOL_MST              IS 'AX HUB Tool 마스터';
-COMMENT ON COLUMN AX_TOOL_MST.TOOL_ID      IS 'Tool ID (PK)';
-COMMENT ON COLUMN AX_TOOL_MST.TOOL_NM      IS 'Tool명';
-COMMENT ON COLUMN AX_TOOL_MST.TOOL_DS      IS 'Tool설명';
-COMMENT ON COLUMN AX_TOOL_MST.TOOL_TYPE_CD IS 'Tool유형코드 (MCP/FUNC/EXT)';
-COMMENT ON COLUMN AX_TOOL_MST.PUSE_YN      IS '사용여부 (Y/N)';
-
-
--- ② 지식(Knowledge) 마스터
-CREATE TABLE AX_KNWL_MST (
-    KNWL_ID          VARCHAR(20)  NOT NULL,   -- 지식 ID (PK)
-    KNWL_NM          VARCHAR(100) NOT NULL,   -- 지식명
-    KNWL_DS          VARCHAR(500),            -- 지식설명
-    KNWL_TYPE_CD     VARCHAR(20),             -- 지식유형코드 (PRODUCT/MANUAL/LEGAL 등)
-    PUSE_YN          VARCHAR(1)   DEFAULT 'Y',
-    SYST_RGI_DT      DATE,
-    SYST_RGI_PRAF_NO VARCHAR(8),
-    SYST_RGI_OGNZ_NO VARCHAR(7),
-    SYST_RGI_SYST_CD VARCHAR(3),
-    SYST_RGI_PRGR_ID VARCHAR(100),
-    SYST_CHG_DT      DATE,
-    SYST_CHG_PRAF_NO VARCHAR(8),
-    SYST_CHG_OGNZ_NO VARCHAR(7),
-    SYST_CHG_SYST_CD VARCHAR(3),
-    SYST_CHG_PRGR_ID VARCHAR(100),
-    CONSTRAINT PK_AX_KNWL_MST PRIMARY KEY (KNWL_ID)
-);
-
-COMMENT ON TABLE  AX_KNWL_MST              IS 'AX HUB 지식 마스터';
-COMMENT ON COLUMN AX_KNWL_MST.KNWL_ID      IS '지식 ID (PK)';
-COMMENT ON COLUMN AX_KNWL_MST.KNWL_NM      IS '지식명';
-COMMENT ON COLUMN AX_KNWL_MST.KNWL_DS      IS '지식설명';
-COMMENT ON COLUMN AX_KNWL_MST.KNWL_TYPE_CD IS '지식유형코드 (PRODUCT/MANUAL/LEGAL/REPORT)';
-COMMENT ON COLUMN AX_KNWL_MST.PUSE_YN      IS '사용여부 (Y/N)';
-
-
--- ③ 역할-Tool 권한 매핑
---   SYST_ID + ROLE_NO → S_EIAM_TIS.AA_ROLE 참조 (FK 미설정: 스키마 분리 환경)
-CREATE TABLE AX_ROLE_TOOL_ATHR (
-    ROLE_TOOL_ATHR_ID VARCHAR(20)  NOT NULL,  -- 역할Tool권한ID (PK)
-    SYST_ID           VARCHAR(10)  NOT NULL,  -- 시스템ID (EIAM 연동 키)
-    ROLE_NO           VARCHAR(50)  NOT NULL,  -- 역할번호 (EIAM AA_ROLE.ROLE_NO)
-    TOOL_ID           VARCHAR(20)  NOT NULL,  -- Tool ID
-    PUSE_YN           VARCHAR(1)   DEFAULT 'Y',
-    SYST_RGI_DT       DATE,
-    SYST_RGI_PRAF_NO  VARCHAR(8),
-    SYST_RGI_OGNZ_NO  VARCHAR(7),
-    SYST_RGI_SYST_CD  VARCHAR(3),
-    SYST_RGI_PRGR_ID  VARCHAR(100),
-    SYST_CHG_DT       DATE,
-    SYST_CHG_PRAF_NO  VARCHAR(8),
-    SYST_CHG_OGNZ_NO  VARCHAR(7),
-    SYST_CHG_SYST_CD  VARCHAR(3),
-    SYST_CHG_PRGR_ID  VARCHAR(100),
-    CONSTRAINT PK_AX_ROLE_TOOL_ATHR PRIMARY KEY (ROLE_TOOL_ATHR_ID)
-);
-
--- (SYST_ID, ROLE_NO, TOOL_ID) 중복 방지
-CREATE UNIQUE INDEX UK_AX_ROLE_TOOL_ATHR
-    ON AX_ROLE_TOOL_ATHR (SYST_ID, ROLE_NO, TOOL_ID);
-
-COMMENT ON TABLE  AX_ROLE_TOOL_ATHR                   IS '역할-Tool 권한 매핑';
-COMMENT ON COLUMN AX_ROLE_TOOL_ATHR.ROLE_TOOL_ATHR_ID IS '역할Tool권한ID (PK)';
-COMMENT ON COLUMN AX_ROLE_TOOL_ATHR.SYST_ID           IS '시스템ID';
-COMMENT ON COLUMN AX_ROLE_TOOL_ATHR.ROLE_NO           IS '역할번호 (EIAM)';
-COMMENT ON COLUMN AX_ROLE_TOOL_ATHR.TOOL_ID           IS 'Tool ID';
-COMMENT ON COLUMN AX_ROLE_TOOL_ATHR.PUSE_YN           IS '사용여부';
-
-
--- ④ 역할-지식 권한 매핑
-CREATE TABLE AX_ROLE_KNWL_ATHR (
-    ROLE_KNWL_ATHR_ID VARCHAR(20)  NOT NULL,  -- 역할지식권한ID (PK)
-    SYST_ID           VARCHAR(10)  NOT NULL,
-    ROLE_NO           VARCHAR(50)  NOT NULL,
-    KNWL_ID           VARCHAR(20)  NOT NULL,
-    PUSE_YN           VARCHAR(1)   DEFAULT 'Y',
-    SYST_RGI_DT       DATE,
-    SYST_RGI_PRAF_NO  VARCHAR(8),
-    SYST_RGI_OGNZ_NO  VARCHAR(7),
-    SYST_RGI_SYST_CD  VARCHAR(3),
-    SYST_RGI_PRGR_ID  VARCHAR(100),
-    SYST_CHG_DT       DATE,
-    SYST_CHG_PRAF_NO  VARCHAR(8),
-    SYST_CHG_OGNZ_NO  VARCHAR(7),
-    SYST_CHG_SYST_CD  VARCHAR(3),
-    SYST_CHG_PRGR_ID  VARCHAR(100),
-    CONSTRAINT PK_AX_ROLE_KNWL_ATHR PRIMARY KEY (ROLE_KNWL_ATHR_ID)
-);
-
-CREATE UNIQUE INDEX UK_AX_ROLE_KNWL_ATHR
-    ON AX_ROLE_KNWL_ATHR (SYST_ID, ROLE_NO, KNWL_ID);
-
-COMMENT ON TABLE  AX_ROLE_KNWL_ATHR                   IS '역할-지식 권한 매핑';
-COMMENT ON COLUMN AX_ROLE_KNWL_ATHR.ROLE_KNWL_ATHR_ID IS '역할지식권한ID (PK)';
-COMMENT ON COLUMN AX_ROLE_KNWL_ATHR.SYST_ID           IS '시스템ID';
-COMMENT ON COLUMN AX_ROLE_KNWL_ATHR.ROLE_NO           IS '역할번호 (EIAM)';
-COMMENT ON COLUMN AX_ROLE_KNWL_ATHR.KNWL_ID           IS '지식ID';
-COMMENT ON COLUMN AX_ROLE_KNWL_ATHR.PUSE_YN           IS '사용여부';
-
-
--- ============================================================
--- 샘플 데이터 (개발용)
--- ============================================================
-INSERT INTO AX_TOOL_MST
-    (TOOL_ID, TOOL_NM, TOOL_DS, TOOL_TYPE_CD, PUSE_YN,
-     SYST_RGI_DT, SYST_RGI_PRAF_NO, SYST_RGI_OGNZ_NO, SYST_RGI_SYST_CD, SYST_RGI_PRGR_ID,
-     SYST_CHG_DT, SYST_CHG_PRAF_NO, SYST_CHG_OGNZ_NO, SYST_CHG_SYST_CD, SYST_CHG_PRGR_ID)
-VALUES
-    ('TOOL_A', '지식 검색', '지식베이스 내 문서 의미 기반 검색', 'MCP', 'Y',
-     CURRENT_DATE, 'SYSTEM', 'SYSTEM', 'AXH', 'SOATM0100',
-     CURRENT_DATE, 'SYSTEM', 'SYSTEM', 'AXH', 'SOATM0100'),
-    ('TOOL_B', 'DB 조회', '사내 데이터베이스 직접 조회 (GLOW)', 'MCP', 'Y',
-     CURRENT_DATE, 'SYSTEM', 'SYSTEM', 'AXH', 'SOATM0100',
-     CURRENT_DATE, 'SYSTEM', 'SYSTEM', 'AXH', 'SOATM0100'),
-    ('TOOL_C', '문서 생성', 'AI 기반 문서 초안 자동 생성', 'FUNC', 'Y',
-     CURRENT_DATE, 'SYSTEM', 'SYSTEM', 'AXH', 'SOATM0100',
-     CURRENT_DATE, 'SYSTEM', 'SYSTEM', 'AXH', 'SOATM0100');
-
-INSERT INTO AX_KNWL_MST
-    (KNWL_ID, KNWL_NM, KNWL_DS, KNWL_TYPE_CD, PUSE_YN,
-     SYST_RGI_DT, SYST_RGI_PRAF_NO, SYST_RGI_OGNZ_NO, SYST_RGI_SYST_CD, SYST_RGI_PRGR_ID,
-     SYST_CHG_DT, SYST_CHG_PRAF_NO, SYST_CHG_OGNZ_NO, SYST_CHG_SYST_CD, SYST_CHG_PRGR_ID)
-VALUES
-    ('KNWL_Q', '상품기초서류', '보험 상품 기초서류 약 8만건', 'PRODUCT', 'Y',
-     CURRENT_DATE, 'SYSTEM', 'SYSTEM', 'AXH', 'SOATM0100',
-     CURRENT_DATE, 'SYSTEM', 'SYSTEM', 'AXH', 'SOATM0100'),
-    ('KNWL_W', '업무매뉴얼', '내부 업무 매뉴얼 및 프로세스 가이드', 'MANUAL', 'Y',
-     CURRENT_DATE, 'SYSTEM', 'SYSTEM', 'AXH', 'SOATM0100',
-     CURRENT_DATE, 'SYSTEM', 'SYSTEM', 'AXH', 'SOATM0100'),
-    ('KNWL_E', '법률/규정', '보험업법 및 금융당국 규정', 'LEGAL', 'Y',
-     CURRENT_DATE, 'SYSTEM', 'SYSTEM', 'AXH', 'SOATM0100',
-     CURRENT_DATE, 'SYSTEM', 'SYSTEM', 'AXH', 'SOATM0100');
-
-COMMIT;

dap-gateway/src/main/resources/application-dev.properties

@@ -1,19 +0,0 @@
-# Dev 환경 전용 설정 (개발 서버 DB 연결 정보 등)
-# spring.datasource.url=jdbc:oracle:thin:@//dev-db-host:1521/XEPDB1
-# spring.datasource.driverClassName=oracle.jdbc.OracleDriver
-# spring.datasource.username=dev_user
-# spring.datasource.password=dev_password
-
-# Render 클라우드 환경 전용 Fallback 라우팅
-mcp.gateway.fallback.routes.sms=https://dap-tool-sms.onrender.com
-mcp.gateway.fallback.routes.email=https://dap-tool-email.onrender.com
-mcp.gateway.fallback.default-url=https://dap-tool-other.onrender.com
-mcp.gateway.fallback.routes.payment=https://dap-tool-payment.onrender.com
-mcp.gateway.fallback.routes.hr=https://dap-tool-hr.onrender.com
-
-# --- 신한라이프 EAI/MCI 연계 IP 정보 (개발 환경) ---
-shinhan.integration.envrTypeCd=D
-shinhan.integration.eai.url=http://10.176.32.181
-shinhan.integration.internalMci.url=http://10.176.32.173
-shinhan.integration.bancaMci.url=http://10.176.32.117
-shinhan.integration.externalMci.url=http://10.176.32.176

dap-gateway/src/main/resources/application-dev.yml

@@ -0,0 +1,29 @@
+# Dev 환경 전용 설정 (개발 서버 DB 연결 정보 등)
+# spring:
+#   datasource:
+#     url: jdbc:oracle:thin:@//dev-db-host:1521/XEPDB1
+#     driverClassName: oracle.jdbc.OracleDriver
+#     username: dev_user
+#     password: dev_password
+
+# OCI (Oracle Cloud) 개발 환경 라우팅
+mcp:
+  gateway:
+    fallback:
+      default-url: http://tool-oth:8084
+      routes:
+        sms: http://tool-sms:8082
+        hr: http://tool-oth:8084
+
+# --- 신한라이프 EAI/MCI 연계 IP 정보 (개발 환경) ---
+shinhan:
+  integration:
+    envrTypeCd: D
+    eai:
+      url: http://10.176.32.181
+    internalMci:
+      url: http://10.176.32.173
+    bancaMci:
+      url: http://10.176.32.117
+    externalMci:
+      url: http://10.176.32.176

dap-gateway/src/main/resources/application-local.properties

@@ -1,27 +0,0 @@
-# Local ?섍꼍 ?꾩슜 ?ㅼ젙 (H2 硫붾え由?DB ??
-spring.datasource.url=jdbc:p6spy:h2:mem:testdb;DB_CLOSE_DELAY=-1;
-spring.datasource.driverClassName=com.p6spy.engine.spy.P6SpyDriver
-spring.datasource.username=sa
-spring.datasource.password=password
-
-spring.h2.console.enabled=true
-# EIMS 동적 라우팅 접속 정보
-eims.http.url=http://localhost:${server.port}/api/gateway
-eims.tcp.host=127.0.0.1
-eims.tcp.port=8090
-eims.tcp.timeout=5000
-eims.jsp.form.url=http://localhost:${server.port}/mock/jsp-form
-eims.jsp.json.url=http://localhost:${server.port}/mock/jsp-json
-eims.mci.url=http://localhost:${server.port}/api/mock/esb/api
-eims.mcistring.url=http://localhost:${server.port}/api/mock/esb/string
-
-# Gateway/Tool URLs
-mcp.adapter.url=http://localhost:${server.port}/rpc/v1/execute
-mcp.gateway.url=http://localhost:${server.port}/mcp/api/v1
-mcp.tool.host=localhost
-
-# Disable Kafka
-spring.autoconfigure.exclude=org.springframework.boot.autoconfigure.kafka.KafkaAutoConfiguration
-
-# Suppress Kafka Connection Logs
-logging.level.org.apache.kafka=ERROR

dap-gateway/src/main/resources/application-local.yml

@@ -0,0 +1,48 @@
+# Local 환경 전용 설정 (H2 메모리 DB 등)
+spring:
+  datasource:
+    url: jdbc:p6spy:h2:mem:testdb;DB_CLOSE_DELAY=-1;
+    driverClassName: com.p6spy.engine.spy.P6SpyDriver
+    username: sa
+    password: password
+  h2:
+    console:
+      enabled: true
+  autoconfigure:
+    exclude: org.springframework.boot.autoconfigure.kafka.KafkaAutoConfiguration
+
+eims:
+  http:
+    url: http://localhost:${server.port}/api/gateway
+  tcp:
+    host: 127.0.0.1
+    port: 8090
+    timeout: 5000
+  jsp:
+    form:
+      url: http://localhost:${server.port}/mock/jsp-form
+    json:
+      url: http://localhost:${server.port}/mock/jsp-json
+  mci:
+    url: http://localhost:${server.port}/api/mock/esb/api
+  mcistring:
+    url: http://localhost:${server.port}/api/mock/esb/string
+
+mcp:
+  adapter:
+    url: http://localhost:${server.port}/rpc/v1/execute
+  gateway:
+    url: http://localhost:${server.port}/mcp/api/v1
+    fallback:
+      default-url: http://localhost:8084
+      routes:
+        sms: http://localhost:8082
+        email: http://localhost:8083
+        payment: http://localhost:8085
+        hr: http://localhost:8084
+  tool:
+    host: localhost
+
+logging:
+  level:
+    org.apache.kafka: ERROR

dap-gateway/src/main/resources/application-prod.properties

@@ -1,12 +0,0 @@
-# Prod 환경 전용 설정 (운영 서버 DB 연결 정보 등)
-# spring.datasource.url=jdbc:oracle:thin:@//prod-db-host:1521/PROD
-# spring.datasource.driverClassName=oracle.jdbc.OracleDriver
-# spring.datasource.username=prod_user
-# spring.datasource.password=prod_password
-
-# --- 신한라이프 EAI/MCI 연계 IP 정보 (운영 환경) ---
-shinhan.integration.envrTypeCd=R
-shinhan.integration.eai.url=http://10.172.32.181
-shinhan.integration.internalMci.url=http://10.172.32.173
-shinhan.integration.bancaMci.url=http://10.172.32.117
-shinhan.integration.externalMci.url=http://10.172.32.177

dap-gateway/src/main/resources/application-prod.yml

@@ -0,0 +1,20 @@
+# Prod 환경 전용 설정 (운영 서버 DB 연결 정보 등)
+# spring:
+#   datasource:
+#     url: jdbc:oracle:thin:@//prod-db-host:1521/PROD
+#     driverClassName: oracle.jdbc.OracleDriver
+#     username: prod_user
+#     password: prod_password
+
+# --- 신한라이프 EAI/MCI 연계 IP 정보 (운영 환경) ---
+shinhan:
+  integration:
+    envrTypeCd: R
+    eai:
+      url: http://10.172.32.181
+    internalMci:
+      url: http://10.172.32.173
+    bancaMci:
+      url: http://10.172.32.117
+    externalMci:
+      url: http://10.172.32.177

dap-gateway/src/main/resources/application.properties

@@ -1,52 +0,0 @@
-spring.application.name=dap-admin
-
-# Gateway Fallback Routing (For unregistered tools)
-mcp.gateway.fallback.routes.sms=http://tool-sms:8082
-mcp.gateway.fallback.routes.email=http://tool-email:8083
-mcp.gateway.fallback.default-url=http://tool-other:8084
-mcp.gateway.fallback.routes.payment=http://tool-payment:8085
-mcp.gateway.fallback.routes.hr=http://tool-hr:8086
-
-
-
-server.port=8081
-server.http2.enabled=true
-
-# 기본적으로 local 환경을 실행
-spring.profiles.active=local
-
-# MyBatis 공통 설정
-mybatis.mapper-locations=classpath:mapper/**/*.xml
-mybatis.type-aliases-package=
-mybatis.configuration.map-underscore-to-camel-case=true
-spring.sql.init.mode=always
-
-logging.level.com.corundumstudio.socketio=DEBUG
-
-# 우아한 종료 (Graceful Shutdown) 설정
-server.shutdown=graceful
-spring.lifecycle.timeout-per-shutdown-phase=20s
-# Suppress Kafka Connection Logs
-logging.level.org.apache.kafka=ERROR
-
-# Spring AI MCP Server Settings
-# spring.ai.mcp.server.protocol=STATELESS
-mcp.agent-claims-required=false
-mcp.trusted-claims-required=false
-mcp.write-approval-required=false
-mcp.default-page-size=100
-mcp.max-page-size=500
-mcp.max-pages-per-call=3
-mcp.max-stream-bytes=1048576
-mcp.max-response-bytes-from-tool=5242880
-mcp.tool-registry-sync-interval-millis=5000
-
-# API 보안 키 설정
-mcp.security.tenant-domains.TESTER-DEV=ALL
-mcp.security.tenant-domains.system=ALL
-# Spring AI OpenAI / Gemini API Config
-spring.ai.openai.api-key=AQ.Ab8RN6KFZggsQf8iooY1v_3h3vp2TIjiYB54dV4Yay3vVKEMtg
-spring.ai.openai.base-url=https://generativelanguage.googleapis.com/v1beta/openai/
-spring.ai.openai.chat.options.model=gemini-flash-latest
-spring.ai.openai.chat.options.temperature=0.3
-

dap-gateway/src/main/resources/application.yml

@@ -0,0 +1,56 @@
+spring:
+  application:
+    name: dap-admin
+  profiles:
+    active: local
+  sql:
+    init:
+      mode: always
+  lifecycle:
+    timeout-per-shutdown-phase: 20s
+  ai:
+    openai:
+      api-key: AQ.Ab8RN6KFZggsQf8iooY1v_3h3vp2TIjiYB54dV4Yay3vVKEMtg
+      base-url: https://generativelanguage.googleapis.com/v1beta/openai/
+      chat:
+        options:
+          model: gemini-flash-latest
+          temperature: 0.3
+
+server:
+  port: 8081
+  http2:
+    enabled: true
+  shutdown: graceful
+
+mcp:
+  gateway:
+    fallback:
+      default-url: http://tool-oth:8084
+      routes:
+        sms: http://tool-sms:8082
+        hr: http://tool-oth:8084
+  agent-claims-required: false
+  trusted-claims-required: false
+  write-approval-required: false
+  default-page-size: 100
+  max-page-size: 500
+  max-pages-per-call: 3
+  max-stream-bytes: 1048576
+  max-response-bytes-from-tool: 5242880
+  tool-registry-sync-interval-millis: 5000
+  security:
+    tenant-domains:
+      TESTER-DEV: ALL
+      system: ALL
+
+mybatis:
+  mapper-locations: classpath:mapper/**/*.xml
+  type-aliases-package: ""
+  configuration:
+    map-underscore-to-camel-case: true
+
+logging:
+  level:
+    com.corundumstudio.socketio: DEBUG
+    org.apache.kafka: ERROR

dap-gateway/src/main/resources/logback-spring.xml

@@ -12,11 +12,14 @@
     </appender>
 
     <!-- 3. 파일(File) 출력 설정 (서버 운영용) -->
+    <!-- Logback에서 시스템 Hostname을 가져오기 위한 설정 -->
+    <property name="HOSTNAME" value="${HOSTNAME}" />
+
     <appender name="FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
-        <file>logs/dap-gateway.log</file> <!-- 현재 로그가 쌓이는 파일 -->
+        <file>/swlog/dap-gateway/A01/${HOSTNAME}_A01.log</file> <!-- 현재 로그가 쌓이는 파일 -->
         <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
             <!-- 매일 자정에 날짜를 붙여서 지난 로그를 분리 저장 -->
-            <fileNamePattern>logs/dap-gateway-%d{yyyy-MM-dd}.log</fileNamePattern>
+            <fileNamePattern>/swlog/dap-gateway/A01/${HOSTNAME}_A01_%d{yyyyMMdd}.log</fileNamePattern>
             <!-- 최대 30일치 로그만 보관하고 오래된 것은 자동 삭제 -->
             <maxHistory>30</maxHistory>
         </rollingPolicy>

dap-gateway/src/main/resources/spy.properties

@@ -1,8 +1,8 @@
-# SLF4J ??? ?? (logback?? ???)
+# SLF4J ??? ?? (logback?? ???)
 appender=com.p6spy.engine.spy.appender.Slf4JLogger
 
 # ??? ??? ??? ?? (???? ?? ??)
-logMessageFormat=io.shinhanlife.dap.common.config.P6SpySqlFormatter
+logMessageFormat=io.shinhanlife.dap.lib.config.P6SpySqlFormatter
 
 # ?? ?? 0ms?? (connection ?? ??) ???
-filter.executionThreshold=1
+filter.executionThreshold=1

dap-gateway/src/main/resources/static/admin/scaffold.html

@@ -380,6 +380,7 @@
                 <a href="/admin/scaffold.html" style="color:#ffffff;" class="font-semibold">Scaffold</a>
                 <a href="/catalog.html" style="color:#a1a1aa;" class="hover:text-white transition-colors">Catalog</a>
                 <a href="/playground.html" style="color:#a1a1aa;" class="hover:text-white transition-colors">Playground</a>
+                <a href="/chat.html" style="color:#a1a1aa;" class="hover:text-white transition-colors">Chat</a>
             </nav>
         </div>
         <div class="flex items-center">
@@ -462,12 +463,13 @@
                         <div class="row mb-3">
                             <div class="col-md-6">
                                 <label class="form-label">Domain Category</label>
-                                <input type="text" class="form-control" name="categoryKey" pattern="^[a-z0-9][a-z0-9_-]*$" list="groupList" placeholder="e.g. common, hr, payment" oninput="this.value = this.value.toLowerCase()" required>
+                                <input type="text" class="form-control" name="categoryKey" pattern="^[a-z0-9]{3}$" maxlength="3" minlength="3" list="groupList" placeholder="e.g. cmm, smp, pay" oninput="this.value = this.value.toLowerCase()" required>
                                 <datalist id="groupList">
-                                    <option value="common">common</option>
-                                    <option value="customer">customer</option>
-                                    <option value="contract">contract</option>
-                                    <option value="claim">claim</option>
+                                    <option value="smp">smp</option>
+                                    <option value="cmm">cmm</option>
+                                    <option value="cus">cus</option>
+                                    <option value="cnt">cnt</option>
+                                    <option value="clm">clm</option>
                                 </datalist>
                             </div>
                             <div class="col-md-6 mt-3 mt-md-0">
@@ -476,7 +478,6 @@
                                     <option value="HTTP">HTTP (REST)</option>
                                     <option value="TCP">TCP (Socket)</option>
                                     <option value="MCI">MCI (Legacy)</option>
-                                    <option value="EAI">EAI (Internal)</option>
                                 </select>
                             </div>
                         </div>
@@ -485,19 +486,28 @@
                             <div class="col-md-6">
                                 <label class="form-label">Target Module</label>
                                 <select class="form-select" name="moduleName" id="targetModuleSelect" required>
-                                    <option value="axhub-tool-other">axhub-tool-other</option>
+                                    <option value="dap-tool-oth">dap-tool-oth</option>
+                                    <option value="dap-tool-hr">dap-tool-hr</option>
+                                    <option value="dap-tool-sms">dap-tool-sms</option>
                                 </select>
                                 <div class="input-hint">Destination Pod directory.</div>
                             </div>
                             <div class="col-md-6 mt-3 mt-md-0">
                                 <label class="form-label">Gateway Registration</label>
                                 <select class="form-select" name="register">
-                                    <option value="true">True (Public)</option>
-                                    <option value="false">False (Private)</option>
+                                    <option value="false" selected>False (Private)</option>
                                 </select>
                                 <div class="input-hint">Controls dynamic routing exposure.</div>
                             </div>
                         </div>
+
+                        <div class="row mb-4">
+                            <div class="col-md-6">
+                                <label class="form-label">Target System Code (MCI Only)</label>
+                                <input type="text" class="form-control" name="clientSystemCode" pattern="^[a-zA-Z]{4}$" maxlength="4" minlength="4" placeholder="e.g. cfpa" oninput="this.value = this.value.toLowerCase()">
+                                <div class="input-hint">Required for MCI Protocol (4 letters).</div>
+                            </div>
+                        </div>
                         
                         <div class="row mb-4">
                             <div class="col-md-6">
@@ -574,7 +584,7 @@
           </div>
           <div class="mb-3">
             <label class="form-label">Category</label>
-            <input type="text" class="form-control" id="editCategoryKey" name="categoryKey" pattern="^[a-z0-9][a-z0-9_-]*$" oninput="this.value = this.value.toLowerCase()">
+            <input type="text" class="form-control" id="editCategoryKey" name="categoryKey" pattern="^[a-z0-9]{3}$" maxlength="3" minlength="3" oninput="this.value = this.value.toLowerCase()">
           </div>
           <div class="mb-3">
             <label class="form-label">Description</label>
@@ -653,7 +663,7 @@
             .then(modules => {
                 const select = document.getElementById('targetModuleSelect');
                 if (modules && modules.length > 0) {
-                    select.innerHTML = modules.map(m => `<option value="${m}" ${m === 'axhub-tool-other' ? 'selected' : ''}>${m}</option>`).join('');
+                    select.innerHTML = modules.map(m => `<option value="${m}" ${m === 'dap-tool-oth' ? 'selected' : ''}>${m}</option>`).join('');
                 }
             })
             .catch(err => console.error('Failed to load modules:', err));

dap-gateway/src/main/resources/static/catalog.html

@@ -69,6 +69,7 @@
                     <a href="/admin/scaffold.html" style="color:#a1a1aa;" class="hover:text-white transition-colors">Scaffold</a>
                     <a href="/catalog.html" style="color:#ffffff;" class="font-semibold">Catalog</a>
                     <a href="/playground.html" style="color:#a1a1aa;" class="hover:text-white transition-colors">Playground</a>
+                    <a href="/chat.html" style="color:#a1a1aa;" class="hover:text-white transition-colors">Chat</a>
                 </nav>
             </div>
             <div class="flex items-center">
@@ -79,12 +80,24 @@
 
     <main class="max-w-6xl mx-auto px-6 py-10">
         <div class="flex flex-col md:flex-row justify-between items-start md:items-end mb-8">
-            <div class="max-w-2xl">
-                <h1 class="text-3xl font-bold tracking-tight mb-2" style="color:#f4f4f5;">Registry Catalog</h1>
-                <p class="text-sm" style="color:#a1a1aa;">Currently integrated AI function tools across all modules. View parameters, descriptions, and integration types.</p>
+            <div class="max-w-2xl w-full">
+                <div class="flex items-center space-x-3 mb-2">
+                    <h1 class="text-3xl font-bold tracking-tight" style="color:#f4f4f5;">Registry Catalog</h1>
+                    <button onclick="openGuideModal()" class="w-6 h-6 rounded-full flex items-center justify-center text-sm font-bold bg-zinc-800 text-zinc-400 hover:bg-zinc-700 hover:text-white transition-colors" title="Connection Guide">?</button>
+                </div>
+                <p class="text-sm mb-6" style="color:#a1a1aa;">Currently integrated AI function tools across all modules. View parameters, descriptions, and integration types.</p>
+                
+                <div class="relative max-w-md w-full">
+                    <input type="text" id="searchInput" placeholder="Search tools by name, description, or category..." class="w-full bg-zinc-900 border border-zinc-700 rounded-lg px-4 py-2.5 text-sm text-zinc-200 placeholder-zinc-500 focus:outline-none focus:border-blue-500 transition-colors">
+                    <svg class="w-4 h-4 absolute right-3 top-3 text-zinc-500" fill="none" stroke="currentColor" viewBox="0 0 24 24"><path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M21 21l-6-6m2-5a7 7 0 11-14 0 7 7 0 0114 0z"></path></svg>
+                </div>
             </div>
-            <div class="mt-4 md:mt-0">
-                <button id="copyMdBtn" class="btn-primary flex items-center">
+            <div class="mt-4 md:mt-0 flex space-x-3 w-full md:w-auto">
+                <button id="copyJsonBtn" class="btn-primary flex items-center justify-center flex-1 md:flex-none" style="background: linear-gradient(135deg, #10b981, #059669); box-shadow: 0 0 20px rgba(16, 185, 129, 0.2);">
+                    <svg class="w-4 h-4 mr-2" fill="none" stroke="currentColor" viewBox="0 0 24 24"><path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M8 16H6a2 2 0 01-2-2V6a2 2 0 012-2h8a2 2 0 012 2v2m-6 12h8a2 2 0 002-2v-8a2 2 0 00-2-2h-8a2 2 0 00-2 2v8a2 2 0 002 2z"></path></svg>
+                    <span id="copyJsonText">Copy Client Config</span>
+                </button>
+                <button id="copyMdBtn" class="btn-primary flex items-center justify-center flex-1 md:flex-none">
                     <svg class="w-4 h-4 mr-2" fill="none" stroke="currentColor" viewBox="0 0 24 24"><path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M8 5H6a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2v-1M8 5a2 2 0 002 2h2a2 2 0 002-2M8 5a2 2 0 012-2h2a2 2 0 012 2m0 0h2a2 2 0 012 2v3m2 4H10m0 0l3-3m-3 3l3 3"></path></svg>
                     <span id="copyBtnText">Copy Markdown Docs</span>
                 </button>
@@ -99,13 +112,52 @@
         </div>
     </main>
 
+    <!-- Guide Modal -->
+    <div id="guideModal" class="fixed inset-0 z-[100] hidden flex items-center justify-center">
+        <div class="absolute inset-0 bg-black/60 backdrop-blur-sm" onclick="closeGuideModal()"></div>
+        <div class="relative bg-zinc-900 border border-zinc-700 rounded-xl shadow-2xl w-full max-w-2xl mx-4 overflow-hidden">
+            <div class="p-5 border-b border-zinc-800 flex justify-between items-center bg-zinc-900/50">
+                <h3 class="text-lg font-semibold text-zinc-100 flex items-center">
+                    <svg class="w-5 h-5 mr-2 text-blue-400" fill="none" stroke="currentColor" viewBox="0 0 24 24"><path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M13 16h-1v-4h-1m1-4h.01M21 12a9 9 0 11-18 0 9 9 0 0118 0z"></path></svg>
+                    AI Agent Connection Guide
+                </h3>
+                <button onclick="closeGuideModal()" class="text-zinc-400 hover:text-white transition-colors">
+                    <svg class="w-5 h-5" fill="none" stroke="currentColor" viewBox="0 0 24 24"><path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M6 18L18 6M6 6l12 12"></path></svg>
+                </button>
+            </div>
+            <div class="p-6 space-y-6 max-h-[70vh] overflow-y-auto text-sm text-zinc-300">
+                <div>
+                    <h4 class="font-semibold text-blue-400 mb-3 flex items-center"><span class="w-5 h-5 rounded bg-blue-500/20 flex items-center justify-center mr-2 text-xs">1</span> Cursor IDE 연동</h4>
+                    <p class="mb-2">1. Cursor 설정 창 열기 (<kbd class="px-1.5 py-0.5 bg-zinc-800 border border-zinc-700 rounded text-xs text-zinc-300">Cmd/Ctrl + ,</kbd>)</p>
+                    <p class="mb-2">2. 사이드바에서 <strong>Features</strong> &gt; <strong>MCP</strong> 메뉴로 이동</p>
+                    <p>3. <strong>+ Add New MCP Server</strong>를 클릭하고, 툴 카테고리의 [Copy SSE URL] 버튼으로 복사한 주소를 `SSE` 타입으로 붙여넣기 하세요.</p>
+                </div>
+                <div class="border-t border-zinc-800 pt-6">
+                    <h4 class="font-semibold text-orange-400 mb-3 flex items-center"><span class="w-5 h-5 rounded bg-orange-500/20 flex items-center justify-center mr-2 text-xs">2</span> Claude Desktop 연동</h4>
+                    <p class="mb-2">1. 아래 설정 파일을 텍스트 에디터로 엽니다:</p>
+                    <div class="bg-black/40 p-3 rounded-lg border border-zinc-800/80 font-mono text-xs mb-3 text-zinc-400">
+                        <div class="mb-1"><strong>Mac:</strong> ~/Library/Application Support/Claude/claude_desktop_config.json</div>
+                        <div><strong>Win:</strong> %APPDATA%\Claude\claude_desktop_config.json</div>
+                    </div>
+                    <p>2. 화면 우측 상단의 <strong>[Copy Client Config]</strong> 버튼을 누른 후, 복사된 JSON 코드를 이 파일 안에 그대로 붙여넣습니다.</p>
+                </div>
+                <div class="border-t border-zinc-800 pt-6">
+                    <h4 class="font-semibold text-emerald-400 mb-3 flex items-center"><span class="w-5 h-5 rounded bg-emerald-500/20 flex items-center justify-center mr-2 text-xs">3</span> 커스텀 Python/Node Agent 연동</h4>
+                    <p class="mb-2">1. MCP 공식 SDK를 설치합니다. <code class="text-xs bg-zinc-800 px-1.5 py-0.5 rounded text-zinc-300 border border-zinc-700">npm i @modelcontextprotocol/sdk</code></p>
+                    <p>2. SSE Client Transport를 사용하여 복사한 카테고리별 URL로 연결합니다.</p>
+                </div>
+            </div>
+        </div>
+    </div>
+
     <script>
+        let allTools = []; // 글로벌 변수로 툴 데이터 보관
         async function fetchTools() {
             try {
                 const response = await fetch('/mcp/api/v1/tools/list');
                 const data = await response.json();
-                const tools = data.result?.tools || [];
-                renderCatalog(tools);
+                allTools = data.result?.tools || [];
+                renderCatalog(allTools);
             } catch (err) {
                 document.getElementById('catalogContainer').innerHTML = `
                     <div style="padding:16px; border:1px solid #7f1d1d; background:rgba(127,29,29,0.15); color:#fca5a5; font-size:14px; border-radius:8px;">
@@ -134,7 +186,12 @@
                 header.style.cssText = 'margin-bottom:16px; padding-bottom:8px; border-bottom:1px solid #27272a; display:flex; align-items:baseline; justify-content:space-between;';
                 header.innerHTML = `
                     <h2 style="font-size:20px; font-weight:600; color:#f4f4f5; text-transform:capitalize;">${group}</h2>
-                    <span class="geist-mono" style="font-size:12px; color:#71717a;">${grouped[group].length} items</span>
+                    <div style="display:flex; align-items:center; gap:8px;">
+                        <span class="geist-mono" style="font-size:12px; color:#71717a;">${grouped[group].length} items</span>
+                        <button onclick="copySseUrl('${group.toLowerCase()}', this)" class="hover:text-blue-400 text-zinc-500 transition-colors p-1.5 rounded hover:bg-zinc-800/50" title="Copy SSE URL">
+                            <svg class="w-4 h-4" fill="none" stroke="currentColor" viewBox="0 0 24 24"><path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M8 16H6a2 2 0 01-2-2V6a2 2 0 012-2h8a2 2 0 012 2v2m-6 12h8a2 2 0 002-2v-8a2 2 0 00-2-2h-8a2 2 0 00-2 2v8a2 2 0 002 2z"></path></svg>
+                        </button>
+                    </div>
                 `;
                 section.appendChild(header);
                 const grid = document.createElement('div');
@@ -227,6 +284,60 @@
             }
         });
 
+        document.getElementById('searchInput').addEventListener('input', (e) => {
+            const query = e.target.value.toLowerCase();
+            const filtered = allTools.filter(t => 
+                (t.name && t.name.toLowerCase().includes(query)) || 
+                (t.displayName && t.displayName.toLowerCase().includes(query)) ||
+                (t.description && t.description.toLowerCase().includes(query)) ||
+                (t.categoryKey && t.categoryKey.toLowerCase().includes(query))
+            );
+            renderCatalog(filtered);
+        });
+
+        function copySseUrl(category, btnElement) {
+            const url = `${window.location.origin}/mcp/sse/${category}`;
+            navigator.clipboard.writeText(url).then(() => {
+                const originalSvg = btnElement.innerHTML;
+                btnElement.innerHTML = `<svg class="w-4 h-4 text-emerald-400" fill="none" stroke="currentColor" viewBox="0 0 24 24"><path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M5 13l4 4L19 7"></path></svg>`;
+                setTimeout(() => { btnElement.innerHTML = originalSvg; }, 2000);
+            }).catch(() => alert('Failed to copy.'));
+        }
+
+        function openGuideModal() {
+            document.getElementById('guideModal').classList.remove('hidden');
+        }
+
+        function closeGuideModal() {
+            document.getElementById('guideModal').classList.add('hidden');
+        }
+
+        document.getElementById('copyJsonBtn').addEventListener('click', () => {
+            const groups = [...new Set(allTools.map(t => t.categoryKey || 'Others'))];
+            const config = { mcpServers: {} };
+            groups.forEach(g => {
+                const safeKey = g.toLowerCase().replace(/[^a-z0-9]/g, '-');
+                config.mcpServers[`axhub-${safeKey}`] = {
+                    "command": "node",
+                    "args": [],
+                    "env": {},
+                    "type": "sse",
+                    "url": `${window.location.origin}/mcp/sse/${g.toLowerCase()}`
+                };
+                // Note: Claude desktop expects command/args for stdio, but for SSE it usually accepts just url/type or requires specialized settings.
+                // Adjusted to basic config.
+                delete config.mcpServers[`axhub-${safeKey}`].command;
+                delete config.mcpServers[`axhub-${safeKey}`].args;
+                delete config.mcpServers[`axhub-${safeKey}`].env;
+            });
+            const textSpan = document.getElementById('copyJsonText');
+            const originalText = textSpan.textContent;
+            navigator.clipboard.writeText(JSON.stringify(config, null, 2)).then(() => {
+                textSpan.textContent = 'Copied JSON!';
+                setTimeout(() => { textSpan.textContent = originalText; }, 2000);
+            }).catch(() => alert('Failed to copy JSON.'));
+        });
+
         document.addEventListener('DOMContentLoaded', fetchTools);
     </script>
 </body>

dap-gateway/src/main/resources/static/chat.html

@@ -173,6 +173,10 @@
                  .replace(/'/g, "'");
         }
 
+        function removeMarkdownEmphasis(text) {
+            return text.replace(/\*\*/g, '');
+        }
+
         async function sendMessage() {
             const text = chatInput.value.trim();
             if (!text || isLoading) return;
@@ -205,6 +209,7 @@
                 // 5. 스트림 읽기
                 const reader = response.body.getReader();
                 const decoder = new TextDecoder("utf-8");
+                let responseText = '';
 
                 while (true) {
                     const { done, value } = await reader.read();
@@ -215,7 +220,8 @@
                     for (const line of lines) {
                         if (line.startsWith('data:')) {
                             const data = line.substring(5);
-                            textContainer.innerHTML += escapeHtml(data);
+                            responseText += data;
+                            textContainer.textContent = removeMarkdownEmphasis(responseText);
                             scrollToBottom();
                         }
                     }

dap-gateway/src/main/resources/static/index.html

@@ -100,6 +100,7 @@
                     <a href="/admin/scaffold.html" class="text-zinc-400 hover:text-white transition-colors">Scaffold</a>
                     <a href="/catalog.html" class="text-zinc-400 hover:text-white transition-colors">Catalog</a>
                     <a href="/playground.html" class="text-zinc-400 hover:text-white transition-colors">Playground</a>
+                    <a href="/chat.html" class="text-zinc-400 hover:text-white transition-colors">Chat</a>
                 </nav>
             </div>
             <div class="flex items-center">
@@ -121,7 +122,7 @@
             </p>
         </div>
 
-        <div class="grid grid-cols-1 md:grid-cols-3 gap-6 w-full max-w-5xl">
+        <div class="grid grid-cols-1 md:grid-cols-2 lg:grid-cols-4 gap-6 w-full max-w-6xl">
             <!-- Scaffold Card -->
             <a href="/admin/scaffold.html" class="card-panel p-8 group block">
                 <div class="w-12 h-12 icon-box rounded-xl flex items-center justify-center mb-6 text-zinc-300">
@@ -163,6 +164,20 @@
                     Enter Playground <svg class="w-3 h-3 ml-1" fill="none" stroke="currentColor" viewBox="0 0 24 24"><path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M14 5l7 7m0 0l-7 7m7-7H3"></path></svg>
                 </div>
             </a>
+
+            <!-- Chat Card -->
+            <a href="/chat.html" class="card-panel p-8 group block">
+                <div class="w-12 h-12 icon-box rounded-xl flex items-center justify-center mb-6 text-zinc-300">
+                    <svg class="w-5 h-5" fill="none" stroke="currentColor" viewBox="0 0 24 24"><path stroke-linecap="round" stroke-linejoin="round" stroke-width="1.5" d="M8 10h.01M12 10h.01M16 10h.01M9 16H5a2 2 0 01-2-2V6a2 2 0 012-2h14a2 2 0 012 2v8a2 2 0 01-2 2h-5l-5 5v-5z"></path></svg>
+                </div>
+                <h2 class="text-lg font-semibold text-zinc-100 mb-3">AI Assistant</h2>
+                <p class="text-[13px] text-zinc-400 leading-relaxed">
+                    Interact with the MCP tool ecosystem through a natural language interface. Test your LLM routing logic in a premium chat UI.
+                </p>
+                <div class="mt-6 flex items-center text-[12px] font-semibold text-zinc-300 group-hover:text-blue-400 group-hover:translate-x-1 transition-all">
+                    Start Chatting <svg class="w-3 h-3 ml-1" fill="none" stroke="currentColor" viewBox="0 0 24 24"><path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M14 5l7 7m0 0l-7 7m7-7H3"></path></svg>
+                </div>
+            </a>
         </div>
     </main>
 </body>

dap-gateway/src/main/resources/static/playground.html

@@ -111,6 +111,7 @@
                     <a href="/admin/scaffold.html" style="color:#a1a1aa;" class="hover:text-white transition-colors">Scaffold</a>
                     <a href="/catalog.html" style="color:#a1a1aa;" class="hover:text-white transition-colors">Catalog</a>
                     <a href="/playground.html" style="color:#ffffff;" class="font-semibold">Playground</a>
+                    <a href="/chat.html" style="color:#a1a1aa;" class="hover:text-white transition-colors">Chat</a>
                 </nav>
             </div>
             <div class="flex items-center space-x-3">

dap-gateway/src/test/java/io/shinhanlife/dap/biz/mcp/gateway/DapGatewayApplicationTests.java

@@ -5,13 +5,13 @@ package io.shinhanlife.dap.mcg;
  * @package io.shinhanlife.dap.mcg
  * @className DapGatewayApplicationTests
  * @description AX HUB 시스템 처리 클래스
- * @author 김형식
+ * @author 0986406
  * @create 2026.09.01
  * <pre>
  * ---------- 개정이력 ----------
  * 수정일      수정자    수정내용
  * ---------- -------- ---------------------------
- * 2026.09.01  김형식    최초생성
+ * 2026.09.01  0986406    최초생성
  * 
  * </pre>
  */

dap-gateway/src/test/java/io/shinhanlife/dap/biz/mcp/gateway/sync/DynamicMcpControllerRouteTest.java

@@ -0,0 +1,35 @@
+package io.shinhanlife.dap.biz.mcp.gateway.sync;
+
+import static org.junit.jupiter.api.Assertions.assertFalse;
+import static org.junit.jupiter.api.Assertions.assertTrue;
+
+import java.util.Arrays;
+import java.util.Set;
+import java.util.stream.Collectors;
+
+import io.shinhanlife.dap.mcg.sync.DynamicMcpController;
+import org.junit.jupiter.api.Test;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PostMapping;
+
+class DynamicMcpControllerRouteTest {
+
+    @Test
+    void exposesOnlySupportedCategoryAwareMcpRoutes() {
+        Set<String> getPaths = Arrays.stream(DynamicMcpController.class.getDeclaredMethods())
+                .flatMap(method -> Arrays.stream(method.getAnnotationsByType(GetMapping.class)))
+                .flatMap(mapping -> Arrays.stream(mapping.value()))
+                .collect(Collectors.toSet());
+        Set<String> postPaths = Arrays.stream(DynamicMcpController.class.getDeclaredMethods())
+                .flatMap(method -> Arrays.stream(method.getAnnotationsByType(PostMapping.class)))
+                .flatMap(mapping -> Arrays.stream(mapping.value()))
+                .collect(Collectors.toSet());
+
+        assertTrue(getPaths.contains("/mcp/sse/{category}"));
+        assertTrue(postPaths.contains("/mcp/message/{category}"));
+        assertTrue(postPaths.contains("/mcp/custom/{category}"));
+        assertFalse(postPaths.contains("/mcp"));
+        assertFalse(postPaths.contains("/mcp/initialize"));
+        assertFalse(postPaths.contains("/mcp/sse/initialize"));
+    }
+}

dap-gateway/src/test/java/io/shinhanlife/dap/biz/mcp/gateway/sync/RegistryMcpToolSpecificationFactoryTest.java

@@ -0,0 +1,33 @@
+package io.shinhanlife.dap.biz.mcp.gateway.sync;
+
+import static org.junit.jupiter.api.Assertions.assertFalse;
+import static org.junit.jupiter.api.Assertions.assertTrue;
+
+import com.fasterxml.jackson.databind.ObjectMapper;
+import io.modelcontextprotocol.spec.McpSchema;
+import io.shinhanlife.dap.mcg.dto.ToolMetadata;
+import io.shinhanlife.dap.mcg.sync.RegistryMcpToolSpecificationFactory;
+import org.junit.jupiter.api.Test;
+
+class RegistryMcpToolSpecificationFactoryTest {
+
+    @Test
+    void exposesMetadataBehaviorHintsInMcpToolSpecification() {
+        ToolMetadata metadata = ToolMetadata.builder()
+                .name("customer_lookup")
+                .description("Looks up customer information")
+                .readOnlyHint(true)
+                .destructiveHint(false)
+                .idempotentHint(true)
+                .openWorldHint(false)
+                .build();
+
+        RegistryMcpToolSpecificationFactory factory = new RegistryMcpToolSpecificationFactory(null, new ObjectMapper());
+        McpSchema.Tool tool = factory.create(metadata).tool();
+
+        assertTrue(tool.annotations().readOnlyHint());
+        assertFalse(tool.annotations().destructiveHint());
+        assertTrue(tool.annotations().idempotentHint());
+        assertFalse(tool.annotations().openWorldHint());
+    }
+}

dap-gateway/src/test/java/io/shinhanlife/dap/biz/mcp/gateway/tool/large/PaginationRequestValidatorTest.java

@@ -5,13 +5,13 @@ package io.shinhanlife.dap.mcg.tool.large;
  * @package io.shinhanlife.dap.mcg.tool.large
  * @className PaginationRequestValidatorTest
  * @description AX HUB 시스템 처리 클래스
- * @author 김형식
+ * @author 0986406
  * @create 2026.09.01
  * <pre>
  * ---------- 개정이력 ----------
  * 수정일      수정자    수정내용
  * ---------- -------- ---------------------------
- * 2026.09.01  김형식    최초생성
+ * 2026.09.01  0986406    최초생성
  * 
  * </pre>
  */

dap-tool-core/build.gradle

@@ -3,7 +3,30 @@ plugins {
 }
 
 dependencies {
-    api project(':dap-common')
+    api 'org.springframework.boot:spring-boot-starter-web'
+    api 'org.springframework.boot:spring-boot-starter-validation'
+    api 'org.springframework.boot:spring-boot-starter-data-redis'
+    
+    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'
+    api 'org.mybatis.spring.boot:mybatis-spring-boot-starter:3.0.3'
+    api 'com.h2database:h2'
+    api 'p6spy:p6spy:3.9.1'
+    api 'io.lettuce:lettuce-core:6.6.0.RELEASE'
+
+    api "org.mapstruct:mapstruct:1.5.5.Final"
+    
+    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:1.4.0'
+    api 'org.springframework.kafka:spring-kafka:3.2.0'
+    api 'org.springdoc:springdoc-openapi-starter-webmvc-ui:2.5.0'
 }
 
 dependencies {

dap-tool-core/src/main/java/io/shinhanlife/dap/lib/adapter/aop/EimsMonitoringAspect.java

@@ -1,4 +1,4 @@
-package io.shinhanlife.dap.common.adapter.aop;
+package io.shinhanlife.dap.lib.adapter.aop;
 
 import lombok.extern.slf4j.Slf4j;
 import org.aspectj.lang.ProceedingJoinPoint;
@@ -9,16 +9,16 @@ import org.springframework.stereotype.Component;
 import java.util.Arrays;
 
 /**
- * @package io.shinhanlife.dap.common.adapter.aop
+ * @package io.shinhanlife.dap.lib.adapter.aop
  * @className EimsMonitoringAspect
  * @description AX HUB 시스템 처리 클래스
- * @author 김형식
+ * @author 0986406
  * @create 2026.09.01
  * <pre>
  * ---------- 개정이력 ----------
  * 수정일      수정자    수정내용
  * ---------- -------- ---------------------------
- * 2026.09.01  김형식    최초생성
+ * 2026.09.01  0986406    최초생성
  * 
  * </pre>
  */
@@ -27,8 +27,8 @@ import java.util.Arrays;
 @Component
 public class EimsMonitoringAspect {
 
-    //  포인트컷: io.shinhanlife.dap.common.adapter.sender 패키지 내의 EimsSender를 구현한 모든 클래스의 메서드를 타겟으로 지정합니다.
-    @Around("execution(* io.shinhanlife.dap.common.adapter.sender.*EimsSender.*(..))")
+    //  포인트컷: io.shinhanlife.dap.lib.adapter.sender 패키지 내의 EimsSender를 구현한 모든 클래스의 메서드를 타겟으로 지정합니다.
+    @Around("execution(* io.shinhanlife.dap.lib.adapter.sender.*EimsSender.*(..))")
     public Object monitorEimsCommunication(ProceedingJoinPoint joinPoint) throws Throwable {
 
         // 1. 호출되는 클래스와 메서드 이름 추출

dap-tool-core/src/main/java/io/shinhanlife/dap/lib/adapter/connector/ExternalApiConnector.java

@@ -1,7 +1,7 @@
-package io.shinhanlife.dap.common.adapter.connector;
+package io.shinhanlife.dap.lib.adapter.connector;
 
-import io.shinhanlife.dap.common.adapter.support.DynamicPayloadBuilder;
-import io.shinhanlife.dap.common.adapter.support.DynamicSchemaValidator;
+import io.shinhanlife.dap.lib.adapter.support.DynamicPayloadBuilder;
+import io.shinhanlife.dap.lib.adapter.support.DynamicSchemaValidator;
 import io.github.resilience4j.circuitbreaker.annotation.CircuitBreaker;
 import io.github.resilience4j.ratelimiter.annotation.RateLimiter;
 import lombok.extern.slf4j.Slf4j;
@@ -12,16 +12,16 @@ import java.util.Map;
 import java.util.List;
 
 /**
- * @package io.shinhanlife.dap.common.adapter.connector
+ * @package io.shinhanlife.dap.lib.adapter.connector
  * @className ExternalApiConnector
  * @description AX HUB 시스템 처리 클래스
- * @author 김형식
+ * @author 0986406
  * @create 2026.09.01
  * <pre>
  * ---------- 개정이력 ----------
  * 수정일      수정자    수정내용
  * ---------- -------- ---------------------------
- * 2026.09.01  김형식    최초생성
+ * 2026.09.01  0986406    최초생성
  * 
  * </pre>
  */

dap-tool-core/src/main/java/io/shinhanlife/dap/lib/adapter/connector/InternalSystemConnector.java

@@ -1,7 +1,7 @@
-package io.shinhanlife.dap.common.adapter.connector;
+package io.shinhanlife.dap.lib.adapter.connector;
 
-import io.shinhanlife.dap.common.adapter.support.DynamicPayloadBuilder;
-import io.shinhanlife.dap.common.adapter.support.DynamicSchemaValidator;
+import io.shinhanlife.dap.lib.adapter.support.DynamicPayloadBuilder;
+import io.shinhanlife.dap.lib.adapter.support.DynamicSchemaValidator;
 import io.github.resilience4j.circuitbreaker.annotation.CircuitBreaker;
 import io.github.resilience4j.ratelimiter.annotation.RateLimiter;
 import lombok.extern.slf4j.Slf4j;
@@ -12,16 +12,16 @@ import java.util.Map;
 import java.util.List;
 
 /**
- * @package io.shinhanlife.dap.common.adapter.connector
+ * @package io.shinhanlife.dap.lib.adapter.connector
  * @className InternalSystemConnector
  * @description AX HUB 시스템 처리 클래스
- * @author 김형식
+ * @author 0986406
  * @create 2026.09.01
  * <pre>
  * ---------- 개정이력 ----------
  * 수정일      수정자    수정내용
  * ---------- -------- ---------------------------
- * 2026.09.01  김형식    최초생성
+ * 2026.09.01  0986406    최초생성
  * 
  * </pre>
  */

dap-tool-core/src/main/java/io/shinhanlife/dap/lib/adapter/connector/LegacyDbConnector.java

@@ -1,6 +1,6 @@
-package io.shinhanlife.dap.common.adapter.connector;
+package io.shinhanlife.dap.lib.adapter.connector;
 
-import io.shinhanlife.dap.common.adapter.support.ResultStandardizer;
+import io.shinhanlife.dap.lib.adapter.support.ResultStandardizer;
 import io.github.resilience4j.circuitbreaker.annotation.CircuitBreaker;
 import io.github.resilience4j.ratelimiter.annotation.RateLimiter;
 import lombok.RequiredArgsConstructor;
@@ -13,16 +13,16 @@ import java.util.Map;
 import java.util.stream.Collectors;
 
 /**
- * @package io.shinhanlife.dap.common.adapter.connector
+ * @package io.shinhanlife.dap.lib.adapter.connector
  * @className LegacyDbConnector
  * @description AX HUB 시스템 처리 클래스
- * @author 김형식
+ * @author 0986406
  * @create 2026.09.01
  * <pre>
  * ---------- 개정이력 ----------
  * 수정일      수정자    수정내용
  * ---------- -------- ---------------------------
- * 2026.09.01  김형식    최초생성
+ * 2026.09.01  0986406    최초생성
  * 
  * </pre>
  */

dap-tool-core/src/main/java/io/shinhanlife/dap/lib/adapter/connector/LegacyEimsConnector.java

@@ -1,7 +1,7 @@
-package io.shinhanlife.dap.common.adapter.connector;
+package io.shinhanlife.dap.lib.adapter.connector;
 
 import com.fasterxml.jackson.databind.ObjectMapper;
-import io.shinhanlife.dap.common.adapter.sender.EimsSender;
+import io.shinhanlife.dap.lib.adapter.sender.EimsSender;
 import io.github.resilience4j.circuitbreaker.annotation.CircuitBreaker;
 import io.github.resilience4j.ratelimiter.RequestNotPermitted;
 import io.github.resilience4j.ratelimiter.annotation.RateLimiter;
@@ -12,19 +12,19 @@ import org.springframework.stereotype.Service;
 
 import java.util.List;
 import java.util.Map;
-import io.shinhanlife.dap.common.adapter.util.LegacyDataTransformer;
+import io.shinhanlife.dap.lib.adapter.util.LegacyDataTransformer;
 
 /**
- * @package io.shinhanlife.dap.common.adapter.connector
+ * @package io.shinhanlife.dap.lib.adapter.connector
  * @className LegacyEimsConnector
  * @description AX HUB 시스템 처리 클래스
- * @author 김형식
+ * @author 0986406
  * @create 2026.09.01
  * <pre>
  * ---------- 개정이력 ----------
  * 수정일      수정자    수정내용
  * ---------- -------- ---------------------------
- * 2026.09.01  김형식    최초생성
+ * 2026.09.01  0986406    최초생성
  * 
  * </pre>
  */