ReTrip-Dev · Bumnote · Sep 13, 2025 · Jul 20, 2025 · Aug 6, 2025 · Sep 13, 2025
diff --git a/README.md b/README.md
@@ -1,13 +1,6 @@
-# 🌄 Retrip - 여행을 요약해주는 새로운 방식의 SNS
-- Retrip은 여행을 좋아하는 사람들을 위한 이미지 기반 여행 요약 SNS입니다. 사용자가 업로드한 여행 사진 속 메타데이터와 이미지 정보를 기반으로, 여행의 전체적인 분위기와 정보를 하나의 이미지로 요약해주는 특별한 서비스를 제공합니다.
+# 🌄 ReTrip - 여행을 요약해주는 새로운 방식의 SNS
 
-![readme_mockup2]()
-
-- 배포 URL : 
-- Test ID : 
-- Test PW : 
-
-<br>
+Retrip은 여행을 좋아하는 사람들을 위한 이미지 기반 여행 요약 SNS입니다. 사용자가 업로드한 여행 사진 속 메타데이터와 이미지 정보를 기반으로, 여행의 전체적인 분위기와 정보를 하나의 이미지로 요약해주는 특별한 서비스를 제공합니다.
 
 ## 프로젝트 소개 
 
@@ -31,30 +24,105 @@
 
 ## 1. 개발 환경
 
-- Front : HTML, Vue3
-- Back-end : 제공된 API 활용
-- 버전 및 이슈관리 : Github, Github Issues, Github Project
-- 협업 툴 : Discord, Notion
-- 서비스 배포 환경 :
+- **Front**: HTML, Vue3, Vuetify3
+- **Back-end**: Spring Boot 3.4.5, Java 21, Spring Data JPA, Spring Security
+- **Database**: MySQL, Redis
+- **AI/ML**: OpenAI GPT-4 Vision API
+- **인프라**: Docker, Nginx, AWS S3
+- **버전 및 이슈관리**: Github, Github Issues, Github Project
+- **협업 툴**: Discord, Notion
+- **서비스 배포 환경**: AWS EC2, Docker Compose
 
 <br>
 
 ## 2. 채택한 개발 기술과 브랜치 전략
 
+### 기술 스택 상세
+
+#### Backend Framework
+- **Spring Boot 3.4.5** (Java 21) - 최신 LTS 버전 사용으로 안정성 확보
+- **Spring Web MVC** - RESTful API 구현
+- **Spring Data JPA** - ORM을 통한 효율적인 데이터베이스 관리
+- **Spring Security** - OAuth2 기반 소셜 로그인 (Kakao)
+
+#### AI & 이미지 처리
+- **OpenAI GPT-4 Vision API** - 이미지 분석 및 여행 패턴 인식
+- **metadata-extractor 2.18.0** - EXIF 메타데이터 추출 (GPS, 시간 정보)
+- **TwelveMonkeys ImageIO** - HEIF, HEIC 등 다양한 이미지 포맷 지원
+- **Thumbnailator** - 이미지 리사이징 및 최적화
+
+#### 모니터링
+- **Spring Actuator** - 애플리케이션 상태 모니터링
+- **Prometheus & Micrometer** - 메트릭 수집 및 모니터링
+
+### 브랜치 전략
+- **main**: 프로덕션 배포 브랜치
+- **dev**: 개발 통합 브랜치
+- **feature/기능명**: 기능 개발 브랜치
+- **refactor/리팩토링명**: 리팩토링 브랜치
 
 <br>
 
 ## 3. 프로젝트 구조
 
