# 예보 v0 채점 풀이 — 구현 방법이며 규칙 변경이 아니다

- 대상: `data/forecast/forecast_v0_2026-11.json` (2026-11-12 14:22 고정, SHA-256 `85e60c86a660992788b614a76ab7ef461b12c09e0814bca832b88ebd00f9d92c`).
- 이 파일은 2026-11-12(목) 밤, 첫 채점 창(11/13 12:55)보다 먼저 고정한다. 이 파일의 SHA-256 은 `data/proof/HASHES.txt` 에 적고, 예보 파일과 함께 OpenTimestamps 공개 시각 증명을 남긴다(`data/proof/`). 고치지 않는다. 고칠 일이 생기면 새 파일로 내고 까닭을 적는다.
- v0 파일에 적힌 규칙이 먼저다. 이 파일은 v0 에 적히지 않은 처리만 정한다. 기준 구현은 `ops/score_forecast.py` 다.

## 1. 기록을 5분 칸에 넣기

1. 기록은 `data/live/parking_sum.csv` 의 `time_kst`(이 PC 시계, 한국 시각)와 `parking_sum` 이다. `parking_sum` 이 빈 줄(요청 실패)은 기록이 없는 것으로 본다.
2. 기록마다 가장 가까운 5분 칸(매시 00·05·…·55분)에 넣는다. 칸 시각에서 2분 안인 기록만 넣고, 한 칸에 둘 이상이면 칸 시각에 가장 가까운 기록을 쓴다.
3. "[13:00, S]" 는 13:00 칸부터 S 칸까지다(두 끝 포함).

## 2. 13시 값

1. 12:55·13:00·13:05 세 칸 값의 가운데 값이다.
2. 셋 가운데 빈 칸이 있으면 있는 값으로 낸다. 둘이면 평균, 하나면 그 값이다. 결과 표에 몇 칸으로 냈는지 적는다.
3. 셋 다 비면 그날은 측정 불충분이다.

## 3. 30분 빈칸

1. [12:55, S] 안에서 세 곳을 본다. (가) 12:55 부터 첫 기록 칸까지 (나) 이웃한 두 기록 칸 사이 (다) 마지막 기록 칸부터 S 까지.
2. 어느 한 곳이라도 30분을 넘으면(5분 칸으로는 35분 이상) 그날은 측정 불충분이다. 예: 13:00 칸 다음 기록이 13:30 칸이면 30분이라 채점한다. 13:35 칸이면 측정 불충분이다.

## 4. M 과 판정

1. M = [13:00, S] 칸 값의 최댓값 − 13시 값.
2. 맞음: 범위(range)의 아래 끝 ≤ M ≤ 위 끝(두 끝 포함). 아니면 틀림.
3. 오차 = M − 점 예보(point).
4. 판정은 반올림하기 전 값으로 한다. 표에는 정수로 반올림해 적는다(0.5 는 올린다). 평균 절대 오차도 반올림 전 값으로 낸 뒤 반올림한다.
5. 최댓값이 여러 칸에서 나오면 가장 이른 칸의 시각을 적는다.

## 5. 정점(peak_window 가 있는 11/27·28·29)

1. [13:00, S+10분] 칸 값의 최댓값이 나온 시각(여럿이면 가장 이른 시각)이 peak_window 안(두 끝 포함)인지 본다.
2. 빈칸 규칙은 3절과 같고, 끝을 S 가 아니라 S+10분으로 본다. 이 규칙에 걸리면 정점만 측정 불충분이고 M 판정은 그대로 둔다.

## 6. 언제 매기나

그날 S+15분이 지나면 매긴다. 그 전에는 '아직'이다. 숫자가 굳는 때: TXT 마지막 날 11/15 17:15, 로이킴 마지막 날 11/22 17:15, 평일 마지막 날 11/26 18:15, 조용필 마지막 날 11/29 17:15.

## 7. 공연일과 평일

1. 공연일 8일은 `main` 이 있는 날이다(11/13·14·15·21·22·27·28·29). 평일 9일은 `main` 이 비어 있는 날이다(11/16~20, 11/23~26).
2. 성적 첫 줄은 "공연 날 8번 중 m번 범위 안 · 평일 9번 중 k번 · 순서 주장 3개 중 j개 맞음" 꼴이다. 측정 불충분인 날, 아직인 날, 판정 전인 주장은 따로 적는다.
3. 공연일과 평일을 합친 적중률은 내지 않는다. 점 예보 평균 절대 오차도 공연일과 평일을 따로 낸다.

## 8. 순서 주장

