피드로 돌아가기
Dev.toBackend
원문 읽기
KASI 데이터셋 기반 47,455일 무결성 검증 Saju API 구축
A Korean Saju (Four Pillars) API that gets the date math right
AI 요약
Context
단순 모듈러 연산 기반의 기존 Western 구현체들이 Lunisolar Calendar의 불규칙성과 Solar Term 경계값 처리 오류로 인한 데이터 부정확성 초래. 특히 True Solar Time 보정 부재로 인한 Hour Pillar 계산 오류가 시스템의 신뢰도를 저하시키는 핵심 병목으로 작용.
Technical Solution
- KASI(한국천문연구원) 국가 표준 데이터셋을 참조 모델로 설정한 Table-driven 변환 엔진 설계
- Gregorian date를 Lunisolar로 변환 시 Leap-month 위치를 정밀 추적하는 정적 데이터 매핑 구조 채택
- 단순 날짜 기준이 아닌 Solar Term(절기) 경계 시점의 천문학적 데이터를 반영한 Year/Month Pillar 전환 로직 구현
- 표준시와 실제 태양 위치의 차이를 보정하는 True Solar Time 계산식을 통한 Hour Pillar 정밀도 확보
- LLM을 배제한 Fully Deterministic 엔진 설계를 통해 밀리초 단위의 Latency 구현 및 비용 예측 가능성 확보
실천 포인트
1. 도메인 특화 날짜/시간 계산 시 표준 라이브러리의 Gregorian 기반 연산 한계 검토
2. 경계값(Edge Case) 정의 시 천문학적/법적 기준 데이터셋 확보 및 검증 루틴 구축
3. 예측 가능성과 저지연이 필수적인 기능에 대해 LLM 대신 결정론적(Deterministic) 알고리즘 우선 고려