Automatyzacja · Flota · Python

Raport spalania floty z kilometrami sprawdzonymi z GPS

Automat co rano sprawdza, czy ma komplet danych za zamknięty miesiąc. Sam pobiera tankowania z portalu kart, stan licznika z GPS i przypisania kierowców z CRM, liczy spalanie każdego pojazdu i rozsyła raport. Człowiek wchodzi wtedy, gdy automat o to poprosi.

Klient
RAN-SIGMA Sp. z o.o.
Branża
Gospodarka odpadami
Rok
2026
Narzędzie
Python na serwerze firmy
Status
Wdrożone · produkcyjnie od września 2026

Wyzwanie

Zastrzeżenie: RAN-SIGMA to firma, którą zarządzam. Ten automat powstał na jej potrzeby i działa tam produkcyjnie od 8 września 2026 — tak samo testuję każde rozwiązanie, zanim zaproponuję podobne klientowi.

Dane do policzenia spalania istniały, ale w czterech miejscach: tankowania w portalu operatora kart paliwowych, stan licznika wpisywany ręcznie przez kierowcę przy dystrybutorze, kilometry w systemie GPS pojazdów, a to, kto jeździ którym autem, w CRM. Poprzednia wersja raportu wymagała, żeby co miesiąc ktoś ręcznie wyeksportował tankowania z portalu i przekazał plik dalej. Kilometry brała wyłącznie z wpisów kierowców, a te bywają błędne: zero zamiast stanu licznika, dopisana cyfra, licznik po wymianie.

Druga trudność to kalendarz. Paliwo zatankowane do pełna w ostatnich dniach miesiąca spala się w następnym. Proste sumowanie litrów po dacie tankowania zawyża jeden miesiąc i zaniża drugi, a w raporcie wygląda to jak nagły problem z pojazdem.

Jak działa automat

Zasada: automat liczy i wskazuje, nie poprawia za ludzi. Kierowcy tankują i wpisują przebieg jak dotąd. Jedyne miejsce, w którym człowiek steruje automatem, to słownik pojazdów na Dysku: kategoria, norma, wykluczenia. Ten sam wzorzec — dane bez przepisywania, kontrola przed liczeniem, raport i mail z podsumowaniem — stoi za automatem wyników finansowych tej samej firmy.

Dane pobiera sam

Codziennie rano automat sprawdza, czy ma komplet danych za zamknięty miesiąc. Eksport tankowań pobiera z portalu operatora kart paliwowych tak, jak zrobiłby to pracownik. Stan licznika pobiera z systemu GPS, a przypisania kierowców z CRM firmy. Folder-wrzutnia na Dysku zostaje jako droga zapasowa, gdy portal zawiedzie.

Odsiew błędnych wpisów licznika

Zero albo jedynka zamiast stanu, licznik cofnięty o dziesiątki tysięcy kilometrów, dopisana cyfra, odczyt odstający od reszty miesiąca: taki wpis jest odrzucany z nazwanym powodem i trafia do zestawienia „Licznik błędnych stanów”. Wymianę licznika automat rozpoznaje po kolejnych spójnych odczytach i nie liczy z niej kilometrów.

Paliwo od tankowania do tankowania

Zużycie miesiąca to paliwo przeniesione z poprzedniego miesiąca plus tankowania w miesiącu minus ostatnie tankowanie, które przechodzi dalej. Okno kilometrów ma te same końce co okno litrów: granicą jest ostatnie tankowanie z poprawnym wpisem licznika. W skali roku żaden litr nie ginie i żaden nie jest liczony dwa razy.

Wpisy kierowców kontra GPS

W chwili tankowań, które zamykają okno miesiąca, automat pyta system GPS o stan licznika. Kilometry z wpisów i z GPS dotyczą więc tego samego odcinka trasy. Gdy różnica przekracza 5% (próg ustawiany w konfiguracji), pojazd trafia do tabeli z kierowcą z CRM i oznaczeniem „pierwszy raz w okresie” albo „cyklicznie”, gdy rozbieżność wraca w kolejnych miesiącach. Rozbieżność nie zmienia wyniku: to sygnał do rozmowy, nie korekta. Pojazd bez nadajnika GPS nie jest porównywany.

Wynik ukryty, gdy nie da się mu ufać

Za mały przebieg, wymiana licznika, długa przerwa w tankowaniach, wartość spoza realnego pasma: spalanie dostaje „n/d” z nazwanym powodem i nie wchodzi do średniej. Średnia floty i kategorii jest ważona przebiegiem, nigdy liczona jako średnia ze średnich. Litry i koszt takiego pojazdu zostają w sumach.

Paliwo spoza kart

Wydanie z firmowej stacji, zakup za gotówkę i przepompowanie paliwa między pojazdami wpisuje się w osobnym arkuszu słownika. Przepompowanie to dwa wiersze: plus u biorcy i minus u dawcy. Flota nie liczy tych litrów dwa razy, a dawca nie dostaje zużycia, którego nie miał.

