youngwon-stock-market

환경설정 (Spring 3.5 / Kotlin 2.2 / Gradle 기반 모노레포)

이 프로젝트는 Spring Framework 3.5와 Kotlin 2.2를 기반으로 하며, Gradle 기반의 모노레포 구조를 채택합니다. 다양한 서비스/도메인을 별도의 Gradle 모듈로 관리할 수 있습니다.

1. 필수 설치

• JDK 21 이상
• Gradle 8.x (Wrapper 사용 권장)
• Docker (선택, 개발용 DB 등)

2. 프로젝트 구조 예시

youngwon-stock-market/
├── build.gradle.kts         # 루트 빌드 설정
├── settings.gradle.kts      # 모듈 관리
├── modules/
│   ├── gateway/             # 클라이언트 게이트웨이 모듈
│   ├── order-manager/       # 주문 관리자 모듈
│   ├── matching-engine/     # 체결 엔진 모듈
│   └── ...                  # 기타 서비스 모듈
└── docs/                    # 설계 문서 등

3. 빌드 & 실행

# 전체 빌드
./gradlew build

# 특정 모듈만 빌드
./gradlew :modules:gateway:build

# 실행 예시 (Spring Boot)
./gradlew :modules:gateway:bootRun

4. 모듈 추가 방법

1. modules/ 하위에 새 디렉토리 생성
2. 해당 디렉토리에 build.gradle.kts 추가
3. settings.gradle.kts에 include(":modules:새모듈명") 추가

5. 설계 문서

상세 시스템 설계 및 아키텍처 문서는 docs/architecture.md에서 확인할 수 있습니다.