@kood/claude-code 0.2.4 → 0.3.0

package/templates/hono/docs/library/hono/env-setup.md

@@ -1,169 +0,0 @@
-# Hono - 환경 변수 설정
-
-> 타입 안전한 환경 변수 관리
-
----
-
-## 파일 구조
-
-```
-프로젝트/
-├── .env                    # 기본 (공통)
-├── .env.development        # 개발 환경
-├── .env.production         # 프로덕션
-├── .env.local              # 로컬 (gitignore)
-├── .env.example            # 템플릿 (커밋용)
-└── src/env.ts              # 검증 및 타입
-```
-
----
-
-## 설치
-
-```bash
-npm install dotenv zod
-npm install -D @types/node
-```
-
----
-
-## Zod로 환경 변수 검증
-
-### src/env.ts
-
-```typescript
-import { z } from 'zod'
-
-const envSchema = z.object({
-  NODE_ENV: z.enum(['development', 'production', 'test']).default('development'),
-  PORT: z.coerce.number().default(3000),
-  DATABASE_URL: z.string().url(),
-  JWT_SECRET: z.string().min(16),
-  JWT_EXPIRES_IN: z.string().default('7d'),
-  OPENAI_API_KEY: z.string().optional(),
-  LOG_LEVEL: z.enum(['debug', 'info', 'warn', 'error']).default('info'),
-  CORS_ORIGIN: z.string().default('*'),
-})
-
-export type Env = z.infer<typeof envSchema>
-
-const parseEnv = (): Env => {
-  const result = envSchema.safeParse(process.env)
-  if (!result.success) {
-    console.error('환경 변수 검증 실패:', result.error.format())
-    process.exit(1)
-  }
-  return result.data
-}
-
-export const env = parseEnv()
-```
-
----
-
-## dotenv 로드
-
-### src/index.ts
-
-```typescript
-import 'dotenv/config'  // 최상단!
-import { serve } from '@hono/node-server'
-import { app } from './app'
-import { env } from './env'
-
-serve({ fetch: app.fetch, port: env.PORT }, (info) => {
-  console.log(`Server: http://localhost:${info.port}`)
-})
-```
-
----
-
-## Hono Bindings
-
-### src/types/hono.ts
-
-```typescript
-import type { Env } from '../env'
-
-export type Bindings = Env
-
-export type Variables = {
-  requestId: string
-  userId?: string
-}
-
-export type HonoEnv = {
-  Bindings: Bindings
-  Variables: Variables
-}
-```
-
-### src/app.ts
-
-```typescript
-import { Hono } from 'hono'
-import type { HonoEnv } from './types/hono'
-import { env } from './env'
-
-export const app = new Hono<HonoEnv>()
-
-// Node.js에서 env 바인딩
-app.use('*', async (c, next) => {
-  Object.assign(c.env, env)
-  await next()
-})
-
-app.get('/', (c) => c.json({ env: c.env.NODE_ENV }))
-```
-
----
-
-## Cloudflare Workers
-
-### wrangler.toml
-
-```toml
-name = "my-hono-app"
-main = "src/index.ts"
-compatibility_date = "2024-01-01"
-
-[vars]
-NODE_ENV = "production"
-LOG_LEVEL = "info"
-```
-
-### .dev.vars (시크릿, gitignore)
-
-```env
-DATABASE_URL=postgresql://localhost:5432/myapp_dev
-JWT_SECRET=dev-secret-key
-```
-
-### 시크릿 설정
-
-```bash
-wrangler secret put DATABASE_URL
-wrangler secret put JWT_SECRET
-```
-
----
-
-## .gitignore
-
-```gitignore
-.env
-.env.local
-.env.*.local
-.dev.vars
-
-!.env.example
-!.env.development
-!.env.production
-```
-
----
-
-## 관련 문서
-
-- [Hono 개요](./index.md)
-- [Cloudflare 배포](../../deployment/cloudflare.md)

package/templates/hono/docs/library/pino/index.md

@@ -1,146 +0,0 @@
-# Pino - Structured Logging
-
-> 초고속 JSON 로거
-
----
-
-## 설치
-
-```bash
-npm install pino pino-pretty
-```
-
----
-
-## 기본 설정
-
-### lib/logger.ts
-
-```typescript
-import pino from 'pino'
-
-const isDev = process.env.NODE_ENV === 'development'
-
-export const logger = pino({
-  level: isDev ? 'debug' : 'info',
-  transport: isDev
-    ? {
-        target: 'pino-pretty',
-        options: {
-          colorize: true,
-          translateTime: 'SYS:yyyy-mm-dd HH:MM:ss',
-          ignore: 'pid,hostname',
-        },
-      }
-    : undefined,
-})
-```
-
----
-
-## 로그 레벨
-
-```typescript
-logger.debug({ data }, 'Debug message')  // 10
-logger.info({ userId }, 'User logged in') // 30
-logger.warn({ attempt }, 'Rate limit')    // 40
-logger.error({ err }, 'Failed')           // 50
-logger.fatal({ err }, 'Crash')            // 60
-```
-
----
-
-## Hono 통합
-
-### 미들웨어
-
-```typescript
-import { createMiddleware } from 'hono/factory'
-import { logger } from '@/lib/logger'
-
-type Env = { Variables: { log: pino.Logger } }
-
-export const loggerMiddleware = createMiddleware<Env>(async (c, next) => {
-  const requestId = c.req.header('x-request-id') ?? crypto.randomUUID()
-  const log = logger.child({ requestId })
-
-  c.set('log', log)
-
-  const start = Date.now()
-  await next()
-
-  log.info({
-    method: c.req.method,
-    path: c.req.path,
-    status: c.res.status,
-    duration: Date.now() - start,
-  }, 'Request completed')
-})
-```
-
-### 사용
-
-```typescript
-app.use(loggerMiddleware)
-
-app.post('/users', async (c) => {
-  const log = c.get('log')
-  const data = c.req.valid('json')
-
-  log.info({ email: data.email }, 'Creating user')
-
-  const user = await prisma.user.create({ data })
-  log.info({ userId: user.id }, 'User created')
-
-  return c.json({ user }, 201)
-})
-```
-
----
-
-## Child Logger
-
-```typescript
-const log = logger.child({
-  requestId: 'abc-123',
-  userId: 'user-456',
-})
-
-log.info('Message with context')
-// {"requestId":"abc-123","userId":"user-456","msg":"Message with context"}
-```
-
----
-
-## 에러 로깅
-
-```typescript
-app.onError((err, c) => {
-  const log = c.get('log')
-
-  log.error({
-    err: {
-      message: err.message,
-      stack: err.stack,
-      name: err.name,
-    },
-    path: c.req.path,
-  }, 'Request failed')
-
-  return c.json({ error: 'Internal Server Error' }, 500)
-})
-```
-
----
-
-## 프로덕션 출력
-
-```json
-{"level":30,"time":1705312245000,"requestId":"abc-123","msg":"Request completed","method":"POST","path":"/users","status":201,"duration":45}
-```
-
----
-
-## 관련 문서
-
-- [Hono 미들웨어](../hono/middleware.md)

package/templates/tanstack-start/docs/architecture/architecture.md

@@ -1,243 +0,0 @@
-# Architecture
-
-TanStack Start 애플리케이션 아키텍처 가이드.
-
-## 목차
-
-- [System Overview](#system-overview)
-- [Layer Architecture](#layer-architecture)
-  - [Routes Layer](#1-routes-layer)
-  - [Services Layer](#2-services-layer)
-  - [Server Functions Layer](#3-server-functions-layer)
-  - [Database Layer](#4-database-layer)
-- [Data Flow](#data-flow)
-- [Technology Stack](#technology-stack)
-
----
-
-## System Overview
-
-```
-┌─────────────────────────────────────────────────────────────────┐
-│                         Client (Browser)                         │
-│  ┌────────────────┐    ┌────────────────┐    ┌───────────────┐  │
-│  │  React Router  │───▶│ TanStack Query │───▶│    React UI   │  │
-│  │  (Navigation)  │◀───│   (Caching)    │◀───│  (Components) │  │
-│  └────────────────┘    └───────┬────────┘    └───────────────┘  │
-└────────────────────────────────┼─────────────────────────────────┘
-                                 ▼
-┌─────────────────────────────────────────────────────────────────┐
-│                    TanStack Start Server                         │
-│  ┌────────────────────────────────────────────────────────────┐ │
-│  │                    Server Functions                         │ │
-│  │   routes/-functions/ → 페이지 전용 | functions/ → 글로벌   │ │
-│  └────────────────────────────┬───────────────────────────────┘ │
-│  ┌────────────────────────────▼───────────────────────────────┐ │
-│  │                    Services Layer                           │ │
-│  │   Zod Validation | Business Logic | Data Transformation    │ │
-│  └────────────────────────────┬───────────────────────────────┘ │
-└───────────────────────────────┼──────────────────────────────────┘
-                                ▼
-┌─────────────────────────────────────────────────────────────────┐
-│                        Database Layer                            │
-│  ┌────────────────┐    ┌────────────────┐    ┌───────────────┐  │
-│  │  Prisma Client │───▶│   PostgreSQL   │    │    Redis      │  │
-│  └────────────────┘    └────────────────┘    └───────────────┘  │
-└─────────────────────────────────────────────────────────────────┘
-```
-
-## Layer Architecture
-
-### 1. Routes Layer
-
-```
-routes/<route-name>/
-├── (main)/                # route group (목록 페이지)
-│   ├── index.tsx          # 페이지 컴포넌트
-│   ├── -components/       # 페이지 전용 컴포넌트
-│   ├── -sections/         # UI 섹션 분리 (200줄+ 페이지)
-│   ├── -tabs/             # 탭 콘텐츠 분리
-│   ├── -hooks/            # 페이지 전용 훅
-│   └── -utils/            # 상수, 헬퍼
-├── new/                   # 생성 페이지 (route group 외부)
-│   └── index.tsx
-├── route.tsx              # route 설정 (loader, beforeLoad)
-└── -functions/            # 페이지 전용 서버 함수
-```
-
-#### Route Group 패턴 `(main)`
-
-목록 페이지는 반드시 `(main)` route group으로 감싸야 한다:
-
-```
-routes/dashboard/companies/
-├── (main)/                # /dashboard/companies (목록)
-│   ├── index.tsx
-│   └── -components/
-└── new/                   # /dashboard/companies/new (생성)
-    └── index.tsx
-```
-
-**규칙:**
-- 목록 페이지 → `(main)/` 내부
-- 생성/편집 페이지 → `(main)/` 외부
-- URL에 `(main)`은 포함되지 않음
-
-#### 페이지 크기 기준
-
-| 줄 수 | 권장 조치 |
-|-------|----------|
-| ~100줄 | 단일 파일 OK |
-| 100-200줄 | -components 분리 검토 |
-| 200줄+ | -sections 분리 필수 |
-| 탭 UI | -tabs 분리 권장 |
-
-#### `-sections/` 패턴 (200줄+ 페이지)
-
-큰 페이지는 논리적 섹션으로 분리:
-
-```tsx
-// routes/settings/(main)/index.tsx
-import { GeneralSection } from './-sections/general-section'
-import { SecuritySection } from './-sections/security-section'
-import { NotificationSection } from './-sections/notification-section'
-
-function SettingsPage() {
-  return (
-    <div className="space-y-8">
-      <GeneralSection />
-      <SecuritySection />
-      <NotificationSection />
-    </div>
-  )
-}
-```
-
-```
-routes/settings/(main)/
-├── index.tsx
-└── -sections/
-    ├── general-section.tsx
-    ├── security-section.tsx
-    └── notification-section.tsx
-```
-
-#### `-tabs/` 패턴 (탭 UI)
-
-탭 기반 페이지는 각 탭을 별도 파일로 분리:
-
-```tsx
-// routes/project-settings/(main)/index.tsx
-import { Tabs, TabsContent, TabsList, TabsTrigger } from '@/components/ui/tabs'
-import { GeneralTab } from './-tabs/general-tab'
-import { MembersTab } from './-tabs/members-tab'
-import { DangerTab } from './-tabs/danger-tab'
-
-function ProjectSettingsPage() {
-  return (
-    <Tabs defaultValue="general">
-      <TabsList>
-        <TabsTrigger value="general">일반</TabsTrigger>
-        <TabsTrigger value="members">멤버</TabsTrigger>
-        <TabsTrigger value="danger">위험</TabsTrigger>
-      </TabsList>
-      <TabsContent value="general"><GeneralTab /></TabsContent>
-      <TabsContent value="members"><MembersTab /></TabsContent>
-      <TabsContent value="danger"><DangerTab /></TabsContent>
-    </Tabs>
-  )
-}
-```
-
-```
-routes/project-settings/(main)/
-├── index.tsx
-└── -tabs/
-    ├── general-tab.tsx
-    ├── members-tab.tsx
-    └── danger-tab.tsx
-```
-
-### 2. Services Layer
-
-```
-services/<domain>/
-├── index.ts            # 진입점 (re-export)
-├── schemas.ts          # Zod 스키마
-├── queries.ts          # GET 요청
-└── mutations.ts        # POST 요청
-```
-
-### 3. Server Functions Layer
-
-```
-functions/                    # 글로벌 서버 함수
-├── index.ts
-├── <function-name>.ts        # 파일당 하나의 함수
-└── middlewares/
-    └── <middleware-name>.ts
-
-routes/<route>/-functions/    # 페이지 전용
-└── <function-name>.ts
-```
-
-**규칙**: 파일당 하나의 함수, 글로벌 vs 로컬 분리
-
-### 4. Database Layer
-
-```typescript
-// database/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
-}
-```
-
-## Data Flow
-
-### Query Flow (읽기)
-
-```
-Page Hook → useQuery → Server Function (GET) → Prisma → Database
-                 ↑
-           TanStack Query (Cache)
-```
-
-### Mutation Flow (쓰기)
-
-```
-Form Submit → useMutation → Server Function (POST)
-                                    ↓
-                            Zod Validation
-                                    ↓
-                            Prisma Mutation → Database
-                                    ↓
-                            Cache Invalidate
-```
-
-## Technology Stack
-
-| Layer | Technology | Version |
-|-------|------------|---------|
-| Framework | TanStack Start | latest |
-| Router | TanStack Router | latest |
-| Data | TanStack Query | latest |
-| ORM | Prisma | 7.x |
-| Validation | Zod | 4.x |
-| Database | PostgreSQL | - |
-| UI | React 18+ | - |
-
-## 관련 문서
-
-- [conventions.md](../guides/conventions.md) - 코드 컨벤션
-- [routes.md](../guides/routes.md) - 라우트 구조
-- [hooks.md](../guides/hooks.md) - Custom Hook 패턴
-- [services.md](../guides/services.md) - Service Layer

package/templates/tanstack-start/docs/deployment/cloudflare.md

@@ -1,132 +0,0 @@
-# Cloudflare 배포
-
-## Quick Reference (Workers 직접 통합)
-
-```typescript
-// vite.config.ts
-import { cloudflare } from '@cloudflare/vite-plugin'
-import { tanstackStart } from '@tanstack/react-start/plugin/vite'
-
-export default defineConfig({
-  plugins: [
-    cloudflare({ viteEnvironment: { name: 'ssr' } }),
-    tanstackStart(),
-    viteReact(),
-  ],
-})
-```
-
-```jsonc
-// wrangler.jsonc
-{
-  "name": "my-app",
-  "compatibility_date": "2024-09-19",
-  "compatibility_flags": ["nodejs_compat"],
-  "main": "@tanstack/react-start/server-entry"
-}
-```
-
-```bash
-yarn add -D @cloudflare/vite-plugin wrangler
-yarn build && wrangler deploy
-```
-
----
-
-## 배포 옵션
-
-| 옵션 | 방식 | 권장 |
-|------|------|------|
-| Workers | 직접 통합 | ✅ |
-| Pages | Nitro `cloudflare_pages` | - |
-
----
-
-## Pages (Nitro)
-
-```typescript
-// nitro.config.ts
-export default defineNitroConfig({
-  preset: 'cloudflare_pages',
-  compatibilityDate: '2024-09-19',
-  cloudflare: { deployConfig: true, nodeCompat: true },
-})
-```
-
-```bash
-yarn build
-wrangler pages deploy .output/public
-```
-
----
-
-## Wrangler 설정
-
-```jsonc
-// wrangler.jsonc (Workers)
-{
-  "name": "my-app",
-  "compatibility_date": "2024-09-19",
-  "compatibility_flags": ["nodejs_compat"],
-  "main": "@tanstack/react-start/server-entry",
-  "vars": { "MY_VAR": "value" },
-  "kv_namespaces": [{ "binding": "MY_KV", "id": "kv-id" }],
-  "d1_databases": [{ "binding": "DB", "database_name": "my-db", "database_id": "db-id" }]
-}
-```
-
----
-
-## KV / D1 사용
-
-```typescript
-// server/api/example.ts
-export default defineHandler(async (event) => {
-  const env = event.context.cloudflare.env
-  const value = await env.MY_KV.get('key')
-  await env.MY_KV.put('key', 'value')
-  const results = await env.DB.prepare('SELECT * FROM users').all()
-  return { value, results }
-})
-```
-
----
-
-## 환경변수
-
-```bash
-# .dev.vars (로컬)
-DATABASE_URL=your-local-url
-
-# 프로덕션 시크릿
-wrangler secret put API_SECRET
-```
-
----
-
-## CI/CD
-
-```yaml
-# .github/workflows/cloudflare.yml
-- uses: cloudflare/wrangler-action@v3
-  with:
-    apiToken: ${{ secrets.CLOUDFLARE_API_TOKEN }}
-    command: deploy
-```
-
----
-
-## 트러블슈팅
-
-```typescript
-// nitro.config.ts - Node.js 호환성
-cloudflare: { nodeCompat: true }
-
-// 번들 최적화
-externals: ['@prisma/client']
-minify: true
-```
-
-```bash
-wrangler tail  # 실시간 로그
-```