fletimageanalysis/back_src/SIMPLE_BATCH_GUIDE.md

간단한 PDF 배치 분석기 사용법

🎯 개요

사용자 요구사항: “복잡하게 하지 말고 기존 모듈 그대로 사용해서 여러 개 처리하고 CSV로 만들기”

✅ 완전 구현 완료! getcode.py와 똑같은 방식으로 여러 PDF를 처리하고 결과를 CSV로 저장하는 시스템이 준비되어 있습니다.

🚀 실행 방법

방법 1: 간단한 실행기 사용

python run_simple_batch.py

방법 2: 직접 실행

python simple_batch_analyzer_app.py

📱 UI 사용법

1. 📂 파일 선택: “PDF 파일 선택” 버튼 클릭 또는 드래그&드롭
2. ✏️ 프롬프트 설정 (선택사항): 기본값은 getcode.py와 동일
   • 기본: “pdf 이미지 분석하여 도면인지 어떤 정보들이 있는지 알려줘”
3. ▶️ 분석 시작: “배치 분석 시작” 버튼 클릭
4. 📊 진행률 확인: 실시간 진행률 및 처리 상태 표시
5. 💾 결과 확인: 자동으로 CSV 파일 저장 및 요약 통계 표시

📄 CSV 출력 형식

생성되는 CSV 파일에는 다음 컬럼들이 포함됩니다:

컬럼명	설명
file_name	파일 이름
file_size_mb	파일 크기 (MB)
processing_time_seconds	처리 시간 (초)
success	성공 여부 (True/False)
analysis_result	getcode.py 스타일 분석 결과
analysis_timestamp	분석 완료 시간
prompt_used	사용된 프롬프트
model_used	사용된 AI 모델
error_message	오류 메시지 (실패시)
processed_at	처리 완료 시간

🔧 환경 설정

1. API 키 설정

.env 파일에 Gemini API 키 설정:

GEMINI_API_KEY=your_api_key_here

2. 필요 패키지 설치

pip install -r requirements.txt

주요 패키지:

• flet>=0.25.1 - UI 프레임워크
• google-genai>=1.0 - Gemini API
• PyMuPDF>=1.26.3 - PDF 처리
• pandas>=1.5.0 - CSV 출력
• python-dotenv>=1.0.0 - 환경변수

⚡ 핵심 특징

• ✨ 단순성: getcode.py와 동일한 방식, 복잡한 기능 제거
• 🔄 배치 처리: 한 번에 여러 PDF 파일 처리
• 📊 CSV 출력: JSON 분석 결과를 자동으로 CSV 변환
• ⚡ 성능: 비동기 처리로 빠른 배치 분석
• 📱 사용성: 직관적이고 간단한 UI

🗂️ 파일 저장 위치

• CSV 결과: D:/MYCLAUDE_PROJECT/fletimageanalysis/results/
• 파일명 형식: batch_analysis_results_YYYY-MM-DD_HH-MM-SS.csv

🎯 예상 사용 시나리오

1. 여러 도면 PDF 분석: 한 번에 10-50개 도면 파일 분석
2. 일괄 메타데이터 추출: 도면 정보, 제목, 축척 등 추출
3. 분석 결과 관리: CSV로 저장하여 Excel에서 관리
4. 품질 보증: 성공률 및 처리 시간 통계로 분석 품질 확인

🔍 문제 해결

Q: 분석이 실패하는 경우

A:

• Gemini API 키가 올바르게 설정되었는지 확인
• PDF 파일이 손상되지 않았는지 확인
• 인터넷 연결 상태 확인

Q: UI가 실행되지 않는 경우

A:

• Python 3.9+ 버전 확인
• Flet 패키지 설치 확인: pip install flet
• 작업 디렉토리가 올바른지 확인

Q: CSV 파일을 찾을 수 없는 경우

A:

• results/ 폴더가 자동 생성됩니다
• 완료 메시지에서 정확한 파일 경로 확인
• 파일 권한 문제 확인

📞 지원

이 시스템은 사용자 요구사항에 맞춰 단순하고 직관적으로 설계되었습니다. getcode.py의 장점을 그대로 유지하면서 배치 처리 기능만 추가했습니다.