2026-11-16 수업 로그 기술이슈 확인 대상

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

S3 수업 세션 로그 기반 · 테스트/내부 계정 및 force kick, 네트워크 경고, TURN_ANALYSIS, 진단성 미디어 경고 제외

0분석 세션
0기술이슈 후보
0정상
force kick / 네트워크 / TURN_ANALYSIS / 진단성 미디어 경고제외 기준
0긴급
0확인
목표는 원인 설명을 길게 쓰는 것이 아니라, 운영자가 바로 확인해야 할 아동 세션을 고르는 것입니다. 아래 목록은 아동명, 회기, 핵심 이슈, 원본 시그니처를 함께 보여줍니다.

당일 반영된 PPI 변경사항

git log origin/develop fallback 기준 · 총 9건. 병합 시각만으로 배포 완료를 단정하지 않습니다.

#1322 fix: 게스트가 수업 화면을 떠나면 녹음을 멈춘다

확인 필요 (GitHub API 504) · 2026-11-16 20:30:50 KST

변경 기능
수업 진행/완료/저장 — 게스트 연결 종료 시 recorder 녹음 중지 전달
영향받을 수 있는 사용자 흐름
아동 수업 화면 이탈·연결 종료 → socket connection handler → recorder stop
개선 기대
퇴장 뒤 불필요한 녹음 지속과 finalize 지연 감소 기대
회귀 위험
일시적 재접속을 이탈로 오인하면 녹음이 조기 종료될 수 있음
확인할 로그·지표
guest disconnect, recording stop/finalize, reentry 로그와 S3 산출물
관련 테스트
guest delivery lease 및 recorder primary reentry 테스트 추가
당일 이슈 관련 가능성
당일 아카이브 0건·미병합 335건이나 직접 대조할 수업 로그가 없어 관련성 확인 불가
배포 상태
미배포 가능성 — develop 병합만 확인, 당일 이슈 원인으로 연결 금지

주요 변경 파일: apps/socket/src/recording/recorderBackend.ts · apps/socket/src/recording/recordingService.ts · apps/socket/src/sfu-socket/handlers/connection-handlers.ts · apps/socket/test/connection-handlers.guest-delivery-lease.test.ts · apps/socket/test/recorder-primary.reentry.test.ts

#1324 chore: Recorder CI에 pnpm 캐시를 켜고 mediasoup 빌드를 건너뛴다

확인 필요 (GitHub API 504) · 2026-11-16 18:16:58 KST

변경 기능
배포/인프라 — Recorder CI 캐시·빌드 최적화
영향받을 수 있는 사용자 흐름
개발자 PR 검증 및 recorder CI 실행
개선 기대
CI 시간과 불필요한 mediasoup 빌드 감소
회귀 위험
캐시 키나 생략 조건 오류 시 검증 누락 가능
확인할 로그·지표
recorder-ci 소요시간·cache hit·빌드 실패율
관련 테스트
workflow 실행 확인 필요
당일 이슈 관련 가능성
런타임 코드 변경이 아니며 당일 기술이슈 직접 관련 근거 없음
배포 상태
CI 전용 변경

주요 변경 파일: .github/workflows/recorder-ci.yml

#1276 feat: 직원 Google 로그인과 공용 Dev 호환 전환

확인 필요 (GitHub API 504) · 2026-11-16 18:11:33 KST

변경 기능
인증/권한 · 진행자 모니터링 — 직원 Google OAuth, 세션·권한·staff route 전환
영향받을 수 있는 사용자 흐름
직원 로그인 → OAuth callback/session → staff 화면·모니터 API 접근
개선 기대
직원 인증을 통합하고 Dev 호환성과 권한 경계를 개선
회귀 위험
대규모 route·middleware 전환으로 로그인 루프, 권한 거부, 모니터 접근 회귀 가능
확인할 로그·지표
staff OAuth callback, session/context-status, 401/403, monitor credential 로그
관련 테스트
staff OAuth/session/policy/proxy/routes 및 socket staff-context 테스트 다수
당일 이슈 관련 가능성
당일 분석 세션이 0건이라 로그 이벤트·API route 직접 일치 여부 확인 불가
배포 상태
미배포 가능성 — develop 병합만 확인, 당일 이슈 원인으로 연결 금지

