docs: Add standard Javadoc comments to all Java source files

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);
+    }
+}

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

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 {

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"})

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

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

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 {
 

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 {
 

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

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 {

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

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 {

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 {
 

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 {
 

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 {
 

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 {

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 {

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 {
 

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

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<>();
 }
-

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 {
 

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)

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 {
 

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 {
 
     /**

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 {

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

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

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)

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

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

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";

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")

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

axhub-common/src/main/java/io/shinhanlife/glow/BizException.java

@@ -1,5 +1,19 @@
 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) {
     }

axhub-common/src/main/java/io/shinhanlife/glow/GlowLogTarget.java

@@ -9,6 +9,20 @@ 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
     }

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 {

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)

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 {

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() {

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

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

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

axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/mcp/gateway/config/GatewayFallbackProperties.java

@@ -7,6 +7,20 @@ 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")

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 {
 

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

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 {
 

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")

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

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;
     }
 }
-

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

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

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

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

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 {
 

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 {
 

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);

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 {

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

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

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

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

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

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

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

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

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

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 {

axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/so/atm/presentation/io/AthrSearchRequest.java

@@ -3,6 +3,20 @@ 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 {

axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/so/atm/presentation/io/AthrSearchResponse.java

@@ -6,6 +6,20 @@ 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 {

axhub-gateway/src/main/java/io/shinhanlife/axhub/biz/so/atm/presentation/io/RoleListRequest.java

@@ -3,6 +3,20 @@ 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 {

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);

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 {

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 {
 

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

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 {
 

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

@@ -5,6 +5,20 @@ 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);

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 {

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

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

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

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
 

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)

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)

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)

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)

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

@@ -5,6 +5,20 @@ 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);

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")

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

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 {

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 {

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

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

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

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

axhub-tool-core/src/main/java/io/shinhanlife/axhub/biz/mcp/adapter/sender/EimsSender.java

@@ -1,5 +1,19 @@
 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;

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 {

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 {

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 {

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 {

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 {