LoadMaster Balans — Документация системы | Open Source
Документация системы • Open Source • MIT License

Документация
LoadMaster Balans

Полное описание системы для расчёта осевых нагрузок и визуализации загрузки грузового транспорта. Профессиональное решение с открытым исходным кодом.

Обзор системы

Что такое LoadMaster Balans?

LoadMaster Balans v1 — это первая стадия разработки комплексной платформы LoadMaster3D, созданная для максимальной полезности транспортного сообщества уже на раннем этапе. Это open-source решение для профессионального расчета осевых нагрузок и визуализации загрузки грузового транспорта, разработанное компанией FULLBORT и распространяемое под лицензией MIT.

Система представляет собой 2D-планировщик загрузки, который решает 80% повседневных задач логистов и диспетчеров. Мы начинаем с 2D, чтобы быстро предоставить сообществу рабочий инструмент, который приносит пользу уже сейчас.

Версия

1.0.0

Лицензия

MIT License

Платформа

WordPress 5.0+ или веб-решение

Требования

PHP 7.4+, MySQL 5.6+

Целевая аудитория

  • Логисты транспортных компаний — нуждаются в быстром и точном расчете осевых нагрузок, визуализации схемы размещения грузов, создании технических заданий для водителей.
  • Диспетчеры складов — требуется контроль правильности погрузки, понятные схемы для водителей, проверка на перегруз осей.
  • Владельцы малого и среднего транспортного бизнеса — нужно бесплатное решение без подписок, простота использования, возможность интеграции в существующие сайты.
  • Разработчики логистических систем — нужен open-source код для интеграции, REST API для автоматизации, возможность кастомизации.

Ключевые возможности

Расчёт осевых нагрузок

Моментный метод расчёта для полуприцепов и грузовиков. Автоматический расчёт центра тяжести, нагрузки на каждую ось, процент использования. Визуальная индикация перегруза (зелёный/жёлтый/красный).

Поддержка kingpin (шкворня) для полуприцепов, распределение нагрузки по осям тележки. Точность расчёта: ±1%, время расчёта: < 50 мс.

Интерактивная визуализация

Canvas-визуализатор с drag-and-drop, мульти-выделением (Ctrl+Click), системой слоёв для стекирования грузов. Сетка с метровыми делениями, snap к сетке 10мм, контроль коллизий в реальном времени.

Визуализация осей, kingpin, нижних слоёв (приглушённо), цветовая индикация статуса. Зум (колёсико, +/−/100%), панорамирование, мини-карта.

Генератор “Хребет”

Уникальный алгоритм оптимальной укладки паллет. Комбинация продольных (“Хребет”) и поперечных (“Ребро”) паллет. Автоматический расчёт схемы для 21-33 паллет в стандартной еврофуре.

Пример: 33 паллеты = 9 “Хребтов” + 12 пар “Рёбер”, LDM = 13.2м.

База транспортных средств

15+ встроенных типов ТС: Еврофура 13.6м, Рефрижератор, Jumbo, КАМАЗ-65117, КАМАЗ-53212, ГАЗон Next, Валдай Next, ГАЗель Next, Ford Transit, контейнеры 20ft/40ft.

Кастомные ТС через админ-панель с экспортом/импортом JSON. Настройка габаритов, осей, kingpin.

Undo/Redo система

История изменений до 50 шагов. Горячие клавиши: Ctrl+Z (отмена), Ctrl+Shift+Z (повтор). Отслеживание всех операций с грузами. Быстрая отмена ошибочных действий.

Экспорт и отчёты

PDF-отчёт: техническое задание на погрузку, таблица осевых нагрузок, скриншот схемы, манифест грузов. JSON: полная структура проекта для интеграции. PNG: высококачественный скриншот схемы.

Метод расчёта

LoadMaster Balans использует моментный метод расчёта для точного определения нагрузок на оси транспортных средств. Метод различается для одиночных грузовиков и полуприцепов.

