Files
dap-was-dapmt/README.md
2026-09-17 17:31:37 +09:00

2.9 KiB

신한라이프 시스템 도메인 Tool Pod (dat-was-datsy)

신한라이프 DX그룹 PJT MCP & TOOL 파트에서 개발 및 운영하는 시스템(SYS) 도메인 전용 DATMT Tool Service Pod(dat-was-sys)입니다.
IAM(계정·인증·인가 및 담당자 조회)과 PCT(점검 일정, 릴리즈 이력, 시스템 공지사항 등) 영역에서 AI Agent가 시스템 운영 현황을 파악하고 질의응답을 지원할 수 있는 MCP 도구를 제공합니다.


1. 서비스 사양 요약

항목 내용
서비스명 (모듈) dat-was-sys (dat-was-datsy)
서버 포트 8086 (기본)
MCP 엔드포인트 http://localhost:8086/mcp, http://localhost:8086/mcp/message
Swagger UI http://localhost:8086/swagger-ui.html
Bundle ID was-sys
기반 기술 Java 21, Spring Boot 3.5.11, MCP Java SDK 2.0.0
공통 의존성 io.shinhanlife:dat-lib-datmt:0.0.1-SNAPSHOT (dat-was-lib)

2. 제공 MCP 도구 (Tools) 목록

① IAM (Identity & Access Management / 조직)

  • AccountInquiryUseCase: 사번 또는 계정 ID를 통한 사용자/임직원 기본 정보 조회
  • AuthenticationInquiryUseCase: 계정의 2차 인증 상태, 계정 잠김 여부 등 인증 상태 확인
  • AuthorizationInquiryUseCase: 사용자가 보유한 시스템 권한 그룹 및 리소스 접근 인가 현황 조회
  • SystemStatusUseCase: 신한라이프 주요 IT 서비스 및 연계 채널의 실시간 가동 상태 점검
  • TeamContactUseCase: 특정 업무/시스템별 담당 부서, 담당자 및 비상 연락처 조회

② PCT (Process & Change Management / 운영)

  • MaintenanceInquiryUseCase: 예정된 시스템 정기 점검, 서버 패치 및 서비스 중단 일정 조회
  • ReleaseInquiryUseCase: 최근 배포된 시스템 기능 개선 및 릴리즈 이력 정보 조회
  • SystemNoticeUseCase: 전사 시스템 공지사항 및 긴급 장애 공지 내역 조회

3. 공통 라이브러리 연동 (Composite Build)

본 저장소는 상위 워크스페이스의 ../dat-lib-datmt 공통 라이브러리를 로컬 복합 빌드(Composite Build)로 직접 참조합니다.

workspace/
├── dat-lib-datmt/          # 공통 라이브러리 (:dat-was-lib)
└── dat-was-datsy/          # [현재 저장소] 시스템 도메인 Tool Pod (:dat-was-sys)

4. 빌드 및 실행 가이드

컴파일 및 빌드

.\gradlew.bat compileJava

단위 테스트 실행

.\gradlew.bat test

로컬 애플리케이션 실행

.\gradlew.bat :dat-was-sys:bootRun

기본 활성화 프로파일: local (application-local.yml 참조)

도커 컨테이너 빌드 및 로컬 구동

docker compose -f docker-compose.local.yml up -d --build