snapshot of https://github.com/twentyhq/twenty.git (main, 2026-09-17; blobs > 131072B omitted)

packages/twenty-docs/l/ko/getting-started/core-concepts/ai.mdx

@@ -0,0 +1,34 @@
+---
+title: AI
+description: Twenty가 AI를 활용해 CRM 경험을 향상시키는 방법입니다.
+icon: robot
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+Twenty는 AI를 단순한 보여주기식 기능이 아닌, 귀하의 데이터 모델과 권한 시스템 안에서 작동하는 도구로서 CRM에 직접 통합합니다.
+
+## AI 챗봇
+
+자연어로 데이터에 대해 질문해 보세요. AI 챗봇은 CRM 레코드를 조회하고 정보를 요약하여, 복잡한 필터를 만들지 않고도 원하는 내용을 찾을 수 있도록 도와줍니다.
+
+<VimeoEmbed videoId="1185511734" title="AI 챗봇" />
+
+## AI 에이전트
+
+AI 에이전트는 단순한 채팅을 넘어, 여러 단계를 포함한 작업을 자율적으로 실행할 수 있습니다:
+
+* 외부 소스의 데이터로 레코드를 보강
+* 후속 이메일을 작성하고 발송
+* 파이프라인 상태를 분석하고 위험 거래를 표시
+* 수신 데이터를 처리하고 적절한 팀으로 라우팅
+
+에이전트는 기존 워크플로 내에서 작동하므로, AI를 수동 승인, 조건부 로직, 외부 API 호출과 결합할 수 있습니다.
+
+## 권한 및 보안
+
+Twenty의 AI는 귀하의 권한 모델을 준수합니다. 에이전트는 사용자(또는 역할)에게 조회 권한이 있는 오브젝트와 필드에만 접근할 수 있습니다. 민감한 데이터는 AI가 개입하더라도 계속 보호됩니다.
+
+<Card title="전체 AI 가이드" icon="arrow-right" href="/l/ko/user-guide/ai/overview">
+  챗봇, 에이전트, 권한 제어에 대한 자세한 레퍼런스입니다.
+</Card>

packages/twenty-docs/l/ko/getting-started/core-concepts/apps.mdx

@@ -0,0 +1,41 @@
+---
+title: 앱
+icon: cube
+description: 코드로 Twenty를 확장하세요 — 커스텀 오브젝트, 서버 측 로직, UI 컴포넌트, AI 에이전트를 모두 TypeScript 패키지 형태로 제공합니다.
+---
+
+대부분의 CRM은 설정 패널을 제공합니다. Twenty는 플랫폼을 제공합니다. 앱은 개발자가 UI가 제공하는 것 이상으로 Twenty를 확장하는 방법입니다. 데이터 모델, 서버 측 로직, UI 컴포넌트, AI 기능을 코드로 정의하고, 이를 하나 이상의 워크스페이스에 배포합니다.
+
+## 앱이 존재하는 이유
+
+워크플로우는 노코드 자동화를 다룹니다. 하지만 어떤 것들은 코드가 필요합니다. 예를 들어, 커스텀 가격 책정 엔진, 독점 보강 파이프라인, 모든 레코드 업데이트 시 실행되는 규정 준수 검사, 내부 도구에서 데이터를 가져오는 커스텀 UI 패널 등이 있습니다.
+
+앱을 통해 이러한 것들을 일급 확장 기능으로 구축할 수 있습니다. 플랫폼 외부에서 API에만 의존하는 불안정한 스크립트가 아니라, 타입 시스템, 권한 모델, UI에 완전하게 접근할 수 있는 플랫폼 위에서 실행되는 코드로 만들 수 있습니다.
+
+## 앱이 정의할 수 있는 것
+
+앱은 `twenty-sdk`를 사용해 **엔티티**를 선언하는 TypeScript 패키지입니다.
+
+| 엔티티           | 하는 일                                                       |
+| ------------- | ---------------------------------------------------------- |
+| **객체 & 필드**   | 새 데이터 테이블과 기존 객체의 필드 — 기본 제공 항목과 동일하게 처리됩니다.               |
+| **로직 함수**     | HTTP 라우트, cron 스케줄 또는 데이터베이스 이벤트로 트리거되는 서버 측 TypeScript 코드 |
+| **프런트 컴포넌트**  | Twenty의 UI(사이드 패널, 위젯, 명령 메뉴) 안에 샌드박싱된 React 컴포넌트가 렌더링됩니다. |
+| **스킬 & 에이전트** | AI 기능 — 재사용 가능한 지침과 자율형 어시스턴트                              |
+| **뷰 & 내비게이션** | 사전 구성된 목록 뷰와 사이드바 메뉴 항목                                    |
+
+모든 것은 빌드 시점에 AST 분석을 통해 감지되며, 설정 파일이나 등록용 상용구 코드는 필요 없습니다. 어떤 `.ts` 파일에든 `export default defineObject(...)`를 추가하면 SDK가 이를 인식합니다.
+
+## 실행 방식
+
+* **로직 함수**는 호스트와 분리된 격리된 Node.js 프로세스에서 실행됩니다. 이들은 앱의 역할 권한 범위로 제한된 타입이 지정된 API 클라이언트를 통해 데이터에 접근합니다.
+* **프런트 컴포넌트**는 Remote DOM을 사용하는 Web Worker에서 실행됩니다 — 메인 페이지와는 샌드박스로 격리되어 있지만 네이티브 DOM 요소를 렌더링합니다(iframe이 아님).
+* **권한**은 API 수준에서 강제 적용됩니다. 앱은 자신의 역할이 허용하는 것만 볼 수 있습니다.
+
+## 개발자 경험
+
+여러분은 로컬 머신에서 TypeScript 프로젝트로 앱을 작성합니다. CLI가 소스 파일을 감시하며 실행 중인 Twenty 서버와 실시간으로 동기화합니다. 파일을 수정하면 1초 안에 UI에서 변경 사항을 확인할 수 있습니다. 스키마가 변경되면 타입이 지정된 API 클라이언트가 자동으로 재생성됩니다. 준비가 되면 `yarn twenty app:publish --private`로 프로덕션 서버에 배포하거나, `yarn twenty app:publish`로 앱을 npm과 Twenty 마켓플레이스에 게시할 수 있습니다.
+
+<Card title="첫 번째 앱 빌드하기" icon="arrow-right" href="/l/ko/developers/extend/apps/getting-started/quick-start">
+  3단계 워크스루 — 스캐폴딩, 로컬 서버 실행, 변경 사항 동기화.
+</Card>

