refactor: rename dasmt to datmt across the project

README.md

@@ -1,10 +1,10 @@
-# DASMT MCP Tool Pods
+# DATMT MCP Tool Pods
 
-신한라이프 업무 기능을 MCP(Model Context Protocol) Tool로 제공하는 Java 멀티 모듈 프로젝트입니다. 각 업무 모듈은 독립 실행 가능한 Spring Boot 애플리케이션이며, MCP Streamable HTTP와 REST 실행 API를 함께 제공합니다.
+?좏븳?쇱씠???낅Т 湲곕뒫??MCP(Model Context Protocol) Tool濡??쒓났?섎뒗 Java 硫€??紐⑤뱢 ?꾨줈?앺듃?낅땲?? 媛??낅Т 紐⑤뱢?€ ?낅┰ ?ㅽ뻾 媛€?ν븳 Spring Boot ?좏뵆由ъ??댁뀡?대ʼn, MCP Streamable HTTP?€ REST ?ㅽ뻾 API瑜??④퍡 ?쒓났?⑸땲??
 
-이 저장소에는 DATMS(Gateway) 애플리케이션이 포함되어 있지 않습니다. DASMT는 Gateway로 Tool을 push 등록하지 않으며, 각 Pod가 `GET /tool-manifest`를 제공하면 DATMS가 이 Manifest를 pull하여 Tool 목록을 구성합니다. Tool 조회와 직접 실행은 각 Pod에서도 자체적으로 처리합니다.
+???€?μ냼?먮뒗 DATMS(Gateway) ?좏뵆由ъ??댁뀡???ы븿?섏뼱 ?덉? ?딆뒿?덈떎. DATMT??Gateway濡?Tool??push ?깅줉?섏? ?딆쑝硫? 媛?Pod媛€ `GET /tool-manifest`瑜??쒓났?섎㈃ DATMS媛€ ??Manifest瑜?pull?섏뿬 Tool 紐⑸줉??援ъ꽦?⑸땲?? Tool 議고쉶?€ 吏곸젒 ?ㅽ뻾?€ 媛?Pod?먯꽌???먯껜?곸쑝濡?泥섎━?⑸땲??
 
-## 기술 기준
+## 湲곗닠 湲곗?
 
 - Java 21
 - Gradle Wrapper 8.14.3
@@ -15,86 +15,86 @@
 - MapStruct, MyBatis, Redis, Kafka, Resilience4j
 - JUnit 5
 
-## 모듈 구성
+## 紐⑤뱢 援ъ꽦
 
-| 모듈 | 역할 | 기본 포트 | Tool 수 |
+| 紐⑤뱢 | ??븷 | 湲곕낯 ?ы듃 | Tool ??|
 |---|---|---:|---:|
-| `dat-was-lib` | MCP 서버, Tool 스캔·실행, Schema, Manifest, 보안, MCI/EAI/HTTP 연동 공통 기능 | - | - |
-| `dat-was-cus` | 고객·CRM·VOC·웹 콘텐츠 관리 Tool | 8084 | 51 |
-| `dat-was-sal` | 영업·청구·인수·동의·현장지원 Tool | 8082 | 52 |
-| `dat-was-pro` | 상품 영역 Tool(개인고객 상세조회·모집수수료 공시) | 8085 | 2 |
-| `dat-was-sys` | IAM·시스템 상태·공지·점검·배포 Tool | 8086 | 51 |
+| `dat-was-lib` | MCP ?쒕쾭, Tool ?ㅼ틪쨌?ㅽ뻾, Schema, Manifest, 蹂댁븞, MCI/EAI/HTTP ?곕룞 怨듯넻 湲곕뒫 | - | - |
+| `dat-was-cus` | 怨좉컼쨌CRM쨌VOC쨌??肄섑뀗痢?愿€由?Tool | 8084 | 51 |
+| `dat-was-sal` | ?곸뾽쨌泥?뎄쨌?몄닔쨌?숈쓽쨌?꾩옣吏€??Tool | 8082 | 52 |
+| `dat-was-pro` | ?곹뭹 ?곸뿭 Tool(媛쒖씤怨좉컼 ?곸꽭議고쉶쨌紐⑥쭛?섏닔猷?怨듭떆) | 8085 | 2 |
+| `dat-was-sys` | IAM쨌?쒖뒪???곹깭쨌怨듭?쨌?먭?쨌諛고룷 Tool | 8086 | 51 |
 
-업무 모듈에는 총 156개의 `@McpTool` 선언이 있습니다. 현재 업무 모듈의 `src/main/resources`에는 별도 `tool-definitions` YAML이 없으며, Tool 메타데이터는 어노테이션과 `@GrowToolHint`를 기준으로 생성됩니다.
+?낅Т 紐⑤뱢?먮뒗 珥?156媛쒖쓽 `@McpTool` ?좎뼵???덉뒿?덈떎. ?꾩옱 ?낅Т 紐⑤뱢??`src/main/resources`?먮뒗 蹂꾨룄 `tool-definitions` YAML???놁쑝硫? Tool 硫뷀??곗씠?곕뒗 ?대끂?뚯씠?섍낵 `@GrowToolHint`瑜?湲곗??쇰줈 ?앹꽦?⑸땲??
 
-현재 업무 구현은 개발·연동 검증 단계입니다. `dat-was-sal`의 `cmm_claim_search`와 `cmm_memo_retriever`는 각각 MCI와 HTTP Client 흐름을 사용하며, 나머지 Tool은 외부 시스템을 변경하지 않는 모의 응답을 중심으로 구현되어 있습니다.
+?꾩옱 ?낅Т 援ы쁽?€ 媛쒕컻쨌?곕룞 寃€利??④퀎?낅땲?? `dat-was-sal`??`cmm_claim_search`?€ `cmm_memo_retriever`??媛곴컖 MCI?€ HTTP Client ?먮쫫???ъ슜?섎ʼn, ?섎㉧吏€ Tool?€ ?몃? ?쒖뒪?쒖쓣 蹂€寃쏀븯吏€ ?딅뒗 紐⑥쓽 ?묐떟??以묒떖?쇰줈 援ы쁽?섏뼱 ?덉뒿?덈떎.
 
-## 처리 구조
+## 泥섎━ 援ъ“
 
 ```text
-MCP Client 또는 REST Client
-  ├─ MCP Streamable HTTP: /mcp
-  └─ REST: POST /mcp/{toolName}
-          │
-          ▼
+MCP Client ?먮뒗 REST Client
+  ?쒋? MCP Streamable HTTP: /mcp
+  ?붴? REST: POST /mcp/{toolName}
+          ??
+          ??
 Tool Pod
-  ├─ McpToolMethodRegistry
-  │    └─ Spring Bean의 @McpTool 메서드 탐색 및 실행 메서드 캐시
-  ├─ ToolRegistryHeartbeatSender
-  │    ├─ Tool 메타데이터 생성
-  │    └─ tool-definitions YAML 병합
-  ├─ ToolManifestService
-  │    └─ DATMS가 pull할 bundle 단위 Manifest 생성
-  ├─ McpToolExecutionService
-  │    ├─ 입력 Schema 검증
-  │    ├─ 요청 DTO 변환 및 Tool 호출
-  │    └─ 출력 Schema 검증
-  └─ UseCase → Converter → MCI/EAI/HTTP Client 또는 Mock 응답
+  ?쒋? McpToolMethodRegistry
+  ??   ?붴? Spring Bean??@McpTool 硫붿꽌???먯깋 諛??ㅽ뻾 硫붿꽌??罹먯떆
+  ?쒋? ToolRegistryHeartbeatSender
+  ??   ?쒋? Tool 硫뷀??곗씠???앹꽦
+  ??   ?붴? tool-definitions YAML 蹂묓빀
+  ?쒋? ToolManifestService
+  ??   ?붴? DATMS媛€ pull??bundle ?⑥쐞 Manifest ?앹꽦
+  ?쒋? McpToolExecutionService
+  ??   ?쒋? ?낅젰 Schema 寃€利?
+  ??   ?쒋? ?붿껌 DTO 蹂€??諛?Tool ?몄텧
+  ??   ?붴? 異쒕젰 Schema 寃€利?
+  ?붴? UseCase ??Converter ??MCI/EAI/HTTP Client ?먮뒗 Mock ?묐떟
 ```
 
-애플리케이션 시작 시 다음 순서로 Tool이 준비됩니다.
+?좏뵆由ъ??댁뀡 ?쒖옉 ???ㅼ쓬 ?쒖꽌濡?Tool??以€鍮꾨맗?덈떎.
 
-1. `ToolDefinitionRepository`는 `classpath*:tool-definitions/**/*.yml` 경로의 정의가 있을 경우 이를 읽고 V17 필수 항목을 검증합니다.
-2. `ToolRegistryHeartbeatSender`가 `@McpTool` 메서드를 스캔하고, 존재하는 YAML 정의가 있으면 병합해 `ToolMetadata`를 생성합니다.
-3. `McpToolMethodRegistry`가 실제 호출 가능한 Bean과 메서드를 Tool 이름으로 캐시합니다.
-4. `ToolPodMcpToolSynchronizer`가 Tool을 MCP SDK 서버에 등록합니다.
-5. REST와 MCP 요청은 공통 `McpToolExecutionService`를 통해 실행됩니다.
+1. `ToolDefinitionRepository`??`classpath*:tool-definitions/**/*.yml` 寃쎈줈???뺤쓽媛€ ?덉쓣 寃쎌슦 ?대? ?쎄퀬 V17 ?꾩닔 ??ぉ??寃€利앺빀?덈떎.
+2. `ToolRegistryHeartbeatSender`媛€ `@McpTool` 硫붿꽌?쒕? ?ㅼ틪?섍퀬, 議댁옱?섎뒗 YAML ?뺤쓽媛€ ?덉쑝硫?蹂묓빀??`ToolMetadata`瑜??앹꽦?⑸땲??
+3. `McpToolMethodRegistry`媛€ ?ㅼ젣 ?몄텧 媛€?ν븳 Bean怨?硫붿꽌?쒕? Tool ?대쫫?쇰줈 罹먯떆?⑸땲??
+4. `ToolPodMcpToolSynchronizer`媛€ Tool??MCP SDK ?쒕쾭???깅줉?⑸땲??
+5. REST?€ MCP ?붿껌?€ 怨듯넻 `McpToolExecutionService`瑜??듯빐 ?ㅽ뻾?⑸땲??
 
