mirror of
https://github.com/nad4-su/meeting-minutes.git
synced 2026-08-12 22:33:25 +09:00
nad4
6e104cbca1
노션 AI Meeting Notes를 참고한 4단계 로드맵을 docs/ROADMAP.md에 정리. Phase 0(완료), Phase 1(워크스페이스), Phase 2(액션 아이템), Phase 3(참석자/태그), Phase 4(선택 — 화자 구분/캘린더/AI Q&A). README는 현재 구현 기능(실시간 요약, 자동 폴백, 네트워크 재연결 등)을 반영하고 테스트 38개, Docker tools 프로필 설명 추가. docs/CREATE_ISSUES.sh는 gh CLI로 4개 epic 이슈를 자동 생성.
185 lines
7.5 KiB
Markdown
185 lines
7.5 KiB
Markdown
# Meeting Minutes — ROADMAP
|
|
|
|
노션의 AI Meeting Notes 기능을 참고한 단계별 개발 계획. 개인/소규모 팀 사용 기준으로 범위 조정됨.
|
|
|
|
---
|
|
|
|
## ✅ Phase 0 — 기반 (완료)
|
|
|
|
### 구현됨
|
|
- [x] Web Speech API 기반 실시간 전사 (Chrome `ko-KR`)
|
|
- [x] 파일 업로드 검증 (MP3/WAV/WebM/M4A/OGG/FLAC, 최대 500MB)
|
|
- [x] 단순 변환 / Gemini AI 요약 두 모드
|
|
- [x] Markdown / HTML 내보내기, 클립보드 복사
|
|
- [x] Gemini 롤링 실시간 요약 (30초 간격, 25/40단어 게이트)
|
|
- [x] 녹음 종료 시 최종 회의록 자동 생성
|
|
- [x] 429 쿼터 초과 자동 쿨다운 + 지수 백오프
|
|
- [x] Gemini 실패 시 단순 변환 자동 폴백
|
|
- [x] 네트워크 에러 자동 재연결 (최대 8회)
|
|
- [x] 좌우 분할 UI (실시간 텍스트 / 실시간 회의록)
|
|
- [x] 자동 스크롤, 진행률 바, 쿨다운 카운터
|
|
- [x] Docker Compose (app + db + test profile)
|
|
- [x] 단위 테스트 38개 통과
|
|
- [x] Prisma 7 호환 스키마 (아직 미사용)
|
|
|
|
### 알려진 제약
|
|
- Chrome 전용 (Web Speech API)
|
|
- 화자 구분 불가 (Web Speech API 한계)
|
|
- 녹음 저장/조회 불가 (DB 미사용)
|
|
- Web Speech 세션이 가끔 끊김 → 자동 재연결로 완화
|
|
|
|
---
|
|
|
|
## 🎯 Phase 1 — 회의 저장/조회 (1~2주)
|
|
|
|
노션의 **Meeting Database** 수준. 생성한 회의록을 저장하고 다시 찾아볼 수 있게 함.
|
|
|
|
### Issues
|
|
- [ ] **#1 Prisma 연결 + 마이그레이션 파이프라인**
|
|
- `src/lib/db.ts` 싱글톤 Prisma 클라이언트
|
|
- 첫 마이그레이션 생성 (`prisma migrate dev`)
|
|
- Dockerfile에 `prisma migrate deploy` 추가
|
|
- Meeting 스키마에 `attendees` (String[]), `tags` (String[]) 필드 추가
|
|
- [ ] **#2 회의 저장 API**
|
|
- `POST /api/meetings` — transcript + markdown 저장
|
|
- `GET /api/meetings` — 목록 조회 (최신순, 페이지네이션)
|
|
- `GET /api/meetings/[id]` — 상세
|
|
- `PUT /api/meetings/[id]` — markdown 편집 저장
|
|
- `DELETE /api/meetings/[id]`
|
|
- [ ] **#3 MinutesViewer에 "저장" 버튼**
|
|
- 생성된 회의록 현재 세션에서 저장 → 토스트 알림
|
|
- 저장 성공 시 `/meetings/[id]` 링크 제공
|
|
- [ ] **#4 회의 목록 페이지** (`/meetings`)
|
|
- 카드 그리드 (제목, 날짜, 앞 2줄 미리보기, 태그)
|
|
- 빈 상태 UI ("첫 회의를 녹음해보세요")
|
|
- [ ] **#5 회의 상세 페이지** (`/meetings/[id]`)
|
|
- Transcript + Markdown 렌더링
|
|
- 인라인 편집 (markdown editor 도입 — 아래 #6)
|
|
- 삭제 버튼
|
|
- [ ] **#6 Markdown 렌더링 라이브러리 도입**
|
|
- `marked` + `isomorphic-dompurify`
|
|
- 기존 커스텀 파서(`export-minutes.ts`) 교체 — 표/리스트/인라인 스타일 정상 렌더
|
|
- [ ] **#7 전역 검색**
|
|
- Postgres `tsvector` 전체 텍스트 인덱스 (transcript + markdown)
|
|
- `/api/meetings?q=...` 엔드포인트
|
|
- 헤더에 검색 바 추가
|
|
|
|
---
|
|
|
|
## 🎯 Phase 2 — 구조화된 액션 아이템 (1주)
|
|
|
|
회의가 끝나면 **"내 할 일"이 자동으로 추출되어 체크리스트로 남음**. 노션 AI의 핵심 가치.
|
|
|
|
### Issues
|
|
- [ ] **#8 Gemini 프롬프트 개선 — JSON 출력**
|
|
- `generateGeminiMinutes`가 마크다운 대신 `{ summary, discussion, actionItems: [{ assignee, due, task }], decisions }` 반환
|
|
- JSON schema validation (zod)
|
|
- [ ] **#9 ActionItem 테이블 + 관계**
|
|
- `Meeting` ↔ `ActionItem` (1:N)
|
|
- 필드: `id`, `meetingId`, `assignee`, `task`, `dueDate`, `isDone`, `createdAt`
|
|
- [ ] **#10 체크리스트 UI**
|
|
- 회의 상세 페이지에 별도 섹션
|
|
- 체크박스 토글 → `PATCH /api/action-items/[id]`
|
|
- [ ] **#11 대시보드 페이지** (`/`)
|
|
- "내 미완료 액션 아이템" 리스트
|
|
- 최근 회의 3건 미리보기
|
|
- 홈으로 승격, 녹음 UI는 `/record`로 이동
|
|
|
|
---
|
|
|
|
## 🎯 Phase 3 — 참석자 + 태그 (3~5일)
|
|
|
|
### Issues
|
|
- [ ] **#12 참석자 입력 UI**
|
|
- 녹음 시작 전 쉼표 구분 입력 ("이름1, 이름2")
|
|
- 회의 상세에서 편집 가능
|
|
- [ ] **#13 태그 시스템**
|
|
- 프리셋: `sprint`, `1on1`, `review`, `planning`, `retro`
|
|
- 사용자 정의 태그 추가
|
|
- 목록 페이지에 태그 필터
|
|
- [ ] **#14 Gemini에 참석자 컨텍스트 주입**
|
|
- 프롬프트에 참석자 이름 포함 → 액션 아이템 담당자 배정 정확도 ↑
|
|
|
|
---
|
|
|
|
## 🎯 Phase 4 — 차별화 기능 (선택, 각 1~2주)
|
|
|
|
### #15 화자 구분 (Speaker Diarization)
|
|
Web Speech API는 화자 구분을 지원하지 않음. 후처리 전략이 필요.
|
|
|
|
**접근 방법 비교:**
|
|
|
|
| 방법 | 정확도 | 비용 | 한국어 | 실시간 |
|
|
|---|---|---|---|---|
|
|
| **Gemini 2.5 Flash (오디오 입력)** | 중 | 무료 (RPM 한도 내) | 좋음 | ❌ 후처리만 |
|
|
| **AssemblyAI** | 매우 높음 | $0.15/hr (5hr/월 무료) | 좋음 | ✅ 가능 |
|
|
| **Deepgram Nova-2** | 높음 | $0.43/hr ($200 무료 크레딧) | 보통 | ✅ 가능 |
|
|
| **Google Cloud STT** | 높음 | $1.44/hr | 좋음 | ✅ 가능 |
|
|
|
|
**권장 구조 — 하이브리드:**
|
|
```
|
|
[클라이언트]
|
|
├─ Web Speech API → 실시간 미리보기 (기존)
|
|
└─ MediaRecorder → audio blob 누적 (신규)
|
|
|
|
[녹음 종료]
|
|
└─ POST /api/transcribe-with-speakers (audio blob)
|
|
└─ Gemini 2.5 Flash OR AssemblyAI
|
|
└─ 화자 라벨 붙은 최종 transcript
|
|
└─ 기존 /api/summarize 파이프라인 재사용
|
|
```
|
|
|
|
**이점:**
|
|
- 녹음 중에는 지금처럼 빠른 미리보기 유지
|
|
- 종료 후 고품질 화자 구분 transcript로 최종 회의록 생성
|
|
- 개인용이면 Gemini 2.5로 무료 처리 가능
|
|
|
|
**세부 이슈:**
|
|
- [ ] **#15a** 클라이언트에 MediaRecorder 병행 녹음 (WebM/Opus)
|
|
- [ ] **#15b** `/api/transcribe-with-speakers` — Gemini 2.5 Flash audio input
|
|
- [ ] **#15c** 화자 라벨 transcript 뷰 (화자별 색상 배지)
|
|
- [ ] **#15d** AssemblyAI 어댑터 (옵션, 정확도 업그레이드 경로)
|
|
|
|
### #16 Google Calendar 연동 (1~2주)
|
|
- OAuth 플로우 (`next-auth` + Google provider)
|
|
- 오늘 회의 목록 표시
|
|
- 캘린더 이벤트 → 회의 페이지 프리셋 (제목, 참석자 자동 채움)
|
|
- 회의 종료 시 이벤트 설명에 회의록 링크 자동 추가
|
|
|
|
### #17 AI Q&A ("과거 회의 검색" - RAG) (2주)
|
|
- 회의별 embedding 생성 (Gemini embedding API 또는 OpenAI)
|
|
- pgvector 확장 설치
|
|
- `/api/ask` — 자연어 질문 → 관련 회의 검색 + Gemini 답변
|
|
- UI: 검색바에 "질문하기" 모드 추가
|
|
|
|
### #18 후속 이메일 초안 생성 (2일)
|
|
- `/api/meetings/[id]/follow-up-email` — Gemini 프롬프트로 요약 이메일 생성
|
|
- 복사/Gmail 열기 버튼
|
|
|
|
### #19 블록 기반 에디터 (2~4주)
|
|
- TipTap 또는 Lexical 도입
|
|
- `/` 슬래시 명령어, 다양한 블록 타입
|
|
- 우선순위 낮음 — 개인 사용에선 현재 markdown textarea로 충분
|
|
|
|
---
|
|
|
|
## ❌ 명시적 비목표 (Non-goals)
|
|
|
|
다음 기능은 개인 사용 목적에 부합하지 않아 **의도적으로 범위 밖**:
|
|
|
|
- **실시간 공동 편집 (CRDT)** — Yjs/Liveblocks 도입 복잡도 대비 이득 없음
|
|
- **권한 관리 / 워크스페이스** — 단일 사용자 가정
|
|
- **모바일 네이티브 앱** — 웹 PWA로 충분
|
|
- **노션 수준의 전역 페이지 트리** — 회의록 전용 도구로 집중
|
|
|
|
---
|
|
|
|
## 진행 관리 규칙
|
|
|
|
1. **Phase 단위로 GitHub Issue 생성** (각 phase를 epic issue로, 세부 `#N`을 task로)
|
|
2. **이슈당 1 브랜치 1 PR**: `feat/1-prisma-setup`, `feat/2-meetings-api` …
|
|
3. **PR 머지 전**: `docker compose --profile tools run --rm test` 전체 통과 필수
|
|
4. **완료 시 ROADMAP 체크박스 업데이트** (이 파일을 single source of truth로 유지)
|
|
|
|
이슈 생성 커맨드는 `docs/CREATE_ISSUES.sh` 참고.
|