# areebasaeed17/transitwise architecture

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

- Interactive diagram: https://gitdiagram.com/areebasaeed17/transitwise
- Repository: https://github.com/areebasaeed17/transitwise

## Overview

TransitWise is a JavaFX bus-ticket booking desktop app. A passenger registers or logs in, searches routes, selects an available seat and travel date, pays from an in-app wallet, and views booking history or a boarding-pass popup. Booking applies an advance-purchase discount and records the ticket; user and ticket records persist in text files. The graph includes the main domain models and ticket formatter. Some UI and persistence links are supported by README statements because the app excerpt is partial; unsampled implementation details are not inferred.

Main entry points: [`BookTicket.java`](https://github.com/areebasaeed17/transitwise/blob/main/BookTicket.java) (Booking workflow), [`TransitWiseApp.java`](https://github.com/areebasaeed17/transitwise/blob/main/TransitWiseApp.java) (JavaFX app), [`Ticket.java`](https://github.com/areebasaeed17/transitwise/blob/main/Ticket.java) (Booking record), [`Bus.java`](https://github.com/areebasaeed17/transitwise/blob/main/Bus.java) (Bus and seats)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Desktop interface"]
  node_app["JavaFX app"]
end

subgraph group_identity["Accounts and wallet"]
  node_authenticator["Input validation<br/>[Authenticator.java]"]
  node_auth["User registry<br/>[AuthService.java]"]
  node_wallet["Wallet service<br/>[WalletService.java]"]
  node_user["Passenger account<br/>[User.java]"]
end

subgraph group_booking["Transit and booking"]
  node_booking["Booking workflow<br/>[BookTicket.java]"]
  node_discount["Discount calculation"]
  node_data["Route and bus data<br/>[Data.java]"]
  node_bus["Bus and seats<br/>[Bus.java]"]
  node_route["Route details<br/>[Route.java]"]
end

subgraph group_records["Records and tickets"]
  node_ticket["Booking record<br/>[Ticket.java]"]
  node_persistence["File persistence"]
  node_usersfile["User records<br/>[users.txt]"]
  node_ticketsfile["Ticket records<br/>[tickets.txt]"]
  node_formatter["Ticket formatter"]
end

node_passenger(("Passenger"))

node_passenger -->|"uses"| node_app
node_app -->|"submits credentials"| node_authenticator
node_authenticator -->|"registers or logs in"| node_auth
node_auth -->|"creates"| node_user
node_app -->|"requests booking"| node_booking
node_app -->|"tops up wallet"| node_wallet
node_booking -->|"searches buses"| node_data
node_data -->|"creates buses"| node_bus
node_data -->|"creates routes"| node_route
node_bus -->|"references route"| node_route
node_booking -->|"calculates fare"| node_discount
node_booking -->|"deducts fare"| node_wallet
node_wallet -->|"updates balance"| node_user
node_booking -->|"checks and books seat"| node_bus
node_booking -->|"creates"| node_ticket
node_booking -->|"adds to history"| node_user
node_ticket -->|"holds passenger"| node_user
node_ticket -->|"holds bus"| node_bus
node_app -->|"loads and saves"| node_persistence
node_persistence -->|"reads and writes"| node_usersfile
node_persistence -->|"reads and appends"| node_ticketsfile
node_formatter -->|"formats details from"| node_ticket
node_app -->|"shows boarding pass"| node_ticket

click node_app "https://github.com/areebasaeed17/transitwise/blob/main/TransitWiseApp.java"
click node_authenticator "https://github.com/areebasaeed17/transitwise/blob/main/Authenticator.java"
click node_auth "https://github.com/areebasaeed17/transitwise/blob/main/AuthService.java"
click node_wallet "https://github.com/areebasaeed17/transitwise/blob/main/WalletService.java"
click node_user "https://github.com/areebasaeed17/transitwise/blob/main/User.java"
click node_booking "https://github.com/areebasaeed17/transitwise/blob/main/BookTicket.java"
click node_discount "https://github.com/areebasaeed17/transitwise/blob/main/discountCalculator.java"
click node_data "https://github.com/areebasaeed17/transitwise/blob/main/Data.java"
click node_bus "https://github.com/areebasaeed17/transitwise/blob/main/Bus.java"
click node_route "https://github.com/areebasaeed17/transitwise/blob/main/Route.java"
click node_ticket "https://github.com/areebasaeed17/transitwise/blob/main/Ticket.java"
click node_persistence "https://github.com/areebasaeed17/transitwise/blob/main/FileManagement.java"
click node_usersfile "https://github.com/areebasaeed17/transitwise/blob/main/data/users.txt"
click node_ticketsfile "https://github.com/areebasaeed17/transitwise/blob/main/data/tickets.txt"
click node_formatter "https://github.com/areebasaeed17/transitwise/blob/main/TicketGenerator.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_app toneBlue
class node_authenticator,node_auth,node_wallet,node_user toneAmber
class node_booking,node_discount,node_data,node_bus,node_route toneMint
class node_ticket,node_persistence,node_usersfile,node_ticketsfile,node_formatter toneRose
class node_passenger toneIndigo
```

## Components

### Desktop interface

- [JavaFX app](https://github.com/areebasaeed17/transitwise/blob/main/TransitWiseApp.java): `TransitWiseApp.java`

### Accounts and wallet

- [Input validation](https://github.com/areebasaeed17/transitwise/blob/main/Authenticator.java): `Authenticator.java`
- [User registry](https://github.com/areebasaeed17/transitwise/blob/main/AuthService.java): `AuthService.java`
- [Wallet service](https://github.com/areebasaeed17/transitwise/blob/main/WalletService.java): `WalletService.java`
- [Passenger account](https://github.com/areebasaeed17/transitwise/blob/main/User.java): `User.java`

### Transit and booking

- [Booking workflow](https://github.com/areebasaeed17/transitwise/blob/main/BookTicket.java): `BookTicket.java`
- [Discount calculation](https://github.com/areebasaeed17/transitwise/blob/main/discountCalculator.java): `discountCalculator.java`
- [Route and bus data](https://github.com/areebasaeed17/transitwise/blob/main/Data.java): `Data.java`
- [Bus and seats](https://github.com/areebasaeed17/transitwise/blob/main/Bus.java): `Bus.java`
- [Route details](https://github.com/areebasaeed17/transitwise/blob/main/Route.java): `Route.java`

### Records and tickets

- [Booking record](https://github.com/areebasaeed17/transitwise/blob/main/Ticket.java): `Ticket.java`
- [File persistence](https://github.com/areebasaeed17/transitwise/blob/main/FileManagement.java): `FileManagement.java`
- [User records](https://github.com/areebasaeed17/transitwise/blob/main/data/users.txt): `data/users.txt`
- [Ticket records](https://github.com/areebasaeed17/transitwise/blob/main/data/tickets.txt): `data/tickets.txt`
- [Ticket formatter](https://github.com/areebasaeed17/transitwise/blob/main/TicketGenerator.java): `TicketGenerator.java`

### Other components

- **Passenger**

## Connections

- Passenger → JavaFX app: uses (evidence: `README.md`)
- JavaFX app → Input validation: submits credentials (evidence: `TransitWiseApp.java`)
- Input validation → User registry: registers or logs in (evidence: `Authenticator.java`)
- User registry → Passenger account: creates (evidence: `AuthService.java`)
- JavaFX app → Booking workflow: requests booking (evidence: `TransitWiseApp.java`)
- JavaFX app → Wallet service: tops up wallet (evidence: `TransitWiseApp.java`)
- Booking workflow → Route and bus data: searches buses (evidence: `BookTicket.java`)
- Route and bus data → Bus and seats: creates buses (evidence: `Data.java`)
- Route and bus data → Route details: creates routes (evidence: `Data.java`)
- Bus and seats → Route details: references route (evidence: `Bus.java`)
- Booking workflow → Discount calculation: calculates fare (evidence: `BookTicket.java`)
- Booking workflow → Wallet service: deducts fare (evidence: `BookTicket.java`)
- Wallet service → Passenger account: updates balance (evidence: `WalletService.java`)
- Booking workflow → Bus and seats: checks and books seat (evidence: `BookTicket.java`)
- Booking workflow → Booking record: creates (evidence: `BookTicket.java`)
- Booking workflow → Passenger account: adds to history (evidence: `BookTicket.java`)
- Booking record → Passenger account: holds passenger (evidence: `Ticket.java`)
- Booking record → Bus and seats: holds bus (evidence: `Ticket.java`)
- JavaFX app → File persistence: loads and saves (evidence: `README.md`)
- File persistence → User records: reads and writes (evidence: `FileManagement.java`)
- File persistence → Ticket records: reads and appends (evidence: `FileManagement.java`)
- Ticket formatter → Booking record: formats details from (evidence: `TicketGenerator.java`)
- JavaFX app → Booking record: shows boarding pass (evidence: `TransitWiseApp.java`)