-DASMT 내부에는 `/registry/register`, `/registry/deregister` 호출이나 주기적인 Gateway heartbeat 전송이 없습니다. `ToolRegistryHeartbeatSender`라는 클래스명은 호환성을 위해 남아 있지만 현재 역할은 로컬 Tool 스캔과 메타데이터 생성뿐입니다.
+DATMT ?대??먮뒗 `/registry/register`, `/registry/deregister` ?몄텧?대굹 二쇨린?곸씤 Gateway heartbeat ?꾩넚???놁뒿?덈떎. `ToolRegistryHeartbeatSender`?쇰뒗 ?대옒?ㅻ챸?€ ?명솚?깆쓣 ?꾪빐 ?⑥븘 ?덉?留??꾩옱 ??븷?€ 濡쒖뺄 Tool ?ㅼ틪怨?硫뷀??곗씠???앹꽦肉먯엯?덈떎.
 
-### DATMS 연동 방식
+### DATMS ?곕룞 諛⑹떇
 
 ```text
 DATMS
-  └─ GET {DASMT Pod URL}/tool-manifest
-       └─ bundleId + revision + tools[]
-            └─ 각 Tool endpoint: {Pod URL}/mcp/{toolName}
+  ?붴? GET {DATMT Pod URL}/tool-manifest
+       ?붴? bundleId + revision + tools[]
+            ?붴? 媛?Tool endpoint: {Pod URL}/mcp/{toolName}
 ```
 
-- `mcp.manifest.bundle-id`는 Manifest를 제공하는 Pod의 고유 식별자이며 필수입니다.
-- 현재 값은 `was-sal`, `was-cus`, `was-pro`, `was-sys`입니다.
-- DATMS에 설정한 bundle ID와 DASMT가 반환하는 `bundleId`가 일치해야 같은 Tool bundle로 관리됩니다.
-- `mcp.manifest.name-prefix`가 비어 있지 않으면 모든 Tool 이름이 해당 prefix로 시작해야 합니다.
-- Manifest 내용이 바뀌면 `revision`이 증가하며, `If-None-Match`가 일치하면 `304 Not Modified`를 반환합니다.
+- `mcp.manifest.bundle-id`??Manifest瑜??쒓났?섎뒗 Pod??怨좎쑀 ?앸퀎?먯씠硫??꾩닔?낅땲??
+- ?꾩옱 媛믪? `was-sal`, `was-cus`, `was-pro`, `was-sys`?낅땲??
+- DATMS???ㅼ젙??bundle ID?€ DATMT媛€ 諛섑솚?섎뒗 `bundleId`媛€ ?쇱튂?댁빞 媛숈? Tool bundle濡?愿€由щ맗?덈떎.
+- `mcp.manifest.name-prefix`媛€ 鍮꾩뼱 ?덉? ?딆쑝硫?紐⑤뱺 Tool ?대쫫???대떦 prefix濡??쒖옉?댁빞 ?⑸땲??
+- Manifest ?댁슜??諛붾€뚮㈃ `revision`??利앷??섎ʼn, `If-None-Match`媛€ ?쇱튂?섎㈃ `304 Not Modified`瑜?諛섑솚?⑸땲??
 
-## 제공 API
+## ?쒓났 API
 
-각 업무 Pod가 동일한 API 구조를 제공합니다.
+媛??낅Т Pod媛€ ?숈씪??API 援ъ“瑜??쒓났?⑸땲??
 
-| 목적 | 메서드 | 경로 |
+| 紐⑹쟻 | 硫붿꽌??| 寃쎈줈 |
 |---|---|---|
-| MCP Streamable HTTP | MCP 프로토콜 | `/mcp` |
-| MCP 메시지 전송 | MCP 프로토콜 | `/mcp/message` |
-| 로컬 Tool 메타데이터 조회 | `GET` | `/mcp/api/v1/tools/local` |
-| Tool 직접 실행 | `POST` | `/mcp/{toolName}` |
-| Tool Manifest 조회 | `GET` | `/tool-manifest` |
-| 카테고리별 Tool Manifest 조회 | `GET` | `/tool-manifest/{categoryKey}` |
+| MCP Streamable HTTP | MCP ?꾨줈?좎퐳 | `/mcp` |
+| MCP 硫붿떆吏€ ?꾩넚 | MCP ?꾨줈?좎퐳 | `/mcp/message` |
+| 濡쒖뺄 Tool 硫뷀??곗씠??議고쉶 | `GET` | `/mcp/api/v1/tools/local` |
+| Tool 吏곸젒 ?ㅽ뻾 | `POST` | `/mcp/{toolName}` |
+| Tool Manifest 議고쉶 | `GET` | `/tool-manifest` |
+| 移댄뀒怨좊━蹂?Tool Manifest 議고쉶 | `GET` | `/tool-manifest/{categoryKey}` |
 
-`GET /tool-manifest`는 `If-None-Match` 요청 헤더를 지원합니다. Manifest가 변경되지 않았으면 `304 Not Modified`를 반환합니다.
+`GET /tool-manifest`??`If-None-Match` ?붿껌 ?ㅻ뜑瑜?吏€?먰빀?덈떎. Manifest媛€ 蹂€寃쎈릺吏€ ?딆븯?쇰㈃ `304 Not Modified`瑜?諛섑솚?⑸땲??
 
-### REST 실행 예시
+### REST ?ㅽ뻾 ?덉떆
 
-다음은 SYS Pod의 시스템 상태 Tool 호출 예시입니다.
+?ㅼ쓬?€ SYS Pod???쒖뒪???곹깭 Tool ?몄텧 ?덉떆?낅땲??
 
 ```powershell
 $headers = @{
@@ -104,7 +104,7 @@ $headers = @{
   'X-Request-Id' = 'request-local-001'
   'X-Request-Time' = '2026-08-25T12:34:56+09:00'
   'X-Vrtl-Praf-No' = 'V100001'
-  'X-App-Code' = 'DASMT'
+  'X-App-Code' = 'DATMT'
   'X-Project-Code' = 'AXHUB'
   'X-User-Ip' = '10.0.0.10'
   'X-Caller-Ip' = '10.0.0.20'
@@ -119,53 +119,53 @@ Invoke-RestMethod `
   -Uri 'http://localhost:8086/mcp/iam_system_status' `
   -Headers $headers `
   -ContentType 'application/json' `
-  -Body '{"environment":"개발"}'
+  -Body '{"environment":"媛쒕컻"}'
 ```
 
-### 요청 헤더 계약
+### ?붿껌 ?ㅻ뜑 怨꾩빟
 
-DATMS가 DASMT Tool Service를 호출할 때 사용하는 헤더는 다음과 같습니다. HTTP 헤더 이름은 대소문자를 구분하지 않지만, 문서와 구현에서는 아래 표기를 기준으로 사용합니다.
+DATMS媛€ DATMT Tool Service瑜??몄텧?????ъ슜?섎뒗 ?ㅻ뜑???ㅼ쓬怨?媛숈뒿?덈떎. HTTP ?ㅻ뜑 ?대쫫?€ ?€?뚮Ц?먮? 援щ텇?섏? ?딆?留? 臾몄꽌?€ 援ы쁽?먯꽌???꾨옒 ?쒓린瑜?湲곗??쇰줈 ?ъ슜?⑸땲??
 
-| 헤더 | 필수 여부 | 용도 | 전달 동작 |
+| ?ㅻ뜑 | ?꾩닔 ?щ? | ?⑸룄 | ?꾨떖 ?숈옉 |
 |---|---|---|---|
