Разработка портала для логистической компании: трекинг и интеграции

Мы разрабатываем порталы для логистических компаний — не просто сайты с формой заявки, а полноценные рабочие инструменты для управления перевозками. Через такой портал клиенты отслеживают грузы в реальном времени, диспетчеры назначают машины, водители получают маршруты, а бухгалтерия выгружает накладные. Каждая роль получает персонализированный интерфейс с разграничением доступа. Типичные проблемы: потеря грузов из-за отсутствия трекинга, неэффективное планирование маршрутов, ручное заполнение документов и недостаток прозрачности для клиентов. Мы решаем их с помощью GPS-трекеров, автоматизации документооборота и гибкой системы тарифов. Наш опыт — 5+ лет и более 30 реализованных проектов для транспортной отрасли, средняя экономия операционных расходов после внедрения — 15–25%.

Функциональные модули портала

Типичный портал для транспортно-логистической компании состоит из нескольких независимых модулей, которые соединяются через общую базу данных и API.

Личный кабинет клиента — регистрация, история заказов, текущий статус доставки, документы (CMR, TTH, счета), запрос новой перевозки. Клиент видит только свои данные.

Панель диспетчера — входящие заявки, назначение водителей и транспортных средств, отслеживание позиций на карте в реальном времени, изменение статусов, чат с водителем.

Мобильное приложение водителя (или PWA) — текущий заказ, маршрут, смена статусов (забрал/в пути/доставил), фотофиксация при выдаче, подпись получателя на экране.

Административная панель — управление справочниками (города, тарифы, типы транспорта), отчёты, управление пользователями.

Почему трекинг грузов — основа современного портала?

Реальное положение транспортных средств — один из ключевых элементов. Есть несколько подходов:

GPS-трекеры с собственным сервером. Устройства типа Teltonika FMB920 отправляют координаты по протоколу MQTT или через собственный TCP-сервер. Данные приходят каждые 30–60 секунд:

# Пример обработки входящих данных с GPS-трекера через MQTT
import paho.mqtt.client as mqtt
import json
from datetime import datetime

def on_message(client, userdata, message):
    data = json.loads(message.payload.decode())
    vehicle_id = data['device_id']
    lat = data['lat']
    lng = data['lng']
    speed = data['speed']
    ts = datetime.fromtimestamp(data['timestamp'])

    # Сохраняем в TimescaleDB (PostgreSQL с расширением для временных рядов)
    db.execute("""
        INSERT INTO vehicle_positions (vehicle_id, lat, lng, speed, recorded_at)
        VALUES (%s, %s, %s, %s, %s)
    """, (vehicle_id, lat, lng, speed, ts))

    # Публикуем в Redis для real-time обновлений на карте
    redis.publish(f'vehicle:{vehicle_id}', json.dumps({
        'lat': lat,
        'lng': lng,
        'speed': speed
    }))

Мобильное приложение с геолокацией. Водитель включает отслеживание через браузер или приложение. Дешевле в инфраструктуре, но зависит от заряда телефона и наличия интернета.

Интеграция с внешними системами. Яндекс.Транспорт, Wialon, Omnicomm — готовые платформы мониторинга с API.

Как мы реализуем карту в реальном времени?

Для отображения позиций используется WebSocket — сервер пушит обновления клиенту без опроса:

// Фронтенд: подключение к WebSocket и обновление маркеров на карте
const socket = new WebSocket('wss://api.example.com/ws/dispatch');
socket.addEventListener('message', (event) => {
  const { vehicleId, lat, lng, speed, status } = JSON.parse(event.data);
  if (markers[vehicleId]) {
    markers[vehicleId].setLatLng([lat, lng]);
    markers[vehicleId].setPopupContent(
      `<b>${vehicleId}</b><br>Скорость: ${speed} км/ч<br>Статус: ${status}`
    );
  } else {
    markers[vehicleId] = L.marker([lat, lng])
      .addTo(map)
      .bindPopup(`<b>${vehicleId}</b>`);
  }
});

Для карты — Leaflet с тайлами от OpenStreetMap (бесплатно) или Яндекс.Карты / Google Maps (платно, но лучше geocoding для СНГ).

Что входит в работу?

• Техническая документация: описание архитектуры, UML-диаграммы, спецификация API.
• Настроенный репозиторий с CI/CD (GitLab CI, GitHub Actions).
• Доступ к промежуточной среде для приёмочного тестирования.
• Обучение команды заказчика работе с порталом.
• Техническая поддержка на протяжении месяца после запуска.

Расчёт стоимости перевозки

