A nossa metodologia de calendário

1. Motor determinístico de múltiplos calendários

Os feriados públicos em todo o mundo seguem sistemas matemáticos e culturais diversos. O nosso processo modela quatro mecanismos principais:

Datas fixas do calendário gregoriano: dias nacionais e aniversários históricos que ocorrem em datas fixas do calendário (por exemplo, 4 de julho e 1 de janeiro).

Cálculos astronómicos e equinociais: solstícios, equinócios e termos solares calculados com coordenadas celestes precisas.

Calendários lunares e lunissolares: calendários islâmicos Hijri, Ano Novo Lunar chinês, Diwali e celebrações budistas, calculados através de modelos normalizados de visibilidade das fases da Lua e verificados com base em proclamações das autoridades religiosas nacionais.

Algoritmos de cálculo da Páscoa: ciclos ocidentais (gregorianos) e ortodoxos orientais (julianos) da Páscoa e as celebrações móveis associadas (Sexta-Feira Santa, Ascensão, Segunda-Feira de Pentecostes, Corpo de Deus).

2. Legislação e decretos oficiais

Os modelos matemáticos fornecem as datas em bruto, mas são as leis que determinam os dias de descanso legal. Cruzamos cada ocorrência calculada com instrumentos jurídicos primários: códigos laborais nacionais, atos parlamentares, diários oficiais e decretos do poder executivo.

Quando as bibliotecas normalizadas omitem reformas legais ou usam regras desatualizadas, o nosso registo de substituições manuais (data/holiday-overrides.ts) aplica correções legais verificadas.

3. Modelação de dias de compensação e mudanças devido ao fim de semana

Um dos aspetos mais importantes do planeamento de feriados é determinar o que acontece quando um feriado previsto na lei coincide com um fim de semana.

O nosso motor codifica sistematicamente as regras nacionais de compensação: transferência automática para a segunda-feira seguinte (por exemplo, no Reino Unido, na Austrália e nos EUA), transferência para a sexta-feira anterior ou regras que determinam o próximo dia útil disponível (por exemplo, na Albânia e na África do Sul), garantindo contagens precisas dos dias úteis.

4. Auditorias legislativas contínuas e testes de regressão

Todos os calendários nacionais são sujeitos a validação automatizada de snapshots (npm run holidays:validate:snapshots) para evitar regressões, enquanto o nosso processo de monitorização contínua acompanha novas leis, feriados públicos pontuais e decretos reais ou presidenciais em todo o mundo.