Compare commits

...
Sign in to create a new pull request.

9 commits

9 changed files with 527 additions and 0 deletions

View file

@ -0,0 +1,3 @@
# iss-cb35afc33813-attempt-1-run-99962f6ffe39
Forge 이슈 작업 브랜치 `forge/iss-cb35afc33813-attempt-1-run-99962f6ffe39`.

52
MIGRATION_CHECKLIST.md Normal file
View file

@ -0,0 +1,52 @@
# 스프링 전환 체크리스트
## Phase 1: 기반 구축 (4주)
- [x] Maven 멀티 모듈 구조 설계
- [x] 부모 POM 생성
- [x] 모듈별 POM 생성
- [x] 메인 애플리케이션 클래스 생성
- [x] 기본 Configuration 설정
- [x] JUnit 5, Mockito 테스트 환경 설정
- [ ] 프로파일별 설정 분리
- [ ] CI/CD 파이프라인 설정
## Phase 2: 모듈 전환 (8주)
- [ ] 기존 DAO → Spring Data JPA 변환
- [ ] Entity 매핑 검토
- [ ] Query 메서드 정의
- [ ] 비즈니스 로직 마이그레이션
- [ ] @Transactional 적용
- [ ] REST API 설계
- [ ] DTO/VO 매핑
- [ ] 유효성 검증 설정
## Phase 3: 인프라 연동 (4주)
- [ ] Spring Security 설정
- [ ] 인증/인가 구현
- [ ] Actuator endpoints 설정
- [ ] 커스텀 메트릭스
- [ ] SLF4J + Logback 설정
- [ ] 로그 패턴 정의
## Phase 4: 검증 및 배포 (4주)
- [ ] 단위 테스트 작성 (90% 커버리지)
- [ ] 통합 테스트 작성
- [ ] E2E 테스트 작성
- [ ] API 문서 생성 (SpringDoc)
- [ ] Docker 이미지 빌드
- [ ] 배포 파이프라인
## 전환 진행 현황
| Phase | 상태 | 완료일 |
|-------|------|--------|
| Phase 1 | 진행중 | - |
| Phase 2 | 대기 | - |
| Phase 3 | 대기 | - |
| Phase 4 | 대기 | - |
## 검증 기준
- 단위 테스트 통과 (90% 이상 커버리지)
- 통합 테스트 통과
- 성능 벤치마크 기존 대비 95% 이상 유지
- API 호환성 100% 유지

138
SPRING_TRANSITION_PLAN.md Normal file
View file

