@kood/claude-code 0.1.5 → 0.1.7

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

@@ -2,14 +2,20 @@
 
 > **Version**: 7.x | Node.js/TypeScript ORM
 
+@setup.md
+@config.md
+@schema.md
+@crud.md
+@relations.md
+@transactions.md
+@cloudflare-d1.md
+
 ---
 
-## 🚀 Quick Reference (복사용)
+## Quick Reference
 
 ```typescript
-// Prisma Client 설정
 import { PrismaClient } from './generated/prisma'  // v7 경로!
-
 export const prisma = new PrismaClient()
 
 // CRUD
@@ -36,128 +42,32 @@ generator client {
 
 ### ⛔ Claude Code 금지
 
-```
-❌ prisma db push 자동 실행 금지
-❌ prisma migrate 자동 실행 금지
-❌ prisma generate 자동 실행 금지
-❌ schema.prisma 임의 변경 금지
-```
+| 금지 사항 |
+|----------|
+| prisma db push 자동 실행 |
+| prisma migrate 자동 실행 |
+| prisma generate 자동 실행 |
+| schema.prisma 임의 변경 |
 
 ---
 
-## 문서 구조
-
-- [Config 파일](./config.md) - prisma.config.ts 설정 ⭐
-- [설치 및 설정](./setup.md) - Prisma Client 설정
-- [스키마 정의 (Multi-File)](./schema.md) - 모델, 관계, Enum 정의
-- [CRUD 작업](./crud.md) - Create, Read, Update, Delete
-- [관계 쿼리](./relations.md) - 중첩 생성, 관계 포함 조회
-- [트랜잭션](./transactions.md) - 배열 기반 트랜잭션, 인터랙티브 트랜잭션
-- [Cloudflare D1](./cloudflare-d1.md) - D1 서버리스 데이터베이스 연동
-
-## 빠른 시작
-
-```bash
-# npm
-npm install @prisma/client@7
-npm install -D prisma@7
-
-# yarn
-yarn add @prisma/client@7
-yarn 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 설정
+## 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'],
-  })
-
+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
+npx prisma migrate dev --name init   # 개발 마이그레이션
+npx prisma migrate deploy            # 프로덕션 마이그레이션
+npx prisma db push                   # 스키마 동기화 (개발용)
+npx prisma generate                  # Client 생성
+npx prisma studio                    # GUI
 ```
-
-## 참고 자료
-
-- [Prisma 공식 문서](https://www.prisma.io/docs)
-- [Prisma GitHub](https://github.com/prisma/prisma)

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

@@ -1,191 +1,69 @@
 # Prisma - 관계 쿼리
 
-> **상위 문서**: [Prisma](./index.md)
-
-## 중첩 생성 (Nested Create)
+## 중첩 생성
 
 ```typescript
-const result = await prisma.user.create({
+const user = 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,
+    email: 'user@prisma.io',
+    posts: { create: [{ title: 'Post 1' }, { title: 'Post 2' }] },
   },
+  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' },
-      },
-    },
-  },
-})
-```
+// connect - 기존 연결
+author: { connect: { id: 1 } }
 
-### disconnect - 관계 해제
+// connectOrCreate - 있으면 연결, 없으면 생성
+categories: { connectOrCreate: { where: { name: 'Tech' }, create: { name: 'Tech' } } }
 
-```typescript
-const post = await prisma.post.update({
-  where: { id: 1 },
-  data: {
-    author: {
-      disconnect: true,
-    },
-  },
-})
+// disconnect - 관계 해제
+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,
-      },
-    },
-  },
-})
-```
+// include
+const users = await prisma.user.findMany({ include: { posts: true, profile: true } })
 
-### 관계 필터링
+// 중첩
+include: { posts: { include: { categories: true } } }
 
-```typescript
-const users = await prisma.user.findMany({
-  include: {
-    posts: {
-      where: { published: true },
-      orderBy: { createdAt: 'desc' },
-      take: 5,
-    },
-  },
-})
+// 필터 + 정렬
+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 },
-    },
-  },
-})
-```
+// some - 하나라도 만족
+where: { posts: { some: { published: true } } }
 
-### none - 조건 만족 없음
+// every - 모두 만족
+where: { posts: { every: { published: true } } }
 
-```typescript
-const users = await prisma.user.findMany({
-  where: {
-    posts: {
-      none: { published: false },
-    },
-  },
-})
+// none - 만족 없음
+where: { posts: { none: { published: false } } }
 ```
 
-## 관계 카운트
+## 카운트
 
 ```typescript
