# D01~D03 합의 반영 — 2026-10-27

## 결정 근거와 적용 범위

수아님이 이 대화에 전달한 이상재님의 답변을 근거로 수신자와의 데이터 기준 합의를 기록한다. 상재님은 PR #188과 D01~D03을 확인하고 원본을 재계산했으며, 7월 224개소/10월 252개소와 예보 누락 조합이 일치한다고 답했다. 독립 재계산은 수신자가 보고한 사실이며 수아 쪽 재검사와 구분한다. 이 답변은 튜터의 전체 규정 승인이나 v2 파이프라인 실행 완료를 뜻하지 않는다.

PR #188은 병합된 v1이다. 이번 자료는 후속 PR의 v2이며 기준과 재현 설정을 갱신했다. 원본 데이터·전처리 결과·모델을 변경/생성하지 않았다.

## D01 — 회차 대체

- 첫 모델은 17시 예보 우선. 없으면 **동일 제공사·관측소·대상 시각·변수**의 10시 예보로 대체한다.
- 원래 결측 여부와 대체 여부를 보존한다. 평가 행을 삭제하거나 제공사 사이의 변수를 무단 대체하지 않는다.
- 향후 10·17시 평균/각 회차 입력 실험에서는 반대 방향도 같은 규칙을 적용한다. 복사 대체된 두 값을 독립 예보 두 개처럼 해석하지 않는다.
- 두 회차 모두 없는 경우는 현재 점검 범위에서 0건이다. 새 경우가 생기면 오류/점검 표시로 드러내고 별도 정책을 정한다. 중앙값 등 구체 대체법은 이번에 합의하지 않았다.
- 명목 회차 허용과 실제 수신 지연 검증은 별개다. 수신 로그는 여전히 없다.
- 적용 계약: `forecast_round_policy.json`. 모델 입력 생성 구현과 실제 대체 결과 검사는 상재님의 모델 실험에서 별도 수행한다.

## D02 — 계절 검증

| 구간 | 대상일(KST) | 고정 발전소 | 검증 행 | 학습 정답 상한(KST) |
|---|---|---:|---:|---|
| DEV_JUL_2024 | 2024-07-01~07-31 | 224 | 166,656 | 2024-06-30 00시 |
| DEV_OCT_2024 | 2024-10-01~10-31 | 252 | 187,488 | 2024-09-30 00시 |

7월의 기록 존재 250개소 중 부분 기록 26개소는 고정 비교에서 제외하고 별도 진단한다. 정답을 0으로 채우지 않는다. 각 구간에서 모든 모델은 동일 발전소·시각을 사용한다. 서로 다른 발전소 구성인 월의 총오차를 직접 비교하지 않는다.

7월 고정 집합의 설비용량은 36,300.895kW로 2개 그룹 각각 20MW 조건을 충족할 수 없다. 합의대로 **발전소 단위 예측 지표만 비교**하고 정산 비교는 하지 않는다. 10월도 전체 253개소 정산과 동일하지 않아 이번 계절 비교의 공식 정산을 활성화하지 않았다.

기존 DEV_JAN/DEV_FEB와 2025년 3~5월 최종 HOLDOUT은 그대로 유지한다. HOLDOUT 정답으로 모델·입력·배정을 선택하지 않는다. 계절 검증 구간은 `split_config.json`의 `folds`에 실제 추가했고 발전소 ID를 명시했다. 학습에는 cutoff 이전의 다른 발전소를 포함한 pooled 모델을 사용할 수 있으나 평가 집합은 고정한다.

2023-06-01 학습 시작, 발행일 00시 상한, 720행 이력 진단은 기존 보수적 설계값을 유지했다. 실제 수신 지연과 짧은 이력 처리 세부법까지 이번 답변에서 새로 승인됐다고 기록하지 않는다.

## D03 — 입력 및 학습 통계

- 첫 모델: 제공 예보·설비 정보·달력. 공통 예보 후보 30개 중 `wa_temp_max/min`을 제외한 28개를 `baseline_forecast_feature_columns`로 명시했다. 기존 `forecast_value_columns`는 원본 스키마 목록이며 삭제하지 않는다. 상재님은 각 모델의 실제 사용 열/변환을 실험 기록에 남긴다.
- **발전량 lag 제외 확정.** 평가 기간 발전량이 없으므로 직전 실제 발전량·그 이동평균을 검증 중에 제공받는 방식은 사용하지 않는다. 과거 실측 날씨도 첫 모델의 허용 입력으로 추가하지 않는다.
- 발전소별 평균 설비이용률 등 **학습 구간에서만 만든 고정 통계는 허용**한다. 1시간 구간에서 `energy_kwh / capacity_kw`의 학습 평균을 예로 들 수 있다. 통계의 학습 종료는 각 fold cutoff이고 해당 fold 안에서 고정한다. 검증/평가 정답으로 업데이트하지 않는다. 학습 이력 없는 발전소는 학습 정보로만 만든 명시적 대체 경로를 둔다.
- SMP는 예측 입력 허용 여부 확인 전까지 기본 제외한다. 정산에서 사용하는 역할과 구분한다.
- `wa_temp_max/min`은 첫 모델 제외에 동의한다. 다만 **전체 원본에서 완전히 동일한 열은 아니다.** 직접 재계산 결과 A 학습 예보에서 244행, 2023-06-01 01시 이후 학습 범위에서 4행이 `wa_temp`와 하나 이상 달랐다. 평가 예보에서는 0행이었다. 따라서 제외 사유는 입력 선택이며 완전 동일 주장으로 쓰지 않는다. 원본 열을 삭제하지 않는다.

## 수행 결과와 다음 담당

- 수아: 설정·계약·결정표 갱신, 원본을 이용한 고정 집합·시간 경계·온도 열 재점검. `agreement_validation.json` 참조.
- 상재: 합의 설정을 입력 생성·Naive/ML baseline에 연결하고 첫 실행에서 입력 열·대체 표시·고정 평가 집합을 확인한다. #1125·#1126 실험을 이어갈 수 있는 기준이며, 아직 실행이 완료됐다는 뜻은 아니다.
- 수아: 첫 실험 결과의 누수·행/시각 정합성을 확인한다.
- D04 실제 수신 지연, D05 공식 정산/음수 정책, D06 v2 수신자 실행·출력 계약 확인은 미결로 유지한다. v2 실행 확인이 없으므로 #1123을 자동 종료하지 않는다.

## 재현 방법

Python과 `requirements-audit.txt`의 라이브러리가 있는 환경에서 이 문서가 있는 폴더를 작업 폴더로 사용한다.

```text
python tools/build_agreed_contracts.py --zip "원본 ZIP의 절대경로"
python verify_handoff.py --source "원본 ZIP의 절대경로"
```

첫 명령은 합의 계약과 계절 자료를 재생성한다. tracked 파일이 달라지면 manifest도 갱신해야 하므로 수신자는 먼저 두 번째 명령으로 배포본을 확인하고, 첫 명령의 재현은 별도 복사본에서 수행하는 것을 권장한다. 과거 v1 분석 스크립트는 v1 재현용이며 현재 v2 정책을 대신 생성하는 도구가 아니다.
