mirror of
https://github.com/hwanny1128/HGZero.git
synced 2026-06-13 05:59:11 +00:00
내외부 시퀀스 - 회의록 공유 제거
This commit is contained in:
cyjadela
@@ -6,14 +6,14 @@
|
||||
각 마이크로서비스의 내부 처리 흐름을 상세히 정의하여 개발 구현의 기준을 제공합니다.
|
||||
|
||||
### 범위
|
||||
본 문서는 5개 마이크로서비스의 총 25개 내부 시퀀스 다이어그램을 다룹니다.
|
||||
본 문서는 5개 마이크로서비스의 총 24개 내부 시퀀스 다이어그램을 다룹니다.
|
||||
|
||||
## 설계 완료 요약
|
||||
|
||||
✅ **전체 25개 내부 시퀀스 다이어그램 설계 완료**
|
||||
✅ **전체 24개 내부 시퀀스 다이어그램 설계 완료**
|
||||
|
||||
- Meeting Service: 14개 시나리오
|
||||
- AI Service: 6개 시나리오
|
||||
- Meeting Service: 13개 시나리오
|
||||
- AI Service: 6개 시나리오
|
||||
- STT Service: 2개 시나리오
|
||||
- User Service: 2개 시나리오
|
||||
- Notification Service: 1개 시나리오
|
||||
|
||||
@@ -1,169 +0,0 @@
|
||||
@startuml meeting-회의록공유
|
||||
!theme mono
|
||||
|
||||
title Meeting Service - 회의록공유 내부 시퀀스
|
||||
|
||||
participant "ShareController" as Controller
|
||||
participant "ShareService" as Service
|
||||
participant "MinutesRepository" as MinutesRepo
|
||||
participant "ShareRepository" as ShareRepo
|
||||
participant "CalendarService" as CalendarService
|
||||
database "Meeting DB<<E>>" as DB
|
||||
database "Redis Cache<<E>>" as Cache
|
||||
queue "Azure Event Hubs<<E>>" as EventHub
|
||||
|
||||
[-> Controller: POST /minutes/{minutesId}/share
|
||||
activate Controller
|
||||
|
||||
note over Controller
|
||||
경로 변수: minutesId
|
||||
요청 데이터:
|
||||
{
|
||||
"sharedWith": ["user1@example.com", "user2@example.com"],
|
||||
"permission": "READ_ONLY" | "COMMENT" | "EDIT",
|
||||
"shareMethod": "EMAIL" | "LINK",
|
||||
"linkOptions": {
|
||||
"expiresIn": 7, // days
|
||||
"requirePassword": true,
|
||||
"password": "..."
|
||||
}
|
||||
}
|
||||
사용자 정보: userId, userName, email
|
||||
end note
|
||||
|
||||
Controller -> Controller: 입력 검증\n- sharedWith 최소 1명\n- permission 유효성
|
||||
|
||||
Controller -> Service: shareMinutes(minutesId, request, userId)
|
||||
activate Service
|
||||
|
||||
' 회의록 정보 조회
|
||||
Service -> MinutesRepo: findById(minutesId)
|
||||
activate MinutesRepo
|
||||
MinutesRepo -> DB: 회의록 정보 조회
|
||||
activate DB
|
||||
DB --> MinutesRepo: 회의록 정보
|
||||
deactivate DB
|
||||
MinutesRepo --> Service: Minutes
|
||||
deactivate MinutesRepo
|
||||
|
||||
note over Service
|
||||
비즈니스 규칙 검증:
|
||||
- 회의록 존재 확인
|
||||
- 공유 권한 확인 (생성자만)
|
||||
- 회의록 상태 확인 (FINALIZED만 공유 가능)
|
||||
end note
|
||||
|
||||
Service -> Service: 회의록 존재 확인
|
||||
|
||||
Service -> Service: 공유 권한 검증\n(생성자만 가능)
|
||||
|
||||
Service -> Service: 회의록 상태 확인
|
||||
|
||||
alt 회의록이 확정되지 않음
|
||||
Service --> Controller: 400 Bad Request\n확정된 회의록만 공유 가능
|
||||
note right
|
||||
에러 응답 형식:
|
||||
{
|
||||
"error": {
|
||||
"code": "MINUTES_NOT_FINALIZED",
|
||||
"message": "확정된 회의록만 공유 가능합니다",
|
||||
"details": "회의록을 먼저 확정해 주세요",
|
||||
"timestamp": "2025-10-23T12:00:00Z",
|
||||
"path": "/api/minutes/{minutesId}/share"
|
||||
}
|
||||
}
|
||||
end note
|
||||
return 400 Bad Request
|
||||
else 공유 가능
|
||||
' 공유 링크 생성
|
||||
Service -> Service: 고유 공유 링크 생성\n(UUID 기반 토큰)
|
||||
|
||||
Service -> ShareRepo: createShareLink(minutesId, token, options)
|
||||
activate ShareRepo
|
||||
ShareRepo -> DB: 공유 링크 정보 저장
|
||||
activate DB
|
||||
DB --> ShareRepo: 링크 생성 완료
|
||||
deactivate DB
|
||||
ShareRepo --> Service: ShareLink
|
||||
deactivate ShareRepo
|
||||
|
||||
' 공유 대상 저장
|
||||
loop 각 공유 대상마다
|
||||
Service -> ShareRepo: addSharedUser(minutesId, userEmail, permission)
|
||||
activate ShareRepo
|
||||
ShareRepo -> DB: 공유 대상 정보 저장
|
||||
activate DB
|
||||
DB --> ShareRepo: 공유 정보 저장 완료
|
||||
deactivate DB
|
||||
ShareRepo --> Service: 저장 성공
|
||||
deactivate ShareRepo
|
||||
end
|
||||
|
||||
' 회의록에서 다음 회의 일정 언급 확인
|
||||
Service -> Service: 다음 회의 일정 추출\n(회의록 내용 분석)
|
||||
|
||||
alt 다음 회의 일정 언급됨
|
||||
Service -> CalendarService: createCalendarEvent(meetingInfo)
|
||||
activate CalendarService
|
||||
|
||||
note over CalendarService
|
||||
캘린더 이벤트 생성:
|
||||
- 제목: 다음 회의 제목
|
||||
- 일시: 추출된 일시
|
||||
- 참석자: 공유 대상자
|
||||
end note
|
||||
|
||||
CalendarService -> CalendarService: 캘린더 이벤트 생성
|
||||
CalendarService --> Service: 이벤트 ID
|
||||
deactivate CalendarService
|
||||
end
|
||||
|
||||
' 캐시 무효화
|
||||
Service -> Cache: DELETE minutes:detail:{minutesId}
|
||||
activate Cache
|
||||
Cache --> Service: 삭제 완료
|
||||
deactivate Cache
|
||||
|
||||
note over Service
|
||||
비동기 이벤트 발행:
|
||||
- 공유 대상자에게 이메일 발송
|
||||
- 캘린더 초대 발송 (일정 있는 경우)
|
||||
end note
|
||||
|
||||
' NotificationRequest 이벤트 발행
|
||||
Service -> EventHub: publish(NotificationRequest)\n{\n channel: EMAIL,\n recipients: sharedWith,\n message: "회의록 공유 안내",\n metadata: {\n minutesId, shareLink,\n permission, sharedBy,\n nextMeetingEvent\n }\n}
|
||||
activate EventHub
|
||||
note right
|
||||
Notification Service가 구독:
|
||||
- Consumer Group: notification-service-group
|
||||
- 공유 대상자에게 이메일 발송
|
||||
end note
|
||||
EventHub --> Service: 발행 완료
|
||||
deactivate EventHub
|
||||
|
||||
Service --> Controller: ShareResponse
|
||||
deactivate Service
|
||||
|
||||
note over Controller
|
||||
응답 데이터:
|
||||
{
|
||||
"minutesId": "uuid",
|
||||
"shareLink": "https://.../share/{token}",
|
||||
"sharedWith": [...],
|
||||
"permission": "READ_ONLY",
|
||||
"expiresAt": "2025-01-30T00:00:00",
|
||||
"sharedAt": "2025-01-23T16:30:00",
|
||||
"nextMeetingEvent": {
|
||||
"eventId": "...",
|
||||
"title": "...",
|
||||
"startTime": "..."
|
||||
}
|
||||
}
|
||||
end note
|
||||
|
||||
return 200 OK\nShareResponse
|
||||
end
|
||||
|
||||
deactivate Controller
|
||||
|
||||
@enduml
|
||||
@@ -131,7 +131,6 @@ else 확정 가능
|
||||
|
||||
note over Service
|
||||
비동기 처리:
|
||||
- 회의록 공유 가능 상태로 전환
|
||||
- 참석자에게 확정 알림
|
||||
end note
|
||||
|
||||
|
||||
Reference in New Issue
Block a user