Welcome to G-Track TMS Documentation¶

G-Track is a modern Software-as-a-Service (SaaS) Transport Management System designed specifically for small-to-medium logistics companies (2-50 vehicles) operating across the European Union.

About G-Track¶

The platform addresses critical pain points in:

📄 Driver document management - Automated expiration tracking for 14 document types
🚚 Vehicle & trailer management - Technical inspection and service tracking
📦 Order processing - Complete transport order lifecycle
💰 Financial operations - EU VAT compliant invoicing and payments
🌍 Multi-country operations - 5 languages, multi-currency support

Current Development Status¶

Phase: MVP (Minimum Viable Product) Timeline: Q4 2025 - Q1 2026 Target Launch: January 2026

Priority #1: Drivers Module (95% complete)

System FoundationCore ModulesTechnical ReferenceProject Management

Executive Summary - Project overview and key features
Project Overview - Business context and problem statement
Technology Stack - Angular 20, Laravel 12, Supabase
System Architecture - Multi-tenancy, authentication, authorization
Authentication - Supabase Auth integration and RLS-based RBAC
Onboarding - Company setup and first-time user experience

Drivers Module - Priority #1 (95% complete)
- Document management for 14 types
- Readiness tracking and alerts
- Mobile document upload via Telegram Bot
Vehicles Module - Trucks and trailers management (placeholder)
Customers Module - Customer and carrier companies (placeholder)
Orders Module - Transport order lifecycle (placeholder)
Invoices Module - EU VAT compliant invoicing (placeholder)

Financial System - Pricing, subscriptions, billing
Internationalization - Multi-language support (RU, EN, CZ, PL, DE)
Database Schema - PostgreSQL structure and relationships
API Specification - RESTful API endpoints

Roadmap - Development phases, milestones, timeline

Technology Stack¶

graph TB
    A[Frontend: Angular 20] --> D[API Gateway]
    B[Backend: Laravel 12] --> D
    C[Supabase: PostgreSQL 17.6] --> B
    C --> E[Supabase Auth]
    D --> E
    D --> F[AWS S3]
    B --> G[Redis Cache]
    E --> C

Frontend: Angular 20 + TypeScript 5.6 + Taiga UI 4.60.0 Backend: Laravel 12 + PHP 8.3 + RESTful API Database: Supabase PostgreSQL 17.6 + PostGIS + TimescaleDB Authentication: Supabase Auth (JWT + RLS) Hosting: Vercel (frontend) + Laravel Cloud (backend) + Supabase (database)

Key Features¶

✅ Multi-tenant Architecture - Company → Offices → Users isolation ✅ Document Expiration Tracking - Automated alerts for 14 document types ✅ Readiness Dashboard - Real-time view of which drivers can work today ✅ Mobile-First Design - PWA support for document upload on mobile devices ✅ EU VAT Compliance - Domestic, Reverse Charge, Non-VAT invoice modes ✅ 5 Languages - Russian, English, Czech, Polish, German ✅ RBAC - 5 roles (Admin, Accountant, HR Manager, Dispatcher, Driver)

📖 Documentation Version¶

Version: 2.2.0 (English-only) Last Updated: November 12, 2025 Based on: Master Specification v3.1 + November 2025 Updates

Source Repository: github.com/tqlismqn/gtrack-docs (Private)

🎯 Quick Status Check¶

Want to see current project status? Check PROJECT_STATUS.md for: - ✅ Current sprint progress (Week 2: November 11-17, 2025) - 🔄 What's in progress right now - 📋 Recent changes (last 2 weeks) - 🎯 Next milestones

For complete project history: See CHANGELOG.md

🚀 Quick Start¶

For DevelopersFor Product ManagersFor UI/UX Designers

Read System Architecture to understand the technical foundation
Review Drivers Module as the reference implementation
Check API Specification for backend integration
See Database Schema for data model

Start with Executive Summary for high-level overview
Read Project Overview for business context
Review Roadmap for development timeline
Check Drivers Module - Business Logic for feature details

Review Drivers Module - UI/UX for design patterns
Check Internationalization for multi-language support
See Onboarding for user flow

Need help?

Contact the development team via Linear or GitHub Issues.