---
title: 아파트 평면도 수집기 V3.3 — 주변 6개 단지 검증과 핵심 정리
date: 2026-09-11
tags: [다가온, 평면도수집기, 검증, 작업인계]
status: 주변 표본 수집 검증 완료 · 배포 상태는 별도 기록
---

# 아파트 평면도 수집기 V3.3

## 핵심만 정리

- 목적: AI에게 매번 요청하지 않아도 Windows에서 단지를 검색해 제공되는 면적·타입의 도면을 수집한다.
- 이번 결과: 강선5단지건영,동부 주변 **6개 단지, 19개 면적 항목** 수집 성공. 최종 저장 그림 19개 모두 치수 기입을 육안 확인했다.
- 실행: `START_DAGAON.cmd` 하나. Windows·Edge·Node.js 22 이상 필요. 실제 DB는 PC에 있고 GitHub·배포 사이트에 포함하지 않는다.
- 직접 입력한 순서 목록은 한 번만 처리. 반복은 근방 찾기로 추가한 단지에만 적용한다. 10·20개 입력 UI와 순서 보존 검증은 유지했다.
- 세 번째 이미지 고정 방식은 폐기했다. 치수 도면이 1·3·4번째에 각각 존재했다.
- 동·호수 타입 자동 조회, 실측 수준의 도면 판독, Blender·ERP·렌더링 연결은 아직 구현 완료된 기능이 아니다.

## 시험 범위와 결과

2026-09-11 한국 시간 기준. 네이버 검색에서 강선5단지건영,동부를 기준으로 같은 법정동(주엽동)의 좌표상 가까운 아파트 6곳을 선택했다. 거리는 단지 좌표 간 직선거리이며 도보 거리가 아니다. 근방 검색은 인접 법정동을 포함하지 않고 최대 100개 후보를 비교하는 현재 제한이 있다.

| 단지 | 기준 단지와 거리 | 네이버 표시 면적(㎡) | 선택 이미지 번호 | 결과 |
| --- | ---: | --- | --- | --- |
| 강선4단지동신 | 약 216m | 78.44 / 93.34 / 103.69 | 3 / 3 / 3 | 3건 |
| 강선8단지럭키,롯데 | 약 225m | 77.98 / 89.97 / 104.75 | 3 / 3 / 3 | 3건 |
| 강선2단지경남 | 약 240m | 123.19 / 151.87 / 190.05 | 4 / 4 / 3 | 3건 |
| 강선6단지금호,한양 | 약 262m | 120.83 / 161.49 / 191.20 / 219.56 | 1 / 3 / 1 / 1 | 4건 |
| 강선3단지한신 | 약 281m | 71.40 / 86.29 / 104.09 | 4 / 3 / 3 | 3건 |
| 강선7단지삼환,유원 | 약 359m | 74.43 / 87.78 / 104.69 | 3 / 3 / 3 | 3건 |
| 합계 | | 19개 항목 | | 19건 |

위 6개 단지는 화면에 타입 문자가 따로 표시되지 않았다. '타입 표기 없음'으로 보관하며 '모든 세대가 기본형'이라는 의미로 바꾸지 않는다. 화면에 제공되지 않은 숨은 변형까지 수집했다고 주장하지 않는다.

회귀 대조군은 강선5단지건영,동부의 124.31A / 125.85B / 159.66A / 160.26B / 177.44A / 177.83B㎡ 6개 항목이다. 이미 저장된 기록과 비교하며 추가 중복 저장을 방지한다.

## 동부만 되던 이유와 수정

1. **VR 표시 오인식:** 다른 단지의 면적 버튼에 붙은 VR 배지가 `VR형`처럼 합쳐졌다. 실제 VR 배지 요소만 제외하고 면적·실제 타입 문자는 보존한다.
2. **타입 문자 미표기:** A/B가 없는 면적을 전부 미확정으로 거절했다. 선택 버튼·뷰어 면적·단지 ID가 일치하는 근거를 함께 저장하는 '타입 표기 없음'을 추가했다. 근거가 없으면 여전히 저장하지 않는다.
3. **화면 초기화 지연:** 경남·한신 등에서 첫 클릭 후 단지정보가 시세 탭으로 되돌아갔다. 정확한 단지정보 탭을 한 번 다시 찾아 브라우저 입력으로 선택한다.
4. **이미지 순서 차이:** 경남 2개와 한신 1개는 세 번째가 입체, 네 번째가 치수 도면이었다. 금호·한양 3개는 이미지가 한 장뿐이며 그 한 장에 치수가 있었다. 이미지 출처의 원본 후보를 선택하고 현재 순번을 다시 확인한다.
5. **동부의 개별 출처 예외:** 동부 124.31A㎡ 도면은 일반 후보 규칙과 다른 주소였다. 육안 확인한 정확한 이미지 URL과 단지·면적 조합을 예외 목록에 등록했다. 모든 `land_naver` 이미지를 도면으로 허용하지 않는다. 출처가 바뀌면 재검토한다.
6. **검사 대상 혼동:** 기존 `verify:data`는 현재 DB가 아닌 과거 V2 이관 백업을 요구했다. 과거 검사는 `verify:migration`, 현재 DB 검사는 `verify:data`로 구분했다. 과거 백업 부재를 성공으로 바꾸거나 기준선 파일을 조작하지 않았다.

