# hodnduy/se104 architecture

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

- Interactive diagram: https://gitdiagram.com/hodnduy/se104
- Repository: https://github.com/hodnduy/se104

## Overview

This repository contains a two-part flight ticket booking system:

1. An Android client application written in Java.
2. A PHP + MySQL backend API that serves the app’s data.

The architecture is a classic mobile client/server setup where the Android app handles UI, session state, and user interaction, while the PHP scripts expose HTTP endpoints backed by a database.

Main system boundaries

- Android app boundary
  - Located under `app/`
  - Responsible for screens, navigation, input validation, list rendering, local session/storage, and calling the backend API
- Backend API boundary
  - Located under `flight_ticket_boooking_api/`
  - PHP endpoints handle login, signup, search, booking, passenger management, and content retrieval
- Database boundary
  - Backed by the SQL schema in `flight_ticket_boooking_api.sql`
  - The API reads/writes booking, user, passenger, city, banner, and related records
- Static media boundary on backend
  - `flight_ticket_boooking_api/images/user` and `images/banners` suggest uploaded or hosted image assets used by the app

Android app structure

The Android app is organized by responsibility rather than by feature module:

- Entry/navigation screens
  - `Splash` likely shows startup animation/loading and decides where to route next
  - `Welcome` is an onboarding/landing screen
  - `MainActivity` is the main container after login or app launch, likely hosting the home screen and navigation drawer
- Authentication and account management
  - `Login`
  - `Register`
  - `Profile`
  - `MyBookingDetail`
- Booking workflow
  - `SearchVehical` is the search/results entry point for available travel options
  - `VehicleDetail` shows details for a selected vehicle/flight option
  - `BookTicket` completes booking and passenger entry
  - `BookingHistory` displays prior bookings
- Informational/support screens
  - `AboutUs`
  - `ContactUs`

The UI is built from XML layouts in `res/layout`, with a separate screen layout for each major activity. The presence of `activity_main.xml`, `app_bar_home.xml`, `content_home.xml`, and `nav_header_home.xml` suggests the main screen uses a navigation drawer or drawer-style home shell.

Presentation and list rendering layer

The `adapters/` package contains the UI binding layer between model objects and list-based views:

- `CityAdapter` renders city choices
- `VehicleAdapter` renders available vehicles/flights
- `PassengerAdapter` renders passenger rows
- `BookingAdapter` renders booking history entries

These adapters imply the app uses RecyclerView/ListView-style list screens for search results, booking history, and passenger lists.

Data model layer

The `models/` package defines the app’s domain objects:

- `User` for account/session profile data
- `Vehical` for travel inventory items
- `City` for origin/destination data
- `Banner` for promotional/homepage content
- `MyBooking` for booking records
- `PassengerModel` for traveler/passenger entries
- `Developer` for app/about metadata

These models are the main data contract between the API responses and the UI adapters.

Utility and infrastructure layer

The `utilities/` package provides cross-cutting support:

- `MyNetwork` is the likely HTTP/network helper used to call PHP endpoints
- `ECONSTANT` centralizes API URLs, keys, request codes, or other constants
- `EFastSaveInit` indicates local key-value persistence setup, probably for login/session state
- `EHelpingFunctions` likely contains shared helpers such as formatting, validation, or UI utilities

This suggests the app uses a lightweight client-side infrastructure rather than a heavy service/repository architecture. Activities likely coordinate most of the logic directly, using utilities for network and persistence.

Resource-driven UI and feedback

The `res/` tree shows the app depends heavily on Android resources:

- Layouts define every screen and row item
- Drawables define custom shapes, icons, backgrounds, and UI decorations
- Animations such as `bounce.xml`, `go_up.xml`, `go_down.xml`
- Raw JSON files such as `loading.json`, `welcome.json`, `empty.json`, `order_empty.json`
  - These strongly suggest Lottie-style animated empty/loading states or onboarding visuals
- Menus and themed values support a branded, custom-styled application

Backend API structure

The PHP backend is a set of endpoint scripts rather than a framework-based application:

