Vibe coding a ewidencja czasu pracy - czego AI-generowany software nie ogarnia

Miniatura wpisu: Vibe coding a ewidencja czasu pracy - czego AI-generowany software nie ogarnia

AI może zbudować aplikację do ewidencji czasu pracy w jeden wieczór. To prawda - i ta wersja będzie działać, dopóki wszystko idzie normalnie. Problem zaczyna się przy dobie pracowniczej, zaokrąglaniu godzin, nadgodzinach w ujęciu okresu rozliczeniowego i eksporcie danych na żądanie PIP. To nie są dodatki do wdrożenia później - to jest to, co dojrzałe oprogramowanie ma wbudowane po latach realnego użytkowania w prawdziwych firmach.

Vibe coding brzmi jak kusząca obietnica

W ciągu ostatnich kilkunastu miesięcy coraz więcej firm odkryło, że można opisać potrzebne narzędzie w kilku zdaniach - "aplikacja, która rejestruje start i stop pracownika, przypisuje godziny do projektu i generuje raport PDF" - i dostać działający prototyp w ciągu kilku godzin. Bez programisty, bez przetargu, bez miesiąca wdrożenia.

Dla ewidencji czasu pracy brzmi to szczególnie kuszącą: wymagania wyglądają na proste. Pracownik przychodzi, pracownik wychodzi, system liczy godziny. Co może pójść nie tak?

Sporo.

Happy path zawsze działa. Edge cases - już nie.

Każda aplikacja generowana przez AI ma jedną cechę wspólną: idealnie obsługuje przypadek, który był w prompcie. Czyli "standardowy dzień roboczy, 8 godzin, bez niuansów." Badania z 2025-2026 roku pokazują, że 45% kodu generowanego przez AI nie przechodzi podstawowych testów bezpieczeństwa, a projekty budowane w tym trybie kumulują dług techniczny trzy razy szybciej niż tradycyjnie rozwijane oprogramowanie.

Ale problem z ewidencją czasu pracy nie leży w bezpieczeństwie kodu. Leży w tym, że Kodeks Pracy ma dziesiątki niuansów, które wyglądają prosto - dopóki nie trafisz na konkretną sytuację.

Co AI "ogarnie" od razu

Rejestracja startu i stopu. Zliczanie godzin. Przypisanie do projektu lub pracownika. Eksport do PDF albo Excela. Prosta lista obecności. Jeśli tyle Ci wystarczy i nigdy nie przyjdzie inspektor pracy - prototyp zadziała.

Czego AI nie wie, że nie wie

Poniżej lista przypadków, które w prawdziwych firmach zdarzają się regularnie - nie raz na rok.

Doba pracownicza. Zgodnie z art. 128 § 3 pkt 1 Kodeksu Pracy doba pracownicza to 24 kolejne godziny liczone od momentu rozpoczęcia pracy - nie od północy. Pracownik, który zaczął o 22:00 i skończył o 6:00, nie ma nadgodzin na przełomie dwóch dni - ma jeden ciągły czas pracy w ramach jednej doby pracowniczej. Większość prostych aplikacji liczy od dnia kalendarzowego. Różnica może wynosić kilka godzin tygodniowo na pracownika, a przy kontroli PIP każda z nich się liczy.

Zaokrąglanie godzin. Czy 8:04 to jeszcze 8:00? Czy 8:05 to już 8:10? Przepisy nie narzucają jednej metody, ale obowiązuje zasada, że zaokrąglenie nie może działać wyłącznie na niekorzyść pracownika. Każda firma powinna stosować konsekwentną, dokumentowalną metodę - i umieć ją wyjaśnić inspektorowi. Szczegółowo opisujemy to w artykule o zaokrąglaniu godzin.

Nadgodziny w ujęciu okresu rozliczeniowego. Przekroczenie dobowe (powyżej 8 h w ciągu doby) i przekroczenie w skali okresu rozliczeniowego to dwie odrębne kategorie - z różnymi zasadami i różnymi stawkami. Aplikacja, która liczy "po 8 godzin dziennie to nadgodziny", może generować błędne wyniki przy miesięcznym lub trzymiesięcznym okresie rozliczeniowym. Błędne wyniki to błędna wypłata.

