# singhdevhub-lovepreet/ticketbooking architecture

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

- Interactive diagram: https://gitdiagram.com/singhdevhub-lovepreet/ticketbooking
- Repository: https://github.com/singhdevhub-lovepreet/ticketbooking

## Overview

This is a Java command-line train-booking application. A user interacts with the menu to sign up or log in, search trains by route, inspect seats, and request a seat booking; they can also view or cancel bookings. App dispatches menu actions to UserBookingService, which coordinates train lookup, seat updates, user authentication, and file-backed data. The core entities represent users, trains, and tickets. The excerpts show JSON persistence intent, but the configured file paths do not clearly match the tree’s localDB filenames, so storage links are omitted.

Main entry points: [`app/src/main/java/ticket/booking/service/UserBookingService.java`](https://github.com/singhdevhub-lovepreet/ticketbooking/blob/main/app/src/main/java/ticket/booking/service/UserBookingService.java) (Booking service), [`app/src/main/java/ticket/booking/App.java`](https://github.com/singhdevhub-lovepreet/ticketbooking/blob/main/app/src/main/java/ticket/booking/App.java) (Menu application), [`app/src/main/java/ticket/booking/entities/Train.java`](https://github.com/singhdevhub-lovepreet/ticketbooking/blob/main/app/src/main/java/ticket/booking/entities/Train.java) (Train), [`app/src/main/java/ticket/booking/entities/User.java`](https://github.com/singhdevhub-lovepreet/ticketbooking/blob/main/app/src/main/java/ticket/booking/entities/User.java) (User)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_cli["CLI workflow"]
  node_app["Menu application<br/>[App.java]"]
end

subgraph group_services["Booking services"]
  node_booking["Booking service"]
  node_train_service["Train service<br/>[TrainService.java]"]
  node_password_util["Password utility"]
end

subgraph group_domain["Domain entities"]
  node_user["User<br/>[User.java]"]
  node_ticket["Ticket<br/>[Ticket.java]"]
  node_train["Train<br/>[Train.java]"]
end

subgraph group_data["Local data"]
  node_users_file[("User records<br/>[users.json]")]
  node_trains_file[("Train records<br/>[trains.json]")]
end

node_traveler(("Traveler"))

node_traveler -->|"chooses actions"| node_app
node_app -->|"dispatches requests"| node_booking
node_app -->|"hashes signup password"| node_password_util
node_app -->|"creates user"| node_user
node_app -->|"displays train data"| node_train
node_booking -->|"checks password"| node_password_util
node_booking -->|"searches and updates trains"| node_train_service
node_booking -->|"reads seat state"| node_train
node_booking -->|"authenticates user"| node_user
node_booking -->|"removes booking ticket"| node_ticket
node_train_service -->|"filters train data"| node_train
node_user -->|"holds booked tickets"| node_ticket
node_ticket -->|"references train"| node_train

click node_app "https://github.com/singhdevhub-lovepreet/ticketbooking/blob/main/app/src/main/java/ticket/booking/App.java"
click node_booking "https://github.com/singhdevhub-lovepreet/ticketbooking/blob/main/app/src/main/java/ticket/booking/service/UserBookingService.java"
click node_train_service "https://github.com/singhdevhub-lovepreet/ticketbooking/blob/main/app/src/main/java/ticket/booking/service/TrainService.java"
click node_password_util "https://github.com/singhdevhub-lovepreet/ticketbooking/blob/main/app/src/main/java/ticket/booking/util/UserServiceUtil.java"
click node_user "https://github.com/singhdevhub-lovepreet/ticketbooking/blob/main/app/src/main/java/ticket/booking/entities/User.java"
click node_ticket "https://github.com/singhdevhub-lovepreet/ticketbooking/blob/main/app/src/main/java/ticket/booking/entities/Ticket.java"
click node_train "https://github.com/singhdevhub-lovepreet/ticketbooking/blob/main/app/src/main/java/ticket/booking/entities/Train.java"
click node_users_file "https://github.com/singhdevhub-lovepreet/ticketbooking/blob/main/app/src/main/java/ticket/booking/localDB/users.json"
click node_trains_file "https://github.com/singhdevhub-lovepreet/ticketbooking/blob/main/app/src/main/java/ticket/booking/localDB/trains.json"

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_booking,node_train_service,node_password_util toneAmber
class node_user,node_ticket,node_train toneMint
class node_users_file,node_trains_file toneRose
class node_traveler toneIndigo
```

## Components

### CLI workflow

- [Menu application](https://github.com/singhdevhub-lovepreet/ticketbooking/blob/main/app/src/main/java/ticket/booking/App.java): `app/src/main/java/ticket/booking/App.java`

### Booking services

- [Booking service](https://github.com/singhdevhub-lovepreet/ticketbooking/blob/main/app/src/main/java/ticket/booking/service/UserBookingService.java): `app/src/main/java/ticket/booking/service/UserBookingService.java`
- [Train service](https://github.com/singhdevhub-lovepreet/ticketbooking/blob/main/app/src/main/java/ticket/booking/service/TrainService.java): `app/src/main/java/ticket/booking/service/TrainService.java`
- [Password utility](https://github.com/singhdevhub-lovepreet/ticketbooking/blob/main/app/src/main/java/ticket/booking/util/UserServiceUtil.java): `app/src/main/java/ticket/booking/util/UserServiceUtil.java`

### Domain entities

- [User](https://github.com/singhdevhub-lovepreet/ticketbooking/blob/main/app/src/main/java/ticket/booking/entities/User.java): `app/src/main/java/ticket/booking/entities/User.java`
- [Ticket](https://github.com/singhdevhub-lovepreet/ticketbooking/blob/main/app/src/main/java/ticket/booking/entities/Ticket.java): `app/src/main/java/ticket/booking/entities/Ticket.java`
- [Train](https://github.com/singhdevhub-lovepreet/ticketbooking/blob/main/app/src/main/java/ticket/booking/entities/Train.java): `app/src/main/java/ticket/booking/entities/Train.java`

### Local data

- [User records](https://github.com/singhdevhub-lovepreet/ticketbooking/blob/main/app/src/main/java/ticket/booking/localDB/users.json): `app/src/main/java/ticket/booking/localDB/users.json`
- [Train records](https://github.com/singhdevhub-lovepreet/ticketbooking/blob/main/app/src/main/java/ticket/booking/localDB/trains.json): `app/src/main/java/ticket/booking/localDB/trains.json`

### Other components

- **Traveler**

## Connections

- Traveler → Menu application: chooses actions (evidence: `app/src/main/java/ticket/booking/App.java`)
- Menu application → Booking service: dispatches requests (evidence: `app/src/main/java/ticket/booking/App.java`)
- Menu application → Password utility: hashes signup password (evidence: `app/src/main/java/ticket/booking/App.java`)
- Menu application → User: creates user (evidence: `app/src/main/java/ticket/booking/App.java`)
- Menu application → Train: displays train data (evidence: `app/src/main/java/ticket/booking/App.java`)
- Booking service → Password utility: checks password (evidence: `app/src/main/java/ticket/booking/service/UserBookingService.java`)
- Booking service → Train service: searches and updates trains (evidence: `app/src/main/java/ticket/booking/service/UserBookingService.java`)
- Booking service → Train: reads seat state (evidence: `app/src/main/java/ticket/booking/service/UserBookingService.java`)
- Booking service → User: authenticates user (evidence: `app/src/main/java/ticket/booking/service/UserBookingService.java`)
- Booking service → Ticket: removes booking ticket (evidence: `app/src/main/java/ticket/booking/service/UserBookingService.java`)
- Train service → Train: filters train data (evidence: `app/src/main/java/ticket/booking/service/TrainService.java`)
- User → Ticket: holds booked tickets (evidence: `app/src/main/java/ticket/booking/entities/User.java`)
- Ticket → Train: references train (evidence: `app/src/main/java/ticket/booking/entities/Ticket.java`)
