Mūsų kalendoriaus metodika

1. Deterministinis daugiakalendoriaus variklis

Valstybinės šventės visame pasaulyje vadovaujasi įvairiomis matematinėmis ir kultūrinėmis sistemomis. Mūsų sistema modeliuoja keturis pagrindinius kalendoriaus mechanizmus:

Fiksuotos Grigaliaus datos: nacionalinės šventės ir istorinės sukaktys, tenkančios fiksuotoms kalendoriaus datoms (pvz., liepos 4 d., sausio 1 d.).

Astronominiai ir lygiadienio skaičiavimai: saulėgrįžos, lygiadieniai ir saulės terminai, apskaičiuoti naudojant tikslias dangaus koordinates.

Mėnulio ir lunisolariniai kalendoriai: Islamo Hidžros kalendoriai, kinų Mėnulio Naujieji metai, Diwali ir budistų šventės, apskaičiuojamos pagal standartinius Mėnulio fazių matomumo modelius ir patvirtintos pagal nacionalinių religinių institucijų proklamacijas.

Computus algoritmai: Vakarų (Grigaliaus) ir Rytų ortodoksų (Julijaus) Velykų ciklai bei nuo jų priklausomos kilnojamos šventės (Didysis penktadienis, Šeštinės, Sekminės, Devintinės).

2. Įstatymai ir oficialūs dekretai

Matematiniai modeliai pateikia pradines datas, tačiau teisiniai įstatymai nustato teisinį poilsį. Kiekvieną apskaičiuotą atvejį sulyginame su pirminiais teisiniais aktais: nacionaliniais darbo kodeksais, parlamentiniais aktais, oficialiais valstybės biuleteniais ir vykdomaisiais įsakymais.

Kai standartinėse bibliotekose trūksta teisinių reformų arba naudojamos pasenusios taisyklės, mūsų rankinio perrašymo registras (data/holiday-overrides.ts) užtikrina patvirtintas teisines pataisas.

3. Pakaitinės dienos ir savaitgalio poslinkio modeliavimas

Vienas iš svarbiausių švenčių planavimo aspektų yra nustatymas, kas nutinka, kai įstatyminė šventė sutampa su savaitgaliu.

Mūsų variklis sistemingai užkoduoja nacionalines kompensacines taisykles: automatinį perkėlimą į kitą pirmadienį (pvz., JK, Australijoje, JAV), perkėlimą į ankstesnį penktadienį arba kito galimo darbo dienos taisykles (pvz., Albanijoje, Pietų Afrikoje), užtikrindamas tikslų darbo dienų skaičių.

4. Nuolatiniai teisiniai auditai ir regresijos testavimas

Kiekvienos šalies kalendoriui taikomas automatinis momentinių kopijų patvirtinimas (npm run holidays:validate:snapshots), siekiant išvengti regresijos, o mūsų nuolatinio stebėjimo vamzdynas seka naujai priimtus įstatymus, vienkartines bankų nedarbo dienas ir karališkojus bei prezidentinius dekretus visame pasaulyje.