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

packages/twenty-docs/l/ko/user-guide/getting-started/capabilities/glossary.mdx

@@ -0,0 +1,104 @@
+---
+title: 용어집
+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/user-guide/getting-started/capabilities/implementation-services.mdx

@@ -0,0 +1,17 @@
+---
+title: 구현 서비스
+description: 시작을 위한 지원이 필요하시든 고급 맞춤 설정을 원하시든, 저희에게는 해결책이 있습니다.
+---
+
+## 구현 파트너
+
+인증된 Twenty 파트너와 협력하여 고급 커스터마이징, 통합 및 전담 구축 지원을 받아 보세요.
+
+<CardGroup cols={2}>
+  <Card title="인증된 파트너 둘러보기" icon="magnifying-glass" href="https://twenty.com/partners/list?ref=docs-implementation-services">
+    파트너를 찾아 바로 문의하세요 — 지역, 언어, 전문 분야로 필터링할 수 있습니다.
+  </Card>
+  <Card title="Twenty가 매칭해 드립니다" icon="envelope" href="mailto:contact@twenty.com">
+    필요한 내용을 알려주시면, 적합한 파트너와 연결해 드립니다.
+  </Card>
+</CardGroup>

packages/twenty-docs/l/ko/user-guide/getting-started/capabilities/what-is-twenty.mdx

