forge-bot/e2e-minimax-20260716-0243
1
0
Fork 0
Code Issues Pull requests 2 Projects Releases Packages Wiki Activity Actions
e2e-minimax-20260716-0243/SPRING_MIGRATION_CHECKLIST.md

3.9 KiB
Raw Permalink Blame History

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 주요 변경 필요 사항

  • pom.xml에 Spring Boot Parent 선언
  • 의존성 버전 명시 (starter-parent 관리)
  • Maven 플러그인 버전 관리
  • 기본 애플리케이션 클래스 생성
  • 서비스 레이어 구현
  • 단위 테스트 작성

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. 검증 결과

# 빌드 검증
$ 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 신규 전환 체크리스트 문서