Ticket + Catch

대규모 트래픽 환경에서 안정적인 예약 처리를 보장하는 티켓팅 플랫폼

Tickatch는 대규모 트래픽이 발생하는 티켓팅 환경을 가정하여, 안정적인 예약 처리를 보장할 수 있는 시스템 구축을 목표로 한 프로젝트입니다.

도메인별 기능을 마이크로서비스로 분리하여 독립적인 배포 및 확장이 가능하도록 설계하고, 분산 환경에서 발생할 수 있는 데이터 정합성 문제를 최소화하기 위해 비동기 메시징 기반의 구조를 적용하였습니다.

이를 통해 높은 동시 접속 상황에서도 안정적으로 동작하는 확장 가능하고, 신뢰성 있는 티켓팅 시스템을 구현하였습니다.

• 예매/티켓 발행과 같은 기본 기능 제공
• 대용량 트래픽 처리 능력 확보
• 기존 티켓팅 서비스와 동일한 기능을 제공하면서도 사용자 친화적인 기능 제공
• MSA 기반의 확장 가능한 아키텍처 구현

┌─────────────────────────────────────────────────────────────────────┐
│                         NGINX (Reverse Proxy)                       │
└─────────────────────────────────────────────────────────────────────┘
                                    │
                            ┌───────┴───────┐
                            ▼               ▼
                 ┌─────────────────┐ ┌─────────────────┐
                 │ Gateway Server  │ │ Gateway Server  │
                 │ (Waiting Queue) │ │ (Waiting Queue) │
                 │      #1         │ │      #2         │
                 └─────────────────┘ └─────────────────┘
                            │               │
                            └───────┬───────┘
                                    │
              ┌─────────────────────┼─────────────────────┐
              ▼                     ▼                     ▼
    ┌─────────────────┐   ┌─────────────────┐   ┌─────────────────┐
    │  Eureka Server  │   │  Config Server  │   │      Redis      │
    │     (HA x2)     │   │      (Git)      │   │                 │
    └─────────────────┘   └─────────────────┘   └─────────────────┘

┌───────────────────────────────────────────────────────────────────────────┐
│                           Business Services                               │
├─────────────┬─────────────┬─────────────┬─────────────┬───────────────────┤
│    User     │    Auth     │   Product   │   Arthall   │   Reservation     │
│   Service   │   Service   │   Service   │   Service   │     Service       │
├─────────────┼─────────────┼─────────────┼─────────────┼───────────────────┤
│ Reservation │   Ticket    │   Payment   │ Notification│  Notification     │
│    Seat     │   Service   │   Service   │   Service   │  Sender Service   │
├─────────────┴─────────────┴─────────────┴─────────────┴───────────────────┤
│                              Log Service                                  │
└───────────────────────────────────────────────────────────────────────────┘
                                    │
         ┌──────────────────────────┼──────────────────────────┐
         ▼                          ▼                          ▼
┌─────────────────┐      ┌─────────────────┐      ┌─────────────────┐
│    RabbitMQ     │      │      Kafka      │      │   PostgreSQL    │
│   (Messaging)   │      │   (Streaming)   │      │   (pgvector)    │
└─────────────────┘      └─────────────────┘      └─────────────────┘

┌───────────────────────────────────────────────────────────────────┐
│                         Observability                             │
├──────────────┬──────────────┬──────────────┬──────────────────────┤
│  ELK Stack   │    Zipkin    │  Prometheus  │       Grafana        │
│  (Logging)   │  (Tracing)   │  (Metrics)   │    (Dashboard)       │
└──────────────┴──────────────┴──────────────┴──────────────────────┘

주요 기능:

• ApiResponse, PageResponse 기반 응답 표준화
• ErrorCode + BusinessException 예외 체계
• X-User-Id 기반 인증, Role 기반 권한 제어
• HTTP / Feign / RabbitMQ / Scheduler TraceId 전파
• MDC + AOP 기반 요청/메서드 자동 로깅
• DomainEvent → IntegrationEvent 변환 및 재시도 지원
• OpenAPI 3.0 + JWT 인증 스키마

