DOCS/troubleshooting/250803_happybell80_file-graph분석도구.md

file-graph-visualizer 프로젝트 개선 작업

오후 8시 00분

file-graph-visualizer 기능 추가 및 개선

문제 상황

1. rb10408_test 프로젝트가 드롭다운에 없음
2. 프로젝트 선택 시 재분석 필요로 시간 지연
3. 파일 구조가 정리되지 않아 난잡함
4. 다른 개발자들과 공유 방법 필요

해결 과정

1. rb10408_test 프로젝트 추가

• visualize_refined.py에 프로젝트 목록 추가
• 드롭다운에 rb10408_test 포함

2. 프로젝트 즉시 전환 기능

• 기존: 프로젝트 선택 → alert 표시 → 재분석 필요
• 개선: 모든 프로젝트 사전 분석 → HTML 파일 생성 → 즉시 전환
• analyze_all_projects.py 스크립트 생성
• index.html에 프로젝트 카드 목록 생성

3. 디렉토리 구조 정리

file-graph-visualizer/
├── src/                    # Python 소스 코드
│   ├── visualize_refined.py
│   └── analyze_all_projects.py
├── output/                 # 생성된 HTML 파일들
│   ├── index.html
│   └── *_graph.html
├── lib/                    # JavaScript 라이브러리
└── analyze.sh             # 실행 스크립트

4. 공유 방법 시도

• 초기 시도: 서버 51124에 배포 → 경로 혼란 (/home/admin/ivada_project/)
• 최종 결정: Git에 output 파일 포함하여 push
• .gitignore에서 output/, *_graph.html 제거
• 다른 개발자는 clone 후 cd output && python -m http.server 3300만 실행

주요 코드 변경사항

visualize_refined.py 개선

• 현재 프로젝트명 표시 기능 추가
• 프로젝트 선택 드롭다운 UI 개선
• 스크롤 가능한 드롭다운 (max-height: 400px)

analyze_all_projects.py 생성

• 모든 IVADA 프로젝트 자동 분석
• index.html 생성 (프로젝트 카드 뷰)
• 각 프로젝트별 HTML 파일 생성

교훈

1. 사용자 경험 우선: 프로젝트 전환 시 대기 시간 제거로 UX 개선
2. 단순한 공유 방법 선택: 복잡한 서버 배포보다 Git을 통한 공유가 효율적
3. 디렉토리 구조 중요성: 체계적인 파일 정리로 유지보수 용이
4. 서버 경로 정확히 확인: admin 계정의 홈은 /home/admin/이 아닌 실제 프로젝트 경로
5. Git 저장소 관리: 일반적으로 output은 .gitignore에 포함하지만, 공유 목적에서는 예외 가능

최종 사용법

# Git clone
git clone https://git.ro-being.com/ivada_Ro-being/file-graph-visualizer.git

# 결과 보기 (이미 분석된 output 포함)
cd file-graph-visualizer/output
python -m http.server 3300

# 브라우저에서 http://localhost:3300 접속