@kood/claude-code 0.1.0

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

@@ -0,0 +1,177 @@
+# Prisma - 스키마 정의
+
+> **상위 문서**: [Prisma](./index.md)
+
+## 기본 스키마
+
+```prisma
+// prisma/schema.prisma
+datasource db {
+  provider = "postgresql"
+  url      = env("DATABASE_URL")
+}
+
+generator client {
+  provider = "prisma-client"
+  output   = "../generated/prisma"
+}
+
+model User {
+  id           Int              @id @default(autoincrement())
+  email        String           @unique
+  name         String?
+  role         Role             @default(USER)
+  posts        Post[]
+  profile      ExtendedProfile?
+  createdAt    DateTime         @default(now())
+  updatedAt    DateTime         @updatedAt
+}
+
+model Post {
+  id         Int        @id @default(autoincrement())
+  title      String
+  content    String?
+  published  Boolean    @default(false)
+  author     User       @relation(fields: [authorId], references: [id])
+  authorId   Int
+  categories Category[]
+  createdAt  DateTime   @default(now())
+  updatedAt  DateTime   @updatedAt
+}
+
+model Category {
+  id    Int    @id @default(autoincrement())
+  name  String @unique
+  posts Post[]
+}
+
+model ExtendedProfile {
+  id        Int    @id @default(autoincrement())
+  biography String
+  user      User   @relation(fields: [userId], references: [id])
+  userId    Int    @unique
+}
+
+enum Role {
+  USER
+  ADMIN
+}
+```
+
+## 선택적 관계
+
+```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")
+}
+```
+
+## 관계 유형
+
+### 1:1 관계
+
+```prisma
+model User {
+  id      Int      @id @default(autoincrement())
+  profile Profile?
+}
+
+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[]
+}
+
+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[]
+}
+
+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())
+
+  @@index([authorId])
+  @@index([createdAt])
+  @@index([title, authorId])
+}
+```
+
+## 복합 키
+
+```prisma
+model PostTag {
+  postId Int
+  tagId  Int
+
+  @@id([postId, tagId])
+}
+```

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

