Maki Boilerplate Project

프로젝트 소개

이 프로젝트는 Kotlin 1.9.25와 Spring Boot 3.5.3 기반의 백엔드 보일러플레이트입니다.
MySQL, MongoDB, Swagger(OpenAPI) 등을 다양하게 연동하는 방법을 탐색하며,
버전을 명확히 고정하여 안정적인 환경을 구축하는 데 집중했습니다.
향후 확장과 실제 서비스 개발을 위한 기초로 활용하기 위해 만들어졌습니다.

---

기술 스택 및 버전

기술	버전
Kotlin	1.9.25
Spring Boot	3.5.3
springdoc-openapi	2.5.0
MySQL Connector/J	8.0.33
MongoDB	4.x 이상
Gradle	8.x 이상
JDK	21

---

주요 기능

• Kotlin 1.9.25 기반 REST API 서버 개발
• Spring Boot 3.5.3 사용
• Swagger UI(OpenAPI) 자동 문서화 및 테스트
• MySQL 8.0.33 JDBC 드라이버를 통한 관계형 DB 연동
• Spring Data MongoDB를 통한 NoSQL 연동
• Spring Security 기본 설정 (인증 없이 모든 요청 허용)
• 개발용 핫 리로딩 및 자동 빌드 지원

---

빌드 및 실행 방법

1. JDK 21 이상 설치
2. MySQL 및 MongoDB 데이터베이스 준비
3. 프로젝트 클론 및 Gradle 빌드 실행

git clone <프로젝트 URL>
cd <프로젝트 폴더>
./gradlew clean build
./gradlew bootRun

---

Swagger UI 접속

local

http://localhost:8080/api/swagger-ui/index.html