🚛 Asset Dispatch TMS System Documentation

Comprehensive Developer & User Guide

Version 1.1 | Last Updated: May 2026

📋 System Overview

Asset Dispatch TMS (Transportation Management System) is a comprehensive fleet management and logistics platform designed for trucking companies. The system provides role-based access control with three main user types:

🔐 Super Admin

System-wide administration, tenant management, and platform configuration

👔 Carrier Admin

Company-level management including fleet, drivers, loads, and operations

🚗 Driver

Mobile-first interface for load management, ELD compliance, and communication

Key System Features

📝 Changelog & Version Fixes

Recent updates and bug fixes

Version 1.1 - May 2026

🆕 New Features

  • HOS Status Integration: Added Hours of Service status display in Drivers Management, showing real-time HOS data from Samsara API integration
  • Delete Writeups: Implemented delete function for writeups with beautiful modal confirmation dialog
  • Delete Fines: Implemented delete function for fines with modal confirmation dialog
  • Email Validation: Added real-time email validation when creating users to check if email is already taken, with button disable and warning message

🐛 Bug Fixes

  • Sidebar Overflow: Fixed "Powered by: Asset Nexus Technology" text overflow by 0.3 pixels when sidebar is resized
  • Delete Fine PHP: Fixed 500 Internal Server Error in delete-fine.php by correcting mysqli constructor parameter order and adding proper integer casting for fine_id
  • Database Connection: Added proper database credentials (db_name, db_user, db_pass, db_host) to delete endpoints to resolve connection errors

🎨 UI/UX Improvements

  • Applied Blue Green branding throughout the system documentation
  • Added loading indicator when checking email availability
  • Added warning icon and message when email is already taken
  • Improved modal confirmation dialogs with better styling and responsive design

Version 1.0 - April 2026

🚀 Initial Release

  • Complete multi-tenant TMS system with Super Admin, Carrier Admin, and Driver roles
  • Comprehensive fleet management, load management, and compliance features
  • ELD integrations with Samsara, OTR Solutions, and GoMotive
  • Load board integration with DAT, TruckStop, and Asset Nexus
  • Full accounting, billing, and payroll management

🔐 Super Admin Features

SUPER ADMIN Full system administration capabilities

Core Modules

Carrier Management

Create, edit, and manage carrier companies

  • Company profile management
  • Database provisioning
  • Subscription management
  • Feature access control

User Management

System-wide user administration

  • Create/edit users
  • Role assignment
  • Access control
  • Activity monitoring

Tenant Operations

Manage tenant databases and operations

  • Database management
  • Schema migrations
  • Data backup/restore
  • Performance monitoring

System Analytics

Platform-wide analytics and reporting

  • Usage statistics
  • Revenue tracking
  • Performance metrics
  • Tenant activity

Migration Management

Database schema and data migrations

  • Schema updates
  • Data migrations
  • Version control
  • Rollback support

System Settings

Global system configuration

  • Feature flags
  • API configurations
  • Email templates
  • System parameters

👔 Carrier Admin Features

CARRIER ADMIN Company-level management and operations

Dashboard & Analytics

Carrier Dashboard

  • Real-time overview of company operations
  • Active loads tracking
  • Driver status monitoring
  • Revenue metrics
  • Fleet utilization
  • Enhanced dashboard with charts

Dispatcher Dashboard

  • Dispatch-specific view
  • Load assignment overview
  • Driver availability
  • Route planning tools

Analytics

  • Performance analytics
  • Operational metrics
  • Custom reports
  • Data visualization

Activity Timeline

  • View system activity
  • Filter by user/action
  • Activity history
  • Audit trail

Fleet Management

Truck Management

  • Add/edit/delete trucks
  • Sync vehicles from ELD systems
  • Track maintenance schedules
  • Monitor vehicle status

Trailer Management

  • Trailer inventory management
  • Trailer assignment
  • Maintenance tracking
  • Inspection records

Vehicle Management

  • Vehicle fleet oversight
  • Vehicle status monitoring
  • Document management
  • Registration tracking

Truck Assignment

  • Assign trucks to drivers
  • Manage truck-driver relationships
  • Track assignment history

Vehicle Monitoring

  • Real-time vehicle tracking
  • Safety events monitoring
  • Vehicle statistics
  • GoMotive integration

Driver Management

Driver Management

  • Driver profiles and documents
  • License and certification tracking
  • Performance monitoring
  • Hours of Service (HOS) compliance
  • Real-time HOS Status display from Samsara API

Driver Profiles

  • Driver profile management
  • Document uploads
  • Certification tracking
  • Performance history

Driver Compliance

  • Writeups management with delete functionality
  • Fines management with delete functionality
  • Tickets tracking
  • Warnings management
  • Inspections management
  • Compliance templates
  • Compliance dashboard
  • Assessment management

Recruitment

  • Driver recruitment pipeline
  • Application management
  • Hiring workflow
  • Onboarding tracking

