# gm-gautam12/airline_booking_service architecture

> Architecture diagram of the GitHub repository gm-gautam12/airline_booking_service, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-06-28). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/gm-gautam12/airline_booking_service
- Repository: https://github.com/gm-gautam12/airline_booking_service

## Overview

##### Project type & purpose
- This is a standalone Node.js/Express microservice—part of a larger Airline Management ecosystem—responsible for airline seat booking and payment processing.
- Key indicators:
- README: “Another Service of Airline Management system…handling booking of airlines and payment.”
- File tree: Typical Express folder layout (controllers, services, repositories, models, routes), Sequelize migrations, config and utils.

##### Core architectural layers & patterns
- Layered (n-tier) architecture:
- API Layer: Express routes → controllers
- Business Logic Layer: services
- Data Access Layer: repositories → ORM models → database
- Cross-cutting concerns: config, logging, error handling, middlewares, cron-jobs
- Repository pattern for DB access (crud-repository.js, booking-repository.js).
- MVC-style separation: route definitions delegate to controllers, which invoke services.

##### Main components
a. External Clients & Entry Points
- Mobile/web UI or other backend services → HTTP requests
- (Optionally) API Gateway or Service Mesh in front
b. Booking & Payment Service
- Routes (src/routes)
- Controllers (src/controllers)
- Middlewares (src/middlewares)
- Services (src/services)
- Repositories + Sequelize Models (src/repositories, src/models)
- Migrations (src/migrations)
- Utils & common libs (src/utils/common, errors, helpers)
c. Persistence Layer
- Relational Database (e.g., PostgreSQL/MySQL)
d. External Systems
- Payment Gateway (Stripe, PayPal, etc.)
- (Optional) Message broker / event bus for async notifications
e. Scheduling
- Cron Jobs (src/utils/common/cron-jobs.js) for cleanup, reminders

##### Relationships & data flows
1. Client → (API Gateway) → Express Route
2. Route → Controller → Service
3. Service → Repository → Database
4. Service → Payment Gateway (HTTP/webhook)
5. Cron Job → Service → Database or External Systems
- Error flows: Controller ↔ Middleware for validation/auth/logging
- Config & Logger modules injected at startup

## Diagram (Mermaid)

