# it25101585/airline-ticket-reservation-system architecture

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

- Interactive diagram: https://gitdiagram.com/it25101585/airline-ticket-reservation-system
- Repository: https://github.com/it25101585/airline-ticket-reservation-system

## Overview

SkyLanka-Air is a Spring MVC airline reservation and staff-operations application. The customer journey searches flights, holds seats, creates a booking, pays, then receives and manages an e-ticket; check-in, cancellation/refunds, and support extend that journey. Staff portals cover flight/fleet operations, ticket administration, finance, support, marketing, and administration. SQL-backed domain records and shared security, audit, notifications, and PDF services support these workflows. README statements establish product-level links; source-index references and excerpts support selected internal calls. Unsampled subsystem wiring is not inferred.

Main entry points: [`src/main/java/com/skylanka/air/booking/service/BookingService.java`](https://github.com/it25101585/airline-ticket-reservation-system/blob/main/src/main/java/com/skylanka/air/booking/service/BookingService.java) (Booking), [`src/main/java/com/skylanka/air/payment/service/PaymentService.java`](https://github.com/it25101585/airline-ticket-reservation-system/blob/main/src/main/java/com/skylanka/air/payment/service/PaymentService.java) (Payment), [`src/main/java/com/skylanka/air/ticket/service/TicketService.java`](https://github.com/it25101585/airline-ticket-reservation-system/blob/main/src/main/java/com/skylanka/air/ticket/service/TicketService.java) (Ticket Management), [`src/main/java/com/skylanka/air/shared/controller/OperationsController.java`](https://github.com/it25101585/airline-ticket-reservation-system/blob/main/src/main/java/com/skylanka/air/shared/controller/OperationsController.java) (Flight Operations)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_travel["Customer Travel"]
  node_flightsearch["Flight Search<br/>[FlightService.java]"]
  node_seatmap["Seat Map &amp; Holds<br/>[SeatService.java]"]
  node_booking["Booking"]
  node_payment["Payment"]
  node_checkin["Online Check-in<br/>[CheckIn.java]"]
  node_refund["Cancellation &amp; Refunds"]
end

subgraph group_records["Reservation Records"]
  node_tickets["Ticket Management<br/>[TicketService.java]"]
  node_pdf["Ticket &amp; Receipt PDFs<br/>[TicketPdf.java]"]
  node_sql[("SQL Server")]
end

subgraph group_staff["Staff Portals"]
  node_operations["Flight Operations"]
  node_fleet["Fleet &amp; Routes"]
  node_finance["Finance Portal"]
  node_support["Support Portal"]
  node_marketing["Marketing Portal"]
  node_admin["Admin Portal"]
  node_complaints["Complaints<br/>[Complaint.java]"]
end

subgraph group_platform["Shared Platform"]
  node_security["Access &amp; Authentication"]
  node_audit["Audit Logging<br/>[AuditService.java]"]
  node_notifications["Notifications"]
  node_loyalty["Loyalty Points"]
end

node_customer(("Customer"))

node_customer -->|"searches"| node_flightsearch
node_flightsearch -->|"selects seats"| node_seatmap
node_seatmap -->|"holds for"| node_booking
node_booking -->|"proceeds to"| node_payment
node_payment -->|"issues tickets"| node_tickets
node_tickets -->|"renders PDF"| node_pdf
node_customer -->|"checks in"| node_checkin
node_customer -->|"requests cancellation"| node_refund
node_customer -->|"requests support"| node_complaints
node_booking -->|"reissues on change"| node_tickets
node_flightsearch -.->|"queries flights"| node_sql
node_seatmap -.->|"reads and updates seats"| node_sql
node_booking -->|"stores bookings"| node_sql
node_payment -.->|"stores attempts"| node_sql
node_tickets -->|"stores tickets"| node_sql
node_payment -->|"awards points"| node_loyalty
node_operations -->|"manages fleet"| node_fleet
node_operations -->|"manages check-in"| node_checkin
node_operations -->|"manages tickets"| node_tickets
node_finance -->|"approves refunds"| node_refund
node_support -->|"tracks complaints"| node_complaints
node_marketing -.->|"uses campaign records"| node_sql
node_admin -->|"manages roles"| node_security
node_admin -->|"reviews audit log"| node_audit
node_operations -->|"audited actions"| node_audit
node_booking -.->|"announces events"| node_notifications
node_security -->|"authenticates browser/API"| node_customer
node_payment -->|"reports transactions"| node_finance

click node_flightsearch "https://github.com/it25101585/airline-ticket-reservation-system/blob/main/src/main/java/com/skylanka/air/flight/service/FlightService.java"
click node_seatmap "https://github.com/it25101585/airline-ticket-reservation-system/blob/main/src/main/java/com/skylanka/air/seat/service/SeatService.java"
click node_booking "https://github.com/it25101585/airline-ticket-reservation-system/blob/main/src/main/java/com/skylanka/air/booking/service/BookingService.java"
click node_payment "https://github.com/it25101585/airline-ticket-reservation-system/blob/main/src/main/java/com/skylanka/air/payment/service/PaymentService.java"
click node_checkin "https://github.com/it25101585/airline-ticket-reservation-system/blob/main/src/main/java/com/skylanka/air/shared/entity/CheckIn.java"
click node_refund "https://github.com/it25101585/airline-ticket-reservation-system/blob/main/src/main/java/com/skylanka/air/payment/service/RefundPolicyService.java"
click node_tickets "https://github.com/it25101585/airline-ticket-reservation-system/blob/main/src/main/java/com/skylanka/air/ticket/service/TicketService.java"
click node_pdf "https://github.com/it25101585/airline-ticket-reservation-system/blob/main/src/main/java/com/skylanka/air/shared/pdf/TicketPdf.java"
click node_operations "https://github.com/it25101585/airline-ticket-reservation-system/blob/main/src/main/java/com/skylanka/air/shared/controller/OperationsController.java"
click node_fleet "https://github.com/it25101585/airline-ticket-reservation-system/blob/main/src/main/java/com/skylanka/air/shared/controller/FleetController.java"
click node_finance "https://github.com/it25101585/airline-ticket-reservation-system/blob/main/src/main/java/com/skylanka/air/payment/controller/PaymentController.java"
click node_support "https://github.com/it25101585/airline-ticket-reservation-system/blob/main/src/main/java/com/skylanka/air/shared/controller/OperationsController.java"
click node_marketing "https://github.com/it25101585/airline-ticket-reservation-system/blob/main/src/main/java/com/skylanka/air/shared/controller/OperationsController.java"
click node_admin "https://github.com/it25101585/airline-ticket-reservation-system/blob/main/src/main/java/com/skylanka/air/shared/controller/OperationsController.java"
click node_security "https://github.com/it25101585/airline-ticket-reservation-system/blob/main/src/main/java/com/skylanka/air/shared/security/AuthorizationSupport.java"
click node_audit "https://github.com/it25101585/airline-ticket-reservation-system/blob/main/src/main/java/com/skylanka/air/shared/service/AuditService.java"
click node_notifications "https://github.com/it25101585/airline-ticket-reservation-system/blob/main/src/main/java/com/skylanka/air/shared/service/EmailNotificationService.java"
click node_loyalty "https://github.com/it25101585/airline-ticket-reservation-system/blob/main/src/main/java/com/skylanka/air/user/service/LoyaltyService.java"
click node_complaints "https://github.com/it25101585/airline-ticket-reservation-system/blob/main/src/main/java/com/skylanka/air/shared/entity/Complaint.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_flightsearch,node_seatmap,node_booking,node_payment,node_checkin,node_refund toneBlue
class node_tickets,node_pdf,node_sql toneAmber
class node_operations,node_fleet,node_finance,node_support,node_marketing,node_admin,node_complaints toneMint
class node_security,node_audit,node_notifications,node_loyalty toneRose
class node_customer toneIndigo
```

## Components

### Customer Travel

- [Flight Search](https://github.com/it25101585/airline-ticket-reservation-system/blob/main/src/main/java/com/skylanka/air/flight/service/FlightService.java): `src/main/java/com/skylanka/air/flight/service/FlightService.java`
- [Seat Map & Holds](https://github.com/it25101585/airline-ticket-reservation-system/blob/main/src/main/java/com/skylanka/air/seat/service/SeatService.java): `src/main/java/com/skylanka/air/seat/service/SeatService.java`
- [Booking](https://github.com/it25101585/airline-ticket-reservation-system/blob/main/src/main/java/com/skylanka/air/booking/service/BookingService.java): `src/main/java/com/skylanka/air/booking/service/BookingService.java`
- [Payment](https://github.com/it25101585/airline-ticket-reservation-system/blob/main/src/main/java/com/skylanka/air/payment/service/PaymentService.java): `src/main/java/com/skylanka/air/payment/service/PaymentService.java`
- [Online Check-in](https://github.com/it25101585/airline-ticket-reservation-system/blob/main/src/main/java/com/skylanka/air/shared/entity/CheckIn.java): `src/main/java/com/skylanka/air/shared/entity/CheckIn.java`
- [Cancellation & Refunds](https://github.com/it25101585/airline-ticket-reservation-system/blob/main/src/main/java/com/skylanka/air/payment/service/RefundPolicyService.java): `src/main/java/com/skylanka/air/payment/service/RefundPolicyService.java`

### Reservation Records

- [Ticket Management](https://github.com/it25101585/airline-ticket-reservation-system/blob/main/src/main/java/com/skylanka/air/ticket/service/TicketService.java): `src/main/java/com/skylanka/air/ticket/service/TicketService.java`
- [Ticket & Receipt PDFs](https://github.com/it25101585/airline-ticket-reservation-system/blob/main/src/main/java/com/skylanka/air/shared/pdf/TicketPdf.java): `src/main/java/com/skylanka/air/shared/pdf/TicketPdf.java`
- **SQL Server**

### Staff Portals

- [Flight Operations](https://github.com/it25101585/airline-ticket-reservation-system/blob/main/src/main/java/com/skylanka/air/shared/controller/OperationsController.java): `src/main/java/com/skylanka/air/shared/controller/OperationsController.java`
- [Fleet & Routes](https://github.com/it25101585/airline-ticket-reservation-system/blob/main/src/main/java/com/skylanka/air/shared/controller/FleetController.java): `src/main/java/com/skylanka/air/shared/controller/FleetController.java`
- [Finance Portal](https://github.com/it25101585/airline-ticket-reservation-system/blob/main/src/main/java/com/skylanka/air/payment/controller/PaymentController.java): `src/main/java/com/skylanka/air/payment/controller/PaymentController.java`
- [Support Portal](https://github.com/it25101585/airline-ticket-reservation-system/blob/main/src/main/java/com/skylanka/air/shared/controller/OperationsController.java): `src/main/java/com/skylanka/air/shared/controller/OperationsController.java`
- [Marketing Portal](https://github.com/it25101585/airline-ticket-reservation-system/blob/main/src/main/java/com/skylanka/air/shared/controller/OperationsController.java): `src/main/java/com/skylanka/air/shared/controller/OperationsController.java`
- [Admin Portal](https://github.com/it25101585/airline-ticket-reservation-system/blob/main/src/main/java/com/skylanka/air/shared/controller/OperationsController.java): `src/main/java/com/skylanka/air/shared/controller/OperationsController.java`
- [Complaints](https://github.com/it25101585/airline-ticket-reservation-system/blob/main/src/main/java/com/skylanka/air/shared/entity/Complaint.java): `src/main/java/com/skylanka/air/shared/entity/Complaint.java`

### Shared Platform

- [Access & Authentication](https://github.com/it25101585/airline-ticket-reservation-system/blob/main/src/main/java/com/skylanka/air/shared/security/AuthorizationSupport.java): `src/main/java/com/skylanka/air/shared/security/AuthorizationSupport.java`
- [Audit Logging](https://github.com/it25101585/airline-ticket-reservation-system/blob/main/src/main/java/com/skylanka/air/shared/service/AuditService.java): `src/main/java/com/skylanka/air/shared/service/AuditService.java`
- [Notifications](https://github.com/it25101585/airline-ticket-reservation-system/blob/main/src/main/java/com/skylanka/air/shared/service/EmailNotificationService.java): `src/main/java/com/skylanka/air/shared/service/EmailNotificationService.java`
- [Loyalty Points](https://github.com/it25101585/airline-ticket-reservation-system/blob/main/src/main/java/com/skylanka/air/user/service/LoyaltyService.java): `src/main/java/com/skylanka/air/user/service/LoyaltyService.java`

### Other components

- **Customer**

## Connections

- Customer → Flight Search: searches
- Flight Search → Seat Map & Holds: selects seats
- Seat Map & Holds → Booking: holds for (evidence: `src/main/java/com/skylanka/air/booking/service/BookingService.java`)
- Booking → Payment: proceeds to
- Payment → Ticket Management: issues tickets (evidence: `src/main/java/com/skylanka/air/payment/service/PaymentService.java`)
- Ticket Management → Ticket & Receipt PDFs: renders PDF (evidence: `src/main/java/com/skylanka/air/ticket/service/TicketService.java`)
- Customer → Online Check-in: checks in
- Customer → Cancellation & Refunds: requests cancellation
- Customer → Complaints: requests support
- Booking → Ticket Management: reissues on change (evidence: `src/main/java/com/skylanka/air/booking/service/BookingService.java`)
- Flight Search → SQL Server: queries flights
- Seat Map & Holds → SQL Server: reads and updates seats
- Booking → SQL Server: stores bookings (evidence: `src/main/java/com/skylanka/air/booking/service/BookingService.java`)
- Payment → SQL Server: stores attempts
- Ticket Management → SQL Server: stores tickets (evidence: `src/main/java/com/skylanka/air/ticket/service/TicketService.java`)
- Payment → Loyalty Points: awards points (evidence: `src/main/java/com/skylanka/air/payment/service/PaymentService.java`)
- Flight Operations → Fleet & Routes: manages fleet
- Flight Operations → Online Check-in: manages check-in (evidence: `src/main/java/com/skylanka/air/shared/controller/OperationsController.java`)
- Flight Operations → Ticket Management: manages tickets (evidence: `src/main/java/com/skylanka/air/shared/controller/OperationsController.java`)
- Finance Portal → Cancellation & Refunds: approves refunds
- Support Portal → Complaints: tracks complaints (evidence: `src/main/java/com/skylanka/air/shared/controller/OperationsController.java`)
- Marketing Portal → SQL Server: uses campaign records
- Admin Portal → Access & Authentication: manages roles
- Admin Portal → Audit Logging: reviews audit log (evidence: `src/main/java/com/skylanka/air/shared/controller/OperationsController.java`)
- Flight Operations → Audit Logging: audited actions (evidence: `src/main/java/com/skylanka/air/shared/controller/OperationsController.java`)
- Booking → Notifications: announces events
- Access & Authentication → Customer: authenticates browser/API
- Payment → Finance Portal: reports transactions (evidence: `src/main/java/com/skylanka/air/payment/controller/PaymentController.java`)