@ -0,0 +1,138 @@
# 스프링 프레임워크 전환 계획
## 1. 개요
### 1.1 목적
본 문서는 기존 런타임 시스템을 스프링 프레임워크 기반으로 전환하기 위한 종합적인 마이그레이션 전략을 정의합니다.
### 1.2 현재 시스템 분석
| 구분 | 현재 상태 |
|------|----------|
| 프레임워크 | 커스텀 런타임 |
| 의존성 관리 | 수동 관리 |
| 설정 방식 | XML 기반 |
| 모듈화 | 제한적 |
| 테스트 지원 | 기본 수준 |
### 1.3 전환 목표
- 스프링 부트 3.x 기반 모던 아키텍처 도입
- 마이크로서비스 패턴 적용
- 자동 구성 및 의존성 주입 활용
- 통합 테스트 및 단위 테스트覆盖率 향상
- CI/CD 파이프라인 간소화
## 2. 타겟 아키텍처
### 2.1 스프링 부트 3.x 기반 계층 구조
```
┌─────────────────────────────────────────────────────────┐
│ Presentation Layer │
│ (Spring MVC / WebFlux) │
├─────────────────────────────────────────────────────────┤
│ Service Layer │
│ (Spring Business Logic) │
├─────────────────────────────────────────────────────────┤
│ Repository Layer │
│ (Spring Data JPA) │
├─────────────────────────────────────────────────────────┤
│ Infrastructure │
│ (Spring Security, Configuration, Actuator) │
└─────────────────────────────────────────────────────────┘
```
### 2.2 핵심 의존성
| 카테고리 | 라이브러리 | 버전 |
|----------|-----------|------|
| Core | spring-boot-starter | 3.2.x |
| Web | spring-boot-starter-web | 3.2.x |
| Data | spring-boot-starter-data-jpa | 3.2.x |
| Security | spring-boot-starter-security | 3.2.x |
| Validation | spring-boot-starter-validation | 3.2.x |
| Test | spring-boot-starter-test | 3.2.x |
### 2.3 모듈 구조
```
spring-runtime/
├── spring-runtime-core/ # 공통 유틸리티, 공통 설정
├── spring-runtime-api/ # REST API 모듈
├── spring-runtime-service/ # 비즈니스 로직 모듈
├── spring-runtime-repository/ # 데이터 접근 모듈
└── spring-runtime-starter/ # 메인 애플리케이션
```
## 3. 마이그레이션 전략
### 3.1 4단계 전환 계획
#### Phase 1: 기반 구축 (4주)
| 작업 항목 | 설명 |
|----------|------|
| 프로젝트 구조 설계 | Maven 멀티 모듈 구조 |
| 스프링 부트 코어 설정 | Application, Configuration |
| 의존성 마이그레이션 | 기존 JAR → Spring BOM |
| 기본 테스트 환경 | JUnit 5, Mockito 설정 |
#### Phase 2: 모듈 전환 (8주)
| 작업 항목 | 설명 |
|----------|------|
| Repository → Spring Data | JPA Entity, Repository 변환 |
| Service 계층 전환 | @Service, @Transactional 적용 |
| Controller 전환 | @RestController 적용 |
| 설정 마이그레이션 | application.yml/properties |
#### Phase 3: 인프라 연동 (4주)
| 작업 항목 | 설명 |
|----------|------|
| Security 적용 | Spring Security 설정 |
| 예외 처리 | @ControllerAdvice |
| 로깅 전환 | SLF4J + Logback |
| Actuator 연동 | 모니터링 설정 |
#### Phase 4: 검증 및 배포 (4주)
| 작업 항목 | 설명 |
|----------|------|
| 통합 테스트 | @SpringBootTest |
| 성능 테스트 | JMeter, Gatling |
| 문서화 | SpringDoc OpenAPI |
| 배포 파이프라인 | CI/CD 설정 |
### 3.2 전환 매핑 테이블
| 기존 구성 | 스프링 전환 대상 | 어노테이션/설정 |
|-----------|-----------------|----------------|
| XML Config | Java Config | @Configuration |
| 수동 Bean | @Bean / @Component | @ComponentScan |
| new 키워드 | 의존성 주입 | @Autowired, @Inject |
| JDBC Template | JdbcTemplate / JPA | Spring Data |
| 서블릿 필터 | Filter | @Filter |
## 4. 리스크 관리
| 리스크 | 영향도 | 완화 전략 |
|--------|--------|----------|
| 의존성 충돌 | 높음 | BOM 사용, 호환성 테스트 |
| 성능 저하 | 중간 | 프로파일링, 최적화 |
| 데이터 손실 | 심각 | 백업, 점진적 전환 |
| 테스트 커버리지 부족 | 중간 | TDD 적용, 자동화 테스트 |
## 5. 검증 기준
- [ ] 모든 단위 테스트 통과 (90% 이상 커버리지)
- [ ] 통합 테스트 통과
- [ ] 성능 벤치마크 기존 대비 95% 이상 유지
- [ ] API 호환성 100% 유지
## 6. 일정 요약
```
Week 1-4: Phase 1 - 기반 구축
Week 5-12: Phase 2 - 모듈 전환
Week 13-16: Phase 3 - 인프라 연동
Week 17-20: Phase 4 - 검증 및 배포
```
**총 예상 기간: 20주**

