jsshin2022 · Oct 15, 2026 · Oct 12, 2026 · Oct 12, 2026
@@ -8,10 +8,16 @@
 |---|---|
 | 처치 | 동대문구, 분석상 시작 분기 2024Q2 |
 | 비교 | 서울 내 20개 자치구 후보 — 정책 이력 추가 확인 필요 |
-| 기간 | 2021Q1~2024Q4, 2023Q4·2024Q1 제외 |
+| 기간 | 2021Q1~2024Q4, 2024Q1만 추정에서 제외 (원자료·전체 분기 집계에는 보관) |
 | 지표 | 골목상권 육류·수산물·청과·반찬 판매 추정매출 합계의 자연로그 |
 | 방법 | 이벤트스터디, 가짜 시행일 검정 |
 
+공개 자료로 정책 근거·집계·검사·추정 과정을 재현할 수 있는 사례를 만드는 데 초점을 둔다. 효과의 유의성보다 근거와 해석 범위를 분명히 남기는 것을 완료 기준으로 삼는다.
+
 분석 범위와 일정은 [plan.md](plan.md), 실행 설정은 [plan.yaml](plan.yaml)에서 볼 수 있다. 자치구별로 찾아본 근거와 더 확인할 내용은 [정책 확인표](policy-verification.md)에 모았다.
 
