# adhavanmasscoc-maker/railflow-java architecture

> Architecture diagram of the GitHub repository adhavanmasscoc-maker/railflow-java, 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/adhavanmasscoc-maker/railflow-java
- Repository: https://github.com/adhavanmasscoc-maker/railflow-java

## Overview

RailFlow is a railway-operations intelligence product for dispatchers and station staff, combining a multi-view operations interface with railway data, journey search, crowd monitoring, platform recommendations, alerts, and AI assistance. The main user workflow is to inspect operational/network state, search journeys or inspect trains and stations, then use crowd and platform intelligence to support dispatch decisions. The repository also contains Node-based API/AI implementations alongside the documented Java/Spring core. Some backend and UI wiring is unsampled, so uncertain connections are omitted or marked unverified.

Main entry points: [`frontend-react/src/App.jsx`](https://github.com/adhavanmasscoc-maker/railflow-java/blob/main/frontend-react/src/App.jsx) (Operations Views), [`src/main/java/com/railflow/controller/DatasetController.java`](https://github.com/adhavanmasscoc-maker/railflow-java/blob/main/src/main/java/com/railflow/controller/DatasetController.java) (Dataset Operations), [`src/main/java/com/railflow/ingestion/DataIngestionEngine.java`](https://github.com/adhavanmasscoc-maker/railflow-java/blob/main/src/main/java/com/railflow/ingestion/DataIngestionEngine.java) (Data Ingestion), [`frontend-react/src/pages/JourneyPage.jsx`](https://github.com/adhavanmasscoc-maker/railflow-java/blob/main/frontend-react/src/pages/JourneyPage.jsx) (Journey Planner)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Operations UI"]
  node_webapp["Operations Views<br/>[App.jsx]"]
  node_dashboard["Operations Dashboard<br/>[DashboardPage.jsx]"]
  node_journey["Journey Planner<br/>[JourneyPage.jsx]"]
  node_network["Network and Crowd<br/>[NetworkPage.jsx]"]
  node_console["Dispatch Console<br/>[ConsolePage.jsx]"]
  node_directory["Station and Train Views<br/>[StationsPage.jsx]"]
  node_dataquality["Quality and Database Views<br/>[QualityPage.jsx]"]
end

subgraph group_domain["Railway Intelligence"]
  node_routesearch["Route Search"]
  node_ingestion["Data Ingestion"]
  node_datasetapi["Dataset Operations"]
  node_crowdworkers["Crowd and Train Workers"]
end

subgraph group_data["Data and Persistence"]
  node_registry["In-Memory Registries<br/>[DataRegistry.java]"]
  node_stationregistry["Station Registry"]
  node_trainregistry["Train Registry<br/>[TrainRegistry.java]"]
  node_sqldb[("Railway Database")]
  node_schema["Database Schema<br/>[SchemaManager.java]"]
end

subgraph group_integrations["API and AI"]
  node_nodeapi["Node API<br/>[server.js]"]
  node_nodedb[("Node Database<br/>[db.js]")]
  node_ai["AI Copilot Engine"]
  node_aiproviders{{"AI Providers"}}
end

node_dispatcher(("Dispatcher"))
node_commuter(("Commuter"))

node_dispatcher -->|"uses"| node_webapp
node_webapp -->|"routes to"| node_dashboard
node_webapp -->|"routes to"| node_journey
node_webapp -->|"routes to"| node_network
node_webapp -->|"routes to"| node_console
node_webapp -->|"routes to"| node_directory
node_webapp -->|"routes to"| node_dataquality
node_journey -.->|"searches routes"| node_routesearch
node_routesearch -.->|"uses mapping"| node_registry
node_ingestion -->|"writes data"| node_sqldb
node_ingestion -->|"uses schema"| node_schema
node_datasetapi -->|"reads stations"| node_stationregistry
node_datasetapi -->|"reads trains"| node_trainregistry
node_datasetapi -.->|"queries records"| node_sqldb
node_crowdworkers -.->|"scheduled updates"| node_registry
node_nodeapi -->|"configures database"| node_nodedb
node_ai -->|"queries providers"| node_aiproviders
node_commuter -->|"uses portal"| node_webapp

click node_webapp "https://github.com/adhavanmasscoc-maker/railflow-java/blob/main/frontend-react/src/App.jsx"
click node_dashboard "https://github.com/adhavanmasscoc-maker/railflow-java/blob/main/frontend-react/src/pages/DashboardPage.jsx"
click node_journey "https://github.com/adhavanmasscoc-maker/railflow-java/blob/main/frontend-react/src/pages/JourneyPage.jsx"
click node_network "https://github.com/adhavanmasscoc-maker/railflow-java/blob/main/frontend-react/src/pages/NetworkPage.jsx"
click node_console "https://github.com/adhavanmasscoc-maker/railflow-java/blob/main/frontend-react/src/pages/ConsolePage.jsx"
click node_directory "https://github.com/adhavanmasscoc-maker/railflow-java/blob/main/frontend-react/src/pages/StationsPage.jsx"
click node_dataquality "https://github.com/adhavanmasscoc-maker/railflow-java/blob/main/frontend-react/src/pages/QualityPage.jsx"
click node_routesearch "https://github.com/adhavanmasscoc-maker/railflow-java/blob/main/src/main/java/com/railflow/service/RouteSearchService.java"
click node_ingestion "https://github.com/adhavanmasscoc-maker/railflow-java/blob/main/src/main/java/com/railflow/ingestion/DataIngestionEngine.java"
click node_datasetapi "https://github.com/adhavanmasscoc-maker/railflow-java/blob/main/src/main/java/com/railflow/controller/DatasetController.java"
click node_crowdworkers "https://github.com/adhavanmasscoc-maker/railflow-java/blob/main/src/main/java/com/railflow/concurrency/ThreadPoolManager.java"
click node_registry "https://github.com/adhavanmasscoc-maker/railflow-java/blob/main/src/main/java/com/railflow/collection/DataRegistry.java"
click node_stationregistry "https://github.com/adhavanmasscoc-maker/railflow-java/blob/main/src/main/java/com/railflow/collection/StationRegistry.java"
click node_trainregistry "https://github.com/adhavanmasscoc-maker/railflow-java/blob/main/src/main/java/com/railflow/collection/TrainRegistry.java"
click node_sqldb "https://github.com/adhavanmasscoc-maker/railflow-java/blob/main/src/main/java/com/railflow/database/DatabaseManager.java"
click node_schema "https://github.com/adhavanmasscoc-maker/railflow-java/blob/main/src/main/java/com/railflow/database/SchemaManager.java"
click node_nodeapi "https://github.com/adhavanmasscoc-maker/railflow-java/blob/main/backend/server.js"
click node_nodedb "https://github.com/adhavanmasscoc-maker/railflow-java/blob/main/backend/database/db.js"
click node_ai "https://github.com/adhavanmasscoc-maker/railflow-java/blob/main/railflow_ai_engine.js"

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_webapp,node_dashboard,node_journey,node_network,node_console,node_directory,node_dataquality toneBlue
class node_routesearch,node_ingestion,node_datasetapi,node_crowdworkers toneAmber
class node_registry,node_stationregistry,node_trainregistry,node_sqldb,node_schema toneMint
class node_nodeapi,node_nodedb,node_ai,node_aiproviders toneRose
class node_dispatcher,node_commuter toneIndigo
```

## Components

### Operations UI

- [Operations Views](https://github.com/adhavanmasscoc-maker/railflow-java/blob/main/frontend-react/src/App.jsx): `frontend-react/src/App.jsx`
- [Operations Dashboard](https://github.com/adhavanmasscoc-maker/railflow-java/blob/main/frontend-react/src/pages/DashboardPage.jsx): `frontend-react/src/pages/DashboardPage.jsx`
- [Journey Planner](https://github.com/adhavanmasscoc-maker/railflow-java/blob/main/frontend-react/src/pages/JourneyPage.jsx): `frontend-react/src/pages/JourneyPage.jsx`
- [Network and Crowd](https://github.com/adhavanmasscoc-maker/railflow-java/blob/main/frontend-react/src/pages/NetworkPage.jsx): `frontend-react/src/pages/NetworkPage.jsx`
- [Dispatch Console](https://github.com/adhavanmasscoc-maker/railflow-java/blob/main/frontend-react/src/pages/ConsolePage.jsx): `frontend-react/src/pages/ConsolePage.jsx`
- [Station and Train Views](https://github.com/adhavanmasscoc-maker/railflow-java/blob/main/frontend-react/src/pages/StationsPage.jsx): `frontend-react/src/pages/StationsPage.jsx`
- [Quality and Database Views](https://github.com/adhavanmasscoc-maker/railflow-java/blob/main/frontend-react/src/pages/QualityPage.jsx): `frontend-react/src/pages/QualityPage.jsx`

### Railway Intelligence

- [Route Search](https://github.com/adhavanmasscoc-maker/railflow-java/blob/main/src/main/java/com/railflow/service/RouteSearchService.java): `src/main/java/com/railflow/service/RouteSearchService.java`
- [Data Ingestion](https://github.com/adhavanmasscoc-maker/railflow-java/blob/main/src/main/java/com/railflow/ingestion/DataIngestionEngine.java): `src/main/java/com/railflow/ingestion/DataIngestionEngine.java`
- [Dataset Operations](https://github.com/adhavanmasscoc-maker/railflow-java/blob/main/src/main/java/com/railflow/controller/DatasetController.java): `src/main/java/com/railflow/controller/DatasetController.java`
- [Crowd and Train Workers](https://github.com/adhavanmasscoc-maker/railflow-java/blob/main/src/main/java/com/railflow/concurrency/ThreadPoolManager.java): `src/main/java/com/railflow/concurrency/ThreadPoolManager.java`

### Data and Persistence

- [In-Memory Registries](https://github.com/adhavanmasscoc-maker/railflow-java/blob/main/src/main/java/com/railflow/collection/DataRegistry.java): `src/main/java/com/railflow/collection/DataRegistry.java`
- [Station Registry](https://github.com/adhavanmasscoc-maker/railflow-java/blob/main/src/main/java/com/railflow/collection/StationRegistry.java): `src/main/java/com/railflow/collection/StationRegistry.java`
- [Train Registry](https://github.com/adhavanmasscoc-maker/railflow-java/blob/main/src/main/java/com/railflow/collection/TrainRegistry.java): `src/main/java/com/railflow/collection/TrainRegistry.java`
- [Railway Database](https://github.com/adhavanmasscoc-maker/railflow-java/blob/main/src/main/java/com/railflow/database/DatabaseManager.java): `src/main/java/com/railflow/database/DatabaseManager.java`
- [Database Schema](https://github.com/adhavanmasscoc-maker/railflow-java/blob/main/src/main/java/com/railflow/database/SchemaManager.java): `src/main/java/com/railflow/database/SchemaManager.java`

### API and AI

- [Node API](https://github.com/adhavanmasscoc-maker/railflow-java/blob/main/backend/server.js): `backend/server.js`
- [Node Database](https://github.com/adhavanmasscoc-maker/railflow-java/blob/main/backend/database/db.js): `backend/database/db.js`
- [AI Copilot Engine](https://github.com/adhavanmasscoc-maker/railflow-java/blob/main/railflow_ai_engine.js): `railflow_ai_engine.js`
- **AI Providers**

### Other components

- **Dispatcher**
- **Commuter**

## Connections

- Dispatcher → Operations Views: uses (evidence: `README.md`)
- Operations Views → Operations Dashboard: routes to (evidence: `frontend-react/src/App.jsx`)
- Operations Views → Journey Planner: routes to (evidence: `frontend-react/src/App.jsx`)
- Operations Views → Network and Crowd: routes to (evidence: `frontend-react/src/App.jsx`)
- Operations Views → Dispatch Console: routes to (evidence: `frontend-react/src/App.jsx`)
- Operations Views → Station and Train Views: routes to (evidence: `frontend-react/src/App.jsx`)
- Operations Views → Quality and Database Views: routes to (evidence: `frontend-react/src/App.jsx`)
- Journey Planner → Route Search: searches routes
- Route Search → In-Memory Registries: uses mapping
- Data Ingestion → Railway Database: writes data (evidence: `src/main/java/com/railflow/ingestion/DataIngestionEngine.java`)
- Data Ingestion → Database Schema: uses schema (evidence: `src/main/java/com/railflow/ingestion/DataIngestionEngine.java`)
- Dataset Operations → Station Registry: reads stations (evidence: `src/main/java/com/railflow/controller/DatasetController.java`)
- Dataset Operations → Train Registry: reads trains (evidence: `src/main/java/com/railflow/controller/DatasetController.java`)
- Dataset Operations → Railway Database: queries records
- Crowd and Train Workers → In-Memory Registries: scheduled updates
- Node API → Node Database: configures database (evidence: `backend/server.js`)
- AI Copilot Engine → AI Providers: queries providers (evidence: `railflow_ai_engine.js`)
- Commuter → Operations Views: uses portal (evidence: `README.md`)
