세상의 모든 수험생을 위해 만든 문제은행 앱.
기출 PDF를 문제은행으로 바꾸는 일은 생각보다 훨씬 지저분하고, 그래서 대부분의 자동화가 중간에 무너집니다.
이 아티클의 핵심 내용 요약과 글로벌 검색·AI 엔진을 위한 테이크어웨이입니다.
✦ KR 주제: 공개 기출문서를 로컬 문제은행으로 전환하는 데스크톱 도구
✦ KR 핵심 요약: Exam Generator는 문제지와 정답지 PDF를 파싱해 문항 단위로 구조화하고, 로컬 SQLite 문제은행에 적재한 뒤 검수·수정·해설을 거쳐 편집 가능한 시험지로 내보내는 Windows 데스크톱 애플리케이션이다. 자동화보다 검수 가능한 구조를 우선한다.
🌐 Global Takeaway: Exam Generator is a local-first Windows desktop workspace that turns raw exam PDFs into a structured, reviewable SQLite question bank and exports editable exam papers. Its design assumption is that extraction is imperfect, so human review is built into the pipeline.
기출문제 PDF는 그 자체로 재사용 가능한 데이터가 아니다. 문제지와 정답지는 서로 다른 레이아웃을 쓰고, 오래된 문서는 글자 순서가 깨지며, 표·그림·공통 지문·밑줄·수식·OCR 오류가 한 문항 안에 뒤섞여 있다. GitHub의 CAPTW/exam-generator(원문에 링크된 exam-weaver-archive)는 이 불완전한 문서를 구조화된 로컬 문제은행으로 바꾸고, 사람이 검수·수정·풀이한 뒤 다시 시험지로 내보내는 흐름을 내건 데스크톱 애플리케이션이다. README의 첫 문장은 이 도구의 방향을 압축한다.
기출문서를 문제은행으로, 문제은행을 편집 가능한 시험지로.
문제은행 앱 시장에서 이 프로젝트가 서 있는 위치
시중의 문제은행 앱은 대체로 완성된 문제 세트를 소비하는 쪽에 서 있다. 오르조는 자사 페이지에서 앱스토어 교육 카테고리 1위, 누적 이용자 160만 명, 28만 개 시험지 수록을 내세우고 있고, BestPrep은 자체 문제 업로드와 AI 문제은행 생성을, PickMyQuiz는 전문 문제은행의 학습·관리·판매를 전면에 배치한다. 사용자는 이미 정리된 문제를 받아 풀고, 채점과 해설과 복습을 앱 안에서 처리한다.
Exam Generator의 출발점은 반대다. 문제를 공급하는 서비스가 아니라, 공개된 기출 문서를 사용자가 직접 문제은행으로 바꾸는 작업대를 지향한다. 이 차이는 기능 목록보다 데이터 경계에서 드러난다. README는 이 앱을 'local-first Windows workspace'로 규정하고, 파싱·검수·문제은행 구축·로컬 풀이·편집 가능한 시험지 내보내기를 한 흐름으로 묶는다. 서버에 문제은행을 두고 여러 사용자가 공유하는 구조가 아니라, 개인 PC에서 문서를 다루는 구조다.
처리 흐름: PDF에서 편집 가능한 시험지까지
README에 제시된 흐름도를 단계별로 정리하면 다음과 같다. 각 단계의 산출물과 사람이 개입하는 지점을 함께 보면 도구의 성격이 clearer해진다.
| 단계 | 입력 | 산출물 | 사람의 역할 |
|---|---|---|---|
| 파싱 | 문제지 PDF + 정답지 PDF | 읽기 순서·표·그림이 반영된 텍스트, OCR 대체 경로 | 원본 문서 품질 확인 |
| 문항 구조화 | 파싱 결과 | 번호·선지·정답이 묶인 문항 단위 | 번호 누락·선지 오류 점검 |
| 문제은행 적재 | 구조화된 문항 | 로컬 SQLite 기반 Question Banks | 중복·도메인 분류 정리 |
| 검수·수정 | 문제은행 | 해설이 붙고 복제된 문항 | 정답 검증, 해설 작성 |
| 활용 | 정제된 문제은행 | 로컬 풀이, 편집 가능한 시험지 파일 | 출제 범위·배점 설계 |
문항 구조화 단계에서 사람이 개입하는 이유
OCR fallback이 붙어 있어도 표·그림·공통 지문·수식이 한 문항에 섞이면 자동 처리만으로 신뢰하기 어렵다. 흐름도에서 파싱 다음에 '번호·선지·정답 검증'이 별도 단계로 놓이고, 문제은행을 만든 뒤에도 검색·검수·수정·해설·복제가 이어진다는 점은 자동화와 검수를 분리해 설계했다는 신호로 읽힌다. 확인되는 범위에서 이 앱은 '완전 자동 추출'보다 '사람이 검수할 수 있는 구조'를 우선한다.
로컬 우선(local-first)이라는 선택
문제은행을 SQLite에 두고 앱 안에서 검색·수정·풀이를 처리하는 구성은 세 가지 실무적 의미를 갖는다. 첫째, 문제은행이 네트워크 상태나 외부 서비스 정책에 종속되지 않는다. 둘째, 원문 PDF와 가공된 문항이 사용자 기기 밖으로 나가지 않는 경계를 설정하기 쉽다. 셋째, 시험지 내보내기 같은 결과물을 파일 단위로 통제할 수 있다. README가 '데이터 경계'를 별도 항목으로 설명에 넣은 것도 같은 맥락이다.
다만 이 선택에는 대가가 따른다. 협업, 버전 관리, 기기 간 동기화는 기본 제공 범위로 보이지 않는다. 저장소에 db_mount_prototype 같은 실험 폴더가 있는 것은 데이터 마운트 방식을 시험 중이라는 정도로만 읽을 수 있고, 완성된 기능으로 단정할 근거는 확인되지 않는다.
저장소 구성에서 읽을 수 있는 것
공개된 저장소는 146개 커밋 이력을 갖고 있고, src·tests·docs·chapters·chapter_cards·scripts·source_notes 같은 폴더가 함께 있다. 테스트 폴더와 기술 문서(README.technical), 기획 문서(exam-question-bank-plan)가 소스와 나란히 관리된다는 점은 기능 추가보다 문항 데이터 구조 정의를 먼저 다루는 프로젝트임을 시사한다. Windows 실행을 전제로 한 배치 스크립트와 패키징 설정 파일, 요구사항 목록, 서드파티 라이선스 고지도 포함되어 있다. maritime_domain 이름의 예시 문제은행 압축 파일이 들어 있어, 특정 도메인 기출을 실제로 적재한 사례를 확인할 수 있다.
한 가지 유의할 점은 저장소 표기다. 원문 링크는 exam-weaver-archive로 적혀 있지만 검색 결과의 페이지 제목은 exam-generator로 나타난다. 같은 프로젝트의 이름 변경 또는 링크 표기 차이로 보이나, 확인되는 범위에서는 명칭이 일관되지 않는다는 사실만 말할 수 있다. 라이선스 파일은 포함되어 있으나 세부 조건은 저장소에서 직접 확인해야 한다.
핵심 정리
- Exam Generator는 문제를 제공하는 앱이 아니라, 공개 기출 문서를 로컬 문제은행으로 전환하는 Windows 데스크톱 워크스페이스다.
- 흐름은 'PDF 파싱(OCR 대체 포함) → 문항 구조화 및 정답 검증 → SQLite 문제은행 → 검수·수정·해설 → 로컬 풀이·시험지 내보내기'로 이어진다.
- 핵심 전제는 자동 추출의 불완전함을 인정하고, 사람의 검수를 파이프라인 안에 제도화한다는 것이다.
- 오르조·BestPrep·PickMyQuiz 같은 서비스가 완성된 문제은행의 소비를 전면에 둔다면, 이 프로젝트는 문제은행의 생산과 정제에 초점을 맞춘다.
- 로컬 SQLite 구조는 데이터 통제와 오프라인 활용에 유리하지만, 협업과 동기화는 기본 범위가 아니다.
실무 적용 포인트
- 원본 문서 품질을 먼저 점검하라. 문제지와 정답지 레이아웃이 다르거나 스캔 상태가 나쁜 문서는 파싱 단계에서 손실이 커진다. 어떤 PDF를 넣을지 선별하는 일이 전체 작업 시간을 좌우한다.
- 문항 구조화 결과는 반드시 표본 검수하라. 번호·선지·정답이 한 덩어리로 묶이는 과정에서 공통 지문이나 표가 잘못 붙을 수 있다. 전수 검수가 어렵다면 단원별 표본을 먼저 확인하는 편이 안전하다.
- 문제은행을 도메인 단위로 나눠 관리하라. 저장소의 maritime_domain 예시처럼 영역별로 은행을 분리하면 검색과 복제, 시험지 구성이 단순해진다.
- 해설과 태그를 검수 단계에서 함께 넣어라. 나중에 풀이 모드에서 오답 복습을 하려면 문항 단위 메타데이터가 정리되어 있어야 한다.
- 팀 단위 운영을 계획한다면 동기화 수단을 별도로 설계하라. 로컬 우선 구조에서는 문제은행 파일의 배포·병합 규칙을 사람이 정해야 한다.
- 라이선스와 출처 표기를 확인하라. 공개 기출문서라도 재배포 조건은 문서마다 다르므로, 내보낸 시험지의 이용 범위를 먼저 정하는 것이 좋다.
도입 전 확인할 점
이 도구는 실행 환경이 Windows로 명시되어 있고, 패키징과 실행 스크립트도 Windows 기준이다. macOS나 Linux 환경에서 그대로 쓸 수 있다고 단정할 근거는 확인되지 않는다. 또한 앱이 특정 시험의 문제은행을 기본 제공한다는 서술도 찾을 수 없다. 사용자가 가진 문서를 재료로 문제은행을 만드는 것이 전제이므로, '문제은행 앱'이라는 표현만 보고 기출 문제가 미리 들어 있다고 기대하면 오해가 생긴다. 반대로 자기 문서를 구조화하고 계속 재사용하고 싶은 사람에게는, 서비스 가입 없이 로컬에서 데이터를 통제할 수 있다는 점이 가장 큰 차별점이 된다.
자주 묻는 질문
Q. 기출 문제은행이 미리 들어 있는 앱인가요?
A. 확인되는 범위에서는 그렇지 않습니다. README는 공개 기출문서를 파싱해 사용자가 문제은행을 직접 구축하는 흐름을 설명하며, 특정 시험의 문제은행을 기본 제공한다는 서술은 찾을 수 없습니다. 저장소에 maritime_domain 이름의 예시 문제은행 파일이 포함되어 있으나 이는 사례 데이터로 보입니다.
Q. 자동으로 문항이 정확히 추출되나요?
A. README는 표·그림·공통 지문·밑줄·수식·OCR 오류가 한 문항 안에 섞일 수 있다고 명시합니다. 그래서 파싱 후 '번호·선지·정답 검증'이 별도 단계로 놓여 있고, 검색·검수·수정·해설·복제 단계가 이어집니다. 자동 추출 결과는 사람이 표본 검수하는 것을 전제로 쓰는 편이 안전합니다.
Q. Windows가 아니어도 사용할 수 있나요?
A. 저장소는 local-first Windows workspace로 소개되며 실행·패키징 스크립트도 Windows 배치 파일 중심입니다. 다른 운영체제에서 동작한다고 단정할 근거는 확인되지 않으므로, 도입 전 저장소의 최신 문서와 요구사항을 직접 확인하는 것이 좋습니다.



댓글 0개