투리브(Toleave)

여행 그룹 관리 · 일정 계획 · 실시간 소통을 담은 여행 동행 서비스

서비스 URL: https://toleave.cloud

Frontend Repo: https://github.com/likeliontravel/FE

📖 Introduction

• 그룹 별 완성하는 여행 계획표
• 실시간 소통을 돕는 그룹 채팅
• 그룹 단위로 일정을 계획 & 공유
• 지역 및 테마 별 핫플 관광지 & 식당 & 숙소를 공유하는 여행 게시판

🛠 Tech Stack

Backend

Auth

Database & Storage

Test

Monitoring

Infra & CI/CD

External API

Co-Work

🏗 System Architecture

배포 서버 Architecture

🗂 ERD

📡 API Reference

Notion API 명세

⚙️ Core Design & Implementation

WebSocket + STOMP 실시간 채팅

flyway 도입과 DB 마이그레이션

flyway는 개발 하는 와중에 sql문을 강제로 삽입해서 테이블을 수정해야하는 번거로움이 생겨서 도입했다고 하면 될라나

k6 테스트 & 모니터링 도입

🧯 Troubleshooting Archive

여행지 필터링 조회 API 응답시간 개선

문제 상황

문제상황 예시

원인 분석 과정

1. ㅡㅡㅡ

2. ㅡㅡㅡ

해결 방안

1. ㅡㅡㅡ

2. ㅡㅡㅡ

3. ㅡㅡㅡ

,,,

문제 상황

문제상황 예시

원인 분석 과정

1. ㅡㅡㅡ

2. ㅡㅡㅡ

해결 방안

1. ㅡㅡㅡ

2. ㅡㅡㅡ

3. ㅡㅡㅡ

👥 Members

안혜린 Design

jwj9127 Frontend

sitduk143 Frontend

JeongBuBu Backend

Yeboong99 Backend

jjuchan Backend

ANMNYG Backend

🚀 Getting Started

Environment Variables

# ===================================
# Toleave 프로젝트 환경 변수 기본 샘플 (.env.default)
# 실제 값은 넣지 말고 각자 환경에서 덮어쓰기
# ===================================

# ==============================
# Database (mySQL)
# ==============================
DB_URL=NEED_TO_SET

# 로컬 앱 수동실행용 username, password
DB_USERNAME=NEED_TO_SET
DB_PASSWORD=NEED_TO_SET

# 최초 MYSQL 컨테이너 생성 시 초기화에 ROOT접속이 반드시 필요하기 때문에 root계정 비밀번호 있어야 함
MYSQL_ROOT_PASSWORD=TO_SET

# ==============================
# GCP
# ==============================
GCP_PROJECT_ID=NEED_TO_SET
GCP_CREDENTIALS_PATH=NEED_TO_SET

# ==============================
# JWT
# ==============================
JWT_SECRET=NEED_TO_SET

# ==============================
# Mail (Gmail SMTP)
# ==============================
MAIL_USERNAME=NEED_TO_SET
MAIL_PASSWORD=NEED_TO_SET
MAIL_HOST=smtp.gmail.com
MAIL_PORT=587

# ==============================
# OAuth2 - Google
# ==============================
GOOGLE_CLIENT_ID=NEED_TO_SET
GOOGLE_CLIENT_SECRET=NEED_TO_SET

# ==============================
# OAuth2 - Naver
# ==============================
NAVER_CLIENT_ID=NEED_TO_SET
NAVER_CLIENT_SECRET=NEED_TO_SET

# ==============================
# OAuth2 - Kakao
# ==============================
KAKAO_CLIENT_ID=NEED_TO_SET
KAKAO_CLIENT_SECRET=NEED_TO_SET

# ==============================
# API
# ==============================
API_URL=NEED_TO_SET
SERVICE_KEY=NEED_TO_SET

# ==============================
# GCS
# ==============================
GCS_BUCKET_TOLEAVE=NEED_TO_SET
GCS_BUCKET_PROFILE=NEED_TO_SET
GCS_BUCKET_CHAT=NEED_TO_SET

# ==============================
# Redis
# ==============================
REDIS_HOST=localhost
REDIS_PORT=6379

# ==============================
# Spring Active Profile
# ==============================
SPRING_PROFILES_ACTIVE=local

# ==============================
# Spring Hibernate DDL Auto
# ==============================
DDL_AUTO=NEED_TO_SET

root directory .env.default 복사 후 각 로컬환경에 맞게 세팅합니다. 외부서비스 키 정보는 메신저 공유 참고.

Run

- 방법 1️⃣: 각 시스템 개별 실행

redis, mysql 개별 실행 후 ./gradlew bootRun 애플리케이션 실행

- 방법 2️⃣: 도커 컴포즈 사용

docker compose 세팅 확인 후 docker-compose up --build