프론트엔드
AST로 Outdated 없는 퍼널 문서 만들기
두줄요약
AST로 퍼널 라우팅을 정적 분석해 문서를 자동 생성하고, 코드 변경 시에도 최신 상태를 유지하는 방법을 소개했습니다. 조건 분기와 훅 내부 이동까지 추출해 Mermaid 다이어그램으로 시각화했습니다.
핵심 내용
- Next.js 퍼널 페이지들의 라우팅 정보를 AST로 정적 분석해 문서화하는 접근
- router.push, router.replace, 조건문, 쿼리 파라미터, 훅 내부 호출까지 추출해 Navigation Edge로 구조화
- URL 상수 해석, 진입점·이탈점 분류, Mermaid 플로우차트 생성으로 자동 동기화 문서 구축
적용해볼 점
- 수기 문서 대신 코드 기반 자동 문서화로 Outdated 문제 완화
- 라우팅 구조, 컴포넌트 의존성, API 호출 패턴 등 다른 코드 정보에도 정적 분석 적용 가능