[위험도] 신뢰도가 재는 것과 시민이 읽는 것을 맞춘다

[RosieOh]

Closes #92

문제

deriveConfidence(missingCount, observationAgeMinutes)   // 입력이 둘뿐

이름은 "데이터 신뢰도" 인데 재는 것은 입력 완전성 × 신선도다. 그리고 그 값이 PublicBeachRiskResponse 로 시민에게 나간다.

⚠️ 안전 + 신뢰도 높음 을 본 사람은 물에 들어간다. 그 "높음" 이 실제로 보장하는 것은 10km 안의 부이에서 3시간 안에 값이 들어왔다 는 것뿐이다.

① 수온이 통째로 없어도 medium 이었다

수온이 없으면 TEMP_UP + TEMP_7D_AVG 가 함께 빠져 개수가 2 — low 기준 3에 걸리지 않는다.

무게로 바꿨다. 수온 두 요인의 합을 3으로 맞춰 수온이 없으면 그 자체로 low 다.

	예전	지금
수온 없음	medium	low
유속만 없음	medium	medium
부차 요인 셋	low	low

② 거리를 아예 보지 않았다

40km 떨어진 관측소의 값이라도 high 가 나왔다. 10km 초과 한 단계, 30km 초과 두 단계.

10km 는 이 저장소가 이미 같은 질문에 내놓은 답이다 — 정답 데이터에서 출현을 해변에 붙이는 반경이고, 근거는 "이보다 넓으면 해변별 차이가 사라진다" 였다. 관측값도 같은 질문을 받는다: 이 값이 이 해변의 것인가. 30km 는 엔진이 "인근 출현" 으로 치는 반경이다.

거리는 실제로 값을 준 해양 관측소의 것이다 — 대표가 낡으면 더 먼 곳이 선택되고, 그때 값은 더 멀리서 온 것이다.

⚠️ 기상 관측소 거리는 쓰지 않는다. 제주 전체에 둘뿐이라(대표 평균 22.6km, 최대 35.5km) 벌점을 주면 모든 해변이 함께 내려갈 뿐이고 운영자가 고칠 방법이 없다. 신뢰도는 고칠 수 있는 것을 가리켜야 한다.

③ 시민에게 '신뢰도' 라고 말하지 않는다

값과 필드 이름은 그대로 두고(프론트가 쓴다) dataConfidenceLabel 을 추가했다:

high   관측 자료 충분
medium 관측 자료 일부 없음
low    관측 자료 많이 부족

low 를 '부족' 이 아니라 '많이 부족' 으로 한 이유 — '부족' 은 "조금 모자라다" 로 읽힌다. low 는 수온을 한 값도 못 받았거나 관측이 하루 넘게 끊긴 상태다.

실측 (제주 12곳, 실데이터)

중문색달  1.1km  결측없음         → high
곽지과물 10.1km  CURRENT_INFLOW   → low      ← 거리 경계를 0.1km 넘는다
나머지 10곳     CURRENT_INFLOW   → medium

⚠️ 선을 15km 로 옮기면 곽지가 안 걸린다. 그건 숫자를 결과에 맞춘 것이지 근거가 아니다. 곽지의 최근접 해양관측소가 실제로 경계에 있다는 사실이 드러나는 편이 낫다.

검증

lint 0 · unit 1377 (신규 17) · e2e 65 · 실 DB 스모크 168 · build OK
git rebase --exec 'npx tsc --noEmit'  → 3 커밋 전부 단독 통과

세 수정을 각각 되돌려 깨지는 것을 확인했다 — 무게→개수 1건, 거리 벌점 제거 3건, 라벨에 '신뢰도' 사용 2건.

남는 것

⚠️ 백테스트는 관측소 거리 기록이 없어 null 을 넣는다. 거리 벌점이 붙지 않으므로 과거 신뢰도를 실제보다 후하게 본다 — 지표를 비교할 때 이 차이를 기억해야 한다.

그리고 이 PR 은 여전히 정확도를 재지 않는다. dataConfidence 는 자료가 충분한지만 답한다. 예측이 맞는지는 정답 데이터가 쌓여야 알 수 있다(#81, #83).