mirror of
https://github.com/hwanny1128/HGZero.git
synced 2025-12-06 19:36:23 +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>
141 lines
3.6 KiB
Plaintext
141 lines
3.6 KiB
Plaintext
@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: 예정된 회의 조회
|
|
activate DB
|
|
DB --> MeetingRepo: 예정된 회의 목록
|
|
deactivate DB
|
|
MeetingRepo --> Service: List<Meeting>
|
|
deactivate MeetingRepo
|
|
|
|
' 진행 중 Todo 조회
|
|
Service -> TodoRepo: findActiveTodos(userId)
|
|
activate TodoRepo
|
|
TodoRepo -> DB: 진행 중 Todo 조회
|
|
activate DB
|
|
DB --> TodoRepo: 진행 중 Todo 목록
|
|
deactivate DB
|
|
TodoRepo --> Service: List<Todo>
|
|
deactivate TodoRepo
|
|
|
|
' 최근 회의록 조회
|
|
Service -> MinutesRepo: findRecentMinutes(userId)
|
|
activate MinutesRepo
|
|
MinutesRepo -> DB: 최근 회의록 조회
|
|
activate DB
|
|
DB --> MinutesRepo: 최근 회의록 목록
|
|
deactivate DB
|
|
MinutesRepo --> Service: List<Minutes>
|
|
deactivate MinutesRepo
|
|
|
|
' 공유받은 회의록 조회
|
|
Service -> MinutesRepo: findSharedMinutes(userId)
|
|
activate MinutesRepo
|
|
MinutesRepo -> DB: 공유받은 회의록 조회
|
|
activate DB
|
|
DB --> MinutesRepo: 공유받은 회의록 목록
|
|
deactivate DB
|
|
MinutesRepo --> Service: List<Minutes>
|
|
deactivate MinutesRepo
|
|
|
|
' 통계 정보 조회
|
|
Service -> MeetingRepo: countUpcomingMeetings(userId)
|
|
activate MeetingRepo
|
|
MeetingRepo -> DB: 예정된 회의 개수 조회
|
|
activate DB
|
|
DB --> MeetingRepo: 예정된 회의 개수
|
|
deactivate DB
|
|
MeetingRepo --> Service: int count
|
|
deactivate MeetingRepo
|
|
|
|
Service -> TodoRepo: countActiveTodos(userId)
|
|
activate TodoRepo
|
|
TodoRepo -> DB: 진행 중 Todo 개수 조회
|
|
activate DB
|
|
DB --> TodoRepo: 진행 중 Todo 개수
|
|
deactivate DB
|
|
TodoRepo --> Service: int count
|
|
deactivate TodoRepo
|
|
|
|
Service -> TodoRepo: calculateTodoCompletionRate(userId)
|
|
activate TodoRepo
|
|
TodoRepo -> DB: Todo 완료율 조회
|
|
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
|