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 본문 드래프트 추가

docs/PR_DRAFT_PHASE_1_5.md

@@ -0,0 +1,79 @@
+# Phase 1.5 — 웹에서 Gemini API 키 설정 (LocalStorage)
+
+`.env`를 만지지 않고도 브라우저 `/settings` 페이지에서 Gemini API 키를 입력·저장·테스트할 수 있도록 함.
+
+## Base
+- 🧱 **Base**: `feat/phase-1-ui` (PR #2 위에 스택)
+- main 직접 머지 시 PR#1 / PR#2 / 본 PR 변경이 합쳐짐
+
+## 설계 의도 (왜 LocalStorage?)
+- **개인용 단일 인스턴스 가정** — 여러 사용자나 디바이스 간 동기화 불필요
+- 키가 서버 DB에 남지 않음 → 백업·로그·덤프 노출 위험 없음
+- 마이그레이션·테이블 추가 불필요
+- 단점: 브라우저마다 다시 입력 / 시크릿 모드·캐시 정리 시 사라짐 (개인용으로 수용 가능)
+
+DB 저장 + env fallback 방식은 의도적으로 선택하지 않음.
+
+## 키 우선순위
+```
+1. 요청 body의 apiKey  (브라우저 LocalStorage에서 옴)
+       ↓ 없으면
+2. process.env.GEMINI_API_KEY  (서버 환경변수 fallback)
+       ↓ 없으면
+3. summarize → 단순 변환 폴백 (warning 표시)
+   summarize-live → 503 (라이브 요약은 키 필수)
+```
+
+## 변경 파일
+
+### 신규
+- `src/lib/api-keys.ts` — `resolveGeminiApiKey()`, `isEnvKeyConfigured()`
+- `src/lib/api-key-storage.ts` — `getStoredApiKey`, `setStoredApiKey`, `clearStoredApiKey`, `maskApiKey`
+- `src/app/api/settings/status/route.ts` — 환경변수 키 존재 여부만 노출 (값 X)
+- `src/app/api/settings/test/route.ts` — 키로 짧은 Gemini 호출 → 결과 분류
+- `src/app/settings/page.tsx` — 입력/저장/삭제/테스트 UI
+- `src/__tests__/api-keys.test.ts` — 7 tests
+- `src/__tests__/api-key-storage.test.ts` — 7 tests
+
+### 수정
+- `src/app/api/summarize/route.ts` — `body.apiKey` 수용, 키 없을 시 단순 변환 폴백
+- `src/app/api/summarize-live/route.ts` — `body.apiKey` 수용
+- `src/hooks/useLiveSummary.ts` — 매 요청 시 LocalStorage 키 첨부
+- `src/app/page.tsx` — generateMinutes에 LocalStorage 키 첨부 + 헤더에 ⚙️ 링크
+- `README.md` / `docs/ROADMAP.md`
+
+## UX
+
+### 설정 페이지 (`/settings`)
+- 현재 키 소스 배지: `브라우저 (LocalStorage)` / `환경변수 (서버)` / `없음`
+- 마스킹된 현재 키 표시 (`AIza••••XYZ12`)
+- 입력 필드 (보이기/숨기기 토글)
+- 버튼: 💾 저장, 🧪 테스트 호출, 🗑️ 삭제
+- 테스트 결과: ✓ 정상 / ✗ 401·403·429 등 분류된 메시지
+- Google AI Studio 무료 발급 링크
+
+### 안전장치
+- 키 GET 응답에서 절대 풀 키 노출 안 함
+- 테스트 호출은 `"OK"` 단어 한 개만 요청 → 토큰 거의 안 씀
+- HTTPS 권장 안내 (localhost는 예외)
+
+## 테스트
+- 단위 테스트 14개 추가 (서버 헬퍼 7 + LocalStorage 7)
+- 전체: **94 tests passing**
+
+## 확인 방법
+```bash
+docker compose up -d --build app
+```
+1. `http://localhost:3000` → 헤더 `⚙️ 설정`
+2. 키 입력 → 💾 저장 → 마스킹된 키가 "현재 키 소스 = 브라우저"로 표시
+3. 🧪 테스트 호출 → "키가 정상적으로 동작합니다." + Gemini 응답 미리보기
+4. 홈으로 돌아가 녹음 → Gemini 요약이 LocalStorage 키로 동작
+5. 🗑️ 삭제 → 환경변수 fallback (있으면) 또는 단순 변환으로 자동 전환
+
+## Breaking changes
+없음. 기존 `.env` 사용자는 변경 없이 동작.
+
+## 후속 (이 PR 범위 아님)
+- 다중 키 (예: OpenAI 키 추가) — 동일 패턴으로 확장 가능
+- 키 로테이션 알림 — Google이 만료 정책 도입 시

docs/PR_DRAFT_PHASE_1_UI.md

@@ -0,0 +1,89 @@
+# Phase 1 UI — 저장/목록/상세 + Markdown + 검색
+
+ROADMAP Phase 1의 #3~#7 완료. PR #1 (`feat/phase-1-foundation`) 위에 스택됨.
+
+## Base
+- 🧱 **Base branch**: `feat/phase-1-foundation` (병합 전이라면 PR#1을 먼저 머지)
+- Main에 직접 머지하고 싶다면 base를 `main`으로 바꾸면 두 PR의 변경이 합쳐져서 올라감
+
+## 포함된 변경
+
+### 📦 의존성
+- `marked@^16.4.0`
+- `isomorphic-dompurify@^2.29.0`
+- `@prisma/adapter-pg@^7.7.0`, `pg@^8.13.1`, `@types/pg`
+  (Prisma 7의 `prisma-client` 엔진은 driver adapter 필수)
+
+### 🎨 Markdown 라이브러리 (#6)
+- `src/lib/markdown.ts` — `renderMarkdownToSafeHtml`, `markdownToPlainText`
+- 기존 커스텀 파서(`export-minutes.ts`) 교체
+- 표/리스트/인용/코드블록 정상 렌더, XSS sanitize 테스트 포함
+- `globals.css`에 `.prose-minutes` 공통 스타일
+
+### 💾 저장 버튼 (#3)
+- `MinutesViewer`에 `📌 저장` → `POST /api/meetings`
+- 생성 당시 설정(template/depth/mode/customPrompt) 함께 저장
+- 저장 성공 시 `/meetings/[id]` 이동 배너
+- 미리보기 ↔ 원문 토글
+
+### 📚 목록 페이지 `/meetings` (#4)
+- 서버 컴포넌트 (Prisma 직접 조회)
+- `MeetingCard` — 제목/날짜/템플릿 배지/참석자/태그/preview
+- 빈 상태 UI (검색 시 vs 최초)
+- prev/next 페이지네이션
+
+### 📄 상세 페이지 `/meetings/[id]` (#5)
+- 서버 컴포넌트 + 클라이언트 편집 island
+- 제목/본문/참석자/태그 인라인 편집
+- 편집 모드는 좌(textarea) · 우(live preview) 분할
+- 삭제 confirm
+- 원본 transcript는 `<details>`로 접어둠
+
+### 🔍 검색 (#7)
+- `MeetingSearchBar` 클라이언트 컴포넌트
+- 300ms debounce + `useTransition` + URL query 동기화
+- 서버에서 `ILIKE contains` — title/transcript/markdown
+- `tsvector` GIN 인덱스는 후속 (개인용 규모에서 `ILIKE`로 충분)
+
+### 🔧 Prisma 7 호환
+- `generator client` → `prisma-client-js` (안정적)
+- `@prisma/adapter-pg`로 driver adapter 사용
+- `src/lib/db.ts`: `DATABASE_URL` 누락 시 placeholder fallback (build-time 안전)
+- DB 접근 페이지/라우트에 `export const dynamic = 'force-dynamic'`
+- Dockerfile에서 `src/generated` 복사 제거
+
+### 🧪 테스트
+- `src/__tests__/markdown.test.ts` 9개 추가 (렌더/sanitize/plain text)
+- 전체: **80 tests passing** (이전 71 + 9)
+
+## 확인 방법
+
+```bash
+# DB + migrate 전제 (PR#1 참고)
+docker compose up -d db
+docker compose --profile tools run --rm migrate
+
+# 빌드 + 기동
+docker compose up -d --build app
+```
+
+### 사용 흐름
+1. `http://localhost:3000`에서 녹음/업로드 → 회의록 생성
+2. `📌 저장` 버튼 클릭 → 배너에 `/meetings/[id]` 링크
+3. 링크 클릭 → 상세 페이지 → `✏️ 편집` → 마크다운/참석자/태그 수정 → 저장
+4. 상단 `← 목록으로` → `/meetings` 카드 그리드
+5. 검색창에 키워드 입력 → 300ms 후 필터링
+6. 삭제는 🗑️ 아이콘 (confirm 후 목록으로 복귀)
+
+## 스크린샷
+
+사용자가 직접 찍어서 추가 예정.
+
+## Breaking changes
+- 기존 녹음/요약 흐름은 유지
+- Prisma 6에서 올라온 환경은 `@prisma/adapter-pg` 추가 설치 필요 (package.json에 이미 반영)
+- Dockerfile의 `COPY src/generated` 제거 — 기존 이미지 캐시는 재빌드 필요
+
+## 남은 Phase 1 후속 (이 PR 범위 아님)
+- tsvector GIN 인덱스 (성능 이슈 체감 시)
+- 태그/참석자 필터 UI (검색바 외 패싯) — Phase 3에서 다룰 예정

docs/PR_DRAFT_PHASE_2.md

@@ -0,0 +1,108 @@
+# 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 시그니처
+
+```http
+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)
+
+## 확인 방법
+
+```bash
+# 마이그레이션 적용 (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에서 +)

docs/ROADMAP.md

@@ -46,13 +46,32 @@
 
 ---
 
-## 🎯 Phase 1 — 회의 저장/조회 (1~2주)
+## ✅ Phase 1.5 — 웹 기반 API 키 설정 (완료)
 
-노션의 **Meeting Database** 수준. 생성한 회의록을 저장하고 다시 찾아볼 수 있게 함.
+`.env`를 만지지 않고도 브라우저에서 Gemini 키를 설정할 수 있도록 함.
+
+### 구현됨
+- [x] `/settings` 페이지 — 키 입력 / 저장 / 삭제 / 마스킹된 현재 키 표시
+- [x] LocalStorage 저장 (서버 DB에 보관 X — 개인용/단일 인스턴스 가정)
+- [x] `/api/settings/status` — 환경변수 키 존재 여부 (값 노출 X)
+- [x] `/api/settings/test` — 키로 가벼운 Gemini 호출 시도 → 200/401/429 등 분류
+- [x] `resolveGeminiApiKey()` 우선순위: 요청 body 키 → 환경변수 → null
+- [x] summarize / summarize-live 라우트가 body의 `apiKey` 사용
+- [x] 단위 테스트 14개 (api-keys 7 + api-key-storage 7)
+
+### 의도된 비목표
+- 다중 사용자 / 권한 관리 — 개인용 단일 인스턴스
+- 키 암호화 — 평문 LocalStorage (현재 .env 신뢰 모델과 동일)
+
+---
+
+## ✅ Phase 1 — 회의 저장/조회 (완료)
+
+노션의 **Meeting Database** 수준. 생성한 회의록을 저장하고 다시 찾아볼 수 있음.
 
 ### Issues
 - [x] **#1 Prisma 연결 + 마이그레이션 파이프라인** — PR `feat/phase-1-foundation`
-  - [x] `src/lib/db.ts` 싱글톤 Prisma 클라이언트
+  - [x] `src/lib/db.ts` 싱글톤 Prisma 클라이언트 (Prisma 7 driver adapter 경유)
   - [x] 첫 마이그레이션 생성 (`prisma migrate dev`)
   - [x] docker-compose `tools` 프로필에 `migrate` 서비스 추가
   - [x] Meeting 스키마 확장 (attendees/tags/template/depth/summaryMode/customPrompt)
@@ -62,44 +81,52 @@
   - [x] `GET /api/meetings/[id]` — 상세
   - [x] `PUT /api/meetings/[id]` — markdown/title/attendees/tags 편집
   - [x] `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=...` 엔드포인트
-  - 헤더에 검색 바 추가
+- [x] **#3 MinutesViewer에 "저장" 버튼** — PR `feat/phase-1-ui`
+  - [x] 생성된 회의록 세션에서 저장 → 배너 + 상세 링크
+  - [x] 미리보기 / 원문 토글
+- [x] **#4 회의 목록 페이지** (`/meetings`) — PR `feat/phase-1-ui`
+  - [x] 카드 그리드 (제목, 날짜, preview, 태그, 참석자, 템플릿 배지)
+  - [x] 빈 상태 UI
+  - [x] 페이지네이션
+- [x] **#5 회의 상세 페이지** (`/meetings/[id]`) — PR `feat/phase-1-ui`
+  - [x] Markdown 렌더링 (sanitize)
+  - [x] 인라인 편집 (제목/본문/참석자/태그) + 좌우 미리보기
+  - [x] 삭제 버튼
+- [x] **#6 Markdown 렌더링 라이브러리 도입** — PR `feat/phase-1-ui`
+  - [x] `marked` + `isomorphic-dompurify`
+  - [x] `src/lib/markdown.ts` 공용 유틸
+  - [x] 기존 커스텀 파서 교체, `.prose-minutes` 공통 스타일
+- [x] **#7 전역 검색** — PR `feat/phase-1-ui`
+  - [x] 검색 바 (debounce 300ms, URL query 동기화)
+  - [x] `/api/meetings?q=...` 부분 검색 (title/transcript/markdown)
+  - [ ] Postgres `tsvector` GIN 인덱스 — 현재 ILIKE로 개인용 규모 충분, 필요 시 후속
 
 ---
 
-## 🎯 Phase 2 — 구조화된 액션 아이템 (1주)
+## ✅ Phase 2 — 구조화된 액션 아이템 (완료)
 
-회의가 끝나면 **"내 할 일"이 자동으로 추출되어 체크리스트로 남음**. 노션 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`로 이동
+### 구현됨
+- [x] **#8 액션 아이템 추출** — Gemini JSON 재구성 대신 마크다운 휴리스틱 채택
+  (모든 템플릿이 이미 `- [ ]` 출력 → 추가 호출 비용 0, 후속에 JSON 모드 가능)
+- [x] **#9 ActionItem 테이블** — `Meeting` ↔ `ActionItem` 1:N (cascade delete)
+  - 필드: `id`, `meetingId`, `task`, `isDone`, `position`, `createdAt`, `updatedAt`
+  - assignee/dueDate는 추후 JSON 출력 모드 도입 시 추가
+- [x] **#10 체크리스트 UI** — 상세 페이지 별도 섹션
+  - 체크박스 토글 (낙관적 업데이트) → `PATCH /api/action-items/[id]`
+  - 개별 삭제 (hover 시 ✕ 노출)
+  - 🔄 재추출 버튼 (마크다운 변경 후 수동 동기화)
+- [x] **#11 대시보드 위젯** — `/meetings` 상단에 "내 미완료 액션 (최근 5)"
+  - 회의 카드 우상단에 미완료 카운트 배지
+  - 홈 페이지 자체 승격은 보류 (현재 녹음 UI 유지)
+- [x] **부가** — Google Docs 호환 서식 복사 (`text/html` + `text/plain` ClipboardItem)
+  - MinutesViewer / MeetingDetail 둘 다 `📋 Docs용` 버튼
+
+### 비목표 (이번 단계)
+- Gemini JSON 출력 + zod 검증 — 정확도 부족 시 후속 도입
+- assignee/dueDate 필드 — JSON 출력 도입과 함께
+- 홈 페이지 대시보드 승격 — 녹음 흐름 보존이 우선
 
 ---