Перейти до змісту

Logistic Module (Multimodal Freight & Forwarding)

💎 Статус: платний плагін, навмисно поза community backend-збіркою. Frontend-config logistic.ts + ці документи лишаються як еталонний кейс механізму exclusion (див. plugin-instruction).

Галузевий вертикальний модуль для логістичних / експедиторських компаній: від прийняття замовлення клієнта до доставки вантажу одержувачу. Підтримує мультимодальні ланцюги (rail → road → sea), консолідацію N→1 (наприклад, зерно з елеваторів у морський порт) та дистрибуцію 1→N (останню милю з одного складу).

Навігація: - operations.md — детальна операційна модель (master data, transactions, journals, analytics) - architecture.md — Django-моделі, status-flow, сценарії (Kyiv→Toronto, Ukraine→Egypt grain), distribution logistics

1. Ключові сутності

Модель Призначення
LogisticOrder Замовлення клієнта на перевезення
RouteSheet Маршрутний лист (план доставки)
ContainerType Довідник типів контейнерів

2. LogisticOrder — замовлення клієнта

  • number / date
  • client → Client
  • contract → Contract
  • pickup_location / delivery_location — точки
  • pickup_date / required_delivery_date
  • cargo_description — опис вантажу
  • weight / volume / pieces
  • container_type → ContainerType (якщо контейнерні перевезення)
  • tariff → ContractSpecification
  • amount / currency / vat_mode
  • status — new / confirmed / in_transit / delivered / cancelled

3. RouteSheet — маршрутний лист

Консолідація замовлень у один рейс: - driver → Driver (Fleet) - vehicle → Vehicle - orders — M2M LogisticOrder - route → Route (фіксований) або waypoints (вручну) - planned_departure / planned_arrival - status — planned / started / completed

4. Frontend-компоненти

5. Зв'язок з іншими модулями

  • Fleet — використовує Vehicle, Driver, Route, Waybill (рейс по маршрутному листу)
  • ContainerHub — для контейнерних операцій
  • Essentials — Invoice (рахунок клієнту за перевезення)

6. Бізнес-процес

1. Клієнт подає заявку → LogisticOrder (new)
2. Менеджер підтверджує → confirmed
3. Планування: RouteSheet + консолідація в рейс
4. Старт рейсу: Waybill (Fleet) створюється з RouteSheet
5. Трекінг: GPS + статуси
6. Доставка → delivered
7. Фінансовий етап: Invoice клієнту

🔮 Deferred / Ideas

Automated route optimization

Мотивація: диспетчер вручну планує порядок заїзду — витрачає час Чому відкладено: потрібна VRP-бібліотека + тестовий набір Trigger: логістична компанія з >20 щоденними рейсами

Customer self-service tracking portal

Мотивація: клієнт хоче бачити де його вантаж без дзвінків Чому відкладено: потрібна інтеграція з Client Portal + GPS Trigger: запит клієнтів на tracking-посилання

Automated invoice generation on delivery

Мотивація: після delivered — автоматично виставити рахунок Чому відкладено: потрібен workflow + перевірка тарифу Trigger: стабілізація процесів

Cross-docking workflow

Мотивація: при перевалці зі фури на фуру — облік у точці перевалки Чому відкладено: складна логіка статусів Trigger: склад-хаб у клієнта

Пов'язане