전투 분석기 OCR MVP

이어받기 스냅샷

상태

진행 중. 고정 crop 기반 전투 분석기 OCR은 레이드 화면에 연결됐고, 실제 영상/화면 공유 검증과 타임라인 모델링이 남아 있습니다.

갱신일

2026-05-13

목표

서버 OCR, 저장소, 파티원 식별, 랭킹, 공개 공유 없이 개인 복기용 전투 지표를 읽을 수 있도록 전투 분석기 OCR의 최소 사용 가능 흐름을 레이드 화면에 연결합니다.

포함 범위

• 우하단 고정 panel crop 기준 전투 분석기 샘플 검증.
• 피해량, DPS, 전투시간 parser와 단위 정규화.
• 파싱 실패, 전투시간 역행, 누적 피해량 감소, 자리수 폭주, DPS 범위 초과, 피해량/시간 대비 DPS 불일치를 버리는 raw stream 안정화.
• 전투 분석기 전용 OCR 경로와 레이드 OCR 흐름의 2초 주기 고정 crop OCR 루프.
• 레이드 상단 상태바에 피해량, DPS, 전투시간, 최근 제외 값 표시.
• 녹화 영상으로 같은 OCR 흐름을 확인할 수 있는 임시 검증 화면.

제외 범위 / 위험 분리

• 이번 MVP에는 floating panel 자동 탐지와 이동 대응을 포함하지 않습니다.
• 그래프 또는 타임라인 UI는 아직 없습니다. 상태바는 현재 accepted reading만 보여줍니다.
• localStorage, 파일 export, DB 저장, schema 변경은 하지 않았습니다.
• 파티원 식별, 랭킹, 공개 공유, 책임 추정 문구는 포함하지 않습니다.

결정

• 현재 OCR 경로는 전투 분석기 panel이 라벨링한 우하단 위치에 유지된다는 전제를 둡니다.
• 중간에 튀는 OCR 값은 마지막 accepted reading을 오염시키지 않도록 stream stabilizer에서 버립니다.
• floating panel 탐지는 고정 crop MVP가 실제로 쓸모 있는지 확인한 뒤 별도 작업으로 다룹니다.
• 전투 분석기 OCR 주기는 현재 2초로 유지합니다. 실제 테스트 후 1초로 줄일지 결정합니다.

검증

• OCR parser와 stream 안정화 focused test가 통과했습니다.
• 전투 분석기 OCR 샘플 검증은 대부분의 샘플에서 모든 필드를 동시에 읽었고, 남은 실패는 밝은 이펙트가 겹친 샘플이었습니다.
• 전체 테스트와 lint가 통과했습니다.
• 최종 실제 영상/화면 공유 환경에서의 live 검증은 남아 있습니다.

다음 작업

1. 녹화 영상 또는 실제 화면 공유로 피해량, DPS, 전투시간이 자연스럽게 갱신되는지 확인합니다.
2. 전투 분석기 OCR 주기를 2초에서 1초로 줄일지 결정합니다.
3. accepted combat meter reading, HP sample, 수동 marker를 소비하는 클라이언트 전용 타임라인 모델을 만듭니다.
4. 고정 crop MVP가 유용하다는 점을 확인한 뒤 floating panel 탐지를 별도 작업으로 분리합니다.