ConcreteBuildControl bot

Nazwa projektu: System automatyzacji logistyki i dostaw obiektów budowlanych (Bot Telegram)
Krótki opis: Opracowałem kompleksowego bota Telegram dla firmy budowlanej, który w pełni zautomatyzował cykl zakupu materiałów: od zgłoszenia kierownika budowy na obiekcie do dostawy i raportowania. System wykorzystuje Google Sheets jako bazę danych i CRM, co pozwala klientowi zarządzać procesami w znanym interfejsie bez wydatków na drogie panele administracyjne.

Problem, który rozwiązuje projekt:
Wcześniej komunikacja odbywała się w chaotycznych czatach: zgłoszenia ginęły, PTO (dział inżynieryjny) nie zdążał zatwierdzać faktur, a dostawcy nie wiedzieli, co i gdzie przewozić. Brakowało przejrzystości statusów zamówień.

Funkcjonalność i Role:
Bot realizuje system rozgraniczenia praw dostępu (RBAC) dla 4 typów użytkowników:

1. Kierownik budowy (Foreman):
Tworzenie zgłoszeń na materiały (tekst lub zdjęcie).
Wybór obiektu z dynamicznej listy.
Przyjęcie materiałów na obiekcie (obowiązkowy raport zdjęciowy + komentarz).
Ewidencja materiałów od zamawiającego.
Cotygodniowe raporty o zużyciu materiałów.
Otrzymywanie powiadomień o statusie zgłoszenia ("Odrzucone", "Jedzie samochód").

2. PTO (Kontrola inżynieryjna):
Walidacja zgłoszeń: przyciski "Zatwierdź" / "Odrzuć".
Możliwość edytowania listy materiałów przed zatwierdzeniem.
Przeglądanie zgłoszeń zdjęciowych i raportów o przyjęciu.
Automatyczne przekazywanie zatwierdzonych zgłoszeń do działu dostaw.

3. Dostawy (Supply):
Otrzymywanie powiadomień o nowych zatwierdzonych zgłoszeniach (ze zdjęciami i szczegółami).
Oznaczanie zgłoszeń statusem "Zamówione".

4. Logistyka:
Kontrola gotowych do wysyłki ładunków.
Zmiana statusu na "Wysłane" (automatyczne powiadomienie kierownika budowy).

Stos technologiczny:
Język: Python 3.10+
Framework: aiogram 3.x (architektura asynchroniczna).
Baza danych: Google Sheets API (biblioteka gspread). Używana jako Baza Danych dla łatwości edytowania przez menedżerów.
Deployment: VPS (Linux), PM2 do zarządzania procesami.

Kluczowe rozwiązania techniczne (High-lights):
Optymalizacja pamięci: Zrealizowano niestandardowe zarządzanie pamięcią za pomocą gc (Garbage Collector) oraz zoptymalizowanych zapytań do API Google. To pozwoliło na zmniejszenie zużycia RAM na słabym VPS, unikając ładowania dużych zbiorów danych.

Niezawodne wyszukiwanie danych: Opracowano algorytm "Smart Search", który znajduje ID zamówienia w tabeli niezależnie od formatowania (ignoruje zera z lewej, spacje, tekstowy format komórek), co wyeliminowało błędy przy ręcznym edytowaniu tabeli przez menedżerów.

Bezproblemowa interakcja: Zrealizowano łańcuch wiadomości. Po naciśnięciu przycisku "Zatwierdź" bot nie tylko zmienia zapis w Baza Danych, ale natychmiast wysyła utworzoną kartę zamówienia (ze zdjęciem) do czatu następnego działu.

Wynik:
Bot połączył pracę działów w jeden strumień. Czas przetwarzania zgłoszenia skrócił się, straty informacji zostały zredukowane do zera, a kierownictwo otrzymało przejrzyste raporty w Google Arkuszach w czasie rzeczywistym.