Load & Dispatch Management

Load Management

  • Create and manage loads
  • Load assignment to drivers
  • Status tracking
  • Document management (BOL, POD)
  • Real-time load tracking
  • Order load handling
  • Suggested loads

Load Board Integration

  • DAT Load Board
  • TruckStop Load Board
  • Asset Nexus Load Board
  • Search and filter loads

Dispatch Scheduling

  • Route planning
  • Driver dispatch
  • ETA tracking
  • Multi-stop routing
  • Route feasibility analysis
  • Schedule management

ETA Tracking

  • Real-time ETA monitoring
  • Delivery predictions
  • Delay alerts
  • Route updates

Financial Management

Accounting Management

  • Chart of Accounts
  • Journal Entries
  • General Ledger
  • Trial Balance
  • Payees management
  • Expenses tracking
  • Accounts Payable
  • Financial Statements

Billing

  • Customer invoicing
  • Accounts receivable
  • Payment tracking
  • Billing management

Factoring

  • Factoring company management
  • Factoring portal integration
  • Invoice factoring
  • Settled bills
  • Account receivables
  • Factoring dashboard

Fuel Cards

  • Fuel card management
  • Card assignment
  • Transaction tracking

Fuel Management

  • Fuel tracking
  • Fuel efficiency monitoring
  • Cost analysis
  • Fuel management screen

Settlement

  • Driver settlement management
  • Pay calculations
  • Deductions tracking

Payroll

  • Payroll management
  • Driver pay calculations
  • Deductions management
  • Pay statements

Loan Management

  • Loan tracking
  • Payment schedules
  • Loan management dashboard

Compliance & Safety

Safety Compliance

  • DOT compliance tracking
  • Safety assessments
  • Incident reporting
  • Drug & alcohol testing
  • Training records
  • Compliance checklists
  • Emergency monitoring
  • Compliance software options

ELD Management

  • ELD token management
  • Samsara ELD integration
  • GoMotive ELD integration
  • ELD configuration
  • ELD devices management

IFTA Management

  • IFTA reports
  • IFTA management
  • Jurisdiction tracking
  • Vehicle tracking
  • Trips tracking
  • Idle events
  • Summary reports

Compliance Tolls

  • BestPass compliance
  • TVC compliance
  • Toll management

Maintenance

  • Maintenance scheduling
  • Work orders
  • Service history
  • Inspections management

User & Role Management

User Management

  • Create/edit users
  • Role assignment
  • Permission management
  • Activity tracking
  • Password management
  • Real-time email validation to prevent duplicate emails
  • Button disable when email is already taken
  • Warning message display for duplicate emails

Role Management

  • Create custom roles
  • Permission configuration
  • Module access control
  • Role templates
  • Audit logging
  • Role assignment screen

Profile Settings

  • User profile management
  • Password change
  • Notification preferences
  • Avatar management

Communication & Collaboration

Messaging

  • Internal messaging
  • Driver communication
  • Document sharing
  • Messaging screen

Announcements

  • Create announcements
  • Target specific users/roles
  • Announcement history

Email Management

  • Email templates
  • Email campaigns
  • Email tracking

Notifications

  • System alerts
  • Notification preferences
  • Notification management

Community

  • Community discussions
  • Forums
  • Knowledge sharing

System Settings

System Settings

  • Company settings
  • Feature configuration
  • API configurations
  • Carrier management

White Label Settings

  • Brand customization
  • Color scheme configuration
  • Logo management

Audit & Security

  • Audit log viewing
  • Security monitoring
  • Security settings

Integrations

  • Third-party integrations
  • API connections
  • Integration management

Customer & Partner Management

Broker Management

  • Broker profiles
  • Contact management
  • Credit terms
  • Performance tracking
  • Document storage

Customer Management

  • Customer profiles
  • Rate agreements
  • Service history
  • Billing preferences

Shipper Management

  • Shipper profiles
  • Contact management
  • Service agreements
  • Performance tracking

Consignee Management

  • Location management
  • Contact information
  • Operating hours

Documents Management

Document Management

  • Document repository
  • Document categorization
  • Version control
  • Access permissions

Dispatcher Documents

  • Dispatcher document access
  • Load documents
  • Driver documents
  • Company documents

Task Management

Todo List

  • Create and manage tasks
  • Task assignment
  • Priority settings
  • Task completion tracking

Scheduling

  • Task scheduling
  • Calendar view
  • Reminders
  • Recurring tasks

Reports

  • Custom report generation
  • Report templates
  • Data export
  • Scheduled reports

🚗 Driver Features

DRIVER Mobile-first interface for drivers

Core Features

Load Management

  • View assigned loads
  • Load details view
  • Load completion details
  • Update load status
  • Upload documents (BOL, POD)
  • Track delivery progress
  • Proof of delivery
  • Navigation integration

ELD Compliance

  • Hours of Service dashboard
  • Hours of Service tracking
  • Duty status updates
  • DVIR (Daily Vehicle Inspection)
  • Logbook management
  • Violation alerts

