🏗️ Текущая Архитектура

Схема взаимосвязей проектов GitLab • git.kgk-global.com

Mobile Apps
Frontend
Backend API
Services
Data Layer
Monitoring
Video
ChatBot
📱 КЛИЕНТСКИЙ УРОВЕНЬ (Client Applications)
Мобильные приложения
🚀 Sputnik Monitor v2 ⬇️
Flutter 3 / Dart (v1.2.7)
Актуальное мобильное приложение мониторинга (GitHub) ⬇️
🚚 Sputnik Logistics ⬇️
Flutter 3 / Dart (v2.4.1)
Мобильное приложение для водителей-логистов ⬇️
Flutter Monitoring
Flutter/Dart
Приложение мониторинга
KGK Mobile
Flutter/Dart
Основное мобильное приложение KGK
Web Frontend
🚗 Monitoring v3.5 Front
Vue.js / Quasar / TypeScript
Веб-интерфейс мониторинга транспорта (карта, треки, маршруты, зоны)
Logistics Front
Vue.js / JavaScript
Веб-интерфейс логистики
WorkDesk Frontend
JavaScript
Рабочий стол оператора
ChatBot Frontend
JavaScript
Интерфейс чат-бота
Messenger
JavaScript
Система обмена сообщениями
🌐 API УРОВЕНЬ (Backend Services)
Sputnik Monitor API
Go
API мониторинга транспорта
Logistics Backend
Python / Go
Backend логистической системы
Packets API
Go
API для работы с пакетами данных
ChatBot Go
Go
Backend чат-бота
CRM RU
PHP / Python
CRM система
🔗 Integrator ⬇️
Go + MySQL
Сервис интеграции с топливными картами
Интеграция с API поставщиков:
• Газпром • Роснефть • PetrolPlus
• Petroleum • Inforkom • UnicardOil ⬇️
⚙️ СЕРВИСНЫЙ УРОВЕНЬ (Processing & Aggregation)
Агрегаторы
M4RCV Aggregator
Go
Агрегация данных с устройств
Traffic Aggregator
Go
Агрегатор трафика
WorkDesk Aggregator
Go
Агрегатор данных рабочего стола
Обработка данных
Parser 2.0
Go
Парсинг данных с устройств
Analyzer 2.0
Go
Анализ данных телеметрии
Template Processor
Go / Python
Обработка шаблонов отчетов
Передача данных
Retranslator Go
Go
Ретрансляция данных
Packet Loader
Go
Загрузка пакетов данных
Packet Unloader
Go
Выгрузка пакетов данных
Golang RCV
Go
Прием данных с устройств
📊 СПЕЦИАЛИЗИРОВАННЫЕ СЕРВИСЫ
Видеомониторинг
Video Monitoring
Go / Python
Система видеомониторинга
Recognition
Python
Распознавание объектов
Мониторинг
Monitoring 4
PHP
Основная система мониторинга
Monitoring v3.5
PHP / Python
Мониторинг версия 3.5
Дополнительные сервисы
Fines
Go
Система штрафов
🗄️ УРОВЕНЬ БАЗ ДАННЫХ (Database Layer)
🐬 MySQL
Primary Database
Основная реляционная БД для бизнес-данных, CRM, топливных карт
🐘 PostgreSQL
Analytics Database
БД для аналитики, телеметрии, мониторинга
⚡ Redis
Cache & Sessions
Кэширование, сессии, очереди сообщений
📨 Kafka
Message Broker
Очереди событий, стриминг данных
🥑 ArangoDB
Multi-Model DB
Графовая/документная БД для маршрутов, зон

🔗 Связи сервисов с базами данных

🐬 MySQL ← Integrator (топливные транзакции)
🐬 MySQL ← CRM (клиенты, заявки)
🐬 MySQL ← Monitoring 4 / v3.5 (объекты)
🐬 MySQL ← Fines (штрафы)
🐘 PostgreSQL ← Sputnik Monitor API (телеметрия)
🐘 PostgreSQL ← Analyzer 2.0 (аналитика)
🐘 PostgreSQL ← Logistics Backend (основные данные)
🥑 ArangoDB ← Logistics Backend (маршруты, графы)
🐘 PostgreSQL ← Video Monitoring (видео метаданные)
⚡ Redis ← Sputnik Monitor API (кэш, сессии)
⚡ Redis ← ChatBot Go (состояния диалогов)
⚡ Redis ← Monitoring v3.5 (кэш)
📨 Kafka ← Parser 2.0 → Analyzer 2.0 (события)
📨 Kafka ← Golang RCV → Packet Loader (пакеты)
📨 Kafka ← Retranslator → External (ретрансляция)
📨 Kafka ← Logistics Backend (события маршрутов)
🧪 ТЕСТИРОВАНИЕ И ИНФРАСТРУКТУРА
Magnum AQA
Python
Автоматизированное тестирование

