# manjush007/railflow architecture

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

- Interactive diagram: https://gitdiagram.com/manjush007/railflow
- Repository: https://github.com/manjush007/railflow

## Overview

RailFlow is a servlet-based train reservation web application. The main user journey is train search and enquiry, followed by availability checking, booking/payment, and booking-history access; user and administrator account and management features form parallel branches. The graph combines sampled service and utility implementations with servlet responsibilities named in the tree and README. Several servlet internals and the payment flow were not sampled, so those relationships are documented at the application level rather than asserted as specific calls.

Main entry points: [`src/com/shashi/service/impl/TrainServiceImpl.java`](https://github.com/manjush007/railflow/blob/main/src/com/shashi/service/impl/TrainServiceImpl.java) (Train operations), [`src/com/shashi/service/impl/UserServiceImpl.java`](https://github.com/manjush007/railflow/blob/main/src/com/shashi/service/impl/UserServiceImpl.java) (User operations), [`src/com/shashi/service/impl/BookingServiceImpl.java`](https://github.com/manjush007/railflow/blob/main/src/com/shashi/service/impl/BookingServiceImpl.java) (Booking operations), [`src/com/shashi/utility/DBUtil.java`](https://github.com/manjush007/railflow/blob/main/src/com/shashi/utility/DBUtil.java) (JDBC access)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web workflows"]
  node_user_web["User workflows"]
  node_search["Train search<br/>[TrainBwStn.java]"]
  node_enquiry["Fare enquiry<br/>[FareEnq.java]"]
  node_availability["Availability"]
  node_booking["Ticket booking<br/>[BookTrains.java]"]
  node_payment["Payment"]
  node_history["Booking history"]
  node_admin_web["Admin workflows<br/>[AdminAddTrain.java]"]
  node_profile["Account management"]
end

subgraph group_services["Application services"]
  node_train_service["Train operations"]
  node_booking_service["Booking operations"]
  node_user_service["User operations"]
end

subgraph group_data["Persistence"]
  node_db_util["JDBC access<br/>[DBUtil.java]"]
  node_oracle[("Oracle database")]
end

subgraph group_domain["Domain and session"]
  node_auth_session["Authentication session<br/>[TrainUtil.java]"]
  node_models["Domain records"]
  node_codes["Roles and responses"]
end

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

node_customer -->|"uses"| node_user_web
node_admin -->|"uses"| node_admin_web
node_user_web -.->|"authenticates"| node_auth_session
node_user_web -->|"searches"| node_search
node_search -->|"queries routes"| node_train_service
node_enquiry -->|"looks up fares"| node_train_service
node_availability -->|"checks trains"| node_train_service
node_booking -->|"creates booking"| node_booking_service
node_booking -->|"checks train"| node_train_service
node_booking -.->|"continues to"| node_payment
node_history -->|"reads history"| node_booking_service
node_admin_web -->|"manages trains"| node_train_service
node_profile -->|"updates profile"| node_user_service
node_user_service -->|"supports login"| node_auth_session
node_train_service -->|"uses JDBC"| node_db_util
node_booking_service -->|"uses JDBC"| node_db_util
node_user_service -->|"uses JDBC"| node_db_util
node_db_util -->|"connects to"| node_oracle
node_train_service -->|"maps trains"| node_models
node_booking_service -->|"maps bookings"| node_models
node_user_service -->|"maps users"| node_models
node_user_service -->|"uses roles"| node_codes

click node_user_web "https://github.com/manjush007/railflow/tree/main/src/com/shashi/servlets"
click node_search "https://github.com/manjush007/railflow/blob/main/src/com/shashi/servlets/TrainBwStn.java"
click node_enquiry "https://github.com/manjush007/railflow/blob/main/src/com/shashi/servlets/FareEnq.java"
click node_availability "https://github.com/manjush007/railflow/blob/main/src/com/shashi/servlets/UserAvailServlet.java"
click node_booking "https://github.com/manjush007/railflow/blob/main/src/com/shashi/servlets/BookTrains.java"
click node_payment "https://github.com/manjush007/railflow/blob/main/src/com/shashi/servlets/BookTrainPayment.java"
click node_history "https://github.com/manjush007/railflow/blob/main/src/com/shashi/servlets/TicketBookingHistory.java"
click node_admin_web "https://github.com/manjush007/railflow/blob/main/src/com/shashi/servlets/AdminAddTrain.java"
click node_profile "https://github.com/manjush007/railflow/blob/main/src/com/shashi/servlets/UpdateUserProfile.java"
click node_train_service "https://github.com/manjush007/railflow/blob/main/src/com/shashi/service/impl/TrainServiceImpl.java"
click node_booking_service "https://github.com/manjush007/railflow/blob/main/src/com/shashi/service/impl/BookingServiceImpl.java"
click node_user_service "https://github.com/manjush007/railflow/blob/main/src/com/shashi/service/impl/UserServiceImpl.java"
click node_auth_session "https://github.com/manjush007/railflow/blob/main/src/com/shashi/utility/TrainUtil.java"
click node_models "https://github.com/manjush007/railflow/tree/main/src/com/shashi/beans"
click node_codes "https://github.com/manjush007/railflow/tree/main/src/com/shashi/constant"
click node_db_util "https://github.com/manjush007/railflow/blob/main/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_user_web,node_search,node_enquiry,node_availability,node_booking,node_payment,node_history,node_admin_web,node_profile toneBlue
class node_train_service,node_booking_service,node_user_service toneAmber
class node_db_util,node_oracle toneMint
class node_auth_session,node_models,node_codes toneRose
class node_customer,node_admin toneIndigo
```

## Components

### Web workflows

- [User workflows](https://github.com/manjush007/railflow/tree/main/src/com/shashi/servlets): `src/com/shashi/servlets`
- [Train search](https://github.com/manjush007/railflow/blob/main/src/com/shashi/servlets/TrainBwStn.java): `src/com/shashi/servlets/TrainBwStn.java`
- [Fare enquiry](https://github.com/manjush007/railflow/blob/main/src/com/shashi/servlets/FareEnq.java): `src/com/shashi/servlets/FareEnq.java`
- [Availability](https://github.com/manjush007/railflow/blob/main/src/com/shashi/servlets/UserAvailServlet.java): `src/com/shashi/servlets/UserAvailServlet.java`
- [Ticket booking](https://github.com/manjush007/railflow/blob/main/src/com/shashi/servlets/BookTrains.java): `src/com/shashi/servlets/BookTrains.java`
- [Payment](https://github.com/manjush007/railflow/blob/main/src/com/shashi/servlets/BookTrainPayment.java): `src/com/shashi/servlets/BookTrainPayment.java`
- [Booking history](https://github.com/manjush007/railflow/blob/main/src/com/shashi/servlets/TicketBookingHistory.java): `src/com/shashi/servlets/TicketBookingHistory.java`
- [Admin workflows](https://github.com/manjush007/railflow/blob/main/src/com/shashi/servlets/AdminAddTrain.java): `src/com/shashi/servlets/AdminAddTrain.java`
- [Account management](https://github.com/manjush007/railflow/blob/main/src/com/shashi/servlets/UpdateUserProfile.java): `src/com/shashi/servlets/UpdateUserProfile.java`

### Application services

- [Train operations](https://github.com/manjush007/railflow/blob/main/src/com/shashi/service/impl/TrainServiceImpl.java): `src/com/shashi/service/impl/TrainServiceImpl.java`
- [Booking operations](https://github.com/manjush007/railflow/blob/main/src/com/shashi/service/impl/BookingServiceImpl.java): `src/com/shashi/service/impl/BookingServiceImpl.java`
- [User operations](https://github.com/manjush007/railflow/blob/main/src/com/shashi/service/impl/UserServiceImpl.java): `src/com/shashi/service/impl/UserServiceImpl.java`

### Persistence

- [JDBC access](https://github.com/manjush007/railflow/blob/main/src/com/shashi/utility/DBUtil.java): `src/com/shashi/utility/DBUtil.java`
- **Oracle database**

### Domain and session

- [Authentication session](https://github.com/manjush007/railflow/blob/main/src/com/shashi/utility/TrainUtil.java): `src/com/shashi/utility/TrainUtil.java`
- [Domain records](https://github.com/manjush007/railflow/tree/main/src/com/shashi/beans): `src/com/shashi/beans`
- [Roles and responses](https://github.com/manjush007/railflow/tree/main/src/com/shashi/constant): `src/com/shashi/constant`

### Other components

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

## Connections

- Customer → User workflows: uses (evidence: `README.md`)
- Administrator → Admin workflows: uses (evidence: `README.md`)
- User workflows → Authentication session: authenticates (evidence: `src/com/shashi/servlets/AdminSearchTrain.java`)
- User workflows → Train search: searches (evidence: `README.md`)
- Train search → Train operations: queries routes (evidence: `src/com/shashi/servlets/TrainBwStn.java`)
- Fare enquiry → Train operations: looks up fares (evidence: `src/com/shashi/servlets/FareEnq.java`)
- Availability → Train operations: checks trains (evidence: `src/com/shashi/servlets/UserAvailServlet.java`)
- Ticket booking → Booking operations: creates booking (evidence: `src/com/shashi/servlets/BookTrains.java`)
- Ticket booking → Train operations: checks train (evidence: `src/com/shashi/servlets/BookTrains.java`)
- Ticket booking → Payment: continues to
- Booking history → Booking operations: reads history (evidence: `src/com/shashi/servlets/TicketBookingHistory.java`)
- Admin workflows → Train operations: manages trains (evidence: `src/com/shashi/servlets/AdminAddTrain.java`)
- Account management → User operations: updates profile (evidence: `src/com/shashi/servlets/UpdateUserProfile.java`)
- User operations → Authentication session: supports login (evidence: `src/com/shashi/utility/TrainUtil.java`)
- Train operations → JDBC access: uses JDBC (evidence: `src/com/shashi/service/impl/TrainServiceImpl.java`)
- Booking operations → JDBC access: uses JDBC (evidence: `src/com/shashi/service/impl/BookingServiceImpl.java`)
- User operations → JDBC access: uses JDBC (evidence: `src/com/shashi/service/impl/UserServiceImpl.java`)
- JDBC access → Oracle database: connects to (evidence: `README.md`)
- Train operations → Domain records: maps trains (evidence: `src/com/shashi/service/impl/TrainServiceImpl.java`)
- Booking operations → Domain records: maps bookings (evidence: `src/com/shashi/service/impl/BookingServiceImpl.java`)
- User operations → Domain records: maps users (evidence: `src/com/shashi/service/impl/UserServiceImpl.java`)
- User operations → Roles and responses: uses roles (evidence: `src/com/shashi/service/impl/UserServiceImpl.java`)
