@kood/claude-code 0.1.0

package/templates/tanstack-start/docs/library/prisma/crud.md

@@ -0,0 +1,218 @@
+# Prisma - CRUD 작업
+
+> **상위 문서**: [Prisma](./index.md)
+
+## Create (생성)
+
+### 단일 레코드 생성
+
+```typescript
+const user = await prisma.user.create({
+  data: {
+    email: 'alice@prisma.io',
+    name: 'Alice',
+  },
+})
+```
+
+### 관계 포함 생성
+
+```typescript
+const userWithPosts = await prisma.user.create({
+  data: {
+    email: 'bob@prisma.io',
+    name: 'Bob',
+    posts: {
+      create: [
+        { title: 'Hello World' },
+        { title: 'My Second Post' },
+      ],
+    },
+  },
+  include: {
+    posts: true,
+  },
+})
+```
+
+### connectOrCreate로 깊은 중첩 생성
+
+```typescript
+const user = await prisma.user.create({
+  include: {
+    posts: {
+      include: {
+        categories: true,
+      },
+    },
+  },
+  data: {
+    email: 'emma@prisma.io',
+    posts: {
+      create: [
+        {
+          title: 'My first post',
+          categories: {
+            connectOrCreate: [
+              {
+                create: { name: 'Introductions' },
+                where: { name: 'Introductions' },
+              },
+              {
+                create: { name: 'Social' },
+                where: { name: 'Social' },
+              },
+            ],
+          },
+        },
+      ],
+    },
+  },
+})
+```
+
+## Read (조회)
+
+### 단일 레코드 조회
+
+```typescript
+const user = await prisma.user.findUnique({
+  where: { email: 'alice@prisma.io' },
+})
+```
+
+### 필터링된 다중 레코드 조회
+
+```typescript
+const users = await prisma.user.findMany({
+  where: { name: 'Alice' },
+})
+```
+
+### 관계 포함 조회
+
+```typescript
+const users = await prisma.user.findMany({
+  where: { role: 'ADMIN' },
+  include: { posts: true },
+})
+```
+
+### 특정 필드만 선택
+
+```typescript
+const user = await prisma.user.findUnique({
+  where: { email: 'emma@prisma.io' },
+  select: {
+    email: true,
+    posts: {
+      select: { likes: true },
+    },
+  },
+})
+```
+
+### 관계 필드로 필터링
+
+```typescript
+const users = await prisma.user.findMany({
+  where: {
+    email: { endsWith: 'prisma.io' },
+    posts: {
+      some: { published: false },
+    },
+  },
+})
+```
+
+## Update (수정)
+
+### 단일 레코드 수정
+
+```typescript
+const user = await prisma.user.update({
+  where: { email: 'alice@prisma.io' },
+  data: { name: 'Alice Updated' },
+})
+```
+
+### 다중 레코드 수정
+
+```typescript
+const updatedUsers = await prisma.user.updateMany({
+  where: { role: 'USER' },
+  data: { role: 'ADMIN' },
+})
+```
+
+### Upsert (있으면 수정, 없으면 생성)
+
+```typescript
+const user = await prisma.user.upsert({
+  where: { email: 'alice@prisma.io' },
+  update: { name: 'Alice Updated' },
+  create: { email: 'alice@prisma.io', name: 'Alice' },
+})
+```
+
+## Delete (삭제)
+
+### 단일 레코드 삭제
+
+```typescript
+const deletedUser = await prisma.user.delete({
+  where: { email: 'alice@prisma.io' },
+})
+```
+
+### 모든 레코드 삭제
+
+```typescript
+const deleteUsers = await prisma.user.deleteMany({})
+```
+
+### 조건부 삭제
+
+```typescript
+const deletedPosts = await prisma.post.deleteMany({
+  where: { published: false },
+})
+```
+
+## 필터 연산자
+
+```typescript
+// 문자열 필터
+where: {
+  email: { contains: 'prisma' },
+  name: { startsWith: 'A' },
+  title: { endsWith: 'guide' },
+}
+
+// 숫자 필터
+where: {
+  age: { gt: 18 },       // greater than
+  age: { gte: 18 },      // greater than or equal
+  age: { lt: 65 },       // less than
+  age: { lte: 65 },      // less than or equal
+}
+
+// 배열 필터
+where: {
+  id: { in: [1, 2, 3] },
+  id: { notIn: [4, 5, 6] },
+}
+
+// 논리 연산자
+where: {
+  OR: [
+    { email: { contains: 'prisma' } },
+    { name: { contains: 'Prisma' } },
+  ],
+  AND: [
+    { published: true },
+    { authorId: 1 },
+  ],
+  NOT: { email: { contains: 'test' } },
+}
+```

