# 상재님, 여기부터 봐주세요

데이터 점검 자료와 검증 설계, 입력 정책을 한곳에 모았습니다.
정제된 학습 데이터·예측 결과는 아직 없고, 이 자료를 보고 같이 기준을 정하는 단계예요.

## 1. 먼저 읽을 것

FORECAST_HANDOFF.md의 '같이 정할 것'을 먼저 봐주세요.
결측 예보 처리, 학습/시험 기간, 입력 목록을 먼저 확인하면 됩니다.
자세한 자료는 outputs 폴더에 있고 원본 데이터는 포함하지 않았습니다.

## 2. 파일이 빠지거나 바뀌지 않았는지 확인

이 ZIP을 빈 폴더에 풀고, 그 폴더에서 아래 명령을 실행해주세요.
Python 3.12로 확인했습니다. 이 단계는 추가 라이브러리가 필요 없습니다.

python verify_handoff.py

예상 결과: failed=0. passed는 파일 수와 검증 항목 수에 따라 표시됩니다.
이것은 패키지/계약의 일치 확인이며 모델 성능 평가가 아닙니다.

동일한 공식 데이터 ZIP이 있으면 실제 파일 경로를 넣어 버전도 확인할 수 있습니다.
공식 사이트에서 다시 다운로드할 필요는 없습니다. 접근 가능한 기존 원본을 사용하세요.

python verify_handoff.py --source "원본 ZIP의 절대경로"

예상 결과: source_zip_checked=true, failed=0.
파일을 못 찾으면 경로, 불일치면 공식 배포 버전을 확인해주세요.

## 3. 기존 검증을 다시 실행하려면

tested Python: 3.12.14. 패키지 폴더에 requirements-audit.txt가 있습니다.
라이브러리가 없다면 같은 Python 환경에 설치하세요.

python -m pip install -r requirements-audit.txt

아래의 "원본 ZIP의 절대경로"는 본인 환경으로 바꿔주세요.
tools는 읽기 전용 분석 도구이며 원본을 정제하거나 모델을 학습하지 않습니다.
전체 품질 검사는 데이터 전체를 읽으므로 실행 환경에 따라 시간이 걸릴 수 있습니다.

python tools/audit_oibc_1120.py --zip "원본 ZIP의 절대경로" --out outputs/reproduced_1120
python tools/verify_oibc_1120_outputs.py outputs/reproduced_1120
python tools/design_oibc_1121_split.py --zip "원본 ZIP의 절대경로" --audit outputs/reproduced_1120/audit_results.json --out outputs/reproduced_1121
python tools/audit_oibc_1122_availability.py --zip "원본 ZIP의 절대경로" --audit outputs/reproduced_1120/audit_results.json --split outputs/reproduced_1121/split_config.json --out outputs/reproduced_1122

예상 결과: reproduced_* 폴더에 JSON/CSV/보고서 생성, 각 검증 failed=0.
누락/이상값은 원본에 실제로 있는 점검 결과이므로 숫자가 0이 되어야 한다는 뜻은 아닙니다.
검증된 기존 자료를 덮어쓰지 않도록 재실행 출력 경로는 별도로 두었습니다.
새 환경에서 라이브러리 설치부터 전체 재실행까지 성공했는지는 아직 수신자 확인 전입니다.

## 4. 확인 후

decisions.csv는 모두 검토 대기입니다. 합의한 내용은 #1123에 남기면 됩니다.
https://sulfite-footbath-next.ngrok-free.dev/issues/1123
