release: v1.0.0 배포를 위한 develop 병합

.dockerignore

@@ -0,0 +1,8 @@
+.git
+.gradle
+build/
+out/
+bin/
+Dockerfile
+.dockerignore
+README.md

.gemini/settings.json

@@ -0,0 +1,5 @@
+{
+  "ui": {
+    "theme": "ANSI Light"
+  }
+}

.github/ISSUE_TEMPLATE/feature.md

@@ -13,4 +13,4 @@ assignees: ""
 <!-- 어떤 것들을 작업해야 하는지 작성해주세요! -->
 
 ### 💡 기타 참고 사항
-<!-- 작업 시 주의해야 할 점이나 특이사항을 적어주세요. -->
+<!-- 작업 시 주의해야 할 점이나 특이사항을 적어주세요! -->

.github/PULL_REQUEST_TEMPLATE.md

@@ -1,13 +1,19 @@
-### 📌 관련 이슈
+## 📌 관련 이슈
+<br>
+
 <!-- #이슈번호로 관련 이슈를 지정해주세요! ex) #12 --> 
 
-### ✨ 작업 내용 요약
+## ✨ 작업 내용 요약
+<br>
+
 <!-- 이번 PR에서 무엇을 변경했는지 간단히 적어주세요! -->
 
-### 🛠️ 주요 변경 사항
+## 🛠️ 주요 변경 사항
+<br>
+
 <!-- 변경 사항을 좀 더 구체적으로 작성해주세요! -->
 
-### 📚 체크리스트
+## 📚 체크리스트
 - [ ] 팀 컨벤션에 맞는 커밋 메시지를 작성했나요?
 - [ ] 로컬 환경에서 정상 작동하는지 확인했나요?
 - [ ] 불필요한 주석이나 print문은 제거했나요?

.github/workflows/deploy.yml