-현재는 계획을 작성한 상태로, 매출 원자료는 아직 수집하거나 분석하지 않았다. 계획을 커밋하고 PR을 올린 뒤 수집 코드(`fetch.py`)와 이 사례에 필요한 검사를 작성할 예정이다. 비교 지역의 휴업일 변경 이력과 연도별 상권 자료를 같은 기준으로 비교할 수 있는지 확인하기 전에는 정책 효과를 판단하지 않는다.
+서울 25개 구의 [공통 조사표](comparison-survey.md)와 [자료원·지표 정의](data-notes.md)를 마련했다. 특성 값과 최종 비교군은 아직 확정하지 않았다. [구별 확인 공백과 자료 요청 초안](verification-gaps.md)에 다음에 확보할 문서를 특정했다.
+
+선행연구의 질문·방법·한계와 사례에 적용할 내용은 [연구 노트](research-notes.md)에 정리했다.
+
+초기 계획은 [PR #9](https://github.com/CausalInferenceLab/policy-effect-analytics-agent/pull/9)로 main에 병합됐고, 선행연구·분기 처리 보완 [PR #10](https://github.com/CausalInferenceLab/policy-effect-analytics-agent/pull/10)은 2026-10-12 확인 시 열려 있다. 매출 원자료는 아직 수집하거나 분석하지 않았다. 비교군 정책 이력, 동시기 지원사업, 자료 기준을 확인하고 필요한 계획 보완을 커밋·PR에 반영한 뒤 수집 코드(`fetch.py`)와 이 사례에 필요한 검사를 작성할 예정이다. 비교 지역의 휴업일 변경 이력과 연도별 상권 자료를 같은 기준으로 비교할 수 있는지 확인하기 전에는 정책 효과를 판단하지 않는다.
@@ -0,0 +1,65 @@
+# 비교군 특성 자료의 출처와 확인 범위
+
+확인일: 2026-10-12. [선정 기준](plan.md#비교군-선정-기준--전수-조사-전에-정할-사항)에 따라 서울 25개 구를 같은 정의로 조사하기 위한 자료원 점검이다. 제공 설명·API 명세·통계표의 연도 선택 항목을 확인했으며, 아래 특성 파일을 내려받거나 지역별 값을 산출하지 않았다. 매출 원자료도 열지 않았다.
+
+## 공식 자료원 점검
+
+| 항목 | 공식 출처 | 확인한 내용 | 2022년 사용 전 남은 확인 |
+|---|---|---|---|
+| 주민등록인구·65세 이상 인구 | [행정안전부 연령별 인구현황](https://jumin.mois.go.kr/ageStatMonth.do) | 월말 기준, 2008년부터 공표한다는 안내. 서울 선택 시 자치구 조회, CSV/XLSX 경로 확인. 등록구분 ‘전체’도 외국인은 제외 | 2022년 선택 항목 확인. 2022-12, 서울 25개 구, 남녀 합계의 실제 조회·다운로드와 65세 이상 구간 확인 |
+| 인구 대체 경로 | [KOSIS DT_1B040A3](https://kosis.kr/statHtml/statHtml.do?orgId=101&tblId=DT_1B040A3), [서울 등록인구 구 경로](https://data.seoul.go.kr/dataList/419/S/2/datasetView.do) | KOSIS는 이번 열람에서 로그인 연결 화면으로 이동. 서울 구 경로는 서비스 종료 표시 | 조회 성공으로 기록하지 않음. 외국인을 포함하는 등록인구와 주민등록인구를 혼용하지 않음 |
+| 1인 가구·일반가구 | [서울 가구원수별 가구](https://data.seoul.go.kr/dataList/DT201004B010004/S/2/datasetView.do), [연결 통계표](https://stat.eseoul.go.kr/statHtml/statHtml.do?orgId=201&tblId=DT_201004_B010004&conn_path=I2&mode=tab) | 2016년부터 연간, 서울·자치구, 일반가구 대상·매년 11월 1일 0시 기준. **연결 조회 화면에서 2022년 선택 항목 확인**. 서울 제공 페이지는 공공누리 1유형 표시 | 2022년 25개 구의 실제 응답·분모·다운로드 검증. KOSIS DT_1JC1505 직접 경로의 오류와 별개로 서울 제공 경로 확보 |
+| 행정구역 면적 | [서울 행정구역(구별)](https://data.seoul.go.kr/dataList/DT201004O010001/S/2/datasetView.do), [연결 통계표](https://stat.eseoul.go.kr/statHtml/statHtml.do?orgId=201&tblId=DT_201004_O010001&conn_path=I2&mode=tab) | 서울·자치구별 면적을 매년 제공. 공공누리 1유형. **연결 조회 화면에서 2022년 선택 항목 확인** | 2022년 값의 기준일·단위·25개 구 실제 응답 확인. 경계 도형의 출처·버전은 면적 통계와 별도 확보 필요 |
+| 업종별 점포 수 | [서울 점포-상권 OA-15577](https://data.seoul.go.kr/dataList/OA-15577/A/1/datasetView.do) | 2021~2025년 ZIP 목록과 **2022년 ZIP 항목** 확인. 일반·프랜차이즈 합계 정의, 공간 기준 변경 안내, 공공누리 1유형 확인 | 2022Q4 실제 포함 여부, 컬럼·업종 코드, 골목상권 구분, 자치구 연결, 영역 자료와의 버전 호환성 |
+| 골목상권 수·구 연결 | [서울 영역-상권 OA-15560](https://data.seoul.go.kr/dataList/OA-15560/S/1/datasetView.do) | 이전 작업에서 2023년 작성 공간 ZIP과 코드 연결 구조 확인 | 2022년 점포 자료 및 향후 매출의 공간 기준과 동일한지 검증. 예전 다운로드만으로 호환성을 확정하지 않음 |
+| 대형마트·SSM·규제 제외 점포 | [행안부 대규모점포 API 후보](https://www.data.go.kr/data/15154948/openapi.do), [구별 정책 근거](policy-verification.md) | 제공 페이지 재조회 성공. 개발·운영 자동승인, 개발계정 트래픽 10,000, 이용허락범위 제한 없음 표시. 구별 최신 목록·공식 예외 단서는 정책 확인표에 기록 | 2022년 말 영업 목록과 2021~2024 개폐점·규제 이력 복원 가능 여부. 대규모점포 전체를 대형마트나 SSM 수로 간주하지 않음 |
+| 전통시장 수·규모 | [서울 전통시장 OA-23058](https://data.seoul.go.kr/dataList/OA-23058/S/1/datasetView.do) | 메타데이터 시간범위는 2022~2025년이나 **API 요청·출력 명세에 연도·기준일 필드가 없음**. 시장명·자치구·주소·유형·점포수 등 명세 확인, 공공누리 1유형 | 현 API만으로 2022년 단면 선택 가능하다고 볼 수 없음. 2022년 기준 원목록을 별도 확보. 연결된 [원본 페이지](https://news.seoul.go.kr/economy/archives/574563?listPage=1)는 2026-08-28 기준 |
+| 전통시장 과거 파일 | [서울 전통시장 OA-1176](https://data.seoul.go.kr/dataList/OA-1176/F/1/datasetView.do) | **전통시장 현황(2022.상반기 기준).xlsx** 항목 확인, 목록 수정일 2022-03-17, 공공누리 1유형 | 실제 다운로드·정확한 기준일·시장 유형·중복·25개 구 범위 확인. 수정일을 기준일로 간주하지 않음 |
+
+점포 자료의 2022년 ZIP 목록은 실제 다운로드 성공을 뜻하지 않는다. 페이지에는 갱신주기가 ‘년간’으로 표시되지만 API에는 연도·분기 요청 형식이 있어 실제 파일의 분기 구성을 확인해야 한다. 또한 2026-07-03 제공 기준 변경 공지가 있으며, 과거 ZIP의 수정일만으로 공간 기준이 소급 통일됐다고 판단하지 않는다.
+
+## 추가 확인 — 2026-10-12
+
+- **가구·면적:** 열린데이터광장의 Sheet가 연결하는 서울 통계 조회 화면을 직접 열어 두 표 모두 `2022` 연도 선택 항목을 확인했다. 가구 표의 수록기간 표시는 2000~2025년, 면적 표는 1960~2025년이다. 이는 조회 선택지 확인이며, 25개 구의 값이나 파일 수집 완료가 아니다. 가구 제공 페이지의 요약 갱신주기는 여전히 ‘5년’이나 상세 설명은 2016년 이후 연간으로 명시하므로 상세 설명과 실제 연도 선택 항목을 함께 기록한다.
+- **전통시장:** [API 명세](https://data.seoul.go.kr/dataList/openApiView.do?infId=OA-23058&srvType=A&serviceKind=1)의 서비스는 `aiListTraditionalMarket`이고 선택 조건은 자치구 `CGG`다. 출력 12개 항목에도 연도·기준일이 없다. 제공 페이지의 시간범위만으로 연도별 패널로 해석하지 않는다. 현 API의 시장 수를 2022년 값으로 쓰는 경로는 보류한다. 대체 경로 OA-1176에서 **2022년 상반기 기준 XLSX** 목록을 찾았다. 파일 내부의 정확한 기준일을 확인한 뒤 모든 구에 동일하게 적용하고, 연말 인구·4분기 점포 수와 시점 차이를 표시한다.
+- **점포:** [API 명세](https://data.seoul.go.kr/dataList/openApiView.do?infId=OA-15577&srvType=A&serviceKind=1)에서 `STDR_YYQU_CD`, `TRDAR_CD`, `TRDAR_SE_CD`, `SVC_INDUTY_CD`와 점포 수 필드를 확인했다. 전체 점포 수는 **`SIMILR_INDUTY_STOR_CO`**, 일반 점포 수는 `STOR_CO`, 프랜차이즈는 `FRC_STOR_CO`다. `STOR_CO`만 집계하면 계획의 전체 점포 수와 달라진다. 명세에는 자치구 코드 출력이 없어 영역 자료와 연결해야 한다.
+- **공간 기준:** [서비스 소개](https://golmok.seoul.go.kr/introduce.do)는 발달상권·전통시장 영역 구축에 2022년 표준단위구역을 사용한다고 설명한다. 반면 OA-15560에서 확인되는 ZIP 수정일은 2023-10-23이다. 이 두 사실만으로 골목상권 경계나 과거 점포·매출의 공간 기준이 같다고 입증되지 않는다. 현재 제공하는 영역과 ZIP의 버전 대조가 남는다.
+
+## 공통 정의와 기준 시점
+
+아래는 수집 시 적용할 작업 정의다. 제공 자료와 대조해 확정하며, 변경이 필요하면 모든 구에 같은 규칙을 적용하고 매출 열람 전에 사유를 기록한다.
+
+| 항목 | 목표 시점·계산 규칙 |
+|---|---|
+| 인구 | 2022년 12월 말 주민등록인구, 등록구분 전체·남녀 합계, 명 |
+| 고령인구 비율 | 같은 자료·같은 기준일의 65세 이상 인구 / 전체 주민등록인구 × 100. 60~69세 구간을 통째로 쓰지 않음 |
+| 인구밀도 | 위 인구 / 2022년 해당 구 전체 행정면적(km²). 인구총조사 기반 밀도와 혼합하지 않음 |
+| 1인 가구 비율 | 2022년 11월 1일 0시 기준 인구총조사 1인 일반가구 / 전체 일반가구 × 100. 주민등록 1인 세대와 구분. 조사 기준일을 별도 기재 |
+| 골목상권 수 | 점포 자료와 호환되는 영역 자료의 골목상권 고유 코드 수. 점포 행 수를 상권 수로 세지 않음 |
+| 식품판매 점포 수 | 2022Q4 골목상권의 CS300007·008·009·010별 전체 점포 수. 분기별 재고인 점포 수를 연간 합산하지 않음. 일반+프랜차이즈와 전체를 중복 합산하지 않음 |
+| 업종 구성비 | 각 업종 점포 수 / 위 4개 업종 점포 수 합계 × 100. 분모가 0이면 정의 불가로 기록. 서울 전체 업종 대비 비중과 구분 |
+| 대형마트·SSM | 2022년 말 영업 점포를 구분 집계하고 점포별 규제 대상·제외·미확인을 별도 표시. 현재 영업 상태만으로 과거 점포 수를 복원하지 않음 |
+| 전통시장 | OA-1176의 2022년 상반기 기준 파일을 우선 검토하여 고유 시장 수와 존재 여부 산출. 정확한 기준일은 내부 설명 확인 후 확정. 상권분석서비스의 전통시장 공간 코드 수와 별개로 기록 |
+| 인접·파급 | 같은 버전의 공식 구 경계로 동대문과 인접 여부 확인. 점포 위치·교통·생활권 근거는 별도 기록하며 인접만으로 소비 이동을 확정하지 않음 |
+| 동시 변화 | 2021~2024 주요 점포 개폐점·지원사업을 사건별로 기록. 발표·예산 교부·실제 시작일을 구분 |
+
+2022년은 우선 검토 연도다. 인구의 연말, 가구의 조사 기준일, 점포의 4분기는 같은 날짜가 아니므로 각 기준일을 보존한다. 특정 항목의 과거 자료를 못 찾으면 최신값으로 메우거나 그 구를 자동 탈락시키지 않는다. 공통 대체 시점·항목 제외 여부를 계획에 기록한 뒤 진행한다.
+
+## 값과 근거의 보관 규칙
+
+각 값은 `자치구명 / 지표 / 값 / 단위 / 기준시점 / 분자·분모 / 출처 URL / 원파일명·해시 / 조회 조건 / 공간·업종 버전 / 확인일 / 상태 / 미확인 사유`와 함께 기록한다. 구 코드는 출처별 코드 체계를 확인한 후 연결하며 이름만 보고 임의 코드를 입력하지 않는다.
+
+상태는 ‘자료원 후보 → 제공 설명 확인 → 해당 연도 목록 확인 → 다운로드 확인 → 정의·품질 확인’으로 구분한다. 미수집·미확인·정의 불가를 숫자 0으로 저장하지 않는다. 0은 해당 시점에 없음을 공식 자료로 확인했을 때만 사용한다. 원자료 저장 위치와 접근 조건은 실제 수집 단계에 확정한다.
+
+지역별 진행 상황은 [공통 조사표](comparison-survey.md)에 기록한다. 이 특성들은 선정 근거를 설명하기 위한 것이며, 자동으로 회귀 공변량·매칭 점수에 추가하지 않는다.
+
+
+## API 키 필요 여부
+
+현재 정책 고시·공개 통계 화면·파일 목록 확인에는 키를 사용하지 않았다. 공개 파일로 같은 기준의 자료를 확보할 수 있는지 먼저 확인하며, API 호출이 필요한 경우에만 설정을 요청한다. 아직 인증된 API 호출 성공이나 과거 자료 복원을 확인한 것은 아니다.
+
+- **서울 열린데이터광장:** [공식 이용안내](https://data.seoul.go.kr/together/guide/useGuide.do)의 일반 인증키를 발급받는 방식이다. 공공데이터포털 키와 별개다. 점포 ZIP 등 공개 파일 경로도 확인돼 현재 발급을 필수로 요청하지 않는다. 사례 수집 코드에서 사용할 환경변수명과 호출 경로는 구현 시 확정한다.
+- **공공데이터포털:** [대규모점포 API](https://www.data.go.kr/data/15154948/openapi.do)를 사용할 때는 해당 서비스 활용신청·승인과 인증키가 필요하다. 저장소의 기존 설정명은 `DATA_GO_KR_API_KEY`다. 키가 있어도 2022년 영업·규제 이력을 복원할 수 있는지는 별도 검증한다.
+- **KOSIS:** 저장소의 기존 설정명은 `KOSIS_API_KEY`다. 현재 서울 통계표·공개 파일 대체 경로를 조사하고 있어 발급 필요 여부는 미정이다.
+
+설정이 필요해지면 사용할 서비스와 로컬 설정 위치를 안내한다. 키는 채팅·문서·커밋에 넣지 않고 로컬 환경변수 또는 Git 제외된 `.env`에 보관한다.