Добро пожаловать в документацию G-Track TMS¶
G-Track — современная Software-as-a-Service (SaaS) система управления транспортом, разработанная специально для малых и средних логистических компаний (2-50 транспортных единиц), работающих в Европейском Союзе.
О системе G-Track¶
Платформа решает критические проблемы в:
- 📄 Управление документами водителей - Автоматическое отслеживание сроков действия 14 типов документов
- 🚚 Управление транспортом и прицепами - Отслеживание техосмотров и сервисного обслуживания
- 📦 Обработка заказов - Полный жизненный цикл транспортных заказов
- 💰 Финансовые операции - Выставление счетов с соблюдением НДС ЕС и платежи
- 🌍 Международные операции - 5 языков, поддержка множества валют
Текущий статус разработки¶
Фаза: MVP (Minimum Viable Product) Сроки: Q4 2025 - Q1 2026 Целевой запуск: Январь 2026
Приоритет #1: Модуль водителей (95% завершено)
Быстрая навигация¶
- Краткое описание - Обзор проекта и ключевые функции
- Обзор проекта - Бизнес-контекст и постановка задачи
- Технологический стек - Angular 20, Laravel 12, Supabase
- Архитектура системы - Мультитенантность, аутентификация, авторизация
- Аутентификация - Интеграция Supabase Auth и RBAC на основе RLS
- Онбординг - Настройка компании и первый опыт пользователя
- Модуль водителей - Приоритет #1 (95% завершено)
- Управление документами для 14 типов
- Отслеживание готовности и уведомления
- Загрузка документов через Telegram Bot
- Модуль транспорта - Управление грузовиками и прицепами (заглушка)
- Модуль клиентов - Клиенты и компании-перевозчики (заглушка)
- Модуль заказов - Жизненный цикл транспортных заказов (заглушка)
- Модуль счетов - Выставление счетов с соблюдением НДС ЕС (заглушка)
- Финансовая система - Ценообразование, подписки, биллинг
- Интернационализация - Поддержка нескольких языков (RU, EN, CZ, PL, DE)
- Схема базы данных - Структура PostgreSQL и связи
- API спецификация - RESTful API endpoints
- Дорожная карта - Фазы разработки, вехи, временные рамки
Технологический стек¶
graph TB
A[Фронтенд: Angular 20] --> D[API Gateway]
B[Бэкенд: 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
Фронтенд: Angular 20 + TypeScript 5.6 + Taiga UI 4.60.0 Бэкенд: Laravel 12 + PHP 8.3 + RESTful API База данных: Supabase PostgreSQL 17.6 + PostGIS + TimescaleDB Аутентификация: Supabase Auth (JWT + RLS) Хостинг: Vercel (фронтенд) + Laravel Cloud (бэкенд) + Supabase (база данных)
Ключевые функции¶
✅ Мультитенантная архитектура - Изоляция: Компания → Офисы → Пользователи ✅ Отслеживание сроков документов - Автоматические уведомления для 14 типов документов ✅ Дашборд готовности - В реальном времени показывает, какие водители могут работать сегодня ✅ Mobile-First дизайн - PWA поддержка для загрузки документов с мобильных устройств ✅ Соблюдение НДС ЕС - Режимы счетов: Внутренний, Reverse Charge, Без НДС ✅ 5 языков - Русский, Английский, Чешский, Польский, Немецкий ✅ RBAC - 5 ролей (Администратор, Бухгалтер, HR менеджер, Диспетчер, Водитель)
📖 Версия документации¶
Версия: 2.2.0 (только английский + базовый русский) Последнее обновление: 12 ноября 2025 Основа: Master Specification v3.1 + Обновления ноября 2025
Репозиторий: github.com/tqlismqn/gtrack-docs (Приватный)
🎯 Быстрая проверка статуса¶
Хотите увидеть текущий статус проекта? Проверьте PROJECT_STATUS.md: - ✅ Прогресс текущего спринта (Неделя 2: 11-17 ноября 2025) - 🔄 Что сейчас в работе - 📋 Недавние изменения (последние 2 недели) - 🎯 Следующие вехи
Для полной истории проекта: Смотрите CHANGELOG.md
🚀 Быстрый старт¶
- Прочитайте Архитектура системы для понимания технической основы
- Изучите Модуль водителей как референсную реализацию
- Проверьте API спецификацию для интеграции с бэкендом
- Смотрите Схему базы данных для модели данных
- Начните с Краткого описания для общего понимания
- Прочитайте Обзор проекта для бизнес-контекста
- Изучите Дорожную карту для временной шкалы разработки
- Проверьте Модуль водителей - Бизнес-логика для деталей функций
- Изучите Модуль водителей - UI/UX для паттернов дизайна
- Проверьте Интернационализацию для поддержки нескольких языков
- Смотрите Онбординг для пользовательского flow
Нужна помощь?
Свяжитесь с командой разработки через Linear или GitHub Issues.