Zod 스키마 기반의 정적 블로그 메타데이터 검증 및 렌더링 구조 설계

Context

정적 블로그 포스트의 수정 이력과 외부 참조 출처를 단순 Markdown으로 관리 시 발생하는 데이터 불일치 및 휴먼 에러 가능성 존재. 단순 텍스트 기반 기록 방식의 낮은 데이터 무결성과 렌더링 일관성 결여를 해결할 구조적 방법 필요.

Technical Solution

• Zod 라이브러리를 통한 Frontmatter 데이터의 강력한 Type Validation으로 빌드 타임 단계에서 스키마 무결성 확보
• z.coerce.date()를 활용한 ISO 8601 날짜 문자열의 Date 객체 자동 변환으로 데이터 처리 일관성 유지
• set:html 속성을 통한 인라인 HTML 허용으로 작성자 제어 하의 유연한 표기법 지원 및 XSS 리스크를 수용하는 Trade-off 결정
• PageHistory.astro 및 PageCredits.astro 컴포넌트 분리를 통한 관심사 분리 및 UI 렌더링 로직의 모듈화
• URL 존재 여부에 따른 조건부 앵커 태그 렌더링으로 데이터 상태 기반의 동적 UI 구조 구현
• Optional 필드 설계를 통한 불필요한 Boilerplate 제거 및 실제 데이터 존재 시에만 UI를 노출하는 효율적 렌더링 전략 채택