# aditya-karn234/air-altura architecture

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

- Interactive diagram: https://gitdiagram.com/aditya-karn234/air-altura
- Repository: https://github.com/aditya-karn234/air-altura

## Overview

Air Altura is a full-stack airline booking system. A traveler searches flights, selects a flight and cabin, creates a seat-reserving booking, pays within a 10-minute window, and can review or cancel bookings; successful payment triggers a confirmation email. The frontend routes and search widget, booking controller/service, and flight search/controller excerpts support key steps. The README documents gateway-wide API routing, expiry, idempotency, seat restoration, and notifications. Many service routes and integrations are unsampled, so their links are shown only where documented.

Main entry points: [`Air-Altura-Frontend/src/App.jsx`](https://github.com/aditya-karn234/air-altura/blob/main/Air-Altura-Frontend/src/App.jsx) (React app routes), [`Air-Altura-Frontend/src/api.js`](https://github.com/aditya-karn234/air-altura/blob/main/Air-Altura-Frontend/src/api.js) (Frontend API client), [`Booking-service/src/services/booking-service.js`](https://github.com/aditya-karn234/air-altura/blob/main/Booking-service/src/services/booking-service.js) (Booking orchestration), [`Air-Altura-Frontend/src/pages/SearchPage.jsx`](https://github.com/aditya-karn234/air-altura/blob/main/Air-Altura-Frontend/src/pages/SearchPage.jsx) (Flight search UI)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Traveler experience"]
  node_web["React app routes<br/>[App.jsx]"]
  node_search["Flight search UI<br/>[SearchPage.jsx]"]
  node_searchwidget["Search form<br/>[SearchWidget.jsx]"]
  node_results["Results and details<br/>[ResultsPage.jsx]"]
  node_bookingui["Booking and payment<br/>[BookingPage.jsx]"]
  node_bookinghistory["Booking history<br/>[BookingsPage.jsx]"]
  node_authui["Sign-in and account<br/>[AuthPage.jsx]"]
  node_api["Frontend API client<br/>[api.js]"]
end

subgraph group_gateway["API gateway"]
  node_gatewayentry["Public API gateway<br/>[index.js]"]
  node_authroutes["Auth routes<br/>[auth-router.js]"]
  node_auth["Registration and login<br/>[auth-controller.js]"]
  node_tokencheck["JWT authentication<br/>[auth-middleware.js]"]
  node_userstore[("User records<br/>[user.js]")]
end

subgraph group_flights["Flight inventory"]
  node_flightapi["Flight API<br/>[flight-routes.js]"]
  node_flightcontroller["Flight handlers"]
  node_flightlogic["Search and seat logic<br/>[flight-service.js]"]
  node_flightrepo["Flight data access"]
  node_flightdb[("Flight inventory database<br/>[flight.js]")]
end

subgraph group_booking["Booking lifecycle"]
  node_bookingapi["Booking endpoints<br/>[booking.js]"]
  node_bookingcontroller["Booking handlers"]
  node_bookinglogic["Booking orchestration<br/>[booking-service.js]"]
  node_bookingrepo["Booking data access"]
  node_bookingdb[("Booking database<br/>[booking.js]")]
  node_idempotency["Payment idempotency<br/>[idempotency.js]"]
  node_cron["Booking expiry janitor<br/>[cron-jobs.js]"]
end

subgraph group_events["Async notifications"]
  node_rabbit["RabbitMQ events"]
  node_seatrestore["Seat restoration consumer"]
  node_emailconsumer["Confirmation email consumer"]
end

node_traveler(("Traveler"))
node_redis[("Redis")]
node_emailprovider["Email delivery"]

node_traveler -->|"uses"| node_web
node_web -->|"routes to"| node_search
node_web -->|"routes to"| node_results
node_web -->|"routes to"| node_bookingui
node_web -->|"routes to"| node_bookinghistory
node_web -->|"routes to"| node_authui
node_search -->|"renders"| node_searchwidget
node_search -->|"navigates to"| node_results
node_search -.->|"requests flights"| node_api
node_results -.->|"requests flights"| node_api
node_bookingui -.->|"sends booking"| node_api
node_bookinghistory -.->|"requests bookings"| node_api
node_authui -->|"sends credentials"| node_api
node_api -->|"sends API traffic"| node_gatewayentry
node_gatewayentry -.->|"mounts routes"| node_authroutes
node_authroutes -->|"dispatches"| node_auth
node_authroutes -->|"authenticates logout"| node_tokencheck
node_auth -->|"reads and writes"| node_userstore
node_auth -->|"blacklists token"| node_redis
node_gatewayentry -->|"forwards booking API"| node_bookingapi
node_gatewayentry -->|"forwards flight API"| node_flightapi
node_flightapi -->|"dispatches"| node_flightcontroller
node_flightcontroller -->|"calls"| node_flightlogic
node_flightlogic -->|"queries"| node_flightrepo
node_flightrepo -->|"reads and writes"| node_flightdb
node_flightlogic -->|"caches searches"| node_redis
node_bookingapi -.->|"dispatches"| node_bookingcontroller
node_bookingcontroller -->|"calls"| node_bookinglogic
node_bookinglogic -->|"accesses bookings"| node_bookingrepo
node_bookingrepo -->|"reads and writes"| node_bookingdb
node_bookinglogic -->|"reserves seats by HTTP"| node_flightapi
node_bookingcontroller -.->|"protects payment"| node_idempotency
node_idempotency -->|"claims payment key"| node_redis
node_cron -.->|"expires bookings"| node_bookingdb
node_bookinglogic -->|"publishes restoration"| node_rabbit
node_cron -->|"publishes restoration"| node_rabbit
node_rabbit -->|"delivers event"| node_seatrestore
node_seatrestore -->|"restores seats"| node_flightlogic
node_bookinglogic -.->|"publishes confirmation"| node_rabbit
node_rabbit -->|"delivers event"| node_emailconsumer
node_emailconsumer -->|"sends email"| node_emailprovider

click node_web "https://github.com/aditya-karn234/air-altura/blob/main/Air-Altura-Frontend/src/App.jsx"
click node_search "https://github.com/aditya-karn234/air-altura/blob/main/Air-Altura-Frontend/src/pages/SearchPage.jsx"
click node_searchwidget "https://github.com/aditya-karn234/air-altura/blob/main/Air-Altura-Frontend/src/components/SearchWidget.jsx"
click node_results "https://github.com/aditya-karn234/air-altura/blob/main/Air-Altura-Frontend/src/pages/ResultsPage.jsx"
click node_bookingui "https://github.com/aditya-karn234/air-altura/blob/main/Air-Altura-Frontend/src/pages/BookingPage.jsx"
click node_bookinghistory "https://github.com/aditya-karn234/air-altura/blob/main/Air-Altura-Frontend/src/pages/BookingsPage.jsx"
click node_authui "https://github.com/aditya-karn234/air-altura/blob/main/Air-Altura-Frontend/src/pages/AuthPage.jsx"
click node_api "https://github.com/aditya-karn234/air-altura/blob/main/Air-Altura-Frontend/src/api.js"
click node_gatewayentry "https://github.com/aditya-karn234/air-altura/blob/main/API-Gateway/src/index.js"
click node_authroutes "https://github.com/aditya-karn234/air-altura/blob/main/API-Gateway/src/routes/v1/auth-router.js"
click node_auth "https://github.com/aditya-karn234/air-altura/blob/main/API-Gateway/src/controllers/auth-controller.js"
click node_tokencheck "https://github.com/aditya-karn234/air-altura/blob/main/API-Gateway/src/middlewares/auth-middleware.js"
click node_userstore "https://github.com/aditya-karn234/air-altura/blob/main/API-Gateway/src/models/user.js"
click node_flightapi "https://github.com/aditya-karn234/air-altura/blob/main/Flights-Service/src/routes/v1/flight-routes.js"
click node_flightcontroller "https://github.com/aditya-karn234/air-altura/blob/main/Flights-Service/src/controllers/flight-controller.js"
click node_flightlogic "https://github.com/aditya-karn234/air-altura/blob/main/Flights-Service/src/services/flight-service.js"
click node_flightrepo "https://github.com/aditya-karn234/air-altura/blob/main/Flights-Service/src/repositories/flight-repository.js"
click node_flightdb "https://github.com/aditya-karn234/air-altura/blob/main/Flights-Service/src/models/flight.js"
click node_bookingapi "https://github.com/aditya-karn234/air-altura/blob/main/Booking-service/src/routes/v1/booking.js"
click node_bookingcontroller "https://github.com/aditya-karn234/air-altura/blob/main/Booking-service/src/controllers/booking-controller.js"
click node_bookinglogic "https://github.com/aditya-karn234/air-altura/blob/main/Booking-service/src/services/booking-service.js"
click node_bookingrepo "https://github.com/aditya-karn234/air-altura/blob/main/Booking-service/src/repositories/booking-repository.js"
click node_bookingdb "https://github.com/aditya-karn234/air-altura/blob/main/Booking-service/src/models/booking.js"
click node_idempotency "https://github.com/aditya-karn234/air-altura/blob/main/Booking-service/src/middlewares/idempotency.js"
click node_cron "https://github.com/aditya-karn234/air-altura/blob/main/Booking-service/src/utils/common/cron-jobs.js"
click node_seatrestore "https://github.com/aditya-karn234/air-altura/blob/main/Flights-Service/src/subscribers/seat-restoration.js"
click node_emailconsumer "https://github.com/aditya-karn234/air-altura/blob/main/Notifications-Service/src/subscribers/booking-confirmed.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_web,node_search,node_searchwidget,node_results,node_bookingui,node_bookinghistory,node_authui,node_api toneBlue
class node_gatewayentry,node_authroutes,node_auth,node_tokencheck,node_userstore,node_redis toneAmber
class node_flightapi,node_flightcontroller,node_flightlogic,node_flightrepo,node_flightdb toneMint
class node_bookingapi,node_bookingcontroller,node_bookinglogic,node_bookingrepo,node_bookingdb,node_idempotency,node_cron toneRose
class node_rabbit,node_seatrestore,node_emailconsumer,node_traveler,node_emailprovider toneIndigo
```

## Components

### Traveler experience

- [React app routes](https://github.com/aditya-karn234/air-altura/blob/main/Air-Altura-Frontend/src/App.jsx): `Air-Altura-Frontend/src/App.jsx`
- [Flight search UI](https://github.com/aditya-karn234/air-altura/blob/main/Air-Altura-Frontend/src/pages/SearchPage.jsx): `Air-Altura-Frontend/src/pages/SearchPage.jsx`
- [Search form](https://github.com/aditya-karn234/air-altura/blob/main/Air-Altura-Frontend/src/components/SearchWidget.jsx): `Air-Altura-Frontend/src/components/SearchWidget.jsx`
- [Results and details](https://github.com/aditya-karn234/air-altura/blob/main/Air-Altura-Frontend/src/pages/ResultsPage.jsx): `Air-Altura-Frontend/src/pages/ResultsPage.jsx`
- [Booking and payment](https://github.com/aditya-karn234/air-altura/blob/main/Air-Altura-Frontend/src/pages/BookingPage.jsx): `Air-Altura-Frontend/src/pages/BookingPage.jsx`
- [Booking history](https://github.com/aditya-karn234/air-altura/blob/main/Air-Altura-Frontend/src/pages/BookingsPage.jsx): `Air-Altura-Frontend/src/pages/BookingsPage.jsx`
- [Sign-in and account](https://github.com/aditya-karn234/air-altura/blob/main/Air-Altura-Frontend/src/pages/AuthPage.jsx): `Air-Altura-Frontend/src/pages/AuthPage.jsx`
- [Frontend API client](https://github.com/aditya-karn234/air-altura/blob/main/Air-Altura-Frontend/src/api.js): `Air-Altura-Frontend/src/api.js`

### API gateway

- [Public API gateway](https://github.com/aditya-karn234/air-altura/blob/main/API-Gateway/src/index.js): `API-Gateway/src/index.js`
- [Auth routes](https://github.com/aditya-karn234/air-altura/blob/main/API-Gateway/src/routes/v1/auth-router.js): `API-Gateway/src/routes/v1/auth-router.js`
- [Registration and login](https://github.com/aditya-karn234/air-altura/blob/main/API-Gateway/src/controllers/auth-controller.js): `API-Gateway/src/controllers/auth-controller.js`
- [JWT authentication](https://github.com/aditya-karn234/air-altura/blob/main/API-Gateway/src/middlewares/auth-middleware.js): `API-Gateway/src/middlewares/auth-middleware.js`
- [User records](https://github.com/aditya-karn234/air-altura/blob/main/API-Gateway/src/models/user.js): `API-Gateway/src/models/user.js`

### Flight inventory

- [Flight API](https://github.com/aditya-karn234/air-altura/blob/main/Flights-Service/src/routes/v1/flight-routes.js): `Flights-Service/src/routes/v1/flight-routes.js`
- [Flight handlers](https://github.com/aditya-karn234/air-altura/blob/main/Flights-Service/src/controllers/flight-controller.js): `Flights-Service/src/controllers/flight-controller.js`
- [Search and seat logic](https://github.com/aditya-karn234/air-altura/blob/main/Flights-Service/src/services/flight-service.js): `Flights-Service/src/services/flight-service.js`
- [Flight data access](https://github.com/aditya-karn234/air-altura/blob/main/Flights-Service/src/repositories/flight-repository.js): `Flights-Service/src/repositories/flight-repository.js`
- [Flight inventory database](https://github.com/aditya-karn234/air-altura/blob/main/Flights-Service/src/models/flight.js): `Flights-Service/src/models/flight.js`

### Booking lifecycle

- [Booking endpoints](https://github.com/aditya-karn234/air-altura/blob/main/Booking-service/src/routes/v1/booking.js): `Booking-service/src/routes/v1/booking.js`
- [Booking handlers](https://github.com/aditya-karn234/air-altura/blob/main/Booking-service/src/controllers/booking-controller.js): `Booking-service/src/controllers/booking-controller.js`
- [Booking orchestration](https://github.com/aditya-karn234/air-altura/blob/main/Booking-service/src/services/booking-service.js): `Booking-service/src/services/booking-service.js`
- [Booking data access](https://github.com/aditya-karn234/air-altura/blob/main/Booking-service/src/repositories/booking-repository.js): `Booking-service/src/repositories/booking-repository.js`
- [Booking database](https://github.com/aditya-karn234/air-altura/blob/main/Booking-service/src/models/booking.js): `Booking-service/src/models/booking.js`
- [Payment idempotency](https://github.com/aditya-karn234/air-altura/blob/main/Booking-service/src/middlewares/idempotency.js): `Booking-service/src/middlewares/idempotency.js`
- [Booking expiry janitor](https://github.com/aditya-karn234/air-altura/blob/main/Booking-service/src/utils/common/cron-jobs.js): `Booking-service/src/utils/common/cron-jobs.js`

### Async notifications

- **RabbitMQ events**
- [Seat restoration consumer](https://github.com/aditya-karn234/air-altura/blob/main/Flights-Service/src/subscribers/seat-restoration.js): `Flights-Service/src/subscribers/seat-restoration.js`
- [Confirmation email consumer](https://github.com/aditya-karn234/air-altura/blob/main/Notifications-Service/src/subscribers/booking-confirmed.js): `Notifications-Service/src/subscribers/booking-confirmed.js`

### Other components

- **Traveler**
- **Redis**
- **Email delivery**

## Connections

- Traveler → React app routes: uses (evidence: `README.md`)
- React app routes → Flight search UI: routes to (evidence: `Air-Altura-Frontend/src/App.jsx`)
- React app routes → Results and details: routes to (evidence: `Air-Altura-Frontend/src/App.jsx`)
- React app routes → Booking and payment: routes to (evidence: `Air-Altura-Frontend/src/App.jsx`)
- React app routes → Booking history: routes to (evidence: `Air-Altura-Frontend/src/App.jsx`)
- React app routes → Sign-in and account: routes to (evidence: `Air-Altura-Frontend/src/App.jsx`)
- Flight search UI → Search form: renders (evidence: `Air-Altura-Frontend/src/pages/SearchPage.jsx`)
- Flight search UI → Results and details: navigates to (evidence: `Air-Altura-Frontend/src/pages/SearchPage.jsx`)
- Flight search UI → Frontend API client: requests flights
- Results and details → Frontend API client: requests flights
- Booking and payment → Frontend API client: sends booking
- Booking history → Frontend API client: requests bookings
- Sign-in and account → Frontend API client: sends credentials (evidence: `Air-Altura-Frontend/src/pages/AuthPage.jsx`)
- Frontend API client → Public API gateway: sends API traffic (evidence: `README.md`)
- Public API gateway → Auth routes: mounts routes
- Auth routes → Registration and login: dispatches (evidence: `API-Gateway/src/routes/v1/auth-router.js`)
- Auth routes → JWT authentication: authenticates logout (evidence: `API-Gateway/src/routes/v1/auth-router.js`)
- Registration and login → User records: reads and writes (evidence: `API-Gateway/src/controllers/auth-controller.js`)
- Registration and login → Redis: blacklists token (evidence: `API-Gateway/src/controllers/auth-controller.js`)
- Public API gateway → Booking endpoints: forwards booking API (evidence: `README.md`)
- Public API gateway → Flight API: forwards flight API (evidence: `README.md`)
- Flight API → Flight handlers: dispatches (evidence: `Flights-Service/src/routes/v1/flight-routes.js`)
- Flight handlers → Search and seat logic: calls (evidence: `Flights-Service/src/controllers/flight-controller.js`)
- Search and seat logic → Flight data access: queries (evidence: `Flights-Service/src/services/flight-service.js`)
- Flight data access → Flight inventory database: reads and writes (evidence: `Flights-Service/src/repositories/flight-repository.js`)
- Search and seat logic → Redis: caches searches (evidence: `Flights-Service/src/services/flight-service.js`)
- Booking endpoints → Booking handlers: dispatches
- Booking handlers → Booking orchestration: calls (evidence: `Booking-service/src/controllers/booking-controller.js`)
- Booking orchestration → Booking data access: accesses bookings (evidence: `Booking-service/src/services/booking-service.js`)
- Booking data access → Booking database: reads and writes (evidence: `Booking-service/src/repositories/booking-repository.js`)
- Booking orchestration → Flight API: reserves seats by HTTP (evidence: `Booking-service/src/services/booking-service.js`)
- Booking handlers → Payment idempotency: protects payment
- Payment idempotency → Redis: claims payment key (evidence: `README.md`)
- Booking expiry janitor → Booking database: expires bookings
- Booking orchestration → RabbitMQ events: publishes restoration (evidence: `Booking-service/src/services/booking-service.js`)
- Booking expiry janitor → RabbitMQ events: publishes restoration (evidence: `README.md`)
- RabbitMQ events → Seat restoration consumer: delivers event (evidence: `README.md`)
- Seat restoration consumer → Search and seat logic: restores seats (evidence: `README.md`)
- Booking orchestration → RabbitMQ events: publishes confirmation
- RabbitMQ events → Confirmation email consumer: delivers event (evidence: `README.md`)
- Confirmation email consumer → Email delivery: sends email (evidence: `README.md`)