packages/twenty-docs/l/ko/getting-started/core-concepts/calendar-and-email.mdx

@@ -0,0 +1,46 @@
+---
+title: 캘린더 및 이메일
+description: 이메일과 캘린더를 Twenty와 동기화하세요.
+icon: envelope
+---
+
+Twenty는 기존 도구들과 연동되어, 수동으로 데이터를 입력하지 않아도 CRM이 최신 상태로 유지되도록 해 줍니다.
+
+## 이메일 동기화
+
+**Google Workspace** 또는 **Microsoft 365** 메일박스를 연결하세요. 연결이 완료되면:
+
+* 이메일이 자동으로 해당 회사 및 사람 레코드에 연결됩니다.
+* 각 레코드의 타임라인에서 전체 이메일 스레드를 확인할 수 있습니다.
+* Twenty에서 직접 이메일을 보낼 수 있습니다.
+* 사용자당 여러 개의 메일박스를 지원합니다.
+
+가져올 내용을 직접 제어할 수 있으며, 날짜 범위나 보낸 사람으로 필터링해 관련 없는 이메일이 들어오는 것을 막을 수 있습니다.
+
+## 캘린더 동기화
+
+연결된 계정에서 캘린더 이벤트가 자동으로 동기화됩니다. 이벤트가 관련 CRM 레코드에 표시되어, 각 연락처나 회사와의 상호작용을 전체적으로 파악할 수 있습니다.
+
+## 통합
+
+이메일과 캘린더를 넘어, Twenty는 다음을 통해 외부 도구와 연동됩니다.
+
+| 방법                | 사용 사례                                   |
+| ----------------- | --------------------------------------- |
+| **API**           | GraphQL 또는 REST API를 사용해 맞춤형 통합을 구축하세요. |
+| **웹훅**            | 레코드가 변경될 때 외부 시스템으로 실시간 알림을 전송합니다.      |
+| **Zapier**        | 코드 작성 없이 5,000개 이상의 앱과 연동하세요.           |
+| **워크플로우 HTTP 액션** | 자동화된 워크플로우의 일부로 모든 외부 API를 호출할 수 있습니다.  |
+
+## 사용자 지정 앱
+
+개발자는 Twenty 위에 전체 기능을 갖춘 앱을 구축하여, 사용자 지정 UI, 서버 측 로직 및 심층 통합을 추가할 수 있습니다. 앱은 커뮤니티에 공개하거나 비공개로 유지할 수 있습니다.
+
+<CardGroup cols={2}>
+  <Card title="캘린더 및 이메일 가이드" icon="envelope" href="/l/ko/user-guide/calendar-emails/overview">
+    이메일 동기화, 캘린더 동기화를 설정하고 문제를 해결하세요.
+  </Card>
+  <Card title="API 및 확장 기능" icon="plug" href="/l/ko/developers/extend/api">
+    Twenty API로 맞춤형 통합을 구축하세요.
+  </Card>
+</CardGroup>

packages/twenty-docs/l/ko/getting-started/core-concepts/dashboards.mdx

@@ -0,0 +1,37 @@
+---
+title: 대시보드
+description: 맞춤형 대시보드로 성과를 추적하고 CRM 데이터를 시각화하세요.
+icon: chart-bar
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+대시보드를 사용하면 파이프라인 건전성, 팀 성과, 수익 추세 및 그 외에 추적하고 싶은 모든 비즈니스 지표를 실시간으로 파악할 수 있습니다.
+
+<VimeoEmbed videoId="1185511768" title="대시보드" />
+
+## 위젯
+
+각 대시보드는 여러 위젯으로 구성됩니다. 위젯은 CRM 데이터에 연결된 단일 차트 또는 지표입니다. 다음을 구성할 수 있습니다:
+
+* **차트 유형** — 막대, 꺾은선, 원형, 숫자 등
+* **데이터 소스** — 데이터 모델(표준 또는 커스텀)에 있는 모든 오브젝트
+* **필터** — 특정 레코드, 날짜 범위 또는 세그먼트로 범위를 좁히기
+* **집계** — 숫자 필드에 대해 개수, 합계, 평균, 최소값, 최대값 계산
+* **그룹화** — 선택한 필드, 날짜 또는 관계별로 분류
+
+## 추적할 수 있는 내용
+
+* 단계별 파이프라인 금액
+* 시간 경과에 따른 거래 성사 수
+* 소스별 평균 거래 규모
+* 작업 완료율
+* 모든 오브젝트에 대한 맞춤형 지표
+
+## 공유
+
+대시보드는 워크스페이스 수준에서 관리되며, 팀의 모든 사람이 볼 수 있습니다. 그리드 레이아웃에서 위젯을 배치하고 크기를 조정하여 팀에 적합한 보기를 만들 수 있습니다.
+
+<Card title="대시보드 전체 가이드" icon="arrow-right" href="/l/ko/user-guide/dashboards/overview">
+  대시보드 만들기, 위젯 구성 및 차트 설정에 대한 자세한 참고 자료입니다.
+</Card>

