단일 파일 기반 파이프라인으로 12일간 19개 SEO 에세이 배포

Context

CMS, Markdown Loader, Static Site Generator 등 복잡한 콘텐츠 생태계로 인한 오버헤드 발생. 소규모 코퍼스 관리 시 도구의 복잡성이 개발 생산성을 저해하는 병목 지점으로 작용함.

Technical Solution

• Next.js의 force-static과 dynamicParams = false 설정을 통한 완전 정적 페이지 생성
• Typed Tuple 기반의 ESSAY_SLUGS allowlist를 구축하여 컴파일 타임의 타입 체크와 런타임 404 처리 동시 달성
• 단일 소스(Single Source of Truth) 기반으로 Sitemap, Index Page, Renderer가 동일한 리스트를 참조하는 구조 설계
• HTTP 200 응답에도 불구하고 발생하는 Soft-404 및 렌더링 오류를 탐지하는 Post-deploy Liveness Probe 구현
• Liveness Probe 내 Title Stem 매칭 및 Sitemap 포함 여부 검증을 통한 배포 무결성 확보

Impact

• 12일 동안 19개의 에세이 발행 및 48시간 이내 Google 인덱싱 완료
• 콘텐츠 추가 시 단일 파일 Diff 발생 및 런타임 오류 수정 시간 단축

Key Takeaway

데이터 규모가 임계치에 도달하기 전까지는 복잡한 추상화 계층보다 단순한 데이터 구조와 강력한 타입 시스템을 활용한 'Simple Model'이 가장 효율적인 아키텍처임.