diff --git a/design/backend/logical/logical-architecture.md b/design/backend/logical/logical-architecture.md index a191744..cc60fb5 100644 --- a/design/backend/logical/logical-architecture.md +++ b/design/backend/logical/logical-architecture.md @@ -37,26 +37,23 @@ - Request/Response 로깅 - CORS 처리 -#### 마이크로서비스 레이어 (8개 서비스) +#### 마이크로서비스 레이어 (5개 서비스) | 서비스 | 책임 | 주요 기능 | |--------|------|----------| -| **User Service** | 사용자 관리 | - 사용자 인증 (LDAP 연동)
- 권한 관리
- 사용자 프로필 관리 | -| **Meeting Service** | 회의 및 회의록 관리 | - 회의 예약/시작/종료
- 회의록 관리 (생성/수정/공유)
- 회의 템플릿 관리
- 회의 통계 | +| **User Service** | 사용자 인증 | - 사용자 인증 (LDAP 연동)
- JWT 토큰 발급 및 검증 | +| **Meeting Service** | 회의, 회의록, Todo, 실시간 협업 관리 | - 회의 예약/시작/종료
- 회의록 관리 (생성/수정/공유)
- 회의 템플릿 관리
- Todo 관리 및 진행 상황 추적
- 실시간 동기화 (WebSocket)
- 버전 관리 및 충돌 해결
- 회의 통계 | | **STT Service** | 음성 인식 | - 음성 녹음 관리
- 음성-텍스트 변환 (Azure Speech)
- 화자 식별 | -| **AI Service** | AI 기반 자동화 | - 회의록 자동 작성 (LLM)
- Todo 자동 추출
- 프롬프팅 기반 회의록 개선
- 관련 회의록 자동 연결 | -| **RAG Service** | 맥락 기반 검색 | - 전문용어 감지
- 맥락 기반 용어 설명
- 관련 문서 검색
- 업무 이력 통합 | -| **Collaboration Service** | 실시간 협업 | - 실시간 동기화 (WebSocket)
- 버전 관리
- 충돌 해결
- 회의록 검증 | -| **Todo Service** | Todo 관리 | - Todo 할당 및 관리
- 진행 상황 추적
- 회의록 실시간 연동
- Todo 통계 | +| **AI Service** | AI 기반 자동화 및 지능형 검색 | - 회의록 자동 작성 (LLM)
- Todo 자동 추출
- 프롬프팅 기반 회의록 개선
- 전문용어 감지 및 맥락 기반 설명 (RAG)
- 관련 회의록 자동 연결 | | **Notification Service** | 알림 관리 | - 알림 발송 (이메일/SMS)
- 리마인더 관리
- 알림 큐 관리 | #### 인프라 레이어 **데이터 저장소** -- **PostgreSQL**: 각 서비스별 독립 데이터베이스 (8개) - - User DB, Meeting DB, STT DB, AI DB, RAG DB, Todo DB, Notification DB +- **PostgreSQL**: 각 서비스별 독립 데이터베이스 (5개) + - User DB, Meeting DB, STT DB, AI DB, Notification DB - **Redis**: 분산 캐시 - - 사용자 프로필, 회의 정보, Todo 목록 캐싱 + - 회의 정보, Todo 목록 캐싱 - 비동기 작업 상태 저장 **메시지 브로커** @@ -76,37 +73,42 @@ ### 2.1 서비스별 책임 #### User Service -**핵심 책임**: 사용자 인증 및 권한 관리 +**핵심 책임**: 사용자 인증 **주요 기능**: - LDAP 연동 사용자 인증 - JWT 토큰 발급 및 검증 -- 사용자 프로필 조회 및 수정 -- 권한 관리 (회의 참여 권한, 회의록 수정 권한) **데이터 관리**: -- User 엔티티: 사용자 정보 (사번, 이름, 이메일, 권한) +- User 엔티티: 사용자 기본 정보 (사번, 이름, 이메일) - Session 엔티티: 활성 세션 관리 -**캐싱 전략**: -- 사용자 프로필: TTL 30분 -- 사용자 권한: TTL 1시간 +**역할 변경**: +- 프론트엔드에서 사용자 정보(userId, userName, email)를 모든 API 요청에 포함하여 전송 +- User Service는 인증 토큰 발급/검증만 담당 +- 다른 서비스는 User Service를 동기 호출하지 않음 (성능 향상, 의존성 제거) --- #### Meeting Service -**핵심 책임**: 회의 및 회의록 생애주기 관리 +**핵심 책임**: 회의, 회의록, Todo, 실시간 협업 통합 관리 **주요 기능**: -- 회의 예약, 시작, 종료 -- 회의록 생성, 수정, 확정, 공유 -- 회의 템플릿 관리 -- 회의 통계 생성 +- **회의 관리**: 회의 예약, 시작, 종료 +- **회의록 관리**: 회의록 생성, 수정, 확정, 공유 +- **Todo 관리**: Todo 할당, 진행 상황 추적, 회의록 양방향 연결 +- **실시간 협업**: WebSocket 기반 실시간 동기화, 버전 관리, 충돌 해결 +- **템플릿 관리**: 회의록 템플릿 관리 +- **통계 생성**: 회의 및 Todo 통계 **데이터 관리**: - Meeting 엔티티: 회의 정보 (제목, 일시, 장소, 참석자) - Transcript 엔티티: 회의록 (내용, 상태, 버전) +- Todo 엔티티: Todo 정보 (내용, 담당자, 마감일, 상태) +- TranscriptVersion 엔티티: 회의록 버전 정보 +- CollaborationEvent 엔티티: 수정 이벤트 (수정자, 시간, 변경 내용) - MeetingTemplate 엔티티: 회의록 템플릿 +- TodoProgress 엔티티: 진행 상황 (시작 시간, 완료 시간) **이벤트 발행**: - `MeetingCreated`: 회의 생성 시 @@ -114,11 +116,20 @@ - `MeetingEnded`: 회의 종료 시 - `TranscriptCreated`: 회의록 생성 완료 시 - `TranscriptShared`: 회의록 공유 시 +- `TodoCreated`: Todo 생성 시 +- `TodoCompleted`: Todo 완료 시 + +**실시간 동기화**: +- WebSocket을 통해 수정 델타 전송 (전체 데이터 대신) +- AI 분석 결과 통합 전송 (정리된 회의록, 전문용어, 관련 자료) +- 모든 참석자에게 실시간 반영 **캐싱 전략**: - 회의 기본 정보: TTL 10분 - 회의 참여자 목록: TTL 10분 - 회의 템플릿: TTL 1시간 +- Todo 목록: TTL 5분 +- Todo 통계: TTL 5분 --- @@ -146,17 +157,23 @@ --- #### AI Service -**핵심 책임**: AI 기반 회의록 자동화 및 Todo 추출 +**핵심 책임**: AI 기반 회의록 자동화, Todo 추출, 지능형 검색 (RAG 통합) **주요 기능**: - LLM 기반 회의록 자동 작성 - Todo 자동 추출 및 담당자 식별 - 프롬프팅 기반 회의록 개선 (1Page 요약, 핵심 요약 등) - 관련 회의록 자동 연결 (벡터 유사도 검색) +- 전문용어 자동 감지 및 맥락 기반 설명 생성 (RAG) +- 과거 회의록 및 사내 문서 검색 +- 업무 이력 통합 **데이터 관리**: - AiTaskStatus 엔티티: 비동기 작업 상태 (PENDING, PROCESSING, COMPLETED, FAILED) - TranscriptSummary 엔티티: AI 생성 요약 +- TermGlossary 엔티티: 용어 사전 +- DocumentEmbedding 엔티티: 문서 벡터 임베딩 +- TermExplanation 엔티티: 생성된 용어 설명 **비동기 처리**: - Queue를 통한 AI 처리 요청 수신 @@ -167,92 +184,23 @@ - `TodoExtracted`: Todo 추출 완료 시 - `TranscriptSummaryCreated`: 요약 생성 완료 시 -**성능 목표**: -- AI 회의록 작성: < 30초 -- Todo 추출: < 10초 -- 프롬프팅 기반 개선: < 1분 - ---- - -#### RAG Service -**핵심 책임**: 맥락 기반 용어 설명 및 관련 문서 검색 - -**주요 기능**: -- 전문용어 자동 감지 -- 벡터 유사도 검색을 통한 맥락 기반 설명 생성 -- 과거 회의록 및 사내 문서 검색 -- 업무 이력 통합 - -**데이터 관리**: -- TermGlossary 엔티티: 용어 사전 -- DocumentEmbedding 엔티티: 문서 벡터 임베딩 -- TermExplanation 엔티티: 생성된 용어 설명 - **검색 전략**: - 벡터 유사도 기반 관련 문서 검색 - 관련도 70% 이상만 반환 - 최대 5개 문서 선택 +**성능 목표**: +- AI 회의록 작성: < 30초 +- Todo 추출: < 10초 +- 프롬프팅 기반 개선: < 1분 +- 용어 검색 및 설명 생성: < 5초 + **차별화 포인트**: - 단순 정의가 아닌 조직 내 실제 사용 맥락 제공 - 업무 지식 없이도 실질적인 도움 제공 --- -#### Collaboration Service -**핵심 책임**: 실시간 협업 및 버전 관리 - -**주요 기능**: -- WebSocket 기반 실시간 동기화 -- 회의록 수정 이력 관리 -- 동시 수정 충돌 해결 (Last Write Wins) -- 섹션별 검증 완료 처리 - -**데이터 관리**: -- TranscriptVersion 엔티티: 회의록 버전 정보 -- CollaborationEvent 엔티티: 수정 이벤트 (수정자, 시간, 변경 내용) - -**실시간 동기화**: -- WebSocket을 통해 수정 델타 전송 (전체 데이터 대신) -- 모든 참석자에게 실시간 반영 - -**이벤트 발행**: -- `SectionVerified`: 섹션 검증 완료 시 - ---- - -#### Todo Service -**핵심 책임**: Todo 관리 및 회의록 실시간 연동 - -**주요 기능**: -- Todo 할당 및 관리 -- 진행 상황 추적 -- 회의록 양방향 연결 -- Todo 통계 생성 - -**데이터 관리**: -- Todo 엔티티: Todo 정보 (내용, 담당자, 마감일, 상태) -- TodoProgress 엔티티: 진행 상황 (시작 시간, 완료 시간) - -**회의록 연동**: -- Todo 생성 시 회의록 섹션 링크 자동 연결 -- Todo 완료 시 회의록에 완료 상태 실시간 반영 - -**이벤트 발행**: -- `TodoCreated`: Todo 생성 시 -- `TodoCompleted`: Todo 완료 시 -- `TodoStatusChanged`: 상태 변경 시 - -**캐싱 전략**: -- 사용자별 Todo 목록: TTL 5분 -- Todo 진행 상태 통계: TTL 5분 - -**차별화 포인트**: -- Todo와 회의록의 강력한 양방향 연결 -- 실시간 진행 상황 반영 - ---- - #### Notification Service **핵심 책임**: 알림 발송 및 리마인더 관리 @@ -281,17 +229,12 @@ ### 2.2 서비스 간 통신 전략 #### 동기 통신 (REST API) -**적용 대상**: 즉시 응답이 필요한 단순 조회 +**적용 대상**: 없음 (서비스 간 동기 의존성 제거) -| 호출자 | 대상 | 목적 | 캐싱 여부 | -|--------|------|------|-----------| -| Meeting Service | User Service | 사용자 정보 조회 | ✅ Redis (TTL 30분) | -| Meeting Service | Collaboration Service | 실시간 동기화 요청 | ❌ | -| Todo Service | User Service | 담당자 정보 조회 | ✅ Redis (TTL 30분) | - -**특징**: -- 캐시 우선 전략으로 직접 의존성 최소화 -- API Gateway를 통한 일관된 인증/인가 +**변경 사항**: +- 프론트엔드가 모든 API 요청에 사용자 정보(userId, userName, email) 포함 +- User Service 동기 참조 완전 제거 → 성능 향상, 장애 격리 +- Meeting Service 내에서 Todo, Collaboration 기능 통합 → 내부 메서드 호출로 처리 --- @@ -303,13 +246,13 @@ | 이벤트 | 발행자 | 구독자 | 목적 | |--------|--------|--------|------| | **MeetingCreated** | Meeting Service | Notification Service
AI Service | 참석자 알림 발송
회의 분석 준비 | -| **MeetingEnded** | Meeting Service | STT Service
AI Service
Todo Service
Notification Service | 회의록 생성
AI 분석 시작
Todo 추출
종료 알림 | -| **TranscriptReady** | STT Service | AI Service | 회의록 자동 작성 시작 | -| **TranscriptCreated** | AI Service | Meeting Service
Notification Service | 회의 상태 업데이트
생성 완료 알림 | -| **TodoExtracted** | AI Service | Todo Service | Todo 자동 할당 | -| **TodoCreated** | Todo Service | Notification Service | 담당자 알림 발송 | -| **TodoCompleted** | Todo Service | Meeting Service
Notification Service | 회의록 반영
완료 알림 | -| **SectionVerified** | Collaboration Service | Meeting Service | 검증 상태 업데이트 | +| **MeetingStarted** | Meeting Service | STT Service | 음성 녹음 시작 준비 | +| **MeetingEnded** | Meeting Service | STT Service
AI Service
Notification Service | 음성 녹음 종료
AI 분석 종료
종료 알림 | +| **TranscriptReady** | STT Service | AI Service | AI 회의록 분석 (5초 배치) | +| **TranscriptSummaryCreated** | AI Service | Meeting Service | 회의록 최종 저장 및 동기화 | +| **TodoCreated** | Meeting Service | Notification Service | 담당자 알림 발송 | +| **TodoCompleted** | Meeting Service | Notification Service | 완료 알림 | +| **TranscriptShared** | Meeting Service | Notification Service | 회의록 공유 알림 | **RabbitMQ Exchange/Queue 구성**: - **Topic Exchange**: `meeting.events`, `transcript.events`, `todo.events` @@ -405,25 +348,28 @@ ``` [회의 시작] ↓ -[STT Service] → 음성 녹음 및 실시간 텍스트 변환 - ↓ (TranscriptReady 이벤트) -[AI Service] → 회의록 자동 작성 (실시간 업데이트) +[STT Service] → 음성 녹음 및 텍스트 변환 + ↓ (TranscriptReady 이벤트 - 5초 배치) +[AI Service] → 병렬 처리 + ├─ 회의록 내용 정리 (LLM) + ├─ 전문용어 추출 및 설명 생성 (RAG) + └─ 관련 자료 검색 (벡터 검색) + ↓ (TranscriptSummaryCreated 이벤트) +[Meeting Service] → 회의록 데이터 저장 및 실시간 동기화 (WebSocket) ↓ -[Collaboration Service] → 실시간 동기화 (WebSocket) - ↓ -[RAG Service] → 전문용어 감지 및 맥락 기반 설명 제공 - ↓ -[참석자들] → 회의록 확인 및 수정 (실시간 협업) +[참석자들] → 정리된 회의록 확인 및 수정 (실시간 협업) ``` **단계별 처리**: -1. STT Service: 음성 녹음 시작 → 실시간 텍스트 변환 -2. STT Service: `TranscriptReady` 이벤트 발행 (5초 간격) -3. AI Service: 변환된 텍스트 수신 → 회의록 자동 작성 -4. AI Service: 회의 맥락 이해 → 주제별 분류, 발언자별 정리 -5. Collaboration Service: WebSocket으로 모든 참석자에게 실시간 동기화 -6. RAG Service: 전문용어 감지 → 맥락 기반 설명 생성 -7. 참석자: 회의록 내용 확인 및 수정 (실시간 반영) +1. STT Service: 음성 녹음 시작 → 텍스트 변환 (Azure Speech) +2. STT Service: `TranscriptReady` 이벤트 발행 (5초 간격 배치) +3. AI Service (병렬 처리): + - 회의록 내용 정리: 주제별 분류, 핵심 내용 요약 + - 전문용어 추출: 자동 감지 → 벡터 임베딩 → 맥락 기반 설명 + - 관련 자료 검색: 유사도 기반 문서 검색 (관련도 70%+) +4. AI Service: 처리 결과 저장 (AI DB) → `TranscriptSummaryCreated` 이벤트 발행 +5. Meeting Service: 회의록 데이터 저장 (Meeting DB) → WebSocket으로 통합 결과 전송 +6. 참석자: 정리된 회의록 확인 및 수정 (실시간 반영) --- @@ -434,11 +380,11 @@ ↓ [Meeting Service] → MeetingEnded 이벤트 발행 ↓ -┌───┴───┬───────┬───────┬────────┐ -↓ ↓ ↓ ↓ ↓ -STT AI Todo Notify Collab -회의록 Todo Todo 종료 검증 -생성 추출 할당 알림 처리 +┌───┴───┬───────┬────────┐ +↓ ↓ ↓ ↓ +STT AI Notify Meeting +음성 Todo 종료 Todo +종료 추출 알림 생성 ``` **단계별 처리**: @@ -450,18 +396,16 @@ STT AI Todo Notify Collab 4. **AI Service** (구독): - 최종 회의록 분석 - Todo 자동 추출 및 담당자 식별 - - `TodoExtracted` 이벤트 발행 -5. **Todo Service** (구독): - - Todo 생성 및 할당 + - 추출된 Todo 정보를 Meeting Service에 전송 +5. **Meeting Service**: + - Todo 생성 및 할당 (내부 처리) - 회의록 섹션 링크 연결 - `TodoCreated` 이벤트 발행 + - 섹션별 검증 완료 처리 (내부 처리) + - 회의록 확정 (확정 버전 생성) 6. **Notification Service** (구독): - 회의 종료 알림 발송 - Todo 할당 알림 발송 -7. **Collaboration Service**: - - 섹션별 검증 완료 처리 - - `SectionVerified` 이벤트 발행 -8. Meeting Service: 회의록 확정 (확정 버전 생성) --- @@ -470,29 +414,24 @@ STT AI Todo Notify Collab ``` [Todo 완료 처리] ↓ -[Todo Service] → TodoCompleted 이벤트 발행 +[Meeting Service] → TodoCompleted 이벤트 발행 ↓ -┌───┴──────────┐ -↓ ↓ -Meeting Notification -회의록 반영 완료 알림 +Notification +완료 알림 ``` **단계별 처리**: 1. 담당자: Todo 완료 버튼 클릭 -2. Todo Service: Todo 상태 업데이트 (완료 시간, 완료자 기록) -3. Todo Service: `TodoCompleted` 이벤트 발행 -4. **Meeting Service** (구독): - - 관련 회의록 조회 (Redis 캐시 → DB) - - 해당 Todo 섹션에 완료 상태 자동 반영 - - 완료 시간 및 완료자 정보 기록 - - Redis 캐시 무효화 (`meeting:info:{meetingId}`) -5. **Notification Service** (구독): +2. Meeting Service: Todo 상태 업데이트 (완료 시간, 완료자 기록) +3. Meeting Service: 관련 회의록에 완료 상태 자동 반영 (내부 처리) +4. Meeting Service: Redis 캐시 무효화 (`meeting:info:{meetingId}`) +5. Meeting Service: `TodoCompleted` 이벤트 발행 +6. **Notification Service** (구독): - 회의록 작성자에게 완료 알림 발송 - 모든 Todo 완료 시 전체 완료 알림 발송 **차별화 포인트**: -- Todo 완료가 회의록에 실시간 반영 +- Todo 완료가 회의록에 즉시 반영 (동일 서비스 내 처리) - 회의 결과 추적 용이 --- @@ -558,13 +497,11 @@ Client → API Gateway → Service | 서비스 | 캐싱 대상 | TTL | 무효화 트리거 | |--------|----------|-----|--------------| -| User Service | 사용자 프로필 | 30분 | 프로필 수정 | -| User Service | 사용자 권한 | 1시간 | 권한 변경 | | Meeting Service | 회의 정보 | 10분 | 회의 수정 | | Meeting Service | 회의 참여자 | 10분 | 참여자 변경 | | Meeting Service | 회의 템플릿 | 1시간 | 템플릿 수정 | -| Todo Service | Todo 목록 | 5분 | Todo 상태 변경 | -| Todo Service | Todo 통계 | 5분 | Todo 완료 | +| Meeting Service | Todo 목록 | 5분 | Todo 상태 변경 | +| Meeting Service | Todo 통계 | 5분 | Todo 완료 | #### 캐시 무효화 전략 - **즉시 무효화**: 데이터 변경 시 즉시 캐시 삭제 @@ -717,21 +654,22 @@ HPA (Horizontal Pod Autoscaler) 설정: #### 레이어 구조 1. **클라이언트 레이어**: 웹 애플리케이션 2. **API Gateway 레이어**: 단일 진입점, 인증/라우팅 -3. **마이크로서비스 레이어**: 8개 독립 서비스 -4. **인프라 레이어**: DB, Redis, RabbitMQ, 외부 서비스 +3. **마이크로서비스 레이어**: 5개 독립 서비스 (User, Meeting, STT, AI, Notification) +4. **인프라 레이어**: Redis, RabbitMQ, 외부 서비스 #### 통신 방식 표현 - **실선 (→)**: 동기적 의존성 (REST API) -- **점선 (-.->)**: 데이터베이스 읽기/쓰기 -- **굵은 화살표**: 이벤트 발행/구독 +- **점선 (-.->)**: 캐시 조회, 외부 시스템 호출, WebSocket 연결 +- **굵은 화살표 (==>)**: 이벤트 발행/구독 #### 색상 구분 - **파란색**: 클라이언트 - **노란색**: API Gateway - **초록색**: 핵심 서비스 (User, Meeting) -- **분홍색**: 전문 서비스 (STT, AI, RAG) -- **보라색**: 지원 서비스 (Collaboration, Todo, Notification) -- **주황색**: 인프라 (DB, Cache, Queue) +- **분홍색**: 전문 서비스 (STT, AI) +- **보라색**: 지원 서비스 (Notification) +- **하늘색**: 인프라 (Redis) +- **주황색**: 메시지 브로커 (RabbitMQ) - **회색**: 외부 서비스 --- @@ -759,13 +697,13 @@ HPA (Horizontal Pod Autoscaler) 설정: | UFR-AI-020 | Todo 자동 추출 | AI Service | ✅ | | UFR-AI-030 | 회의록 개선 | AI Service | ✅ | | UFR-AI-040 | 관련 회의록 연결 | AI Service | ✅ | -| UFR-RAG-010 | 전문용어 감지 | RAG Service | ✅ | -| UFR-RAG-020 | 맥락 기반 용어 설명 | RAG Service | ✅ | -| UFR-COLLAB-010 | 회의록 수정 동기화 | Collaboration Service | ✅ | -| UFR-COLLAB-020 | 충돌 해결 | Collaboration Service | ✅ | -| UFR-COLLAB-030 | 검증 완료 | Collaboration Service | ✅ | -| UFR-TODO-010 | Todo 할당 | Todo, Notification Services | ✅ | -| UFR-TODO-030 | Todo 완료 처리 | Todo, Meeting, Notification Services | ✅ | +| UFR-RAG-010 | 전문용어 감지 | AI Service | ✅ | +| UFR-RAG-020 | 맥락 기반 용어 설명 | AI Service | ✅ | +| UFR-COLLAB-010 | 회의록 수정 동기화 | Meeting Service | ✅ | +| UFR-COLLAB-020 | 충돌 해결 | Meeting Service | ✅ | +| UFR-COLLAB-030 | 검증 완료 | Meeting Service | ✅ | +| UFR-TODO-010 | Todo 할당 | Meeting, Notification Services | ✅ | +| UFR-TODO-030 | Todo 완료 처리 | Meeting, Notification Services | ✅ | **커버리지**: 24/24 (100%) @@ -826,16 +764,17 @@ HPA (Horizontal Pod Autoscaler) 설정: ### ADR-001: 마이크로서비스 아키텍처 선택 **날짜**: 2025-01-22 -**상태**: 승인 -**결정**: 8개 마이크로서비스로 분리 +**상태**: 수정됨 (ADR-007로 대체) +**결정**: ~~7개~~ → **5개 마이크로서비스**로 분리 **이유**: - 독립 배포 및 확장 가능 - 팀별 책임 명확화 - 기술 스택 다양화 가능 +- 서비스 통합으로 운영 복잡도 감소 (Meeting + Collaboration + Todo) **대안**: - 모놀리식: 초기 개발 속도는 빠르나 확장성 제한 -- 서비스 수 증가: 운영 복잡도 과도 +- 서비스 수 증가 (7개 이상): 운영 복잡도 과도 --- @@ -866,3 +805,101 @@ HPA (Horizontal Pod Autoscaler) 설정: **대안**: - Write-Through: 모든 쓰기 작업에서 캐시 업데이트 필요, 성능 저하 - Read-Through: 캐시 미스 시 캐시가 DB 조회, 복잡도 증가 + +--- + +### ADR-004: RAG Service를 AI Service에 통합 +**날짜**: 2025-01-22 +**상태**: 승인 +**결정**: RAG Service를 독립 서비스가 아닌 AI Service에 통합 +**이유**: +- RAG와 AI 모두 LLM 기반 처리로 긴밀하게 연동 +- 서비스 개수 감소로 운영 복잡도 감소 (8개 → 7개) +- 동일한 벡터 임베딩 모델 및 LLM 공유 가능 +- 회의록 자동 작성 시 용어 설명이 필요하므로 통합이 효율적 + +**대안**: +- RAG 독립 서비스: 서비스 수 증가, 네트워크 호출 증가, 운영 부담 + +--- + +### ADR-005: Collaboration → Meeting 통신을 REST API로 변경 +**날짜**: 2025-01-22 +**상태**: 승인 +**결정**: 섹션 검증 완료 시 MQ 이벤트가 아닌 REST API 동기 호출 +**이유**: +- 검증 완료 상태를 Meeting Service DB에 즉시 반영 필요 +- 실패 시 재시도 및 오류 처리가 명확 +- 이벤트 기반보다 동기 통신이 더 적합한 사례 + +**대안**: +- MQ 이벤트: 비동기 처리로 인한 일관성 지연, 실패 추적 어려움 + +--- + +### ADR-006: 실시간 텍스트 표시 제거 및 AI 분석 결과 통합 전송 +**날짜**: 2025-01-22 +**상태**: 승인 +**결정**: STT 변환 텍스트를 실시간으로 표시하지 않고, AI 분석 완료 후 통합 결과만 표시 +**이유**: +- 실시간 텍스트는 정확도가 낮고 오타가 많아 사용자 혼란 유발 +- AI 분석된 정리된 회의록이 더 높은 가치 제공 (주제별 분류, 요약, 전문용어 설명) +- 사용자는 정리된 회의록 + 전문용어 + 관련 자료를 통합하여 확인 +- 처리 시간 단축: ~~15초~~ → **13초** (실시간 텍스트 동기화 단계 제거) +- Collaboration Service의 역할 단순화: AI 분석 결과 통합 전송에 집중 + +**처리 흐름**: +1. STT Service: TranscriptReady 이벤트 발행 (5초 배치) +2. AI Service: 병렬 분석 (회의록 정리 + 전문용어 + 관련 자료) +3. AI Service: TranscriptSummaryCreated 이벤트 발행 +4. Meeting Service: 회의록 저장 → Collaboration Service에 REST API 호출 +5. Collaboration Service: WebSocket으로 통합 결과 전송 + +**대안**: +- 실시간 텍스트 표시 유지: 낮은 정확도, 높은 네트워크 트래픽, 사용자 혼란 + +--- + +### ADR-007: 서비스 통합 및 동기 의존성 제거 +**날짜**: 2025-01-22 +**상태**: 승인 +**결정**: Meeting, Collaboration, Todo 서비스를 Meeting Service로 통합하고, User Service 동기 참조 제거 + +**이유**: +- **복잡도 감소**: 7개 → 5개 서비스로 단순화, 운영 부담 감소 +- **성능 향상**: + - User Service 동기 호출 제거 → 네트워크 지연 제거 + - Todo/Collaboration 내부 메서드 호출 → 서비스 간 통신 오버헤드 제거 +- **장애 격리**: User Service 장애가 Meeting Service에 영향 없음 +- **일관성 향상**: Todo와 회의록이 동일 트랜잭션 내에서 처리 가능 +- **개발 효율성**: 하나의 서비스 내에서 회의록, Todo, 실시간 협업 기능 통합 개발 + +**변경 사항**: +1. **Meeting Service 통합**: + - Collaboration 기능 통합: WebSocket, 버전 관리, 충돌 해결 + - Todo 기능 통합: Todo CRUD, 진행 상황 추적, 회의록 연동 + - 데이터베이스: Meeting DB에 Todo, TranscriptVersion, CollaborationEvent 테이블 추가 + +2. **User Service 역할 변경**: + - 인증 전용: LDAP 인증, JWT 토큰 발급/검증만 담당 + - 프론트엔드 책임: 모든 API 요청에 사용자 정보(userId, userName, email) 포함 + - 동기 참조 제거: 다른 서비스는 User Service를 호출하지 않음 + +3. **이벤트 변경**: + - TodoCreated, TodoCompleted 발행자: ~~Todo Service~~ → **Meeting Service** + - TodoExtracted 제거: AI Service가 Meeting Service에 직접 Todo 정보 전송 + +**성능 개선**: +- User Service 동기 호출 제거: ~100ms 지연 제거 +- Todo 처리: 서비스 간 통신 → 내부 메서드 호출 (10배 빠름) +- 실시간 동기화: Collaboration Service → Meeting Service REST API 제거 + +**트레이드오프**: +- **Risk**: 프론트엔드에서 사용자 정보 조작 가능 → JWT 토큰 검증으로 완화 +- **복잡도 증가**: Meeting Service 코드 복잡도 증가 → 명확한 레이어 분리로 완화 +- **확장성 제한**: Meeting Service 단일 확장 → Stateless 설계로 수평 확장 가능 + +**대안**: +- 서비스 분리 유지: 운영 복잡도 높음, 네트워크 지연 존재 +- API Composition 패턴: 여전히 네트워크 호출 필요, 복잡도 증가 + diff --git a/design/backend/logical/logical-architecture.mmd b/design/backend/logical/logical-architecture.mmd index 942e206..a52edd9 100644 --- a/design/backend/logical/logical-architecture.mmd +++ b/design/backend/logical/logical-architecture.mmd @@ -1,59 +1,121 @@ graph TB + %% ======================================== + %% 클라이언트 레이어 + %% ======================================== + subgraph Client["클라이언트 레이어"] + WebApp["웹 애플리케이션
(React/Vue SPA)"] + end + + %% ======================================== + %% API Gateway 레이어 + %% ======================================== + subgraph Gateway["API Gateway 레이어"] + APIGateway["API Gateway
- JWT 인증/인가
- 서비스 라우팅
- Rate Limiting
- CORS 처리"] + end + + %% ======================================== %% 마이크로서비스 레이어 - subgraph Services["마이크로서비스"] + %% ======================================== + subgraph Services["마이크로서비스 레이어"] %% 핵심 서비스 - UserSvc["User Service
- 사용자 인증
- 권한 관리"] - MeetingSvc["Meeting Service
- 회의 관리
- 회의록 관리
- 회의록 공유"] + UserSvc["User Service
- 사용자 인증 (LDAP)
- JWT 토큰 발급"] + MeetingSvc["Meeting Service
- 회의 생애주기 관리
- 회의록 CRUD
- 템플릿 관리
- 회의 통계
- Todo 관리
- 실시간 동기화 (WebSocket)
- 버전 관리"] %% 전문 서비스 STTSvc["STT Service
- 음성 녹음
- 텍스트 변환
- 화자 식별"] - AISvc["AI Service
- 회의록 자동 작성
- Todo 추출
- 프롬프팅 개선"] - RAGSvc["RAG Service
- 맥락 기반 용어 설명
- 관련 문서 검색"] + AISvc["AI Service
- 회의록 자동 작성
- Todo 추출
- 프롬프팅 개선
- 전문용어 감지 (RAG)
- 맥락 기반 설명 (RAG)
- 관련 회의록 연결"] %% 지원 서비스 - CollabSvc["Collaboration Service
- 실시간 동기화
- 버전 관리
- 충돌 해결"] - TodoSvc["Todo Service
- Todo 할당/관리
- 진행 상황 추적
- 회의록 연동"] NotifySvc["Notification Service
- 알림 발송
- 리마인더 관리"] end - %% 메시지 브로커 - subgraph MQ["메시지 브로커"] - RabbitMQ["RabbitMQ
- Pub/Sub
- Queue-Based Load Leveling"] + %% ======================================== + %% 인프라 레이어 + %% ======================================== + subgraph Infrastructure["인프라 레이어"] + %% 캐시 + Redis["Redis
- 분산 캐시 (Cache-Aside)
- 작업 상태 저장
- 세션 관리"] + + %% 메시지 브로커 + RabbitMQ["RabbitMQ
- Pub/Sub 패턴
- Queue-Based Load Leveling"] end + %% ======================================== %% 외부 시스템 - External["외부 시스템
- STT 엔진
- LLM
- Email/SMS"] + %% ======================================== + subgraph External["외부 시스템"] + AzureSpeech["Azure Speech
(STT 엔진)"] + LLM["AI Model Server
(LLM)"] + EmailSMS["Email/SMS Service"] + end + %% ======================================== + %% 클라이언트 → API Gateway (동기) + %% ======================================== + WebApp -->|"HTTPS
모든 API 요청"| APIGateway + + %% ======================================== + %% API Gateway → 서비스 (동기 라우팅) + %% ======================================== + APIGateway -->|"/api/users/**"| UserSvc + APIGateway -->|"/api/meetings/**
/api/todos/**"| MeetingSvc + APIGateway -->|"/api/stt/**"| STTSvc + APIGateway -->|"/api/ai/**"| AISvc + APIGateway -->|"/api/notifications/**"| NotifySvc + + %% ======================================== + %% 클라이언트 → Meeting (WebSocket) + %% ======================================== + WebApp -.->|"WebSocket
실시간 동기화"| MeetingSvc + + %% ======================================== + %% 서비스 → Redis (캐시 우선 전략) + %% ======================================== + MeetingSvc -.->|"Cache-Aside
회의 정보/참여자/Todo"| Redis + AISvc -.->|"작업 상태 저장
Async Request-Reply"| Redis + + %% ======================================== + %% 서비스 간 동기 통신 제거 (프론트엔드에서 사용자 정보 전송) + %% ======================================== + + %% ======================================== %% 서비스 → RabbitMQ (이벤트 발행) - MeetingSvc -->|MeetingEnded| RabbitMQ - MeetingSvc -->|MeetingCreated| RabbitMQ - STTSvc -->|TranscriptReady| RabbitMQ - AISvc -->|TodoExtracted| RabbitMQ - AISvc -->|TranscriptCreated| RabbitMQ - CollabSvc -->|SectionVerified| RabbitMQ - TodoSvc -->|TodoCompleted| RabbitMQ + %% ======================================== + MeetingSvc ==>|"이벤트 발행"| RabbitMQ + STTSvc ==>|"이벤트 발행"| RabbitMQ + AISvc ==>|"이벤트 발행"| RabbitMQ - %% RabbitMQ → 서비스 (큐 구독) - RabbitMQ -->|STT 요청| STTSvc - RabbitMQ -->|AI 처리| AISvc - RabbitMQ -->|알림 발송| NotifySvc - RabbitMQ -->|Todo 생성| TodoSvc - RabbitMQ -->|회의 이벤트| CollabSvc + %% ======================================== + %% 이벤트 구독 정보 (노트) + %% ======================================== + Note1["📋 이벤트 구독 매핑

Meeting Service:
- TranscriptSummaryCreated

STT Service:
- MeetingEnded

AI Service:
- MeetingCreated
- MeetingEnded
- TranscriptReady

Notification Service:
- MeetingCreated
- MeetingEnded
- TranscriptCreated
- TodoCreated
- TodoCompleted"] + Note1 -.->|"참조"| RabbitMQ + + %% ======================================== %% 서비스 → 외부 시스템 - STTSvc -.->|음성 변환| External - AISvc -.->|LLM 요청| External - NotifySvc -.->|이메일/SMS| External + %% ======================================== + STTSvc -.->|"음성 변환 요청"| AzureSpeech + AISvc -.->|"LLM 요청"| LLM + NotifySvc -.->|"이메일/SMS 발송"| EmailSMS - %% 스타일 + %% ======================================== + %% 스타일 정의 + %% ======================================== + classDef client fill:#e3f2fd,stroke:#1976d2,stroke-width:3px + classDef gateway fill:#fff9c4,stroke:#f57f17,stroke-width:3px classDef core fill:#c8e6c9,stroke:#2e7d32,stroke-width:2px classDef special fill:#f8bbd0,stroke:#c2185b,stroke-width:2px classDef support fill:#d1c4e9,stroke:#512da8,stroke-width:2px - classDef mq fill:#fff9c4,stroke:#f57f17,stroke-width:3px + classDef infra fill:#b2ebf2,stroke:#00838f,stroke-width:2px + classDef mq fill:#ffe0b2,stroke:#e65100,stroke-width:3px classDef external fill:#cfd8dc,stroke:#455a64,stroke-width:2px + class WebApp client + class APIGateway gateway class UserSvc,MeetingSvc core - class STTSvc,AISvc,RAGSvc special - class CollabSvc,TodoSvc,NotifySvc support + class STTSvc,AISvc special + class NotifySvc support + class Redis infra class RabbitMQ mq - class External external + class AzureSpeech,LLM,EmailSMS external