Naša metodika kalendára

1. Deterministický multi-kalendárový engine

Štátne sviatky po celom svete sa riadia rôznymi matematickými a kultúrnymi systémami. Náš systém modeluje štyri hlavné kalendárové mechanizmy:

Pevné dátumy podľa gregoriánskeho kalendára: Štátne sviatky a historické výročia pripadajúce na pevné dátumy kalendára (napr. 4. júla, 1. januára).

Astronomické a rovnodennostné výpočty: Slnovraty, rovnodennosti a solárne obdobia vypočítané pomocou presných nebeských súradníc.

Lunárne a lunisolárne kalendáre: Islamský kalendár hidžry, čínsky lunárny nový rok, Diwali a budhistické sviatky vypočítané pomocou štandardných modelov viditeľnosti mesiacov a overené prostredníctvom vyhlásení národných náboženských autorít.

Algoritmy Computus: Cykly západnej (gregoriánskej) a východnej pravoslávnej (juliánskej) Veľkej noci a ich závislé pohyblivé sviatky (Veľký piatok, Nanebovstúpenie Pána, Svätodušný pondelok, Božie telo).

2. Zákonná legislatíva a oficiálne dekréty

Matematické modely poskytujú surové dátumy, ale zákony určujú právny pokoj. Každý vypočítaný výskyt krížovo porovnávame s primárnymi právnymi predpismi: národnými zákonníkmi práce, zákonmi parlamentu, oficiálnymi štátnymi vestníkmi a výkonnými nariadeniami.

Tam, kde štandardné knižnice opomínajú zákonné reformy alebo používajú zastarané pravidlá, náš register manuálnych úprav (data/holiday-overrides.ts) presadzuje overené zákonné opravy.

3. Náhradné dni a modelovanie víkendových posunov

Jedným z najdôležitejších aspektov plánovania sviatkov je určenie toho, čo sa stane, keď zákonný sviatok pripadne na víkend.

Náš engine systematicky kóduje národné kompenzačné pravidlá: automatické presuny na nasledujúci pondelok (napr. UK, Austrália, USA), presuny na predchádzajúci piatok alebo pravidlá nasledujúceho dostupného pracovného dňa (napr. Albánsko, Južná Afrika), čo zaisťuje presný počet pracovných dní.

4. Nepretržité legislatívne audity a regresné testovanie

Každý kalendár krajiny podlieha automatizovanej validácii snímok (npm run holidays:validate:snapshots), aby sa predišlo regresiám, zatiaľ čo náš kanál nepretržitého monitorovania sleduje novoprijaté zákony, jednorazové bankové prázdniny a kráľovské alebo prezidentské dekréty po celom svete.