diff --git a/README.md b/README.md index 1e160e0..b3c6192 100644 --- a/README.md +++ b/README.md @@ -1,111 +1,107 @@ -# 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 요약 비교 -- **내보내기** — 마크다운(.md), HTML(.html) 다운로드 및 클립보드 복사 -- **회의록 저장** — PostgreSQL 데이터베이스 영속 저장 +--- + +## 현재 기능 (Phase 0) + +### 녹음 & 전사 +- 브라우저 실시간 음성 인식 (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 | -| STT | Web Speech API (무료) | -| AI 요약 | Gemini API (무료 티어) | -| DB | PostgreSQL 16 + Prisma ORM | -| 테스트 | Vitest (31개 테스트, 96% 커버리지) | -| 배포 | Docker Compose | +| 프레임워크 | Next.js 16 (App Router) + TypeScript | +| STT (실시간) | Web Speech API — Chrome 내장, 무료 | +| AI 요약 | Gemini 2.5 Flash Lite — 무료 등급 15 RPM / 1000 RPD | +| DB | PostgreSQL 16 + Prisma 7 (스키마 준비, Phase 1에서 활용 예정) | +| 테스트 | Vitest (38 tests, jsdom) | +| 배포 | 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 -# 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 실행 +### 2. 기동 ```bash -docker compose up -d +docker compose up -d --build ``` -처음 실행 시 이미지 빌드에 시간이 걸릴 수 있습니다. +브라우저에서 [http://localhost:3000](http://localhost:3000) 접속 → **Chrome 권장** (Web Speech API). -### 4. DB 마이그레이션 +### 3. 확인 방법 -```bash -docker compose exec app npx prisma migrate deploy -``` - -### 5. 접속 - -브라우저에서 [http://localhost:3000](http://localhost:3000)에 접속합니다. +1. 회의 제목 입력 (선택) +2. **Gemini AI 요약** 모드 (기본값) +3. **녹음 시작** → 마이크 권한 허용 +4. 말하기 시작 → 좌측 실시간 텍스트, 25단어 이상 쌓이면 우측에 중간 회의록 생성 +5. **녹음 중지** → 최종 회의록이 페이지 하단에 자동 생성됨 ### 서비스 관리 ```bash -# 로그 확인 -docker compose logs -f app - -# 서비스 중지 -docker compose down - -# 서비스 중지 + DB 데이터 삭제 -docker compose down -v - -# 이미지 재빌드 (코드 변경 후) -docker compose up -d --build +docker compose logs -f app # 로그 +docker compose restart app # 재시작 +docker compose down # 중지 (데이터 유지) +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 +npm test # 전체 테스트 +npm run test:coverage # 커버리지 리포트 ``` -[http://localhost:3000](http://localhost:3000)에서 확인합니다. - -### 테스트 - -```bash -npm test # 전체 테스트 -npm run test:watch # 워치 모드 -npm run test:coverage # 커버리지 리포트 -``` +--- ## 프로젝트 구조 @@ -113,21 +109,60 @@ npm run test:coverage # 커버리지 리포트 src/ ├── app/ │ ├── api/ -│ │ ├── upload/route.ts # 파일 업로드 API -│ │ └── summarize/route.ts # 회의록 생성 API -│ ├── page.tsx # 메인 UI +│ │ ├── upload/route.ts # 파일 업로드 +│ │ ├── summarize/route.ts # 최종 회의록 (Gemini + simple fallback) +│ │ └── summarize-live/route.ts # 실시간 중간 요약 +│ ├── page.tsx # 메인 UI │ └── layout.tsx ├── lib/ -│ ├── audio-validation.ts # 오디오 파일 검증 -│ ├── upload-handler.ts # 업로드 처리 -│ ├── transcript-formatter.ts # STT 결과 포매팅 -│ ├── minutes-generator.ts # 회의록 생성 (단순/Gemini) -│ └── export-minutes.ts # MD/HTML 내보내기 +│ ├── audio-validation.ts +│ ├── upload-handler.ts +│ ├── transcript-formatter.ts +│ ├── minutes-generator.ts # 최종 요약 생성 +│ ├── 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 — 개인 사용에 충분하나 팀 단위는 유료 전환 권장 diff --git a/docs/CREATE_ISSUES.sh b/docs/CREATE_ISSUES.sh new file mode 100755 index 0000000..13b8a41 --- /dev/null +++ b/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 작업 시작 시 개별 생성 권장" diff --git a/docs/ROADMAP.md b/docs/ROADMAP.md new file mode 100644 index 0000000..ba98204 --- /dev/null +++ b/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` 참고.