docs: ROADMAP 추가, README에 Phase 0 현황 반영

노션 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 이슈를 자동 생성.

README.md

@@ -1,133 +1,168 @@
-# Meeting Minutes - 회의록 자동 작성 서비스
+# Meeting Minutes — 실시간 AI 회의록
 
-음성 녹음을 텍스트로 변환하고, 구조화된 회의록을 자동 생성하는 웹 서비스입니다.
+음성 녹음을 실시간으로 텍스트·요약으로 변환하고, 구조화된 회의록을 자동 생성하는 웹 서비스.
 
-## 주요 기능
+향후 로드맵 — 노션 AI Meeting Notes 수준의 워크스페이스: [`docs/ROADMAP.md`](docs/ROADMAP.md)
 
-- **실시간 녹음** — 브라우저에서 바로 음성 인식 (Web Speech API, Chrome 권장)
+---
-- **파일 업로드** — MP3, WAV, WebM, M4A, OGG, FLAC 지원 (최대 500MB)
+
-- **두 가지 변환 모드** — 단순 STT→마크다운 변환 / Gemini AI 요약 비교
+## 현재 기능 (Phase 0)
-- **내보내기** — 마크다운(.md), HTML(.html) 다운로드 및 클립보드 복사
+
-- **회의록 저장** — PostgreSQL 데이터베이스 영속 저장
+### 녹음 & 전사
+- 브라우저 실시간 음성 인식 (Web Speech API · Chrome `ko-KR`)
+- 네트워크 끊김 시 **자동 재연결** (최대 8회) — 누적 transcript 보존
+- 파일 업로드: MP3, WAV, WebM, M4A, OGG, FLAC (최대 500MB)
+- 인식된 텍스트는 textarea에서 직접 편집 가능
+
+### AI 요약 (Gemini)
+- **실시간 회의록**: 녹음 중 30초 간격으로 Gemini가 중간 요약 갱신 (25단어 이상, 40단어 증분 게이트)
+- **최종 회의록**: 녹음 중지 시 자동 생성
+- 모델: `gemini-2.5-flash-lite` (개인 무료 등급에서 여유있게 동작)
+- 429 쿼터 초과 시 **60초 쿨다운** + UI 안내, 그 외 실패는 지수 백오프
+- Gemini 실패 시 **단순 변환 마크다운으로 자동 폴백** — 결과물은 항상 보장
+- 내보내기: Markdown(.md), HTML(.html), 클립보드 복사
+
+### 화면
+- 녹음 시 **좌(실시간 텍스트) · 우(실시간 회의록)** 분할 뷰
+- 확정 전 interim 텍스트는 회색 이탤릭 + 깜빡이는 커서
+- 새 내용 도착 시 자동 스크롤
+- 진행률 바 (첫 요약까지 단어 수), 쿨다운 카운터
+
+---
 
 ## 기술 스택
 
 | 구분 | 기술 |
 |------|------|
-| 프레임워크 | Next.js 16 + TypeScript |
+| 프레임워크 | Next.js 16 (App Router) + TypeScript |
-| STT | Web Speech API (무료) |
+| STT (실시간) | Web Speech API — Chrome 내장, 무료 |
-| AI 요약 | Gemini API (무료 티어) |
+| AI 요약 | Gemini 2.5 Flash Lite — 무료 등급 15 RPM / 1000 RPD |
-| DB | PostgreSQL 16 + Prisma ORM |
+| DB | PostgreSQL 16 + Prisma 7 (스키마 준비, Phase 1에서 활용 예정) |
-| 테스트 | Vitest (31개 테스트, 96% 커버리지) |
+| 테스트 | Vitest (38 tests, jsdom) |
-| 배포 | Docker Compose |
+| 배포 | Docker Compose (app + db + test profile) |
 
-## Docker로 실행하기
+---
 
-### 사전 요구사항
+## 빠른 시작 (Docker Compose)
 
