우리의 캘린더 방법론

1. 결정론적 멀티 캘린더 엔진

전 세계의 공휴일은 다양한 수학적 및 문화적 시스템을 따릅니다. 우리의 파이프라인은 네 가지 주요 캘린더 메커니즘을 모델링합니다.

고정된 그레고리력 날짜: 고정된 캘린더 날짜에 해당하는 국경일 및 역사적 기념일 (예: 7월 4일, 1월 1일).

천문학 및 춘분점 계산: 정확한 천구 좌표를 사용하여 계산된 지점, 춘분/추분 및 절기.

음력 및 태음태력: 이슬람 히즈라력, 설날, 디파리, 불교 기념일 등은 표준 달의 위상 가시성 모델을 통해 계산되며 국가 종교 기관의 공식 발표를 통해 검증됩니다.

부활절 계산 알고리즘: 서양(그레고리력) 및 동방 정교회(율리우스력)의 부활절 주기와 이에 종속된 이동 축일(성금요일, 승천일, 성령강림월요일, 그리스도의 성체 성혈 축일).

2. 법정 입법 및 공식 법령

수학적 모델은 원시 날짜를 제공하지만, 법정 법률은 법적 휴식을 규정합니다. 우리는 계산된 모든 날짜를 국가 노동법, 의회 법안, 공식 주립 관보, 행정 명령 등의 주요 법적 문서와 교차 검증합니다.

표준 라이브러리가 법적 개정을 누락하거나 오래된 규칙을 사용하는 경우, 당사의 수동 오버라이드 레지스트리(data/holiday-overrides.ts)를 통해 검증된 법정 수정을 적용합니다.

3. 대체 휴일 및 주말 이동 모델링

휴일 계획에서 가장 중요한 측면 중 하나는 법정 공휴일이 주말과 겹칠 때 어떤 일이 발생하는지 파악하는 것입니다.

우리 엔진은 국가별 보상 휴무 규칙을 체계적으로 인코딩합니다. 다음 월요일로의 자동 이동(예: 영국, 호주, 미국), 이전 금요일로의 이동, 또는 이용 가능한 다음 근무일 규칙(예: 알바니아, 남아프리카공화국)을 적용하여 정확한 근무일 수를 보장합니다.

4. 지속적인 입법 감사 및 회귀 테스트

모든 국가 캘린더는 회귀를 방지하기 위해 자동화된 스냅샷 검증(npm run holidays:validate:snapshots)을 거치며, 우리의 지속적인 모니터링 파이프라인은 전 세계적으로 새로 제정된 법률, 일회성 은행 휴무일, 왕실 또는 대통령령을 추적합니다.