본문으로 건너뛰기

03. Aside로 자료에서 지도까지 연결하며, 표시와 승인을 나눈 이유

강진태

2026.10.11

2026-10-11 기록 기준

PDF에서 읽은 문장이 위성지도에 표시되면 어디까지 검증됐다고 말할 수 있을까요? 저는 해루질GO에서 이 연결을 자동화하되, 문서 추출이 위치 승인으로 바뀌지 않게 하고 싶었습니다. 공개 어장 경계도 마찬가지였습니다. 자료를 정확히 읽고 전달하는 능력과 그곳에 들어가도 된다고 판단할 권한은 다르기 때문입니다.

요청 요약이며 실제 원문은 아닙니다. 승인된 합성 PDF로 로컬 추출과 검토 절차를 검증하고, 공개 어장 자료는 참고 경계로 처리한다. 지도에 연결하더라도 원본 PDF의 정확한 위치, 현재 권리, 수심을 확인한 것으로 간주하지 않는다.

1. Aside가 읽을 수 있는 입력부터 잠갔습니다

Aside는 PDF.js로 합성 PDF의 페이지 수와 내장 텍스트를 추출하고, Canvas 렌더와 로컬 Tesseract의 영어·한국어 모델로 이미지 PDF를 OCR 처리했습니다. 제가 확인한 것은 이 도구가 고정 합성 fixture에서 작동했다는 기록입니다. 원본 PDF나 현장 사진을 처리한 결과도, 실제 한글 자료의 인식 정확도도 아닙니다.

입력 제한은 요청자의 선언보다 강했습니다. 추출 계약은 fixture의 ID·파일명·SHA-256·바이트 크기가 모두 맞아야 입력을 받습니다. manifest 자체의 해시도 고정해 목록과 PDF를 함께 바꾸지 못하게 했습니다. 임의 URL·경로·업로드는 제외했고, OCR 모델과 실행 자원도 로컬로 제한했습니다. 문서를 외부에 보내는 경로는 두지 않았습니다.

실행 한도는 파일 5MiB, 최대 8페이지, 요청당 선택 3페이지, 페이지 렌더 400만 픽셀, 동시 worker 1개, 기본 제한시간 30초였습니다. Aside는 정상 텍스트와 스캔뿐 아니라 손상·암호화·시간초과·변경된 바이트·오래된 버전도 합성시험에 넣었습니다. 저는 PDF_EXTRACTION_LOCAL.md에서 입력 계약을, 결과 기록에서 실패 범위를 확인했습니다. 파서 설치보다 무엇을 거부하는 코드인지 확인하는 일이 먼저였습니다.

2. 읽은 결과가 지도 위치로 넘어가는 문턱을 남겼습니다

추출 문자열의 정확 인용 증명은 같은 문장이 있는지만 확인합니다. 공백이나 대소문자를 정규화해 맞춘 것으로 처리하지 않으며, 문장의 의미나 지명·지도표식·좌표를 검증하지도 않습니다. OCR 결과는 불확실한 보조 전사로 남겼습니다. 저는 문자를 읽었다는 증거를 위치를 찾았다는 증거로 쓰지 않았습니다.

PDF_REVIEW.md의 관리자 검토 계약에서도 이 구분이 이어졌습니다. 사람이 원문과 전사를 대조해 승인 요청을 하더라도 상태는 REVIEWED_MANUAL입니다. 원문 검증·좌표 매핑·핀 적용·XP 지급 플래그는 여전히 false입니다. 저장과 결정 시 파일 크기·해시·원문 연결·버전을 다시 확인하고 감사 기록을 같은 트랜잭션에 남깁니다. 좌표 적용은 별도의 사람 매핑 자료, 독립 검증과 승인을 거쳐야 합니다.

위성지도 화면이 보인다는 사실도 이 문턱을 없애지 못했습니다. 지도 장애 시험의 첫 실패는 loading 상태를 읽는 경쟁이었고, Aside는 QA 대기를 수정한 뒤 당시 15건을 재시험해 통과했습니다. 최신 지도 근거 시험은 25건이지만 PDF 정확 위치 검증은 0건입니다. 78쪽 자료의 참고 확인을 전체 지리참조 검증으로 확대하지 않았습니다. 화면 장애를 고친 결과와 원문 위치를 검증한 결과는 따로 읽었습니다.

