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

주요 변경사항:

[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
@@ -27,7 +27,7 @@ activate Service
Service -> Repository: checkDuplicateNotification(eventId)
activate Repository
Repository -> DB: SELECT * FROM notifications\nWHERE event_id = ?
Repository -> DB: 알림 중복 확인 조회\n(이벤트ID 기준)
note right
중복 발송 방지:
- Event ID 기반
@@ -58,7 +58,7 @@ else 신규 이벤트
Service -> Repository: getUserPreferences(userId)
activate Repository
Repository -> DB: SELECT * FROM user_notification_prefs\nWHERE user_id = ?
Repository -> DB: 사용자 알림 설정 조회\n(사용자ID 기준)
note right
사용자 설정 확인:
- 알림 채널 (email/sms)
@@ -139,7 +139,7 @@ else 신규 이벤트
Service -> Repository: saveNotificationLog(notification)
activate Repository
Repository -> DB: INSERT INTO notifications\n(event_id, user_id, type, channel, status, sent_at)
Repository -> DB: 알림 이력 저장\n(이벤트ID, 사용자ID, 유형, 채널, 상태, 발송일시)
note right
알림 로그 저장:
- 발송 이력
@@ -152,7 +152,7 @@ else 신규 이벤트
Service -> Repository: updateUserActivity(userId, "NOTIFICATION_SENT")
activate Repository
Repository -> DB: INSERT INTO user_activities\n(user_id, activity_type, details)
Repository -> DB: 사용자 활동 이력 저장\n(사용자ID, 활동유형, 상세내용)
DB --> Repository: saved
Repository --> Service: updated
deactivate Repository