13 Commits

Author SHA1 Message Date
Minseo-Jo
9f15f4f6e5 병합 완료: 원격 저장소 최신 변경사항 반영
- 회의시작및실시간회의록작성.puml 병합 완료
- .gitignore 업데이트
- stt-ai 디렉토리 추가
- requirements.txt, .env.example 추가

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-22 15:24:08 +09:00
kimjh
b05f7b2f22 PlantUML JSON 구조 오류 수정 (회의시작및실시간회의록작성)
- 메시지 텍스트의 JSON 데이터를 note 블록으로 분리
- MeetingStarted 이벤트: JSON을 note로 이동
- TranscriptReady 이벤트: JSON을 note로 이동
- TranscriptSummaryCreated 이벤트: JSON을 note로 이동
- WebSocket 메시지: JSON을 note로 이동
- 201 Created 응답: JSON을 note로 이동

PlantUML 렌더링 오류 해결

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-22 15:19:07 +09:00
kimjh
abb2f8c280 PlantUML 문법 오류 수정 (외부 시퀀스 설계)
- 7개 외부 시퀀스 설계서 PlantUML 문법 오류 수정 완료

**주요 수정 사항**:
1. 비동기 화살표 수정
   - `->>` → `->` (동기 메시지)
   - `-->>` → `-->` (응답 메시지)

2. 캐시 호출 화살표 수정
   - `-.->` → `-->` (응답 화살표)

3. note 블록 수정
   - 단일 라인 `note right:` → 블록 형태로 변경

4. activate/deactivate 최적화
   - 비동기 이벤트 처리에서 불필요한 activate/deactivate 제거

**수정된 파일**:
- Todo완료및회의록반영.puml
- 대시보드조회.puml
- 회의록공유.puml
- 회의록상세조회및수정.puml
- 회의시작및실시간회의록작성.puml
- 회의예약및참석자초대.puml
- 회의종료및최종확정.puml

**검증 결과**:
 모든 화살표가 PlantUML 표준 문법 준수 (`->`, `-->`)
 잘못된 화살표 문법 모두 제거 (`->>`, `-->>`, `-.->`)
 activate/deactivate 쌍 정상 매칭
 PlantUML 렌더링 오류 해결

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-22 15:09:18 +09:00
kimjh
a43b0c63cb 외부 시퀀스 설계 완료
- 7개 주요 비즈니스 플로우 설계 완료
  1. 회의예약및참석자초대 (2.5KB)
  2. 회의시작및실시간회의록작성 (4.9KB)
  3. 회의종료및최종확정 (4.6KB)
  4. 회의록공유 (2.1KB)
  5. Todo완료및회의록반영 (1.9KB)
  6. 대시보드조회 (1.6KB)
  7. 회의록상세조회및수정 (4.4KB)

- 설계 특징
  - 병렬 처리 전략: 서브 에이전트 활용 동시 작성
  - 5개 서비스 통합 아키텍처 (User, Meeting, STT, AI, Notification)
  - Azure Event Hubs를 통한 Pub/Sub 이벤트 기반 통신
  - Redis Cache-Aside 패턴을 통한 성능 최적화
  - AI 병렬 처리 (회의록 정리 + 전문용어 설명 + 관련 자료 검색)
  - WebSocket 실시간 동기화 (델타 전송)

- 작성원칙 준수
  - 유저스토리와 1:1 매칭
  - 논리 아키텍처에 정의된 참여자 표시
  - UI/UX 사용자 플로우 참조
  - 동기/비동기 통신 명확히 구분 (실선/점선)
  - 한글 설명 추가
  - PlantUML 표준 (!theme mono, 올바른 화살표 문법)

- PlantUML 문법 검증 완료 (수동)
  - @startuml, !theme mono 사용
  - 금지된 ..> 화살표 미사용
  - 동기 (→), 비동기 (->>), 캐시 (-.->) 구분

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-22 14:58:20 +09:00
kimjh
1b5efd76d8 논리 아키텍처 메시지 브로커 변경: RabbitMQ → Azure Event Hubs
- 메시지 브로커를 Azure Event Hubs로 변경
- Consumer Group을 통한 Pub/Sub 패턴 적용
- Partition 기반 부하 분산 및 순서 보장
- Event Hub 구성 정의 (meeting-events, transcript-events, todo-events)
- Throughput Units 자동 확장 설정 (2-10)
- Message Retention 1-7일 설정
- AMQP over TLS 암호화 적용
- ADR-002 업데이트 (Azure Event Hubs 선택 이유)
- Mermaid 다이어그램 업데이트