출처 규칙은 `land_system`, `hscp_img` 계열 및 검증된 개별 예외를 사용한다. 이는 후보 선정 규칙이지 범용 치수 인식 모델이 아니다. 후보 없음·후보 중복은 확인 필요로 남기고 입체 그림으로 대체하지 않는다.

## 검증 기준

- 정적 문법 검사 통과.
- 자동 테스트 139개, 실행 안전 점검 40개 통과. 순서·반복 구분, 단지 주소 판별, 타입 근거, 이미지 번호, 저장 검증·중복·복구를 포함한다.
- 실제 Windows 시작 파일로 서버 V3.3, 전용 Edge, 관리 화면·네이버 시작 페이지, 확장 V3.3 및 코드 해시, 서버 인증 연결을 확인한다.
- 이번 최종 6개 단지 수집 보고서: 총 19개, 실패·확인 필요·도면 없음 0개. 이미 저장된 항목은 재사용하며 중복 저장하지 않는다.
- 최종 저장 PNG 19개를 열어 치수선·숫자 기입을 확인했다. 전체 실내 치수의 정확성이나 실제 세대와의 일치까지 검증한 것은 아니다.
- 현재 데이터 감사: 활성 기록 31건, 보관 12건, 이미지 43개. 누락·해시 불일치·잘못된 PNG·메타데이터·중복 그룹·미참조 이미지 0개.
- 이번 시험 중 잘못 선택한 입체 이미지 3건은 보관 처리했다. 원본 파일 43개의 해시를 보관 전후 비교했고 모두 유지됐다. 기존 활성 기록 12건을 포함해 보관 대상 외 기록은 바꾸지 않았다.
- 성공 결과는 필요 없이 반복 검증하지 않았다. 실패 단계의 원인 수정 및 최종 검사 기록은 삭제하지 않는다.

## 원본 자료 자체의 주의점

네이버의 현재 표시 면적과 그림에 인쇄된 과거 면적 표기가 다른 사례가 있다. 예를 들어 한신 104.09㎡ 항목의 그림 하단에는 분양 108.79, 86.29㎡ 항목에는 분양 87.90이 적혀 있다. 다른 단지에도 차이가 있다. 발생 원인은 이번 조사에서 확정하지 않았다.

수집기는 해당 네이버 면적 항목에 연결된 그림을 저장한다. 숫자를 임의로 고치거나 면적 차이가 없다고 단정하지 않는다. 따라서 **수집 동작 시험 통과와 원본 도면 내용의 완전한 정확성은 별개**다. 설계·견적에 사용하기 전 공급/전용/분양 기준 및 현장 실측을 확인해야 한다.

저장 파일은 뷰어의 도면 영역을 캡처한 PNG다. 원격 이미지 원본과 동일한 해상도·바이트를 보증하는 다운로드 방식은 아니다. 워터마크를 지우거나 도면을 임의로 재구성하지 않는다. 자료의 이용·재배포 권한은 별도로 확인해야 한다.

## 저장·배포 원칙

- Obsidian: 이 문서는 현재 보관함 안의 프로젝트 `docs`에 저장한다.
- GitHub: 기존 비공개 저장소의 작업 브랜치와 V3.3 태그에 프로그램·요약 문서를 함께 기록한다. 인증 정보·실사용 DB·평면도 이미지는 제외한다.
- Cloudflare: 사용자 지정 표시 이름은 **아파트 평면도 수집기**. Windows 로컬 프로그램과 문서의 다운로드·안내 페이지로 구성하며, 클라우드에서 네이버 수집을 실행하는 서비스로 표현하지 않는다. 게시의 공개/접근 제한 설정은 사용자 선택에 따른다.
- 이 문서는 시험 결과이며 실제 업로드 완료 여부는 별도 배포 기록과 최종 안내로 구분한다.

## 다음 단계

1. 다른 지역·신축·타입 수가 많은 단지로 표본을 확대한다. 이번 6곳 결과만으로 전국 보장을 하지 않는다.
2. 사용자가 보여준 호별면적 화면을 근거로 동·호수 → 타입을 연결한다. 현재 미구현이며 임의 추정하지 않는다.
3. 치수 읽기·도면 축척·벽/창/문 인식 검증을 통과한 자료만 Blender로 전달한다.
4. ERP 자재는 실물 규격과 반복 패턴을 확보한 뒤 적용한다. 작은 색상 견본만으로 정확한 실물 비율을 확정하지 않는다.

이전 시점의 내용은 [V3.2 핵심 정리](PROJECT_CHECKPOINT_2026-09-11.md)에 보존한다.