mirror of
https://github.com/hwanny1128/HGZero.git
synced 2026-06-13 17:39:09 +00:00
외부/내부 시퀀스 설계 일관성 개선 및 표준화
주요 변경사항:
[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:
@@ -35,6 +35,18 @@ alt Cache Hit
|
||||
|
||||
alt 권한 없음
|
||||
Service --> Controller: 403 Forbidden\n조회 권한 없음
|
||||
note right
|
||||
에러 응답 형식:
|
||||
{
|
||||
"error": {
|
||||
"code": "ACCESS_DENIED",
|
||||
"message": "조회 권한이 없습니다",
|
||||
"details": "회의록 조회 권한이 없는 사용자입니다",
|
||||
"timestamp": "2025-10-23T12:00:00Z",
|
||||
"path": "/api/minutes/{minutesId}"
|
||||
}
|
||||
}
|
||||
end note
|
||||
return 403 Forbidden
|
||||
else 권한 있음
|
||||
Service --> Controller: MinutesDetailResponse\n(캐시 데이터)
|
||||
@@ -44,7 +56,7 @@ else Cache Miss
|
||||
' 회의록 기본 정보 조회
|
||||
Service -> MinutesRepo: findByIdWithMeeting(minutesId)
|
||||
activate MinutesRepo
|
||||
MinutesRepo -> DB: SELECT m.*, mt.*\nFROM minutes m\nJOIN meetings mt ON m.meetingId = mt.id\nWHERE m.id = ?
|
||||
MinutesRepo -> DB: 회의록 및 회의 정보 조회
|
||||
activate DB
|
||||
DB --> MinutesRepo: 회의록 및 회의 정보
|
||||
deactivate DB
|
||||
@@ -65,7 +77,7 @@ else Cache Miss
|
||||
' 권한 확인
|
||||
Service -> MinutesRepo: hasAccessPermission(minutesId, userId)
|
||||
activate MinutesRepo
|
||||
MinutesRepo -> DB: SELECT COUNT(*) FROM (\n SELECT 1 FROM minutes WHERE id = ? AND creatorId = ?\n UNION\n SELECT 1 FROM participants p JOIN meetings m\n ON p.meetingId = m.id JOIN minutes mi\n ON mi.meetingId = m.id\n WHERE mi.id = ? AND p.userId = ?\n UNION\n SELECT 1 FROM shared_minutes\n WHERE minutesId = ? AND sharedWith = ?\n) AS access
|
||||
MinutesRepo -> DB: 회의록 조회 권한 확인
|
||||
activate DB
|
||||
DB --> MinutesRepo: 권한 확인 결과
|
||||
deactivate DB
|
||||
@@ -74,12 +86,24 @@ else Cache Miss
|
||||
|
||||
alt 권한 없음
|
||||
Service --> Controller: 403 Forbidden\n조회 권한 없음
|
||||
note right
|
||||
에러 응답 형식:
|
||||
{
|
||||
"error": {
|
||||
"code": "ACCESS_DENIED",
|
||||
"message": "조회 권한이 없습니다",
|
||||
"details": "회의록 조회 권한이 없는 사용자입니다",
|
||||
"timestamp": "2025-10-23T12:00:00Z",
|
||||
"path": "/api/minutes/{minutesId}"
|
||||
}
|
||||
}
|
||||
end note
|
||||
return 403 Forbidden
|
||||
else 권한 있음
|
||||
' 참석자 목록 조회
|
||||
Service -> MinutesRepo: findParticipants(minutesId)
|
||||
activate MinutesRepo
|
||||
MinutesRepo -> DB: SELECT p.*, u.name, u.email\nFROM participants p\nJOIN meetings m ON p.meetingId = m.id\nJOIN minutes mi ON mi.meetingId = m.id\nJOIN users u ON p.userId = u.id\nWHERE mi.id = ?
|
||||
MinutesRepo -> DB: 참석자 목록 조회
|
||||
activate DB
|
||||
DB --> MinutesRepo: 참석자 목록
|
||||
deactivate DB
|
||||
@@ -89,7 +113,7 @@ else Cache Miss
|
||||
' 섹션별 상세 내용 조회
|
||||
Service -> SectionRepo: findSectionsByMinutesId(minutesId)
|
||||
activate SectionRepo
|
||||
SectionRepo -> DB: SELECT * FROM minutes_sections\nWHERE minutesId = ?\nORDER BY sectionOrder
|
||||
SectionRepo -> DB: 섹션 목록 조회
|
||||
activate DB
|
||||
DB --> SectionRepo: 섹션 목록
|
||||
deactivate DB
|
||||
@@ -99,7 +123,7 @@ else Cache Miss
|
||||
' AI 요약 정보 조회
|
||||
Service -> SectionRepo: findAISummaries(minutesId)
|
||||
activate SectionRepo
|
||||
SectionRepo -> DB: SELECT * FROM ai_summaries\nWHERE minutesId = ?\nORDER BY sectionId
|
||||
SectionRepo -> DB: AI 요약 정보 조회
|
||||
activate DB
|
||||
DB --> SectionRepo: AI 요약 목록
|
||||
deactivate DB
|
||||
@@ -117,7 +141,7 @@ else Cache Miss
|
||||
- 최대 3개
|
||||
end note
|
||||
|
||||
RelatedService -> DB: SELECT * FROM related_minutes\nWHERE minutesId = ?\nAND similarityScore >= 0.7\nORDER BY similarityScore DESC\nLIMIT 3
|
||||
RelatedService -> DB: 관련 회의록 조회
|
||||
activate DB
|
||||
DB --> RelatedService: 관련 회의록 목록
|
||||
deactivate DB
|
||||
@@ -127,7 +151,7 @@ else Cache Miss
|
||||
' 조회 이력 기록
|
||||
Service -> MinutesRepo: recordViewHistory(minutesId, userId)
|
||||
activate MinutesRepo
|
||||
MinutesRepo -> DB: INSERT INTO view_history\n(minutesId, userId, viewedAt)\nVALUES (?, ?, NOW())
|
||||
MinutesRepo -> DB: 조회 이력 기록
|
||||
activate DB
|
||||
DB --> MinutesRepo: 기록 완료
|
||||
deactivate DB
|
||||
|
||||
Reference in New Issue
Block a user