packages/twenty-docs/l/ko/getting-started/core-concepts/data-model.mdx

@@ -0,0 +1,47 @@
+---
+title: 데이터 모델
+description: Twenty가 개체, 필드, 관계로 데이터를 구조화하는 방식을 이해하세요.
+icon: database
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+Twenty의 모든 것은 **개체**와 **필드**를 중심으로 구축되어 있으며, 이는 데이터 모델의 구성 요소입니다.
+
+## 개체
+
+개체는 데이터를 저장하는 테이블입니다. Twenty에는 표준 개체가 기본으로 제공됩니다:
+
+* **Companies** — 비즈니스를 함께하는 조직
+* **People** — 개별 연락처
+* **Opportunities** — 파이프라인에 있는 거래
+* **Tasks** — 팀을 위한 실행 항목
+* **Notes** — 레코드에 연결된 자유 형식 텍스트
+
+또한 비즈니스에 필요한 모든 것에 대해 **사용자 지정 개체**를 생성할 수 있습니다. 예를 들어 프로젝트, 지원 티켓, 제품, 계약 등입니다.
+
+## 필드
+
+필드는 각 개체의 속성입니다. Twenty는 다양한 필드 유형을 지원합니다:
+
+| Category | 유형                                                                   |
+| -------- | -------------------------------------------------------------------- |
+| **기본**   | Text, Number, Boolean, Date, Currency, Rating, Select                |
+| **복합**   | Address (street, city, state, zip), Full Name, Links, Phones, Emails |
+| **특수**   | Relation, File Attachment, JSON, Actor (who created/modified)        |
+
+각 개체에는 `id`, `createdAt`, `updatedAt`, `createdBy`, `position`과 같은 시스템 필드도 자동으로 포함됩니다.
+
+## 관계
+
+개체는 관계를 통해 서로 연결됩니다. 하나의 Company에는 여러 People이 있고, 하나의 Opportunity는 하나의 Company에 속하는 식입니다. 또한 다대다 관계를 포함해 어떤 개체 간이든 사용자 지정 관계를 생성할 수 있습니다.
+
+## 이것이 강력한 이유
+
+미리 정의된 개체와 필드에만 제한되는 기존 CRM과는 달리, Twenty를 사용하면 비즈니스가 운영되는 방식에 맞춰 데이터를 정확하게 모델링할 수 있습니다. 사용자 지정 개체는 API 엔드포인트, 뷰, 권한, 워크플로 트리거 등을 포함해 기본 제공 개체와 동일한 최상위 수준으로 취급됩니다.
+
+<Card title="데이터 모델 자세히 살펴보기" icon="arrow-right" href="/l/ko/user-guide/data-model/overview">
+  개체, 필드, 관계 및 이를 구성하는 방법에 대한 전체 레퍼런스입니다.
+</Card>
+
+<VimeoEmbed videoId="1185511827" title="데이터 모델" />

packages/twenty-docs/l/ko/getting-started/core-concepts/glossary.mdx

