# maoengsodung-dev/travel-transportation-frontend architecture

> Architecture diagram of the GitHub repository maoengsodung-dev/travel-transportation-frontend, 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/maoengsodung-dev/travel-transportation-frontend
- Repository: https://github.com/maoengsodung-dev/travel-transportation-frontend

## Overview

This Flutter/GetX app supports regional travel booking in Cambodia. The principal journey is to search multimodal trips, choose travel dates and seats, complete payment, and access digital tickets and trip history. Other documented capabilities include authentication, profile and payment-method management, favorites, discounts, maps, notifications, and English/Khmer localization. The README describes these capabilities and the GetX architecture; implementation excerpts were not provided, so relationships below rely on README statements rather than inspected Dart source.

Main entry points: [`lib/main.dart`](https://github.com/maoengsodung-dev/travel-transportation-frontend/blob/main/lib/main.dart) (App Bootstrap), [`lib/app/modules/home_screens/search`](https://github.com/maoengsodung-dev/travel-transportation-frontend/tree/main/lib/app/modules/home_screens/search) (Route Search), [`lib/app/routes/app_pages.dart`](https://github.com/maoengsodung-dev/travel-transportation-frontend/blob/main/lib/app/routes/app_pages.dart) (Named Routing), [`lib/app/data/data.dart`](https://github.com/maoengsodung-dev/travel-transportation-frontend/blob/main/lib/app/data/data.dart) (Transit Data)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App Shell"]
  node_bootstrap["App Bootstrap<br/>[main.dart]"]
  node_routing["Named Routing<br/>[app_pages.dart]"]
end

subgraph group_discovery["Trip Discovery"]
  node_search["Route Search"]
  node_schedules[("Transit Data<br/>[data.dart]")]
  node_date_picker["Trip Dates"]
  node_trip_filters["Trip Filters"]
  node_map["Station Map"]
end

subgraph group_booking["Booking &amp; Payment"]
  node_seat_selection["Seat Selection"]
  node_checkout["Payment Checkout"]
  node_ticket_history["Tickets &amp; History"]
end

subgraph group_traveler["Traveler Services"]
  node_authentication["Authentication"]
  node_profile["Profile Settings"]
  node_favorites["Favorite Routes"]
end

subgraph group_shared["Shared Services"]
  node_discounts["Discount Offers"]
  node_notifications["Trip Alerts"]
  node_localization["English &amp; Khmer"]
end

node_traveler_actor(("Traveler"))

node_traveler_actor -->|"opens app"| node_bootstrap
node_bootstrap -->|"initializes routing"| node_routing
node_traveler_actor -->|"searches routes"| node_search
node_search -->|"compares schedules"| node_schedules
node_traveler_actor -->|"selects dates"| node_date_picker
node_traveler_actor -->|"filters trips"| node_trip_filters
node_traveler_actor -->|"views stations"| node_map
node_traveler_actor -->|"selects seats"| node_seat_selection
node_traveler_actor -->|"pays fare"| node_checkout
node_traveler_actor -->|"accesses tickets"| node_ticket_history
node_traveler_actor -->|"signs in"| node_authentication
node_traveler_actor -->|"manages profile"| node_profile
node_traveler_actor -->|"saves routes"| node_favorites
node_traveler_actor -->|"views offers"| node_discounts
node_traveler_actor -->|"receives alerts"| node_notifications
node_bootstrap -->|"supports languages"| node_localization

click node_bootstrap "https://github.com/maoengsodung-dev/travel-transportation-frontend/blob/main/lib/main.dart"
click node_routing "https://github.com/maoengsodung-dev/travel-transportation-frontend/blob/main/lib/app/routes/app_pages.dart"
click node_search "https://github.com/maoengsodung-dev/travel-transportation-frontend/tree/main/lib/app/modules/home_screens/search"
click node_schedules "https://github.com/maoengsodung-dev/travel-transportation-frontend/blob/main/lib/app/data/data.dart"
click node_date_picker "https://github.com/maoengsodung-dev/travel-transportation-frontend/tree/main/lib/app/modules/home_screens/date"
click node_trip_filters "https://github.com/maoengsodung-dev/travel-transportation-frontend/tree/main/lib/app/modules/home_screens/search"
click node_map "https://github.com/maoengsodung-dev/travel-transportation-frontend/tree/main/lib/app/modules/home_screens/map"
click node_seat_selection "https://github.com/maoengsodung-dev/travel-transportation-frontend/tree/main/lib/app/modules/select_seat"
click node_checkout "https://github.com/maoengsodung-dev/travel-transportation-frontend/tree/main/lib/app/modules/payment"
click node_ticket_history "https://github.com/maoengsodung-dev/travel-transportation-frontend/tree/main/lib/app/modules/history"
click node_authentication "https://github.com/maoengsodung-dev/travel-transportation-frontend/tree/main/lib/app/modules/auth"
click node_profile "https://github.com/maoengsodung-dev/travel-transportation-frontend/tree/main/lib/app/modules/account_setting"
click node_favorites "https://github.com/maoengsodung-dev/travel-transportation-frontend/tree/main/lib/app/modules/favorite"
click node_discounts "https://github.com/maoengsodung-dev/travel-transportation-frontend/tree/main/lib/app/modules/home_screens/discount"
click node_notifications "https://github.com/maoengsodung-dev/travel-transportation-frontend/tree/main/lib/app/modules/notification"
click node_localization "https://github.com/maoengsodung-dev/travel-transportation-frontend/blob/main/lib/app/services/app_translatations.dart"

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_bootstrap,node_routing toneBlue
class node_search,node_schedules,node_date_picker,node_trip_filters,node_map toneAmber
class node_seat_selection,node_checkout,node_ticket_history toneMint
class node_authentication,node_profile,node_favorites toneRose
class node_discounts,node_notifications,node_localization,node_traveler_actor toneIndigo
```

## Components

### App Shell

- [App Bootstrap](https://github.com/maoengsodung-dev/travel-transportation-frontend/blob/main/lib/main.dart): `lib/main.dart`
- [Named Routing](https://github.com/maoengsodung-dev/travel-transportation-frontend/blob/main/lib/app/routes/app_pages.dart): `lib/app/routes/app_pages.dart`

### Trip Discovery

- [Route Search](https://github.com/maoengsodung-dev/travel-transportation-frontend/tree/main/lib/app/modules/home_screens/search): `lib/app/modules/home_screens/search`
- [Transit Data](https://github.com/maoengsodung-dev/travel-transportation-frontend/blob/main/lib/app/data/data.dart): `lib/app/data/data.dart`
- [Trip Dates](https://github.com/maoengsodung-dev/travel-transportation-frontend/tree/main/lib/app/modules/home_screens/date): `lib/app/modules/home_screens/date`
- [Trip Filters](https://github.com/maoengsodung-dev/travel-transportation-frontend/tree/main/lib/app/modules/home_screens/search): `lib/app/modules/home_screens/search`
- [Station Map](https://github.com/maoengsodung-dev/travel-transportation-frontend/tree/main/lib/app/modules/home_screens/map): `lib/app/modules/home_screens/map`

### Booking & Payment

- [Seat Selection](https://github.com/maoengsodung-dev/travel-transportation-frontend/tree/main/lib/app/modules/select_seat): `lib/app/modules/select_seat`
- [Payment Checkout](https://github.com/maoengsodung-dev/travel-transportation-frontend/tree/main/lib/app/modules/payment): `lib/app/modules/payment`
- [Tickets & History](https://github.com/maoengsodung-dev/travel-transportation-frontend/tree/main/lib/app/modules/history): `lib/app/modules/history`

### Traveler Services

- [Authentication](https://github.com/maoengsodung-dev/travel-transportation-frontend/tree/main/lib/app/modules/auth): `lib/app/modules/auth`
- [Profile Settings](https://github.com/maoengsodung-dev/travel-transportation-frontend/tree/main/lib/app/modules/account_setting): `lib/app/modules/account_setting`
- [Favorite Routes](https://github.com/maoengsodung-dev/travel-transportation-frontend/tree/main/lib/app/modules/favorite): `lib/app/modules/favorite`

### Shared Services

- [Discount Offers](https://github.com/maoengsodung-dev/travel-transportation-frontend/tree/main/lib/app/modules/home_screens/discount): `lib/app/modules/home_screens/discount`
- [Trip Alerts](https://github.com/maoengsodung-dev/travel-transportation-frontend/tree/main/lib/app/modules/notification): `lib/app/modules/notification`
- [English & Khmer](https://github.com/maoengsodung-dev/travel-transportation-frontend/blob/main/lib/app/services/app_translatations.dart): `lib/app/services/app_translatations.dart`

### Other components

- **Traveler**

## Connections

- Traveler → App Bootstrap: opens app (evidence: `README.md`)
- App Bootstrap → Named Routing: initializes routing (evidence: `README.md`)
- Traveler → Route Search: searches routes (evidence: `README.md`)
- Route Search → Transit Data: compares schedules (evidence: `README.md`)
- Traveler → Trip Dates: selects dates (evidence: `README.md`)
- Traveler → Trip Filters: filters trips (evidence: `README.md`)
- Traveler → Station Map: views stations (evidence: `README.md`)
- Traveler → Seat Selection: selects seats (evidence: `README.md`)
- Traveler → Payment Checkout: pays fare (evidence: `README.md`)
- Traveler → Tickets & History: accesses tickets (evidence: `README.md`)
- Traveler → Authentication: signs in (evidence: `README.md`)
- Traveler → Profile Settings: manages profile (evidence: `README.md`)
- Traveler → Favorite Routes: saves routes (evidence: `README.md`)
- Traveler → Discount Offers: views offers (evidence: `README.md`)
- Traveler → Trip Alerts: receives alerts (evidence: `README.md`)
- App Bootstrap → English & Khmer: supports languages (evidence: `README.md`)