-const users = await prisma.user.findMany({
-  include: {
-    _count: {
-      select: { posts: true },
-    },
-  },
-})
-
-// 결과: { id: 1, name: 'Alice', _count: { posts: 5 } }
+include: { _count: { select: { posts: true } } }
+// 결과: { _count: { posts: 5 } }
 ```
 
-## 중첩 업데이트
+## 중첩 수정/삭제
 
 ```typescript
-const user = await prisma.user.update({
-  where: { id: 1 },
-  data: {
-    posts: {
-      updateMany: {
-        where: { published: false },
-        data: { published: true },
-      },
-    },
-  },
-})
-```
+// updateMany
+posts: { updateMany: { where: { published: false }, data: { published: true } } }
 
-## 중첩 삭제
-
-```typescript
-const user = await prisma.user.update({
-  where: { id: 1 },
-  data: {
-    posts: {
-      deleteMany: {
-        where: { published: false },
-      },
-    },
-  },
-})
+// deleteMany
+posts: { deleteMany: { where: { published: false } } }
 ```

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

@@ -1,275 +1,98 @@
 # Prisma - 스키마 정의 (Multi-File)
 
-> **상위 문서**: [Prisma](./index.md)
+## ⚠️ 필수 규칙
 
-## ⚠️ 필수: Multi-File 구조 사용
+1. **Multi-File 구조** 사용
+2. **모든 요소에 한글 주석** (파일, 모델, 필드, enum)
 
-Prisma 스키마는 **반드시 Multi-File 구조**로 작성합니다.
+## 구조
 
 ```
-prisma/
-├── schema/
-│   ├── +base.prisma      # datasource, generator 설정
-│   ├── +enum.prisma      # 모든 enum 정의
-│   ├── user.prisma       # User 모델
-│   ├── post.prisma       # Post 모델
-│   ├── category.prisma   # Category 모델
-│   └── profile.prisma    # Profile 모델
+prisma/schema/
+├── +base.prisma    # datasource, generator
+├── +enum.prisma    # 모든 enum
+├── user.prisma     # User 모델
+└── post.prisma     # Post 모델
 ```
 
-## ⚠️ 필수: 한글 주석 작성
-
-**Prisma Multi-File의 모든 요소에 한글 주석을 작성해야 합니다.**
-
-```
-✅ 파일별 목적 주석
-✅ 모델별 설명 주석
-✅ 필드별 설명 주석 (용도가 명확하지 않은 경우)
-✅ 관계 설명 주석
-✅ enum 값 설명 주석
-```
-
----
-
-## Multi-File 스키마 예시
-
-### +base.prisma (기본 설정)
+## 예시
 
 ```prisma
-// prisma/schema/+base.prisma
-// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-// Prisma 기본 설정 파일
-// datasource 및 generator 설정
-// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-// 데이터베이스 연결 설정
+// +base.prisma
 datasource db {
   provider = "postgresql"
   url      = env("DATABASE_URL")
 }
 
-// Prisma Client 생성 설정
 generator client {
-  provider = "prisma-client"  // Prisma v7 필수
+  provider = "prisma-client"
   output   = "../generated/prisma"
 }
-```
-
-### +enum.prisma (열거형 정의)
-
-```prisma
-// prisma/schema/+enum.prisma
-// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-// 모든 열거형(enum) 정의 파일
-// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
-// 사용자 권한 열거형
+// +enum.prisma
 enum Role {
   USER   // 일반 사용자
   ADMIN  // 관리자
 }
 