@@ -0,0 +1,105 @@
+---
+title: 용어집
+icon: book
+description: Twenty 전반에 사용되는 주요 용어.
+---
+
+## API
+
+API(응용 프로그래밍 인터페이스)는 Twenty를 다른 소프트웨어 시스템과 연결하고 맞춤형 통합을 구축할 수 있게 합니다.
+
+## 앱
+
+앱은 데이터 모델과 로직 함수를 정의할 수 있도록 코드로 작성된 사용자 정의 확장 기능입니다. 이를 통해 개발자는 여러 워크스페이스에 걸쳐 배포할 수 있는 재사용 가능한 사용자 정의 기능을 만들 수 있습니다.
+
+## 코드 액션
+
+코드 액션은 데이터 변환, 계산 수행, 기본 제공 액션으로는 불가능한 복잡한 로직 실행을 위해 사용자 정의 JavaScript를 작성할 수 있게 해주는 워크플로우 단계입니다.
+
+## 명령 메뉴
+
+명령 메뉴는 신속한 작업 수행, 기록 생성 및 워크스페이스 내비게이션을 효율적으로 도와주는 빠른 접근 인터페이스입니다. (Mac에서는 `Cmd + K`, Windows에서는 `Ctrl + K`로 열림)
+
+## 회사 및 사람들
+
+CRM에는 두 가지 기본 유형의 기록이 있습니다:
+
+* `회사`는 기업이나 조직을 나타냅니다.
+* `사람들`은 현재 및 잠재 고객 또는 클라이언트를 나타냅니다.
+
+## 사용자 정의 필드
+
+사용자 정의 필드는 비즈니스 요구 및 프로세스에 특정한 정보를 캡처하기 위해 생성하는 데이터 필드입니다.
+
+## 데이터 모델
+
+데이터 모델은 CRM에서 정보가 어떻게 구성되는지를 정의하는 구조로, 어떤 객체가 존재하는지, 그 속성(필드), 그리고 서로 어떻게 관련되는지를 포함합니다.
+
+## 즐겨찾기
+
+즐겨찾기는 빠른 접근을 위해 표시해 둔 기록으로, 사이드바에 표시되어 중요한 데이터로 즉시 이동할 수 있게 합니다.
+
+## 필드
+
+필드는 특정 엔터티에 대한 특정 데이터가 저장되는 영역을 나타냅니다.
+
+## 이터레이터
+
+이터레이터는 항목 배열을 순회하여 목록의 각 항목에 대해 후속 액션을 실행하는 워크플로우 액션입니다.
+
+## 칸반
+
+`칸반`은 카드와 열을 사용하여 비즈니스 프로세스를 추적하는 시각적 방법입니다. 각 열은 프로세스의 단계를 나타내며(예: 신규, 진행 중, 성사, 실패), 기록이 진행됨에 따라 단계들을 거쳐 이동합니다.
+
+## 객체
+
+객체는 CRM에서 특정 유형의 엔터티(예: 사람, 회사, 기회)를 나타내는 데이터 구조입니다. 객체는 기본 제공 표준 객체일 수도 있고, 사용자 정의 객체(사용자가 생성한 객체)일 수도 있습니다.
+
+## 기회
+
+Twenty CRM에서 기회란 계정 또는 연락처와의 잠재적 거래 또는 판매를 의미합니다.
+
+## 기록
+
+기록은 특정 계정 또는 연락처와 같은 객체의 인스턴스를 나타냅니다.
+
+## 관계 필드
+
+관계 필드는 다른 객체들 간의 연결을 만들어 주며, 기록을 서로 연결할 수 있게 합니다. (예: 사람을 회사에 연결)
+
+## 표준 필드
+
+표준 필드는 객체에 기본 제공되는 미리 만들어진 데이터 필드로, 모든 워크스페이스에서 공통 기능을 제공합니다.
+
+## 작업
+
+Twenty CRM의 작업은 연락처, 계정 또는 기회와 관련된 할당된 활동입니다.
+
+## 트리거
+
+트리거는 워크플로우의 시작점으로 — 자동화를 시작하는 이벤트나 조건입니다. 예로는 기록 생성, 기록 업데이트, 웹훅, 예약된 시간 등이 있습니다.
+
+## 보기
+
+보기를 사용해 각 보기마다 필터, 레이아웃, 정렬 옵션을 설정하여 기록의 표시 방식을 사용자 지정할 수 있습니다.
+
+## 업서트
+
+업서트는 "update"와 "insert"를 결합한 작업으로 — 일치 항목이 있으면 기존 레코드를 업데이트하고, 없으면 새 레코드를 생성합니다.
+
+## 웹훅
+
+웹훅은 특정 이벤트가 발생할 때 Twenty에서 다른 애플리케이션으로 전송되는 자동화된 메시지로, 실시간 데이터 동기화를 가능하게 합니다.
+
+## 워크플로우
+
+워크플로우는 특정 조건에 따라 작업을 자동으로 트리거하여 반복적인 작업 및 비즈니스 프로세스를 자동화하는 데 도움이 되는 프로세스입니다.
+
+## 워크스페이스
+
+`워크스페이스`는 일반적으로 Twenty를 사용하는 회사를 나타냅니다. Twenty에 팀원들이 추가하는 모든 기록과 데이터를 보유합니다.
+일반적으로 회사에서 직원 이메일 주소에 사용하는 단일 도메인 이름을 가집니다.
+
+## 워크스페이스 구성원
+
+워크스페이스 구성원은 팀에서 워크스페이스에 접근할 수 있는 Twenty 사용자입니다. 이들은 기록의 소유자 또는 담당자로 지정될 수 있습니다.

packages/twenty-docs/l/ko/getting-started/core-concepts/layout.mdx

