외부/내부 시퀀스 설계 일관성 개선 및 표준화

주요 변경사항:

[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>
This commit is contained in:
ondal
2025-10-23 09:48:06 +09:00
parent f86973c93b
commit 715add4dbc
43 changed files with 505 additions and 156 deletions
@@ -30,7 +30,7 @@ Service -> Service: 회의 맥락 정보 조회 준비
par 회의 정보 조회
Service -> Repo: getMeetingContext(meetingId)
activate Repo
Repo -> DB: SELECT meeting_info
Repo -> DB: 회의 맥락 정보 조회
activate DB
DB --> Repo: 회의 정보 반환
deactivate DB
@@ -39,7 +39,7 @@ par 회의 정보 조회
else 이전 내용 조회
Service -> Repo: getPreviousTranscripts(meetingId)
activate Repo
Repo -> DB: SELECT previous_content
Repo -> DB: 이전 회의록 내용 조회
activate DB
DB --> Repo: 이전 회의록
deactivate DB
@@ -82,7 +82,7 @@ Service -> Service: 회의록 데이터 구조화
Service -> Repo: saveTranscriptDraft(meetingId, content)
activate Repo
Repo -> DB: INSERT INTO ai_transcripts
Repo -> DB: AI 회의록 초안 저장 (상태: DRAFT)
activate DB
note right
저장 데이터:
@@ -222,6 +222,30 @@ note right
* decisions: []
end note
note over Controller, DB
AI 제안 병합 프로세스:
1. 자동 병합 (Auto-merge):
- confidence >= 0.8인 결정사항
→ 회의록 "결정사항" 섹션에 자동 추가
- priority: HIGH인 논의사항
→ "추가 논의 필요" 섹션에 자동 반영
2. 사용자 검토 (User Review):
- 0.5 <= confidence < 0.8
→ 제안 목록에 표시, 사용자 승인 대기
- priority: MEDIUM/LOW
→ 선택적 반영 가능
3. 병합 시점:
- 실시간: 회의 진행 중 자동 반영
- 최종: 회의록 확정 전 사용자 최종 검토
4. 병합 이력:
- 제안 ID, 병합 여부, 승인자, 시각 기록
- 감사 추적(Audit Trail) 유지
end note
note over Controller, DB
처리 시간:
- 맥락 조회: 100-200ms