hgzero/design/backend/sequence/inner/meeting-회의록목록조회.puml
ondal 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>
2025-10-23 09:48:06 +09:00

71 lines
1.5 KiB
Plaintext

@startuml
!theme mono
title 회의록 목록 조회 내부 시퀀스
participant "API Gateway<<E>>" as Gateway
participant "MeetingController" as Controller
participant "MeetingService" as Service
participant "MeetingRepository" as Repository
database "PostgreSQL<<E>>" as DB
database "Redis Cache<<E>>" as Cache
Gateway -> Controller: GET /api/meetings?page=0&size=20
activate Controller
Controller -> Service: getMeetingList(pageRequest, filters)
activate Service
note right of Service
조회 조건:
- 페이징 (page, size)
- 필터 (날짜, 상태, 작성자)
- 정렬 (최신순, 제목순)
end note
Service -> Cache: get(meetings:list:{hash})
activate Cache
note right of Cache
목록 조회 캐싱
키: 쿼리 조건 해시
TTL: 5분
end note
Cache --> Service: null (cache miss)
deactivate Cache
Service -> Repository: findAll(specification, pageable)
activate Repository
Repository -> DB: 회의록 목록 조회\n(필터 조건, 정렬, 페이징)
activate DB
DB --> Repository: meeting_rows
deactivate DB
Repository --> Service: Page<Meeting>
deactivate Repository
Service -> Service: toResponseList(meetings)
note right of Service
응답 변환:
- DTO 매핑
- 민감 정보 필터링
end note
Service -> Cache: SET meetings:list:{hash}\n(TTL: 5분)
activate Cache
note right of Cache
목록 데이터 캐싱:
- TTL: 5분
- 자동 만료
end note
Cache --> Service: OK
deactivate Cache
Service --> Controller: Page<MeetingResponse>
deactivate Service
Controller --> Gateway: 200 OK
deactivate Controller
@enduml