@@ -0,0 +1,74 @@
+---
+title: 레이아웃
+description: Twenty에서 탐색하고 둘러보며 레코드를 조회하는 방법입니다.
+icon: table-columns
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+## 메인 레이아웃
+
+화면 중앙은 레코드가 있는 곳으로, 사람, 회사, 영업 기회, 작업, 노트, 대시보드, 워크플로우, 그리고 모든 사용자 정의 객체가 위치합니다. 이곳에서 레코드를 조회, 편집, 삭제하고, 새로운 보기를 생성합니다.
+
+<img src="/images/user-guide/home/main-layout.png" style={{width:'100%'}} />
+
+## 내비게이션 바
+
+왼쪽 사이드바에서는 다음을 사용할 수 있습니다:
+
+* **워크스페이스 전환기** — 워크스페이스 간 전환 또는 새 워크스페이스 생성 (상단 드롭다운)
+* **검색** — `/`를 눌러 즉시 포커스를 맞추고, 모든 객체를 대상으로 검색합니다.
+* **설정** — 왼쪽 상단에서 접근
+* **즐겨찾기** — 고정된 보기, 사용자별로 고유함
+* **객체 바로가기** — People, Companies, Opportunities 등으로 빠르게 이동
+* **워크플로우** — 자동화를 생성합니다.
+
+항목을 끌어 순서를 변경하고, 관련 객체를 폴더로 묶고, 사용하지 않는 항목은 숨기세요.
+
+<img src="/images/user-guide/home/navigation-bar.png" style={{width:'100%'}} />
+
+## 명령 메뉴
+
+`Cmd+K`(Mac) 또는 `Ctrl+K`(Windows)를 누르거나 오른쪽 상단의 점 세 개를 클릭합니다. 여기에서 다음 작업을 수행할 수 있습니다:
+
+* 새 레코드를 생성
+* CSV를 통해 데이터를 가져오고 내보냅니다.
+* 새 보기를 생성
+* 삭제된 레코드에 접근 (Twenty는 소프트 삭제와 하드 삭제를 지원합니다)
+* 워크스페이스를 탐색하는 데 사용할 수 있는 키보드 단축키를 확인하세요.
+
+<img src="/images/user-guide/home/command-menu.png" style={{width:'100%'}} />
+
+## 검색
+
+명령 메뉴, 내비게이션 바 상단 또는 `/`를 눌러 접근할 수 있습니다. 검색은 모든 객체 전반에서 작동합니다.
+
+<img src="/images/user-guide/home/search-bar.png" style={{width:'100%'}} />
+
+## 사이드 패널
+
+레코드를 클릭하면 오른쪽에 사이드 패널이 열립니다. 현재 페이지를 벗어나지 않고 해당 레코드의 핵심 정보를 빠르게 확인할 수 있습니다. 전체 레코드 페이지로 이동하려면 **열기**를 클릭하세요.
+
+<img src="/images/user-guide/home/side-panel.png" style={{width:'100%'}} />
+
+## 보기
+
+모든 객체는 여러 보기를 지원하며, 객체별 보기 개수에는 제한이 없습니다. 왼쪽 상단의 드롭다운을 사용해 보기 간 전환을 할 수 있습니다.
+
+* **테이블** — 스프레드시트 스타일의 행과 열 보기로, 그룹화, 인라인 편집, 열 사용자 지정을 지원합니다.
+* **칸반** — 선택 필드를 기준으로 카드를 드래그 앤 드롭해 구성하며, 파이프라인에 적합합니다.
+* **캘린더** — 날짜 필드를 기준으로 레코드를 배치해 일정 기반 계획에 활용합니다.
+
+각 보기는 자체 필터, 정렬, 필드 가시성을 저장합니다. 보기를 워크스페이스와 공유하거나 비공개로 유지할 수 있습니다. 사이드바에서 빠르게 접근할 수 있도록 보기를 즐겨찾기에 추가하세요.
+
+<img src="/images/user-guide/home/view-menu.png" style={{width:'100%'}} />
+
+## 레코드 페이지
+
+레코드를 열면, 상세 페이지는 구성 가능한 **탭**과 **위젯**으로 구성됩니다. 필드, 관련 레코드, 이메일, 타임라인, 작업, 노트, 파일, 차트, iframes 등 위젯을 그리드에서 추가, 제거, 재정렬, 크기 조절할 수 있습니다. 각 객체 유형은 고유한 레이아웃을 가집니다.
+
+<Card title="전체 레이아웃 가이드" icon="arrow-right" href="/l/ko/user-guide/layout/overview">
+  내비게이션, 보기, 레코드 페이지에 대한 상세 참조와 사용 방법 안내입니다.
+</Card>
+
+<VimeoEmbed videoId="1185511790" title="레이아웃" />

packages/twenty-docs/l/ko/getting-started/core-concepts/workflows.mdx

@@ -0,0 +1,55 @@
+---
+title: 워크플로우
+description: Twenty의 비주얼 워크플로우 빌더로 비즈니스 프로세스를 자동화하세요.
+icon: bolt
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+워크플로우를 사용하면 반복적인 작업을 자동화하고 Twenty를 외부 도구와 연결할 수 있습니다. 코드 작성 없이 사용할 수 있지만, 원하면 코드를 작성할 수도 있습니다.
+
+<VimeoEmbed videoId="1185511711" title="워크플로우" />
+
+## 워크플로우의 동작 방식
+
+모든 워크플로우는 세 가지 부분으로 구성됩니다:
+
+1. **트리거** — 워크플로우를 시작하는 요소
+2. **단계** — 이후에 수행되는 작업(하나 이상의 작업이 순차적으로 실행됨)
+3. **변수** — 단계 간에 흐르는 데이터
+
+## 트리거
+
+| 트리거         | 실행 시점                                   |
+| ----------- | --------------------------------------- |
+| **레코드 이벤트** | 레코드가 생성, 업데이트, 삭제 또는 업서트될 때             |
+| **수동**      | 사용자가 버튼을 클릭할 때(단일 레코드, 여러 레코드 또는 전역적으로) |
+| **일정**      | 주기적으로(cron 구문)                          |
+| **웹훅**      | 외부 시스템이 HTTP POST를 전송할 때                |
+
+## 작업
+
+워크플로우는 다음을 어떤 조합으로든 연결할 수 있습니다:
+
+* **레코드 작업** — 레코드를 생성, 업데이트, 조회, 삭제 또는 업서트
+* **이메일 보내기** — 연결된 계정에서 이메일을 보내거나 초안을 작성
+* **HTTP 요청** — 외부 API 호출
+* **코드** — 복잡한 로직을 위한 커스텀 JavaScript 실행
+* **분기** — if/else 조건으로 워크플로우 경로를 분기
+* **이터레이터** — 데이터 배열을 반복 처리
+* **AI 에이전트** — AI 에이전트가 데이터를 자율적으로 처리하도록 함
+* **지연** — 계속 진행하기 전에 대기
+* **양식** — 워크플로우 중간에 사용자 입력 수집
+
+## 만들 수 있는 것
+
+* 거래가 특정 단계에 도달하면 Slack 알림 보내기
+* 외부 API 데이터를 사용해 신규 연락처를 자동 보강
+* 정체된 기회를 감지하고 담당자에게 알림
+* Twenty와 청구 시스템 간에 데이터를 동기화
+* 레코드 데이터를 기반으로 PDF 또는 인보이스 생성
+* 특정 조건과 일치하는 수신 이메일에 자동 회신
+
+<Card title="워크플로우 전체 가이드" icon="arrow-right" href="/l/ko/user-guide/workflows/overview">
+  트리거, 작업, 변수 및 실제 자동화 레시피에 대한 상세 레퍼런스입니다.
+</Card>