Praca w niedzielę i święta. Pracownikowi, który przepracował niedzielę, przysługuje dzień wolny w zamian - albo dodatek do wynagrodzenia, jeśli dnia wolnego nie udzielono w wymaganym terminie. To nie jest oczywiste dla aplikacji, która nie wie, kiedy był ostatni raz udzielony dzień wolny i czy upłynął wymagany termin.

Archiwizacja przez 10 lat. Od 2019 roku ewidencja czasu pracy pracowników zatrudnionych po 31 grudnia 2018 musi być przechowywana przez 10 lat. To oznacza: dane nie mogą zniknąć przy zmianie systemu, nie mogą być "zarchiwizowane" w sposób, który uniemożliwia eksport, i muszą być dostępne na żądanie PIP lub sądu przez cały ten czas. Aplikacja zbudowana w jeden wieczór rzadko ma przemyślany model archiwizacji na dekadę.

Dane osobowe pracowników. Ewidencja czasu pracy to dane osobowe - w przypadku pracowników tymczasowych delegowanych do klienta agencji, przetwarzane przez kilka podmiotów jednocześnie. Kto ma dostęp? Czy brygadzista widzi dane całej ekipy, czy tylko swoich ludzi? Czy po zakończeniu umowy dane są usuwane zgodnie z harmonogramem? Czy system prowadzi logi zmian - kto, kiedy, co zmodyfikował? Bez odpowiedzi na te pytania nie ma mowy o zgodności z RODO.

Eksport na żądanie PIP. Inspektor pracy, który przychodzi na kontrolę, prosi o ewidencję w formie możliwej do zweryfikowania - z timestampami, przypisaniem do pracownika, historią zmian. Plik Excel z ręcznie wpisanymi godzinami zazwyczaj nie wystarczy. Jeśli aplikacja nie ma funkcji eksportu audytowego, kontrola zaczyna się od pierwszego problemu.

Kiedy luka wychodzi na wierzch

Przez pierwsze tygodnie wszystko wygląda w porządku. Prototyp rejestruje godziny, raporty generują się szybko, wszyscy są zadowoleni.

Pierwsza luka wychodzi przy sporze. Inwestor kwestionuje 40 godzin z ostatniego tygodnia. Otwierasz raport - godziny są, ale nie ma lokalizacji GPS, nie ma timestampów wygenerowanych przez serwer, jest tylko to, co ktoś wpisał ręcznie. Dokładnie ten scenariusz opisujemy w artykule Spór o godziny z inwestorem – jak podwykonawca może się obronić. W agencji pracy ta sama sytuacja dotyczy klienta, który kwestionuje przepracowane godziny pracowników tymczasowych - szczegóły w artykule o rozliczaniu czasu pracy pracowników tymczasowych u kontrahenta.

Druga luka wychodzi przy kontroli PIP. Inspektor pyta o ewidencję za konkretny miesiąc sprzed roku. Jeśli system nie archiwizuje w sposób umożliwiający taki eksport - odpowiedź brzmi: "nie mamy."

Trzecia luka wychodzi przy pierwszych nadgodzinach rozliczanych w dłuższym okresie rozliczeniowym. Wynik jest błędny, bo aplikacja nie implementuje przepisów - implementuje intuicję autora promptu.

Co buduje się latami, a nie w jeden wieczór

W dojrzałym oprogramowaniu do ewidencji każda funkcja ma historię za sobą.

Każda zmiana przepisów - skrócenie okresu archiwizacji dokumentacji pracowniczej do 10 lat w 2019 roku, zmiany w obliczaniu podstawy wymiaru składek ZUS, nowe wymagania dotyczące dokumentacji pracowników tymczasowych - to aktualizacja w kodzie, w dokumentacji i w eksporcie danych. Każdy raport od firmy, która miała problem przy kontroli PIP, to nowa walidacja lub nowe pole w systemie. Każdy spór o godziny zakończony sukcesem dzięki GPS i serwerowemu timestampowi to potwierdzenie, że te dane są zbierane w sposób, który faktycznie działa.