- Authentication/account endpoints
  - `login.php`
  - `signup.php`
  - `changepass.php`
- Booking/search endpoints
  - `searchvehicle.php`
  - `bookticket.php`
  - `getbookingid.php`
  - `getmybooking.php`
- Content/data endpoints
  - `getcity.php`
  - `getbanner.php`
  - `getpassengers.php`
- Submission endpoints
  - `addpas.php`
  - `addcontactus.php`
  - `adddonation.php`

`db.php` and `db1.php` are the database connection/configuration files. The presence of separate scripts for each operation suggests the backend is a simple request/response API, likely returning JSON to the Android client.

Data flow through the system

A typical user flow is:

1. App launch
   - `Splash`/`Welcome` screens display branding and loading assets
2. Authentication
   - `Login` or `Register` sends credentials to `login.php` or `signup.php`
   - Session state is probably stored locally using the FastSave-based utility layer
3. Home screen
   - `MainActivity` loads the main UI and possibly banners/city data from `getbanner.php` and `getcity.php`
4. Search and selection
   - `SearchVehical` calls `searchvehicle.php` with route/date criteria
   - Results are parsed into `Vehical` models and rendered through `VehicleAdapter`
5. Detail and booking
   - `VehicleDetail` presents a selected option
   - `BookTicket` collects passenger/booking details and posts them to `bookticket.php` and/or `addpas.php`
6. Booking tracking
   - `BookingHistory` calls `getmybooking.php`
   - `MyBookingDetail` shows the selected booking record
7. Support/profile
   - `Profile`, `AboutUs`, and `ContactUs` expose user/account and informational flows
   - `addcontactus.php` stores user inquiries

Important architectural characteristics

- Client-server separation is explicit
  - Android does UI and orchestration
  - PHP scripts handle all persistent operations
- Data exchange is likely JSON over HTTP
  - The model classes and endpoint naming strongly indicate this pattern
- The app is screen-centric
  - Each major function is a separate `Activity`
- Presentation and data are loosely separated
  - Adapters bind model objects to views
- State is partly local
  - `FastSave` initialization indicates local persistence for login/session/preferences
- Backend is script-based, not layered
  - The server side appears to be a collection of endpoint files with shared DB configuration rather than a multi-tier framework

Relevant technologies

- Android Studio / Android SDK
- Java for the mobile client
- XML for layouts, drawables, animations, and themes
- PHP for the backend API
- MySQL for persistent data storage
- Gradle for Android build configuration
- Likely JSON responses between API and client

For an architecture diagram, the clearest grouping is:

- Android Presentation Layer
  - Activities, adapters, layouts, resources
- Android Support Layer
  - utilities, local persistence, networking
- API Layer
  - PHP endpoint scripts
- Data Layer
  - MySQL database plus hosted images/banners/users media

This repository is therefore best understood as a mobile booking front end integrated with a simple PHP-based data service and relational database backend.

