[8팀] 백엔드 코드리뷰용 PR

.github/ISSUE_TEMPLATE/♻️-refactor.md

@@ -0,0 +1,17 @@
+---
+name: "♻️ Refactor"
+about: 리팩토링
+title: "♻️"
+labels: ''
+assignees: ''
+
+---
+
+### 📌 Description
+
+
+---
+
+### ✅ Task
+- [ ] Task 1
+- [ ] Task 2

.github/ISSUE_TEMPLATE/⚙️-setting.md

@@ -0,0 +1,17 @@
+---
+name: "⚙️ Setting"
+about: 배포, 인프라 등 설정 관련
+title: "⚙️"
+labels: ''
+assignees: ''
+
+---
+
+### 📌 Description
+
+
+---
+
+### ✅ Task
+- [ ] Task 1
+- [ ] Task 2

.github/ISSUE_TEMPLATE/✅-test.md

@@ -0,0 +1,17 @@
+---
+name: "✅ Test"
+about: 테스트 추가
+title: "✅"
+labels: ''
+assignees: ''
+
+---
+
+### 📌 Description
+
+
+---
+
+### ✅ Task
+- [ ] Task 1
+- [ ] Task 2

.github/ISSUE_TEMPLATE/✨-feature.md

@@ -0,0 +1,17 @@
+---
+name: "✨ Feature"
+about: 새로운 기능 추가
+title: "✨"
+labels: ''
+assignees: ''
+
+---
+
+### 📌 Description
+
+
+---
+
+### ✅ Task
+- [ ] Task 1
+- [ ] Task 2

.github/ISSUE_TEMPLATE/🐛-fix.md

@@ -0,0 +1,17 @@
+---
+name: "\U0001F41B Fix"
+about: 버그 수정
+title: "\U0001F41B"
+labels: ''
+assignees: ''
+
+---
+
+### 📌 Description
+
+
+---
+
+### ✅ Task
+- [ ] Task 1
+- [ ] Task 2

.github/pull_request_template.md

@@ -0,0 +1,12 @@
+### ✨ Related Issue
+
+---
+
+### 📌 Task Details
+- Task 1
+- Task 2
+
+---
+
+### 💬 Review Requirements (Optional)
+

.github/workflows/deploy.yml

