Skip to content

itmir913/WordFinderApp

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

43 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🔍 학교생활기록부 일괄 점검 프로그램

본 프로그램은 교사가 학교생활기록부를 효율적으로 점검할 수 있도록 돕는 도구입니다. PDF와 Excel(.xlsx) 파일을 지원하며, 발견된 단어를 자동으로 강조하고 북마크를 생성합니다.


🚀 사용자 가이드 (선생님용)

📌 Step 1. 검색 기준 설정

  • 검색할 단어들이 나열된 CSV 파일을 준비합니다. (첫 번째 열에 검색할 단어들이 입력되어 있어야 합니다.)
  • 프로그램 상단의 [CSV 파일 불러오기] 버튼을 누르거나, 화면에 CSV 파일을 드래그 앤 드롭하여 등록하세요.

📌 Step 2. 검색 대상 파일 추가

  • [📁 검색 대상 파일] 탭에서 점검할 학생부 PDF 또는 Excel 파일을 추가합니다.
  • [➕ 파일 추가] 버튼을 이용하거나, 리스트 영역으로 파일을 드래그 앤 드롭하여 여러 개를 한 번에 추가할 수 있습니다.

📥 나이스(NEIS)에서 파일 준비하기

  • Excel: 나이스(NEIS) ▷ 학급담임 ▷ 학생부 ▷ 학교생활기록부 ▷ 학생부 항목별 조회 ▷ [저장] 버튼 ▷ XLS data
  • PDF: 인쇄 ▷ 프린터 선택 ▷ PDF로 저장. 텍스트를 검색할 수 있는 원본 파일만 가능합니다. (※ 이미지 형태의 스캔본 불가능)

📌 Step 3. 처리 시작 및 확인

  • 파일이 모두 준비되면 우측 하단의 ▶ 처리 시작 버튼을 클릭합니다.
  • 진행 상황과 상세 결과(성공/실패 등)는 [📜 시스템 로그] 탭에서 실시간으로 확인할 수 있습니다.
  • 처리 중에는 ⛔ 중지 버튼을 눌러 작업을 강제로 중단할 수 있습니다.

💡 팁: 리스트에 추가된 파일을 삭제하려면 해당 파일 우측의 버튼을 누르거나, **[🗑 전체 비우기]**를 통해 목록을 초기화할 수 있습니다.

📌 Step 4. 결과 파일 활용법

  • 점검이 완료되면 원본 파일과 같은 폴더에 **output_**이 붙은 결과 파일이 생성됩니다.
  • PDF: 단어에 노란색 하이라이트가 칠해지며, 왼쪽 북마크(목차) 메뉴를 통해 발견 위치로 즉시 이동할 수 있습니다.
  • Excel: 가장 오른쪽에 '발견여부'와 '발견된 단어' 컬럼이 추가되며, 해당 행 전체가 노란색으로 강조됩니다.

ℹ️ 프로그램 정보


🛠️ 개발 및 기술 정보

📌 기술 스택

  • UI: PyQt6 (Frameless 커스텀 디자인)
  • PDF 처리: PyMuPDF (fitz) (Quad 방식 하이라이트 및 정밀 검색 플래그 적용)
  • Excel 처리: pandas + openpyxl (가상 헤더 처리 및 조건부 서식)

⚖️ 라이선스 (License)

본 프로그램은 GNU LESSER GENERAL PUBLIC LICENSE Version 3 (LGPLv3) 하에 배포됩니다.

  1. 사용 및 배포: 누구나 자유롭게 프로그램을 사용하고 복제하여 배포할 수 있습니다.
  2. 수정 및 소스 공개: 이 프로그램을 수정하여 배포할 경우, 수정된 소스코드는 LGPLv3에 따라 공개해야 합니다.
    • 단, 이 프로그램을 라이브러리 형태로 링크하여 사용하는 별도의 프로그램은 소스코드를 공개할 의무가 없습니다.
  3. 보증의 부재: 본 프로그램은 유용성을 희망하며 배포되지만, 어떠한 형태의 보증도 제공하지 않습니다.

📦 실행 파일 빌드 방법 (PyInstaller)

아래 명령어를 사용하면 Python 스크립트를 실행 파일로 패키징할 수 있습니다.

pip install pyinstaller   
pyinstaller --onedir --windowed --clean --name "WordFinderApp" --add-data "default.csv;." main.py

또는, spec 파일을 활용하여 빌드할 수도 있습니다.

pyinstaller --clean WordFinderApp.spec

Copyright 2026. All rights reserved.

About

학교생활기록부 점검 효율화를 위한 단어 검색 프로그램: PDF/엑셀 파일 내 키워드 자동 강조 및 북마크 생성 기능 제공

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages