From 2f5dad05dfb0cc71539d7d8586f43eac0e89ddce Mon Sep 17 00:00:00 2001
From: juheelee <jessia0308@nate.com>
Date: Wed, 29 Jul 2026 15:34:01 +0900
Subject: [PATCH 1/3] =?UTF-8?q?feat:=20=EB=A9=94=ED=83=80=20=ED=86=B5?=
 =?UTF-8?q?=ED=95=A9=20=EC=BD=94=EB=93=9C=20=EC=A1=B0=ED=9A=8C?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../converter/MetaCommonCodeConverter.java    | 31 +++++++
 .../biz/cmm/dto/MetaCommonCodeRequest.java    | 32 +++++++
 .../biz/cmm/dto/MetaCommonCodeResponse.java   | 37 ++++++++
 .../cmm/usecase/MetaCommonCodeUseCase.java    | 37 ++++++++
 .../impl/MetaCommonCodeUseCaseImpl.java       | 89 +++++++++++++++++++
 5 files changed, 226 insertions(+)
 create mode 100644 dap-tool-oth/src/main/java/io/shinhanlife/dap/mcc/biz/cmm/converter/MetaCommonCodeConverter.java
 create mode 100644 dap-tool-oth/src/main/java/io/shinhanlife/dap/mcc/biz/cmm/dto/MetaCommonCodeRequest.java
 create mode 100644 dap-tool-oth/src/main/java/io/shinhanlife/dap/mcc/biz/cmm/dto/MetaCommonCodeResponse.java
 create mode 100644 dap-tool-oth/src/main/java/io/shinhanlife/dap/mcc/biz/cmm/usecase/MetaCommonCodeUseCase.java
 create mode 100644 dap-tool-oth/src/main/java/io/shinhanlife/dap/mcc/biz/cmm/usecase/impl/MetaCommonCodeUseCaseImpl.java

