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

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

Mobile Apps
Frontend
Backend API
Services
Data Layer
Monitoring
Video
ChatBot
🏢

KGK Global

Мониторинг транспорта

🌐 Monitoring v3.5 📊 CRM ⛽ Integrator 🤖 ChatBot 📹 Video Monitoring
🗄️ Databases: MySQL • ClickHouse • MongoDB • Redis
🏪

Magnum

Retail & Logistics

📱 Sputnik Monitor 🚚 Sputnik Logistics 🌐 Logistics Frontend 📦 Logistics API 🧪 Magnum AQA
🗄️ Databases: PostgreSQL • ArangoDB • Redis
📱 КЛИЕНТСКИЙ УРОВЕНЬ (Client Applications)
Мобильные приложения
Magnum
🚀 Sputnik Monitor v2
Flutter 3 / Dart (v1.2.7)
Мобильное приложение мониторинга транспорта (GitHub)
Magnum
🚚 Sputnik Logistics
Flutter 3 / Dart (v2.4.1)
Мобильное логистическое приложение для водителей
KGK
Flutter Monitoring
Flutter/Dart
Приложение мониторинга
Web Frontend
KGK
🚗 Monitoring v3.5 Front
Vue.js / Quasar / TypeScript
Веб-интерфейс мониторинга транспорта (карта, треки, маршруты, зоны)
Magnum
Logistics Front
Vue.js / JavaScript
Веб-интерфейс логистики
KGK
ChatBot Frontend
JavaScript
Интерфейс чат-бота
KGK
Messenger
JavaScript
Система обмена сообщениями
🌐 API УРОВЕНЬ (Backend Services)
Magnum KGK
Sputnik Monitor API (Redesign API)
Go
API мониторинга транспорта
🌐 API: api.sputnik-monitor.ru
Magnum
Logistics API
Go (PostgreSQL + ArangoDB + Redis)
Backend логистической системы
🌐 API: logistics.sputnik-monitor.ru
Magnum KGK
Packets API
Go (ClickHouse + MongoDB + MySQL + Redis)
API для работы с пакетами данных
🌐 API: packets.sputnik-monitor.ru
KGK
Chat API
Go
Backend чат-бота
🌐 API: chat.sputnik-monitor.ru
KGK
CRM RU
PHP / Python
CRM система
KGK
🔗 Integrator
Go + MySQL
Сервис интеграции с топливными картами
Интеграция с API поставщиков:
• Газпром • Роснефть • PetrolPlus
• Petroleum • Inforkom • UnicardOil
⚙️ СЕРВИСНЫЙ УРОВЕНЬ (Processing & Aggregation)
Агрегаторы
Magnum KGK
M4RCV Aggregator
Go (ClickHouse + MongoDB + MySQL + Redis)
Агрегация данных с устройств
🌐 API: events.sputnik-monitor.ru
Magnum KGK
Traffic Aggregator
Go
Агрегатор трафика
KGK
WorkDesk Aggregator
Go
Агрегатор данных рабочего стола
Обработка данных
Magnum KGK
Parser 2.0
Go
Парсинг данных с устройств
Magnum KGK
Analyzer 2.0
Go
Анализ данных телеметрии
KGK
📄 Template Processor
Go + MySQL + wkhtmltopdf
Генерация и рассылка отчётов мониторинга
Типы отчётов:
• Маршруты • Топливо • Скорость
• Температура • Зоны • Штрафы
Отправка: Email • SMS • Telegram
Передача данных
MagnumKGKRetranslator Go
Go
Ретрансляция данных во внешние системы
🌐 API: retranslator.sputnik-monitor.ru
MagnumKGKPacket Loader
Go
Загрузка пакетов данных
MagnumKGKPacket Unloader
Go
Выгрузка пакетов данных
MagnumKGKReceiver (Golang RCV)
Go
Прием данных с устройств (трекеров)
ADDR: rcv1.sputnik-monitor.ru:9016
📊 СПЕЦИАЛИЗИРОВАННЫЕ СЕРВИСЫ
Видеомониторинг
KGK
Video Monitoring
Go / Python
Система видеомониторинга
KGK
Recognition
Python
Распознавание объектов
Мониторинг
KGK
Monitoring 4
PHP
Основная система мониторинга
KGK
Monitoring v3.5
PHP / Python
Мониторинг версия 3.5
Дополнительные сервисы
KGK
Fines
Go
Система штрафов
🌐 КОРПОРАТИВНЫЕ САЙТЫ
Веб-сайт
KGK
KGK Corporate Website
PHP / MODX CMS
Корпоративный сайт компании KGK
🗄️ УРОВЕНЬ БАЗ ДАННЫХ (Database Layer)
Magnum KGK
🐬 MySQL MainDB
Primary Database
Основная реляционная БД для бизнес-данных, CRM, топливных карт
Remote: main3b01:3306 | Local: 10.80.0.121:3306
Magnum
🐘 PostgreSQL
Logistics Database
БД для логистики (Logistics Backend)
Host: 37.139.43.100:5001 | DB: postgres
Magnum KGK
⚡ Redis Queue
Message Queue
Очереди сообщений для обработки пакетов
Remote: redis:63796 | Local: 10.80.0.10:63796
Magnum KGK
⚡ Redis States
Cache & Sessions
Кэширование, сессии, состояния
Remote: redis:63795 | Local: 10.80.0.10:63795
Magnum KGK
📨 Kafka
Message Broker
Очереди событий, стриминг данных
Magnum KGK
🥑 ArangoDB
Multi-Model DB
Графовая/документная БД для маршрутов, зон
Remote: http://10.80.0.104:8529 | Local: http://178.177.40.137:8529
Magnum KGK
🏠 ClickHouse Packet DB
OLAP Database
Колоночная БД для хранения пакетов данных
Remote: tcp://balance-ch:9000 | Local: tcp://10.80.x.26:9000
Magnum KGK
🍃 MongoDB Aggregator
Document Database
Документная БД для агрегированных данных
Remote: http://srv-v-db01:27017/aggdata | Local: http://10.80.0.114:27017/aggdata
Magnum KGK
🍃 MongoDB Retranslations
Document Database
Документная БД для ретрансляций
Remote: http://srv-v-db01:27017/retranslations | Local: http://10.10.0.106:27017/retranslations

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

