AI 제안사항 SSE 스트리밍 기능 구현 및 CORS 문제 해결

주요 변경사항:
- Event Hub 리스너를 Python AI Service에 통합하여 STT 텍스트 실시간 수신
- LocalDateTime 배열 형식을 Unix timestamp로 변환하는 로직 추가
- SSE 응답에 CORS 헤더 명시적 추가 (localhost:8888 허용)
- SSE Keep-alive를 위한 ping 이벤트 추가 (5초 주기)
- Redis 데이터 정리 스크립트 추가
- 분석 임계값을 MVP 수준으로 조정 (3개 세그먼트 = 약 15-30초)
- 프론트엔드 SSE 연동 가이드 문서 작성
- 프론트엔드에 ping 이벤트 핸들러 추가 및 에러 핸들링 개선

기술적 개선사항:
- EventSourceResponse에 Access-Control-Allow-Origin 헤더 추가
- timestamp 변환 로직으로 Java-Python 호환성 해결
- Redis 저장 오류 로깅 강화
- SSE generator에 주기적 heartbeat 전송으로 연결 유지

문서:
- develop/dev/ai-frontend-integration-guide.md: 프론트엔드 개발자를 위한 상세 연동 가이드

🤖 Generated with Claude Code

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
Minseo-Jo
2025-10-29 17:20:10 +09:00
parent 13eb213211
commit c664116cd2
7 changed files with 435 additions and 19 deletions
+27 -2
View File
@@ -1,5 +1,6 @@
"""AI 제안사항 SSE 엔드포인트"""
from fastapi import APIRouter
from fastapi import APIRouter, Response
from fastapi.responses import StreamingResponse
from sse_starlette.sse import EventSourceResponse
import logging
import asyncio
@@ -94,9 +95,16 @@ async def stream_ai_suggestions(meeting_id: str):
previous_count = 0
# Keep-alive를 위한 주석 전송
yield {
"event": "ping",
"data": "connected"
}
while True:
# 현재 세그먼트 개수 확인
current_count = await redis_service.get_segment_count(meeting_id)
logger.debug(f"세그먼트 카운트 - meetingId: {meeting_id}, count: {current_count}, prev: {previous_count}")
# 임계값 이상이고, 이전보다 증가했으면 분석
if (current_count >= settings.min_segments_for_analysis
@@ -106,6 +114,8 @@ async def stream_ai_suggestions(meeting_id: str):
accumulated_text = await redis_service.get_accumulated_text(meeting_id)
if accumulated_text:
logger.info(f"텍스트 누적 완료 - meetingId: {meeting_id}, 길이: {len(accumulated_text)}")
# Claude API로 분석
suggestions = await claude_service.analyze_suggestions(accumulated_text)
@@ -124,6 +134,12 @@ async def stream_ai_suggestions(meeting_id: str):
previous_count = current_count
# Keep-alive 주석 전송 (SSE 연결 유지)
yield {
"event": "ping",
"data": f"alive-{current_count}"
}
# 5초마다 체크
await asyncio.sleep(5)
@@ -138,7 +154,16 @@ async def stream_ai_suggestions(meeting_id: str):
finally:
await redis_service.disconnect()
return EventSourceResponse(event_generator())
# CORS 헤더를 포함한 EventSourceResponse 반환
return EventSourceResponse(
event_generator(),
headers={
"Cache-Control": "no-cache",
"X-Accel-Buffering": "no",
"Access-Control-Allow-Origin": "http://localhost:8888",
"Access-Control-Allow-Credentials": "true",
}
)
@router.get("/test")