Communication

  • Message dispatcher
  • Load updates
  • Emergency contacts management
  • Push notifications
  • Notification settings
  • Document sharing

Documents

  • Document list management
  • Document scanner
  • Upload photos
  • Sign documents
  • View load documents
  • Access company policies
  • License/certification storage

Finance & Payroll

  • Financial overview
  • Budget management
  • Budget setup
  • Business finance tracking
  • Financial reports
  • Loan requests
  • Loans management
  • Personal finance
  • Receipt tracking
  • View pay statements
  • Track earnings
  • Deduction details
  • Settlement history
  • Expense reporting

Profile Management

  • Personal information
  • Edit profile
  • Emergency contacts
  • Emergency contact form
  • Preferences
  • Document uploads
  • Password change
  • Help and support

Safety & Compliance

  • Safety dashboard
  • Compliance checklist
  • Safety checklist form
  • Emergency monitoring
  • Equipment inspection form
  • Incident reporting
  • Operations manual

Tracking & Navigation

  • Real-time tracking
  • Geofence navigation
  • Route guidance
  • Location updates

Security

  • PIN input screen
  • Secure authentication
  • Session management

🔌 API Documentation

RESTful API endpoints for system integration

Authentication

POST /authentications/login-user.php

Description: User login and authentication

Request Body:

{ "email": "user@example.com", "password": "password123" }

Response: JWT token and user details

POST /authentications/logout-user.php

Description: User logout

Carrier Admin APIs

User Management

GET /carrier-admin/users/get-users.php

Description: Get all users for carrier

POST /carrier-admin/users/create-user.php

Description: Create new user

PUT /carrier-admin/users/update-user.php

Description: Update user information

DELETE /carrier-admin/users/delete-user.php

Description: Delete user

Truck Management

GET /carrier-admin/trucks/get-trucks.php

Description: Get all trucks

POST /carrier-admin/trucks/sync-samsara-vehicles.php

Description: Sync vehicles from Samsara ELD

Driver Management

GET /carrier-admin/drivers/get-drivers.php

Description: Get all drivers

POST /carrier-admin/drivers/create-driver.php

Description: Create new driver

Load Management

GET /carrier-admin/loads/get-loads.php

Description: Get all loads

POST /carrier-admin/loads/create-load.php

Description: Create new load

Role Management

POST /carrier-admin/role-assignment/get-roles.php

Description: Get all roles

POST /carrier-admin/role-assignment/create-role.php

Description: Create custom role

ELD Integration

POST /eld/enhanced-api-configurations.php

Description: Manage ELD API configurations

Super Admin APIs

GET /super-admin/carriers/get-carriers.php

Description: Get all carriers

POST /super-admin/carriers/create-carrier.php

Description: Create new carrier

POST /super-admin/migrations/run-migration.php

Description: Execute database migration

API Response Format

All API responses follow this standard format:

{
    "status": "success" | "error",
    "message": "Response message",
    "data": { ... } | [ ... ],
    "count": 0,
    "metadata": { ... }
}
            

Authentication

Most API endpoints require authentication via JWT token in the Authorization header:

Authorization: Bearer {token}

Database Credentials

Multi-tenant endpoints require database credentials in the request body:

{
    "db_name": "tenant_database",
    "db_user": "database_user",
    "db_pass": "database_password",
    "db_host": "localhost"
}
            

🛠️ Technology Stack

Frontend

Technology Purpose Version
Flutter Cross-platform UI framework Latest
Dart Programming language Latest
Provider State management Latest
Google Fonts Typography Latest

Backend

Technology Purpose Version
PHP Server-side language 7.4+
MySQL Database 5.7+
Apache/XAMPP Web server Latest

Integrations

Service Purpose
Samsara ELD and GPS tracking
OTR Solutions ELD compliance
GoMotive Legacy ELD system
DAT Load Board Load marketplace
TruckStop Load marketplace
Asset Nexus Load marketplace
Comdata/EFS/WEX Fuel card integration

Architecture

🗄️ Database Schema

Core Tables

Table Name Description
users System users (all roles)
roles User roles and permissions
trucks Fleet vehicles
drivers Driver information
loads Load/shipment data
brokers Broker companies
customers Customer accounts
api_configurations Third-party API settings
audit_logs System activity tracking
notifications User notifications

🚀 Deployment Information

Production Environment

Development Setup

  1. Install Flutter SDK
  2. Install XAMPP (Apache + MySQL + PHP)
  3. Clone repository
  4. Configure database credentials in env_config.dart
  5. Run flutter pub get
  6. Run flutter run -d chrome

📞 Support & Contact

Technical Support

For technical issues and bug reports

Email: support@assetlogistics.us

Documentation

Additional resources and guides

Wiki: Internal documentation portal

Development Team

For feature requests and enhancements

Contact: dev@assetlogistics.us