마지막 업데이트 2026-11-11
대상: apps/web/features/monitor-recording/model/recording-limits.ts의 MAX_RECORDED_CHILDREN = 4 · 기준 코드: ppi PPI-1376 브랜치(2026-11-11)
| 출처 | 내용 | 해석 |
|---|---|---|
| PPI-1376 녹화 계획 §8 | "구현 전 확정: … 최대 녹화 길이·동시 아동 수" → "2026-10-19 확정: … 최대 30분·아동 4명" | 정책 결정으로 확정한 값입니다. 성능 수치는 함께 적혀 있지 않습니다 |
설계 docs/superpowers/specs/2026-10-19-monitor-card-recording-design.md:25 | "확정 정책" 표: 최대 아동 수 | 4명 (5번째 이후 room은 녹음하지 않고 UI에 표시) | 이유가 적혀 있지 않습니다 |
| 같은 문서 §1 PoC 완료 기준 6번 | "30분 녹화 시 메모리·CPU … 기록" | 성능은 근거가 아니라 나중에 측정할 항목이었습니다 |
최초 커밋 c2abbc2b | "최대 30분, 아동 4명, 녹화 전 대기 10분으로 제한해 장시간 녹화로 인한 브라우저 부하와 저장 용량 문제를 막습니다" | 세 제한을 묶은 설명이라 4라는 숫자 자체의 근거는 아닙니다. 이 커밋 당시에는 별도 녹화 창이 탭 영상을 캡처해 다시 인코딩하는 구조여서 지금보다 부하가 컸습니다 |
계획 docs/superpowers/plans/2026-10-27-in-page-child-audio-recording.md:359-360 | "IndexedDB 쓰기 부하(5초 × 아동 4명) … 실기기 4:1 수업에서 프레임 저하 여부를 확인" | 4명을 전제로 두고 성능은 나중에 확인하는 순서입니다 |
그룹 수업 구성은 4:1 모니터 그룹 수업 만들기 가이드를 참고하세요. 커스텀 그룹 정원(maxChildrenByGroupType.custom, 기본 2)은 서버 설정으로 4보다 크게 올릴 수 있습니다. 그래서 5명 이상인 그룹은 설정만 바꾸면 생길 수 있고, 그때 5번째 아동부터는 녹음에서 빠집니다.
use-group-recording-session.ts:508의 addRoom 한 곳에서만 검사합니다. 이미 녹음 중인 room이 4개면 새 room은 run.skipped에 넣고, UI의 skippedCount와 manifest의 skippedRooms에 남깁니다.AnalyserNode, MediaRecorder(Opus) 1개, 5초마다(RECORDER_TIMESLICE_MS) IndexedDB에 조각 저장.| 위치 | 변경 |
|---|---|
recording-limits.ts:2 | MAX_RECORDED_CHILDREN = 6 |
use-group-recording-session.test.tsx:1342 | "아동은 4명까지 녹음하고 나머지는 skippedRooms로 남긴다" — 아동 7명을 넣어 1명이 빠지는지 확인하도록 고칩니다 |
| 설계·계획 문서, Storybook | "4명 초과" 문구를 고칩니다 |
서버 lib/monitor-recording/ | 바꿀 것 없음. 아동 수 제한이 없고, 파일당 크기 제한(child-audio 300MB)만 있습니다 |
| 녹화 뷰어 | 바꿀 것 없음(코드 기준). 아동을 한 줄씩 나열하는 구조입니다. 6명 화면은 직접 확인하지 않았습니다 |
| 등급 | 항목 | 내용 |
|---|---|---|
| 높음 | 진행자 브라우저 부하 1.5배 | 믹서·analyser·MediaRecorder·IndexedDB 쓰기가 그룹 모니터 탭의 메인 스레드에서 돌아갑니다. 같은 탭에서 카드 영상 디코드와 음성 분석도 함께 돌고 있습니다. 음성 분석은 docs/plans/audio-analysis-agent-optimization/02-current-architecture-and-risks.md에 4:1 기준 위험이 이미 정리되어 있습니다.PPI-1398 실측(녹화 없음, DevTools 열린 상태)에서 탭은 2세션일 때 CPU 약 24~30%·메모리 약 310~330MB, 4세션일 때 CPU 약 32~34%·메모리 517~566MB였습니다. 순간 표본이라 세션당 증가량은 계산할 수 없습니다. 녹화를 켰을 때 늘어나는 부하는 녹화 계획 문서( 2026-10-27-in-page-child-audio-recording.md:359)에 실기기 4:1에서 확인할 항목으로만 남아 있고, 측정 결과는 없습니다 |
| 중간 | 제품 구조가 4:1 기준 | 문서 전반이 그룹 수업을 4:1로 전제합니다. 운영에서 6명 그룹이 생기지 않으면 상수를 바꿔도 효과가 없습니다. 기획 확인이 먼저 필요합니다 |
| 중간 | 영상과 오디오 불일치 | 영상은 monitor app이 화면을 녹화합니다. 카드 6개가 한 화면에 다 보이지 않으면, 오디오는 있는데 영상에는 나오지 않는 아동이 생깁니다. 6개 카드 배치를 확인해야 합니다 |
| 낮음 | 저장 용량 | 40분 Opus 오디오는 아동 1명당 수십 MB입니다. 6명이면 IndexedDB 사용량과 업로드 양이 1.5배가 됩니다. 브라우저 quota를 넘을 가능성은 낮습니다 |
| 낮음 | 배포 순간 진행 중인 녹화 | 새로고침해서 녹화를 이어갈 때 저장된 skippedRooms를 그대로 복원합니다(use-group-recording-session.ts:764). 그래서 배포 전에 빠진 5번째 아동은 그 녹화가 끝날 때까지 계속 빠집니다 |
MONITOR_PERFORMANCE 로그(Long Task, 프레임)와 메모리·CPU를 비교합니다.