학부 연구실 검색 서비스의 백엔드 애플리케이션입니다. Java 21 · Spring Boot · Gradle을 사용합니다.
API 계약, 데이터 모델, 크롤링·승격, 실행·배포·로깅 안내는 SEBU-brain에서 관리합니다.
Java 21을 준비하고 .env.example을 참고해 JWT_SECRET_BASE64 등 실행 환경 변수를 설정합니다. 실제 .env와 비밀키는 커밋하지 않습니다.
.\gradlew.bat bootRun
.\gradlew.bat testmacOS/Linux에서는 ./gradlew를 사용합니다. 로컬 Swagger UI: http://localhost:8080/swagger-ui/index.html.
src/main/: 애플리케이션과 Flyway 마이그레이션src/test/: 자동 테스트와 검증용 fixtureops/,.github/: 운영 스크립트와 CI.agents/skills/: 백엔드 개발·마이그레이션 작업 지침
분류 CSV는 자동 테스트가 독립적으로 실행되도록 src/test/resources/fixtures/에 유지합니다. 과거 Flyway 파일의 docs/... 주석은 체크섬 보존을 위해 그대로 두며, 이전 위치는 브레인의 문서 모음에서 찾을 수 있습니다.