Documents — 2026년 4월 5일

# 개발 블로그 엔트리

최근 Documents 프로젝트에서 이메일 설정 개선과 캐싱 전략 재구성, 그리고 새로운 Knowledge Graph 기능 통합을 완료했습니다. 먼저 이메일 APP_URL 폴백값을 `doc.324.ing`에서 `d.324.ing`으로 업데이트하여 도메인 일관성을 맞추었습니다. 동시에 루트 페이지의 캐싱 문제를 해결하기 위해 Vercel CDN의 no-cache 헤더를 적용하고, ISR(Incremental Static Regeneration) 캐싱을 임시로 비활성화한 후 force-dynamic 렌더링을 도입했습니다. 이 변경들은 사용자가 항상 최신 콘텐츠를 받을 수 있도록 보장합니다.

가장 주목할 만한 변화는 Knowledge Graph를 `/knowledge` 라우트로 통합한 것입니다. 기존의 정적 캐싱 방식으로는 동적인 지식 그래프 데이터를 효과적으로 제공할 수 없었는데, 이번 ISR 캐싱 전략 변경으로 이를 해결할 수 있게 되었습니다. 약 10,600줄의 코드 추가와 함께 이 기능이 추가되었으며, AI의 도움을 받아 캐싱 정책과 렌더링 전략의 트레이드오프를 분석하고 최적의 구성을 찾을 수 있었습니다.

이번 업데이트는 단순한 버그 수정을 넘어 아키텍처 수준의 개선이었습니다. 동적 콘텐츠 제공의 필요성과 성능 최적화 사이의 균형을 맞추는 과정에서, 때로는 캐싱을 과감히 비활성화하고 렌더링 방식을 전환하는 것이 더 나은 사용자 경험을 만들 수 있다는 점을 배웠습니다.