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

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

Логистический портал — это не просто сайт-визитка с формой заявки. Это рабочий инструмент, через который менеджеры клиентов отслеживают грузы, диспетчеры назначают машины, водители получают маршруты, а бухгалтерия выгружает накладные. Каждая из этих ролей работает со своими данными, своими сценариями, своим уровнем доступа.

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

Типичный портал для транспортно-логистической компании состоит из нескольких независимых модулей, которые соединяются через общую базу данных и 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. Подключение к их 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 для СНГ).

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

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

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: 'RUB',
            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

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

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

Геопространственные индексы в 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
);

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

Сроки разработки

Минимально жизнеспособный портал (личный кабинет клиента + статусы + документы) — 6–8 недель. Полноценная система с диспетчерской картой, мобильным приложением водителя, расчётом тарифов и интеграциями — 4–6 месяцев. Это реальные цифры для команды из трёх разработчиков.