diff --git a/dap-tool-oth/src/main/java/io/shinhanlife/dap/mcc/biz/cmm/converter/MetaCommonCodeConverter.java b/dap-tool-oth/src/main/java/io/shinhanlife/dap/mcc/biz/cmm/converter/MetaCommonCodeConverter.java
new file mode 100644
index 00000000..47b2bebf
--- /dev/null
+++ b/dap-tool-oth/src/main/java/io/shinhanlife/dap/mcc/biz/cmm/converter/MetaCommonCodeConverter.java
@@ -0,0 +1,31 @@
+package io.shinhanlife.dap.mcc.biz.cmm.converter;
+
+import io.shinhanlife.dap.mcc.biz.cmm.dto.MetaCommonCodeRequest;
+import io.shinhanlife.dap.mcc.biz.cmm.dto.MetaCommonCodeResponse;
+import io.shinhanlife.dap.mcc.infra.itrf.mci.cfp.a.io.CLCNNB00001_I;
+import io.shinhanlife.dap.mcc.infra.itrf.mci.cfp.a.io.CLCNNB00001_O;
+import org.mapstruct.Mapper;
+import org.mapstruct.Mapping;
+
+/**
+ * @package io.shinhanlife.dap.mcc.biz.cmm.converter
+ * @className MetaCommonCodeConverter
+ * @description AX HUB 시스템 처리 클래스
+ * @author 0986406
+ * @create 2026.07.29
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.07.29  0986406    최초생성
+ * 
+ * </pre>
+ */
+@Mapper(componentModel = "spring")
+public interface MetaCommonCodeConverter {
+    @Mapping(target = "csNo", source = "groupCode", defaultValue = "GRP_COMM_CD")
+    CLCNNB00001_I toLegacyRequest(MetaCommonCodeRequest req);
+
+    @Mapping(target = "codeList", ignore = true)
+    MetaCommonCodeResponse toResponse(CLCNNB00001_O mciRes);
+}
diff --git a/dap-tool-oth/src/main/java/io/shinhanlife/dap/mcc/biz/cmm/dto/MetaCommonCodeRequest.java b/dap-tool-oth/src/main/java/io/shinhanlife/dap/mcc/biz/cmm/dto/MetaCommonCodeRequest.java
new file mode 100644
index 00000000..1cb36e79
--- /dev/null
+++ b/dap-tool-oth/src/main/java/io/shinhanlife/dap/mcc/biz/cmm/dto/MetaCommonCodeRequest.java
@@ -0,0 +1,32 @@
+package io.shinhanlife.dap.mcc.biz.cmm.dto;
+
+import com.fasterxml.jackson.annotation.JsonInclude;
+import io.shinhanlife.dap.lib.annotation.McpParameter;
+import lombok.Data;
+
+/**
+ * @package io.shinhanlife.dap.mcc.biz.cmm.dto
+ * @className MetaCommonCodeRequest
+ * @description AX HUB 시스템 처리 클래스
+ * @author 0986406
+ * @create 2026.07.29
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.07.29  0986406    최초생성
+ * 
+ * </pre>
+ */
+@Data
+@JsonInclude(JsonInclude.Include.NON_NULL)
+public class MetaCommonCodeRequest {
+    @McpParameter(description = "통합코드 그룹 ID (예: GRP_SYS_01, GRP_COMM_CD)", required = false)
+    private String groupCode;
+
+    @McpParameter(description = "코드명 검색 키워드 (예: 사용, 상태)", required = false)
+    private String codeName;
+
+    @McpParameter(description = "사용여부 (예: Y, N)", required = false)
+    private String useYn;
+}
diff --git a/dap-tool-oth/src/main/java/io/shinhanlife/dap/mcc/biz/cmm/dto/MetaCommonCodeResponse.java b/dap-tool-oth/src/main/java/io/shinhanlife/dap/mcc/biz/cmm/dto/MetaCommonCodeResponse.java
new file mode 100644
index 00000000..751f2404
--- /dev/null
+++ b/dap-tool-oth/src/main/java/io/shinhanlife/dap/mcc/biz/cmm/dto/MetaCommonCodeResponse.java
@@ -0,0 +1,37 @@
+package io.shinhanlife.dap.mcc.biz.cmm.dto;
+
+import com.fasterxml.jackson.annotation.JsonInclude;
+import lombok.Data;
+
+import java.util.List;
+
+/**
+ * @package io.shinhanlife.dap.mcc.biz.cmm.dto
+ * @className MetaCommonCodeResponse
+ * @description AX HUB 시스템 처리 클래스
+ * @author 0986406
+ * @create 2026.07.29
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.07.29  0986406    최초생성
+ * 
+ * </pre>
+ */
+@Data
+@JsonInclude(JsonInclude.Include.NON_NULL)
+public class MetaCommonCodeResponse {
+    private List<MetaCommonCodeItem> codeList;
+
+    @Data
+    @JsonInclude(JsonInclude.Include.NON_NULL)
+    public static class MetaCommonCodeItem {
+        private String groupCode;
+        private String code;
+        private String codeName;
+        private String codeDesc;
+        private Integer sortSeq;
+        private String useYn;
+    }
+}
diff --git a/dap-tool-oth/src/main/java/io/shinhanlife/dap/mcc/biz/cmm/usecase/MetaCommonCodeUseCase.java b/dap-tool-oth/src/main/java/io/shinhanlife/dap/mcc/biz/cmm/usecase/MetaCommonCodeUseCase.java
new file mode 100644
index 00000000..2e2ac524
--- /dev/null
+++ b/dap-tool-oth/src/main/java/io/shinhanlife/dap/mcc/biz/cmm/usecase/MetaCommonCodeUseCase.java
@@ -0,0 +1,37 @@
+package io.shinhanlife.dap.mcc.biz.cmm.usecase;
+
+import io.shinhanlife.dap.lib.annotation.McpFunction;
+import io.shinhanlife.dap.lib.annotation.McpTool;
+import io.shinhanlife.dap.mcc.biz.cmm.dto.MetaCommonCodeRequest;
+
+/**
+ * @package io.shinhanlife.dap.mcc.biz.cmm.usecase
+ * @className MetaCommonCodeUseCase
+ * @description AX HUB 시스템 처리 클래스
+ * @author 0986406
+ * @create 2026.07.29
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.07.29  0986406    최초생성
+ * 
+ * </pre>
+ */
+@McpTool(
+    routingType = "MCI",
+    categoryKey = "cmm"
+)
+public interface MetaCommonCodeUseCase {
+    @McpFunction(
+        displayName = "메타 통합코드 조회 툴",
+        name = "metaCommonCode",
+        description = "메타 통합코드 목록을 조회해줘",
+        prompt = "메타 통합코드 목록을 조회해줘",
+        mappingId = "CLCNNB00001",
+        register = false,
+        requiresApproval = false,
+        openWorldHint = true
+    )
+    Object execute(MetaCommonCodeRequest req);
+}
diff --git a/dap-tool-oth/src/main/java/io/shinhanlife/dap/mcc/biz/cmm/usecase/impl/MetaCommonCodeUseCaseImpl.java b/dap-tool-oth/src/main/java/io/shinhanlife/dap/mcc/biz/cmm/usecase/impl/MetaCommonCodeUseCaseImpl.java
new file mode 100644
index 00000000..4c51e6f6
--- /dev/null
+++ b/dap-tool-oth/src/main/java/io/shinhanlife/dap/mcc/biz/cmm/usecase/impl/MetaCommonCodeUseCaseImpl.java
@@ -0,0 +1,89 @@
+package io.shinhanlife.dap.mcc.biz.cmm.usecase.impl;
+
+import io.shinhanlife.dap.mcc.biz.cmm.converter.MetaCommonCodeConverter;
+import io.shinhanlife.dap.mcc.biz.cmm.dto.MetaCommonCodeRequest;
+import io.shinhanlife.dap.mcc.biz.cmm.dto.MetaCommonCodeResponse;
+import io.shinhanlife.dap.mcc.biz.cmm.dto.MetaCommonCodeResponse.MetaCommonCodeItem;
+import io.shinhanlife.dap.mcc.biz.cmm.usecase.MetaCommonCodeUseCase;
+import io.shinhanlife.dap.mcc.infra.itrf.mci.cfp.a.MciCfpaClient;
+import io.shinhanlife.dap.mcc.infra.itrf.mci.cfp.a.io.CLCNNB00001_I;
+import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.stereotype.Service;
+
+import java.util.ArrayList;
+import java.util.List;
+import java.util.Map;
+
+/**
+ * @package io.shinhanlife.dap.mcc.biz.cmm.usecase.impl
+ * @className MetaCommonCodeUseCaseImpl
+ * @description AX HUB 시스템 처리 클래스
+ * @author 0986406
+ * @create 2026.07.29
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.07.29  0986406    최초생성
+ * 
+ * </pre>
+ */
+@Slf4j
+@Service
+@RequiredArgsConstructor
+public class MetaCommonCodeUseCaseImpl implements MetaCommonCodeUseCase {
+
+    private final MciCfpaClient mci;
+    private final MetaCommonCodeConverter converter;
+
+    @Override
+    public Object execute(MetaCommonCodeRequest req) {
+        log.info("[MCI Tool] {} 요청 수신. 파라미터: {}", "metaCommonCode", req);
+        try {
+            CLCNNB00001_I mciRequest = converter.toLegacyRequest(req);
+
+            Object mciResponse = mci.callCfpa0001(mciRequest);
+            log.info("[MCI Tool] CLCNNB00001 MCI call completed. Returning response status: {}",
+                    mciResponse != null);
+
+            // 현업 테스트용으로 MCI 통신을 바이패스하고 하드코딩된 메타 통합코드 샘플 결과를 반환합니다.
+            MetaCommonCodeResponse res = new MetaCommonCodeResponse();
+            List<MetaCommonCodeItem> list = new ArrayList<>();
+
+            MetaCommonCodeItem item1 = new MetaCommonCodeItem();
+            item1.setGroupCode(req.getGroupCode() != null ? req.getGroupCode() : "GRP_COMM_CD");
+            item1.setCode("CD001");
+            item1.setCodeName("진행중");
+            item1.setCodeDesc("SR 요청 처리 진행 중 상태");
+            item1.setSortSeq(1);
+            item1.setUseYn("Y");
+            list.add(item1);
+
+            MetaCommonCodeItem item2 = new MetaCommonCodeItem();
+            item2.setGroupCode(req.getGroupCode() != null ? req.getGroupCode() : "GRP_COMM_CD");
+            item2.setCode("CD002");
+            item2.setCodeName("완료");
+            item2.setCodeDesc("SR 요청 처리 완료 상태");
+            item2.setSortSeq(2);
+            item2.setUseYn("Y");
+            list.add(item2);
+
+            MetaCommonCodeItem item3 = new MetaCommonCodeItem();
+            item3.setGroupCode(req.getGroupCode() != null ? req.getGroupCode() : "GRP_COMM_CD");
+            item3.setCode("CD003");
+            item3.setCodeName("보류");
+            item3.setCodeDesc("SR 요청 처리 일시 보류 상태");
+            item3.setSortSeq(3);
+            item3.setUseYn("N");
+            list.add(item3);
+
+            res.setCodeList(list);
+
+            return res;
+        } catch (Exception e) {
+            log.error("[MCI Tool] 연동 중 오류 발생: {}", e.getMessage(), e);
+            return Map.of("status", "ERROR", "message", e.getMessage() != null ? e.getMessage() : "Unknown error");
+        }
+    }
+}