Raporty i mail z podsumowaniem

Po każdym nowym miesiącu na Dysk trafiają raport miesięczny PDF i XLSX, raport roczny i zestawienie zbiorcze. Mail ma numerowane sekcje: flota w skrócie, porównanie z poprzednim miesiącem, czerwone alerty, wpisy kontra GPS, pojazdy do uzupełnienia, a w załączniku komplet plików. Każde uruchomienie przelicza całą historię od zera, więc ponowne przeliczenie miesiąca podmienia wyniki zamiast je dublować.

Przypomnienia, błędy i kopia

Gdy eksportu za miesiąc brakuje, czwartego dnia idzie przypomnienie, szóstego pilne, potem jeszcze ósmego i dziesiątego. Każdy nieobsłużony błąd kończy się mailem z fragmentem logu. Co noc powstaje kopia zapasowa stanu i pobranych plików, bez haseł: odtworzenie serwera to instalacja i ponowne wpisanie kluczy.

Co rozstrzyga automat, a co człowiek

Automat: arytmetyka, kontrola, wskazanie

Automat liczy litry, kilometry i koszt, ocenia każdy pojazd wobec normy jego kategorii (zielony, żółty, czerwony; zimą progi są łagodniejsze), wskazuje błędne wpisy i pojazdy bez kierowcy w CRM. Nowy pojazd dopisuje do słownika sam, z kategorią do uzupełnienia, i w pierwszym miesiącu nie ocenia go wobec normy: to okres nauki. Twarde alerty, np. litry bez kilometrów, działają od początku.

Człowiek: rozmowa i decyzja

Automat nie poprawia wpisów za kierowcę i nie ocenia ludzi. Rozmowę z kierowcą, który wpisuje błędne stany, poprawki przypisań w CRM, kategorię nowego auta i decyzję, co zrobić z przekroczeniem normy, zostawia osobie odpowiedzialnej za flotę. Raport ma tę rozmowę ułatwić: pokazuje pojazd, kierowcę i to, czy problem się powtarza.

Dlaczego program, a nie asystent AI

Spalanie jest podstawą rozmów z kierowcami, więc każda liczba musi wyjść tak samo przy każdym przeliczeniu i dać się odtworzyć ręcznie. Dlatego rdzeń to zwykły program w Pythonie z 241 testami automatycznymi (stan na 5.11.2026), a nie model językowy. Asystent AI pomagał pisać i sprawdzać kod, ale w samym liczeniu nie uczestniczy.

Jak wygląda wynik

Prawdziwych raportów spółki nie publikujemy. Poniżej są wycinki raportu wygenerowane tym samym kodem na fikcyjnych danych testowych: firma, pojazdy, kierowcy i liczby są zmyślone, a układ, obliczenia i reguły pochodzą z działającego automatu.

Harmonogram: produkcja od 8 września, rozbudowa do listopada 2026

  • 7.09.2026: kontrakt danych i pierwsze moduły — wczytywanie eksportów, metoda od tankowania do tankowania, raporty.
  • 8.09.2026: automat na serwerze firmy — pobieranie eksportu z portalu kart, kilometry z GPS na granicach okien, kierowcy z CRM, mail z sekcjami. Pierwsze uruchomienie przeliczyło historię tankowań od czerwca 2025.
  • 9.09.2026: kierowcy miesiąc po miesiącu prosto z CRM, nocna kopia zapasowa, instrukcje na Dysku firmy.
  • 21.10.2026: paliwo z firmowej stacji — nowe ciągniki dostały pierwsze baki z zasobu firmy, zanim miały własne karty.
  • 2–5.11.2026: przepompowanie paliwa między pojazdami i zakupy poza kartą, lista pojazdów bez kierowcy prosto z CRM, poprawki przypisań przy niepełnym miesiącu.

Wynik od września 2026

Raport za zamknięty miesiąc powstaje bez ręcznego eksportu, gdy portal kart działa. Osoba odpowiedzialna za flotę włącza się wtedy, gdy automat poprosi o to mailem. Spalanie każdego pojazdu jest liczone na tym samym odcinku trasy co litry, a wpisy kierowców są porównywane z GPS wszędzie tam, gdzie pojazd ma nadajnik.

4
źródła danych w jednym raporcie: karty, GPS, CRM i słownik pojazdów
co rano
sprawdzenie, czy jest komplet danych za zamknięty miesiąc
od 06.2025
cała historia przeliczana od zera przy każdym uruchomieniu

