Documents — 2026년 3월 3일

# 개발 블로그 엔트리

Documents 프로젝트에 큰 규모의 기능 개선과 안정성 개선 작업을 진행했습니다. 목차(TOC) 네비게이션 시스템을 완전히 재설계하여 iframe 리로드 문제를 해결하고 `scrollIntoView`를 활용한 부드러운 스크롤 경험을 제공했습니다. 특히 앵커 인터셉션 로직을 강화하여 resolved href의 프래그먼트도 확인하도록 개선해, 복잡한 라우팅 환경에서도 안정적으로 작동하도록 만들었습니다.

더불어 관리자 카테고리 매니저의 UX를 폭넓게 개선했고, 에디터 저장 기능과 카테고리 커스텀 ID 설정 등 여러 주요 버그들을 수정했습니다. TypeScript 타입 안정성 강화, 데이터베이스 쿼리 최적화(복합 인덱스 제거 및 JS 측 정렬로 변경)도 함께 진행하여 코드베이스의 견고성을 높였습니다. AI 어시스턴트의 도움을 받아 타입 캐스팅 이슈들을 효율적으로 식별하고 해결할 수 있었습니다.

16개 파일에 걸쳐 1800여 줄의 코드 추가와 함께 불필요한 부분들을 정리하면서, 사용자 경험과 개발자 경험 모두를 개선하는 균형잡힌 업데이트가 되었습니다. 특히 이번 작업을 통해 작은 버그 수정이 전체 사용성에 얼마나 큰 영향을 미치는지 다시 한 번 깨달을 수 있었습니다.