packages/twenty-docs/l/ko/getting-started/introduction.mdx

@@ -0,0 +1,55 @@
+---
+title: 왜 Twenty인가
+icon: heart
+---
+
+import { CardTitle } from "/snippets/card-title.mdx"
+
+지금까지 여러분은 시작하기는 쉽지만 변경이 불가능한 소프트웨어와, 유연하지만 설정하는 데 몇 달이 걸리는 소프트웨어 사이에서 선택해 왔습니다. Twenty는 세 번째 선택지입니다: **사용 준비가 이미 끝났고, 사용하면서 계속 재구성할 수 있는 CRM입니다.**
+
+## Twenty의 차별점
+
+Twenty는 설정만 하는 제품이 아니라, 그 위에 구축할 수 있는 플랫폼입니다.
+
+<CardGroup cols={2}>
+  <Card img="/images/user-guide/halftone/ai.png">
+    <CardTitle>에이전트를 위해 설계됨</CardTitle>
+    에이전트는 실제 권한으로 여러분의 데이터 모델 안에서 작업합니다. 기술, 도구, MCP.
+  </Card>
+  <Card img="/images/user-guide/halftone/permissions.png">
+    <CardTitle>보안이 보장된 확장성</CardTitle>
+    보안성이 검증된 기반 위에서, 바이브 코딩 도구의 유연성을 제공합니다.
+  </Card>
+  <Card img="/images/user-guide/halftone/dev-api.png">
+    <CardTitle>모던 스택</CardTitle>
+    React, TypeScript. 여러분의 팀은 이미 Twenty를 확장하는 방법을 알고 있습니다. 독점 언어도, 진입 장벽도 없습니다.
+  </Card>
+  <Card img="/images/user-guide/halftone/dev-self-host.png">
+    <CardTitle>락인 없음</CardTitle>
+    오픈 소스 코어, 셀프 호스팅 가능, 언제든지 데이터를 내보낼 수 있습니다.
+  </Card>
+</CardGroup>
+
+## Twenty는 누구를 위한 것인가
+
+* **Salesforce를 대체하려는 대기업** — 여러분의 팀은 이 도구를 활용하기보다, 이 도구와 싸우는 데 더 많은 시간을 쓰고 있습니다.
+  락인된 느낌이고, 비용은 계속해서 증가합니다.
+* **기술 창업자가 있는 스타트업** — 이제는 스프레드시트와 Notion만으로는 부족합니다. 여러분에게는 큰 포부가 있고, 함께 성장할 수 있는 CRM을 원합니다.
+* **우위를 찾는 GTM 팀** — 자체 리드 스코어링, 자체 데이터 보강, 자체 아웃바운드 워크플로를 구축하고 싶어 합니다.
+* **프라이버시에 민감한 조직** — 셀프 호스팅이 필요하고, 데이터를 처음부터 끝까지 직접 소유해야 합니다. 규제, 계약, 혹은 단지 원칙 때문일 수 있습니다.
+* **Salesforce 파트너** —
+  여러분의 개발자는 고객에게 라이선스 비용 인상을 설명하는 데 지쳤습니다.
+  더 나은 DX를 원하고, 고객에게 더 낮은 라이선스 비용으로 더 빠르게 프로젝트를 제공하고 싶어 합니다.
+* **웹 개발 에이전시** — 여러분의 팀은 TypeScript, React,
+  그리고 PostgreSQL을 이미 알고 있습니다. Twenty는 APEX를 배우거나 독점 자격증을 취득하지 않고도 CRM 시장에 진입할 수 있게 해 줍니다.
+
+## Twenty가 맞지 않은 경우
+
+* **다시는 신경 쓰지 않아도 되는 CRM을 원하는 팀.** Twenty는 도구에 밀접하게 관여해, 시간이 지남에 따라 함께 다듬어 가고자 하는 팀에게 더 큰 가치를 제공합니다. 완전 관리형 서비스를 원한다면 Pipedrive나
+  HubSpot이 좋은 선택이 될 것입니다.
+* **오늘 당장 수백 개의 사전 구축 통합이 필요한 회사.** 우리의 에코시스템은 빠르게 성장하고 있지만, 아직 Salesforce나 HubSpot만큼 폭넓지는 않습니다. 부족한 부분을 직접 구축할 수 있다면, 분명 마음에 드실 것입니다. 그렇지 않다면, 1년 뒤에 다시 찾아와 주세요.
+* **도구를 실제로 쓰는 사람이 아니라, 이사회 회의실에서 도구를 결정하는 조직.** 우리는 스테이크 디너나 경영진 브리핑을 제공하지 않습니다. 우리는 스스로 사용할 도구를 선택할 권한이 있는 팀과 함께 승리합니다.
+
+<Card title="시작할 준비가 되셨나요?" icon="rocket" href="/l/ko/getting-started/quickstart">
+  클라우드 또는 셀프 호스팅 환경에서 Twenty를 5분 이내에 설정해 보세요.
+</Card>

