meeting-minutes/docs/PR_DRAFT_PHASE_2.md

Phase 2 — 액션 아이템 추출/체크리스트 + Google Docs 호환 복사

ROADMAP Phase 2 (#8~#11) + 사용자 추가 요청.

Base

• 🧱 Base: feat/web-api-key-settings (PR #3 위에 스택)

설계 결정 — 휴리스틱 vs Gemini JSON

ROADMAP은 Gemini JSON 출력 + zod 검증을 명시했지만 마크다운 체크박스 휴리스틱으로 갈음:

방식	장점	단점
휴리스틱 (채택)	Gemini 호출 0, 모든 템플릿 호환, 즉시 동작	assignee/dueDate 미추출
Gemini JSON	구조화된 출력, 정확한 메타	호출 추가, 프롬프트 재작성, zod 검증

후속에 정확도 부족 체감 시 JSON 모드로 업그레이드 가능 (테이블 스키마는 이미 확장 가능).

변경

신규 파일

• prisma/migrations/20260428071709_add_action_items/
• src/lib/action-items.ts — parseActionItems(markdown)
• src/app/api/action-items/[id]/route.ts — PATCH/DELETE
• src/app/api/meetings/[id]/reparse-action-items/route.ts — POST
• src/components/meeting/ActionItemList.tsx — 체크리스트 UI
• src/__tests__/action-items.test.ts — 8 tests

수정

• prisma/schema.prisma — ActionItem 모델
• src/app/api/meetings/route.ts — POST 시 자동 추출, GET에 미완료 카운트
• src/app/api/meetings/[id]/route.ts — actionItems include
• src/app/meetings/page.tsx — 미완료 위젯 (최근 5)
• src/app/meetings/[id]/page.tsx — actionItems 전달
• src/components/meeting/MeetingCard.tsx — 미완료 배지
• src/components/meeting/MeetingDetail.tsx — ActionItemList 통합 + 📋 Docs용 버튼
• src/components/minutes/MinutesViewer.tsx — 📋 Docs용 버튼
• src/lib/markdown.ts — copyMarkdownAsRichText() 추가

API 시그니처

POST /api/meetings
{ title, markdownMinutes, ... }
→ 201 { ...meeting, actionItems: [{ id, task, isDone, position }] }

PATCH /api/action-items/[id]
{ isDone?: boolean, task?: string }
→ 200 { ...item }

DELETE /api/action-items/[id]
→ 204

POST /api/meetings/[id]/reparse-action-items
→ 200 { actionItems: [...], replaced: N }

UX 흐름

1. 회의록 생성 → 📌 저장 → 마크다운의 - [ ] 자동 추출
2. /meetings/[id] 상세 → 본문 아래 ✅ 액션 아이템 섹션
3. 체크박스 클릭 (낙관적 업데이트, 서버 PATCH)
4. 본문 편집 후 새 항목 추가 시 → 🔄 재추출 버튼으로 동기화 ⚠️ 재추출은 토글 상태를 모두 초기화 (confirm 표시)
5. /meetings 상단에서 "내 미완료 액션 (최근 5)" 한눈에 파악

Google Docs 복사 (사용자 추가 요청)

copyMarkdownAsRichText(markdown):

• 1차: navigator.clipboard.write([new ClipboardItem({ 'text/html', 'text/plain' })]) (모던 브라우저)
• 폴백: 임시 contenteditable + document.execCommand('copy')

→ Google Docs / Word / Notion에 붙여넣으면 헤딩/리스트/굵게/코드/표 서식 유지.

버튼 라벨링 정리:

• 📋 .md — 마크다운 원문 복사
• 📋 Docs용 — 서식 유지 복사 (파랑색 강조)
• ⬇ .md / ⬇ .html — 파일 다운로드

테스트

• 102 tests passing (이전 94 + 8 action-items)

확인 방법

# 마이그레이션 적용 (action_items 테이블 추가)
docker compose --profile tools run --rm migrate

# 빌드 + 기동
docker compose up -d --build app

체크 시나리오:

1. 회의 녹음 → 마크다운에 - [ ] 항목 자동 포함된 상태로 생성
2. 📌 저장 → /meetings/[id] 이동
3. 체크박스 토글 → 진행률 변화, 새로고침해도 유지
4. 본문 편집 → - [ ] 새 항목 추가 → 저장 → 🔄 재추출 → 새 항목 등장
5. 📋 Docs용 → Google Docs에 붙여넣어 서식 확인
6. /meetings → 카드 배지 + 상단 위젯 노출 확인

Breaking changes

• 마이그레이션 필요 (action_items 테이블)
• 기존 회의록은 액션 아이템이 비어있음 — 상세에서 🔄 재추출 한 번 누르면 채워짐

후속 (이 PR 범위 아님)

• Gemini JSON 출력 모드 (assignee/dueDate 정확 추출)
• 홈 페이지를 대시보드로 승격
• 액션 아이템 직접 추가 (체크리스트 UI에서 +)