Одиночный грузовик (kingpin = 0)

R_rear        = W × (Xcg – frontAxle) / L
R_front      = W – R_rear
где W = общий вес, Xcg = центр тяжести, L = база ТС

Полуприцеп (kingpin < 0)

1. D = BogieCenter – KP (плечо)
2. M = Σ(item.weight × (item.Xcg – KP)) (момент)
3. R_bogie = M / D (нагрузка на тележку)
4. R_tractor = W – R_bogie (нагрузка на тягач)
5. R_axle_i = R_bogie / N_axles (распределение по осям)

Особенности расчёта

  • Точность: ±1% по сравнению с ручными расчётами
  • Скорость: расчёт выполняется менее чем за 50 мс
  • Поддержка: 2-5 осей на транспортном средстве
  • Центр тяжести: автоматический расчёт на основе позиций и весов грузов
  • Визуальная индикация: зелёный (норма), жёлтый (предупреждение), красный (перегруз)

Транспортные средства

LoadMaster Balans включает 15+ встроенных типов транспортных средств с точными параметрами габаритов, осей и kingpin. Также поддерживается создание кастомных ТС через админ-панель.

Полуприцепы

  • • Еврофура 13.6м (3 оси)
  • • Рефрижератор 13.6м
  • • Jumbo (юмба) 13.6м
  • • Еврофура 11м

Грузовики

  • • КАМАЗ-65117 (тент)
  • • КАМАЗ-53212 (борт)
  • • ГАЗон Next 10т
  • • Валдай Next
  • • ГАЗель Next (4.2м)
  • • Ford Transit LWB

Контейнеры

  • • Контейнер 20ft
  • • Контейнер 40ft
  • • Контейнер 40ft HC
  • • + Кастомные ТС

Кастомные транспортные средства

Через админ-панель можно создавать собственные типы транспортных средств с настройкой:

  • Габариты: длина, ширина, высота кузова
  • Оси: количество, позиции, максимальные нагрузки
  • Kingpin: позиция шкворня (для полуприцепов)
  • Название и описание

Кастомные ТС можно экспортировать в JSON и импортировать на других сайтах для переноса конфигураций.

Визуализация

Интерактивная Canvas-визуализация предоставляет профессиональные инструменты для размещения и управления грузами в реальном времени.

Основные функции

  • Drag-and-Drop: перемещение грузов мышью с контролем коллизий
  • Мульти-выделение: выбор нескольких грузов (Ctrl+Click)
  • Сетка: метровые деления для точного позиционирования
  • Snap к сетке: автоматическое выравнивание с шагом 10мм
  • Система слоёв: стекирование грузов в несколько ярусов
  • Визуализация осей: отображение позиций осей и kingpin
  • Цветовая индикация: визуальное отображение статуса нагрузок

Навигация

  • Зум: колёсико мыши, кнопки +/−, или 100% для сброса
  • Панорамирование: перетаскивание пустой области или стрелки клавиатуры
  • Мини-карта: обзор всей схемы с индикатором видимой области

Горячие клавиши

  • Del — удаление выбранных грузов
  • R — поворот груза на 90°
  • Ctrl+Z — отмена последнего действия
  • Ctrl+Shift+Z — повтор отменённого действия
  • Ctrl+Click — мульти-выделение грузов

Генератор “Хребет”

Генератор “Хребет” — это уникальный алгоритм оптимальной укладки паллет для максимального использования пространства транспортного средства.

Принцип работы

Алгоритм использует комбинацию продольных (“Хребет”) и поперечных (“Ребро”) паллет для создания оптимальной схемы размещения:

  • “Хребет”: продольные паллеты (1200×800) размещаются вдоль кузова
  • “Ребро”: поперечные пары паллет (800×1200) размещаются поперёк
  • Автоматический расчёт: система определяет оптимальную комбинацию для заданного количества паллет

Пример для 33 паллет:

9 “Хребтов” + 12 пар “Рёбер” = 33 паллеты, LDM = 13.2м

