Module: Fleet Management & Logistics (Автотранспорт та Логістика)¶

Цей модуль забезпечує повний цикл керування перевезеннями: від прийому заявки до розрахунку рентабельності рейсу та технічного обслуговування автопарку. Побудований за стандартом Single Source of Truth.

1. Master Data (Мастер-дані)¶

Сутність	Опис	Ключові поля
Vehicles (ТЗ)	Власний та найманий транспорт	Plate Number, VIN, Model, Payload (т), Volume (м³), Ownership (Own/Hired)
Drivers	База водіїв з їх допусками	Full Name, License Categories, License Expiry, Phone, Rating
Fuel Cards / Tanks	Паливні картки або власні АЗС	Provider, Card Number, Fuel Type (Diesel/Gas), Limit
Maintenance Norms	Регламенти ТО для моделей ТЗ	Model_ID, Service_Interval (km), Standard_Parts_List
Routes & Zones	Популярні маршрути та геозони	Start_Point, End_Point, Standard_Distance, Est_Duration

2. Transaction Data (Транзакційні дані)¶

Transport Request (Заявка на перевезення):
Вхідний документ від клієнта (через CRM).
Містить тип вантажу, точки завантаження/вивантаження, вимоги до температури/транспорту.
Waybill (Подорожній лист):
Центральний виконавчий документ. Поєднує водія, ТЗ та маршрут.
Фіксує: Одометр (старт/фініш), Залишок палива (старт/фініш), Маршрутні точки з відмітками часу.
Fuel Transaction (Паливна операція):
Заправка за чеком або імпорт даних з АЗС.
Пов'язана з Waybill для розрахунку фактичного розходу.
Repair Order (Ремонтна відомість):
Документ на проведення сервісних робіт.
Списує запчастини (через Inventory) та фіксує вартість робіт (через HRM або зовнішніх підрядників).
Freight Invoice (Акт виконаних робіт):
Фінансове нарахування доходу клієнту та витрат найманому перевізнику.

3. Journals & Ledgers (Журнали та реєстри)¶

A. Mileage & Odometer Ledger (Реєстр пробігу)¶

Накопичувальний облік кілометражу для планування ТО. * Dimensions: Vehicle_ID, Waybill_ID. * Resources: Distance_KM, Engine_Hours.

B. Fuel Ledger (Реєстр палива)¶

Контроль руху палива: Прихід (заправка) - Вихід (нормативи vs факт). * Dimensions: Vehicle_ID, Driver_ID, Fuel_Type. * Resources: Liters_Quantity, Amount_Cost, Overconsumption (Понаднормова витрата).

C. Vehicle Availability Ledger (Стан парку)¶

Журнал статусів ТЗ в реальному часі. * Dimensions: Vehicle_ID. * Resources: Status (In Route, Maintenance, Available, Broken).

4. Business Processes (Бізнес-процеси)¶

Dispatching (Диспетчеризація): Призначення ТЗ та водія на заявку з перевіркою їх доступності та придатності під тип вантажу.
Waybill Closure: Процес закриття рейсу, де система автоматично порівнює фактичний розхід палива з нормативним.
Preventive Maintenance Alerts: Автоматичне створення Repair Order при досягненні ліміту пробігу.
Settlements with Hired Carriers: Розрахунок маржинальності між ціною клієнта та ціною найманого транспорту.

5. Analytics & BI (Аналітика)¶

Реалізовано на Report Framework (2026-07-06), обидва — подвійне представлення (таблиця з розшифровкою до первинних документів ⇄ діаграми):

Статистика роботи транспорту (transport-statistics): по кожному ТЗ — рейси, пробіг, пальне, л/100км, виручка, грн/км з проведених подорожніх листів. Розшифровка → подорожні листи.
Відомість руху пального (fuel-movement): по ТЗ × вид пального — залишок поч., заправлено, видано за ПЛ, витрачено, злито, залишок кін. Джерело — FuelLedger. Розшифровка → заправки / подорожні листи / зливи.
Вигідність та окупність автопарку (vehicle-lifecycle): по кожному власному ТЗ (накопичено на дату) — первісна вартість, згенерована цінність, витрати експлуатації, внесок, % окупності, ₴/км за 12 міс і сигнал «тримати / планувати заміну / продавати». Джерело — агрегатор життєвого циклу (амортизація + пальне + ЗП + ремонти проти виручки). Працює для transport-company (реальна виручка) і внутрішнього транспорту (зіставна виручка = робота × бенчмарк-тариф TransportBenchmarkTariff). Показує, чи вигідно далі тримати авто в парку. ADR adr-2026-07-15-vehicle-lifecycle-economics.
Економічний вік та заміна ТЗ (vehicle-replacement): forward-looking модель — поточний вік, річні витрати, оптимальний економічний строк (мінімум EUAC), років до заміни, залишкова вартість і статус «в межах / наближається / перевищено ресурс». Відповідає на питання «коли продавати».

Деталі — docs/ai/domains/fleet/reports.md.

Заплановано:

Cost per KM: Повний розріз витрат (паливо + ремонт + з/п) на 1 км пробігу.
Fuel Efficiency: Рейтинг водіїв за показниками економії палива.
Fleet Downtime: Аналіз часу перебування ТЗ у ремонті порівняно з часом у рейсах.
LTL/FTL Profitability: Аналіз рентабельності повних та часткових завантажень.
Empty Miles: Відсоток холостого пробігу без вантажу.

6. Architectural Proposal: High-Frequency Data Handling¶

VehicleLocationHistory (GPS Tracking)¶

Для зберігання координат та історії переміщення ТЗ рекомендується використовувати окрему NoSQL базу даних (наприклад, Redis для поточних координат або InfluxDB для часових рядів).

Аргументація: * Продуктивність: При інтеграції з GPS-трекерами система може отримувати тисячі точок щохвилини. Використання основної PostgreSQL для цих цілей призведе до надмірного розростання таблиць та сповільнення роботи всієї DOP. * Масштабованість: NoSQL рішення краще справляються з write-heavy навантаженням. * Гібридний підхід: У PostgreSQL зберігаються лише агреговані дані (фінальний пробіг за рейсом у Waybill), тоді як детальний "трек" зберігається у спеціалізованому сховищі.