Replacing archaic paper-based track approvals with a live, interactive map, automated AI path optimization, and instantaneous voice/SMS dispatch protocols.

🚀 The Core Vision

Currently, authorizing a railway maintenance "block" requires a staggering amount of phone calls, physical paper trails, and radio miscommunications. If a train is on an intercept path, the results can be catastrophic. BlockTrain completely digitizes this workflow to remove human error and prioritize human lives.

✨ Platform Features

🗺️ Live Digital Twin A beautifully rendered, fully interactive SVG map of the railway network. Visualizes active trains, maintenance blocks (yellow hazard zones), and station platforms in real-time.	🚂 Physics-Based Kinematics Trains move smoothly across the network using custom mathematical physics hooks, preventing instant teleportation and providing a realistic simulation of network traffic.
🎙️ Emergency Voice Dispatch Click any track to schedule a block and record live emergency audio. Instantly triggers native SMS protocols to blast the custom text and Cloudinary audio link to field workers.	🧠 AI-Powered Rerouting Integrated with Grok AI to analyze blocked tracks, calculate ripple effects, and automatically suggest optimized routing paths to minimize delays.

🏗️ Enterprise Architecture

Our backend employs a strict Domain-Driven Design (DDD), cleanly structured into highly scalable feature modules.

📂 modules/blocks — Maintenance scheduling logic
📂 modules/dispatch — Native SMS, telecom, and Cloudinary media
📂 modules/workers — Personnel and department routing
📂 modules/chatbot — Grok AI analytics and prompting
📂 modules/optimization — Railway pathfinding and kinematic scheduling

🛠️ Getting Started

1. Boot the API Server

cd apps/api
npm install
npm run dev

API mounts on http://localhost:5000

2. Launch the Digital Twin

cd frontend
npm install
npm run dev

Map & Dispatch UI available at http://localhost:3000