Поддерживаемые конфигурации

  • 21-33 паллеты в стандартной еврофуре 13.6м
  • Европаллеты: 1200×800×1450мм, вес 500кг
  • Финпаллеты: 1200×1000×1450мм, вес 600кг
  • Автоматический расчёт: система выбирает оптимальную схему

Экспорт и импорт

PDF-отчёт

Техническое задание на погрузку: информация о ТС, сводка нагрузки (общий вес, LDM, статус), таблица осевых нагрузок с процентами, скриншот схемы размещения, манифест грузов с координатами.

Поддержка кириллицы, логотип компании (опционально)

JSON

Полная структура проекта: метаданные (версия, дата), информация о ТС (габариты, оси, kingpin), слои с грузами (позиции, размеры, веса), результаты анализа (общий вес, LDM, осевые нагрузки).

Импорт/экспорт для переноса между сайтами

PNG скриншот

Высококачественный скриншот схемы размещения грузов. Автоматическое скрытие интерфейса, масштаб 2x для четкости.

Разрешение: до 4K, формат: PNG

Сохранение проектов

Для авторизованных пользователей доступно сохранение проектов в базе данных:

  • • Сохранение проектов с названием и описанием
  • • Список “Мои проекты” с датами создания и изменения
  • • Загрузка проектов одним кликом
  • • Удаление проектов
  • • Экспорт сохранённых проектов в JSON

Конфигурация

Настройки плагина

В админ-панели WordPress доступны следующие настройки:

  • Единицы измерения: миллиметры (мм) или сантиметры (см)
  • Тема интерфейса: светлая или тёмная
  • Язык интерфейса: русский (RU) или английский (EN)
  • Управление ТС: создание, редактирование, удаление транспортных средств
  • Управление шаблонами: создание, редактирование, удаление шаблонов грузов

Экспорт/импорт конфигураций

Для переноса настроек между сайтами доступны функции экспорта и импорта:

  • Экспорт ТС: сохранение кастомных транспортных средств в JSON
  • Импорт ТС: загрузка транспортных средств из JSON-файла
  • Экспорт шаблонов: сохранение шаблонов грузов в JSON
  • Импорт шаблонов: загрузка шаблонов из JSON-файла

Архитектура системы

Компоненты системы

  • Frontend: JavaScript (ES6+), Canvas API для визуализации, React-подобная архитектура компонентов
  • Backend: PHP 7.4+, WordPress API, REST API endpoints
  • База данных: MySQL для хранения проектов, ТС и шаблонов
  • Экспорт: TCPDF для генерации PDF, Canvas API для PNG

Структура данных

Проект сохраняется в следующем формате:

{
  "version": "1.0.0",
  "date": "2026-01-27T12:00:00Z",
  "vehicle": {
    "id": "eurofura-13.6",
    "name": "Еврофура 13.6м",
    "dimensions": { "length": 13600, "width": 2450, "height": 2700 },
    "axles": [...],
    "kingpin": -3800
  },
  "layers": [
    {
      "id": 1,
      "items": [
        {
          "id": "item-1",
          "x": 1000,
          "y": 500,
          "width": 1200,
          "length": 800,
          "height": 1450,
          "weight": 500,
          "rotation": 0
        }
      ]
    }
  ],
  "analysis": {
    "totalWeight": 15000,
    "ldm": 13.2,
    "axleLoads": [...]
  }
}

Лицензия

MIT License

LoadMaster Balans распространяется под лицензией MIT License, что означает:

  • Свободное использование: можно использовать в коммерческих и некоммерческих проектах
  • Модификация: можно изменять код под свои нужды
  • Распространение: можно распространять оригинальную или модифицированную версию
  • Открытый исходный код: полный доступ к коду без ограничений

Единственное требование — сохранение информации о лицензии и авторских правах в исходном коде.

Готовы начать работу с LoadMaster Balans?

Попробуйте систему бесплатно прямо сейчас.