@kood/claude-code 0.1.5 → 0.1.7

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

@@ -1,235 +1,65 @@
-# Prisma - Config 파일 (prisma.config.ts)
+# Prisma - Config 파일
 
-> **상위 문서**: [Prisma](./index.md)
+Prisma v7 `prisma.config.ts` 설정.
 
-Prisma v7에서 도입된 `prisma.config.ts` 설정 파일입니다.
-
----
-
-## ⚠️ 필수: Multi-File 스키마 설정
-
-Multi-File 스키마를 사용하려면 **반드시** `prisma.config.ts`에서 스키마 폴더를 지정해야 합니다.
-
-```typescript
-// prisma.config.ts
-import path from 'node:path'
-import { defineConfig, env } from 'prisma/config'
-
-export default defineConfig({
-  // Multi-File 스키마 폴더 지정
-  schema: path.join('prisma', 'schema'),
-  datasource: {
-    url: env('DATABASE_URL'),
-  },
-})
-```
-
----
-
-## 파일 위치 및 이름
-
-### 지원되는 파일명
-
-```
-prisma.config.ts      # 권장 (소규모 프로젝트)
-prisma.config.js
-prisma.config.mjs
-prisma.config.cjs
-prisma.config.mts
-prisma.config.cts
-
-.config/prisma.ts     # 권장 (대규모 프로젝트)
-.config/prisma.js
-```
-
-### 권장 위치
-
-```
-프로젝트/
-├── prisma.config.ts      # 프로젝트 루트
-├── prisma/
-│   ├── schema/           # Multi-File 스키마 폴더
-│   │   ├── +base.prisma
-│   │   ├── +enum.prisma
-│   │   └── user.prisma
-│   └── migrations/       # 마이그레이션 폴더
-└── package.json
-```
-
----
-
-## 설정 옵션
-
-### 전체 옵션 목록
-
-| 옵션 | 타입 | 필수 | 설명 |
-|------|------|------|------|
-| `schema` | string | ❌ | 스키마 파일 또는 폴더 경로 |
-| `datasource.url` | string | ✅ | 데이터베이스 연결 URL |
-| `datasource.shadowDatabaseUrl` | string | ❌ | Shadow DB URL |
-| `migrations.path` | string | ❌ | 마이그레이션 폴더 경로 |
-| `migrations.seed` | string | ❌ | 시드 스크립트 명령어 |
-| `migrations.initShadowDb` | string | ❌ | Shadow DB 초기화 SQL |
-| `views.path` | string | ❌ | SQL 뷰 정의 폴더 |
-| `typedSql.path` | string | ❌ | TypedSQL 파일 폴더 |
-| `experimental` | object | ❌ | 실험적 기능 활성화 |
-
----
-
-## 기본 설정 예시
-
-### defineConfig 사용 (권장)
+## Multi-File 스키마 (필수)
 
 ```typescript
 // prisma.config.ts
 import 'dotenv/config'
+import path from 'node:path'
 import { defineConfig, env } from 'prisma/config'
 
 export default defineConfig({
-  // Multi-File 스키마 설정
-  schema: 'prisma/schema',
-
-  // 마이그레이션 설정
+  schema: path.join('prisma', 'schema'),  // 폴더 경로!
   migrations: {
     path: 'prisma/migrations',
     seed: 'tsx prisma/seed.ts',
   },
-
-  // 데이터베이스 연결
   datasource: {
     url: env('DATABASE_URL'),
   },
 })
 ```
 
-### satisfies 사용
+## 폴더 구조
 
-```typescript
-// prisma.config.ts
-import 'dotenv/config'
-import type { PrismaConfig } from 'prisma'
-import { env } from 'prisma/config'
-
-export default {
-  schema: 'prisma/schema',
-  migrations: {
-    path: 'prisma/migrations',
-    seed: 'tsx prisma/seed.ts',
-  },
-  datasource: {
-    url: env('DATABASE_URL'),
-  },
-} satisfies PrismaConfig
 ```
-
----
-
-## Multi-File 스키마 설정
-
-### 필수 설정
-
-```typescript
-// prisma.config.ts
-import path from 'node:path'
-import { defineConfig, env } from 'prisma/config'
-
-export default defineConfig({
-  // ⚠️ 폴더 경로 지정 (파일이 아님!)
-  schema: path.join('prisma', 'schema'),
-  datasource: {
-    url: env('DATABASE_URL'),
-  },
-})
-```
-
-### 폴더 구조
-
-```
-prisma/
-├── schema/                    # Multi-File 스키마 폴더
-│   ├── +base.prisma          # datasource, generator 설정
-│   ├── +enum.prisma          # 모든 enum 정의
-│   ├── user.prisma           # User 모델
-│   ├── post.prisma           # Post 모델
-│   └── ...
-└── migrations/               # ⚠️ datasource와 같은 레벨에 위치
+프로젝트/
+├── prisma.config.ts
+├── prisma/
+│   ├── schema/
+│   │   ├── +base.prisma   # datasource, generator
+│   │   ├── +enum.prisma   # enum 정의
+│   │   └── user.prisma    # 모델
+│   └── migrations/
 ```
 
