ConcreteBuildControl бот

Назва проєкту: Система автоматизації логістики та постачання будівельних об'єктів (Telegram Bot)
Короткий опис: Розробив комплексний Telegram-бот для будівельної компанії, який повністю автоматизував цикл закупівлі матеріалів: від заявки виконроба на об'єкті до доставки та звітності. Система використовує Google Sheets як базу даних та CRM, що дозволяє клієнту керувати процесами у звичному інтерфейсі без витрат на дорогі адмін-панелі.

Проблема, яку вирішує проєкт:
Раніше комунікація велася в хаотичних чатах: заявки губилися, ПТО (інженерний відділ) не встигав погоджувати рахунки, а постачання не знало, що і куди везти. Була відсутня прозорість статусів замовлень.

Функціонал та Ролі:
Бот реалізує систему розмежування прав доступу (RBAC) для 4-х типів користувачів:

1. Виконроб (Foreman):

Створення заявок на матеріали (текст або фото).

Вибір об'єкта з динамічного списку.

Прийом матеріалів на об'єкті (обов'язковий фотозвіт + коментар).

Облік матеріалів від замовника.

Тижневі звіти списання матеріалів.

Отримання сповіщень про статус заявки ("Відхилено", "Їде машина").

2. ПТО (Інженерний контроль):

Валідація заявок: кнопки "Погодити" / "Відхилити".

Можливість редагування списку матеріалів перед погодженням.

Перегляд фото-заявок та звітів про прийом.

Автоматична передача погоджених заявок у відділ постачання.

3. Постачання (Supply):

Отримання сповіщень про нові погоджені заявки (з фото та деталями).

Маркування заявок статусом "Замовлено".

4. Логістика:

Контроль готових до відправки вантажів.

Зміна статусу на "Відправлено" (автоматичне сповіщення виконробу).

Технічний стек:
Мова: Python 3.10+

Фреймворк: aiogram 3.x (асинхронна архітектура).

База даних: Google Sheets API (бібліотека gspread). Використовується як БД для легкості редагування менеджерами.

Деплой: VPS (Linux), PM2 для керування процесами.

Ключові технічні рішення (High-lights):
Оптимізація пам'яті: Реалізовано кастомний менеджмент пам'яті за допомогою gc (Garbage Collector) та оптимізованих запитів до API Google. Це дозволило знизити споживання RAM на слабкому VPS, уникнувши завантаження великих масивів даних.

Надійний пошук даних: Розроблено алгоритм "Smart Search", який знаходить ID замовлення в таблиці незалежно від форматування (ігнорує нулі зліва, пробіли, текстовий формат клітинок), що виключило помилки при ручному редагуванні таблиці менеджерами.

Безшовна взаємодія: Реалізовано ланцюжок повідомлень. При натисканні кнопки "Погодити" бот не просто змінює запис у БД, а миттєво надсилає сформовану картку замовлення (з фото) у чат наступного відділу.

Результат:
Бот об'єднав роботу відділів в єдиний потік. Час обробки заявки скоротився, втрати інформації зведені до нуля, а керівництво отримало прозору звітність у Google Таблицях у реальному часі.