@@ -0,0 +1,96 @@
+name: Pace Project CI/CD # 워크플로우 이름 설정
+
+on:
+  push:
+    branches: [ "main", "develop" ] # 해당 브랜치에 코드가 push될 때만 실행
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest # 깃허브가 제공하는 최신 우분투 가상 환경에서 작업
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4 # 깃허브 서버로 내 소스 코드를 가져옴
+
+      - name: Set up JDK 21
+        uses: actions/setup-java@v4
+        with:
+          java-version: '21'
+          distribution: 'temurin'
+          cache: 'gradle'
+
+      - name: Grant execute permission for gradlew
+        run: chmod +x gradlew
+
+      - name: Run Tests with Gradle
+        run: ./gradlew test
+
+      - name: Login to Docker Hub
+        uses: docker/login-action@v3 # 도커 허브 접속 시도
+        with:
+          username: ${{ secrets.DOCKERHUB_USERNAME }} # 깃허브 시크릿에서 아이디 가져옴
+          password: ${{ secrets.DOCKERHUB_TOKEN }} # 깃허브 시크릿에서 토큰 가져옴
+
+      - name: Build and push Docker image
+        uses: docker/build-push-action@v5 # 도커 이미지 빌드 및 전송
+        with:
+          context: . # 현재 위치의 파일을 바탕으로 빌드
+          push: true # 빌드 성공 시 도커 허브로 즉시 보냄
+          tags: ${{ secrets.DOCKERHUB_USERNAME }}/pace-project:latest # 이미지 이름과 태그 붙임
+
+      - name: Prepare directory on EC2
+        uses: appleboy/ssh-action@v1.0.3
+        with:
+          host: ${{ secrets.EC2_HOST }}
+          username: ${{ secrets.EC2_USERNAME }}
+          key: ${{ secrets.EC2_SSH_KEY }}
+          script: mkdir -p ~/pace-project/nginx
+
+      - name: Copy docker-compose.yml via scp
+        uses: appleboy/scp-action@v0.1.7
+        with:
+          host: ${{ secrets.EC2_HOST }}
+          username: ${{ secrets.EC2_USERNAME }}
+          key: ${{ secrets.EC2_SSH_KEY }}
+          source: "docker-compose.yml,nginx/default.conf" # 내 깃허브에 있는 파일 이름
+          target: "~/pace-project" # 서버에 저장될 폴더 이름
+
+      - name: Deploy to EC2
+        uses: appleboy/ssh-action@v1.0.3 # SSH를 통해 AWS EC2 서버에 접속
+        with:
+          host: ${{ secrets.EC2_HOST }} # EC2의 IP 주소로 연결
+          username: ${{ secrets.EC2_USERNAME }} # 접속 계정(보통 ubuntu) 사용
+          key: ${{ secrets.EC2_SSH_KEY }} # .pem 키 내용으로 인증
+          script: | # 접속 후 실행할 명령어들 시작
+            mkdir -p ~/pace-project # 프로젝트 폴더가 없으면 생성
+            cd ~/pace-project # 해당 폴더로 이동
+
+            docker pull ${{ secrets.DOCKERHUB_USERNAME }}/pace-project:latest # 창고에서 새 이미지 가져옴
+
+            # 서버에서 사용할 비밀 장부(.env)를 시크릿 값으로 새로 만듦
+            echo "MYSQL_ROOT_PASSWORD=${{ secrets.MYSQL_ROOT_PASSWORD }}" > .env
+            echo "MYSQL_DATABASE=${{ secrets.MYSQL_DATABASE }}" >> .env
+            echo "MYSQL_USER=${{ secrets.MYSQL_USER }}" >> .env
+            echo "MYSQL_PASSWORD=${{ secrets.MYSQL_PASSWORD }}" >> .env
+            echo "REDIS_PASSWORD=${{ secrets.REDIS_PASSWORD }}" >> .env
+            echo "JWT_SECRET=${{ secrets.JWT_SECRET }}" >> .env
+            echo "KAKAO_CLIENT_ID=${{ secrets.KAKAO_CLIENT_ID }}" >> .env
+            echo "KAKAO_REDIRECT_URI=${{ secrets.KAKAO_REDIRECT_URI }}" >> .env
+            echo "GOOGLE_MAPS_API_KEY=${{ secrets.GOOGLE_MAPS_API_KEY }}" >> .env
+            echo "SEOUL_SUBWAY_API_KEY=${{ secrets.SEOUL_SUBWAY_API_KEY }}" >> .env
+            docker-compose up -d --remove-orphans # 새 이미지로 세트 메뉴(DB+앱) 다시 실행
+            docker image prune -f
+
+            # 헬스 체크: 서버가 제대로 떴는지 10번 확인함
+            echo "Starting health check..."
+            for i in {1..10}; do
+              RESPONSE=$(curl -s -H "Host: pace-server.kro.kr" http://localhost/health) # 내 서버에 안부를 물어봄
+              if [ "$RESPONSE" = "OK" ]; then # 대답이 "OK"면 성공
+                echo "Health check passed!"
+                exit 0
+              fi
+              echo "Waiting for server... ($i/10)" # 아직 안 떴으면 10초 기다림
+              sleep 10
+            done
+            echo "Health check failed." # 10번 다 실패하면 배포 실패 처리
+            exit 1

.gitignore

@@ -4,6 +4,7 @@ build/
 !gradle/wrapper/gradle-wrapper.jar
 !**/src/main/**/build/
 !**/src/test/**/build/
+.gemini
 
 ### STS ###
 .apt_generated
@@ -35,3 +36,6 @@ out/
 
 ### VS Code ###
 .vscode/
+
+.DS_Store
+.env

Dockerfile

@@ -0,0 +1,33 @@
+# 빌드 스테이지(eclipse-temurin을 사용하여 jar 파일 생성)
+FROM eclipse-temurin:21-jdk-jammy AS build
+
+# 컨테이너 내부의 작업 디렉토리를 /app으로 설정
+WORKDIR /workspace
+
+# 의존성 캐시 단계
+COPY gradlew .
+COPY gradle gradle
+COPY settings.gradle build.gradle ./
+
+# Gradle 래퍼(/gradlew)에 실행 권한 부여 및 라이브러리 다운로드
+RUN chmod +x ./gradlew && ./gradlew --no-daemon dependencies
+
+# 빌드 단계
+COPY src src
+RUN ./gradlew --no-daemon clean bootJar -x test
+
+# 실행 단계
+FROM eclipse-temurin:21-jre-jammy AS runtime
+WORKDIR /app
+
+# 보안을 위한 비관리자 유저 생성
+RUN useradd -ms /bin/bash appuser
+USER appuser
+
+# 빌드 결과물만 복사
+COPY --from=build /workspace/build/libs/*.jar app.jar
+
+EXPOSE 8080
+
+# 한국 시간 설정 및 실행
+ENTRYPOINT ["java", "-Duser.timezone=Asia/Seoul", "-jar", "app.jar"]

README.md

@@ -1,2 +1,70 @@
-# Pace_server
-UMC 9기 'Pace' 서비스 server 팀
+# Pace Server 🏃‍♂️
+
+> **UMC 9기 'Pace' 서버팀** 
+
+## 📖 프로젝트 개요
+
+**Pace**는 사용자의 일정과 이동 경로를 효율적으로 관리할 수 있도록 돕는 모바일 애플리케이션입니다. **카카오 로그인**을 통한 간편한 인증을 지원하며, 대중교통 데이터를 활용한 일정 관리, 경로 추천, 장소 저장 등의 기능을 제공합니다.
+
+## 🛠 백엔드 기술 스택 (Tech Stack)
+
+### 환경 (Environment)
+*   ![Java](https://img.shields.io/badge/Java-21-ED8B00?style=flat&logo=openjdk&logoColor=white)
+*   ![Spring Boot](https://img.shields.io/badge/Spring%20Boot-4.0.1-6DB33F?style=flat&logo=springboot&logoColor=white)
+*   ![Gradle](https://img.shields.io/badge/Gradle-8.x-02303A?style=flat&logo=gradle&logoColor=white)
+
+### 데이터베이스 & ORM
+*   ![MySQL](https://img.shields.io/badge/MySQL-8.0-4479A1?style=flat&logo=mysql&logoColor=white)
+*   **Spring Data JPA**
+*   **QueryDSL 5.0**
+
+### 보안 & 인증 (Security & Auth)
+*   **Spring Security**
+*   **OAuth 2.0 (Kakao Login)**
+*   **JWT (JSON Web Token)**
+
+### API & 문서화
+*   **SpringDoc OpenAPI (Swagger UI)**
+*   **WebFlux (WebClient)** - 외부 API 연동
+
+### 유틸리티 (Utilities)
+*   **Apache POI** - 엑셀 데이터 처리 (버스/지하철 정보)
+*   **Lombok**
+
+## 📂 프로젝트 구조
+
+```bash
+src/main/java/com/example/pace
+├── PaceApplication.java
+├── domain
+│   ├── auth          # 인증 (Kakao, JWT)
+│   ├── member        # 회원 관리, 장소 보관함, 설정
+│   ├── schedule      # 일정 및 경로 관리
+│   ├── terms         # 약관 관리
+│   └── transit       # 대중교통 데이터 로직
+└── global
+    ├── apiPayload    # 표준 API 응답 구조
+    ├── auth          # 시큐리티 설정, Custom User Details
+    ├── config        # 앱 설정 (Swagger, WebClient 등)
+    └── entity        # Base Entities
+```
+
+## ✨ 주요 기능
+
+### 1. 인증 (Authentication)
+*   **카카오 로그인**: Kakao OAuth2를 이용한 간편 로그인.
+*   **토큰 관리**: Access/Refresh Token 발급 및 재발급(Reissue).
+*   **계정 관리**: 로그아웃 및 회원 탈퇴 기능.
+
+### 2. 일정 관리 (Schedule Management)
+*   **생성/삭제**: 개인 일정 등록 및 삭제.
+*   **조회**: 일별, 월별 일정 목록 조회.
+*   **경로**: 대중교통 정보를 활용한 일정 경로 관리.
+
+### 3. 회원 및 설정 (Member & Settings)
+*   **프로필**: 사용자 정보 관리.
+*   **장소 보관함**: 자주 가는 장소 즐겨찾기 및 그룹 관리.
+*   **온보딩**: 초기 사용자 설정 프로세스.
+
+### 4. 대중교통 통합 (Transit Integration)
+*   **데이터 로딩**: 버스 및 지하철 데이터(Excel/JSON)를 로드하여 경로 계산에 활용.

build.gradle

@@ -1,46 +1,97 @@
 plugins {
-	id 'java'
-	id 'org.springframework.boot' version '4.0.1'
-	id 'io.spring.dependency-management' version '1.1.7'
+    id 'java'
+    id 'org.springframework.boot' version '4.0.1'
+    id 'io.spring.dependency-management' version '1.1.7'
+    id 'org.jetbrains.kotlin.jvm'
 }
 
 group = 'com.example'
 version = '0.0.1-SNAPSHOT'
 description = 'Demo project for Spring Boot'
 
 java {
-	toolchain {
-		languageVersion = JavaLanguageVersion.of(21)
-	}
+    toolchain {
+        languageVersion = JavaLanguageVersion.of(21)
+    }
 }
 
 configurations {
-	compileOnly {
-		extendsFrom annotationProcessor
-	}
+    compileOnly {
+        extendsFrom annotationProcessor
+    }
 }
 
 repositories {
-	mavenCentral()
+    mavenCentral()
 }
 
 dependencies {
-	implementation 'org.springframework.boot:spring-boot-starter-data-jpa'
-	implementation 'org.springframework.boot:spring-boot-starter-security'
-	implementation 'org.springframework.boot:spring-boot-starter-security-oauth2-client'
-	implementation 'org.springframework.boot:spring-boot-starter-webmvc'
-	compileOnly 'org.projectlombok:lombok'
-	developmentOnly 'org.springframework.boot:spring-boot-devtools'
-	runtimeOnly 'com.mysql:mysql-connector-j'
-	annotationProcessor 'org.springframework.boot:spring-boot-configuration-processor'
-	annotationProcessor 'org.projectlombok:lombok'
-	testImplementation 'org.springframework.boot:spring-boot-starter-data-jpa-test'
-	testImplementation 'org.springframework.boot:spring-boot-starter-security-oauth2-client-test'
-	testImplementation 'org.springframework.boot:spring-boot-starter-security-test'
-	testImplementation 'org.springframework.boot:spring-boot-starter-webmvc-test'
-	testRuntimeOnly 'org.junit.platform:junit-platform-launcher'
+    implementation 'org.springframework.boot:spring-boot-starter-data-jpa'
+    implementation 'org.springframework.boot:spring-boot-starter-security'
+    implementation 'org.springframework.boot:spring-boot-starter-security-oauth2-client'
+
+    implementation 'org.springframework.boot:spring-boot-starter-web'
+    compileOnly 'org.projectlombok:lombok'
+    developmentOnly 'org.springframework.boot:spring-boot-devtools'
+    runtimeOnly 'com.mysql:mysql-connector-j'
+    annotationProcessor 'org.springframework.boot:spring-boot-configuration-processor'
+    annotationProcessor 'org.projectlombok:lombok'
+
+    testImplementation 'org.springframework.boot:spring-boot-starter-test'
+    testImplementation 'org.springframework.boot:spring-boot-starter-data-jpa-test'
+    testImplementation 'org.springframework.boot:spring-boot-starter-security-oauth2-client-test'
+    testImplementation 'org.springframework.boot:spring-boot-starter-security-test'
+    testImplementation 'org.springframework.boot:spring-boot-starter-webmvc-test'
+    testRuntimeOnly 'org.junit.platform:junit-platform-launcher'
+    testRuntimeOnly 'com.h2database:h2'
+
+    // Swagger UI
+    implementation("org.springdoc:springdoc-openapi-starter-webmvc-ui:3.0.1")
+
+    // jwt
+    implementation 'io.jsonwebtoken:jjwt-api:0.12.3'
+    implementation 'io.jsonwebtoken:jjwt-impl:0.12.3'
+    implementation 'io.jsonwebtoken:jjwt-jackson:0.12.3'
+    implementation 'org.springframework.boot:spring-boot-configuration-processor'
+
+    // WebClient
+    implementation 'org.springframework.boot:spring-boot-starter-webflux'
+
+    // Excel (Apache POI)
+    implementation 'org.apache.poi:poi-ooxml:5.4.0'
+
+    // QueryDSL : OpenFeign
+    implementation "io.github.openfeign.querydsl:querydsl-jpa:7.0"
+    implementation "io.github.openfeign.querydsl:querydsl-core:7.0"
+    annotationProcessor "io.github.openfeign.querydsl:querydsl-apt:7.0:jpa"
+    annotationProcessor "jakarta.persistence:jakarta.persistence-api"
+    annotationProcessor "jakarta.annotation:jakarta.annotation-api"
+
+    // idk
+    implementation "org.jetbrains.kotlin:kotlin-stdlib-jdk8"
+
+    // redis
+    implementation 'org.springframework.boot:spring-boot-starter-data-redis'
 }
 
+
 tasks.named('test') {
-	useJUnitPlatform()
+    useJUnitPlatform()
+}
+
+def querydslDir = layout.buildDirectory.dir("generated/querydsl").get().asFile
+
+// 소스 세트에 생성 경로 추가
+sourceSets {
+    main.java.srcDirs += [querydslDir]
+}
+
+// 컴파일 시 생성 경로 지정
+tasks.withType(JavaCompile).configureEach {
+    options.generatedSourceOutputDirectory.set(querydslDir)
 }
+
+// clean 태스크에 생성 폴더 삭제 로직
+clean.doLast {
+    file(querydslDir).deleteDir()
+}