# glendaleeismaquilan/cebuairlines architecture

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

- Interactive diagram: https://gitdiagram.com/glendaleeismaquilan/cebuairlines
- Repository: https://github.com/glendaleeismaquilan/cebuairlines

## Overview

CebuAirlines is a coursework flight-booking product with web and mobile clients and an Express/Firebase backend. The customer journey runs from flight search through booking details, payment, and ticket/boarding pass; the backend also serves admin and gate-agent workflows. The README confirms search, seat selection, booking, and flight/booking administration. Arrows use explicit route registration, imports, or excerpted calls; screens and several subsystems are grouped where their internal links were not shown, so those uncertain interactions are omitted.

Main entry points: [`CebuAirlinesMobileApp/CebuMobileApp/App.js`](https://github.com/glendaleeismaquilan/cebuairlines/blob/main/CebuAirlinesMobileApp/CebuMobileApp/App.js) (Mobile app), [`CebuAirlinesWebApp/backend/routes/bookings.js`](https://github.com/glendaleeismaquilan/cebuairlines/blob/main/CebuAirlinesWebApp/backend/routes/bookings.js) (Bookings API), [`CebuAirlinesWebApp/frontend/src/App.js`](https://github.com/glendaleeismaquilan/cebuairlines/blob/main/CebuAirlinesWebApp/frontend/src/App.js) (Web app), [`CebuAirlinesWebApp/backend/server.js`](https://github.com/glendaleeismaquilan/cebuairlines/blob/main/CebuAirlinesWebApp/backend/server.js) (API server)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_clients["Customer clients"]
  node_mobile_app["Mobile app<br/>[App.js]"]
  node_mobile_search["Mobile search<br/>[SearchScreen.js]"]
  node_mobile_booking["Mobile booking flow"]
  node_web_app["Web app<br/>[App.js]"]
  node_web_search["Web flight search<br/>[FlightSearch.js]"]
  node_web_booking["Web booking review"]
  node_web_seats["Seat selection<br/>[SeatSelector.js]"]
  node_api_client["Web API client<br/>[api.js]"]
end

subgraph group_server["API and operations"]
  node_api_server["API server<br/>[server.js]"]
  node_booking_routes["Bookings API<br/>[bookings.js]"]
  node_other_routes["Flight, payment, admin APIs"]
  node_ops_routes["Tickets and operations APIs"]
end

subgraph group_identity["Identity and alerts"]
  node_mobile_auth["Mobile identity<br/>[AuthContext.js]"]
  node_mobile_notifications["Mobile notifications"]
  node_web_auth["Web identity<br/>[AuthContext.js]"]
  node_backend_auth["API authorization<br/>[auth.js]"]
  node_email["Email delivery<br/>[emailService.js]"]
  node_notifications["Notification service"]
end

subgraph group_persistence["Firebase data"]
  node_mobile_data["Mobile Firestore access"]
  node_mobile_firebase["Mobile Firebase config<br/>[firebase.js]"]
  node_backend_firebase["Backend Firebase config<br/>[firebase.js]"]
  node_firestore[("Firebase Firestore")]
end

node_passenger(("Passenger"))
node_admin_user(("Admin or gate agent"))
node_mail_service["SMTP mail service"]

node_passenger -->|"uses"| node_mobile_app
node_mobile_app -->|"provides context"| node_mobile_auth
node_mobile_app -->|"provides context"| node_mobile_notifications
node_mobile_app -->|"routes to"| node_mobile_search
node_mobile_app -->|"routes to"| node_mobile_booking
node_mobile_search -.->|"accesses flights"| node_mobile_data
node_mobile_booking -.->|"creates booking"| node_mobile_data
node_mobile_data -->|"uses config"| node_mobile_firebase
node_mobile_data -->|"reads and writes"| node_firestore
node_mobile_notifications -->|"uses config"| node_mobile_firebase
node_mobile_firebase -.->|"connects"| node_firestore
node_passenger -->|"uses"| node_web_app
node_web_app -->|"provides context"| node_web_auth
node_web_app -->|"routes to"| node_web_search
node_web_app -->|"routes to"| node_web_booking
node_web_booking -->|"submits booking"| node_api_client
node_web_search -->|"requests flights"| node_api_client
node_web_booking -.->|"selects seats"| node_web_seats
node_api_client -.->|"calls API"| node_api_server
node_api_server -->|"mounts bookings"| node_booking_routes
node_api_server -->|"mounts API routes"| node_other_routes
node_api_server -->|"mounts operations"| node_ops_routes
node_admin_user -->|"uses"| node_web_app
node_booking_routes -->|"checks identity"| node_backend_auth
node_backend_auth -->|"uses credentials"| node_backend_firebase
node_booking_routes -->|"uses database"| node_backend_firebase
node_backend_firebase -->|"connects"| node_firestore
node_booking_routes -->|"sends booking mail"| node_email
node_booking_routes -->|"creates alerts"| node_notifications
node_notifications -->|"uses database"| node_backend_firebase
node_email -->|"sends mail"| node_mail_service

click node_mobile_app "https://github.com/glendaleeismaquilan/cebuairlines/blob/main/CebuAirlinesMobileApp/CebuMobileApp/App.js"
click node_mobile_auth "https://github.com/glendaleeismaquilan/cebuairlines/blob/main/CebuAirlinesMobileApp/CebuMobileApp/src/context/AuthContext.js"
click node_mobile_search "https://github.com/glendaleeismaquilan/cebuairlines/blob/main/CebuAirlinesMobileApp/CebuMobileApp/src/screens/SearchScreen.js"
click node_mobile_booking "https://github.com/glendaleeismaquilan/cebuairlines/blob/main/CebuAirlinesMobileApp/CebuMobileApp/src/screens/ReviewBookingScreen.js"
click node_mobile_data "https://github.com/glendaleeismaquilan/cebuairlines/blob/main/CebuAirlinesMobileApp/CebuMobileApp/src/utils/firestoreService.js"
click node_mobile_firebase "https://github.com/glendaleeismaquilan/cebuairlines/blob/main/CebuAirlinesMobileApp/CebuMobileApp/src/config/firebase.js"
click node_mobile_notifications "https://github.com/glendaleeismaquilan/cebuairlines/blob/main/CebuAirlinesMobileApp/CebuMobileApp/src/context/NotificationContext.js"
click node_web_app "https://github.com/glendaleeismaquilan/cebuairlines/blob/main/CebuAirlinesWebApp/frontend/src/App.js"
click node_web_auth "https://github.com/glendaleeismaquilan/cebuairlines/blob/main/CebuAirlinesWebApp/frontend/src/context/AuthContext.js"
click node_web_search "https://github.com/glendaleeismaquilan/cebuairlines/blob/main/CebuAirlinesWebApp/frontend/src/pages/FlightSearch.js"
click node_web_booking "https://github.com/glendaleeismaquilan/cebuairlines/blob/main/CebuAirlinesWebApp/frontend/src/pages/ReviewBookingPage.js"
click node_web_seats "https://github.com/glendaleeismaquilan/cebuairlines/blob/main/CebuAirlinesWebApp/frontend/src/components/SeatSelector.js"
click node_api_client "https://github.com/glendaleeismaquilan/cebuairlines/blob/main/CebuAirlinesWebApp/frontend/src/utils/api.js"
click node_api_server "https://github.com/glendaleeismaquilan/cebuairlines/blob/main/CebuAirlinesWebApp/backend/server.js"
click node_booking_routes "https://github.com/glendaleeismaquilan/cebuairlines/blob/main/CebuAirlinesWebApp/backend/routes/bookings.js"
click node_other_routes "https://github.com/glendaleeismaquilan/cebuairlines/tree/main/CebuAirlinesWebApp/backend/routes"
click node_ops_routes "https://github.com/glendaleeismaquilan/cebuairlines/tree/main/CebuAirlinesWebApp/backend/routes"
click node_backend_firebase "https://github.com/glendaleeismaquilan/cebuairlines/blob/main/CebuAirlinesWebApp/backend/config/firebase.js"
click node_backend_auth "https://github.com/glendaleeismaquilan/cebuairlines/blob/main/CebuAirlinesWebApp/backend/middleware/auth.js"
click node_email "https://github.com/glendaleeismaquilan/cebuairlines/blob/main/CebuAirlinesWebApp/backend/services/emailService.js"
click node_notifications "https://github.com/glendaleeismaquilan/cebuairlines/blob/main/CebuAirlinesWebApp/backend/services/notificationService.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_mobile_app,node_mobile_search,node_mobile_booking,node_web_app,node_web_search,node_web_booking,node_web_seats,node_api_client toneBlue
class node_api_server,node_booking_routes,node_other_routes,node_ops_routes toneAmber
class node_mobile_auth,node_mobile_notifications,node_web_auth,node_backend_auth,node_email,node_notifications toneMint
class node_mobile_data,node_mobile_firebase,node_backend_firebase,node_firestore toneRose
class node_passenger,node_admin_user,node_mail_service toneIndigo
```

## Components

### Customer clients

- [Mobile app](https://github.com/glendaleeismaquilan/cebuairlines/blob/main/CebuAirlinesMobileApp/CebuMobileApp/App.js): `CebuAirlinesMobileApp/CebuMobileApp/App.js`
- [Mobile search](https://github.com/glendaleeismaquilan/cebuairlines/blob/main/CebuAirlinesMobileApp/CebuMobileApp/src/screens/SearchScreen.js): `CebuAirlinesMobileApp/CebuMobileApp/src/screens/SearchScreen.js`
- [Mobile booking flow](https://github.com/glendaleeismaquilan/cebuairlines/blob/main/CebuAirlinesMobileApp/CebuMobileApp/src/screens/ReviewBookingScreen.js): `CebuAirlinesMobileApp/CebuMobileApp/src/screens/ReviewBookingScreen.js`
- [Web app](https://github.com/glendaleeismaquilan/cebuairlines/blob/main/CebuAirlinesWebApp/frontend/src/App.js): `CebuAirlinesWebApp/frontend/src/App.js`
- [Web flight search](https://github.com/glendaleeismaquilan/cebuairlines/blob/main/CebuAirlinesWebApp/frontend/src/pages/FlightSearch.js): `CebuAirlinesWebApp/frontend/src/pages/FlightSearch.js`
- [Web booking review](https://github.com/glendaleeismaquilan/cebuairlines/blob/main/CebuAirlinesWebApp/frontend/src/pages/ReviewBookingPage.js): `CebuAirlinesWebApp/frontend/src/pages/ReviewBookingPage.js`
- [Seat selection](https://github.com/glendaleeismaquilan/cebuairlines/blob/main/CebuAirlinesWebApp/frontend/src/components/SeatSelector.js): `CebuAirlinesWebApp/frontend/src/components/SeatSelector.js`
- [Web API client](https://github.com/glendaleeismaquilan/cebuairlines/blob/main/CebuAirlinesWebApp/frontend/src/utils/api.js): `CebuAirlinesWebApp/frontend/src/utils/api.js`

### API and operations

- [API server](https://github.com/glendaleeismaquilan/cebuairlines/blob/main/CebuAirlinesWebApp/backend/server.js): `CebuAirlinesWebApp/backend/server.js`
- [Bookings API](https://github.com/glendaleeismaquilan/cebuairlines/blob/main/CebuAirlinesWebApp/backend/routes/bookings.js): `CebuAirlinesWebApp/backend/routes/bookings.js`
- [Flight, payment, admin APIs](https://github.com/glendaleeismaquilan/cebuairlines/tree/main/CebuAirlinesWebApp/backend/routes): `CebuAirlinesWebApp/backend/routes`
- [Tickets and operations APIs](https://github.com/glendaleeismaquilan/cebuairlines/tree/main/CebuAirlinesWebApp/backend/routes): `CebuAirlinesWebApp/backend/routes`

### Identity and alerts

- [Mobile identity](https://github.com/glendaleeismaquilan/cebuairlines/blob/main/CebuAirlinesMobileApp/CebuMobileApp/src/context/AuthContext.js): `CebuAirlinesMobileApp/CebuMobileApp/src/context/AuthContext.js`
- [Mobile notifications](https://github.com/glendaleeismaquilan/cebuairlines/blob/main/CebuAirlinesMobileApp/CebuMobileApp/src/context/NotificationContext.js): `CebuAirlinesMobileApp/CebuMobileApp/src/context/NotificationContext.js`
- [Web identity](https://github.com/glendaleeismaquilan/cebuairlines/blob/main/CebuAirlinesWebApp/frontend/src/context/AuthContext.js): `CebuAirlinesWebApp/frontend/src/context/AuthContext.js`
- [API authorization](https://github.com/glendaleeismaquilan/cebuairlines/blob/main/CebuAirlinesWebApp/backend/middleware/auth.js): `CebuAirlinesWebApp/backend/middleware/auth.js`
- [Email delivery](https://github.com/glendaleeismaquilan/cebuairlines/blob/main/CebuAirlinesWebApp/backend/services/emailService.js): `CebuAirlinesWebApp/backend/services/emailService.js`
- [Notification service](https://github.com/glendaleeismaquilan/cebuairlines/blob/main/CebuAirlinesWebApp/backend/services/notificationService.js): `CebuAirlinesWebApp/backend/services/notificationService.js`

### Firebase data

- [Mobile Firestore access](https://github.com/glendaleeismaquilan/cebuairlines/blob/main/CebuAirlinesMobileApp/CebuMobileApp/src/utils/firestoreService.js): `CebuAirlinesMobileApp/CebuMobileApp/src/utils/firestoreService.js`
- [Mobile Firebase config](https://github.com/glendaleeismaquilan/cebuairlines/blob/main/CebuAirlinesMobileApp/CebuMobileApp/src/config/firebase.js): `CebuAirlinesMobileApp/CebuMobileApp/src/config/firebase.js`
- [Backend Firebase config](https://github.com/glendaleeismaquilan/cebuairlines/blob/main/CebuAirlinesWebApp/backend/config/firebase.js): `CebuAirlinesWebApp/backend/config/firebase.js`
- **Firebase Firestore**

### Other components

- **Passenger**
- **Admin or gate agent**
- **SMTP mail service**

## Connections

- Passenger → Mobile app: uses
- Mobile app → Mobile identity: provides context (evidence: `CebuAirlinesMobileApp/CebuMobileApp/App.js`)
- Mobile app → Mobile notifications: provides context (evidence: `CebuAirlinesMobileApp/CebuMobileApp/App.js`)
- Mobile app → Mobile search: routes to
- Mobile app → Mobile booking flow: routes to
- Mobile search → Mobile Firestore access: accesses flights
- Mobile booking flow → Mobile Firestore access: creates booking
- Mobile Firestore access → Mobile Firebase config: uses config (evidence: `CebuAirlinesMobileApp/CebuMobileApp/src/utils/firestoreService.js`)
- Mobile Firestore access → Firebase Firestore: reads and writes (evidence: `CebuAirlinesMobileApp/CebuMobileApp/src/utils/firestoreService.js`)
- Mobile notifications → Mobile Firebase config: uses config (evidence: `CebuAirlinesMobileApp/CebuMobileApp/src/context/NotificationContext.js`)
- Mobile Firebase config → Firebase Firestore: connects
- Passenger → Web app: uses (evidence: `CebuAirlinesWebApp/frontend/src/App.js`)
- Web app → Web identity: provides context (evidence: `CebuAirlinesWebApp/frontend/src/App.js`)
- Web app → Web flight search: routes to (evidence: `CebuAirlinesWebApp/frontend/src/App.js`)
- Web app → Web booking review: routes to (evidence: `CebuAirlinesWebApp/frontend/src/App.js`)
- Web booking review → Web API client: submits booking (evidence: `CebuAirlinesWebApp/frontend/src/pages/ReviewBookingPage.js`)
- Web flight search → Web API client: requests flights (evidence: `CebuAirlinesWebApp/frontend/src/pages/FlightSearch.js`)
- Web booking review → Seat selection: selects seats
- Web API client → API server: calls API
- API server → Bookings API: mounts bookings (evidence: `CebuAirlinesWebApp/backend/server.js`)
- API server → Flight, payment, admin APIs: mounts API routes (evidence: `CebuAirlinesWebApp/backend/server.js`)
- API server → Tickets and operations APIs: mounts operations (evidence: `CebuAirlinesWebApp/backend/server.js`)
- Admin or gate agent → Web app: uses (evidence: `CebuAirlinesWebApp/frontend/src/App.js`)
- Bookings API → API authorization: checks identity (evidence: `CebuAirlinesWebApp/backend/routes/bookings.js`)
- API authorization → Backend Firebase config: uses credentials (evidence: `CebuAirlinesWebApp/backend/middleware/auth.js`)
- Bookings API → Backend Firebase config: uses database (evidence: `CebuAirlinesWebApp/backend/routes/bookings.js`)
- Backend Firebase config → Firebase Firestore: connects (evidence: `CebuAirlinesWebApp/backend/config/firebase.js`)
- Bookings API → Email delivery: sends booking mail (evidence: `CebuAirlinesWebApp/backend/routes/bookings.js`)
- Bookings API → Notification service: creates alerts (evidence: `CebuAirlinesWebApp/backend/routes/bookings.js`)
- Notification service → Backend Firebase config: uses database (evidence: `CebuAirlinesWebApp/backend/services/notificationService.js`)
- Email delivery → SMTP mail service: sends mail (evidence: `CebuAirlinesWebApp/backend/services/emailService.js`)
