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 본문 드래프트 추가
This commit is contained in:
2026-04-28 16:38:09 +09:00
committed by GitHub
parent 78e0caac0b
commit cf6613bb94
11 changed files with 615 additions and 15 deletions
+79
View File
@@ -0,0 +1,79 @@
# Phase 1 Foundation — Prisma 연동 + 회의록 CRUD API
ROADMAP Phase 1의 #1 (Prisma 셋업), #2 (회의 저장 API) 완료.
## 포함된 변경
### 🔧 인프라
- `src/lib/db.ts` — Prisma 클라이언트 싱글톤 (dev HMR 대응)
- `prisma/schema.prisma` — Meeting 모델 확장
- `attendees`, `tags`: `String[]` (Phase 3에서 UI 노출 예정)
- `template`, `depth`, `summaryMode`, `customPrompt`: 생성 당시 설정 보존 (재생성/디버깅용)
- `createdAt` 인덱스 (목록 쿼리 최적화)
- 첫 마이그레이션 `20260421104750_init` 생성·커밋
- `docker-compose.yml``tools` 프로필에 `migrate` 서비스 추가
(app 이미지에 prisma CLI를 포함시키지 않고 독립 실행)
### 🔌 API
- `GET /api/meetings`
- 쿼리 파라미터: `q` (제목/transcript/markdown 부분 검색), `limit` (default 20, max 100), `offset`
- 응답: `{ meetings, total, limit, offset }` (카드 렌더용 필드만 select)
- `POST /api/meetings`
- 필수: `title`, `markdownMinutes`
- 선택: `rawTranscript`, `summaryMode`, `template`, `depth`, `customPrompt`, `attendees[]`, `tags[]`
- 배열 타입 외 값은 빈 배열로 정규화
- `GET /api/meetings/[id]` — 상세, 404
- `PUT /api/meetings/[id]``title`/`markdownMinutes`/`attendees`/`tags`만 편집 허용
- `DELETE /api/meetings/[id]` — 204 / 404
### ✅ 테스트
- `src/__tests__/meetings-api.test.ts` — Prisma mock 기반 14개 케이스 추가
- 전체: **71 tests passing** (이전 57 + 14)
### 📝 문서
- `README.md` — "DB 마이그레이션 실행" 단계 추가
- `docs/ROADMAP.md` — Phase 1 #1/#2 체크박스 완료 표시
## 확인 방법
```bash
# 1. DB 기동
docker compose up -d db
# 2. 마이그레이션 적용 (최초 1회)
docker compose --profile tools run --rm migrate
# 3. 테스트
docker compose --profile tools run --rm test
# 4. 앱 기동
docker compose up -d --build app
```
`curl`로 API 스모크 테스트:
```bash
# 빈 목록
curl http://localhost:3000/api/meetings
# 생성
curl -X POST http://localhost:3000/api/meetings \
-H 'Content-Type: application/json' \
-d '{"title":"테스트","markdownMinutes":"# 내용"}'
# 조회 / 수정 / 삭제
curl http://localhost:3000/api/meetings/<id>
```
## 이 PR에 없는 것 (다음 PR 예정)
- [ ] #3 `marked` + `DOMPurify` 도입 (기존 커스텀 markdown 파서 교체)
- [ ] #4 MinutesViewer에 "저장" 버튼 — 생성 결과를 DB에 저장하는 UI
- [ ] #5 `/meetings` 목록 페이지
- [ ] #6 `/meetings/[id]` 상세 + 인라인 편집
- [ ] #7 전역 검색 (tsvector 기반, 지금은 단순 `contains`)
## Breaking changes
없음. 기존 녹음/요약 흐름은 그대로 동작.
## 마이그레이션 주의
첫 실행 시 `meetings` 테이블이 생성됨. 기존 개발 DB가 있다면 `prisma migrate resolve` 또는 `docker compose down -v`로 초기화 필요.