feat(web, server): 실시간 회의 구현

[hyesngy]

작업내용

실시간 회의를 LiveKit SFU에서 P2P WebRTC mesh로 직접 구현하고, 그에 따라 사라진 녹음을 자막 기반 분석으로 대체합니다. 2026-08-09 회의 결정(docs/decisions/2026-08.md)의 "실시간 회의는 LiveKit 대신 RTC를 직접 구현한다" 항목입니다.

LiveKit은 미디어 전송뿐 아니라 녹음(Egress) 도 담당하고 있었고, 그 녹음 파일이 AI 요약 → 결정사항 파이프라인의 입력이었습니다. 그래서 RTC 교체만으로 끝나지 않고 서버 분석 경로까지 함께 바꿉니다.

1. RTC 직접 구현 (web)
2. 자막 영속화 (server)
3. 분석 경로 분기 (server)
4. LiveKit 제거

포함된 영역

• FE
• BE
• AI
• docs
• infra
• 직접 작성 → DB 마이그레이션 (V2__drop_meeting_audio_egress_id.sql, mock.sql 동반 수정)

예측 (작업 초기 PR 생성 시 작성)

• 예상 소요: 1주일
• 막힐 것 같은 곳:
  • RTC를 직접 구현
  • LiveKit을 걷어내면 녹음도 같이 사라지는데, 그 녹음이 결정사항 파이프라인의 입력이라 어디까지 번질지 모르겠음
• 전문 밖 영역 중 걱정되는 것:
  • 서버 분석 로직
  • Flyway 마이그레이션

결과 (머지 전 작성)

• 실제 소요: 1주일
• 실제로 막힌 곳:
  • 시그널링은 이미 서버에 있었음. MeetingMessageType에 OFFER/ANSWER/ICE와 forwardSignal이 구현돼 있어서 예상보다 RTC 작업이 가벼웠음
  • audioKey로 분기하려다 실패. 회의 생성 시점에 buildRecordingKey로 무조건 채워져서 녹음 여부와 무관하게 항상 non-null. 실제 판정자는 MeetingAudioKeyResolver.resolvePlayableAudioKey(S3 존재 확인)였음
  • persistMeetingAnalysis를 그냥 재사용했으면 자막이 전멸했음. 세그먼트가 비면 getDialogues().clear()만 실행되고 orphanRemoval=true라 저장해둔 회의록이 전부 DELETE됨 → replaceDialogues 플래그로 분리
  • LiveKit이 admin API에도 물려 있었음. /admin/livekit/rooms 계열 3개 엔드포인트와 DTO 5개. 계획에 없던 범위였고 함께 정리함
  • TranscribeSegment의 speaker·is_final이 FastAPI 필수 필드인데 서버 DTO엔 speaker가 없어서, Dialogue에서 재구성할 때 채워 넣어야 했음 (누락 시 조용히 422)
  • spotless가 ratchetFrom origin/main이라 건드린 파일이 통째로 재포맷됨. MeetingSocketHandler의 기존 와일드카드 import를 spotless가 못 펴서 수동으로 확장함 → diff가 실제 변경보다 크게 보입니다
• 배운 것:
  • 기존 코드에 이미 있는 걸 먼저 확인하지 않으면 서버를 새로 만들 뻔했음 (시그널링)
  • "필드가 채워져 있다"와 "실물이 있다"는 다름. audioKey 건이 딱 그 사례
  • JPA orphanRemoval이 걸린 컬렉션에 clear()가 있는 메서드는 재사용 전에 반드시 확인해야 함

리뷰 요청

준용 (server 가디언) — AGENTS.md "경계" 항목을 3개 건드렸습니다. 설계 확인 부탁드립니다.

1. MeetingAnalysisService.analyzeMeetingAudio를 오디오 없는 경로로 분기한 것 — 결정사항 대시보드에 영향이 갑니다
2. global/external/fast/dto/request/TranscriptSegmentPayload 추가 (기존 DTO 수정 없이 추가만)
3. application.yaml의 livekit 블록 제거 / Meeting.audioEgressId 필드 + 컬럼 DROP

인덱스 검토 근거 (체크리스트 항목): dialogue를 meeting_id로 조회하는 쿼리를 새로 추가했습니다. V1에 fk_dialogue_meeting FK가 걸려 있고 InnoDB가 FK 컬럼에 인덱스를 자동 생성하므로 별도 인덱스는 추가하지 않았습니다. ORDER BY speech_datetime, dialogue_id는 회의 하나 범위 내 정렬이라 회의당 발화 수 규모에서 filesort 비용이 문제되지 않는다고 판단했습니다.

메모

아직 검증 안 된 것 (머지 전 필요)

1. 두 창에서 입장 → 한쪽에서 말했을 때 반대쪽에서 소리가 들리는지 (RTC 성공 판정)
2. 말하는 쪽 타일에 발화 표시가 뜨는지
3. 말하는 도중 dialogue 테이블에 행이 실시간으로 쌓이는지
4. 서버 강제 종료 후 재기동 → 쌓인 자막이 남아 있는지
5. 회의 종료 → 오디오 대기 60초가 없어졌는지, 요약·결정사항이 생성되는지
6. 분석 후에도 dialogue 행이 지워지지 않았는지 ← 이번 변경에서 가장 깨지기 쉬운 지점

• 이번에 정해진 것(녹음 포기, 이번 사이클 회의 범위)은 docs/decisions/에 아직 안 썼습니다. 회의에서 확정된 것만 기록하는 규칙이라, 다음 회의에서 확정 후 추가하겠습니다

범위 밖 — 별도 이슈 제안

• analysis-test 엔드포인트가 프로덕션 컨트롤러에 노출돼 회의 참여자 누구나 임의 JSON으로 Decision/Application/Dialogue를 덮어쓸 수 있습니다 (MeetingController) — 보안 이슈
• replaceApplications가 삭제 후 재삽입이라 재분석마다 applicationId가 바뀌어 ChromaDB 임베딩·커밋 매칭과 어긋납니다
• MeetingLiveMessageRepository에 상한·TTL이 없어 메모리가 계속 쌓입니다

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
whylog	Ready	Preview	Aug 21, 2026 9:28am

[whylog-dev]

WhyLog AI 리뷰

결과: ✅ 차단 항목 없음 · 모델: Google gemini-3.6-flash

실시간 회의 방식을 LiveKit SFU에서 P2P WebRTC mesh로 전환하고, 오디오 녹음 없이 실시간 자막(Dialogue)으로 회의를 분석하는 파이프라인을 구현했습니다. 관련 LiveKit 코드 정리 및 DB 마이그레이션(V2), mock 데이터 수정이 충실히 포함되었으며 차단 항목은 없습니다.

PR 리뷰 문서: docs/pr-reviews/PR-16.md 서명·부모 SHA·입력 digest 확인 · 이전 판단 유지

차단

없음

제안

없음

_{이 코멘트는 새 실행 때 갱신됩니다. 차단 항목은 사람이 타당성을 확인한 뒤 수정하세요.}