업데이트 내역
Prisma Production Guardrails 핸드북 변경 기록
2026-03-26
- Prisma Optimize 서비스 종료(2026-03-23) 대응
- 관측 전략 챕터에
withOptimize()제거 가이드 및 마이그레이션 코드 예시 추가 @prisma/extension-optimize→ Prisma Postgres Query Insights 대체 안내
- 관측 전략 챕터에
- Prisma Next 로드맵 갱신(2026-03-20)
- 마이그레이션 전략 챕터에 월별 마일스톤 테이블 추가 (4월 기여 오픈 → 5월 EA → 6~7월 GA)
- Prisma 7과 호환 레이어 병렬 실행 가능 안내
- Prisma Studio v7.5.0 기능 상세화
- 관측 전략 챕터에 다중 셀 선택, SQL 필터, Cmd+K 팔레트 섹션 추가
- index.mdx 버전 Callout 갱신 (Optimize 종료, Prisma Next 로드맵 반영)
- 검증 리포트 3차 검증 항목 추가 (4개 항목, 3개 외부 소스)
- 전체 기준일을 2026-03-13에서 2026-03-26으로 갱신
2026-02-07
- 최초 발행
- 포함 범위
- 환경 분리 전략
- Prisma Postgres 활용(풀링/캐싱/직접 연결/PR 격리 DB)
- Prisma MCP 활용(Local/Remote 서버 구성, 승인 기반 운영 자동화)
- 마이그레이션 전략/워크플로우/실패 대응
- 롤백 전략
- 백업/DR 전략
- 관측/트러블슈팅/운영 정책
- 런북 템플릿, 검증 리포트
2026-03-13
- Prisma ORM v7.5.0 기준으로 버전 정보 갱신
- index.mdx: 버전 Callout 추가 (v7.5.0 Savepoint 트랜잭션, v7.4.0 쿼리 캐싱, Prisma Next 발표)
- Prisma Postgres 플랜별 한도 테이블 전면 갱신 (Free/Starter/Pro/Business)
- prisma-postgres-utilization.mdx: 4개 플랜 상세 수치, Query Insights/IaC 지원 추가
- 토폴로지 챕터에 쿼리 캐싱 레이어(v7.4.0+) 섹션 추가
- 마이그레이션 전략에 Prisma Next graph-based migrations 전망 섹션 추가
- Prisma MCP 도구 목록 구체화 (Remote 10개, Local 7개 도구명 명시)
- 지원 IDE/에이전트 통합 목록 추가
- MCP 저장소 최종 커밋(2025-10-07) 주석 추가
- 관측 전략에 Query Insights 섹션, v7.5.0 Prisma Studio 기능 추가
- 검증 리포트 2차 검증 항목 추가 (5개 항목, 4개 외부 소스)
- 전체 기준일을 2026-02-07에서 2026-03-13으로 갱신
2026-02-07 (개선)
- 전제 고정: Prisma Postgres 사용 팀 기준으로 인트로/적용 범위 명확화
- 흐름 개선: 핸드북 구조 다이어그램에 단계 간 전이(기반 -> 마이그레이션 -> 운영 안정성 -> 부록) 추가
- 탐색 개선: 부록에서
verification/updates를 분리 노출 - 근거 강화: Prisma Postgres 한도/플랜 의존 항목(기준일 포함) 추가
- 거버넌스 강화: DB Change Request에 MCP 도구/세션/승인 필드 추가
- 검증 강화: 외부 링크 접근성 목록 + 명령 재현성 점검 표 추가