mirror of
https://github.com/hwanny1128/HGZero.git
synced 2025-12-06 20:46:23 +00:00
715add4dbc
주요 변경사항:
[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>
118 lines
2.9 KiB
Plaintext
118 lines
2.9 KiB
Plaintext
@startuml
|
|
!theme mono
|
|
|
|
title 검증 완료 내부 시퀀스
|
|
|
|
participant "API Gateway<<E>>" as Gateway
|
|
participant "MeetingController" as Controller
|
|
participant "MeetingService" as Service
|
|
participant "Meeting" as Domain
|
|
participant "ValidationService" as ValidationService
|
|
participant "MeetingRepository" as Repository
|
|
database "PostgreSQL<<E>>" as DB
|
|
database "Redis Cache<<E>>" as Cache
|
|
queue "Event Hub<<E>>" as EventHub
|
|
|
|
Gateway -> Controller: POST /api/meetings/{id}/validate
|
|
activate Controller
|
|
|
|
Controller -> Service: validateMeeting(meetingId)
|
|
activate Service
|
|
|
|
Service -> Repository: findById(meetingId)
|
|
activate Repository
|
|
Repository -> DB: 회의 정보 조회\n(회의ID 기준)
|
|
activate DB
|
|
DB --> Repository: meeting_row
|
|
deactivate DB
|
|
Repository --> Service: Meeting entity
|
|
deactivate Repository
|
|
|
|
Service -> ValidationService: performValidation(meeting)
|
|
activate ValidationService
|
|
|
|
ValidationService -> ValidationService: validateStructure()
|
|
note right of ValidationService
|
|
구조 검증:
|
|
- 필수 섹션 존재
|
|
- 섹션 순서
|
|
- 데이터 완정성
|
|
end note
|
|
|
|
ValidationService -> ValidationService: validateContent()
|
|
note right of ValidationService
|
|
내용 검증:
|
|
- 필수 항목 기입
|
|
- 형식 준수
|
|
- 참조 무결성
|
|
end note
|
|
|
|
ValidationService -> ValidationService: validateBusiness()
|
|
note right of ValidationService
|
|
비즈니스 규칙:
|
|
- 참석자 서명
|
|
- Todo 할당 완료
|
|
- 첨부파일 검증
|
|
end note
|
|
|
|
ValidationService --> Service: ValidationResult
|
|
deactivate ValidationService
|
|
|
|
alt validation passed
|
|
Service -> Domain: markAsValidated()
|
|
activate Domain
|
|
Domain -> Domain: changeStatus(VALIDATED)
|
|
Domain --> Service: validated Meeting
|
|
deactivate Domain
|
|
|
|
Service -> Repository: save(meeting)
|
|
activate Repository
|
|
Repository -> DB: 회의 상태 업데이트\n(상태='검증완료')
|
|
activate DB
|
|
DB --> Repository: affected_rows
|
|
deactivate DB
|
|
Repository --> Service: savedMeeting
|
|
deactivate Repository
|
|
|
|
Service -> Cache: SET meeting:{id}\n(TTL: 10분)
|
|
activate Cache
|
|
note right of Cache
|
|
회의 정보 캐싱:
|
|
- TTL: 10분
|
|
- 자동 만료
|
|
end note
|
|
Cache --> Service: OK
|
|
deactivate Cache
|
|
|
|
Service ->> EventHub: publish(MeetingValidatedEvent)
|
|
activate EventHub
|
|
note right of EventHub
|
|
검증 완료 이벤트:
|
|
- 확정 가능 상태 알림
|
|
end note
|
|
deactivate EventHub
|
|
|
|
Service --> Controller: success response
|
|
else validation failed
|
|
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
|
|
|
|
Controller --> Gateway: 200 OK / 400 Bad Request
|
|
deactivate Controller
|
|
|
|
@enduml
|