@@ -0,0 +1,42 @@
+---
+title: 트웬티란 무엇입니까?
+description: Twenty는 비즈니스에 필요한 것을 정확히 만들 수 있도록 기본 구성 요소를 제공하는 오픈 소스 CRM입니다.
+---
+
+## 비전
+
+좋은 CRM을 만드는 것은 어렵습니다. 왜냐하면 그것은 균형 잡기의 행위이기 때문입니다.
+비즈니스마다 요구 사항은 간단히 보이지만 각자의 필요는 다릅니다.
+결과적으로 CRM은 너무 기본적이거나 지나치게 많은 것을 시도하지만 어떤 것도 전문적으로 다루지 못하게 됩니다.
+
+처음에 트웬티는 이미 알고 있는 대부분의 CRM과 유사하게 보입니다: 거래를 추적하고 연락처를 조직하고, 작업 및 메모를 관리할 수 있습니다.
+**그러나 이를 차별화하는 것은 확장 가능성에 대한 우리의 접근 방식입니다. 우리는 고객의 고유한 비즈니스 문제를 해결할 수 있도록 건축 블록을 제공하는 오픈 플랫폼을 구축하고 있습니다.**
+
+기능 목록보다 보편적인 원칙과 일반적인 패턴을 우선시합니다.
+모든 답을 찾으려 하지 않고 사용자가 자신에게 가장 잘 맞는 방식을 찾을 수 있도록 지원합니다.
+오픈 소스는 우리의 접근 방식을 지탱하는 기초이며, 트웬티는 커뮤니티와 함께 진화하며 커뮤니티를 위한 것입니다.
+
+## 이점
+
+**사용자 정의 가능:** 비즈니스 요구 사항에 맞도록 설계되었습니다.
+
+**커뮤니티 주도:** 대규모 오픈 소스 커뮤니티에 의해 구축되고 유지 관리됩니다.
+
+**비용 효율적:** 언제든지 자체 호스팅이 가능하므로 벤더 락인이 없습니다.
+
+## 주요 기능
+
+* **캘린더 및 이메일:** 메일함과 캘린더를 동기화하여 CRM 레코드에서 모든 커뮤니케이션을 확인하세요. [자세히 알아보기](/l/ko/user-guide/calendar-emails/overview).
+* **데이터 모델:** 고유한 비즈니스 프로세스에 맞게 사용자 지정 객체와 필드를 생성하세요. [자세히 보기](/l/ko/user-guide/data-model/overview).
+* **데이터 마이그레이션:** CSV 또는 API를 통해 데이터를 가져오고 내보내세요. [시작하기](/l/ko/user-guide/data-migration/overview).
+* **보기 및 파이프라인:** 테이블 보기, 칸반 보드, 영업 파이프라인으로 데이터를 구성하세요. [자세히 보기](/l/ko/user-guide/views-pipelines/overview).
+* **워크플로우:** 비즈니스 프로세스를 자동화하고 외부 도구와 통합하세요. [자동화 구축](/l/ko/user-guide/workflows/overview).
+* **AI:** AI 기반 기능과 에이전트로 CRM을 강화하세요. [AI 자세히 보기](/l/ko/user-guide/ai/overview).
+* **대시보드:** 맞춤형 보고서와 시각화를 통해 성과를 추적하세요. [대시보드 보기](/l/ko/user-guide/dashboards/overview).
+* **권한 및 액세스:** 역할 기반 권한을 통해 누가 데이터를 보기, 편집, 관리할 수 있는지 제어하세요. [액세스 구성](/l/ko/user-guide/permissions-access/overview).
+* **노트 및 작업:** 더 나은 협업을 위해 레코드에 연결된 노트와 작업을 생성하세요.
+* **API 및 웹훅:** 다른 앱과 연결하고 맞춤형 통합을 구축하세요. [통합 시작하기](/l/ko/developers/extend/api).
+
+## 지금 가입하세요
+
+[여기에서 등록하십시오](https://app.twenty.com) 또는 [GitHub에서 기여자로 참여하세요](https://github.com/twentyhq/twenty).

packages/twenty-docs/l/ko/user-guide/getting-started/how-tos/configure-your-workspace.mdx

@@ -0,0 +1,77 @@
+---
+title: 워크스페이스 구성
+description: 모든 비즈니스는 다르게 작동합니다. 요구에 맞게 Twenty를 구성하려면 이 3단계부터 시작하세요.
+---
+
+<Note>**빠른 성과**: 메일박스를 먼저 연결하는 것부터 시작하세요. 이는 즉각적인 가치를 부여하고 팀이 실제 데이터로 Twenty를 활동 중인 상태로 볼 수 있도록 돕습니다. 설정 → 계정에서 이를 수행할 수 있습니다.</Note>
+
+## 1. 데이터 모델 사용자 정의하기
+
+Twenty는 일상 업무를 가장 잘 지원할 수 있는 데이터 모델을 설계하는 데 필요한 유연성을 제공합니다.
+여러 객체 간의 관계를 포함한 모든 유형의 객체 및 필드를 생성할 수 있습니다. 설정 → 데이터 모델에서 이를 할 수 있습니다.
+아래 몇 가지 팁이 있습니다:
+
+* **사용자 정의 필드나 사용자 정의 객체의 수에는 제한이 없습니다**. 사용자 정의 객체와 필드를 추가해도 요금을 업그레이드할 필요는 없습니다.
+* **People, Companies 및 Opportunities는 메일박스와 캘린더에서 동기화된 이메일 및 회의에 액세스할 수 있는 세 가지 객체입니다**. 필요시 레코드를 분류할 수 있는 필드를 추가하여 가능한 한 많이 사용하는 것을 권장합니다. 다음은 예시입니다:
+  * 잠재 고객 및 파트너에 대해 People 객체를 사용하는 것이 가장 좋으며, Partner 사용자 정의 객체를 생성하는 대신 People 객체에 `Person Type`이라는 필드를 만드는 것이 좋습니다. Partner 레코드에서는 이 사람과 주고받은 이메일을 확인할 수 없기 때문입니다.
+  * People에서 파트너를 표시하는 보기와 잠재 고객을 표시하는 다른 보기를 만드세요.
+* 두 People은 동일한 이메일 주소를 가질 수 없습니다. 두 Companies는 동일한 도메인을 가질 수 없습니다.
+* 사용하지 않으려는 표준 필드와 객체를 비활성화할 수 있습니다.
+* 보기에서 필드를 숨길 수 있습니다: 필드를 생성하는 것을 두려워하지 마세요, 전부 다 표시할 필요는 없습니다.
+
+데이터 모델 설계를 배우려면 [이 글](/l/ko/user-guide/data-model/overview)을 읽으세요.
+
+## 2. 데이터 가져오기
+
+기존 데이터를 Twenty에 가져오면 팀이 바로 컨텍스트를 가질 수 있습니다.
+
+### 메일박스 연결하기
+
+워크스페이스 생성 시 이를 수행하지 않았다면, 설정 → 계정에서 **Google 또는 Microsoft 계정**을 연결하세요. 이로써 Twenty는 다음과 같은 작업을 할 수 있습니다:
+
+* 메시지와 회의 가져오기
+* 상호 작용을 기반으로 연락처를 자동 생성하기 (선택사항)
+* 팀에서 커뮤니케이션 기록을 계속 볼 수 있도록 합니다.
+
+**다른 공급업체를 사용합니까?**
+SMTP를 통해 다른 메일박스를 추가하거나 CalDAV를 통해 다른 캘린더를 추가할 수 있습니다. 구성하려면 **설정 → 계정**으로 이동하세요.
+
+### CSV로 데이터 가져오기
+
+Command 메뉴 (`Cmd + K` 또는 `Ctrl + K`)를 사용하여 CSV를 통해 People, Companies, Opportunities 또는 다른 사용자 정의 객체를 가져옵니다.
+
+**주요 지침**:
+
+* 기대되는 형식을 이해하기 위해 샘플 파일을 다운로드해주세요
+* 각 파일의 레코드를 10,000개로 제한하세요.
+* People의 중복 이메일 또는 Companies의 중복 도메인을 제거하세요.
+* 가져오기 전에 오류를 검토하고 수정하세요 (노란색으로 강조 표시된 부분).
+
+Read [this article](/l/ko/user-guide/data-migration/overview) to learn more about data import.
+
+## 3. 첫 번째 뷰 만들기
+
+다른 보기를 만드는 것은 팀이 데이터를 실질적으로 활용할 수 있게 만드는 핵심입니다.
+진행 방법은 다음과 같습니다:
+
+* **열 추가 또는 숨기기**
+  옵션 → 필드(오른쪽 위)를 클릭하여 특정 보기에서 보이는 필드를 관리하세요. 거기서 필드를 표시하거나 숨길 수 있습니다.
+
+* **필드 순서 변경**
+  옵션 → 필드(오른쪽 위)를 클릭하여 특정 보기에서 필드의 순서를 변경하세요. 끌어다 놓기하여 필드를 재정렬합니다.
+
+* **보기 필터링**
+  오른쪽 위 필터 사용하여 표시된 레코드를 제한하세요.
+
+* **레코드 정렬**
+  오른쪽 위 정렬 기능 사용하거나 열 이름을 클릭하여 표시된 레코드를 재정렬하세요.
+
+* **레이아웃 선택**
+  `단계` 또는 유사한 선택형 필드가 있는 한, **칸반 레이아웃** 또는 **그룹별 목록** 레이아웃으로 전환할 수 있습니다.
+
+* **즐겨찾기로 보기 저장**
+  여러 보기를 보여주는 드롭다운 메뉴를 사용하여 이를 할 수 있습니다.
+
+## 다음은 무엇입니까?
+
+[워크플로우](/l/ko/user-guide/workflows/overview)를 사용하여 자동화를 시작하세요.

packages/twenty-docs/l/ko/user-guide/getting-started/how-tos/create-workspace.mdx

@@ -0,0 +1,48 @@
+---
+title: 워크스페이스 만들기
+description: Twenty에 등록하고, 구독 플랜을 선택하고, 계정을 설정하는 방법에 대한 단계별 가이드를 따르십시오.
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+## 1단계: 등록
+
+1. [Twenty 등록](https://app.twenty.com)으로 이동하세요.
+2. 선호하는 등록 방법을 선택하세요:
+   * Google 계정으로 등록하려면 **Google로 계속**을 선택하십시오.
+   * Microsoft 계정으로 등록하려면 **Microsoft로 계속**을 선택하십시오.
+   * 또는, 이메일로 등록하려면 **이메일로 계속**을 선택하십시오.
+
+<VimeoEmbed videoId="927066829" title="동영상 시연" />
+
+## 2단계: 시험 기간 선택하기
+
+두 가지 시험 기간 중 하나를 선택하세요:
+
+### 30일
+
+신용카드 있음
+
+### 7일
+
+신용카드 없음
+
+두 가지 시험 모두 포함:
+
+* 전체 접근
+* 무제한 연락처
+* 이메일 통합
+* 사용자 지정 개체
+* API 및 웹훅
+
+"플랜 변경"을 클릭하여 다른 플랜이나 청구 주기를 선택할 수 있습니다.
+
+<img src="/images/user-guide/create-workspace/choose-plan.png" style={{width:'100%'}} />
+
+## 3단계: 결제 확인 및 계정 설정
+
+Stripe를 통한 결제 승인이 완료되면, 작업 공간 및 사용자 프로필을 생성하도록 안내받습니다. 언제든지 구독을 취소할 수 있다는 점을 기억하세요.
+
+## 지원
+
+문의 사항이나 도움이 필요하시면, [contact@twenty.com](mailto:contact@twenty.com)으로 전용 지원팀에 연락하거나 [Discord](https://discord.gg/cx5n4Jzs57)에서 메시지를 보내주세요.

packages/twenty-docs/l/ko/user-guide/getting-started/how-tos/navigate-around-twenty.mdx

@@ -0,0 +1,84 @@
+---
+title: Twenty 둘러보기
+description: 플랫폼을 탐색하고 다양한 유형의 작업을 수행할 수 있는 위치에 대한 빠른 개요를 얻으십시오.
+---
+
+## 주요 레이아웃
+
+화면 중앙은 **레코드가 있는 곳**입니다: 사람, 회사, 영업기회, 작업, 노트, 대시보드, 워크플로우, 그리고 생성한 기타 모든 개체입니다. 여기에서 일상의 작업이 이루어집니다.
+그곳에서 **레코드를 보고, 편집하거나 삭제**할 수 있으며, **새로운 보기를 생성**할 수도 있습니다.
+
+<img src="/images/user-guide/home/main-layout.png" style={{width:'100%'}} />
+
+## 내비게이션 바
+
+왼쪽에서는 위에서 아래 순서로 다음을 수행할 수 있습니다:
+
+* 드롭다운 메뉴를 사용하여 여러 작업 공간 간에 전환하거나 새 작업 공간을 만듭니다.
+* **검색창을 사용**하세요 (즉시 초점을 맞추려면 `/`를 누르세요)
+* **설정** 섹션 열기
+* **즐겨찾기 보기**에 직접 액세스할 수 있습니다. 즐겨찾기는 사용자마다 고유합니다.
+* 다른 객체 간 전환
+* 워크플로우를 사용하여 **자동화를 생성**합니다.
+
+<img src="/images/user-guide/home/navigation-bar.png" style={{width:'100%'}} />
+
+## 명령 메뉴
+
+명령 메뉴는 Twenty에서 **작업에 빠르게 접근할 수 있는 기능을 제공합니다**. 두 가지 방법으로 접근할 수 있습니다:
+
+* **키보드 단축키**: `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%'}} />
+
+## 사이드 패널
+
+레코드를 클릭하면 오른쪽에 사이드 패널이 표시됩니다. 다른 페이지로 이동하지 않고도 해당 레코드의 핵심 정보를 빠르게 확인할 수 있습니다. 그곳에서 이 개요를 닫거나 Open 버튼을 클릭하여 이 레코드에 대한 추가 정보를 확인할 수 있습니다.
+
+<img src="/images/user-guide/home/side-panel.png" style={{width:'100%'}} />
+
+## 보기
+
+모든 객체(예: 기회 또는 사람)는 여러 보기를 지원합니다. 객체당 보기 수에는 제한이 없습니다.
+
+주요 레이아웃의 좌측 상단의 드롭다운 메뉴를 사용하여 다양한 보기 간 전환이 가능합니다. 예를 들어:
+
+* 기회를 스테이지별로 추적하기 위해 Kanban 뷰를 사용하세요
+* 섹션을 만들고 효율성을 높이기 위해 그룹 보기를 사용하세요
+* 특정 기록물에 집중하기 위해 필터를 사용하세요 (예: 지난주에 생성된 리드)
+* 필터된 보기를 저장하여 나중에 다시 사용하세요
+* 빠르게 액세스할 수 있도록 보기를 즐겨찾기로 지정하세요.
+
+<img src="/images/user-guide/home/view-menu.png" style={{width:'100%'}} />
+
+보기가 처음이라면 [보기 및 파이프라인 가이드](/l/ko/user-guide/views-pipelines/overview)를 읽고 생성 및 사용자 정의 방법을 알아보세요.
+
+## 설정
+
+상단 왼쪽에서 설정을 열어 다음을 수행합니다:
+
+* **메일박스와 캘린더** 계정을 연결하여 이메일과 캘린더를 원활하게 동기화합니다
+* **데이터 모델**을 사용자 정의하세요: 사용자 정의 객체, 필드, 관계를 생성합니다
+* **API 플레이그라운드에 접속하고 웹훅을 구성하세요**
+* **사용자 권한을 관리**하고 작업 공간 접근 제어를 관리합니다
+* 팀원을 초대하고 사용자 역할을 관리합니다
+* 프로필과 작업 공간 환경설정을 편집합니다
+* 청구를 설정하고 워크플로우 크레딧 사용량을 모니터링합니다
+* 다가오는 기능을 찾아보고 활성화하세요(Updates → Early Access 아래)
+* **지원에 접속**하여 라이브 채팅으로 문의하세요
+* **문서를 열어** 사용자 가이드와 개발자 문서를 둘러보세요
+
+<Note>설정 아래에서 해당 섹션이 모두 보이지 않는 경우, 워크스페이스 관리자에게 문의하세요 — 일부 섹션은 액세스가 제한되어 있습니다.</Note>