kimminsung/fletimageanalysis
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

first commit

Browse Source
This commit is contained in:
김민성
2025-07-16 17:33:20 +09:00
commit 4b9161db45
51 changed files with 23478 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

266
README.md Normal file
View File

@@ -0,0 +1,266 @@
# PDF/DXF 문서 분석기
Flet 기반의 PDF 및 DXF 파일 업로드 및 분석 애플리케이션입니다. PDF 파일은 Google Gemini AI를 통해 이미지 분석을, DXF 파일은 ezdxf 라이브러리를 통해 도곽 정보 및 Block Reference/Attribute Reference를 추출하여 상세한 정보를 제공합니다.
![Python](https://img.shields.io/badge/Python-3.9+-blue.svg)
![Flet](https://img.shields.io/badge/Flet-0.25.1+-orange.svg)
![ezdxf](https://img.shields.io/badge/ezdxf-1.4.2+-red.svg)
![License](https://img.shields.io/badge/License-MIT-green.svg)
## 🌟 주요 기능
### PDF 분석 기능
- 📄 **PDF 파일 업로드**: 간편한 드래그 앤 드롭 인터페이스
- 🔍 **AI 이미지 분석**: Google Gemini API를 통한 고급 이미지 분석
- 🏢 **조직별 스키마**: 국토교통부/한국도로공사 전용 분석 스키마
- 👁️ **PDF 뷰어 모달**: 별도 창에서 PDF 미리보기 및 페이지 네비게이션
### DXF 분석 기능 (NEW)
- 🏗️ **DXF 파일 지원**: CAD 도면 파일 (.dxf) 업로드 및 분석
- 📐 **도곽 정보 추출**: 도면명, 도면번호, 건설분야, 건설단계, 축척 등
- 🔧 **Block Reference 분석**: 블록 참조 및 속성 정보 완전 추출
- 📋 **Attribute Reference**: 모든 속성의 tag, text, prompt, position, bounding box 정보
- 📏 **바운딩 박스 계산**: 텍스트 및 블록의 정확한 좌표 정보
- 🎯 **ATTDEF 정보 수집**: 블록 정의에서 프롬프트 정보 자동 매핑
### 공통 기능
- 📊 **실시간 진행률**: 분석 과정을 실시간으로 확인
- 🎨 **현대적인 UI**: 좌우 분할 레이아웃 및 Material Design 기반 인터페이스
- ⚙️ **다양한 분석 모드**: 기본, 상세, 사용자 정의 분석
- 💾 **결과 저장**: 분석 결과를 텍스트/JSON 파일로 저장
- 📱 **반응형 디자인**: 다양한 화면 크기에 대응하는 인터페이스
## 🚀 빠른 시작
### 1. 요구 사항
- Python 3.9 이상
- Google Gemini API 키
### 2. 설치
```bash
# 저장소 클론
git clone https://github.com/your-username/pdf-analyzer.git
cd pdf-analyzer
# 가상 환경 생성 (권장)
python -m venv venv
# 가상 환경 활성화
# Windows:
venv\\Scripts\\activate
# macOS/Linux:
source venv/bin/activate
# 의존성 설치
pip install -r requirements.txt
```
### 3. 환경 설정
1. `.env.example` 파일을 `.env`로 복사:
```bash
copy .env.example .env # Windows
cp .env.example .env # macOS/Linux
```
2. `.env` 파일을 편집하여 Gemini API 키 설정:
```env
GEMINI_API_KEY=your_actual_gemini_api_key_here
```
### 4. 실행
```bash
python main.py
```
## 🛠️ 설정
### 환경 변수
`.env` 파일에서 다음 설정을 조정할 수 있습니다:
```env
# 필수: Gemini API 키
GEMINI_API_KEY=your_gemini_api_key
# 애플리케이션 설정
APP_TITLE=PDF 도면 분석기
APP_VERSION=1.0.0
DEBUG=False
# 파일 업로드 설정
MAX_FILE_SIZE_MB=50
ALLOWED_EXTENSIONS=pdf
UPLOAD_FOLDER=uploads
# Gemini API 설정
GEMINI_MODEL=gemini-2.5-pro
DEFAULT_PROMPT=pdf 이미지 분석하여 도면인지 어떤 정보들이 있는지 알려줘.
```
### Gemini API 키 획득
1. [Google AI Studio](https://makersuite.google.com/app/apikey)에 접속
2. Google 계정으로 로그인
3. "Create API Key" 클릭
4. 생성된 API 키를 `.env` 파일에 추가
## 📖 사용법
### 기본 사용법
1. **PDF 파일 선택**: "PDF 파일 선택" 버튼을 클릭하여 분석할 PDF 파일을 선택합니다.
2. **분석 설정**:
- **페이지 선택**: 첫 번째 페이지만 또는 모든 페이지 분석 선택
- **분석 모드**: 기본, 상세, 사용자 정의 중 선택
3. **분석 시작**: "분석 시작" 버튼을 클릭하여 AI 분석을 시작합니다.
4. **결과 확인**: 분석 완료 후 결과를 확인하고 필요시 저장합니다.
### 분석 모드
- **기본 분석**: 문서 유형 및 기본 정보 분석
- **상세 분석**: 도면, 도표, 텍스트 등 상세 정보 분석
- **사용자 정의**: 원하는 분석 내용을 직접 입력
## 🏗️ 프로젝트 구조
```
fletimageanalysis/
├── main.py # 메인 애플리케이션
├── config.py # 설정 관리
├── pdf_processor.py # PDF 처리 모듈
├── gemini_analyzer.py # Gemini API 연동
├── ui_components.py # UI 컴포넌트
├── requirements.txt # 의존성 목록
├── .env.example # 환경 변수 템플릿
├── uploads/ # 업로드 폴더
├── assets/ # 자산 폴더
└── docs/ # 문서 폴더
```
## 🔧 개발
### 개발 환경 설정
```bash
# 개발용 의존성 설치
pip install black flake8 pytest
# 코드 포맷팅
black .
# 코드 검사
flake8 .
# 테스트 실행
pytest
```
### 모듈 설명
#### `pdf_processor.py`
- PDF 파일 검증 및 정보 추출
- PDF 페이지를 이미지로 변환
- Base64 인코딩 처리
#### `gemini_analyzer.py`
- Gemini API 클라이언트 관리
- 이미지 분석 요청 및 응답 처리
- 스트리밍 분석 지원
#### `ui_components.py`
- Flet UI 컴포넌트 정의
- 재사용 가능한 UI 요소들
- Material Design 스타일 적용
#### `main.py`
- 메인 애플리케이션 로직
- 이벤트 처리 및 UI 통합
- 백그라운드 작업 관리
## 🐛 문제 해결
### 일반적인 문제들
**1. API 키 오류**
```
오류: Gemini API 키가 설정되지 않았습니다.
해결: .env 파일에 올바른 GEMINI_API_KEY를 설정하세요.
```
**2. PDF 파일 오류**
```
오류: 유효하지 않은 PDF 파일입니다.
해결: 손상되지 않은 PDF 파일을 사용하거나 다른 PDF로 시도하세요.
```
**3. 의존성 설치 오류**
```bash
# PyMuPDF 설치 문제가 있을 경우
pip install --upgrade pip
pip install PyMuPDF --no-cache-dir
```
**4. 메모리 부족 오류**
```
해결: 큰 PDF 파일의 경우 첫 번째 페이지만 분석하거나
zoom 값을 낮춰서 이미지 크기를 줄이세요.
```
### 로그 확인
애플리케이션 실행 시 콘솔에서 상세한 로그를 확인할 수 있습니다:
```bash
python main.py 2>&1 | tee app.log
```
## 🤝 기여하기
1. 이 저장소를 포크합니다
2. 기능 브랜치를 생성합니다 (`git checkout -b feature/AmazingFeature`)
3. 변경사항을 커밋합니다 (`git commit -m 'Add some AmazingFeature'`)
4. 브랜치에 푸시합니다 (`git push origin feature/AmazingFeature`)
5. Pull Request를 생성합니다
## 📝 라이선스
이 프로젝트는 MIT 라이선스 하에 배포됩니다. 자세한 내용은 [LICENSE](LICENSE) 파일을 참조하세요.
## 🙏 감사의 말
- [Flet](https://flet.dev/) - 뛰어난 Python UI 프레임워크
- [Google Gemini](https://ai.google.dev/) - 강력한 AI 분석 API
- [PyMuPDF](https://pymupdf.readthedocs.io/) - PDF 처리 라이브러리
## 📞 지원
문제가 있거나 질문이 있으시면 [Issues](https://github.com/your-username/pdf-analyzer/issues) 페이지에서 이슈를 생성해 주세요.
---
**🔗 관련 링크**
- [Flet 문서](https://flet.dev/docs/)
- [Gemini API 문서](https://ai.google.dev/gemini-api/docs)
- [PyMuPDF 문서](https://pymupdf.readthedocs.io/)