Naptármetodológiánk

1. Determinisztikus többnaptáras motor

A munkaszüneti napok világszerte különböző matematikai és kulturális rendszereket követnek. Rendszerünk négy elsődleges naptármechanizmust modellez:

Rögzített Gergely-naptári dátumok: A rögzített naptári napokra eső nemzeti ünnepnapok és történelmi évfordulók (pl. július 4., január 1.).

Csillagászati és napéjegyenlőségi számítások: Napfordulók, napéjegyenlőségek és napfordulóhoz kapcsolódó időpontok pontos égi koordináták alapján kiszámítva.

Hold- és luniszoláris naptárak: Iszlám hidzsri naptárak, kínai holdújév, دیوالي (Diwali) és buddhista ünnepségek, amelyeket a szokásos holdfázis láthatósági modellek alapján számítanak ki, és a nemzeti vallási hatóságok hirdetményei ellenőriznek.

Computus algoritmusok: Nyugati (Gergely-naptári) és keleti ortodox (Julián-naptári) húsvéti ciklusok, valamint az azokhoz kapcsolódó mozgó ünnepek (nagypéntek, áldozócsütörtök, pünkösdhétfő, úrnapja).

2. Törvényi jogszabályok és hivatalos rendeletek

A matematikai modellek nyers dátumokat biztosítanak, de a törvények határozzák meg a jogi pihenőidőt. Minden kiszámított eseményt összevetünk az elsődleges jogi eszközökkel: a nemzeti munkajogi kódexekkel, parlamenti törvényekkel, hivatalos állami közlönyökkel és végrehajtói rendeletekkel.

Ahol a standard könyvtárak kihagyják a törvényi reformokat vagy elavult szabályokat használnak, a manuális felülbírálási nyilvántartásunk (data/holiday-overrides.ts) érvényesíti a hitelesített törvényi helyesbítéseket.

3. Pótléknapok és hétvégi eltolódási modellezés

Az ünnepi tervezés egyik legfontosabb szempontja annak meghatározása, hogy mi történik, ha egy törvényi ünnepnap hétvégére esik.

Motorunk szisztematikusan kódolja a nemzeti kompenzációs szabályokat: automatikus áttérések a következő hétfőre (pl. Egyesült Királyság, Ausztrália, USA), áttérések az előző péntekre vagy a következő lehetséges munkanap szabályaira (pl. Albánia, Dél-Afrika), biztosítva a pontos munkanapszámítást.

4. Folyamatos jogszabályiauditok és regressziós tesztelés

Minden egyes ország naptára automatizált pillanatkép-ellenőrzésen esik át (npm run holidays:validate:snapshots) a regresszió elkerülése érdekében, miközben folyamatos figyelési folyamatunk nyomon követi az újonnan elfogadott törvényeket, egyszeri banki szünnapokat, valamint a királyi vagy elnöki rendeleteket világszerte.