주요 변경 파일: apps/web/app/api/staff/google/callback/route.ts · apps/web/lib/staff-session.ts · apps/web/lib/auth.middleware.ts · apps/socket/src/sfu-socket/staff-context.ts · apps/web/app/api/lesson-logs/append/route.ts · 외 230개

#1314 feat: 사용자 상세에서 발행된 수업스케치를 보고 문장을 고친다

확인 필요 (GitHub API 504) · 2026-11-16 17:02:39 KST

변경 기능
기타 UI/운영 — 사용자 상세의 발행 수업스케치 조회·문장 수정
영향받을 수 있는 사용자 흐름
직원 사용자 상세 → 발행 보고서 목록·리비전 조회 → 문장 수정
개선 기대
운영 화면에서 발행 결과를 확인하고 교정 가능
회귀 위험
리비전 선택·저장 권한·동시 수정 시 잘못된 보고서 반영 가능
확인할 로그·지표
reports/revisions API 4xx·5xx, 저장 성공률
관련 테스트
published report API·detail·list 컴포넌트 테스트
당일 이슈 관련 가능성
수업 실시간 로그와 직접 일치하는 근거 없음
배포 상태
미배포 가능성 — develop 병합만 확인

주요 변경 파일: apps/web/components/sections/published-report-detail.tsx · apps/web/components/sections/user-published-reports.tsx · apps/web/lib/published-report.ts · apps/web/lib/ppi-api-client.ts · apps/web/app/api/class-mgmt/children/[childId]/reports/route.ts · 외 13개

#1319 [PPI-1462] fix: 데스크톱 모드 Android 태블릿에도 재생 정체 자동 복구를 켠다

확인 필요 (GitHub API 504) · 2026-11-16 16:59:34 KST

변경 기능
AI 세션/음성 인식 · LiveKit/WebRTC — Android 태블릿 재생 정체 자동 복구
영향받을 수 있는 사용자 흐름
AI 음성 재생 → playout stall 감지 → Android desktop-mode에서도 자동 복구
개선 기대
태블릿에서 음성 재생 멈춤의 자가 복구 범위 확대
회귀 위험
기기 판별 오탐이나 과도한 재시작으로 음성 끊김 가능
확인할 로그·지표
livekit playout stall·recovery 이벤트, 복구 횟수·재생 지연
관련 테스트
livekit-playout-stall Android desktop-mode 테스트 보강
당일 이슈 관련 가능성
당일 분석 세션 0건으로 logger/event 직접 대조 불가
배포 상태
미배포 가능성 — develop 병합만 확인, 당일 이슈 원인으로 연결 금지

주요 변경 파일: apps/web/lib/voice-agent/livekit-playout-stall.ts · apps/web/lib/voice-agent/livekit-playout-stall.test.ts

#1320 fix: Dev 배포 recorder 입력의 off가 false로 읽히지 않게 한다

확인 필요 (GitHub API 504) · 2026-11-16 16:57:25 KST

변경 기능
배포/인프라 — Dev recorder boolean 입력 변환 수정
영향받을 수 있는 사용자 흐름
Dev workflow 입력 off → runtime env 생성 → recorder 활성화 여부 결정
개선 기대
off 값이 잘못 truthy 처리되는 배포 설정 오류 방지
회귀 위험
Dev 전용 조건 분기 회귀 가능
확인할 로그·지표
Dev workflow input·runtime env 검증과 recorder 기동 상태
관련 테스트
dev runtime env wiring 테스트 보강
당일 이슈 관련 가능성
Prod 수업 로그와 직접 관련 근거 없음
배포 상태
Dev 배포 전용

주요 변경 파일: .github/workflows/dev.yml · scripts/dev-runtime-env-wiring.test.mjs

#1182 [PPI-1376] feat: 모니터 카드 녹화·S3 업로드·수업 녹화 뷰어