🐬 MySQL ← Integrator (топливные транзакции)
🐬 MySQL ← CRM (клиенты, заявки)
🐬 MySQL ← Monitoring 4 / v3.5 (объекты)
🐬 MySQL ← Fines (штрафы)
🐘 PostgreSQL ← Logistics Backend (основные данные, pgx driver)
🥑 ArangoDB ← Logistics Backend (маршруты, графы)
🏠 ClickHouse ← Packets API (хранение пакетов)
🏠 ClickHouse ← Aggregator (агрегированные данные)
🍃 MongoDB ← Aggregator (aggdata)
🍃 MongoDB ← Packets API (пакеты)
⚡ Redis Queue (:63796) ← Packet Loader / Parser (очередь пакетов)
⚡ Redis States (:63795) ← Packets API / Analyzer (состояния)
⚡ Redis States ← Logistics Backend (кэш)
⚡ Redis Queue ← Parser 2.0 → Packet Loader (распарсенные пакеты)
⚡ Redis Queue ← Receiver → Parser 2.0 (сырые пакеты)
(события маршрутов)
🧪 ТЕСТИРОВАНИЕ И ИНФРАСТРУКТУРА
Magnum
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
📄

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

🦊 Открыть в GitLab

🎯 Назначение

Template Processor — сервис автоматической генерации и рассылки отчётов по мониторингу транспорта. Обрабатывает шаблоны отчётов, генерирует документы в форматах PDF/XLS и автоматически отправляет их через Email, SMS или Telegram. Поддерживает scheduled-задачи и обработку событий в реальном времени.

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

  • 🐹 Go — основной язык разработки
  • 🐬 MySQL — хранение шаблонов и логов
  • 📄 wkhtmltopdf — конвертация HTML в PDF
  • ⚙️ Worker Pool — многопоточная обработка
  • 📧 SMTP/Telegram/SMS — multi-channel отправка
  • 🌐 Gin Framework — REST API
📐 Архитектура обработки
Templates Worker → Report API → Export (PDF/XLS) → Sender (Email/SMS/TG)
📬 Каналы уведомлений
📧 Email Bot → SMTP Gmail
📱 Telegram Bot → Telegram API
💬 SMS Bot → Megafon Gateway

📊 Типы отчётов

🚗 Маршруты
route_detail / route_summary
⛽ Топливо
fuel_detail / fuel_summary
⚡ Скорость
speed
🌡️ Температура
temp
📍 Геозоны
zones
🚨 Штрафы
fines
📏 Пробег
mileage
📊 Датчики
sensors_detail / summary_sensors
📈 Аналитика
detail_analyze / summary_analyze

⚙️ Воркеры и компоненты

🔄 Templates Worker:Обработка шаблонов отчётов
📬 Events Worker:Обработка событий и уведомлений
🛠️ Maintenance Worker:Фоновые задачи
API Endpoint:https://template-processor.sputnik-monitor.ru
Форматы экспорта:PDF, XLS
Последнее обновление:January 2026

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

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