From c6a2f8245547439dd40888bc2c919d8b52b5eeab Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=EA=B9=80=EB=8F=84=EA=B2=B8?= <kdkhelloworld@gmail.com>
Date: Wed, 29 Jul 2026 16:08:45 +0900
Subject: [PATCH 2/3] push TEST

---
 README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 8d64e909..4028631a 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,6 @@
 # DAP Backend
 
-Spring Boot 기반 DAP 관리자 백엔드 API 서버 및 MCP(Model Context Protocol) Gateway / Tool 분산 서버 프로젝트입니다.
+Spring Boot 기반 DAP 관리자 백엔드 API 서버 및 MCP(Model Context Protocol) Gateway / Tool 분산 서버 프로젝트 입니다.
 
 ---
 

From b68fbb9726de1119e64a5a9c9c60702d3af34c82 Mon Sep 17 00:00:00 2001
From: juheelee <jessia0308@nate.com>
Date: Wed, 29 Jul 2026 16:48:28 +0900
Subject: [PATCH 3/3] =?UTF-8?q?feat:=20=EB=A9=94=ED=83=80=20=ED=86=B5?=
 =?UTF-8?q?=ED=95=A9=20=EC=BD=94=EB=93=9C=20=EC=A1=B0=ED=9A=8C?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../dap/mcc/biz/cmm/converter/MetaCommonCodeConverter.java    | 4 ++--
 .../dap/mcc/biz/cmm/dto/MetaCommonCodeRequest.java            | 4 ++--
 .../dap/mcc/biz/cmm/dto/MetaCommonCodeResponse.java           | 4 ++--
 .../dap/mcc/biz/cmm/usecase/MetaCommonCodeUseCase.java        | 4 ++--
 .../mcc/biz/cmm/usecase/impl/MetaCommonCodeUseCaseImpl.java   | 4 ++--
 5 files changed, 10 insertions(+), 10 deletions(-)

