/home / /projects / premium-logistics-bot
PRODUCTION #001

premium-logistics-bot

Платформа управления автопарком: заявки, ТО, опросы водителей и аналитика

MAX-бот для водителей и веб-панель для механиков, логистов и руководства. Из разрозненных чатов и Excel выросла единая система: ремонты, плановое ТО, ежедневные опросы состояния авто, пересадки, медиа-вложения и сквозная аналитика по автопарку.

max-bot web-panel fleet-management maintenance-ТО rbac rest-api automation
99.8% uptime
~50ms avg response
📦
11 modules
🔐
4 user roles
📄 README.md

# Контекст

В логистике всё держится на предсказуемости: машина должна выйти в рейс, доехать, вернуться и снова быть готовой к работе. На деле же каждая поломка начиналась одинаково: звонок, голосовое, сообщение в общем чате.

Кто‑то записал проблему в таблицу, кто‑то забыл, кто‑то «обязательно занесёт потом». Через пару месяцев никто не мог честно ответить на вопрос:

«Что сейчас с нашим автопарком и какие машины нас подводят чаще всего?»

# Задача

Заказчику нужен был не очередной «портал для галочки», а рабочий инструмент:

Не мешает водителям — минимум действий, всё в одном месте
Прозрачная очередь задач вместо чатового шума
История по каждому авто и тенденции для управленцев

# Архитектура

┌────────────┐  ┌────────────┐  ┌────────────┐  ┌────────────┐
│  ВОДИТЕЛИ   │  │  МЕХАНИКИ   │  │   ЛОГИСТЫ   │  │ РУКОВОДСТВО │
│  (MAX Bot)  │  │ (Web Panel) │  │ (Web Panel) │  │ (Web Panel) │
└──────┬─────┘  └──────┬─────┘  └──────┬─────┘  └──────┬─────┘
       └───────────────┴───────┬───────┴───────────────┘
                               │
                  ┌────────────▼────────────┐
                  │        REST API          │
                  │  Express.js + RBAC-auth  │
                  └────────────┬────────────┘
          ┌────────────────────┼────────────────────┐
          ▼                    ▼                    ▼
 ┌────────────────┐  ┌────────────────┐  ┌────────────────┐
 │   SQLite DB    │  │ Медиа (Multer) │  │  Уведомления   │
 │ заявки·авто·ТО │  │   фото/видео   │  │   → MAX-бот    │
 └────────────────┘  └────────────────┘  └────────────────┘

# Решение

→ Бот для водителей

bot: Выберите номер авто
user: А001АА
bot: Укажите пробег
user: 145200
bot: Тип проблемы?
user: Не электрика
bot: Опишите проблему
user: Стук в подвеске спереди слева
bot: ✓ Заявка #1847 создана
  • Работает в MAX — там, где команда общается каждый день
  • Пошаговый сценарий: номер авто → пробег → тип → описание
  • Фото и видео поломки прикрепляются прямо из чата
  • Регулярные опросы состояния авто (чек-ины) — бот сам спрашивает водителя
  • Режим механика: просмотр и закрытие поломок по номеру авто
  • Для водителя это диалог, для системы — структурированная заявка с ID

→ Веб-панель: 11 модулей для механиков, логистов и руководства

📋
Заявки на ремонт Фильтры по статусу/типу/авто, поиск, экспорт в CSV
🚗
Автопарк Карточка авто, история поломок и ТО, учёт пробега
🛠
Автозаявки и ТО Шаблоны ТО, журнал работ, плановые задачи по пробегу
🧾
Опросы водителей Регулярные чек-ины состояния авто через бота
🔁
Пересадки Передача авто между водителями и рейсами
📊
Отчёты Аналитика по автопарку, типам поломок и механикам
📚
База знаний Инструкции и регламенты для команды
🔔
Журнал уведомлений Лог событий, настройка типов и шаблонов сообщений
🎬
Видео-плеер Просмотр фото и видео, прикреплённых к заявкам
👥
Пользователи и роли RBAC: админ, механик, водитель, бухгалтер
⚙️
Администрирование Управление ботом, уведомлениями и доступами

# Как выглядит панель

Стилизованные мокапы ключевых экранов веб-панели. Данные условные — для демонстрации структуры интерфейса.

premium-logistics — Заявки
Все Активные Исправлено Электрика 🔍 поиск по авто…
#АвтоПроблемаТипСтатус
1847А012ВХ23Стук в подвеске спереди слеване электрикаАктивна
1846В884КС23Не работают габаритыэлектрикаАктивна
1845Е551МР123Замена тормозных колодокне электрикаИсправлено
1844К203ОТ23Течь антифризане электрикаИсправлено
premium-logistics — Отчёты
128заявок всего
17активных
34ТО за месяц
12авто в парке
Топ авто по числу поломок
В884КС2318
А012ВХ2312
Е551МР1238
К203ОТ235
premium-logistics — Автопарк
А012ВХ23 2 поломки
пробег: 145 200 км
ТО: 12.06.2025
электрика: ок
В884КС23 электрика
пробег: 210 540 км
ТО: 28.05.2025
в ремонте
Е551МР123 исправно
пробег: 98 760 км
ТО: 04.06.2025
след. ТО через 1 240 км

// демонстрационный интерфейс — реальные данные клиента не публикуются

# Технические особенности

notifications Уведомления админов через MAX-бота с гибкой настройкой событий и шаблонов
media Загрузка фото/видео поломок (Multer), хранение и привязка к заявкам
scheduler Планировщик опросов водителей и очередь отправки сообщений в бота
rbac Ролевой доступ (admin/mechanic/driver/accountant), пароли через bcrypt
database SQLite (better-sqlite3): индексы по ключевым полям, история пробега и ТО
reliability PM2 + watchdog-скрипт: автоперезапуск бота и контроль доступности
frontend SPA-подход на Fetch API без тяжёлых фреймворков, тёмная/светлая тема
scaling План миграции на PostgreSQL при росте нагрузки

# Результат

Заявки перестали теряться в чатах: у каждой есть ID, статус, автор

Руководство увидело реальную картину: какие машины тянут бюджет вниз

Водителям не нужно осваивать новый интерфейс — просто пишут боту

У механиков появился единый инструмент вместо десятка чатов

Плановое ТО и опросы водителей перевели парк из режима «тушим пожары» в профилактику

Фото и видео в заявках убрали споры «было/не было» при приёмке работ

start-project.sh
# Хотите похожую систему для своего бизнеса?
# Начать можно без ТЗ на 40 страниц.
 
$ describe --current-state "как живёте сейчас"
$ identify --pain-points "где теряются данные/время"
$ define --success-criteria "что будет успехом через 3-6 мес"
 
→ На основе этого предложу архитектуру и поэтапный план
 
─────────────────────────────────────────────