HUTAMS_AUDIO/docs/api_contract.md

WebSocket Events

모든 실시간 통신은 /api/v1/ws/live 엔드포인트에서 이뤄집니다.

1. stt_result: 오디오 변환 완료 즉시 발생.

   • Payload: Pydantic STTResponse JSON
   • 긴급도(urgency), 열번(train_number), 세그먼트 데이터 포함.

2. thread_updated: 병목이 걸리는 백그라운드 LLM 연산 처리 이후 보내지는 후행 이벤트.

   • Payload: {"action": "append|new", "record_id": num, "segment_id": num, "speaker": str}

3. context_discovered: 관제 전문 지식이 포함되어 있을 경우 딕셔너리 정보 반환.

   • Payload: contexts 배열 (키워드, 제목, 설명글 등)

REST API

1. GET /api/v1/segments/{segment_id}/audio: Opus 압축 오디오 재생 스트리밍
2. GET /api/v1/records: STT 변환 이력 목록 조회
3. GET /api/v1/segments/daily: 일자별 세그먼트 채팅뷰 커서 페이징 조회