From 5e4f88ea414ed5731002cb49a844876a608ba57a Mon Sep 17 00:00:00 2001
From: jade <jade.kimhs@gmail.com>
Date: Thu, 9 Jul 2026 09:11:46 +0900
Subject: [PATCH] docs: Add standard Javadoc comments to all Java source files

---
 AddJavadoc.java                               | 103 ++++++++++++++++++
 .../biz/mcp/adapter/dto/ErrorDetail.java      |  14 +++
 .../biz/mcp/adapter/dto/JsonRpcRequest.java   |  14 +++
 .../biz/mcp/adapter/dto/JsonRpcResponse.java  |  14 +++
 .../axhub/biz/mcp/adapter/dto/Params.java     |  14 +++
 .../biz/mcp/gateway/dto/ToolMetadata.java     |  14 +++
 .../axhub/common/config/CorsConfig.java       |  14 +++
 .../axhub/common/config/MybatisConfig.java    |  16 ++-
 .../common/config/P6SpySqlFormatter.java      |  14 +++
 .../integration/GlowIntegrationCall.java      |  16 ++-
 .../integration/dto/SampleGlowMessage.java    |  16 ++-
 .../axhub/common/mcp/config/CacheConfig.java  |  14 +++
 .../common/mcp/config/JacksonConfig.java      |  14 +++
 .../common/mcp/config/KafkaLocalConfig.java   |  14 +++
 .../common/mcp/config/SwaggerConfig.java      |  16 ++-
 .../axhub/common/mcp/config/WebConfig.java    |  14 +++
 .../mcp/exception/GlobalExceptionHandler.java |  16 ++-
 .../common/mcp/filter/MdcLoggingFilter.java   |  16 ++-
 .../mcp/security/ApiKeyInterceptor.java       |  16 ++-
 .../mcp/security/SecurityProperties.java      |  15 ++-
 .../session/converter/ZtUsacConverter.java    |  14 +++
 .../session/domain/model/ZtUsacModel.java     |  16 ++-
 .../domain/repository/ZtUsacRepository.java   |  14 +++
 .../session/domain/service/ZtUsacService.java |  14 +++
 .../service/impl/ZtUsacServiceImpl.java       |  16 ++-
 .../axhub/common/session/dto/SessionDto.java  |  16 ++-
 .../axhub/common/session/dto/ZtUsacInDto.java |  16 ++-
 .../common/session/dto/ZtUsacOutDto.java      |  16 ++-
 .../presentation/SsoRestController.java       |  16 ++-
 .../session/presentation/io/SsoResponse.java  |  16 ++-
 .../axhub/common/util/SessionUtil.java        |  14 +++
 .../io/shinhanlife/glow/BaseException.java    |  16 ++-
 .../io/shinhanlife/glow/BaseResponse.java     |  16 ++-
 .../io/shinhanlife/glow/BizException.java     |  16 ++-
 .../io/shinhanlife/glow/GlowLogTarget.java    |  16 ++-
 .../java/io/shinhanlife/glow/GlowLogger.java  |  14 +++
 .../java/io/shinhanlife/glow/PageInfo.java    |  16 ++-
 .../io/shinhanlife/glow/ResponseCode.java     |  16 ++-
 .../io/shinhanlife/glow/ResponseUtil.java     |  16 ++-
 .../io/shinhanlife/glow/db/dto/AuditInfo.java |  16 ++-
 .../mcp/gateway/AxHubGatewayApplication.java  |  16 ++-
 .../mcp/gateway/aop/GatewayLoggingAspect.java |  16 ++-
 .../config/GatewayFallbackProperties.java     |  16 ++-
 .../biz/mcp/gateway/config/RedisConfig.java   |  14 +++
 .../controller/KillSwitchController.java      |  16 ++-
 .../gateway/controller/MciMockController.java |  16 ++-
 .../controller/McpRouterController.java       |  16 ++-
 .../biz/mcp/gateway/dto/ToolMetadata.java     |  14 +++
 .../messaging/KafkaProducerService.java       |  15 ++-
 .../registry/RedisRegistryService.java        |  16 ++-
 .../mcp/gateway/service/ExecuteService.java   |  14 +++
 .../gateway/service/KillSwitchService.java    |  16 ++-
 .../biz/mcp/gateway/service/ToolPlanner.java  |  16 ++-
 .../so/atm/converter/AccessMgmtConverter.java |  16 ++-
 .../domain/repository/AccessMgmtMapper.java   |  16 ++-
 .../atm/domain/service/AccessMgmtService.java |  16 ++-
 .../service/impl/AccessMgmtServiceImpl.java   |  16 ++-
 .../axhub/biz/so/atm/dto/AthrItemOutDto.java  |  16 ++-
 .../axhub/biz/so/atm/dto/AthrOutDto.java      |  16 ++-
 .../axhub/biz/so/atm/dto/AthrSaveInDto.java   |  16 ++-
 .../axhub/biz/so/atm/dto/AthrSearchInDto.java |  16 ++-
 .../biz/so/atm/dto/RoleKnwlAthrInDto.java     |  16 ++-
 .../axhub/biz/so/atm/dto/RoleListInDto.java   |  16 ++-
 .../axhub/biz/so/atm/dto/RoleListOutDto.java  |  16 ++-
 .../biz/so/atm/dto/RoleToolAthrInDto.java     |  16 ++-
 .../atm/presentation/SOATM0100Controller.java |  16 ++-
 .../atm/presentation/io/AthrSaveRequest.java  |  16 ++-
 .../presentation/io/AthrSearchRequest.java    |  16 ++-
 .../presentation/io/AthrSearchResponse.java   |  16 ++-
 .../atm/presentation/io/RoleListRequest.java  |  16 ++-
 .../biz/so/atm/usecase/AccessMgmtUseCase.java |  16 ++-
 .../usecase/impl/AccessMgmtUseCaseImpl.java   |  16 ++-
 .../sample/converter/SampleConverter.java     |  16 ++-
 .../domain/model/AppliSystNtfyPatiModel.java  |  16 ++-
 .../repository/GlowSampleRepository.java      |  16 ++-
 .../domain/service/GlowSampleService.java     |  16 ++-
 .../service/impl/GlowSampleServiceImpl.java   |  16 ++-
 .../sample/dto/AppliSystNtfyRgiInDTO.java     |  16 ++-
 .../axhub/sample/dto/StrnTermListInDTO.java   |  16 ++-
 .../axhub/sample/dto/StrnTermListOutDTO.java  |  16 ++-
 .../presentation/GlowSampleController.java    |  14 +++
 .../io/AppliSystNtfyPatiRequest.java          |  16 ++-
 .../io/AppliSystNtfyPatiResponse.java         |  16 ++-
 .../presentation/io/StrnTermRequest.java      |  16 ++-
 .../presentation/io/StrnTermResponse.java     |  14 +++
 .../sample/usecase/GlowSampleUseCase.java     |  16 ++-
 .../usecase/impl/GlowSampleUseCaseImpl.java   |  16 ++-
 .../mcp/adapter/aop/EimsMonitoringAspect.java |  14 +++
 .../connector/ExternalApiConnector.java       |  14 +++
 .../connector/InternalSystemConnector.java    |  14 +++
 .../adapter/connector/LegacyDbConnector.java  |  14 +++
 .../connector/LegacyEimsConnector.java        |  16 ++-
 .../ThirdPartySecurityConnector.java          |  16 ++-
 .../biz/mcp/adapter/sender/EaiEimsSender.java |  16 ++-
 .../biz/mcp/adapter/sender/EimsSender.java    |  16 ++-
 .../mcp/adapter/sender/HttpEimsSender.java    |  16 ++-
 .../mcp/adapter/sender/JspFormEimsSender.java |  16 ++-
 .../mcp/adapter/sender/JspJsonEimsSender.java |  16 ++-
 .../biz/mcp/adapter/sender/MciEimsSender.java |  16 ++-
 .../biz/mcp/adapter/sender/TcpEimsSender.java |  16 ++-
 .../support/DynamicPayloadBuilder.java        |  14 +++
 .../support/DynamicSchemaValidator.java       |  14 +++
 .../adapter/support/ResultStandardizer.java   |  14 +++
 .../mcp/adapter/support/TicketManager.java    |  15 ++-
 .../adapter/support/ToolExecutionService.java |  16 ++-
 .../mcp/adapter/test/MockEimsHttpServer.java  |  14 +++
 .../mcp/adapter/test/MockEimsTcpServer.java   |  14 +++
 .../biz/mcp/adapter/test/MockJspServer.java   |  14 +++
 .../adapter/util/LegacyDataTransformer.java   |  16 ++-
 .../util/PiiMaskingLogbackConverter.java      |  16 ++-
 .../biz/mcp/adapter/util/PiiMaskingUtils.java |  16 ++-
 .../biz/mcp/sample/dto/SampleMciReqDto.java   |  16 ++-
 .../biz/mcp/sample/dto/SampleMciResDto.java   |  16 ++-
 .../sample/service/SampleMciCallService.java  |  16 ++-
 .../mcp/tool/aop/ToolSlaMonitoringAspect.java |  16 ++-
 .../config/GlowCommunicationProperties.java   |  16 ++-
 .../biz/mcp/tool/config/McpProperties.java    |  16 ++-
 .../controller/BusinessToolController.java    |  16 ++-
 .../axhub/biz/mcp/tool/dto/ToolMetadata.java  |  16 ++-
 .../tool/service/AbstractMcpToolService.java  |  16 ++-
 .../service/ToolRegistryHeartbeatSender.java  |  16 ++-
 .../mcp/tool/util/JsonSchemaGenerator.java    |  16 ++-
 .../biz/mcp/tool/util/ToolScaffolder.java     |  16 ++-
 .../axhub/biz/mcp/tool/dto/EmailSendReq.java  |  16 ++-
 .../tool/email/AxHubToolEmailApplication.java |  16 ++-
 .../biz/mcp/tool/email/EmailToolService.java  |  16 ++-
 .../biz/mcp/tool/dto/BillingProcessReq.java   |  16 ++-
 .../biz/mcp/tool/dto/BillingStatusReq.java    |  16 ++-
 .../axhub/biz/mcp/tool/dto/BondCheckReq.java  |  16 ++-
 .../axhub/biz/mcp/tool/dto/BondIssueReq.java  |  16 ++-
 .../biz/mcp/tool/dto/ContractDetailReq.java   |  16 ++-
 .../biz/mcp/tool/dto/ContractStatusReq.java   |  16 ++-
 .../biz/mcp/tool/dto/CustomerDetailReq.java   |  16 ++-
 .../biz/mcp/tool/dto/CustomerGradeReq.java    |  16 ++-
 .../axhub/biz/mcp/tool/dto/LeaveCountReq.java |  16 ++-
 .../biz/mcp/tool/dto/TemplateDownloadReq.java |  16 ++-
 .../biz/mcp/tool/dto/VacationRegisterReq.java |  16 ++-
 .../tool/other/AxHubToolOtherApplication.java |  16 ++-
 .../tool/service/BillingProcessService.java   |  16 ++-
 .../mcp/tool/service/BondIssueService.java    |  16 ++-
 .../tool/service/CommonUtilityService.java    |  16 ++-
 .../tool/service/ContractInquiryService.java  |  16 ++-
 .../mcp/tool/service/CustomerInfoService.java |  16 ++-
 .../tool/service/TemplateUtilityService.java  |  16 ++-
 .../axhub/biz/mcp/tool/dto/SmsSendReq.java    |  16 ++-
 .../mcp/tool/sms/AxHubToolSmsApplication.java |  16 ++-
 .../biz/mcp/tool/sms/SmsToolService.java      |  16 ++-
 147 files changed, 2259 insertions(+), 115 deletions(-)
 create mode 100644 AddJavadoc.java

diff --git a/AddJavadoc.java b/AddJavadoc.java
new file mode 100644
index 0000000..6d174a4
--- /dev/null
+++ b/AddJavadoc.java
@@ -0,0 +1,103 @@
+import java.io.*;
+import java.nio.file.*;
+import java.nio.file.attribute.BasicFileAttributes;
+import java.util.*;
+import java.util.regex.*;
+
+public class AddJavadoc {
+
+    static final String ROOT_DIR = ".";
+    
+    static final String TEMPLATE = 
+        "/**\n" +
+        " * @package %s\n" +
+        " * @className %s\n" +
+        " * @description AX HUB 시스템 처리 클래스\n" +
+        " * @author 김형식\n" +
+        " * @create 2026.09.01\n" +
+        " * <pre>\n" +
+        " * ---------- 개정이력 ----------\n" +
+        " * 수정일      수정자    수정내용\n" +
+        " * ---------- -------- ---------------------------\n" +
+        " * 2026.09.01  김형식    최초생성\n" +
+        " * \n" +
+        " * </pre>\n" +
+        " */";
+
+    public static void main(String[] args) throws Exception {
+        Files.walkFileTree(Paths.get(ROOT_DIR), new SimpleFileVisitor<Path>() {
+            @Override
+            public FileVisitResult preVisitDirectory(Path dir, BasicFileAttributes attrs) {
+                String name = dir.getFileName().toString();
+                if (name.equals(".git") || name.equals("build") || name.equals(".gradle") || name.equals("scratch") || name.equals("out") || name.equals("bin")) {
+                    return FileVisitResult.SKIP_SUBTREE;
+                }
+                return FileVisitResult.CONTINUE;
+            }
+
+            @Override
+            public FileVisitResult visitFile(Path file, BasicFileAttributes attrs) throws IOException {
+                if (file.toString().endsWith(".java") && !file.getFileName().toString().equals("AddJavadoc.java")) {
+                    processJavaFile(file);
+                }
+                return FileVisitResult.CONTINUE;
+            }
+        });
+        System.out.println("Done.");
+    }
+
+    private static void processJavaFile(Path file) throws IOException {
+        List<String> lines = Files.readAllLines(file);
+        String content = String.join("\n", lines);
+        
+        if (content.contains("---------- 개정이력 ----------") || content.contains("@className")) {
+            System.out.println("Skipping (already has javadoc): " + file);
+            return;
+        }
+
+        String packageName = "unknown";
+        String className = "unknown";
+
+        Matcher pkgMatcher = Pattern.compile("(?m)^\\s*package\\s+([\\w\\.]+)\\s*;").matcher(content);
+        if (pkgMatcher.find()) {
+            packageName = pkgMatcher.group(1);
+        }
+
+        int classDeclIdx = -1;
+        for (int i = 0; i < lines.size(); i++) {
+            String line = lines.get(i);
+            Matcher classMatcher = Pattern.compile("^\\s*(?:public\\s+|protected\\s+|private\\s+|abstract\\s+|final\\s+|static\\s+)*(class|interface|enum|record)\\s+(\\w+)").matcher(line);
+            if (classMatcher.find()) {
+                classDeclIdx = i;
+                className = classMatcher.group(2);
+                break;
+            }
+        }
+
+        if (classDeclIdx == -1) {
+            System.out.println("Skipping (no class declaration found): " + file);
+            return;
+        }
+
+        int insertIdx = classDeclIdx;
+        for (int i = classDeclIdx - 1; i >= 0; i--) {
+            String line = lines.get(i).trim();
+            if (line.isEmpty()) {
+                continue;
+            }
+            if (line.startsWith("@")) {
+                insertIdx = i;
+            } else if (line.startsWith("//") || line.startsWith("/*") || line.startsWith("*")) {
+                break;
+            } else {
+                break;
+            }
+        }
+
+        String javadoc = String.format(TEMPLATE, packageName, className);
+        lines.add(insertIdx, javadoc);
+
+        Files.write(file, String.join("\n", lines).getBytes("UTF-8"));
+        System.out.println("Updated: " + file);
+    }
+}
diff --git a/axhub-common/src/main/java/io/shinhanlife/axhub/biz/mcp/adapter/dto/ErrorDetail.java b/axhub-common/src/main/java/io/shinhanlife/axhub/biz/mcp/adapter/dto/ErrorDetail.java
index 665cc83..bc69f9e 100644
--- a/axhub-common/src/main/java/io/shinhanlife/axhub/biz/mcp/adapter/dto/ErrorDetail.java
+++ b/axhub-common/src/main/java/io/shinhanlife/axhub/biz/mcp/adapter/dto/ErrorDetail.java
@@ -7,6 +7,20 @@ import lombok.AllArgsConstructor;
 import lombok.Getter;
 import lombok.Setter;
 
+/**
+ * @package io.shinhanlife.axhub.biz.mcp.adapter.dto
+ * @className ErrorDetail
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @Getter
 @Setter
 @AllArgsConstructor
diff --git a/axhub-common/src/main/java/io/shinhanlife/axhub/biz/mcp/adapter/dto/JsonRpcRequest.java b/axhub-common/src/main/java/io/shinhanlife/axhub/biz/mcp/adapter/dto/JsonRpcRequest.java
index 0e528fc..e34979e 100644
--- a/axhub-common/src/main/java/io/shinhanlife/axhub/biz/mcp/adapter/dto/JsonRpcRequest.java
+++ b/axhub-common/src/main/java/io/shinhanlife/axhub/biz/mcp/adapter/dto/JsonRpcRequest.java
@@ -3,6 +3,20 @@ package io.shinhanlife.axhub.biz.mcp.adapter.dto;
 import lombok.Getter;
 import lombok.Setter;
 
+/**
+ * @package io.shinhanlife.axhub.biz.mcp.adapter.dto
+ * @className JsonRpcRequest
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @Getter
 @Setter
 public class JsonRpcRequest {
diff --git a/axhub-common/src/main/java/io/shinhanlife/axhub/biz/mcp/adapter/dto/JsonRpcResponse.java b/axhub-common/src/main/java/io/shinhanlife/axhub/biz/mcp/adapter/dto/JsonRpcResponse.java
index cf0e188..5c0cd8e 100644
--- a/axhub-common/src/main/java/io/shinhanlife/axhub/biz/mcp/adapter/dto/JsonRpcResponse.java
+++ b/axhub-common/src/main/java/io/shinhanlife/axhub/biz/mcp/adapter/dto/JsonRpcResponse.java
@@ -5,6 +5,20 @@ import lombok.Getter;
 import lombok.Setter;
 
 // 2. 응답 DTO
+/**
+ * @package io.shinhanlife.axhub.biz.mcp.adapter.dto
+ * @className JsonRpcResponse
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @Getter
 @Setter
 @JsonPropertyOrder({"jsonrpc", "result", "error", "id"})
diff --git a/axhub-common/src/main/java/io/shinhanlife/axhub/biz/mcp/adapter/dto/Params.java b/axhub-common/src/main/java/io/shinhanlife/axhub/biz/mcp/adapter/dto/Params.java
index 57131be..9e459af 100644
--- a/axhub-common/src/main/java/io/shinhanlife/axhub/biz/mcp/adapter/dto/Params.java
+++ b/axhub-common/src/main/java/io/shinhanlife/axhub/biz/mcp/adapter/dto/Params.java
@@ -10,6 +10,20 @@ import java.util.Map;
 import lombok.Getter;
 import lombok.Setter;
 
+/**
+ * @package io.shinhanlife.axhub.biz.mcp.adapter.dto
+ * @className Params
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @Getter
 @Setter
 @Builder
diff --git a/axhub-common/src/main/java/io/shinhanlife/axhub/biz/mcp/gateway/dto/ToolMetadata.java b/axhub-common/src/main/java/io/shinhanlife/axhub/biz/mcp/gateway/dto/ToolMetadata.java
index 29eb91c..b6a85f8 100644
--- a/axhub-common/src/main/java/io/shinhanlife/axhub/biz/mcp/gateway/dto/ToolMetadata.java
+++ b/axhub-common/src/main/java/io/shinhanlife/axhub/biz/mcp/gateway/dto/ToolMetadata.java
@@ -14,6 +14,20 @@ import java.util.Map;
  * Tool(Agent)의 명세 및 라우팅 정보를 담고 있는 메타데이터 클래스
  * Redis 레지스트리에 저장되며, Planner와 Router 간의 통신 객체(Plan)로 사용됩니다.
  */