packages/twenty-docs/l/ko/getting-started/key-features.mdx

@@ -0,0 +1,70 @@
+---
+title: 핵심 기능
+description: 커스텀 데이터 모델부터 AI 기반 자동화까지, Twenty로 할 수 있는 모든 것을 둘러보세요.
+icon: star
+---
+
+import { CardTitle } from "/snippets/card-title.mdx"
+
+Twenty는 완전한 기능을 갖춘 CRM 플랫폼입니다. 이를 통해 무엇을 구축할 수 있는지 살펴보세요.
+
+<CardGroup cols={2}>
+  <Card href="/l/ko/user-guide/data-model/overview" img="/images/user-guide/halftone/data-model.png">
+    <CardTitle>Custom Data Model</CardTitle>
+    비즈니스에 필요한 정확한 데이터 구조를 정의하세요.
+    <br />커스텀 오브젝트를 만들고, 20개 이상의 필드 유형으로 커스텀 필드를 추가하며, 어떤 오브젝트끼리든 관계를 구성하세요.
+  </Card>
+
+  <Card href="/l/ko/user-guide/views-pipelines/overview" img="/images/user-guide/halftone/layout.png">
+    <CardTitle>Views & Pipelines</CardTitle>
+    테이블 뷰, 칸반 보드, 캘린더 뷰 간에 전환하세요.
+    <br />AND/OR 로직으로 필터링하고, 여러 필드 기준으로 정렬하며, 레코드를 그룹화하고, 커스텀 뷰를 저장하세요.
+  </Card>
+
+  <Card href="/l/ko/user-guide/workflows/overview" img="/images/user-guide/halftone/workflows.png">
+    <CardTitle>Workflows & Automation</CardTitle>
+    코드를 작성하지 않고도 모든 비즈니스 프로세스를 자동화하세요.
+    <br />레코드 변경, 일정, 수동 작업 또는 수신 웹훅을 트리거로 워크플로우를 실행하세요.
+  </Card>
+
+  <Card href="/l/ko/user-guide/calendar-emails/overview" img="/images/user-guide/halftone/calendar-emails.png">
+    <CardTitle>Calendar & Email Sync</CardTitle>
+    Google Workspace 또는 Microsoft 365 계정을 연결하세요.
+    <br />이메일과 캘린더 이벤트가 관련 CRM 레코드에 자동으로 표시됩니다.
+  </Card>
+
+  <Card href="/l/ko/user-guide/ai/overview" img="/images/user-guide/halftone/ai.png">
+    <CardTitle>AI</CardTitle>
+    CRM 내에서 자율적으로 작동하는 AI 에이전트가 질문에 답변하고, 레코드를 보강하며, 권한 모델 내에서 다단계 작업을 실행합니다.
+  </Card>
+
+  <Card href="/l/ko/user-guide/dashboards/overview" img="/images/user-guide/halftone/dashboards.png">
+    <CardTitle>Dashboards & Reporting</CardTitle>
+    실시간 위젯으로 커스텀 대시보드를 구축하세요.
+    <br />구성 가능한 차트와 필터로 파이프라인 지표, 팀 성과, 비즈니스 KPI를 추적하세요.
+  </Card>
+
+  <Card href="/l/ko/user-guide/permissions-access/overview" img="/images/user-guide/halftone/permissions.png">
+    <CardTitle>Permissions & Access Control</CardTitle>
+    오브젝트, 필드, 개별 레코드 등 모든 수준에서 역할 기반 액세스 제어를 구성하세요.
+    <br />SAML 또는 OIDC로 SSO를 구성하세요. 감사 로그를 통해 누가 무엇을 했는지 추적할 수 있습니다.
+  </Card>
+
+  <Card href="/l/ko/developers/extend/api" img="/images/user-guide/halftone/dev-api.png">
+    <CardTitle>API & Extensibility</CardTitle>
+    커스텀 데이터 모델에 맞게 확장되는 개발자 우선 API입니다.
+    <br />워크스페이스별로 자동 생성되는 문서를 갖춘 GraphQL 및 REST 엔드포인트를 모두 제공합니다.
+  </Card>
+
+  <Card href="/l/ko/user-guide/data-migration/overview" img="/images/user-guide/halftone/data-migration.png">
+    <CardTitle>Data Import & Export</CardTitle>
+    CSV 파일 또는 API를 통해 데이터를 가져오세요.
+    <br />필드 매핑, 중복 감지, 오류 처리가 내장되어 있습니다. 언제든지 데이터를 내보낼 수 있어 벤더 종속이 없습니다.
+  </Card>
+
+  <Card href="/l/ko/developers/self-host/self-host" img="/images/user-guide/halftone/dev-self-host.png">
+    <CardTitle>Self-Hosting</CardTitle>
+    단일 Docker Compose 명령으로 자체 인프라에서 Twenty를 실행하세요.
+    <br />데이터를 완전히 제어하고, 업데이트도 일정에 맞춰 진행하세요.
+  </Card>
+</CardGroup>