-| `X-Tool-Server-API-Key` | 인증 설정 시 필수 | DATMS와 DASMT 사이의 Tool Server 인증 | `mcp.security.api-key` 또는 `api-keys`와 비교 |
-| `X-Guid` | 선택 | 업무 호출 상관관계 식별자 | 실행 로그, 성공 응답, 하위 HTTP 호출로 전달 |
-| `X-Praf-No` | 선택 | 실제 사용자 사번 | 세션 조회와 하위 HTTP 호출로 전달 |
-| `X-Request-Id` | 선택 | 요청 추적 식별자 | 실행 로그, 성공 응답, 하위 HTTP 호출로 전달 |
-| `X-Request-Time` | 선택 | 요청 발생 시각 | 하위 HTTP 호출로 전달 |
-| `X-Vrtl-Praf-No` | 선택 | 가상 사용자 사번 | 하위 HTTP 호출로 전달 |
-| `X-App-Code` | 선택 | 호출 애플리케이션 코드 | 하위 HTTP 호출로 전달 |
-| `X-Project-Code` | 선택 | 호출 프로젝트 코드 | 하위 HTTP 호출로 전달 |
-| `X-User-Ip` | 선택 | 사용자 IP 주소 | 하위 HTTP 호출로 전달 |
-| `X-Caller-Ip` | 선택 | 호출 시스템 IP 주소 | 하위 HTTP 호출로 전달 |
-| `X-Caller-Host` | 선택 | 호출 시스템 호스트명 | 하위 HTTP 호출로 전달 |
-| `X-Channel` | 선택 | 호출 채널 | 하위 HTTP 호출로 전달 |
-| `X-Agent-Id` | 선택 | 호출 Agent 식별자 | 하위 HTTP 호출로 전달 |
-| `mcp-session-id` | 선택 | MCP 세션 식별자 | 성공 응답과 하위 HTTP 호출로 전달 |
+| `X-Tool-Server-API-Key` | ?몄쬆 ?ㅼ젙 ???꾩닔 | DATMS?€ DATMT ?ъ씠??Tool Server ?몄쬆 | `mcp.security.api-key` ?먮뒗 `api-keys`?€ 鍮꾧탳 |
+| `X-Guid` | ?좏깮 | ?낅Т ?몄텧 ?곴?愿€怨??앸퀎??| ?ㅽ뻾 濡쒓렇, ?깃났 ?묐떟, ?섏쐞 HTTP ?몄텧濡??꾨떖 |
+| `X-Praf-No` | ?좏깮 | ?ㅼ젣 ?ъ슜???щ쾲 | ?몄뀡 議고쉶?€ ?섏쐞 HTTP ?몄텧濡??꾨떖 |
+| `X-Request-Id` | ?좏깮 | ?붿껌 異붿쟻 ?앸퀎??| ?ㅽ뻾 濡쒓렇, ?깃났 ?묐떟, ?섏쐞 HTTP ?몄텧濡??꾨떖 |
+| `X-Request-Time` | ?좏깮 | ?붿껌 諛쒖깮 ?쒓컖 | ?섏쐞 HTTP ?몄텧濡??꾨떖 |
+| `X-Vrtl-Praf-No` | ?좏깮 | 媛€???ъ슜???щ쾲 | ?섏쐞 HTTP ?몄텧濡??꾨떖 |
+| `X-App-Code` | ?좏깮 | ?몄텧 ?좏뵆由ъ??댁뀡 肄붾뱶 | ?섏쐞 HTTP ?몄텧濡??꾨떖 |
+| `X-Project-Code` | ?좏깮 | ?몄텧 ?꾨줈?앺듃 肄붾뱶 | ?섏쐞 HTTP ?몄텧濡??꾨떖 |
+| `X-User-Ip` | ?좏깮 | ?ъ슜??IP 二쇱냼 | ?섏쐞 HTTP ?몄텧濡??꾨떖 |
+| `X-Caller-Ip` | ?좏깮 | ?몄텧 ?쒖뒪??IP 二쇱냼 | ?섏쐞 HTTP ?몄텧濡??꾨떖 |
+| `X-Caller-Host` | ?좏깮 | ?몄텧 ?쒖뒪???몄뒪?몃챸 | ?섏쐞 HTTP ?몄텧濡??꾨떖 |
+| `X-Channel` | ?좏깮 | ?몄텧 梨꾨꼸 | ?섏쐞 HTTP ?몄텧濡??꾨떖 |
+| `X-Agent-Id` | ?좏깮 | ?몄텧 Agent ?앸퀎??| ?섏쐞 HTTP ?몄텧濡??꾨떖 |
+| `mcp-session-id` | ?좏깮 | MCP ?몄뀡 ?앸퀎??| ?깃났 ?묐떟怨??섏쐞 HTTP ?몄텧濡??꾨떖 |
 
-`McpRequestHeaderFilter`는 URI에 `/mcp`가 포함된 요청에서 위 헤더를 `McpRequestHeaderContext`에 저장하므로 REST `/mcp/{toolName}`과 MCP Streamable HTTP `/mcp`, `/mcp/message`에 모두 적용됩니다. REST 경로는 `BusinessToolController`도 동일한 헤더를 직접 읽어 실행 서비스에 전달합니다. 헤더가 없는 하위 HTTP 호출에는 `X-ANONYMOUS-REQ: AXHUB-TOOL`이 설정됩니다.
+`McpRequestHeaderFilter`??URI??`/mcp`媛€ ?ы븿???붿껌?먯꽌 ???ㅻ뜑瑜?`McpRequestHeaderContext`???€?ν븯誘€濡?REST `/mcp/{toolName}`怨?MCP Streamable HTTP `/mcp`, `/mcp/message`??紐⑤몢 ?곸슜?⑸땲?? REST 寃쎈줈??`BusinessToolController`???숈씪???ㅻ뜑瑜?吏곸젒 ?쎌뼱 ?ㅽ뻾 ?쒕퉬?ㅼ뿉 ?꾨떖?⑸땲?? ?ㅻ뜑媛€ ?녿뒗 ?섏쐞 HTTP ?몄텧?먮뒗 `X-ANONYMOUS-REQ: AXHUB-TOOL`???ㅼ젙?⑸땲??
 
-기존 `guid`, `employee-no`, `virtual-employee-no` 헤더는 지원하지 않습니다.
+湲곗〈 `guid`, `employee-no`, `virtual-employee-no` ?ㅻ뜑??吏€?먰븯吏€ ?딆뒿?덈떎.
 
-주요 실행 응답은 다음과 같습니다.
+二쇱슂 ?ㅽ뻾 ?묐떟?€ ?ㅼ쓬怨?媛숈뒿?덈떎.
 
-| HTTP 상태 | 코드 | 의미 |
+| HTTP ?곹깭 | 肄붾뱶 | ?섎? |
 |---:|---|---|
-| 200 | - | Tool 실행 성공 |
-| 404 | `TOOL_NOT_FOUND` | 요청한 Tool 이름이 없음 |
-| 422 | `INVALID_PARAM` | 요청이 입력 Schema와 일치하지 않음 |
-| 500 | `INVALID_TOOL_RESPONSE` | 결과가 출력 Schema와 일치하지 않음 |
-| 502 | `TOOL_ERROR` | Tool 실행 중 예외 발생 |
+| 200 | - | Tool ?ㅽ뻾 ?깃났 |
+| 404 | `TOOL_NOT_FOUND` | ?붿껌??Tool ?대쫫???놁쓬 |
+| 422 | `INVALID_PARAM` | ?붿껌???낅젰 Schema?€ ?쇱튂?섏? ?딆쓬 |
+| 500 | `INVALID_TOOL_RESPONSE` | 寃곌낵媛€ 異쒕젰 Schema?€ ?쇱튂?섏? ?딆쓬 |
+| 502 | `TOOL_ERROR` | Tool ?ㅽ뻾 以??덉쇅 諛쒖깮 |
 
-## Tool 구현 방식
+## Tool 援ы쁽 諛⑹떇
 
-호출 가능한 메서드는 Spring AI Community의 `@McpTool`로 선언합니다. 프로젝트 고유 실행·표시 정보는 `@GrowToolHint`로 보완합니다.
+?몄텧 媛€?ν븳 硫붿꽌?쒕뒗 Spring AI Community??`@McpTool`濡??좎뼵?⑸땲?? ?꾨줈?앺듃 怨좎쑀 ?ㅽ뻾쨌?쒖떆 ?뺣낫??`@GrowToolHint`濡?蹂댁셿?⑸땲??
 
 ```java
 @McpTool(
     name = "iam_system_status",
-    title = "시스템 상태 조회",
-    description = "모의 시스템 상태 정보를 조회합니다.",
+    title = "?쒖뒪???곹깭 議고쉶",
+    description = "紐⑥쓽 ?쒖뒪???곹깭 ?뺣낫瑜?議고쉶?⑸땲??",
     annotations = @McpTool.McpAnnotations(openWorldHint = false)
 )
 @GrowToolHint(
@@ -176,76 +176,76 @@ DATMS가 DASMT Tool Service를 호출할 때 사용하는 헤더는 다음과
 SystemStatusResponse getSystemStatus(SystemStatusRequest request);
 ```
 
-`@McpTool.name`은 다음 형식을 사용합니다.
+`@McpTool.name`?€ ?ㅼ쓬 ?뺤떇???ъ슜?⑸땲??
 
 ```text
 ^[a-z][a-z0-9_]{2,63}$
 ```
 
-예: `cmm_claim_search`, `crm_customer_detail`, `iam_system_status`
+?? `cmm_claim_search`, `crm_customer_detail`, `iam_system_status`
 
-이름 중복과 형식은 `validateMcpToolNames` Gradle 작업으로 검사합니다. 현재 루트 `build.gradle`에는 `validateToolSchemaV17` Gradle 작업이 등록되어 있지 않으며, 모든 `bootJar` 작업은 `validateMcpToolNames`에만 의존합니다.
+?대쫫 以묐났怨??뺤떇?€ `validateMcpToolNames` Gradle ?묒뾽?쇰줈 寃€?ы빀?덈떎. ?꾩옱 猷⑦듃 `build.gradle`?먮뒗 `validateToolSchemaV17` Gradle ?묒뾽???깅줉?섏뼱 ?덉? ?딆쑝硫? 紐⑤뱺 `bootJar` ?묒뾽?€ `validateMcpToolNames`?먮쭔 ?섏〈?⑸땲??
 
-## Tool YAML 정의
+## Tool YAML ?뺤쓽
 
-공통 라이브러리는 Tool 메타데이터를 보강하기 위한 선택적 YAML 정의를 지원합니다. YAML 정의를 추가할 경우 업무 모듈의 다음 경로를 사용합니다.
+怨듯넻 ?쇱씠釉뚮윭由щ뒗 Tool 硫뷀??곗씠?곕? 蹂닿컯?섍린 ?꾪븳 ?좏깮??YAML ?뺤쓽瑜?吏€?먰빀?덈떎. YAML ?뺤쓽瑜?異붽???寃쎌슦 ?낅Т 紐⑤뱢???ㅼ쓬 寃쎈줈瑜??ъ슜?⑸땲??
 
 ```text
 dat-was-*/src/main/resources/tool-definitions/{category}/{tool-name}.yml
 ```
 
