mirror of
https://github.com/hwanny1128/HGZero.git
synced 2025-12-06 10:16:24 +00:00
715add4dbc
주요 변경사항:
[Critical]
- API 엔드포인트 통일: POST /api/minutes/{minutesId}/finalize
- 이벤트 이름 표준화: MinutesFinalized
[Warning]
- API Gateway 라우팅 규칙 문서화 (외부 시퀀스 7개 파일)
- 대시보드 API 경로 통일: GET /api/dashboard
- AI 제안 병합 프로세스 상세 문서화
- 회의록 확정 검증 로직 5단계 상세화
[Minor]
- Redis 캐시 TTL 명시 (7개 파일, TTL 정책 표준화)
- 대시보드 페이지네이션 파라미터 추가
- 에러 응답 포맷 표준화 (14개 에러 응답)
총 31개 파일 수정, 34건의 개선 사항 적용
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
88 lines
2.3 KiB
Plaintext
88 lines
2.3 KiB
Plaintext
@startuml
|
|
!theme mono
|
|
|
|
title STT Service - 음성녹음시작 내부 시퀀스
|
|
|
|
participant "RecordingController" as Controller
|
|
participant "RecordingService" as Service
|
|
participant "RecordingRepository" as Repository
|
|
participant "AzureSpeechClient" as AzureClient
|
|
database "STT DB" as DB
|
|
database "Azure Blob Storage<<E>>" as BlobStorage
|
|
queue "Azure Event Hubs<<E>>" as EventHub
|
|
|
|
== MeetingStarted 이벤트 수신 ==
|
|
|
|
EventHub -> Controller: MeetingStarted 이벤트 수신\n(meetingId, sessionId)
|
|
activate Controller
|
|
|
|
Controller -> Service: prepareRecording(meetingId, sessionId)
|
|
activate Service
|
|
|
|
Service -> Service: 녹음 세션 검증
|
|
note right
|
|
- 중복 녹음 방지 체크
|
|
- meetingId 유효성 검증
|
|
end note
|
|
|
|
Service -> Repository: createRecording(meetingId, sessionId)
|
|
activate Repository
|
|
|
|
Repository -> DB: 녹음 세션 생성\n(녹음ID, 회의ID, 세션ID, 상태, 생성일시)
|
|
activate DB
|
|
DB --> Repository: recordingId 반환
|
|
deactivate DB
|
|
|
|
Repository --> Service: RecordingEntity 반환
|
|
deactivate Repository
|
|
|
|
== Azure Speech Service 초기화 ==
|
|
|
|
Service -> AzureClient: initializeRecognizer(recordingId, sessionId)
|
|
activate AzureClient
|
|
|
|
AzureClient -> AzureClient: 음성 인식기 설정
|
|
note right
|
|
- 언어: ko-KR
|
|
- 샘플레이트: 16kHz
|
|
- 화자 식별 활성화
|
|
- 실시간 스트리밍 모드
|
|
end note
|
|
|
|
AzureClient -> BlobStorage: 녹음 파일 저장 경로 생성\n(path: recordings/{meetingId}/{sessionId}.wav)
|
|
activate BlobStorage
|
|
BlobStorage --> AzureClient: 저장 경로 URL 반환
|
|
deactivate BlobStorage
|
|
|
|
AzureClient --> Service: RecognizerConfig 반환
|
|
deactivate AzureClient
|
|
|
|
== 녹음 상태 업데이트 ==
|
|
|
|
Service -> Repository: updateRecordingStatus(recordingId, "RECORDING")
|
|
activate Repository
|
|
|
|
Repository -> DB: 녹음 상태 업데이트\n(상태='녹음중', 시작일시, 저장경로)
|
|
activate DB
|
|
DB --> Repository: 업데이트 완료
|
|
deactivate DB
|
|
|
|
Repository --> Service: 업데이트 완료
|
|
deactivate Repository
|
|
|
|
Service --> Controller: RecordingResponse(recordingId, status, storagePath)
|
|
deactivate Service
|
|
|
|
Controller --> EventHub: RecordingStarted 이벤트 발행\n(recordingId, meetingId, status)
|
|
deactivate Controller
|
|
|
|
note over Controller, EventHub
|
|
처리 시간:
|
|
- DB 녹음 생성: ~100ms
|
|
- Azure 인식기 초기화: ~500ms
|
|
- Blob 경로 생성: ~200ms
|
|
- 총 처리 시간: ~800ms
|
|
end note
|
|
|
|
@enduml
|