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

premium-logistics-bot

Внутренняя система учёта поломок и ТО автопарка

Чат-бот и веб-панель, которые убрали хаос из чатов и Excel, собрав все поломки, ТО и работу механиков в единую прозрачную систему.

telegram-bot web-panel rest-api automation
99.8% uptime
~50ms avg response
📦
4 user roles
🔄
24/7 monitoring
📄 README.md

# Контекст

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

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

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

# Задача

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

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

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

┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐
│    ВОДИТЕЛИ     │     │    МЕХАНИКИ     │     │     АДМИНЫ      │
│   (MAX Bot)     │     │   (Web Panel)   │     │   (Web Panel)   │
└────────┬────────┘     └────────┬────────┘     └────────┬────────┘
         │                       │                       │
         └───────────────────────┼───────────────────────┘
                                 │
                    ┌────────────▼────────────┐
                    │      REST API          │
                    │   (Express.js + Auth)  │
                    └────────────┬────────────┘
                                 │
                    ┌────────────▼────────────┐
                    │       SQLite DB         │
                    │  (заявки, авто, юзеры)  │
                    └─────────────────────────┘

# Решение

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

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

→ Веб-панель для механиков и админов

📋
Таблица заявок Фильтры по статусу, типу, номеру авто
🚗
Автопарк История поломок и ТО по каждой машине
📊
Отчёты Аналитика по автопарку и механикам
🔐
Роли Админ, механик, водитель, бухгалтер

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

notifications Уведомления админов через MAX-бота с гибкой настройкой событий
database Оптимизированная SQLite: индексы по ключевым полям для быстрого API
frontend SPA-подход: динамическая загрузка через Fetch API без тяжёлых фреймворков
scaling План миграции на PostgreSQL при росте нагрузки

# Результат

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

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

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

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

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