mirror of
https://github.com/hwanny1128/HGZero.git
synced 2025-12-06 23:06:23 +00:00
8ab563fe86
- 프로토타입 05-회의진행.html 4개 탭 상세 분석
- AI 메모, 용어사전, 녹음 제어 기능 누락 API 7개 식별
- 우선순위별 구현 권장 순서 제시 (P0/P1/P2)
- 유저스토리 영향도 매핑 (US-06, US-07, US-08, US-09, US-10)
주요 누락 API:
- PUT /api/meetings/{meetingId}/memo (메모 저장)
- GET /api/ai/suggestions/realtime/{meetingId} (AI 실시간 추천)
- POST /api/ai/suggestions/{suggestionId}/adopt (AI 추천 채택)
- GET /api/ai/terms/search (용어 검색)
- GET /api/ai/terms/{termName}/detail (용어 상세)
- POST /api/stt/recordings/{recordingId}/pause (녹음 일시정지)
- POST /api/stt/recordings/{recordingId}/resume (녹음 재개)
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
96 lines
4.3 KiB
Markdown
96 lines
4.3 KiB
Markdown
# API 누락 요약표 (회의 진행 실시간 기능)
|
|
|
|
**작성일**: 2025년 10월 28일
|
|
**근거 문서**: [API리뷰-프로토타입vs구현.md](./API리뷰-프로토타입vs구현.md)
|
|
|
|
---
|
|
|
|
## 🔴 P0 (치명적 - 즉시 구현 필요)
|
|
|
|
| # | API | 프로토타입 근거 | 영향받는 유저스토리 | 비고 |
|
|
|---|-----|----------------|-------------------|------|
|
|
| 1 | `PUT /api/meetings/{meetingId}/memo` | [05-회의진행.html:1119-1143](../design/uiux/prototype/05-회의진행.html#L1119-L1143) | US-07, US-10 | 메모 저장 불가, 데이터 손실 위험 |
|
|
| 2 | `GET /api/ai/suggestions/realtime/{meetingId}` | [05-회의진행.html:767-806](../design/uiux/prototype/05-회의진행.html#L767-L806) | US-07, US-08 | AI 실시간 추천 완전 미동작 |
|
|
| 3 | `POST /api/stt/recordings/{recordingId}/pause` | [05-회의진행.html:1212-1243](../design/uiux/prototype/05-회의진행.html#L1212-L1243) | US-06 | 녹음 일시정지 불가 |
|
|
| 4 | `POST /api/stt/recordings/{recordingId}/resume` | [05-회의진행.html:1212-1243](../design/uiux/prototype/05-회의진행.html#L1212-L1243) | US-06 | 녹음 재개 불가 |
|
|
|
|
---
|
|
|
|
## 🟡 P1 (중요 - 우선 구현 필요)
|
|
|
|
| # | API | 프로토타입 근거 | 영향받는 유저스토리 | 비고 |
|
|
|---|-----|----------------|-------------------|------|
|
|
| 5 | `POST /api/ai/suggestions/{suggestionId}/adopt` | [05-회의진행.html:1070-1097](../design/uiux/prototype/05-회의진행.html#L1070-L1097) | US-07 | AI 추천 채택 불가, 수동 복붙 필요 |
|
|
| 6 | `GET /api/ai/terms/search` | [05-회의진행.html:1145-1182](../design/uiux/prototype/05-회의진행.html#L1145-L1182) | US-09 | 용어 검색 불가 |
|
|
|
|
---
|
|
|
|
## 🟢 P2 (일반 - 향후 개선)
|
|
|
|
| # | API | 프로토타입 근거 | 영향받는 유저스토리 | 비고 |
|
|
|---|-----|----------------|-------------------|------|
|
|
| 7 | `GET /api/ai/terms/{termName}/detail` | [05-회의진행.html:1305-1308](../design/uiux/prototype/05-회의진행.html#L1305-L1308) | US-09 | 용어 상세 조회 불가 |
|
|
|
|
---
|
|
|
|
## 📊 탭별 API 구현 현황
|
|
|
|
| 탭 | 기능 | 필요 API 수 | 구현 API 수 | 구현률 | 우선순위 |
|
|
|----|------|------------|------------|--------|---------|
|
|
| **참석자** | 참석자 관리 | 4 | 4 | 100% ✅ | - |
|
|
| **AI 메모** | 실시간 메모 & AI 추천 | 3 | 0 | 0% ❌ | P0 (3개) |
|
|
| **용어사전** | 용어 감지/검색 | 3 | 1 | 33% ⚠️ | P1 (1개), P2 (1개) |
|
|
| **관련회의록** | 유사 회의록 찾기 | 2 | 2 | 100% ✅ | - |
|
|
| **녹음 제어** | 녹음 상태 관리 | 5 | 3 | 60% ⚠️ | P0 (2개) |
|
|
|
|
---
|
|
|
|
## 🎯 구현 권장 순서
|
|
|
|
### Sprint 1 (1주) - P0 필수 기능
|
|
1. **메모 저장 API** (`PUT /api/meetings/{meetingId}/memo`)
|
|
- 예상 작업: 4시간
|
|
- 구현 위치: `MeetingController.java`
|
|
|
|
2. **AI 실시간 추천 API** (`GET /api/ai/suggestions/realtime/{meetingId}`)
|
|
- 예상 작업: 8시간
|
|
- 구현 위치: `SuggestionController.java`
|
|
- 폴링 또는 SSE 방식 선택 필요
|
|
|
|
3. **녹음 일시정지/재개 API** (`POST pause`, `POST resume`)
|
|
- 예상 작업: 6시간
|
|
- 구현 위치: `RecordingController.java`
|
|
|
|
### Sprint 2 (3일) - P1 중요 기능
|
|
4. **AI 추천 채택 API** (`POST /api/ai/suggestions/{suggestionId}/adopt`)
|
|
- 예상 작업: 4시간
|
|
|
|
5. **용어 검색 API** (`GET /api/ai/terms/search`)
|
|
- 예상 작업: 3시간
|
|
|
|
### Sprint 3 (2일) - P2 보조 기능
|
|
6. **용어 상세 조회 API** (`GET /api/ai/terms/{termName}/detail`)
|
|
- 예상 작업: 4시간
|
|
|
|
---
|
|
|
|
## 📝 비고
|
|
|
|
### 구현 고려사항
|
|
1. **AI 실시간 추천**: 폴링(Polling) vs SSE(Server-Sent Events) 방식 결정 필요
|
|
2. **메모 저장**: 개인별 메모 vs 공유 메모 정책 확인 필요
|
|
3. **녹음 일시정지**: 타이머 상태 동기화 로직 필요
|
|
4. **용어 검색**: 조직 용어 사전과 회의별 용어 통합 검색 정책 필요
|
|
|
|
### 테스트 시나리오
|
|
- [ ] 회의 진행 중 메모 작성 후 저장 → 다시 로드 시 메모 복원 확인
|
|
- [ ] AI 추천 메모 실시간 조회 → 5초마다 새 추천 확인
|
|
- [ ] AI 추천 채택 → 입력창에 시간 포함하여 추가 확인
|
|
- [ ] 용어 검색 → 키워드로 조직/회의 용어 찾기 확인
|
|
- [ ] 녹음 일시정지 → 타이머 정지 확인
|
|
- [ ] 녹음 재개 → 타이머 재개 확인
|
|
|
|
---
|
|
|
|
**문서 종료**
|