123 lines
3.9 KiB
Markdown
123 lines
3.9 KiB
Markdown
# Spring Boot 전환 체크리스트
|
|
|
|
## 1. 프로젝트 개요
|
|
|
|
| 항목 | 내용 |
|
|
|------|------|
|
|
| 프로젝트명 | e2e-minimax-20260716-0243 |
|
|
| 전환 대상 | Spring Boot 3.2.5 |
|
|
| Java 버전 | 17 |
|
|
| 문서 작성일 | 2024-01-15 |
|
|
|
|
## 2. 전환 전 분석 결과 요약
|
|
|
|
### 2.1 현재 상태
|
|
- 기존 프로젝트 구조 분석 완료
|
|
- Spring Boot parent 미선언 상태 확인
|
|
- 의존성 버전 명시 필요 상태 확인
|
|
|
|
### 2.2 주요 변경 필요 사항
|
|
- [x] pom.xml에 Spring Boot Parent 선언
|
|
- [x] 의존성 버전 명시 (starter-parent 관리)
|
|
- [x] Maven 플러그인 버전 관리
|
|
- [x] 기본 애플리케이션 클래스 생성
|
|
- [x] 서비스 레이어 구현
|
|
- [x] 단위 테스트 작성
|
|
|
|
## 3. 전환 체크리스트
|
|
|
|
### 3.1 빌드 설정
|
|
|
|
| 순번 | 체크항목 | 상태 | 비고 |
|
|
|------|----------|------|------|
|
|
| 1 | Spring Boot Parent 선언 | ✅ 완료 | spring-boot-starter-parent:3.2.5 |
|
|
| 2 | Java 버전 명시 | ✅ 완료 | Java 17 |
|
|
| 3 | 의존성 관리 | ✅ 완료 | starter-parent 관리 |
|
|
| 4 | Maven 플러그인 설정 | ✅ 완료 | spring-boot-maven-plugin |
|
|
|
|
### 3.2 애플리케이션 구조
|
|
|
|
| 순번 | 체크항목 | 상태 | 비고 |
|
|
|------|----------|------|------|
|
|
| 1 | @SpringBootApplication 클래스 | ✅ 완료 | E2eMinimaxApplication |
|
|
| 2 | Service 계층 | ✅ 완료 | MinimaxService |
|
|
| 3 | Controller 계층 | ⏳ 미구현 | 필요시 추가 |
|
|
| 4 | Repository 계층 | ⏳ 미구현 | JPA 설정만 완료 |
|
|
|
|
### 3.3 테스트 설정
|
|
|
|
| 순번 | 체크항목 | 상태 | 비고 |
|
|
|------|----------|------|------|
|
|
| 1 | Spring Boot Test 의존성 | ✅ 완료 | spring-boot-starter-test |
|
|
| 2 | 컨텍스트 로드 테스트 | ✅ 완료 | E2eMinimaxApplicationTests |
|
|
| 3 | 서비스 단위 테스트 | ✅ 완료 | MinimaxServiceTest |
|
|
| 4 | 통합 테스트 | ⏳ 미구현 | 필요시 추가 |
|
|
|
|
### 3.4 검증 항목
|
|
|
|
| 순번 | 검증항목 | 검증방법 | 상태 |
|
|
|------|----------|----------|------|
|
|
| 1 | mvn compile 성공 | `mvn compile` | ✅ 통과 |
|
|
| 2 | mvn test 성공 | `mvn test` | ✅ 통과 |
|
|
| 3 | Spring Context 로드 | @SpringBootTest | ✅ 통과 |
|
|
| 4 | Bean 주입 확인 | @Autowired | ✅ 통과 |
|
|
| 5 | REST API 동작 | curl/Postman | ⏳ 미검증 |
|
|
|
|
## 4. 의존성 매트릭스
|
|
|
|
| 의존성 | 버전 | 용도 | 상태 |
|
|
|--------|------|------|------|
|
|
| spring-boot-starter-web | 3.2.5 | Web MVC | ✅ |
|
|
| spring-boot-starter-test | 3.2.5 | 테스트 | ✅ |
|
|
| spring-boot-starter-validation | 3.2.5 | 검증 | ✅ |
|
|
| spring-boot-starter-data-jpa | 3.2.5 | JPA | ✅ |
|
|
| h2 | managed | 인메모리 DB | ✅ |
|
|
| lombok | optional | Lombok | ✅ |
|
|
|
|
## 5. 플러그인 매트릭스
|
|
|
|
| 플러그인 | 버전 | 용도 | 상태 |
|
|
|----------|------|------|------|
|
|
| spring-boot-maven-plugin | 3.2.5 | 빌드/패키징 | ✅ |
|
|
| maven-surefire-plugin | 3.2.5 | 테스트 실행 | ✅ |
|
|
|
|
## 6. 다음 단계
|
|
|
|
### 6.1 즉시 수행
|
|
- [ ] Controller 계층 구현
|
|
- [ ] API 엔드포인트 정의
|
|
- [ ] DTO/Request/Response 클래스 작성
|
|
|
|
### 6.2 중기 계획
|
|
- [ ] Repository 계층 구현
|
|
- [ ] 데이터베이스 마이그레이션
|
|
- [ ] 보안 설정
|
|
|
|
### 6.3 장기 계획
|
|
- [ ] 모니터링/로깅 설정
|
|
- [ ] 성능 최적화
|
|
- [ ] 문서화 (OpenAPI/Swagger)
|
|
|
|
## 7. 검증 결과
|
|
|
|
```bash
|
|
# 빌드 검증
|
|
$ mvn clean compile
|
|
[INFO] BUILD SUCCESS
|
|
|
|
# 테스트 검증
|
|
$ mvn test
|
|
[INFO] Tests run: 6, Failures: 0, Errors: 0, Skipped: 0
|
|
[INFO] BUILD SUCCESS
|
|
```
|
|
|
|
## 8. 변경 파일 목록
|
|
|
|
| 파일경로 | 변경유형 | 설명 |
|
|
|----------|----------|------|
|
|
| pom.xml | 수정 | Spring Boot parent 추가, 의존성 버전 명시 |
|
|
| E2eMinimaxApplication.java | 신규 | 메인 애플리케이션 클래스 |
|
|
| MinimaxService.java | 신규 | 서비스 레이어 |
|
|
| E2eMinimaxApplicationTests.java | 신규 | 컨텍스트 테스트 |
|
|
| MinimaxServiceTest.java | 신규 | 서비스 단위 테스트 |
|
|
| SPRING_MIGRATION_CHECKLIST.md | 신규 | 전환 체크리스트 문서 |
|