Phase 2: 액션 아이템 + Google Docs 호환 복사 (#4)

* feat(phase-1): 저장/목록/상세 UI + 마크다운 라이브러리 + 검색

ROADMAP Phase 1 #3~#7 완료.

## Markdown 렌더링 (#6)
- marked + isomorphic-dompurify 도입
- src/lib/markdown.ts 공용 유틸 (renderMarkdownToSafeHtml + markdownToPlainText)
- 기존 커스텀 파서(export-minutes.ts) 교체 — 표/리스트/인용/코드블록 정상 렌더
- globals.css에 .prose-minutes 스타일 추가

## 저장 버튼 (#3)
- MinutesViewer에 📌 저장 버튼 + 상태별 피드백
- 미리보기/원문 토글
- 저장 성공 시 /meetings/[id] 상세 링크 배너
- URL.revokeObjectURL 타이밍을 setTimeout으로 지연 (Firefox/Safari 호환)

## 목록 페이지 (#4)
- /meetings 서버 컴포넌트, 페이지네이션 (prev/next)
- MeetingCard: 제목/날짜/템플릿 배지/참석자/태그/preview
- 빈 상태 UI (검색 결과 없음 / 첫 녹음 안내)
- preview는 markdown → plain text 변환 후 160자로 자르기

## 상세 페이지 + 편집 (#5)
- /meetings/[id] 서버 컴포넌트 + 클라이언트 편집 island
- 제목/본문/참석자/태그 인라인 편집
- 편집 모드에서 좌(textarea) · 우(live preview) 분할
- 삭제 버튼 (confirm)
- 원본 transcript는 <details>로 접어둠

## 검색 (#7)
- MeetingSearchBar 클라이언트 컴포넌트
- 300ms debounce + useTransition + URL query 동기화 (replace, scroll false)
- 서버에서 ILIKE contains로 title/transcript/markdown 검색
- tsvector GIN 인덱스는 후속 최적화로 분리 (개인용 규모에서 ILIKE 충분)

## Prisma 7 호환
- @prisma/adapter-pg + pg 추가 (driver adapter 필수)
- generator를 prisma-client-js로 전환 (안정적 레거시)
- src/lib/db.ts에 PrismaPg 어댑터 사용 + DATABASE_URL 누락 시 placeholder로 fallback
- DB 접근 페이지/라우트에 export const dynamic = 'force-dynamic' 추가
  (Next 16 pre-render 시 Prisma 초기화 회피)
- Dockerfile에서 src/generated 복사 제거, .gitignore도 정리

## UX
- 메인 페이지 우상단 "📚 저장된 회의록" 링크 추가

## 테스트
- src/__tests__/markdown.test.ts 9개 신규 (렌더/sanitize/plain text)
- 전체: 80 tests passing (이전 71 + 9)

* docs: PR#2 본문 드래프트 추가

* feat(phase-1.5): 웹에서 Gemini API 키 설정 (LocalStorage)

.env를 만지지 않고도 브라우저에서 키를 설정·관리할 수 있게 함.
개인용 단일 인스턴스 가정으로 LocalStorage만 사용 (DB 미관여).

## 구조
- src/lib/api-keys.ts (서버): resolveGeminiApiKey() 우선순위
  요청 body 키 → process.env.GEMINI_API_KEY → null
- src/lib/api-key-storage.ts (클라이언트): get/set/clear/maskApiKey
- /api/settings/status: 환경변수 키 존재 여부만 노출 (값 X)
- /api/settings/test: 키로 짧은 Gemini 호출 → 200/401/403/429 분류
- /settings 페이지: 입력/저장/삭제/마스킹 표시/테스트 호출

## 라우트 변경
- /api/summarize, /api/summarize-live가 body.apiKey 수용
- 키 없을 때 summarize는 단순 변환으로 폴백 (UX 보존)
- summarize-live는 503 + 안내 메시지 (라이브 요약은 키 필수)

## UI
- 메인 헤더에 ⚙️ 설정 링크 추가
- 설정 페이지에 현재 키 소스 배지 (브라우저 / 환경변수 / 없음)
- 보이기/숨기기 토글, 테스트 호출 버튼, 보안 안내

## 테스트
- api-keys.test.ts: 7개 (요청>env, 공백 처리, env 미설정 시 null)
- api-key-storage.test.ts: 7개 (LocalStorage CRUD + 마스킹)
- 전체: 94 tests (이전 80 + 14)

## 비목표 (개인용 가정)
- 다중 사용자 / 권한
- DB 영속화 / 키 암호화

* docs: PR#3 본문 드래프트 추가

* feat(phase-2): 액션 아이템 추출/체크리스트 + Google Docs 호환 복사

## 액션 아이템 (ROADMAP #8~#11)
ROADMAP의 Gemini JSON 출력 대신 마크다운 체크박스 휴리스틱 채택.
모든 템플릿이 이미 - [ ] 형식 출력하므로 Gemini 호출 비용 0.

### Schema
- ActionItem 테이블 추가 (Meeting 1:N, cascade delete)
- 필드: id, meetingId, task, isDone, position, createdAt, updatedAt
- 인덱스: (meetingId, position) / isDone
- 마이그레이션 20260428071709_add_action_items

### 추출 (src/lib/action-items.ts)
- /^\s*[-*]\s+\[(x|X|\s)\]\s+(.+)/ 매칭
- 빈/짧은(<2자)/점만(...) task 노이즈 제거
- 들여쓰기/대문자 X 모두 허용
- 단위 테스트 8개

### API
- POST /api/meetings: 마크다운에서 액션 아이템 자동 추출 후 함께 저장
- GET /api/meetings (목록): _count로 미완료 액션 카운트 포함
- GET /api/meetings/[id] (상세): actionItems include
- PATCH /api/action-items/[id]: isDone 토글, task 수정
- DELETE /api/action-items/[id]
- POST /api/meetings/[id]/reparse-action-items: 마크다운 재파싱으로 교체

### UI
- ActionItemList 컴포넌트: 체크박스 + 낙관적 업데이트 + 진행률(완료/전체)
  + 개별 삭제 (hover ✕) + 🔄 재추출 버튼
- MeetingDetail에 통합 (조회 모드에서만 노출, 편집 중에는 숨김)
- MeetingCard에 미완료 카운트 배지 (✅ N 미완료)
- /meetings 상단에 "내 미완료 액션 (최근 5)" 위젯

### 비목표 (이번 단계)
- assignee/dueDate 필드 — Gemini JSON 모드 도입 시 추가
- 홈 페이지 대시보드 승격 — 녹음 흐름 보존이 우선

## Google Docs 호환 복사
- src/lib/markdown.ts: copyMarkdownAsRichText()
  - ClipboardItem({text/html, text/plain}) 우선
  - 미지원 브라우저는 contenteditable + execCommand 폴백
- MinutesViewer / MeetingDetail에 📋 Docs용 버튼 추가
- 기존 .md 복사는 📋 .md로 분리 라벨링
- 다운로드 버튼은 ⬇ 접두로 구분

## 테스트
- action-items.test.ts: 8개 (다양한 마크다운 패턴)
- 전체: 102 tests passing (이전 94 + 8)

* docs: PR#4 본문 드래프트 추가

src/__tests__/action-items.test.ts

@@ -0,0 +1,71 @@
+import { describe, it, expect } from 'vitest'
+import { parseActionItems } from '@/lib/action-items'
+
+describe('parseActionItems', () => {
+  it('마크다운에서 - [ ] / - [x] 항목을 추출한다', () => {
+    const md = `## 액션 아이템
+- [ ] QA 일정 확정
+- [x] PR 머지
+- [ ] 다음 주 발표 자료 준비`
+    const result = parseActionItems(md)
+    expect(result).toHaveLength(3)
+    expect(result[0]).toEqual({ task: 'QA 일정 확정', isDone: false })
+    expect(result[1]).toEqual({ task: 'PR 머지', isDone: true })
+    expect(result[2]).toEqual({
+      task: '다음 주 발표 자료 준비',
+      isDone: false,
+    })
+  })
+
+  it('대문자 X 도 done으로 인식', () => {
+    const result = parseActionItems('- [X] 완료')
+    expect(result).toEqual([{ task: '완료', isDone: true }])
+  })
+
+  it('* 불릿도 인식한다', () => {
+    const result = parseActionItems('* [ ] 별표 항목')
+    expect(result).toEqual([{ task: '별표 항목', isDone: false }])
+  })
+
+  it('체크박스 없는 일반 불릿은 무시한다', () => {
+    const md = `- 그냥 불릿
+- [ ] 액션 아이템
+- 또 일반 불릿`
+    const result = parseActionItems(md)
+    expect(result).toHaveLength(1)
+    expect(result[0].task).toBe('액션 아이템')
+  })
+
+  it('빈 task / 매우 짧은 task / 점만 있는 task 는 제외', () => {
+    const md = `- [ ]
+- [ ] a
+- [ ] ...
+- [ ] 정상 항목`
+    const result = parseActionItems(md)
+    expect(result).toHaveLength(1)
+    expect(result[0].task).toBe('정상 항목')
+  })
+
+  it('섹션과 무관하게 모든 체크박스를 수집', () => {
+    const md = `## 요약
+이것저것
+
+## 회의 내용
+- [ ] 본문에 있는 항목
+
+## 다른 섹션
+- [x] 다른 섹션의 항목`
+    const result = parseActionItems(md)
+    expect(result).toHaveLength(2)
+  })
+
+  it('빈 문자열은 빈 배열', () => {
+    expect(parseActionItems('')).toEqual([])
+    expect(parseActionItems('# 제목만 있음')).toEqual([])
+  })
+
+  it('들여쓰기된 체크박스도 인식', () => {
+    const result = parseActionItems('  - [ ] 들여쓰기')
+    expect(result).toEqual([{ task: '들여쓰기', isDone: false }])
+  })
+})

src/__tests__/api-key-storage.test.ts

@@ -0,0 +1,50 @@
+import { describe, it, expect, beforeEach } from 'vitest'
+import {
+  getStoredApiKey,
+  setStoredApiKey,
+  clearStoredApiKey,
+  maskApiKey,
+} from '@/lib/api-key-storage'
+
+describe('LocalStorage api key helpers', () => {
+  beforeEach(() => {
+    window.localStorage.clear()
+  })
+
+  it('저장 후 동일 키를 반환한다', () => {
+    setStoredApiKey('AIza-test-key')
+    expect(getStoredApiKey()).toBe('AIza-test-key')
+  })
+
+  it('미설정 시 null 반환', () => {
+    expect(getStoredApiKey()).toBeNull()
+  })
+
+  it('빈 문자열 저장 시 null로 취급', () => {
+    setStoredApiKey('')
+    expect(getStoredApiKey()).toBeNull()
+  })
+
+  it('clear 시 삭제된다', () => {
+    setStoredApiKey('AIza-test-key')
+    clearStoredApiKey()
+    expect(getStoredApiKey()).toBeNull()
+  })
+})
+
+describe('maskApiKey', () => {
+  it('긴 키는 앞 4자 + ••• + 뒤 4자', () => {
+    expect(maskApiKey('AIzaSyABCDEFGHIJKLMNOPQRSTUVWXYZ1234')).toBe(
+      'AIza••••1234',
+    )
+  })
+
+  it('8자 이하는 전부 마스킹', () => {
+    expect(maskApiKey('short')).toBe('••••')
+    expect(maskApiKey('12345678')).toBe('••••')
+  })
+
+  it('정확히 9자는 마스킹 적용', () => {
+    expect(maskApiKey('123456789')).toBe('1234••••6789')
+  })
+})

src/__tests__/api-keys.test.ts

@@ -0,0 +1,72 @@
+import { describe, it, expect, beforeEach, afterEach } from 'vitest'
+import { resolveGeminiApiKey, isEnvKeyConfigured } from '@/lib/api-keys'
+
+describe('resolveGeminiApiKey', () => {
+  const originalEnv = process.env.GEMINI_API_KEY
+
+  beforeEach(() => {
+    delete process.env.GEMINI_API_KEY
+  })
+
+  afterEach(() => {
+    if (originalEnv === undefined) {
+      delete process.env.GEMINI_API_KEY
+    } else {
+      process.env.GEMINI_API_KEY = originalEnv
+    }
+  })
+
+  it('요청 키가 우선이다', () => {
+    process.env.GEMINI_API_KEY = 'env-key'
+    expect(resolveGeminiApiKey('request-key')).toBe('request-key')
+  })
+
+  it('요청 키가 없으면 환경변수 키로 폴백한다', () => {
+    process.env.GEMINI_API_KEY = 'env-key'
+    expect(resolveGeminiApiKey()).toBe('env-key')
+    expect(resolveGeminiApiKey(null)).toBe('env-key')
+    expect(resolveGeminiApiKey(undefined)).toBe('env-key')
+    expect(resolveGeminiApiKey('')).toBe('env-key')
+    expect(resolveGeminiApiKey('   ')).toBe('env-key')
+  })
+
+  it('둘 다 비어있으면 null', () => {
+    expect(resolveGeminiApiKey()).toBeNull()
+    expect(resolveGeminiApiKey('')).toBeNull()
+  })
+
+  it('요청 키 앞뒤 공백을 제거한다', () => {
+    expect(resolveGeminiApiKey('  abc  ')).toBe('abc')
+  })
+
+  it('환경변수 키 앞뒤 공백을 제거한다', () => {
+    process.env.GEMINI_API_KEY = '  env-key  '
+    expect(resolveGeminiApiKey()).toBe('env-key')
+  })
+})
+
+describe('isEnvKeyConfigured', () => {
+  const originalEnv = process.env.GEMINI_API_KEY
+
+  afterEach(() => {
+    if (originalEnv === undefined) {
+      delete process.env.GEMINI_API_KEY
+    } else {
+      process.env.GEMINI_API_KEY = originalEnv
+    }
+  })
+
+  it('환경변수가 설정되어 있으면 true', () => {
+    process.env.GEMINI_API_KEY = 'AIza...'
+    expect(isEnvKeyConfigured()).toBe(true)
+  })
+
+  it('비어있거나 공백만 있으면 false', () => {
+    delete process.env.GEMINI_API_KEY
+    expect(isEnvKeyConfigured()).toBe(false)
+    process.env.GEMINI_API_KEY = ''
+    expect(isEnvKeyConfigured()).toBe(false)
+    process.env.GEMINI_API_KEY = '   '
+    expect(isEnvKeyConfigured()).toBe(false)
+  })
+})

src/__tests__/markdown.test.ts

@@ -0,0 +1,69 @@
+import { describe, it, expect } from 'vitest'
+import {
+  renderMarkdownToSafeHtml,
+  markdownToPlainText,
+} from '@/lib/markdown'
+
+describe('renderMarkdownToSafeHtml', () => {
+  it('헤딩/리스트/굵은 글씨를 HTML로 변환한다', () => {
+    const html = renderMarkdownToSafeHtml(`# 제목
+- 항목1
+- **중요** 항목2`)
+    expect(html).toContain('<h1>제목</h1>')
+    expect(html).toContain('<ul>')
+    expect(html).toContain('<strong>중요</strong>')
+  })
+
+  it('GFM 체크박스를 렌더한다', () => {
+    const html = renderMarkdownToSafeHtml('- [ ] 할 일\n- [x] 완료')
+    expect(html).toContain('type="checkbox"')
+  })
+
+  it('코드 블록을 pre><code>로 감싼다', () => {
+    const html = renderMarkdownToSafeHtml('```\nconst x = 1\n```')
+    expect(html).toContain('<pre>')
+    expect(html).toContain('<code>')
+  })
+
+  it('인라인 HTML 스크립트는 살균되어 제거된다', () => {
+    const html = renderMarkdownToSafeHtml(
+      '안녕 <script>alert("xss")</script> 세계',
+    )
+    expect(html).not.toContain('<script>')
+    expect(html).not.toContain('alert')
+  })
+
+  it('onerror 속성 같은 이벤트 핸들러는 살균된다', () => {
+    const html = renderMarkdownToSafeHtml(
+      '<img src="x" onerror="alert(1)">',
+    )
+    expect(html).not.toContain('onerror')
+  })
+
+  it('빈 문자열은 빈 문자열을 반환한다', () => {
+    expect(renderMarkdownToSafeHtml('')).toBe('')
+  })
+})
+
+describe('markdownToPlainText', () => {
+  it('마크다운을 스트립하여 평문을 반환한다', () => {
+    const text = markdownToPlainText('# 제목\n**굵은** 글씨와 [링크](http://x.com)')
+    expect(text).toContain('제목')
+    expect(text).toContain('굵은')
+    expect(text).toContain('링크')
+    expect(text).not.toContain('#')
+    expect(text).not.toContain('**')
+  })
+
+  it('길이 초과 시 말줄임표를 붙인다', () => {
+    const long = 'a '.repeat(200)
+    const text = markdownToPlainText(long, 20)
+    expect(text.endsWith('...')).toBe(true)
+    expect(text.length).toBeLessThanOrEqual(23)
+  })
+
+  it('연속 공백은 하나로 줄어든다', () => {
+    const text = markdownToPlainText('A\n\n\nB\n\n\nC')
+    expect(text).toBe('A B C')
+  })
+})