SK쉴더스 루키즈 최종 프로젝트 백엔드 리포지토리입니다.
🏗 System Architecture
본 프로젝트는 MSA(Microservice Architecture) 기반 백엔드 구조로 설계되었습니다. 개발 단계에서는 서비스별로 포트를 분리하여 독립적으로 개발·테스트하였으며, 배포 환경에서는 Gateway를 통해 단일 엔드포인트로 통합하여 클라이언트가 내부 구조를 인지하지 않도록 구성했습니다.
🔌 Service Ports
| Service | Port |
|---|---|
| Gateway | 8080 |
| Congestion Service | 8081 |
| Place Service | 8082 |
| User Service | 8083 |
| 서비스 | API 유형 | 역할 설명 |
|---|---|---|
| Gateway | REST | 모든 클라이언트 요청의 진입점 라우팅, CORS, Timeout 설정 중앙 관리 |
| User Service | REST | 회원가입, 로그인, 사용자 정보 관리 JWT 기반 인증·인가 및 사용자 식별 |
| Place Service | REST | 관광지·음식점·숙박·행사 정보 제공 Elasticsearch 기반 장소 검색 타사 리뷰 요약 및 관광지 추천 API |
| Congestion Service | SSE | 실시간 인구 밀집도, 사고·통제, 날씨 정보 처리 SSE 기반 실시간 데이터 스트리밍 제공 |
로컬에서 postgreSQL 테스트
-
Docker 이미지 다운로드 및 컨테이너 실행
docker pull postgres:latest -
PostgreSQL 컨테이너 실행
docker run --name my-postgres -e POSTGRES_USER=root -e POSTGRES_PASSWORD=admin -e POSTGRES_DB=stars_db -p 5432:5432 -d postgres:latest -
Spring Boot 애플리케이션 설정
- 이제, Spring Boot 애플리케이션에서 PostgreSQL과 연결 설정. application.properties에 PostgreSQL 데이터베이스 설정 추가
spring.datasource.url=jdbc:postgresql://localhost:5432/stars_db spring.datasource.username=root spring.datasource.password=admin spring.datasource.driver-class-name=org.postgresql.Driver spring.jpa.database-platform=org.hibernate.dialect.PostgreSQLDialect spring.jpa.hibernate.ddl-auto=update
PostgreSQL과 프로젝트 같이 띄우는 법
- 프로젝트 최상위 디렉토리 (/place-service, docker-compose.yml과 Dockerfile이 있는 위치)에서 docker compose up --build 실행
- 빌드가 완료되면 자동으로 Spring 로고가 나오면서 실행됨
- 다른 cmd 창에서 docker exec -it my_postgres bash 실행
- psql -U root -d stars_db 실행하면 접속이 될 것임
- 접속한 후 \dt 로 테이블 존재 확인 가능, select 문으로 데이터 확인 가능
- select * from area; 로 결과를 본 후, q 를 눌러야 다시 명령창으로 돌아갈 수 있음
토큰 redis에 저장
📄 API Documentation (Postman) https://documenter.getpostman.com/view/29374455/2sB2qZEN9h
📊 ERD https://www.erdcloud.com/d/hC5ZaGYqaP3oha66s
NOTION https://almond-comfort-a8a.notion.site/1-1c0fef49d8d580e29afcd1902561e2ad?pvs=74
| 기능 | 설명 |
|---|---|
| 회원가입 / 로그인 | 회원가입 시 DB에 사용자 정보 저장 후 인증 정보 기반 로그인 |
| 혼잡도 제공 | 장소별 실시간 인구 밀집 데이터를 기반으로 관광지 혼잡도 시각화 |
| 관광지 추천 | 사용자 선택 조건 및 알고리즘 기준 관광지 추천 |
| 행사 목록 | 서울 지역 진행·예정 행사 목록 제공 |
| 장소 검색 | Elasticsearch 기반 관광지 조건 검색 |
| 챗봇 | 관광 관련 질문에 대한 AI 기반 응답 제공 |
| 유동인구 정보 | 실시간 유동인구 제공 (성별·연령대 확장 가능 구조) |
| 타사 리뷰 요약 | 네이버·카카오 리뷰 감정 분석 후 장단점 요약 |
| 리뷰 작성 | 사용자가 관광지 리뷰 작성 |
| 대중교통 정보 | 관광지 접근을 위한 대중교통 정보 제공 |
- PostgreSQL을 사용하여 사용자 및 서비스 데이터를 관리
- 사용자 인증은 JWT 기반
- 발급된 토큰은 Redis에 저장하여 만료 및 로그아웃 관리
기술스택
