How adi-tya-dev/rail_setu_sih works
RailSetu is a railway operations platform for maintenance, train and asset visibility, conflict monitoring, simulation, and work-block planning. Users navigate operational views in the frontend; backend API routes serve those views, while the planning pipeline gathers maintenance tasks and available track windows, clusters work, scores packages, and optimizes assignments. A separate simulator-watcher and event-processing path publishes live updates. The source index and excerpts establish the main wiring; several UI-to-API and unsampled feature relationships are therefore left unconnected.
Main entry points: blockPlanning.service.js Block planning pipeline · App.jsx App and navigation · app.js Express API app · changeProcessor.js Change processor
Components 24
Operations UI
- App and navigation
frontend/src/App.jsx - Operations pages
frontend/src/pages - ML planning view
frontend/src/pages/BlockPlanningML.jsx - Railway map
frontend/src/pages/RailwayMap.jsx - Timetable slots
frontend/src/pages/TimetableSlots.jsx - Live event context
frontend/src/contexts/LiveEventsContext.jsx
Backend API
- Express API app
Backend/src/app.js - API route modules
Backend/src/routes - Planning controller
Backend/src/controllers/blockPlanning.controller.js - Integration controller
Backend/src/controllers/integration.controller.js - Operational services
Backend/src/services
Planning and simulation
- Block planning pipeline
Backend/src/services/blockPlanning.service.js - Spatial clustering
Backend/src/algorithms/clusteringEngine.js - Window optimization
Backend/src/algorithms/optimizationEngine.js - ML package scoring
Backend/src/algorithms/mlScoring.engine.js - Simulation and rerouting
Backend/src/algorithms/simulation.engine.js
Live integrations
- Simulator watcher
Backend/src/events/simulatorWatcher.js - Change processor
Backend/src/events/changeProcessor.js - SSE connection manager
Backend/src/events/sseManager.js - Rail system simulators
Backend/src/integration/simulators
Persistence and domain data
- Prisma configuration
Backend/src/config/prisma.js - Planning seed catalog
Backend/src/services/seedData.provider.js - Railway network data
Backend/src/data/railwayNetwork.js
Other components
- Rail operations user
Connections 27
- Rail operations user → App and navigation: uses
- App and navigation → Operations pages: routes to
frontend/src/App.jsx - App and navigation → ML planning view: routes to
frontend/src/App.jsx - App and navigation → Railway map: routes to
frontend/src/App.jsx - App and navigation → Timetable slots: routes to
frontend/src/App.jsx - Express API app → API route modules: mounts
Backend/src/app.js - API route modules → Planning controller: routes to
Backend/src/routes/blockPlanning.routes.js - API route modules → Integration controller: routes to
Backend/src/routes/integration.routes.js - Planning controller → Block planning pipeline: invokes
Backend/src/controllers/blockPlanning.controller.js - Planning controller → Spatial clustering: uses
Backend/src/controllers/blockPlanning.controller.js - Integration controller → Operational services: invokes
Backend/src/controllers/integration.controller.js - Integration controller → SSE connection manager: attaches stream
Backend/src/controllers/integration.controller.js - Block planning pipeline → Spatial clustering: clusters tasks
Backend/src/services/blockPlanning.service.js - Block planning pipeline → Window optimization: optimizes windows
Backend/src/services/blockPlanning.service.js - Block planning pipeline → ML package scoring: scores packages
Backend/src/services/blockPlanning.service.js - Block planning pipeline → Rail system simulators: fetches COA data
Backend/src/services/blockPlanning.service.js - Block planning pipeline → Prisma configuration: reads tasks
Backend/src/services/blockPlanning.service.js - Block planning pipeline → Planning seed catalog: uses fallback data
Backend/src/services/twoHorizonPlanning.service.js - Simulation and rerouting → Railway network data: uses route data
- Simulator watcher → Rail system simulators: polls sources
Backend/src/events/simulatorWatcher.js - Change processor → SSE connection manager: broadcasts events
Backend/src/events/changeProcessor.js - Change processor → Block planning pipeline: updates planning
Backend/src/events/changeProcessor.js - Live event context → Rail operations user: shows live updates
- Simulator watcher → Change processor: emits requests
Backend/server.js - Express API app → Simulator watcher: starts watcher
Backend/server.js - Express API app → Change processor: starts processor
Backend/server.js - Express API app → SSE connection manager: starts heartbeat
Backend/server.js