1. 주장 1(조용필 > 로이킴): 조용필 날 M 의 가장 작은 값 > 로이킴 날 M 의 가장 큰 값.
2. 주장 2(로이킴 > TXT): 로이킴 날 M 의 가장 작은 값 > TXT 날 M 의 가장 큰 값.
3. 주장 3(TXT 는 평일보다 조금 큼): TXT 세 날 각각 0 < M − 평일 평균 < 200 이고, 셋 다 맞아야 맞음이다. 날마다 차이를 함께 적는다.
4. 평일 평균은 채점된 평일 M 의 평균이다(9일 가운데 몇 날로 냈는지 적는다).
5. 측정 불충분인 날은 빼고 판정하고, 몇 날로 판정했는지 적는다. 견주는 한 묶음이 모두 측정 불충분이면 '판정 못 함'이다. 견주는 날이 다 끝나기 전에는 '아직'이다(주장 2: 11/22 17:15, 주장 3: 11/26 18:15, 주장 1: 11/29 17:15).

## 9. 기록원과 대신 쓰기

1. 기록원은 PC 기록(`data/live/parking_sum.csv`)이다.
2. 2026-11-17 부터 Cloudflare Worker 기록이 있으면, PC 기록이 빈 5분 칸에만 Worker 값을 넣는다. PC 값이 있는 칸은 PC 값을 쓴다. Worker 시각은 한국 시각으로 바꿔 1절과 같은 방법으로 칸에 넣는다.
3. 날마다 PC 칸 수와 대신 쓴 칸 수를 적는다. 대신 쓰기 때문에 판정(채점/측정 불충분, 맞음/틀림)이 바뀐 날은 PC 기록만으로 낸 판정도 함께 적는다.

## 10. 틀린 날 공개 문구 (v0 `wrong_public_note` 를 따른다, 빈칸만 채운다)

- 예보보다 많았을 때: "11월 ○일(○) 예보는 13시부터 공연 시작까지 주차가 +○~+○대(점 +○대) 늘어난다는 것이었습니다. 실제는 +○대로 예보보다 많아 '틀림'입니다. 다른 점: ○○(추정). 미리 고정한 예보는 고치지 않고 그대로 둡니다. 12월 예보에서 바꾼 점: ○○."
- 예보보다 적었을 때: "11월 ○일(○) 예보는 +○~+○대(점 +○대)였습니다. 실제는 +○대로 예보보다 적어 '틀림'입니다. 다른 점: ○○(추정). 미리 고정한 예보는 고치지 않고 그대로 둡니다. 12월 예보에서 바꾼 점: ○○." '많이 붐빔'으로 안내한 날이면 "이 안내를 보고 시간을 옮기신 분께 죄송합니다."를 덧붙인다.
- 측정 불충분: "11월 ○일은 기록이 ○시 ○분부터 ○분 동안 비어 채점하지 않았습니다(v0 규칙: 30분 넘게 비면 채점하지 않음)."

## 11. 고정 뒤에 더한 보조 지표 — v0 성적을 바꾸지 않고 성적 첫 줄에 넣지 않는다

화면과 글에는 '고정 뒤 보조 지표'라고 제목을 붙인다.

1. 기준선: 모든 공연일에 +583대를 예보했다고 칠 때의 평균 절대 오차(공연일만). +583 은 v0 근거 7일 M(275·342·269·1,206·1,346·214·432)의 평균(4,084 ÷ 7 = 583.4)이다. 점 예보 오차가 이보다 작을 때만 "공연 유형을 나눈 값어치가 있었다"고 쓴다.
2. 잡음 폭: 채점된 평일 M 의 가장 작은 값~가장 큰 값.
3. 단계 적중: M ≤ 300 은 평소, 300 < M < 700 은 조금 붐빔, M ≥ 700 은 많이 붐빔으로 다시 매겨 v0 `parking_level` 과 견준다. '평소~조금 붐빔'은 둘 다 맞음으로 본다. 300 은 v0 평일 범위의 위 끝, 700 은 v0 주차형 범위의 아래 끝이다.
4. 13~22시 Δ 곡선: Δ(t) = v(t) − 13시 값. 채점 구간 [13:00, S] 를 칠해 구분하고, 예보 범위는 S 자리의 세로 막대로 그린다.
5. 공연 없는 금요일 11/20 의 Δ 곡선을 11/13·11/27 금요일 곡선과 나란히 둔다.
6. '가를 수 없음' 덧말: TXT 날 M 과 평일 평균의 차이가 잡음 폭(평일 M 의 가장 큰 값 − 가장 작은 값)보다 작으면 붙인다. 11월 관측 창에는 공연 없는 주말이 없어 주말끼리의 흔들림은 재지 못했다는 말도 TXT 판정에 붙인다.

## 12. 다시 매기는 경우

PC 기록 파일은 줄을 덧붙이기만 한다. 채점 코드의 잘못을 고치면 다시 매기고, 커밋 기록과 `ops/score_forecast.py` 머리 주석에 무엇을 왜 고쳤는지 적는다. 예보 v0 과 이 풀이는 고치지 않는다.