주요 특징:

• 상호 Peer 등록으로 단일 장애 지점(SPOF) 제거
• Context Path 분리 (/eureka1, /eureka2)
• Actuator 기반 헬스 체크 및 메트릭 제공
• Zipkin, Logstash 연동 지원

주요 특징:

• 서비스별/환경별 설정 분리 (local, dev, prod)
• RabbitMQ 기반 Bus Refresh 지원
• 민감 정보는 환경 변수로만 주입

구조:

config-repo/
├── common/              # 모든 서비스 공통 설정
├── {service}/           # 서비스별 기본 설정
└── {service}-{profile}/ # 환경별 설정

설계 원칙:

• 민감 정보는 절대 커밋하지 않음
• 모든 시크릿은 환경 변수 주입
• 공통 → 서비스 → 환경 순 우선순위

인프라 구성:

설계 특징:

• Docker Compose 단일 명령으로 전체 인프라 기동
• 데이터 볼륨 분리로 영속성 보장
• 헬스 체크 기반 의존성 순서 관리

데이터베이스 설계:

• 서비스별 스키마 분리 (Schema per Service)
• pgvector 기반 좌석 위치 벡터 저장
• IVFFlat 인덱스 활용 좌석 거리 연산 최적화

리소스 최적화:

• JVM 힙 최소화 (128–256MB)
• G1GC + 짧은 GC Pause 설정
• 단일 호스트 기준 약 4.5GB 메모리 사용

설계 핵심:

이벤트 기반 연동:

• UserStatusChangedEvent → Auth Service 전달 (RabbitMQ)
• UserLogEvent → Log Service 전달

비즈니스 규칙:

설계 핵심:

토큰 관리 정책:

OAuth 지원:

• Kakao / Naver / Google
• CUSTOMER 사용자만 허용
• 계정 연동 / 해제 기능

이벤트 처리:

공연/전시 상품 도메인을 담당하는 마이크로서비스입니다. 공연 등록부터 심사, 예매 오픈, 판매 종료까지 상품 라이프사이클 전반을 책임집니다.

핵심 책임:

• 공연/전시 상품의 전체 라이프사이클 관리
• 관리자 심사 기반 판매 승인 프로세스
• 좌석 등급(VIP/R/S 등)과 가격·잔여석 요약 관리
• 스케줄 기반 자동 상태 전이
• 상품 취소·좌석 변동을 이벤트로 외부 서비스에 전파

설계 핵심:

상품 상태 흐름:

DRAFT → PENDING → APPROVED → SCHEDULED → ON_SALE → CLOSED → COMPLETED
                                ↓ (어떤 상태에서도)
                            CANCELLED

도메인 모델:

이벤트 연동:

동시성·정합성:

• 좌석 차감 시 비관적 락 적용
• 좌석 등급 합계와 총 좌석 수 일관성 검증
• 스케줄러 전이는 REQUIRES_NEW 트랜잭션으로 격리

아트홀·스테이지·스테이지 좌석 구조 도메인을 담당하는 마이크로서비스입니다.
예매 및 티켓 도메인의 기준이 되는 공간 구조와 좌석 배치 정보를 책임집니다.

• 아트홀, 스테이지, 좌석의 전체 라이프사이클 관리
• 예매·티켓 서비스가 참조하는 좌석 구조의 기준 데이터 제공
• 좌석의 논리적 위치(row/col)와 실제 공간 좌표(vector) 관리
• 상위 도메인 삭제 시 하위 도메인 연쇄 삭제 처리
• 아트홀/스테이지/좌석 상태 변경 이력 로그 발행

ArtHall / Stage

ACTIVE → INACTIVE → (soft delete)

StageSeat

ACTIVE → INACTIVE → (soft delete)