-// 게시글 상태 열거형
-enum PostStatus {
-  DRAFT      // 임시저장
-  PUBLISHED  // 공개됨
-  ARCHIVED   // 보관됨
-}
-```
-
-### user.prisma (User 모델)
-
-```prisma
-// prisma/schema/user.prisma
-// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-// 사용자 모델
-// 시스템의 모든 사용자 정보를 저장
-// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
+// user.prisma
 model User {
-  id           Int              @id @default(autoincrement())
-  email        String           @unique  // 로그인 이메일 (중복 불가)
-  name         String?                   // 표시 이름 (선택)
-  role         Role             @default(USER)  // 사용자 권한
-  posts        Post[]                    // 작성한 게시글 목록
-  profile      ExtendedProfile?          // 확장 프로필 (1:1)
-  createdAt    DateTime         @default(now())
-  updatedAt    DateTime         @updatedAt
-}
-```
-
-### post.prisma (Post 모델)
-
-```prisma
-// prisma/schema/post.prisma
-// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-// 게시글 모델
-// 사용자가 작성한 게시글 정보
-// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-model Post {
-  id         Int        @id @default(autoincrement())
-  title      String                    // 게시글 제목
-  content    String?                   // 게시글 본문 (선택)
-  published  Boolean    @default(false)  // 공개 여부
-  status     PostStatus @default(DRAFT)  // 게시글 상태
-  author     User       @relation(fields: [authorId], references: [id])  // 작성자 관계
-  authorId   Int                       // 작성자 ID (외래키)
-  categories Category[]                // 소속 카테고리 목록 (M:N)
-  createdAt  DateTime   @default(now())
-  updatedAt  DateTime   @updatedAt
-}
-```
-
-### category.prisma (Category 모델)
-
-```prisma
-// prisma/schema/category.prisma
-// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-// 카테고리 모델
-// 게시글 분류를 위한 카테고리
-// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-model Category {
-  id    Int    @id @default(autoincrement())
-  name  String @unique  // 카테고리명 (중복 불가)
-  posts Post[]          // 소속 게시글 목록 (M:N)
-}
-```
-
-### profile.prisma (Profile 모델)
-
-```prisma
-// prisma/schema/profile.prisma
-// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-// 확장 프로필 모델
-// 사용자의 추가 정보 (1:1 관계)
-// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-model ExtendedProfile {
-  id        Int    @id @default(autoincrement())
-  biography String  // 자기소개
-  user      User   @relation(fields: [userId], references: [id])  // 사용자 관계
-  userId    Int    @unique  // 사용자 ID (외래키, 유니크)
-}
-```
-
----
-
-## 선택적 관계
-
-```prisma
-model Post {
-  id       Int   @id @default(autoincrement())
-  author   User? @relation(fields: [authorId], references: [id])
-  authorId Int?
-}
-```
-
-## 커스텀 필드/모델명 매핑
-
-```prisma
-model User {
-  id    Int    @id @default(autoincrement()) @map("user_id")
-  email String @unique
-
-  @@map("users")
+  id        Int      @id @default(autoincrement())
+  email     String   @unique  // 로그인 이메일
+  name      String?           // 표시 이름
+  role      Role     @default(USER)
+  posts     Post[]            // 작성 게시글 (1:N)
+  profile   Profile?          // 프로필 (1:1)
+  createdAt DateTime @default(now())
+  updatedAt DateTime @updatedAt
 }
 ```
 
 ## 관계 유형
 
-### 1:1 관계
-
 ```prisma
-model User {
-  id      Int      @id @default(autoincrement())
-  profile Profile?
-}
-
+// 1:1
 model Profile {
   id     Int  @id @default(autoincrement())
   user   User @relation(fields: [userId], references: [id])
   userId Int  @unique
 }
-```
-
-### 1:N 관계
-
-```prisma
-model User {
-  id    Int    @id @default(autoincrement())
-  posts Post[]
-}
 
+// 1:N
 model Post {
-  id       Int  @id @default(autoincrement())
   author   User @relation(fields: [authorId], references: [id])
   authorId Int
 }
-```
 
-### M:N 관계 (암묵적)
-
-```prisma
-model Post {
-  id         Int        @id @default(autoincrement())
-  categories Category[]
-}
-
-model Category {
-  id    Int    @id @default(autoincrement())
-  posts Post[]
-}
-```
-
-### M:N 관계 (명시적)
-
-```prisma
-model Post {
-  id         Int                @id @default(autoincrement())
-  categories CategoriesOnPosts[]
-}
-
-model Category {
-  id    Int                @id @default(autoincrement())
-  posts CategoriesOnPosts[]
-}
+// M:N (암묵적)
+model Post { categories Category[] }
+model Category { posts Post[] }
 
+// M:N (명시적)
 model CategoriesOnPosts {
   post       Post     @relation(fields: [postId], references: [id])
   postId     Int
   category   Category @relation(fields: [categoryId], references: [id])
   categoryId Int
-  assignedAt DateTime @default(now())
-
   @@id([postId, categoryId])
 }
 ```
 
-## 인덱스
+## 기타
 
 ```prisma
-model Post {
-  id        Int      @id @default(autoincrement())
-  title     String
-  content   String?
-  authorId  Int
-  createdAt DateTime @default(now())
+// 선택적 관계
+author   User? @relation(fields: [authorId], references: [id])
+authorId Int?
 
-  @@index([authorId])
-  @@index([createdAt])
-  @@index([title, authorId])
-}
-```
+// 인덱스
+@@index([authorId])
+@@index([createdAt])
 
-## 복합 키
+// 복합 키
+@@id([postId, tagId])
 
-```prisma
-model PostTag {
-  postId Int
-  tagId  Int
-
-  @@id([postId, tagId])
-}
+// 매핑
+@map("user_id")
+@@map("users")
 ```