DOCS/journey/troubleshooting/250803_happybell80_file-graph분석도구.md
Claude-51124 22557e7132 docs: 오래된 트러블슈팅 아카이브 및 구조 정리
- 7-8월 초기 구축 문서 12개를 _archive/troubleshooting/2025_07-08_initial_setup/로 이동
- book/300_architecture/390_human_in_the_loop_intent_learning.md를 journey/research/intent_classification/로 이동 (개발 여정 문서)
- 빈 폴더 제거 (journey/assets/*)
2025-11-17 14:06:05 +09:00

2.7 KiB

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 접속