packages/twenty-docs/l/ko/getting-started/quickstart.mdx

@@ -0,0 +1,73 @@
+---
+title: 빠른 시작
+description: Twenty를 클라우드 또는 셀프 호스팅 환경에서 5분 이내에 실행해 보세요.
+icon: play
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+## 가입하기
+
+<Steps>
+  <Step title="계정 생성하기">
+    [app.twenty.com](https://app.twenty.com)으로 이동하여 Google, Microsoft 또는 이메일로 가입하세요.
+  </Step>
+  <Step title="평가판 선택">
+    **30일**(카드 필요) 또는 **7일**(카드 없이) 중에서 선택하세요. 두 옵션 모두 전체 액세스를 포함합니다. 연락처 무제한, 이메일 통합, 커스텀 객체, API를 모두 사용할 수 있습니다. 요금제나 결제 주기는 언제든지 변경할 수 있습니다.
+  </Step>
+  <Step title="워크스페이스 만들기">
+    Stripe를 통한 결제가 확인된 후 워크스페이스 이름과 사용자 프로필을 설정하게 됩니다. 언제든지 취소할 수 있습니다.
+  </Step>
+</Steps>
+
+<VimeoEmbed videoId="1185227242" title="워크스페이스 만들기" />
+
+## 워크스페이스 구성
+
+접속하면 Twenty를 내 환경에 맞게 설정하는 세 단계는 다음과 같습니다:
+
+### 1. 메일박스 연결하기
+
+**설정 → 계정**으로 이동하여 Google 또는 Microsoft 계정을 연결하세요. Twenty는 이메일과 캘린더 이벤트를 가져오고, 상호작용을 기반으로 자동으로 연락처를 생성합니다. 다른 공급자를 사용 중이신가요? 같은 페이지에서 SMTP를 통해 메일박스를 추가하거나 CalDAV를 통해 캘린더를 추가할 수 있습니다.
+
+<Note>여기서 시작하세요 — 메일박스를 연결하면 다른 항목을 맞춤설정하기 전에 실제 데이터를 통해 팀에 즉각적인 가치를 제공합니다.</Note>
+
+<VimeoEmbed videoId="1185416821" title="메일박스 연결하기" />
+
+### 2. 데이터 모델 구성하기
+
+**설정 → 데이터 모델**로 이동하여 커스텀 객체와 필드를 생성하세요. 알아두면 좋은 몇 가지 사항:
+
+* 커스텀 객체와 필드는 **모든 요금제에서 무제한으로 제공**되며, 추가 과금이 없습니다.
+* **People, Companies, Opportunities**는 동기화된 이메일과 미팅을 표시하는 객체입니다. 이들을 기본으로 사용하고, 이메일 이력이 없는 별도 객체를 만들기보다는 (예: `Person Type` 필드처럼) 필드를 추가해 분류하세요.
+* 두 People은 동일한 이메일을 공유할 수 없습니다. 두 Companies는 동일한 도메인을 공유할 수 없습니다.
+* 필요하지 않은 기본 필드/객체는 비활성화할 수 있으며, 삭제하지 않고도 보기에서 필드를 숨길 수 있습니다.
+
+[데이터 모델 참고 자료 →](/l/ko/user-guide/data-model/overview)
+
+<VimeoEmbed videoId="1185416793" title="데이터 모델 구성하기" />
+
+### 3. 데이터 가져오기
+
+Command 메뉴 (`Cmd+K` / `Ctrl+K`)를 사용하여 CSV를 통해 People, Companies, Opportunities 또는 임의의 커스텀 객체를 가져오세요. 먼저 샘플 파일을 다운로드하여 예상되는 형식을 확인하세요. 파일은 최대 10,000개 레코드로 제한하고, 가져오기 전에 이메일/도메인 중복을 제거하세요.
+
+[데이터 마이그레이션 가이드 →](/l/ko/user-guide/data-migration/overview)
+
+<VimeoEmbed videoId="1185416775" title="데이터 가져오기" />
+
+## 다음 단계
+
+<CardGroup cols={2}>
+  <Card title="레이아웃 살펴보기" icon="table-columns" href="/l/ko/getting-started/core-concepts/layout">
+    탐색, 보기, 명령 메뉴, 사이드 패널.
+  </Card>
+  <Card title="워크플로우 만들기" icon="bolt" href="/l/ko/user-guide/workflows/overview">
+    비즈니스 프로세스를 자동화하세요.
+  </Card>
+  <Card title="보기 생성" icon="table" href="/l/ko/user-guide/layout/overview">
+    테이블, 칸반, 캘린더 — 데이터를 필터링하고 정렬하세요.
+  </Card>
+  <Card title="API 살펴보기" icon="plug" href="/l/ko/developers/extend/api">
+    테넌트별 스키마 기반 REST 및 GraphQL.
+  </Card>
+</CardGroup>