Skip to content

suxrobGM/logistics-app

Repository files navigation

LogisticsX

Build Status Deploy CC BY-NC 4.0

AI-first fleet management platform with an autonomous dispatch agent that matches loads to trucks, verifies HOS compliance, optimizes routes, and searches load boards — all with full reasoning transparency. Built for trucking companies on a modern multi-tenant cloud-native architecture with real-time GPS tracking, invoicing, and payroll.

AI Dispatch - Sessions & Decisions

Website Live Demo

Overview

LogisticsX is an AI-first fleet management platform purpose-built for trucking fleets specializing in intermodal containers and vehicle transport. It replaces spreadsheet-based workflows with an end-to-end digital system connecting dispatchers, drivers, and customers through web and mobile applications with real-time synchronization.

The platform is built around its AI dispatch agent — an agentic system that autonomously analyzes fleet state, matches loads to trucks, verifies HOS compliance, optimizes trip routes, and proactively searches load boards for revenue opportunities. It operates in two modes: human-in-the-loop (suggests assignments for dispatcher approval) and fully autonomous (executes decisions in real-time). Every decision is logged with full reasoning transparency, and dispatchers can approve, reject, or re-plan with context.

Dispatchers create loads, assign drivers, search load boards, monitor deliveries in real-time - or let the AI agent handle it. Drivers receive assignments, navigate routes, capture proof of delivery, and communicate with dispatch via the mobile app. Customers track shipments, download documents, and pay invoices through the self-service portal. Owners access financial reports, driver performance metrics, payroll, and operational analytics.

Features

Operations Financial Compliance Communication
AI-powered dispatching Invoicing & Stripe payments ELD / HOS (Samsara, Motive) Real-time messaging
MCP server for AI tools Stripe Connect direct payouts Safety & DVIR inspections Push notifications
Load management & dispatching Payroll & timesheets Document management (POD, BOL) Customer self-service portal
Trip planning & route optimization Expense tracking Role-based access control Driver mobile app
Fleet & maintenance tracking Reports & analytics
Load board integration (DAT, Truckstop)

Complete feature list

Quick Start

Docker with Aspire (Recommended)

dotnet run --project src/Aspire/Logistics.Aspire.AppHost

Dashboard: http://localhost:7100

Manual Setup

See Local Development Guide

Live Demo

Portal URL
TMS Portal tms.logisticsx.app
Customer Portal customer.logisticsx.app

Test Credentials:

Role Email Password
Owner owner@test.com Test12345#
Manager manager1@test.com Test12345#
Dispatcher dispatcher1@test.com Test12345#
Driver driver1@test.com Test12345#
Customer customer1@test.com Test12345#

All test credentials

Tech Stack

Layer Technologies
Backend .NET 10, ASP.NET Core, EF Core, MediatR, SignalR, Duende IdentityServer
Frontend Angular 21, PrimeNG, Tailwind CSS
Mobile Kotlin Multiplatform, Compose Multiplatform
Database PostgreSQL 18
Payments Stripe, Stripe Connect
Infrastructure Docker, .NET Aspire, Nginx, GitHub Actions
Integrations Mapbox, Firebase, Samsara, Motive, DAT, Truckstop, 123Loadboard, Claude API

Applications

App Technology Port
API ASP.NET Core 7000
Identity Server Duende IdentityServer 7001
Admin Portal Angular 7002
TMS Portal Angular 7003
Customer Portal Angular 7004
Website Angular (SSR) 7005
Driver App Kotlin Multiplatform

Architecture

DDD + CQRS with MediatR, multi-tenant with isolated databases per company.

src/
├── Aspire/                  # .NET Aspire orchestration
├── Client/
│   ├── Logistics.Angular/   # Angular workspace (4 apps + shared library)
│   └── Logistics.DriverApp/ # Kotlin Multiplatform mobile
├── Core/                    # Domain, Application (CQRS), Mappings
├── Infrastructure/          # 8 focused projects (Persistence, Payments, etc.)
├── Shared/                  # Cross-cutting: Geo, Identity, Models
└── Presentation/            # API, IdentityServer, DbMigrator

Full architecture docs

Screenshots

AI Dispatch

Sessions & Decisions Agent Timeline
Sessions Timeline

TMS Portal

Dashboard Loads Trips
Dashboard Loads Trips
Fleet Reports Invoicing
Fleet Reports Invoices

Customer Portal

Dashboard Shipment Details
Dashboard Shipment

All screenshots

Documentation

Guide Description
Features Complete feature list
Getting Started Prerequisites, local setup, Docker
Architecture System design, patterns, domain model
API Reference Authentication, endpoints, webhooks
Deployment VPS setup, Docker Compose, Nginx, SSL
AI Dispatch Agentic dispatcher architecture & API
MCP Server Connect Claude Desktop, Cursor & other AI tools to your fleet
Development Backend, Angular, mobile guides

Contributing

Pull requests welcome! Fork, create a feature branch, and submit a PR.

See development guides for coding conventions.

License

Creative Commons Attribution-NonCommercial 4.0

For commercial licensing, contact me.

Contact

Created by Sukhrob Ilyosbekov

About

AI-powered fleet management platform with an agentic dispatcher that autonomously matches loads to trucks, ensures HOS compliance, and optimizes routes. Built for trucking companies.

Topics

Resources

License

Code of conduct

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors