
학원·학교에서 가장 흔한 스캔 요청 중 하나는 이것이다. “시험지·프린트에 쓴 필기를 지우고, 인쇄된 글자는 그대로 두고 싶다.” 시중 스캐너 앱은 곡면 보정·OCR에는 강하지만, 필기 제거 과정에서 인쇄 글자를 다시 그려 버리는 경우가 있다. 시험지 재사용에는 치명적이다.
ocr-scanner-fable 작업(제품 가칭 CleanScan / CleanScan)은 그 문제를 Web 우선 파이프라인으로 풀어 본 기록이다. 이 글은 기획서·마일스톤 로그에 남은 결정과 교훈만 요약한다. 벤치마크 앱의 다운로드 수 등은 기획 조사에 인용된 참고치이며, 우리 제품의 성과 지표가 아니다.

제품 한 줄
교재·시험지·프린트를 올리면 필기·낙서만 지우고 인쇄 원본을 복원하는 스캐너. OCR은 후속 단계로 두고, 1차 가치는 원본 픽셀 충실도에 둔다.
왜 생성형 “통짜 편집”을 기본으로 두지 않았나
기획 비교에서 생성형 이미지 편집 API는 MVP가 빠르지만, 문서 전체를 재생성하며 인쇄 글자를 치환·변형할 수 있다. 그래서 권장 골격은 하이브리드였다.
- 경계 감지·원근 보정
- 필기 마스크 (고전 CV + 세그멘테이션)
- 마스크 안만 인페인팅 (기본 LaMa, 실패 시 TELEA 폴백)
- 마스크 밖 픽셀은 수정하지 않는다
이 문장이 전 아키텍처의 중심이다.
파이프라인에서 배운 안전장치
마일스톤 로그에 남은 실전 교훈을 짧게 옮긴다.
불확실 영역 표시 LaMa는 필기 아래 인쇄 글자를 “그럴듯한 오탈자”로 채워 넣을 수 있다. 충실도 OCR 게이트는 마스크 *안쪽*을 측정하기 어렵다. 그래서 복원 불확실 구간을 계약 필드와 앰버 하이라이트로 노출했다. “깨끗해 보이는 결과”보다 어디를 믿으면 안 되는지를 보여 주는 쪽을 택했다.
마스크 커버리지 상한 실스캔에서 오검출이 커지면 본문까지 지워진다. 커버리지 상한(의심 마스크)과 원본 보존 경로를 넣어, 파괴적 결과를 차단하는 실험을 했다. 로그상 오검출이 크게 줄고 본문 보존이 확인된 사례가 있다. 굵은 헤더 오검출·잔여 필기는 이후 과제로 남겼다.
데모와 mock을 섞지 않기 UI mock만으로는 “필기 제거가 안 된다”는 피드백을 재현할 수 없다. 워커 FastAPI 직결 로컬 데모 브리지를 두고 나서야 브라우저 e2e로 원자적 JSON 쓰기·폴링 내성 같은 결함을 잡았다.
계약(versioned job schema) UUID·상태 전이·soft error·uncertain_regions 등을 버전으로 고정하고, 구세대 산출물은 폐기 세대로 격리했다. UI·워커·QA가 같은 언어로 실패를 말하게 하려는 목적이다.
교육 현장 관점
- 학원 배치: 같은 시험지 PDF를 다시 쓰려면 “예쁜 복원”보다 “인쇄 동일성”이 먼저다.
- 학생 오답 노트: 필기 제거 후 OCR·문항 클립은 P1 이후 스토리다. 너무 일찍 묶으면 충실도 문제가 가려진다.
- 윤리: 저작권 있는 교재 스캔·재배포는 사용자 책임 영역이다. 도구는 복원 보조이며, 무단 배포를 권장하지 않는다.
지금 단계의 한계
- Web MVP·로컬 워커 중심. Android 연속 촬영은 후속.
- 실스캔 다양성(조명·볼펜·형광펜·겹친 글씨)은 여전히 꼬리다.
- “100% 원본 보존”을 마케팅 문장으로 쓰지 않는다. 대신 OCR diff 게이트·불확실 영역 같은 검증 장치를 제품 언어로 남긴다.
다음에 같은 스캐너를 만든다면
- 마스크 밖 불변식 테스트부터 자동화한다.
- 실패 UX(재시도·원본 다운로드·불확실 배지)를 모델 교체보다 먼저 둔다.
- 교육용 배치(여러 장 → PDF)는 충실도 리포트와 함께 출시한다.
필기 제거는 이미지 미화가 아니라 문서 신뢰 문제다. CleanScan 실험이 남긴 가장 큰 문장은 여전히 이것이다. 마스크 밖은 건드리지 않는다. 확신이 없으면 표시한다.
FAQ
Q. 생성형으로 페이지 전체를 다시 그리는 방식이 기본인가요?
A. 이 회고 기준으로는 기본으로 두지 않았습니다. 필기 마스크 안에서만 지우고 인쇄 영역은 건드리지 않는 쪽을 안전장치로 둡니다.
Q. “원본 100% 보존”이라고 말해도 되나요?
A. 마케팅 문장으로 쓰지 않습니다. 대신 OCR diff 게이트·불확실 영역 표시 같은 검증 장치를 제품 언어로 남깁니다.
Q. 교재 스캔을 자유롭게 재배포해도 되나요?
A. 안 됩니다. 저작권 있는 교재 스캔·재배포는 사용자 책임이며, 도구는 복원 보조일 뿐 무단 배포를 권장하지 않습니다.
Q. 지금 단계에서 완전한 Android 연속 촬영 제품인가요?
A. 아닙니다. Web MVP·로컬 워커 중심이고 Android 연속 촬영은 후속으로 적혀 있습니다.
작성: moonlang journal · polish 2026-09-23 · 저작권·100% 보존 마케팅 문장 없음