-현재 업무 모듈에는 이 경로의 YAML 정의가 없습니다. 따라서 실행 시 메타데이터는 `@McpTool`, `@GrowToolHint`, DTO Schema를 기준으로 구성됩니다. YAML 정의를 도입하는 경우 V17 주요 필수 항목은 다음과 같습니다.
+?꾩옱 ?낅Т 紐⑤뱢?먮뒗 ??寃쎈줈??YAML ?뺤쓽媛€ ?놁뒿?덈떎. ?곕씪???ㅽ뻾 ??硫뷀??곗씠?곕뒗 `@McpTool`, `@GrowToolHint`, DTO Schema瑜?湲곗??쇰줈 援ъ꽦?⑸땲?? YAML ?뺤쓽瑜??꾩엯?섎뒗 寃쎌슦 V17 二쇱슂 ?꾩닔 ??ぉ?€ ?ㅼ쓬怨?媛숈뒿?덈떎.
 
 - `name`, `display_name`, `version`, `category_key`
 - `description.function`, `when_to_use`, `when_not_to_use`, `io_limits`
-- 3~10개의 `example_queries`
+- 3~10媛쒖쓽 `example_queries`
 - `read_only`, `destructive`, `idempotent`
 - `parameters_schema.type: object`
 - `parameters_schema.additionalProperties: false`
-- 각 입력 property의 `description`
+- 媛??낅젰 property??`description`
 
-입력·출력 Schema는 `ToolSchemaResolver`가 어노테이션의 Schema 리소스와 인라인 Schema, DTO에서 생성한 Schema를 해석합니다. YAML 정의가 있으면 `ToolRegistryHeartbeatSender`가 `parameters_schema`와 `output_schema`를 병합하여 최종 메타데이터를 만듭니다.
+?낅젰쨌異쒕젰 Schema??`ToolSchemaResolver`媛€ ?대끂?뚯씠?섏쓽 Schema 由ъ냼?ㅼ? ?몃씪??Schema, DTO?먯꽌 ?앹꽦??Schema瑜??댁꽍?⑸땲?? YAML ?뺤쓽媛€ ?덉쑝硫?`ToolRegistryHeartbeatSender`媛€ `parameters_schema`?€ `output_schema`瑜?蹂묓빀?섏뿬 理쒖쥌 硫뷀??곗씠?곕? 留뚮벊?덈떎.
 
-실행 시 Schema 검증은 MCP Java SDK의 `DefaultJsonSchemaValidator`를 사용하며 JSON Schema 2020-12 기준으로 처리합니다. 입력 불일치는 `422 INVALID_PARAM`, 출력 불일치는 `500 INVALID_TOOL_RESPONSE`로 반환됩니다. 단, Schema 해석 또는 검증기 자체에서 예외가 발생하면 현재 구현은 오류를 로그에 기록하고 해당 검증을 건너뜁니다.
+?ㅽ뻾 ??Schema 寃€利앹? MCP Java SDK??`DefaultJsonSchemaValidator`瑜??ъ슜?섎ʼn JSON Schema 2020-12 湲곗??쇰줈 泥섎━?⑸땲?? ?낅젰 遺덉씪移섎뒗 `422 INVALID_PARAM`, 異쒕젰 遺덉씪移섎뒗 `500 INVALID_TOOL_RESPONSE`濡?諛섑솚?⑸땲?? ?? Schema ?댁꽍 ?먮뒗 寃€利앷린 ?먯껜?먯꽌 ?덉쇅媛€ 諛쒖깮?섎㈃ ?꾩옱 援ы쁽?€ ?ㅻ쪟瑜?濡쒓렇??湲곕줉?섍퀬 ?대떦 寃€利앹쓣 嫄대꼫?곷땲??
 
-## 로컬 실행
+## 濡쒖뺄 ?ㅽ뻾
 
-### 사전 조건
+### ?ъ쟾 議곌굔
 
 - JDK 21
-- 프로젝트에 포함된 Gradle Wrapper
-- Redis 또는 외부 연동이 필요한 경우 Docker
+- ?꾨줈?앺듃???ы븿??Gradle Wrapper
+- Redis ?먮뒗 ?몃? ?곕룞???꾩슂??寃쎌슦 Docker
 
-기본 활성 프로필은 `local`입니다. 로컬 프로필은 H2 메모리 DB와 P6Spy를 사용합니다.
+湲곕낯 ?쒖꽦 ?꾨줈?꾩? `local`?낅땲?? 濡쒖뺄 ?꾨줈?꾩? H2 硫붾え由?DB?€ P6Spy瑜??ъ슜?⑸땲??
 
 ```powershell
 $env:SPRING_PROFILES_ACTIVE = 'local'
 $env:TOOL_SERVER_API_KEY = 'tool-server-key'
 ```
 
-`TOOL_SERVER_API_KEY`를 지정하지 않으면 현재 개발 기본값인 `tool-server-key`가 사용됩니다. 운영 환경에서는 기본값을 사용하지 말고 DATMS의 Tool Server API Key와 동일한 별도 Secret을 주입해야 합니다.
+`TOOL_SERVER_API_KEY`瑜?吏€?뺥븯吏€ ?딆쑝硫??꾩옱 媛쒕컻 湲곕낯媛믪씤 `tool-server-key`媛€ ?ъ슜?⑸땲?? ?댁쁺 ?섍꼍?먯꽌??湲곕낯媛믪쓣 ?ъ슜?섏? 留먭퀬 DATMS??Tool Server API Key?€ ?숈씪??蹂꾨룄 Secret??二쇱엯?댁빞 ?⑸땲??
 
-각 Pod는 별도 터미널에서 실행합니다.
+媛?Pod??蹂꾨룄 ?곕??먯뿉???ㅽ뻾?⑸땲??
 
 ```powershell
-# 영업 Tool Pod
+# ?곸뾽 Tool Pod
 $env:AXHUB_TOOL_URL = 'http://localhost:8082'
 .\gradlew.bat :dat-was-sal:bootRun
 
-# 고객 Tool Pod
+# 怨좉컼 Tool Pod
 $env:AXHUB_TOOL_URL = 'http://localhost:8084'
 .\gradlew.bat :dat-was-cus:bootRun
 
-# 상품 Tool Pod
+# ?곹뭹 Tool Pod
 $env:AXHUB_TOOL_URL = 'http://localhost:8085'
 .\gradlew.bat :dat-was-pro:bootRun
 
-# 시스템 Tool Pod
+# ?쒖뒪??Tool Pod
 $env:AXHUB_TOOL_URL = 'http://localhost:8086'
 .\gradlew.bat :dat-was-sys:bootRun
 ```
 
-실행 후 SYS Pod 기준 확인 URL은 다음과 같습니다.
+?ㅽ뻾 ??SYS Pod 湲곗? ?뺤씤 URL?€ ?ㅼ쓬怨?媛숈뒿?덈떎.
 
 ```text
 http://localhost:8086/mcp/api/v1/tools/local
@@ -253,40 +253,40 @@ http://localhost:8086/tool-manifest
 http://localhost:8086/swagger-ui/index.html
 ```
 
-### 주요 환경 변수
+### 二쇱슂 ?섍꼍 蹂€??
 
-| 환경 변수 | 설명 | 기본값 |
+| ?섍꼍 蹂€??| ?ㅻ챸 | 湲곕낯媛?|
 |---|---|---|
-| `SPRING_PROFILES_ACTIVE` | Spring 활성 프로필 | `local` |
-| `PORT` | Pod 수신 포트 | 모듈별 기본 포트 |
-| `TOOL_SERVER_API_KEY` | DATMS가 `X-Tool-Server-API-Key`로 전달할 공통 인증 Key | `tool-server-key` |
-| `AXHUB_TOOL_URL` | Manifest의 Tool endpoint 생성에 사용할 Pod 외부 URL | `http://localhost:${server.port}` |
-| `AXHUB_GATEWAY_URL` | 프로필 및 Compose 호환용 Gateway URL. 현재 DASMT의 push 등록에는 사용하지 않음 | `http://localhost:8081` |
-| `SPRING_DATA_REDIS_HOST` | Redis 호스트 | `localhost` |
-| `SPRING_DATA_REDIS_PORT` | Redis 포트 | `6379` |
-| `GLOW_COMMUNICATION_MCI_HOST` | MCI 대상 호스트 | 프로필별 설정 |
-| `GLOW_COMMUNICATION_MCI_PORT` | MCI 대상 포트 | 프로필별 설정 |
+| `SPRING_PROFILES_ACTIVE` | Spring ?쒖꽦 ?꾨줈??| `local` |
+| `PORT` | Pod ?섏떊 ?ы듃 | 紐⑤뱢蹂?湲곕낯 ?ы듃 |
+| `TOOL_SERVER_API_KEY` | DATMS媛€ `X-Tool-Server-API-Key`濡??꾨떖??怨듯넻 ?몄쬆 Key | `tool-server-key` |
+| `AXHUB_TOOL_URL` | Manifest??Tool endpoint ?앹꽦???ъ슜??Pod ?몃? URL | `http://localhost:${server.port}` |
+| `AXHUB_GATEWAY_URL` | ?꾨줈??諛?Compose ?명솚??Gateway URL. ?꾩옱 DATMT??push ?깅줉?먮뒗 ?ъ슜?섏? ?딆쓬 | `http://localhost:8081` |
+| `SPRING_DATA_REDIS_HOST` | Redis ?몄뒪??| `localhost` |
+| `SPRING_DATA_REDIS_PORT` | Redis ?ы듃 | `6379` |
+| `GLOW_COMMUNICATION_MCI_HOST` | MCI ?€???몄뒪??| ?꾨줈?꾨퀎 ?ㅼ젙 |
+| `GLOW_COMMUNICATION_MCI_PORT` | MCI ?€???ы듃 | ?꾨줈?꾨퀎 ?ㅼ젙 |
 