Co zastąpił automat

  • Ręczny eksport z portalu co miesiąc — automat pobiera go sam, a o nieudanym pobraniu informuje mailem
  • Kilometry brane na wiarę — wpisy kierowców są porównywane z GPS na tym samym odcinku trasy
  • Skoki spalania na przełomie miesięcy — ostatnie tankowanie przechodzi do kolejnego miesiąca razem z kilometrami, które na nim przejechano
  • „Kto jeździł tym autem?” — kierowca z CRM stoi przy pojeździe w tabelach i w mailu

Co dziś zrobiłbym inaczej

Od pierwszego dnia sprawdzałbym, jak stary jest każdy odczyt z zewnętrznego systemu. Zapytanie o stan licznika w danej chwili zwracało najbliższy zapisany punkt, także sprzed montażu nadajnika, a taki odczyt wyglądał na poprawny. Fałszywe alarmy zniknęły, gdy automat zaczął odrzucać pomiar GPS oddalony od tankowania o ponad dobę.

Paliwo spoza kart też warto mieć w modelu od początku. Doszło dopiero wtedy, gdy nowe ciągniki zatankowano z firmowej stacji, zanim dostały własne karty.

Kiedy takie rozwiązanie nie ma sensu

Przy kilku samochodach osobowych wystarczy arkusz albo raport z portalu kart. Ten automat rozwiązuje inny problem: łączy karty paliwowe, GPS, CRM i słownik pojazdów z różnymi normami kategorii i pokazuje rozbieżności we wpisach przebiegu.

Jeśli system telematyczny floty sam liczy spalanie z wiarygodnych danych o paliwie, lepiej zacząć od niego. Tu tak nie było: odczyty paliwa z sond w zbiornikach są za mało dokładne, więc z GPS automat bierze wyłącznie kilometry. Warunkiem jest też dyscyplina wpisów: pojazd, którego kierowca nie wpisuje przebiegu, a który nie ma GPS, zostanie w raporcie z „n/d”. Jak takie źródła połączyć bez przepisywania, opisujemy na stronie integracji API.

Czego tu nie ma

Na tej stronie nie ma liczb z raportów spółki, rejestracji pojazdów, nazwisk kierowców ani nazw dostawców kart i GPS. Pokazujemy mechanizm, bo to on jest przenośny między firmami. Dane floty RAN-SIGMA pozostają wewnątrz firmy.

Pytania i odpowiedzi

Pytania o ten projekt

Czy kierowcy muszą zmienić sposób pracy?

Nie. Tankują kartą i wpisują stan licznika przy dystrybutorze tak jak dotąd. Zmienia się tylko to, że błędny wpis widać w raporcie razem z kierowcą przypisanym w CRM i oznaczeniem „pierwszy raz w okresie” albo „cyklicznie”.

Co się dzieje z błędnym wpisem licznika?

Automat go odrzuca z nazwanym powodem (zero, cofnięcie, skok, odczyt odstający) i liczy kilometry z poprawnych wpisów. Gdy z wpisów nie da się nic policzyć, a pojazd ma GPS, kilometry bierze z GPS i zaznacza to w raporcie. Wpisu za kierowcę nie poprawia.

Dlaczego nie sumować litrów po dacie tankowania?

Bo paliwo zatankowane do pełna pod koniec miesiąca spala się w następnym. Metoda od tankowania do tankowania przenosi ostatnie tankowanie na kolejny miesiąc razem z kilometrami, które na nim przejechano. W skali roku suma litrów się zgadza, a pojedynczy miesiąc nie skacze.

Dlaczego podstawą są liczniki, a nie GPS?

Taką decyzję podjąłem po porównaniu obu źródeł: liczniki są tym samym źródłem, na którym stały wcześniejsze raporty, więc nowe wyniki dają się zestawić z historią. GPS kontroluje wpisy i zastępuje je tylko wtedy, gdy z liczników nic nie wychodzi. Danych o paliwie z sond automat nie używa, bo są za mało dokładne.

Co z paliwem tankowanym poza kartą?

Wydanie z firmowej stacji, zakup za gotówkę albo kartą kredytową i przepompowanie między pojazdami wpisuje się w osobnym arkuszu słownika pojazdów. Automat dolicza te litry do spalania, a koszt zostaje tam, gdzie wydano pieniądze.

Gdzie działa automat i kto ma dostęp do danych?

Na serwerze firmy, na osobnym koncie systemowym. Hasła do portalu kart, systemu GPS i poczty są tylko na serwerze, a nocna kopia zapasowa ich nie zawiera. Raporty trafiają do folderu floty na Dysku firmy i do ustalonej listy odbiorców.

Spalanie floty liczysz ręcznie z eksportu kart?

Na pierwszej rozmowie sprawdzamy, jakie dane już macie: eksport kart paliwowych, GPS, przypisania kierowców. I czy da się z nich liczyć spalanie bez ręcznego przepisywania.

Szczegóły projektu

Technologie

Python · openpyxl · reportlab · Google Drive API · API systemu GPS · API CRM · systemd

Zakres prac