+/**
+ * @package io.shinhanlife.axhub.biz.mcp.gateway.dto
+ * @className ToolMetadata
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @Builder
 @NoArgsConstructor
 @AllArgsConstructor
diff --git a/axhub-common/src/main/java/io/shinhanlife/axhub/common/config/CorsConfig.java b/axhub-common/src/main/java/io/shinhanlife/axhub/common/config/CorsConfig.java
index 306b7fe..a4fcfe4 100644
--- a/axhub-common/src/main/java/io/shinhanlife/axhub/common/config/CorsConfig.java
+++ b/axhub-common/src/main/java/io/shinhanlife/axhub/common/config/CorsConfig.java
@@ -4,6 +4,20 @@ import org.springframework.context.annotation.Configuration;
 import org.springframework.web.servlet.config.annotation.CorsRegistry;
 import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;
 
+/**
+ * @package io.shinhanlife.axhub.common.config
+ * @className CorsConfig
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @Configuration
 public class CorsConfig implements WebMvcConfigurer {
 
diff --git a/axhub-common/src/main/java/io/shinhanlife/axhub/common/config/MybatisConfig.java b/axhub-common/src/main/java/io/shinhanlife/axhub/common/config/MybatisConfig.java
index b04456f..14d2cc1 100644
--- a/axhub-common/src/main/java/io/shinhanlife/axhub/common/config/MybatisConfig.java
+++ b/axhub-common/src/main/java/io/shinhanlife/axhub/common/config/MybatisConfig.java
@@ -7,6 +7,20 @@ import org.mybatis.spring.SqlSessionFactoryBean;
 import org.springframework.context.annotation.Bean;
 import org.springframework.context.annotation.Configuration;
 
+/**
+ * @package io.shinhanlife.axhub.common.config
+ * @className MybatisConfig
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @Configuration
 public class MybatisConfig {
 
@@ -16,4 +30,4 @@ public class MybatisConfig {
         sessionFactory.setDataSource(dataSource);
         return sessionFactory.getObject();
     }
-}
+}
\ No newline at end of file
diff --git a/axhub-common/src/main/java/io/shinhanlife/axhub/common/config/P6SpySqlFormatter.java b/axhub-common/src/main/java/io/shinhanlife/axhub/common/config/P6SpySqlFormatter.java
index 0a4ed21..515d29a 100644
--- a/axhub-common/src/main/java/io/shinhanlife/axhub/common/config/P6SpySqlFormatter.java
+++ b/axhub-common/src/main/java/io/shinhanlife/axhub/common/config/P6SpySqlFormatter.java
@@ -3,6 +3,20 @@ package io.shinhanlife.axhub.common.config;
 import com.p6spy.engine.logging.Category;
 import com.p6spy.engine.spy.appender.MessageFormattingStrategy;
 
+/**
+ * @package io.shinhanlife.axhub.common.config
+ * @className P6SpySqlFormatter
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 public class P6SpySqlFormatter implements MessageFormattingStrategy {
 
     @Override
diff --git a/axhub-common/src/main/java/io/shinhanlife/axhub/common/integration/GlowIntegrationCall.java b/axhub-common/src/main/java/io/shinhanlife/axhub/common/integration/GlowIntegrationCall.java
index 854033f..e92a2ca 100644
--- a/axhub-common/src/main/java/io/shinhanlife/axhub/common/integration/GlowIntegrationCall.java
+++ b/axhub-common/src/main/java/io/shinhanlife/axhub/common/integration/GlowIntegrationCall.java
@@ -16,6 +16,20 @@ import org.springframework.stereotype.Component;
  * 신한라이프 Glow Framework 개발표준정의서를 바탕으로 대내/대외망/EAI 통신을 
  * MCP 툴에서 손쉽게 호출할 수 있도록 일원화한 컴포넌트입니다.
  */
+/**
+ * @package io.shinhanlife.axhub.common.integration
+ * @className GlowIntegrationCall
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @Component
 @RequiredArgsConstructor
 public class GlowIntegrationCall {
@@ -88,4 +102,4 @@ public class GlowIntegrationCall {
         return mci.call(req, resBody);
     }
     */
-}
+}
\ No newline at end of file
diff --git a/axhub-common/src/main/java/io/shinhanlife/axhub/common/integration/dto/SampleGlowMessage.java b/axhub-common/src/main/java/io/shinhanlife/axhub/common/integration/dto/SampleGlowMessage.java
index 272c180..5e6bf20 100644
--- a/axhub-common/src/main/java/io/shinhanlife/axhub/common/integration/dto/SampleGlowMessage.java
+++ b/axhub-common/src/main/java/io/shinhanlife/axhub/common/integration/dto/SampleGlowMessage.java
@@ -15,6 +15,20 @@ import java.util.List;
  * Glow Framework 개발표준정의서(2.2.1 IO 작성) 규칙을 100% 준수한 샘플입니다.
  * 새로운 대외 통신 전문을 만들 때 이 파일을 복사해서 필드명과 길이만 수정하여 사용하세요.
  */
+/**
+ * @package io.shinhanlife.axhub.common.integration.dto
+ * @className SampleGlowMessage
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @Getter
 @Builder
 @AllArgsConstructor
@@ -67,4 +81,4 @@ public class SampleGlowMessage {
         // @GlowMciFieldInfo(order = 4, length = 200)
         private String anxMsgCt;
     }
-}
+}
\ No newline at end of file
diff --git a/axhub-common/src/main/java/io/shinhanlife/axhub/common/mcp/config/CacheConfig.java b/axhub-common/src/main/java/io/shinhanlife/axhub/common/mcp/config/CacheConfig.java
index 37af12b..cb0f3b1 100644
--- a/axhub-common/src/main/java/io/shinhanlife/axhub/common/mcp/config/CacheConfig.java
+++ b/axhub-common/src/main/java/io/shinhanlife/axhub/common/mcp/config/CacheConfig.java
@@ -6,6 +6,20 @@ import org.springframework.cache.concurrent.ConcurrentMapCacheManager;
 import org.springframework.context.annotation.Bean;
 import org.springframework.context.annotation.Configuration;
 
+/**
+ * @package io.shinhanlife.axhub.common.mcp.config
+ * @className CacheConfig
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @Configuration
 @EnableCaching
 public class CacheConfig {
diff --git a/axhub-common/src/main/java/io/shinhanlife/axhub/common/mcp/config/JacksonConfig.java b/axhub-common/src/main/java/io/shinhanlife/axhub/common/mcp/config/JacksonConfig.java
index a4405cc..93b542d 100644
--- a/axhub-common/src/main/java/io/shinhanlife/axhub/common/mcp/config/JacksonConfig.java
+++ b/axhub-common/src/main/java/io/shinhanlife/axhub/common/mcp/config/JacksonConfig.java
@@ -7,6 +7,20 @@ import org.springframework.context.annotation.Bean;
 import org.springframework.context.annotation.Configuration;
 import org.springframework.context.annotation.Primary;
 
+/**
+ * @package io.shinhanlife.axhub.common.mcp.config
+ * @className JacksonConfig
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @Configuration
 public class JacksonConfig {
 
diff --git a/axhub-common/src/main/java/io/shinhanlife/axhub/common/mcp/config/KafkaLocalConfig.java b/axhub-common/src/main/java/io/shinhanlife/axhub/common/mcp/config/KafkaLocalConfig.java
index 23e2c6b..bd62c4b 100644
--- a/axhub-common/src/main/java/io/shinhanlife/axhub/common/mcp/config/KafkaLocalConfig.java
+++ b/axhub-common/src/main/java/io/shinhanlife/axhub/common/mcp/config/KafkaLocalConfig.java
@@ -12,6 +12,20 @@ import org.springframework.beans.factory.annotation.Value;
 import java.util.HashMap;
 import java.util.Map;
 
+/**
+ * @package io.shinhanlife.axhub.common.mcp.config
+ * @className KafkaLocalConfig
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @Configuration
 public class KafkaLocalConfig {
 
diff --git a/axhub-common/src/main/java/io/shinhanlife/axhub/common/mcp/config/SwaggerConfig.java b/axhub-common/src/main/java/io/shinhanlife/axhub/common/mcp/config/SwaggerConfig.java
index e6cf221..b746ac8 100644
--- a/axhub-common/src/main/java/io/shinhanlife/axhub/common/mcp/config/SwaggerConfig.java
+++ b/axhub-common/src/main/java/io/shinhanlife/axhub/common/mcp/config/SwaggerConfig.java
@@ -8,6 +8,20 @@ import io.swagger.v3.oas.models.security.SecurityScheme;
 import org.springframework.context.annotation.Bean;
 import org.springframework.context.annotation.Configuration;
 
+/**
+ * @package io.shinhanlife.axhub.common.mcp.config
+ * @className SwaggerConfig
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @Configuration
 public class SwaggerConfig {
 
@@ -30,4 +44,4 @@ public class SwaggerConfig {
                                         .in(SecurityScheme.In.HEADER)
                                         .description("헤더에 API Key를 입력해주세요. (기본값: SHINHAN_MCP_SECRET_KEY_2026)")));
     }
-}
+}
\ No newline at end of file
diff --git a/axhub-common/src/main/java/io/shinhanlife/axhub/common/mcp/config/WebConfig.java b/axhub-common/src/main/java/io/shinhanlife/axhub/common/mcp/config/WebConfig.java
index b2229d6..07545b4 100644
--- a/axhub-common/src/main/java/io/shinhanlife/axhub/common/mcp/config/WebConfig.java
+++ b/axhub-common/src/main/java/io/shinhanlife/axhub/common/mcp/config/WebConfig.java
@@ -8,6 +8,20 @@ import org.springframework.web.servlet.config.annotation.CorsRegistry;
 
 import io.shinhanlife.axhub.common.mcp.security.ApiKeyInterceptor;
 
+/**
+ * @package io.shinhanlife.axhub.common.mcp.config
+ * @className WebConfig
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @Configuration
 @RequiredArgsConstructor
 public class WebConfig implements WebMvcConfigurer {
diff --git a/axhub-common/src/main/java/io/shinhanlife/axhub/common/mcp/exception/GlobalExceptionHandler.java b/axhub-common/src/main/java/io/shinhanlife/axhub/common/mcp/exception/GlobalExceptionHandler.java
index 9075541..0772c0c 100644
--- a/axhub-common/src/main/java/io/shinhanlife/axhub/common/mcp/exception/GlobalExceptionHandler.java
+++ b/axhub-common/src/main/java/io/shinhanlife/axhub/common/mcp/exception/GlobalExceptionHandler.java
@@ -7,6 +7,20 @@ import org.springframework.http.ResponseEntity;
 import org.springframework.web.bind.annotation.ExceptionHandler;
 import org.springframework.web.bind.annotation.RestControllerAdvice;
 
+/**
+ * @package io.shinhanlife.axhub.common.mcp.exception
+ * @className GlobalExceptionHandler
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @Slf4j
 @RestControllerAdvice //  이 어노테이션이 전역 적용의 핵심입니다!
 public class GlobalExceptionHandler {
@@ -41,4 +55,4 @@ public class GlobalExceptionHandler {
 
         return ResponseEntity.ok(response);
     }
-}
+}
\ No newline at end of file
diff --git a/axhub-common/src/main/java/io/shinhanlife/axhub/common/mcp/filter/MdcLoggingFilter.java b/axhub-common/src/main/java/io/shinhanlife/axhub/common/mcp/filter/MdcLoggingFilter.java
index 5ff17e8..b421fca 100644
--- a/axhub-common/src/main/java/io/shinhanlife/axhub/common/mcp/filter/MdcLoggingFilter.java
+++ b/axhub-common/src/main/java/io/shinhanlife/axhub/common/mcp/filter/MdcLoggingFilter.java
@@ -11,6 +11,20 @@ import org.springframework.web.filter.OncePerRequestFilter;
 import java.io.IOException;
 import java.util.UUID;
 
+/**
+ * @package io.shinhanlife.axhub.common.mcp.filter
+ * @className MdcLoggingFilter
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @Component
 public class MdcLoggingFilter extends OncePerRequestFilter {
 
@@ -39,4 +53,4 @@ public class MdcLoggingFilter extends OncePerRequestFilter {
             MDC.clear();
         }
     }
-}
+}
\ No newline at end of file
diff --git a/axhub-common/src/main/java/io/shinhanlife/axhub/common/mcp/security/ApiKeyInterceptor.java b/axhub-common/src/main/java/io/shinhanlife/axhub/common/mcp/security/ApiKeyInterceptor.java
index 7899b5d..f52cb00 100644
--- a/axhub-common/src/main/java/io/shinhanlife/axhub/common/mcp/security/ApiKeyInterceptor.java
+++ b/axhub-common/src/main/java/io/shinhanlife/axhub/common/mcp/security/ApiKeyInterceptor.java
@@ -10,6 +10,20 @@ import org.springframework.web.servlet.HandlerInterceptor;
 
 import java.util.Map;
 
+/**
+ * @package io.shinhanlife.axhub.common.mcp.security
+ * @className ApiKeyInterceptor
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @Slf4j
 @Component
 @RequiredArgsConstructor
@@ -55,4 +69,4 @@ public class ApiKeyInterceptor implements HandlerInterceptor {
         // 6. 메모리 누수를 방지하기 위해 요청 처리가 완전히 끝나면 MDC에서 테넌트 정보를 지워줍니다.
         MDC.remove("tenantId");
     }
-}
+}
\ No newline at end of file
diff --git a/axhub-common/src/main/java/io/shinhanlife/axhub/common/mcp/security/SecurityProperties.java b/axhub-common/src/main/java/io/shinhanlife/axhub/common/mcp/security/SecurityProperties.java
index 27fe1b1..2c0962a 100644
--- a/axhub-common/src/main/java/io/shinhanlife/axhub/common/mcp/security/SecurityProperties.java
+++ b/axhub-common/src/main/java/io/shinhanlife/axhub/common/mcp/security/SecurityProperties.java
@@ -13,6 +13,20 @@ import java.util.Map;
  * application-local.properties 파일에 정의된 mcp.security.api-keys.* 설정들을
  * Map 자료구조로 자동 바인딩(주입) 받기 위한 설정 클래스입니다.
  */
+/**
+ * @package io.shinhanlife.axhub.common.mcp.security
+ * @className SecurityProperties
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @Data
 @Component
 @ConfigurationProperties(prefix = "mcp.security")
@@ -24,4 +38,3 @@ public class SecurityProperties {
     // 만약 "ALL" 이 포함되어 있다면 모든 도메인에 접근 허용
     private Map<String, List<String>> tenantDomains = new HashMap<>();
 }
-
diff --git a/axhub-common/src/main/java/io/shinhanlife/axhub/common/session/converter/ZtUsacConverter.java b/axhub-common/src/main/java/io/shinhanlife/axhub/common/session/converter/ZtUsacConverter.java
index 6896d30..7b0e1eb 100644
--- a/axhub-common/src/main/java/io/shinhanlife/axhub/common/session/converter/ZtUsacConverter.java
+++ b/axhub-common/src/main/java/io/shinhanlife/axhub/common/session/converter/ZtUsacConverter.java
@@ -5,6 +5,20 @@ import io.shinhanlife.axhub.common.session.dto.ZtUsacOutDto;
 import org.mapstruct.Mapper;
 import org.mapstruct.Mapping;
 
+/**
+ * @package io.shinhanlife.axhub.common.session.converter
+ * @className ZtUsacConverter
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @Mapper(componentModel = "spring")
 public abstract class ZtUsacConverter {
 
diff --git a/axhub-common/src/main/java/io/shinhanlife/axhub/common/session/domain/model/ZtUsacModel.java b/axhub-common/src/main/java/io/shinhanlife/axhub/common/session/domain/model/ZtUsacModel.java
index edd3528..15ec97e 100644
--- a/axhub-common/src/main/java/io/shinhanlife/axhub/common/session/domain/model/ZtUsacModel.java
+++ b/axhub-common/src/main/java/io/shinhanlife/axhub/common/session/domain/model/ZtUsacModel.java
@@ -7,6 +7,20 @@ import lombok.Builder;
 import lombok.Getter;
 import lombok.NoArgsConstructor;
 
+/**
+ * @package io.shinhanlife.axhub.common.session.domain.model
+ * @className ZtUsacModel
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @Getter
 @Builder
 @NoArgsConstructor(access = AccessLevel.PROTECTED)
@@ -34,4 +48,4 @@ public class ZtUsacModel extends AuditInfo {
     /* 인사직책명 */
     private String prafDutyNm;
 
