sonamu 0.8.24 → 0.8.26

package/src/skills/sonamu/config.md

@@ -1,17 +1,17 @@
 ---
 name: sonamu-config
-description: Sonamu 프로젝트 설정. .env 환경변수, sonamu.config.ts 설정. Use when configuring a new Sonamu project.
+description: Sonamu project configuration. .env environment variables, sonamu.config.ts settings. Use when configuring a new Sonamu project.
 ---
 
-# Sonamu 프로젝트 설정
+# Sonamu Project Configuration
 
-프로젝트 생성 후 `.env`와 `sonamu.config.ts` 설정 가이드.
+A guide for setting up `.env` and `sonamu.config.ts` after project creation.
 
-## .env 파일
+## .env File
 
-위치: `packages/api/.env`
+Location: `packages/api/.env`
 
-### 기본 환경변수 (create-sonamu 생성)
+### Default Environment Variables (generated by create-sonamu)
 
 ```env
 # Database Configuration
@@ -24,49 +24,49 @@ DATABASE_NAME=myproject
 PROJECT_NAME=myproject
 ```
 
-### 추가 환경변수 (필요시)
+### Additional Environment Variables (as needed)
 
 ```env
-# Session (프로덕션에서 반드시 변경)
+# Session (must be changed in production)
 SESSION_SECRET=your-secret-key-change-in-production
 SESSION_SALT=random-16-char-salt
 
-# AWS S3 (파일 업로드용)
+# AWS S3 (for file uploads)
 AWS_ACCESS_KEY_ID=your-access-key
 AWS_SECRET_ACCESS_KEY=your-secret-key
 S3_REGION=ap-northeast-2
 S3_BUCKET=your-bucket-name
 
-# Slack 알림 (마이그레이션 확인용)
+# Slack notifications (for migration confirmation)
 SLACK_BOT_TOKEN=xoxb-your-token
 SLACK_CHANNEL_ID=C0123456789
 ```
 
-### 환경변수 설명
+### Environment Variable Reference
 
-| 변수 | 필수 | 설명 |
+| Variable | Required | Description |
 |-----|-----|------|
-| `DB_HOST` | ✓ | DB 호스트 (Docker: `0.0.0.0`, 외부 DB: 해당 IP) |
-| `DB_PORT` | ✓ | DB 포트 (기본값: `5432`) |
-| `DB_USER` | ✓ | DB 사용자명 (기본값: `postgres`) |
-| `DB_PASSWORD` | ✓ | DB 비밀번호 |
-| `DATABASE_NAME` | ✓ | 데이터베이스명 |
-| `PROJECT_NAME` | ✓ | 프로젝트명 (Docker, config에서 사용) |
-| `CONTAINER_NAME` | | Docker 컨테이너명 |
-| `SESSION_SECRET` | | 세션 암호화 키 (프로덕션 필수) |
-| `SESSION_SALT` | | 세션 salt (16자) |
-| `AWS_ACCESS_KEY_ID` | | S3 사용 시 필수 |
-| `AWS_SECRET_ACCESS_KEY` | | S3 사용 시 필수 |
-| `S3_REGION` | | S3 리전 (기본값: `ap-northeast-2`) |
-| `S3_BUCKET` | | S3 버킷명 |
+| `DB_HOST` | ✓ | DB host (Docker: `0.0.0.0`, external DB: the relevant IP) |
+| `DB_PORT` | ✓ | DB port (default: `5432`) |
+| `DB_USER` | ✓ | DB username (default: `postgres`) |
+| `DB_PASSWORD` | ✓ | DB password |
+| `DATABASE_NAME` | ✓ | Database name |
+| `PROJECT_NAME` | ✓ | Project name (used in Docker, config) |
+| `CONTAINER_NAME` | | Docker container name |
+| `SESSION_SECRET` | | Session encryption key (required in production) |
+| `SESSION_SALT` | | Session salt (16 characters) |
+| `AWS_ACCESS_KEY_ID` | | Required when using S3 |
+| `AWS_SECRET_ACCESS_KEY` | | Required when using S3 |
+| `S3_REGION` | | S3 region (default: `ap-northeast-2`) |
+| `S3_BUCKET` | | S3 bucket name |
 
 ---
 
 ## sonamu.config.ts
 
