How raushankumarpandit/railoptima-sih2026 works
RAILOPTIMA is a human-governed railway maintenance decision-support platform. Planners review asset condition, maintenance backlog, and traffic forecasts, request ranked possession windows, then approve or reject recommendations and review decisions and model analytics. The graph includes the React workflow, API/backend boundary, persistence, and documented ML and optimization capabilities. Some backend routes and model wiring were not excerpted; those relationships are shown only where the README documents them.
Main entry points: main.tsx Application shell · api.ts REST client · main.py FastAPI application · optimization_service.py Window optimizer
Components 18
Planner interface
- Application shell
frontend/src/main.tsx - Authentication screen
frontend/src/pages/Login.tsx - Network overview
frontend/src/pages/Dashboard.tsx - Asset intelligence
frontend/src/pages/Assets.tsx - Traffic forecast
frontend/src/pages/Traffic.tsx - Maintenance backlog
frontend/src/pages/Backlog.tsx - Block planner
frontend/src/pages/Planner.tsx - Block decisions
frontend/src/pages/Blocks.tsx - Model analytics
frontend/src/pages/Analytics.tsx - REST client
frontend/src/api.ts
API and domain services
- FastAPI application
backend/main.py
Prediction and scheduling
- Asset prediction models
backend/ml/saved_models - Traffic classifier
backend/ml/saved_models - Window optimizer
backend/optimization/optimization_service.py
Operational data
- Operational models
backend/models/orm.py - SQLite database
backend/database/db.py - Canonical railway data
dataset/canonical_reference
Other components
- Railway planner
Connections 28
- Railway planner → Authentication screen: signs in
README.md - Application shell → Authentication screen: renders
frontend/src/main.tsx - Application shell → Network overview: routes to
frontend/src/main.tsx - Application shell → Block planner: routes to
frontend/src/main.tsx - Application shell → Asset intelligence: routes to
frontend/src/main.tsx - Application shell → Traffic forecast: routes to
frontend/src/main.tsx - Application shell → Maintenance backlog: routes to
frontend/src/main.tsx - Application shell → Block decisions: routes to
frontend/src/main.tsx - Application shell → Model analytics: routes to
frontend/src/main.tsx - Authentication screen → REST client: authenticates through
frontend/src/pages/Login.tsx - Network overview → REST client: requests overview
frontend/src/pages/Dashboard.tsx - Asset intelligence → REST client: requests asset data
frontend/src/pages/Assets.tsx - Traffic forecast → REST client: requests forecasts
frontend/src/pages/Traffic.tsx - Maintenance backlog → REST client: requests backlog
frontend/src/pages/Backlog.tsx - Block planner → REST client: submits planning actions
frontend/src/pages/Planner.tsx - Block decisions → REST client: requests decisions
frontend/src/pages/Blocks.tsx - Model analytics → REST client: requests metrics
frontend/src/pages/Analytics.tsx - REST client → FastAPI application: sends REST requests
README.md - Canonical railway data → FastAPI application: supplies records
README.md - FastAPI application → Operational models: queries and updates
backend/main.py - Operational models → SQLite database: uses ORM base
backend/models/orm.py - FastAPI application → Window optimizer: requests ranked windows
backend/main.py - FastAPI application → Asset prediction models: uses for risk and health
README.md - FastAPI application → Traffic classifier: uses for density forecasts
README.md - Window optimizer → Traffic classifier: forecasts candidate traffic
README.md - Window optimizer → FastAPI application: returns recommendation
README.md - Railway planner → Block planner: reviews and decides
README.md - FastAPI application → SQLite database: persists decisions and feedback
README.md