-`mcp.security.api-key`는 단일 DATMS 공통 Key를, `mcp.security.api-keys`는 `API Key → tenant ID` 형태의 다중 Key를 지원합니다. `ApiKeyInterceptor`는 Spring MVC가 처리하는 `/rpc/**`, `/mcp/**` 요청에 적용되므로 REST `/mcp/{toolName}`과 `/mcp/api/v1/tools/local`은 올바른 `X-Tool-Server-API-Key`가 없으면 `401 Unauthorized`가 됩니다. 두 설정이 모두 비어 있을 때는 해당 MVC 요청을 익명으로 허용합니다. 현재 네 업무 Pod의 기본 `application.yml`은 단일 Key를 설정합니다.
+`mcp.security.api-key`???⑥씪 DATMS 怨듯넻 Key瑜? `mcp.security.api-keys`??`API Key ??tenant ID` ?뺥깭???ㅼ쨷 Key瑜?吏€?먰빀?덈떎. `ApiKeyInterceptor`??Spring MVC媛€ 泥섎━?섎뒗 `/rpc/**`, `/mcp/**` ?붿껌???곸슜?섎?濡?REST `/mcp/{toolName}`怨?`/mcp/api/v1/tools/local`?€ ?щ컮瑜?`X-Tool-Server-API-Key`媛€ ?놁쑝硫?`401 Unauthorized`媛€ ?⑸땲?? ???ㅼ젙??紐⑤몢 鍮꾩뼱 ?덉쓣 ?뚮뒗 ?대떦 MVC ?붿껌???듬챸?쇰줈 ?덉슜?⑸땲?? ?꾩옱 ???낅Т Pod??湲곕낯 `application.yml`?€ ?⑥씪 Key瑜??ㅼ젙?⑸땲??
 
-반면 `/mcp`와 `/mcp/message`는 별도 Servlet으로 등록되어 Spring MVC `HandlerInterceptor`를 통과하지 않습니다. 현재 구현만으로는 이 두 MCP Streamable HTTP 경로에 `ApiKeyInterceptor` 인증이 적용되지 않으므로, 운영 배포 전 Servlet Filter 또는 전용 MCP 인증 계층을 추가해야 합니다.
+諛섎㈃ `/mcp`?€ `/mcp/message`??蹂꾨룄 Servlet?쇰줈 ?깅줉?섏뼱 Spring MVC `HandlerInterceptor`瑜??듦낵?섏? ?딆뒿?덈떎. ?꾩옱 援ы쁽留뚯쑝濡쒕뒗 ????MCP Streamable HTTP 寃쎈줈??`ApiKeyInterceptor` ?몄쬆???곸슜?섏? ?딆쑝誘€濡? ?댁쁺 諛고룷 ??Servlet Filter ?먮뒗 ?꾩슜 MCP ?몄쬆 怨꾩링??異붽??댁빞 ?⑸땲??
 
 ## Scaffold
 
-공통 라이브러리는 새 Tool과 새 Tool Pod를 만드는 두 개의 Java CLI를 제공합니다. 두 클래스의 `main` 메서드를 IDE에서 실행하거나 필요한 인자를 전달해 실행할 수 있습니다.
+怨듯넻 ?쇱씠釉뚮윭由щ뒗 ??Tool怨???Tool Pod瑜?留뚮뱶????媛쒖쓽 Java CLI瑜??쒓났?⑸땲?? ???대옒?ㅼ쓽 `main` 硫붿꽌?쒕? IDE?먯꽌 ?ㅽ뻾?섍굅???꾩슂???몄옄瑜??꾨떖???ㅽ뻾?????덉뒿?덈떎.
 
-| Scaffolder | 역할 | 주요 생성·수정 대상 |
+| Scaffolder | ??븷 | 二쇱슂 ?앹꽦쨌?섏젙 ?€??|
 |---|---|---|
-| `ToolScaffolder` | 기존 Pod에 Tool 구현 추가 | UseCase, DTO, Converter, Mock 응답, V17 Tool YAML, 연동 설정 |
-| `PodScaffolder` | 새 실행 Pod 모듈 추가 | 모듈 디렉터리, `build.gradle`, Dockerfile, Application 클래스, 프로필 설정, `settings.gradle`, `docker-compose.yml` |
+| `ToolScaffolder` | 湲곗〈 Pod??Tool 援ы쁽 異붽? | UseCase, DTO, Converter, Mock ?묐떟, V17 Tool YAML, ?곕룞 ?ㅼ젙 |
+| `PodScaffolder` | ???ㅽ뻾 Pod 紐⑤뱢 異붽? | 紐⑤뱢 ?붾젆?곕━, `build.gradle`, Dockerfile, Application ?대옒?? ?꾨줈???ㅼ젙, `settings.gradle`, `docker-compose.yml` |
 
-`PodScaffolder`의 인자 순서는 다음과 같습니다.
+`PodScaffolder`???몄옄 ?쒖꽌???ㅼ쓬怨?媛숈뒿?덈떎.
 
 ```text
 PodScaffolder <module-name> <port> [author] [yyyy.MM.dd]
 ```
 
-예를 들어 `payment 8099`를 입력하면 `dat-was-payment` 모듈을 생성합니다. 생성되는 `application.yml`에는 다음 계약이 포함됩니다.
+?덈? ?ㅼ뼱 `payment 8099`瑜??낅젰?섎㈃ `dat-was-payment` 紐⑤뱢???앹꽦?⑸땲?? ?앹꽦?섎뒗 `application.yml`?먮뒗 ?ㅼ쓬 怨꾩빟???ы븿?⑸땲??
 
 ```yaml
 mcp:
@@ -297,40 +297,40 @@ mcp:
     api-key: ${TOOL_SERVER_API_KEY:tool-server-key}
 ```
 
-생성되는 Compose 서비스에도 `TOOL_SERVER_API_KEY=${TOOL_SERVER_API_KEY:-tool-server-key}`가 추가됩니다. 생성 후에는 다음 항목을 반드시 확인해야 합니다.
+?앹꽦?섎뒗 Compose ?쒕퉬?ㅼ뿉??`TOOL_SERVER_API_KEY=${TOOL_SERVER_API_KEY:-tool-server-key}`媛€ 異붽??⑸땲?? ?앹꽦 ?꾩뿉???ㅼ쓬 ??ぉ??諛섎뱶???뺤씤?댁빞 ?⑸땲??
 
-1. `bundle-id`를 DATMS에 등록할 bundle ID와 일치시킵니다.
-2. 운영 환경의 `TOOL_SERVER_API_KEY`를 DATMS가 전달하는 Key와 동일한 Secret으로 설정합니다.
-3. 실제 배포 주소에 맞게 `AXHUB_TOOL_URL`을 설정합니다.
-4. MCI·EAI·HTTP 연동 대상과 timeout을 환경별 설정으로 교체합니다.
-5. `validateMcpToolNames`와 모듈·전체 테스트를 실행합니다. YAML 정의를 추가했다면 `ToolSchemaV17ValidationRunner` 또는 관련 테스트로 V17 항목을 별도 검증합니다.
+1. `bundle-id`瑜?DATMS???깅줉??bundle ID?€ ?쇱튂?쒗궢?덈떎.
+2. ?댁쁺 ?섍꼍??`TOOL_SERVER_API_KEY`瑜?DATMS媛€ ?꾨떖?섎뒗 Key?€ ?숈씪??Secret?쇰줈 ?ㅼ젙?⑸땲??
+3. ?ㅼ젣 諛고룷 二쇱냼??留욊쾶 `AXHUB_TOOL_URL`???ㅼ젙?⑸땲??
+4. MCI쨌EAI쨌HTTP ?곕룞 ?€?곴낵 timeout???섍꼍蹂??ㅼ젙?쇰줈 援먯껜?⑸땲??
+5. `validateMcpToolNames`?€ 紐⑤뱢쨌?꾩껜 ?뚯뒪?몃? ?ㅽ뻾?⑸땲?? YAML ?뺤쓽瑜?異붽??덈떎硫?`ToolSchemaV17ValidationRunner` ?먮뒗 愿€???뚯뒪?몃줈 V17 ??ぉ??蹂꾨룄 寃€利앺빀?덈떎.
 
-## 테스트와 검증
+## ?뚯뒪?몄? 寃€利?
 
 ```powershell
-# 운영 소스 전체 컴파일
+# ?댁쁺 ?뚯뒪 ?꾩껜 而댄뙆??
 .\gradlew.bat classes
 
-# 전체 테스트
+# ?꾩껜 ?뚯뒪??
 .\gradlew.bat test
 
-# 모듈별 테스트
+# 紐⑤뱢蹂??뚯뒪??
 .\gradlew.bat :dat-was-lib:test
 .\gradlew.bat :dat-was-cus:test
 .\gradlew.bat :dat-was-sal:test
 .\gradlew.bat :dat-was-pro:test
 .\gradlew.bat :dat-was-sys:test
 
-# Tool 이름·중복 검사
+# Tool ?대쫫쨌以묐났 寃€??
 .\gradlew.bat validateMcpToolNames
 
-# 검증, 테스트, 패키징
+# 寃€利? ?뚯뒪?? ?⑦궎吏?
 .\gradlew.bat clean build
 ```
 
