#1298 [PPI-1392] feat: 녹취를 Go recorder로 옮긴다
- 변경 기능
- 수업 진행/완료/저장 · LiveKit/WebRTC · 배포/인프라 — mediasoup socket의 녹취 부하를 별도 Go recorder로 분리하고 UDP RTP 수신, gRPC 제어, active-active 처리, S3 산출물·원본 업로드, 로그 outbox를 추가
- 영향받을 수 있는 사용자 흐름
- 아동·AI 음성 producer 생성 → socket이 PlainTransport/RTP와 녹취 ID를 구성 → recorder 2대가 수신하고 한 노드가 finalize → mp3·captions·원본을 S3에 저장 → 웹 목록·삭제 API가 recorder 원본까지 정리하는 흐름
- 개선 기대
- socket의 ffmpeg·녹취 부하를 분리해 수업 signaling 안정성과 장애 격리를 높이고, 노드 이중화·재허락·재입장 인계 및 roomId/recordingId 연계 로그로 복구와 추적을 개선할 것으로 기대
- 회귀 위험
- recorder/SSM/UDP/gRPC 연결 또는 active-active finalizer 선택 실패 시 녹취 시작·종료·업로드 누락 가능. ffmpeg 5.1 타임라인 보정, Redis outbox, 재접속 인계, 웹 원본 삭제가 새 회귀 지점이며 prod 전환은 운영 설정과 별도 배포에 의존
- 확인할 로그·지표
- recording start/stop/finalize 결과, roomId+recordingId 로그, recorder gRPC 상태, REC_* 오류 코드, outbox backlog·sweeper, RTP packet/drop·disk 지표, mp3/captions/source S3 생성률과 녹취 삭제 실패율
- 관련 테스트
- recorder Go unit/integration/e2e·race/vet, socket recorder/legacy/shadow·HA fault·outbox·reentry 테스트, web session-log 삭제 테스트, 배포/환경 계약 테스트. PR 설명상 scripts 100개·Python 23개·Terraform 19개와 dev 실제 업로드·삭제 확인
- 당일 이슈 관련 가능성
- 당일 finalize 아카이브가 0건이고 미병합 272건이지만, 수업 로그 자체가 없어 이 PR과 직접 일치하는 logger prefix·이벤트·상태 전이를 대조할 수 없음. 병합 시각만으로 원인 연결 금지
- 배포 상태
- 미배포 가능성 — 17:40 KST develop 병합만 확인. prod recorder는 release workflow, SSM 키·IAM·노드 rollout 및 RECORDING_MODE 설정이 필요하므로 당일 이슈 원인으로 연결 금지
주요 변경 파일: apps/recorder/internal/session/manager.go · apps/socket/src/recording/recorderBackend.ts · apps/socket/src/recording/recordingService.ts · apps/web/app/api/session-logs/route.ts · .github/workflows/deploy-recorder-prod.yml · 외 274개