TruckRoute Planner — GIS & HOS Compliance Platform

An enterprise-grade commercial fleet route optimization and Electronic Logging Device (ELD) compliance platform built for long-haul truck dispatchers and drivers under US FMCSA regulations. Powered by PostGIS spatial queries, automated fuel stop recommendations based on tank capacity and fuel prices, and a 24-hour daily ELD grid log generator.

View GitHub repo

Full-Stack GIS Specialist
Backend & Django Engineer
HOS Compliance Architect
PostGIS Spatial Developer

Live GIS Fleet Mapping & Spatial Engine

PostGIS-powered spatial mapping with real-time driver tracking, waypoint overlays, toll calculation, and dynamic route optimization.

TruckRoute Planner Live GIS Map & Fleet Tracking Interface

FMCSA Hours of Service (HOS) Engine

The platform enforces strict Federal Motor Carrier Safety Administration (FMCSA) property-carrying driver rules via a robust duty state machine.

Tracks the 11-hour driving limit, 14-hour duty window, 30-minute mandatory break, 70-hour / 8-day rolling cycle limits, and applies 34-hour off-duty restarts automatically.

Duty State Machine Rules

• 11-Hour Driving Limit: Max driving window after 10 consecutive hours off duty.
• 14-Hour Duty Window: Strict driving cutoff 14 hours after coming on duty.
• 30-Minute Break Enforcement: Mandates rest after 8 cumulative driving hours.
• 34-Hour Cycle Restart: Auto-detects 34 consecutive off-duty hours to reset 70h cycle.

Core Platform Mechanics

Spatial Route Optimization

PostGIS distance queries (SRID 4326), multi-waypoint sequencing (pickups, deliveries, rest stops), and toll avoidance options.

Intelligent Fuel Stop Generator

Calculates optimal fuel stops based on truck tank size, real-time diesel price feeds, and driver brand preferences (Love's, Pilot, TA).

Automated 24-Hour ELD Log Generator

Generates 1440-minute daily log sheets automatically with odometer verification, engine hours tracking, and cryptographic signature validation.

Fleet Dispatcher Command Center

Dispatcher-level portal for managing active loads, assigning driver routes, monitoring HOS duty clocks, and managing fleet compliance.

Interactive Application Showcase Gallery

Explore the long-haul driver experience, dispatcher portals, and admin management dashboards.

Public Landing Portal

High-converting showcase highlighting route optimization and ELD compliance features.

Authentication & Portal Access

Role-based JWT access for Drivers, Dispatchers, and Fleet Managers.

Driver Live Dashboard

Real-time HOS duty clocks, remaining driving window, active trip map, and metrics.

Active Trip View

Interactive multi-stop navigation with automated fuel stop recommendations.

Driver Trips Portal

Complete trip history filtered by status (Planned, In Progress, Completed, Cancelled).

Dispatcher Load Directory

Dispatcher overview for managing active loads and assigning driver routes.

Admin Control Panel

Fleet analytics, compliance summaries, user management, and system logs.

Truck Preferences & Settings

Customizable truck parameters (fuel capacity, toll avoidance, max driving hours).

Technology Stack & Infrastructure Specs

Backend Core	Python 3.11, Django 4.2 LTS, Django REST Framework (DRF)
Geospatial GIS Engine	GeoDjango (`django.contrib.gis`), PostGIS (PostgreSQL 15 + Spatial Extensions 3.3), GDAL, GEOS, PROJ
Background & Caching	Celery 5.x, Celery Beat (Periodic HOS resets), Redis 7 Broker & Cache
Frontend Stack	React 19, TypeScript 5.8, Vite 7, TailwindCSS 3.4, HeroUI, Radix UI Primitives, Lucide Icons
State & Maps	Zustand, `@tanstack/react-query` v5, Mapbox GL JS / React Map GL, Google Maps JS API
DevOps & Containerization	Docker Multi-stage builds, Docker Compose, Nginx Reverse Proxy & Static Server