KB

HOS Trip Planner

In the trucking industry, Hours of Service (HOS) violations can cost thousands in fines and endanger driver safety. Manual compliance planning is time-consuming, error-prone, and creates anxiety for drivers who must navigate complex federal regulations while optimizing their routes. I built a full-stack compliance platform that transforms this challenge into a seamless experience....

    Tech Stack

    1. Backend: Django + Django REST Framework
    2. Frontend: React + TypeScript + Vite
    3. Database: PostgreSQL
    4. Maps & Routing: OpenStreetMap + Leaflet.js + OpenRouteService
    5. Infrastructure: Docker + Docker Compose

Live Site

Github

Project picture

    Core Features:

  • Intelligent HOS Compliance Engine
  • Automatically calculates and enforces DOT regulations, inserting required breaks and rest periods while providing real-time compliance scoring for every trip.

  • Smart Route Optimization
  • Generates truck-specific routes that factor in HOS status, vehicle restrictions, and optimal break locations, ensuring both efficiency and compliance.

  • One-Click ELD Log Generation
  • Transforms completed trips into DOT-compliant Electronic Logging Device records, eliminating hours of manual paperwork.

  • Driver-Centric Trip Planning
  • Mobile-first interface with address autocomplete, vehicle pre-selection, and current HOS status display—reducing planning time by 90%.

  • Real-Time Violation Prevention
  • Proactively alerts drivers before violations occur with visual indicators.

  • Fleet Management Dashboard
  • Comprehensive Django admin interface for monitoring compliance, reviewing trips, and generating regulatory reports.

  • Multi-Day Trip Support
  • Handles complex long-haul routes with automatic 10-hour reset calculations and day-by-day compliance validation.

Why The Web Stack

  • I chose Django for its robust authentication system and built-in admin interface, crucial for fleet management oversight. The Django REST Framework provided powerful serialization and permission controls essential for our driver-centric API design. This combination gave me enterprise-grade security with JWT authentication while maintaining rapid development velocity.
  • React
  • TypeScript was non-negotiable i needed to reduce runtime errors during development, while Vite's lightning-fast HMR kept development cycle efficient.
  • Django
  • PostgreSQL's JSONB support was critical for storing complex compliance reports and route data. Its robust transaction handling ensures data integrity when calculating multi-day trips with interdependent HOS periods. The advanced indexing capabilities significantly improved query performance for trip history searches.
  • PostgreSQL
  • I deliberately chose open-source mapping solutions to control costs. React-Leaflet provided the interactive mapping experience drivers expect.
  • Docker
Hos periods section picture
Hos dashboard image
Hos maps section image

Challenges & Solutions

Challenge: Making Complex Regulations Simple

Solution: I built a modular compliance engine where each rule operates independently before combining results. This approach allowed us to test edge cases systematically while keeping the code maintainable. The system thinks like an experienced driver—automatically inserting breaks at optimal times and warning about upcoming violations before they happen.

Hos trips page image

Lessons Learned

Coming into this project with zero trucking experience, I had to become a student of the industry. I spent weeks studying DOT handbooks, analyzing real driver logs, reading documents and watching youtube videos to understand not just what the rules were, but why they existed and how drivers actually applied them. I learned that the "11-hour driving limit" wasn"t just a number, it interacted with the 14-hour on-duty window, 30-minute break requirements, and 70-hour weekly limits in complex ways that varied by situation....

Other Projects

Askai project landing page image

Askai

This is a simple web app that utilizes OpenAI models like GPT-3.5 Turbo, a powerful text generation model that generates responses based on given prompts. Additionally, the app integrates the DALL-E 3 model, an image generation model that creates images according to the descriptions provided.

Mizviv Hairs Online-store image

Mizviv Hairs Online-store

Online E-commerce platform for wigs, and hair products.

Let’s Build Together

Feel free to reach to me if you are looking for a developer or maybe you just want to connect.

ken.bassey9@gmail.com