================================================================================
PDF 표 추출 및 엑셀 변환 도구
PDF Table Extractor v1.0.0
================================================================================

제작자: 의학계산기 (www.medcalc.co.kr)
Copyright © 의학계산기 medcalc.co.kr

================================================================================
프로그램 소개
================================================================================

이 프로그램은 텍스트 기반 PDF 파일에서 표를 자동으로 추출하여 
엑셀 파일(.xlsx)로 변환해주는 도구입니다.

주요 기능:
  ✓ PDF 파일에서 표 자동 인식 및 추출
  ✓ 페이지 범위 선택 (전체 또는 일부 페이지)
  ✓ 추출된 표 미리보기
  ✓ 엑셀 파일로 변환 및 다운로드
  ✓ 드래그 앤 드롭 파일 업로드 지원

================================================================================
시스템 요구사항
================================================================================

운영체제:
  - Windows 10 이상 (Windows 11 권장)
  - 64비트 운영체제

하드웨어:
  - RAM: 최소 4GB (8GB 이상 권장)
  - 디스크 공간: 100MB 이상 여유 공간
  - 인터넷 연결: 불필요 (오프라인 실행 가능)

소프트웨어:
  - 웹 브라우저 (Chrome, Edge, Firefox 등)
  - 추가 설치 프로그램 불필요

================================================================================
설치 방법
================================================================================

1. ZIP 파일 압축 해제
   - PDF_Table_Extractor.zip 파일을 우클릭
   - "압축 풀기" 또는 "Extract All" 선택
   - 원하는 폴더에 압축 해제

2. 실행 파일 확인
   - 압축 해제된 폴더에서 "PDF_Table_Extractor_by_Medcalc.exe" 파일 확인

3. 설치 완료!
   - 별도의 설치 과정이 필요 없습니다.
   - 실행 파일만 있으면 바로 사용할 수 있습니다.
   - 모두 무료입니다.

================================================================================
사용 방법
================================================================================

1단계: 프로그램 실행
  - PDF_Table_Extractor.exe 파일을 더블클릭하면 실행됩니다.
  - 명령 프롬프트 창이 열리고 서버가 시작됩니다. (이때 시간이 걸릴 수 있으므로 잠시 기다려주세요.)
  - 잠시 후 브라우저가 자동으로 열립니다.
  - 브라우저 주소: http://localhost:5000

2단계: PDF 파일 업로드
  - 웹 페이지의 업로드 영역에 PDF 파일을 드래그 앤 드롭하거나
  - 업로드 영역을 클릭하여 파일 선택
  - 파일 정보(파일명, 크기, 페이지 수)가 자동으로 표시됩니다.

3단계: 페이지 범위 선택 (선택사항)
  - "전체 페이지": PDF의 모든 페이지에서 표 추출
  - "일부 페이지 선택": 시작 페이지와 끝 페이지 지정

4단계: 표 추출
  - "표 추출 시작" 버튼 클릭
  - 처리 중 메시지와 진행률이 표시됩니다
  - 추출 완료 시 미리보기 테이블이 표시됩니다

5단계: 엑셀 파일 다운로드
  - "엑셀 파일 다운로드" 버튼 클릭
  - 엑셀 파일이 자동으로 다운로드됩니다
  - 파일명: [원본PDF파일명]_tables.xlsx

6단계: 초기화 (선택사항)
  - "초기화" 버튼으로 모든 데이터 초기화 가능

================================================================================
주의사항
================================================================================

1. 첫 실행 시 Windows Defender 경고
   - Windows Defender가 "알 수 없는 게시자" 경고를 표시할 수 있습니다.
   - 이는 정상적인 현상입니다 (코드 서명 인증서 미사용)
   - 해결 방법:
     * "추가 정보" 클릭
     * "실행" 버튼 클릭
   - 또는 Windows Defender에서 예외 추가 가능