-위치: `packages/api/src/sonamu.config.ts`
+Location: `packages/api/src/sonamu.config.ts`
 
-### 전체 구조
+### Full Structure
 
 ```typescript
 import path from "node:path";
@@ -79,18 +79,18 @@ const port = 34900;
 
 export default defineConfig({
   projectName: process.env.PROJECT_NAME ?? "MyProject",
-  api: { /* API 설정 */ },
-  i18n: { /* 다국어 설정 */ },
-  sync: { /* 동기화 설정 */ },
-  database: { /* DB 설정 */ },
-  logging: { /* 로깅 설정 (false로 비활성화 가능) */ },
-  test: { /* 테스트 설정 */ },
-  server: { /* 서버 설정 */ },
-  slackConfirm: { /* Production 마이그레이션 Slack 승인 */ },
+  api: { /* API settings */ },
+  i18n: { /* i18n settings */ },
+  sync: { /* sync settings */ },
+  database: { /* DB settings */ },
+  logging: { /* logging settings (disable with false) */ },
+  test: { /* test settings */ },
+  server: { /* server settings */ },
+  slackConfirm: { /* Production migration Slack approval */ },
 });
 ```
 
-### 주요 섹션별 설정
+### Key Section Settings
 
 #### projectName
 
@@ -102,10 +102,10 @@ projectName: process.env.PROJECT_NAME ?? "MyProject",
 
 ```typescript
 api: {
-  dir: "api",              // API 디렉토리명
-  timezone: "Asia/Seoul",  // 타임존
+  dir: "api",              // API directory name
+  timezone: "Asia/Seoul",  // timezone
   route: {
-    prefix: "/api",        // API 라우트 prefix
+    prefix: "/api",        // API route prefix
   },
 },
 ```
@@ -119,13 +119,13 @@ i18n: {
 },
 ```
 
-자세한 내용은 `i18n.md` 참조.
+See `i18n.md` for details.
 
 #### sync
 
 ```typescript
 sync: {
-  targets: ["web"],  // 타입 동기화 대상 패키지
+  targets: ["web"],  // target packages for type sync
 },
 ```
 
@@ -146,65 +146,65 @@ database: {
 },
 ```
 
-자세한 내용은 `database.md` 참조.
+See `database.md` for details.
 
 #### test
 
 ```typescript
 test: {
-  parallel: true,   // 병렬 테스트 활성화
-  maxWorkers: 4,    // Worker 수
-  devRunner: {      // Dev 서버 내 Vitest 상주 인스턴스
+  parallel: true,   // enable parallel testing
+  maxWorkers: 4,    // number of workers
+  devRunner: {      // Vitest resident instance inside Dev server
     enabled: true,
     watch: true,
   },
 },
 ```
 
-자세한 내용은 `testing.md`, `testing-devrunner.md` 참조.
+See `testing.md`, `testing-devrunner.md` for details.
 
 #### server
 
 ```typescript
 server: {
   listen: { port: 34900, host: "localhost" },
-  plugins: { /* 플러그인 설정 */ },
+  plugins: { /* plugin settings */ },
   auth: true,
-  apiConfig: { /* API 설정 */ },
-  storage: { /* 스토리지 설정 */ },
-  cache: { /* 캐시 설정 */ },
-  lifecycle: { /* 라이프사이클 훅 */ },
+  apiConfig: { /* API settings */ },
+  storage: { /* storage settings */ },
+  cache: { /* cache settings */ },
+  lifecycle: { /* lifecycle hooks */ },
 },
 ```
 
 ---
 
-## server.auth 상세 (better-auth 인증)
+## server.auth Details (better-auth Authentication)
 
-Sonamu는 **better-auth**를 사용한 인증 시스템을 제공한다.
+Sonamu provides an authentication system using **better-auth**.
 
-### 1. 엔티티 자동 생성
+### 1. Auto-generate Entities
 
 ```bash
 pnpm sonamu auth generate
 ```
 
-생성되는 엔티티:
-- **User** - 사용자 (id, name, email, email_verified, image)
-- **Session** - 세션 (token, expires_at, user_id)
-- **Account** - 계정 (provider_id, access_token 등)
-- **Verification** - 이메일 인증
+Generated entities:
+- **User** - user (id, name, email, email_verified, image)
+- **Session** - session (token, expires_at, user_id)
+- **Account** - account (provider_id, access_token, etc.)
+- **Verification** - email verification
 
-### 2. server.auth 설정
+### 2. server.auth Configuration
 
 ```typescript
 server: {
-  // 기본 설정 (emailAndPassword 활성화)
+  // Basic configuration (emailAndPassword enabled)
   auth: {
     emailAndPassword: { enabled: true },
   },
 
-  // 소셜 로그인 추가
+  // Add social login
   // auth: {
   //   emailAndPassword: { enabled: true },
   //   socialProviders: {
@@ -217,18 +217,18 @@ server: {
 }
 ```
 
-### 3. 인증 API 엔드포인트
+### 3. Authentication API Endpoints
 
-`/api/auth/*` 경로로 자동 등록:
+Automatically registered under the `/api/auth/*` path:
 
-| 엔드포인트 | 메서드 | 설명 |
+| Endpoint | Method | Description |
 |------------|--------|------|
-| `/api/auth/sign-up/email` | POST | 회원가입 |
-| `/api/auth/sign-in/email` | POST | 로그인 |
-| `/api/auth/sign-out` | POST | 로그아웃 |
-| `/api/auth/get-session` | GET | 세션 조회 |
+| `/api/auth/sign-up/email` | POST | Sign up |
+| `/api/auth/sign-in/email` | POST | Sign in |
+| `/api/auth/sign-out` | POST | Sign out |
+| `/api/auth/get-session` | GET | Get session |
 
-### 4. Context에서 user/session 접근
+### 4. Accessing user/session from Context
 
 ```typescript
 @api({ httpMethod: "GET", guards: ["user"] })
@@ -239,9 +239,9 @@ async me(): Promise<UserSubsetA | null> {
 }
 ```
 
-### 5. 필드 매핑 (camelCase → snake_case)
+### 5. Field Mapping (camelCase → snake_case)
 
-better-auth는 camelCase, Sonamu는 snake_case 사용. 자동 매핑 적용:
+better-auth uses camelCase, Sonamu uses snake_case. Automatic mapping is applied:
 
 | better-auth | Sonamu |
 |-------------|--------|
@@ -252,22 +252,22 @@ better-auth는 camelCase, Sonamu는 snake_case 사용. 자동 매핑 적용:
 
 ---
 
-## Guards 시스템 (권한 제어)
+## Guards System (Access Control)
 
-Sonamu 권한 시스템은 2가지 요소로 구성:
+The Sonamu permission system consists of 2 components:
 
-1. **GuardKeys** - 권한 키 정의
-2. **guardHandler** - 권한 검사 로직
+1. **GuardKeys** - permission key definitions
+2. **guardHandler** - permission check logic
 
-### 1. GuardKeys 확장 (커스텀 권한)
+### 1. Extending GuardKeys (Custom Permissions)
 
-**소스코드:** `modules/sonamu/src/api/decorators.ts` (GuardKeys 인터페이스)
+**Source code:** `modules/sonamu/src/api/decorators.ts` (GuardKeys interface)
 
-기본 제공: `query`, `admin`, `user`
+Provided by default: `query`, `admin`, `user`
 
-커스텀 권한 추가 시 `src/typings/sonamu.d.ts`에서 확장:
+To add custom permissions, extend in `src/typings/sonamu.d.ts`:
 
-**파일 위치:** `src/typings/sonamu.d.ts`
+**File location:** `src/typings/sonamu.d.ts`
 
 ```typescript
 import {} from "sonamu";
@@ -277,13 +277,13 @@ declare module "sonamu" {
     query: true;
     admin: true;
     user: true;
-    manager: true;      // 추가
-    superadmin: true;   // 추가
+    manager: true;      // added
+    superadmin: true;   // added
   }
 }
 ```
 
-### 2. @api 데코레이터에서 guards 사용
+### 2. Using guards in the @api Decorator
 
 ```typescript
 // user.model.ts
@@ -292,22 +292,22 @@ import { api } from "sonamu";
 class UserModelClass extends BaseModelClass {
   @api({ httpMethod: "GET", guards: ["user"] })
   async me(): Promise<UserSubsetA | null> {
-    // 로그인한 사용자만 접근
+    // only logged-in users can access
   }
 
   @api({ httpMethod: "DELETE", guards: ["admin"] })
   async del(ids: number[]): Promise<number> {
-    // 관리자만 접근
+    // only admins can access
   }
 
   @api({ httpMethod: "GET", guards: ["admin", "manager"] })
   async adminList(): Promise<UserSubsetA[]> {
-    // admin 또는 manager 권한
+    // admin or manager permission
   }
 }
 ```
 
-### 3. guardHandler 구현
+### 3. Implementing guardHandler
 
 ```typescript
 import { Sonamu } from "sonamu";
@@ -315,44 +315,44 @@ import { Sonamu } from "sonamu";
 // sonamu.config.ts
 apiConfig: {
   guardHandler: (guard, request, api) => {
-    // better-auth Context에서 user 접근
+    // Access user from better-auth Context
     const { user } = Sonamu.getContext();
 
     switch (guard) {
       case "user":
-        // 로그인 필수
+        // login required
         if (!user) {
-          throw new Error("로그인이 필요합니다");
+          throw new Error("Login is required");
         }
         break;
 
       case "admin":
-        // 관리자 권한 (User 엔티티에 role 필드 추가 필요)
+        // admin permission (requires adding role field to User entity)
         if (!user || (user as any).role !== "admin") {
-          throw new Error("관리자만 접근 가능합니다");
+          throw new Error("Only admins can access");
         }
         break;
 
       case "manager":
-        // 매니저 권한 (커스텀 Guard 예시)
-        if (!user || ![“admin”, “manager”].includes((user as any).role)) {
-          throw new Error("매니저 권한이 필요합니다");
+        // manager permission (custom Guard example)
+        if (!user || !["admin", "manager"].includes((user as any).role)) {
+          throw new Error("Manager permission is required");
         }
         break;
 
       case "query":
-        // 모든 사용자 허용 (비로그인 포함)
+        // allow all users (including unauthenticated)
         break;
     }
   },
 },
 ```
 
-**NOTE:** better-auth의 기본 User 엔티티는 `role` 필드가 없다. 권한 기반 인증이 필요하면 User 엔티티에 `role` 필드를 추가하거나, 별도 Role 엔티티를 만들어야 한다.
+**NOTE:** better-auth's default User entity does not have a `role` field. If role-based authentication is needed, add a `role` field to the User entity or create a separate Role entity.
 
-### 권한별 메뉴/화면 접근 제어
+### Menu/Screen Access Control by Permission
 