-}
+}
\ No newline at end of file
diff --git a/axhub-common/src/main/java/io/shinhanlife/axhub/common/session/domain/repository/ZtUsacRepository.java b/axhub-common/src/main/java/io/shinhanlife/axhub/common/session/domain/repository/ZtUsacRepository.java
index 3414e55..be7b68b 100644
--- a/axhub-common/src/main/java/io/shinhanlife/axhub/common/session/domain/repository/ZtUsacRepository.java
+++ b/axhub-common/src/main/java/io/shinhanlife/axhub/common/session/domain/repository/ZtUsacRepository.java
@@ -5,6 +5,20 @@ import io.shinhanlife.axhub.common.session.dto.ZtUsacInDto;
 import io.shinhanlife.axhub.common.session.dto.ZtUsacOutDto;
 
 
+/**
+ * @package io.shinhanlife.axhub.common.session.domain.repository
+ * @className ZtUsacRepository
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @GlowMybatisMapper
 public interface ZtUsacRepository {
 
diff --git a/axhub-common/src/main/java/io/shinhanlife/axhub/common/session/domain/service/ZtUsacService.java b/axhub-common/src/main/java/io/shinhanlife/axhub/common/session/domain/service/ZtUsacService.java
index a0253a0..fc69141 100644
--- a/axhub-common/src/main/java/io/shinhanlife/axhub/common/session/domain/service/ZtUsacService.java
+++ b/axhub-common/src/main/java/io/shinhanlife/axhub/common/session/domain/service/ZtUsacService.java
@@ -3,6 +3,20 @@ package io.shinhanlife.axhub.common.session.domain.service;
 import io.shinhanlife.axhub.common.session.dto.ZtUsacInDto;
 import io.shinhanlife.axhub.common.session.dto.ZtUsacOutDto;
 
+/**
+ * @package io.shinhanlife.axhub.common.session.domain.service
+ * @className ZtUsacService
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 public interface ZtUsacService {
 
     /**
diff --git a/axhub-common/src/main/java/io/shinhanlife/axhub/common/session/domain/service/impl/ZtUsacServiceImpl.java b/axhub-common/src/main/java/io/shinhanlife/axhub/common/session/domain/service/impl/ZtUsacServiceImpl.java
index 9bc3b0f..9b53f3d 100644
--- a/axhub-common/src/main/java/io/shinhanlife/axhub/common/session/domain/service/impl/ZtUsacServiceImpl.java
+++ b/axhub-common/src/main/java/io/shinhanlife/axhub/common/session/domain/service/impl/ZtUsacServiceImpl.java
@@ -7,6 +7,20 @@ import io.shinhanlife.axhub.common.session.dto.ZtUsacOutDto;
 import lombok.RequiredArgsConstructor;
 import org.springframework.stereotype.Service;
 
+/**
+ * @package io.shinhanlife.axhub.common.session.domain.service.impl
+ * @className ZtUsacServiceImpl
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @Service
 @RequiredArgsConstructor
 public class ZtUsacServiceImpl implements ZtUsacService {
@@ -25,4 +39,4 @@ public class ZtUsacServiceImpl implements ZtUsacService {
         result.initLists();
         return result;
     }
-}
+}
\ No newline at end of file
diff --git a/axhub-common/src/main/java/io/shinhanlife/axhub/common/session/dto/SessionDto.java b/axhub-common/src/main/java/io/shinhanlife/axhub/common/session/dto/SessionDto.java
index dc69a34..6b7adfb 100644
--- a/axhub-common/src/main/java/io/shinhanlife/axhub/common/session/dto/SessionDto.java
+++ b/axhub-common/src/main/java/io/shinhanlife/axhub/common/session/dto/SessionDto.java
@@ -10,6 +10,20 @@ import lombok.Builder;
 import lombok.Getter;
 import lombok.Setter;
 
+/**
+ * @package io.shinhanlife.axhub.common.session.dto
+ * @className SessionDto
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @Getter
 @Setter
 @Builder
@@ -62,4 +76,4 @@ public class SessionDto {
 
 
 
-}
+}
\ No newline at end of file
diff --git a/axhub-common/src/main/java/io/shinhanlife/axhub/common/session/dto/ZtUsacInDto.java b/axhub-common/src/main/java/io/shinhanlife/axhub/common/session/dto/ZtUsacInDto.java
index cdc67d9..8f5d3eb 100644
--- a/axhub-common/src/main/java/io/shinhanlife/axhub/common/session/dto/ZtUsacInDto.java
+++ b/axhub-common/src/main/java/io/shinhanlife/axhub/common/session/dto/ZtUsacInDto.java
@@ -7,6 +7,20 @@ import lombok.Builder;
 import lombok.Getter;
 import lombok.Setter;
 
+/**
+ * @package io.shinhanlife.axhub.common.session.dto
+ * @className ZtUsacInDto
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @Getter
 @Setter
 @Builder
@@ -20,4 +34,4 @@ public class ZtUsacInDto {
     @Builder.Default
     private String puseYn = "Y";
 
-}
+}
\ No newline at end of file
diff --git a/axhub-common/src/main/java/io/shinhanlife/axhub/common/session/dto/ZtUsacOutDto.java b/axhub-common/src/main/java/io/shinhanlife/axhub/common/session/dto/ZtUsacOutDto.java
index 9618643..8da1db0 100644
--- a/axhub-common/src/main/java/io/shinhanlife/axhub/common/session/dto/ZtUsacOutDto.java
+++ b/axhub-common/src/main/java/io/shinhanlife/axhub/common/session/dto/ZtUsacOutDto.java
@@ -11,6 +11,20 @@ import lombok.Builder;
 import lombok.Getter;
 import lombok.NoArgsConstructor;
 
+/**
+ * @package io.shinhanlife.axhub.common.session.dto
+ * @className ZtUsacOutDto
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @Getter
 @Builder
 @NoArgsConstructor(access = AccessLevel.PROTECTED)
@@ -68,4 +82,4 @@ public class ZtUsacOutDto {
         return Arrays.asList(str.split(","));
     }
 
-}
+}
\ No newline at end of file
diff --git a/axhub-common/src/main/java/io/shinhanlife/axhub/common/session/presentation/SsoRestController.java b/axhub-common/src/main/java/io/shinhanlife/axhub/common/session/presentation/SsoRestController.java
index df80a18..5aa1cfe 100644
--- a/axhub-common/src/main/java/io/shinhanlife/axhub/common/session/presentation/SsoRestController.java
+++ b/axhub-common/src/main/java/io/shinhanlife/axhub/common/session/presentation/SsoRestController.java
@@ -25,6 +25,20 @@ import org.springframework.web.bind.annotation.RestController;
 
 import java.util.Objects;
 
+/**
+ * @package io.shinhanlife.axhub.common.session.presentation
+ * @className SsoRestController
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @RestController
 @RequiredArgsConstructor
 @Slf4j
@@ -74,4 +88,4 @@ public class SsoRestController {
 
     }
 
-}
+}
\ No newline at end of file
diff --git a/axhub-common/src/main/java/io/shinhanlife/axhub/common/session/presentation/io/SsoResponse.java b/axhub-common/src/main/java/io/shinhanlife/axhub/common/session/presentation/io/SsoResponse.java
index 5de945e..89a4a3a 100644
--- a/axhub-common/src/main/java/io/shinhanlife/axhub/common/session/presentation/io/SsoResponse.java
+++ b/axhub-common/src/main/java/io/shinhanlife/axhub/common/session/presentation/io/SsoResponse.java
@@ -7,6 +7,20 @@ import lombok.Getter;
 import lombok.NoArgsConstructor;
 import lombok.Setter;
 
+/**
+ * @package io.shinhanlife.axhub.common.session.presentation.io
+ * @className SsoResponse
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @Getter
 @Setter
 @Builder
@@ -18,4 +32,4 @@ public class SsoResponse {
     private SessionDto userInfo;
     private String redirectUrl;
 
-}
+}
\ No newline at end of file
diff --git a/axhub-common/src/main/java/io/shinhanlife/axhub/common/util/SessionUtil.java b/axhub-common/src/main/java/io/shinhanlife/axhub/common/util/SessionUtil.java
index 6fc81eb..1d38cf2 100644
--- a/axhub-common/src/main/java/io/shinhanlife/axhub/common/util/SessionUtil.java
+++ b/axhub-common/src/main/java/io/shinhanlife/axhub/common/util/SessionUtil.java
@@ -5,6 +5,20 @@ import jakarta.servlet.http.HttpSession;
 import org.springframework.web.context.request.RequestContextHolder;
 import org.springframework.web.context.request.ServletRequestAttributes;
 
+/**
+ * @package io.shinhanlife.axhub.common.util
+ * @className SessionUtil
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 public class SessionUtil {
 
     private static final String SESSION_KEY = "userInfo";
diff --git a/axhub-common/src/main/java/io/shinhanlife/glow/BaseException.java b/axhub-common/src/main/java/io/shinhanlife/glow/BaseException.java
index ae63fd9..379eb61 100644
--- a/axhub-common/src/main/java/io/shinhanlife/glow/BaseException.java
+++ b/axhub-common/src/main/java/io/shinhanlife/glow/BaseException.java
@@ -10,6 +10,20 @@ import lombok.NoArgsConstructor;
 @NoArgsConstructor
 @AllArgsConstructor
 //@Schema(description = "응답 에러 객체. 성공 케이스일 경우 null. 실제 에러가 발생할 경우에만 예외명, 예외 메시지 필드 세팅 예정.")
+/**
+ * @package io.shinhanlife.glow
+ * @className BaseException
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 public class BaseException {
 
 //    @Schema(description = "Error 코드 Meta 참조 운영. (예) 20001, 50001 등", shinhanlife = "20001")
@@ -26,4 +40,4 @@ public class BaseException {
     @Builder.Default
     String exceptionDetail = "";
 
-}
+}
\ No newline at end of file
diff --git a/axhub-common/src/main/java/io/shinhanlife/glow/BaseResponse.java b/axhub-common/src/main/java/io/shinhanlife/glow/BaseResponse.java
index e0d88e1..797faaf 100644
--- a/axhub-common/src/main/java/io/shinhanlife/glow/BaseResponse.java
+++ b/axhub-common/src/main/java/io/shinhanlife/glow/BaseResponse.java
@@ -5,6 +5,20 @@ import lombok.Builder;
 import lombok.Getter;
 import lombok.ToString;
 
+/**
+ * @package io.shinhanlife.glow
+ * @className BaseResponse
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @ToString
 @Getter
 @Builder
@@ -22,4 +36,4 @@ public class BaseResponse<T> {
 
     private BaseException error;
 
-}
+}
\ No newline at end of file
diff --git a/axhub-common/src/main/java/io/shinhanlife/glow/BizException.java b/axhub-common/src/main/java/io/shinhanlife/glow/BizException.java
index 1a27f56..f1cc14a 100644
--- a/axhub-common/src/main/java/io/shinhanlife/glow/BizException.java
+++ b/axhub-common/src/main/java/io/shinhanlife/glow/BizException.java
@@ -1,6 +1,20 @@
 package io.shinhanlife.glow;
 
+/**
+ * @package io.shinhanlife.glow
+ * @className BizException
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 public class BizException extends RuntimeException {
     public BizException(String s) {
     }
-}
+}
\ No newline at end of file
diff --git a/axhub-common/src/main/java/io/shinhanlife/glow/GlowLogTarget.java b/axhub-common/src/main/java/io/shinhanlife/glow/GlowLogTarget.java
index c16937e..1fa37ce 100644
--- a/axhub-common/src/main/java/io/shinhanlife/glow/GlowLogTarget.java
+++ b/axhub-common/src/main/java/io/shinhanlife/glow/GlowLogTarget.java
@@ -9,7 +9,21 @@ public @interface GlowLogTarget {
 
     Target[] value() default {};
 
+/**
+ * @package io.shinhanlife.glow
+ * @className Target
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
     enum Target {
         FILE, CONSOLE
     }
-}
+}
\ No newline at end of file
diff --git a/axhub-common/src/main/java/io/shinhanlife/glow/GlowLogger.java b/axhub-common/src/main/java/io/shinhanlife/glow/GlowLogger.java
index 3da0e49..f25b010 100644
--- a/axhub-common/src/main/java/io/shinhanlife/glow/GlowLogger.java
+++ b/axhub-common/src/main/java/io/shinhanlife/glow/GlowLogger.java
@@ -5,6 +5,20 @@ import org.slf4j.LoggerFactory;
 import org.springframework.context.annotation.Scope;
 import org.springframework.stereotype.Component;
 
+/**
+ * @package io.shinhanlife.glow
+ * @className GlowLogger
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @Component
 @Scope("prototype")
 public class GlowLogger {
diff --git a/axhub-common/src/main/java/io/shinhanlife/glow/PageInfo.java b/axhub-common/src/main/java/io/shinhanlife/glow/PageInfo.java
index 21da179..034055e 100644
--- a/axhub-common/src/main/java/io/shinhanlife/glow/PageInfo.java
+++ b/axhub-common/src/main/java/io/shinhanlife/glow/PageInfo.java
@@ -10,6 +10,20 @@ import org.apache.ibatis.session.RowBounds;
 import java.io.Serial;
 import java.io.Serializable;
 
+/**
+ * @package io.shinhanlife.glow
+ * @className PageInfo
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @Getter
 @Setter
 @JsonIgnoreProperties(ignoreUnknown = true)
@@ -65,4 +79,4 @@ public class PageInfo extends RowBounds implements Serializable {
         return super.getLimit();
     }
 
-}
+}
\ No newline at end of file
diff --git a/axhub-common/src/main/java/io/shinhanlife/glow/ResponseCode.java b/axhub-common/src/main/java/io/shinhanlife/glow/ResponseCode.java
index 63ffb69..996ffe0 100644
--- a/axhub-common/src/main/java/io/shinhanlife/glow/ResponseCode.java
+++ b/axhub-common/src/main/java/io/shinhanlife/glow/ResponseCode.java
@@ -4,6 +4,20 @@ import lombok.Getter;
 import lombok.RequiredArgsConstructor;
 import org.springframework.http.HttpStatus;
 
+/**
+ * @package io.shinhanlife.glow
+ * @className ResponseCode
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @Getter
 @RequiredArgsConstructor
 public enum ResponseCode {
@@ -28,4 +42,4 @@ public enum ResponseCode {
     private final HttpStatus status;
     private final String message;
 
-}
+}
\ No newline at end of file
diff --git a/axhub-common/src/main/java/io/shinhanlife/glow/ResponseUtil.java b/axhub-common/src/main/java/io/shinhanlife/glow/ResponseUtil.java
index 9ebe6b9..40ffd41 100644
--- a/axhub-common/src/main/java/io/shinhanlife/glow/ResponseUtil.java
+++ b/axhub-common/src/main/java/io/shinhanlife/glow/ResponseUtil.java
@@ -3,6 +3,20 @@ package io.shinhanlife.glow;
 import org.springframework.http.HttpStatus;
 import org.springframework.http.ResponseEntity;
 
+/**
+ * @package io.shinhanlife.glow
+ * @className ResponseUtil
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 public final class ResponseUtil {
 
     private ResponseUtil() {
@@ -108,4 +122,4 @@ public final class ResponseUtil {
         );
     }
 
-}
+}
\ No newline at end of file
diff --git a/axhub-common/src/main/java/io/shinhanlife/glow/db/dto/AuditInfo.java b/axhub-common/src/main/java/io/shinhanlife/glow/db/dto/AuditInfo.java
index 9f58ae2..234e4da 100644
--- a/axhub-common/src/main/java/io/shinhanlife/glow/db/dto/AuditInfo.java
+++ b/axhub-common/src/main/java/io/shinhanlife/glow/db/dto/AuditInfo.java
@@ -8,6 +8,20 @@ import lombok.AllArgsConstructor;
 
 import java.util.Date;
 
+/**
+ * @package io.shinhanlife.glow.db.dto
+ * @className AuditInfo
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @Getter
 @Setter
 @NoArgsConstructor
@@ -23,4 +37,4 @@ public class AuditInfo {
     private String systChgOgnzNo;   // 시스템변경조직번호
     private String systChgSystCd;   // 시스템변경시스템코드
     private String systChgPrgrId;   // 시스템변경프로그램ID
-}
+}
\ No newline at end of file
diff --git a/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/mcp/gateway/AxHubGatewayApplication.java b/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/mcp/gateway/AxHubGatewayApplication.java
index 6f895b8..15d5b4d 100644
--- a/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/mcp/gateway/AxHubGatewayApplication.java
+++ b/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/mcp/gateway/AxHubGatewayApplication.java
@@ -4,6 +4,20 @@ import org.springframework.boot.SpringApplication;
 import org.springframework.boot.autoconfigure.SpringBootApplication;
 import org.springframework.cache.annotation.EnableCaching;
 
+/**
+ * @package io.shinhanlife.axhub.biz.mcp.gateway
+ * @className AxHubGatewayApplication
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @SpringBootApplication(scanBasePackages = {"io.shinhanlife.axhub.biz.mcp.gateway", "io.shinhanlife.axhub.common.mcp", "io.shinhanlife.axhub.common.config"})
 @org.springframework.boot.context.properties.ConfigurationPropertiesScan(basePackages = {"io.shinhanlife.axhub.biz.mcp.gateway", "io.shinhanlife.axhub.common.mcp", "io.shinhanlife.axhub.common.config"})
 @EnableCaching
@@ -11,4 +25,4 @@ public class AxHubGatewayApplication {
     public static void main(String[] args) {
         SpringApplication.run(AxHubGatewayApplication.class, args);
     }
-}
+}
\ No newline at end of file
diff --git a/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/mcp/gateway/aop/GatewayLoggingAspect.java b/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/mcp/gateway/aop/GatewayLoggingAspect.java
index a0c3224..a385b0c 100644
--- a/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/mcp/gateway/aop/GatewayLoggingAspect.java
+++ b/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/mcp/gateway/aop/GatewayLoggingAspect.java
@@ -7,6 +7,20 @@ import org.aspectj.lang.annotation.Aspect;
 import org.springframework.stereotype.Component;
 import org.springframework.util.StopWatch;
 
+/**
+ * @package io.shinhanlife.axhub.biz.mcp.gateway.aop
+ * @className GatewayLoggingAspect
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @Slf4j
 @Aspect
 @Component
@@ -36,4 +50,4 @@ public class GatewayLoggingAspect {
             }
         }
     }
-}
+}
\ No newline at end of file
diff --git a/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/mcp/gateway/config/GatewayFallbackProperties.java b/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/mcp/gateway/config/GatewayFallbackProperties.java
index 5092e68..b5718dc 100644
--- a/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/mcp/gateway/config/GatewayFallbackProperties.java
+++ b/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/mcp/gateway/config/GatewayFallbackProperties.java
@@ -7,10 +7,24 @@ import org.springframework.context.annotation.Configuration;
 import java.util.HashMap;
 import java.util.Map;
 
+/**
+ * @package io.shinhanlife.axhub.biz.mcp.gateway.config
+ * @className GatewayFallbackProperties
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @Data
 @Configuration
 @ConfigurationProperties(prefix = "mcp.gateway.fallback")
 public class GatewayFallbackProperties {
     private Map<String, String> routes = new HashMap<>();
     private String defaultUrl;
-}
+}
\ No newline at end of file
diff --git a/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/mcp/gateway/config/RedisConfig.java b/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/mcp/gateway/config/RedisConfig.java
index c480a9e..372f737 100644
--- a/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/mcp/gateway/config/RedisConfig.java
+++ b/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/mcp/gateway/config/RedisConfig.java
@@ -9,6 +9,20 @@ import org.springframework.data.redis.core.RedisTemplate;
 import org.springframework.data.redis.serializer.Jackson2JsonRedisSerializer;
 import org.springframework.data.redis.serializer.StringRedisSerializer;
 
+/**
+ * @package io.shinhanlife.axhub.biz.mcp.gateway.config
+ * @className RedisConfig
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @Configuration
 public class RedisConfig {
 
diff --git a/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/mcp/gateway/controller/KillSwitchController.java b/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/mcp/gateway/controller/KillSwitchController.java
index 572efd3..11974ab 100644
--- a/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/mcp/gateway/controller/KillSwitchController.java
+++ b/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/mcp/gateway/controller/KillSwitchController.java
@@ -7,6 +7,20 @@ import org.springframework.web.bind.annotation.*;
 
 import java.util.Map;
 
+/**
+ * @package io.shinhanlife.axhub.biz.mcp.gateway.controller
+ * @className KillSwitchController
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @RestController
 @RequestMapping("/mcp/api/v1/admin/kill-switch")
 @RequiredArgsConstructor
@@ -52,4 +66,4 @@ public class KillSwitchController {
             "target", target
         ));
     }
-}
+}
\ No newline at end of file
diff --git a/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/mcp/gateway/controller/MciMockController.java b/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/mcp/gateway/controller/MciMockController.java
index 1f67945..dd17dde 100644
--- a/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/mcp/gateway/controller/MciMockController.java
+++ b/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/mcp/gateway/controller/MciMockController.java
@@ -4,6 +4,20 @@ import org.springframework.web.bind.annotation.PostMapping;
 import org.springframework.web.bind.annotation.RestController;
 import java.util.Map;
 
+/**
+ * @package io.shinhanlife.axhub.biz.mcp.gateway.controller
+ * @className MciMockController
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @RestController
 public class MciMockController {
 
@@ -34,4 +48,4 @@ public class MciMockController {
             )
         );
     }
-}
+}
\ No newline at end of file
diff --git a/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/mcp/gateway/controller/McpRouterController.java b/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/mcp/gateway/controller/McpRouterController.java
index b765aa3..2a58466 100644
--- a/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/mcp/gateway/controller/McpRouterController.java
+++ b/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/mcp/gateway/controller/McpRouterController.java
@@ -19,6 +19,20 @@ import java.util.List;
 import io.swagger.v3.oas.annotations.Operation;
 import io.swagger.v3.oas.annotations.tags.Tag;
 
+/**
+ * @package io.shinhanlife.axhub.biz.mcp.gateway.controller
+ * @className McpRouterController
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @Slf4j
 @RestController
 @RequestMapping("/mcp/api/v1")
@@ -185,4 +199,4 @@ public class McpRouterController {
             return ResponseEntity.status(404).body("Tool not found");
         }
     }
-}
+}
\ No newline at end of file
diff --git a/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/mcp/gateway/dto/ToolMetadata.java b/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/mcp/gateway/dto/ToolMetadata.java
index 17a81b9..af58a40 100644
--- a/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/mcp/gateway/dto/ToolMetadata.java
+++ b/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/mcp/gateway/dto/ToolMetadata.java
@@ -14,6 +14,20 @@ import java.util.Map;
  * Tool(Agent)의 명세 및 라우팅 정보를 담고 있는 메타데이터 클래스
  * Redis 레지스트리에 저장되며, Planner와 Router 간의 통신 객체(Plan)로 사용됩니다.
  */