• 좌석 구조는 예매·티켓 도메인의 단일 기준 소스(Single Source of Truth)
• 삭제 및 상태 변경은 트랜잭션 내에서 처리
• 연쇄 삭제는 명시적 코드 흐름으로 제어하여 확장 가능성 확보

티켓 예매 플랫폼의 예매 트랜잭션 라이프사이클을 관리하는 마이크로서비스입니다. 예매 생성부터 결제 동기화, 만료 처리까지 예매 상태 전 과정을 책임집니다.

핵심 책임:

• 예매 트랜잭션의 전체 라이프사이클 관리 (생성 → 결제 → 확정/취소/만료)
• 결제 서비스와의 상태 동기화 처리
• 좌석 선점·해제 조율 (ReservationSeat Service 연동)
• 결제 미진행 예매의 자동 만료 처리 (10분 기준)
• 예매 확정 시 알림·티켓 발행 트리거
• 상품 취소 시 관련 예매 일괄 취소

설계 핵심:

예매 상태 흐름:

INIT → PENDING_PAYMENT → CONFIRMED
                ↓ (결제 실패)
        PAYMENT_FAILED → CANCELED
        
INIT/PENDING_PAYMENT (10분 초과) → EXPIRED

도메인 모델:

이벤트 연동:

외부 서비스 연동:

동시성·정합성:

• 예매 생성 시 좌석 선점으로 동시 예약 방지
• 결제 결과 수신 시 멱등성 보장 (중복 처리 방지)
• 만료 스케줄러는 REQUIRES_NEW 트랜잭션으로 격리
• 예매 취소 시 좌석·티켓·결제 일관성 보장 (분산 트랜잭션 패턴)

설계 핵심:

좌석 상태 관리:

이벤트 기반 연동:

• ReservationSeatPreemptEvent → 다른 서비스로 선점 알림
• ReservationSeatCanceledEvent → 다른 서비스로 취소 알림
• ProductReservationSeatDeleteRequest ← Product Service로부터 삭제 요청 수신

비즈니스 규칙:

• 상태 전환 시 요청자 권한 검증 필수
• 선점/예약/취소 시 findByIdWithLock으로 락 획득
• 상품 삭제 시 해당 상품의 모든 좌석 자동 삭제

예매 확정 후 티켓 발행과 사용 처리를 담당하는 마이크로서비스입니다. 티켓 발행부터 사용, 취소까지 티켓 라이프사이클 전반을 책임집니다.

핵심 책임:

• 티켓의 전체 라이프사이클 관리 (발행 → 사용/취소/만료)
• 예매 확정(CONFIRMED) 상태 검증 후 티켓 발행
• 예매 취소 시 티켓 자동 취소 처리
• 티켓 사용 처리 (공연 입장 시)
• 티켓 발행 시 알림 발송 트리거
• 중복 발행 방지 (기존 티켓 취소 후 재발행)

설계 핵심:

티켓 상태 흐름:

ISSUED → USED (공연 입장)
  ↓
CANCELED (예매 취소)
  ↓
EXPIRED (공연 종료)

도메인 모델:

이벤트 연동:

외부 서비스 연동:

동시성·정합성:

• 티켓 발행 시 예매 상태(CONFIRMED) 필수 검증
• 동일 예매 ID 중복 발행 방지 (기존 티켓 자동 취소)
• 티켓 사용 처리 멱등성 보장 (중복 사용 방지)
• 예매 취소 시 티켓 상태 일관성 보장

토스 페이먼츠 연동을 통한 결제 처리와 환불 관리를 담당하는 마이크로서비스입니다. 결제 생성부터 승인, 실패, 환불까지 결제 라이프사이클 전반을 책임집니다.

핵심 책임:

• 결제의 전체 라이프사이클 관리 (요청 → 처리 → 성공/실패/환불)
• 토스 페이먼츠 API 연동 및 결제 처리
• 결제 결과를 예매 서비스에 전송하여 상태 동기화
• 예매 취소 시 자동 환불 처리
• 상품 취소 시 관련 결제 일괄 환불
• 다건 결제·환불 지원 (여러 예매를 하나의 결제로 묶기)

