12만 달러 손실을 막는 글로벌 Banking-aware 날짜 계산 API 설계

Context

레거시 코드인 business_day_utils.py 기반의 SLA 계산 구조로 인한 도메인 특수성 처리 한계 발생. 일반적인 날짜 라이브러리가 처리하지 못하는 국가별 Half-day 및 지역별 공휴일 예외 케이스로 인해 잘못된 통지 5만 건 발송 및 계약 해지 초래.

Technical Solution

• Jurisdictional Granularity 도입을 통한 국가 내 주별(Sub-national) 공휴일 차이 해결
• Banking-specific Calendar 정의로 독일 은행권의 Christmas Eve Half-day(12pm 종료) 등 도메인 특화 시간 계산 로직 반영
• Variable Work-week 엔진 설계로 사우디아라비아의 주말 변경 이력(2013년 목/금 $\rightarrow$ 금/토) 및 국가별 상이한 주말 설정 처리
• DST-safe Arithmetic 적용으로 일광 절약 시간제 전환 시점의 모호한 시간 계산 오류 방지
• Evidence-based Audit Trail 구조 설계를 통해 계산 결과와 함께 공식 정부 문서(Bundesbank 등) 소스 링크를 JSON 응답에 포함하여 법적/컴플라이언스 근거 제공