Tego nie da się wygenerować promptem. Buduje się to przez lata realnego użytkowania - w firmach podwykonawczych z kilkoma budowami naraz, w agencjach pracy z pracownikami delegowanymi do dziesiątek zakładów, w sytuacjach, które nie były w żadnym scenariuszu testowym.

Jeśli chcesz zobaczyć, jak to wygląda w praktyce dla firm terenowych - szczegóły znajdziesz na stronie eGodziny dla firm budowlanych. Możesz też umówić krótkie demo, żeby sprawdzić, czy to pasuje do Twojego sposobu pracy.

Czy aplikacja generowana przez AI spełnia wymogi art. 149 Kodeksu Pracy?

Art. 149 KP wymaga rzetelnego prowadzenia ewidencji i jej przechowywania - nie narzuca formy ani technologii. Aplikacja AI może spełniać ten wymóg formalnie, jeśli zapisuje wymagane dane. Problem pojawia się przy kontroli PIP lub sporze: inspektor sprawdza nie tylko fakt istnienia ewidencji, ale jej kompletność, zgodność z przepisami o dobie pracowniczej i nadgodzinach oraz możliwość eksportu w czytelnej formie. Aplikacja, która implementuje "intuicję" zamiast przepisów, może zapisywać dane w sposób, który nie przetrwa weryfikacji.

Jak sprawdzić, czy oprogramowanie poprawnie obsługuje dobę pracowniczą?

Najprostszy test: wprowadź czas pracy pracownika, który zaczął o 22:00 i skończył o 6:00 dnia następnego. Jeśli system przypisuje te godziny do dwóch różnych dni kalendarzowych i traktuje je jako dwie odrębne zmiany - obsługa doby pracowniczej wymaga weryfikacji. Poprawna implementacja liczy od momentu rozpoczęcia pracy, nie od północy. Warto też zapytać dostawcę wprost: jak system obsługuje pracę nocną i przejście przez dobę pracowniczą.

Czy dane z AI-generowanej aplikacji są akceptowane przez PIP przy kontroli?

PIP nie ma listy "zatwierdzonych systemów" - inspektor ocenia, czy ewidencja jest prowadzona rzetelnie i zawiera wymagane dane. W praktyce kluczowe jest: czy dane są kompletne (godziny startu i stopu dla każdego dnia, identyfikacja pracownika, informacje o nadgodzinach), czy są przechowywane przez wymagany okres (10 lat dla zatrudnionych po 31.12.2018) i czy można je wyeksportować w czytelnej formie. Aplikacja, która nie spełnia tych kryteriów, nie "przejdzie" kontroli - niezależnie od tego, czy był za nią człowiek czy AI.

Jak RODO dotyczy ewidencji czasu pracy pracowników tymczasowych?

Przy pracownikach tymczasowych ewidencja czasu pracy jest przetwarzana przez co najmniej dwa podmioty: agencję pracy (pracodawca) i pracodawcę użytkownika (zakład klienta). Wymaga to jasnej umowy o powierzeniu danych, określenia, kto jest administratorem, kto procesorem i jakie dane są przekazywane. Aplikacja, w której "wszyscy widzą wszystko", nie spełnia wymogów minimalizacji danych. Dodatkowe ryzyko: po zakończeniu delegowania pracownika, dane powinny być usunięte lub zanonimizowane zgodnie z przyjętym harmonogramem - co wymaga funkcji w systemie, nie ręcznego działania.

Kiedy warto zacząć od dojrzałego systemu, a kiedy wystarczy prosty arkusz?

Prosty arkusz lub aplikacja AI wystarczy, gdy: masz mniej niż 5 pracowników, czas pracy jest zawsze standardowy (8h/dzień, bez pracy nocnej, bez nadgodzin, bez niedziel), i nikt nigdy nie będzie kwestionował Twoich danych. Dojrzały system jest potrzebny, gdy: masz pracowników terenowych na kilku lokalizacjach, rozliczasz godziny z inwestorem lub klientem agencji, zatrudniasz pracowników tymczasowych, pracujesz w systemie zmianowym lub nocnym, lub po prostu nie chcesz odkrywać luk przy kontroli PIP.