JSON Schema의 복잡성을 제거한 예시 기반의 고밀도 데이터 검증 프레임워크 Okyline

Context

JSON Schema의 복잡한 조건부 로직과 추상적인 에러 경로로 인한 가독성 저하 문제 발생. 특히 비즈니스 불변성(Business Invariants) 표현의 한계로 인해 검증 로직이 코드 레벨로 분산되는 아키텍처적 병목 지점 확인.

Technical Solution

• Annotated JSON Example 방식을 도입하여 데이터 구조와 검증 규칙을 단일 컨텍스트 내에서 정의하는 구조 설계
• 필드명에 직접 제약 조건을 삽입하는 Inline Annotation 방식을 통해 스키마 정의와 실제 데이터 형태 간의 인지적 거리 단축
• $appliedIf 연산자를 통한 조건부 필드 활성화 로직 구현으로 복잡한 if/then/else 체인을 직관적인 매핑 구조로 변경
• $compute 섹션을 통한 필드 간 연산 검증 기능을 추가하여 JSON Schema에서 불가능한 비즈니스 불변성 체크 구현
• Key-based Unique Validation을 도입하여 객체 전체 비교가 아닌 특정 식별자 기준의 중복 데이터 필터링 수행