[MERGE]: 최종 배포 develop 브랜치 병합

.github/workflows/django_CI.yml

@@ -24,7 +24,6 @@ jobs:
     - name: Install system dependencies
       run: |
         sudo apt-get update
-        sudo apt-get install -y libgl1
         sudo apt-get install -y dos2unix
         dos2unix requirements.txt
     - name: Install Dependencies
@@ -37,4 +36,4 @@ jobs:
         echo "${{ secrets.ENV_FILE }}" > .env
     - name: Run Tests
       run: |
-        python manage.py test --settings=config.settings_ci
+        python manage.py test --settings=config.settings_ci -v 2

.gitignore

@@ -15,4 +15,5 @@ db.sqlite3
 # 로그파일 무시
 *.log
 /logs
-nginx.conf
+nginx.conf
+*.sqlite3

Dockerfile

@@ -1,7 +1,6 @@
 FROM python:3.12
 
 WORKDIR /code
-RUN apt-get update && apt-get install -y libgl1
 COPY ./requirements.txt /code/
 RUN pip install -r requirements.txt
 COPY . /code/

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 임태근, 조시연
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -0,0 +1,161 @@
+# Conever Backend API
+
+<div align="center">
+  <h3>AI가 추천하는 맞춤 여행지 · 순간을 기록하고 다시 꺼내보는 리마인드</h3>
+  <p><strong>Conever 모바일 앱의 API Gateway 백엔드</strong></p>
+</div>
+
+---
+
+## 목차
+- [프로젝트 개요](#-프로젝트-개요)
+- [문제 정의 & 가치 제안](#-문제-정의--가치-제안)
+- [핵심 기능](#-핵심-기능)
+- [아키텍처 개요](#-아키텍처-개요)
+- [기술 스택](#-기술-스택)
+- [프로젝트 구조](#-프로젝트-구조)
+- [보안 · 프라이버시](#-보안--프라이버시)
+- [관측성 · 안정성](#-관측성--안정성)
+- [차별점 & 확장성](#-차별점--확장성)
+- [커밋 컨벤션](#-커밋-컨벤션)
+- [팀-백엔드](#-팀---백엔드)
+- [문의](#-문의)
+- [라이선스](#-라이선스)
+
+---
+
+## 📌 프로젝트 개요
+**Conever**는 사용자의 지역/테마 선호를 바탕으로 **AI가 여행지를 추천**하고, 여행 중 촬영한 사진을 **인생네컷 형태로 재구성**하며, 특정 주기에 **리마인드 알림**으로 추억을 다시 꺼내보게 하는 서비스입니다.  
+본 저장소는 모바일 클라이언트를 위한 **API Gateway 백엔드**로, 인증/인가, 데이터 집계, 비동기 오케스트레이션을 담당합니다.
+
+---
+
+## 🎯 문제 정의 & 가치 제안
+- **문제**: 기존 여행 서비스는 예약·길안내 중심으로, *여정의 감정과 스토리*를 기록하고 *주기적으로 리마인드*하는 경험이 부족합니다.
+- **가치**: Conever는 (1) **개인화 추천**, (2) **기록의 구조화(인생네컷)**, (3) **시간이 흐른 뒤의 재경험(리마인드)** 을 결합하여 *여행의 전체 수명 주기*를 지원합니다.
+
+---
+
+## 🎯 핵심 기능
+### 🤖 AI 기반 추천
+- 17개 시·도, 7개 카테고리 기반 개인화 추천
+- 한국관광공사 TourAPI + 생성형 AI(Gemini 2.5 Flash) 후처리 파이프라인
+
+### 📍 연관 관광지 추천
+- 실제 이동/방문 데이터 기반 연관 장소 제안
+- 인기·연관도 Top-N(예: 최대 50개) 활용, 동선 설계 보조
+
+### 📸 사진 저장 & 인생네컷
+- 촬영 사진 업로드/보관
+- 4장 자동 레이아웃 인생네컷 생성
+- (선택) 감정/스토리 태깅
+
+### 🔔 추억 리마인드
+- 3개월/6개월/1년/2년/5년 주기 알림
+- 과거 여행 기록/이미지 재노출
+
+### 🤝 동반자 & 포즈 추천
+- 관광지별 포즈 추천
+- 동반자 초대, 사진/인생네컷 공동 열람
+
+---
+
+## 🏗 아키텍처 개요
+- **API Gateway (Django/DRF)**: 인증/인가, 요청 검증, 응답 집계
+- **비동기 처리 (Celery + Redis)**: 이미지 처리, 알림 발송, 데이터 동기화
+- **데이터 레이어 (MySQL)**: 도메인 데이터 영속화
+- **파일 스토리지 (AWS S3)**: 사진/인생네컷 저장
+- **실시간/푸시 (Channels/WebSocket & FCM 연계 가능)**: (선택) 실시간 상태/알림
+- **모니터링 (Promtail → Loki → Grafana)**: 로그/지표 관제
+
+간단한 흐름(요약):
+```
+Mobile App → (Auth) → API Gateway ─┬─ MySQL
+                                   ├─ Redis/Celery (비동기)
+                                   ├─ S3 (이미지/인생네컷)
+                                   └─ 외부 API(TourAPI/Geocoder/Gemini)
+```
+
+---
+
+## 🛠 기술 스택
+- **Backend**: Django 5.x, Django REST Framework, Django Channels  
+- **DB/Cache**: MySQL 8.x, Redis 7.2.x  
+- **Queue/Schedule**: Celery 5.x, Celery Beat  
+- **Infra**: Docker, Docker Compose, Nginx, AWS S3  
+- **Monitoring**: Grafana, Loki, Promtail  
+- **External APIs**: 한국관광공사 TourAPI, Geocoder API 2.0, Google Gemini
+
+> 실제 버전은 `requirements.txt`를 기준으로 관리됩니다.
+
+---
+
+## 📂 프로젝트 구조
+```
+alphaBE/
+├── authenticate/          # 인증/인가
+├── config/                # Django 설정
+├── middleware/            # 커스텀 미들웨어
+├── services/              # 서비스 레이어(외부 API, 도메인 로직)
+├── tour/                  # 여행 도메인
+├── usr/                   # 사용자 도메인
+├── tests/                 # 테스트
+├── docker-compose.yml
+├── Dockerfile
+├── requirements.txt
+├── manage.py
+└── entrypoint.sh
+```
+
+---
+
+## 🔐 보안 · 프라이버시
+- **비밀 관리**: 모든 자격증명/키는 저장소에 포함하지 않습니다(.env, 키 파일 등은 커밋 금지).
+- **데이터 최소 수집**: 추천 및 리마인드 목적 범위 내 최소 정보만 수집·저장.
+- **익명화/가명화**: 로그·분석 단계에서 개인 식별 정보 최소화.
+- **권한 분리**: 읽기/쓰기 권한을 역할별로 분리(원칙: 최소 권한).
+
+---
+
+## 📈 관측성 · 안정성
+- **로그 파이프라인**: Promtail → Loki 집계, Grafana 대시보드 시각화
+- **비동기 오프로딩**: 이미지 처리/AI 후처리/알림 발송은 Celery로 처리 지연 최소화
+- **헬스체크/리트라이**: 외부 API 실패 대비 타임아웃·재시도 정책 설계
+- **확장성 고려**: 캐시 계층(Redis)·수평 확장 전제, WAF/Rate Limit 구성 용이
+
+---
+
+## 🚀 차별점 & 확장성
+- **여정 전·중·후 전체를 아우르는 설계**: 추천 → 기록(인생네컷) → 리마인드의 폐루프(Closed Loop).
+- **데이터 네트워크 효과**: 동반자/공유 기능으로 재참여·재방문 유도.
+- **모듈화된 AI 파이프라인**: 모델 교체·프롬프트 튜닝·후처리 모듈을 분리하여 실험 비용 절감.
+- **운영 친화성**: 로그/지표 표준화로 A/B 실험·성능 튜닝·오류 분석이 용이.
+
+---
+
+## 🧾 커밋 컨벤션
+**Conventional Commits** 권장:
+- `feat:` 기능 추가
+- `fix:` 버그 수정
+- `refactor:` 리팩터링(기능 변화 없음)
+- `chore:` 빌드/도구/패키지 갱신
+- `docs:` 문서 수정
+- `test:` 테스트 추가/개선
+
+> 기존 `MODIFY` 라벨은 `feat:` 또는 `refactor:` 등 표준 라벨로 대체를 권장합니다.
+
+---
+
+## 👥 팀 - 백엔드
+- **임태근** ([@YimTaeKeun](https://github.com/YimTaeKeun)) — 총괄, 백엔드, 기획  
+- **조시연** ([@jimmy914](https://github.com/jimmy914)) — 백엔드, 기획
+
+---
+
+## 📫 문의
+프로젝트 문의: **[email protected]**
+
+---
+
+## 📄 라이선스
+- 라이선스: `LICENSE` 파일 참조  

authenticate/tests.py

@@ -1,15 +1,19 @@
-import  unittest
-from django.test import TestCase
+import logging
+import unittest
+
+from django.test import override_settings
+from django.urls import reverse
+
 from config.settings import (
-    KAKAO_AUTH_CODE, # 임시 인가 코드를 가져옵니다. 테스트 실행시마다 .env 파일에서 매번 바꿔줘야합니다.
-    KAKAO_REFRESH_TOKEN, # 리프레시 토큰. 만료시 바꿔 사용
+    KAKAO_AUTH_CODE,  # 임시 인가 코드를 가져옵니다. 테스트 실행시마다 .env 파일에서 매번 바꿔줘야합니다.
+    # 리프레시 토큰. 만료시 바꿔 사용
     APP_LOGGER,
     SKIP_TEST,
-    KAKAO_REST_API_KEY,
+    SIMPLE_JWT,
+    REFRESH_TOKEN,
 )
-import logging
-from services.kakao_token_service import KakaoTokenService
 from tests.base import BaseTestCase
+
 logger = logging.getLogger(APP_LOGGER)
 
 # Create your tests here.
@@ -27,58 +31,79 @@ def test_login_callback(self):
         print(response.json())
         self.assertEqual(response.status_code, 201)
 
-    @unittest.skipIf(SKIP_TEST == 'True', "Skip Login Refresh Test")
-    def test_refresh_token(self):
+    # python의 unpacking은 같은 값이 있다면 덮어쓰기로 진행이 됨. 따라서 BLACKLIST_AFTER_ROTATION값은 False로 됨
+    # 아래 설정은 리프레시 토큰은 테스트 중에는 블랙리스트에 넣지 않도록 함
+    @override_settings(SIMPLE_JWT={**SIMPLE_JWT, "BLACKLIST_AFTER_ROTATION": False})
+    def test_refresh_token_success(self):
         """
-        해당 테스트는 카카오 리프레시 토큰이 제대로 날라오는지 확인하기 위한 테스트입니다.
+            해당 테스트는 토큰이 제대로 refresh가 되는지 테스트합니다.
         """
-        target_uri = '/auth/refresh/'
-        # TODO 리프레시 토큰으로서 유효기간이 만료되면 바꿔줘야합니다.
+        uri = reverse('refresh')
         data = {
-            'refresh_token': KAKAO_REFRESH_TOKEN,
+            'refresh_token': REFRESH_TOKEN,
         }
-        response = self.client.post(target_uri, data=data, content_type='application/json')
-        self.assertEqual(response.status_code, 201)
-        # 리프레시 토큰 정보를 body에서 발견하지 못한 경우를 테스트 합니다.
+        response = self.client.post(uri, data=data, content_type='application/json')
+        self.assertEqual(response.status_code, 200)
+        logger.debug('test_refresh_token_success result:' + str(response.json()))
+
+    def test_refresh_token_failure_no_parameter(self):
+        """
+            해당 테스트는 refresh token 뷰에서 파라미터가 제대로 날라오지 않았을 경우를 테스트합니다.
+        """
+        uri = reverse('refresh')
         data = {
-            # 일부러 틀린 정보를 넣습니다.
-            'ref': '',
+            'ref': '123sdf1',
         }
-        response = self.client.post(target_uri, data=data, content_type='application/json')
+        response = self.client.post(uri, data=data, content_type='application/json')
         self.assertEqual(response.status_code, 400)
-        # 토큰 정보 자체를 변환해서 테스트합니다.
+        logger.debug('refresh no parameter result:' + str(response.json()))
+
+    def test_refresh_token_failure_invalid_token(self):
+        """
+            해당 테스트는 refresh token 뷰에서 토큰이 유효하지 않은 경우를 테스트합니다.
+        """
+        uri = reverse('refresh')
         data = {
             'refresh_token': '1pbZZHeOq9TsJBPQgA-URNdOUoDlhxp__AAAAAgo9cusAAAGUKtVQgeQ1KlcE_6bt',
         }
-        response = self.client.post(target_uri, data=data, content_type='application/json')
+        response = self.client.post(uri, data=data, content_type='application/json')
         self.assertEqual(response.status_code, 400)
+        logger.debug('refresh invalid token result:' + str(response.json()))
+
 
-    @unittest.skipIf(SKIP_TEST == 'True', "Skip Login Test")
-    def test_login(self):
+    def test_login_success(self):
         """
         해당 함수는 flutter sdk로 발급받은 액세스 토큰과 아이디 토큰을 활용하여 로그인 혹은 회원가입 진행이 되는지 확인합니다.
         """
-        end_point = '/auth/login/'
+        end_point = reverse('login_register')
         headers = {
             'Authorization': f'Bearer {self.KAKAO_TEST_ACCESS_TOKEN}'
         }
         data = {
             'id_token': self.KAKAO_TEST_ID_TOKEN,
         }
         # register Test
-        response = self.client.post(end_point, headers=headers, data=data, content_type='application/json')
+        response = self.client.post(end_point, data=data, content_type='application/json')
         self.assertEqual(response.status_code, 201)
-        self.assertEqual(response.json()['is_new'], True)
 
         # login Test
         response = self.client.post(end_point, headers=headers, data=data, content_type='application/json')
         self.assertEqual(response.status_code, 201)
         self.assertEqual(response.json()['is_new'], False)
+        logger.debug('login success result:' + str(response.json()))
 
+    def test_login_failure(self):
+        """
+            로그인 실패를 테스트합니다.
+        """
+        end_point = reverse('login')
+        headers = {
+            'Authorization': f'Bearer {self.KAKAO_TEST_ACCESS_TOKEN}'
+        }
         # 400 Test
         data2 = {
-            'id_token' : 'hsesefs'
+            'id_token': 'hsesefs'
         }
         response = self.client.post(end_point, headers=headers, data=data2, content_type='application/json')
         self.assertEqual(response.status_code, 400)
-
+        logger.debug('login failure result:' + str(response.json()))

authenticate/urls.py

@@ -1,6 +1,6 @@
 from django.urls import path
-from .views import kakao_callback, KakaoRefreshTokens, LoginRegisterView, CustomTokenRefreshView
-from rest_framework_simplejwt.views import TokenRefreshView
+
+from .views import kakao_callback, LoginRegisterView, CustomTokenRefreshView
 
 urlpatterns = [
     path('login/', LoginRegisterView.as_view({
@@ -10,5 +10,5 @@
     # path('refresh/', KakaoRefreshTokens.as_view({
     #     'post': 'create',
     # }), name='refresh_tokens'),
-    path('refresh/', CustomTokenRefreshView.as_view())
+    path('refresh/', CustomTokenRefreshView.as_view(), name='refresh'),
 ]