2. 지원하는 PDF 형식
   - 텍스트 기반 PDF만 지원합니다.
   - 이미지 기반 PDF(스캔본)는 지원하지 않습니다.
   - OCR이 필요한 PDF는 사용할 수 없습니다.

3. 표 구조
   - 각 페이지에 하나의 표가 있다고 가정합니다.
   - 첫 번째 페이지의 첫 번째 행을 헤더로 인식합니다.
   - 복잡한 표 구조는 정확도가 떨어질 수 있습니다.

4. 동시 작업 제한
   - 한 번에 하나의 작업만 처리됩니다.

5. 포트 사용
   - 기본 포트: 5000
   - 포트가 사용 중이면 자동으로 다른 포트를 찾습니다.
   - 여러 개의 프로그램을 동시에 실행할 수 없습니다.

================================================================================
문제 해결
================================================================================

문제 1: "localhost에서 연결을 거부했습니다" 오류
  해결:
    - 명령 프롬프트 창에서 서버가 정상적으로 시작되었는지 확인
    - 브라우저 주소를 http://localhost:5000 으로 직접 입력
    - 방화벽이 차단하고 있는지 확인

문제 2: "다른 작업이 진행 중입니다" 메시지
  해결:
    - 현재 진행 중인 작업이 완료될 때까지 대기
    - 또는 브라우저를 새로고침하여 상태 확인

문제 3: 표가 추출되지 않음
  해결:
    - PDF가 텍스트 기반인지 확인 (이미지 기반 PDF는 불가)
    - PDF에 표가 실제로 있는지 확인
    - 다른 PDF 파일로 테스트

문제 4: 프로그램이 실행되지 않음
  해결:
    - Windows 10 이상인지 확인
    - 바이러스 백신 프로그램이 차단하고 있는지 확인
    - 관리자 권한으로 실행 시도

문제 5: 엑셀 파일이 다운로드되지 않음
  해결:
    - 브라우저의 다운로드 설정 확인
    - 팝업 차단기 해제
    - 브라우저 캐시 삭제 후 재시도

================================================================================
프로그램 종료
================================================================================

종료 방법:
  1. 명령 프롬프트 창에서 Ctrl+C 누르기
  2. 또는 명령 프롬프트 창을 닫기

주의:
  - 프로그램을 종료하면 웹 서버도 함께 종료됩니다.
  - 브라우저에서 접속할 수 없게 됩니다.
  - 다시 사용하려면 프로그램을 다시 실행하세요.

================================================================================
문의 및 지원
================================================================================

웹사이트: https://www.medcalc.co.kr
이메일: sondoctor@kakao.com

버그 리포트나 기능 제안은 웹사이트를 통해 문의해주세요.

================================================================================
버전 정보
================================================================================

현재 버전: v1.0.0
릴리스 날짜: 2026년 1월

주요 기능:
  - PDF 표 추출
  - 엑셀 파일 변환
  - 웹 기반 사용자 인터페이스
  - 드래그 앤 드롭 파일 업로드
  - 페이지 범위 선택
  - 표 미리보기

================================================================================
라이선스 및 면책 조항
================================================================================

이 프로그램은 무료로 제공됩니다.
개인적 용도로 자유롭게 사용할 수 있으나 상업적 용도로 사용할 수 없습니다.

면책 조항:
  - 이 프로그램의 사용으로 인한 데이터 손실이나 손해에 대해
    제작자는 책임을 지지 않습니다.
  - 프로그램 사용 전 중요한 데이터는 백업하시기 바랍니다.
  - 프로그램은 "있는 그대로" 제공되며, 명시적이거나 묵시적인
    보증을 제공하지 않습니다.

================================================================================
감사의 말
================================================================================

이 프로그램을 사용해주셔서 감사합니다.
더 나은 서비스를 위해 계속 개선하겠습니다.

의학계산기 (www.medcalc.co.kr)

================================================================================
