mirror of
https://github.com/hwanny1128/HGZero.git
synced 2025-12-06 14:56: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>
119 lines
3.0 KiB
Plaintext
119 lines
3.0 KiB
Plaintext
@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
|