Skip to content

Repository files navigation

문서 신구대비실

공무원의 규정·지침·계획서 개정 업무를 위해 만든 Windows용 신구대비표 초안 생성기입니다.

기존 문서 A와 변경 문서 B를 등록하면 달라진 문장, 수치, 날짜, 추가·삭제 항목을 찾아 원문 위치와 함께 정리합니다. 유료 한컴 자동화 엔진이나 외부 인공지능 서비스 없이 내 PC에서 처리하며, 결과를 Excel 신구대비표로 내려받을 수 있습니다.

지원 환경: Windows 10·11 64비트 · 처리 방식: 내 PC에서만 처리 · 현재 버전: 0.3.0

최신 Windows 버전 내려받기 · 예시 문서로 체험하기 · 오류 제보하기

문서 신구대비실에서 변경 내용을 확인하는 가상 예시 화면

공무원을 위해 만들었습니다

연도만 바뀐 추진계획, 개정된 지침, 반복 발간하는 기술동향 보고서를 매번 눈으로 대조하는 시간을 줄이기 위해 시작했습니다.

  • 조례·규칙·훈령·예규 개정 전후 비교
  • 사업계획서와 시행계획의 연도별 변경 확인
  • 업무지침·매뉴얼·가이드 개정 내역 정리
  • 기술·정책동향 보고서의 최신판 대조
  • 최종 신구대비표를 만들기 전 검토 범위 압축

자동 비교는 담당자의 판단을 대신하지 않습니다. 빠뜨리기 쉬운 변경 후보를 먼저 모아 주고, 최종 판단과 승인은 담당자가 직접 할 수 있도록 만든 초안 작성 도구입니다.

Windows에서 바로 시작하기

  1. 최신 릴리스에서 Windows 10·11 64비트 단일 실행파일로 표시된 BookDiff-v0.3.0-windows-x64.exe를 내려받습니다.
  2. 기관에서 허용한 폴더에 파일을 저장한 뒤 두 번 클릭합니다.
  3. 기본 브라우저에 문서 신구대비실 화면이 자동으로 열립니다.
  4. 작업이 끝나면 화면 오른쪽 위의 프로그램 종료 단추를 누릅니다.

설치 프로그램이나 Python은 필요하지 않습니다. 단일 실행파일이라 처음 실행할 때 준비 시간이 조금 걸릴 수 있습니다.

Windows 보호 화면이 나타나는 경우
현재 실행파일은 코드 서명 인증서가 없어 Windows SmartScreen 경고가 표시될 수 있습니다. 반드시 이 저장소의 릴리스에서 받은 파일인지 확인하고, 기관 보안정책상 허용되는 경우에만 추가 정보 → 실행을 선택하십시오. 릴리스 설명에 공개된 SHA-256 값으로 파일 무결성을 확인할 수 있습니다.

사용법

1. 기존 문서와 변경 문서 등록

기존 문서와 변경 문서를 등록하는 가상 예시 화면

  1. A에는 기존 문서를 넣습니다. 변경 전 기준이 되는 문서입니다.
  2. B에는 변경 문서를 넣습니다. 수정되거나 새로 작성된 문서입니다.
  3. 파일 분석이 끝나면 A와 B 비교 시작을 누릅니다.

A와 B의 순서를 바꾸면 추가삭제의 의미도 반대로 표시됩니다.

2. 변경 내용과 원문 위치 확인

변경 내용과 원문 위치를 확인하는 가상 예시 화면

  • 비교가 끝나면 수치·날짜 변경, 내용 변경, 추가, 삭제를 구분해 보여 줍니다.
  • 결과 행을 누르면 A·B 원문의 해당 위치로 이동합니다.
  • 노란색 형광표시는 전체 변경 위치, 진한 표시는 현재 선택한 변경입니다.
  • 페이지를 확인할 수 있는 문서는 A · 1쪽, B · 1쪽처럼 쪽 번호를 함께 표시합니다.

3. 검토 상태 정리 후 내보내기

검토 상태와 내보내기 기능을 설명하는 가상 예시 화면

  1. 변경 유형 단추나 검색창으로 필요한 항목을 좁힙니다.
  2. 각 항목을 검토 필요, 승인, 보류로 정리합니다.
  3. 내보내기에서 Excel, CSV 또는 JSON을 선택합니다.

일반적인 행정업무에는 Excel (.xlsx) 출력을 권장합니다. 결과 파일에는 기존 내용, 변경 내용, 변경 유형, 변경 요약, A·B 쪽 번호와 검토 상태가 포함됩니다.

예시 문서로 1분 체험

실제 행정문서를 넣기 전에 공개용 가상 자료로 전체 흐름을 확인할 수 있습니다.

두 파일은 특정 기관이나 실제 사업과 관계없는 가상 자료입니다. 자세한 순서는 예시 문서 안내를 참고하십시오.

지원 문서