Main entry points: [`app/src/main/java/com/maadi/flightticketbooking/MainActivity.java`](https://github.com/hodnduy/se104/blob/HEAD/app/src/main/java/com/maadi/flightticketbooking/MainActivity.java) (Main Activity), [`app/src/main/java/com/maadi/flightticketbooking/models`](https://github.com/hodnduy/se104/tree/HEAD/app/src/main/java/com/maadi/flightticketbooking/models) (App Models), [`app/src/main/java/com/maadi/flightticketbooking/utilities`](https://github.com/hodnduy/se104/tree/HEAD/app/src/main/java/com/maadi/flightticketbooking/utilities) (App Utilities), [`app/src/main/res/layout`](https://github.com/hodnduy/se104/tree/HEAD/app/src/main/res/layout) (Layouts)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph "Android app"
  splash["Splash<br/>activity<br/>[Splash.java]"]
  welcome["Welcome<br/>activity<br/>[Welcome.java]"]
  main_activity["Main Activity<br/>[MainActivity.java]"]
  login["Login<br/>activity<br/>[Login.java]"]
  register["Register<br/>activity<br/>[Register.java]"]
  search_vehicle["Search Vehicle<br/>activity<br/>[SearchVehical.java]"]
  vehicle_detail["Vehicle Detail<br/>activity<br/>[VehicleDetail.java]"]
  book_ticket["Book Ticket<br/>activity<br/>[BookTicket.java]"]
  booking_history["Booking History<br/>activity"]
  my_booking_detail["Booking Detail<br/>activity"]
  profile["Profile<br/>activity<br/>[Profile.java]"]
  about_us["About Us<br/>activity<br/>[AboutUs.java]"]
  contact_us["Contact Us<br/>activity<br/>[ContactUs.java]"]
  vehicle_adapter["Vehicle Adapter<br/>recycler adapter"]
  booking_adapter["Booking Adapter<br/>recycler adapter"]
  passenger_adapter["Passenger Adapter<br/>recycler adapter"]
  app_models["App Models<br/>domain models"]
  app_utilities["App Utilities<br/>support layer"]
  layout_resources["Layouts<br/>android resources"]
  ui_assets["UI Assets<br/>android resources"]
end

subgraph "Backend API"
  auth_endpoints["Auth APIs<br/>php endpoints"]
  booking_endpoints["Booking APIs<br/>php endpoints"]
  content_endpoints["Content APIs<br/>php endpoints"]
  db_config["DB Config<br/>php config<br/>[db.php]"]
end

subgraph "Data layer"
  mysql_db[("MySQL DB<br/>relational database")]
  media_store["Media Store<br/>hosted images"]
end

splash -->|"routes to"| welcome
welcome -->|"entry to auth"| login
login -->|"opens app"| main_activity
register -->|"returns"| login
main_activity -->|"launches"| search_vehicle
main_activity -->|"shows"| booking_history
main_activity -->|"opens"| profile
main_activity -->|"opens"| about_us
main_activity -->|"opens"| contact_us
search_vehicle -->|"selects"| vehicle_detail
vehicle_detail -->|"continues to"| book_ticket
book_ticket -->|"creates"| my_booking_detail
booking_history -->|"drills into"| my_booking_detail
search_vehicle -->|"renders via"| vehicle_adapter
booking_history -->|"renders via"| booking_adapter
book_ticket -->|"renders via"| passenger_adapter
app_utilities -->|"calls"| auth_endpoints
app_utilities -->|"calls"| booking_endpoints
app_utilities -->|"calls"| content_endpoints
auth_endpoints -->|"uses"| db_config
booking_endpoints -->|"uses"| db_config
content_endpoints -->|"uses"| db_config
db_config -->|"connects to"| mysql_db
content_endpoints -->|"serves"| media_store
app_models -->|"feeds"| vehicle_adapter
app_models -->|"feeds"| booking_adapter
app_models -->|"feeds"| passenger_adapter
app_models -->|"populates"| app_utilities
layout_resources -->|"backs"| main_activity
layout_resources -->|"backs"| search_vehicle
layout_resources -->|"backs"| book_ticket
ui_assets -->|"styles"| layout_resources

click splash "https://github.com/hodnduy/se104/blob/main/app/src/main/java/com/maadi/flightticketbooking/activities/Splash.java"
click welcome "https://github.com/hodnduy/se104/blob/main/app/src/main/java/com/maadi/flightticketbooking/Welcome.java"
click main_activity "https://github.com/hodnduy/se104/blob/main/app/src/main/java/com/maadi/flightticketbooking/MainActivity.java"
click login "https://github.com/hodnduy/se104/blob/main/app/src/main/java/com/maadi/flightticketbooking/activities/Login.java"
click register "https://github.com/hodnduy/se104/blob/main/app/src/main/java/com/maadi/flightticketbooking/activities/Register.java"
click search_vehicle "https://github.com/hodnduy/se104/blob/main/app/src/main/java/com/maadi/flightticketbooking/activities/SearchVehical.java"
click vehicle_detail "https://github.com/hodnduy/se104/blob/main/app/src/main/java/com/maadi/flightticketbooking/activities/VehicleDetail.java"
click book_ticket "https://github.com/hodnduy/se104/blob/main/app/src/main/java/com/maadi/flightticketbooking/activities/BookTicket.java"
click booking_history "https://github.com/hodnduy/se104/blob/main/app/src/main/java/com/maadi/flightticketbooking/activities/BookingHistory.java"
click my_booking_detail "https://github.com/hodnduy/se104/blob/main/app/src/main/java/com/maadi/flightticketbooking/activities/MyBookingDetail.java"
click profile "https://github.com/hodnduy/se104/blob/main/app/src/main/java/com/maadi/flightticketbooking/activities/Profile.java"
click about_us "https://github.com/hodnduy/se104/blob/main/app/src/main/java/com/maadi/flightticketbooking/activities/AboutUs.java"
click contact_us "https://github.com/hodnduy/se104/blob/main/app/src/main/java/com/maadi/flightticketbooking/activities/ContactUs.java"
click vehicle_adapter "https://github.com/hodnduy/se104/blob/main/app/src/main/java/com/maadi/flightticketbooking/adapters/VehicleAdapter.java"
click booking_adapter "https://github.com/hodnduy/se104/blob/main/app/src/main/java/com/maadi/flightticketbooking/adapters/BookingAdapter.java"
click passenger_adapter "https://github.com/hodnduy/se104/blob/main/app/src/main/java/com/maadi/flightticketbooking/adapters/PassengerAdapter.java"
click app_models "https://github.com/hodnduy/se104/tree/main/app/src/main/java/com/maadi/flightticketbooking/models"
click app_utilities "https://github.com/hodnduy/se104/tree/main/app/src/main/java/com/maadi/flightticketbooking/utilities"
click layout_resources "https://github.com/hodnduy/se104/tree/main/app/src/main/res/layout"
click ui_assets "https://github.com/hodnduy/se104/tree/main/app/src/main/res"
click auth_endpoints "https://github.com/hodnduy/se104/tree/main/flight_ticket_boooking_api"
click booking_endpoints "https://github.com/hodnduy/se104/tree/main/flight_ticket_boooking_api"
click content_endpoints "https://github.com/hodnduy/se104/tree/main/flight_ticket_boooking_api"
click db_config "https://github.com/hodnduy/se104/blob/main/flight_ticket_boooking_api/db.php"
click mysql_db "https://github.com/hodnduy/se104/blob/main/flight_ticket_boooking_api.sql"
click media_store "https://github.com/hodnduy/se104/tree/main/flight_ticket_boooking_api/images"

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 splash,welcome,main_activity,login,register,search_vehicle,vehicle_detail,book_ticket,booking_history,my_booking_detail,profile,about_us,contact_us,vehicle_adapter,booking_adapter,passenger_adapter,app_models,app_utilities,layout_resources,ui_assets toneBlue
class auth_endpoints,booking_endpoints,content_endpoints,db_config toneAmber
class mysql_db,media_store toneMint
```

## Components

### Android app

Java mobile client with screens, adapters, models, and support utilities.

- [Splash](https://github.com/hodnduy/se104/blob/HEAD/app/src/main/java/com/maadi/flightticketbooking/activities/Splash.java): activity · Startup loading and routing screen · `app/src/main/java/com/maadi/flightticketbooking/activities/Splash.java`
- [Welcome](https://github.com/hodnduy/se104/blob/HEAD/app/src/main/java/com/maadi/flightticketbooking/Welcome.java): activity · Landing and onboarding screen · `app/src/main/java/com/maadi/flightticketbooking/Welcome.java`
- [Main Activity](https://github.com/hodnduy/se104/blob/HEAD/app/src/main/java/com/maadi/flightticketbooking/MainActivity.java): activity · Home shell and navigation container · `app/src/main/java/com/maadi/flightticketbooking/MainActivity.java`
- [Login](https://github.com/hodnduy/se104/blob/HEAD/app/src/main/java/com/maadi/flightticketbooking/activities/Login.java): activity · User authentication screen · `app/src/main/java/com/maadi/flightticketbooking/activities/Login.java`
- [Register](https://github.com/hodnduy/se104/blob/HEAD/app/src/main/java/com/maadi/flightticketbooking/activities/Register.java): activity · Account creation screen · `app/src/main/java/com/maadi/flightticketbooking/activities/Register.java`
- [Search Vehicle](https://github.com/hodnduy/se104/blob/HEAD/app/src/main/java/com/maadi/flightticketbooking/activities/SearchVehical.java): activity · Search and results entry point · `app/src/main/java/com/maadi/flightticketbooking/activities/SearchVehical.java`
- [Vehicle Detail](https://github.com/hodnduy/se104/blob/HEAD/app/src/main/java/com/maadi/flightticketbooking/activities/VehicleDetail.java): activity · Selected route or flight details · `app/src/main/java/com/maadi/flightticketbooking/activities/VehicleDetail.java`
- [Book Ticket](https://github.com/hodnduy/se104/blob/HEAD/app/src/main/java/com/maadi/flightticketbooking/activities/BookTicket.java): activity · Booking and passenger entry flow · `app/src/main/java/com/maadi/flightticketbooking/activities/BookTicket.java`
- [Booking History](https://github.com/hodnduy/se104/blob/HEAD/app/src/main/java/com/maadi/flightticketbooking/activities/BookingHistory.java): activity · Past bookings list screen · `app/src/main/java/com/maadi/flightticketbooking/activities/BookingHistory.java`
- [Booking Detail](https://github.com/hodnduy/se104/blob/HEAD/app/src/main/java/com/maadi/flightticketbooking/activities/MyBookingDetail.java): activity · Single booking detail view · `app/src/main/java/com/maadi/flightticketbooking/activities/MyBookingDetail.java`
- [Profile](https://github.com/hodnduy/se104/blob/HEAD/app/src/main/java/com/maadi/flightticketbooking/activities/Profile.java): activity · User account and profile screen · `app/src/main/java/com/maadi/flightticketbooking/activities/Profile.java`
- [About Us](https://github.com/hodnduy/se104/blob/HEAD/app/src/main/java/com/maadi/flightticketbooking/activities/AboutUs.java): activity · App information screen · `app/src/main/java/com/maadi/flightticketbooking/activities/AboutUs.java`
- [Contact Us](https://github.com/hodnduy/se104/blob/HEAD/app/src/main/java/com/maadi/flightticketbooking/activities/ContactUs.java): activity · Support and inquiry screen · `app/src/main/java/com/maadi/flightticketbooking/activities/ContactUs.java`
- [Vehicle Adapter](https://github.com/hodnduy/se104/blob/HEAD/app/src/main/java/com/maadi/flightticketbooking/adapters/VehicleAdapter.java): recycler adapter · Binds vehicle search results to list rows · `app/src/main/java/com/maadi/flightticketbooking/adapters/VehicleAdapter.java`
- [Booking Adapter](https://github.com/hodnduy/se104/blob/HEAD/app/src/main/java/com/maadi/flightticketbooking/adapters/BookingAdapter.java): recycler adapter · Binds booking history records to list rows · `app/src/main/java/com/maadi/flightticketbooking/adapters/BookingAdapter.java`
- [Passenger Adapter](https://github.com/hodnduy/se104/blob/HEAD/app/src/main/java/com/maadi/flightticketbooking/adapters/PassengerAdapter.java): recycler adapter · Binds passenger rows in booking flow · `app/src/main/java/com/maadi/flightticketbooking/adapters/PassengerAdapter.java`
- [App Models](https://github.com/hodnduy/se104/tree/HEAD/app/src/main/java/com/maadi/flightticketbooking/models): domain models · User, city, vehicle, banner, booking, passenger, and developer objects · `app/src/main/java/com/maadi/flightticketbooking/models`
- [App Utilities](https://github.com/hodnduy/se104/tree/HEAD/app/src/main/java/com/maadi/flightticketbooking/utilities): support layer · Networking, constants, persistence, and helper functions · `app/src/main/java/com/maadi/flightticketbooking/utilities`
- [Layouts](https://github.com/hodnduy/se104/tree/HEAD/app/src/main/res/layout): android resources · Screen and row XML layouts for the UI · `app/src/main/res/layout`
- [UI Assets](https://github.com/hodnduy/se104/tree/HEAD/app/src/main/res): android resources · Drawables, animations, raw Lottie assets, menus, and themes · `app/src/main/res`

### Backend API

PHP endpoint layer serving booking and account operations.

- [Auth APIs](https://github.com/hodnduy/se104/tree/HEAD/flight_ticket_boooking_api): php endpoints · Login, signup, and password change scripts · `flight_ticket_boooking_api`
- [Booking APIs](https://github.com/hodnduy/se104/tree/HEAD/flight_ticket_boooking_api): php endpoints · Search, booking, booking ID, and passenger retrieval scripts · `flight_ticket_boooking_api`
- [Content APIs](https://github.com/hodnduy/se104/tree/HEAD/flight_ticket_boooking_api): php endpoints · City, banner, and contact submission scripts · `flight_ticket_boooking_api`
- [DB Config](https://github.com/hodnduy/se104/blob/HEAD/flight_ticket_boooking_api/db.php): php config · Shared database connection scripts · `flight_ticket_boooking_api/db.php`

### Data layer

Persistent storage and hosted media used by the API.

- [MySQL DB](https://github.com/hodnduy/se104/blob/HEAD/flight_ticket_boooking_api.sql): relational database · Persistent booking, user, passenger, city, and banner data · `flight_ticket_boooking_api.sql`
- [Media Store](https://github.com/hodnduy/se104/tree/HEAD/flight_ticket_boooking_api/images): hosted images · User and banner image assets served by the backend · `flight_ticket_boooking_api/images`

## Connections

- Splash → Welcome: routes to · Startup flow continues to landing screen
- Welcome → Login: entry to auth · User can proceed into authentication
- Login → Main Activity: opens app · Successful login reaches the main shell
- Register → Login: returns · After signup the user can sign in
- Main Activity → Search Vehicle: launches · Home shell starts booking search
- Main Activity → Booking History: shows · Home shell accesses past bookings
- Main Activity → Profile: opens · Home shell exposes account screen
- Main Activity → About Us: opens · Home shell exposes about screen
- Main Activity → Contact Us: opens · Home shell exposes support screen
- Search Vehicle → Vehicle Detail: selects · Chosen result opens detail view
- Vehicle Detail → Book Ticket: continues to · Detail view leads into booking
- Book Ticket → Booking Detail: creates · Completed booking leads to confirmation/detail
- Booking History → Booking Detail: drills into · History entries open booking detail
- Search Vehicle → Vehicle Adapter: renders via · Search results are bound into rows
- Booking History → Booking Adapter: renders via · Booking history uses a list adapter
- Book Ticket → Passenger Adapter: renders via · Passenger entry list is adapter-driven
- App Utilities → Auth APIs: calls · HTTP client invokes authentication APIs
- App Utilities → Booking APIs: calls · HTTP client invokes booking APIs
- App Utilities → Content APIs: calls · HTTP client invokes content and support APIs
- Auth APIs → DB Config: uses · Endpoints share database connection setup
- Booking APIs → DB Config: uses · Endpoints share database connection setup
- Content APIs → DB Config: uses · Endpoints share database connection setup
- DB Config → MySQL DB: connects to · Backend reads and writes relational data
- Content APIs → Media Store: serves · Banners and user images are exposed to the app
- App Models → Vehicle Adapter: feeds · Vehicle model data binds to result rows
- App Models → Booking Adapter: feeds · Booking model data binds to history rows
- App Models → Passenger Adapter: feeds · Passenger model data binds to passenger rows
- App Models → App Utilities: populates · Network responses are parsed into app models
- Layouts → Main Activity: backs · XML layouts define the app shell and screens
- Layouts → Search Vehicle: backs · XML layouts define the search screen
- Layouts → Book Ticket: backs · XML layouts define the booking screen
- UI Assets → Layouts: styles · Resources provide visuals, animations, and themes for layouts
