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

주요 변경사항:

[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
@@ -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