Näin estämme vero- ja palkkalaskureitamme vanhenemasta hiljaa käsiin

Jokaisella tämän sivuston laskurilla, joka koskee veroja, sosiaalivakuutusta tai minimipalkkaa, on sama vikaantumistapa: se on oikein rakennuspäivänä, sitten valtio päivittää jonkin prosentin puoli vuotta myöhemmin, ja työkalu alkaa hiljaa antaa vääriä vastauksia. Kukaan ei saa virheilmoitusta. Sivu toimii täsmälleen kuten ennenkin — se on vain nyt väärässä, ja itsevarmasti.

Se on huonompi lopputulos kuin että työkalua ei olisi lainkaan. Joten rakensimme järjestelmän nimenomaan tämän huomaamiseen.

“Kyllä me muistetaan tarkistaa” -ongelma

Ilmeinen korjaus — “tarkistetaan luvut säännöllisesti” — ei skaalaudu. Ylläpidämme nettopalkka-, sosiaalivakuutus- ja palkanlaskentalaskureita puolessa tusinassa maassa, joista jokaisella on omat veroluokkansa, maksuprosenttinsa ja vuosittain tarkistettavat kynnysarvonsa. Kerro se sillä, montako kuukautta kuluu ennen kuin kukaan hoksaa tarkistaa, ja rehellinen vastaus on: lopulta jokin vanhenee eikä kukaan huomaa ennen kuin käyttäjä huomaa.

Mitä rakensimme sen sijaan

Rekisteritiedosto listaa jokaisen laskureihin kovakoodatun virallisen luvun: missä tiedostossa se asuu, mitä luku edustaa, missä virallinen lähde on ja kuinka usein sen realistisesti odotetaan muuttuvan (jotkin arvot liikkuvat joka tammikuu uuden verovuoden alkaessa; toiset muuttuvat vain lakia muutettaessa, mikä on arvaamatonta mutta harvinaista).

Ajastettu työ ajautuu viikoittain, tarkistaa aikataulun perusteella, mitkä merkinnät ovat tarkistusvuorossa, ja jokaiselle niistä:

Hakee nykyisen arvon virallisesta viranomaislähteestä
Pyytää kielimallia poimimaan tarkan luvun hakutuloksista — ei mitään muuta, vain luvun ja luottamustason
Jos malli on varma ja luku muuttui, soveltaa sen kirjaimellisena, varmennettuna tekstikorvauksena koodiin (ei koskaan vapaamuotoisena uudelleenkirjoituksena — malli ei saa improvisoida ympäröivää logiikkaa)
Ajaa täyden buildin varmistaakseen, ettei mikään hajonnut, ennen minkään commitointia
Jos build epäonnistuu, muutos perutaan automaattisesti ja merkitään ihmisen katsottavaksi

Koko systeemi on suunniteltu yksinkertaisen periaatteen ympärille: automaatio saa päivittää luvun, mutta se ei koskaan saa arvata. Jos se ei löydä varmaa vastausta virallisesta lähteestä, se ei tee mitään ja raportoi sen selkeästi sen sijaan, että jättäisi uskottavan näköisen väärän luvun paikoilleen.

Riippumaton mistään yksittäisestä työkalusta

Itse työ pyörii infrastruktuurilla, joka on riippumaton yksittäisestä toimittajasta tai tilistä — jos jokin putken osa kaatuu, koko järjestelmä ei lakkaa toimimasta, vaan siirtyy toiseen reittiin luvun poimimiseksi. Tämä varmuus merkitsee tässä enemmän kuin useimmassa automaatiossa: väärässä oleva verolaskuri on aktiivisesti haitallinen tavalla, jolla vaikkapa rikkinäinen meemigeneraattori ei yksinkertaisesti ole.

Mitä tämä tarkoittaa sinulle

Jokainen tämän järjestelmän kattama laskuri näyttää “virallinen data varmennettu” -päivämäärän suoraan sivulla, erillään tavallisen sisältösivun “viimeksi päivitetty” -päivämäärästä. Jos tuo päivämäärä näyttää joskus epäilyttävän vanhalta, siitä kannattaa ilmoittaa meille suoraan — se tarkoittaa yleensä, että automaattinen tarkistus törmäsi lähteeseen, jota se ei osannut jäsentää, ei sitä, että olisimme unohtaneet asian.

Kokeile

Nämä ovat yksikielisiä työkaluja, joista jokainen on rakennettu nimenomaan oman maansa sääntöjä varten, joten alla olevat linkit avautuvat kyseisellä kielellä: