핵심 요약
토스가 AST 기반 정적 분석으로 퍼널 흐름을 자동 추출하고 Mermaid 다이어그램으로 시각화하는 도구를 구축해 문서의 최신화를 자동화했습니다.
구현 방법
- ts-morph를 이용해 TypeScript 소스코드를 AST로 파싱
- Next.js 페이지 39개 파일의 Navigation 호출(router.push/replace) 추출
- 조건은 가장 가까운 if/삼항에서 추출하고 훅 의존성까지 역추적
- URL 상수 매핑을 AST로 처리해 실제 경로로 변환
- Mermaid 다이어그램으로 시각화, push는 단일 화살표(-->), replace는 이중 화살표(==>)
주요 결과
- 전체 경로를 한 번에 추출 가능, 문서 업데이트 자동화
- 데드 엔드 자동 탐지 및 수정점 확인 용이
- 신규 입사자 온보딩 및 유지보수성 향상에 기여