설계 핵심:

결제 상태 흐름:

REQUESTED → PROCESSING → SUCCESS
                ↓ (실패 시)
        CANCEL / FAIL / EXPIRED
        
SUCCESS → REFUND (예매 취소 시)
        → REFUND_FAIL (환불 실패 시)

도메인 모델:

이벤트 연동:

외부 서비스 연동:

동시성·정합성:

• 결제 생성 시 예매 상태 변경 (PENDING_PAYMENT로 변경)
• 결제 승인/실패 결과 멱등성 보장 (중복 처리 방지)
• 환불 요청 멱등성 보장 (중복 환불 방지)
• 결제 결과를 예매 서비스에 전송하여 결제-예매 상태 동기화

설계 핵심:

알림 상태 관리:

지원 채널:

이벤트 기반 연동:

비즈니스 규칙:

• 템플릿 기반 동적 콘텐츠 생성 (Thymeleaf)
• QR 코드 생성 및 Base64 인코딩 (ZXing)
• 실패 시 최대 3회 자동 재시도
• 티켓 검증 URL: https://www.tickatch.xyz/ticket/checked?ticketId={id}

설계 핵심:

발송 채널 구현:

재시도 정책:

발송 상태:

이벤트 처리:

비즈니스 규칙:

• 각 발송 시도마다 히스토리 엔티티 생성 (PENDING 상태)
• 발송 성공 시 markAsSuccess() 호출 → SUCCESS + sentAt 기록
• 발송 실패 시 markAsFailed(errorMessage) 호출 → FAILED + 에러 저장

Tickatch 전 서비스의 비즈니스 행위 이력(Audit Log) 을 중앙에서 수집·저장하는 마이크로서비스입니다.
생성/수정/삭제/상태변경 등 핵심 도메인 행위를 정형 데이터로 기록해 운영·클레임 대응 근거를 제공합니다.

• 서비스별 주요 행위(생성/변경/삭제/상태변경) 로그 수집·저장
• 사용자/리소스/행위 단위 이력 조회 근거 데이터 제공
• 로그 저장 실패가 비즈니스 트랜잭션에 영향 없도록 비동기 수집

Business Service → Domain Action 발생 → RabbitMQ 발행 → Log Service 수신 → PostgreSQL 저장

티케팅 서비스 웹 프론트엔드 애플리케이션입니다.

기술 스택:

사용자 유형:

• Customer (고객) - 티켓 예매
• Seller (판매자) - 상품 등록/관리
• Admin (관리자) - 심사/운영

주요 기능:

• 사용자 타입별 독립 로그인/대시보드
• OAuth 팝업 방식 소셜 로그인 (카카오, 네이버, 구글)
• 반응형 UI + 다크모드 지원
• 대기열 시스템 연동

API Routes 구성:

Gateway 및 마이크로서비스들의 부하 내성을 검증하기 위한 테스트 전용 서비스입니다.

테스트 목적:

테스트 API:

# 스레드 점유 시뮬레이션 (sleepMs 만큼 대기 후 응답)
GET  /api/v1/test/load?sleepMs=1000
POST /api/v1/test/load?sleepMs=1000

JMeter 점진적 부하 테스트 결과:

결론: 약 7,000 요청 수준부터 스레드 고갈 징후 발생 → 대기열 시스템 도입 필요성 확인

장애 분석:

• Docker & Docker Compose
• JDK 21+
• Node.js 18+ (Frontend)

# 1. 인프라 실행
cd infrastructure
docker-compose up -d

# 2. 서비스 인프라 실행
cd service-infrastructure
docker-compose up -d

# 3. 개별 서비스 실행 (개발 환경)
cd {service-name}
./gradlew bootRun

# 4. 프론트엔드 실행
cd tickatch_web
npm install
npm run dev

© 2025 Tickatch Team