+/**
+ * @package io.shinhanlife.axhub.biz.mcp.gateway.dto
+ * @className ToolMetadata
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @Builder
 @NoArgsConstructor
 @AllArgsConstructor
diff --git a/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/mcp/gateway/messaging/KafkaProducerService.java b/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/mcp/gateway/messaging/KafkaProducerService.java
index cb136e2..94420da 100644
--- a/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/mcp/gateway/messaging/KafkaProducerService.java
+++ b/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/mcp/gateway/messaging/KafkaProducerService.java
@@ -9,6 +9,20 @@ import com.fasterxml.jackson.databind.ObjectMapper;
 import java.util.Map;
 import java.util.UUID;
 
+/**
+ * @package io.shinhanlife.axhub.biz.mcp.gateway.messaging
+ * @className KafkaProducerService
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @Slf4j
 @Service
 @RequiredArgsConstructor
@@ -45,4 +59,3 @@ public class KafkaProducerService {
         return ticketId;
     }
 }
-
diff --git a/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/mcp/gateway/registry/RedisRegistryService.java b/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/mcp/gateway/registry/RedisRegistryService.java
index d4439e2..2023454 100644
--- a/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/mcp/gateway/registry/RedisRegistryService.java
+++ b/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/mcp/gateway/registry/RedisRegistryService.java
@@ -12,6 +12,20 @@ import java.util.Set;
 import java.util.stream.Collectors;
 import java.util.Objects;
 
+/**
+ * @package io.shinhanlife.axhub.biz.mcp.gateway.registry
+ * @className RedisRegistryService
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @Slf4j
 @Service
 @RequiredArgsConstructor
@@ -80,4 +94,4 @@ public class RedisRegistryService {
         redisTemplate.delete(KEY_PREFIX + toolName);
         log.info(" [RedisRegistry] 툴 삭제 완료: {}", toolName);
     }
-}
+}
\ No newline at end of file
diff --git a/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/mcp/gateway/service/ExecuteService.java b/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/mcp/gateway/service/ExecuteService.java
index 5982ea3..bf2c581 100644
--- a/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/mcp/gateway/service/ExecuteService.java
+++ b/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/mcp/gateway/service/ExecuteService.java
@@ -11,6 +11,20 @@ import org.springframework.http.MediaType;
 import java.util.Map;
 import java.util.List;
 
+/**
+ * @package io.shinhanlife.axhub.biz.mcp.gateway.service
+ * @className ExecuteService
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @Slf4j
 @Service
 @RequiredArgsConstructor
diff --git a/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/mcp/gateway/service/KillSwitchService.java b/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/mcp/gateway/service/KillSwitchService.java
index 337fa07..dd3ade7 100644
--- a/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/mcp/gateway/service/KillSwitchService.java
+++ b/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/mcp/gateway/service/KillSwitchService.java
@@ -5,6 +5,20 @@ import lombok.extern.slf4j.Slf4j;
 import org.springframework.data.redis.core.StringRedisTemplate;
 import org.springframework.stereotype.Service;
 
+/**
+ * @package io.shinhanlife.axhub.biz.mcp.gateway.service
+ * @className KillSwitchService
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @Slf4j
 @Service
 @RequiredArgsConstructor
@@ -54,4 +68,4 @@ public class KillSwitchService {
         stringRedisTemplate.delete(key);
         log.info(" [KillSwitch] 차단 키 완전 삭제: {} -> {}", type, target);
     }
-}
+}
\ No newline at end of file
diff --git a/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/mcp/gateway/service/ToolPlanner.java b/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/mcp/gateway/service/ToolPlanner.java
index f5cba6b..0134551 100644
--- a/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/mcp/gateway/service/ToolPlanner.java
+++ b/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/mcp/gateway/service/ToolPlanner.java
@@ -11,6 +11,20 @@ import org.springframework.stereotype.Component;
 import java.util.List;
 import java.util.Map;
 
+/**
+ * @package io.shinhanlife.axhub.biz.mcp.gateway.service
+ * @className ToolPlanner
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @Slf4j
 @Component
 @RequiredArgsConstructor
@@ -80,4 +94,4 @@ public class ToolPlanner {
         // 3. 수립된 계획(툴 메타데이터) 반환
         return toolMetadata;
     }
-}
+}
\ No newline at end of file
diff --git a/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/so/atm/converter/AccessMgmtConverter.java b/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/so/atm/converter/AccessMgmtConverter.java
index 9e1cd96..4a04f9a 100644
--- a/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/so/atm/converter/AccessMgmtConverter.java
+++ b/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/so/atm/converter/AccessMgmtConverter.java
@@ -10,6 +10,20 @@ import io.shinhanlife.axhub.biz.so.atm.presentation.io.AthrSearchResponse;
 import io.shinhanlife.axhub.biz.so.atm.presentation.io.RoleListRequest;
 import org.mapstruct.Mapper;
 
+/**
+ * @package io.shinhanlife.axhub.biz.so.atm.converter
+ * @className AccessMgmtConverter
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @Mapper(componentModel = "spring")
 public abstract class AccessMgmtConverter {
 
@@ -20,4 +34,4 @@ public abstract class AccessMgmtConverter {
     public abstract AthrSaveInDto toInDto(AthrSaveRequest request);
 
     public abstract AthrSearchResponse toResponse(AthrOutDto outDto);
-}
+}
\ No newline at end of file
diff --git a/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/so/atm/domain/repository/AccessMgmtMapper.java b/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/so/atm/domain/repository/AccessMgmtMapper.java
index 01af16c..bf5c309 100644
--- a/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/so/atm/domain/repository/AccessMgmtMapper.java
+++ b/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/so/atm/domain/repository/AccessMgmtMapper.java
@@ -11,6 +11,20 @@ import org.apache.ibatis.annotations.Param;
 
 import java.util.List;
 
+/**
+ * @package io.shinhanlife.axhub.biz.so.atm.domain.repository
+ * @className AccessMgmtMapper
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @GlowMybatisMapper
 public interface AccessMgmtMapper {
 
@@ -31,4 +45,4 @@ public interface AccessMgmtMapper {
     void deleteKnwlAthr(@Param("systId") String systId, @Param("roleNo") String roleNo);
 
     void insertKnwlAthr(RoleKnwlAthrInDto inDto);
-}
+}
\ No newline at end of file
diff --git a/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/so/atm/domain/service/AccessMgmtService.java b/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/so/atm/domain/service/AccessMgmtService.java
index 16b4bd0..d91ed5c 100644
--- a/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/so/atm/domain/service/AccessMgmtService.java
+++ b/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/so/atm/domain/service/AccessMgmtService.java
@@ -8,6 +8,20 @@ import io.shinhanlife.axhub.biz.so.atm.dto.RoleListOutDto;
 
 import java.util.List;
 
+/**
+ * @package io.shinhanlife.axhub.biz.so.atm.domain.service
+ * @className AccessMgmtService
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 public interface AccessMgmtService {
 
     List<RoleListOutDto> getRoles(RoleListInDto inDto);
@@ -15,4 +29,4 @@ public interface AccessMgmtService {
     AthrOutDto getAthr(AthrSearchInDto inDto);
 
     void saveAthr(AthrSaveInDto inDto);
-}
+}
\ No newline at end of file
diff --git a/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/so/atm/domain/service/impl/AccessMgmtServiceImpl.java b/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/so/atm/domain/service/impl/AccessMgmtServiceImpl.java
index e94354b..1bba37e 100644
--- a/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/so/atm/domain/service/impl/AccessMgmtServiceImpl.java
+++ b/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/so/atm/domain/service/impl/AccessMgmtServiceImpl.java
@@ -21,6 +21,20 @@ import java.util.Set;
 import java.util.UUID;
 import java.util.stream.Collectors;
 
+/**
+ * @package io.shinhanlife.axhub.biz.so.atm.domain.service.impl
+ * @className AccessMgmtServiceImpl
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @Service
 @RequiredArgsConstructor
 public class AccessMgmtServiceImpl implements AccessMgmtService {
@@ -125,4 +139,4 @@ public class AccessMgmtServiceImpl implements AccessMgmtService {
     private String shortUuid() {
         return UUID.randomUUID().toString().replace("-", "").substring(0, 12).toUpperCase();
     }
-}
+}
\ No newline at end of file
diff --git a/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/so/atm/dto/AthrItemOutDto.java b/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/so/atm/dto/AthrItemOutDto.java
index 5a75f78..b4f92f0 100644
--- a/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/so/atm/dto/AthrItemOutDto.java
+++ b/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/so/atm/dto/AthrItemOutDto.java
@@ -7,6 +7,20 @@ import lombok.AllArgsConstructor;
 import lombok.Getter;
 import lombok.Setter;
 
+/**
+ * @package io.shinhanlife.axhub.biz.so.atm.dto
+ * @className AthrItemOutDto
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @Getter
 @Setter
 @Builder
@@ -18,4 +32,4 @@ public class AthrItemOutDto {
     private String  resourceDs;
     private String  typeCode;
     private boolean granted;
-}
+}
\ No newline at end of file
diff --git a/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/so/atm/dto/AthrOutDto.java b/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/so/atm/dto/AthrOutDto.java
index a37fcb4..be10a30 100644
--- a/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/so/atm/dto/AthrOutDto.java
+++ b/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/so/atm/dto/AthrOutDto.java
@@ -9,6 +9,20 @@ import lombok.Getter;
 
 import java.util.List;
 
+/**
+ * @package io.shinhanlife.axhub.biz.so.atm.dto
+ * @className AthrOutDto
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @Getter
 @AllArgsConstructor
 @Setter
@@ -17,4 +31,4 @@ import java.util.List;
 public class AthrOutDto {
     private List<AthrItemOutDto> tools;
     private List<AthrItemOutDto> knwls;
-}
+}
\ No newline at end of file
diff --git a/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/so/atm/dto/AthrSaveInDto.java b/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/so/atm/dto/AthrSaveInDto.java
index 6ffded6..ba4b23b 100644
--- a/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/so/atm/dto/AthrSaveInDto.java
+++ b/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/so/atm/dto/AthrSaveInDto.java
@@ -9,6 +9,20 @@ import lombok.Setter;
 
 import java.util.List;
 
+/**
+ * @package io.shinhanlife.axhub.biz.so.atm.dto
+ * @className AthrSaveInDto
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @Getter
 @Setter
 @Builder
@@ -19,4 +33,4 @@ public class AthrSaveInDto {
     private String       roleNo;
     private List<String> grantedToolIds;
     private List<String> grantedKnwlIds;
-}
+}
\ No newline at end of file
diff --git a/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/so/atm/dto/AthrSearchInDto.java b/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/so/atm/dto/AthrSearchInDto.java
index 90413ec..c1ef881 100644
--- a/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/so/atm/dto/AthrSearchInDto.java
+++ b/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/so/atm/dto/AthrSearchInDto.java
@@ -7,6 +7,20 @@ import lombok.AllArgsConstructor;
 import lombok.Getter;
 import lombok.Setter;
 
+/**
+ * @package io.shinhanlife.axhub.biz.so.atm.dto
+ * @className AthrSearchInDto
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @Getter
 @Setter
 @Builder
@@ -15,4 +29,4 @@ import lombok.Setter;
 public class AthrSearchInDto {
     private String systId;
     private String roleNo;
-}
+}
\ No newline at end of file
diff --git a/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/so/atm/dto/RoleKnwlAthrInDto.java b/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/so/atm/dto/RoleKnwlAthrInDto.java
index 5ecc3bc..cdbd4cb 100644
--- a/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/so/atm/dto/RoleKnwlAthrInDto.java
+++ b/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/so/atm/dto/RoleKnwlAthrInDto.java
@@ -9,6 +9,20 @@ import lombok.Setter;
 
 import java.util.Date;
 
+/**
+ * @package io.shinhanlife.axhub.biz.so.atm.dto
+ * @className RoleKnwlAthrInDto
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @Getter
 @Setter
 @Builder
@@ -31,4 +45,4 @@ public class RoleKnwlAthrInDto {
     private String systChgOgnzNo;
     private String systChgSystCd;
     private String systChgPrgrId;
-}
+}
\ No newline at end of file
diff --git a/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/so/atm/dto/RoleListInDto.java b/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/so/atm/dto/RoleListInDto.java
index 0fee49a..5639171 100644
--- a/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/so/atm/dto/RoleListInDto.java
+++ b/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/so/atm/dto/RoleListInDto.java
@@ -7,6 +7,20 @@ import lombok.AllArgsConstructor;
 import lombok.Getter;
 import lombok.Setter;
 
+/**
+ * @package io.shinhanlife.axhub.biz.so.atm.dto
+ * @className RoleListInDto
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @Getter
 @Setter
 @Builder
@@ -16,4 +30,4 @@ public class RoleListInDto {
     private String systId;
     private String puseYn;
     private String keyword;
-}
+}
\ No newline at end of file
diff --git a/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/so/atm/dto/RoleListOutDto.java b/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/so/atm/dto/RoleListOutDto.java
index 29aa179..9eebab2 100644
--- a/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/so/atm/dto/RoleListOutDto.java
+++ b/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/so/atm/dto/RoleListOutDto.java
@@ -7,6 +7,20 @@ import lombok.AllArgsConstructor;
 import lombok.Getter;
 import lombok.Setter;
 
+/**
+ * @package io.shinhanlife.axhub.biz.so.atm.dto
+ * @className RoleListOutDto
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @Getter
 @Setter
 @Builder
@@ -18,4 +32,4 @@ public class RoleListOutDto {
     private String roleNm;
     private String roleDs;
     private String puseYn;
-}
+}
\ No newline at end of file
diff --git a/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/so/atm/dto/RoleToolAthrInDto.java b/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/so/atm/dto/RoleToolAthrInDto.java
index 4fc519c..95abfc1 100644
--- a/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/so/atm/dto/RoleToolAthrInDto.java
+++ b/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/so/atm/dto/RoleToolAthrInDto.java
@@ -9,6 +9,20 @@ import lombok.Setter;
 
 import java.util.Date;
 
+/**
+ * @package io.shinhanlife.axhub.biz.so.atm.dto
+ * @className RoleToolAthrInDto
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @Getter
 @Setter
 @Builder
@@ -31,4 +45,4 @@ public class RoleToolAthrInDto {
     private String systChgOgnzNo;
     private String systChgSystCd;
     private String systChgPrgrId;
-}
+}
\ No newline at end of file
diff --git a/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/so/atm/presentation/SOATM0100Controller.java b/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/so/atm/presentation/SOATM0100Controller.java
index 9021683..dc14007 100644
--- a/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/so/atm/presentation/SOATM0100Controller.java
+++ b/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/so/atm/presentation/SOATM0100Controller.java
@@ -17,6 +17,20 @@ import org.springframework.web.bind.annotation.RestController;
 
 import java.util.List;
 
+/**
+ * @package io.shinhanlife.axhub.biz.so.atm.presentation
+ * @className SOATM0100Controller
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @RestController
 @RequestMapping("/so/atm")
 @RequiredArgsConstructor
@@ -42,4 +56,4 @@ public class SOATM0100Controller {
         accessMgmtUseCase.saveAthr(request);
         return ResponseUtil.ok();
     }
-}
+}
\ No newline at end of file
diff --git a/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/so/atm/presentation/io/AthrSaveRequest.java b/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/so/atm/presentation/io/AthrSaveRequest.java
index f95874f..6842130 100644
--- a/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/so/atm/presentation/io/AthrSaveRequest.java
+++ b/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/so/atm/presentation/io/AthrSaveRequest.java
@@ -5,6 +5,20 @@ import lombok.Setter;
 
 import java.util.List;
 
+/**
+ * @package io.shinhanlife.axhub.biz.so.atm.presentation.io
+ * @className AthrSaveRequest
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @Getter
 @Setter
 public class AthrSaveRequest {
@@ -12,4 +26,4 @@ public class AthrSaveRequest {
     private String       roleNo;
     private List<String> grantedToolIds;
     private List<String> grantedKnwlIds;
-}
+}
\ No newline at end of file
diff --git a/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/so/atm/presentation/io/AthrSearchRequest.java b/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/so/atm/presentation/io/AthrSearchRequest.java
index 4a8bccb..761dfae 100644
--- a/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/so/atm/presentation/io/AthrSearchRequest.java
+++ b/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/so/atm/presentation/io/AthrSearchRequest.java
@@ -3,9 +3,23 @@ package io.shinhanlife.axhub.biz.so.atm.presentation.io;
 import lombok.Getter;
 import lombok.Setter;
 
+/**
+ * @package io.shinhanlife.axhub.biz.so.atm.presentation.io
+ * @className AthrSearchRequest
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @Getter
 @Setter
 public class AthrSearchRequest {
     private String systId;
     private String roleNo;
-}
+}
\ No newline at end of file
diff --git a/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/so/atm/presentation/io/AthrSearchResponse.java b/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/so/atm/presentation/io/AthrSearchResponse.java
index f749993..96ddf64 100644
--- a/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/so/atm/presentation/io/AthrSearchResponse.java
+++ b/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/so/atm/presentation/io/AthrSearchResponse.java
@@ -6,9 +6,23 @@ import lombok.Getter;
 
 import java.util.List;
 
+/**
+ * @package io.shinhanlife.axhub.biz.so.atm.presentation.io
+ * @className AthrSearchResponse
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @Getter
 @AllArgsConstructor
 public class AthrSearchResponse {
     private List<AthrItemOutDto> tools;
     private List<AthrItemOutDto> knwls;
-}
+}
\ No newline at end of file
diff --git a/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/so/atm/presentation/io/RoleListRequest.java b/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/so/atm/presentation/io/RoleListRequest.java
index c7a72bf..2e4bfdb 100644
--- a/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/so/atm/presentation/io/RoleListRequest.java
+++ b/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/so/atm/presentation/io/RoleListRequest.java
@@ -3,10 +3,24 @@ package io.shinhanlife.axhub.biz.so.atm.presentation.io;
 import lombok.Getter;
 import lombok.Setter;
 
+/**
+ * @package io.shinhanlife.axhub.biz.so.atm.presentation.io
+ * @className RoleListRequest
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @Getter
 @Setter
 public class RoleListRequest {
     private String systId;
     private String puseYn;
     private String keyword;
-}
+}
\ No newline at end of file
diff --git a/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/so/atm/usecase/AccessMgmtUseCase.java b/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/so/atm/usecase/AccessMgmtUseCase.java
index 28eaa85..9801a8e 100644
--- a/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/so/atm/usecase/AccessMgmtUseCase.java
+++ b/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/so/atm/usecase/AccessMgmtUseCase.java
@@ -8,6 +8,20 @@ import io.shinhanlife.axhub.biz.so.atm.presentation.io.RoleListRequest;
 
 import java.util.List;
 
+/**
+ * @package io.shinhanlife.axhub.biz.so.atm.usecase
+ * @className AccessMgmtUseCase
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 public interface AccessMgmtUseCase {
 
     List<RoleListOutDto> getRoles(RoleListRequest request);
@@ -15,4 +29,4 @@ public interface AccessMgmtUseCase {
     AthrSearchResponse getAthr(AthrSearchRequest request);
 
     void saveAthr(AthrSaveRequest request);
-}
+}
\ No newline at end of file
diff --git a/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/so/atm/usecase/impl/AccessMgmtUseCaseImpl.java b/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/so/atm/usecase/impl/AccessMgmtUseCaseImpl.java
index 954e9fe..6a17f8c 100644
--- a/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/so/atm/usecase/impl/AccessMgmtUseCaseImpl.java
+++ b/axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/so/atm/usecase/impl/AccessMgmtUseCaseImpl.java
@@ -13,6 +13,20 @@ import org.springframework.stereotype.Service;
 
 import java.util.List;
 
+/**
+ * @package io.shinhanlife.axhub.biz.so.atm.usecase.impl
+ * @className AccessMgmtUseCaseImpl
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @Service
 @RequiredArgsConstructor
 public class AccessMgmtUseCaseImpl implements AccessMgmtUseCase {
@@ -34,4 +48,4 @@ public class AccessMgmtUseCaseImpl implements AccessMgmtUseCase {
     public void saveAthr(AthrSaveRequest request) {
         accessMgmtService.saveAthr(converter.toInDto(request));
     }
-}
+}
\ No newline at end of file
diff --git a/axhub-gateway/src/main/java/io/shinhanlife/axhub/sample/converter/SampleConverter.java b/axhub-gateway/src/main/java/io/shinhanlife/axhub/sample/converter/SampleConverter.java
index 31a6993..e4643c6 100644
--- a/axhub-gateway/src/main/java/io/shinhanlife/axhub/sample/converter/SampleConverter.java
+++ b/axhub-gateway/src/main/java/io/shinhanlife/axhub/sample/converter/SampleConverter.java
@@ -9,6 +9,20 @@ import io.shinhanlife.axhub.sample.presentation.io.StrnTermRequest;
 import io.shinhanlife.axhub.sample.presentation.io.StrnTermResponse;
 import org.mapstruct.Mapper;
 
+/**
+ * @package io.shinhanlife.axhub.sample.converter
+ * @className SampleConverter
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @Mapper(componentModel = "spring")
 public abstract class SampleConverter {
 
@@ -20,4 +34,4 @@ public abstract class SampleConverter {
 
     public abstract AppliSystNtfyRgiInDTO convertAppliRequestToDto(AppliSystNtfyPatiRequest request);
 
-}
+}
\ No newline at end of file
diff --git a/axhub-gateway/src/main/java/io/shinhanlife/axhub/sample/domain/model/AppliSystNtfyPatiModel.java b/axhub-gateway/src/main/java/io/shinhanlife/axhub/sample/domain/model/AppliSystNtfyPatiModel.java
index 6be7a24..3677c6b 100644
--- a/axhub-gateway/src/main/java/io/shinhanlife/axhub/sample/domain/model/AppliSystNtfyPatiModel.java
+++ b/axhub-gateway/src/main/java/io/shinhanlife/axhub/sample/domain/model/AppliSystNtfyPatiModel.java
@@ -3,6 +3,20 @@ package io.shinhanlife.axhub.sample.domain.model;
 import io.shinhanlife.glow.db.dto.AuditInfo;
 import lombok.*;
 
+/**
+ * @package io.shinhanlife.axhub.sample.domain.model
+ * @className AppliSystNtfyPatiModel
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @Getter
 @Builder
 @AllArgsConstructor
@@ -18,4 +32,4 @@ public class AppliSystNtfyPatiModel extends AuditInfo {
     private String ntfyTrgtPrafNo;
     private String shmsPmlYn;
     private String ntfyCfmYn;
-}
+}
\ No newline at end of file
diff --git a/axhub-gateway/src/main/java/io/shinhanlife/axhub/sample/domain/repository/GlowSampleRepository.java b/axhub-gateway/src/main/java/io/shinhanlife/axhub/sample/domain/repository/GlowSampleRepository.java
index 2fec825..69d2eec 100644
--- a/axhub-gateway/src/main/java/io/shinhanlife/axhub/sample/domain/repository/GlowSampleRepository.java
+++ b/axhub-gateway/src/main/java/io/shinhanlife/axhub/sample/domain/repository/GlowSampleRepository.java
@@ -9,6 +9,20 @@ import io.shinhanlife.glow.PageInfo;
 
 import java.util.List;
 
+/**
+ * @package io.shinhanlife.axhub.sample.domain.repository
+ * @className GlowSampleRepository
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @GlowMybatisMapper
 public interface GlowSampleRepository {
 
@@ -17,4 +31,4 @@ public interface GlowSampleRepository {
 
     int insertAppliSystNtfyPati(AppliSystNtfyPatiModel appliSystNtfyPatiModel);
 
-}
+}
\ No newline at end of file
diff --git a/axhub-gateway/src/main/java/io/shinhanlife/axhub/sample/domain/service/GlowSampleService.java b/axhub-gateway/src/main/java/io/shinhanlife/axhub/sample/domain/service/GlowSampleService.java
index 71f87a5..8fd72d1 100644
--- a/axhub-gateway/src/main/java/io/shinhanlife/axhub/sample/domain/service/GlowSampleService.java
+++ b/axhub-gateway/src/main/java/io/shinhanlife/axhub/sample/domain/service/GlowSampleService.java
@@ -5,7 +5,21 @@ import io.shinhanlife.axhub.sample.dto.StrnTermListInDTO;
 import io.shinhanlife.axhub.sample.dto.StrnTermListOutDTO;
 import io.shinhanlife.glow.PageInfo;
 
+/**
+ * @package io.shinhanlife.axhub.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);
-}
+}
\ No newline at end of file
diff --git a/axhub-gateway/src/main/java/io/shinhanlife/axhub/sample/domain/service/impl/GlowSampleServiceImpl.java b/axhub-gateway/src/main/java/io/shinhanlife/axhub/sample/domain/service/impl/GlowSampleServiceImpl.java
index a7dac1f..32a3abf 100644
--- a/axhub-gateway/src/main/java/io/shinhanlife/axhub/sample/domain/service/impl/GlowSampleServiceImpl.java
+++ b/axhub-gateway/src/main/java/io/shinhanlife/axhub/sample/domain/service/impl/GlowSampleServiceImpl.java
@@ -14,6 +14,20 @@ import lombok.RequiredArgsConstructor;
 import org.springframework.stereotype.Service;
 import java.util.List;
 
+/**
+ * @package io.shinhanlife.axhub.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 {
@@ -38,4 +52,4 @@ public class GlowSampleServiceImpl implements GlowSampleService {
         return glowSampleRepository.insertAppliSystNtfyPati(appliSystNtfyPatiModel);
     }
 
-}
+}
\ No newline at end of file
diff --git a/axhub-gateway/src/main/java/io/shinhanlife/axhub/sample/dto/AppliSystNtfyRgiInDTO.java b/axhub-gateway/src/main/java/io/shinhanlife/axhub/sample/dto/AppliSystNtfyRgiInDTO.java
index 74d76d9..ce40b94 100644
--- a/axhub-gateway/src/main/java/io/shinhanlife/axhub/sample/dto/AppliSystNtfyRgiInDTO.java
+++ b/axhub-gateway/src/main/java/io/shinhanlife/axhub/sample/dto/AppliSystNtfyRgiInDTO.java
@@ -8,6 +8,20 @@ import lombok.AllArgsConstructor;
 
 import lombok.*;
 
+/**
+ * @package io.shinhanlife.axhub.sample.dto
+ * @className AppliSystNtfyRgiInDTO
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @Getter
 @Setter
 @Builder
@@ -24,4 +38,4 @@ public class AppliSystNtfyRgiInDTO {
     private String ntfyTrgtPrafNo;
     private String shmsPmlYn;
     private String ntfyCfmYn;
-}
+}
\ No newline at end of file
diff --git a/axhub-gateway/src/main/java/io/shinhanlife/axhub/sample/dto/StrnTermListInDTO.java b/axhub-gateway/src/main/java/io/shinhanlife/axhub/sample/dto/StrnTermListInDTO.java
index 107426c..a579d75 100644
--- a/axhub-gateway/src/main/java/io/shinhanlife/axhub/sample/dto/StrnTermListInDTO.java
+++ b/axhub-gateway/src/main/java/io/shinhanlife/axhub/sample/dto/StrnTermListInDTO.java
@@ -7,6 +7,20 @@ import lombok.Builder;
 import lombok.Getter;
 import lombok.Setter;
 
+/**
+ * @package io.shinhanlife.axhub.sample.dto
+ * @className StrnTermListInDTO
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @Getter
 @Setter
 @Builder
@@ -14,4 +28,4 @@ import lombok.Setter;
 @AllArgsConstructor
 public class StrnTermListInDTO {
     private String strnTermHanNm;
-}
+}
\ No newline at end of file
diff --git a/axhub-gateway/src/main/java/io/shinhanlife/axhub/sample/dto/StrnTermListOutDTO.java b/axhub-gateway/src/main/java/io/shinhanlife/axhub/sample/dto/StrnTermListOutDTO.java
index e99add9..b3599d1 100644
--- a/axhub-gateway/src/main/java/io/shinhanlife/axhub/sample/dto/StrnTermListOutDTO.java
+++ b/axhub-gateway/src/main/java/io/shinhanlife/axhub/sample/dto/StrnTermListOutDTO.java
@@ -11,6 +11,20 @@ import lombok.Setter;
 
 import java.util.List;
 
+/**
+ * @package io.shinhanlife.axhub.sample.dto
+ * @className StrnTermListOutDTO
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @Builder
 @Getter
 @Setter
@@ -29,4 +43,4 @@ public class StrnTermListOutDTO {
         private String strnTermEngNm;
         private String strnTermScrnTermNm;
     }
-}
+}
\ No newline at end of file
diff --git a/axhub-gateway/src/main/java/io/shinhanlife/axhub/sample/presentation/GlowSampleController.java b/axhub-gateway/src/main/java/io/shinhanlife/axhub/sample/presentation/GlowSampleController.java
index 343b58c..28f9c7f 100644
--- a/axhub-gateway/src/main/java/io/shinhanlife/axhub/sample/presentation/GlowSampleController.java
+++ b/axhub-gateway/src/main/java/io/shinhanlife/axhub/sample/presentation/GlowSampleController.java
@@ -13,6 +13,20 @@ import org.springframework.web.bind.annotation.PostMapping;
 import org.springframework.web.bind.annotation.RequestBody;
 import org.springframework.web.bind.annotation.RestController;
 
+/**
+ * @package io.shinhanlife.axhub.sample.presentation
+ * @className GlowSampleController
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @RestController
 @RequiredArgsConstructor
 
diff --git a/axhub-gateway/src/main/java/io/shinhanlife/axhub/sample/presentation/io/AppliSystNtfyPatiRequest.java b/axhub-gateway/src/main/java/io/shinhanlife/axhub/sample/presentation/io/AppliSystNtfyPatiRequest.java
index 4e1abf7..949995e 100644
--- a/axhub-gateway/src/main/java/io/shinhanlife/axhub/sample/presentation/io/AppliSystNtfyPatiRequest.java
+++ b/axhub-gateway/src/main/java/io/shinhanlife/axhub/sample/presentation/io/AppliSystNtfyPatiRequest.java
@@ -2,6 +2,20 @@ package io.shinhanlife.axhub.sample.presentation.io;
 
 import lombok.*;
 
+/**
+ * @package io.shinhanlife.axhub.sample.presentation.io
+ * @className AppliSystNtfyPatiRequest
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @Getter
 @Builder
 @NoArgsConstructor(access = AccessLevel.PROTECTED)
@@ -17,4 +31,4 @@ public class AppliSystNtfyPatiRequest {
     private String ntfyTrgtPrafNo;
     private String shmsPmlYn;
     private String ntfyCfmYn;
-}
+}
\ No newline at end of file
diff --git a/axhub-gateway/src/main/java/io/shinhanlife/axhub/sample/presentation/io/AppliSystNtfyPatiResponse.java b/axhub-gateway/src/main/java/io/shinhanlife/axhub/sample/presentation/io/AppliSystNtfyPatiResponse.java
index 1228f42..b5e8587 100644
--- a/axhub-gateway/src/main/java/io/shinhanlife/axhub/sample/presentation/io/AppliSystNtfyPatiResponse.java
+++ b/axhub-gateway/src/main/java/io/shinhanlife/axhub/sample/presentation/io/AppliSystNtfyPatiResponse.java
@@ -2,6 +2,20 @@ package io.shinhanlife.axhub.sample.presentation.io;
 
 import lombok.*;
 
+/**
+ * @package io.shinhanlife.axhub.sample.presentation.io
+ * @className AppliSystNtfyPatiResponse
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @Getter
 @Builder
 @NoArgsConstructor(access = AccessLevel.PROTECTED)
@@ -9,4 +23,4 @@ import lombok.*;
 public class AppliSystNtfyPatiResponse {
     private String successYn;
     private String msg;
-}
+}
\ No newline at end of file
diff --git a/axhub-gateway/src/main/java/io/shinhanlife/axhub/sample/presentation/io/StrnTermRequest.java b/axhub-gateway/src/main/java/io/shinhanlife/axhub/sample/presentation/io/StrnTermRequest.java
index 79c6d62..26f983f 100644
--- a/axhub-gateway/src/main/java/io/shinhanlife/axhub/sample/presentation/io/StrnTermRequest.java
+++ b/axhub-gateway/src/main/java/io/shinhanlife/axhub/sample/presentation/io/StrnTermRequest.java
@@ -3,6 +3,20 @@ package io.shinhanlife.axhub.sample.presentation.io;
 import io.shinhanlife.glow.PageInfo;
 import lombok.*;
 
+/**
+ * @package io.shinhanlife.axhub.sample.presentation.io
+ * @className StrnTermRequest
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @Getter
 @Builder
 @NoArgsConstructor(access = AccessLevel.PROTECTED)
@@ -11,4 +25,4 @@ public class StrnTermRequest {
     private PageInfo pageInfo;
 
     private String strnTermHanNm;
-}
+}
\ No newline at end of file
diff --git a/axhub-gateway/src/main/java/io/shinhanlife/axhub/sample/presentation/io/StrnTermResponse.java b/axhub-gateway/src/main/java/io/shinhanlife/axhub/sample/presentation/io/StrnTermResponse.java
index ece9ad9..5e02f84 100644
--- a/axhub-gateway/src/main/java/io/shinhanlife/axhub/sample/presentation/io/StrnTermResponse.java
+++ b/axhub-gateway/src/main/java/io/shinhanlife/axhub/sample/presentation/io/StrnTermResponse.java
@@ -5,6 +5,20 @@ import lombok.*;
 
 import java.util.List;
 
+/**
+ * @package io.shinhanlife.axhub.sample.presentation.io
+ * @className StrnTermResponse
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @Getter
 @Builder
 @NoArgsConstructor(access = AccessLevel.PROTECTED)
diff --git a/axhub-gateway/src/main/java/io/shinhanlife/axhub/sample/usecase/GlowSampleUseCase.java b/axhub-gateway/src/main/java/io/shinhanlife/axhub/sample/usecase/GlowSampleUseCase.java
index ef7eb7a..79a3c2b 100644
--- a/axhub-gateway/src/main/java/io/shinhanlife/axhub/sample/usecase/GlowSampleUseCase.java
+++ b/axhub-gateway/src/main/java/io/shinhanlife/axhub/sample/usecase/GlowSampleUseCase.java
@@ -5,7 +5,21 @@ import io.shinhanlife.axhub.sample.presentation.io.AppliSystNtfyPatiResponse;
 import io.shinhanlife.axhub.sample.presentation.io.StrnTermRequest;
 import io.shinhanlife.axhub.sample.presentation.io.StrnTermResponse;
 
+/**
+ * @package io.shinhanlife.axhub.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);
-}
+}
\ No newline at end of file
diff --git a/axhub-gateway/src/main/java/io/shinhanlife/axhub/sample/usecase/impl/GlowSampleUseCaseImpl.java b/axhub-gateway/src/main/java/io/shinhanlife/axhub/sample/usecase/impl/GlowSampleUseCaseImpl.java
index dacef02..2efeb04 100644
--- a/axhub-gateway/src/main/java/io/shinhanlife/axhub/sample/usecase/impl/GlowSampleUseCaseImpl.java
+++ b/axhub-gateway/src/main/java/io/shinhanlife/axhub/sample/usecase/impl/GlowSampleUseCaseImpl.java
@@ -15,6 +15,20 @@ import io.shinhanlife.glow.GlowServiceGroupId;
 import lombok.RequiredArgsConstructor;
 import org.springframework.stereotype.Service;
 
+/**
+ * @package io.shinhanlife.axhub.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")
@@ -40,4 +54,4 @@ public class GlowSampleUseCaseImpl implements GlowSampleUseCase {
                 .msg(rtn > 0 ? "성공적으로 처리 되었습니다." : "처리중 오류발생!!")
                 .build();
     }
-}
+}
\ No newline at end of file
diff --git a/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/adapter/aop/EimsMonitoringAspect.java b/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/adapter/aop/EimsMonitoringAspect.java
index 3762c4f..8e5267a 100644
--- a/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/adapter/aop/EimsMonitoringAspect.java
+++ b/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/adapter/aop/EimsMonitoringAspect.java
@@ -8,6 +8,20 @@ import org.springframework.stereotype.Component;
 
 import java.util.Arrays;
 
+/**
+ * @package io.shinhanlife.axhub.biz.mcp.adapter.aop
+ * @className EimsMonitoringAspect
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @Slf4j
 @Aspect
 @Component
diff --git a/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/adapter/connector/ExternalApiConnector.java b/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/adapter/connector/ExternalApiConnector.java
index 97d3dd7..c2da059 100644
--- a/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/adapter/connector/ExternalApiConnector.java
+++ b/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/adapter/connector/ExternalApiConnector.java
@@ -11,6 +11,20 @@ import org.springframework.web.client.RestClient;
 import java.util.Map;
 import java.util.List;
 
+/**
+ * @package io.shinhanlife.axhub.biz.mcp.adapter.connector
+ * @className ExternalApiConnector
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @Slf4j
 @Service
 public class ExternalApiConnector {
diff --git a/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/adapter/connector/InternalSystemConnector.java b/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/adapter/connector/InternalSystemConnector.java
index 511061d..d9235c5 100644
--- a/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/adapter/connector/InternalSystemConnector.java
+++ b/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/adapter/connector/InternalSystemConnector.java
@@ -11,6 +11,20 @@ import org.springframework.web.client.RestClient;
 import java.util.Map;
 import java.util.List;
 
+/**
+ * @package io.shinhanlife.axhub.biz.mcp.adapter.connector
+ * @className InternalSystemConnector
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @Slf4j
 @Service
 public class InternalSystemConnector {
diff --git a/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/adapter/connector/LegacyDbConnector.java b/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/adapter/connector/LegacyDbConnector.java
index 3f47074..f718cc3 100644
--- a/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/adapter/connector/LegacyDbConnector.java
+++ b/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/adapter/connector/LegacyDbConnector.java
@@ -12,6 +12,20 @@ import java.util.List;
 import java.util.Map;
 import java.util.stream.Collectors;
 
+/**
+ * @package io.shinhanlife.axhub.biz.mcp.adapter.connector
+ * @className LegacyDbConnector
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @Slf4j
 @Service
 @RequiredArgsConstructor
diff --git a/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/adapter/connector/LegacyEimsConnector.java b/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/adapter/connector/LegacyEimsConnector.java
index 8f462f7..9408b63 100644
--- a/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/adapter/connector/LegacyEimsConnector.java
+++ b/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/adapter/connector/LegacyEimsConnector.java
@@ -14,6 +14,20 @@ import java.util.List;
 import java.util.Map;
 import io.shinhanlife.axhub.biz.mcp.adapter.util.LegacyDataTransformer;
 
+/**
+ * @package io.shinhanlife.axhub.biz.mcp.adapter.connector
+ * @className LegacyEimsConnector
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @Slf4j
 @Service
 @RequiredArgsConstructor
@@ -118,4 +132,4 @@ public class LegacyEimsConnector {
             return "{}";
         }
     }
-}
+}
\ No newline at end of file
diff --git a/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/adapter/connector/ThirdPartySecurityConnector.java b/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/adapter/connector/ThirdPartySecurityConnector.java
index 6af4545..9671495 100644
--- a/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/adapter/connector/ThirdPartySecurityConnector.java
+++ b/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/adapter/connector/ThirdPartySecurityConnector.java
@@ -7,6 +7,20 @@ import org.springframework.stereotype.Service;
 
 import java.util.Map;
 
+/**
+ * @package io.shinhanlife.axhub.biz.mcp.adapter.connector
+ * @className ThirdPartySecurityConnector
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @Slf4j
 @Service
 @RequiredArgsConstructor
@@ -54,4 +68,4 @@ public class ThirdPartySecurityConnector {
         log.info(" [3rd Party Security] 보안 모듈 처리 완료");
         return resultJson;
     }
-}
+}
\ No newline at end of file
diff --git a/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/adapter/sender/EaiEimsSender.java b/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/adapter/sender/EaiEimsSender.java
index 5796a5d..79d0183 100644
--- a/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/adapter/sender/EaiEimsSender.java
+++ b/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/adapter/sender/EaiEimsSender.java
@@ -10,6 +10,20 @@ import org.springframework.kafka.core.KafkaTemplate;
 import org.springframework.stereotype.Service;
 import org.springframework.util.StopWatch;
 
+/**
+ * @package io.shinhanlife.axhub.biz.mcp.adapter.sender
+ * @className EaiEimsSender
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @Slf4j
 @Service("eaiEimsSender")
 @RequiredArgsConstructor
@@ -87,4 +101,4 @@ public class EaiEimsSender implements EimsSender {
                 interfaceId, System.currentTimeMillis(), xmlData
         );
     }
-}
+}
\ No newline at end of file
diff --git a/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/adapter/sender/EimsSender.java b/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/adapter/sender/EimsSender.java
index 96beced..946cec1 100644
--- a/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/adapter/sender/EimsSender.java
+++ b/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/adapter/sender/EimsSender.java
@@ -1,6 +1,20 @@
 package io.shinhanlife.axhub.biz.mcp.adapter.sender;
 
+/**
+ * @package io.shinhanlife.axhub.biz.mcp.adapter.sender
+ * @className EimsSender
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 public interface EimsSender {
     // 프로토콜에 상관없이 이 메서드 하나로 통일합니다.
     String send(String interfaceId, String payload) throws Exception;
-}
+}
\ No newline at end of file
diff --git a/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/adapter/sender/HttpEimsSender.java b/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/adapter/sender/HttpEimsSender.java
index 7f83825..c0b40ab 100644
--- a/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/adapter/sender/HttpEimsSender.java
+++ b/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/adapter/sender/HttpEimsSender.java
@@ -13,6 +13,20 @@ import org.slf4j.MDC;
 
 import io.shinhanlife.axhub.biz.mcp.tool.config.GlowCommunicationProperties;
 
+/**
+ * @package io.shinhanlife.axhub.biz.mcp.adapter.sender
+ * @className HttpEimsSender
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @Slf4j
 @Component
 public class HttpEimsSender implements EimsSender {
@@ -50,4 +64,4 @@ public class HttpEimsSender implements EimsSender {
                 .retrieve()
                 .body(String.class); // 응답 결과를 String으로 받음
     }
-}
+}
\ No newline at end of file
diff --git a/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/adapter/sender/JspFormEimsSender.java b/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/adapter/sender/JspFormEimsSender.java
index 7253f96..78e450e 100644
--- a/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/adapter/sender/JspFormEimsSender.java
+++ b/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/adapter/sender/JspFormEimsSender.java
@@ -9,6 +9,20 @@ import org.springframework.util.LinkedMultiValueMap;
 import org.springframework.util.MultiValueMap;
 import org.springframework.web.client.RestClient;
 
+/**
+ * @package io.shinhanlife.axhub.biz.mcp.adapter.sender
+ * @className JspFormEimsSender
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @Slf4j
 @Component
 public class JspFormEimsSender implements EimsSender {
@@ -41,4 +55,4 @@ public class JspFormEimsSender implements EimsSender {
         // 3. JSP 특유의 앞뒤 공백 및 엔터 제거
         return rawResponse != null ? rawResponse.trim() : "";
     }
-}
+}
\ No newline at end of file
diff --git a/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/adapter/sender/JspJsonEimsSender.java b/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/adapter/sender/JspJsonEimsSender.java
index 65b8254..835d31a 100644
--- a/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/adapter/sender/JspJsonEimsSender.java
+++ b/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/adapter/sender/JspJsonEimsSender.java
@@ -8,6 +8,20 @@ import org.springframework.web.client.RestClient;
 
 import java.util.Map;
 
+/**
+ * @package io.shinhanlife.axhub.biz.mcp.adapter.sender
+ * @className JspJsonEimsSender
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @Slf4j
 @Component
 public class JspJsonEimsSender implements EimsSender {
@@ -42,4 +56,4 @@ public class JspJsonEimsSender implements EimsSender {
         // 3. JSP 응답 정제
         return rawResponse != null ? rawResponse.trim() : "";
     }
-}
+}
\ No newline at end of file
diff --git a/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/adapter/sender/MciEimsSender.java b/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/adapter/sender/MciEimsSender.java
index 626408a..b6915e6 100644
--- a/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/adapter/sender/MciEimsSender.java
+++ b/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/adapter/sender/MciEimsSender.java
@@ -10,6 +10,20 @@ import org.springframework.stereotype.Service;
 import org.springframework.util.StopWatch;
 import org.springframework.web.client.RestClient;
 
+/**
+ * @package io.shinhanlife.axhub.biz.mcp.adapter.sender
+ * @className MciEimsSender
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @Slf4j
 @Service("mciEimsSender")
 public class MciEimsSender implements EimsSender {
@@ -58,4 +72,4 @@ public class MciEimsSender implements EimsSender {
     private String wrapWithEsbHeader(String interfaceId, String xmlData) {
         return String.format("<EsbMessage><Header><InterfaceId>%s</InterfaceId></Header><Body>%s</Body></EsbMessage>", interfaceId, xmlData);
     }
-}
+}
\ No newline at end of file
diff --git a/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/adapter/sender/TcpEimsSender.java b/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/adapter/sender/TcpEimsSender.java
index bdc63f0..c562b34 100644
--- a/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/adapter/sender/TcpEimsSender.java
+++ b/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/adapter/sender/TcpEimsSender.java
@@ -10,6 +10,20 @@ import java.io.OutputStream;
 import java.net.InetSocketAddress;
 import java.net.Socket;
 
+/**
+ * @package io.shinhanlife.axhub.biz.mcp.adapter.sender
+ * @className TcpEimsSender
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @Slf4j
 @Component
 public class TcpEimsSender implements EimsSender {
@@ -54,4 +68,4 @@ public class TcpEimsSender implements EimsSender {
             return new String(buffer, 0, readByte, "EUC-KR");
         }
     }
-}
+}
\ No newline at end of file
diff --git a/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/adapter/support/DynamicPayloadBuilder.java b/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/adapter/support/DynamicPayloadBuilder.java
index 824df7c..5b27735 100644
--- a/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/adapter/support/DynamicPayloadBuilder.java
+++ b/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/adapter/support/DynamicPayloadBuilder.java
@@ -5,6 +5,20 @@ import org.springframework.stereotype.Service;
 import java.util.List;
 import java.util.Map;
 
+/**
+ * @package io.shinhanlife.axhub.biz.mcp.adapter.support
+ * @className DynamicPayloadBuilder
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @Service
 public class DynamicPayloadBuilder {
 
diff --git a/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/adapter/support/DynamicSchemaValidator.java b/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/adapter/support/DynamicSchemaValidator.java
index 1cf11d8..037efc4 100644
--- a/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/adapter/support/DynamicSchemaValidator.java
+++ b/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/adapter/support/DynamicSchemaValidator.java
@@ -4,6 +4,20 @@ import org.springframework.stereotype.Service;
 import java.util.List;
 import java.util.Map;
 
+/**
+ * @package io.shinhanlife.axhub.biz.mcp.adapter.support
+ * @className DynamicSchemaValidator
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @Service
 public class DynamicSchemaValidator {
     
diff --git a/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/adapter/support/ResultStandardizer.java b/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/adapter/support/ResultStandardizer.java
index 2585030..b327488 100644
--- a/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/adapter/support/ResultStandardizer.java
+++ b/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/adapter/support/ResultStandardizer.java
@@ -5,6 +5,20 @@ import org.springframework.stereotype.Component;
 import java.util.HashMap;
 import java.util.Map;
 
+/**
+ * @package io.shinhanlife.axhub.biz.mcp.adapter.support
+ * @className ResultStandardizer
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @Component
 public class ResultStandardizer {
 
diff --git a/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/adapter/support/TicketManager.java b/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/adapter/support/TicketManager.java
index c4b940e..08cb970 100644
--- a/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/adapter/support/TicketManager.java
+++ b/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/adapter/support/TicketManager.java
@@ -10,6 +10,20 @@ import java.util.concurrent.Executors;
 import java.util.concurrent.ScheduledExecutorService;
 import java.util.concurrent.TimeUnit;
 
+/**
+ * @package io.shinhanlife.axhub.biz.mcp.adapter.support
+ * @className TicketManager
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @Slf4j
 @Component
 public class TicketManager {
@@ -80,4 +94,3 @@ public class TicketManager {
         }
     }
 }
-
diff --git a/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/adapter/support/ToolExecutionService.java b/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/adapter/support/ToolExecutionService.java
index 55637d6..ebb5667 100644
--- a/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/adapter/support/ToolExecutionService.java
+++ b/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/adapter/support/ToolExecutionService.java
@@ -12,6 +12,20 @@ import org.springframework.stereotype.Service;
 import java.util.HashMap;
 import java.util.Map;
 
+/**
+ * @package io.shinhanlife.axhub.biz.mcp.adapter.support
+ * @className ToolExecutionService
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @Slf4j
 @Service
 @RequiredArgsConstructor
@@ -73,4 +87,4 @@ public class ToolExecutionService {
         response.setError(new ErrorDetail(code, message));
         return response;
     }
-}
+}
\ No newline at end of file
diff --git a/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/adapter/test/MockEimsHttpServer.java b/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/adapter/test/MockEimsHttpServer.java
index 2f58be2..71ebb64 100644
--- a/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/adapter/test/MockEimsHttpServer.java
+++ b/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/adapter/test/MockEimsHttpServer.java
@@ -6,6 +6,20 @@ import com.fasterxml.jackson.databind.ObjectMapper;
 import org.springframework.core.io.ClassPathResource;
 import java.util.Map;
 
+/**
+ * @package io.shinhanlife.axhub.biz.mcp.adapter.test
+ * @className MockEimsHttpServer
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @Slf4j
 @RestController
 @RequestMapping("/api")
diff --git a/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/adapter/test/MockEimsTcpServer.java b/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/adapter/test/MockEimsTcpServer.java
index 8eb094d..e437abd 100644
--- a/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/adapter/test/MockEimsTcpServer.java
+++ b/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/adapter/test/MockEimsTcpServer.java
@@ -21,6 +21,20 @@ import java.util.Map;
 @Slf4j
 @Component
 // 대신 "local" 환경(application-local.properties)에서만 가짜 소켓 서버가 켜지도록 보장합니다.
+/**
+ * @package io.shinhanlife.axhub.biz.mcp.adapter.test
+ * @className MockEimsTcpServer
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @Profile("local")
 public class MockEimsTcpServer {
 
diff --git a/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/adapter/test/MockJspServer.java b/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/adapter/test/MockJspServer.java
index e6ab2ec..4bfbf65 100644
--- a/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/adapter/test/MockJspServer.java
+++ b/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/adapter/test/MockJspServer.java
@@ -6,6 +6,20 @@ import org.springframework.web.bind.annotation.*;
 
 import java.util.Map;
 
+/**
+ * @package io.shinhanlife.axhub.biz.mcp.adapter.test
+ * @className MockJspServer
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @Slf4j
 @RestController
 @RequestMapping("/mock")
diff --git a/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/adapter/util/LegacyDataTransformer.java b/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/adapter/util/LegacyDataTransformer.java
index 46e6af9..61323ae 100644
--- a/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/adapter/util/LegacyDataTransformer.java
+++ b/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/adapter/util/LegacyDataTransformer.java
@@ -5,6 +5,20 @@ import java.util.HashMap;
 import java.util.List;
 import java.util.Map;
 
+/**
+ * @package io.shinhanlife.axhub.biz.mcp.adapter.util
+ * @className LegacyDataTransformer
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @Slf4j
 public class LegacyDataTransformer {
 
@@ -75,4 +89,4 @@ public class LegacyDataTransformer {
 
         return transformedData;
     }
-}
+}
\ No newline at end of file
diff --git a/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/adapter/util/PiiMaskingLogbackConverter.java b/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/adapter/util/PiiMaskingLogbackConverter.java
index d13c2c9..9d7b3fd 100644
--- a/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/adapter/util/PiiMaskingLogbackConverter.java
+++ b/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/adapter/util/PiiMaskingLogbackConverter.java
@@ -8,6 +8,20 @@ import ch.qos.logback.classic.spi.ILoggingEvent;
  * 모든 로그 메시지(%msg)가 파일이나 콘솔에 찍히기 직전에 이 클래스를 거쳐가게 됩니다.
  * 여기서 PiiMaskingUtils.mask()를 호출하여 PII(주민번호, 계좌번호 등)를 안전하게 별표(*) 처리합니다.
  */
