Flight Reservation System은 MSA(Microservices Architecture)를 채택하여 항공편 검색, 예약, 유저 관리 등 다양한 서비스를 분산된 마이크로서비스로 구현한 애플리케이션입니다. 개별 서비스는 확장성과 유지보수에 용이하도록 구성되었으며, Eureka를 통한 서비스 디스커버리와 Gateway를 통한 API 라우팅을 지원합니다.
프로젝트는 아래와 같은 주요 컴포넌트로 구성됩니다:
-
Eureka (서비스 레지스트리)
- 포트: 8761
- 모든 마이크로서비스는 Eureka에 등록되어 서로의 위치를 자동으로 검색합니다.
-
Gateway (API 게이트웨이)
- 포트: 8443
- 클라이언트의 요청을 해당 서비스로 라우팅하며, 인증, 로깅 등 부가 기능을 처리합니다.
-
유저 서비스
- 포트: 8081
- 회원가입, 로그인, 프로필 관리 등 유저 관련 기능을 담당합니다.
-
항공 서비스
- 포트: 8082
- 항공편 정보 관리, 항공편 검색 및 상세 정보 제공 기능을 제공합니다.
-
예매 서비스
- 포트: 8083
- 항공편 예약 및 결제 처리, 예약 내역 관리 기능을 제공합니다.
- 항공편 검색: 사용자가 입력한 출발지, 도착지, 날짜 정보를 기반으로 항공편 목록을 조회할 수 있습니다.
- 예약 처리: 선택한 항공편에 대한 예약 및 결제 과정을 진행합니다.
- 예약 관리: 예약 내역 조회, 수정, 취소 기능을 제공합니다.
- 유저 관리: 회원가입, 로그인, 비밀번호 복구, 프로필 관리 등 사용자 관련 작업을 수행합니다.
- 위치 기반 서비스: 카카오맵 오픈 API를 활용하여 항공편 출발지 및 도착지 주변 위치를 시각화합니다.
- 날씨 정보 제공: 날씨 오픈 API를 통해 항공편 운항 및 예약에 참고할 수 있는 실시간 날씨 정보를 제공합니다.
- RESTful API: 각 서비스는 독립적인 REST API 엔드포인트를 제공하며, Gateway를 통해 통합된 API 사용이 가능합니다.
- 백엔드:
- 언어/프레임워크: Java 17 이상, Spring Boot
- 빌드 도구: Gradle
- 보조 기술:
- Redis: 세션 관리 및 캐시 처리
- JWT: 사용자 인증 및 토큰 기반 보안 처리
- Elasticsearch: 항공편 검색의 고속화 및 색인 최적화
- Kafka: 비동기 메시징 및 이벤트 스트리밍
- 마이크로서비스 인프라:
- Eureka: 서비스 디스커버리 (포트 8761)
- Gateway: API 라우팅 및 부가 기능 (포트 8443)
- 유저 서비스: (포트 8081)
- 항공 서비스: (포트 8082)
- 예매 서비스: (포트 8083)
- 외부 API 통합:
- 카카오맵 오픈 API: 지도 기반 위치 서비스 제공
- 날씨 오픈 API: 실시간 날씨 정보 제공
- 프론트엔드: React + Vite
- 폴더명:
flight-reservation-front-main - 개발 서버 포트: 5173
- 폴더명:
- 데이터베이스: MySQL 또는 PostgreSQL
각 마이크로서비스의 API는 Swagger를 통해 문서화되어 있습니다.
개발 및 테스트 과정에서 Swagger UI를 사용하여 API 명세를 확인하고, 인터랙티브하게 테스트할 수 있습니다.
예를 들어, Gateway 서비스의 Swagger 문서는 다음 URL에서 확인할 수 있습니다:
https://localhost:8443/swagger-ui.html
각 서비스마다 별도의 Swagger 문서 페이지가 제공될 수 있으니, 필요 시 해당 URL을 참고하세요.
- 박순일: 유저 서비스 담당 및 통합 담당
- 이용수: 항공 서비스 담당 및 카카오맵 API 연동 담당
- 최민석: 예매 서비스 담당, 결제 서비스 및 Kafka 통신 설계
- 박세호: 프론트 엔드 총괄 및 디자인 담당, 날씨 API 연동 담당
아래는 실제 가동화면 메인페이지의 예시 스크린샷입니다.
- Java 17 이상 설치
- Gradle (프로젝트 내
gradlew스크립트 포함) - Node.js 및 npm (프론트엔드 실행용)
- 데이터베이스 서버 (MySQL, PostgreSQL 등) 구동
- 레포지토리 클론
git clone https://github.com/Parksoonil/flight-reservation.git cd flight-reservation
이 프로젝트는 백엔드(마이크로서비스)와 프론트엔드(React + Vite)로 구성되어 있으며, 각 마이크로서비스는 독립된 Gradle 모듈 또는 애플리케이션으로 구성되어 있습니다.
./gradlew build./gradlew :eureka-server:bootRun./gradlew :gateway:bootRun./gradlew :user-service:bootRun./gradlew :flight-service:bootRun./gradlew :reservation-service:bootRun각 서비스 실행 후, Eureka 대시보드에 접속하여 등록된 서비스 목록을 확인할 수 있습니다.
- 프론트엔드 디렉토리로 이동:
cd flight-reservation-front-main npm install - 개발 서버 실행:
npm run dev
- 브라우저에서 http://localhost:5173으로 접속하여 프론트엔드 애플리케이션을 확인합니다.
- 웹 인터페이스: 브라우저에서 Gateway 주소(https://localhost:8443)를 통해 각 서비스 기능에 접근합니다.
- API 사용: 각 마이크로서비스는 독립적인 RESTful API를 제공하며, Swagger 또는 Postman을 통해 개별 API 엔드포인트를 테스트할 수 있습니다.
- 서비스 디스커버리: Eureka 대시보드를 통해 현재 등록된 서비스 목록 및 상태를 확인할 수 있습니다.
- 서비스 안정화: 각 마이크로서비스(유저, 항공, 예매 서비스)의 기본 기능 구현 완료 및 통합 테스트 진행 중.
- API 문서화: Swagger를 활용한 API 문서화 작업 완료 및 주기적인 업데이트.
- 인프라 구축: Eureka, Gateway, Redis, Elasticsearch, Kafka 등 주요 인프라 구성 완료.
- 자동화 배포: CI/CD 파이프라인 구축 및 Docker 기반 컨테이너 배포 도입.
- 실시간 모니터링: Prometheus, Grafana 등 모니터링 도구를 활용한 시스템 상태 실시간 확인.
- 추천 시스템: 사용자 선호도 분석을 통한 항공편 추천 기능 추가.
- 다국어 지원: 글로벌 사용자 확대를 위한 다국어 인터페이스 지원.
- 성능 최적화: Elasticsearch와 Kafka를 활용한 데이터 처리 및 메시징 성능 개선.
- 보안 강화: JWT 외 추가 인증/인가 방식을 도입하여 보안 체계 강화.
- UI/UX 개선: 프론트엔드 사용자 경험 개선 및 디자인 피드백 반영.
- 레포지토리를 fork합니다.
- 새로운 브랜치를 생성합니다.
git checkout -b feature/새로운기능
- 변경 사항을 commit합니다.
- 변경 사항을 push한 후, pull request를 생성합니다.
- 문제 제보나 기능 요청은 Issue를 등록해 주시면 감사하겠습니다.
이 프로젝트는 MIT 라이센스 하에 배포됩니다. 자세한 내용은 LICENSE 파일을 참조하세요.
프로젝트 관련 문의는 Parksoonil GitHub 프로필 또는 이슈 트래커를 통해 연락해주시면 됩니다.