66 lines
1.9 KiB
Markdown
66 lines
1.9 KiB
Markdown
|
# 프로젝트 개요
|
||
|
|
|
||
|
|
- **타입**: Java + Spring Boot + Maven
|
||
|
|
- **JDK**: 17 (`.sdkmanrc` 참조)
|
||
|
|
- **프레임워크**: Spring Boot
|
||
|
|
- **빌드 도구**: Maven (Maven Wrapper 사용)
|
||
|
|
|
||
|
|
## 빌드 및 실행
|
||
|
|
|
||
|
|
```bash
|
||
|
|
# 빌드
|
||
|
|
./mvnw clean compile
|
||
|
|
|
||
|
|
# 패키징
|
||
|
|
./mvnw clean package -DskipTests
|
||
|
|
|
||
|
|
# 테스트
|
||
|
|
./mvnw test
|
||
|
|
|
||
|
|
# 특정 테스트 클래스 실행
|
||
|
|
./mvnw test -Dtest=클래스명
|
||
|
|
|
||
|
|
# 로컬 실행
|
||
|
|
./mvnw spring-boot:run
|
||
|
|
|
||
|
|
# 린트 (Checkstyle 설정된 경우)
|
||
|
|
./mvnw checkstyle:check
|
||
|
|
```
|
||
|
|
|
||
|
|
## 프로젝트 구조
|
||
|
|
|
||
|
|
```
|
||
|
|
src/
|
||
|
|
├── main/
|
||
|
|
│ ├── java/
|
||
|
|
│ │ └── com/gcsc/{프로젝트}/
|
||
|
|
│ │ ├── config/ # 설정 클래스
|
||
|
|
│ │ ├── controller/ # REST 컨트롤러
|
||
|
|
│ │ ├── service/ # 비즈니스 로직
|
||
|
|
│ │ ├── repository/ # 데이터 접근
|
||
|
|
│ │ ├── domain/ # 엔티티
|
||
|
|
│ │ ├── dto/ # 데이터 전송 객체
|
||
|
|
│ │ ├── exception/ # 예외 처리
|
||
|
|
│ │ └── util/ # 유틸리티
|
||
|
|
│ └── resources/
|
||
|
|
│ ├── application.yml # 공통 설정
|
||
|
|
│ ├── application-local.yml # 로컬 설정 (.gitignore)
|
||
|
|
│ └── application-prod.yml # 운영 설정
|
||
|
|
└── test/
|
||
|
|
└── java/ # 테스트 코드
|
||
|
|
```
|
||
|
|
|
||
|
|
## 팀 규칙
|
||
|
|
|
||
|
|
- 코드 스타일: `.claude/rules/code-style.md` 참조
|
||
|
|
- 네이밍 규칙: `.claude/rules/naming.md` 참조
|
||
|
|
- 테스트 규칙: `.claude/rules/testing.md` 참조
|
||
|
|
- Git 워크플로우: `.claude/rules/git-workflow.md` 참조
|
||
|
|
- 팀 정책: `.claude/rules/team-policy.md` 참조
|
||
|
|
|
||
|
|
## 의존성 관리
|
||
|
|
|
||
|
|
- Nexus 프록시 레포지토리를 통해 의존성 관리 (`.mvn/settings.xml`)
|
||
|
|
- 새 의존성 추가 시 `pom.xml`에 버전 명시
|
||
|
|
- Spring Boot BOM 범위 내 의존성은 버전 생략 가능
|