# dharanes/sportify architecture

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

- Interactive diagram: https://gitdiagram.com/dharanes/sportify
- Repository: https://github.com/dharanes/sportify

## Overview

This repository implements a sports-turf discovery, management, and booking product, with a React client and Spring-based services. Users browse turfs, inspect games, courts, and availability, then book and pay; owners register and manage turfs, while customers and admins have profile and administration workflows. Turf, booking, customer, gateway, and Stripe services form distinct backend capabilities. The graph shows only relationships visible in excerpts or SOURCE INDEX references; cross-service HTTP wiring and several runtime interactions are not sampled, so those links are omitted rather than inferred.

Main entry points: [`FRONTEND/src/main.jsx`](https://github.com/dharanes/sportify/blob/main/FRONTEND/src/main.jsx) (Web application), [`FRONTEND/src/components/Booking/Booking.jsx`](https://github.com/dharanes/sportify/blob/main/FRONTEND/src/components/Booking/Booking.jsx) (Booking flow), [`BACKEND/Gateway/src/main/java/com/gateway/config/RouteConfig.java`](https://github.com/dharanes/sportify/blob/main/BACKEND/Gateway/src/main/java/com/gateway/config/RouteConfig.java) (API gateway), [`BACKEND/TurfService/src/main/java/com/turf/controller/TurfController.java`](https://github.com/dharanes/sportify/blob/main/BACKEND/TurfService/src/main/java/com/turf/controller/TurfController.java) (Turf API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web client"]
  node_webapp["Web application<br/>[main.jsx]"]
  node_discovery["Turf discovery<br/>[FindTurf.jsx]"]
  node_details["Turf details<br/>[TurfDetails.jsx]"]
  node_bookingui["Booking flow<br/>[Booking.jsx]"]
  node_paymentui["Payment flow<br/>[Payment.jsx]"]
  node_ownerui["Turf registration<br/>[AddTurf.jsx]"]
  node_adminui["Admin dashboard<br/>[AdminDashboard.jsx]"]
  node_api["API client<br/>[api.js]"]
end

subgraph group_access["Access and identity"]
  node_authstate["Auth state<br/>[AuthSlice.js]"]
  node_gateway["API gateway<br/>[RouteConfig.java]"]
  node_jwt["JWT utilities<br/>[JwtUtil.java]"]
  node_customers["Customer accounts"]
  node_customerexceptions["Customer exceptions"]
end

subgraph group_venues["Turf management"]
  node_turfapi["Turf API"]
  node_gameapi["Game and court API"]
  node_turfservice["Turf operations<br/>[TurfService.java]"]
  node_turfrepo[("Turf records<br/>[TurfRepo.java]")]
end

subgraph group_booking["Booking and payment"]
  node_bookingapi["Booking API"]
  node_bookingservice["Booking operations"]
  node_bookingstore[("Booking records")]
  node_paymentapi["Payment API"]
  node_stripeservice["Stripe checkout<br/>[StripeService.java]"]
end

subgraph group_platform["Service platform"]
  node_eureka["Service registry"]
end

node_visitor(("User or owner"))
node_stripe["Stripe"]

node_visitor -->|"uses"| node_webapp
node_webapp -->|"routes to"| node_discovery
node_webapp -->|"routes to"| node_details
node_webapp -->|"routes to"| node_bookingui
node_webapp -->|"routes to"| node_ownerui
node_webapp -->|"routes to"| node_adminui
node_authstate -->|"calls"| node_api
node_visitor -.->|"requests"| node_gateway
node_gateway -->|"uses"| node_jwt
node_customers -->|"declares errors"| node_customerexceptions
node_turfapi -->|"delegates to"| node_turfservice
node_gameapi -->|"delegates to"| node_turfservice
node_visitor -.->|"browses"| node_turfapi
node_bookingapi -->|"delegates to"| node_bookingservice
node_paymentapi -->|"delegates to"| node_stripeservice
node_stripeservice -->|"creates checkout"| node_stripe
node_visitor -.->|"books"| node_bookingapi
node_bookingui -.->|"continues to"| node_paymentui

click node_webapp "https://github.com/dharanes/sportify/blob/main/FRONTEND/src/main.jsx"
click node_discovery "https://github.com/dharanes/sportify/blob/main/FRONTEND/src/components/FindTurf/FindTurf.jsx"
click node_details "https://github.com/dharanes/sportify/blob/main/FRONTEND/src/components/Turf/TurfDetails.jsx"
click node_bookingui "https://github.com/dharanes/sportify/blob/main/FRONTEND/src/components/Booking/Booking.jsx"
click node_paymentui "https://github.com/dharanes/sportify/blob/main/FRONTEND/src/components/Booking/Payment.jsx"
click node_ownerui "https://github.com/dharanes/sportify/blob/main/FRONTEND/src/components/Profile/AddTurf.jsx"
click node_adminui "https://github.com/dharanes/sportify/blob/main/FRONTEND/src/components/Admin/AdminDashboard.jsx"
click node_api "https://github.com/dharanes/sportify/blob/main/FRONTEND/src/Api/api.js"
click node_authstate "https://github.com/dharanes/sportify/blob/main/FRONTEND/src/ReduxToolKit/AuthSlice.js"
click node_gateway "https://github.com/dharanes/sportify/blob/main/BACKEND/Gateway/src/main/java/com/gateway/config/RouteConfig.java"
click node_jwt "https://github.com/dharanes/sportify/blob/main/BACKEND/Gateway/src/main/java/com/gateway/util/JwtUtil.java"
click node_customers "https://github.com/dharanes/sportify/blob/main/BACKEND/CustomerService/src/main/java/com/customer/service/CustomerService.java"
click node_customerexceptions "https://github.com/dharanes/sportify/blob/main/BACKEND/CustomerService/src/main/java/com/customer/exception/CustomerAlreadyExistsException.java"
click node_turfapi "https://github.com/dharanes/sportify/blob/main/BACKEND/TurfService/src/main/java/com/turf/controller/TurfController.java"
click node_gameapi "https://github.com/dharanes/sportify/blob/main/BACKEND/TurfService/src/main/java/com/turf/controller/GameController.java"
click node_turfservice "https://github.com/dharanes/sportify/blob/main/BACKEND/TurfService/src/main/java/com/turf/service/TurfService.java"
click node_turfrepo "https://github.com/dharanes/sportify/blob/main/BACKEND/TurfService/src/main/java/com/turf/repository/TurfRepo.java"
click node_bookingapi "https://github.com/dharanes/sportify/blob/main/BACKEND/BookingService/src/main/java/com/booking/controller/BookingController.java"
click node_bookingservice "https://github.com/dharanes/sportify/blob/main/BACKEND/BookingService/src/main/java/com/booking/service/BookingService.java"
click node_bookingstore "https://github.com/dharanes/sportify/blob/main/BACKEND/BookingService/src/main/java/com/booking/repository/BookingRepository.java"
click node_paymentapi "https://github.com/dharanes/sportify/blob/main/BACKEND/payment-stripe/src/main/java/com/payment/controller/PaymentController.java"
click node_stripeservice "https://github.com/dharanes/sportify/blob/main/BACKEND/payment-stripe/src/main/java/com/payment/service/StripeService.java"
click node_eureka "https://github.com/dharanes/sportify/blob/main/BACKEND/Eureka/src/main/java/com/eureka/EurekaApplication.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_webapp,node_discovery,node_details,node_bookingui,node_paymentui,node_ownerui,node_adminui,node_api,node_visitor toneBlue
class node_authstate,node_gateway,node_jwt,node_customers,node_customerexceptions toneAmber
class node_turfapi,node_gameapi,node_turfservice,node_turfrepo toneMint
class node_bookingapi,node_bookingservice,node_bookingstore,node_paymentapi,node_stripeservice toneRose
class node_eureka,node_stripe toneIndigo
```

## Components

### Web client

- [Web application](https://github.com/dharanes/sportify/blob/main/FRONTEND/src/main.jsx): `FRONTEND/src/main.jsx`
- [Turf discovery](https://github.com/dharanes/sportify/blob/main/FRONTEND/src/components/FindTurf/FindTurf.jsx): `FRONTEND/src/components/FindTurf/FindTurf.jsx`
- [Turf details](https://github.com/dharanes/sportify/blob/main/FRONTEND/src/components/Turf/TurfDetails.jsx): `FRONTEND/src/components/Turf/TurfDetails.jsx`
- [Booking flow](https://github.com/dharanes/sportify/blob/main/FRONTEND/src/components/Booking/Booking.jsx): `FRONTEND/src/components/Booking/Booking.jsx`
- [Payment flow](https://github.com/dharanes/sportify/blob/main/FRONTEND/src/components/Booking/Payment.jsx): `FRONTEND/src/components/Booking/Payment.jsx`
- [Turf registration](https://github.com/dharanes/sportify/blob/main/FRONTEND/src/components/Profile/AddTurf.jsx): `FRONTEND/src/components/Profile/AddTurf.jsx`
- [Admin dashboard](https://github.com/dharanes/sportify/blob/main/FRONTEND/src/components/Admin/AdminDashboard.jsx): `FRONTEND/src/components/Admin/AdminDashboard.jsx`
- [API client](https://github.com/dharanes/sportify/blob/main/FRONTEND/src/Api/api.js): `FRONTEND/src/Api/api.js`

### Access and identity

- [Auth state](https://github.com/dharanes/sportify/blob/main/FRONTEND/src/ReduxToolKit/AuthSlice.js): `FRONTEND/src/ReduxToolKit/AuthSlice.js`
- [API gateway](https://github.com/dharanes/sportify/blob/main/BACKEND/Gateway/src/main/java/com/gateway/config/RouteConfig.java): `BACKEND/Gateway/src/main/java/com/gateway/config/RouteConfig.java`
- [JWT utilities](https://github.com/dharanes/sportify/blob/main/BACKEND/Gateway/src/main/java/com/gateway/util/JwtUtil.java): `BACKEND/Gateway/src/main/java/com/gateway/util/JwtUtil.java`
- [Customer accounts](https://github.com/dharanes/sportify/blob/main/BACKEND/CustomerService/src/main/java/com/customer/service/CustomerService.java): `BACKEND/CustomerService/src/main/java/com/customer/service/CustomerService.java`
- [Customer exceptions](https://github.com/dharanes/sportify/blob/main/BACKEND/CustomerService/src/main/java/com/customer/exception/CustomerAlreadyExistsException.java): `BACKEND/CustomerService/src/main/java/com/customer/exception/CustomerAlreadyExistsException.java`

### Turf management

- [Turf API](https://github.com/dharanes/sportify/blob/main/BACKEND/TurfService/src/main/java/com/turf/controller/TurfController.java): `BACKEND/TurfService/src/main/java/com/turf/controller/TurfController.java`
- [Game and court API](https://github.com/dharanes/sportify/blob/main/BACKEND/TurfService/src/main/java/com/turf/controller/GameController.java): `BACKEND/TurfService/src/main/java/com/turf/controller/GameController.java`
- [Turf operations](https://github.com/dharanes/sportify/blob/main/BACKEND/TurfService/src/main/java/com/turf/service/TurfService.java): `BACKEND/TurfService/src/main/java/com/turf/service/TurfService.java`
- [Turf records](https://github.com/dharanes/sportify/blob/main/BACKEND/TurfService/src/main/java/com/turf/repository/TurfRepo.java): `BACKEND/TurfService/src/main/java/com/turf/repository/TurfRepo.java`

### Booking and payment

- [Booking API](https://github.com/dharanes/sportify/blob/main/BACKEND/BookingService/src/main/java/com/booking/controller/BookingController.java): `BACKEND/BookingService/src/main/java/com/booking/controller/BookingController.java`
- [Booking operations](https://github.com/dharanes/sportify/blob/main/BACKEND/BookingService/src/main/java/com/booking/service/BookingService.java): `BACKEND/BookingService/src/main/java/com/booking/service/BookingService.java`
- [Booking records](https://github.com/dharanes/sportify/blob/main/BACKEND/BookingService/src/main/java/com/booking/repository/BookingRepository.java): `BACKEND/BookingService/src/main/java/com/booking/repository/BookingRepository.java`
- [Payment API](https://github.com/dharanes/sportify/blob/main/BACKEND/payment-stripe/src/main/java/com/payment/controller/PaymentController.java): `BACKEND/payment-stripe/src/main/java/com/payment/controller/PaymentController.java`
- [Stripe checkout](https://github.com/dharanes/sportify/blob/main/BACKEND/payment-stripe/src/main/java/com/payment/service/StripeService.java): `BACKEND/payment-stripe/src/main/java/com/payment/service/StripeService.java`

### Service platform

- [Service registry](https://github.com/dharanes/sportify/blob/main/BACKEND/Eureka/src/main/java/com/eureka/EurekaApplication.java): `BACKEND/Eureka/src/main/java/com/eureka/EurekaApplication.java`

### Other components

- **User or owner**
- **Stripe**

## Connections

- User or owner → Web application: uses
- Web application → Turf discovery: routes to (evidence: `FRONTEND/src/main.jsx`)
- Web application → Turf details: routes to (evidence: `FRONTEND/src/main.jsx`)
- Web application → Booking flow: routes to (evidence: `FRONTEND/src/main.jsx`)
- Web application → Turf registration: routes to (evidence: `FRONTEND/src/main.jsx`)
- Web application → Admin dashboard: routes to (evidence: `FRONTEND/src/main.jsx`)
- Auth state → API client: calls (evidence: `FRONTEND/src/ReduxToolKit/AuthSlice.js`)
- User or owner → API gateway: requests
- API gateway → JWT utilities: uses
- Customer accounts → Customer exceptions: declares errors (evidence: `BACKEND/CustomerService/src/main/java/com/customer/service/CustomerService.java`)
- Turf API → Turf operations: delegates to (evidence: `BACKEND/TurfService/src/main/java/com/turf/controller/TurfController.java`)
- Game and court API → Turf operations: delegates to (evidence: `BACKEND/TurfService/src/main/java/com/turf/controller/GameController.java`)
- User or owner → Turf API: browses
- Booking API → Booking operations: delegates to (evidence: `BACKEND/BookingService/src/main/java/com/booking/controller/BookingController.java`)
- Payment API → Stripe checkout: delegates to (evidence: `BACKEND/payment-stripe/src/main/java/com/payment/controller/PaymentController.java`)
- Stripe checkout → Stripe: creates checkout (evidence: `BACKEND/payment-stripe/src/main/java/com/payment/service/StripeService.java`)
- User or owner → Booking API: books
- Booking flow → Payment flow: continues to
