# mdarnob007/train-ticket architecture

> Architecture diagram of the GitHub repository mdarnob007/train-ticket, 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/mdarnob007/train-ticket
- Repository: https://github.com/mdarnob007/train-ticket

## Overview

This is a hands-on CLI bot for booking Bangladesh Railway e-tickets at release time. The principal workflow starts in `bin/start.py`: establish or reuse a browser session, search for the requested train, obtain its seat layout, choose seats, and use the browser to confirm the selection. Booking stops at the passenger form; payment remains a manual handoff. The graph preserves the API/browser split and the documented login, seat-preference, and OTP capabilities. Some internal links are based on imports and README statements; unsampled implementation details are not inferred.

Main entry points: [`bin/start.py`](https://github.com/mdarnob007/train-ticket/blob/main/bin/start.py) (Booking CLI), [`app/rpa/api_client.py`](https://github.com/mdarnob007/train-ticket/blob/main/app/rpa/api_client.py) (Rail API client), [`app/rpa/session.py`](https://github.com/mdarnob007/train-ticket/blob/main/app/rpa/session.py) (Login and session), [`app/rpa/seat_picker.py`](https://github.com/mdarnob007/train-ticket/blob/main/app/rpa/seat_picker.py) (Seat selection)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_cli["CLI orchestration"]
  node_start["Booking CLI<br/>[start.py]"]
end

subgraph group_session["Browser session"]
  node_session_flow["Login and session<br/>[session.py]"]
  node_driver["Browser driver<br/>[driver.py]"]
  node_otp["OTP entry<br/>[otp.py]"]
end

subgraph group_booking["Trip and seats"]
  node_api_client["Rail API client<br/>[api_client.py]"]
  node_search["Train search<br/>[search.py]"]
  node_layout["Seat layout<br/>[layout.py]"]
  node_seat_picker["Seat selection<br/>[seat_picker.py]"]
  node_reserve["Seat confirmation<br/>[reserve.py]"]
end

subgraph group_models["Configuration and state"]
  node_config["Settings<br/>[config.py]"]
  node_job["Booking state<br/>[job.py]"]
  node_api_defs["API definitions<br/>[apidefs.py]"]
  node_selectors["UI selectors<br/>[selectors.py]"]
end

node_traveler(("Traveler"))
node_railway{{"Railway booking site"}}
node_shohoz{{"Shohoz API"}}
node_passenger["Passenger form"]
node_payment(("Manual payment"))

node_traveler -->|"runs"| node_start
node_start -->|"loads settings"| node_config
node_start -->|"creates run"| node_job
node_start -->|"establishes session"| node_session_flow
node_start -->|"searches trains"| node_search
node_start -->|"loads layout"| node_layout
node_start -->|"chooses seats"| node_seat_picker
node_start -->|"confirms seats"| node_reserve
node_session_flow -->|"uses browser"| node_driver
node_session_flow -->|"uses API"| node_api_client
node_search -->|"requests trips"| node_api_client
node_layout -->|"requests layout"| node_api_client
node_layout -->|"reads seat modal"| node_driver
node_seat_picker -->|"resolves seats"| node_driver
node_reserve -->|"uses selection"| node_seat_picker
node_driver -->|"drives browser"| node_railway
node_api_client -->|"sends API requests"| node_shohoz
node_api_client -->|"uses endpoints"| node_api_defs
node_session_flow -->|"uses locators"| node_selectors
node_search -->|"uses locators"| node_selectors
node_seat_picker -->|"uses locators"| node_selectors
node_reserve -->|"continues to form"| node_passenger
node_traveler -.->|"enters code"| node_otp
node_traveler -->|"fills details"| node_passenger
node_traveler -->|"completes manually"| node_payment

click node_start "https://github.com/mdarnob007/train-ticket/blob/main/bin/start.py"
click node_config "https://github.com/mdarnob007/train-ticket/blob/main/app/config.py"
click node_job "https://github.com/mdarnob007/train-ticket/blob/main/app/models/job.py"
click node_api_defs "https://github.com/mdarnob007/train-ticket/blob/main/app/models/apidefs.py"
click node_selectors "https://github.com/mdarnob007/train-ticket/blob/main/app/models/selectors.py"
click node_session_flow "https://github.com/mdarnob007/train-ticket/blob/main/app/rpa/session.py"
click node_driver "https://github.com/mdarnob007/train-ticket/blob/main/app/rpa/driver.py"
click node_api_client "https://github.com/mdarnob007/train-ticket/blob/main/app/rpa/api_client.py"
click node_search "https://github.com/mdarnob007/train-ticket/blob/main/app/rpa/search.py"
click node_layout "https://github.com/mdarnob007/train-ticket/blob/main/app/rpa/layout.py"
click node_seat_picker "https://github.com/mdarnob007/train-ticket/blob/main/app/rpa/seat_picker.py"
click node_reserve "https://github.com/mdarnob007/train-ticket/blob/main/app/rpa/reserve.py"
click node_otp "https://github.com/mdarnob007/train-ticket/blob/main/app/rpa/otp.py"

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_start toneBlue
class node_session_flow,node_driver,node_otp toneAmber
class node_api_client,node_search,node_layout,node_seat_picker,node_reserve,node_shohoz toneMint
class node_config,node_job,node_api_defs,node_selectors toneRose
class node_traveler,node_railway,node_passenger,node_payment toneIndigo
```

## Components

### CLI orchestration

- [Booking CLI](https://github.com/mdarnob007/train-ticket/blob/main/bin/start.py): `bin/start.py`

### Browser session

- [Login and session](https://github.com/mdarnob007/train-ticket/blob/main/app/rpa/session.py): `app/rpa/session.py`
- [Browser driver](https://github.com/mdarnob007/train-ticket/blob/main/app/rpa/driver.py): `app/rpa/driver.py`
- [OTP entry](https://github.com/mdarnob007/train-ticket/blob/main/app/rpa/otp.py): `app/rpa/otp.py`

### Trip and seats

- [Rail API client](https://github.com/mdarnob007/train-ticket/blob/main/app/rpa/api_client.py): `app/rpa/api_client.py`
- [Train search](https://github.com/mdarnob007/train-ticket/blob/main/app/rpa/search.py): `app/rpa/search.py`
- [Seat layout](https://github.com/mdarnob007/train-ticket/blob/main/app/rpa/layout.py): `app/rpa/layout.py`
- [Seat selection](https://github.com/mdarnob007/train-ticket/blob/main/app/rpa/seat_picker.py): `app/rpa/seat_picker.py`
- [Seat confirmation](https://github.com/mdarnob007/train-ticket/blob/main/app/rpa/reserve.py): `app/rpa/reserve.py`

### Configuration and state

- [Settings](https://github.com/mdarnob007/train-ticket/blob/main/app/config.py): `app/config.py`
- [Booking state](https://github.com/mdarnob007/train-ticket/blob/main/app/models/job.py): `app/models/job.py`
- [API definitions](https://github.com/mdarnob007/train-ticket/blob/main/app/models/apidefs.py): `app/models/apidefs.py`
- [UI selectors](https://github.com/mdarnob007/train-ticket/blob/main/app/models/selectors.py): `app/models/selectors.py`

### Other components

- **Traveler**
- **Railway booking site**
- **Shohoz API**
- **Passenger form**
- **Manual payment**

## Connections

- Traveler → Booking CLI: runs
- Booking CLI → Settings: loads settings (evidence: `bin/start.py`)
- Booking CLI → Booking state: creates run (evidence: `bin/start.py`)
- Booking CLI → Login and session: establishes session (evidence: `bin/start.py`)
- Booking CLI → Train search: searches trains (evidence: `bin/start.py`)
- Booking CLI → Seat layout: loads layout (evidence: `bin/start.py`)
- Booking CLI → Seat selection: chooses seats (evidence: `bin/start.py`)
- Booking CLI → Seat confirmation: confirms seats (evidence: `bin/start.py`)
- Login and session → Browser driver: uses browser (evidence: `app/rpa/session.py`)
- Login and session → Rail API client: uses API (evidence: `app/rpa/session.py`)
- Train search → Rail API client: requests trips (evidence: `app/rpa/search.py`)
- Seat layout → Rail API client: requests layout (evidence: `app/rpa/layout.py`)
- Seat layout → Browser driver: reads seat modal (evidence: `app/rpa/layout.py`)
- Seat selection → Browser driver: resolves seats (evidence: `app/rpa/seat_picker.py`)
- Seat confirmation → Seat selection: uses selection (evidence: `app/rpa/reserve.py`)
- Browser driver → Railway booking site: drives browser
- Rail API client → Shohoz API: sends API requests (evidence: `app/rpa/api_client.py`)
- Rail API client → API definitions: uses endpoints (evidence: `app/rpa/api_client.py`)
- Login and session → UI selectors: uses locators (evidence: `app/rpa/session.py`)
- Train search → UI selectors: uses locators (evidence: `app/rpa/search.py`)
- Seat selection → UI selectors: uses locators (evidence: `app/rpa/seat_picker.py`)
- Seat confirmation → Passenger form: continues to form
- Traveler → OTP entry: enters code
- Traveler → Passenger form: fills details
- Traveler → Manual payment: completes manually
