사용자 가이드

SnapFig 앱을 처음 설치하고 실행하며, 주요 기능을 사용하는 방법을 단계별로 안내합니다.

---

1. 설치 및 실행

사전 요구사항

• Android 기기 또는 에뮬레이터 (Android 7.0 이상)
• iOS 기기 또는 시뮬레이터 (iOS 12 이상)
• Flutter SDK 3.7.2 이상, Dart SDK 3.0 이상
• Android Studio 또는 VS Code (Flutter 플러그인 설치)
• (iOS) Xcode 12 이상

앱 설치

1. 앱 다운로드

   • Google Play / App Store 에서 “SnapFig” 검색 후 설치
   • 또는 APK/IPA 파일 직접 다운로드 및 설치

2. 앱 권한 허용

   • 파일 접근 권한: PDF 문서를 선택하고 저장하기 위해 필수
   • 마이크/카메라 권한 (AI 대화 기능 사용 시 선택)

실행하기

# 소스 코드를 직접 빌드하는 경우
git clone https://github.com/CommitBang/Frontend.git
cd Frontend
flutter pub get
flutter run --release

---

2. 기본 사용법

2.1 PDF 문서 추가

1. 앱 홈 화면에서 “+ 문서 추가” 버튼을 탭
2. 기기 파일 관리자에서 원하는 PDF 파일 선택
3. 선택 즉시 OCR & 레이아웃 분석이 자동으로 시작
4. 처리 완료 후 문서 목록에 썸네일로 표시

2.2 문서 탐색

1. 목차 버튼을 탭하면 자동 생성된 챕터 및 섹션 목록 표시
2. 원하는 챕터를 선택하여 해당 페이지로 바로 이동

2.3 텍스트–Figure 매핑 & 팝업

1. PDF 뷰어에서 본문 중 “Figure 3.1” 같은 주석 텍스트를 탭
2. 해당 Figure 이미지가 팝업 모달로 전체 표시
3. 팝업 내에서 이미지 확대/축소 및 위치 이동 가능

2.4 AI Q&A (Figure 분석)

1. Figure 팝업 하단의 “Ask AI” 버튼 탭
2. 대화 창이 열리면 질문 입력 후 전송
3. OpenAI GPT-4/Gemini가 생성한 답변을 실시간으로 확인

---

3. 고급 기능

3.1 즐겨찾기 & 하이라이트

• 즐겨찾기: 문서 뷰 상단의 ★ 아이콘 탭

• 하이라이트: 길게 누른 후 색상 선택

3.2 메모 추가

1. 화면 우측 하단 메모 아이콘 탭
2. 원하는 위치를 터치하여 텍스트 입력
3. 메모 저장 후 페이지 사이드바에서 빠르게 접근

3.3 다크 모드 전환

• 앱 설정(⚙️) → 테마 → 다크/라이트 전환

---

4. 자주 묻는 질문(FAQ)

Q1. OCR 처리 속도가 느려요.

• 고해상도 PDF는 처리 시간이 오래 걸립니다.

• 설정 → OCR 정확도 옵션을 낮게 조정해 보세요.

Q2. AI Q&A가 동작하지 않아요.

• 인터넷 연결을 확인하세요.

• 설정 → API 키가 올바르게 등록되었는지 확인하세요.

Q3. 데이터가 정상적으로 저장되지 않아요.

• 설정 → 로컬 저장소 사용 권한을 허용했는지 확인하세요.

• 앱 재시작 후 문제가 지속되면 로그를 확인해 주세요(설정 → 로그 보기).