@startuml
!theme mono

title 최종 회의록 확정 내부 시퀀스

participant "API Gateway<<E>>" as Gateway
participant "MinutesController" as Controller
participant "MeetingService" as Service
participant "Meeting" as Domain
participant "TranscriptService" as TranscriptService
participant "MeetingRepository" as Repository
database "PostgreSQL<<E>>" as DB
database "Redis Cache<<E>>" as Cache
queue "Event Hub<<E>>" as EventHub

Gateway -> Controller: POST /api/minutes/{minutesId}/finalize
activate Controller

Controller -> Service: confirmTranscript(meetingId)
activate Service

Service -> Repository: findById(meetingId)
activate Repository
Repository -> DB: 회의 정보 조회\n(회의ID 기준)
activate DB
DB --> Repository: meeting_row
deactivate DB
Repository --> Service: Meeting entity
deactivate Repository

Service -> Domain: confirmTranscript()
activate Domain

Domain -> Domain: validateCanConfirm()
note right of Domain
회의록 확정 검증 규칙:

1. 상태 검증:
   - 회의 상태 = COMPLETED (종료됨)
   - 회의록 상태 = DRAFT (작성중)
   ✗ IN_PROGRESS → 400 Bad Request

2. 권한 검증:
   - 확정 요청자 = 회의 생성자 OR
   - 확정 요청자 ∈ 참석자 목록
   ✗ 권한 없음 → 403 Forbidden

3. 필수 항목 검증:
   - 회의록 제목: NOT NULL, 길이 >= 5
   - 참석자 목록: 최소 1명 이상
   - 주요 논의 내용: NOT NULL, 길이 >= 20
   - 결정 사항: 최소 1개 이상 OR
     "결정사항 없음" 명시적 표시
   ✗ 누락 → 400 Bad Request
     (누락 항목 목록 반환)

4. 데이터 무결성:
   - 섹션별 내용 완결성 확인
   - 참조 링크 유효성 확인
   - 첨부 파일 접근 가능 여부
   ✗ 무결성 위반 → 400 Bad Request

5. 이력 검증:
   - 마지막 수정 후 24시간 경과 경고
   - 미승인 AI 제안 존재 시 알림
   ⚠️ 경고만 표시, 진행 가능
end note

Domain -> Domain: changeStatus(CONFIRMED)

Domain --> Service: updated Meeting
deactivate Domain

Service -> TranscriptService: lockTranscript(meetingId)
activate TranscriptService
note right of TranscriptService
회의록 잠금:
- 더 이상 수정 불가
- 버전 고정
end note
TranscriptService --> Service: lockedTranscript
deactivate TranscriptService

Service -> Repository: save(meeting)
activate Repository
Repository -> DB: 회의 상태 업데이트\n(상태='확정', 확정일시)
activate DB
DB --> Repository: affected_rows
deactivate DB
Repository --> Service: savedMeeting
deactivate Repository

Service -> Cache: SET meeting:{id}\n(TTL: 10분)
activate Cache
note right of Cache
  회의 정보 캐싱:
  - TTL: 10분
  - 자동 만료
end note
Cache --> Service: OK
deactivate Cache

Service ->> EventHub: publish(MinutesFinalized)
activate EventHub
note right of EventHub
비동기 이벤트:
- 참석자에게 최종본 알림
- 공유 서비스로 전송
end note
deactivate EventHub

Service --> Controller: MeetingResponse
deactivate Service

Controller --> Gateway: 200 OK
deactivate Controller

@enduml
