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

주요 변경사항:

[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
@@ -21,7 +21,7 @@ activate Service
Service -> Repository: findById(meetingId)
activate Repository
Repository -> DB: SELECT * FROM meetings WHERE id = ?
Repository -> DB: 회의 정보 조회\n(회의ID 기준)
activate DB
DB --> Repository: meeting_row
deactivate DB
@@ -67,15 +67,20 @@ alt validation passed
Service -> Repository: save(meeting)
activate Repository
Repository -> DB: UPDATE meetings SET status = 'VALIDATED'
Repository -> DB: 회의 상태 업데이트\n(상태='검증완료')
activate DB
DB --> Repository: affected_rows
deactivate DB
Repository --> Service: savedMeeting
deactivate Repository
Service -> Cache: set(meeting:{id}, meetingData)
Service -> Cache: SET meeting:{id}\n(TTL: 10분)
activate Cache
note right of Cache
회의 정보 캐싱:
- TTL: 10분
- 자동 만료
end note
Cache --> Service: OK
deactivate Cache
@@ -89,7 +94,19 @@ alt validation passed
Service --> Controller: success response
else validation failed
Service --> Controller: error response with details
Service --> Controller: 400 Bad Request
note right
에러 응답 형식:
{
"error": {
"code": "VALIDATION_FAILED",
"message": "회의록 검증에 실패했습니다",
"details": "필수 항목 누락 또는 형식 오류",
"timestamp": "2025-10-23T12:00:00Z",
"path": "/api/meetings/{id}/validate"
}
}
end note
end
deactivate Service