본문으로 바로가기
리옵트 핸드북
리옵트 핸드북
Prisma Production Guardrails

기반 설계

Ch1. 환경 분리 전략Ch2. 토폴로지와 환경 구성Ch3. Prisma Postgres 활용

마이그레이션

Ch4. 마이그레이션 전략Ch5. 마이그레이션 파이프라인Ch6. 마이그레이션 실패 대응Ch7. 롤백 전략

운영 안정성

Ch8. 백업 및 DR 전략Ch9. 관측 전략Ch10. 운영 트러블슈팅Ch11. 운영 정책과 거버넌스Ch12. Prisma MCP 활용

부록

부록 A. 런북 템플릿검증 리포트업데이트 내역
핸드북›Prisma Production Guardrails›업데이트 내역

업데이트 내역

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 도구/세션/승인 필드 추가
  • 검증 강화: 외부 링크 접근성 목록 + 명령 재현성 점검 표 추가

관련 문서

검증 리포트

Prisma Production Guardrails 핸드북의 구조 및 정합성 검증

Ch12. Prisma MCP 활용

Prisma MCP를 안전하게 운영 환경에 도입하기 위한 로컬/리모트 구성, 권한 제어, 운영 패턴

Ch5. Next.js App Router 엔터프라이즈 패턴

엔터프라이즈 프로젝트 설계 · Multi-zone, Cache Components, Proxy, Server Actions, Route Handlers, 런타임 선택

Ch3. 공유 패키지 설계 패턴

엔터프라이즈 프로젝트 설계 · DB(Prisma), UI, utils, config, types 패키지의 설계 패턴과 트리셰이킹

Ch13. 레퍼런스와 아키텍처 결정 기록

엔터프라이즈 프로젝트 설계 · ADR 템플릿, 기술 선택 근거, 전체 참고 문헌

검증 리포트

Prisma Production Guardrails 핸드북의 구조 및 정합성 검증

On this page

2026-03-262026-02-072026-03-132026-02-07 (개선)