plan(YoungjaeKang-retail-hours): 특성자료 수집 기준·정책 근거 보강

[YoungjaeKang]

무엇을 했나요?

정책 전 특성자료의 출처만 정리돼 있던 상태에서, 서울 25개 구에 적용할 수집 시점·조회 범위·누락 처리·검사 기준을 구체화했습니다. collection-plan.md를 추가하고 인구·가구·면적·점포·시장 자료원을 plan.yaml에 반영했습니다.

• 2022년을 목표 연도로 삼되 인구의 12월 말, 가구의 11월 1일, 점포의 4분기, 시장의 상반기 등 실제 기준시점을 보존합니다.
• 모든 구를 출력에 유지하고, 비공개·미수집·정의 불가·연결 오류는 값과 구분해 기록합니다. 누락을 0으로 채우거나 특성값 때문에 구를 자동 탈락시키지 않습니다.
• 특성자료의 별도 로컬 산출물과 출처·해시·품질 기록을 정했습니다. 공통 make flow가 수행하는 검사와 후속 사례 코드에서 구현할 검사를 구분했습니다.
• 동대문구 2024-121호 첨부 고시를 확인했습니다. 경동시장점을 포함한 대형마트 2곳·SSM 10곳의 대상 목록, 고시 시행일 2024-08-21, 실제 휴업일 9/11→9/17과 9/25 유지 내용을 기록했습니다.

케이스

cases/YoungjaeKang-retail-hours

이번 후속 변경: collection-plan.md, plan.md, plan.yaml, data-notes.md, policy-verification.md, verification-gaps.md, comparison-survey.md, README.md.

현재 확인 범위

특성 수치·매출 원자료 수집과 효과 추정은 하지 않았습니다. 실제 다운로드한 것은 정책 고시 첨부이며, 특성자료는 제공 설명·명세·파일 목록 확인 단계입니다.

가구·면적·점포·시장 자료의 공공누리 1유형을 확인했습니다. 행안부 인구 다운로드에 적용되는 이용 조건은 미확인이므로 license: other와 notes에 상태를 명시하고 해당 자료 취득을 보류합니다. 공간 버전·면적 기준일·시장 유형 등은 취득 후 검증 조건으로 남겼습니다.

경동시장점의 2023년 적용 제외 사유, 성동·용산·강북의 점포별 처분과 연속 이력은 미확인입니다. 20개 비교 후보 중 전체 분석 기간의 이력 확인을 마친 구는 여전히 0개이며 최종 비교군은 후속 PR에서 정합니다. 기관 직접 문의·정보공개청구·회신 대기는 작업 범위에서 제외합니다. 공개 자료로 확인되지 않는 항목은 미확인으로 남기며, 독립적인 수집·검사 구현은 진행합니다.

체크리스트

• plan.yaml을 특성값·매출 결과 열람 전에 작성하고 계획 변경 이유를 기록했습니다.
• 모든 자료의 이용 조건 확인이 끝났습니다. 인구 자료의 이용 조건 확인이 남아 있으며 해당 취득은 보류합니다. 확인된 출처와 조건은 data_sources에 명시했습니다.
• API 키·.env·개인정보·원자료·가공 데이터를 포함하지 않았습니다.
• 그림·수치가 fetch.py → make flow로 재현됩니다. 이번 PR은 수집 전 계획이며 실행 코드는 후속 PR입니다.
• make check PY=.venv/bin/python 통과: ruff·pytest, 테스트 2건 skip.
• 개인 사례 폴더만 변경했습니다.
• YAML 스키마, 기존 추정 설정 유지, 문서 링크·앵커, 조사표 25개 구 중복·누락·일치, git diff --check 검증을 통과했습니다.

리뷰어에게

수집 기준과 보류 조건, 점포 예외의 확인 범위를 검토 부탁드립니다. 이번 PR은 정책·수집 계획 단계이며 특성자료 수집 코드와 최종 비교군 확정은 각각 후속 PR로 나눕니다.

PR #11의 후속입니다. 아직 미병합인 #10·#11의 변경을 포함하므로 현재 main 기준 차이에는 선행 변경도 보입니다. #10→#11 병합 후 이번 변경의 차이·충돌·CI를 확인하고 필요하면 브랜치를 정리합니다. 원본 main 대상의 Draft PR로 제출합니다.