PPI-1482 리소스 로딩 진행 바: As-Is → To-Be

마지막 업데이트 2026-11-19

진행 바 기준을 파일 개수에서 전체 바이트로 바꿉니다. 숫자 x / y는 그대로 파일 개수입니다. PR #1342 · 2026-11-19

배경 사례: 강예준 2회기 리소스 로딩 8/21 정체 원인 분석 (9번째 영상 수신 중 바 정체)

As-Is

바 = current / total (파일 수)
큰 영상 1개를 받는 동안 바가 멈춤 → 아동·보호자가 멈춘 줄 알고 재입장 반복

To-Be

바 = 받은 바이트 / 전체 바이트 (ratio)
받는 중인 파일의 진행분까지 반영 → 저속 회선에서도 바가 계속 차오름. 진행자 모니터도 같은 비율 표시

시뮬레이션 (가정: 파일 21개, 100MB, 8Mbps)

0초
칸 너비 = 파일 크기. 9번째 파일이 60MB 영상(전체의 60%), 나머지는 2MB씩
아동 로딩 화면
As-Is 파일 개수
To-Be 바이트 (250ms 간격 갱신)
진행자 모니터 (카드뷰·포커스뷰)
As-Is 파일 개수
To-Be 바이트 5% 단위

데이터 흐름 변경

아동 화면

/api/resources/urls
+ 화질별 size
→ fetchResumable
+ onBytes(received,total)
→ useResourceCache
파일 비중 합산 → onByteProgress(ratio)
→ useLessonDataLoader
250ms throttle
→ ResourceLoadingScreen
ratio ?? current/total

진행자 모니터

useLessonDataLoader
파일 수 변화·5% 단위만 publish
→ GUEST_CACHING_PROGRESS
+ ratio (0~1)
→ socket 핸들러
ratio 검증 → Redis 저장
→ useMonitorSession
cachingProgressFromEvent
→ MonitorMediaDisplay
카드뷰·포커스뷰 바

초록 테두리 = 이번 PR에서 바뀐 지점. 크기를 모르는 파일은 크기를 아는 파일의 평균을 비중으로 씁니다. 비율은 뒤로 가지 않습니다.

호환성 (배포 순서 무관)

조합아동 화면진행자 모니터
새 web + 새 socket바이트 기준바이트 기준 (5% 단위)
새 web + 구 socket바이트 기준파일 개수 기준 (socket이 ratio 무시)
구 아동 화면 + 새 socket파일 개수 기준파일 개수 기준 (ratio 없음)
size 정보 없는 리소스평균 비중으로 계산, 전부 없으면 파일 개수와 같은 결과

비용·남은 확인