docs: Add standard Javadoc comments to all Java source files

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

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 {
             }
         }
     }
-}
+}

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

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
@@ -52,4 +66,4 @@ public class KillSwitchController {
             "target", target
         ));
     }
-}
+}

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

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

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
@@ -80,4 +94,4 @@ public class RedisRegistryService {
         redisTemplate.delete(KEY_PREFIX + toolName);
         log.info(" [RedisRegistry] 툴 삭제 완료: {}", toolName);
     }
-}
+}

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
@@ -54,4 +68,4 @@ public class KillSwitchService {
         stringRedisTemplate.delete(key);
         log.info(" [KillSwitch] 차단 키 완전 삭제: {} -> {}", type, target);
     }
-}
+}

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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)
@@ -17,4 +31,4 @@ public class AppliSystNtfyPatiRequest {
     private String ntfyTrgtPrafNo;
     private String shmsPmlYn;
     private String ntfyCfmYn;
-}
+}

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

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

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

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