🔄 Потоки данных и взаимосвязи

📱 Mobile Apps → Sputnik Monitor API → 🗄️ Database
🖥️ Monitoring Frontend → Monitoring v3.5 Backend → 🗄️ Database
🚛 Logistics Frontend → Logistics Backend → 🗄️ Database
📡 GPS Devices → Golang RCV → Parser 2.0 → Analyzer 2.0
📦 Packet Loader → Packets API → Aggregator → 🗄️ Database
🎥 Video Devices → Video Monitoring → Recognition → 🚨 Alerts
💬 ChatBot Frontend → ChatBot Go → CRM / Monitoring
📊 Retranslator → Traffic Aggregator → External Systems
🧪 Magnum AQA → All Frontend & Backend Services
⛽ Integrator → Fuel Card APIs → 🐬 MySQL → CRM/Monitoring
🔗

INTEGRATOR - Детальное описание

📂 Открыть в GitLab

🎯 Назначение

Integrator — это сервис интеграции с внешними API поставщиков топливных карт. Он автоматически синхронизирует данные о транзакциях по топливным картам из различных топливных компаний в единую базу данных KGK.

🛠️ Технологии

  • 🐹 Go — основной язык разработки
  • 🐬 MySQL — база данных для хранения транзакций
  • ⚙️ Worker Pool — многопоточная обработка подписок
  • 🌐 REST API — интеграция с внешними сервисами
📐 Архитектура обработки
Subscription Processor → Worker Pool → Provider API → MySQL DB

⛽ Поддерживаемые провайдеры

Газпром
gazprom.go
Роснефть
rosneft.go
PetrolPlus
petrolplus.go
Petroleum
petroleum.go
Inforkom
inforkom.go
UnicardOil
unicardoil.go
📱

SPUTNIK MONITOR v2 - Детальное описание

🐙 Открыть в GitHub

🎯 Назначение

Sputnik Monitor — мобильное приложение для мониторинга транспорта и отслеживания GPS-трекеров в реальном времени. Позволяет видеть местоположение объектов на карте, просматривать историю перемещений, отчеты по топливу и температуре.

🛠️ Технологии

  • 🎯 Flutter 3 / Dart — SDK ≥3.0.0
  • 📦 GetX — state management
  • 🗺️ Flutter Map — OSM карты
  • 📡 WebSocket — real-time данные
  • 📊 FL Chart — интерактивные графики
  • 📄 PDF View — просмотр отчетов
� Backend интеграция
REST API + WebSocket
PostgreSQL
Real-time мониторинг

📋 Функции приложения

🗺️ Карта
OSM / Flutter Map
📍 Трекинг
Real-time GPS
⛽ Топливо
fuel_report/
🌡️ Температура
temperature_report/
📊 Отчеты
detail_report/
🔲 Зоны
zones/

📱 Версия

Версия:1.2.7+53
Обновлено:December 2025
Платформы:iOS, Android
🚚

SPUTNIK LOGISTICS - Детальное описание

🦊 Открыть в GitLab

🎯 Назначение

Sputnik Logistics — мобильное приложение для водителей, обеспечивающее полный контроль над логистическими маршрутами и задачами. Водители могут отслеживать точки маршрута, подтверждать посещения, просматривать карты и получать инструкции по следующему пункту назначения.

🛠️ Технологии

  • 🎯 Flutter 3 / Dart — SDK ≥3.0.0
  • 📦 BLoC / Cubit — state management
  • 🗺️ Google Maps + OSM — мульти-карты
  • 📡 WebSocket — real-time маршруты
  • 📍 Geolocator — геопозиционирование
  • 📸 Image Picker — фото-отчеты
  • 🌐 Dio — HTTP клиент
🔗 Backend интеграция
REST API (Go / gin)
PostgreSQL / MySQL
Docker + GitLab CI

📋 Функции приложения

🗺️ Карты
Google / Yandex / OSM
📍 Маршруты
Real-time навигация
✅ Точки
Контрольные чекпоинты
📴 Оффлайн
Автономный режим
📸 Фото
Отчеты с места
🌐 i18n
Локализация

📱 Версия

Версия:2.4.1+30
Создан:Февраль 2024
Платформы:iOS, Android

Сгенерировано на основе анализа кода GitLab и GitHub репозиториев

git.kgk-global.com • github.com • January 2026