nook-server

취향 기반 장소 아카이빙 서비스, nook의 서버 애플리케이션입니다.

기술 스택

• Java 25
• Kotlin 2.4
• Spring Boot 4
• Spring Data JPA
• MySQL 8.4 LTS
• Gradle Kotlin DSL

모듈

• nook-api-domain: 도메인 모델과 규칙
• nook-api-application: 유스케이스와 포트
• nook-api-infrastructure: JPA 및 외부 시스템 어댑터
• nook-api-presentation: HTTP API와 API 애플리케이션 진입점
• nook-api-batch: 배치 작업과 배치 애플리케이션 진입점

의존성 규칙은 모듈 구조를 참고합니다.

실행 준비

저장소 루트의 .env.example을 복사해 .env를 만들면 API와 batch 애플리케이션이 로컬 실행 시 자동으로 값을 읽습니다. .env는 Git에 포함되지 않습니다.

cp .env.example .env

필요한 값을 .env에 입력합니다. OS 환경변수, JVM system property와 명령행 인자는 .env보다 우선합니다. dev, staging, live 환경은 기존처럼 실행 환경에서 환경변수를 직접 주입합니다.

장소 후보 검색에는 카카오 디벨로퍼스 애플리케이션의 REST API 키를 사용합니다.

Instagram 게시물·릴스 수집 dataset ID는 Bright Data 공식 기본값을 사용합니다. 계정에서 별도 dataset을 사용하는 경우 BRIGHT_DATA_POSTS_DATASET_ID, BRIGHT_DATA_REELS_DATASET_ID로 재정의합니다.

API 애플리케이션을 실행합니다.

./gradlew :nook-api-presentation:bootRun

배치 애플리케이션을 실행합니다.

./gradlew :nook-api-batch:bootRun

검증

./gradlew clean test

Docker

API 이미지:

docker build -t nook-api -f Dockerfile .

배치 이미지:

docker build -t nook-batch -f Dockerfile.batch .

실행 환경에서 SPRING_PROFILES_ACTIVE, DB 설정, JWT 비밀키와 사용하는 소셜 provider 설정을 주입합니다.