forked from kimhyungsik/ax_hub_mcp_tool
73 lines
2.9 KiB
Markdown
73 lines
2.9 KiB
Markdown
# 신한라이프 시스템 도메인 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)로 직접 참조합니다.
|
|
|
|
```text
|
|
workspace/
|
|
├── dat-lib-datmt/ # 공통 라이브러리 (:dat-was-lib)
|
|
└── dat-was-datsy/ # [현재 저장소] 시스템 도메인 Tool Pod (:dat-was-sys)
|
|
```
|
|
|
|
---
|
|
|
|
## 4. 빌드 및 실행 가이드
|
|
|
|
### 컴파일 및 빌드
|
|
```powershell
|
|
.\gradlew.bat compileJava
|
|
```
|
|
|
|
### 단위 테스트 실행
|
|
```powershell
|
|
.\gradlew.bat test
|
|
```
|
|
|
|
### 로컬 애플리케이션 실행
|
|
```powershell
|
|
.\gradlew.bat :dat-was-sys:bootRun
|
|
```
|
|
*기본 활성화 프로파일: `local` (`application-local.yml` 참조)*
|
|
|
|
### 도커 컨테이너 빌드 및 로컬 구동
|
|
```powershell
|
|
docker compose -f docker-compose.local.yml up -d --build
|
|
```
|
|
|