mirror of
https://github.com/hwanny1128/HGZero.git
synced 2025-12-06 13:46: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>
111 lines
3.1 KiB
Plaintext
111 lines
3.1 KiB
Plaintext
@startuml
|
|
!theme mono
|
|
|
|
title 대시보드 조회 내부 시퀀스 (AFR-USER-020)
|
|
|
|
participant "API Gateway<<E>>" as Gateway
|
|
participant "UserController" as Controller
|
|
participant "DashboardService" as Service
|
|
participant "MeetingClient" as MeetingClient
|
|
participant "TodoClient" as TodoClient
|
|
participant "UserRepository" as Repository
|
|
database "PostgreSQL<<E>>" as DB
|
|
database "Redis Cache<<E>>" as Cache
|
|
|
|
Gateway -> Controller: GET /api/v1/dashboard\nAuthorization: Bearer {token}
|
|
activate Controller
|
|
|
|
Controller -> Service: getDashboard(userId)
|
|
activate Service
|
|
|
|
Service -> Cache: get("dashboard:" + userId)
|
|
note right
|
|
캐시 조회:
|
|
- Key: dashboard:{userId}
|
|
- TTL: 5분
|
|
end note
|
|
|
|
alt 캐시 존재
|
|
Cache --> Service: cached dashboard data
|
|
|
|
Service --> Controller: DashboardResponse
|
|
deactivate Service
|
|
|
|
Controller --> Gateway: 200 OK\n{dashboard data}
|
|
deactivate Controller
|
|
|
|
else 캐시 미존재
|
|
Cache --> Service: null
|
|
|
|
par 병렬 데이터 조회
|
|
Service -> MeetingClient: getUpcomingMeetings(userId)
|
|
activate MeetingClient
|
|
note right
|
|
Meeting Service API:
|
|
GET /api/v1/meetings/upcoming
|
|
- userId
|
|
- limit: 5
|
|
end note
|
|
MeetingClient --> Service: upcoming meetings
|
|
deactivate MeetingClient
|
|
else
|
|
Service -> TodoClient: getPendingTodos(userId)
|
|
activate TodoClient
|
|
note right
|
|
Todo Service API:
|
|
GET /api/v1/todos/pending
|
|
- userId
|
|
- limit: 10
|
|
end note
|
|
TodoClient --> Service: pending todos
|
|
deactivate TodoClient
|
|
else
|
|
Service -> Repository: getRecentActivities(userId)
|
|
activate Repository
|
|
Repository -> DB: SELECT * FROM user_activities\nWHERE user_id = ?\nORDER BY created_at DESC\nLIMIT 10
|
|
DB --> Repository: activities
|
|
Repository --> Service: recent activities
|
|
deactivate Repository
|
|
else
|
|
Service -> Repository: getUserStatistics(userId)
|
|
activate Repository
|
|
Repository -> DB: SELECT\n COUNT(DISTINCT meeting_id) as total_meetings,\n COUNT(DISTINCT todo_id) as total_todos,\n AVG(meeting_duration) as avg_duration\nFROM user_statistics\nWHERE user_id = ?
|
|
DB --> Repository: statistics
|
|
Repository --> Service: user statistics
|
|
deactivate Repository
|
|
end
|
|
|
|
Service -> Service: aggregateDashboardData()
|
|
note right
|
|
대시보드 데이터 구성:
|
|
- 예정된 회의 목록
|
|
- 미완료 할일 목록
|
|
- 최근 활동 내역
|
|
- 통계 정보
|
|
end note
|
|
|
|
Service -> Service: enrichWithMetadata()
|
|
note right
|
|
메타데이터 추가:
|
|
- 회의 참석자 수
|
|
- 할일 우선순위
|
|
- 활동 타입별 아이콘
|
|
end note
|
|
|
|
Service -> Cache: set("dashboard:" + userId, dashboardData, 300)
|
|
note right
|
|
캐시 저장:
|
|
- TTL: 5분 (300초)
|
|
- 자동 만료
|
|
end note
|
|
Cache --> Service: cached
|
|
|
|
Service --> Controller: DashboardResponse\n{meetings, todos, activities, stats}
|
|
deactivate Service
|
|
|
|
Controller --> Gateway: 200 OK\n{dashboard data}
|
|
deactivate Controller
|
|
end
|
|
|
|
@enduml
|