+/**
+ * @package io.shinhanlife.axhub.biz.mcp.adapter.util
+ * @className PiiMaskingLogbackConverter
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 public class PiiMaskingLogbackConverter extends MessageConverter {
 
     @Override
@@ -18,4 +32,4 @@ public class PiiMaskingLogbackConverter extends MessageConverter {
         // 정규식을 이용하여 개인정보가 포함되어 있으면 마스킹 처리하여 반환합니다.
         return PiiMaskingUtils.mask(originalMessage);
     }
-}
+}
\ No newline at end of file
diff --git a/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/adapter/util/PiiMaskingUtils.java b/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/adapter/util/PiiMaskingUtils.java
index a05d846..269ab09 100644
--- a/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/adapter/util/PiiMaskingUtils.java
+++ b/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/adapter/util/PiiMaskingUtils.java
@@ -3,6 +3,20 @@ package io.shinhanlife.axhub.biz.mcp.adapter.util;
 import java.util.regex.Matcher;
 import java.util.regex.Pattern;
 
+/**
+ * @package io.shinhanlife.axhub.biz.mcp.adapter.util
+ * @className PiiMaskingUtils
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 public class PiiMaskingUtils {
     
     // 1. 주민등록번호 패턴 (ex: 900101-1234567 또는 9001011234567)
@@ -60,4 +74,4 @@ public class PiiMaskingUtils {
 
         return masked;
     }
-}
+}
\ No newline at end of file
diff --git a/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/sample/dto/SampleMciReqDto.java b/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/sample/dto/SampleMciReqDto.java
index 09d24cf..bb828cf 100644
--- a/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/sample/dto/SampleMciReqDto.java
+++ b/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/sample/dto/SampleMciReqDto.java
@@ -7,6 +7,20 @@ import lombok.Getter;
 import lombok.NoArgsConstructor;
 import lombok.ToString;
 
+/**
+ * @package io.shinhanlife.axhub.biz.mcp.sample.dto
+ * @className SampleMciReqDto
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @Getter
 @Builder
 @ToString
@@ -28,4 +42,4 @@ public class SampleMciReqDto {
      * 요청 세부 파라미터
      */
     private String requestDetails;
