nad4/meeting-minutes
1
0
Fork 0
mirror of https://github.com/nad4-su/meeting-minutes.git synced 2026-08-12 22:33:25 +09:00
Code Issues Packages Projects Releases Wiki Activity
Files
cf6613bb946c76d18e377ee0081b40383506ca67
meeting-minutes/docs/ROADMAP.md
T
nad4andGitHub cf6613bb94 Phase 1 foundation: Prisma + /api/meetings CRUD (#1) 
* feat(phase-1): Prisma 연동 + 회의록 CRUD API

Phase 1 foundation (ROADMAP #1~#3):

- src/lib/db.ts: Prisma 클라이언트 싱글톤 (dev hot-reload 대응)
- Meeting 스키마 확장: attendees/tags (String[]), template/depth/
  summaryMode/customPrompt (향후 참조 복원용), createdAt 인덱스
- 첫 마이그레이션 `20260421104750_init` 생성
- /api/meetings (GET 목록 + POST 생성)
  - q 파라미터로 제목/transcript/markdown 부분 검색
  - limit (max 100), offset 페이지네이션
  - attendees/tags 배열 타입 정규화
- /api/meetings/[id] (GET/PUT/DELETE)
  - PUT은 markdownMinutes/title/attendees/tags만 편집 허용
  - 존재하지 않는 id에 대해 404
- docker-compose.yml: tools 프로필에 migrate 서비스 추가
  (app 컨테이너 bloat 없이 마이그레이션 실행)
- Prisma mock 기반 API 테스트 14개 신규 (총 71 tests)

* docs: migrate 실행 단계 추가, ROADMAP의 #1/#2 완료 체크

* docs: PR 본문 드래프트 추가
2026-04-28 16:38:09 +09:00

7.1 KiB
Raw Blame History

Meeting Minutes — ROADMAP

노션의 AI Meeting Notes 기능을 참고한 단계별 개발 계획. 개인/소규모 팀 사용 기준으로 범위 조정됨.

✅ Phase 0 — 기반 (완료)

구현됨

  • Web Speech API 기반 실시간 전사 (Chrome ko-KR)
  • 파일 업로드 검증 (MP3/WAV/WebM/M4A/OGG/FLAC, 최대 500MB)
  • 단순 변환 / Gemini AI 요약 두 모드
  • Markdown / HTML 내보내기, 클립보드 복사
  • Gemini 롤링 실시간 요약 (30초 간격, 25/40단어 게이트)
  • 녹음 종료 시 최종 회의록 자동 생성
  • 429 쿼터 초과 자동 쿨다운 + 지수 백오프
  • Gemini 실패 시 단순 변환 자동 폴백
  • 네트워크 에러 자동 재연결 (최대 8회)
  • 좌우 분할 UI (실시간 텍스트 / 실시간 회의록)
  • 자동 스크롤, 진행률 바, 쿨다운 카운터
  • Docker Compose (app + db + test profile)
  • 단위 테스트 38개 통과
  • Prisma 7 호환 스키마 (아직 미사용)

알려진 제약

  • Chrome 전용 (Web Speech API)
  • 화자 구분 불가 — 의도적 비지원 (Non-goal)
  • 녹음 저장/조회 불가 (DB 미사용)
  • Web Speech 세션이 가끔 끊김 → 자동 재연결로 완화

✅ Phase 0.5 — 템플릿 + 강도 조절 (완료)

사용자가 회의록 외 다양한 용도로 쓸 수 있도록 템플릿 시스템과 강도 조절 도입.

구현됨

  • 6개 프리셋 템플릿 (회의록, 강의·세미나, 1:1 미팅, 브레인스토밍, 인터뷰, 원문 정리)
  • 커스텀 프롬프트 옵션 (파워 유저용 자유 입력)
  • 3단계 강도 조절 (간결 / 표준 / 상세)
  • 템플릿별 기본 강도 프리셋 (예: 강의는 상세, 회의록은 표준)
  • 템플릿별 라이브 요약 지원 플래그 (raw/interview는 종료 시 한 번만)
  • Gemini 모드에서만 노출, 단순 변환은 기존 동작 유지
  • 라이브 요약도 동일 템플릿/강도 적용
  • 프롬프트 빌더 단위 테스트 19개

🎯 Phase 1 — 회의 저장/조회 (1~2주)

노션의 Meeting Database 수준. 생성한 회의록을 저장하고 다시 찾아볼 수 있게 함.

Issues

  • #1 Prisma 연결 + 마이그레이션 파이프라인 — PR feat/phase-1-foundation
    • src/lib/db.ts 싱글톤 Prisma 클라이언트
    • 첫 마이그레이션 생성 (prisma migrate dev)
    • docker-compose tools 프로필에 migrate 서비스 추가
    • Meeting 스키마 확장 (attendees/tags/template/depth/summaryMode/customPrompt)
  • #2 회의 저장 API — PR feat/phase-1-foundation
    • POST /api/meetings — transcript + markdown 저장
    • GET /api/meetings — 목록 조회 (최신순, 페이지네이션, q 부분검색)
    • GET /api/meetings/[id] — 상세
    • PUT /api/meetings/[id] — markdown/title/attendees/tags 편집
    • 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주)

#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)

다음 기능은 개인 사용 목적에 부합하지 않아 의도적으로 범위 밖:

  • 화자 구분 (Speaker Diarization) — 유료 API 비용/복잡도 대비 개인용에 과함
  • 실시간 공동 편집 (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 참고.

Reference in New Issue View Git Blame Copy Permalink