문항맵(Munhang-map)

문항맵 모의고사 PDF를 문항 단위로 갈라, 깨진 수식을 되살리고, 2022 개정 교육과정 성취기준 후보를 붙여 한글·워드 파일로 내보내는 교사용 도구입니다. 설치도 로그인도 없이 내 컴퓨터 안에서만 돕니다. 시험지 PDF를 열면 늘 하던 그 작업 문항을 하나씩 긁어 붙이고, 깨진 수식을 손으로 다시 쓰고, 성취기준 문서를 열어 코드를 찾아 적습니다. 시험지 한 부를 정리하는 데 걸리는 시간의 대부분은 이 옮겨 적는 일에 들어갑니다. 문항맵은 이 반복을 대신합니다. 교사는 결과를 확인하고 고치는 데만 시간을 씁니다. (물론 아직 develop 중에 있어서 원하는 대로 뙇! 하고 나오지 않을 수 있습니다.) 깨진 수식을 되살립니다 한글 수식 편집기로 만든 시험지는 전용 글꼴을 쓰기 때문에, PDF에서 그대로 복사하면 숫자와 기호가 네모로 깨집니다. "물체의 길이는 □□□□□□이다" 같은 문장을 받아 본 적이 있으실 겁니다. 문항맵은 이것을 "물체의 길이는 65.0 cm이다"로 되돌립니다. 다만 아무 글자나 추측해서 바꾸지 않습니다. 글꼴 이름과 문자 코드, 글자 모양이 모두 일치할 때만 원래 문자로 복원하고, 확신이 서지 않으면 고치지 않고 "문자 복원 확인 필요"라고 표시합니다. 틀린 숫자를 그럴듯하게 채워 넣는 것보다, 확인이 필요하다고 알려 주는 편이 안전하기 때문입니다. 흩어져 있는 6, 5, 점, 0, c, m을 좌표와 기준선으로 묶어 하나의 값으로 복원하고, 분수와 근호, 위아래 첨자도 좌표를 따라 연결해 수식으로 보여 줍니다. 무엇을 하나 문항 분리 — 2단으로 짠 시험지도 단을 구분해, 문항 번호부터 다음 번호 직전까지를 한 문항으로 끊습니다. 발문과 자료, 선택지를 포함한 원문 전체 캡처를 문항마다 함께 남깁니다. 표와 자료 상자 — PDF에 실제로 그려진 선을 읽어 표와 <보기> 상자를 되살립니다. 바깥 세로선이 없는 표나, 제목 때문에 윗선이 끊긴 상자도 찾아냅니다. 성취기준 연결 — 초·중·고 3,285개 성취기준에서 후보를 찾아 붙입니다. 예를 들어 [9국01-01] 화자의 의도와 관점을 추론하며 듣는다. 와 같이 제시되며, 최종 선택은 교사가 합니다. (@pblsketch 선생님의 git에 있는 성취기준을 이용하였습니다. 감사합니다!) 내보내기 — DOCX와 HWPX로 내보냅니다. 성취기준별로 파일을 나눠 ZIP 하나로 받을 수 있고, 표는 문서에서 그대로 편집됩니다. 내 문제함 — 여러 시험지에서 고른 문항을 이 컴퓨터에 모아 두었다가, 나중에 검색해 함께 내보냅니다. 직접 수정 — 인식 결과는 언제든 고칠 수 있습니다. 굵게와 밑줄은 Cmd 또는 Ctrl 키와 B, U로 넣으며, 내보낸 문서까지 그대로 유지됩니다. 시험지는 내 컴퓨터 밖으로 나가지 않습니다 문항맵은 내 컴퓨터에서 작은 서버를 띄우고 브라우저로 접속하는 방식입니다. 주소는 127.0.0.1, 즉 이 컴퓨터에서만 열립니다. 같은 공유기를 쓰는 다른 사람도 접속할 수 없습니다. 문항 분리, 원문 캡처, 수식 문자 복원, 표 인식, 성취기준 검색까지 전부 외부 AI 없이 됩니다. 가입도 로그인도 필요 없고, 시험지 파일이 어딘가로 업로드되지도 않습니다. 더 어려운 문항을 AI로 다시 읽히고 싶을 때만 본인 API 키를 연결합니다. OpenAI, Anthropic Claude, Google Gemini와 OpenAI 호환 로컬 모델을 쓸 수 있습니다. 이때만 해당 문항의 이미지가 선택한 곳으로 전송되고, 비용도 본인 계정에서 나갑니다. 사용법 1. Node.js 22.13 이상을 설치합니다. nodejs.org에서 LTS 버전을 받으면 되고, 한 번만 하면 됩니다. 2. 아래 주소에서 ZIP을 내려받아 압축을 풉니다. 폴더 전체를 옮기세요. 실행 파일만 따로 꺼내면 동작하지 않습니다. 3. Mac은 문항맵.command, Windows는 문항맵.bat(또는 .cmd 파일)를 실행합니다. 검은 창이 뜨고 브라우저가 자동으로 열립니다. 이 창을 닫으면 문항맵도 함께 종료됩니다. Mac에서 "확인할 수 없는 개발자"라며 열리지 않으면, 파일을 우클릭한 뒤 열기 → 열기를 처음 한 번만 해 주세요. 그다음부터는 더블클릭으로 열립니다. 4. 시험지 PDF를 넣고 분석이 끝나기를 기다립니다. 스캔한 PDF는 글자 정보가 없어 먼저 OCR을 거쳐야 합니다. 5. 원문과 대조하며 고치고, 성취기준을 고른 뒤 내보냅니다. "검토 저장"으로 작업 상태를 파일에 보관했다가 다음에 이어서 할 수 있습니다. 알아두실 점 자동 추출 결과는 초안입니다. 문항 분리도, 수식 복원도, 성취기준 추천도 완벽하지 않습니다. 반드시 원문과 대조하고 고친 뒤에 사용하세요. 성취기준 옆에 표시되는 퍼센트는 문자 인식 정확도가 아니라 후보의 관련도입니다. 텍스트형 PDF가 대상입니다. 글자와 선이 PDF 안에 들어 있어야 합니다. 이미지로 스캔한 시험지는 OCR을 먼저 거쳐야 하고, 그림 안에 그려진 표는 셀 구조까지 복원하지 않습니다. 시험지의 저작권은 별개입니다. 문항맵이 MIT 라이선스라는 것은 이 프로그램의 코드에 대한 이야기이고, 시험지와 문항을 어디까지 쓰고 나눌 수 있는지는 사용하는 분이 직접 확인하셔야 합니다. 문제함과 검토 파일에는 시험지 원문이 암호화되지 않은 채로 담기니, 다른 사람과 주고받을 때 주의하세요. 내려받기 - (교사 인증 후 열 수 있어요) 문항맵 0.7.2 · 제작 여광재(온양고등학교) · 코드는 MIT 라이선스 성취기준 자료는 pblsketch/worksheet-grab, HWPX 서식은 jkf87/hwpx-skill, 수식 표시는 KaTeX를 사용합니다.