Jak dbamy o to, żeby nasze kalkulatory podatkowe i płacowe po cichu się nie zdezaktualizowały

Każdy kalkulator na tej stronie dotyczący podatków, ubezpieczeń społecznych czy płacy minimalnej ma tę samą wadę: jest poprawny w dniu, w którym go publikujemy, a potem, sześć miesięcy później, jakiś rząd aktualizuje stawkę i narzędzie zaczyna po cichu podawać złe wyniki. Nikt nie dostaje żadnego komunikatu o błędzie. Strona działa dokładnie tak jak wcześniej — po prostu teraz jest niepoprawna, i to z pełnym przekonaniem.

To gorszy efekt niż brak narzędzia w ogóle. Dlatego zbudowaliśmy system specjalnie po to, żeby to wychwytywać.

Problem z podejściem “na pewno o tym pamiętamy”

Oczywiste rozwiązanie — “wystarczy okresowo sprawdzać liczby” — nie skaluje się. Utrzymujemy kalkulatory wynagrodzenia netto, składek społecznych i płac dla kilkunastu… a właściwie kilku krajów, z których każdy ma własne progi podatkowe, stawki składek i corocznie aktualizowane progi. Pomnóżcie to przez liczbę miesięcy, które mijają, zanim ktoś w ogóle pomyśli o ponownym sprawdzeniu, a szczera odpowiedź brzmi: prędzej czy później coś się zdezaktualizuje i nikt tego nie zauważy, dopóki nie zrobi tego użytkownik.

Co zbudowaliśmy zamiast tego

Plik rejestru wymienia każdą oficjalną liczbę zapisaną na stałe w kodzie każdego kalkulatora: w którym pliku się znajduje, co reprezentuje ta liczba, gdzie jest oficjalne źródło i jak często realistycznie można się spodziewać jej zmiany (niektóre wartości zmieniają się co roku w styczniu wraz z początkiem nowego roku podatkowego, inne tylko wtedy, gdy zmienia się ustawa — co jest nieprzewidywalne, ale rzadkie).

Zaplanowane zadanie uruchamia się co tydzień, sprawdza, które wpisy wymagają przeglądu zgodnie z tym harmonogramem, i dla każdego z nich:

Wyszukuje aktualną wartość w oficjalnym źródle rządowym
Prosi model językowy o wyodrębnienie konkretnej liczby z wyników wyszukiwania — nic więcej, tylko liczbę i poziom pewności
Jeśli model jest pewny i liczba się zmieniła, wprowadza ją jako dosłowną, zweryfikowaną zamianę tekstu bezpośrednio w kodzie (nigdy jako swobodne przepisanie — model nie ma prawa improwizować otaczającej logiki)
Uruchamia pełny build, żeby potwierdzić, że nic się nie zepsuło, zanim cokolwiek zostanie zatwierdzone
Jeśli build się nie powiedzie, zmiana jest automatycznie cofana i oznaczana do sprawdzenia przez człowieka

Cały system opiera się na prostej zasadzie: automatyzacja może aktualizować liczbę, ale nigdy nie może zgadywać. Jeśli nie potrafi znaleźć pewnej odpowiedzi z oficjalnego źródła, nic nie robi i jasno to zgłasza, zamiast zostawiać na miejscu wiarygodnie wyglądającą, ale błędną liczbę.

Niezależny od pojedynczego narzędzia

Samo zadanie działa na infrastrukturze niezależnej od jednego dostawcy czy konta — jeśli jedna część procesu przestanie działać, cały system się nie zatrzymuje, tylko przełącza się na inną ścieżkę wyodrębniania liczby. Ta redundancja ma tu większe znaczenie niż w większości automatyzacji: błędny kalkulator podatkowy wyrządza realną szkodę, w sposób, w jaki po prostu nie robi tego zepsuty generator memów.

Co to oznacza dla Ciebie

Każdy kalkulator objęty tym systemem pokazuje bezpośrednio na stronie datę “zweryfikowano dane oficjalne”, oddzielną od daty “ostatniej aktualizacji”, którą można zobaczyć na zwykłej stronie z treścią. Jeśli kiedykolwiek zobaczysz, że ta data wygląda podejrzanie staro, warto nam to bezpośrednio zgłosić — zwykle oznacza to, że automatyczna kontrola natrafiła na źródło, którego nie potrafiła przetworzyć, a nie że o czymś zapomnieliśmy.

Wypróbuj

To narzędzia jednojęzyczne, zbudowane specjalnie pod zasady obowiązujące w danym kraju, dlatego poniższe linki otwierają się w tym właśnie języku: