mirror of
https://github.com/hwanny1128/HGZero.git
synced 2026-06-13 16:29:11 +00:00
내부 시퀀스 설계 완료 (25개 시나리오)
전체 5개 마이크로서비스의 내부 처리 흐름을 상세히 설계 [추가된 파일] - Meeting Service: 6개 시나리오 (검증완료, 실시간수정동기화, 최종회의록확정, 충돌해결, 템플릿선택, 회의록목록조회) - STT Service: 2개 시나리오 (음성녹음인식, 텍스트변환) - User Service: 2개 시나리오 (사용자인증, 대시보드조회) - Notification Service: 1개 시나리오 (알림발송) [주요 설계 내용] - Clean Architecture 적용 (Controller → Service → Domain → Repository) - Cache-Aside 패턴 (Redis 기반 성능 최적화) - Event-Driven Architecture (Azure Event Hub) - Real-time Collaboration (WebSocket + OT 알고리즘) - RAG 기능 (맥락 기반 AI) [검증 결과] - PlantUML 문법 검증: 모든 파일 통과 ✅ - 유저스토리 매칭: 100% 일치 ✅ - 아키텍처 패턴 준수: 완료 ✅ [병렬 처리] - 서브 에이전트 3개로 병렬 작업 수행 - Meeting Service, AI Service, STT/User/Notification 동시 설계 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
@@ -0,0 +1,90 @@
|
||||
@startuml
|
||||
!theme mono
|
||||
|
||||
title 충돌 해결 내부 시퀀스
|
||||
|
||||
participant "WebSocket<<E>>" as WebSocket
|
||||
participant "CollaborationController" as Controller
|
||||
participant "CollaborationService" as Service
|
||||
participant "ConflictResolver" as Resolver
|
||||
participant "TranscriptService" as TranscriptService
|
||||
database "Redis Cache<<E>>" as Cache
|
||||
queue "Event Hub<<E>>" as EventHub
|
||||
|
||||
WebSocket -> Controller: onConflict(conflictData)
|
||||
activate Controller
|
||||
|
||||
Controller -> Service: resolveConflict(meetingId, conflictData)
|
||||
activate Service
|
||||
|
||||
Service -> Cache: get(meeting:{id}:conflicts)
|
||||
activate Cache
|
||||
note right of Cache
|
||||
충돌 목록 조회:
|
||||
- 발생 시간
|
||||
- 관련 사용자
|
||||
- 충돌 영역
|
||||
end note
|
||||
Cache --> Service: conflictList
|
||||
deactivate Cache
|
||||
|
||||
Service -> Resolver: analyzeConflict(conflictData)
|
||||
activate Resolver
|
||||
|
||||
Resolver -> Resolver: detectConflictType()
|
||||
note right of Resolver
|
||||
충돌 유형 분석:
|
||||
- 동일 위치 수정
|
||||
- 삭제-수정 충돌
|
||||
- 순서 변경 충돌
|
||||
end note
|
||||
|
||||
Resolver -> Resolver: applyStrategy()
|
||||
note right of Resolver
|
||||
해결 전략:
|
||||
- 자동 병합 (단순 충돌)
|
||||
- 최신 우선 (시간 기반)
|
||||
- 수동 해결 필요 (복잡)
|
||||
end note
|
||||
|
||||
Resolver --> Service: resolutionResult
|
||||
deactivate Resolver
|
||||
|
||||
alt auto-resolved
|
||||
Service -> TranscriptService: applyResolution(meetingId, resolution)
|
||||
activate TranscriptService
|
||||
TranscriptService --> Service: mergedContent
|
||||
deactivate TranscriptService
|
||||
|
||||
Service -> Cache: del(meeting:{id}:conflicts)
|
||||
activate Cache
|
||||
Cache --> Service: OK
|
||||
deactivate Cache
|
||||
|
||||
else manual-required
|
||||
Service -> Cache: set(meeting:{id}:conflicts, conflictData)
|
||||
activate Cache
|
||||
note right of Cache
|
||||
충돌 정보 저장
|
||||
수동 해결 대기
|
||||
end note
|
||||
Cache --> Service: OK
|
||||
deactivate Cache
|
||||
end
|
||||
|
||||
Service ->> EventHub: publish(ConflictResolvedEvent)
|
||||
activate EventHub
|
||||
note right of EventHub
|
||||
이벤트 발행:
|
||||
- 자동 해결: 동기화
|
||||
- 수동 필요: 알림
|
||||
end note
|
||||
deactivate EventHub
|
||||
|
||||
Service --> Controller: ResolutionResponse
|
||||
deactivate Service
|
||||
|
||||
Controller --> WebSocket: send(resolution)
|
||||
deactivate Controller
|
||||
|
||||
@enduml
|
||||
Reference in New Issue
Block a user