mirror of
https://github.com/hwanny1128/HGZero.git
synced 2025-12-06 13:46:24 +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>
133 lines
3.7 KiB
Plaintext
133 lines
3.7 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/dashboard?\npage=1&size=10&sort=createdAt,desc\nAuthorization: Bearer {token}
|
|
note right
|
|
페이지네이션 파라미터:
|
|
- page: 페이지 번호 (기본값: 1)
|
|
- size: 페이지 크기 (기본값: 10)
|
|
- sort: 정렬 기준 (기본값: createdAt,desc)
|
|
end note
|
|
activate Controller
|
|
|
|
Controller -> Service: getDashboard(userId, page, size, sort)
|
|
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\n{meetings, todos, activities, stats, pagination}
|
|
deactivate Service
|
|
|
|
Controller --> Gateway: 200 OK\n{dashboard data + pagination}
|
|
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: 최근 활동 내역 조회\n(사용자ID, 최신순 정렬, 10건)
|
|
DB --> Repository: activities
|
|
Repository --> Service: recent activities
|
|
deactivate Repository
|
|
else
|
|
Service -> Repository: getUserStatistics(userId)
|
|
activate Repository
|
|
Repository -> DB: 사용자 통계 조회\n(총 회의수, 총 할일수, 평균 회의시간)
|
|
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, pagination}
|
|
deactivate Service
|
|
|
|
Controller --> Gateway: 200 OK\n{dashboard data + pagination}
|
|
note right
|
|
응답 형식:
|
|
{
|
|
"upcomingMeetings": [...],
|
|
"activeTodos": [...],
|
|
"recentActivities": [...],
|
|
"statistics": {...},
|
|
"pagination": {
|
|
"page": 1,
|
|
"size": 10,
|
|
"totalElements": 45,
|
|
"totalPages": 5,
|
|
"hasNext": true
|
|
}
|
|
}
|
|
end note
|
|
deactivate Controller
|
|
end
|
|
|
|
@enduml
|