-}
+}
\ No newline at end of file
diff --git a/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/sample/dto/SampleMciResDto.java b/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/sample/dto/SampleMciResDto.java
index 93d548b..6fac01a 100644
--- a/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/sample/dto/SampleMciResDto.java
+++ b/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/sample/dto/SampleMciResDto.java
@@ -9,6 +9,20 @@ import lombok.ToString;
 
 import java.util.Map;
 
+/**
+ * @package io.shinhanlife.axhub.biz.mcp.sample.dto
+ * @className SampleMciResDto
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @Getter
 @Builder
 @ToString
@@ -30,4 +44,4 @@ public class SampleMciResDto {
      * 상세 데이터
      */
     private Map<String, Object> data;
-}
+}
\ No newline at end of file
diff --git a/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/sample/service/SampleMciCallService.java b/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/sample/service/SampleMciCallService.java
index 8bbe5e0..0128694 100644
--- a/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/sample/service/SampleMciCallService.java
+++ b/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/sample/service/SampleMciCallService.java
@@ -9,6 +9,20 @@ import lombok.RequiredArgsConstructor;
 import lombok.extern.slf4j.Slf4j;
 import org.springframework.stereotype.Service;
 
+/**
+ * @package io.shinhanlife.axhub.biz.mcp.sample.service
+ * @className SampleMciCallService
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @Slf4j
 @Service
 @RequiredArgsConstructor
@@ -49,4 +63,4 @@ public class SampleMciCallService {
             throw new RuntimeException("MCI 통신 실패", e);
         }
     }
-}
+}
\ No newline at end of file
diff --git a/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/aop/ToolSlaMonitoringAspect.java b/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/aop/ToolSlaMonitoringAspect.java
index 51f8af4..c8be8e2 100644
--- a/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/aop/ToolSlaMonitoringAspect.java
+++ b/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/aop/ToolSlaMonitoringAspect.java
@@ -13,6 +13,20 @@ import org.springframework.util.StopWatch;
 
 import java.lang.reflect.Method;
 
+/**
+ * @package io.shinhanlife.axhub.biz.mcp.tool.aop
+ * @className ToolSlaMonitoringAspect
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @Slf4j
 @Aspect
 @Component
@@ -66,4 +80,4 @@ public class ToolSlaMonitoringAspect {
             throw e;
         }
     }
-}
+}
\ No newline at end of file
diff --git a/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/config/GlowCommunicationProperties.java b/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/config/GlowCommunicationProperties.java
index 9c9b605..fae395d 100644
--- a/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/config/GlowCommunicationProperties.java
+++ b/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/config/GlowCommunicationProperties.java
@@ -10,6 +10,20 @@ import org.springframework.stereotype.Component;
  * application-glow-local.yml 의 'glow.communication' 하위 설정값들을 
  * 자바 객체(Bean)로 매핑하여 제공합니다.
  */
