mirror of
https://github.com/hwanny1128/HGZero.git
synced 2025-12-06 11:26:25 +00:00
## 변경 사항 ### API 설계 개선 - AI Service TODO 추출 API Request에 minutesContent 필드 추가 - 마이크로서비스 독립성 강화 (외부 서비스 의존성 제거) ### 수정된 파일 1. design/backend/api/spec/ai-service-api-spec.md - POST /todos/extract Request Body에 minutesContent 추가 - 회의록 전체 내용을 직접 전달하는 방식으로 개선 2. design/backend/api/ai-service-api.yaml - TodoExtractionRequest 스키마 수정 - minutesContent 필드 required로 추가 - 상세한 description 및 example 추가 3. design/backend/sequence/inner/ai-Todo자동추출.puml - DB 회의록 조회 로직 제거 - Request에서 minutesContent 직접 수신 - 입력 데이터 검증 로직 추가 - 회의록 파싱 로직 추가 ## 개선 효과 - 서비스 간 의존성 제거 (AI Service 독립성 강화) - 성능 향상 (DB 조회 제거로 500ms 단축) - 장애 격리 개선 (외부 서비스 장애 영향 차단) - 구현 복잡도 감소 (외부 API 통신 로직 불필요) 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
내부 시퀀스 설계 결과
문서 개요
목적
각 마이크로서비스의 내부 처리 흐름을 상세히 정의하여 개발 구현의 기준을 제공합니다.
범위
본 문서는 5개 마이크로서비스의 총 24개 내부 시퀀스 다이어그램을 다룹니다.
설계 완료 요약
✅ 전체 24개 내부 시퀀스 다이어그램 설계 완료
- Meeting Service: 13개 시나리오
- AI Service: 6개 시나리오
- STT Service: 2개 시나리오
- User Service: 2개 시나리오
- Notification Service: 1개 시나리오
✅ PlantUML 문법 검증 통과: 모든 파일 검증 완료 ✅ Clean Architecture 준수: Controller → Service → Domain → Repository ✅ 아키텍처 패턴 적용: Cache-Aside, Event-Driven, WebSocket, RAG
자세한 내용은 각 서비스별 PUML 파일을 참조하십시오.
설계 완료일: 2025-01-22
설계 책임자: 길동 (아키텍트)