mirror of
https://github.com/hwanny1128/HGZero.git
synced 2025-12-07 00:16:24 +00:00
d55fcfc1bd
전체 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>
87 lines
2.0 KiB
Plaintext
87 lines
2.0 KiB
Plaintext
@startuml
|
|
!theme mono
|
|
|
|
title 최종 회의록 확정 내부 시퀀스
|
|
|
|
participant "API Gateway<<E>>" as Gateway
|
|
participant "MeetingController" as Controller
|
|
participant "MeetingService" as Service
|
|
participant "Meeting" as Domain
|
|
participant "TranscriptService" as TranscriptService
|
|
participant "MeetingRepository" as Repository
|
|
database "PostgreSQL<<E>>" as DB
|
|
database "Redis Cache<<E>>" as Cache
|
|
queue "Event Hub<<E>>" as EventHub
|
|
|
|
Gateway -> Controller: POST /api/meetings/{id}/confirm
|
|
activate Controller
|
|
|
|
Controller -> Service: confirmTranscript(meetingId)
|
|
activate Service
|
|
|
|
Service -> Repository: findById(meetingId)
|
|
activate Repository
|
|
Repository -> DB: SELECT * FROM meetings WHERE id = ?
|
|
activate DB
|
|
DB --> Repository: meeting_row
|
|
deactivate DB
|
|
Repository --> Service: Meeting entity
|
|
deactivate Repository
|
|
|
|
Service -> Domain: confirmTranscript()
|
|
activate Domain
|
|
|
|
Domain -> Domain: validateCanConfirm()
|
|
note right of Domain
|
|
도메인 규칙:
|
|
- COMPLETED 상태 검증
|
|
- 작성자 권한 검증
|
|
- 회의록 존재 여부 확인
|
|
end note
|
|
|
|
Domain -> Domain: changeStatus(CONFIRMED)
|
|
|
|
Domain --> Service: updated Meeting
|
|
deactivate Domain
|
|
|
|
Service -> TranscriptService: lockTranscript(meetingId)
|
|
activate TranscriptService
|
|
note right of TranscriptService
|
|
회의록 잠금:
|
|
- 더 이상 수정 불가
|
|
- 버전 고정
|
|
end note
|
|
TranscriptService --> Service: lockedTranscript
|
|
deactivate TranscriptService
|
|
|
|
Service -> Repository: save(meeting)
|
|
activate Repository
|
|
Repository -> DB: UPDATE meetings SET status = 'CONFIRMED', confirmed_at = ?
|
|
activate DB
|
|
DB --> Repository: affected_rows
|
|
deactivate DB
|
|
Repository --> Service: savedMeeting
|
|
deactivate Repository
|
|
|
|
Service -> Cache: set(meeting:{id}, meetingData)
|
|
activate Cache
|
|
Cache --> Service: OK
|
|
deactivate Cache
|
|
|
|
Service ->> EventHub: publish(TranscriptConfirmedEvent)
|
|
activate EventHub
|
|
note right of EventHub
|
|
비동기 이벤트:
|
|
- 참석자에게 최종본 알림
|
|
- 공유 서비스로 전송
|
|
end note
|
|
deactivate EventHub
|
|
|
|
Service --> Controller: MeetingResponse
|
|
deactivate Service
|
|
|
|
Controller --> Gateway: 200 OK
|
|
deactivate Controller
|
|
|
|
@enduml
|