How kevinjosh10/block-train works
BlockTrain coordinates railway maintenance planning across departmental tasks, track-block windows, prioritization, schedule optimization, and field dispatch. The principal workflow is task and block data entering the API, priority scoring and coordinated schedule generation, then plan review and worker notification. The repository also includes a digital-twin operations dashboard, incident and AI-analysis capabilities, and worker/block management. The README describes ML inference and field artifacts, but sampled wiring does not establish how those capabilities connect to the runtime API; those links are omitted.
Main entry points: app.js API routing · db.js PostgreSQL access · page.tsx Operations UI · tasks.js Task management
Components 25
Operations dashboard
- Operations UI
frontend/src/app/rbms/page.tsx - AI planner UI
frontend/src/app/ai-planner/page.tsx - Digital twin
frontend/src/components/train/LiveTrains.tsx
API and access
- API routing
apps/api/src/app.js - Authentication
apps/api/src/core/middleware/auth.js - Role controls
apps/api/src/core/middleware/rbac.js
Maintenance planning
- Task management
apps/api/src/routes/tasks.js - Task prioritization
apps/api/src/modules/optimization/priority.service.js - Schedule optimization
apps/api/src/modules/optimization/optimizer.service.js - Optimization endpoints
apps/api/src/modules/optimization/optimization.routes.js - Plan management
apps/api/src/routes/plans.js
Operations and dispatch
- Incident reporting
apps/api/src/routes/incidents.js - Active blocks
apps/api/src/modules/blocks/block.controller.js - Worker directory
apps/api/src/modules/workers/worker.controller.js - Worker dispatch
apps/api/src/modules/dispatch/dispatch.controller.js - AI analysis
apps/api/src/modules/chatbot/chatbot.routes.js - Audio storage
apps/api/src/modules/dispatch/cloudinary.service.js
State and simulation
- Train physics
frontend/src/lib/hooks/useTrainPhysics.ts - Corridor model
frontend/src/lib/stations.ts - Client state
frontend/src/lib/store.ts - PostgreSQL access
apps/api/src/core/db.js - Audit logging
apps/api/src/core/services/auditService.js
Other components
- Rail staff
- SMS and voice
- Python inference
model_implementation/scripts/ai_inference_service.py
Connections 34
- Rail staff → Operations UI: uses
frontend/src/app/rbms/page.tsx - Rail staff → AI planner UI: plans with
frontend/src/app/ai-planner/page.tsx - Operations UI → Client state: reads state
frontend/src/app/rbms/page.tsx - Operations UI → Corridor model: renders corridor
frontend/src/app/rbms/page.tsx - Operations UI → AI analysis: uses chatbot
frontend/src/app/rbms/page.tsx - Operations UI → Digital twin: shows trains
- Digital twin → Train physics: simulates
- Train physics → Corridor model: reads stations
frontend/src/lib/hooks/useTrainPhysics.ts - Train physics → Client state: reads state
frontend/src/lib/hooks/useTrainPhysics.ts - API routing → Authentication: applies
apps/api/src/app.js - API routing → Role controls: applies
apps/api/src/app.js - API routing → Task management: routes requests
apps/api/src/app.js - API routing → Optimization endpoints: routes requests
apps/api/src/app.js - API routing → Incident reporting: routes requests
apps/api/src/app.js - API routing → Plan management: routes requests
apps/api/src/app.js - API routing → Active blocks: routes requests
apps/api/src/app.js - API routing → Worker directory: routes requests
apps/api/src/app.js - API routing → Worker dispatch: routes requests
apps/api/src/app.js - API routing → AI analysis: routes requests
apps/api/src/app.js - Task management → PostgreSQL access: reads and writes
apps/api/src/routes/tasks.js - Task management → Task prioritization: scores tasks
apps/api/src/routes/tasks.js - Task management → Audit logging: logs changes
apps/api/src/routes/tasks.js - Optimization endpoints → PostgreSQL access: loads planning data
apps/api/src/modules/optimization/optimization.routes.js - Optimization endpoints → Task prioritization: calculates priority
apps/api/src/modules/optimization/optimization.routes.js - Optimization endpoints → Schedule optimization: runs optimizer
apps/api/src/modules/optimization/optimization.routes.js - Schedule optimization → PostgreSQL access: reads and saves
apps/api/src/modules/optimization/optimizer.service.js - Schedule optimization → Task prioritization: uses scores
apps/api/src/modules/optimization/optimizer.service.js - Schedule optimization → Audit logging: records activity
apps/api/src/modules/optimization/optimizer.service.js - Active blocks → PostgreSQL access: via service
- Worker directory → PostgreSQL access: via service
- Worker dispatch → PostgreSQL access: finds workers
apps/api/src/modules/dispatch/dispatch.controller.js - Worker dispatch → Audio storage: uploads audio
apps/api/src/modules/dispatch/dispatch.controller.js - Worker dispatch → SMS and voice: notifies workers
- AI analysis → Python inference: may invoke