```mermaid
graph TD
    Client["External Clients(UI/Other Services)"]:::external
    APIGateway["API Gateway"]:::external
    Client -->|HTTP Request| APIGateway

    subgraph "Booking-Payment Service"
        Index["Entry Point (src/index.js)"]:::api

        subgraph "API Layer"
            MainRoutes["Routes Index"]:::api
            V1Index["Versioned Routes Index"]:::api
            BookingRoutes["Booking Routes"]:::api
            ControllersIndex["Controllers Index"]:::api
            BookingController["Booking Controller"]:::api
            InfoController["Info Controller"]:::api
            MiddlewaresIndex["Middlewares Index"]:::api
            BookingMiddleware["Booking Middleware"]:::api
        end

        subgraph "Business Layer"
            ServicesIndex["Services Index"]:::business
            BookingService["Booking Service"]:::business
        end

        subgraph "Data Layer"
            RepositoriesIndex["Repositories Index"]:::data
            CRUDRepository["CRUD Repository"]:::data
            BookingRepository["Booking Repository"]:::data
            ModelsIndex["Models Index"]:::data
            BookingModel["Booking Model"]:::data
            CreateBookingMigration["Create Booking Migration"]:::data
        end

        subgraph "Infra & Cross-Cutting"
            ConfigIndex["Config Index"]:::cross
            ServerConfig["Server Config"]:::cross
            LoggerConfig["Logger Config"]:::cross
            UtilsIndex["Utils Index"]:::cross
            ApiResponse["API Response Wrapper"]:::cross
            ErrorResponse["Error Response Utility"]:::cross
            Enums["Enums"]:::cross
            CronJobs["Cron Job Scheduler"]:::cross
            AppError["Application Error"]:::cross
            DateTimeHelper["Date-Time Helper"]:::cross
        end
    end

    APIGateway -->|forwards to| Index
    Index -->|loads| MainRoutes
    MainRoutes -->|includes| V1Index
    V1Index -->|defines POST /v1/bookings| BookingRoutes
    V1Index -->|defines GET /v1/info| InfoController
    BookingRoutes -->|uses middleware| BookingMiddleware
    BookingRoutes -->|invokes| BookingController
    InfoController -->|invokes| ServicesIndex
    BookingController -->|calls| BookingService
    BookingService -->|uses| BookingRepository
    BookingRepository -->|executes ORM| BookingModel
    BookingModel -->|migrated by| CreateBookingMigration
    BookingService -->|process/payment via REST| PaymentGateway
    CronJobs -.->|scheduled tasks| BookingService
    BookingService -->|CRUD via| CRUDRepository
    CRUDRepository -->|connects to| Database
    BookingRepository -->|connects to| Database
    Database["Relational Database"]:::data
    PaymentGateway["Payment Gateway"]:::external

    BookingMiddleware -->|validates/errors| ErrorResponse
    BookingController -->|wraps response| ApiResponse
    Index -->|configures| ConfigIndex
    ConfigIndex -->|loads| ServerConfig
    ConfigIndex -->|loads| LoggerConfig
    ConfigIndex -->|loads| UtilsIndex
    UtilsIndex -->|exports| ApiResponse
    UtilsIndex -->|exports| ErrorResponse
    UtilsIndex -->|exports| Enums
    UtilsIndex -->|exports| AppError
    UtilsIndex -->|exports| DateTimeHelper
    UtilsIndex -->|exports| CronJobs

    click Index "https://github.com/gm-gautam12/airline_booking_service/blob/master/src/index.js"
    click MainRoutes "https://github.com/gm-gautam12/airline_booking_service/blob/master/src/routes/index.js"
    click V1Index "https://github.com/gm-gautam12/airline_booking_service/blob/master/src/routes/v1/index.js"
    click BookingRoutes "https://github.com/gm-gautam12/airline_booking_service/blob/master/src/routes/v1/booking-routes.js"
    click ControllersIndex "https://github.com/gm-gautam12/airline_booking_service/blob/master/src/controllers/index.js"
    click BookingController "https://github.com/gm-gautam12/airline_booking_service/blob/master/src/controllers/booking-controller.js"
    click InfoController "https://github.com/gm-gautam12/airline_booking_service/blob/master/src/controllers/info-controller.js"
    click MiddlewaresIndex "https://github.com/gm-gautam12/airline_booking_service/blob/master/src/middlewares/index.js"
    click BookingMiddleware "https://github.com/gm-gautam12/airline_booking_service/blob/master/src/middlewares/booking-middleware.js"
    click ServicesIndex "https://github.com/gm-gautam12/airline_booking_service/blob/master/src/services/index.js"
    click BookingService "https://github.com/gm-gautam12/airline_booking_service/blob/master/src/services/booking-service.js"
    click RepositoriesIndex "https://github.com/gm-gautam12/airline_booking_service/blob/master/src/repositories/index.js"
    click CRUDRepository "https://github.com/gm-gautam12/airline_booking_service/blob/master/src/repositories/crud-repository.js"
    click BookingRepository "https://github.com/gm-gautam12/airline_booking_service/blob/master/src/repositories/booking-repository.js"
    click ModelsIndex "https://github.com/gm-gautam12/airline_booking_service/blob/master/src/models/index.js"
    click BookingModel "https://github.com/gm-gautam12/airline_booking_service/blob/master/src/models/booking.js"
    click CreateBookingMigration "https://github.com/gm-gautam12/airline_booking_service/blob/master/src/migrations/20250603102033-create-booking.js"
    click ConfigIndex "https://github.com/gm-gautam12/airline_booking_service/blob/master/src/config/index.js"
    click ServerConfig "https://github.com/gm-gautam12/airline_booking_service/blob/master/src/config/server-config.js"
    click LoggerConfig "https://github.com/gm-gautam12/airline_booking_service/blob/master/src/config/logger-config.js"
    click UtilsIndex "https://github.com/gm-gautam12/airline_booking_service/blob/master/src/utils/index.js"
    click ApiResponse "https://github.com/gm-gautam12/airline_booking_service/blob/master/src/utils/common/ApiResponse.js"
    click ErrorResponse "https://github.com/gm-gautam12/airline_booking_service/blob/master/src/utils/common/Error-response.js"
    click Enums "https://github.com/gm-gautam12/airline_booking_service/blob/master/src/utils/common/enums.js"
    click CronJobs "https://github.com/gm-gautam12/airline_booking_service/blob/master/src/utils/common/cron-jobs.js"
    click AppError "https://github.com/gm-gautam12/airline_booking_service/blob/master/src/utils/errors/app-error.js"
    click DateTimeHelper "https://github.com/gm-gautam12/airline_booking_service/blob/master/src/utils/helpers/dateTime-helper.js"

    classDef api fill:#D0E8FF,stroke:#007BFF,stroke-width:1px
    classDef business fill:#DBF0DB,stroke:#28A745,stroke-width:1px
    classDef data fill:#FFE5CC,stroke:#FD7E14,stroke-width:1px
    classDef cross fill:#F0F0F0,stroke:#6C757D,stroke-width:1px
    classDef external fill:#EDE5F7,stroke:#6F42C1,stroke-width:1px
```
