# jjsh0208/takenseat architecture

> Architecture diagram of the GitHub repository jjsh0208/takenseat, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/jjsh0208/takenseat
- Repository: https://github.com/jjsh0208/takenseat

## Overview

TakenSeat is an eight-service MSA ticketing platform. Its user-facing journey spans identity, queue admission, performance discovery, booking, payment and ticketing; coupons, reviews and recommendations are additional capabilities. The tree and README establish the product’s breadth, while sampled code verifies only selected internals: review API dispatch, recommendation caching and lookups, booking queries, and queue-to-booking messaging. Other service-to-service links are omitted where the excerpts do not establish the caller or transport.

Main entry points: [`com.taken_seat.review-service/src/main/java/com/taken_seat/review_service/presentation/controller/ReviewController.java`](https://github.com/jjsh0208/takenseat/blob/dev/com.taken_seat.review-service/src/main/java/com/taken_seat/review_service/presentation/controller/ReviewController.java) (Review API), [`com.taken_seat.performance-service/src/main/java/com/taken_seat/performance_service/recommend/application/service/RecommendQueryService.java`](https://github.com/jjsh0208/takenseat/blob/dev/com.taken_seat.performance-service/src/main/java/com/taken_seat/performance_service/recommend/application/service/RecommendQueryService.java) (Recommendations), [`com.taken_seat.booking-service/src/main/java/com/taken_seat/booking_service/booking/infrastructure/service/BookingQueryService.java`](https://github.com/jjsh0208/takenseat/blob/dev/com.taken_seat.booking-service/src/main/java/com/taken_seat/booking_service/booking/infrastructure/service/BookingQueryService.java) (Booking lifecycle), [`com.taken_seat.review-service/src/main/java/com/taken_seat/review_service/application/service/ReviewLikeService.java`](https://github.com/jjsh0208/takenseat/blob/dev/com.taken_seat.review-service/src/main/java/com/taken_seat/review_service/application/service/ReviewLikeService.java) (Review likes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_edge["Entry and platform"]
  node_gateway["API gateway"]
  node_discovery["Service discovery"]
  node_shared["Common services<br/>[common_service]"]
end

subgraph group_identity["Identity and queue"]
  node_auth["Accounts and mileage"]
  node_queue["Admission queue<br/>[QueueService.java]"]
  node_queue_store[("Queue state")]
end

subgraph group_catalog["Performance discovery"]
  node_performance["Performance catalog<br/>[performance]"]
  node_venue["Venue management<br/>[performancehall]"]
  node_schedules["Schedules and seats<br/>[performanceticket]"]
  node_recommend["Recommendations"]
  node_recommend_cache[("Recommendation cache")]
end

subgraph group_commerce["Booking and payment"]
  node_booking["Booking lifecycle"]
  node_booking_store[("Booking records")]
  node_ticket["Ticket issuance<br/>[ticket]"]
  node_payment["Payment processing"]
end

subgraph group_engagement["Post-purchase"]
  node_coupon["Coupon service<br/>[CouponService.java]"]
  node_review_api["Review API"]
  node_review_service["Review operations<br/>[ReviewService.java]"]
  node_review_likes["Review likes"]
  node_review_cache[("Like cache")]
end

node_customers(("Ticket customers"))
node_toss["TossPayments"]

node_recommend -->|"reads and saves"| node_recommend_cache
node_recommend -->|"looks up shows"| node_performance
node_booking -->|"queries records"| node_booking_store
node_queue -->|"requests booking"| node_booking
node_review_api -->|"dispatches review commands"| node_review_service
node_review_api -->|"dispatches like commands"| node_review_likes
node_customers -->|"uses review API"| node_review_api
node_review_likes -.->|"implementation"| node_review_cache
node_payment -.->|"integrates"| node_toss

click node_gateway "https://github.com/jjsh0208/takenseat/blob/dev/com.taken_seat.gateway-service/src/main/java/com/taken_seat/gateway_service/GatewayServiceApplication.java"
click node_discovery "https://github.com/jjsh0208/takenseat/blob/dev/com.taken_seat.eureka-service/src/main/java/com/taken_seat/eureka_service/EurekaServiceApplication.java"
click node_shared "https://github.com/jjsh0208/takenseat/tree/dev/com.taken_seat.common-service/src/main/java/com/taken_seat/common_service"
click node_auth "https://github.com/jjsh0208/takenseat/blob/dev/com.taken_seat.auth-service/src/main/java/com/taken_seat/auth_service/application/service/auth/AuthServiceImpl.java"
click node_queue "https://github.com/jjsh0208/takenseat/blob/dev/com.taken_seat.queue-service/src/main/java/com/taken_seat/queue_service/application/service/QueueService.java"
click node_queue_store "https://github.com/jjsh0208/takenseat/blob/dev/com.taken_seat.queue-service/src/main/java/com/taken_seat/queue_service/infrastructure/repository/QueueRepository.java"
click node_performance "https://github.com/jjsh0208/takenseat/tree/dev/com.taken_seat.performance-service/src/main/java/com/taken_seat/performance_service/performance"
click node_venue "https://github.com/jjsh0208/takenseat/tree/dev/com.taken_seat.performance-service/src/main/java/com/taken_seat/performance_service/performancehall"
click node_schedules "https://github.com/jjsh0208/takenseat/tree/dev/com.taken_seat.performance-service/src/main/java/com/taken_seat/performance_service/performanceticket"
click node_recommend "https://github.com/jjsh0208/takenseat/blob/dev/com.taken_seat.performance-service/src/main/java/com/taken_seat/performance_service/recommend/application/service/RecommendQueryService.java"
click node_recommend_cache "https://github.com/jjsh0208/takenseat/blob/dev/com.taken_seat.performance-service/src/main/java/com/taken_seat/performance_service/recommend/infrastructure/redis/RecommendationCacheService.java"
click node_booking "https://github.com/jjsh0208/takenseat/blob/dev/com.taken_seat.booking-service/src/main/java/com/taken_seat/booking_service/booking/infrastructure/service/BookingQueryService.java"
click node_booking_store "https://github.com/jjsh0208/takenseat/blob/dev/com.taken_seat.booking-service/src/main/java/com/taken_seat/booking_service/booking/domain/repository/BookingQueryRepository.java"
click node_ticket "https://github.com/jjsh0208/takenseat/tree/dev/com.taken_seat.booking-service/src/main/java/com/taken_seat/booking_service/ticket"
click node_payment "https://github.com/jjsh0208/takenseat/blob/dev/com.taken_seat.payment-service/src/main/java/com/taken_seat/payment_service/presentation/controller/PaymentController.java"
click node_coupon "https://github.com/jjsh0208/takenseat/blob/dev/com.taken_seat.coupon-service/src/main/java/com/taken_seat/coupon_service/application/service/CouponService.java"
click node_review_api "https://github.com/jjsh0208/takenseat/blob/dev/com.taken_seat.review-service/src/main/java/com/taken_seat/review_service/presentation/controller/ReviewController.java"
click node_review_service "https://github.com/jjsh0208/takenseat/blob/dev/com.taken_seat.review-service/src/main/java/com/taken_seat/review_service/application/service/ReviewService.java"
click node_review_likes "https://github.com/jjsh0208/takenseat/blob/dev/com.taken_seat.review-service/src/main/java/com/taken_seat/review_service/application/service/ReviewLikeService.java"
click node_review_cache "https://github.com/jjsh0208/takenseat/blob/dev/com.taken_seat.review-service/src/main/java/com/taken_seat/review_service/infrastructure/redis/service/ReviewLikeServiceImpl.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_gateway,node_discovery,node_shared toneBlue
class node_auth,node_queue,node_queue_store toneAmber
class node_performance,node_venue,node_schedules,node_recommend,node_recommend_cache toneMint
class node_booking,node_booking_store,node_ticket,node_payment toneRose
class node_coupon,node_review_api,node_review_service,node_review_likes,node_review_cache,node_customers,node_toss toneIndigo
```

## Components

### Entry and platform

- [API gateway](https://github.com/jjsh0208/takenseat/blob/dev/com.taken_seat.gateway-service/src/main/java/com/taken_seat/gateway_service/GatewayServiceApplication.java): `com.taken_seat.gateway-service/src/main/java/com/taken_seat/gateway_service/GatewayServiceApplication.java`
- [Service discovery](https://github.com/jjsh0208/takenseat/blob/dev/com.taken_seat.eureka-service/src/main/java/com/taken_seat/eureka_service/EurekaServiceApplication.java): `com.taken_seat.eureka-service/src/main/java/com/taken_seat/eureka_service/EurekaServiceApplication.java`
- [Common services](https://github.com/jjsh0208/takenseat/tree/dev/com.taken_seat.common-service/src/main/java/com/taken_seat/common_service): `com.taken_seat.common-service/src/main/java/com/taken_seat/common_service`

### Identity and queue

- [Accounts and mileage](https://github.com/jjsh0208/takenseat/blob/dev/com.taken_seat.auth-service/src/main/java/com/taken_seat/auth_service/application/service/auth/AuthServiceImpl.java): `com.taken_seat.auth-service/src/main/java/com/taken_seat/auth_service/application/service/auth/AuthServiceImpl.java`
- [Admission queue](https://github.com/jjsh0208/takenseat/blob/dev/com.taken_seat.queue-service/src/main/java/com/taken_seat/queue_service/application/service/QueueService.java): `com.taken_seat.queue-service/src/main/java/com/taken_seat/queue_service/application/service/QueueService.java`
- [Queue state](https://github.com/jjsh0208/takenseat/blob/dev/com.taken_seat.queue-service/src/main/java/com/taken_seat/queue_service/infrastructure/repository/QueueRepository.java): `com.taken_seat.queue-service/src/main/java/com/taken_seat/queue_service/infrastructure/repository/QueueRepository.java`

### Performance discovery

- [Performance catalog](https://github.com/jjsh0208/takenseat/tree/dev/com.taken_seat.performance-service/src/main/java/com/taken_seat/performance_service/performance): `com.taken_seat.performance-service/src/main/java/com/taken_seat/performance_service/performance`
- [Venue management](https://github.com/jjsh0208/takenseat/tree/dev/com.taken_seat.performance-service/src/main/java/com/taken_seat/performance_service/performancehall): `com.taken_seat.performance-service/src/main/java/com/taken_seat/performance_service/performancehall`
- [Schedules and seats](https://github.com/jjsh0208/takenseat/tree/dev/com.taken_seat.performance-service/src/main/java/com/taken_seat/performance_service/performanceticket): `com.taken_seat.performance-service/src/main/java/com/taken_seat/performance_service/performanceticket`
- [Recommendations](https://github.com/jjsh0208/takenseat/blob/dev/com.taken_seat.performance-service/src/main/java/com/taken_seat/performance_service/recommend/application/service/RecommendQueryService.java): `com.taken_seat.performance-service/src/main/java/com/taken_seat/performance_service/recommend/application/service/RecommendQueryService.java`
- [Recommendation cache](https://github.com/jjsh0208/takenseat/blob/dev/com.taken_seat.performance-service/src/main/java/com/taken_seat/performance_service/recommend/infrastructure/redis/RecommendationCacheService.java): `com.taken_seat.performance-service/src/main/java/com/taken_seat/performance_service/recommend/infrastructure/redis/RecommendationCacheService.java`

### Booking and payment

- [Booking lifecycle](https://github.com/jjsh0208/takenseat/blob/dev/com.taken_seat.booking-service/src/main/java/com/taken_seat/booking_service/booking/infrastructure/service/BookingQueryService.java): `com.taken_seat.booking-service/src/main/java/com/taken_seat/booking_service/booking/infrastructure/service/BookingQueryService.java`
- [Booking records](https://github.com/jjsh0208/takenseat/blob/dev/com.taken_seat.booking-service/src/main/java/com/taken_seat/booking_service/booking/domain/repository/BookingQueryRepository.java): `com.taken_seat.booking-service/src/main/java/com/taken_seat/booking_service/booking/domain/repository/BookingQueryRepository.java`
- [Ticket issuance](https://github.com/jjsh0208/takenseat/tree/dev/com.taken_seat.booking-service/src/main/java/com/taken_seat/booking_service/ticket): `com.taken_seat.booking-service/src/main/java/com/taken_seat/booking_service/ticket`
- [Payment processing](https://github.com/jjsh0208/takenseat/blob/dev/com.taken_seat.payment-service/src/main/java/com/taken_seat/payment_service/presentation/controller/PaymentController.java): `com.taken_seat.payment-service/src/main/java/com/taken_seat/payment_service/presentation/controller/PaymentController.java`

### Post-purchase

- [Coupon service](https://github.com/jjsh0208/takenseat/blob/dev/com.taken_seat.coupon-service/src/main/java/com/taken_seat/coupon_service/application/service/CouponService.java): `com.taken_seat.coupon-service/src/main/java/com/taken_seat/coupon_service/application/service/CouponService.java`
- [Review API](https://github.com/jjsh0208/takenseat/blob/dev/com.taken_seat.review-service/src/main/java/com/taken_seat/review_service/presentation/controller/ReviewController.java): `com.taken_seat.review-service/src/main/java/com/taken_seat/review_service/presentation/controller/ReviewController.java`
- [Review operations](https://github.com/jjsh0208/takenseat/blob/dev/com.taken_seat.review-service/src/main/java/com/taken_seat/review_service/application/service/ReviewService.java): `com.taken_seat.review-service/src/main/java/com/taken_seat/review_service/application/service/ReviewService.java`
- [Review likes](https://github.com/jjsh0208/takenseat/blob/dev/com.taken_seat.review-service/src/main/java/com/taken_seat/review_service/application/service/ReviewLikeService.java): `com.taken_seat.review-service/src/main/java/com/taken_seat/review_service/application/service/ReviewLikeService.java`
- [Like cache](https://github.com/jjsh0208/takenseat/blob/dev/com.taken_seat.review-service/src/main/java/com/taken_seat/review_service/infrastructure/redis/service/ReviewLikeServiceImpl.java): `com.taken_seat.review-service/src/main/java/com/taken_seat/review_service/infrastructure/redis/service/ReviewLikeServiceImpl.java`

### Other components

- **Ticket customers**
- **TossPayments**

## Connections

- Recommendations → Recommendation cache: reads and saves (evidence: `com.taken_seat.performance-service/src/main/java/com/taken_seat/performance_service/recommend/application/service/RecommendQueryService.java`)
- Recommendations → Performance catalog: looks up shows (evidence: `com.taken_seat.performance-service/src/main/java/com/taken_seat/performance_service/recommend/application/service/RecommendQueryService.java`)
- Booking lifecycle → Booking records: queries records (evidence: `com.taken_seat.booking-service/src/main/java/com/taken_seat/booking_service/booking/infrastructure/service/BookingQueryService.java`)
- Admission queue → Booking lifecycle: requests booking (evidence: `com.taken_seat.queue-service/src/main/java/com/taken_seat/queue_service/application/service/QueueService.java`)
- Review API → Review operations: dispatches review commands (evidence: `com.taken_seat.review-service/src/main/java/com/taken_seat/review_service/presentation/controller/ReviewController.java`)
- Review API → Review likes: dispatches like commands (evidence: `com.taken_seat.review-service/src/main/java/com/taken_seat/review_service/presentation/controller/ReviewController.java`)
- Ticket customers → Review API: uses review API (evidence: `com.taken_seat.review-service/src/main/java/com/taken_seat/review_service/presentation/controller/ReviewController.java`)
- Review likes → Like cache: implementation
- Payment processing → TossPayments: integrates
