Lotto API 실행 방법

사전 준비

• Java 21
• Docker Desktop
• Node.js, npm

루트 디렉터리의 .env 파일은 Spring Boot와 Docker Compose가 함께 사용합니다.

MYSQL_ROOT_PASSWORD=REALDEV
MYSQL_DATABASE=lotto
MYSQL_USER=ikae
MYSQL_PASSWORD=wntjr

Docker Compose로 DB 실행

현재 docker-compose.yml은 MySQL만 실행합니다.

docker compose up -d

컨테이너가 처음 생성될 때 docker/mysql/init/001_create_lotto_tables.sql이 실행되어 테이블과 초기 OPEN 회차가 생성됩니다.

상태 확인:

docker compose ps

DB 종료:

docker compose down

DB 데이터를 초기화하고 다시 실행:

docker compose down -v
docker compose up -d

백엔드 별도 실행

MySQL이 먼저 실행되어 있어야 합니다.

Windows PowerShell:

.\gradlew.bat bootRun

macOS/Linux/Git Bash:

./gradlew bootRun

백엔드는 기본적으로 http://localhost:8080에서 실행됩니다.

동작 확인:

curl -X POST http://localhost:8080/api/lottos \
  -H "Content-Type: application/json" \
  -d "{\"count\": 5}"

프론트엔드 별도 실행

백엔드가 http://localhost:8080에서 실행 중이어야 합니다.

cd frontend
npm install
npm run dev

프론트엔드는 기본적으로 http://localhost:3000에서 실행됩니다.

전체 개발 실행 순서

첫 번째 터미널:

docker compose up -d
./gradlew bootRun

두 번째 터미널:

cd frontend
npm install
npm run dev