-### +base.prisma 예시
+## +base.prisma
 
 ```prisma
-// prisma/schema/+base.prisma
-// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-// Prisma 기본 설정 파일
-// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-// 데이터베이스 연결 설정
 datasource db {
   provider = "postgresql"
   url      = env("DATABASE_URL")
 }
 
-// Prisma Client 생성 설정
 generator client {
-  provider = "prisma-client"  // Prisma v7 필수
+  provider = "prisma-client"
   output   = "../../generated/prisma"
 }
 ```
 
----
-
-## 환경 변수 설정
-
-### dotenv 설치
-
-```bash
-npm install dotenv
-```
-
-### 환경 변수 사용
-
-```typescript
-// prisma.config.ts
-import 'dotenv/config'  // ⚠️ 반드시 최상단에 import
-import { defineConfig, env } from 'prisma/config'
-
-export default defineConfig({
-  schema: 'prisma/schema',
-  datasource: {
-    url: env('DATABASE_URL'),  // 타입 안전한 환경 변수 접근
-  },
-})
-```
-
-### .env 파일
-
-```env
-DATABASE_URL="postgresql://user:password@localhost:5432/mydb"
-```
-
----
-
-## 마이그레이션 설정
+## 설정 옵션
 
-### 시드 스크립트
+| 옵션 | 설명 |
+|------|------|
+| `schema` | 스키마 폴더 경로 |
+| `datasource.url` | DB URL (필수) |
+| `datasource.shadowDatabaseUrl` | Shadow DB URL |
+| `migrations.path` | 마이그레이션 폴더 |
+| `migrations.seed` | 시드 명령어 |
 
-```typescript
-// prisma.config.ts
-import { defineConfig, env } from 'prisma/config'
-
-export default defineConfig({
-  schema: 'prisma/schema',
-  migrations: {
-    path: 'prisma/migrations',
-    seed: 'tsx prisma/seed.ts',  // 시드 명령어
-  },
-  datasource: {
-    url: env('DATABASE_URL'),
-  },
-})
-```
-
-### 시드 파일 예시
+## 시드 파일
 
 ```typescript
 // prisma/seed.ts
@@ -238,140 +68,10 @@ import { PrismaClient } from '../generated/prisma'
 const prisma = new PrismaClient()
 
 async function main() {
-  // 초기 데이터 생성
   await prisma.user.create({
-    data: {
-      email: 'admin@example.com',
-      name: '관리자',
-      role: 'ADMIN',
-    },
+    data: { email: 'admin@example.com', name: '관리자', role: 'ADMIN' },
   })
 }
 
-main()
-  .catch(console.error)
-  .finally(() => prisma.$disconnect())
-```
-
----
-
-## Shadow Database 설정
-
-마이그레이션 시 사용되는 임시 데이터베이스입니다.
-
-```typescript
-// prisma.config.ts
-import { defineConfig, env } from 'prisma/config'
-
-export default defineConfig({
-  schema: 'prisma/schema',
-  datasource: {
-    url: env('DATABASE_URL'),
-    shadowDatabaseUrl: env('SHADOW_DATABASE_URL'),
-  },
-})
+main().catch(console.error).finally(() => prisma.$disconnect())
 ```
-
----
-
-## 실험적 기능
-
-### External Tables
-
-외부에서 관리되는 테이블 설정:
-
-```typescript
-// prisma.config.ts
-import { defineConfig, env } from 'prisma/config'
-
-export default defineConfig({
-  schema: 'prisma/schema',
-  experimental: {
-    externalTables: true,
-  },
-  tables: {
-    external: ['public.users'],
-  },
-  enums: {
-    external: ['public.role'],
-  },
-  datasource: {
-    url: env('DATABASE_URL'),
-  },
-})
-```
-
----
-
-## 경로 해석 규칙
-
-### 중요 사항
-
-- 모든 경로는 **config 파일 위치 기준**으로 해석됩니다
-- CLI 명령어 실행 위치가 아닙니다!
-
-### 예시
-
-```
-프로젝트/
-├── prisma.config.ts          # 여기가 기준!
-├── prisma/
-│   └── schema/
-└── src/
-```
-
-```typescript
-// prisma.config.ts
-export default defineConfig({
-  // ✅ prisma.config.ts 기준 상대 경로
-  schema: 'prisma/schema',
-
-  // ❌ 이렇게 하지 마세요
-  schema: './prisma/schema',  // ./ 불필요
-})
-```
-
-### 커스텀 경로 지정
-
-```bash
-# --config 플래그로 config 파일 위치 지정
-npx prisma validate --config ./path/to/myconfig.ts
-```
-
----
-
-## 전체 설정 예시
-
-```typescript
-// prisma.config.ts
-// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-// Prisma v7 설정 파일
-// Multi-File 스키마 및 마이그레이션 설정
-// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-import 'dotenv/config'
-import path from 'node:path'
-import { defineConfig, env } from 'prisma/config'
-
-export default defineConfig({
-  // Multi-File 스키마 폴더
-  schema: path.join('prisma', 'schema'),
-
-  // 마이그레이션 설정
-  migrations: {
-    path: 'prisma/migrations',
-    seed: 'tsx prisma/seed.ts',
-  },
-
-  // 데이터베이스 연결
-  datasource: {
-    url: env('DATABASE_URL'),
-  },
-})
-```
-
----
-
-## 관련 문서
-
-- [스키마 정의 (Multi-File)](./schema.md)
-- [설치 및 설정](./setup.md)

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

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