diff --git a/dap-tool-oth/src/main/java/io/shinhanlife/dap/mcc/biz/cmm/converter/MetaCommonCodeConverter.java b/dap-tool-oth/src/main/java/io/shinhanlife/dap/mcc/biz/cmm/converter/MetaCommonCodeConverter.java
index 47b2bebf..87f56ee9 100644
--- a/dap-tool-oth/src/main/java/io/shinhanlife/dap/mcc/biz/cmm/converter/MetaCommonCodeConverter.java
+++ b/dap-tool-oth/src/main/java/io/shinhanlife/dap/mcc/biz/cmm/converter/MetaCommonCodeConverter.java
@@ -11,13 +11,13 @@ import org.mapstruct.Mapping;
  * @package io.shinhanlife.dap.mcc.biz.cmm.converter
  * @className MetaCommonCodeConverter
  * @description AX HUB 시스템 처리 클래스
- * @author 0986406
+ * @author 09863409
  * @create 2026.07.29
  * <pre>
  * ---------- 개정이력 ----------
  * 수정일      수정자    수정내용
  * ---------- -------- ---------------------------
- * 2026.07.29  0986406    최초생성
+ * 2026.07.29  09863409    최초생성
  * 
  * </pre>
  */
diff --git a/dap-tool-oth/src/main/java/io/shinhanlife/dap/mcc/biz/cmm/dto/MetaCommonCodeRequest.java b/dap-tool-oth/src/main/java/io/shinhanlife/dap/mcc/biz/cmm/dto/MetaCommonCodeRequest.java
index 1cb36e79..a28a3afe 100644
--- a/dap-tool-oth/src/main/java/io/shinhanlife/dap/mcc/biz/cmm/dto/MetaCommonCodeRequest.java
+++ b/dap-tool-oth/src/main/java/io/shinhanlife/dap/mcc/biz/cmm/dto/MetaCommonCodeRequest.java
@@ -8,13 +8,13 @@ import lombok.Data;
  * @package io.shinhanlife.dap.mcc.biz.cmm.dto
  * @className MetaCommonCodeRequest
  * @description AX HUB 시스템 처리 클래스
