Feature/spring to ktor migration

.env.example

@@ -0,0 +1,30 @@
+# 데이터베이스 설정
+DB_HOST=localhost
+DB_USER=hmh_user
+DB_PASSWORD=your_db_password
+DB_NAME=hmh
+
+# JWT 설정
+JWT_SECRET=your-super-secret-jwt-key-change-this-in-production-minimum-32-characters
+JWT_ISSUER=hmh-server
+JWT_AUDIENCE=hmh-client
+
+# 카카오 OAuth
+KAKAO_CLIENT_ID=your_kakao_client_id
+KAKAO_CLIENT_SECRET=your_kakao_client_secret
+KAKAO_REDIRECT_URI=http://your-domain.com/auth/kakao/callback
+
+# 애플 OAuth
+APPLE_TEAM_ID=your_apple_team_id
+APPLE_KEY_ID=your_apple_key_id
+APPLE_CLIENT_ID=your_apple_client_id
+
+# Slack 웹훅 (선택사항)
+SLACK_ERROR_WEBHOOK_URL=https://hooks.slack.com/services/your/slack/webhook
+SLACK_NEW_USER_WEBHOOK_URL=https://hooks.slack.com/services/your/slack/webhook
+
+# CORS 설정
+ALLOWED_HOSTS=localhost:3000,your-domain.com,your-app-name.herokuapp.com
+
+# 배포 환경
+DEPLOYMENT_GROUP_NAME=hmh-dev-deploy-group

CLAUDE.md

@@ -0,0 +1,99 @@
+# HMH 프로젝트 - Spring Boot to Ktor 마이그레이션
+
+## 프로젝트 개요
+- **프로젝트명**: HMH (Habit Making Helper)
+- **현재 상태**: Spring Boot 3.2.1 + Java 17 기반
+- **목표**: Ktor + Kotlin으로 마이그레이션
+- **그룹ID**: sopt.org
+- **버전**: 0.0.1-SNAPSHOT
+
+## 현재 기술 스택 (Spring Boot)
+- **언어**: Java 17
+- **프레임워크**: Spring Boot 3.2.1
+- **빌드 도구**: Gradle
+- **데이터베이스**: MySQL
+- **ORM**: Spring Data JPA + QueryDSL
+- **보안**: Spring Security + JWT
+- **API 문서**: SpringDoc OpenAPI (Swagger)
+- **외부 연동**: OpenFeign (카카오, 애플 로그인)
+- **모니터링**: Slack API
+
+## 도메인 구조
+프로젝트는 다음과 같은 도메인으로 구성되어 있습니다:
+
+### 핵심 도메인
+- **auth**: 인증/인가 (소셜 로그인, JWT)
+- **user**: 사용자 관리
+- **challenge**: 챌린지 관리
+- **dailychallenge**: 일일 챌린지
+- **app**: 앱 관리 및 히스토리
+- **point**: 포인트 시스템
+- **admin**: 관리자 기능
+- **banner**: 배너 관리
+
+### 인프라/공통
+- **global/auth**: JWT, 소셜 로그인 (카카오, 애플)
+- **global/common**: 공통 예외, 응답 포맷
+- **global/config**: 설정 클래스들
+- **slack**: 슬랙 알림
+
+## 주요 기능
+1. **소셜 로그인**: 카카오, 애플 OAuth 연동
+2. **JWT 기반 인증**: 토큰 발급/재발급
+3. **챌린지 시스템**: 사용자 습관 관리
+4. **포인트 시스템**: 챌린지 완료 시 포인트 적립
+5. **관리자 기능**: 사용자 및 챌린지 관리
+6. **슬랙 모니터링**: 에러 및 신규 유저 알림
+
+## 마이그레이션 고려사항
+
+### 의존성 매핑
+- Spring Boot Web → Ktor Server
+- Spring Data JPA → Exposed ORM 또는 Ktorm
+- Spring Security → Ktor Authentication
+- QueryDSL → Kotlin SQL DSL
+- OpenFeign → Ktor Client
+- SpringDoc → Ktor OpenAPI Plugin
+
+### 아키텍처 패턴
+현재 계층형 아키텍처 (Controller-Service-Repository)를 유지하되, Kotlin 관례에 맞게 조정
+
+### 보안 고려사항
+- JWT 처리 방식
+- 소셜 로그인 연동 방식
+- CORS 설정
+- 인증/인가 미들웨어
+
+## 빌드 및 실행
+
+### 현재 (Gradle)
+```bash
+./gradlew build
+./gradlew test
+./gradlew bootRun
+```
+
+### 배포 스크립트
+- `script/start.sh`: 서버 시작
+- `script/stop.sh`: 서버 종료
+- `appspec.yml`: AWS CodeDeploy 설정
+
+## 환경 설정
+- `local.properties`: 로컬 환경 변수
+- MySQL 데이터베이스 연결 필요
+- JWT 시크릿 키 설정 필요
+- 카카오/애플 OAuth 클라이언트 정보 필요
+- 슬랙 웹훅 URL 설정 필요
+
+## 중요 노트
+- 현재 프로젝트는 삭제된 README.md가 있음 (git status 확인)
+- 테스트 커버리지 확인 필요
+- API 문서 호환성 확인 필요
+- 데이터베이스 마이그레이션 스크립트 작성 필요
+
+## 마이그레이션 우선순위
+1. 핵심 인프라 (서버, 데이터베이스 연결)
+2. 인증/인가 시스템
+3. 핵심 도메인 (user, challenge)
+4. 외부 연동 (소셜 로그인)
+5. 부가 기능 (포인트, 관리자, 배너)

