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:
@@ -40,7 +40,7 @@ activate Service
|
||||
' 회의록 정보 조회
|
||||
Service -> MinutesRepo: findById(minutesId)
|
||||
activate MinutesRepo
|
||||
MinutesRepo -> DB: SELECT * FROM minutes WHERE id = ?
|
||||
MinutesRepo -> DB: 회의록 정보 조회
|
||||
activate DB
|
||||
DB --> MinutesRepo: 회의록 정보
|
||||
deactivate DB
|
||||
@@ -61,6 +61,18 @@ Service -> Service: 수정 권한 검증\n(생성자만 가능)
|
||||
|
||||
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 권한 있음
|
||||
' 잠긴 섹션 확인
|
||||
@@ -77,12 +89,24 @@ else 권한 있음
|
||||
|
||||
alt 잠긴 섹션 수정 시도
|
||||
Service --> Controller: 400 Bad Request\n잠긴 섹션은 수정 불가
|
||||
note right
|
||||
에러 응답 형식:
|
||||
{
|
||||
"error": {
|
||||
"code": "SECTION_LOCKED",
|
||||
"message": "잠긴 섹션은 수정할 수 없습니다",
|
||||
"details": "해당 섹션은 잠금 상태로 수정이 제한됩니다",
|
||||
"timestamp": "2025-10-23T12:00:00Z",
|
||||
"path": "/api/minutes/{minutesId}"
|
||||
}
|
||||
}
|
||||
end note
|
||||
return 400 Bad Request
|
||||
else 수정 가능
|
||||
' 수정 이력 저장 (버전 관리)
|
||||
Service -> VersionService: createModificationHistory(minutesId, userId, changes)
|
||||
activate VersionService
|
||||
VersionService -> DB: INSERT INTO modification_history\n(minutesId, modifiedBy, modifiedAt,\nchangeType, oldValue, newValue)
|
||||
VersionService -> DB: 수정 이력 저장
|
||||
activate DB
|
||||
DB --> VersionService: 이력 저장 완료
|
||||
deactivate DB
|
||||
@@ -93,7 +117,7 @@ else 권한 있음
|
||||
alt 제목 변경됨
|
||||
Service -> MinutesRepo: updateTitle(minutesId, newTitle)
|
||||
activate MinutesRepo
|
||||
MinutesRepo -> DB: UPDATE minutes\nSET title = ?,\n updatedAt = NOW(),\n updatedBy = ?\nWHERE id = ?
|
||||
MinutesRepo -> DB: 회의록 제목 수정
|
||||
activate DB
|
||||
DB --> MinutesRepo: 업데이트 완료
|
||||
deactivate DB
|
||||
@@ -105,7 +129,7 @@ else 권한 있음
|
||||
loop 각 섹션마다
|
||||
Service -> SectionRepo: updateSection(sectionId, content, aiSummary)
|
||||
activate SectionRepo
|
||||
SectionRepo -> DB: UPDATE minutes_sections\nSET content = ?,\n aiSummary = ?,\n updatedAt = NOW(),\n updatedBy = ?\nWHERE id = ?
|
||||
SectionRepo -> DB: 섹션 내용 및 AI 요약 수정
|
||||
activate DB
|
||||
DB --> SectionRepo: 업데이트 완료
|
||||
deactivate DB
|
||||
@@ -117,7 +141,7 @@ else 권한 있음
|
||||
alt 확정된 회의록 수정
|
||||
Service -> MinutesRepo: updateStatus(minutesId, "DRAFT")
|
||||
activate MinutesRepo
|
||||
MinutesRepo -> DB: UPDATE minutes\nSET status = 'DRAFT'\nWHERE id = ?\nAND status = 'FINALIZED'
|
||||
MinutesRepo -> DB: 확정된 회의록을 다시 작성 중(DRAFT)으로 변경
|
||||
activate DB
|
||||
DB --> MinutesRepo: 업데이트 완료
|
||||
deactivate DB
|
||||
|
||||
Reference in New Issue
Block a user