아동이 없어도 녹화하고,
그 수업에서 다시 볼 수 있게
마지막 업데이트 2026-11-11
아동 미접속 수업의 영상 저장·재입장 녹화 재개·앱 접속 시 재전송 안내를 함께 다루는 구현 설계입니다.
1. 기대 결과
완료 기준은 PC에 파일이 생기는 것이 아니라, 영상이 원격 저장되고 해당 수업의 녹화 목록에서 찾아 재생되는 것입니다.
- 예약시각이 지나고 앱 준비·복구가 끝나면 아동 없이도 녹화를 시작합니다.
- 끝까지 아동이 오지 않아도 영상과 수업 정보를 저장합니다.
- 늦게 합류한 아동의 음성은 실제 합류 시점부터 영상과 맞게 재생됩니다.
- 진행자가 미종료 수업에 다시 들어오면 시작 조건 확인 후 녹화를 재개합니다.
- 전송 실패 정보는 보존하고, 앱 접속 시 재전송 상태와 재시도를 안내합니다.
2. 확인된 문제와 현재 코드의 차이
| 근거 | 확인 내용 | 해석 |
|---|---|---|
| 2026-11-10 사용자 제공 QA 웹 7270324 / 앱 0.1.9 a943985 | 아동 0명 종료 시 upload 호출 0회, IndexedDB 메타 삭제, done 처리 및 경고. 재입장 시 exitedAt 조건이 자동 재시작 차단. | 시작 성공만으로 저장·재입장 요구를 충족하지 못함. |
| 2026-11-11 작업트리 코드 확인 웹 HEAD 6159f83a submitStoredRecording | 현재 1:1 키에는 영상만 등록하는 예외가 있음. 그룹은 조립된 음성 파일이 없으면 empty 반환. | 이전 QA를 현재 1:1 전체에 그대로 적용하지 않음. 1:1은 실제 저장·재생까지 별도 검증 필요. |
useGroupRecordingSession | empty 결과에서 로컬 메타 정리, notRecorded 표시, 앱 영상 폐기 요청 경로가 있음. | 그룹 영상만 저장하려면 제출·정리·앱 처리까지 함께 변경해야 함. |
useScheduledRecordingStart | 예정시각 이후 이탈 이력이 있고 lessonActive가 false이면 재시작 차단. | 아동 접속 여부와 수업 종료 여부를 분리해야 함. |
확인된 코드 경로와 사용자 제공 QA를 근거로 한 설계입니다. 서버·앱·플레이어 전체 경로의 호환성 및 실제 OS 캡처·원격 저장소 E2E는 아직 검증하지 않았습니다.
3. 데이터와 책임
수업에 영상을 연결하는 기준은 실제로 녹음된 아동 목록이 아니라 예약된 수업 대상입니다. 음성 트랙은 실제 녹음이 있을 때만 만듭니다.
| 담당 | 입력·소유 정보 | 출력·책임 |
|---|---|---|
| 예약·수업 화면 | 수업 범위, 날짜, 대상 room·아동·회기, 진행자, 예약 시작·종료 정보 | 접속 인원과 무관한 수업 스냅샷 전달. 정보 로딩 중과 대상 없음 구분. |
| 웹 녹화 세션 | recordingId, 수업 스냅샷, 실제 음성 구간, 앱 영상 상태 | 시작 전에 필요한 연결 정보를 지속 저장. 종료·새로고침·복구에도 같은 녹화 정보 유지. |
| 웹 업로드·복구 | 저장된 녹화 메타와 음성 조각 | 음성 0개여도 manifest 제출. 같은 녹화의 중복 제출 방지. 실패 시 재전송 근거 보존. |
| 서버 complete·색인 | 검증된 예약 대상과 manifest, 녹화 식별자 | 영상만 있는 녹화를 수용하고 대상 수업별 색인 생성. 권한 및 수업 관계 검증. 재요청에 중복 행을 만들지 않음. |
| 모니터 앱 | 녹화 식별자, 화면 캡처 및 로컬 영상 파일 | 영상 저장·전송·재시도 상태 보존. 아동 음성 부재만으로 영상 폐기 금지. |
| 녹화 보기·상태 UI | 수업 색인, 영상 수신 상태, 실제 음성 트랙 | 음성 트랙이 없어도 영상 재생. 미전송·확인 대기·완료를 구분. |
필드 이름·manifest 버전 변경 여부는 서버와 기존 데이터 소비자를 확인해 확정합니다. 예약 대상 정보를 가짜 음성 트랙으로 표현하지 않습니다. 과거 메타에 대상 정보가 없으면 임의의 아동에게 연결하지 않고 복구 확인 대상으로 남깁니다.
4. 시작·재입장 정책
- 시작: 유효한 예약시각 도달 + 앱 준비 + 복구 완료 + 수업 미종료 + 녹화 가능 시간 이내를 모두 확인합니다.
- 재입장: 이탈 이력만으로 재시작을 막지 않습니다. 같은 수업이 미종료인지 확인한 뒤 재개합니다. 기존 앱 녹화가 살아 있으면 먼저 연결·복구해 중복 시작을 방지합니다.
- 차단: 예약시각 전, 종료된 수업, 녹화 마감 이후, 복구 중에는 자동 시작하지 않습니다. 종료 상태를 아직 모르는 것을 미종료로 간주하지 않습니다.
- 종료: 아동 0명을 ‘모두 수업 종료’로 간주하지 않습니다. 기존 수업 종료·예약 마감·이탈 종료 정책과 최대 녹화 제한을 유지합니다.
- 구간 연결: 재입장으로 새 녹화가 생기면 같은 수업에 연결하고 실제 시간 순으로 재생합니다. 이탈 중 녹화되지 않은 구간은 공백으로 남습니다.
주요 검토 지점: use-scheduled-recording-start.ts, 녹화 컨트롤 호출부, 수업 종료 판단 및 복구 경로. exitedAt 조건을 단순 삭제하는 것으로 끝내지 않습니다.
5. 영상만 저장하는 흐름
- 시작 전에 예약 대상·진행자·수업 범위를 스냅샷으로 저장합니다.
- 앱은 영상을 녹화하고, 웹은 실제 합류한 아동의 음성만 수집합니다.
- 종료 시 음성 파일이 0개여도 수업 대상과 영상 정보를 가진 manifest를 만듭니다.
- 서버가 manifest를 검증하고 각 대상 수업에 색인을 만듭니다. 이미 처리한 recordingId 재요청은 같은 결과로 수렴시킵니다.
- 웹 등록과 앱 영상 전송의 도착 순서가 달라도 복구할 수 있게 합니다. 등록 성공만으로 ‘전송 완료’를 표시하지 않습니다.
- 영상 수신과 수업 연결이 확인되면 완료 표시합니다. 로컬 정리는 재전송에 필요한 정보의 소유자를 확인한 뒤 수행합니다.
영향 범위: StoredRecording, assembleGroupRecording, submitStoredRecording, 업로드·복구 runner, complete API·수업 색인·조회, 앱 영상 폐기/재전송 경로, 영상 확인과 플레이어. 기존 음성 있는 녹화와 1:1 예외도 회귀 확인합니다.
6. 앱 접속 시 재전송 오버레이
앱 준비 후 웹·앱에 남은 미전송 기록을 확인합니다. 동일 recordingId를 묶어 수업명·일시·진행 상태·실패 이유와 필요한 동작을 보여줍니다. UI는 apps/web/shared/ui/overlay의 useOverlay를 사용합니다.
| 표시 상태 | 사용자 동작과 처리 |
|---|---|
| 전송 중 | 진행 상황 표시. 중복 재시도 차단. |
| 전송 실패 | 실패한 웹 등록 또는 앱 영상 전송을 재시도. 이미 성공한 파일·색인은 중복 생성하지 않음. |
| 영상 확인 대기 | 서버 수신 상태 재확인. 확인 지연을 성공으로 바꾸지 않음. |
| 복구 확인 필요 | 로컬 파일 또는 수업 정보가 부족한 이유를 표시. 재전송 불가능한 항목에 성공 가능한 것처럼 재시도 버튼을 제공하지 않음. |
| 완료 | 영상·수업 연결 확인 후 완료로 전환. |
닫기는 미전송 자료 삭제를 뜻하지 않습니다. 기존 업로드 잠금과 복구 runner를 재사용하는 방향으로 설계하며, 앱 브리지의 미전송 목록·재시도 지원 여부는 구현 전에 확인합니다.
7. 필수 인수 기준
| 시나리오 | 기대 결과 |
|---|---|
| 1:1 아동 끝까지 미접속 | 예약 이후 녹화 시작. 음성 없이 영상·manifest 저장, 해당 회기 목록에 표시, 영상 재생 성공. |
| 그룹 전원 끝까지 미접속 | 음성 0개여도 정상 등록. 예약된 각 대상 수업의 색인에서 해당 영상 조회·재생. 앱 영상 폐기 요청 없음. |
| 시작 후 늦게 합류 | 합류 전 영상 보존. 합류 후 음성 시작 offset과 영상 동기 일치. 예약 대상 중복 등록 없음. |
| 아동 없이 진행자 반복 이탈·재입장 | 미종료 수업에서 조건 충족 시 재개. 구간 누락·중복 없이 같은 수업에 연결. 종료·마감 후 재입장에서는 시작하지 않음. |
| 웹 등록 실패 / 앱 영상 전송 실패 | 각각 독립적으로 미완료 표시와 재시도 정보 보존. 앱 재접속 후 안내·재시도 가능. |
| 재시도 중복 / 전송 도착 순서 역전 | 수업 색인·녹화 중복 없음. 영상 수신 전 완료 표시 없음. |
| 시작 조건 회귀 | 예약 전·앱 미준비·복구 중·종료 상태 미확인에서는 시작하지 않음. 기존 정상 음성 녹화 유지. |
모든 핵심 4개 시나리오에서 실제 OS 캡처 → 영상·manifest 원격 저장 → 수업별 색인 → 재생을 검증해야 완료입니다. 외부 통신 차단 fixture나 합성 영상 통과만으로 완료 처리하지 않습니다.
8. 구현 순서와 검증
- 계약 확인: 예약 대상 데이터, 종료 상태, manifest·complete 검증, 앱 브리지, 조회·재생 경로를 추적합니다. 현재 코드와 QA 버전을 구분합니다.
- 설계 확정: 공통 계약에 영향을 주는 변경으로 취급하고 설계 승인 후 상세 구현 계획을 작성합니다. 작업 분류는 기존 동작 수정과 추가를 포함하는
combined입니다. - 기준 테스트: 실제 위험 동작을 보호하는 기존 테스트를 확인하고 관련 baseline을 실행합니다. 빈 음성·재입장·중복 복구를 보호하지 못하면 최소 테스트부터 추가합니다.
- 저장 경로: 예약 정보 지속 저장, 영상 전용 manifest·서버 색인·재생과 앱 영상 보존을 하나의 흐름으로 구현합니다.
- 재입장·복구: 미종료 판단과 중복 녹화 방지, 재전송 오버레이를 연결합니다.
- 검증: 관련 hook·제출·서버 계약·복구·플레이어 테스트만 우선 실행합니다. UI 상태별 fixture Storybook story와 관련 정적 빌드를 검증하고, 변경 경로에 한정한 lint·타입·mutation 검사를 수행합니다.
- 최종 확인: guardian-gate 코드 리뷰와 실제 앱·원격 저장 E2E 증거를 남깁니다. 미검증은 미검증으로 기록합니다.
9. 남은 결정과 운영 영향
- 미종료·취소·마감의 권위 있는 데이터와 로딩 완료 조건을 확인해야 합니다.
- 예약 대상이 변경되는 경우 스냅샷 갱신 범위, 과거 메타 복구와 manifest 호환 정책을 확정해야 합니다.
- 그룹 공통 영상의 기존 권한 정책을 유지하면서 예약 대상별 색인이 올바른 수업에만 연결되는지 확인해야 합니다.
- 진행자만 있는 영상도 저장되므로 저장량·전송량이 증가합니다. 녹화 표시와 기존 종료 제한을 유지합니다.
- 이번 범위는 미접속 녹화의 정상 저장·재입장·복구입니다. 예약 전 무조건 녹화, 음성 수집 방식 변경, 관련 없는 구조 정리는 포함하지 않습니다.