Backend guide

🛠️ 백엔드 가이드

🧱 Build 환경

Gradle + Spring Boot + Java 21

Spring Boot는 빠른 백엔드 애플리케이션 개발을 위한 프레임워크이며, Gradle은 의존성 관리와 빌드 자동화를 지원합니다. 이 프로젝트는 Java 21과 Spring Boot 3.2.5, MySQL, JWT, OpenFeign, Kakao OAuth, OpenAI API를 사용합니다.

• Build Tool: Gradle (Groovy DSL)
• JDK Version: Java 21 (java.toolchain.languageVersion)
• Framework: Spring Boot 3.2.5
• Dependency Management: io.spring.dependency-management, Spring Cloud BOM (2023.0.1)
• Database: MySQL (로컬 13306 포트)
• ORM: Spring Data JPA + Hibernate (ddl-auto: update, MySQLDialect)
• OAuth: Kakao Login 지원 (application.yml에 client-id 및 redirect-uri 설정)
• Security: Spring Security + JWT 인증 (jjwt 0.11.5)
• API 연동: OpenFeign, OpenAI API 연동
• 테스트 도구: JUnit + Spring Security Test
• 로컬 개발 지원: H2 인메모리 DB, application-SECRET-KEY.properties를 통한 profile 분기

---

🛠 설정 파일 정리

1. application.yml

• DB 접속 정보: MySQL, 포트 13306
• 프로파일 분리: SECRET-KEY 파일에서 민감 정보 주입
• JWT 키, Kakao OAuth, OpenAI API 키 포함

2. application-SECRET-KEY.properties

• .gitignore로 관리
• ${database-password}, ${jwt.secret} 등 외부 변수 설정

📂 주요 Gradle 스크립트 (build.gradle)

명령어	설명
./gradlew build	프로젝트 전체 빌드
./gradlew test	테스트 실행
java -jar ...	실행 가능한 JAR 실행