- * @author 0986406
+ * @author 09863409
  * @create 2026.07.29
  * <pre>
  * ---------- 개정이력 ----------
  * 수정일      수정자    수정내용
  * ---------- -------- ---------------------------
- * 2026.07.29  0986406    최초생성
+ * 2026.07.29  09863409    최초생성
  * 
  * </pre>
  */
diff --git a/dap-tool-oth/src/main/java/io/shinhanlife/dap/mcc/biz/cmm/dto/MetaCommonCodeResponse.java b/dap-tool-oth/src/main/java/io/shinhanlife/dap/mcc/biz/cmm/dto/MetaCommonCodeResponse.java
index 751f2404..653a32a2 100644
--- a/dap-tool-oth/src/main/java/io/shinhanlife/dap/mcc/biz/cmm/dto/MetaCommonCodeResponse.java
+++ b/dap-tool-oth/src/main/java/io/shinhanlife/dap/mcc/biz/cmm/dto/MetaCommonCodeResponse.java
@@ -9,13 +9,13 @@ import java.util.List;
  * @package io.shinhanlife.dap.mcc.biz.cmm.dto
  * @className MetaCommonCodeResponse
  * @description AX HUB 시스템 처리 클래스
- * @author 0986406
+ * @author 09863409
  * @create 2026.07.29
  * <pre>
  * ---------- 개정이력 ----------
  * 수정일      수정자    수정내용
  * ---------- -------- ---------------------------
- * 2026.07.29  0986406    최초생성
+ * 2026.07.29  09863409    최초생성
  * 
  * </pre>
  */
diff --git a/dap-tool-oth/src/main/java/io/shinhanlife/dap/mcc/biz/cmm/usecase/MetaCommonCodeUseCase.java b/dap-tool-oth/src/main/java/io/shinhanlife/dap/mcc/biz/cmm/usecase/MetaCommonCodeUseCase.java
index 2e2ac524..f8c2a52a 100644
--- a/dap-tool-oth/src/main/java/io/shinhanlife/dap/mcc/biz/cmm/usecase/MetaCommonCodeUseCase.java
+++ b/dap-tool-oth/src/main/java/io/shinhanlife/dap/mcc/biz/cmm/usecase/MetaCommonCodeUseCase.java
@@ -8,13 +8,13 @@ import io.shinhanlife.dap.mcc.biz.cmm.dto.MetaCommonCodeRequest;
  * @package io.shinhanlife.dap.mcc.biz.cmm.usecase
  * @className MetaCommonCodeUseCase
  * @description AX HUB 시스템 처리 클래스
- * @author 0986406
+ * @author 09863409
  * @create 2026.07.29
  * <pre>
  * ---------- 개정이력 ----------
  * 수정일      수정자    수정내용
  * ---------- -------- ---------------------------
- * 2026.07.29  0986406    최초생성
+ * 2026.07.29  09863409    최초생성
  * 
  * </pre>
  */
diff --git a/dap-tool-oth/src/main/java/io/shinhanlife/dap/mcc/biz/cmm/usecase/impl/MetaCommonCodeUseCaseImpl.java b/dap-tool-oth/src/main/java/io/shinhanlife/dap/mcc/biz/cmm/usecase/impl/MetaCommonCodeUseCaseImpl.java
index 4c51e6f6..92ddf781 100644
--- a/dap-tool-oth/src/main/java/io/shinhanlife/dap/mcc/biz/cmm/usecase/impl/MetaCommonCodeUseCaseImpl.java
+++ b/dap-tool-oth/src/main/java/io/shinhanlife/dap/mcc/biz/cmm/usecase/impl/MetaCommonCodeUseCaseImpl.java
@@ -19,13 +19,13 @@ import java.util.Map;
  * @package io.shinhanlife.dap.mcc.biz.cmm.usecase.impl
  * @className MetaCommonCodeUseCaseImpl
  * @description AX HUB 시스템 처리 클래스
- * @author 0986406
+ * @author 09863409
  * @create 2026.07.29
  * <pre>
  * ---------- 개정이력 ----------
  * 수정일      수정자    수정내용
  * ---------- -------- ---------------------------
- * 2026.07.29  0986406    최초생성
+ * 2026.07.29  09863409    최초생성
  * 
  * </pre>
  */