# 🌲 Sonamu

## Docs

- [Agent 설정](https://sonamu.cartanova.ai/ko/advanced-features/ai-agents/agent-configuration.md): AI 에이전트 기본 설정하기
- [Agent 생성하기](https://sonamu.cartanova.ai/ko/advanced-features/ai-agents/creating-agents.md): BaseAgentClass로 커스텀 AI 에이전트 구축하기
- [AI SDK 사용하기](https://sonamu.cartanova.ai/ko/advanced-features/ai-agents/using-ai-sdk.md): Vercel AI SDK와 커스텀 프로바이더 활용하기
- [Cache Presets](https://sonamu.cartanova.ai/ko/advanced-features/cache-control/cache-presets.md): 사전 정의된 캐시 설정 활용하기
- [API에서 사용하기](https://sonamu.cartanova.ai/ko/advanced-features/cache-control/using-in-apis.md): @api 데코레이터에 Cache-Control 적용하기
- [SSR에서 사용하기](https://sonamu.cartanova.ai/ko/advanced-features/cache-control/using-in-ssr.md): SSR 페이지에 Cache-Control 적용하기
- [Cache-Control이란?](https://sonamu.cartanova.ai/ko/advanced-features/cache-control/what-is-cache-control.md): HTTP 캐싱의 기본 개념 이해하기
- [캐시 설정](https://sonamu.cartanova.ai/ko/advanced-features/caching/cache-configuration.md): BentoCache stores와 drivers 설정하기
- [@cache 데코레이터](https://sonamu.cartanova.ai/ko/advanced-features/caching/cache-decorator.md): 메서드에 캐시 적용하기
- [캐시 무효화](https://sonamu.cartanova.ai/ko/advanced-features/caching/cache-invalidation.md): Tag 기반 캐시 무효화 및 관리
- [캐시 전략](https://sonamu.cartanova.ai/ko/advanced-features/caching/cache-strategies.md): TTL, Grace, Namespace 활용 전략
- [압축 설정](https://sonamu.cartanova.ai/ko/advanced-features/compress/compress-configuration.md): 전역 압축 플러그인 설정하기
- [압축 프리셋](https://sonamu.cartanova.ai/ko/advanced-features/compress/compress-presets.md): 사전 정의된 압축 설정 활용하기
- [API별 압축 제어](https://sonamu.cartanova.ai/ko/advanced-features/compress/per-api-control.md): @api 데코레이터로 엔드포인트별 압축 설정하기
- [성능 최적화](https://sonamu.cartanova.ai/ko/advanced-features/compress/performance-optimization.md): 압축을 통한 성능 최적화 전략
- [SD 함수와 딕셔너리](https://sonamu.cartanova.ai/ko/advanced-features/i18n/dictionary.md): 타입 안전한 번역 함수 사용법
- [Entity 라벨 자동 추출](https://sonamu.cartanova.ai/ko/advanced-features/i18n/entity-labels.md): Entity 정의에서 자동으로 추출되는 i18n 라벨
- [Excel Import/Export](https://sonamu.cartanova.ai/ko/advanced-features/i18n/excel-import.md): Sonamu UI에서 번역 파일 일괄 관리하기
- [헬퍼 함수](https://sonamu.cartanova.ai/ko/advanced-features/i18n/helpers.md): josa, plural, format 등 i18n 유틸리티
- [다국어 DB 컬럼](https://sonamu.cartanova.ai/ko/advanced-features/i18n/localized-columns.md): name_ko, name_en 또는 locale map 형태의 다국어 컬럼 처리
- [i18n 개요](https://sonamu.cartanova.ai/ko/advanced-features/i18n/overview.md): Sonamu의 다국어 지원 시스템 아키텍처
- [i18n 설정](https://sonamu.cartanova.ai/ko/advanced-features/i18n/setup.md): Sonamu 프로젝트에서 다국어 지원 활성화하기
- [클라이언트 통합](https://sonamu.cartanova.ai/ko/advanced-features/sse/client-integration.md): 프론트엔드에서 SSE 사용하기
- [SSE 엔드포인트 만들기](https://sonamu.cartanova.ai/ko/advanced-features/sse/creating-sse-endpoints.md): @stream 데코레이터로 SSE API 구축하기
- [SSE 설정](https://sonamu.cartanova.ai/ko/advanced-features/sse/sse-setup.md): Server-Sent Events 플러그인 설정하기
- [파일 저장 및 조회](https://sonamu.cartanova.ai/ko/advanced-features/storage/file-operations.md): 파일 업로드, 다운로드, 조회 가이드
- [스토리지 드라이버](https://sonamu.cartanova.ai/ko/advanced-features/storage/storage-drivers.md): fs, S3 드라이버 설정 가이드
- [Storage Manager](https://sonamu.cartanova.ai/ko/advanced-features/storage/storage-manager.md): 파일 스토리지 시스템 소개
- [URL 빌더](https://sonamu.cartanova.ai/ko/advanced-features/storage/url-builder.md): 파일 URL 생성 및 커스터마이징
- [청킹](https://sonamu.cartanova.ai/ko/advanced-features/vector-search/chunking.md): Sonamu에서 긴 문서를 작은 조각으로 분할하기
- [임베딩](https://sonamu.cartanova.ai/ko/advanced-features/vector-search/embeddings.md): Sonamu에서 Voyage AI, OpenAI로 텍스트 임베딩 생성하기
- [하이브리드 검색](https://sonamu.cartanova.ai/ko/advanced-features/vector-search/hybrid-search.md): Sonamu에서 벡터 검색과 키워드 검색을 결합하여 정확도 향상하기
- [pgvector 설정](https://sonamu.cartanova.ai/ko/advanced-features/vector-search/pgvector-setup.md): PostgreSQL pgvector 확장 설치 및 설정하기
- [벡터 검색](https://sonamu.cartanova.ai/ko/advanced-features/vector-search/vector-search.md): Sonamu Model에서 pgvector 유사도 검색 구현하기
- [에러 처리](https://sonamu.cartanova.ai/ko/advanced-features/workflows/error-handling.md): Workflow 에러 처리 및 재시도 전략
- [Step](https://sonamu.cartanova.ai/ko/advanced-features/workflows/steps.md): Workflow를 Step으로 나누기
- [Worker 설정](https://sonamu.cartanova.ai/ko/advanced-features/workflows/worker-setup.md): Workflow Worker 설정 및 시작하기
- [@workflow 데코레이터](https://sonamu.cartanova.ai/ko/advanced-features/workflows/workflow-decorator.md): Workflow 정의 및 실행하기
- [보호된 라우트](https://sonamu.cartanova.ai/ko/api-development/authentication/protected-routes.md): Guards로 API 권한 제어하기
- [세션 관리](https://sonamu.cartanova.ai/ko/api-development/authentication/session-management.md): 세션과 토큰의 생명주기 관리
- [인증 설정하기](https://sonamu.cartanova.ai/ko/api-development/authentication/setup.md): Sonamu에서 better-auth 기반 인증 시스템 구축하기
- [커스텀 Context](https://sonamu.cartanova.ai/ko/api-development/context/custom-context.md): 프로젝트에 맞게 Context 확장하기
- [Context 가져오기](https://sonamu.cartanova.ai/ko/api-development/context/getting-context.md): Sonamu.getContext()로 요청 컨텍스트 접근하기
- [SonamuContext](https://sonamu.cartanova.ai/ko/api-development/context/sonamu-context.md): 요청 컨텍스트 정보: request, reply, user
- [@api 데코레이터](https://sonamu.cartanova.ai/ko/api-development/creating-apis/api-decorator.md): 메서드를 API 엔드포인트로 변환하기
- [HTTP 메서드](https://sonamu.cartanova.ai/ko/api-development/creating-apis/http-methods.md): GET, POST, PUT, DELETE 상세 가이드
- [파라미터](https://sonamu.cartanova.ai/ko/api-development/creating-apis/parameters.md): API 파라미터 타입 정의 및 검증
- [반환 타입](https://sonamu.cartanova.ai/ko/api-development/creating-apis/return-types.md): API 응답 타입 정의하기
- [파일 저장](https://sonamu.cartanova.ai/ko/api-development/file-upload/saving-files.md): Storage Manager와 다양한 스토리지 드라이버
- [파일 업로드 설정](https://sonamu.cartanova.ai/ko/api-development/file-upload/setup.md): @upload 데코레이터와 Storage 설정
- [BufferedFile 클래스](https://sonamu.cartanova.ai/ko/api-development/file-upload/uploaded-file-class.md): 파일 정보 접근과 saveToDisk() 메서드
- [URL 생성](https://sonamu.cartanova.ai/ko/api-development/file-upload/url-generation.md): Public URL과 Signed URL
- [Frame 생성하기](https://sonamu.cartanova.ai/ko/api-development/frames/creating-frames.md): BaseFrameClass로 독립적인 API 만들기
- [사용 사례](https://sonamu.cartanova.ai/ko/api-development/frames/use-cases.md): Frame의 다양한 활용 예제
- [Frame이란?](https://sonamu.cartanova.ai/ko/api-development/frames/what-are-frames.md): Entity 없이 독립적인 API를 만드는 방법
- [자동 검증](https://sonamu.cartanova.ai/ko/api-development/validation/automatic-validation.md): Zod를 활용한 타입 안전 파라미터 검증
- [커스텀 검증](https://sonamu.cartanova.ai/ko/api-development/validation/custom-validation.md): 프로젝트별 검증 로직 구현하기
- [에러 처리](https://sonamu.cartanova.ai/ko/api-development/validation/error-handling.md): SoException 기반의 일관된 에러 응답
- [del](https://sonamu.cartanova.ai/ko/api-reference/base-model/del.md): 레코드 삭제
- [findById](https://sonamu.cartanova.ai/ko/api-reference/base-model/find-by-id.md): ID로 단일 레코드 조회
- [findMany](https://sonamu.cartanova.ai/ko/api-reference/base-model/find-many.md): 리스트 조회 및 페이지네이션
- [getPuri](https://sonamu.cartanova.ai/ko/api-reference/base-model/get-puri.md): Puri 쿼리 빌더 가져오기
- [save](https://sonamu.cartanova.ai/ko/api-reference/base-model/save.md): 레코드 저장 및 수정
- [sonamuFilter](https://sonamu.cartanova.ai/ko/api-reference/base-model/sonamu-filter.md): 타입 안전한 엔티티 필터링
- [AuthContext](https://sonamu.cartanova.ai/ko/api-reference/context/auth-context.md): Sonamu 인증 컨텍스트 레퍼런스
- [Context 메서드](https://sonamu.cartanova.ai/ko/api-reference/context/methods.md): Context 접근 메서드 레퍼런스
- [Context](https://sonamu.cartanova.ai/ko/api-reference/context/sonamu-context.md): Sonamu API 요청 컨텍스트 레퍼런스
- [@api](https://sonamu.cartanova.ai/ko/api-reference/decorators/api.md): API 엔드포인트 생성 데코레이터
- [@cache](https://sonamu.cartanova.ai/ko/api-reference/decorators/cache.md): 메서드 결과 캐싱 데코레이터
- [@stream](https://sonamu.cartanova.ai/ko/api-reference/decorators/stream.md): SSE 스트리밍 API 생성 데코레이터
- [@transactional](https://sonamu.cartanova.ai/ko/api-reference/decorators/transactional.md): 데이터베이스 트랜잭션 관리 데코레이터
- [@upload](https://sonamu.cartanova.ai/ko/api-reference/decorators/upload.md): 파일 업로드 API 생성 데코레이터
- [@websocket](https://sonamu.cartanova.ai/ko/api-reference/decorators/websocket.md): 양방향 WebSocket 채널 API 생성 데코레이터
- [@workflow](https://sonamu.cartanova.ai/ko/api-reference/decorators/workflow.md): 워크플로우 정의 데코레이터
- [BadRequestException](https://sonamu.cartanova.ai/ko/api-reference/exceptions/bad-request-error.md): 잘못된 요청 처리를 위한 400 예외
- [커스텀 예외](https://sonamu.cartanova.ai/ko/api-reference/exceptions/custom-errors.md): 프로젝트에 맞는 커스텀 예외 클래스 만들기
- [SoException](https://sonamu.cartanova.ai/ko/api-reference/exceptions/sonamu-error.md): Sonamu 예외 처리 시스템 기본 클래스
- [UnauthorizedException](https://sonamu.cartanova.ai/ko/api-reference/exceptions/unauthorized-error.md): 인증 및 권한 처리를 위한 401 예외
- [Advanced Methods](https://sonamu.cartanova.ai/ko/api-reference/puri-methods/advanced-methods.md): 고급 쿼리 메서드
- [join](https://sonamu.cartanova.ai/ko/api-reference/puri-methods/join.md): 테이블 조인하기
- [limit & offset](https://sonamu.cartanova.ai/ko/api-reference/puri-methods/limit.md): 페이지네이션과 결과 제한
- [orderBy](https://sonamu.cartanova.ai/ko/api-reference/puri-methods/order-by.md): 결과 정렬하기
- [select](https://sonamu.cartanova.ai/ko/api-reference/puri-methods/select.md): SELECT 절로 조회할 필드 지정
- [where](https://sonamu.cartanova.ai/ko/api-reference/puri-methods/where.md): WHERE 절로 조건 필터링
- [API 키 관리](https://sonamu.cartanova.ai/ko/configuration/environment-variables/api-keys.md): 외부 서비스 API 키 안전하게 설정하기
- [데이터베이스 인증 정보](https://sonamu.cartanova.ai/ko/configuration/environment-variables/database-credentials.md): PostgreSQL 연결 정보 안전하게 설정하기
- [.env 설정](https://sonamu.cartanova.ai/ko/configuration/environment-variables/env-setup.md): 환경 변수 파일 생성 및 관리
- [카테고리 로깅](https://sonamu.cartanova.ai/ko/configuration/logging/category-logging.md): 로그 카테고리 시스템과 계층 구조
- [Fastify 로깅](https://sonamu.cartanova.ai/ko/configuration/logging/fastify-logging.md): HTTP 요청/응답 로깅 커스터마이징
- [LogTape 설정](https://sonamu.cartanova.ai/ko/configuration/logging/logtape-setup.md): sonamu.config.ts의 logging 옵션
- [Sinks & Filters](https://sonamu.cartanova.ai/ko/configuration/logging/sinks-and-filters.md): 로그 출력 대상과 필터링 설정
- [인증](https://sonamu.cartanova.ai/ko/configuration/sonamu-config/auth.md): better-auth 기반 인증 설정
- [캐시 (BentoCache)](https://sonamu.cartanova.ai/ko/configuration/sonamu-config/cache.md): BentoCache 기반 캐싱 설정
- [Cache-Control](https://sonamu.cartanova.ai/ko/configuration/sonamu-config/cache-control.md): HTTP Cache-Control 헤더 설정
- [압축](https://sonamu.cartanova.ai/ko/configuration/sonamu-config/compress.md): HTTP 응답 압축 설정
- [데이터베이스](https://sonamu.cartanova.ai/ko/configuration/sonamu-config/database.md): PostgreSQL 연결 및 환경별 설정
- [프로젝트 설정](https://sonamu.cartanova.ai/ko/configuration/sonamu-config/project-settings.md): projectName, api, i18n 설정하기
- [서버](https://sonamu.cartanova.ai/ko/configuration/sonamu-config/server.md): Fastify 서버 기본 설정 및 플러그인
- [스토리지](https://sonamu.cartanova.ai/ko/configuration/sonamu-config/storage.md): 파일 저장소 드라이버 설정
- [동기화 대상](https://sonamu.cartanova.ai/ko/configuration/sonamu-config/sync-targets.md): 프론트엔드와 타입/Service 동기화 설정
- [Task](https://sonamu.cartanova.ai/ko/configuration/sonamu-config/tasks.md): Workflow 및 백그라운드 작업 설정
- [Path Mapping](https://sonamu.cartanova.ai/ko/configuration/typescript/path-mappings.md): 모듈 경로 별칭 설정하기
- [tsconfig.json](https://sonamu.cartanova.ai/ko/configuration/typescript/tsconfig.md): TypeScript 설정하기
- [타입 체크](https://sonamu.cartanova.ai/ko/configuration/typescript/type-checking.md): 컴파일러 옵션 설정하기
- [생성된 코드 커스터마이징](https://sonamu.cartanova.ai/ko/core-concepts/auto-generation/customizing-generated-code.md): 자동 생성된 파일을 수정하지 않고 안전하게 커스터마이징하는 방법
- [Syncer](https://sonamu.cartanova.ai/ko/core-concepts/auto-generation/syncer.md): 파일 변경을 감지하고 자동으로 코드를 생성하는 Sonamu의 핵심 시스템
- [자동 생성되는 파일](https://sonamu.cartanova.ai/ko/core-concepts/auto-generation/what-gets-generated.md): Sonamu가 Entity 정의로부터 자동 생성하는 모든 파일 목록
- [파일 재생성 시점](https://sonamu.cartanova.ai/ko/core-concepts/auto-generation/when-files-regenerate.md): 어떤 파일을 변경하면 어떤 파일이 재생성되는지 완벽 가이드
- [Entity 정의하기](https://sonamu.cartanova.ai/ko/core-concepts/entity/defining-entities.md): entity.json 구조와 Entity 정의 방법
- [Enums](https://sonamu.cartanova.ai/ko/core-concepts/entity/enums.md): Enum 타입 정의하고 활용하기
- [Field Types](https://sonamu.cartanova.ai/ko/core-concepts/entity/field-types.md): Entity에서 사용 가능한 모든 필드 타입과 옵션
- [Relations](https://sonamu.cartanova.ai/ko/core-concepts/entity/relations.md): Entity 간 관계 정의하고 활용하기
- [Sonamu UI 사용하기](https://sonamu.cartanova.ai/ko/core-concepts/entity/using-sonamu-ui.md): Sonamu UI의 모든 기능과 효율적인 사용법
- [Sonamu 동작 원리](https://sonamu.cartanova.ai/ko/core-concepts/how-sonamu-works.md): Sonamu의 전체 아키텍처와 핵심 메커니즘 이해하기
- [@api Decorator](https://sonamu.cartanova.ai/ko/core-concepts/model/api-decorator.md): HTTP API 엔드포인트를 자동 생성하는 @api 데코레이터 활용법
- [BaseModel Methods](https://sonamu.cartanova.ai/ko/core-concepts/model/basemodel-methods.md): BaseModelClass가 제공하는 모든 메서드와 사용법
- [Business Logic](https://sonamu.cartanova.ai/ko/core-concepts/model/business-logic.md): Model에서 비즈니스 로직을 작성하는 패턴과 예제
- [Model 생성하기](https://sonamu.cartanova.ai/ko/core-concepts/model/creating-models.md): Sonamu Model 파일 생성과 Scaffold 사용 방법
- [Model이란?](https://sonamu.cartanova.ai/ko/core-concepts/model/what-is-model.md): Sonamu Model의 역할과 구조 이해하기
- [E2E Type Safety](https://sonamu.cartanova.ai/ko/core-concepts/type-system/e2e-type-safety.md): 클라이언트부터 서버, 데이터베이스까지 완벽한 타입 안전성
- [Entity Types](https://sonamu.cartanova.ai/ko/core-concepts/type-system/entity-types.md): Entity 정의로부터 자동 생성되는 TypeScript 타입 시스템
- [Generated Types](https://sonamu.cartanova.ai/ko/core-concepts/type-system/generated-types.md): Sonamu가 자동 생성하는 타입들의 종류와 활용법
- [Zod Validation](https://sonamu.cartanova.ai/ko/core-concepts/type-system/zod-validation.md): Zod를 활용한 런타임 데이터 검증 가이드
- [마이그레이션 생성하기](https://sonamu.cartanova.ai/ko/database/migrations/creating-migrations.md): Sonamu UI에서 자동으로 생성하기
- [마이그레이션 동작 원리](https://sonamu.cartanova.ai/ko/database/migrations/how-migrations-work.md): Sonamu의 자동 마이그레이션 시스템 이해하기
- [마이그레이션 전략](https://sonamu.cartanova.ai/ko/database/migrations/migration-strategies.md): 안전하고 효율적인 스키마 변경 방법
- [프로덕션 승인](https://sonamu.cartanova.ai/ko/database/migrations/production-approval.md): Slack을 통한 프로덕션 마이그레이션 승인 프로세스
- [롤백하기](https://sonamu.cartanova.ai/ko/database/migrations/rolling-back.md): migrate rollback으로 변경 사항 되돌리기
- [마이그레이션 실행하기](https://sonamu.cartanova.ai/ko/database/migrations/running-migrations.md): pnpm sonamu migrate로 데이터베이스 적용하기
- [고급 패턴](https://sonamu.cartanova.ai/ko/database/puri/advanced-patterns.md): 트랜잭션, 서브쿼리, 벡터 검색 등 고급 기능
- [집계 함수](https://sonamu.cartanova.ai/ko/database/puri/aggregations.md): COUNT, SUM, AVG 등 집계 함수 사용하기
- [기본 쿼리](https://sonamu.cartanova.ai/ko/database/puri/basic-queries.md): Puri의 기본적인 CRUD 쿼리 사용법
- [조인](https://sonamu.cartanova.ai/ko/database/puri/joins.md): Puri로 테이블 조인하기
- [Raw Queries](https://sonamu.cartanova.ai/ko/database/puri/raw-queries.md): SQL 표현식과 복잡한 쿼리 작성하기
- [타입 안전성](https://sonamu.cartanova.ai/ko/database/puri/type-safety.md): Puri의 완벽한 타입 안전성 이해하기
- [Subset 정의하기](https://sonamu.cartanova.ai/ko/database/subsets/defining-subsets.md): Entity에서 Subset 생성 및 관리
- [중첩 관계](https://sonamu.cartanova.ai/ko/database/subsets/nested-relations.md): LoaderQuery로 1:N, N:M 관계 데이터 로딩
- [Subset 사용하기](https://sonamu.cartanova.ai/ko/database/subsets/using-subsets.md): Model에서 Subset 활용하기
- [Subset이란?](https://sonamu.cartanova.ai/ko/database/subsets/what-are-subsets.md): 효율적인 데이터 조회를 위한 Subset 시스템
- [모범 사례](https://sonamu.cartanova.ai/ko/database/transactions/best-practices.md): 트랜잭션을 효과적으로 사용하는 방법
- [수동 트랜잭션](https://sonamu.cartanova.ai/ko/database/transactions/manual-transactions.md): getPuri().transaction()으로 직접 트랜잭션 관리하기
- [@transactional 데코레이터](https://sonamu.cartanova.ai/ko/database/transactions/transactional-decorator.md): 메서드를 자동으로 트랜잭션으로 감싸기
- [고급 패턴](https://sonamu.cartanova.ai/ko/database/upsert-builder/advanced-patterns.md): 복잡한 데이터 구조와 특수 케이스 처리하기
- [기본 사용법](https://sonamu.cartanova.ai/ko/database/upsert-builder/basic-usage.md): UpsertBuilder로 데이터 저장하기
- [배치 작업](https://sonamu.cartanova.ai/ko/database/upsert-builder/batch-operations.md): 대량 데이터를 효율적으로 처리하기
- [관계 데이터](https://sonamu.cartanova.ai/ko/database/upsert-builder/relations.md): UBRef로 복잡한 관계 처리하기
- [API 개발](https://sonamu.cartanova.ai/ko/faq/api.md): API 개발과 데코레이터 관련 질문
- [데이터베이스](https://sonamu.cartanova.ai/ko/faq/database.md): 데이터베이스와 쿼리 관련 질문
- [배포](https://sonamu.cartanova.ai/ko/faq/deployment.md): 프로덕션 배포와 운영에 관한 질문
- [Entity와 Model](https://sonamu.cartanova.ai/ko/faq/entity-and-model.md): Entity와 Model 정의에 관한 질문
- [일반 질문](https://sonamu.cartanova.ai/ko/faq/general.md): Sonamu 사용에 관한 일반적인 질문
- [테스팅](https://sonamu.cartanova.ai/ko/faq/testing.md): 테스트 작성과 실행에 관한 질문
- [useListParams](https://sonamu.cartanova.ai/ko/frontend-integration/core-hooks/use-list-params.md): URL 기반 리스트 필터링과 페이지네이션 관리
- [useSelection](https://sonamu.cartanova.ai/ko/frontend-integration/core-hooks/use-selection.md): 테이블 다중 선택 및 벌크 작업 관리
- [Service 동작 원리](https://sonamu.cartanova.ai/ko/frontend-integration/generated-services/how-services-work.md): 자동 생성 클라이언트의 작동 방식
- [TanStack Query Hook](https://sonamu.cartanova.ai/ko/frontend-integration/generated-services/tanstack-query.md): Sonamu Service와 TanStack Query 통합
- [useSSEStream](https://sonamu.cartanova.ai/ko/frontend-integration/generated-services/useSSEStream.md): Server-Sent Events 실시간 스트리밍
- [Service 사용하기](https://sonamu.cartanova.ai/ko/frontend-integration/generated-services/using-services.md): 자동 생성된 Service로 API 호출하기
- [프론트엔드 설정](https://sonamu.cartanova.ai/ko/frontend-integration/getting-started/setup.md): SonamuProvider로 프론트엔드 초기 설정하기
- [자동 생성 컴포넌트 개요](https://sonamu.cartanova.ai/ko/frontend-integration/react-components/auto-generated-overview.md): Entity 정의에서 자동 생성되는 프론트엔드 컴포넌트들
- [커스텀 컴포넌트](https://sonamu.cartanova.ai/ko/frontend-integration/react-components/custom-components.md): Sonamu 컴포넌트 커스터마이징하기
- [ID Async Select](https://sonamu.cartanova.ai/ko/frontend-integration/react-components/id-async-select.md): 관계 데이터를 선택하는 비동기 셀렉트 컴포넌트
- [OrderBySelect](https://sonamu.cartanova.ai/ko/frontend-integration/react-components/order-by-select.md): 정렬 옵션 선택 컴포넌트 사용법
- [View Scaffolding](https://sonamu.cartanova.ai/ko/frontend-integration/react-components/scaffolding-views.md): CRUD 뷰를 자동으로 생성하기
- [검색 컴포넌트](https://sonamu.cartanova.ai/ko/frontend-integration/react-components/search-components.md): SearchFieldSelect + Input으로 동적 검색 구현하기
- [Search Input](https://sonamu.cartanova.ai/ko/frontend-integration/react-components/search-input.md): 검색 자동완성 컴포넌트
- [캐시 제어](https://sonamu.cartanova.ai/ko/frontend-integration/ssr/cache-control.md): TanStack Query 캐싱과 SSR Cache-Control 설정
- [Hydration 전략](https://sonamu.cartanova.ai/ko/frontend-integration/ssr/hydration-strategies.md): TanStack Query Hydration으로 서버 데이터를 클라이언트에 전달
- [데이터 프리로딩](https://sonamu.cartanova.ai/ko/frontend-integration/ssr/preloading-data.md): registerSSR로 서버에서 데이터 미리 로드하기
- [SSR 설정](https://sonamu.cartanova.ai/ko/frontend-integration/ssr/ssr-setup.md): Sonamu의 TanStack Router + Vite SSR 구성
- [API 타입 추론](https://sonamu.cartanova.ai/ko/frontend-integration/type-safety/api-type-inference.md): 백엔드에서 프론트엔드로 완전한 타입 추론
- [컴파일 타임 에러](https://sonamu.cartanova.ai/ko/frontend-integration/type-safety/compile-time-errors.md): API 변경을 즉시 감지하여 런타임 에러 방지
- [공유 타입](https://sonamu.cartanova.ai/ko/frontend-integration/type-safety/shared-types.md): services.generated.ts의 타입 구조
- [개발 워크플로우](https://sonamu.cartanova.ai/ko/getting-started/development-workflow.md): Sonamu의 전체 개발 사이클 이해하기
- [첫 엔티티 만들기](https://sonamu.cartanova.ai/ko/getting-started/first-entity.md): Sonamu UI로 첫 번째 엔티티를 생성하고 API 만들기
- [설치하기](https://sonamu.cartanova.ai/ko/getting-started/installation.md): Sonamu 설치 및 개발 환경 설정
- [Sonamu 소개](https://sonamu.cartanova.ai/ko/getting-started/introduction.md): TypeScript의 강점을 최대한 활용하는 풀스택 프레임워크
- [프로젝트 구조](https://sonamu.cartanova.ai/ko/getting-started/project-structure.md): Sonamu 프로젝트의 디렉토리 구조와 주요 파일
- [빠른 시작](https://sonamu.cartanova.ai/ko/getting-started/quick-start.md): 첫 프로젝트 만들기 - pnpm create sonamu
- [Seamless DX](https://sonamu.cartanova.ai/ko/getting-started/seamless-dx.md): 서버 재시작 없는 개발, 시각적 Entity 관리, 자동 코드 동기화
- [Fixture 생성하기](https://sonamu.cartanova.ai/ko/testing/fixtures/creating-fixtures.md): fixture.ts로 테스트 데이터 정의하기
- [Fixture 로딩하기](https://sonamu.cartanova.ai/ko/testing/fixtures/loading-fixtures.md): 프로덕션 데이터를 Fixture DB로 가져오기
- [Fixture 동기화](https://sonamu.cartanova.ai/ko/testing/fixtures/syncing-fixtures.md): Fixture DB를 Test DB로 복사하기
- [테스트 데이터베이스](https://sonamu.cartanova.ai/ko/testing/fixtures/test-database.md): 격리된 테스트 DB 설정하기
- [API Mocking](https://sonamu.cartanova.ai/ko/testing/mocking/api-mocking.md): 외부 의존성 모킹하기
- [데이터베이스 Mocking](https://sonamu.cartanova.ai/ko/testing/mocking/database-mocking.md): 트랜잭션으로 DB 테스트 격리하기
- [runWithMockContext](https://sonamu.cartanova.ai/ko/testing/mocking/run-with-mock-context.md): Mock Context로 테스트 실행하기
- [테스트 디버깅](https://sonamu.cartanova.ai/ko/testing/naite/debugging-tests.md): 콜스택 추적으로 테스트 디버깅하기
- [Naite Viewer](https://sonamu.cartanova.ai/ko/testing/naite/naite-viewer.md): VSCode Extension으로 테스트 로그 시각화하기
- [로그 조회하기](https://sonamu.cartanova.ai/ko/testing/naite/querying-logs.md): Naite.get()으로 테스트 데이터 쿼리하기
- [로그 기록하기](https://sonamu.cartanova.ai/ko/testing/naite/recording-logs.md): Naite.t()로 테스트 데이터 추적하기
- [Naite란?](https://sonamu.cartanova.ai/ko/testing/naite/what-is-naite.md): 테스트 로깅 및 디버깅 시스템
- [테스트 Scaffolding](https://sonamu.cartanova.ai/ko/testing/writing-tests/scaffolding-tests.md): model.test.ts 자동 생성하기
- [테스트 헬퍼](https://sonamu.cartanova.ai/ko/testing/writing-tests/test-helpers.md): Fixture 시스템과 테스트 유틸리티
- [테스트 구조](https://sonamu.cartanova.ai/ko/testing/writing-tests/test-structure.md): Vitest 기반 Sonamu 테스트 시스템
- [Boundaries](https://sonamu.cartanova.ai/ko/tools-and-cli/hmr/boundaries.md): HMR Boundary 개념과 실전 활용법
- [HMR 동작 원리](https://sonamu.cartanova.ai/ko/tools-and-cli/hmr/how-hmr-works.md): Sonamu의 Hot Module Replacement 시스템이 어떻게 작동하는지 이해하기
- [문제 해결](https://sonamu.cartanova.ai/ko/tools-and-cli/hmr/troubleshooting.md): HMR 관련 문제 해결 가이드
- [build](https://sonamu.cartanova.ai/ko/tools-and-cli/sonamu-cli/build.md): 프로덕션 빌드하기
- [cone](https://sonamu.cartanova.ai/ko/tools-and-cli/sonamu-cli/cone.md): AI를 활용한 cone 메타데이터 생성 및 업그레이드
- [dev](https://sonamu.cartanova.ai/ko/tools-and-cli/sonamu-cli/dev.md): HMR 지원 개발 서버 시작하기
- [fixture](https://sonamu.cartanova.ai/ko/tools-and-cli/sonamu-cli/fixture.md): 테스트 데이터 관리하기
- [migrate](https://sonamu.cartanova.ai/ko/tools-and-cli/sonamu-cli/migrate.md): 데이터베이스 마이그레이션 관리하기
- [scaffold](https://sonamu.cartanova.ai/ko/tools-and-cli/sonamu-cli/scaffold.md): Entity 기반 코드 자동 생성하기
- [stub](https://sonamu.cartanova.ai/ko/tools-and-cli/sonamu-cli/stub.md): 빠른 개발을 위한 코드 스텁 생성하기
- [test](https://sonamu.cartanova.ai/ko/tools-and-cli/sonamu-cli/test.md): dev 서버에서 테스트 실행하기
- [Entity 관리](https://sonamu.cartanova.ai/ko/tools-and-cli/sonamu-ui/entity-management.md): Entity 생성, 수정, 삭제하기
- [시작하기](https://sonamu.cartanova.ai/ko/tools-and-cli/sonamu-ui/getting-started.md): Sonamu UI 실행 및 접속하기
- [Migration 탭](https://sonamu.cartanova.ai/ko/tools-and-cli/sonamu-ui/migration-tab.md): 마이그레이션 생성 및 실행하기
- [Scaffolding 탭](https://sonamu.cartanova.ai/ko/tools-and-cli/sonamu-ui/scaffolding-tab.md): 코드 자동 생성하기
- [Subset 관리](https://sonamu.cartanova.ai/ko/tools-and-cli/sonamu-ui/subset-management.md): Entity Subset 정의 및 관리하기
- [팁과 요령](https://sonamu.cartanova.ai/ko/tools-and-cli/sonamu-ui/tips-and-tricks.md): Sonamu UI를 효율적으로 사용하는 방법
- [주요 기능들](https://sonamu.cartanova.ai/ko/tools-and-cli/vscode-extension/features.md): Sonamu VS Code Extension의 주요 기능
- [설치하기](https://sonamu.cartanova.ai/ko/tools-and-cli/vscode-extension/installation.md): Sonamu VS Code Extension 설치 방법
- [단축키 & 명령어](https://sonamu.cartanova.ai/ko/tools-and-cli/vscode-extension/shortcuts.md): Sonamu Extension의 단축키 및 명령어
- [데이터베이스 연결](https://sonamu.cartanova.ai/ko/troubleshooting/common-errors/database-connection.md): DB 연결 문제 해결하기
- [HMR 문제](https://sonamu.cartanova.ai/ko/troubleshooting/common-errors/hmr-issues.md): HMR 문제 해결하기
- [마이그레이션 오류](https://sonamu.cartanova.ai/ko/troubleshooting/common-errors/migration-errors.md): 마이그레이션 문제 해결하기
- [pnpm Workspace 의존성 문제](https://sonamu.cartanova.ai/ko/troubleshooting/common-errors/pnpm-workspace.md): pnpm workspace 환경에서의 의존성 해결 문제
- [포트가 이미 사용 중](https://sonamu.cartanova.ai/ko/troubleshooting/common-errors/port-in-use.md): 포트 충돌 해결하기
- [타입 오류](https://sonamu.cartanova.ai/ko/troubleshooting/common-errors/type-errors.md): 타입 에러 해결하기
- [콘솔 로깅](https://sonamu.cartanova.ai/ko/troubleshooting/debugging/console-logging.md): 로그로 디버깅하기
- [소스 맵](https://sonamu.cartanova.ai/ko/troubleshooting/debugging/source-maps.md): 소스 맵 사용하기
- [Naite 사용하기](https://sonamu.cartanova.ai/ko/troubleshooting/debugging/using-naite.md): Naite로 디버깅하기
- [Vitest 디버그](https://sonamu.cartanova.ai/ko/troubleshooting/debugging/vitest-debug.md): 테스트 디버깅하기
- [캐싱 전략](https://sonamu.cartanova.ai/ko/troubleshooting/performance/caching-strategies.md): 캐싱으로 성능 개선하기
- [N+1 문제](https://sonamu.cartanova.ai/ko/troubleshooting/performance/n-plus-one-problems.md): N+1 쿼리 문제 해결하기
- [쿼리 최적화](https://sonamu.cartanova.ai/ko/troubleshooting/performance/query-optimization.md): 데이터베이스 쿼리 최적화하기

## OpenAPI Specs

- [openapi](https://sonamu.cartanova.ai/api-reference/openapi.json)