refactor: massive rename dap -> dat and fix scaffold syntax error
Some checks failed
Deploy to OCIWP / deploy (push) Failing after 14s
Some checks failed
Deploy to OCIWP / deploy (push) Failing after 14s
This commit is contained in:
@@ -4,7 +4,7 @@
|
||||
|
||||
이 문서는 AX HUB의 **Tool Pod 개발자**가 로컬 PC와 신한라이프 내부망에서 동일한 방식으로 소스를 빌드하고 실행하기 위한 기준을 정리한다.
|
||||
|
||||
이 문서의 범위는 `dap-was-lib`와 Tool Pod(`dap-was-cus`, `dap-was-sal`, `dap-was-pro`, `dap-was-sys`)이다. 외부 라우팅 계층의 구성과 운영 방법은 다루지 않는다.
|
||||
이 문서의 범위는 `dat-was-lib`와 Tool Pod(`dat-was-cus`, `dat-was-sal`, `dat-was-pro`, `dat-was-sys`)이다. 외부 라우팅 계층의 구성과 운영 방법은 다루지 않는다.
|
||||
|
||||
## 2. 기준 기술 환경
|
||||
|
||||
@@ -26,23 +26,23 @@
|
||||
|
||||
| 모듈 | 기본 포트 | 역할 |
|
||||
|---|---:|---|
|
||||
| `dap-was-lib` | 해당 없음 | MCP 서버 설정, Tool 탐색·실행, Schema, V17 메타데이터, MCI·HTTP 연동, 공통 로그·헤더 처리 |
|
||||
| `dap-was-cus` | 8084 | 고객 관련 Tool Pod |
|
||||
| `dap-was-sal` | 8082 | 영업 관련 Tool Pod |
|
||||
| `dap-was-pro` | 8085 | 상품 관련 Tool Pod |
|
||||
| `dap-was-sys` | 8086 | 시스템 관련 Tool Pod |
|
||||
| `dat-was-lib` | 해당 없음 | MCP 서버 설정, Tool 탐색·실행, Schema, V17 메타데이터, MCI·HTTP 연동, 공통 로그·헤더 처리 |
|
||||
| `dat-was-cus` | 8084 | 고객 관련 Tool Pod |
|
||||
| `dat-was-sal` | 8082 | 영업 관련 Tool Pod |
|
||||
| `dat-was-pro` | 8085 | 상품 관련 Tool Pod |
|
||||
| `dat-was-sys` | 8086 | 시스템 관련 Tool Pod |
|
||||
|
||||
각 실행 모듈은 `dap-was-lib`를 의존하고 다음 패키지를 스캔한다.
|
||||
각 실행 모듈은 `dat-was-lib`를 의존하고 다음 패키지를 스캔한다.
|
||||
|
||||
```java
|
||||
@SpringBootApplication(scanBasePackages = {
|
||||
"io.shinhanlife.dap.mcc",
|
||||
"io.shinhanlife.dap.lib"
|
||||
"io.shinhanlife.dat.mcc",
|
||||
"io.shinhanlife.dat.lib"
|
||||
})
|
||||
@Import(ToolMcpServerConfiguration.class)
|
||||
```
|
||||
|
||||
따라서 업무 Tool은 `io.shinhanlife.dap.mcc` 아래에, 공통 기능은 `io.shinhanlife.dap.lib` 아래에 둔다.
|
||||
따라서 업무 Tool은 `io.shinhanlife.dat.mcc` 아래에, 공통 기능은 `io.shinhanlife.dat.lib` 아래에 둔다.
|
||||
|
||||
## 4. 개발 PC 준비
|
||||
|
||||
@@ -102,7 +102,7 @@ spring:
|
||||
|
||||
```powershell
|
||||
$env:SPRING_PROFILES_ACTIVE = "local"
|
||||
.\gradlew.bat :dap-was-cus:bootRun
|
||||
.\gradlew.bat :dat-was-cus:bootRun
|
||||
```
|
||||
|
||||
또는 IntelliJ Run Configuration의 `Active profiles`에 `local`을 입력한다.
|
||||
@@ -128,22 +128,22 @@ $env:SPRING_PROFILES_ACTIVE = "local"
|
||||
### 7.1 공통 라이브러리 검증
|
||||
|
||||
```powershell
|
||||
.\gradlew.bat :dap-was-lib:clean :dap-was-lib:test
|
||||
.\gradlew.bat :dat-was-lib:clean :dat-was-lib:test
|
||||
```
|
||||
|
||||
### 7.2 Tool Pod 컴파일
|
||||
|
||||
```powershell
|
||||
.\gradlew.bat :dap-was-cus:compileJava
|
||||
.\gradlew.bat :dap-was-sal:compileJava
|
||||
.\gradlew.bat :dap-was-pro:compileJava
|
||||
.\gradlew.bat :dap-was-sys:compileJava
|
||||
.\gradlew.bat :dat-was-cus:compileJava
|
||||
.\gradlew.bat :dat-was-sal:compileJava
|
||||
.\gradlew.bat :dat-was-pro:compileJava
|
||||
.\gradlew.bat :dat-was-sys:compileJava
|
||||
```
|
||||
|
||||
### 7.3 Tool Pod 실행
|
||||
|
||||
```powershell
|
||||
.\gradlew.bat :dap-was-cus:bootRun
|
||||
.\gradlew.bat :dat-was-cus:bootRun
|
||||
```
|
||||
|
||||
실행 후 확인할 Tool Pod 자체 주소는 다음과 같다.
|
||||
@@ -186,7 +186,7 @@ $env:SPRING_PROFILES_ACTIVE = "local"
|
||||
- [ ] `java -version`이 21이다.
|
||||
- [ ] Gradle JVM이 JDK 21이다.
|
||||
- [ ] `gradlew.bat --version`이 정상 실행된다.
|
||||
- [ ] `:dap-was-lib:test`가 성공한다.
|
||||
- [ ] `:dat-was-lib:test`가 성공한다.
|
||||
- [ ] 대상 Tool Pod의 `compileJava`가 성공한다.
|
||||
- [ ] local 프로파일로 Tool Pod가 기동된다.
|
||||
- [ ] `/tool-manifest`에서 Tool 목록이 조회된다.
|
||||
|
||||
@@ -42,7 +42,7 @@ ins_insurance_processor
|
||||
## 3. 업무 패키지 구조
|
||||
|
||||
```text
|
||||
io.shinhanlife.dap.mcc
|
||||
io.shinhanlife.dat.mcc
|
||||
├─ biz.{category}
|
||||
│ ├─ dto
|
||||
│ ├─ converter
|
||||
|
||||
@@ -6,11 +6,11 @@
|
||||
|
||||
대상은 다음 Tool 모듈이다.
|
||||
|
||||
- `dap-was-cus`
|
||||
- `dap-was-sal`
|
||||
- `dap-was-pro`
|
||||
- `dap-was-sys`
|
||||
- 공통 기능이 필요한 경우 `dap-was-lib`
|
||||
- `dat-was-cus`
|
||||
- `dat-was-sal`
|
||||
- `dat-was-pro`
|
||||
- `dat-was-sys`
|
||||
- 공통 기능이 필요한 경우 `dat-was-lib`
|
||||
|
||||
## 2. 개발 전 준비 자료
|
||||
|
||||
@@ -52,7 +52,7 @@ Scaffold 입력 시 최소한 다음 값을 정확히 지정한다.
|
||||
|
||||
| 항목 | 예시 | 설명 |
|
||||
|---|---|---|
|
||||
| Target Module | `dap-was-sal` | 소스가 생성될 Tool Pod |
|
||||
| Target Module | `dat-was-sal` | 소스가 생성될 Tool Pod |
|
||||
| Domain Category | `cmm` | 업무 패키지 및 Schema 경로 |
|
||||
| Base Name | `ClaimSearch` | Java 클래스명 기준 |
|
||||
| Tool Name | `cmm_claim_search` | MCP Tool 식별자 |
|
||||
@@ -265,10 +265,10 @@ http://localhost:{podPort}/tool-test-console.html
|
||||
|
||||
```powershell
|
||||
# 공통 단위 테스트
|
||||
.\gradlew.bat :dap-was-lib:test
|
||||
.\gradlew.bat :dat-was-lib:test
|
||||
|
||||
# 대상 Pod 테스트
|
||||
.\gradlew.bat :dap-was-cus:test
|
||||
.\gradlew.bat :dat-was-cus:test
|
||||
|
||||
# Tool명 중복
|
||||
.\gradlew.bat validateMcpToolNames
|
||||
@@ -277,7 +277,7 @@ http://localhost:{podPort}/tool-test-console.html
|
||||
.\gradlew.bat validateToolSchemaV17
|
||||
|
||||
# 배포 산출물 생성: 위 두 검증이 자동 선행됨
|
||||
.\gradlew.bat :dap-was-cus:bootJar
|
||||
.\gradlew.bat :dat-was-cus:bootJar
|
||||
```
|
||||
|
||||
Docker는 컴파일과 일반 단위 테스트에 필요하지 않다. 실제 HTTP/MCI Mock 컨테이너를 사용하는 연계 테스트에서만 실행한다.
|
||||
|
||||
Reference in New Issue
Block a user