3. 참고 GIS는 원형과 전달 상태를 함께 봉인했습니다

지도에 올릴 별도 자료는 2022년 공개 마을어업 참고 경계 3,703개였습니다. Aside는 schema version 2 인덱스의 seal과 전체 feature seal을 검증했습니다. 저는 RESULT.json과 PUBLIC_SEAL_VERIFIED.json을 대조해 실제 feature 바이트 195,796,617, 정점 4,917,683의 집계를 확인했습니다. 원래 형상은 단순화하거나 변경하지 않았습니다. 몇 개가 보이는 화면 대신 인덱스와 각 도형의 해시·바이트·정점을 전수 무결성의 근거로 삼았습니다.

봉인된 파일도 화면에 도착하는 동안 실패할 수 있습니다. Aside는 응답 스트림 크기를 제한하고 요청 제한시간을 15초로 두었습니다. 늦게 도착한 응답의 본문을 정리하고, 오래된 출처의 재시도 결과가 새 상태를 덮지 못하게 하는 보호도 기록했습니다. 관련 전송 시험은 13건입니다. 파일의 동일성을 확인하는 봉인과 비동기 로딩의 상태 보호가 이어져야 자료가 바뀌지 않은 채 표시 단계까지 갈 수 있었습니다.

초기 SVG 재시도 실패는 자료 로딩과 오버레이 표시를 나누는 계기가 됐습니다. 이미 자료를 받았다면 전체 실패로 되돌리지 않고 오버레이만 다시 시도했습니다. 같은 도형을 재사용하고 사용자의 초기 숨김 선호도 유지했습니다. 재시도 성공을 이유로 사용자가 숨긴 레이어를 임의로 켜지 않도록 한 것입니다.

합성 지도 미리보기에는 공개 참고 경계 10개를 표시했습니다. 배경과 포인트는 합성이므로 실제 현장 위치의 증거는 아닙니다. 보이는 영역의 근거는 네이티브 HTML 목록으로도 제공했습니다. 다만 DOM 키 이벤트나 단위시험을 물리 키보드 검증으로 쓰지 않았고, 전체 합성 브라우저 기록의 프로그램 키 관련 3건은 불확정으로 남겼습니다.

4. 마지막 게이트는 정확도와 권리였습니다

저는 이 흐름의 완료를 로컬 추출 계약, 수동 검토 상태, 참고 GIS 무결성, 로딩·재시도 경계로 한정했습니다. 봉인 검증은 받은 자료가 원래 자료와 같은지를 보여줄 뿐, 2022년 참고 경계를 현재 면허·소유·동의나 법적 출입금지 경계로 바꾸지 않습니다. 검증된 실제 법적 통제 폴리곤은 0개입니다. 이 자료로 채집 허가나 안전 인증을 주장하지 않았습니다.

간조 시점 수심 120cm 이상을 회피할 경계도 생성하지 못했습니다. 상세 수심, 동일 기준면, 대상 시각, 불확실성과 재사용 권리가 없었기 때문입니다. 수심 판단은 UNKNOWN이며, 조위 70/100cm의 노출 선호와 수심 120cm를 같은 기준으로 취급하지 않았습니다. 모르는 값을 지도 모양으로 채우지 않는 것이 마지막 제한이었습니다.

원본 PDF의 파서·OCR 처리, 정확한 지도표식 대조, 원본 앱 반영과 서비스 재시작은 하지 않았습니다. 저는 Aside의 코드·시험·기록을 단계별 증거로 읽고, 사람의 대조와 현재 권리 확인을 남겼습니다. 이번에 배운 것은 자료에서 지도까지 연결하는 하네스가 자동 승인 장치가 아니라는 점입니다. 연결이 길어질수록 앞 단계의 성공이 다음 단계의 권한까지 대신하지 않게 해야 했습니다.

근거 문서: PDF_EXTRACTION_LOCAL.md, PDF_REVIEW.md, LATEST_FINAL_HANDOVER.md, RESULT.json, PUBLIC_SEAL_VERIFIED.json, BROWSER.json, LOCAL_COMPLETION.md.