@@ -0,0 +1,156 @@
+# Prisma - 설치 및 설정
+
+> **상위 문서**: [Prisma](./index.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
+
+# bun
+bun add @prisma/client@7
+bun add prisma@7 --dev
+
+# 초기화
+npx prisma init
+```
+
+## v6에서 v7 업그레이드
+
+```bash
+# npm
+npm install @prisma/client@7
+npm install -D prisma@7
+
+# yarn
+yarn up prisma@7 @prisma/client@7
+
+# pnpm
+pnpm upgrade prisma@7 @prisma/client@7
+```
+
+### Generator 변경 (필수)
+
+```prisma
+// schema.prisma - 이전 (v6)
+generator client {
+  provider = "prisma-client-js"
+}
+
+// schema.prisma - v7
+generator client {
+  provider = "prisma-client"        // 새로운 provider
+  output   = "../generated/prisma"  // output 필수
+}
+```
+
+## Prisma Client 설정
+
+### 기본 설정
+
+```typescript
+// lib/prisma.ts
+import { PrismaClient } from './generated/prisma'  // output 경로에서 import
+
+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
+import { PrismaClient } from './generated/prisma'
+
+const prisma = new PrismaClient({
+  log: [{ level: 'query', emit: 'event' }],
+})
+
+prisma.$on('query', (e) => {
+  console.log('Query:', e.query)
+  console.log('Params:', e.params)
+  console.log('Duration:', e.duration, 'ms')
+})
+```
+
+### QueryEvent 타입
+
+```typescript
+type QueryEvent = {
+  timestamp: Date
+  query: string
+  params: string
+  duration: number
+  target: string
+}
+```
+
+## TanStack Start 통합
+
+```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()
+
+if (process.env.NODE_ENV !== 'production') globalForPrisma.prisma = prisma
+
+// Server Function에서 사용
+import { createServerFn } from '@tanstack/react-start'
+import { prisma } from '~/lib/prisma'
+
+export const getUsers = createServerFn({ method: 'GET' })
+  .handler(async () => {
+    return prisma.user.findMany({
+      include: { posts: true },
+    })
+  })
+
+export const createUser = createServerFn({ method: 'POST' })
+  .inputValidator((data: { email: string; name: string }) => data)
+  .handler(async ({ data }) => {
+    return prisma.user.create({ data })
+  })
+```
+
+## 마이그레이션
+
+```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
+```

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

@@ -0,0 +1,140 @@
+# Prisma - 트랜잭션
+
+> **상위 문서**: [Prisma](./index.md)
+
+## 배열 기반 트랜잭션
+
+여러 쿼리를 순차적으로 실행하고, 하나라도 실패하면 모두 롤백됩니다.
+
+```typescript
+// 관계 데이터 삭제
+const deletePosts = prisma.post.deleteMany({
+  where: { authorId: 7 },
+})
+
+const deleteUser = prisma.user.delete({
+  where: { id: 7 },
+})
+
+const transaction = await prisma.$transaction([deletePosts, deleteUser])
+```
+
+## GDPR 데이터 삭제 예시
+
+```typescript
+const id = 9 // 삭제할 사용자
+
+const deletePosts = prisma.post.deleteMany({
+  where: { userId: id },
+})
+
+const deleteMessages = prisma.privateMessage.deleteMany({
+  where: { userId: id },
+})
+
+const deleteUser = prisma.user.delete({
+  where: { id: id },
+})
+
+// 모든 작업이 성공하거나 모두 실패
+await prisma.$transaction([deletePosts, deleteMessages, deleteUser])
+```
+
+## 모든 데이터 삭제
+
+```typescript
+const deletePosts = prisma.post.deleteMany()
+const deleteProfile = prisma.profile.deleteMany()
+const deleteUsers = prisma.user.deleteMany()
+
+// 순서대로 실행 (deleteUsers가 마지막)
+await prisma.$transaction([deleteProfile, deletePosts, deleteUsers])
+```
+
+## 인터랙티브 트랜잭션
+
+더 복잡한 트랜잭션 로직이 필요할 때 사용합니다.
+
+```typescript
+const result = await prisma.$transaction(async (tx) => {
+  // 1. 잔액 확인
+  const sender = await tx.account.findUnique({
+    where: { id: senderId },
+  })
+
+  if (!sender || sender.balance < amount) {
+    throw new Error('Insufficient balance')
+  }
+
+  // 2. 보내는 계좌에서 차감
+  const updatedSender = await tx.account.update({
+    where: { id: senderId },
+    data: { balance: { decrement: amount } },
+  })
+
+  // 3. 받는 계좌에 입금
+  const updatedRecipient = await tx.account.update({
+    where: { id: recipientId },
+    data: { balance: { increment: amount } },
+  })
+
+  return { sender: updatedSender, recipient: updatedRecipient }
+})
+```
+
+## 트랜잭션 옵션
+
+```typescript
+await prisma.$transaction(
+  async (tx) => {
+    // 트랜잭션 로직
+  },
+  {
+    maxWait: 5000, // 최대 대기 시간 (ms)
+    timeout: 10000, // 트랜잭션 타임아웃 (ms)
+    isolationLevel: 'Serializable', // 격리 수준
+  }
+)
+```
+
+## 격리 수준
+
+```typescript
+// 가능한 격리 수준
+type IsolationLevel =
+  | 'ReadUncommitted'
+  | 'ReadCommitted'
+  | 'RepeatableRead'
+  | 'Serializable'
+```
+
+## 타입 안전 Raw Query
+
+```typescript
+import { selectUserTitles, updateUserName } from '@prisma/client/sql'
+
+const [userList, updateUser] = await prisma.$transaction([
+  prisma.$queryRawTyped(selectUserTitles()),
+  prisma.$queryRawTyped(updateUserName(2)),
+])
+```
+
+## 트랜잭션 내 에러 처리
+
+```typescript
+try {
+  await prisma.$transaction(async (tx) => {
+    await tx.user.create({ data: { email: 'alice@prisma.io' } })
+
+    // 의도적 에러 발생 시 전체 롤백
+    if (someCondition) {
+      throw new Error('Rollback transaction')
+    }
+
+    await tx.post.create({ data: { title: 'Hello', authorId: 1 } })
+  })
+} catch (error) {
+  console.error('Transaction failed:', error)
+  // 트랜잭션 내 모든 변경사항이 롤백됨
+}
+```

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

@@ -0,0 +1,146 @@
+# TanStack Query
+
+> **Version**: 5.x | React Data Fetching Library
+
+---
+
+## 🚀 Quick Reference (복사용)
+
+```typescript
+// useQuery - 데이터 조회
+const { data, isLoading, error } = useQuery({
+  queryKey: ['users'],
+  queryFn: () => getUsers(),
+})
+
+// useMutation - 데이터 변경
+const queryClient = useQueryClient()
+const mutation = useMutation({
+  mutationFn: createUser,
+  onSuccess: () => {
+    queryClient.invalidateQueries({ queryKey: ['users'] })
+  },
+})
+
+// mutation 실행
+mutation.mutate({ email, name })
+
+// Optimistic Update
+const mutation = useMutation({
+  mutationFn: updateUser,
+  onMutate: async (newUser) => {
+    await queryClient.cancelQueries({ queryKey: ['users'] })
+    const previous = queryClient.getQueryData(['users'])
+    queryClient.setQueryData(['users'], (old) => [...old, newUser])
+    return { previous }
+  },
+  onError: (err, newUser, context) => {
+    queryClient.setQueryData(['users'], context.previous)
+  },
+})
+```
+
+### QueryClient 설정
+
+```tsx
+import { QueryClient, QueryClientProvider } from '@tanstack/react-query'
+
+const queryClient = new QueryClient()
+
+function App() {
+  return (
+    <QueryClientProvider client={queryClient}>
+      <YourApp />
+    </QueryClientProvider>
+  )
+}
+```
+
+---
+
+## 문서 구조
+
+- [설치 및 설정](./setup.md) - QueryClient 설정
+- [useQuery](./use-query.md) - 데이터 조회 훅
+- [useMutation](./use-mutation.md) - 데이터 변경 훅
+- [무효화](./invalidation.md) - Query 무효화 및 리페치
+- [Optimistic Updates](./optimistic-updates.md) - 낙관적 업데이트
+
+## 빠른 시작
+
+```bash
+yarn add @tanstack/react-query
+```
+
+### QueryClient 설정
+
+```tsx
+import {
+  QueryClient,
+  QueryClientProvider,
+} from '@tanstack/react-query'
+
+const queryClient = new QueryClient()
+
+function App() {
+  return (
+    <QueryClientProvider client={queryClient}>
+      <YourApp />
+    </QueryClientProvider>
+  )
+}
+```
+
+## 핵심 개념
+
+### useQuery - 데이터 조회
+
+```tsx
+import { useQuery } from '@tanstack/react-query'
+
+function Todos() {
+  const { data, isLoading, error } = useQuery({
+    queryKey: ['todos'],
+    queryFn: getTodos,
+  })
+
+  if (isLoading) return <div>Loading...</div>
+  if (error) return <div>Error: {error.message}</div>
+
+  return (
+    <ul>
+      {data?.map((todo) => (
+        <li key={todo.id}>{todo.title}</li>
+      ))}
+    </ul>
+  )
+}
+```
+
+### useMutation - 데이터 변경
+
+```tsx
+import { useMutation, useQueryClient } from '@tanstack/react-query'
+
+function AddTodo() {
+  const queryClient = useQueryClient()
+
+  const mutation = useMutation({
+    mutationFn: postTodo,
+    onSuccess: () => {
+      queryClient.invalidateQueries({ queryKey: ['todos'] })
+    },
+  })
+
+  return (
+    <button onClick={() => mutation.mutate({ title: 'New Todo' })}>
+      Add Todo
+    </button>
+  )
+}
+```
+
+## 참고 자료
+
+- [TanStack Query 공식 문서](https://tanstack.com/query/latest)
+- [TanStack Query GitHub](https://github.com/tanstack/query)