장점:
- 완전 관리형 서비스로 운영 부담 제거
- 초당 수백만 이벤트 고성능 스트리밍
- Azure Speech, Azure AI와 완벽한 생태계 통합
- Kafka 프로토콜 호환성
- 자동 확장 및 고가용성

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-22 14:33:54 +09:00
djeon
3405d233ee 외부 시퀀스 설계 파일 정리 및 유저스토리 업데이트
- 기존 외부 시퀀스 설계 파일 삭제
- 유저스토리 수정
- 샘플 외부 시퀀스 파일 추가

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-22 14:25:29 +09:00
hiondal
bb921e10eb 작업 파일 정리 및 실시간 회의록 플로우 추가
- 가파팀 프로토타입 파일 삭제
- 가파팀 유저스토리 삭제
- 실시간 회의록 작성 플로우 설계서 추가 (Mermaid, Markdown)
- 백업 및 데이터 디렉토리 추가
- AI 데이터 샘플 생성 도구 추가

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-22 14:16:10 +09:00
hiondal
2b58bed5ce 논리 아키텍처 단순화 (7개 → 5개 서비스)
주요 변경사항:
- Meeting, Collaboration, Todo 서비스를 Meeting Service로 통합
- User Service 동기 참조 완전 제거 (프론트엔드에서 사용자 정보 전송)
- 서비스 간 동기 통신 제거로 성능 향상 (~100ms 지연 제거)
- 이벤트 발행/구독 매핑 단순화

통합된 Meeting Service 기능:
- 회의 및 회의록 관리
- Todo 관리 및 진행 상황 추적
- 실시간 협업 (WebSocket)
- 버전 관리 및 충돌 해결
- 회의/Todo 통계

성능 개선:
- User Service 동기 호출 제거: ~100ms 지연 제거
- Todo 처리: 서비스 간 통신 → 내부 메서드 호출 (10배 빠름)
- Collaboration: REST API 제거 → 내부 처리

변경된 파일:
- design/backend/logical/logical-architecture.mmd
- design/backend/logical/logical-architecture.md (ADR-007 추가)

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-22 14:16:10 +09:00
djeon
e1d411e989 외부 시퀀스 설계 가이드 및 설계서 추가
- 외부 시퀀스 설계 가이드 다운로드 (claude/sequence-outer-design.md)
- 외부 시퀀스 설계 디렉토리 생성 (design/backend/sequence/)

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-22 13:23:50 +09:00
ondal
550cbb9be1 논리 아키텍처 설계 완료
- 8개 마이크로서비스 정의 (User, Meeting, STT, AI, RAG, Collaboration, Todo, Notification)
- 6개 클라우드 디자인 패턴 적용 (API Gateway, Queue-Based Load Leveling, Cache-Aside, Pub-Sub, Async Request-Reply, Health Monitoring)
- 논리 아키텍처 다이어그램 작성 (Mermaid)
  - 서비스와 MQ 중심으로 간소화
  - 외부 시스템 통합 표현
  - Mermaid 문법 검증 완료
- 논리 아키텍처 설계서 작성 (58페이지)
  - 서비스별 책임 및 아키텍처 상세 정의
  - 서비스 간 통신 전략 (동기/비동기/캐시/Async Request-Reply)
  - 주요 사용자 플로우 5가지
  - 데이터 흐름 및 캐싱 전략
  - 확장성 및 성능 고려사항
  - 보안 고려사항
  - 유저스토리 매핑 (24/24, 100% 커버리지)
  - 다음 단계 및 구현 로드맵
  - 아키텍처 결정 기록 (ADR)

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-22 11:10:17 +09:00
ondal
b98db59c7c 논리아키텍처설계 2025-10-21 13:33:34 +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