Fix: 실시간 회의 기능 완성도 개선

[ggamnunq]

🎯 작업 내용

주요 변경사항

• 실시간 회의(WebSocket + LiveKit SFU) 연동 구조를 정리하고, 중복 참여 및 실패 케이스 처리를 보강했습니다.
• 관리자용 LiveKit/회의방 조회 및 강제 종료 API를 추가했습니다.
• 서버 비정상 종료 후 재기동 시 종료되지 않은 회의들을 일괄 종료 처리하도록 보정했습니다.
• API/메서드 호출 로깅 AOP를 도입하고, Swagger UI 인증 토큰이 새로고침 후에도 유지되도록 설정했습니다.
• 응답/저장 시간대 기준을 한국시간(Asia/Seoul)으로 통일했습니다.

상세 내용

• 실시간 회의 연동

  • 회의 생성 후 WebSocket 및 LiveKit SFU 연결 흐름을 정리했습니다.
  • WebSocket 입장 시 참가자 roster, join/leave, transcript 메시지를 주고받도록 구성했습니다.
  • 동일 member의 실시간 중복 참여는 WebSocket 단계에서 error_participant_already_joined 메시지로 처리하도록 변경했습니다.
  • rtc-token 발급 단계에서는 중복 참여 차단을 제거해, 회의 진입 흐름이 불필요하게 409로 막히지 않도록 조정했습니다.
  • 회의 참여 실패 케이스와 응답 방식을 문서화했습니다.

• 관리자용 회의/LiveKit API

  • 열린 LiveKit room 목록 조회 API를 추가했습니다.
  • 특정 room의 participant 목록 조회 API를 추가했습니다.
  • room 삭제 API와 participant 강제 제거 API를 추가했습니다.
  • meetingId 기준 웹소켓 세션 조회 API를 추가했습니다.

• 회의 종료 및 복구

  • 마지막 참가자가 나가면 회의가 자동 종료되도록 처리했습니다.
  • 서버가 비정상 종료된 뒤 재기동될 때 endDateTime == null인 회의는 시작 시점에 현재 시간으로 종료 처리되도록 보정했습니다.

• 시간대 처리

  • 서버 저장/응답 기준 시간을 한국시간(Asia/Seoul)으로 통일했습니다.
  • KoreaDateTimeUtil은 제거하고 설정 기반으로 단순화했습니다.

• 로깅 및 문서화

  • @RestController API 호출에 대해 시작/종료 로그를 남기는 AOP를 추가했습니다.
  • 메서드 레벨 로그용 @LogExecution 커스텀 어노테이션과 별도 pointcut/aspect/writer 구조를 도입했습니다.
  • 로그 메시지는 enum으로 분리해 관리성을 높였습니다.

• Swagger

  • Swagger UI에서 인증 토큰을 새로고침 후에도 유지하도록 persist-authorization을 활성화했습니다.

✅ 체크리스트

• 코드 빌드가 정상적으로 완료되었나요?
• 코드 리뷰 요청 전 self-review를 진행했나요?

📋 API 명세서

💬 리뷰 요청사항 (선택)

📚 참고 자료 (선택)

[Yujin1219]

확인했습니다 수고하셨습니다!! 👍 💯