# mshezan/rail-app architecture

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

- Interactive diagram: https://gitdiagram.com/mshezan/rail-app
- Repository: https://github.com/mshezan/rail-app

## Overview

This appears to be an Android rail application with passenger and control-room screens, train information, scanning, authentication, and local event storage. The supplied material contains only the file tree; no README or runtime source excerpts establish how these components are connected. The graph therefore identifies major components by their source paths but omits unverified relationships and workflow arrows.

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app_ui["App experience"]
  node_main_activity["Activity entry<br/>[MainActivity.kt]"]
  node_main_screen["Main navigation<br/>[MainScreen.kt]"]
  node_passenger_home["Passenger home"]
  node_passenger_home_vm["Home state"]
  node_tracking_ui["Train tracking"]
  node_tracking_vm["Tracking state"]
  node_delays_ui["Passenger delays"]
  node_delays_vm["Delay state"]
  node_control_room["Control room"]
  node_control_vm["Control state"]
  node_event_log["Event log<br/>[EventLogScreen.kt]"]
  node_event_log_vm["Event log state"]
  node_scan_ui["Scan screen<br/>[ScanScreen.kt]"]
  node_scan_vm["Scan state<br/>[ScanViewModel.kt]"]
  node_saved_trains["Saved trains"]
  node_login["Login screen<br/>[LoginScreen.kt]"]
end

subgraph group_rail["Rail information"]
  node_train_models["Train models<br/>[TrainModels.kt]"]
  node_delay_engine["Delay prediction"]
  node_operational_factors["Operational factors"]
  node_pnr_repository["PNR lookup<br/>[PNRRepository.kt]"]
  node_train_status["Train status"]
  node_train_tracking_repo["Tracking repository"]
  node_train_source["Train data source<br/>[TrainDataSource.kt]"]
end

subgraph group_data["Data and sync"]
  node_database[("App database<br/>[AppDatabase.kt]")]
  node_scan_repository["Scan events<br/>[ScanRepository.kt]"]
  node_scan_dao["Scan event DAO<br/>[ScanEventDao.kt]"]
  node_saved_train_dao["Saved train DAO<br/>[SavedTrainDao.kt]"]
  node_sync_manager["Sync manager<br/>[SyncManager.kt]"]
  node_sync_worker["Sync worker<br/>[SyncWorker.kt]"]
end

subgraph group_integrations["Identity and sensors"]
  node_session_manager["Session manager<br/>[SessionManager.kt]"]
  node_rail_api["Rail API integration"]
  node_detection_sensor["Detection sensor<br/>[DetectionSensor.kt]"]
end

node_user(("App user"))

