검증 리포트
Prisma Production Guardrails 핸드북의 구조 및 정합성 검증
이 문서는 Prisma Production Guardrails 핸드북의 문서 구조 정합성과 운영 관점 커버리지를 검토한 결과를 기록합니다.
검증 기준일
2026년 3월 26일 (3차 검증)
검증 범위
- 챕터 구성: 요청 범위(환경 분리, Prisma Postgres 활용, Prisma MCP 활용, 마이그레이션, 실패 대응, 롤백, 백업, 관측, 운영 정책) 포함 여부
- 링크/목차:
meta.json페이지 목록과 실제 파일 존재 여부 - 링크 접근성: Prisma 공식 문서/저장소 링크의 접근 가능 여부
- 운영 실무성: 각 챕터의 체크리스트/런북/의사결정 기준 포함 여부
- 명령 재현성: 문서 내 핵심 명령의 실행 전제/검증 가능성 점검
검증 방법
meta.json과 실제 파일 목록을 대조해 누락 페이지 확인- 인덱스 목차 카드와 챕터 제목 번호 정합성 확인
- Prisma 공식 링크는 기준일에 문서 접근 가능 여부 확인
- 명령 예시는 실행 환경 제약을 포함해 재현성 수준 기록
결과 요약
| 항목 | 결과 |
|---|---|
| 요청 주제 커버리지 | 포함 |
meta.json 정합성 | 이상 없음 |
| 외부 링크 접근성 | 주요 링크 접근 확인 |
| 명령 재현성 기록 | 포함 |
| 운영 템플릿 제공 | 포함 |
| 버전 정합성 | Prisma ORM v7.5.0 기준 갱신 완료 |
| 플랜/한도 정보 | 2026-03-13 기준 공식 가격표 반영 |
링크 접근성 확인 목록
| 항목 | 링크 | 결과 |
|---|---|---|
| Prisma Postgres | https://www.prisma.io/postgres | 접근 확인 |
| Prisma Postgres DB 기능 | https://www.prisma.io/docs/postgres/database | 접근 확인 |
| 연결 풀링 | https://www.prisma.io/docs/postgres/database/connection-pooling | 접근 확인 |
| 캐싱 | https://www.prisma.io/docs/postgres/database/caching | 접근 확인 |
| 백업 | https://www.prisma.io/docs/postgres/database/backups | 접근 확인 |
| Prisma MCP 문서 | https://www.prisma.io/docs/postgres/database/mcp | 접근 확인 |
| Prisma MCP 저장소 | https://github.com/prisma/mcp | 접근 확인 |
명령 재현성 점검
| 항목 | 예시 | 검증 결과 |
|---|---|---|
| Prisma CLI 확인 | npx prisma --version | 현재 문서 작업 환경 DNS 제약으로 실행 검증 제외 |
| Local MCP 실행 | npx -y prisma mcp | 현재 문서 작업 환경 DNS 제약으로 실행 검증 제외 |
| Remote MCP 실행 | npx -y mcp-remote https://mcp.prisma.io/mcp | 현재 문서 작업 환경 DNS 제약으로 실행 검증 제외 |
| datasource 설정 | schema.prisma 예시 | 정적 문법/구조 검토 완료 |
2차 검증 (2026-03-13) 추가 항목
| 검증 항목 | 결과 | 비고 |
|---|---|---|
| Prisma ORM v7.5.0 변경사항 반영 | 반영 완료 | Savepoint 트랜잭션, 쿼리 캐싱 레이어, Prisma Studio |
| Prisma Postgres 플랜별 한도 갱신 | 반영 완료 | Free/Starter/Pro/Business 4개 플랜 상세 수치 |
| Prisma MCP 도구 목록 갱신 | 반영 완료 | Remote 10개, Local 7개 도구명 명시 |
| Prisma Next(→Prisma 8) 전망 반영 | 반영 완료 | graph-based migrations 예고, 12개월 Prisma 7 지원 |
| Query Insights 기능 추가 | 반영 완료 | 관측 전략 챕터에 추가 |
2차 검증에서 확인한 외부 소스
- Prisma ORM Changelog: https://www.prisma.io/changelog — v7.5.0 (2026-03-11) 확인
- Prisma Blog "The Next Evolution of Prisma ORM" (2026-03-04) — Prisma Next 발표 확인
- Prisma Postgres Pricing: https://www.prisma.io/pricing — 플랜별 한도 수치 확인
- Prisma MCP GitHub: https://github.com/prisma/mcp — 최종 커밋 2025-10-07, 도구 목록 확인
3차 검증 (2026-03-26) 추가 항목
| 검증 항목 | 결과 | 비고 |
|---|---|---|
| Prisma Optimize 서비스 종료 반영 | 반영 완료 | withOptimize() 제거 가이드, Query Insights 대체 안내 |
| Prisma Next 로드맵 갱신 | 반영 완료 | 2026-03-20 공식 로드맵 (4월 기여 오픈 → 5월 EA → 6~7월 GA) |
| Prisma Studio v7.5.0 기능 상세화 | 반영 완료 | 다중 셀 선택, SQL 필터, Cmd+K 팔레트 |
| 호환 레이어 병렬 실행 전략 반영 | 반영 완료 | Prisma 7 → Next 점진적 전환 가능성 안내 |
3차 검증에서 확인한 외부 소스
- Prisma Blog "Prisma Optimize is shutting down" (2026-03-23) — Optimize 종료 및 Query Insights 대체 확인
- Prisma Blog "Prisma Next Roadmap Update" (2026-03-20) — 월별 마일스톤 및 호환 레이어 확인
- Prisma ORM Changelog: https://www.prisma.io/changelog — v7.5.0 Prisma Studio 기능 상세 확인
검증 한계
범위 안내
본 리포트는 문서 정합성과 링크 접근성 중심 검토입니다. 실행 명령의 완전 재현성은 네트워크가 허용된 런타임에서 별도 CI 검증이 필요합니다.