hgzero/design/backend/sequence/inner/meeting-회의록공유.puml

@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: SELECT * FROM minutes WHERE id = ?
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확정된 회의록만 공유 가능
    return 400 Bad Request
else 공유 가능
    ' 공유 링크 생성
    Service -> Service: 고유 공유 링크 생성\n(UUID 기반 토큰)

    Service -> ShareRepo: createShareLink(minutesId, token, options)
    activate ShareRepo
    ShareRepo -> DB: INSERT INTO share_links\n(minutesId, token, permission,\nexpiresAt, requirePassword, passwordHash,\ncreatedBy, createdAt)
    activate DB
    DB --> ShareRepo: 링크 생성 완료
    deactivate DB
    ShareRepo --> Service: ShareLink
    deactivate ShareRepo

    ' 공유 대상 저장
    loop 각 공유 대상마다
        Service -> ShareRepo: addSharedUser(minutesId, userEmail, permission)
        activate ShareRepo
        ShareRepo -> DB: INSERT INTO shared_minutes\n(minutesId, sharedWith, permission,\nsharedBy, sharedAt)
        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

    ' 이벤트 발행
    Service -> EventHub: publish(MinutesShared)\n{\n  minutesId, shareLink,\n  sharedWith, permission,\n  sharedBy, nextMeetingEvent\n}
    activate EventHub
    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