전투 분석기 OCR MVP

현재 병목

전투 지표는 보이지만, 시간축 데이터가 아니다

상태바에 숫자를 표시하는 것만으로는 복기가 되지 않는다. 먼저 OCR이 읽은 값이 “지금 믿을 수 있는 현재값”인지 판단해야 하고, 중간에 튀는 단발 값이 다음 단계의 그래프나 타임라인을 오염시키지 않아야 한다. 그래서 이번 slice는 그래프보다 앞단의 입력 안정화에 집중한다.

상태

진행: 고정 위치 OCR, 상태바, 리뷰 그래프 smoke 연결됨
남은 일: 실제 영상 검증과 최종 /raid 통합
갱신일: 2026-05-14

최근 관측 기준

왜 고정 crop MVP로 충분히 시작할 수 있는가

34 라벨링 샘플

33 전체 필드 동시 성공

3 읽는 필드

1초 현재 OCR 주기

실패한 샘플은 밝은 전투 이펙트가 겹친 케이스였다. 제품 연결은 1초 주기로 맞췄고, 모든 프레임을 맞히려 하기보다 대부분 안정적인 값을 받아들이고 튀는 값을 버리는 stream 안정화가 더 중요한 설계 포인트다.

입력 흐름

화면 숫자가 accepted reading이 되기까지

고정 영역

전투 분석기가 우하단에 있다는 전제에서 피해량, DPS, 전투시간 영역을 잘라낸다.

숫자 OCR

제한된 숫자와 구분자 중심으로 읽어 일반 텍스트 OCR보다 흔들림을 줄인다.

단위 파싱

억과 만 단위를 정규화하고 소수점 흔들림을 전투 분석기 표시 형식에 맞춘다.

stream 판정

시간 역행, 피해량 감소, 자리수 폭주, DPS 불일치 같은 단발 오류를 버린다.

복기 그래프

accepted reading만 상태바와 리뷰 타임라인에 넣고, 종료 후 DPS/HP 흐름을 관문별로 다시 본다.

이번 slice

바뀐 것과 일부러 바꾸지 않은 것

포함

피해량, DPS, 전투시간 parser와 단위 정규화.
전투 분석기 숫자에 맞춘 OCR 경로와 1초 주기 읽기 루프.
누적 피해량 감소, timer rollback, 자리수 폭주, DPS 불일치 제거.
피해량/전투시간 기준 DPS 검증. DPS OCR 후보가 범위 밖으로 튈 때만 derived DPS를 사용한다.
레이드 상단 상태바, /raid-video 검증 화면, 종료 후 리뷰 그래프 smoke.
관문 reset segment 분리, HP timeline 안정화, DPS smoothing/log scale/grid/current label 표시.

제외 / 위험 분리

floating panel 자동 탐지는 아직 하지 않는다.
저장, export, DB schema 변경은 하지 않는다.
파티원 식별, 순위화, 책임 추정 문구로 확장하지 않는다.
브라우저 화면 공유 녹화는 후보로만 남기고 현재 필수 범위에서는 제외한다.

결정

이어받는 사람이 지켜야 할 기준

현재 OCR 경로는 panel이 라벨링한 우하단 위치에 유지된다는 전제를 둔다.
중간에 튀는 OCR 값은 마지막 accepted reading을 오염시키지 않도록 버린다.
DPS OCR은 독립 신뢰값이 아니라 후보값이다. 범위 안의 후보가 피해량/전투시간과 모순되면 reject한다.
관문 구분과 HP 안정화는 전투 분석기 도메인에서 다루고, 기존 레이드 공략 표시 도메인과 테스트를 강하게 결합하지 않는다.
전투 지표는 개인 복기용 입력이며, 평가나 순위화로 다루지 않는다.
OCR 주기는 현재 1초다. reject 비율과 브라우저 반응성은 영상 기반으로 계속 확인한다.

검증 상태

통과한 것과 아직 봐야 할 것

통과

parser focused test
stream stabilization test
combat timeline focused test
chart render focused test
샘플 OCR 검증
type-check, lint, full test

남은 확인

녹화 영상에서 DPS/HP 그래프가 실제 흐름을 충분히 반영하는지 확인.
실제 화면 공유 환경에서 OCR worker 성능 확인.
OCR reject 비율과 derived DPS 비율이 수용 가능한지 확인.

다음 액션

바로 이어서 할 일

녹화 영상으로 1초 OCR reject 비율, derived DPS 비율, 그래프 흐름을 확인한다.
/raid-video smoke에서 검증한 리뷰 surface를 /raid 통합 흐름으로 옮기는 설계를 정한다.
관문별 boss/gate label metadata를 전투 분석기 도메인 안에서 어떻게 들고 갈지 정한다.
고정 crop MVP가 유용하다는 점을 확인한 뒤 floating panel 탐지를 별도 작업으로 분리한다.