Moait
홈인기 피드모든 블로그모든 태그
홈인기 피드모든 블로그모든 태그
AST로 Outdated 없는 퍼널 문서 만들기 섬네일

AST로 Outdated 없는 퍼널 문서 만들기

토스 favicon토스·Architecture·
TypeScriptNextJSASTTSMorphMermaid
2025년 12월 24일15

AI 요약

이 글은 AI가 요약했어요. 정확한 내용은 꼭 원문을 확인해 주세요!

핵심 요약

토스가 AST 기반 정적 분석으로 퍼널 흐름을 자동 추출하고 Mermaid 다이어그램으로 시각화하는 도구를 구축해 문서의 최신화를 자동화했습니다.

구현 방법

  • ts-morph를 이용해 TypeScript 소스코드를 AST로 파싱
  • Next.js 페이지 39개 파일의 Navigation 호출(router.push/replace) 추출
  • 조건은 가장 가까운 if/삼항에서 추출하고 훅 의존성까지 역추적
  • URL 상수 매핑을 AST로 처리해 실제 경로로 변환
  • Mermaid 다이어그램으로 시각화, push는 단일 화살표(-->), replace는 이중 화살표(==>)

주요 결과

  • 전체 경로를 한 번에 추출 가능, 문서 업데이트 자동화
  • 데드 엔드 자동 탐지 및 수정점 확인 용이
  • 신규 입사자 온보딩 및 유지보수성 향상에 기여

연관 피드

%가 높을수록 이 글과 비슷할 가능성이 높아요!
No Image
68%

로딩 스피너는 이제 그만! UPTN Station UX 개선 사례

SK플래닛 faviconSK플래닛·2024년 11월 21일
No Image
67%

CMS 모노레포 개선기: 빌드 시간 단축부터 번들 최적화까지

여기어때 favicon여기어때·2026년 04월 23일
쓱닷컴이 접근성을 대하는 방식 섬네일
67%

쓱닷컴이 접근성을 대하는 방식

SSG.COM faviconSSG.COM·2026년 06월 15일