+/**
+ * @package io.shinhanlife.axhub.biz.mcp.tool.config
+ * @className GlowCommunicationProperties
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @Component
 @Getter
 @Setter
@@ -68,4 +82,4 @@ public class GlowCommunicationProperties {
         private String endpoint;
         private String allowedOrigins;
     }
-}
+}
\ No newline at end of file
diff --git a/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/config/McpProperties.java b/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/config/McpProperties.java
index a4309df..eb8918d 100644
--- a/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/config/McpProperties.java
+++ b/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/config/McpProperties.java
@@ -6,6 +6,20 @@ import org.springframework.context.annotation.Configuration;
 
 import java.util.Map;
 
+/**
+ * @package io.shinhanlife.axhub.biz.mcp.tool.config
+ * @className McpProperties
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @Data
 @Configuration
 @ConfigurationProperties(prefix = "mcp")
@@ -22,4 +36,4 @@ public class McpProperties {
         private Boolean register;
         private Boolean visible;
     }
-}
+}
\ No newline at end of file
diff --git a/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/controller/BusinessToolController.java b/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/controller/BusinessToolController.java
index 1be9172..ee689e2 100644
--- a/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/controller/BusinessToolController.java
+++ b/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/controller/BusinessToolController.java
@@ -28,6 +28,20 @@ import io.shinhanlife.axhub.biz.mcp.tool.util.JsonSchemaGenerator;
 
 import lombok.extern.slf4j.Slf4j;
 
+/**
+ * @package io.shinhanlife.axhub.biz.mcp.tool.controller
+ * @className BusinessToolController
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @Slf4j
 @RestController
 @RequestMapping("/")
@@ -169,4 +183,4 @@ public class BusinessToolController {
             return error;
         }
     }
-}
+}
\ No newline at end of file
diff --git a/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/dto/ToolMetadata.java b/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/dto/ToolMetadata.java
index be31562..8dd09d7 100644
--- a/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/dto/ToolMetadata.java
+++ b/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/dto/ToolMetadata.java
@@ -8,6 +8,20 @@ import lombok.AllArgsConstructor;
 
 import java.util.Map;
 
+/**
+ * @package io.shinhanlife.axhub.biz.mcp.tool.dto
+ * @className ToolMetadata
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @Getter
 @Setter
 @Builder
@@ -28,4 +42,4 @@ public class ToolMetadata {
     private boolean visible = true;
 
 
-}
+}
\ No newline at end of file
diff --git a/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/service/AbstractMcpToolService.java b/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/service/AbstractMcpToolService.java
index 2dd96e0..ce9f58d 100644
--- a/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/service/AbstractMcpToolService.java
+++ b/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/service/AbstractMcpToolService.java
@@ -11,6 +11,20 @@ import java.util.Map;
 
 import lombok.extern.slf4j.Slf4j;
 
+/**
+ * @package io.shinhanlife.axhub.biz.mcp.tool.service
+ * @className AbstractMcpToolService
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @Slf4j
 public abstract class AbstractMcpToolService {
 
@@ -65,4 +79,4 @@ public abstract class AbstractMcpToolService {
             return error;
         }
     }
-}
+}
\ No newline at end of file
diff --git a/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/service/ToolRegistryHeartbeatSender.java b/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/service/ToolRegistryHeartbeatSender.java
index 1d87785..145dde8 100644
--- a/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/service/ToolRegistryHeartbeatSender.java
+++ b/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/service/ToolRegistryHeartbeatSender.java
@@ -24,6 +24,20 @@ import java.util.HashMap;
 import java.util.List;
 import java.util.Map;
 
+/**
+ * @package io.shinhanlife.axhub.biz.mcp.tool.service
+ * @className ToolRegistryHeartbeatSender
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @Slf4j
 @Component
 @Configuration
@@ -148,4 +162,4 @@ public class ToolRegistryHeartbeatSender {
             log.error(" [HeartbeatSender] 툴 등록 실패: {}", ex.getMessage());
         }
     }
-}
+}
\ No newline at end of file
diff --git a/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/util/JsonSchemaGenerator.java b/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/util/JsonSchemaGenerator.java
index a27502a..844827c 100644
--- a/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/util/JsonSchemaGenerator.java
+++ b/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/util/JsonSchemaGenerator.java
@@ -5,6 +5,20 @@ import java.lang.reflect.Field;
 import java.util.HashMap;
 import java.util.Map;
 
+/**
+ * @package io.shinhanlife.axhub.biz.mcp.tool.util
+ * @className JsonSchemaGenerator
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 public class JsonSchemaGenerator {
 
     /**
@@ -43,4 +57,4 @@ public class JsonSchemaGenerator {
         if (java.util.List.class.isAssignableFrom(clazz)) return "array";
         return "object";
     }
-}
+}
\ No newline at end of file
diff --git a/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/util/ToolScaffolder.java b/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/util/ToolScaffolder.java
index 2af4a40..4aef13c 100644
--- a/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/util/ToolScaffolder.java
+++ b/axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/util/ToolScaffolder.java
@@ -18,6 +18,20 @@ import java.util.Scanner;
  *  - 컴파일: javac -encoding UTF-8 axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/util/ToolScaffolder.java
  *  - 실행: java -cp axhub-tool-core/src/main/java io.shinhanlife.axhub.biz.mcp.tool.util.ToolScaffolder [이름] [ID] "[설명]" "[그룹]" "[통신방식]" "[모듈명]"
  */
+/**
+ * @package io.shinhanlife.axhub.biz.mcp.tool.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.axhub.biz.mcp.tool";
@@ -169,4 +183,4 @@ public class ToolScaffolder {
         System.out.println("[Res DTO] " + dtoDir.resolve(baseName + "Res.java"));
         System.out.println("\n💡 팁: " + interfaceId + " 목업 데이터를 mock-responses.json에 추가하세요.");
     }
-}
+}
\ No newline at end of file
diff --git a/axhub-tool-email/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/dto/EmailSendReq.java b/axhub-tool-email/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/dto/EmailSendReq.java
index e35d147..501426f 100644
--- a/axhub-tool-email/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/dto/EmailSendReq.java
+++ b/axhub-tool-email/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/dto/EmailSendReq.java
@@ -8,6 +8,20 @@ import io.shinhanlife.axhub.biz.mcp.tool.annotation.McpParameter;
 import lombok.Getter;
 import lombok.Setter;
 
+/**
+ * @package io.shinhanlife.axhub.biz.mcp.tool.dto
+ * @className EmailSendReq
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @Getter
 @Setter
 @Builder
@@ -23,4 +37,4 @@ public class EmailSendReq {
 
     @McpParameter(description = "이메일 본문 내용", required = true)
     private String body;
-}
+}
\ No newline at end of file
diff --git a/axhub-tool-email/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/email/AxHubToolEmailApplication.java b/axhub-tool-email/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/email/AxHubToolEmailApplication.java
index d8cc0e5..835e27d 100644
--- a/axhub-tool-email/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/email/AxHubToolEmailApplication.java
+++ b/axhub-tool-email/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/email/AxHubToolEmailApplication.java
@@ -4,6 +4,20 @@ import org.springframework.boot.SpringApplication;
 import org.springframework.boot.autoconfigure.SpringBootApplication;
 import org.springframework.cache.annotation.EnableCaching;
 
+/**
+ * @package io.shinhanlife.axhub.biz.mcp.tool.email
+ * @className AxHubToolEmailApplication
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @SpringBootApplication(scanBasePackages = {"io.shinhanlife.axhub.biz.mcp.tool", "io.shinhanlife.axhub.biz.mcp.adapter", "io.shinhanlife.axhub.common.mcp", "io.shinhanlife.axhub.common.config"})
 @org.springframework.boot.context.properties.ConfigurationPropertiesScan(basePackages = {"io.shinhanlife.axhub.biz.mcp.tool", "io.shinhanlife.axhub.biz.mcp.adapter", "io.shinhanlife.axhub.common.mcp", "io.shinhanlife.axhub.common.config"})
 @EnableCaching
@@ -11,4 +25,4 @@ public class AxHubToolEmailApplication {
     public static void main(String[] args) {
         SpringApplication.run(AxHubToolEmailApplication.class, args);
     }
-}
+}
\ No newline at end of file
diff --git a/axhub-tool-email/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/email/EmailToolService.java b/axhub-tool-email/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/email/EmailToolService.java
index 8656135..29b0c6e 100644
--- a/axhub-tool-email/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/email/EmailToolService.java
+++ b/axhub-tool-email/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/email/EmailToolService.java
@@ -9,6 +9,20 @@ import lombok.extern.slf4j.Slf4j;
 import java.util.HashMap;
 import java.util.Map;
 
+/**
+ * @package io.shinhanlife.axhub.biz.mcp.tool.email
+ * @className EmailToolService
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @Slf4j
 @McpTool(routingType = "EAI", group = "NOTIFICATION")
 public class EmailToolService extends AbstractMcpToolService {
@@ -33,4 +47,4 @@ public class EmailToolService extends AbstractMcpToolService {
 
         return result;
     }
-}
+}
\ No newline at end of file
diff --git a/axhub-tool-other/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/dto/BillingProcessReq.java b/axhub-tool-other/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/dto/BillingProcessReq.java
index b0b393e..95ac307 100644
--- a/axhub-tool-other/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/dto/BillingProcessReq.java
+++ b/axhub-tool-other/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/dto/BillingProcessReq.java
@@ -8,6 +8,20 @@ import io.shinhanlife.axhub.biz.mcp.tool.annotation.McpParameter;
 import lombok.Getter;
 import lombok.Setter;
 
+/**
+ * @package io.shinhanlife.axhub.biz.mcp.tool.dto
+ * @className BillingProcessReq
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @Getter
 @Setter
 @Builder
@@ -20,4 +34,4 @@ public class BillingProcessReq {
 
     @McpParameter(description = "심사 승인 여부 (예: APPROVE, REJECT)")
     private String approvalStatus;
-}
+}
\ No newline at end of file
diff --git a/axhub-tool-other/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/dto/BillingStatusReq.java b/axhub-tool-other/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/dto/BillingStatusReq.java
index c4420e6..839d67a 100644
--- a/axhub-tool-other/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/dto/BillingStatusReq.java
+++ b/axhub-tool-other/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/dto/BillingStatusReq.java
@@ -8,6 +8,20 @@ import io.shinhanlife.axhub.biz.mcp.tool.annotation.McpParameter;
 import lombok.Getter;
 import lombok.Setter;
 
+/**
+ * @package io.shinhanlife.axhub.biz.mcp.tool.dto
+ * @className BillingStatusReq
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @Getter
 @Setter
 @Builder
@@ -17,4 +31,4 @@ public class BillingStatusReq {
 
     @McpParameter(description = "조회할 청구 접수 번호", required = true)
     private String billingId;
-}
+}
\ No newline at end of file
diff --git a/axhub-tool-other/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/dto/BondCheckReq.java b/axhub-tool-other/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/dto/BondCheckReq.java
index 0cf03b9..eaceb98 100644
--- a/axhub-tool-other/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/dto/BondCheckReq.java
+++ b/axhub-tool-other/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/dto/BondCheckReq.java
@@ -8,6 +8,20 @@ import io.shinhanlife.axhub.biz.mcp.tool.annotation.McpParameter;
 import lombok.Getter;
 import lombok.Setter;
 
+/**
+ * @package io.shinhanlife.axhub.biz.mcp.tool.dto
+ * @className BondCheckReq
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @Getter
 @Setter
 @Builder
@@ -17,4 +31,4 @@ public class BondCheckReq {
 
     @McpParameter(description = "확인하고자 하는 디지털 증권 발행 금액", required = true)
     private Long amount;
-}
+}
\ No newline at end of file
diff --git a/axhub-tool-other/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/dto/BondIssueReq.java b/axhub-tool-other/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/dto/BondIssueReq.java
index 73a5af7..22e3a6c 100644
--- a/axhub-tool-other/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/dto/BondIssueReq.java
+++ b/axhub-tool-other/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/dto/BondIssueReq.java
@@ -8,6 +8,20 @@ import io.shinhanlife.axhub.biz.mcp.tool.annotation.McpParameter;
 import lombok.Getter;
 import lombok.Setter;
 
+/**
+ * @package io.shinhanlife.axhub.biz.mcp.tool.dto
+ * @className BondIssueReq
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @Getter
 @Setter
 @Builder
@@ -20,4 +34,4 @@ public class BondIssueReq {
 
     @McpParameter(description = "발행 대상 계좌 번호", required = true)
     private String targetAccount;
-}
+}
\ No newline at end of file
diff --git a/axhub-tool-other/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/dto/ContractDetailReq.java b/axhub-tool-other/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/dto/ContractDetailReq.java
index 02e11d5..5e8ab88 100644
--- a/axhub-tool-other/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/dto/ContractDetailReq.java
+++ b/axhub-tool-other/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/dto/ContractDetailReq.java
@@ -8,6 +8,20 @@ import io.shinhanlife.axhub.biz.mcp.tool.annotation.McpParameter;
 import lombok.Getter;
 import lombok.Setter;
 
+/**
+ * @package io.shinhanlife.axhub.biz.mcp.tool.dto
+ * @className ContractDetailReq
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @Getter
 @Setter
 @Builder
@@ -20,4 +34,4 @@ public class ContractDetailReq {
 
     @McpParameter(description = "조회할 계약 번호", required = true)
     private String contractId;
-}
+}
\ No newline at end of file
diff --git a/axhub-tool-other/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/dto/ContractStatusReq.java b/axhub-tool-other/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/dto/ContractStatusReq.java
index 48dc303..9e151ed 100644
--- a/axhub-tool-other/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/dto/ContractStatusReq.java
+++ b/axhub-tool-other/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/dto/ContractStatusReq.java
@@ -8,6 +8,20 @@ import io.shinhanlife.axhub.biz.mcp.tool.annotation.McpParameter;
 import lombok.Getter;
 import lombok.Setter;
 
+/**
+ * @package io.shinhanlife.axhub.biz.mcp.tool.dto
+ * @className ContractStatusReq
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @Getter
 @Setter
 @Builder
@@ -20,4 +34,4 @@ public class ContractStatusReq {
 
     @McpParameter(description = "조회할 계약 번호")
     private String contractId;
-}
+}
\ No newline at end of file
diff --git a/axhub-tool-other/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/dto/CustomerDetailReq.java b/axhub-tool-other/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/dto/CustomerDetailReq.java
index b31dd30..0f2d2ae 100644
--- a/axhub-tool-other/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/dto/CustomerDetailReq.java
+++ b/axhub-tool-other/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/dto/CustomerDetailReq.java
@@ -8,6 +8,20 @@ import io.shinhanlife.axhub.biz.mcp.tool.annotation.McpParameter;
 import lombok.Getter;
 import lombok.Setter;
 
+/**
+ * @package io.shinhanlife.axhub.biz.mcp.tool.dto
+ * @className CustomerDetailReq
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @Getter
 @Setter
 @Builder
@@ -20,4 +34,4 @@ public class CustomerDetailReq {
 
     @McpParameter(description = "고객 식별 번호 (CID)")
     private String customerId;
-}
+}
\ No newline at end of file
diff --git a/axhub-tool-other/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/dto/CustomerGradeReq.java b/axhub-tool-other/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/dto/CustomerGradeReq.java
index a6da11d..8e6dcd0 100644
--- a/axhub-tool-other/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/dto/CustomerGradeReq.java
+++ b/axhub-tool-other/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/dto/CustomerGradeReq.java
@@ -8,6 +8,20 @@ import io.shinhanlife.axhub.biz.mcp.tool.annotation.McpParameter;
 import lombok.Getter;
 import lombok.Setter;
 
+/**
+ * @package io.shinhanlife.axhub.biz.mcp.tool.dto
+ * @className CustomerGradeReq
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @Getter
 @Setter
 @Builder
@@ -20,4 +34,4 @@ public class CustomerGradeReq {
 
     @McpParameter(description = "고객 식별 번호 (CID)")
     private String customerId;
-}
+}
\ No newline at end of file
diff --git a/axhub-tool-other/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/dto/LeaveCountReq.java b/axhub-tool-other/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/dto/LeaveCountReq.java
index d5dae56..a47f822 100644
--- a/axhub-tool-other/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/dto/LeaveCountReq.java
+++ b/axhub-tool-other/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/dto/LeaveCountReq.java
@@ -8,6 +8,20 @@ import io.shinhanlife.axhub.biz.mcp.tool.annotation.McpParameter;
 import lombok.Getter;
 import lombok.Setter;
 
+/**
+ * @package io.shinhanlife.axhub.biz.mcp.tool.dto
+ * @className LeaveCountReq
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @Getter
 @Setter
 @Builder
@@ -17,4 +31,4 @@ public class LeaveCountReq {
 
     @McpParameter(description = "연차 내역을 조회할 사원 번호", required = true)
     private String employeeId;
-}
+}
\ No newline at end of file
diff --git a/axhub-tool-other/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/dto/TemplateDownloadReq.java b/axhub-tool-other/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/dto/TemplateDownloadReq.java
index 128d2a1..f807717 100644
--- a/axhub-tool-other/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/dto/TemplateDownloadReq.java
+++ b/axhub-tool-other/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/dto/TemplateDownloadReq.java
@@ -7,6 +7,20 @@ import lombok.Getter;
 import lombok.NoArgsConstructor;
 import lombok.ToString;
 
+/**
+ * @package io.shinhanlife.axhub.biz.mcp.tool.dto
+ * @className TemplateDownloadReq
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @Getter
 @Builder
 @ToString
@@ -18,4 +32,4 @@ public class TemplateDownloadReq {
      * 다운로드할 템플릿의 종류 ID (예: CUSTOMER_EXCEL, PRODUCT_PDF 등)
      */
     private String templateId;
