# 신한라이프 시스템 도메인 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
```