snapshot of https://github.com/twentyhq/twenty.git (main, 2026-09-17; blobs > 131072B omitted)
Some checks failed
App Prod-Parity E2E Dispatch / dispatch (push) Failing after 10s
CD Storybook UI / build (push) Failing after 3m25s
CD Storybook UI / dispatch (push) Has been skipped
CD deploy main / website-changed-files (push) Successful in 18m8s
CI Agent Skills / changed-files-check (push) Successful in 18m9s
CI Create App E2E minimal / changed-files-check (push) Successful in 24s
CI Create App / changed-files-check (push) Successful in 26s
CI Docs / changed-files-check (push) Successful in 26s
CI Emails / changed-files-check (push) Successful in 28s
CI Example App Hello World / changed-files-check (push) Successful in 23s
CI Front / changed-files-check (push) Has been skipped
CI Example App Postcard / changed-files-check (push) Successful in 27s
CI UI / changed-files-check (push) Has been skipped
CI Utils Test / changed-files-check (push) Successful in 45s
CI Twenty Apps / discover (push) Successful in 1m3s
CD deploy main / deploy-main (push) Failing after 3s
CI Agent Skills / agent-skills-validate (push) Has been skipped
CI Create App / create-app-test (lint) (push) Has been skipped
CI Emails / emails-test (push) Has been skipped
CI Front / front-task (lingui:compile) (push) Has been skipped
CI Front / front-task (lint) (push) Has been skipped
CI Example App Postcard / example-app-postcard (push) Has been skipped
CI UI / ui-task (lint) (push) Has been skipped
CI UI / ui-task (pack-size) (push) Has been skipped
CI UI / ui-task (size) (push) Has been skipped
CI UI / ui-task (test) (push) Has been skipped
CI UI / ui-task (typecheck) (push) Has been skipped
CI Utils Test / utils-test (push) Has been skipped
CI Twenty Apps / ${{ matrix.app.name }} (push) Has been skipped
CI Emails / ci-emails-status-check (push) Successful in 2s
CI Example App Hello World / ci-example-app-hello-world-status-check (push) Successful in 2s
CI Example App Postcard / ci-example-app-postcard-status-check (push) Successful in 3s
CI UI / ui-sb-test (push) Has been skipped
CI Utils Test / ci-utils-test-status-check (push) Successful in 2s
CI Twenty Apps / ci-twenty-apps-status-check (push) Successful in 2s
CI UI / ci-ui-status-check (push) Successful in 2s
CI Desktop / desktop (push) Failing after 1m8s
Push docs to Crowdin / Push documentation to Crowdin (push) Failing after 55s
Push translations to Crowdin / Extract and upload translations (push) Failing after 5s
Push website translations to Crowdin / Extract and upload website translations (push) Failing after 5s
CI Create App / create-app-test (test) (push) Has been skipped
CI Create App / create-app-test (typecheck) (push) Has been skipped
CI Docs / docs-lint (push) Has been skipped
CI Example App Hello World / example-app-hello-world (push) Has been skipped
CI Front / front-task (lingui:extract) (push) Has been skipped
CI Front / front-task (test) (push) Has been skipped
CI Front / front-task (typecheck) (push) Has been skipped
CI UI / ui-sb-build (push) Failing after 1m32s
CI Twenty Apps / ${{ matrix.app.name }} (${{ matrix.server-source }}) (push) Has been skipped
CI Agent Skills / agent-skills-publish (push) Has been skipped
CI Create App / ci-create-app-status-check (push) Successful in 2s
CI Agent Skills / agent-skills-remote-source (push) Has been skipped
CI Create App E2E minimal / create-app-e2e-minimal (push) Has been cancelled
CI E2E Main / e2e-test (push) Has been cancelled
CI Front / front-sb-build (push) Has been cancelled
CI Front / front-build (push) Has been cancelled
CI Create App E2E minimal / ci-create-app-e2e-minimal-status-check (push) Has been cancelled
CI E2E Main / ci-e2e-main-status-check (push) Has been cancelled
CI E2E Main / notify-main-ci-failure (push) Has been cancelled
CI E2E Main / qa-scout-comment (push) Has been cancelled
CI Front / front-sb-test (push) Has been cancelled
CI Front / front-sb-screenshots (push) Has been cancelled
CI Front / ci-front-status-check (push) Has been cancelled
DPA Sub-Processor Sync / sync-subprocessors (push) Failing after 3s
AI Catalog Sync / sync-catalog (push) Failing after 2s

This commit is contained in:
upstream-mirror
2026-09-17 23:28:13 +05:00
commit e7da97194a
32688 changed files with 4208681 additions and 0 deletions

View File

@@ -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)를 사용하여 자동화를 시작하세요.

View File

@@ -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)에서 메시지를 보내주세요.

View File

@@ -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>