확인 필요 (GitHub API 504) · 2026-11-16 16:40:01 KST

변경 기능
진행자 모니터링 · 수업 진행/완료/저장 · LiveKit/WebRTC — 모니터 녹화, S3 업로드, 녹화 뷰어
영향받을 수 있는 사용자 흐름
모니터 카드 수업 감시 → 브라우저 녹화·로컬 복구 → S3 등록·업로드 → 로그 화면 재생·삭제
개선 기대
수업 녹화의 자동화·복구·조회 가능성과 운영 추적성 향상
회귀 위험
대규모 신규 경로로 녹음 누락, 메모리·디스크 증가, 업로드 중복, 완료 상태 경합, 미디어 소비 회귀 가능
확인할 로그·지표
recording start/chunk/complete/upload/recovery, S3 등록 실패, gap, monitor media 상태
관련 테스트
녹화 session/store/upload/recovery/viewer/API/monitoring 관련 광범위 테스트 포함
당일 이슈 관련 가능성
당일 아카이브 0건·미병합 335건이나 원본 finalize 로그가 없어 신규 recording 이벤트와 직접 대조 불가
배포 상태
미배포 가능성 — develop 병합만 확인, 당일 이슈 원인으로 연결 금지

주요 변경 파일: apps/web/features/monitor-recording/model/use-group-recording-session.ts · apps/web/lib/monitor-recording/recording-service.ts · apps/web/features/recording-viewer/ui/recording-viewer.tsx · apps/web/app/api/monitor-recordings/upload-url/route.ts · apps/socket/src/sfu-socket/handlers/monitoring-handlers.ts · 외 251개

#1318 fix: Deploy Staging이 recorder를 socket보다 먼저 배포한다

확인 필요 (GitHub API 504) · 2026-11-16 14:59:14 KST

변경 기능
배포/인프라 — Staging recorder 선배포 순서 보장
영향받을 수 있는 사용자 흐름
Staging 배포 → recorder 준비 → socket 배포
개선 기대
socket 전환 시 recorder 미준비 구간 감소
회귀 위험
recorder 실패가 전체 Staging 배포를 지연·차단 가능
확인할 로그·지표
workflow job 순서·recorder health·socket rollout
관련 테스트
deployment workflow policy와 staging options 테스트
당일 이슈 관련 가능성
Staging 전용으로 Prod 당일 수업 이슈 직접 관련 없음
배포 상태
Staging workflow 변경

주요 변경 파일: .github/workflows/deploy-recorder-staging.yml · .github/workflows/deploy-staging.yml · scripts/recorder-deploy-workflows.test.mjs · scripts/staging-workflow-options.test.py · docs/recording-recorder-staging.md · 외 1개

#1317 fix: Deploy Prod가 recorder를 socket보다 먼저 배포한다

확인 필요 (GitHub API 504) · 2026-11-16 10:58:09 KST

변경 기능
배포/인프라 · 수업 진행/완료/저장 — Prod recorder 선배포 순서 보장
영향받을 수 있는 사용자 흐름
Prod 배포 → recorder 준비 → socket/web rollout
개선 기대
녹취 backend 전환 시 recorder 미준비 구간 감소
회귀 위험
recorder 배포 실패가 후속 서비스 배포를 막거나 버전 호환 구간을 만들 수 있음
확인할 로그·지표
Prod workflow 순서, recorder health, recording start/finalize 성공률
관련 테스트
recorder deploy workflow·prod runtime wiring 테스트
당일 이슈 관련 가능성
당일 미병합 335건과 시간상 공존하지만 배포 시각·로그 직접 증거가 없어 원인 연결 금지
배포 상태
병합은 확인했으나 실제 Prod workflow 실행·완료 시각 확인 필요

주요 변경 파일: .github/workflows/deploy-recorder-prod.yml · .github/workflows/deploy-web-prod.yml · scripts/recorder-deploy-workflows.test.mjs · scripts/ppi-server-actions-wiring.test.mjs · scripts/prod-runtime-env-wiring.test.mjs