-}
+}
\ No newline at end of file
diff --git a/axhub-tool-other/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/dto/VacationRegisterReq.java b/axhub-tool-other/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/dto/VacationRegisterReq.java
index 6f58e7a..8f53136 100644
--- a/axhub-tool-other/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/dto/VacationRegisterReq.java
+++ b/axhub-tool-other/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/dto/VacationRegisterReq.java
@@ -8,6 +8,20 @@ import io.shinhanlife.axhub.biz.mcp.tool.annotation.McpParameter;
 import lombok.Getter;
 import lombok.Setter;
 
+/**
+ * @package io.shinhanlife.axhub.biz.mcp.tool.dto
+ * @className VacationRegisterReq
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @Getter
 @Setter
 @Builder
@@ -20,4 +34,4 @@ public class VacationRegisterReq {
 
     @McpParameter(description = "휴가 일자 (YYYY-MM-DD 형식)", required = true)
     private String date;
-}
+}
\ No newline at end of file
diff --git a/axhub-tool-other/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/other/AxHubToolOtherApplication.java b/axhub-tool-other/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/other/AxHubToolOtherApplication.java
index 38cb1ce..b85efe4 100644
--- a/axhub-tool-other/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/other/AxHubToolOtherApplication.java
+++ b/axhub-tool-other/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/other/AxHubToolOtherApplication.java
@@ -4,6 +4,20 @@ import org.springframework.boot.SpringApplication;
 import org.springframework.boot.autoconfigure.SpringBootApplication;
 import org.springframework.cache.annotation.EnableCaching;
 
+/**
+ * @package io.shinhanlife.axhub.biz.mcp.tool.other
+ * @className AxHubToolOtherApplication
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @SpringBootApplication(scanBasePackages = {"io.shinhanlife.axhub.biz.mcp.tool", "io.shinhanlife.axhub.biz.mcp.adapter", "io.shinhanlife.axhub.common.mcp", "io.shinhanlife.axhub.common.config"})
 @org.springframework.boot.context.properties.ConfigurationPropertiesScan(basePackages = {"io.shinhanlife.axhub.biz.mcp.tool", "io.shinhanlife.axhub.biz.mcp.adapter", "io.shinhanlife.axhub.common.mcp", "io.shinhanlife.axhub.common.config"})
 @EnableCaching
@@ -11,4 +25,4 @@ public class AxHubToolOtherApplication {
     public static void main(String[] args) {
         SpringApplication.run(AxHubToolOtherApplication.class, args);
     }
-}
+}
\ No newline at end of file
diff --git a/axhub-tool-other/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/service/BillingProcessService.java b/axhub-tool-other/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/service/BillingProcessService.java
index 9b34919..68d01da 100644
--- a/axhub-tool-other/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/service/BillingProcessService.java
+++ b/axhub-tool-other/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/service/BillingProcessService.java
@@ -13,6 +13,20 @@ import io.shinhanlife.axhub.biz.mcp.tool.dto.BillingProcessReq;
     routingType = "MCI",
     group = "CLAIM"
 )
+/**
+ * @package io.shinhanlife.axhub.biz.mcp.tool.service
+ * @className BillingProcessService
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @lombok.extern.slf4j.Slf4j
 public class BillingProcessService extends AbstractMcpToolService {
 
@@ -50,4 +64,4 @@ public class BillingProcessService extends AbstractMcpToolService {
         }
         return result;
     }
-}
+}
\ No newline at end of file
diff --git a/axhub-tool-other/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/service/BondIssueService.java b/axhub-tool-other/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/service/BondIssueService.java
index 70384ce..5177a8b 100644
--- a/axhub-tool-other/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/service/BondIssueService.java
+++ b/axhub-tool-other/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/service/BondIssueService.java
@@ -9,6 +9,20 @@ import io.shinhanlife.axhub.biz.mcp.tool.dto.BondIssueReq;
     routingType = "EAI",
     group = "POLICY"
 )
+/**
+ * @package io.shinhanlife.axhub.biz.mcp.tool.service
+ * @className BondIssueService
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 public class BondIssueService extends AbstractMcpToolService {
 
     @McpFunction(name = "check", description = "발행 가능 여부 조회", prompt = "디지털 증권 발행 한도가 충분한지 확인해줘.", mappingId = "BOND_001")
@@ -20,4 +34,4 @@ public class BondIssueService extends AbstractMcpToolService {
     public Object issue(BondIssueReq data) {
         return executeLegacy("EAI", "BOND_002", data);
     }
-}
+}
\ No newline at end of file
diff --git a/axhub-tool-other/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/service/CommonUtilityService.java b/axhub-tool-other/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/service/CommonUtilityService.java
index c8d4be3..6b11734 100644
--- a/axhub-tool-other/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/service/CommonUtilityService.java
+++ b/axhub-tool-other/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/service/CommonUtilityService.java
@@ -10,6 +10,20 @@ import io.shinhanlife.axhub.biz.mcp.tool.dto.LeaveCountReq;
     routingType = "HTTP",
     group = "HR"
 )
+/**
+ * @package io.shinhanlife.axhub.biz.mcp.tool.service
+ * @className CommonUtilityService
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 public class CommonUtilityService extends AbstractMcpToolService {
 
     @McpFunction(name = "register_vacation", description = "휴가 등록", prompt = "내일 하루 연차 휴가를 등록해줘.", mappingId = "HR_VAC_01")
@@ -22,4 +36,4 @@ public class CommonUtilityService extends AbstractMcpToolService {
         return executeLegacy("HTTP", "HR_VAC_02", data);
     }
 
-}
+}
\ No newline at end of file
diff --git a/axhub-tool-other/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/service/ContractInquiryService.java b/axhub-tool-other/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/service/ContractInquiryService.java
index d93b9a8..90eaa5e 100644
--- a/axhub-tool-other/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/service/ContractInquiryService.java
+++ b/axhub-tool-other/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/service/ContractInquiryService.java
@@ -9,6 +9,20 @@ import io.shinhanlife.axhub.biz.mcp.tool.dto.ContractDetailReq;
     routingType = "HTTP",
     group = "CONTRACT"
 )
+/**
+ * @package io.shinhanlife.axhub.biz.mcp.tool.service
+ * @className ContractInquiryService
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 public class ContractInquiryService extends AbstractMcpToolService {
 
     @McpFunction(name = "contract_status", description = "계약상태 조회", prompt = "김신한 고객의 현재 계약 상태를 조회해줘.", mappingId = "CNTR_001")
@@ -20,4 +34,4 @@ public class ContractInquiryService extends AbstractMcpToolService {
     public Object getDetail(ContractDetailReq data) {
         return executeLegacy("HTTP", "CNTR_002", data);
     }
-}
+}
\ No newline at end of file
diff --git a/axhub-tool-other/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/service/CustomerInfoService.java b/axhub-tool-other/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/service/CustomerInfoService.java
index e7ceb55..04b6524 100644
--- a/axhub-tool-other/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/service/CustomerInfoService.java
+++ b/axhub-tool-other/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/service/CustomerInfoService.java
@@ -9,6 +9,20 @@ import io.shinhanlife.axhub.biz.mcp.tool.dto.CustomerDetailReq;
     routingType = "TCP",
     group = "CUSTOMER"
 )
+/**
+ * @package io.shinhanlife.axhub.biz.mcp.tool.service
+ * @className CustomerInfoService
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 public class CustomerInfoService extends AbstractMcpToolService {
 
     @McpFunction(name = "grade", description = "고객등급 조회", prompt = "이 고객의 VIP 등급을 조회해줘.", mappingId = "CRM_001")
@@ -20,4 +34,4 @@ public class CustomerInfoService extends AbstractMcpToolService {
     public Object getDetail(CustomerDetailReq data) {
         return executeLegacy("TCP", "CRM_002", data);
     }
-}
+}
\ No newline at end of file
diff --git a/axhub-tool-other/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/service/TemplateUtilityService.java b/axhub-tool-other/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/service/TemplateUtilityService.java
index d20bea5..e1c1680 100644
--- a/axhub-tool-other/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/service/TemplateUtilityService.java
+++ b/axhub-tool-other/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/service/TemplateUtilityService.java
@@ -11,6 +11,20 @@ import java.util.Map;
     routingType = "HTTP",
     group = "COMMON"
 )
+/**
+ * @package io.shinhanlife.axhub.biz.mcp.tool.service
+ * @className TemplateUtilityService
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 public class TemplateUtilityService extends AbstractMcpToolService {
 
     @McpFunction(
@@ -39,4 +53,4 @@ public class TemplateUtilityService extends AbstractMcpToolService {
             throw new RuntimeException("템플릿 URL 생성 실패", e);
         }
     }
-}
+}
\ No newline at end of file
diff --git a/axhub-tool-sms/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/dto/SmsSendReq.java b/axhub-tool-sms/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/dto/SmsSendReq.java
index d7c9be2..a910487 100644
--- a/axhub-tool-sms/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/dto/SmsSendReq.java
+++ b/axhub-tool-sms/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/dto/SmsSendReq.java
@@ -8,6 +8,20 @@ import io.shinhanlife.axhub.biz.mcp.tool.annotation.McpParameter;
 import lombok.Getter;
 import lombok.Setter;
 
+/**
+ * @package io.shinhanlife.axhub.biz.mcp.tool.dto
+ * @className SmsSendReq
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @Getter
 @Setter
 @Builder
@@ -20,4 +34,4 @@ public class SmsSendReq {
 
     @McpParameter(description = "전송할 메시지 내용", required = true)
     private String message;
-}
+}
\ No newline at end of file
diff --git a/axhub-tool-sms/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/sms/AxHubToolSmsApplication.java b/axhub-tool-sms/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/sms/AxHubToolSmsApplication.java
index 3612034..e5974ed 100644
--- a/axhub-tool-sms/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/sms/AxHubToolSmsApplication.java
+++ b/axhub-tool-sms/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/sms/AxHubToolSmsApplication.java
@@ -4,6 +4,20 @@ import org.springframework.boot.SpringApplication;
 import org.springframework.boot.autoconfigure.SpringBootApplication;
 import org.springframework.cache.annotation.EnableCaching;
 
+/**
+ * @package io.shinhanlife.axhub.biz.mcp.tool.sms
+ * @className AxHubToolSmsApplication
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @SpringBootApplication(scanBasePackages = {"io.shinhanlife.axhub.biz.mcp.tool", "io.shinhanlife.axhub.biz.mcp.adapter", "io.shinhanlife.axhub.common.mcp", "io.shinhanlife.axhub.common.config"})
 @org.springframework.boot.context.properties.ConfigurationPropertiesScan(basePackages = {"io.shinhanlife.axhub.biz.mcp.tool", "io.shinhanlife.axhub.biz.mcp.adapter", "io.shinhanlife.axhub.common.mcp", "io.shinhanlife.axhub.common.config"})
 @EnableCaching
@@ -11,4 +25,4 @@ public class AxHubToolSmsApplication {
     public static void main(String[] args) {
         SpringApplication.run(AxHubToolSmsApplication.class, args);
     }
-}
+}
\ No newline at end of file
diff --git a/axhub-tool-sms/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/sms/SmsToolService.java b/axhub-tool-sms/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/sms/SmsToolService.java
index b00af57..d29102c 100644
--- a/axhub-tool-sms/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/sms/SmsToolService.java
+++ b/axhub-tool-sms/src/main/java/io/shinhanlife/axhub/biz/mcp/tool/sms/SmsToolService.java
@@ -9,6 +9,20 @@ import lombok.extern.slf4j.Slf4j;
 import java.util.HashMap;
 import java.util.Map;
 
+/**
+ * @package io.shinhanlife.axhub.biz.mcp.tool.sms
+ * @className SmsToolService
+ * @description AX HUB 시스템 처리 클래스
+ * @author 김형식
+ * @create 2026.09.01
+ * <pre>
+ * ---------- 개정이력 ----------
+ * 수정일      수정자    수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01  김형식    최초생성
+ * 
+ * </pre>
+ */
 @Slf4j
 @McpTool(routingType = "EAI", group = "NOTIFICATION")
 public class SmsToolService extends AbstractMcpToolService {
@@ -32,4 +46,4 @@ public class SmsToolService extends AbstractMcpToolService {
 
         return result;
     }
-}
+}
\ No newline at end of file