개발 가이드

필수 도구

• Node.js 20 (LTS)
• npm
• Docker (선택, 로컬 컨테이너로 실행 시)

로컬 개발

# 의존성 설치
npm install

# 개발 서버
npm run dev

# 또는 도커 컴포즈로 실행
docker-compose up --build

빌드(프로덕션)

npm run build
npm start

GitHub Actions 프리뷰 빌드

• pull_request 또는 push(main 제외) 시 자동으로 빌드가 실행되어 .next 빌드 아티팩트가 생성됩니다.
• Actions 페이지에서 해당 워크플로우의 Artifacts에서 프리뷰 빌드를 다운로드하여 로컬에서 검증할 수 있습니다.

배포

• deploy/deploy.sh는 예시 스크립트입니다. 서버 접속 정보(SSH 키, 유저, 호스트)를 설정한 뒤 사용하세요.