+```
+retrip-api/
+├── src/main/java/ssafy/retrip/
+│   ├── api/
+│   │   ├── controller/          # REST API 엔드포인트
+│   │   │   └── retrip/
+│   │   │       ├── RetripController.java
+│   │   │       └── response/    # API 응답 DTO
+│   │   └── service/
+│   │       ├── openai/          # OpenAI GPT 연동
+│   │       │   ├── GptImageAnalysisService.java
+│   │       │   ├── OpenAiClient.java
+│   │       │   └── response/    # GPT 응답 모델
+│   │       └── retrip/          # 핵심 비즈니스 로직
+│   │           ├── RetripService.java
+│   │           ├── ImageConverter.java
+│   │           └── info/        # 도메인 정보 객체
+│   ├── config/                  # 설정 클래스
+│   │   ├── SecurityConfig.java  # Spring Security 설정
+│   │   ├── OpenAiConfig.java    # OpenAI 클라이언트 설정
+│   │   ├── RedisConfig.java     # Redis 설정
+│   │   └── WebConfig.java       # CORS 설정
+│   ├── domain/                  # JPA 엔티티
+│   │   ├── retrip/
+│   │   │   ├── Retrip.java      # 여행 요약 엔티티
+│   │   │   ├── TimeSlot.java    # 시간대 Enum
+│   │   │   └── RetripRepository.java
+│   │   └── place/
+│   │       └── RecommendationPlace.java  # 추천 장소 엔티티
+│   └── utils/                   # 유틸리티 클래스
+│       ├── ImageMetaDataUtil.java  # 이미지 메타데이터 추출
+│       ├── CoordinateUtil.java     # GPS 좌표 처리
+│       └── DistanceUtil.java       # 거리 계산
+├── docker/                      # Docker 설정
+├── nginx/                       # Nginx 설정 (SSL, 리버스 프록시)
+├── scripts/                     # 배포 스크립트
+└── src/main/resources/
+    ├── application.yml          # 애플리케이션 설정
+    └── analysis.prompt          # GPT 분석 프롬프트
+```
+
 <br>
 
 ## 4. 역할 분담
 
 ### 💁🏻‍♂️ 김용범
+- AI 모델 연동 및 프롬프트 엔지니어링
+- 이미지 메타데이터 추출 및 처리
+- GPS 기반 위치 분석 로직 구현
+- Docker 및 인프라 구성
 
 <br>
 
 ### 💁🏻‍♂️ 오일우
+- Spring Boot 백엔드 아키텍처 설계
+- RESTful API 개발
+- 데이터베이스 설계 및 JPA 구현
+- Spring Security 및 OAuth2 인증 구현
 
 <br>
 
@@ -63,37 +131,146 @@
 ### 개발 기간
 
 - 전체 개발 기간 : 2025-04-28 ~ ing
-- UI 구현 : 2025-05-15 ~ ing
-- 기능 구현 : 2022-05-12 ~ ing
+- 백엔드 API 개발 : 2025-04-28 ~ 2025-05-10
+- AI 모델 연동 : 2025-05-11 ~ 2025-05-20
+- 인프라 구축 : 2025-05-21 ~ 2025-05-25
+- 테스트 및 최적화 : 2025-05-26 ~ ing
 
 <br>
 
 ### 작업 관리
 
+- Github Projects를 활용한 칸반 보드 운영
+- 주 2회 정기 미팅을 통한 진행상황 공유
+- Discord를 통한 실시간 커뮤니케이션
 
 <br>
 
 ## 6. 신경 쓴 부분
 
+### 🎯 이미지 처리 최적화
+- 대용량 이미지 처리를 위한 메모리 효율적인 리사이징
+- HEIF/HEIC 등 최신 이미지 포맷 지원
+- 메타데이터 보존하면서 이미지 크기 최적화
+
+### 🤖 AI 분석 정확도
+- GPT-4 Vision 프롬프트 최적화로 분석 정확도 향상
+- 이미지 메타데이터와 AI 분석 결과의 교차 검증
+- 위치 정보 기반 맞춤형 추천 알고리즘
+
+### 🔒 보안 및 안정성
+- Spring Security를 통한 인증/인가 처리
+- 이미지 업로드 시 악성 파일 검증
+- Rate Limiting으로 API 남용 방지
+
+### 📊 모니터링
+- Prometheus + Grafana를 통한 실시간 모니터링
+- 주요 비즈니스 메트릭 추적
+- 에러 로깅 및 알림 시스템
+
 <br>
 
 ## 7. 페이지별 기능
 
