How adhavanmasscoc-maker/railflow-java works
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: App.jsx Operations Views · DatasetController.java Dataset Operations · DataIngestionEngine.java Data Ingestion · JourneyPage.jsx Journey Planner
Components 22
Operations UI
- Operations Views
frontend-react/src/App.jsx - Operations Dashboard
frontend-react/src/pages/DashboardPage.jsx - Journey Planner
frontend-react/src/pages/JourneyPage.jsx - Network and Crowd
frontend-react/src/pages/NetworkPage.jsx - Dispatch Console
frontend-react/src/pages/ConsolePage.jsx - Station and Train Views
frontend-react/src/pages/StationsPage.jsx - Quality and Database Views
frontend-react/src/pages/QualityPage.jsx
Railway Intelligence
- Route Search
src/main/java/com/railflow/service/RouteSearchService.java - Data Ingestion
src/main/java/com/railflow/ingestion/DataIngestionEngine.java - Dataset Operations
src/main/java/com/railflow/controller/DatasetController.java - Crowd and Train Workers
src/main/java/com/railflow/concurrency/ThreadPoolManager.java
Data and Persistence
- In-Memory Registries
src/main/java/com/railflow/collection/DataRegistry.java - Station Registry
src/main/java/com/railflow/collection/StationRegistry.java - Train Registry
src/main/java/com/railflow/collection/TrainRegistry.java - Railway Database
src/main/java/com/railflow/database/DatabaseManager.java - Database Schema
src/main/java/com/railflow/database/SchemaManager.java
API and AI
- Node API
backend/server.js - Node Database
backend/database/db.js - AI Copilot Engine
railflow_ai_engine.js - AI Providers
Other components
- Dispatcher
- Commuter
Connections 18
- Dispatcher → Operations Views: uses
README.md - Operations Views → Operations Dashboard: routes to
frontend-react/src/App.jsx - Operations Views → Journey Planner: routes to
frontend-react/src/App.jsx - Operations Views → Network and Crowd: routes to
frontend-react/src/App.jsx - Operations Views → Dispatch Console: routes to
frontend-react/src/App.jsx - Operations Views → Station and Train Views: routes to
frontend-react/src/App.jsx - Operations Views → Quality and Database Views: routes to
frontend-react/src/App.jsx - Journey Planner → Route Search: searches routes
- Route Search → In-Memory Registries: uses mapping
- Data Ingestion → Railway Database: writes data
src/main/java/com/railflow/ingestion/DataIngestionEngine.java - Data Ingestion → Database Schema: uses schema
src/main/java/com/railflow/ingestion/DataIngestionEngine.java - Dataset Operations → Station Registry: reads stations
src/main/java/com/railflow/controller/DatasetController.java - Dataset Operations → Train Registry: reads trains
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
backend/server.js - AI Copilot Engine → AI Providers: queries providers
railflow_ai_engine.js - Commuter → Operations Views: uses portal
README.md