12 Commits

Author SHA1 Message Date
yabo0812
d2f396cffb 설계서 전면 업데이트: RAG Service 문서화 및 불필요 설계 정리
## 주요 변경사항

### 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>
2025-10-29 17:51:57 +09:00
Minseo-Jo
9d71646b2e AI 서비스 SSE 스트리밍 기능 및 테스트 환경 구성 완료
- SSE 스트리밍 방식으로 AI 분석 결과 실시간 전송 구현
- 용어 감지 및 관련 회의록 검색 기능 개선
- API 명세 업데이트 (SSE 엔드포인트 추가)
- AI 및 STT 서비스 테스트 환경 구성 문서 작성

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-24 16:33:57 +09:00
Minseo-Jo
694a84e4f5 화자 식별 기능 제거 및 STT 서비스 단순화
프로토타입 검토 결과, 화자 식별 기능이 현재 요구사항에서 제외되어 관련 코드 및 설계 문서를 제거하고 현행화했습니다.

변경사항:
1. 백엔드 코드 정리
   - Speaker 관련 컨트롤러, 서비스, 리포지토리 삭제
   - Speaker 도메인, DTO, 이벤트 클래스 삭제
   - Recording 및 Transcription 서비스에서 화자 관련 로직 제거

2. API 명세 현행화 (stt-service-api.yaml)
   - 화자 식별/관리 API 엔드포인트 제거 (/speakers/*)
   - 응답 스키마에서 speakerId, speakerName 필드 제거
   - 화자 관련 스키마 전체 제거 (Speaker*)
   - API 설명에서 화자 식별 관련 내용 제거

3. 설계 문서 현행화
   - STT 녹음 시퀀스: 화자 식별 단계 제거
   - STT 텍스트변환 시퀀스: 화자 정보 업데이트 로직 제거, 배치 모드 제거
   - 실시간 전용 기능으로 단순화

영향:
- 화자별 발언 구분 기능 제거
- 실시간 음성-텍스트 변환에만 집중
- 시스템 복잡도 감소 및 성능 개선 (초기화 시간: 1.1초 → 0.8초)

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-24 14:46:39 +09:00
Minseo-Jo
e5cf329254 AI 서비스 API 설계 및 명세 추가
- AI 서비스 API 설계서 작성 (design/backend/api/ai-service-api.md)
- OpenAPI 3.0 명세서 작성 (design/backend/api/ai-service-api.yaml)
- 회의록 AI 분석 API 엔드포인트 정의
- 일정 추출 API 엔드포인트 정의
- 요약 생성 API 엔드포인트 정의
- 공통 응답 포맷 및 에러 처리 정의

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-23 14:28:33 +09:00
cyjadela
b66caf0267 meeting service API 설계서 에러 해결 2025-10-23 14:26:50 +09:00
Minseo-Jo
b8ff2a8339 섹션 AI 요약 재생성으로 변경 (프로토타입 반영)
- 프롬프트 기반 회의록 개선 → 섹션 AI 요약 재생성으로 변경
- UFR-AI-030 → UFR-AI-035로 유저스토리 교체
- API 엔드포인트: POST /sections/{sectionId}/regenerate-summary
- 내부 시퀀스, 외부 시퀀스, API 설계서, 유저스토리 일관성 확보
- 프로토타입의 "AI 재생성" 버튼 기능과 정확히 매칭

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-23 13:47:20 +09:00
cyjadela
d3faf55657 Merge branch 'main' of https://github.com/hwanny1128/HGZero 2025-10-23 13:32:39 +09:00
cyjadela
d6df40015e meeting service API 설계서 수정 2025-10-23 13:31:47 +09:00
Minseo-Jo
8f7e3fc1b7 회의록 공유 기능 제거에 따른 대시보드 조회 시퀀스 수정
- meeting-대시보드조회.puml에서 공유받은 회의록 조회 로직 제거
- findSharedMinutes(userId) 메서드 호출 및 관련 시퀀스 삭제
- 응답 데이터 구조에서 sharedMinutes 필드 제거
- 프로토타입 변경사항 반영 완료

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-23 11:14:05 +09:00
ondal
a551235ad7 API 설계 완료
- 5개 마이크로서비스 API 명세 작성 (User, Meeting, STT, AI, Notification)
- OpenAPI 3.0 표준 준수
- 총 47개 API 설계
- 유저스토리 100% 커버리지
- swagger-cli 검증 통과
- 종합 API 설계서 작성

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-23 10:49:29 +09:00
Minseo-Jo
bd34b40991 프로젝트 구조 정리 및 프로토타입 업데이트
- design-last, design-v1 디렉토리 정리
- UI/UX 프로토타입 개선 및 통합
- 스타일 가이드 및 테스트 결과 업데이트
- 유저스토리 목록 추가
- 불필요한 문서 제거

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-21 10:12:18 +09:00
hiondal
27e8c12eaf 회의록별 대시보드 기능 추가
- 유저스토리 추가: UFR-MEET-070 [회의록대시보드]
  - 핵심내용, 결정사항, Todo 진행상황, 참고자료 4개 섹션 정의
  - AI, RAG, Todo 서비스 연동 명시
  - 복잡도: M/21

- UI/UX 설계서 작성 (design/uiux/uiux.md)
  - 회의록별 대시보드 화면 구조 상세 설계
  - 5개 주요 영역: Header, 핵심내용, 결정사항, Todo 진행상황, 참고자료
  - 스타일 시스템 정의 (색상, 타이포그래피, 간격, 반응형)
  - WCAG 2.1 Level AA 접근성 가이드라인
  - 인터랙션 및 데이터 요구사항 명세
  - 에러 처리 및 성능 최적화 방안

- API 설계서 작성 (design/backend/api/meeting-dashboard-api.md)
  - 5개 주요 엔드포인트 정의
    - 대시보드 전체 조회
    - 핵심내용 조회
    - 결정사항 조회 (페이지네이션)
    - Todo 진행상황 조회 (필터링)
    - 참고자료 조회 (타입별 필터, 페이지네이션)
  - 데이터 모델 정의 (TypeScript Interface)
  - Redis 캐싱 전략 (섹션별 TTL 설정)
  - 성능 최적화 (병렬 처리, 선택적 로딩, 인덱싱)
  - 보안 (JWT 인증, Rate Limiting)
  - 에러 코드 및 테스트 시나리오

차별화 포인트:
- 회의 결과를 한눈에 파악할 수 있는 통합 뷰
- Todo 진행상황 실시간 업데이트 (WebSocket)
- 관련 회의록 및 업무 이력 자동 연결 (RAG)
- Mobile First 반응형 설계

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-20 13:46:20 +09:00