package/templates/tanstack-start/docs/library/prisma/index.md

@@ -0,0 +1,165 @@
+# Prisma
+
+> **Version**: 7.x | Node.js/TypeScript ORM
+
+---
+
+## 🚀 Quick Reference (복사용)
+
+```typescript
+// Prisma Client 설정
+import { PrismaClient } from './generated/prisma'  // v7 경로!
+
+export const prisma = new PrismaClient()
+
+// CRUD
+const users = await prisma.user.findMany()
+const user = await prisma.user.create({ data: { email, name } })
+const updated = await prisma.user.update({ where: { id }, data: { name } })
+const deleted = await prisma.user.delete({ where: { id } })
+
+// 관계 포함
+const userWithPosts = await prisma.user.findUnique({
+  where: { id },
+  include: { posts: true },
+})
+```
+
+### v7 schema.prisma (⚠️ 중요)
+
+```prisma
+generator client {
+  provider = "prisma-client"        // v7! (prisma-client-js 아님)
+  output   = "../generated/prisma"  // output 필수!
+}
+```
+
+### ⛔ Claude Code 금지
+
+```
+❌ prisma db push 자동 실행 금지
+❌ prisma migrate 자동 실행 금지
+❌ prisma generate 자동 실행 금지
+❌ schema.prisma 임의 변경 금지
+```
+
+---
+
+## 문서 구조
+
+- [설치 및 설정](./setup.md) - Prisma Client 설정
+- [스키마 정의](./schema.md) - 모델, 관계, Enum 정의
+- [CRUD 작업](./crud.md) - Create, Read, Update, Delete
+- [관계 쿼리](./relations.md) - 중첩 생성, 관계 포함 조회
+- [트랜잭션](./transactions.md) - 배열 기반 트랜잭션, 인터랙티브 트랜잭션
+
+## 빠른 시작
+
+```bash
+# npm
+npm install @prisma/client@7
+npm install -D prisma@7
+
+# yarn
+yarn add @prisma/client@7
+yarn add -D prisma@7
+
+# pnpm
+pnpm add @prisma/client@7
+pnpm add -D prisma@7
+
+# 초기화
+npx prisma init
+```
+
+## v7 주요 변경사항
+
+### 새로운 Generator Provider
+
+```prisma
+// schema.prisma
+generator client {
+  provider = "prisma-client"        // prisma-client-js → prisma-client
+  output   = "../generated/prisma"  // output 필드 필수
+}
+```
+
+### 새로운 옵션들
+
+```prisma
+generator client {
+  provider        = "prisma-client"
+  output          = "../generated/prisma"
+  runtime         = "nodejs"        // nodejs, deno, bun, workerd, vercel-edge, react-native
+  moduleFormat    = "esm"           // esm 또는 cjs
+  previewFeatures = ["queryCompiler", "driverAdapters"]
+}
+```
+
+## 핵심 개념
+
+### Prisma Client 설정
+
+```typescript
+// lib/prisma.ts
+import { PrismaClient } from './generated/prisma'
+
+const globalForPrisma = globalThis as unknown as {
+  prisma: PrismaClient | undefined
+}
+
+export const prisma =
+  globalForPrisma.prisma ??
+  new PrismaClient({
+    log: ['query'],
+  })
+
+if (process.env.NODE_ENV !== 'production') globalForPrisma.prisma = prisma
+```
+
+### 기본 쿼리
+
+```typescript
+// 조회
+const users = await prisma.user.findMany()
+
+// 생성
+const user = await prisma.user.create({
+  data: { email: 'alice@prisma.io', name: 'Alice' },
+})
+
+// 수정
+const updated = await prisma.user.update({
+  where: { id: 1 },
+  data: { name: 'Updated Name' },
+})
+
+// 삭제
+const deleted = await prisma.user.delete({
+  where: { id: 1 },
+})
+```
+
+## 마이그레이션 명령어
+
+```bash
+# 개발 환경 마이그레이션
+npx prisma migrate dev --name init
+
+# 프로덕션 마이그레이션
+npx prisma migrate deploy
+
+# 스키마 동기화 (개발용)
+npx prisma db push
+
+# Prisma Client 생성
+npx prisma generate
+
+# Prisma Studio (GUI)
+npx prisma studio
+```
+
+## 참고 자료
+
+- [Prisma 공식 문서](https://www.prisma.io/docs)
+- [Prisma GitHub](https://github.com/prisma/prisma)

package/templates/tanstack-start/docs/library/prisma/relations.md

@@ -0,0 +1,191 @@
+# Prisma - 관계 쿼리
+
+> **상위 문서**: [Prisma](./index.md)
+
+## 중첩 생성 (Nested Create)
+
+```typescript
+const result = await prisma.user.create({
+  data: {
+    email: 'elsa@prisma.io',
+    name: 'Elsa Prisma',
+    posts: {
+      create: [
+        { title: 'How to make an omelette' },
+        { title: 'How to eat an omelette' },
+      ],
+    },
+  },
+  include: {
+    posts: true,
+  },
+})
+```
+
+## 관계 연결
+
+### connect - 기존 레코드 연결
+
+```typescript
+const post = await prisma.post.create({
+  data: {
+    title: 'New Post',
+    author: {
+      connect: { id: 1 },
+    },
+  },
+})
+```
+
+### connectOrCreate - 있으면 연결, 없으면 생성
+
+```typescript
+const post = await prisma.post.create({
+  data: {
+    title: 'New Post',
+    categories: {
+      connectOrCreate: {
+        where: { name: 'Technology' },
+        create: { name: 'Technology' },
+      },
+    },
+  },
+})
+```
+
+### disconnect - 관계 해제
+
+```typescript
+const post = await prisma.post.update({
+  where: { id: 1 },
+  data: {
+    author: {
+      disconnect: true,
+    },
+  },
+})
+```
+
+## 관계 포함 조회
+
+### include 사용
+
+```typescript
+const users = await prisma.user.findMany({
+  include: {
+    posts: true,
+    profile: true,
+  },
+})
+```
+
+### 중첩 include
+
+```typescript
+const users = await prisma.user.findMany({
+  include: {
+    posts: {
+      include: {
+        categories: true,
+      },
+    },
+  },
+})
+```
+
+### 관계 필터링
+
+```typescript
+const users = await prisma.user.findMany({
+  include: {
+    posts: {
+      where: { published: true },
+      orderBy: { createdAt: 'desc' },
+      take: 5,
+    },
+  },
+})
+```
+
+## 관계로 필터링
+
+### some - 하나라도 조건 만족
+
+```typescript
+const users = await prisma.user.findMany({
+  where: {
+    posts: {
+      some: { published: true },
+    },
+  },
+})
+```
+
+### every - 모두 조건 만족
+
+```typescript
+const users = await prisma.user.findMany({
+  where: {
+    posts: {
+      every: { published: true },
+    },
+  },
+})
+```
+
+### none - 조건 만족 없음
+
+```typescript
+const users = await prisma.user.findMany({
+  where: {
+    posts: {
+      none: { published: false },
+    },
+  },
+})
+```
+
+## 관계 카운트
+
+```typescript
+const users = await prisma.user.findMany({
+  include: {
+    _count: {
+      select: { posts: true },
+    },
+  },
+})
+
+// 결과: { id: 1, name: 'Alice', _count: { posts: 5 } }
+```
+
+## 중첩 업데이트
+
+```typescript
+const user = await prisma.user.update({
+  where: { id: 1 },
+  data: {
+    posts: {
+      updateMany: {
+        where: { published: false },
+        data: { published: true },
+      },
+    },
+  },
+})
+```
+
+## 중첩 삭제
+
+```typescript
+const user = await prisma.user.update({
+  where: { id: 1 },
+  data: {
+    posts: {
+      deleteMany: {
+        where: { published: false },
+      },
+    },
+  },
+})
+```