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

주요 변경사항:

[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
@@ -42,7 +42,7 @@ Service -> Service: 회의 시간 유효성 검사
Service -> Repo: checkConflictingMeetings(userId, startTime, endTime)
activate Repo
Repo -> DB: SELECT COUNT(*) FROM meetings\nWHERE creatorId = ?\nAND status = 'SCHEDULED'\nAND (startTime <= ? AND endTime >= ?)
Repo -> DB: 중복 회의 확인
activate DB
DB --> Repo: 중복 회의 개수
deactivate DB
@@ -51,6 +51,18 @@ deactivate Repo
alt 중복 회의 존재
Service --> Controller: 409 Conflict\n중복된 회의 시간
note right
에러 응답 형식:
{
"error": {
"code": "MEETING_TIME_CONFLICT",
"message": "중복된 회의 시간이 존재합니다",
"details": "해당 시간대에 이미 예약된 회의가 있습니다",
"timestamp": "2025-10-23T12:00:00Z",
"path": "/api/meetings"
}
}
end note
return 409 Conflict
else 중복 없음
Service -> Service: Meeting 엔티티 생성\n- 회의 ID 생성\n- 상태: SCHEDULED\n- 생성자 정보 설정
@@ -58,7 +70,7 @@ else 중복 없음
' 회의 정보 저장
Service -> Repo: save(meeting)
activate Repo
Repo -> DB: INSERT INTO meetings\n(id, title, startTime, endTime,\nlocation, status, creatorId, createdAt)
Repo -> DB: 회의 정보 저장
activate DB
DB --> Repo: 회의 저장 완료
deactivate DB
@@ -68,7 +80,7 @@ else 중복 없음
' 참석자 저장
Service -> ParticipantRepo: saveAll(participants)
activate ParticipantRepo
ParticipantRepo -> DB: INSERT INTO participants\n(meetingId, email, role, status)
ParticipantRepo -> DB: 참석자 정보 저장
activate DB
DB --> ParticipantRepo: 참석자 저장 완료
deactivate DB