+### 📸 이미지 업로드 및 분석
+- 다중 이미지 업로드 (5~20장)
+- 실시간 업로드 진행률 표시
+- 이미지 미리보기 및 순서 조정
+
+### 🗺️ 여행 요약 결과
+- AI 기반 여행 스타일 분석 (MBTI, 여행 성향)
+- 시각적 여행 요약 카드 생성
+- 위치 기반 추천 장소 제공
+- 여행 통계 (이동 거리, 주요 활동 시간대 등)
+
+### 📱 SNS 공유
+- 생성된 요약 이미지 다운로드
+- 주요 SNS 플랫폼 공유 기능
+- 고유 URL을 통한 결과 공유
+
 <br>
 
 ## 8. 트러블 슈팅
 
+### 🔧 대용량 이미지 처리 메모리 이슈
+- **문제**: 고해상도 이미지 다량 업로드 시 OutOfMemoryError 발생
+- **해결**: 
+  - ImageIO 대신 TwelveMonkeys 라이브러리 사용
+  - 스트리밍 방식으로 이미지 처리
+  - 적절한 JVM 힙 메모리 설정
+
+### 🌐 CORS 이슈
+- **문제**: 프론트엔드-백엔드 간 CORS 정책 위반
+- **해결**: 
+  - WebConfig에서 명시적 CORS 설정
+  - 환경별 허용 Origin 분리 관리
+
+### ⚡ GPT API 응답 시간 최적화
+- **문제**: GPT-4 Vision API 응답 시간이 길어 UX 저하
+- **해결**: 
+  - 이미지 사전 압축으로 요청 크기 감소
+  - 비동기 처리 및 진행 상태 표시
+  - 응답 캐싱으로 재요청 시 성능 향상
+
 <br>
 
 ## 9. 개선 목표
 
+- 🚀 실시간 분석 진행률 표시 (WebSocket)
+- 🌍 다국어 지원 확대
+- 📊 더 정교한 여행 패턴 분석
+- 🎨 다양한 요약 템플릿 제공
+- 👥 소셜 기능 강화 (팔로우, 좋아요, 댓글)
+- 📱 모바일 앱 개발
+
 <br>
 
 ## 10. 프로젝트 후기
 
-### 💁🏻‍♂️ 김용범
+### 💁🏻‍♂️ 김용범
+AI 기술을 실제 서비스에 적용하면서 프롬프트 엔지니어링의 중요성을 깨달았습니다. 특히 이미지 메타데이터와 AI 분석을 결합하여 더 정확한 결과를 도출하는 과정이 흥미로웠습니다. Docker와 인프라 구성을 통해 DevOps 역량도 향상시킬 수 있었습니다.
 
+<br>
+
+### 💁🏻‍♂️ 오일우
+Spring Boot와 JPA를 활용한 백엔드 개발 경험을 쌓을 수 있었고, 특히 대용량 이미지 처리와 성능 최적화 과정에서 많은 것을 배웠습니다. OAuth2 인증과 보안 설정을 구현하면서 실무에서 필요한 보안 지식도 습득할 수 있었습니다.
 
 <br>
 