-### 실행 전 확인
+### ?ㅽ뻾 ???뺤씤
 
-테스트 수와 성공 여부는 소스 변경에 따라 달라지므로 고정된 수치를 문서화하지 않습니다. 배포 전 현재 작업 트리에서 다음 명령을 실행해 확인합니다.
+?뚯뒪???섏? ?깃났 ?щ????뚯뒪 蹂€寃쎌뿉 ?곕씪 ?щ씪吏€誘€濡?怨좎젙???섏튂瑜?臾몄꽌?뷀븯吏€ ?딆뒿?덈떎. 諛고룷 ???꾩옱 ?묒뾽 ?몃━?먯꽌 ?ㅼ쓬 紐낅졊???ㅽ뻾???뺤씤?⑸땲??
 
 ```powershell
 .\gradlew.bat test validateMcpToolNames
@@ -338,138 +338,139 @@ mcp:
 
 ## Docker Compose
 
-`docker-compose.yml`은 DASMT의 네 업무 Pod만 정의합니다.
+`docker-compose.yml`?€ DATMT?????낅Т Pod留??뺤쓽?⑸땲??
 
-| 서비스 | 컨테이너 포트 | 호스트 포트 |
+| ?쒕퉬??| 而⑦뀒?대꼫 ?ы듃 | ?몄뒪???ы듃 |
 |---|---:|---:|
 | `was-sal` | 8082 | 8282 |
 | `was-cus` | 8084 | 8284 |
 | `was-pro` | 8085 | 8285 |
 | `was-sys` | 8086 | 8286 |
 
-모듈 Dockerfile은 사전에 생성된 Boot JAR를 이미지에 복사합니다. 먼저 JAR를 빌드한 뒤 Compose를 실행합니다.
+紐⑤뱢 Dockerfile?€ ?ъ쟾???앹꽦??Boot JAR瑜??대?吏€??蹂듭궗?⑸땲?? 癒쇱? JAR瑜?鍮뚮뱶????Compose瑜??ㅽ뻾?⑸땲??
 
 ```powershell
 .\gradlew.bat :dat-was-sal:bootJar :dat-was-cus:bootJar :dat-was-pro:bootJar :dat-was-sys:bootJar
 docker compose up --build
 ```
 
-Compose 파일의 용도와 현재 주의점은 다음과 같습니다.
+Compose ?뚯씪???⑸룄?€ ?꾩옱 二쇱쓽?먯? ?ㅼ쓬怨?媛숈뒿?덈떎.
 
-| 파일 | 용도 | 현재 소스 기준 주의점 |
+| ?뚯씪 | ?⑸룄 | ?꾩옱 ?뚯뒪 湲곗? 二쇱쓽??|
 |---|---|---|
-| `docker-compose.yml` | DASMT 네 Pod 단독 실행 | `gateway` 서비스가 없지만 push 등록이 제거되어 DASMT 시작에는 필요하지 않음 |
-| `docker-compose.local.yml` | DATMS와 DASMT의 로컬 통합 구성 | 두 저장소가 같은 상위 디렉터리에 있는 구조를 가정 |
-| `docker-compose.prod.yml` | DATMS와 DASMT의 개발 프로필 기반 OCI 구성 | 저장소의 runner 등록 토큰을 운영 Secret으로 분리해야 함 |
+| `docker-compose.yml` | DATMT ??Pod ?⑤룆 ?ㅽ뻾 | `gateway` ?쒕퉬?ㅺ? ?놁?留?push ?깅줉???쒓굅?섏뼱 DATMT ?쒖옉?먮뒗 ?꾩슂?섏? ?딆쓬 |
+| `docker-compose.local.yml` | DATMS?€ DATMT??濡쒖뺄 ?듯빀 援ъ꽦 | ???€?μ냼媛€ 媛숈? ?곸쐞 ?붾젆?곕━???덈뒗 援ъ“瑜?媛€??|
+| `docker-compose.prod.yml` | DATMS?€ DATMT??媛쒕컻 ?꾨줈??湲곕컲 OCI 援ъ꽦 | ?€?μ냼??runner ?깅줉 ?좏겙???댁쁺 Secret?쇰줈 遺꾨━?댁빞 ??|
 
-`docker-compose.local.yml`과 `docker-compose.prod.yml`의 build context는 각각 `./dat-was-DATMS`, `./dat-was-dasmt`입니다. 현재 파일 위치에서 사용할 때는 context 기준을 두 저장소의 상위 디렉터리로 맞춰야 합니다.
+`docker-compose.local.yml`怨?`docker-compose.prod.yml`??build context??媛곴컖 `./dat-was-DATMS`, `./dat-was-datmt`?낅땲?? ?꾩옱 ?뚯씪 ?꾩튂?먯꽌 ?ъ슜???뚮뒗 context 湲곗??????€?μ냼???곸쐞 ?붾젆?곕━濡?留욎떠???⑸땲??
 
 ```powershell
-# DASMT 저장소 디렉터리에서 실행
+# DATMT ?€?μ냼 ?붾젆?곕━?먯꽌 ?ㅽ뻾
 docker compose --project-directory .. -f docker-compose.local.yml up --build
 ```
 
-현재 기존 네 Pod의 Compose 정의에는 `TOOL_SERVER_API_KEY` 환경 변수 전달이 없습니다. 따라서 컨테이너는 애플리케이션 기본값 `tool-server-key`를 사용합니다. 운영 배포 전 각 서비스에 Secret 기반 `TOOL_SERVER_API_KEY` 전달 설정을 추가하고 DATMS의 Key와 일치시켜야 합니다. DATMS는 각 Pod의 `AXHUB_TOOL_URL` 또는 배포 URL에 접근해 `/tool-manifest`를 pull할 수 있어야 합니다.
+?꾩옱 湲곗〈 ??Pod??Compose ?뺤쓽?먮뒗 `TOOL_SERVER_API_KEY` ?섍꼍 蹂€???꾨떖???놁뒿?덈떎. ?곕씪??而⑦뀒?대꼫???좏뵆由ъ??댁뀡 湲곕낯媛?`tool-server-key`瑜??ъ슜?⑸땲?? ?댁쁺 諛고룷 ??媛??쒕퉬?ㅼ뿉 Secret 湲곕컲 `TOOL_SERVER_API_KEY` ?꾨떖 ?ㅼ젙??異붽??섍퀬 DATMS??Key?€ ?쇱튂?쒖폒???⑸땲?? DATMS??媛?Pod??`AXHUB_TOOL_URL` ?먮뒗 諛고룷 URL???묎렐??`/tool-manifest`瑜?pull?????덉뼱???⑸땲??
 
-## OpenShift (Kubernetes) 배포
+## OpenShift (Kubernetes) 諛고룷
 
-OpenShift 개발 환경용 Kustomize 매니페스트는 [`k8s/`](k8s/)에 있습니다. 대상은 DASMT의 네 Tool Pod뿐이며 DATMS(Gateway)의 Deployment·Service·Route는 이 저장소에서 만들지 않습니다.
+OpenShift 媛쒕컻 ?섍꼍??Kustomize 留ㅻ땲?섏뒪?몃뒗 [`k8s/`](k8s/)???덉뒿?덈떎. ?€?곸? DATMT????Tool Pod肉먯씠硫?DATMS(Gateway)??Deployment쨌Service쨌Route?????€?μ냼?먯꽌 留뚮뱾吏€ ?딆뒿?덈떎.
 
 ```text
 k8s/
-├─ base/                 # 네 Pod 공통 ConfigMap, Service, Deployment
-└─ overlays/dev/         # 개발 namespace, Registry 이미지 경로와 tag
+?쒋? base/                 # ??Pod 怨듯넻 ConfigMap, Service, Deployment
+?붴? overlays/dev/         # 媛쒕컻 namespace, Registry ?대?吏€ 寃쎈줈?€ tag
 ```
 
-### 배포 구조
+### 諛고룷 援ъ“
 
-각 Tool Pod는 Deployment 1개와 외부에 노출되지 않는 `ClusterIP` Service 1개를 사용합니다. OpenShift Route와 LoadBalancer Service는 생성하지 않으며, Gateway가 클러스터 내부 DNS로 호출합니다.
+媛?Tool Pod??Deployment 1媛쒖? ?몃????몄텧?섏? ?딅뒗 `ClusterIP` Service 1媛쒕? ?ъ슜?⑸땲?? OpenShift Route?€ LoadBalancer Service???앹꽦?섏? ?딆쑝硫? Gateway媛€ ?대윭?ㅽ꽣 ?대? DNS濡??몄텧?⑸땲??
 
-| Service | Pod 포트 | Gateway 호출 주소 |
+| Service | Pod ?ы듃 | Gateway ?몄텧 二쇱냼 |
 |---|---:|---|
 | `was-sal` | 8082 | `http://was-sal:8082` |
 | `was-cus` | 8084 | `http://was-cus:8084` |
 | `was-pro` | 8085 | `http://was-pro:8085` |
 | `was-sys` | 8086 | `http://was-sys:8086` |
 
-Gateway가 다른 namespace에 있으면 `was-sal.axhub-dasmt-dev.svc`와 같은 FQDN을 사용하고, NetworkPolicy에서 Gateway namespace의 ingress를 별도로 허용해야 합니다.
+Gateway媛€ ?ㅻⅨ namespace???덉쑝硫?`was-sal.axhub-datmt-dev.svc`?€ 媛숈? FQDN???ъ슜?섍퀬, NetworkPolicy?먯꽌 Gateway namespace??ingress瑜?蹂꾨룄濡??덉슜?댁빞 ?⑸땲??
 
-### 반영 전 설정
+### 諛섏쁺 ???ㅼ젙
 
