정적 구현 guide
Build-time 콘텐츠 검증
Guide slug, 관계, 날짜, 설명 또는 문서 구조가 일관되지 않은 정적 출력을 만들기 전에 build를 실패시킵니다.
최종 수정일 2026-08-28
작성된 model 검증하기
각 독립 프로젝트의 local content module은 build 시 source of truth가 됩니다. Module load 단계에서 slug의 안전한 lowercase pattern과 중복 여부, 필수 text, 안정적인 날짜 형식, 여러 개의 의미 있는 section을 확인합니다. 모든 related target은 실제 guide를 가리켜야 합니다.
이 규칙은 rendering만 보호하지 않습니다. Slug collection은 static path, sitemap location, home link, canonical URL과 related navigation을 정의합니다. 하나의 잘못된 항목이 deployment 이후 여러 defect를 만드는 것을 방지합니다.
실행 가능한 failure 만들기
Validation error는 실패한 guide와 field를 알려주어 editor가 source를 직접 수정할 수 있게 합니다. Content module은 별도 compile 과정 없이 직렬화 가능한 plain object를 export하므로 Next.js build를 결정적으로 유지하고 runtime content fetching을 피합니다.
Validation을 optional lint가 아니라 모든 build에 포함합니다. Content 변경 시 origin을 먼저 build하여 모든 static path가 rendering되는지 확인하고, gateway의 별도 metadata index도 동기화한 뒤 sitemap과 discovery link를 다시 생성합니다.