2

함께 이야기해요 2

로그인하고 댓글을 남겨 주세요

Giacomo 프로필 이미지
Giacomo2026.10.16

OCR 추출 뒤 사람이 원문과 전사를 대조해 승인 요청을 하더라도, 좌표와 지도 핀 적용은 별도 승인으로 남기도록 정하셨네요. 문장을 읽을 수 있게 된 것과 그 문장이 가리키는 장소를 찾은 것은 다른 확인이라는 점이 여기서 분명해져요. 앞선 물때 글에서 숫자의 의미를 확인하셨다면, 이번에는 문서에서 지도까지 넘어가는 각 단계가 무엇을 증명하는지 따로 붙잡으셨습니다.

입력도 합성 PDF로 한정하고 파일 내용과 버전이 맞아야 받도록 하셨어요. 손상되거나 암호화된 문서, 시간초과, 바뀐 내용까지 시험에 넣은 기록은 추출 도구가 설치됐다는 설명보다 실습 범위를 이해하는 데 도움이 됩니다. 실제 원본 PDF와 한글 자료의 인식 정확도는 아직 확인하지 않았다고 적으셔서, 로컬 추출의 성공을 실제 자료의 정확성으로 확대하지 않게 되고요.

지도에 쓸 2022년 공개 마을어업 참고 경계 3,703개는 일부가 화면에 보이는지와 전체 원형이 유지됐는지를 나눠 확인하셨네요. 그 뒤 전송 중 늦은 응답과 오래된 출처의 재시도까지 다루셨다는 점도 눈에 띕니다. 파일이 원래 자료와 같아도 화면에 도착하는 과정은 별도로 실패할 수 있다는 사실이, 자료 확인과 표시 처리를 함께 읽게 해줘요.

SVG 재시도에서 자료 로딩과 오버레이 표시를 나눈 수정도 실용적이에요. 이미 받은 도형을 다시 쓰되 사용자가 숨긴 레이어는 켜지 않도록 하셨잖아요. 재시도 성공과 사용자의 표시 선택을 별개로 유지한 것이죠. 동시에 참고 경계의 무결성은 현재 면허나 출입·채취 권리를 뜻하지 않고, 수심 자료가 없으면 120cm 회피 경계를 만들 수 없다는 한계도 남아 있습니다. 보기 좋은 지도에 확인하지 않은 판단을 채워 넣지 않으셨어요.

추출, 수동 대조, 자료 전달, 화면 표시를 연결하면서도 각 단계의 성공이 다음 단계의 승인을 대신하지 못하게 정리하신 점이 단단합니다. 지도에 무언가 표시됐을 때 ‘무엇이 확인된 표시인가’를 따져볼 수 있게 해주신 기록이라, 문서와 공간 정보를 연결하는 다른 작업에도 참고가 됩니다.

뽀짝이 프로필 이미지
뽀짝이2026.10.12

강진태님, 안녕하세요. 뽀짝이예요.

"PDF에서 읽은 문장이 지도에 표시되면 어디까지 검증됐다고 말할 수 있을까"라는 질문으로 시작해서, 추출·표시·승인을 끝까지 나눠 둔 점이 인상 깊었어요. 사람이 대조해 승인 요청을 해도 상태는 REVIEWED_MANUAL이고 원문 검증·좌표 매핑·핀 적용 플래그는 여전히 false라는 설계가 특히 단단해 보여요.

봉인 검증은 자료가 원래와 같다는 것만 보여 줄 뿐 현재 면허나 출입 권리까지 증명하지 않는다고 선을 그은 대목, 그리고 수심 120cm 회피 경계를 근거가 없어서 만들지 않고 UNKNOWN으로 둔 결정이 좋았어요. 모르는 값을 지도 모양으로 채우지 않는다는 원칙은 AI 결과물을 다루는 분들께 큰 참고가 될 거예요.

고롱고롱… 꼼꼼한 기록 잘 읽었어요 ✨

필요한 AI 정보만
메일함에 쏙쏙 넣어드려요.

지금 핫한 AI 소식부터 직접 해 본 사례까지, 월요일마다 무료로 받아보세요