Телеграм бот для грузоперевозок по РФ

Описание

Префикс заявки( с ндс, без ндс, нал)

Техническое задание (ТЗ) на Telegram-бота для управления заявками на перевозку

1. Общее описание

Бот предназначен для:

· Создания заявок на перевозку и назначения их конкретным водителям.
· Подтверждения заявок водителями.
· Контроля выполнения и формирования отчетов для руководителя.

---

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

2.1. Для диспетчера ( создающего заявки)

· Создание заявки на перевозку:
- Префикс заявки
· Выбор водителя из списка
· Указание параметров перевозки:
· Точка А → Точка Б (адреса или геолокация).
· Дата и время выполнения.
· Тип груза (опционально).
· Вес/объем (опционально).
· Комментарий.
· Возможность прикрепить файл (накладная, фото груза и т. д.).
· Просмотр всех заявок:
· Фильтрация по статусу (новая, подтверждена, выполнена, отменена).
· Редактирование заявки,отмена (если статус "новая, подтвержденная").

2.2. Для водителя
🚛
· Уведомление о новой заявке (автоматически при назначении).
· Подтверждение заявки:
· Кнопки "✅ Принять" ( возможностью указать коментарий).
· Изменение статуса заявки: "в пути на загрузку", "на загрузке"
· "В пути" → "Доставлено" (с возможностью коментарий и подтверждения- фото).
· Просмотр своих заявок (активные, завершенные).

2.3. Для руководителя

· панель управления с аналитикой:
· Количество заявок за период.
· Загрузка водителей (рейтинг активности).
· Ручная корректировка:
· Переназначение водителя.
· Отмена заявки.
· Экспорт отчетов (Excel/PDF).

3. Безопасность и доступ

· Ролевая модель:
· Диспетчер: может создавать/редактировать заявки.
· Водитель: только свои заявки + подтверждение.
· Руководитель: полный доступ + отчеты.
· Верификация:
· Регистрация по номеру телефона или ID сотрудника.

4. Чат между диспетчером и водителем внутри заявки.

Решение

- Создана иерархия хендлеров для оработки Python + teleAPI
- Реализована логика хранения вложений, текста, пользователей.
- Логика состояний: регистрация, чаты водителя и диспетчера.
- Реализованы дашборды для руководителя и других ролей
- Выгрузка отчетов в xlsx/pdf

Результат

Бот помогает фиксировать результаты работы по заявкам, контролировать персонал и оптимзировать мониторинг рабочего процесса.

Ссылки на примеры реализации

 github.com/lovemetrue/Next-25

Презентация проекта