Feat: HTTPS 적용 및 테스트 완료한버전 main으로 merge

.github/workflows/deploy.yml

@@ -1,11 +1,103 @@
-name: UMC Dev CI/CD // 여러분들 맘대로 이름 지으세요
+name: CI/CD Pipeline
 
 on:
-  pull_request:
-    types: [closed]
-  workflow_dispatch: # (2).수동 실행도 가능하도록
+  push:
+    branches: [ develop, main ]
 
 jobs:
   build:
-    runs-on: ubuntu-latest # (3).OS환경
-    if: github.event.pull_request.merged == true && github.event.pull_request.base.ref == 'develop'
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v3
+
+      - name: Set up JDK 17
+        uses: actions/setup-java@v3
+        with:
+          distribution: 'temurin'
+          java-version: '17'
+
+      # application.yml 생성 방식 변경
+      - name: Make application.yml
+        run: |
+          cd ./src/main/resources
+          # EOF에 따옴표(')를 붙여서 쉘이 ${...}를 건드리지 못하게 막습니다.
+          cat << 'EOF' > ./application.yml
+          ${{ secrets.APPLICATION_YML }}
+          EOF
+        shell: bash
+
+      - name: Grant execute permission for gradlew
+        run: chmod +x gradlew
+
+      - name: Build with Gradle
+        uses: gradle/gradle-build-action@v2
+        with:
+          arguments: build -x test
+
+      - name: Upload build artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: digitalTok
+          path: build/libs/*.jar
+
+  deploy:
+    needs: build
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Download build artifact
+        uses: actions/download-artifact@v4
+        with:
+          name: digitalTok
+          path: build/libs/
+
+      # env 추가 및 run.sh 생성
+      - name: Deploy to EC2
+        env:
+          EC2_SSH_KEY: ${{ secrets.EC2_SSH_KEY }}
+          EC2_USERNAME: ${{ secrets.EC2_USERNAME }}
+          EC2_HOST: ${{ secrets.EC2_HOST }}
+        run: |
+          echo "$EC2_SSH_KEY" > private_key.pem
+          chmod 600 private_key.pem
+          jar_file=$(find build/libs -name '*.jar' ! -name '*plain.jar' | head -n 1)
+
+          # 파일 전송
+          scp -i private_key.pem -o StrictHostKeyChecking=no "$jar_file" $EC2_USERNAME@$EC2_HOST:/home/$EC2_USERNAME/digitalTok.jar
+
+          # 실행 스크립트 생성 (run.sh)
+          cat <<EOF > run.sh
+          #!/bin/bash
+
+          # 1. 기존 자바 프로세스 강제 종료
+          pgrep java | xargs -r kill -9
+          sleep 5
+
+          # DB 및 AWS 환경변수 설정
+          export DB_URL='${{ secrets.DB_URL }}'
+          export DB_USERNAME='${{ secrets.DB_USERNAME }}'
+          export DB_PASSWORD='${{ secrets.DB_PASSWORD }}'
+          export AWS_ACCESS_KEY='${{ secrets.AWS_ACCESS_KEY }}'
+          export AWS_SECRET_KEY='${{ secrets.AWS_SECRET_KEY }}'
+          export SPRING_CLOUD_AWS_REGION_STATIC=ap-northeast-2
+
+          # 이메일 환경변수 설정
+          export MAIL_USERNAME='${{ secrets.MAIL_USERNAME }}'
+          export MAIL_PASSWORD='${{ secrets.MAIL_PASSWORD }}'
+
+          # 서버 실행 명령어
+          # -Djwt.secret 옵션으로 스프링이 찾는 이름에 맞춰서 값을 직접 넣어줌
+          nohup java -Duser.timezone=Asia/Seoul \
+          -Dapp.server-url='https://diring.site' \
+          -Djwt.secret='${{ secrets.JWT_SECRET_KEY }}' \
+          -Djwt.access-token-validity-in-seconds=1800 \
+          -Djwt.refresh-token-validity-in-seconds=604800 \
+          -jar /home/$EC2_USERNAME/digitalTok.jar > app.log 2>&1 &
+          EOF
+
+          # 스크립트 전송 및 실행
+          scp -i private_key.pem -o StrictHostKeyChecking=no run.sh $EC2_USERNAME@$EC2_HOST:/home/$EC2_USERNAME/run.sh
+          ssh -i private_key.pem -o StrictHostKeyChecking=no $EC2_USERNAME@$EC2_HOST "chmod +x /home/$EC2_USERNAME/run.sh && sh /home/$EC2_USERNAME/run.sh"
+
+          rm -f private_key.pem run.sh

.gitignore

@@ -41,4 +41,23 @@ Thumbs.db
 
 ### [Custom Settings] ###
 # 나중에 DB 정보나 API Key가 들어있는 설정 파일을 숨길 때 사용하세요.
-# application-secret.properties
+# application-secret.properties
+
+### [Security & AWS] ###
+# EC2 접속을 위한 키 파일 (해킹 위험 1순위, 절대 금지)
+*.pem
+
+# 환경변수 설정 파일
+.env
+
+### [Spring Boot Config - Safety] ###
+# 우리가 만들기로 했던 배포용 설정 파일 (실수 방지용)
+src/main/resources/application-prod.yml
+src/main/resources/application-secret.yml
+
+# 혹시 모를 로컬 테스트용 설정 파일들
+application-prod.yml
+application-secret.yml
+
+#debug용 파일은 업로드 되지 않게
+debug-output

README.md

@@ -1,90 +1,103 @@
-> **프로젝트 한 줄 소개:** 나만의 전자 잉크 키링 서비
+# 🏷️ 나만의 전자 잉크 키링 서비스, DiRing (디링)
 
 ![Java](https://img.shields.io/badge/Java-17-007396?style=flat&logo=java&logoColor=white)
 ![Spring Boot](https://img.shields.io/badge/Spring%20Boot-3.5.9-6DB33F?style=flat&logo=springboot&logoColor=white)
 ![MySQL](https://img.shields.io/badge/MySQL-8.0-4479A1?style=flat&logo=mysql&logoColor=white)
+![AWS](https://img.shields.io/badge/AWS-EC2%20%2F%20S3%20%2F%20RDS-232F3E?style=flat&logo=amazon-aws&logoColor=white)
+
+> **"당신의 일상을 키링에 담다."** <br>
+> 사용자가 원하는 템플릿이나 이미지를 선택하면 전자 잉크(E-ink) 디스플레이에 맞는 이미지로 변환하여 전자 잉크(E-ink)키링 디바이스로 전송해주는 서비스입니다.
+
+<br>
+
+## 🌐 Swagger API Docs
+- **URL:** [http://3.37.213.174:8080/swagger-ui/index.html](http://3.37.213.174:8080/swagger-ui/index.html)
 
 <br>
 
 ## 1. 🚩 프로젝트 개요
 - **개발 기간:** 2025.12.12 ~ 2026.02.19
-- **개발 인원:** Backend 3
-- **프로젝트 목적:**
+- **개발 인원:** 4명 (Backend Team)
+
+### 👨‍💻 팀원 및 담당 역할 (R&R)
+
+| 이름 | 포지션 | 담당 도메인 및 핵심 기여 |
+| :---: | :---: | :--- |
+| [**이정헌**](https://github.com/LeeJeongHeon02) | **Team Leader** | • **Template & CI/CD** <br>• 지하철 템플릿 이미지 생성 로직 구현 <br>• GitHub Actions 파이프라인 구축 및 서버 관리 |
+| [**송정은**](https://github.com/jeun66) | **Sub Leader** | • **Image Processing** <br>• E-ink 전용 4-Color Quantization(양자화) 알고리즘 구현 <br>• 이미지 ↔ 바이너리 데이터 인코딩/디코딩 로직 개발 |
+| [**이승주**](https://github.com/dudulic) | **Member** | • **Auth & Security** <br>• JWT 기반 인증/인가 시스템 및 Refresh Token 로테이션 <br>• SMTP 기반 이메일 인증 기능 구현 |
+| [**조성하**](https://github.com/cdth12345) | **Member** | • **Device & User** <br>• 사용자 프로필 관리 및 디바이스 연동 API 개발 |
 
 <br>
 
 ## 2. 📚 사용 기술 (Tech Stack)
 
-| 구분 | 기술 |
-| :-: | - |
-| **Language** | Java 17 |
-| **Framework** | Spring Boot 3.5.9, Spring Security, Spring Data JPA |
-| **Database** | MySQL, Redis |
-| **Infra** | AWS EC2, RDS, Docker |
-| **Collaboration** | Git, Notion, Discord |
+| 구분 | 기술 | 상세 내용 |
+| :-: | :-: | - |
+| **Language** | Java 17 |  |
+| **Framework** | Spring Boot 3.5.9 | Spring Security, Spring Data JPA |
+| **Database** | MySQL 8.0 | AWS RDS (Prod), H2 (Test) |
+| **Infra** | AWS | EC2, S3 (Image Storage), RDS |
+| **CI/CD** | GitHub Actions | Gradle Build -> SCP Transfer -> Deploy Script |
+| **Utils** | ImageIO, Java AWT | 이미지 생성 및 픽셀 처리 |
 
 <br>
 
-## 3.🤝 Team Convention (협업 규칙)
-
-### 3-1. Branch Strategy - Git Flow 전략
+## 3. ✨ 주요 기능 (Key Features)
 
-* **main**: 배포 가능한 상태의 코드가 모이는 브랜치
-* **develop**: 다음 버전을 위한 개발이 진행되는 주 브랜치
-* **feature**: 기능을 개발하는 브랜치 (develop에서 분기)
-    * 브랜치 명: `feature/이슈번호-기능요약`
-    * 예시: `feature/12-login-api`
-* **hotfix**: 배포된 버전에서 발생한 버그를 긴급 수정 (main에서 분기)
+### 🔐 1. 인증 및 보안 (Auth & Security)
+- **JWT 기반 로그인:** Access/Refresh Token을 활용한 무상태(Stateless) 인증.
+- **이메일 인증:** Google SMTP를 연동하여 비밀번호 찾기 시 새로운 비밀번호 자동 발송.
 
+### 🖼️ 2. 템플릿 이미지 생성 (Template Engine)
+- **동적 이미지 드로잉:** Java AWT/Graphics2D를 활용해 실시간으로 이미지를 그려냅니다.
+- **커스텀 폰트 적용:** `Pretendard` 폰트를 서버 리소스에 내장하여 일관된 타이포그래피 제공.
 
-### 3-2. Commit Message Convention
-- 제목은 50글자 이내로 작성한다.
-- 첫글자는 대문자로 작성한다.
-- 마침표 및 특수기호는 사용하지 않는다.
-- 영문으로 작성하는 경우 동사(원형)을 가장 앞에 명령어로 작성한다.
-- 과거시제는 사용하지 않는다.
-- 간결하고 요점적으로 즉, 개조식 구문으로 작성한다.
-### 구조 및 작성예시
-```text
-Feat: 회원가입 시 이메일 중복 검사 로직 추가
+### 🎨 3. 전자 잉크 이미지 처리 (E-ink Processing)
+- **4-Color Quantization:** 일반 이미지를 E-ink 디스플레이가 표현 가능한 4색(Black, White, Red, Yellow)으로 최적화하여 변환합니다.
+- **Binary Encoding:** 변환된 픽셀 데이터를 하드웨어(키링)로 전송하기 위해 경량화된 바이너리 포맷으로 인코딩합니다.
 
-기존에 아이디만 중복 검사하던 로직에 이메일 검사 추가함.
-DB 쿼리 최적화 포함.
+### ☁️ 4. 스토리지 및 데이터 관리
+- **AWS S3 연동:** 생성된 템플릿 이미지와 사용자 업로드 이미지를 S3 버킷에 안전하게 저장합니다.
+- **트랜잭션 관리:** 이미지 업로드 실패 시 S3 파일 삭제 등 롤백 처리 이벤트 핸들링 로직 구현.
 
-Resolves: #123
+<br>
 
-```
+## 4. 🏗️ 아키텍처 및 설계 (Architecture)
 
-## 4. 🏗️ 아키텍처 및 설계 (Architecture & Design)
 ### 4-1. 시스템 아키텍처
-<img width="2816" height="1536" alt="digitaltok 아키텍처구조" src="https://github.com/user-attachments/assets/f65c9d9c-9503-405d-bc6b-97a074a7efa3" />
+<img width="80%" alt="최종 시스템 아키텍처" src="https://github.com/user-attachments/assets/4c868be5-8523-4106-b7e1-e899430b431d" />
 
 ### 4-2. ERD (Entity Relationship Diagram)
-*(여기에 ERD 이미지를 넣으세요)*
-<img width="1268" height="747" alt="스크린샷 2026-01-14 205456" src="https://github.com/user-attachments/assets/4f4ae8b4-ed71-4918-99e8-8cba38ba153a" />
-
-
-<br>
-
-## 5. ✨ 주요 기능 (Key Features)
-* **회원가입/로그인:** JWT 기반 인증, OAuth2 (Kakao, Google)
-* **이미지 생성:** S3를 이용한 이미지 업로드
+<img width="80%" alt="ERD" src="https://github.com/user-attachments/assets/c9bbada4-d5ea-4f07-b06b-35df1140d490" />
 
 <br>
 
+## 5. 📂 디렉토리 구조 (Directory Structure)
+도메인형 디렉토리 구조(Domain-driven)를 채택하여 응집도를 높였습니다.
 
-## 6. 📂 디렉토리 구조 (Directory Structure)
 ```bash
-src
-├── main
-│   ├── java
-│   │   └── com.example.project
-│   │       ├── common       # 공통 처리 (Exception, DTO)
-│   │       ├── config       # 설정 파일
-│   │       ├── controller   # 컨트롤러
-│   │       ├── domain       # 엔티티
-│   │       ├── repository   # 리포지토리
-│   │       └── service      # 비즈니스 로직
-│   └── resources
-└── test
-
+digitaltok-server/
+├── .github/                # GitHub 관련 설정 (CI/CD 워크플로우, 이슈/PR 템플릿)
+├── gradle/                 # Gradle Wrapper 관련 설정
+├── src/
+│   ├── main/
+│   │   ├── java/com/digital_tok/
+│   │   │   ├── global/     # 공통 설정 (Security, Exception, API 응답 규격 등)
+│   │   │   ├── auth/       # 인증 및 인가 (Login, JWT 등)
+│   │   │   │   ├── controller      # 컨트롤러
+│   │   │   │   ├── convertor       # Entity, DTO 간의 변환
+│   │   │   │   ├── domain          # 엔티티
+│   │   │   │   ├── dto             # DTO 클래스
+│   │   │   │   ├── repository      # 리포지토리
+│   │   │   │   └── service         # 비즈니스 로직
+│   │   │   ├── device/     # 디바이스 관리 도메인
+│   │   │   ├── image/      # 이미지 처리 및 스토리지(S3) 관련
+│   │   │   ├── template/   # 템플릿 관리 및 이미지 생성 로직
+│   │   │   ├── user/       # 사용자 관리 도메인
+│   │   │   └── DigitalTokApplication.java  # 애플리케이션 시작점
+│   │   └── resources/      # 설정 파일(yml), 폰트 등의 리소스
+│   └── test/               # 테스트 코드 (JUnit5 등)
+├── build.gradle            # 프로젝트 의존성 및 빌드 설정
+├── gradlew                 # Gradle 실행 스크립트
+└── README.md               # 프로젝트 설명 문서

build.gradle

@@ -5,7 +5,7 @@ plugins {
 }
 
 group = 'com.digital-tok'
-version = '0.0.1-SNAPSHOT'
+version = '1.0.0'
 description = 'E-Ink digital-tok service'
 
 java {
@@ -24,6 +24,11 @@ repositories {
 	mavenCentral()
 }
 
+// [추가할 부분 1] 빌드된 jar 파일 이름을 버전 없이 고정
+bootJar {
+	archiveFileName = 'digitalTok.jar'
+}
+
 dependencies {
 	implementation 'org.springframework.boot:spring-boot-starter-data-jpa'
 	implementation 'org.springframework.boot:spring-boot-starter-validation'
@@ -35,6 +40,28 @@ dependencies {
 	annotationProcessor 'org.projectlombok:lombok'
 	testImplementation 'org.springframework.boot:spring-boot-starter-test'
 	testRuntimeOnly 'org.junit.platform:junit-platform-launcher'
+
+	// AWS SDK
+	implementation 'software.amazon.awssdk:s3:2.29.0'
+
+    // Swagger
+    implementation 'org.springdoc:springdoc-openapi-starter-webmvc-ui:2.8.13'
+    implementation 'org.springdoc:springdoc-openapi-starter-webmvc-api:2.8.13'
+
+	// AWS S3 (Spring Cloud AWS 3.x)
+	implementation platform("io.awspring.cloud:spring-cloud-aws-dependencies:3.1.0")
+	implementation 'io.awspring.cloud:spring-cloud-aws-starter-s3'
+
+    // Spring Security
+    implementation 'org.springframework.boot:spring-boot-starter-security'
+
+    // JWT 라이브러리 (JJWT 0.12.3 버전)
+    implementation 'io.jsonwebtoken:jjwt-api:0.12.3'
+    runtimeOnly 'io.jsonwebtoken:jjwt-impl:0.12.3'
+    runtimeOnly 'io.jsonwebtoken:jjwt-jackson:0.12.3'
+
+    // 이메일 발송 라이브러리
+    implementation 'org.springframework.boot:spring-boot-starter-mail'
 }
 
 tasks.named('test') {

src/main/java/com/digital_tok/DigitalTokApplication.java

@@ -2,8 +2,12 @@
 
 import org.springframework.boot.SpringApplication;
 import org.springframework.boot.autoconfigure.SpringBootApplication;
+import org.springframework.data.jpa.repository.config.EnableJpaAuditing;
+import org.springframework.scheduling.annotation.EnableAsync;
 
 @SpringBootApplication
+@EnableJpaAuditing
+@EnableAsync // 비동기 처리 활성화
 public class DigitalTokApplication {
 
 	public static void main(String[] args) {