DEPLOYMENT.md

@@ -0,0 +1,180 @@
+# HMH Ktor Server 배포 가이드
+
+## 🚀 배포 방법 선택
+
+### 방법 1: Docker를 사용한 배포 (추천)
+
+#### 1.1 사전 준비
+```bash
+# Docker 및 Docker Compose 설치 확인
+docker --version
+docker-compose --version
+```
+
+#### 1.2 환경 변수 설정
+```bash
+# 환경 변수 파일 복사 및 수정
+cp .env.example .env
+vi .env  # 실제 값으로 수정
+```
+
+#### 1.3 Docker로 실행
+```bash
+# 애플리케이션 빌드 및 실행
+docker-compose up -d
+
+# 로그 확인
+docker-compose logs -f hmh-server
+
+# 상태 확인
+docker-compose ps
+```
+
+#### 1.4 접속 확인
+```bash
+# 헬스체크
+curl http://localhost:8080/health
+
+# API 테스트
+curl http://localhost:8080/api/v1/point/earn
+```
+
+### 방법 2: AWS EC2 인스턴스 배포
+
+#### 2.1 EC2 인스턴스 준비
+```bash
+# Ubuntu 20.04 LTS 추천
+# 인스턴스 타입: t3.micro 이상
+# 보안 그룹: 8080 포트 개방
+```
+
+#### 2.2 서버 환경 설정
+```bash
+# Java 17 설치
+sudo apt update
+sudo apt install openjdk-17-jdk -y
+
+# MySQL 설치 (또는 RDS 사용)
+sudo apt install mysql-server -y
+
+# Git 설치
+sudo apt install git -y
+```
+
+#### 2.3 애플리케이션 배포
+```bash
+# 프로젝트 클론
+git clone <your-repository-url> /home/ubuntu/app
+cd /home/ubuntu/app
+
+# 환경 변수 설정
+cp .env.example .env
+sudo vi .env  # 실제 값으로 수정
+
+# 배포 스크립트 실행
+./script/ktor-start.sh
+```
+
+### 방법 3: Heroku 배포 (간단한 테스트용)
+
+#### 3.1 Heroku CLI 설치 및 로그인
+```bash
+# Heroku CLI 설치
+# https://devcenter.heroku.com/articles/heroku-cli
+
+heroku login
+```
+
+#### 3.2 Heroku 앱 생성
+```bash
+heroku create your-app-name
+```
+
+#### 3.3 환경 변수 설정
+```bash
+heroku config:set JWT_SECRET=your-secret-key
+heroku config:set DB_HOST=your-db-host
+heroku config:set DB_USER=your-db-user
+heroku config:set DB_PASSWORD=your-db-password
+# ... 기타 환경 변수들
+```
+
+#### 3.4 배포
+```bash
+git add .
+git commit -m "Deploy to Heroku"
+git push heroku main
+```
+
+## 🔧 운영 환경 설정
+
+### 환경 변수 필수 설정
+
+1. **데이터베이스 설정**
+   - `DB_HOST`: 데이터베이스 호스트
+   - `DB_USER`: 데이터베이스 사용자
+   - `DB_PASSWORD`: 데이터베이스 비밀번호
+
+2. **보안 설정**
+   - `JWT_SECRET`: 32자 이상의 안전한 비밀키
+   - `ALLOWED_HOSTS`: 허용할 도메인 목록
+
+3. **OAuth 설정 (선택사항)**
+   - `KAKAO_CLIENT_ID`, `KAKAO_CLIENT_SECRET`
+   - `APPLE_TEAM_ID`, `APPLE_KEY_ID`, `APPLE_CLIENT_ID`
+
+### 로그 모니터링
+
+```bash
+# Docker 환경
+docker-compose logs -f hmh-server
+
+# 일반 환경
+tail -f logs/application.log
+```
+
+### 헬스체크 엔드포인트
+
+- `GET /health` - 기본 상태 확인
+- `GET /health/ready` - 준비 상태 확인
+- `GET /health/live` - 생존 상태 확인
+
+## 🐛 트러블슈팅
+
+### 일반적인 문제들
+
+1. **포트 충돌**
+   ```bash
+   # 8080 포트 사용 중인 프로세스 확인
+   lsof -i :8080
+
+   # 프로세스 종료
+   sudo kill -9 <PID>
+   ```
+
+2. **데이터베이스 연결 실패**
+   - DB 호스트, 포트, 사용자 정보 확인
+   - 방화벽 설정 확인
+   - MySQL 서비스 상태 확인
+
+3. **JWT 오류**
+   - JWT_SECRET 환경 변수 설정 확인
+   - 32자 이상의 안전한 키 사용
+
+4. **메모리 부족**
+   ```bash
+   # Java 힙 메모리 제한 설정
+   export JAVA_OPTS="-Xmx512m -Xms256m"
+   ```
+
+## 📊 모니터링
+
+### 권장 모니터링 도구
+- **로그**: ELK Stack 또는 CloudWatch
+- **메트릭**: Prometheus + Grafana
+- **알림**: Slack 웹훅 활용
+
+### 성능 최적화
+- DB 커넥션 풀 크기 조정
+- JVM 힙 메모리 튜닝
+- Nginx 리버스 프록시 사용

Dockerfile

@@ -0,0 +1,38 @@
+# HMH Ktor Server Dockerfile
+FROM openjdk:17-jdk-slim
+
+# 작업 디렉토리 설정
+WORKDIR /app
+
+# 시스템 패키지 업데이트 및 필요한 도구 설치
+RUN apt-get update && apt-get install -y \
+    curl \
+    && rm -rf /var/lib/apt/lists/*
+
+# Gradle Wrapper와 소스 코드 복사
+COPY gradlew .
+COPY gradle gradle
+COPY build.gradle.kts .
+COPY settings.gradle .
+COPY gradle.properties .
+COPY src src
+
+# 빌드 권한 설정
+RUN chmod +x ./gradlew
+
+# 애플리케이션 빌드
+RUN ./gradlew build -x test
+
+# 포트 노출
+EXPOSE 8080
+
+# 환경 변수 설정
+ENV KTOR_ENV=prod
+ENV KTOR_PORT=8080
+
+# 헬스체크 설정
+HEALTHCHECK --interval=30s --timeout=3s --start-period=30s --retries=3 \
+    CMD curl -f http://localhost:8080/health || exit 1
+
+# 애플리케이션 실행
+CMD ["./gradlew", "run"]