mirror of
https://github.com/hwanny1128/HGZero.git
synced 2026-06-13 16:29:11 +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:
@@ -29,7 +29,7 @@ activate Service
|
||||
' Todo 정보 조회
|
||||
Service -> TodoRepo: findById(todoId)
|
||||
activate TodoRepo
|
||||
TodoRepo -> DB: SELECT * FROM todos WHERE id = ?
|
||||
TodoRepo -> DB: Todo 정보 조회
|
||||
activate DB
|
||||
DB --> TodoRepo: Todo 정보
|
||||
deactivate DB
|
||||
@@ -49,10 +49,34 @@ Service -> Service: 완료 권한 검증\n(담당자만 가능)
|
||||
|
||||
alt 권한 없음
|
||||
Service --> Controller: 403 Forbidden\n담당자만 완료 가능
|
||||
note right
|
||||
에러 응답 형식:
|
||||
{
|
||||
"error": {
|
||||
"code": "INSUFFICIENT_PERMISSION",
|
||||
"message": "Todo 완료 권한이 없습니다",
|
||||
"details": "담당자만 Todo를 완료할 수 있습니다",
|
||||
"timestamp": "2025-10-23T12:00:00Z",
|
||||
"path": "/api/todos/{todoId}/complete"
|
||||
}
|
||||
}
|
||||
end note
|
||||
return 403 Forbidden
|
||||
else 권한 있음
|
||||
alt Todo가 이미 완료됨
|
||||
Service --> Controller: 409 Conflict\n이미 완료된 Todo
|
||||
note right
|
||||
에러 응답 형식:
|
||||
{
|
||||
"error": {
|
||||
"code": "TODO_ALREADY_COMPLETED",
|
||||
"message": "이미 완료된 Todo입니다",
|
||||
"details": "해당 Todo는 이미 완료 처리되었습니다",
|
||||
"timestamp": "2025-10-23T12:00:00Z",
|
||||
"path": "/api/todos/{todoId}/complete"
|
||||
}
|
||||
}
|
||||
end note
|
||||
return 409 Conflict
|
||||
else 완료 처리 가능
|
||||
' 완료 확인 다이얼로그 (프론트엔드에서 처리됨)
|
||||
@@ -60,7 +84,7 @@ else 권한 있음
|
||||
' Todo 완료 처리
|
||||
Service -> TodoRepo: markAsCompleted(todoId, userId)
|
||||
activate TodoRepo
|
||||
TodoRepo -> DB: UPDATE todos\nSET status = 'COMPLETED',\n completedAt = NOW(),\n completedBy = ?\nWHERE id = ?
|
||||
TodoRepo -> DB: Todo 완료 상태 업데이트
|
||||
activate DB
|
||||
DB --> TodoRepo: 업데이트 완료
|
||||
deactivate DB
|
||||
@@ -77,7 +101,7 @@ else 권한 있음
|
||||
' 회의록 섹션 업데이트
|
||||
Service -> MinutesRepo: updateTodoStatus(todoId, "COMPLETED")
|
||||
activate MinutesRepo
|
||||
MinutesRepo -> DB: UPDATE minutes_sections\nSET todoStatuses = JSON_SET(todoStatuses,\n CONCAT('$."', ?, '"'),\n JSON_OBJECT(\n 'status', 'COMPLETED',\n 'completedAt', NOW(),\n 'completedBy', ?\n )\n)\nWHERE JSON_CONTAINS(todoIds, CAST(? AS JSON))
|
||||
MinutesRepo -> DB: 회의록 섹션의 Todo 상태 업데이트
|
||||
activate DB
|
||||
DB --> MinutesRepo: 업데이트 완료
|
||||
deactivate DB
|
||||
@@ -87,7 +111,7 @@ else 권한 있음
|
||||
' 회의록의 모든 Todo 완료 여부 확인
|
||||
Service -> TodoRepo: countPendingTodos(minutesId)
|
||||
activate TodoRepo
|
||||
TodoRepo -> DB: SELECT COUNT(*) FROM todos\nWHERE minutesId = ?\nAND status != 'COMPLETED'
|
||||
TodoRepo -> DB: 미완료 Todo 개수 조회
|
||||
activate DB
|
||||
DB --> TodoRepo: 미완료 Todo 개수
|
||||
deactivate DB
|
||||
|
||||
Reference in New Issue
Block a user