🚅 Raillo

🙌🏻 멤버

김민아	김영렬	박범진	신지민	이승훈	이찬원	조윤성

📋 목차

• 프로젝트 개요
• 기술 스택
• 아키텍처
• 주요 기능
• 모니터링 & 운영
• 테스트
• 주요 엔드포인트

📖 프로젝트 개요

Raillo는 코레일(KORAIL) 예매 시스템을 클론코딩한 기차 예약 플랫폼으로,
실제 서비스의 핵심 기능들을 최대한 유사하게 구현하여 현업에서 사용되는 기술 스택과 설계 패턴을 학습하고 적용한 프로젝트입니다.

📅 진행 기간

• 1차 (기획 및 개발) : 2025. 05. 28. ~ 2025. 07. 01.
• 2차 (클라이언트 요구사항 반영) : 2025. 07. 02. ~ 2025. 07. 15.
• 3차 (카카오 API 통합) : 2025. 07. 16. ~ 2025. 08. 08.
• 지속 개선 : 2025. 08. 09. ~ endless

🎯 핵심 목표

• 실제 서비스와 유사한 핵심 기능 구현 : 실제 코레일에서 제공하는 회원 인증 및 주요 예매 흐름을 최대한 비슷하게 구현
• 활발한 협업과 역할 분담 경험 : 팀 내부에서 역할을 분담, 협업툴을 이용한 버전관리, 이슈 트래킹, 코드 리뷰 등 협업 방식을 적용
• 실무에서 사용되는 기술 스택 학습 및 경험 : 실무에서 사용되는 다양한 기술 스택을 학습, 경험하고 관련 패턴을 적용

🔧 기술 스택

Backend

• Language : Java
• Framework : Spring Boot, Spring Security, Spring Batch
• ORM : Spring Data JPA, QueryDSL
• DB : MySQL (Production), H2 (Test)
• Cache : Redis
• Authentication : JWT
• File Processing : Apache POI
• Build Tool : Gradle

Infrastructure & DevOps

• Cloud Platform : AWS (EKS, RDS, Route53, Load Balancer)
• Container : Docker, Kubernetes
• CI/CD : GitHub Actions, ArgoCD (GitOps)
• Monitoring : Prometheus, Grafana
• VCS : Git, GitHub

Testing

• Framework : JUnit, Spring Boot Test
• DB : H2 (in-memory)
• Cache : Embedded Redis
• Test Utils : AssertJ
• Performance Testing : K6
• Email Testing : GreenMail
• Coverage : JaCoCo

🏗️ 아키텍처

도메인 주도 설계 (DDD)

src/main/java/com/sudo/railo/
├── auth/       # 인증 도메인
├── booking/    # 예약 도메인  
├── global/     # 공통 기능
├── member/     # 회원 도메인
├── payment/    # 결제 도메인
└── train/      # 열차 도메인

🚀 주요 특징

🔑 Auth 도메인

• JWT 기반 인증 시스템 : Access Token과 Refresh Token을 활용한 Stateless 인증 및 인가
• 이메일 인증 : Redis를 활용한 인증 코드 발송 및 검증 시스템
• 보안 강화 : 로그아웃된 토큰 Redis 관리, 쿠키 기반 Refresh Token 관리

👤 Member 도메인

• 고유 회원번호 시스템 : Redis 기반 일일 증분 카운터를 활용한 회원번호 자동 생성 (yyyyMMddCCCC 형식)
• Soft-Delete : 실제 회원 삭제가 아닌 비활성화 처리
• 만료 회원 일괄 삭제 : 만료된 회원 데이터 정리를 위한 Spring Batch 활용

🎫 Booking 도메인

• 장바구니 시스템 : 예약 후 결제 전 임시 저장 및 관리 기능
• 좌석 예약 관리 : 승객 유형별 좌석 배정 및 예약 상태 관리
• 요금 계산 : 거리별, 승객 유형별, 차량 등급별 요금 자동 계산

💵 Payment 도메인

• 결제 수단 확장을 위한 유연한 구조 : 절차를 분리함으로써 추후 결제 수단 확장 용이함
• 결제 키 생성 : 고유한 결제 식별자 자동 생성
• 결제 검증 : 금액 검증 및 중복 결제 방지
• 자동 티켓 발급 : 결제 완료 시 티켓 생성
• 취소 및 환불 : 결제 취소 및 환불 처리 시스템

🚅 Train 도메인

• 실제 데이터 활용 : 코레일의 실제 운영 스케줄 Excel 파일을 파싱하여 데이터 구축
• 엑셀 데이터 파싱 : Apache POI를 활용한 복잡한 스케줄 데이터 자동 파싱
• 열차 검색 최적화 : 배치 쿼리를 활용한 대용량 스케줄 검색 성능 최적화
• 좌석 현황 관리 : 실시간 좌석 예약 현황 및 여유석 정보 제공
• 역 간 요금 시스템 : 구간별 세분화된 요금 체계 구현

📊 모니터링 & 운영

• GitHub Actions와 ArgoCD를 활용해 코드 변경 시 자동 빌드, 배포, 클러스터 적용
• AWS EKS 기반에서 모든 구성요소를 컨테이너로 관리
• Prometheus, Grafana등을 도입하여 노드 별 서비스 상태, 리소스 사용량을 실시간으로 수집 및 가시화
• 여러 Node Group과 분산된 백엔드 및 Redis로 구성되어 고가용성 확보
• RDS, Route53, LB 등 AWS 서비스를 사용하여 데이터 관리와 트래픽 분산 및 도메인 운영 지원

🧪 테스트

로컬 테스트 환경 구축

• 로컬에서 운영환경과 비슷한 환경 구축 후 스트레스 테스트 진행
• Spring Boot, LB, Redis, Prometheus, Grafana, AWS RDS 이용

K6를 이용한 부하 테스트

• K6로 API 호출 -> 로드밸런서 -> Spring Boot Application -> DB
• 부하 테스트 목표 설정 (예: Target TPS 500, Avg Latency 800ms 이하)
• 부하 테스트 진행 후 병목 지점 파악, 성능 개선
• 개선한 시스템이 어느 정도 트래픽까지를 견딜 수 있는지 테스트 과정 반복

📌 주요 엔드포인트

# Auth
POST /auth/signup
POST /auth/login
POST /auth/logout
POST /auth/emails/verify
POST /auth/reissue

# Booking
GET /api/v1/booking/reservation
GET /api/v1/booking/reservation/{reservationId}
POST /api/v1/booking/reservation
DELETE /api/v1/booking/reservation
GET /api/v1/booking/ticket

# Member
DELETE /api/v1/members
GET /api/v1/members/me
PUT /api/v1/members/password

# Payment
GET /api/v1/payments
POST /api/v1/payments/{paymentKey}/cancel
POST /api/v1/payments/bank-account
POST /api/v1/payments/card

# Train
GET /api/v1/trains/calendar
POST /api/v1/trains/cars
POST /api/v1/trains/search
POST /api/v1/trains/seats