플러스프로젝트 배경
1) 예상 리스크 및 대응 계획 - FastAPI asyncio 이벤트 루프에서 다수 WebSocket 연결을 동시 처리할 때 블로킹 리스크가 있으며, async/await 일관 적용 및 anyio 태스크 그룹으로 대응할 계획입니다 - 화면 공유 전환 시 SDP 재협상이 필요하여 기존 연결이 잠시 중단될 리스크가 있으며, RTCRtpSender.replaceTrack()으로 재협상 없이 트랙을 교체하는 방
프로젝트 성과
FastAPI WebSocket Signaling 구현
Python FastAPI의 네이티브 WebSocket을 Signaling 서버로 활용하여 WebRTC offer/answer/ICE 교환 흐름을 설계합니다
방 전체 공유 타이머 동기화 설계
Redis 인메모리 타이머 상태와 WebSocket broadcast를 결합하여 참여자 전원이 동일한 포모도로 사이클을 공유하는 구조를 구현합니다
SQLAlchemy 비동기 ORM 적용
FastAPI 비동기 런타임과 SQLAlchemy 2.0 async 세션을 결합하여 DB 쿼리 블로킹 없는 요청 처리 구조를 설계합니다
음성·화상 선택적 미디어 스트림 제어 구현
MediaStreamTrack API로 카메라·마이크를 독립적으로 토글하며, 화면 공유 시 기존 영상 트랙과 동적으로 교체하는 로직을 구현합니다
방장 권한 미들웨어 설계
FastAPI Dependency Injection으로 방장 JWT 클레임을 검증하는 미들웨어를 구현하여 강퇴·뮤트 등 관리 API를 보호합니다
핵심 기능
스터디룸 탐색
공개 스터디룸 목록 탐색 및 입장
진행 단계
FastAPI WebSocket Signaling 서버 및 방 상태 관리 설계
2026.04
FastAPI 네이티브 WebSocket으로 Signaling 서버 구조 설계, 방 입장·퇴장 이벤트 처리 및 Redis 상태 저장 연동
프로젝트 상세
1) 포트폴리오 소개 교육 도메인에 WebRTC 음성·화상 기술을 적용한 실시간 온라인 스터디룸 플랫폼입니다. 스터디룸 생성·입장, 실시간 음성/화상 통신, 포모도로 타이머, 참여자 마이크 개별 제어 기능을 제공하여 비대면 학습 환경을 구축합니다. 2) 작업 범위 - 스터디룸 탐색: 공개 스터디룸 목록 탐색 및 입장 - 음성·화상 통신: WebRTC 기반 다자 음성·화상 스터디 세션 - 포모도로