61
spring-runtime/pom.xml Normal file
View file

@ -0,0 +1,61 @@
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<parent>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-parent</artifactId>
<version>3.2.5</version>
<relativePath/>
</parent>
<groupId>com.runtime</groupId>
<artifactId>spring-runtime</artifactId>
<version>1.0.0-SNAPSHOT</version>
<packaging>pom</packaging>
<name>Spring Runtime Parent</name>
<description>스프링 프레임워크 전환 부모 POM</description>
<modules>
<module>spring-runtime-core</module>
<module>spring-runtime-api</module>
<module>spring-runtime-service</module>
<module>spring-runtime-repository</module>
<module>spring-runtime-starter</module>
</modules>
<properties>
<java.version>17</java.version>
<maven.compiler.source>17</maven.compiler.source>
<maven.compiler.target>17</maven.compiler.target>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
</properties>
<dependencyManagement>
<dependencies>
<dependency>
<groupId>com.runtime</groupId>
<artifactId>spring-runtime-core</artifactId>
<version>${project.version}</version>
</dependency>
<dependency>
<groupId>com.runtime</groupId>
<artifactId>spring-runtime-api</artifactId>
<version>${project.version}</version>
</dependency>
<dependency>
<groupId>com.runtime</groupId>
<artifactId>spring-runtime-service</artifactId>
<version>${project.version}</version>
</dependency>
<dependency>
<groupId>com.runtime</groupId>
<artifactId>spring-runtime-repository</artifactId>
<version>${project.version}</version>
</dependency>
</dependencies>
</dependencyManagement>
</project>

View file

@ -0,0 +1,39 @@
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<parent>
<groupId>com.runtime</groupId>
<artifactId>spring-runtime</artifactId>
<version>1.0.0-SNAPSHOT</version>
</parent>
<artifactId>spring-runtime-core</artifactId>
<packaging>jar</packaging>
<name>Spring Runtime Core</name>
<description>스프링 런타임 공통 코어 모듈</description>
<dependencies>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-validation</artifactId>
</dependency>
<dependency>
<groupId>org.projectlombok</groupId>
<artifactId>lombok</artifactId>
<optional>true</optional>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-test</artifactId>
<scope>test</scope>
</dependency>
</dependencies>
</project>

View file

@ -0,0 +1,95 @@
package com.runtime.core.exception;
import org.springframework.http.HttpStatus;
import org.springframework.http.ResponseEntity;
import org.springframework.validation.FieldError;
import org.springframework.web.bind.MethodArgumentNotValidException;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.RestControllerAdvice;
import java.time.LocalDateTime;
import java.util.HashMap;
import java.util.Map;
/**
* 전역 예외 처리 핸들러
*/
@RestControllerAdvice
public class GlobalExceptionHandler {
@ExceptionHandler(BusinessException.class)
public ResponseEntity<ErrorResponse> handleBusinessException(BusinessException ex) {
ErrorResponse error = ErrorResponse.builder()
.timestamp(LocalDateTime.now())
.status(ex.getStatus().value())
.error(ex.getErrorCode())
.message(ex.getMessage())
.build();
return ResponseEntity.status(ex.getStatus()).body(error);
}
@ExceptionHandler(MethodArgumentNotValidException.class)
public ResponseEntity<ErrorResponse> handleValidationException(MethodArgumentNotValidException ex) {
Map<String, String> errors = new HashMap<>();
ex.getBindingResult().getAllErrors().forEach(error -> {
String fieldName = ((FieldError) error).getField();
String errorMessage = error.getDefaultMessage();
errors.put(fieldName, errorMessage);
});
ErrorResponse error = ErrorResponse.builder()
.timestamp(LocalDateTime.now())
.status(HttpStatus.BAD_REQUEST.value())
.error("VALIDATION_ERROR")
.message("입력 검증에 실패했습니다")
.validationErrors(errors)
.build();
return ResponseEntity.badRequest().body(error);
}
@ExceptionHandler(Exception.class)
public ResponseEntity<ErrorResponse> handleGenericException(Exception ex) {
ErrorResponse error = ErrorResponse.builder()
.timestamp(LocalDateTime.now())
.status(HttpStatus.INTERNAL_SERVER_ERROR.value())
.error("INTERNAL_ERROR")
.message("예상치 못한 오류가 발생했습니다")
.build();
return ResponseEntity.internalServerError().body(error);
}
}
/**
* 비즈니스 예외 기본 클래스
*/
class BusinessException extends RuntimeException {
private final HttpStatus status;
private final String errorCode;
public BusinessException(String message, HttpStatus status, String errorCode) {
super(message);
this.status = status;
this.errorCode = errorCode;
}
public BusinessException(String message, HttpStatus status) {
this(message, status, "BUSINESS_ERROR");
}
public HttpStatus getStatus() { return status; }
public String getErrorCode() { return errorCode; }
}
/**
* 표준 에러 응답 DTO
*/
@lombok.Data
@lombok.Builder
@lombok.AllArgsConstructor
@lombok.NoArgsConstructor
class ErrorResponse {
private LocalDateTime timestamp;
private int status;
private String error;
private String message;
private Map<String, String> validationErrors;
}