-### 💁🏻‍♂️ 오일우
+---
+
+## 🚀 Quick Start
+
+### 요구사항
+- Java 21+
+- MySQL 8.0+
+- Redis 7.0+
+- Docker & Docker Compose (선택사항)
+
+### 로컬 환경 실행
+```bash
+# 1. 프로젝트 클론
+git clone https://github.com/ReTrip-Dev/ReTrip-api.git
+cd ReTrip-api
+
+# 2. application-secret.yml 설정
+# src/main/resources/application-secret.yml 파일 생성 후 필요한 설정 추가
+
+# 3. 애플리케이션 실행
+./gradlew bootRun
+```
+
+### API 테스트
+```bash
+# 이미지 업로드 및 분석
+curl -X POST http://localhost:8080/api/images/uploads \
+  -F "images=@photo1.jpg" \
+  -F "images=@photo2.jpg" \
+  -F "images=@photo3.jpg" \
+  -F "images=@photo4.jpg" \
+  -F "images=@photo5.jpg"
+```
+
+## 📞 문의
+
+프로젝트에 대한 문의사항은 [Issues](https://github.com/ReTrip-Dev/ReTrip-api/issues)를 통해 남겨주세요.
diff --git a/build.gradle b/build.gradle
@@ -63,32 +63,27 @@ dependencies {
     testImplementation 'org.springframework.boot:spring-boot-starter-test'
     testImplementation 'org.springframework.restdocs:spring-restdocs-mockmvc'
 
-    // AWS - 중복된 의존성 제거 및 간소화
-    implementation platform('software.amazon.awssdk:bom:2.20.56')
-    implementation 'software.amazon.awssdk:s3'
-    implementation 'software.amazon.awssdk:url-connection-client'
-
-    // EXIF/메타데이터 - 안정적인 버전 사용
+    // EXIF/메타데이터
     implementation 'com.drewnoakes:metadata-extractor:2.18.0'
 
-    // TwelveMonkeys ImageIO - 안정적인 버전 사용
+    // TwelveMonkeys ImageIO
     implementation 'com.twelvemonkeys.imageio:imageio-core:3.9.4'
     implementation 'com.twelvemonkeys.imageio:imageio-jpeg:3.9.4'
     implementation 'com.twelvemonkeys.imageio:imageio-tiff:3.9.4'
 
-    // Apache Commons Imaging (실험적 의존성 제거)
+    // Apache Commons Imaging
     implementation 'org.apache.commons:commons-imaging:1.0-alpha3'
 
-    // 이미지 처리 관련 라이브러리 - 안정적인 버전으로 변경
+    // 이미지 처리 관련 라이브러리
     implementation 'net.coobird:thumbnailator:0.4.19'
 
     // Monitoring
     implementation 'org.springframework.boot:spring-boot-starter-actuator'
     implementation 'io.micrometer:micrometer-registry-prometheus'
 
     // OpenAI 연동
-    implementation("com.openai:openai-java:2.8.1")   // 공식 SDK
-    implementation("org.springframework.boot:spring-boot-starter-webflux") // SSE 스트림 전송
+    implementation 'com.openai:openai-java:2.8.1'
+
 
 }
 

diff --git a/src/main/java/ssafy/retrip/api/controller/retrip/RetripController.java b/src/main/java/ssafy/retrip/api/controller/retrip/RetripController.java
@@ -3,7 +3,9 @@
 import jakarta.servlet.http.HttpServletRequest;
 import java.io.IOException;
 import java.util.List;
+import java.util.concurrent.CompletableFuture;
 import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
 import org.springframework.http.HttpStatus;
 import org.springframework.http.ResponseEntity;
 import org.springframework.web.bind.annotation.PostMapping;
@@ -14,6 +16,7 @@
 import ssafy.retrip.api.controller.retrip.response.TravelAnalysisResponseDto;
 import ssafy.retrip.api.service.retrip.RetripService;
 
+@Slf4j
 @RestController
 @RequiredArgsConstructor
 @RequestMapping("/api/images")
@@ -22,14 +25,18 @@ public class RetripController {
   private final RetripService retripService;
 
   @PostMapping("/uploads")
-  public ResponseEntity<TravelAnalysisResponseDto> uploadMultipleImages(HttpServletRequest request,
+  public CompletableFuture<ResponseEntity<TravelAnalysisResponseDto>> uploadMultipleImages(HttpServletRequest request,
       @RequestParam("images") List<MultipartFile> images) throws IOException {
 
-    try {
-      return ResponseEntity.ok(retripService.createRetripFromImages(images));
-    } catch (Exception e) {
-      e.printStackTrace();
-      return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR).build();
-    }
+    return retripService.createRetripFromImages(images)
+        .thenApply(result -> {
+          log.info("여행 분석 완료: retripId={}", result.getRetripId());
+          return ResponseEntity.ok(result);
+        })
+        .exceptionally(ex -> {
+          log.error("여행 분석 처리 중 오류 발생", ex);
+          return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR)
+              .body(null);
+        });
   }
 }