-- [Docker](https://docs.docker.com/get-docker/) 및 [Docker Compose](https://docs.docker.com/compose/install/) 설치
+### 1. 준비
-
-### 1. 저장소 클론
 
 ```bash
 git clone git@github.com:nad4-su/meeting-minutes.git
 cd meeting-minutes
-```
-
-### 2. 환경 변수 설정
-
-```bash
 cp .env.example .env
 ```
 
-`.env` 파일을 열어 필요한 값을 수정합니다:
+`.env`에서 **`GEMINI_API_KEY`** 설정 ([Google AI Studio](https://aistudio.google.com/apikey)에서 무료 발급).
+> 키가 없어도 "단순 변환" 모드는 정상 동작.
 
-```env
+### 2. 기동
-# PostgreSQL (기본값 사용 가능)
-DATABASE_URL="postgresql://meetinguser:meetingpass@db:5432/meetingminutes"
-POSTGRES_USER=meetinguser
-POSTGRES_PASSWORD=meetingpass
-POSTGRES_DB=meetingminutes
-
-# Gemini API (선택사항 - AI 요약 기능에 필요)
-# https://aistudio.google.com/apikey 에서 무료 발급
-GEMINI_API_KEY=여기에_API_키_입력
-```
-
-> Gemini API 키가 없어도 **단순 변환** 모드는 정상 동작합니다.
-
-### 3. Docker Compose 실행
 
 ```bash
-docker compose up -d
+docker compose up -d --build
 ```
 
-처음 실행 시 이미지 빌드에 시간이 걸릴 수 있습니다.
+브라우저에서 [http://localhost:3000](http://localhost:3000) 접속 → **Chrome 권장** (Web Speech API).
 
-### 4. DB 마이그레이션
+### 3. 확인 방법
 
-```bash
+1. 회의 제목 입력 (선택)
-docker compose exec app npx prisma migrate deploy
+2. **Gemini AI 요약** 모드 (기본값)
-```
+3. **녹음 시작** → 마이크 권한 허용
-
+4. 말하기 시작 → 좌측 실시간 텍스트, 25단어 이상 쌓이면 우측에 중간 회의록 생성
-### 5. 접속
+5. **녹음 중지** → 최종 회의록이 페이지 하단에 자동 생성됨
-
-브라우저에서 [http://localhost:3000](http://localhost:3000)에 접속합니다.
 
 ### 서비스 관리
 
 ```bash
-# 로그 확인
+docker compose logs -f app           # 로그
-docker compose logs -f app
+docker compose restart app           # 재시작
-
+docker compose down                  # 중지 (데이터 유지)
-# 서비스 중지
+docker compose down -v               # 중지 + 볼륨 삭제
-docker compose down
+docker compose up -d --build         # 코드 변경 후 재빌드
-
-# 서비스 중지 + DB 데이터 삭제
-docker compose down -v
-
-# 이미지 재빌드 (코드 변경 후)
-docker compose up -d --build
 ```
 
+### 테스트 (Docker)
+
+```bash
+docker compose --profile tools run --rm test
+```
+
+별도 Node 설치 불필요. `tools` 프로필 컨테이너에서 `vitest` 실행.
+
+---
+
 ## 로컬 개발 (Docker 없이)
 
 ```bash
 npm install
-npm run dev
+npm run dev               # http://localhost:3000
-```
-
-[http://localhost:3000](http://localhost:3000)에서 확인합니다.
-
-### 테스트
-
-```bash
 npm test                  # 전체 테스트
-npm run test:watch      # 워치 모드
 npm run test:coverage     # 커버리지 리포트
 ```
 
+---
+
 ## 프로젝트 구조
 
 ```
 src/
 ├── app/
 │   ├── api/
-│   │   ├── upload/route.ts         # 파일 업로드 API
+│   │   ├── upload/route.ts              # 파일 업로드
-│   │   └── summarize/route.ts      # 회의록 생성 API
+│   │   ├── summarize/route.ts           # 최종 회의록 (Gemini + simple fallback)
+│   │   └── summarize-live/route.ts      # 실시간 중간 요약
 │   ├── page.tsx                         # 메인 UI
 │   └── layout.tsx
 ├── lib/
-│   ├── audio-validation.ts         # 오디오 파일 검증
+│   ├── audio-validation.ts
-│   ├── upload-handler.ts           # 업로드 처리
+│   ├── upload-handler.ts
-│   ├── transcript-formatter.ts     # STT 결과 포매팅
+│   ├── transcript-formatter.ts
-│   ├── minutes-generator.ts        # 회의록 생성 (단순/Gemini)
+│   ├── minutes-generator.ts             # 최종 요약 생성
-│   └── export-minutes.ts           # MD/HTML 내보내기
+│   ├── live-summary.ts                  # 롤링 요약 생성
+│   └── export-minutes.ts
 ├── hooks/
-│   └── useSpeechRecognition.ts     # 실시간 음성 인식 훅
+│   ├── useSpeechRecognition.ts          # Web Speech API + 네트워크 재시도
+│   └── useLiveSummary.ts                # 30s 폴링 + 429 쿨다운 + 증분 게이트
 ├── components/
 │   ├── upload/AudioUploader.tsx
-│   ├── recorder/LiveRecorder.tsx
+│   ├── recorder/LiveRecorder.tsx        # 좌우 분할 뷰
 │   └── minutes/MinutesViewer.tsx
-└── __tests__/                      # 31개 테스트
+└── __tests__/                           # 38 tests
+
+docs/
+├── ROADMAP.md                           # 개발 로드맵 (Phase 0~4)
+└── CREATE_ISSUES.sh                     # gh CLI용 이슈 자동 생성 스크립트
+
+prisma/
+└── schema.prisma                        # Meeting 모델 (Phase 1에서 활용)
 ```
+
+---
+
+## 로드맵 요약
+
+상세: [`docs/ROADMAP.md`](docs/ROADMAP.md)
+
+| Phase | 내용 | 상태 |
+|---|---|---|
+| **0** | 실시간 전사 + 롤링 요약 + 자동 최종 생성 | ✅ 완료 |
+| **1** | 회의 저장/조회/검색 워크스페이스 | 📋 기획됨 |
+| **2** | 구조화된 액션 아이템 (Gemini JSON + 체크리스트) | 📋 기획됨 |
+| **3** | 참석자 + 태그 시스템 | 📋 기획됨 |
+| **4** | 차별화 기능 (화자 구분, 캘린더, AI Q&A, 블록 에디터) | 💡 선택 |
+
+### 진행 관리
+1. `gh auth login` 후 `bash docs/CREATE_ISSUES.sh` — 4개 epic issue 자동 생성
+2. 이슈당 1 브랜치 1 PR 원칙
+3. PR 머지 전 `docker compose --profile tools run --rm test` 필수
+4. 완료 시 `docs/ROADMAP.md` 체크박스 업데이트
+
+---
+
+## 알려진 제약
+
+- **Chrome 전용**: Web Speech API 비표준 — Safari/Firefox는 제한적 (Phase 4 #15에서 서버 사이드 전사로 해결 예정)
+- **화자 구분 불가**: Web Speech API가 지원하지 않음. Phase 4 #15에서 Gemini 2.5 오디오 입력 또는 AssemblyAI 경로 계획됨
+- **녹음 저장 없음**: 현재 페이지 세션 내에서만 유지됨. Phase 1에서 DB 영속화
+- **Gemini 무료 등급**: 15 RPM / 1000 RPD — 개인 사용에 충분하나 팀 단위는 유료 전환 권장

docs/CREATE_ISSUES.sh

@@ -0,0 +1,103 @@
+#!/usr/bin/env bash
+# GitHub Issues 생성 스크립트
+# 사전 조건: gh auth login 완료, 저장소 내에서 실행
+# 사용: bash docs/CREATE_ISSUES.sh
+
+set -euo pipefail
+
+if ! command -v gh >/dev/null 2>&1; then
+  echo "gh CLI가 필요합니다: brew install gh"
+  exit 1
+fi
+
+if ! gh auth status >/dev/null 2>&1; then
+  echo "GitHub 로그인이 필요합니다: gh auth login"
+  exit 1
+fi
+
+# Epic 레이블 생성 (이미 있으면 무시)
+gh label create "phase-1" --color "0e8a16" --description "Phase 1 — Workspace basics" 2>/dev/null || true
+gh label create "phase-2" --color "1d76db" --description "Phase 2 — Action items" 2>/dev/null || true
+gh label create "phase-3" --color "5319e7" --description "Phase 3 — Attendees & tags" 2>/dev/null || true
+gh label create "phase-4" --color "b60205" --description "Phase 4 — Advanced (opt-in)" 2>/dev/null || true
+gh label create "epic" --color "fbca04" --description "Phase-level epic" 2>/dev/null || true
+
+# Epic issues (각 phase 하나씩)
+gh issue create \
+  --title "[Epic] Phase 1 — 회의 저장/조회 워크스페이스" \
+  --label "epic,phase-1" \
+  --body "$(cat <<'BODY'
+노션 Meeting Database 수준 구현. 세부 내용은 [docs/ROADMAP.md](../blob/main/docs/ROADMAP.md) 참조.
+
+## 하위 작업
+- [ ] #1 Prisma 연결 + 마이그레이션 파이프라인
+- [ ] #2 회의 저장 API (GET/POST/PUT/DELETE)
+- [ ] #3 MinutesViewer 저장 버튼
+- [ ] #4 회의 목록 페이지
+- [ ] #5 회의 상세 페이지
+- [ ] #6 Markdown 렌더링 라이브러리 도입 (marked + DOMPurify)
+- [ ] #7 전역 검색 (Postgres tsvector)
+
+## 완료 기준
+- 녹음한 회의를 DB에 저장하고 나중에 재조회/편집 가능
+- Markdown이 표·리스트·인라인 포맷 제대로 렌더됨
+- 제목/transcript 검색 동작
+BODY
+)"
+
+gh issue create \
+  --title "[Epic] Phase 2 — 구조화된 액션 아이템" \
+  --label "epic,phase-2" \
+  --body "$(cat <<'BODY'
+"회의 끝나면 내 할 일이 명확" 경험 제공. 세부: [docs/ROADMAP.md](../blob/main/docs/ROADMAP.md).
+
+## 하위 작업
+- [ ] #8 Gemini 프롬프트 JSON 출력 + zod 검증
+- [ ] #9 ActionItem 테이블 + Meeting 관계
+- [ ] #10 체크리스트 UI (체크박스 토글)
+- [ ] #11 대시보드 페이지 (미완료 액션 + 최근 회의)
+
+## 완료 기준
+- 회의 생성 시 액션 아이템이 구조화 저장됨
+- 사용자가 홈에서 미완료 할 일을 한눈에 확인
+BODY
+)"
+
+gh issue create \
+  --title "[Epic] Phase 3 — 참석자 + 태그" \
+  --label "epic,phase-3" \
+  --body "$(cat <<'BODY'
+회의 메타데이터 관리 + 필터링. 세부: [docs/ROADMAP.md](../blob/main/docs/ROADMAP.md).
+
+## 하위 작업
+- [ ] #12 참석자 입력 UI
+- [ ] #13 태그 시스템 (프리셋 + 커스텀)
+- [ ] #14 Gemini 프롬프트에 참석자 컨텍스트 주입
+
+## 완료 기준
+- 회의 목록에서 참석자/태그로 필터링 가능
+- 액션 아이템 담당자 자동 배정 정확도 개선
+BODY
+)"
+
+gh issue create \
+  --title "[Epic] Phase 4 — 차별화 기능 (화자 구분, 캘린더, AI Q&A)" \
+  --label "epic,phase-4" \
+  --body "$(cat <<'BODY'
+선택적 고급 기능. 각 이슈 단독 진행 가능. 세부: [docs/ROADMAP.md](../blob/main/docs/ROADMAP.md).
+
+## 하위 작업
+- [ ] #15 화자 구분 (Gemini 2.5 audio input + MediaRecorder 하이브리드)
+- [ ] #16 Google Calendar 연동
+- [ ] #17 AI Q&A (RAG with pgvector)
+- [ ] #18 후속 이메일 초안 생성
+- [ ] #19 블록 기반 에디터 (우선순위 낮음)
+
+## 완료 기준
+각 sub-issue 독립 완료. 전체 Phase 4 완료는 #15 + #18 최소 달성 시 간주.
+BODY
+)"
+
+echo ""
+echo "✅ 4개 epic issue 생성 완료"
+echo "세부 task 이슈는 해당 phase 작업 시작 시 개별 생성 권장"

docs/ROADMAP.md

@@ -0,0 +1,184 @@
+# 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` 참고.