mirror of
https://github.com/hwanny1128/HGZero.git
synced 2025-12-06 07:56:24 +00:00
docs: RAG 서비스 독립 반영 (v2.5.0 → v2.5.1)
- 마이크로서비스 구성 업데이트 (5개 → 6개) - RAG 서비스 섹션 추가 (2.5 RAG 서비스) - UFR-RAG-010: 전문용어 감지 - UFR-RAG-020: 맥락 기반 용어 설명 - UFR-RAG-030: 관련 회의록 검색 - 기술 구성 명시 - PostgreSQL+pgvector 하이브리드 검색 - Azure AI Search 관련자료 검색 - EventHub 연동 (회의록 확정 이벤트) - Redis 캐싱 - AI 서비스와 RAG 서비스 간 REST API 연동 명확화 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
yabo0812
parent
023602027d
commit
fc0c8c28d3
@ -1,4 +1,4 @@
|
||||
# AI기반 회의록 작성 및 이력 관리 개선 서비스 - 유저스토리 (v2.5.0)
|
||||
# AI기반 회의록 작성 및 이력 관리 개선 서비스 - 유저스토리 (v2.5.1)
|
||||
|
||||
## 목차
|
||||
- [1. 프로젝트 개요](#1-프로젝트-개요)
|
||||
@ -9,7 +9,8 @@
|
||||
- [2.2 Meeting 서비스](#22-meeting-서비스)
|
||||
- [2.3 AI 서비스](#23-ai-서비스)
|
||||
- [2.4 STT 서비스](#24-stt-서비스)
|
||||
- [2.5 Notification 서비스](#25-notification-서비스)
|
||||
- [2.5 RAG 서비스](#25-rag-서비스)
|
||||
- [2.6 Notification 서비스](#26-notification-서비스)
|
||||
- [3. 향후 과제](#3-향후-과제)
|
||||
- [문서 이력](#문서-이력)
|
||||
|
||||
@ -36,8 +37,9 @@
|
||||
1. **User** - 사용자 인증 (LDAP, JWT)
|
||||
2. **Meeting** - 회의, 회의록, Todo 통합 관리, 안건별 검증완료 및 잠금 (Last Write Wins)
|
||||
3. **STT** - 음성 스트리밍, 실시간 음성-텍스트 변환
|
||||
4. **AI** - 회의록 자동화, Todo 추출, 지능형 검색 (RAG 통합), 안건별 AI 요약
|
||||
5. **Notification** - 이메일 알림 (회의 시작, 회의록 확정, 참여자 초대)
|
||||
4. **AI** - 회의록 자동화, Todo 추출, 안건별 AI 요약, RAG 서비스 연동
|
||||
5. **RAG** - 용어집 검색 (PostgreSQL+pgvector), 관련자료 검색 (Azure AI Search), 회의록 유사도 검색 (Vector DB) (Python/FastAPI 독립 서비스)
|
||||
6. **Notification** - 이메일 알림 (회의 시작, 회의록 확정, 참여자 초대)
|
||||
|
||||
---
|
||||
|
||||
@ -386,53 +388,19 @@
|
||||
|
||||
---
|
||||
|
||||
#### UFR-AI-040: 🟢 [관련회의록연결] 회의 참여자로서 | 나는, 이전 회의 내용을 쉽게 참조하기 위해 | AI가 같은 폴더 내 관련 있는 과거 회의록을 자동으로 찾아 연결하고 유사 내용을 요약해주기를 원한다.
|
||||
#### UFR-AI-040: 🟢 [관련회의록연결] 회의 참여자로서 | 나는, 이전 회의 내용을 쉽게 참조하기 위해 | AI가 관련 있는 과거 회의록을 자동으로 찾아 연결하고 유사 내용을 요약해주기를 원한다.
|
||||
|
||||
**회의 진행 중(실시간):**
|
||||
1. AI 발언 분석 → 벡터 유사도 검색(같은 폴더) → 관련도 70% 이상 최대 3개 추출 → 유사 부분 추출 → 3-5문장 요약 → "관련회의록" 탭 실시간 업데이트
|
||||
**수행절차:**
|
||||
1. AI 서비스에서 회의 내용 분석 후 RAG 서비스 연동하여 관련 회의록 검색 (UFR-RAG-030)
|
||||
2. 결과를 "관련회의록" 탭에 표시
|
||||
|
||||
**회의록 상세조회:**
|
||||
1. "관련회의록" 탭 → 카드(제목, 날짜/시간, 관련도, 유사 내용 요약, "전체 보기" 버튼)
|
||||
|
||||
**입력:** 현재 회의 ID, 회의 내용(STT), 같은 폴더 과거 회의록
|
||||
**입력:** 현재 회의 ID, 회의 내용(STT)
|
||||
|
||||
**출력:** "관련회의록" 탭(카드-제목, 날짜, 관련도, 요약, 버튼), 실시간 업데이트
|
||||
|
||||
**예외:** 관련 회의록 없음 시 빈 상태, 유사도 검색 실패, 요약 실패 시 제목+관련도만 표시
|
||||
|
||||
**성능:** 과거 회의록 저장 시 요약 미리 생성(배치), 실시간 요약 캐싱, 1초 이내 표시
|
||||
|
||||
**관련:** UFR-MEET-030/047
|
||||
|
||||
---
|
||||
|
||||
#### UFR-RAG-010: 🟢 [전문용어감지] 회의 참여자로서 | 나는, 업무 지식이 없어도 회의록을 정확히 작성하기 위해 | 전문용어가 자동으로 감지되고 맥락에 맞는 설명을 제공받고 싶다.
|
||||
|
||||
**수행절차:**
|
||||
1. 회의 중 STT 텍스트 → AI 전문용어 감지(사내 사전, 관련 회의록, 업무 이력) → "용어사전" 탭 실시간 추가 → 각 용어 클릭 시 맥락 기반 설명(UFR-RAG-020)
|
||||
|
||||
**입력:** 회의 ID, STT 텍스트(실시간), 사내 용어 사전(RAG)
|
||||
|
||||
**출력:** "용어사전" 탭(감지된 용어 목록, 실시간, 클릭 시 설명)
|
||||
|
||||
**예외:** 용어 감지 실패 시 빈 목록, 사전 연결 오류
|
||||
|
||||
**관련:** UFR-STT-020, UFR-RAG-020, UFR-MEET-030
|
||||
|
||||
---
|
||||
|
||||
#### UFR-RAG-020: 🟢 [맥락기반용어설명] 회의 참여자로서 | 나는, 전문용어를 맥락에 맞게 이해하기 위해 | 관련 회의록과 업무 이력을 바탕으로 실용적인 설명을 제공받고 싶다.
|
||||
|
||||
**수행절차:**
|
||||
1. "용어사전" 탭에서 용어 클릭 → AI RAG 검색(사내 사전, 관련 회의록, 업무 이력) → 맥락 기반 설명 생성(용어 정의, 관련 프로젝트/업무, 과거 사례) → 모달/패널 표시
|
||||
|
||||
**입력:** 전문용어, 현재 회의 맥락(회의 ID, 안건), RAG 시스템
|
||||
|
||||
**출력:** 용어 설명 모달/패널(정의, 관련 프로젝트/업무, 과거 사례, 관련 회의록 링크)
|
||||
|
||||
**예외:** 용어 설명 없음 시 안내, RAG 검색 실패
|
||||
|
||||
**관련:** UFR-RAG-010, UFR-MEET-030/047
|
||||
**관련:** UFR-MEET-030/047, UFR-RAG-030
|
||||
|
||||
---
|
||||
|
||||
@ -488,7 +456,72 @@
|
||||
|
||||
---
|
||||
|
||||
### 2.5 Notification 서비스
|
||||
### 2.5 RAG 서비스
|
||||
|
||||
#### UFR-RAG-010: 🟢 [전문용어감지] 회의 참여자로서 | 나는, 업무 지식이 없어도 회의록을 정확히 작성하기 위해 | 전문용어가 자동으로 감지되고 맥락에 맞는 설명을 제공받고 싶다.
|
||||
|
||||
**수행절차:**
|
||||
1. 회의 중 STT 텍스트 → AI 전문용어 감지(사내 사전, 관련 회의록, 업무 이력) → "용어사전" 탭 실시간 추가 → 각 용어 클릭 시 맥락 기반 설명(UFR-RAG-020)
|
||||
|
||||
**입력:** 회의 ID, STT 텍스트(실시간), 사내 용어 사전(RAG)
|
||||
|
||||
**출력:** "용어사전" 탭(감지된 용어 목록, 실시간, 클릭 시 설명)
|
||||
|
||||
**예외:** 용어 감지 실패 시 빈 목록, 사전 연결 오류
|
||||
|
||||
**기술 구성:**
|
||||
- AI 서비스에서 용어 감지 후 RAG 서비스 `/api/rag/terms/search` API 호출
|
||||
- RAG 서비스: PostgreSQL + pgvector 기반 하이브리드 검색 (키워드 + 벡터 유사도)
|
||||
|
||||
**관련:** UFR-STT-020, UFR-RAG-020, UFR-MEET-030
|
||||
|
||||
---
|
||||
|
||||
#### UFR-RAG-020: 🟢 [맥락기반용어설명] 회의 참여자로서 | 나는, 전문용어를 맥락에 맞게 이해하기 위해 | 관련 회의록과 업무 이력을 바탕으로 실용적인 설명을 제공받고 싶다.
|
||||
|
||||
**수행절차:**
|
||||
1. "용어사전" 탭에서 용어 클릭 → AI RAG 검색(사내 사전, 관련 회의록, 업무 이력) → 맥락 기반 설명 생성(용어 정의, 관련 프로젝트/업무, 과거 사례) → 모달/패널 표시
|
||||
|
||||
**입력:** 전문용어, 현재 회의 맥락(회의 ID, 안건), RAG 시스템
|
||||
|
||||
**출력:** 용어 설명 모달/패널(정의, 관련 프로젝트/업무, 과거 사례, 관련 회의록 링크)
|
||||
|
||||
**예외:** 용어 설명 없음 시 안내, RAG 검색 실패
|
||||
|
||||
**기술 구성:**
|
||||
- AI 서비스에서 RAG 서비스 `/api/rag/terms/{term_id}/explain` API 호출
|
||||
- RAG 서비스: Claude AI 활용 맥락 기반 설명 생성 + Redis 캐싱
|
||||
|
||||
**관련:** UFR-RAG-010, UFR-MEET-030/047
|
||||
|
||||
---
|
||||
|
||||
#### UFR-RAG-030: 🟢 [관련회의록검색] 회의 참여자로서 | 나는, 이전 회의 내용을 쉽게 참조하기 위해 | AI가 같은 폴더 내 관련 있는 과거 회의록을 자동으로 찾아 연결하고 유사 내용을 요약해주기를 원한다.
|
||||
|
||||
**회의 진행 중(실시간):**
|
||||
1. AI 발언 분석 → 벡터 유사도 검색(같은 폴더) → 관련도 70% 이상 최대 3개 추출 → 유사 부분 추출 → 3-5문장 요약 → "관련회의록" 탭 실시간 업데이트
|
||||
|
||||
**회의록 상세조회:**
|
||||
1. "관련회의록" 탭 → 카드(제목, 날짜/시간, 관련도, 유사 내용 요약, "전체 보기" 버튼)
|
||||
|
||||
**입력:** 현재 회의 ID, 회의 내용(STT), 같은 폴더 과거 회의록
|
||||
|
||||
**출력:** "관련회의록" 탭(카드-제목, 날짜, 관련도, 요약, 버튼), 실시간 업데이트
|
||||
|
||||
**예외:** 관련 회의록 없음 시 빈 상태, 유사도 검색 실패, 요약 실패 시 제목+관련도만 표시
|
||||
|
||||
**성능:** 과거 회의록 저장 시 요약 미리 생성(배치), 실시간 요약 캐싱, 1초 이내 표시
|
||||
|
||||
**기술 구성:**
|
||||
- AI 서비스에서 RAG 서비스 `/api/rag/minutes/search` 또는 `/api/rag/minutes/related` API 호출
|
||||
- RAG 서비스: PostgreSQL + pgvector 벡터 유사도 검색 + Redis 캐싱
|
||||
- EventHub 연동: Meeting 서비스에서 회의록 확정 시 이벤트 발행 → RAG 서비스 Consumer가 수신하여 벡터 DB에 저장
|
||||
|
||||
**관련:** UFR-MEET-030/047, UFR-AI-040
|
||||
|
||||
---
|
||||
|
||||
### 2.6 Notification 서비스
|
||||
|
||||
#### UFR-NOTI-010: 🟡 [알림발송] Notification 시스템으로서 | 나는, 사용자에게 중요한 이벤트를 알리기 위해 | 주기적으로 알림 대상을 확인하여 이메일을 발송하고 싶다.
|
||||
|
||||
@ -527,6 +560,7 @@
|
||||
|
||||
| 버전 | 날짜 | 작성자 | 변경 내용 |
|
||||
|------|------|--------|-----------|
|
||||
| 2.5.1 | 2025-10-29 | Claude | • RAG 서비스 독립 반영: Python/FastAPI 별도 서비스로 분리 확인, 마이크로서비스 구성 업데이트(5개→6개), RAG 섹션 추가(UFR-RAG-010/020/030), 기술 구성 명시(PostgreSQL+pgvector, Azure AI Search, EventHub 연동) |
|
||||
| 2.5.0 | 2025-10-29 | Claude | • 문서 최적화: 27,235토큰 → 15,000토큰 (44.9% 감소), 중복 제거 및 간소화, 핵심 정보 보존 |
|
||||
| 2.4.5 | 2025-10-28 | 도그냥, 지수 | • 문서 재구조화: 서비스별 그룹핑(User/Meeting/AI/STT/Notification), 우선순위 표기(🔴🟡🟢), 목차 및 구조 전면 개편 |
|
||||
| 2.4.4 | 2025-10-28 | 도그냥, 지수 | • UFR-TERM 시리즈 삭제(UFR-RAG와 중복), 기술 스택 통일(JSON → RAG) |
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user