-다음 값은 실제 신한라이프 개발망 값으로 교체해야 합니다.
+?ㅼ쓬 媛믪? ?ㅼ젣 ?좏븳?쇱씠??媛쒕컻留?媛믪쑝濡?援먯껜?댁빞 ?⑸땲??
 
-1. [`k8s/overlays/dev/kustomization.yaml`](k8s/overlays/dev/kustomization.yaml)의 namespace, 내부 Container Registry 경로, 배포 image tag
-2. [`k8s/base/configmap.yaml`](k8s/base/configmap.yaml)의 `CHANGE_ME` MCI·EXTMCI·EAI 호스트
-3. 실제 Secret 값
+1. [`k8s/overlays/dev/kustomization.yaml`](k8s/overlays/dev/kustomization.yaml)??namespace, ?대? Container Registry 寃쎈줈, 諛고룷 image tag
+2. [`k8s/base/configmap.yaml`](k8s/base/configmap.yaml)??`CHANGE_ME` MCI쨌EXTMCI쨌EAI ?몄뒪??
+3. ?ㅼ젣 Secret 媛?
 
-`dasmt-runtime-secrets` Secret은 Git에 저장하지 않고 OpenShift namespace에서 별도로 생성합니다. 최소한 `TOOL_SERVER_API_KEY`는 DATMS가 전달하는 `X-Tool-Server-API-Key`와 같은 값이어야 합니다. DB 계정·비밀번호, API Key, 인증서 비밀번호 등도 이 Secret으로 관리합니다.
+`datmt-runtime-secrets` Secret?€ Git???€?ν븯吏€ ?딄퀬 OpenShift namespace?먯꽌 蹂꾨룄濡??앹꽦?⑸땲?? 理쒖냼??`TOOL_SERVER_API_KEY`??DATMS媛€ ?꾨떖?섎뒗 `X-Tool-Server-API-Key`?€ 媛숈? 媛믪씠?댁빞 ?⑸땲?? DB 怨꾩젙쨌鍮꾨?踰덊샇, API Key, ?몄쬆??鍮꾨?踰덊샇 ?깅룄 ??Secret?쇰줈 愿€由ы빀?덈떎.
 
 ```powershell
-# runtime-secrets.env는 저장소 밖에 보관합니다.
-oc -n axhub-dasmt-dev create secret generic dasmt-runtime-secrets `
+# runtime-secrets.env???€?μ냼 諛뽰뿉 蹂닿??⑸땲??
+oc -n axhub-datmt-dev create secret generic datmt-runtime-secrets `
   --from-env-file=runtime-secrets.env
 ```
 
-Secret이 없으면 각 Deployment의 `envFrom.secretRef`를 해석할 수 없어 Pod가 시작하지 않을 수 있습니다.
+Secret???놁쑝硫?媛?Deployment??`envFrom.secretRef`瑜??댁꽍?????놁뼱 Pod媛€ ?쒖옉?섏? ?딆쓣 ???덉뒿?덈떎.
 
-### 이미지 빌드와 배포
+### ?대?吏€ 鍮뚮뱶?€ 諛고룷
 
-모듈 Dockerfile은 미리 생성된 Boot JAR를 복사하므로, 이미지를 만들기 전에 네 모듈의 JAR를 빌드합니다. 개발망에서는 JDK/JRE 베이스 이미지와 Gradle/Maven 의존성을 내부 Registry·Nexus에서 사용할 수 있어야 합니다.
+紐⑤뱢 Dockerfile?€ 誘몃━ ?앹꽦??Boot JAR瑜?蹂듭궗?섎?濡? ?대?吏€瑜?留뚮뱾湲??꾩뿉 ??紐⑤뱢??JAR瑜?鍮뚮뱶?⑸땲?? 媛쒕컻留앹뿉?쒕뒗 JDK/JRE 踰좎씠???대?吏€?€ Gradle/Maven ?섏〈?깆쓣 ?대? Registry쨌Nexus?먯꽌 ?ъ슜?????덉뼱???⑸땲??
 
 ```powershell
 .\gradlew.bat :dat-was-sal:bootJar :dat-was-cus:bootJar :dat-was-pro:bootJar :dat-was-sys:bootJar
 
-# OpenShift 로그인 및 project 선택 후
+# OpenShift 濡쒓렇??諛?project ?좏깮 ??
 oc kustomize k8s/overlays/dev
 oc apply -k k8s/overlays/dev
-oc get deployment,pod,svc -n axhub-dasmt-dev
+oc get deployment,pod,svc -n axhub-datmt-dev
 ```
 
-적용 전에는 `oc kustomize k8s/overlays/dev | oc apply --dry-run=client -f -`로 서버 측 스키마 검증을 수행합니다. 현재 매니페스트의 readiness/liveness probe는 TCP 포트 확인 방식입니다. Actuator health endpoint를 추가한 뒤에는 HTTP readiness/liveness probe로 변경하는 것을 권장합니다.
+?곸슜 ?꾩뿉??`oc kustomize k8s/overlays/dev | oc apply --dry-run=client -f -`濡??쒕쾭 痢??ㅽ궎留?寃€利앹쓣 ?섑뻾?⑸땲?? ?꾩옱 留ㅻ땲?섏뒪?몄쓽 readiness/liveness probe??TCP ?ы듃 ?뺤씤 諛⑹떇?낅땲?? Actuator health endpoint瑜?異붽????ㅼ뿉??HTTP readiness/liveness probe濡?蹂€寃쏀븯??寃껋쓣 沅뚯옣?⑸땲??
 
-상세한 명령과 Gateway 연결 확인 방법은 [`k8s/README.md`](k8s/README.md)를 참고합니다.
+?곸꽭??紐낅졊怨?Gateway ?곌껐 ?뺤씤 諛⑸쾿?€ [`k8s/README.md`](k8s/README.md)瑜?李멸퀬?⑸땲??
 
-## 보안 및 운영 주의사항
+## 蹂댁븞 諛??댁쁺 二쇱쓽?ы빆
 
-현재 구현을 운영 환경에 노출하기 전에 아래 항목을 반드시 점검해야 합니다.
+?꾩옱 援ы쁽???댁쁺 ?섍꼍???몄텧?섍린 ?꾩뿉 ?꾨옒 ??ぉ??諛섎뱶???먭??댁빞 ?⑸땲??
 
-- API Key 인터셉터는 Spring MVC의 `/rpc/**`, `/mcp/**` Handler에 적용됩니다. REST `/mcp/{toolName}`과 `/mcp/api/v1/tools/local`은 인증 대상입니다.
-- 별도 Servlet인 `/mcp`, `/mcp/message`는 MVC 인터셉터를 우회하므로 현재 API Key 인증 대상이 아닙니다. 운영 노출 전에 별도 인증을 추가해야 합니다.
-- `/tool-manifest`와 `/tool-manifest/{categoryKey}`는 위 인터셉터 경로 밖에 있어 현재 API Key 인증 대상이 아닙니다. 내부망·Ingress 정책 또는 별도 인증이 필요한지 운영 기준을 확인해야 합니다.
-- 네 업무 Pod의 기본 Key는 모두 `tool-server-key`입니다. 운영에서는 반드시 별도 Secret으로 교체하고 DATMS의 `X-Tool-Server-API-Key` 값과 일치시켜야 합니다.
-- 설정된 단일 Key와 다중 Key가 모두 없을 때만 익명 요청이 허용됩니다.
-- `mcp.security.tenant-domains`는 설정 객체에 바인딩되지만 Tool별 인가에 사용되지 않습니다.
-- `requiresApproval`은 메타데이터에만 기록되며 실행 차단이나 승인 확인 로직은 없습니다.
-- 입력·출력 Schema 처리 자체에서 예외가 발생하면 현재 실행 서비스는 로그를 남기고 검증을 건너뜁니다.
-- CORS는 모든 Origin을 허용하면서 credential도 허용하도록 설정되어 있습니다. 운영 Origin을 명시적으로 제한해야 합니다.
-- `docker-compose.prod.yml`에 runner 등록 토큰이 평문으로 포함되어 있습니다. 사용 중인 토큰은 폐기·재발급하고 배포 Secret으로 이전해야 합니다.
-- Tool 요청과 연동 오류 로그에 개인정보나 인증정보가 포함되지 않도록 DTO와 로그 마스킹 정책을 검토해야 합니다.
+- API Key ?명꽣?됲꽣??Spring MVC??`/rpc/**`, `/mcp/**` Handler???곸슜?⑸땲?? REST `/mcp/{toolName}`怨?`/mcp/api/v1/tools/local`?€ ?몄쬆 ?€?곸엯?덈떎.
+- 蹂꾨룄 Servlet??`/mcp`, `/mcp/message`??MVC ?명꽣?됲꽣瑜??고쉶?섎?濡??꾩옱 API Key ?몄쬆 ?€?곸씠 ?꾨떃?덈떎. ?댁쁺 ?몄텧 ?꾩뿉 蹂꾨룄 ?몄쬆??異붽??댁빞 ?⑸땲??
+- `/tool-manifest`?€ `/tool-manifest/{categoryKey}`?????명꽣?됲꽣 寃쎈줈 諛뽰뿉 ?덉뼱 ?꾩옱 API Key ?몄쬆 ?€?곸씠 ?꾨떃?덈떎. ?대?留씲텶ngress ?뺤콉 ?먮뒗 蹂꾨룄 ?몄쬆???꾩슂?쒖? ?댁쁺 湲곗????뺤씤?댁빞 ?⑸땲??
+- ???낅Т Pod??湲곕낯 Key??紐⑤몢 `tool-server-key`?낅땲?? ?댁쁺?먯꽌??諛섎뱶??蹂꾨룄 Secret?쇰줈 援먯껜?섍퀬 DATMS??`X-Tool-Server-API-Key` 媛믨낵 ?쇱튂?쒖폒???⑸땲??
+- ?ㅼ젙???⑥씪 Key?€ ?ㅼ쨷 Key媛€ 紐⑤몢 ?놁쓣 ?뚮쭔 ?듬챸 ?붿껌???덉슜?⑸땲??
+- `mcp.security.tenant-domains`???ㅼ젙 媛앹껜??諛붿씤?⑸릺吏€留?Tool蹂??멸????ъ슜?섏? ?딆뒿?덈떎.
+- `requiresApproval`?€ 硫뷀??곗씠?곗뿉留?湲곕줉?섎ʼn ?ㅽ뻾 李⑤떒?대굹 ?뱀씤 ?뺤씤 濡쒖쭅?€ ?놁뒿?덈떎.
+- ?낅젰쨌異쒕젰 Schema 泥섎━ ?먯껜?먯꽌 ?덉쇅媛€ 諛쒖깮?섎㈃ ?꾩옱 ?ㅽ뻾 ?쒕퉬?ㅻ뒗 濡쒓렇瑜??④린怨?寃€利앹쓣 嫄대꼫?곷땲??
+- CORS??紐⑤뱺 Origin???덉슜?섎㈃??credential???덉슜?섎룄濡??ㅼ젙?섏뼱 ?덉뒿?덈떎. ?댁쁺 Origin??紐낆떆?곸쑝濡??쒗븳?댁빞 ?⑸땲??
+- `docker-compose.prod.yml`??runner ?깅줉 ?좏겙???됰Ц?쇰줈 ?ы븿?섏뼱 ?덉뒿?덈떎. ?ъ슜 以묒씤 ?좏겙?€ ?먭린쨌?щ컻湲됲븯怨?諛고룷 Secret?쇰줈 ?댁쟾?댁빞 ?⑸땲??
+- Tool ?붿껌怨??곕룞 ?ㅻ쪟 濡쒓렇??媛쒖씤?뺣낫???몄쬆?뺣낫媛€ ?ы븿?섏? ?딅룄濡?DTO?€ 濡쒓렇 留덉뒪???뺤콉??寃€?좏빐???⑸땲??
 