Тарификация у логистических компаний бывает сложной: зависит от веса, объёма, расстояния, типа груза, срочности, страховки. Рекомендуется вынести логику в отдельный сервис:

class FreightCalculator {
    public function calculate(FreightRequest $request): FreightQuote {
        $distance = $this->distanceMatrix->calculate(
            $request->originCity,
            $request->destinationCity
        );
        $baseRate = $this->rateRepository->findRate(
            $request->cargoType,
            $request->vehicleType,
            $distance->zone
        );
        $weightCharge = max($request->weight, $request->volumetricWeight()) * $baseRate->perKg;
        $distanceCharge = $distance->km * $baseRate->perKm;
        $insurance = $request->declaredValue * 0.002; // 0.2%
        $total = ($weightCharge + $distanceCharge + $insurance) * $request->urgencyMultiplier() * $this->seasonalCoefficient();
        return new FreightQuote(
            base: $weightCharge + $distanceCharge,
            insurance: $insurance,
            total: round($total, 2),
            currency: 'USD',
            validUntil: now()->addHours(24),
        );
    }
}

Документооборот

Транспортная накладная, CMR, экспедиторская расписка — всё это должно генерироваться автоматически из данных заказа. Используется библиотека типа TCPDF или Snappy (wkhtmltopdf) для PHP, либо Puppeteer для Node.js.

Подпись получателя собирается через Canvas API в браузере и сохраняется как изображение, прикреплённое к накладной:

const canvas = document.getElementById('signature-pad');
const signaturePad = new SignaturePad(canvas, {
  backgroundColor: 'rgb(255, 255, 255)',
  penColor: 'rgb(0, 0, 0)',
});
document.getElementById('save-signature').addEventListener('click', () => {
  if (!signaturePad.isEmpty()) {
    const dataUrl = signaturePad.toDataURL('image/png');
    // Отправляем на сервер вместе с подтверждением доставки
    fetch('/api/deliveries/' + deliveryId + '/confirm', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json'
      },
      body: JSON.stringify({
        signature: dataUrl,
        confirmed_at: new Date().toISOString()
      }),
    });
  }
});

Интеграции с внешними системами

Логистический портал редко живёт изолированно. Типичные интеграции:

• 1С — выгрузка накладных, синхронизация контрагентов, загрузка оплат
• Диадок / СБИС — электронный документооборот, подписание документов ЭЦП
• Транспортные биржи (ATI.SU, Deliver) — автоматическая публикация заявок на перевозку
• Страховые компании — оформление страхования груза через API

Пошаговая инструкция: как мы запускаем интеграцию с 1С

1. Анализ — изучаем текущие документы и реквизиты, согласовываем форматы обмена (XML, JSON).
2. Разработка — пишем модуль синхронизации на стороне портала, настраиваем выгрузку контрагентов и заказов.
3. Тестирование — проверяем корректность данных на тестовой базе 1С, исправляем ошибки.
4. Ввод в эксплуатацию — запускаем в фоновом режиме, мониторим логи.
5. Сопровождение — в течение месяца после запуска фиксим замечания и обучаем бухгалтеров.

Производительность при масштабе

Отметим: когда в системе тысячи активных перевозок, наивные запросы к БД начинают тормозить. Несколько конкретных решений:

Геопространственные индексы в PostgreSQL с расширением PostGIS:

CREATE INDEX idx_vehicle_positions_location ON vehicle_positions USING GIST (ST_SetSRID(ST_MakePoint(lng, lat), 4326)); -- Выборка всех машин в радиусе 50 км от точки
SELECT vehicle_id, lat, lng
FROM vehicle_positions vp
JOIN (
    SELECT vehicle_id, MAX(recorded_at) as last_seen
    FROM vehicle_positions
    GROUP BY vehicle_id
) latest ON vp.vehicle_id = latest.vehicle_id AND vp.recorded_at = latest.last_seen
WHERE ST_DWithin(
    ST_SetSRID(ST_MakePoint(lng, lat), 4326)::geography,
    ST_SetSRID(ST_MakePoint(37.6173, 55.7558), 4326)::geography,
    50000
);

Партиционирование таблицы позиций по дате — через месяц данные архивируются и не мешают основным запросам.

Сроки и этапы разработки

Бюджет такого проекта обычно составляет от $10k–50k в зависимости от функционала. Получите консультацию по архитектуре портала — свяжитесь с нами, чтобы обсудить ваш проект.

Конвенция о договоре международной дорожной перевозки грузов (CMR) — основные требования к накладным.