click node_main_activity "https://github.com/mshezan/rail-app/blob/main/app/src/main/java/com/example/railapp/MainActivity.kt"
click node_main_screen "https://github.com/mshezan/rail-app/blob/main/app/src/main/java/com/example/railapp/ui/MainScreen.kt"
click node_passenger_home "https://github.com/mshezan/rail-app/blob/main/app/src/main/java/com/example/railapp/ui/PassengerHomeScreen.kt"
click node_passenger_home_vm "https://github.com/mshezan/rail-app/blob/main/app/src/main/java/com/example/railapp/ui/PassengerHomeViewModel.kt"
click node_tracking_ui "https://github.com/mshezan/rail-app/blob/main/app/src/main/java/com/example/railapp/ui/TrainTrackingScreen.kt"
click node_tracking_vm "https://github.com/mshezan/rail-app/blob/main/app/src/main/java/com/example/railapp/ui/TrainTrackingViewModel.kt"
click node_delays_ui "https://github.com/mshezan/rail-app/blob/main/app/src/main/java/com/example/railapp/ui/PassengerDelaysScreen.kt"
click node_delays_vm "https://github.com/mshezan/rail-app/blob/main/app/src/main/java/com/example/railapp/ui/PassengerDelaysViewModel.kt"
click node_control_room "https://github.com/mshezan/rail-app/blob/main/app/src/main/java/com/example/railapp/ui/ControlRoomScreen.kt"
click node_control_vm "https://github.com/mshezan/rail-app/blob/main/app/src/main/java/com/example/railapp/ui/ControlRoomViewModel.kt"
click node_event_log "https://github.com/mshezan/rail-app/blob/main/app/src/main/java/com/example/railapp/ui/EventLogScreen.kt"
click node_event_log_vm "https://github.com/mshezan/rail-app/blob/main/app/src/main/java/com/example/railapp/ui/EventLogViewModel.kt"
click node_scan_ui "https://github.com/mshezan/rail-app/blob/main/app/src/main/java/com/example/railapp/ui/ScanScreen.kt"
click node_scan_vm "https://github.com/mshezan/rail-app/blob/main/app/src/main/java/com/example/railapp/ui/ScanViewModel.kt"
click node_saved_trains "https://github.com/mshezan/rail-app/blob/main/app/src/main/java/com/example/railapp/ui/SavedTrainsScreen.kt"
click node_train_models "https://github.com/mshezan/rail-app/blob/main/app/src/main/java/com/example/railapp/domain/train/TrainModels.kt"
click node_delay_engine "https://github.com/mshezan/rail-app/blob/main/app/src/main/java/com/example/railapp/domain/train/DelayPredictionEngine.kt"
click node_operational_factors "https://github.com/mshezan/rail-app/blob/main/app/src/main/java/com/example/railapp/domain/train/OperationalFactors.kt"
click node_pnr_repository "https://github.com/mshezan/rail-app/blob/main/app/src/main/java/com/example/railapp/data/train/PNRRepository.kt"
click node_train_status "https://github.com/mshezan/rail-app/blob/main/app/src/main/java/com/example/railapp/data/train/TrainStatusRepository.kt"
click node_train_tracking_repo "https://github.com/mshezan/rail-app/blob/main/app/src/main/java/com/example/railapp/data/train/TrainTrackingRepository.kt"
click node_train_source "https://github.com/mshezan/rail-app/blob/main/app/src/main/java/com/example/railapp/data/train/TrainDataSource.kt"
click node_database "https://github.com/mshezan/rail-app/blob/main/app/src/main/java/com/example/railapp/data/AppDatabase.kt"
click node_scan_repository "https://github.com/mshezan/rail-app/blob/main/app/src/main/java/com/example/railapp/data/ScanRepository.kt"
click node_scan_dao "https://github.com/mshezan/rail-app/blob/main/app/src/main/java/com/example/railapp/data/ScanEventDao.kt"
click node_saved_train_dao "https://github.com/mshezan/rail-app/blob/main/app/src/main/java/com/example/railapp/data/train/SavedTrainDao.kt"
click node_sync_manager "https://github.com/mshezan/rail-app/blob/main/app/src/main/java/com/example/railapp/sync/SyncManager.kt"
click node_sync_worker "https://github.com/mshezan/rail-app/blob/main/app/src/main/java/com/example/railapp/sync/SyncWorker.kt"
click node_session_manager "https://github.com/mshezan/rail-app/blob/main/app/src/main/java/com/example/railapp/auth/SessionManager.kt"
click node_rail_api "https://github.com/mshezan/rail-app/blob/main/app/src/main/java/com/example/railapp/api/RailApiIntegration.kt"
click node_detection_sensor "https://github.com/mshezan/rail-app/blob/main/app/src/main/java/com/example/railapp/sensor/DetectionSensor.kt"
click node_login "https://github.com/mshezan/rail-app/blob/main/app/src/main/java/com/example/railapp/ui/LoginScreen.kt"

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_main_activity,node_main_screen,node_passenger_home,node_passenger_home_vm,node_tracking_ui,node_tracking_vm,node_delays_ui,node_delays_vm,node_control_room,node_control_vm,node_event_log,node_event_log_vm,node_scan_ui,node_scan_vm,node_saved_trains,node_login,node_user toneBlue
class node_train_models,node_delay_engine,node_operational_factors,node_pnr_repository,node_train_status,node_train_tracking_repo,node_train_source toneAmber
class node_database,node_scan_repository,node_scan_dao,node_saved_train_dao,node_sync_manager,node_sync_worker toneMint
class node_session_manager,node_rail_api,node_detection_sensor toneRose
```

## Components

### App experience

- [Activity entry](https://github.com/mshezan/rail-app/blob/main/app/src/main/java/com/example/railapp/MainActivity.kt): `app/src/main/java/com/example/railapp/MainActivity.kt`
- [Main navigation](https://github.com/mshezan/rail-app/blob/main/app/src/main/java/com/example/railapp/ui/MainScreen.kt): `app/src/main/java/com/example/railapp/ui/MainScreen.kt`
- [Passenger home](https://github.com/mshezan/rail-app/blob/main/app/src/main/java/com/example/railapp/ui/PassengerHomeScreen.kt): `app/src/main/java/com/example/railapp/ui/PassengerHomeScreen.kt`
- [Home state](https://github.com/mshezan/rail-app/blob/main/app/src/main/java/com/example/railapp/ui/PassengerHomeViewModel.kt): `app/src/main/java/com/example/railapp/ui/PassengerHomeViewModel.kt`
- [Train tracking](https://github.com/mshezan/rail-app/blob/main/app/src/main/java/com/example/railapp/ui/TrainTrackingScreen.kt): `app/src/main/java/com/example/railapp/ui/TrainTrackingScreen.kt`
- [Tracking state](https://github.com/mshezan/rail-app/blob/main/app/src/main/java/com/example/railapp/ui/TrainTrackingViewModel.kt): `app/src/main/java/com/example/railapp/ui/TrainTrackingViewModel.kt`
- [Passenger delays](https://github.com/mshezan/rail-app/blob/main/app/src/main/java/com/example/railapp/ui/PassengerDelaysScreen.kt): `app/src/main/java/com/example/railapp/ui/PassengerDelaysScreen.kt`
- [Delay state](https://github.com/mshezan/rail-app/blob/main/app/src/main/java/com/example/railapp/ui/PassengerDelaysViewModel.kt): `app/src/main/java/com/example/railapp/ui/PassengerDelaysViewModel.kt`
- [Control room](https://github.com/mshezan/rail-app/blob/main/app/src/main/java/com/example/railapp/ui/ControlRoomScreen.kt): `app/src/main/java/com/example/railapp/ui/ControlRoomScreen.kt`
- [Control state](https://github.com/mshezan/rail-app/blob/main/app/src/main/java/com/example/railapp/ui/ControlRoomViewModel.kt): `app/src/main/java/com/example/railapp/ui/ControlRoomViewModel.kt`
- [Event log](https://github.com/mshezan/rail-app/blob/main/app/src/main/java/com/example/railapp/ui/EventLogScreen.kt): `app/src/main/java/com/example/railapp/ui/EventLogScreen.kt`
- [Event log state](https://github.com/mshezan/rail-app/blob/main/app/src/main/java/com/example/railapp/ui/EventLogViewModel.kt): `app/src/main/java/com/example/railapp/ui/EventLogViewModel.kt`
- [Scan screen](https://github.com/mshezan/rail-app/blob/main/app/src/main/java/com/example/railapp/ui/ScanScreen.kt): `app/src/main/java/com/example/railapp/ui/ScanScreen.kt`
- [Scan state](https://github.com/mshezan/rail-app/blob/main/app/src/main/java/com/example/railapp/ui/ScanViewModel.kt): `app/src/main/java/com/example/railapp/ui/ScanViewModel.kt`
- [Saved trains](https://github.com/mshezan/rail-app/blob/main/app/src/main/java/com/example/railapp/ui/SavedTrainsScreen.kt): `app/src/main/java/com/example/railapp/ui/SavedTrainsScreen.kt`
- [Login screen](https://github.com/mshezan/rail-app/blob/main/app/src/main/java/com/example/railapp/ui/LoginScreen.kt): `app/src/main/java/com/example/railapp/ui/LoginScreen.kt`

### Rail information

- [Train models](https://github.com/mshezan/rail-app/blob/main/app/src/main/java/com/example/railapp/domain/train/TrainModels.kt): `app/src/main/java/com/example/railapp/domain/train/TrainModels.kt`
- [Delay prediction](https://github.com/mshezan/rail-app/blob/main/app/src/main/java/com/example/railapp/domain/train/DelayPredictionEngine.kt): `app/src/main/java/com/example/railapp/domain/train/DelayPredictionEngine.kt`
- [Operational factors](https://github.com/mshezan/rail-app/blob/main/app/src/main/java/com/example/railapp/domain/train/OperationalFactors.kt): `app/src/main/java/com/example/railapp/domain/train/OperationalFactors.kt`
- [PNR lookup](https://github.com/mshezan/rail-app/blob/main/app/src/main/java/com/example/railapp/data/train/PNRRepository.kt): `app/src/main/java/com/example/railapp/data/train/PNRRepository.kt`
- [Train status](https://github.com/mshezan/rail-app/blob/main/app/src/main/java/com/example/railapp/data/train/TrainStatusRepository.kt): `app/src/main/java/com/example/railapp/data/train/TrainStatusRepository.kt`
- [Tracking repository](https://github.com/mshezan/rail-app/blob/main/app/src/main/java/com/example/railapp/data/train/TrainTrackingRepository.kt): `app/src/main/java/com/example/railapp/data/train/TrainTrackingRepository.kt`
- [Train data source](https://github.com/mshezan/rail-app/blob/main/app/src/main/java/com/example/railapp/data/train/TrainDataSource.kt): `app/src/main/java/com/example/railapp/data/train/TrainDataSource.kt`

### Data and sync

- [App database](https://github.com/mshezan/rail-app/blob/main/app/src/main/java/com/example/railapp/data/AppDatabase.kt): `app/src/main/java/com/example/railapp/data/AppDatabase.kt`
- [Scan events](https://github.com/mshezan/rail-app/blob/main/app/src/main/java/com/example/railapp/data/ScanRepository.kt): `app/src/main/java/com/example/railapp/data/ScanRepository.kt`
- [Scan event DAO](https://github.com/mshezan/rail-app/blob/main/app/src/main/java/com/example/railapp/data/ScanEventDao.kt): `app/src/main/java/com/example/railapp/data/ScanEventDao.kt`
- [Saved train DAO](https://github.com/mshezan/rail-app/blob/main/app/src/main/java/com/example/railapp/data/train/SavedTrainDao.kt): `app/src/main/java/com/example/railapp/data/train/SavedTrainDao.kt`
- [Sync manager](https://github.com/mshezan/rail-app/blob/main/app/src/main/java/com/example/railapp/sync/SyncManager.kt): `app/src/main/java/com/example/railapp/sync/SyncManager.kt`
- [Sync worker](https://github.com/mshezan/rail-app/blob/main/app/src/main/java/com/example/railapp/sync/SyncWorker.kt): `app/src/main/java/com/example/railapp/sync/SyncWorker.kt`

### Identity and sensors

- [Session manager](https://github.com/mshezan/rail-app/blob/main/app/src/main/java/com/example/railapp/auth/SessionManager.kt): `app/src/main/java/com/example/railapp/auth/SessionManager.kt`
- [Rail API integration](https://github.com/mshezan/rail-app/blob/main/app/src/main/java/com/example/railapp/api/RailApiIntegration.kt): `app/src/main/java/com/example/railapp/api/RailApiIntegration.kt`
- [Detection sensor](https://github.com/mshezan/rail-app/blob/main/app/src/main/java/com/example/railapp/sensor/DetectionSensor.kt): `app/src/main/java/com/example/railapp/sensor/DetectionSensor.kt`

### Other components

- **App user**