View file

@ -0,0 +1,80 @@
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<parent>
<groupId>com.runtime</groupId>
<artifactId>spring-runtime</artifactId>
<version>1.0.0-SNAPSHOT</version>
</parent>
<artifactId>spring-runtime-starter</artifactId>
<packaging>jar</packaging>
<name>Spring Runtime Starter</name>
<description>스프링 런타임 메인 애플리케이션</description>
<dependencies>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-data-jpa</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-security</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-validation</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-actuator</artifactId>
</dependency>
<dependency>
<groupId>com.runtime</groupId>
<artifactId>spring-runtime-core</artifactId>
</dependency>
<dependency>
<groupId>com.runtime</groupId>
<artifactId>spring-runtime-api</artifactId>
</dependency>
<dependency>
<groupId>com.runtime</groupId>
<artifactId>spring-runtime-service</artifactId>
</dependency>
<dependency>
<groupId>com.runtime</groupId>
<artifactId>spring-runtime-repository</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-test</artifactId>
<scope>test</scope>
</dependency>
<dependency>
<groupId>com.h2database</groupId>
<artifactId>h2</artifactId>
<scope>test</scope>
</dependency>
</dependencies>
<build>
<plugins>
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
</plugin>
</plugins>
</build>
</project>

View file

@ -0,0 +1,18 @@
package com.runtime;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.transaction.annotation.EnableTransactionManagement;
/**
* 스프링 런타임 메인 애플리케이션
* 스프링 부트 3.x 기반 런타임 시스템의 진입점
*/
@SpringBootApplication
@EnableTransactionManagement
public class SpringRuntimeApplication {
public static void main(String[] args) {
SpringApplication.run(SpringRuntimeApplication.class, args);
}
}

View file

@ -0,0 +1,41 @@
# 스프링 런타임 애플리케이션 설정
spring:
application:
name: spring-runtime
datasource:
url: jdbc:h2:mem:springruntime;DB_CLOSE_DELAY=-1
driver-class-name: org.h2.Driver
username: sa
password:
jpa:
hibernate:
ddl-auto: update
show-sql: true
properties:
hibernate:
format_sql: true
dialect: org.hibernate.dialect.H2Dialect
h2:
console:
enabled: true
path: /h2-console
server:
port: 8080
servlet:
context-path: /api
management:
endpoints:
web:
exposure:
include: health,info,metrics
endpoint:
health:
show-details: always
logging:
level:
com.runtime: DEBUG
org.springframework.web: INFO
org.hibernate.SQL: DEBUG