Nossa Metodologia de Calendário

1. Mecanismo Multi-Calendário Determinístico

Os feriados públicos em todo o mundo seguem diversos sistemas matemáticos e culturais. Nosso pipeline modela quatro mecanismos principais de calendário:

Datas Gregorianas Fixas: Dias nacionais e aniversários históricos que caem em datas de calendário fixas (ex.: 4 de julho, 1º de janeiro).

Computações Astronômicas e Equinociais: Solstícios, equinócios e termos solares calculados usando coordenadas celestes precisas.

Calendários Lunares e Lunissolares: Calendários islâmicos Hijri, Ano Novo Lunar Chinês, Diwali e observâncias budistas calculados por meio de modelos padrão de visibilidade de fases da lua e verificados contra proclamações de autoridades religiosas nacionais.

Algoritmos de Computus: Ciclos da Páscoa Ocidental (Gregoriana) e Ortodoxa Oriental (Juliana) e suas festas móveis dependentes (Sexta-Feira Santa, Ascensão, Segunda-Feira de Pentecostes, Corpus Christi).

2. Legislação Estatutária e Decretos Oficiais

Modelos matemáticos fornecem datas brutas, mas as leis estatutárias ditam o descanso legal. Fazemos o cruzamento de cada ocorrência calculada com instrumentos legais primários: códigos trabalhistas nacionais, atos parlamentares, diários oficiais do estado e ordens executivas.

Onde bibliotecas padrão omitem reformas estatutárias ou usam regras desatualizadas, nosso registro de substituição manual (data/holiday-overrides.ts) aplica correções estatutárias verificadas.

3. Dias Substitutos e Modelagem de Mudança de Fim de Semana

Um dos aspectos mais críticos do planejamento de feriados é determinar o que acontece quando um feriado estatutário coincide com um fim de semana.

Nosso mecanismo codifica sistematicamente regras compensatórias nacionais: mudanças automáticas para a segunda-feira seguinte (ex.: Reino Unido, Austrália, EUA), mudanças para a sexta-feira anterior ou regras para o próximo dia útil disponível (ex.: Albânia, África do Sul), garantindo contagens precisas de dias úteis.

4. Auditorias Legislativas Contínuas e Testes de Regressão

Cada calendário de país está sujeito à validação automatizada de instantâneos (npm run holidays:validate:snapshots) para evitar regressão, enquanto nosso pipeline de monitoramento contínuo rastreia leis recém-promulgadas, feriados bancários pontuais e decretos reais ou presidenciais em todo o mundo.