-## 주요 소스 위치
+## 二쇱슂 ?뚯뒪 ?꾩튂
 
-| 주제 | 위치 |
+| 二쇱젣 | ?꾩튂 |
 |---|---|
-| 공통 빌드 및 검증 작업 | `build.gradle` |
-| REST Tool 실행 API | `dat-was-lib/src/main/java/io/shinhanlife/dat/mcc/presentation/BusinessToolController.java` |
-| 요청 헤더 캡처·전달 | `dat-was-lib/src/main/java/io/shinhanlife/dat/lib/mcp/McpRequestHeaderFilter.java`, `McpRequestHeaderContext.java` |
-| Tool 실행 서비스 | `dat-was-lib/src/main/java/io/shinhanlife/dat/lib/mcp/McpToolExecutionService.java` |
-| JSON Schema 2020-12 검증 설정 | `dat-was-lib/src/main/java/io/shinhanlife/dat/lib/config/ToolSchemaConfiguration.java` |
-| 실행 메서드 Registry | `dat-was-lib/src/main/java/io/shinhanlife/dat/lib/mcp/McpToolMethodRegistry.java` |
-| MCP SDK 서버 | `dat-was-lib/src/main/java/io/shinhanlife/dat/lib/mcp/ToolMcpServerConfiguration.java` |
-| MCP Tool 동기화 | `dat-was-lib/src/main/java/io/shinhanlife/dat/lib/mcp/ToolPodMcpToolSynchronizer.java` |
-| Tool 스캔 및 메타데이터 생성 | `dat-was-lib/src/main/java/io/shinhanlife/dat/lib/mcp/ToolRegistryHeartbeatSender.java` |
-| YAML Tool 정의 로딩 | `dat-was-lib/src/main/java/io/shinhanlife/dat/lib/metadata/ToolDefinitionRepository.java` |
-| V17 정의 검증 | `dat-was-lib/src/main/java/io/shinhanlife/dat/lib/metadata/ToolDefinitionValidator.java` |
-| Manifest 생성 | `dat-was-lib/src/main/java/io/shinhanlife/dat/lib/manifest/ToolManifestService.java` |
-| API Key 인터셉터 | `dat-was-lib/src/main/java/io/shinhanlife/dat/lib/mcp/security/ApiKeyInterceptor.java` |
-| Tool·Pod 스캐폴딩 | `dat-was-lib/src/main/java/io/shinhanlife/dat/lib/util/ToolScaffolder.java`, `PodScaffolder.java` |
+| 怨듯넻 鍮뚮뱶 諛?寃€利??묒뾽 | `build.gradle` |
+| REST Tool ?ㅽ뻾 API | `dat-was-lib/src/main/java/io/shinhanlife/dat/mcc/presentation/BusinessToolController.java` |
+| ?붿껌 ?ㅻ뜑 罹≪쿂쨌?꾨떖 | `dat-was-lib/src/main/java/io/shinhanlife/dat/lib/mcp/McpRequestHeaderFilter.java`, `McpRequestHeaderContext.java` |
+| Tool ?ㅽ뻾 ?쒕퉬??| `dat-was-lib/src/main/java/io/shinhanlife/dat/lib/mcp/McpToolExecutionService.java` |
+| JSON Schema 2020-12 寃€利??ㅼ젙 | `dat-was-lib/src/main/java/io/shinhanlife/dat/lib/config/ToolSchemaConfiguration.java` |
+| ?ㅽ뻾 硫붿꽌??Registry | `dat-was-lib/src/main/java/io/shinhanlife/dat/lib/mcp/McpToolMethodRegistry.java` |
+| MCP SDK ?쒕쾭 | `dat-was-lib/src/main/java/io/shinhanlife/dat/lib/mcp/ToolMcpServerConfiguration.java` |
+| MCP Tool ?숆린??| `dat-was-lib/src/main/java/io/shinhanlife/dat/lib/mcp/ToolPodMcpToolSynchronizer.java` |
+| Tool ?ㅼ틪 諛?硫뷀??곗씠???앹꽦 | `dat-was-lib/src/main/java/io/shinhanlife/dat/lib/mcp/ToolRegistryHeartbeatSender.java` |
+| YAML Tool ?뺤쓽 濡쒕뵫 | `dat-was-lib/src/main/java/io/shinhanlife/dat/lib/metadata/ToolDefinitionRepository.java` |
+| V17 ?뺤쓽 寃€利?| `dat-was-lib/src/main/java/io/shinhanlife/dat/lib/metadata/ToolDefinitionValidator.java` |
+| Manifest ?앹꽦 | `dat-was-lib/src/main/java/io/shinhanlife/dat/lib/manifest/ToolManifestService.java` |
+| API Key ?명꽣?됲꽣 | `dat-was-lib/src/main/java/io/shinhanlife/dat/lib/mcp/security/ApiKeyInterceptor.java` |
+| Tool쨌Pod ?ㅼ틦?대뵫 | `dat-was-lib/src/main/java/io/shinhanlife/dat/lib/util/ToolScaffolder.java`, `PodScaffolder.java` |
 
-## 개발 시 권장 확인 순서
+## 媛쒕컻 ??沅뚯옣 ?뺤씤 ?쒖꽌
+
+1. Tool 硫붿꽌?쒖? ?붿껌쨌?묐떟 DTO瑜?援ы쁽?⑸땲??
+2. ?숈씪 ?대쫫??V17 YAML ?뺤쓽瑜?`tool-definitions` ?꾨옒??異붽??⑸땲??
+3. `validateMcpToolNames`?€ 紐⑤뱢쨌?꾩껜 ?뚯뒪?몃? ?ㅽ뻾?⑸땲?? Tool YAML ?뺤쓽瑜?異붽???寃쎌슦?먮뒗 V17 ??ぉ??蹂꾨룄 寃€利앺빀?덈떎.
+4. 紐⑤뱢 ?뚯뒪?몄? ?꾩껜 ?뚯뒪?몃? ?ㅽ뻾?⑸땲??
+5. 濡쒖뺄 Pod?먯꽌 `/mcp/api/v1/tools/local`怨?`/tool-manifest`瑜??뺤씤?⑸땲??
+6. DATMS??bundle ID, Pod Manifest URL, Tool Server API Key媛€ DATMT ?ㅼ젙怨??쇱튂?섎뒗吏€ ?뺤씤?⑸땲??
+7. REST?€ MCP ?묒そ?먯꽌 ?숈씪??Tool 寃곌낵쨌?붿껌 ?ㅻ뜑 ?꾨떖쨌?ㅻ쪟 怨꾩빟???뺤씤?⑸땲??
 
-1. Tool 메서드와 요청·응답 DTO를 구현합니다.
-2. 동일 이름의 V17 YAML 정의를 `tool-definitions` 아래에 추가합니다.
-3. `validateMcpToolNames`와 모듈·전체 테스트를 실행합니다. Tool YAML 정의를 추가한 경우에는 V17 항목을 별도 검증합니다.
-4. 모듈 테스트와 전체 테스트를 실행합니다.
-5. 로컬 Pod에서 `/mcp/api/v1/tools/local`과 `/tool-manifest`를 확인합니다.
-6. DATMS의 bundle ID, Pod Manifest URL, Tool Server API Key가 DASMT 설정과 일치하는지 확인합니다.
-7. REST와 MCP 양쪽에서 동일한 Tool 결과·요청 헤더 전달·오류 계약을 확인합니다.