# fumikobotan15-max/showtime architecture

> Architecture diagram of the GitHub repository fumikobotan15-max/showtime, 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/fumikobotan15-max/showtime
- Repository: https://github.com/fumikobotan15-max/showtime

## Overview

ShowTime is a movie-ticket booking application. Users sign in, set location and preferences, browse scheduled movies and showtimes, choose seats, pay, and receive a ticket; they can also manage bookings and account details. The map groups the React route stages, Express API domains, and persistence/integration layer. The README documents the end-to-end flow and payment guarantees; several backend routes and pages are indexed but not excerpted, so links not directly evidenced are omitted or marked unverified.

Main entry points: [`client/src/api.js`](https://github.com/fumikobotan15-max/showtime/blob/main/client/src/api.js) (API client), [`client/src/App.jsx`](https://github.com/fumikobotan15-max/showtime/blob/main/client/src/App.jsx) (Route shell), [`server/routes/auth.js`](https://github.com/fumikobotan15-max/showtime/blob/main/server/routes/auth.js) (Authentication API), [`server/routes/booking.js`](https://github.com/fumikobotan15-max/showtime/blob/main/server/routes/booking.js) (Booking and payments)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Booking experience"]
  node_app["Route shell<br/>[App.jsx]"]
  node_identity_ui["Sign-in and recovery<br/>[AuthPages.jsx]"]
  node_session["Auth session<br/>[auth.jsx]"]
  node_setup_ui["Location and preferences<br/>[Wizard.jsx]"]
  node_discovery_ui["Movie discovery<br/>[Home.jsx]"]
  node_movie_ui["Movie details<br/>[Movie.jsx]"]
  node_shows_ui["Showtime selection<br/>[Shows.jsx]"]
  node_seats_ui["Seat selection<br/>[Seats.jsx]"]
  node_checkout_ui["Checkout<br/>[Checkout.jsx]"]
  node_ticket_ui["Ticket and bookings<br/>[Ticket.jsx]"]
  node_account_ui["Account settings"]
  node_api_client["API client<br/>[api.js]"]
end

subgraph group_api["Application API"]
  node_auth_routes["Authentication API<br/>[auth.js]"]
  node_catalog_routes["Catalog API<br/>[catalog.js]"]
  node_location_routes["Location API<br/>[location.js]"]
  node_preferences_routes["Preferences API<br/>[preferences.js]"]
  node_booking_routes["Booking and payments<br/>[booking.js]"]
  node_seat_logic["Seat layout and pricing<br/>[seatLayout.js]"]
end

subgraph group_data["Domain data"]
  node_models[("MongoDB domain models<br/>[index.js]")]
  node_database[("MongoDB")]
end

subgraph group_integrations["External services"]
  node_oauth_service["OAuth provider flows<br/>[oauth.js]"]
  node_tmdb_service["Movie title search<br/>[tmdb.js]"]
  node_razorpay["Razorpay"]
  node_twilio["Twilio SMS"]
  node_nominatim["Nominatim geocoding"]
end

node_customer(("Moviegoer"))

node_customer -->|"uses"| node_app
node_app -->|"routes to"| node_identity_ui
node_app -->|"routes to"| node_setup_ui
node_app -->|"routes to"| node_discovery_ui
node_app -->|"routes to"| node_movie_ui
node_app -->|"routes to"| node_shows_ui
node_app -->|"routes to"| node_seats_ui
node_app -->|"routes to"| node_checkout_ui
node_app -->|"routes to"| node_ticket_ui
node_app -->|"routes to"| node_account_ui
node_app -->|"checks session"| node_session
node_identity_ui -->|"signs in through"| node_session
node_session -->|"requests"| node_api_client
node_setup_ui -->|"requests"| node_api_client
node_discovery_ui -->|"requests"| node_api_client
node_movie_ui -->|"requests"| node_api_client
node_shows_ui -->|"requests"| node_api_client
node_seats_ui -->|"requests"| node_api_client
node_checkout_ui -->|"requests"| node_api_client
node_ticket_ui -.->|"requests"| node_api_client
node_account_ui -->|"requests"| node_api_client
node_api_client -.->|"calls API"| node_auth_routes
node_api_client -.->|"calls API"| node_catalog_routes
node_api_client -.->|"calls API"| node_location_routes
node_api_client -.->|"calls API"| node_preferences_routes
node_api_client -.->|"calls API"| node_booking_routes
node_auth_routes -->|"reads and writes"| node_models
node_auth_routes -->|"delegates OAuth"| node_oauth_service
node_catalog_routes -->|"queries catalog"| node_models
node_catalog_routes -->|"searches titles"| node_tmdb_service
node_booking_routes -->|"reads and writes"| node_models
node_booking_routes -->|"validates and prices"| node_seat_logic
node_location_routes -.->|"geocodes"| node_nominatim
node_auth_routes -->|"sends reset OTP"| node_twilio
node_booking_routes -->|"creates and verifies payment"| node_razorpay
node_oauth_service -.->|"verifies identity"| node_customer
node_models -.->|"persists domain records"| node_database

click node_app "https://github.com/fumikobotan15-max/showtime/blob/main/client/src/App.jsx"
click node_identity_ui "https://github.com/fumikobotan15-max/showtime/blob/main/client/src/pages/AuthPages.jsx"
click node_session "https://github.com/fumikobotan15-max/showtime/blob/main/client/src/auth.jsx"
click node_setup_ui "https://github.com/fumikobotan15-max/showtime/blob/main/client/src/pages/Wizard.jsx"
click node_discovery_ui "https://github.com/fumikobotan15-max/showtime/blob/main/client/src/pages/Home.jsx"
click node_movie_ui "https://github.com/fumikobotan15-max/showtime/blob/main/client/src/pages/Movie.jsx"
click node_shows_ui "https://github.com/fumikobotan15-max/showtime/blob/main/client/src/pages/Shows.jsx"
click node_seats_ui "https://github.com/fumikobotan15-max/showtime/blob/main/client/src/pages/Seats.jsx"
click node_checkout_ui "https://github.com/fumikobotan15-max/showtime/blob/main/client/src/pages/Checkout.jsx"
click node_ticket_ui "https://github.com/fumikobotan15-max/showtime/blob/main/client/src/pages/Ticket.jsx"
click node_account_ui "https://github.com/fumikobotan15-max/showtime/blob/main/client/src/pages/AccountSettings.jsx"
click node_api_client "https://github.com/fumikobotan15-max/showtime/blob/main/client/src/api.js"
click node_auth_routes "https://github.com/fumikobotan15-max/showtime/blob/main/server/routes/auth.js"
click node_catalog_routes "https://github.com/fumikobotan15-max/showtime/blob/main/server/routes/catalog.js"
click node_location_routes "https://github.com/fumikobotan15-max/showtime/blob/main/server/routes/location.js"
click node_preferences_routes "https://github.com/fumikobotan15-max/showtime/blob/main/server/routes/preferences.js"
click node_booking_routes "https://github.com/fumikobotan15-max/showtime/blob/main/server/routes/booking.js"
click node_seat_logic "https://github.com/fumikobotan15-max/showtime/blob/main/server/services/seatLayout.js"
click node_models "https://github.com/fumikobotan15-max/showtime/blob/main/server/models/index.js"
click node_oauth_service "https://github.com/fumikobotan15-max/showtime/blob/main/server/services/oauth.js"
click node_tmdb_service "https://github.com/fumikobotan15-max/showtime/blob/main/server/services/tmdb.js"

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_app,node_identity_ui,node_session,node_setup_ui,node_discovery_ui,node_movie_ui,node_shows_ui,node_seats_ui,node_checkout_ui,node_ticket_ui,node_account_ui,node_api_client toneBlue
class node_auth_routes,node_catalog_routes,node_location_routes,node_preferences_routes,node_booking_routes,node_seat_logic toneAmber
class node_models,node_database toneMint
class node_oauth_service,node_tmdb_service,node_razorpay,node_twilio,node_nominatim toneRose
class node_customer toneIndigo
```

## Components

### Booking experience

- [Route shell](https://github.com/fumikobotan15-max/showtime/blob/main/client/src/App.jsx): `client/src/App.jsx`
- [Sign-in and recovery](https://github.com/fumikobotan15-max/showtime/blob/main/client/src/pages/AuthPages.jsx): `client/src/pages/AuthPages.jsx`
- [Auth session](https://github.com/fumikobotan15-max/showtime/blob/main/client/src/auth.jsx): `client/src/auth.jsx`
- [Location and preferences](https://github.com/fumikobotan15-max/showtime/blob/main/client/src/pages/Wizard.jsx): `client/src/pages/Wizard.jsx`
- [Movie discovery](https://github.com/fumikobotan15-max/showtime/blob/main/client/src/pages/Home.jsx): `client/src/pages/Home.jsx`
- [Movie details](https://github.com/fumikobotan15-max/showtime/blob/main/client/src/pages/Movie.jsx): `client/src/pages/Movie.jsx`
- [Showtime selection](https://github.com/fumikobotan15-max/showtime/blob/main/client/src/pages/Shows.jsx): `client/src/pages/Shows.jsx`
- [Seat selection](https://github.com/fumikobotan15-max/showtime/blob/main/client/src/pages/Seats.jsx): `client/src/pages/Seats.jsx`
- [Checkout](https://github.com/fumikobotan15-max/showtime/blob/main/client/src/pages/Checkout.jsx): `client/src/pages/Checkout.jsx`
- [Ticket and bookings](https://github.com/fumikobotan15-max/showtime/blob/main/client/src/pages/Ticket.jsx): `client/src/pages/Ticket.jsx`
- [Account settings](https://github.com/fumikobotan15-max/showtime/blob/main/client/src/pages/AccountSettings.jsx): `client/src/pages/AccountSettings.jsx`
- [API client](https://github.com/fumikobotan15-max/showtime/blob/main/client/src/api.js): `client/src/api.js`

### Application API

- [Authentication API](https://github.com/fumikobotan15-max/showtime/blob/main/server/routes/auth.js): `server/routes/auth.js`
- [Catalog API](https://github.com/fumikobotan15-max/showtime/blob/main/server/routes/catalog.js): `server/routes/catalog.js`
- [Location API](https://github.com/fumikobotan15-max/showtime/blob/main/server/routes/location.js): `server/routes/location.js`
- [Preferences API](https://github.com/fumikobotan15-max/showtime/blob/main/server/routes/preferences.js): `server/routes/preferences.js`
- [Booking and payments](https://github.com/fumikobotan15-max/showtime/blob/main/server/routes/booking.js): `server/routes/booking.js`
- [Seat layout and pricing](https://github.com/fumikobotan15-max/showtime/blob/main/server/services/seatLayout.js): `server/services/seatLayout.js`

### Domain data

- [MongoDB domain models](https://github.com/fumikobotan15-max/showtime/blob/main/server/models/index.js): `server/models/index.js`
- **MongoDB**

### External services

- [OAuth provider flows](https://github.com/fumikobotan15-max/showtime/blob/main/server/services/oauth.js): `server/services/oauth.js`
- [Movie title search](https://github.com/fumikobotan15-max/showtime/blob/main/server/services/tmdb.js): `server/services/tmdb.js`
- **Razorpay**
- **Twilio SMS**
- **Nominatim geocoding**

### Other components

- **Moviegoer**

## Connections

- Moviegoer → Route shell: uses (evidence: `README.md`)
- Route shell → Sign-in and recovery: routes to (evidence: `client/src/App.jsx`)
- Route shell → Location and preferences: routes to (evidence: `client/src/App.jsx`)
- Route shell → Movie discovery: routes to (evidence: `client/src/App.jsx`)
- Route shell → Movie details: routes to (evidence: `client/src/App.jsx`)
- Route shell → Showtime selection: routes to (evidence: `client/src/App.jsx`)
- Route shell → Seat selection: routes to (evidence: `client/src/App.jsx`)
- Route shell → Checkout: routes to (evidence: `client/src/App.jsx`)
- Route shell → Ticket and bookings: routes to (evidence: `client/src/App.jsx`)
- Route shell → Account settings: routes to (evidence: `client/src/App.jsx`)
- Route shell → Auth session: checks session (evidence: `client/src/App.jsx`)
- Sign-in and recovery → Auth session: signs in through (evidence: `client/src/pages/AuthPages.jsx`)
- Auth session → API client: requests (evidence: `client/src/auth.jsx`)
- Location and preferences → API client: requests (evidence: `client/src/pages/Wizard.jsx`)
- Movie discovery → API client: requests (evidence: `client/src/pages/Home.jsx`)
- Movie details → API client: requests (evidence: `client/src/pages/Movie.jsx`)
- Showtime selection → API client: requests (evidence: `client/src/pages/Shows.jsx`)
- Seat selection → API client: requests (evidence: `client/src/pages/Seats.jsx`)
- Checkout → API client: requests (evidence: `client/src/pages/Checkout.jsx`)
- Ticket and bookings → API client: requests
- Account settings → API client: requests (evidence: `client/src/pages/AccountSettings.jsx`)
- API client → Authentication API: calls API
- API client → Catalog API: calls API
- API client → Location API: calls API
- API client → Preferences API: calls API
- API client → Booking and payments: calls API
- Authentication API → MongoDB domain models: reads and writes (evidence: `server/routes/auth.js`)
- Authentication API → OAuth provider flows: delegates OAuth (evidence: `server/routes/auth.js`)
- Catalog API → MongoDB domain models: queries catalog (evidence: `server/routes/catalog.js`)
- Catalog API → Movie title search: searches titles (evidence: `server/routes/catalog.js`)
- Booking and payments → MongoDB domain models: reads and writes (evidence: `server/routes/booking.js`)
- Booking and payments → Seat layout and pricing: validates and prices (evidence: `server/routes/booking.js`)
- Location API → Nominatim geocoding: geocodes
- Authentication API → Twilio SMS: sends reset OTP (evidence: `server/routes/auth.js`)
- Booking and payments → Razorpay: creates and verifies payment (evidence: `server/routes/booking.js`)
- OAuth provider flows → Moviegoer: verifies identity
- MongoDB domain models → MongoDB: persists domain records
