그룹 녹화 최대 아동 수 4 → 6 변경 영향 검토

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

대상: apps/web/features/monitor-recording/model/recording-limits.ts의 MAX_RECORDED_CHILDREN = 4 · 기준 코드: ppi PPI-1376 브랜치(2026-11-11)

결론

1. 4명은 어디서 나왔나

출처내용해석
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번째 아동부터는 녹음에서 빠집니다.

2. 현재 동작

3. 6으로 바꾸면 고칠 곳

위치변경
recording-limits.ts:2MAX_RECORDED_CHILDREN = 6
use-group-recording-session.test.tsx:1342"아동은 4명까지 녹음하고 나머지는 skippedRooms로 남긴다" — 아동 7명을 넣어 1명이 빠지는지 확인하도록 고칩니다
설계·계획 문서, Storybook"4명 초과" 문구를 고칩니다
서버 lib/monitor-recording/바꿀 것 없음. 아동 수 제한이 없고, 파일당 크기 제한(child-audio 300MB)만 있습니다
녹화 뷰어바꿀 것 없음(코드 기준). 아동을 한 줄씩 나열하는 구조입니다. 6명 화면은 직접 확인하지 않았습니다

4. 위험

등급항목내용
높음진행자 브라우저 부하 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번째 아동은 그 녹화가 끝날 때까지 계속 빠집니다

5. 권장 순서

  1. 운영에서 5~6명 그룹이 실제로 필요한지 기획과 확인합니다.
  2. 진행자가 실제로 쓰는 PC급 장비에서 4:1과 6:1로 각각 40분 녹화를 합니다. 기존 MONITOR_PERFORMANCE 로그(Long Task, 프레임)와 메모리·CPU를 비교합니다.
  3. monitor app 영상에 카드 6개가 모두 담기는지 확인합니다.
  4. 통과하면 상수, 테스트, 문서를 함께 바꾸고 guardian-gate 리뷰를 거칩니다.
녹화 뷰어 6명 화면과 4:1·6:1 실측 결과는 이 문서 작성 시점에 확인하지 않았습니다. 측정하면 이 문서에 결과를 덧붙여 주세요.

관련 문서