shared-dg05-coffeeQuokka/hgzero
1
0
Fork 0
mirror of https://github.com/hwanny1128/HGZero.git synced 2025-12-06 10:16:24 +00:00
Code Issues Packages Projects Releases Wiki Activity
hgzero/claudedocs/API-누락-요약표.md
yabo0812 8ab563fe86 docs: 회의 진행 실시간 기능 API 누락 분석 추가 
- 프로토타입 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>
2025-10-28 11:24:12 +09:00

4.3 KiB
Raw Blame History

API 누락 요약표 (회의 진행 실시간 기능)

작성일: 2025년 10월 28일 근거 문서: API리뷰-프로토타입vs구현.md

🔴 P0 (치명적 - 즉시 구현 필요)

# API 프로토타입 근거 영향받는 유저스토리 비고
1 PUT /api/meetings/{meetingId}/memo 05-회의진행.html:1119-1143 US-07, US-10 메모 저장 불가, 데이터 손실 위험
2 GET /api/ai/suggestions/realtime/{meetingId} 05-회의진행.html:767-806 US-07, US-08 AI 실시간 추천 완전 미동작
3 POST /api/stt/recordings/{recordingId}/pause 05-회의진행.html:1212-1243 US-06 녹음 일시정지 불가
4 POST /api/stt/recordings/{recordingId}/resume 05-회의진행.html:1212-1243 US-06 녹음 재개 불가

🟡 P1 (중요 - 우선 구현 필요)

# API 프로토타입 근거 영향받는 유저스토리 비고
5 POST /api/ai/suggestions/{suggestionId}/adopt 05-회의진행.html:1070-1097 US-07 AI 추천 채택 불가, 수동 복붙 필요
6 GET /api/ai/terms/search 05-회의진행.html:1145-1182 US-09 용어 검색 불가

🟢 P2 (일반 - 향후 개선)

# API 프로토타입 근거 영향받는 유저스토리 비고
7 GET /api/ai/terms/{termName}/detail 05-회의진행.html:1305-1308 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 중요 기능

  1. AI 추천 채택 API (POST /api/ai/suggestions/{suggestionId}/adopt)

    • 예상 작업: 4시간

  2. 용어 검색 API (GET /api/ai/terms/search)

    • 예상 작업: 3시간

Sprint 3 (2일) - P2 보조 기능

  1. 용어 상세 조회 API (GET /api/ai/terms/{termName}/detail)
    • 예상 작업: 4시간

📝 비고

구현 고려사항

  1. AI 실시간 추천: 폴링(Polling) vs SSE(Server-Sent Events) 방식 결정 필요
  2. 메모 저장: 개인별 메모 vs 공유 메모 정책 확인 필요
  3. 녹음 일시정지: 타이머 상태 동기화 로직 필요
  4. 용어 검색: 조직 용어 사전과 회의별 용어 통합 검색 정책 필요

테스트 시나리오

  • 회의 진행 중 메모 작성 후 저장 → 다시 로드 시 메모 복원 확인
  • AI 추천 메모 실시간 조회 → 5초마다 새 추천 확인
  • AI 추천 채택 → 입력창에 시간 포함하여 추가 확인
  • 용어 검색 → 키워드로 조직/회의 용어 찾기 확인
  • 녹음 일시정지 → 타이머 정지 확인
  • 녹음 재개 → 타이머 재개 확인

문서 종료