구분 형식 지원 내용
주력 HWP 5.x 문단·표 구조 분석, 원문 SVG 미리보기, 변경 위치 표시
주력 HWPX 문단·표 구조 분석, 구조 미리보기, 변경 위치 표시
주력 PDF 텍스트·표 분석, 실제 페이지 미리보기, 좌표 형광표시
일반 문서 DOCX, ODT, RTF 제목·문단·표 분석
표·발표 XLSX, CSV, TSV, PPTX 셀·표 행·슬라이드 텍스트 분석
텍스트 TXT, Markdown, JSON, XML, HTML 문단과 구조 분석
이미지 PNG, JPG, TIFF, BMP, WebP Tesseract가 설치된 경우 문자 인식

파일 하나의 최대 크기는 300MB입니다.

개인정보와 문서 보안

  • 프로그램은 127.0.0.1에만 열리며 문서를 외부 인공지능 서비스나 인터넷 서버로 전송하지 않습니다.
  • 원본 문서와 분석 결과는 최근 작업 복원을 위해 실행한 PC에 저장됩니다.
  • Windows 저장 위치는 %LOCALAPPDATA%\BookDiff\data입니다.
  • 실행 기록은 %LOCALAPPDATA%\BookDiff\logs\bookdiff.log에 저장됩니다.
  • 화면 오른쪽 위의 새 비교 시작을 누르면 현재 작업 세션이 삭제됩니다.
  • 프로그램을 종료하는 것만으로는 최근 작업 파일이 삭제되지 않습니다.

기관의 보안지침이 항상 우선합니다. 비밀·민감 자료는 반드시 기관이 승인한 장비와 환경에서만 처리하십시오. 이 프로그램은 보안성 검토나 문서 등급 판정을 대신하지 않습니다.

사용 전 확인해 주세요

이 프로그램이 만드는 결과는 신구대비표 초안입니다. 최종 제출 전 담당자가 반드시 원문과 대조해야 합니다.

  • 문자·토큰 유사도와 문서 순서를 기준으로 비교하므로 의미가 같은 다른 표현도 변경으로 잡힐 수 있습니다.
  • 복잡한 표, 다단 편집, 글상자, 수식은 읽기 순서나 쪽 위치가 달라질 수 있습니다.
  • HWPX의 글꼴·도형·페이지 조판은 원본과 완전히 동일하게 재현되지 않습니다.
  • 암호화되거나 배포용으로 제한된 HWP는 일부 내용만 인식될 수 있습니다.
  • 스캔 PDF와 이미지 문서는 Tesseract OCR이 설치된 경우에만 글자를 추출합니다.

문제가 생겼을 때

실행파일을 눌러도 화면이 열리지 않습니다

  1. 작업표시줄에 프로그램이 이미 실행 중인지 확인합니다.
  2. 실행파일을 한 번 더 눌러 기존 화면을 엽니다.
  3. 그래도 열리지 않으면 %LOCALAPPDATA%\BookDiff\logs\bookdiff.log를 확인합니다.

HWP 내용이 일부 빠지거나 쪽 위치가 다릅니다

암호화 여부, 배포용 문서 여부, 글상자·수식·복잡한 표 사용 여부를 확인하십시오. 원문과 비교 결과가 다르면 문서 본문과 기관 정보를 제거한 재현용 표본으로 오류를 제보해 주세요.

프로그램을 완전히 초기화하고 싶습니다

프로그램을 종료한 뒤 %LOCALAPPDATA%\BookDiff\data 폴더를 기관 보안정책에 따라 삭제하십시오. 원본 문서와 분석 결과가 함께 삭제됩니다.

개발자를 위한 Windows 실행

py -3.10 -m venv .venv
.\.venv\Scripts\python.exe -m pip install -r requirements.txt
.\scripts\download_unhwp.ps1
.\.venv\Scripts\python.exe run_dev.py

브라우저에서 http://127.0.0.1:52731을 엽니다. Windows 실행파일 빌드와 테스트 방법은 개발자 안내를 참고하십시오.

검증 현황

  • 자동 테스트 24개 통과
  • HWP, HWPX, PDF A/B 파싱·미리보기·비교 확인
  • Excel, CSV, JSON 내보내기 확인
  • 한글 파일명과 한글 경로에서 Windows 실행 확인
  • 반복 실행 시 서버가 중복으로 열리지 않는 동작 확인

세부 검증 내용은 검증 기록에 정리되어 있습니다.

참여와 라이선스

  • 자체 소스 코드는 MIT License로 배포합니다.
  • 오류 제보와 개선 제안은 기여 안내를 먼저 확인해 주세요.
  • 보안 문제는 공개 이슈에 문서나 개인정보를 첨부하지 말고 보안 안내를 따라 주세요.
  • 버전별 변경 사항은 변경 내역에서 확인할 수 있습니다.
  • 사용한 외부 구성요소와 라이선스는 제3자 고지에서 확인할 수 있습니다.

문서 신구대비실은 검토 시간을 줄이는 도구입니다. 최종 내용의 정확성과 행정적 판단은 담당자가 확인해야 합니다.

About

공무원의 HWP·HWPX·PDF 개정 업무를 위한 Windows 로컬 신구대비표 초안 생성기

Topics

Resources

Contributing

Security policy

Stars

18 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages