mirror of
https://github.com/hwanny1128/HGZero.git
synced 2025-12-06 13:46:24 +00:00
d2f396cffb
## 주요 변경사항 ### 1. RAG Service 독립 서비스 문서화 - RAG Service OpenAPI 명세 작성 (9개 API) - Terms APIs: 용어 검색, 조회, 맥락 기반 설명 (3개) - Documents APIs: 관련 문서 검색, 통계 (2개) - Minutes APIs: 회의록 벡터 검색, 연관 검색 (4개) - 기술 스택: Python 3.11+, FastAPI, PostgreSQL+pgvector, Azure AI Search - 성능 요구사항 명시 (용어 검색 <500ms, 설명 생성 <3초) ### 2. 불필요한 설계서 삭제 (10개 파일, 27% 감소) - AI Service (3개): 결정사항제안, 논의사항제안, 회의록개선 - Meeting Service (5개): 실시간수정동기화, 충돌해결, Todo완료처리, Todo할당, 리마인더발송 - Notification Service (2개): Todo알림발송, 초대알림발송 ### 3. API 설계서 업데이트 (v2.0 → v2.1) - 마이크로서비스: 5개 → 6개 (RAG Service 추가) - 총 API 개수: 47개 → 56개 (+9개) - AI Service 주요 특징 업데이트 - RAG Service 연동 명시 - 삭제된 Suggestion API 제거 - 차별화 포인트: 맥락 기반 용어 설명, 하이브리드 검색 강조 - RAG Service 섹션 완전 신규 작성 - 통계 및 문서 이력 업데이트 ### 4. 내부 시퀀스 다이어그램 업데이트 (2개) - ai-전문용어감지.puml: RAG Service API 호출 방식 명시 - ai-맥락기반용어설명.puml: RAG Service API 호출 방식 명시 ### 5. 문서화 - 설계서 업데이트 요약 문서 작성 (claudedocs/설계서_업데이트_요약.md) - 전체 변경 사항, 영향 분석, 다음 단계 작업 명시 ## 영향 분석 - 설계서 파일: 37개 → 27개 (10개 삭제) - 유저스토리 커버리지: 28개 유저스토리 100% 반영 - 서비스 아키텍처: AI Service와 RAG Service 분리로 독립성 향상 🤖 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
설계 책임자: 길동 (아키텍트)