@@ -0,0 +1,195 @@
+on:
+  push:
+    branches: [ "main", "dev" ]
+  workflow_dispatch:
+
+jobs:
+  build-and-push:
+    runs-on: ubuntu-latest
+    outputs:
+      tag: ${{ steps.vars.outputs.tag }}
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: JDK 17 세팅
+        uses: actions/setup-java@v4
+        with:
+          java-version: '17'
+          distribution: 'temurin'
+
+      - name: Gradle 캐시
+        uses: actions/cache@v3
+        with:
+          path: |
+            ~/.gradle/caches
+            ~/.gradle/wrapper
+          key: ${{ runner.os }}-gradle-${{ hashFiles('**/*.gradle*', '**/gradle-wrapper.properties') }}
+          restore-keys: |
+            ${{ runner.os }}-gradle
+
+  deploy-dev:
+    if: github.ref == 'refs/heads/dev'
+    needs: build-and-push
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Checkout source code
+        uses: actions/checkout@v4
+
+      - name: Set up SSH key
+        uses: webfactory/[email protected]
+        with:
+          ssh-private-key: ${{ secrets.DEV_EC2_SSH_KEY }}
+
+      - name: YML 파일 세팅
+        env:
+          APPLICATION_PROPERTIES: ${{ secrets.ONKU_APP_DEV_YML }}
+          TEST_APPLICATION_PROPERTIES: ${{ secrets.ONKU_APP_TEST_YML }}
+          FCM_JSON: ${{ secrets.ONKU_FCM_JSON }}
+
+        run: |
+          cd ./src
+          rm -rf main/resources/application.yml
+          mkdir -p main/resources
+          mkdir -p test/resources
+          mkdir -p main/resources/firebase
+          echo "$APPLICATION_PROPERTIES" > main/resources/application.yml
+          echo "$TEST_APPLICATION_PROPERTIES" > test/resources/application.yml
+          echo "$FCM_JSON" > main/resources/firebase/fcm.json
+
+      - name: gradlew 권한 부여
+        run: chmod +x gradlew
+
+      - name: 테스트 수행
+        run: ./gradlew test
+
+      - name: 테스트 리포트 아티팩트 업로드
+        if: failure()
+        uses: actions/upload-artifact@v4
+        with:
+          name: test-report
+          path: build/reports/tests/test
+
+      - name: 스프링부트 빌드
+        run: ./gradlew build
+
+      - name: Docker Buildx 세팅
+        uses: docker/setup-buildx-action@v3
+
+      - name: docker login
+        uses: docker/login-action@v2
+        with:
+          username: ${{ secrets.DOCKERHUB_USERNAME }}
+          password: ${{ secrets.DOCKERHUB_PASSWORD }}
+
+      - name: 도커 이미지 빌드 후 푸시
+        if: success()
+        uses: docker/build-push-action@v6
+        with:
+          context: .
+          file: ./Dockerfile
+          push: true
+          tags: ${{ secrets.DOCKERHUB_USERNAME }}/backend:${{ github.sha }}
+          platforms: linux/amd64,linux/arm64
+
+      - name: Docker Compose 파일 NCP 서버로 전송
+        run: scp -o StrictHostKeyChecking=no -P ${{ secrets.DEV_EC2_PORT }} docker-compose.yml ${{ secrets.DEV_EC2_USER }}@${{ secrets.DEV_EC2_HOST }}:./
+
+      - name: EC2 접속 후 이미지 다운로드 및 배포
+        if: success()
+        uses: appleboy/ssh-action@master
+        with:
+          host: ${{ secrets.DEV_EC2_HOST }}
+          username: ${{ secrets.DEV_EC2_USER }}
+          key: ${{ secrets.DEV_EC2_SSH_KEY }}
+          port: ${{ secrets.DEV_EC2_PORT }}
+          script: |
+            export DOCKER_CONTAINER_REGISTRY=${{ secrets.DOCKERHUB_USERNAME }}
+            export REDIS_PASSWORD=${{ secrets.DEV_REDIS_PASSWORD }}
+            export GITHUB_SHA=${{ github.sha }}
+            sudo chmod +x ./deploy.sh
+            ./deploy.sh
+  deploy-prod:
+    if: github.ref == 'refs/heads/main'
+    needs: build-and-push
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Checkout source code
+        uses: actions/checkout@v4
+
+      - name: Set up SSH key
+        uses: webfactory/[email protected]
+        with:
+          ssh-private-key: ${{ secrets.PROD_EC2_SSH_KEY }}
+
+      - name: YML 파일 세팅
+        env:
+          APPLICATION_PROPERTIES: ${{ secrets.ONKU_APP_PROD_YML }}
+          TEST_APPLICATION_PROPERTIES: ${{ secrets.ONKU_APP_TEST_YML }}
+          FCM_JSON: ${{ secrets.ONKU_FCM_JSON }}
+
+        run: |
+          cd ./src
+          rm -rf main/resources/application.yml
+          mkdir -p main/resources
+          mkdir -p test/resources
+          mkdir -p main/resources/firebase
+          echo "$APPLICATION_PROPERTIES" > main/resources/application.yml
+          echo "$TEST_APPLICATION_PROPERTIES" > test/resources/application.yml
+          echo "$FCM_JSON" > main/resources/firebase/fcm.json
+
+      - name: gradlew 권한 부여
+        run: chmod +x gradlew
+
+      - name: 테스트 수행
+        run: ./gradlew test
+
+      - name: 테스트 리포트 아티팩트 업로드
+        if: failure()
+        uses: actions/upload-artifact@v4
+        with:
+          name: test-report
+          path: build/reports/tests/test
+
+      - name: 스프링부트 빌드
+        run: ./gradlew build
+
+      - name: Docker Buildx 세팅
+        uses: docker/setup-buildx-action@v3
+
+      - name: docker login
+        uses: docker/login-action@v2
+        with:
+          username: ${{ secrets.DOCKERHUB_USERNAME }}
+          password: ${{ secrets.DOCKERHUB_PASSWORD }}
+
+      - name: 도커 이미지 빌드 후 푸시
+        if: success()
+        uses: docker/build-push-action@v6
+        with:
+          context: .
+          file: ./Dockerfile
+          push: true
+          tags: ${{ secrets.DOCKERHUB_USERNAME }}/backend:${{ github.sha }}
+          platforms: linux/amd64,linux/arm64
+
+      - name: Docker Compose 파일 NCP 서버로 전송
+        run: scp -o StrictHostKeyChecking=no -P ${{ secrets.PROD_EC2_PORT }} docker-compose.yml ${{ secrets.PROD_EC2_USER }}@${{ secrets.PROD_EC2_HOST }}:./
+
+      - name: EC2 접속 후 이미지 다운로드 및 배포
+        if: success()
+        uses: appleboy/ssh-action@master
+        with:
+          host: ${{ secrets.PROD_EC2_HOST }}
+          username: ${{ secrets.PROD_EC2_USER }}
+          key: ${{ secrets.PROD_EC2_SSH_KEY }}
+          port: ${{ secrets.PROD_EC2_PORT }}
+          script: |
+            export DOCKER_CONTAINER_REGISTRY=${{ secrets.DOCKERHUB_USERNAME }}
+            export REDIS_PASSWORD='${{ secrets.PROD_REDIS_PASSWORD }}'
+            export GITHUB_SHA=${{ github.sha }}
+            sudo chmod +x ./deploy.sh
+            ./deploy.sh

.gitignore

@@ -40,4 +40,6 @@ out/
 .kotlin
 
 ### YAML ###
