Documents — 2026년 3월 2일
Documents 프로젝트를 GitHub Pages에서 Next.js와 Firebase 기반의 현대적인 스택으로 완전히 마이그레이션했습니다. 이번 작업의 핵심은 단순한 정적 사이트 호스팅을 넘어 동적 콘텐츠 관리와 성능 최적화를 동시에 달성하는 것이었습니다. 72개 파일의 변경을 통해 아카이브 페이지들을 Next.js의 ISR(Incremental Static Regeneration)로 전환했고, Firebase를 활용한 캐시 무효화 메커니즘을 구현해 콘텐츠 업데이트 시 자동으로 캐시를 갱신하도록 설정했습니다. 이를 통해 빌드 시간은 단축하면서도 항상 최신 콘텐츠를 사용자에게 제공할 수 있게 되었습니다.
기술적으로는 몇 가지 흥미로운 개선 사항들이 있습니다. 기존의 브라우저 기본 `confirm()` 대신 React 기반의 인라인 컨펌 UI로 교체해 사용자 경험을 개선했고, 관리자 CRUD 작업을 클라이언트 SDK에서 Server Actions로 마이그레이션해 보안을 강화했습니다. 또한 환경 변수의 뉘앙스로 인한 Firestore 경로 오류를 해결했고, 아카이브 콘텐츠 페이지를 풀스크린으로 렌더링하도록 수정했습니다. AI 어시스턴트의 도움을 받아 마이그레이션 중 여러 엣지 케이스를 식별하고 해결 방안을 검토했으며, 원본 사이트 레이아웃과의 일관성 유지도 함께 진행했습니다.
이제 Documents는 확장 가능하고 유지보수하기 쉬운 구조로 재편성되었습니다. ISR을 통한 캐싱 전략과 Server Actions 기반의 관리 시스템은 향후 더 많은 문서 추가와 실시간 업데이트 요구사항에도 쉽게 대응할 수 있는 토대를 마련했습니다.