-권한별 UI 접근 제어는 **프론트엔드에서** 처리한다:
+UI access control by permission is handled **on the frontend**:
 
 ```typescript
 // web/src/lib/auth.ts
@@ -371,34 +371,34 @@ export function canAccess(userRole: string, menu: keyof typeof menuPermissions)
 ```tsx
 // web/src/components/Sidebar.tsx
 {canAccess(user.role, "userManagement") && (
-  <MenuItem href="/admin/users">사용자 관리</MenuItem>
+  <MenuItem href="/admin/users">User Management</MenuItem>
 )}
 ```
 
 ---
 
-## server.plugins 상세
+## server.plugins Details
 
-### session (세션 관리)
+### session (Session Management)
 
 ```typescript
 session: {
   secret: process.env.SESSION_SECRET || "change-this-in-production",
   salt: process.env.SESSION_SALT || "mq9hDxBCDbsQDR6N",
   cookie: {
-    domain: "localhost",  // 프로덕션에서 실제 도메인으로 변경
+    domain: "localhost",  // change to actual domain in production
     path: "/",
-    maxAge: 60 * 60 * 24 * 365 * 10,  // 10년
+    maxAge: 60 * 60 * 24 * 365 * 10,  // 10 years
   },
 },
 ```
 
-**프로덕션 체크리스트:**
-- `SESSION_SECRET`: 반드시 강력한 무작위 문자열로 변경
-- `SESSION_SALT`: 16자 무작위 문자열로 변경
-- `cookie.domain`: 실제 도메인으로 변경
+**Production checklist:**
+- `SESSION_SECRET`: must be changed to a strong random string
+- `SESSION_SALT`: change to a 16-character random string
+- `cookie.domain`: change to the actual domain
 
-### static (정적 파일)
+### static (Static Files)
 
 ```typescript
 static: {
@@ -407,7 +407,7 @@ static: {
 },
 ```
 
-### multipart (파일 업로드)
+### multipart (File Upload)
 
 ```typescript
 multipart: {
@@ -419,9 +419,9 @@ multipart: {
 
 ---
 
-## server.storage 상세
+## server.storage Details
 
-### 로컬 파일 시스템
+### Local File System
 
 ```typescript
 storage: {
@@ -462,9 +462,9 @@ storage: {
 
 ---
 
-## server.cache 상세
+## server.cache Details
 
-Sonamu는 **BentoCache**를 사용한다.
+Sonamu uses **BentoCache**.
 
 ```typescript
 import { drivers as cacheDrivers, store } from "sonamu/cache";
@@ -479,21 +479,21 @@ cache: {
 },
 ```
 
-**사용 가능한 드라이버:**
-- `memory` - 메모리 캐시 (기본)
-- `file` - 파일 기반 캐시
-- `redis` - Redis 캐시
-- `knex` - DB 기반 캐시
+**Available drivers:**
+- `memory` - in-memory cache (default)
+- `file` - file-based cache
+- `redis` - Redis cache
+- `knex` - DB-based cache
 
-다른 드라이버 사용 시 [BentoCache 문서](https://bentocache.dev/) 참조.
+For other drivers, refer to the [BentoCache documentation](https://bentocache.dev/).
 
 ---
 
-## server.apiConfig 상세
+## server.apiConfig Details
 
 ### contextProvider
 
-요청마다 Context에 추가 정보 주입:
+Inject additional information into Context per request:
 
 ```typescript
 contextProvider: (defaultContext, request) => {
@@ -502,34 +502,34 @@ contextProvider: (defaultContext, request) => {
     ip: request.ip,
     session: request.session,
     body: request.body,
-    // 커스텀 필드 추가 가능
+    // custom fields can be added
   };
 },
 ```
 
 ### guardHandler
 
-API 가드 처리:
+Handle API guard processing:
 
 ```typescript
 guardHandler: (guard, request, api) => {
-  // guard 값에 따라 접근 제어
+  // access control based on guard value
   if (guard === "admin" && request.user?.role !== "admin") {
-    throw new Error("관리자만 접근 가능합니다");
+    throw new Error("Only admins can access");
   }
 },
 ```
 
 ### cacheControlHandler
 
-HTTP 캐시 헤더 설정:
+Set HTTP cache headers:
 
 ```typescript
 cacheControlHandler: (req) => {
   switch (req.type) {
     case "assets":
       if (req.path.match(/-[a-f0-9]+\./)) {
-        return CachePresets.immutable;  // 해시 포함 파일
+        return CachePresets.immutable;  // files with hash
       }
       return CachePresets.longLived;
 
@@ -550,7 +550,7 @@ cacheControlHandler: (req) => {
 
 ---
 
-## server.lifecycle 상세
+## server.lifecycle Details
 
 ```typescript
 lifecycle: {
@@ -559,7 +559,7 @@ lifecycle: {
   },
   onShutdown: () => {
     console.log("graceful shutdown");
-    // DB 연결 종료, 리소스 정리 등
+    // close DB connections, clean up resources, etc.
   },
   onError: (error, request, reply) => {
     console.error(error);
@@ -573,78 +573,78 @@ lifecycle: {
 
 ---
 
-## Sonamu 로컬 개발 환경 설정
+## Sonamu Local Development Environment Setup
 
-**언제 필요한가:**
-- Sonamu 프레임워크 소스코드를 수정하며 개발하는 경우
-- 로컬의 Sonamu 저장소와 프로젝트를 연동하여 작업하는 경우
+**When is this needed:**
+- When modifying the Sonamu framework source code during development
+- When linking a local Sonamu repository to a project for development
 
-**문제 상황:**
+**Problem:**
 
-pnpm link로 Sonamu를 연결하면 빌드 시 타입 에러 발생:
+When linking Sonamu with pnpm link, type errors occur at build time:
 
 ```
 error TS2345: Argument of type 'ZodNumber' is not assignable to parameter...
   Type '2' is not assignable to type '3'.
 ```
 
-**원인:**
+**Cause:**
 
-- 링크된 Sonamu와 프로젝트가 각자의 `node_modules`를 유지
-- 공통 의존성(zod 등)의 버전이 달라서 TypeScript 타입 불일치 발생
-- TypeScript가 두 개의 다른 타입 정의를 동시에 참조하여 에러 발생
+- The linked Sonamu and the project each maintain their own `node_modules`
+- TypeScript type mismatches occur due to different versions of shared dependencies (e.g. zod)
+- TypeScript simultaneously references two different type definitions, causing errors
 
-**해결 방법:**
+**Solution:**
 
-### 1. pnpm-workspace.yaml에 override 추가
+### 1. Add override to pnpm-workspace.yaml
 
-프로젝트 루트의 `pnpm-workspace.yaml`:
+In the project root's `pnpm-workspace.yaml`:
 
 ```yaml
 overrides:
   sonamu: link:../../sonamu/modules/sonamu
 ```
 
-### 2. packages/api/package.json에 배포 버전 명시
+### 2. Specify published version in packages/api/package.json
 
 ```json
 {
   "dependencies": {
-    "sonamu": "^0.7.45"  // 최신 배포 버전으로 명시
+    "sonamu": "^0.7.45"  // specify the latest published version
   }
 }
 ```
 
-### 3. 설치 실행
+### 3. Run install
 
 ```bash
 pnpm install
 ```
 
-### 4. 빌드 확인
+### 4. Verify build
 
 ```bash
 cd packages/api
 pnpm build
 ```
 
-**작동 원리:**
+**How it works:**
 
-- **TypeScript 타입 체크**: `package.json`의 배포 버전을 보고 npm registry의 타입 정의 참조
-- **실제 런타임**: `pnpm overrides`의 로컬 링크가 우선순위를 가져 로컬 소스코드 실행
-- 타입 체크와 런타임을 분리하여 버전 불일치 문제 해결
+- **TypeScript type check**: references type definitions from the npm registry based on the published version in `package.json`
+- **Actual runtime**: `pnpm overrides` local link takes priority and runs local source code
+- Separates type checking and runtime to resolve version mismatch issues
 
-**주의사항:**
+**Notes:**
 
-- Sonamu 소스코드를 수정한 후 프로젝트에서 즉시 반영됨
-- Sonamu 빌드 후 프로젝트 재시작 필요
-- 일반 프로젝트 개발 시에는 npm 버전 사용 권장
+- Changes to Sonamu source code are immediately reflected in the project
+- Restarting the project is required after building Sonamu
+- For general project development, using the npm version is recommended
 
 ---
 
-## 환경별 설정
+## Environment-Specific Configuration
 
-### 개발 환경
+### Development Environment
 
 ```env
 # packages/api/.env
@@ -656,7 +656,7 @@ DATABASE_NAME=myproject
 PROJECT_NAME=myproject
 ```
 
-### 프로덕션 환경
+### Production Environment
 
 ```env
 # packages/api/.env.production
@@ -678,54 +678,54 @@ S3_BUCKET=myproject-prod-bucket
 
 ---
 
-## server 추가 옵션
+## server Additional Options
 
 ### baseUrl
 
 ```typescript
 server: {
-  baseUrl: "https://api.example.com",  // 외부 접근 URL (기본: host:port)
+  baseUrl: "https://api.example.com",  // external access URL (default: host:port)
 }
 ```
 
 ### fastify
 
-Fastify 서버 옵션을 직접 전달합니다 (`logger` 제외).
+Pass Fastify server options directly (excluding `logger`).
 
-### plugins 전체 목록
+### Full Plugin List
 
-| 플러그인 | 타입 | 설명 |
+| Plugin | Type | Description |
 |----------|------|------|
-| `compress` | `boolean \| FastifyCompressOptions` | 응답 압축 (@fastify/compress) |
-| `cors` | `boolean \| FastifyCorsOptions` | CORS 설정 |
-| `formbody` | `boolean \| FastifyFormbodyOptions` | x-www-form-urlencoded 파싱 |
-| `multipart` | `boolean \| FastifyMultipartOptions` | 파일 업로드 |
-| `qs` | `boolean \| QsPluginOptions` | 쿼리 스트링 파싱 |
-| `session` | 세션 설정 | 세션 관리 |
+| `compress` | `boolean \| FastifyCompressOptions` | Response compression (@fastify/compress) |
+| `cors` | `boolean \| FastifyCorsOptions` | CORS configuration |
+| `formbody` | `boolean \| FastifyFormbodyOptions` | x-www-form-urlencoded parsing |
+| `multipart` | `boolean \| FastifyMultipartOptions` | File upload |
+| `qs` | `boolean \| QsPluginOptions` | Query string parsing |
+| `session` | session config | Session management |
 | `sse` | `boolean \| SsePluginOptions` | Server-Sent Events |
-| `static` | `boolean \| FastifyStaticOptions` | 정적 파일 서빙 |
-| `custom` | `(server: FastifyInstance) => void` | 커스텀 플러그인 등록 함수 |
+| `static` | `boolean \| FastifyStaticOptions` | Static file serving |
+| `custom` | `(server: FastifyInstance) => void` | Custom plugin registration function |
 
 ## logging
 
-로깅 설정을 정의합니다. `false`로 설정하면 로깅을 완전히 비활성화합니다.
+Define logging configuration. Set to `false` to completely disable logging.
 
 ```typescript
-logging: false,  // 로깅 비활성화
-// 또는
+logging: false,  // disable logging
+// or
 logging: {
-  sinks: { /* 로그 출력 대상 정의 */ },
-  filters: { /* 필터 정의 */ },
+  sinks: { /* define log output targets */ },
+  filters: { /* define filters */ },
 },
 ```
 
 ## slackConfirm
 
-Production DB 마이그레이션 시 Slack을 통한 승인 프로세스를 활성화합니다.
+Activates a Slack-based approval process for production DB migrations.
 
 ```typescript
 slackConfirm: {
-  targets: ["production"],       // 승인이 필요한 DB 키 목록
+  targets: ["production"],       // list of DB keys requiring approval
   botToken: process.env.SLACK_BOT_TOKEN ?? "",  // Slack Bot Token (xoxb-...)
   channelId: process.env.SLACK_CHANNEL_ID ?? "", // Slack Channel ID (C...)
 },
@@ -733,17 +733,17 @@ slackConfirm: {
 
 ---
 
-## 설정 후 체크리스트
+## Post-Configuration Checklist
 
-1. `.env` 파일 생성 확인
-2. Docker 실행: `pnpm docker:up`
-3. 빌드 확인: `pnpm build`
-4. 서버 실행: `pnpm dev`
-5. Sonamu UI 접속: http://localhost:34900/sonamu-ui
+1. Confirm `.env` file is created
+2. Start Docker: `pnpm docker:up`
+3. Verify build: `pnpm build`
+4. Start server: `pnpm dev`
+5. Access Sonamu UI: http://localhost:34900/sonamu-ui
 
-프로덕션 배포 전:
-- [ ] `SESSION_SECRET` 변경
-- [ ] `SESSION_SALT` 변경
-- [ ] `cookie.domain` 실제 도메인으로 변경
-- [ ] S3 설정 (필요시)
-- [ ] 에러 핸들링 로직 추가
+Before production deployment:
+- [ ] Change `SESSION_SECRET`
+- [ ] Change `SESSION_SALT`
+- [ ] Change `cookie.domain` to the actual domain
+- [ ] Configure S3 (if needed)
+- [ ] Add error handling logic