-application.yml
+application.yml
+#src/main/resources/*
+src/main/resources/firebase/*

Dockerfile

@@ -0,0 +1,6 @@
+FROM openjdk:17.0.1-jdk-slim
+WORKDIR /app
+COPY ./build/libs/backend-0.0.1-SNAPSHOT.jar /app/backend.jar
+EXPOSE 8080
+ENTRYPOINT ["java"]
+CMD ["-jar", "backend.jar"]

README.md

@@ -0,0 +1,49 @@
+# 큐-첵 (Ku-check): 큐시즘의 모든 일을 한큐에 체크하다, 큐첵
+> 🔗 **서비스 링크**: [`https://ku-check.vercel.app`](https://ku-check.vercel.app)
+<img width="7680" height="4320" alt="큐첵 소개" src="https://github.com/user-attachments/assets/e6375d54-366a-429d-a771-dfd6ef557d3d" />
+
+## 🎨 서비스 설명
+- 큐첵은 큐시즘 운영에 흩어져 있던 출결, 상벌점, 공지, 불참사유서 제출을 하나로 통합해 학회 운영을 더 정확하고 간편하게 만드는 전용 관리 서비스입니다.
+- 운영진은 반복적인 수기 행정을 줄일 수 있고, 학회원은 내 활동 현황과 이번 주 핵심 정보를 한 곳에서 확인하며 불참사유서까지 앱에서 바로 제출할 수 있습니다.
+
+## 💻 Backend Members
+|                                                       **김영록**                                                       |                                                     **김민지**                                                      |
+|:-------------------------------------------------------------------------------------------------------------------:|:----------------------------------------------------------------------------------------------------------------:|
+| <a href="https://github.com/kimyeoungrok"><img src="https://avatars.githubusercontent.com/u/127182406?v=4" width="150"> | <a href="https://github.com/minzix"><img src="https://avatars.githubusercontent.com/u/126869805?v=4" width="150"> |
+|                                                      `backend`                                                      |                                                    `backend`                                                     |
+
+## 📜 API 명세서
+[큐첵 개발 서버 API 명세서](https://dev.ku-check.o-r.kr/swagger-ui/index.html)
+
+## 🗃️ ERD
+<img width="2110" height="1272" alt="Ku-Check (1) (1)" src="https://github.com/user-attachments/assets/85afd83a-16c8-4c63-943b-98eaff150a29" />
+
+## 🛠️ 기술 스택
+| 기술 스택 | 사용 이유 |
+|----------|-----------|
+| **Spring Kotlin** | Kotlin은 간결하고 읽기 쉬운 문법을 제공하여 개발 생산성이 높아진다고 판단해 사용했습니다.<br>Java 기반 기술 스택과 완벽히 호환되어 러닝커브가 적다고 생각했습니다.<br>Null-safety 덕분에 런타임 오류(NPE)를 줄일 수 있어 선택했습니다. |
+| **Spring Data JPA** | SQL을 직접 작성하지 않고 객체지향적인 방식으로 DB를 다루기 위해 JPA를 사용하였으며, Spring 환경에서 이를 쉽게 활용할 수 있도록 지원하는 Spring Data JPA를 선택했습니다. |
+| **AWS EC2** | 서비스 배포 서버로 사용했습니다. |
+| **AWS S3** | 큐픽 증빙사진, 불참증명서 파일 등을 저장하기 위한 파일 저장소로 사용했습니다. |
+| **AWS RDS** | 타 클라우드 대비 저렴하고, VPC·보안 그룹과 통합되어 안전한 접근 제어가 가능하여 사용했습니다. |
+| **Docker** | 개발 및 배포 환경을 컨테이너화하여 일관된 환경을 유지하기 위해 사용했습니다. |
+| **GitHub Actions** | GitHub 기반으로 CI 환경을 일원화하여 자동화된 빌드 및 테스트 환경을 구축하기 위해 사용했습니다. |
+| **MySQL 8.x** | MySQL 5 대비 향상된 성능, 강화된 보안 기능, 공간 데이터 처리 기능을 제공하여 사용했습니다. |
+| **Redis** | TTL을 제공해 토큰과 같은 세션 정보를 유효시간 기반으로 관리할 수 있습니다.<br>메모리 기반 저장소로 DB 대비 빠른 속도를 제공하여 로그인 등 세션 관리에 적합합니다. |
+| **JUnit** | JUnit Jupiter/Platform/Vintage 등 모듈형 구성 덕분에 유연하고 확장 가능한 테스트 환경을 제공하여 사용했습니다. |
+| **AssertJ** | 외부 의존성을 모킹해 특정 단위만 독립적으로 테스트할 수 있습니다.<br>호출 검증, 다양한 입력 조건 설정 등 정교한 테스트 시나리오 구현이 가능하여 선택했습니다. |
+| **Swagger** | 클라이언트–서버 간 API 명세서로 활용하기 위해 사용했습니다. |
+
+
+## 💬 Commit Convention
+> e.g. feat: 카카오 로그인 구현 #1
+
+| Type       | 내용                                |
+|------------| --------------------------------- |
+| `feat`     | 새로운 기능 추가                         |
+| `fix`      | 버그 수정                             |
+| `hotfix`   | 서비스 장애 등 긴급 이슈 수정                 |
+| `test`     | 테스트 코드 추가 및 수정, 삭제                |
+| `refactor` | 코드 리팩토링                           |
+| `deploy`   | 배포 관련 작업 (CI/CD, 서버 설정, 배포 스크립트 등) |
+| `setting`  | 개발 환경 세팅|