mirror of
https://github.com/hwanny1128/HGZero.git
synced 2026-06-13 17:39:09 +00:00
내부 시퀀스 설계 완료
- 총 21개 PlantUML 파일 생성 (Meeting 10개, AI 6개, STT 2개, Notification 3개) - 서브 에이전트를 활용한 병렬 설계로 효율성 극대화 - 모든 시나리오는 유저스토리 및 외부 시퀀스와 1:1 매칭 - Controller → Service → Repository 계층 구조 명확히 표현 - Redis Cache, Azure Event Hubs 등 인프라 컴포넌트 표시 - 동기(→)/비동기(-->) 구분 명확 - 외부 참여자 <<E>> 표시 적용 - PlantUML 문법 검사 및 오류 수정 완료 (13개 파일 수정) - par/and 블록 문법 오류 수정 - return 형식 적용으로 참여자 없는 화살표 오류 해결 설계 특징: - 캐시 전략: Cache-Aside 패턴, TTL 관리, 즉시 무효화 - 비동기 처리: Azure Event Hubs 기반 이벤트 구독 - 실시간 협업: WebSocket 기반 동기화, 변경 델타 전송 - 데이터 일관성: 버전 관리, 양방향 연결, 트랜잭션 처리 추가 파일: - claude/sequence-inner-design.md: 내부시퀀스설계 가이드 - tools/check-plantuml.ps1: PlantUML 문법 검사 스크립트 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
@@ -0,0 +1,140 @@
|
||||
@startuml meeting-대시보드조회
|
||||
!theme mono
|
||||
|
||||
title Meeting Service - 대시보드조회 내부 시퀀스
|
||||
|
||||
participant "DashboardController" as Controller
|
||||
participant "DashboardService" as Service
|
||||
participant "MeetingRepository" as MeetingRepo
|
||||
participant "TodoRepository" as TodoRepo
|
||||
participant "MinutesRepository" as MinutesRepo
|
||||
database "Redis Cache<<E>>" as Cache
|
||||
database "Meeting DB<<E>>" as DB
|
||||
|
||||
[-> Controller: GET /dashboard
|
||||
activate Controller
|
||||
|
||||
note over Controller
|
||||
사용자 정보는 헤더에서 추출
|
||||
(userId, userName, email)
|
||||
end note
|
||||
|
||||
Controller -> Service: getDashboardData(userId)
|
||||
activate Service
|
||||
|
||||
' 캐시 조회
|
||||
Service -> Cache: GET dashboard:{userId}
|
||||
activate Cache
|
||||
Cache --> Service: 캐시 조회 결과
|
||||
deactivate Cache
|
||||
|
||||
alt Cache Hit
|
||||
Service --> Service: 캐시 데이터 반환
|
||||
else Cache Miss
|
||||
' 예정된 회의 조회
|
||||
Service -> MeetingRepo: findUpcomingMeetings(userId)
|
||||
activate MeetingRepo
|
||||
MeetingRepo -> DB: SELECT meetings\nWHERE userId = ? AND status = 'SCHEDULED'\nAND startTime > NOW()\nORDER BY startTime LIMIT 3
|
||||
activate DB
|
||||
DB --> MeetingRepo: 예정된 회의 목록
|
||||
deactivate DB
|
||||
MeetingRepo --> Service: List<Meeting>
|
||||
deactivate MeetingRepo
|
||||
|
||||
' 진행 중 Todo 조회
|
||||
Service -> TodoRepo: findActiveTodos(userId)
|
||||
activate TodoRepo
|
||||
TodoRepo -> DB: SELECT todos\nWHERE assignee = ? AND status = 'IN_PROGRESS'\nORDER BY dueDate LIMIT 3
|
||||
activate DB
|
||||
DB --> TodoRepo: 진행 중 Todo 목록
|
||||
deactivate DB
|
||||
TodoRepo --> Service: List<Todo>
|
||||
deactivate TodoRepo
|
||||
|
||||
' 최근 회의록 조회
|
||||
Service -> MinutesRepo: findRecentMinutes(userId)
|
||||
activate MinutesRepo
|
||||
MinutesRepo -> DB: SELECT minutes\nWHERE creatorId = ?\nORDER BY createdAt DESC LIMIT 3
|
||||
activate DB
|
||||
DB --> MinutesRepo: 최근 회의록 목록
|
||||
deactivate DB
|
||||
MinutesRepo --> Service: List<Minutes>
|
||||
deactivate MinutesRepo
|
||||
|
||||
' 공유받은 회의록 조회
|
||||
Service -> MinutesRepo: findSharedMinutes(userId)
|
||||
activate MinutesRepo
|
||||
MinutesRepo -> DB: SELECT minutes m JOIN shared_minutes sm\nON m.id = sm.minutesId\nWHERE sm.sharedWith = ?\nORDER BY sm.sharedAt DESC LIMIT 3
|
||||
activate DB
|
||||
DB --> MinutesRepo: 공유받은 회의록 목록
|
||||
deactivate DB
|
||||
MinutesRepo --> Service: List<Minutes>
|
||||
deactivate MinutesRepo
|
||||
|
||||
' 통계 정보 조회
|
||||
Service -> MeetingRepo: countUpcomingMeetings(userId)
|
||||
activate MeetingRepo
|
||||
MeetingRepo -> DB: SELECT COUNT(*)\nFROM meetings\nWHERE userId = ? AND status = 'SCHEDULED'
|
||||
activate DB
|
||||
DB --> MeetingRepo: 예정된 회의 개수
|
||||
deactivate DB
|
||||
MeetingRepo --> Service: int count
|
||||
deactivate MeetingRepo
|
||||
|
||||
Service -> TodoRepo: countActiveTodos(userId)
|
||||
activate TodoRepo
|
||||
TodoRepo -> DB: SELECT COUNT(*)\nFROM todos\nWHERE assignee = ? AND status = 'IN_PROGRESS'
|
||||
activate DB
|
||||
DB --> TodoRepo: 진행 중 Todo 개수
|
||||
deactivate DB
|
||||
TodoRepo --> Service: int count
|
||||
deactivate TodoRepo
|
||||
|
||||
Service -> TodoRepo: calculateTodoCompletionRate(userId)
|
||||
activate TodoRepo
|
||||
TodoRepo -> DB: SELECT\n (COUNT(CASE WHEN status='COMPLETED' THEN 1 END) * 100.0 /\n COUNT(*)) as rate\nFROM todos WHERE assignee = ?
|
||||
activate DB
|
||||
DB --> TodoRepo: Todo 완료율
|
||||
deactivate DB
|
||||
TodoRepo --> Service: double rate
|
||||
deactivate TodoRepo
|
||||
|
||||
note over Service
|
||||
비즈니스 로직:
|
||||
- 데이터 조합 및 정제
|
||||
- DTO 변환
|
||||
- 통계 계산
|
||||
end note
|
||||
|
||||
Service -> Service: 대시보드 데이터 조합
|
||||
|
||||
' 캐시 저장
|
||||
Service -> Cache: SET dashboard:{userId}\n(TTL: 5분)
|
||||
activate Cache
|
||||
Cache --> Service: 캐시 저장 완료
|
||||
deactivate Cache
|
||||
end
|
||||
|
||||
Service --> Controller: DashboardResponse
|
||||
deactivate Service
|
||||
|
||||
note over Controller
|
||||
응답 데이터 구조:
|
||||
{
|
||||
"upcomingMeetings": [...],
|
||||
"activeTodos": [...],
|
||||
"recentMinutes": [...],
|
||||
"sharedMinutes": [...],
|
||||
"statistics": {
|
||||
"upcomingMeetingsCount": n,
|
||||
"activeTodosCount": n,
|
||||
"todoCompletionRate": n
|
||||
}
|
||||
}
|
||||
end note
|
||||
|
||||
return 200 OK\nDashboardResponse
|
||||
|
||||
deactivate Controller
|
||||
|
||||
@enduml
|
||||
Reference in New Issue
Block a user