# saiteja05-code/train-ticket-reservation architecture

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

- Interactive diagram: https://gitdiagram.com/saiteja05-code/train-ticket-reservation
- Repository: https://github.com/saiteja05-code/train-ticket-reservation

## Overview

This is a Java servlet-based train reservation portal: users can search trains and fares, book tickets, and view booking history; administrators manage train schedules and records. Servlet handlers call service implementations, which perform SQL operations through DBUtil. User and admin authentication is handled by TrainUtil and role-specific user services. The README contains no usable product documentation, so capabilities are inferred from the source tree and indexed servlet references; several servlet and booking details were not excerpted.

Main entry points: [`src/com/shashi/service/impl/TrainServiceImpl.java`](https://github.com/saiteja05-code/train-ticket-reservation/blob/master/src/com/shashi/service/impl/TrainServiceImpl.java) (Train operations), [`src/com/shashi/service/impl/BookingServiceImpl.java`](https://github.com/saiteja05-code/train-ticket-reservation/blob/master/src/com/shashi/service/impl/BookingServiceImpl.java) (Booking operations), [`src/com/shashi/service/impl/UserServiceImpl.java`](https://github.com/saiteja05-code/train-ticket-reservation/blob/master/src/com/shashi/service/impl/UserServiceImpl.java) (User operations), [`src/com/shashi/servlets/BookTrains.java`](https://github.com/saiteja05-code/train-ticket-reservation/blob/master/src/com/shashi/servlets/BookTrains.java) (Ticket booking)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Servlet workflows"]
  node_search["Train search<br/>[TrainBwStn.java]"]
  node_fare["Fare enquiry<br/>[FareEnq.java]"]
  node_booking["Ticket booking<br/>[BookTrains.java]"]
  node_history["Booking history"]
  node_train_admin["Train administration"]
  node_user_home["User home<br/>[UserHome.java]"]
end

subgraph group_services["Domain services"]
  node_train_service["Train operations"]
  node_booking_service["Booking operations"]
  node_user_service["User operations"]
  node_train_api["Train service API<br/>[TrainService.java]"]
  node_booking_api["Booking service API"]
  node_user_api["User service API<br/>[UserService.java]"]
end

subgraph group_identity["Identity and session"]
  node_auth["Session utilities<br/>[TrainUtil.java]"]
end

subgraph group_model["Domain model"]
  node_user_model["User record<br/>[UserBean.java]"]
  node_train_model["Train record<br/>[TrainBean.java]"]
  node_booking_model["Booking record<br/>[HistoryBean.java]"]
end

subgraph group_storage["Persistence"]
  node_db_util["Database access<br/>[DBUtil.java]"]
  node_database[("Relational database")]
end

node_customer(("Customer"))
node_admin(("Administrator"))

node_customer -->|"searches"| node_search
node_customer -.->|"checks fares"| node_fare
node_customer -.->|"books tickets"| node_booking
node_customer -.->|"views history"| node_history
node_admin -.->|"manages trains"| node_train_admin
node_search -->|"calls"| node_train_service
node_fare -->|"calls"| node_train_service
node_booking -->|"calls"| node_train_service
node_booking -->|"creates booking"| node_booking_service
node_history -->|"loads history"| node_booking_service
node_train_admin -->|"updates trains"| node_train_service
node_user_home -->|"checks session"| node_auth
node_train_service -->|"gets connection"| node_db_util
node_booking_service -->|"gets connection"| node_db_util
node_user_service -->|"gets connection"| node_db_util
node_train_service -->|"queries trains"| node_database
node_booking_service -.->|"queries bookings"| node_database
node_user_service -->|"queries users"| node_database
node_auth -->|"authenticates"| node_user_service
node_train_service -->|"implements"| node_train_api
node_booking_service -->|"implements"| node_booking_api
node_user_service -->|"implements"| node_user_api
node_train_service -->|"maps records"| node_train_model
node_booking_service -->|"maps records"| node_booking_model
node_user_service -->|"maps records"| node_user_model

click node_search "https://github.com/saiteja05-code/train-ticket-reservation/blob/master/src/com/shashi/servlets/TrainBwStn.java"
click node_fare "https://github.com/saiteja05-code/train-ticket-reservation/blob/master/src/com/shashi/servlets/FareEnq.java"
click node_booking "https://github.com/saiteja05-code/train-ticket-reservation/blob/master/src/com/shashi/servlets/BookTrains.java"
click node_history "https://github.com/saiteja05-code/train-ticket-reservation/blob/master/src/com/shashi/servlets/TicketBookingHistory.java"
click node_train_admin "https://github.com/saiteja05-code/train-ticket-reservation/blob/master/src/com/shashi/servlets/AdminTrainUpdate.java"
click node_user_home "https://github.com/saiteja05-code/train-ticket-reservation/blob/master/src/com/shashi/servlets/UserHome.java"
click node_train_service "https://github.com/saiteja05-code/train-ticket-reservation/blob/master/src/com/shashi/service/impl/TrainServiceImpl.java"
click node_booking_service "https://github.com/saiteja05-code/train-ticket-reservation/blob/master/src/com/shashi/service/impl/BookingServiceImpl.java"
click node_user_service "https://github.com/saiteja05-code/train-ticket-reservation/blob/master/src/com/shashi/service/impl/UserServiceImpl.java"
click node_train_api "https://github.com/saiteja05-code/train-ticket-reservation/blob/master/src/com/shashi/service/TrainService.java"
click node_booking_api "https://github.com/saiteja05-code/train-ticket-reservation/blob/master/src/com/shashi/service/BookingService.java"
click node_user_api "https://github.com/saiteja05-code/train-ticket-reservation/blob/master/src/com/shashi/service/UserService.java"
click node_auth "https://github.com/saiteja05-code/train-ticket-reservation/blob/master/src/com/shashi/utility/TrainUtil.java"
click node_user_model "https://github.com/saiteja05-code/train-ticket-reservation/blob/master/src/com/shashi/beans/UserBean.java"
click node_train_model "https://github.com/saiteja05-code/train-ticket-reservation/blob/master/src/com/shashi/beans/TrainBean.java"
click node_booking_model "https://github.com/saiteja05-code/train-ticket-reservation/blob/master/src/com/shashi/beans/HistoryBean.java"
click node_db_util "https://github.com/saiteja05-code/train-ticket-reservation/blob/master/src/com/shashi/utility/DBUtil.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_search,node_fare,node_booking,node_history,node_train_admin,node_user_home toneBlue
class node_train_service,node_booking_service,node_user_service,node_train_api,node_booking_api,node_user_api toneAmber
class node_auth toneMint
class node_user_model,node_train_model,node_booking_model toneRose
class node_db_util,node_database,node_customer,node_admin toneIndigo
```

## Components

### Servlet workflows

- [Train search](https://github.com/saiteja05-code/train-ticket-reservation/blob/master/src/com/shashi/servlets/TrainBwStn.java): `src/com/shashi/servlets/TrainBwStn.java`
- [Fare enquiry](https://github.com/saiteja05-code/train-ticket-reservation/blob/master/src/com/shashi/servlets/FareEnq.java): `src/com/shashi/servlets/FareEnq.java`
- [Ticket booking](https://github.com/saiteja05-code/train-ticket-reservation/blob/master/src/com/shashi/servlets/BookTrains.java): `src/com/shashi/servlets/BookTrains.java`
- [Booking history](https://github.com/saiteja05-code/train-ticket-reservation/blob/master/src/com/shashi/servlets/TicketBookingHistory.java): `src/com/shashi/servlets/TicketBookingHistory.java`
- [Train administration](https://github.com/saiteja05-code/train-ticket-reservation/blob/master/src/com/shashi/servlets/AdminTrainUpdate.java): `src/com/shashi/servlets/AdminTrainUpdate.java`
- [User home](https://github.com/saiteja05-code/train-ticket-reservation/blob/master/src/com/shashi/servlets/UserHome.java): `src/com/shashi/servlets/UserHome.java`

### Domain services

- [Train operations](https://github.com/saiteja05-code/train-ticket-reservation/blob/master/src/com/shashi/service/impl/TrainServiceImpl.java): `src/com/shashi/service/impl/TrainServiceImpl.java`
- [Booking operations](https://github.com/saiteja05-code/train-ticket-reservation/blob/master/src/com/shashi/service/impl/BookingServiceImpl.java): `src/com/shashi/service/impl/BookingServiceImpl.java`
- [User operations](https://github.com/saiteja05-code/train-ticket-reservation/blob/master/src/com/shashi/service/impl/UserServiceImpl.java): `src/com/shashi/service/impl/UserServiceImpl.java`
- [Train service API](https://github.com/saiteja05-code/train-ticket-reservation/blob/master/src/com/shashi/service/TrainService.java): `src/com/shashi/service/TrainService.java`
- [Booking service API](https://github.com/saiteja05-code/train-ticket-reservation/blob/master/src/com/shashi/service/BookingService.java): `src/com/shashi/service/BookingService.java`
- [User service API](https://github.com/saiteja05-code/train-ticket-reservation/blob/master/src/com/shashi/service/UserService.java): `src/com/shashi/service/UserService.java`

### Identity and session

- [Session utilities](https://github.com/saiteja05-code/train-ticket-reservation/blob/master/src/com/shashi/utility/TrainUtil.java): `src/com/shashi/utility/TrainUtil.java`

### Domain model

- [User record](https://github.com/saiteja05-code/train-ticket-reservation/blob/master/src/com/shashi/beans/UserBean.java): `src/com/shashi/beans/UserBean.java`
- [Train record](https://github.com/saiteja05-code/train-ticket-reservation/blob/master/src/com/shashi/beans/TrainBean.java): `src/com/shashi/beans/TrainBean.java`
- [Booking record](https://github.com/saiteja05-code/train-ticket-reservation/blob/master/src/com/shashi/beans/HistoryBean.java): `src/com/shashi/beans/HistoryBean.java`

### Persistence

- [Database access](https://github.com/saiteja05-code/train-ticket-reservation/blob/master/src/com/shashi/utility/DBUtil.java): `src/com/shashi/utility/DBUtil.java`
- **Relational database**

### Other components

- **Customer**
- **Administrator**

## Connections

- Customer → Train search: searches (evidence: `src/com/shashi/servlets/TrainBwStn.java`)
- Customer → Fare enquiry: checks fares
- Customer → Ticket booking: books tickets
- Customer → Booking history: views history
- Administrator → Train administration: manages trains
- Train search → Train operations: calls (evidence: `src/com/shashi/servlets/TrainBwStn.java`)
- Fare enquiry → Train operations: calls (evidence: `src/com/shashi/servlets/FareEnq.java`)
- Ticket booking → Train operations: calls (evidence: `src/com/shashi/servlets/BookTrains.java`)
- Ticket booking → Booking operations: creates booking (evidence: `src/com/shashi/servlets/BookTrains.java`)
- Booking history → Booking operations: loads history (evidence: `src/com/shashi/servlets/TicketBookingHistory.java`)
- Train administration → Train operations: updates trains (evidence: `src/com/shashi/servlets/AdminTrainUpdate.java`)
- User home → Session utilities: checks session (evidence: `src/com/shashi/servlets/UserHome.java`)
- Train operations → Database access: gets connection (evidence: `src/com/shashi/service/impl/TrainServiceImpl.java`)
- Booking operations → Database access: gets connection (evidence: `src/com/shashi/service/impl/BookingServiceImpl.java`)
- User operations → Database access: gets connection (evidence: `src/com/shashi/service/impl/UserServiceImpl.java`)
- Train operations → Relational database: queries trains (evidence: `src/com/shashi/service/impl/TrainServiceImpl.java`)
- Booking operations → Relational database: queries bookings
- User operations → Relational database: queries users (evidence: `src/com/shashi/service/impl/UserServiceImpl.java`)
- Session utilities → User operations: authenticates (evidence: `src/com/shashi/utility/TrainUtil.java`)
- Train operations → Train service API: implements (evidence: `src/com/shashi/service/impl/TrainServiceImpl.java`)
- Booking operations → Booking service API: implements (evidence: `src/com/shashi/service/impl/BookingServiceImpl.java`)
- User operations → User service API: implements (evidence: `src/com/shashi/service/impl/UserServiceImpl.java`)
- Train operations → Train record: maps records (evidence: `src/com/shashi/service/impl/TrainServiceImpl.java`)
- Booking operations → Booking record: maps records (evidence: `src/com/shashi/service/impl/BookingServiceImpl.java`)
- User operations → User record: maps records (evidence: `src/com/shashi/service/impl/UserServiceImpl.java`)
