# 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 추천 채택 → 입력창에 시간 포함하여 추가 확인
- [ ] 용어 검색 → 키워드로 조직/회의 용어 찾기 확인
- [ ] 녹음 일시정지 → 타이머 정지 확인
- [ ] 녹음 재개 → 타이머 재개 확인

---

**문서 종료**
