From 8712ae754dfb773106bb319ef11ad5bfd1f8f6c0 Mon Sep 17 00:00:00 2001
From: "github-actions[bot]"
<41898282+github-actions[bot]@users.noreply.github.com>
Date: Fri, 19 Jun 2026 15:43:40 +0200
Subject: [PATCH] i18n - docs translations (#21859)
Created by Github action
Co-authored-by: github-actions
---
packages/twenty-docs/docs.json | 312 ++++++++++++++++++
.../l/ar/getting-started/core-concepts/ai.mdx | 34 ++
.../ar/getting-started/core-concepts/apps.mdx | 41 +++
.../core-concepts/calendar-and-email.mdx | 46 +++
.../core-concepts/dashboards.mdx | 37 +++
.../core-concepts/data-model.mdx | 47 +++
.../core-concepts/glossary.mdx | 105 ++++++
.../getting-started/core-concepts/layout.mdx | 74 +++++
.../core-concepts/workflows.mdx | 55 +++
.../l/ar/getting-started/introduction.mdx | 66 ++++
.../l/ar/getting-started/key-features.mdx | 70 ++++
.../l/ar/getting-started/quickstart.mdx | 73 ++++
.../l/cs/getting-started/core-concepts/ai.mdx | 34 ++
.../cs/getting-started/core-concepts/apps.mdx | 41 +++
.../core-concepts/calendar-and-email.mdx | 46 +++
.../core-concepts/dashboards.mdx | 37 +++
.../core-concepts/data-model.mdx | 47 +++
.../core-concepts/glossary.mdx | 105 ++++++
.../getting-started/core-concepts/layout.mdx | 74 +++++
.../core-concepts/workflows.mdx | 55 +++
.../l/cs/getting-started/introduction.mdx | 62 ++++
.../l/cs/getting-started/key-features.mdx | 70 ++++
.../l/cs/getting-started/quickstart.mdx | 73 ++++
.../l/de/getting-started/core-concepts/ai.mdx | 34 ++
.../de/getting-started/core-concepts/apps.mdx | 41 +++
.../core-concepts/calendar-and-email.mdx | 46 +++
.../core-concepts/dashboards.mdx | 37 +++
.../core-concepts/data-model.mdx | 47 +++
.../core-concepts/glossary.mdx | 105 ++++++
.../getting-started/core-concepts/layout.mdx | 74 +++++
.../core-concepts/workflows.mdx | 55 +++
.../l/de/getting-started/introduction.mdx | 72 ++++
.../l/de/getting-started/key-features.mdx | 70 ++++
.../l/de/getting-started/quickstart.mdx | 73 ++++
.../l/es/getting-started/core-concepts/ai.mdx | 34 ++
.../es/getting-started/core-concepts/apps.mdx | 41 +++
.../core-concepts/calendar-and-email.mdx | 46 +++
.../core-concepts/dashboards.mdx | 37 +++
.../core-concepts/data-model.mdx | 47 +++
.../core-concepts/glossary.mdx | 105 ++++++
.../getting-started/core-concepts/layout.mdx | 74 +++++
.../core-concepts/workflows.mdx | 55 +++
.../l/es/getting-started/introduction.mdx | 73 ++++
.../l/es/getting-started/key-features.mdx | 70 ++++
.../l/es/getting-started/quickstart.mdx | 73 ++++
.../l/fr/getting-started/core-concepts/ai.mdx | 34 ++
.../fr/getting-started/core-concepts/apps.mdx | 41 +++
.../core-concepts/calendar-and-email.mdx | 46 +++
.../core-concepts/dashboards.mdx | 37 +++
.../core-concepts/data-model.mdx | 47 +++
.../core-concepts/glossary.mdx | 105 ++++++
.../getting-started/core-concepts/layout.mdx | 74 +++++
.../core-concepts/workflows.mdx | 55 +++
.../l/fr/getting-started/introduction.mdx | 71 ++++
.../l/fr/getting-started/key-features.mdx | 70 ++++
.../l/fr/getting-started/quickstart.mdx | 73 ++++
.../l/it/getting-started/core-concepts/ai.mdx | 34 ++
.../it/getting-started/core-concepts/apps.mdx | 41 +++
.../core-concepts/calendar-and-email.mdx | 46 +++
.../core-concepts/dashboards.mdx | 37 +++
.../core-concepts/data-model.mdx | 47 +++
.../core-concepts/glossary.mdx | 105 ++++++
.../getting-started/core-concepts/layout.mdx | 74 +++++
.../core-concepts/workflows.mdx | 55 +++
.../l/it/getting-started/introduction.mdx | 72 ++++
.../l/it/getting-started/key-features.mdx | 70 ++++
.../l/it/getting-started/quickstart.mdx | 73 ++++
.../l/ko/getting-started/core-concepts/ai.mdx | 34 ++
.../ko/getting-started/core-concepts/apps.mdx | 41 +++
.../core-concepts/calendar-and-email.mdx | 46 +++
.../core-concepts/dashboards.mdx | 37 +++
.../core-concepts/data-model.mdx | 47 +++
.../core-concepts/glossary.mdx | 105 ++++++
.../getting-started/core-concepts/layout.mdx | 74 +++++
.../core-concepts/workflows.mdx | 55 +++
.../l/ko/getting-started/introduction.mdx | 55 +++
.../l/ko/getting-started/key-features.mdx | 70 ++++
.../l/ko/getting-started/quickstart.mdx | 73 ++++
.../l/pt/getting-started/core-concepts/ai.mdx | 34 ++
.../pt/getting-started/core-concepts/apps.mdx | 41 +++
.../core-concepts/calendar-and-email.mdx | 46 +++
.../core-concepts/dashboards.mdx | 37 +++
.../core-concepts/data-model.mdx | 47 +++
.../core-concepts/glossary.mdx | 105 ++++++
.../getting-started/core-concepts/layout.mdx | 74 +++++
.../core-concepts/workflows.mdx | 55 +++
.../l/pt/getting-started/introduction.mdx | 72 ++++
.../l/pt/getting-started/key-features.mdx | 70 ++++
.../l/pt/getting-started/quickstart.mdx | 73 ++++
.../l/ro/getting-started/core-concepts/ai.mdx | 34 ++
.../ro/getting-started/core-concepts/apps.mdx | 41 +++
.../core-concepts/calendar-and-email.mdx | 46 +++
.../core-concepts/dashboards.mdx | 37 +++
.../core-concepts/data-model.mdx | 47 +++
.../core-concepts/glossary.mdx | 105 ++++++
.../getting-started/core-concepts/layout.mdx | 74 +++++
.../core-concepts/workflows.mdx | 55 +++
.../l/ro/getting-started/introduction.mdx | 72 ++++
.../l/ro/getting-started/key-features.mdx | 70 ++++
.../l/ro/getting-started/quickstart.mdx | 73 ++++
.../l/ru/getting-started/core-concepts/ai.mdx | 34 ++
.../ru/getting-started/core-concepts/apps.mdx | 41 +++
.../core-concepts/calendar-and-email.mdx | 46 +++
.../core-concepts/dashboards.mdx | 37 +++
.../core-concepts/data-model.mdx | 47 +++
.../core-concepts/glossary.mdx | 105 ++++++
.../getting-started/core-concepts/layout.mdx | 74 +++++
.../core-concepts/workflows.mdx | 55 +++
.../l/ru/getting-started/introduction.mdx | 72 ++++
.../l/ru/getting-started/key-features.mdx | 70 ++++
.../l/ru/getting-started/quickstart.mdx | 73 ++++
.../l/tr/getting-started/core-concepts/ai.mdx | 34 ++
.../tr/getting-started/core-concepts/apps.mdx | 41 +++
.../core-concepts/calendar-and-email.mdx | 46 +++
.../core-concepts/dashboards.mdx | 37 +++
.../core-concepts/data-model.mdx | 47 +++
.../core-concepts/glossary.mdx | 105 ++++++
.../getting-started/core-concepts/layout.mdx | 74 +++++
.../core-concepts/workflows.mdx | 55 +++
.../l/tr/getting-started/introduction.mdx | 62 ++++
.../l/tr/getting-started/key-features.mdx | 70 ++++
.../l/tr/getting-started/quickstart.mdx | 73 ++++
.../l/zh/getting-started/core-concepts/ai.mdx | 34 ++
.../zh/getting-started/core-concepts/apps.mdx | 41 +++
.../core-concepts/calendar-and-email.mdx | 46 +++
.../core-concepts/dashboards.mdx | 37 +++
.../core-concepts/data-model.mdx | 47 +++
.../core-concepts/glossary.mdx | 105 ++++++
.../getting-started/core-concepts/layout.mdx | 74 +++++
.../core-concepts/workflows.mdx | 55 +++
.../l/zh/getting-started/introduction.mdx | 53 +++
.../l/zh/getting-started/key-features.mdx | 70 ++++
.../l/zh/getting-started/quickstart.mdx | 73 ++++
133 files changed, 8098 insertions(+)
create mode 100644 packages/twenty-docs/l/ar/getting-started/core-concepts/ai.mdx
create mode 100644 packages/twenty-docs/l/ar/getting-started/core-concepts/apps.mdx
create mode 100644 packages/twenty-docs/l/ar/getting-started/core-concepts/calendar-and-email.mdx
create mode 100644 packages/twenty-docs/l/ar/getting-started/core-concepts/dashboards.mdx
create mode 100644 packages/twenty-docs/l/ar/getting-started/core-concepts/data-model.mdx
create mode 100644 packages/twenty-docs/l/ar/getting-started/core-concepts/glossary.mdx
create mode 100644 packages/twenty-docs/l/ar/getting-started/core-concepts/layout.mdx
create mode 100644 packages/twenty-docs/l/ar/getting-started/core-concepts/workflows.mdx
create mode 100644 packages/twenty-docs/l/ar/getting-started/introduction.mdx
create mode 100644 packages/twenty-docs/l/ar/getting-started/key-features.mdx
create mode 100644 packages/twenty-docs/l/ar/getting-started/quickstart.mdx
create mode 100644 packages/twenty-docs/l/cs/getting-started/core-concepts/ai.mdx
create mode 100644 packages/twenty-docs/l/cs/getting-started/core-concepts/apps.mdx
create mode 100644 packages/twenty-docs/l/cs/getting-started/core-concepts/calendar-and-email.mdx
create mode 100644 packages/twenty-docs/l/cs/getting-started/core-concepts/dashboards.mdx
create mode 100644 packages/twenty-docs/l/cs/getting-started/core-concepts/data-model.mdx
create mode 100644 packages/twenty-docs/l/cs/getting-started/core-concepts/glossary.mdx
create mode 100644 packages/twenty-docs/l/cs/getting-started/core-concepts/layout.mdx
create mode 100644 packages/twenty-docs/l/cs/getting-started/core-concepts/workflows.mdx
create mode 100644 packages/twenty-docs/l/cs/getting-started/introduction.mdx
create mode 100644 packages/twenty-docs/l/cs/getting-started/key-features.mdx
create mode 100644 packages/twenty-docs/l/cs/getting-started/quickstart.mdx
create mode 100644 packages/twenty-docs/l/de/getting-started/core-concepts/ai.mdx
create mode 100644 packages/twenty-docs/l/de/getting-started/core-concepts/apps.mdx
create mode 100644 packages/twenty-docs/l/de/getting-started/core-concepts/calendar-and-email.mdx
create mode 100644 packages/twenty-docs/l/de/getting-started/core-concepts/dashboards.mdx
create mode 100644 packages/twenty-docs/l/de/getting-started/core-concepts/data-model.mdx
create mode 100644 packages/twenty-docs/l/de/getting-started/core-concepts/glossary.mdx
create mode 100644 packages/twenty-docs/l/de/getting-started/core-concepts/layout.mdx
create mode 100644 packages/twenty-docs/l/de/getting-started/core-concepts/workflows.mdx
create mode 100644 packages/twenty-docs/l/de/getting-started/introduction.mdx
create mode 100644 packages/twenty-docs/l/de/getting-started/key-features.mdx
create mode 100644 packages/twenty-docs/l/de/getting-started/quickstart.mdx
create mode 100644 packages/twenty-docs/l/es/getting-started/core-concepts/ai.mdx
create mode 100644 packages/twenty-docs/l/es/getting-started/core-concepts/apps.mdx
create mode 100644 packages/twenty-docs/l/es/getting-started/core-concepts/calendar-and-email.mdx
create mode 100644 packages/twenty-docs/l/es/getting-started/core-concepts/dashboards.mdx
create mode 100644 packages/twenty-docs/l/es/getting-started/core-concepts/data-model.mdx
create mode 100644 packages/twenty-docs/l/es/getting-started/core-concepts/glossary.mdx
create mode 100644 packages/twenty-docs/l/es/getting-started/core-concepts/layout.mdx
create mode 100644 packages/twenty-docs/l/es/getting-started/core-concepts/workflows.mdx
create mode 100644 packages/twenty-docs/l/es/getting-started/introduction.mdx
create mode 100644 packages/twenty-docs/l/es/getting-started/key-features.mdx
create mode 100644 packages/twenty-docs/l/es/getting-started/quickstart.mdx
create mode 100644 packages/twenty-docs/l/fr/getting-started/core-concepts/ai.mdx
create mode 100644 packages/twenty-docs/l/fr/getting-started/core-concepts/apps.mdx
create mode 100644 packages/twenty-docs/l/fr/getting-started/core-concepts/calendar-and-email.mdx
create mode 100644 packages/twenty-docs/l/fr/getting-started/core-concepts/dashboards.mdx
create mode 100644 packages/twenty-docs/l/fr/getting-started/core-concepts/data-model.mdx
create mode 100644 packages/twenty-docs/l/fr/getting-started/core-concepts/glossary.mdx
create mode 100644 packages/twenty-docs/l/fr/getting-started/core-concepts/layout.mdx
create mode 100644 packages/twenty-docs/l/fr/getting-started/core-concepts/workflows.mdx
create mode 100644 packages/twenty-docs/l/fr/getting-started/introduction.mdx
create mode 100644 packages/twenty-docs/l/fr/getting-started/key-features.mdx
create mode 100644 packages/twenty-docs/l/fr/getting-started/quickstart.mdx
create mode 100644 packages/twenty-docs/l/it/getting-started/core-concepts/ai.mdx
create mode 100644 packages/twenty-docs/l/it/getting-started/core-concepts/apps.mdx
create mode 100644 packages/twenty-docs/l/it/getting-started/core-concepts/calendar-and-email.mdx
create mode 100644 packages/twenty-docs/l/it/getting-started/core-concepts/dashboards.mdx
create mode 100644 packages/twenty-docs/l/it/getting-started/core-concepts/data-model.mdx
create mode 100644 packages/twenty-docs/l/it/getting-started/core-concepts/glossary.mdx
create mode 100644 packages/twenty-docs/l/it/getting-started/core-concepts/layout.mdx
create mode 100644 packages/twenty-docs/l/it/getting-started/core-concepts/workflows.mdx
create mode 100644 packages/twenty-docs/l/it/getting-started/introduction.mdx
create mode 100644 packages/twenty-docs/l/it/getting-started/key-features.mdx
create mode 100644 packages/twenty-docs/l/it/getting-started/quickstart.mdx
create mode 100644 packages/twenty-docs/l/ko/getting-started/core-concepts/ai.mdx
create mode 100644 packages/twenty-docs/l/ko/getting-started/core-concepts/apps.mdx
create mode 100644 packages/twenty-docs/l/ko/getting-started/core-concepts/calendar-and-email.mdx
create mode 100644 packages/twenty-docs/l/ko/getting-started/core-concepts/dashboards.mdx
create mode 100644 packages/twenty-docs/l/ko/getting-started/core-concepts/data-model.mdx
create mode 100644 packages/twenty-docs/l/ko/getting-started/core-concepts/glossary.mdx
create mode 100644 packages/twenty-docs/l/ko/getting-started/core-concepts/layout.mdx
create mode 100644 packages/twenty-docs/l/ko/getting-started/core-concepts/workflows.mdx
create mode 100644 packages/twenty-docs/l/ko/getting-started/introduction.mdx
create mode 100644 packages/twenty-docs/l/ko/getting-started/key-features.mdx
create mode 100644 packages/twenty-docs/l/ko/getting-started/quickstart.mdx
create mode 100644 packages/twenty-docs/l/pt/getting-started/core-concepts/ai.mdx
create mode 100644 packages/twenty-docs/l/pt/getting-started/core-concepts/apps.mdx
create mode 100644 packages/twenty-docs/l/pt/getting-started/core-concepts/calendar-and-email.mdx
create mode 100644 packages/twenty-docs/l/pt/getting-started/core-concepts/dashboards.mdx
create mode 100644 packages/twenty-docs/l/pt/getting-started/core-concepts/data-model.mdx
create mode 100644 packages/twenty-docs/l/pt/getting-started/core-concepts/glossary.mdx
create mode 100644 packages/twenty-docs/l/pt/getting-started/core-concepts/layout.mdx
create mode 100644 packages/twenty-docs/l/pt/getting-started/core-concepts/workflows.mdx
create mode 100644 packages/twenty-docs/l/pt/getting-started/introduction.mdx
create mode 100644 packages/twenty-docs/l/pt/getting-started/key-features.mdx
create mode 100644 packages/twenty-docs/l/pt/getting-started/quickstart.mdx
create mode 100644 packages/twenty-docs/l/ro/getting-started/core-concepts/ai.mdx
create mode 100644 packages/twenty-docs/l/ro/getting-started/core-concepts/apps.mdx
create mode 100644 packages/twenty-docs/l/ro/getting-started/core-concepts/calendar-and-email.mdx
create mode 100644 packages/twenty-docs/l/ro/getting-started/core-concepts/dashboards.mdx
create mode 100644 packages/twenty-docs/l/ro/getting-started/core-concepts/data-model.mdx
create mode 100644 packages/twenty-docs/l/ro/getting-started/core-concepts/glossary.mdx
create mode 100644 packages/twenty-docs/l/ro/getting-started/core-concepts/layout.mdx
create mode 100644 packages/twenty-docs/l/ro/getting-started/core-concepts/workflows.mdx
create mode 100644 packages/twenty-docs/l/ro/getting-started/introduction.mdx
create mode 100644 packages/twenty-docs/l/ro/getting-started/key-features.mdx
create mode 100644 packages/twenty-docs/l/ro/getting-started/quickstart.mdx
create mode 100644 packages/twenty-docs/l/ru/getting-started/core-concepts/ai.mdx
create mode 100644 packages/twenty-docs/l/ru/getting-started/core-concepts/apps.mdx
create mode 100644 packages/twenty-docs/l/ru/getting-started/core-concepts/calendar-and-email.mdx
create mode 100644 packages/twenty-docs/l/ru/getting-started/core-concepts/dashboards.mdx
create mode 100644 packages/twenty-docs/l/ru/getting-started/core-concepts/data-model.mdx
create mode 100644 packages/twenty-docs/l/ru/getting-started/core-concepts/glossary.mdx
create mode 100644 packages/twenty-docs/l/ru/getting-started/core-concepts/layout.mdx
create mode 100644 packages/twenty-docs/l/ru/getting-started/core-concepts/workflows.mdx
create mode 100644 packages/twenty-docs/l/ru/getting-started/introduction.mdx
create mode 100644 packages/twenty-docs/l/ru/getting-started/key-features.mdx
create mode 100644 packages/twenty-docs/l/ru/getting-started/quickstart.mdx
create mode 100644 packages/twenty-docs/l/tr/getting-started/core-concepts/ai.mdx
create mode 100644 packages/twenty-docs/l/tr/getting-started/core-concepts/apps.mdx
create mode 100644 packages/twenty-docs/l/tr/getting-started/core-concepts/calendar-and-email.mdx
create mode 100644 packages/twenty-docs/l/tr/getting-started/core-concepts/dashboards.mdx
create mode 100644 packages/twenty-docs/l/tr/getting-started/core-concepts/data-model.mdx
create mode 100644 packages/twenty-docs/l/tr/getting-started/core-concepts/glossary.mdx
create mode 100644 packages/twenty-docs/l/tr/getting-started/core-concepts/layout.mdx
create mode 100644 packages/twenty-docs/l/tr/getting-started/core-concepts/workflows.mdx
create mode 100644 packages/twenty-docs/l/tr/getting-started/introduction.mdx
create mode 100644 packages/twenty-docs/l/tr/getting-started/key-features.mdx
create mode 100644 packages/twenty-docs/l/tr/getting-started/quickstart.mdx
create mode 100644 packages/twenty-docs/l/zh/getting-started/core-concepts/ai.mdx
create mode 100644 packages/twenty-docs/l/zh/getting-started/core-concepts/apps.mdx
create mode 100644 packages/twenty-docs/l/zh/getting-started/core-concepts/calendar-and-email.mdx
create mode 100644 packages/twenty-docs/l/zh/getting-started/core-concepts/dashboards.mdx
create mode 100644 packages/twenty-docs/l/zh/getting-started/core-concepts/data-model.mdx
create mode 100644 packages/twenty-docs/l/zh/getting-started/core-concepts/glossary.mdx
create mode 100644 packages/twenty-docs/l/zh/getting-started/core-concepts/layout.mdx
create mode 100644 packages/twenty-docs/l/zh/getting-started/core-concepts/workflows.mdx
create mode 100644 packages/twenty-docs/l/zh/getting-started/introduction.mdx
create mode 100644 packages/twenty-docs/l/zh/getting-started/key-features.mdx
create mode 100644 packages/twenty-docs/l/zh/getting-started/quickstart.mdx
diff --git a/packages/twenty-docs/docs.json b/packages/twenty-docs/docs.json
index 22f79f2849..3aba25b7cf 100644
--- a/packages/twenty-docs/docs.json
+++ b/packages/twenty-docs/docs.json
@@ -468,6 +468,32 @@
{
"language": "fr",
"tabs": [
+ {
+ "tab": "Prise en main",
+ "groups": [
+ {
+ "group": "Bienvenue",
+ "pages": [
+ "l/fr/getting-started/introduction",
+ "l/fr/getting-started/key-features",
+ "l/fr/getting-started/quickstart"
+ ]
+ },
+ {
+ "group": "Concepts clés",
+ "pages": [
+ "l/fr/getting-started/core-concepts/data-model",
+ "l/fr/getting-started/core-concepts/layout",
+ "l/fr/getting-started/core-concepts/workflows",
+ "l/fr/getting-started/core-concepts/calendar-and-email",
+ "l/fr/getting-started/core-concepts/ai",
+ "l/fr/getting-started/core-concepts/apps",
+ "l/fr/getting-started/core-concepts/dashboards",
+ "l/fr/getting-started/core-concepts/glossary"
+ ]
+ }
+ ]
+ },
{
"tab": "Guide de l'utilisateur",
"groups": [
@@ -875,6 +901,32 @@
{
"language": "ar",
"tabs": [
+ {
+ "tab": "البدء",
+ "groups": [
+ {
+ "group": "مرحبًا",
+ "pages": [
+ "l/ar/getting-started/introduction",
+ "l/ar/getting-started/key-features",
+ "l/ar/getting-started/quickstart"
+ ]
+ },
+ {
+ "group": "المفاهيم الأساسية",
+ "pages": [
+ "l/ar/getting-started/core-concepts/data-model",
+ "l/ar/getting-started/core-concepts/layout",
+ "l/ar/getting-started/core-concepts/workflows",
+ "l/ar/getting-started/core-concepts/calendar-and-email",
+ "l/ar/getting-started/core-concepts/ai",
+ "l/ar/getting-started/core-concepts/apps",
+ "l/ar/getting-started/core-concepts/dashboards",
+ "l/ar/getting-started/core-concepts/glossary"
+ ]
+ }
+ ]
+ },
{
"tab": "دليل المستخدم",
"groups": [
@@ -1282,6 +1334,32 @@
{
"language": "cs",
"tabs": [
+ {
+ "tab": "Začínáme",
+ "groups": [
+ {
+ "group": "Vítejte",
+ "pages": [
+ "l/cs/getting-started/introduction",
+ "l/cs/getting-started/key-features",
+ "l/cs/getting-started/quickstart"
+ ]
+ },
+ {
+ "group": "Základní pojmy",
+ "pages": [
+ "l/cs/getting-started/core-concepts/data-model",
+ "l/cs/getting-started/core-concepts/layout",
+ "l/cs/getting-started/core-concepts/workflows",
+ "l/cs/getting-started/core-concepts/calendar-and-email",
+ "l/cs/getting-started/core-concepts/ai",
+ "l/cs/getting-started/core-concepts/apps",
+ "l/cs/getting-started/core-concepts/dashboards",
+ "l/cs/getting-started/core-concepts/glossary"
+ ]
+ }
+ ]
+ },
{
"tab": "Uživatelská příručka",
"groups": [
@@ -1689,6 +1767,32 @@
{
"language": "de",
"tabs": [
+ {
+ "tab": "Erste Schritte",
+ "groups": [
+ {
+ "group": "Willkommen",
+ "pages": [
+ "l/de/getting-started/introduction",
+ "l/de/getting-started/key-features",
+ "l/de/getting-started/quickstart"
+ ]
+ },
+ {
+ "group": "Kernkonzepte",
+ "pages": [
+ "l/de/getting-started/core-concepts/data-model",
+ "l/de/getting-started/core-concepts/layout",
+ "l/de/getting-started/core-concepts/workflows",
+ "l/de/getting-started/core-concepts/calendar-and-email",
+ "l/de/getting-started/core-concepts/ai",
+ "l/de/getting-started/core-concepts/apps",
+ "l/de/getting-started/core-concepts/dashboards",
+ "l/de/getting-started/core-concepts/glossary"
+ ]
+ }
+ ]
+ },
{
"tab": "Benutzerhandbuch",
"groups": [
@@ -2096,6 +2200,32 @@
{
"language": "es",
"tabs": [
+ {
+ "tab": "Primeros pasos",
+ "groups": [
+ {
+ "group": "Bienvenido",
+ "pages": [
+ "l/es/getting-started/introduction",
+ "l/es/getting-started/key-features",
+ "l/es/getting-started/quickstart"
+ ]
+ },
+ {
+ "group": "Conceptos clave",
+ "pages": [
+ "l/es/getting-started/core-concepts/data-model",
+ "l/es/getting-started/core-concepts/layout",
+ "l/es/getting-started/core-concepts/workflows",
+ "l/es/getting-started/core-concepts/calendar-and-email",
+ "l/es/getting-started/core-concepts/ai",
+ "l/es/getting-started/core-concepts/apps",
+ "l/es/getting-started/core-concepts/dashboards",
+ "l/es/getting-started/core-concepts/glossary"
+ ]
+ }
+ ]
+ },
{
"tab": "Guía de usuario",
"groups": [
@@ -2503,6 +2633,32 @@
{
"language": "it",
"tabs": [
+ {
+ "tab": "Per iniziare",
+ "groups": [
+ {
+ "group": "Benvenuto",
+ "pages": [
+ "l/it/getting-started/introduction",
+ "l/it/getting-started/key-features",
+ "l/it/getting-started/quickstart"
+ ]
+ },
+ {
+ "group": "Concetti chiave",
+ "pages": [
+ "l/it/getting-started/core-concepts/data-model",
+ "l/it/getting-started/core-concepts/layout",
+ "l/it/getting-started/core-concepts/workflows",
+ "l/it/getting-started/core-concepts/calendar-and-email",
+ "l/it/getting-started/core-concepts/ai",
+ "l/it/getting-started/core-concepts/apps",
+ "l/it/getting-started/core-concepts/dashboards",
+ "l/it/getting-started/core-concepts/glossary"
+ ]
+ }
+ ]
+ },
{
"tab": "Guida utente",
"groups": [
@@ -3238,6 +3394,32 @@
{
"language": "ko",
"tabs": [
+ {
+ "tab": "시작하기",
+ "groups": [
+ {
+ "group": "환영합니다",
+ "pages": [
+ "l/ko/getting-started/introduction",
+ "l/ko/getting-started/key-features",
+ "l/ko/getting-started/quickstart"
+ ]
+ },
+ {
+ "group": "핵심 개념",
+ "pages": [
+ "l/ko/getting-started/core-concepts/data-model",
+ "l/ko/getting-started/core-concepts/layout",
+ "l/ko/getting-started/core-concepts/workflows",
+ "l/ko/getting-started/core-concepts/calendar-and-email",
+ "l/ko/getting-started/core-concepts/ai",
+ "l/ko/getting-started/core-concepts/apps",
+ "l/ko/getting-started/core-concepts/dashboards",
+ "l/ko/getting-started/core-concepts/glossary"
+ ]
+ }
+ ]
+ },
{
"tab": "사용자 안내서",
"groups": [
@@ -3645,6 +3827,32 @@
{
"language": "pt",
"tabs": [
+ {
+ "tab": "Primeiros passos",
+ "groups": [
+ {
+ "group": "Boas-vindas",
+ "pages": [
+ "l/pt/getting-started/introduction",
+ "l/pt/getting-started/key-features",
+ "l/pt/getting-started/quickstart"
+ ]
+ },
+ {
+ "group": "Conceitos essenciais",
+ "pages": [
+ "l/pt/getting-started/core-concepts/data-model",
+ "l/pt/getting-started/core-concepts/layout",
+ "l/pt/getting-started/core-concepts/workflows",
+ "l/pt/getting-started/core-concepts/calendar-and-email",
+ "l/pt/getting-started/core-concepts/ai",
+ "l/pt/getting-started/core-concepts/apps",
+ "l/pt/getting-started/core-concepts/dashboards",
+ "l/pt/getting-started/core-concepts/glossary"
+ ]
+ }
+ ]
+ },
{
"tab": "User Guide",
"groups": [
@@ -4052,6 +4260,32 @@
{
"language": "ro",
"tabs": [
+ {
+ "tab": "Începeți",
+ "groups": [
+ {
+ "group": "Bun venit",
+ "pages": [
+ "l/ro/getting-started/introduction",
+ "l/ro/getting-started/key-features",
+ "l/ro/getting-started/quickstart"
+ ]
+ },
+ {
+ "group": "Concepte cheie",
+ "pages": [
+ "l/ro/getting-started/core-concepts/data-model",
+ "l/ro/getting-started/core-concepts/layout",
+ "l/ro/getting-started/core-concepts/workflows",
+ "l/ro/getting-started/core-concepts/calendar-and-email",
+ "l/ro/getting-started/core-concepts/ai",
+ "l/ro/getting-started/core-concepts/apps",
+ "l/ro/getting-started/core-concepts/dashboards",
+ "l/ro/getting-started/core-concepts/glossary"
+ ]
+ }
+ ]
+ },
{
"tab": "User Guide",
"groups": [
@@ -4459,6 +4693,32 @@
{
"language": "ru",
"tabs": [
+ {
+ "tab": "Начало работы",
+ "groups": [
+ {
+ "group": "Добро пожаловать",
+ "pages": [
+ "l/ru/getting-started/introduction",
+ "l/ru/getting-started/key-features",
+ "l/ru/getting-started/quickstart"
+ ]
+ },
+ {
+ "group": "Основные понятия",
+ "pages": [
+ "l/ru/getting-started/core-concepts/data-model",
+ "l/ru/getting-started/core-concepts/layout",
+ "l/ru/getting-started/core-concepts/workflows",
+ "l/ru/getting-started/core-concepts/calendar-and-email",
+ "l/ru/getting-started/core-concepts/ai",
+ "l/ru/getting-started/core-concepts/apps",
+ "l/ru/getting-started/core-concepts/dashboards",
+ "l/ru/getting-started/core-concepts/glossary"
+ ]
+ }
+ ]
+ },
{
"tab": "Руководство пользователя",
"groups": [
@@ -4866,6 +5126,32 @@
{
"language": "tr",
"tabs": [
+ {
+ "tab": "Başlarken",
+ "groups": [
+ {
+ "group": "Hoş geldiniz",
+ "pages": [
+ "l/tr/getting-started/introduction",
+ "l/tr/getting-started/key-features",
+ "l/tr/getting-started/quickstart"
+ ]
+ },
+ {
+ "group": "Temel Kavramlar",
+ "pages": [
+ "l/tr/getting-started/core-concepts/data-model",
+ "l/tr/getting-started/core-concepts/layout",
+ "l/tr/getting-started/core-concepts/workflows",
+ "l/tr/getting-started/core-concepts/calendar-and-email",
+ "l/tr/getting-started/core-concepts/ai",
+ "l/tr/getting-started/core-concepts/apps",
+ "l/tr/getting-started/core-concepts/dashboards",
+ "l/tr/getting-started/core-concepts/glossary"
+ ]
+ }
+ ]
+ },
{
"tab": "Kullanıcı Rehberi",
"groups": [
@@ -5273,6 +5559,32 @@
{
"language": "zh",
"tabs": [
+ {
+ "tab": "开始使用",
+ "groups": [
+ {
+ "group": "欢迎",
+ "pages": [
+ "l/zh/getting-started/introduction",
+ "l/zh/getting-started/key-features",
+ "l/zh/getting-started/quickstart"
+ ]
+ },
+ {
+ "group": "核心概念",
+ "pages": [
+ "l/zh/getting-started/core-concepts/data-model",
+ "l/zh/getting-started/core-concepts/layout",
+ "l/zh/getting-started/core-concepts/workflows",
+ "l/zh/getting-started/core-concepts/calendar-and-email",
+ "l/zh/getting-started/core-concepts/ai",
+ "l/zh/getting-started/core-concepts/apps",
+ "l/zh/getting-started/core-concepts/dashboards",
+ "l/zh/getting-started/core-concepts/glossary"
+ ]
+ }
+ ]
+ },
{
"tab": "用户指南",
"groups": [
diff --git a/packages/twenty-docs/l/ar/getting-started/core-concepts/ai.mdx b/packages/twenty-docs/l/ar/getting-started/core-concepts/ai.mdx
new file mode 100644
index 0000000000..80c485b914
--- /dev/null
+++ b/packages/twenty-docs/l/ar/getting-started/core-concepts/ai.mdx
@@ -0,0 +1,34 @@
+---
+title: الذكاء الاصطناعي
+description: كيف يستخدم Twenty الذكاء الاصطناعي لتحسين تجربة الـ CRM لديك.
+icon: robot
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+يقوم Twenty بدمج الذكاء الاصطناعي مباشرة في نظام الـ CRM الخاص بك — ليس كحيلة دعائية، بل كأداة تعمل ضمن نموذج البيانات لديك ونظام الصلاحيات لديك.
+
+## روبوت محادثة بالذكاء الاصطناعي
+
+اطرح أسئلة حول بياناتك باللغة الطبيعية. يمكن لروبوت المحادثة بالذكاء الاصطناعي الاستعلام عن سجلات الـ CRM لديك، وتلخيص المعلومات، ومساعدتك في العثور على ما تبحث عنه دون إنشاء عوامل تصفية معقدة.
+
+
+
+## وكلاء الذكاء الاصطناعي
+
+وكلاء الذكاء الاصطناعي يتجاوزون حدود المحادثة — بإمكانهم تنفيذ مهام متعددة الخطوات بشكل مستقل:
+
+* إثراء السجلات ببيانات من مصادر خارجية
+* صياغة رسائل المتابعة وإرسالها
+* تحليل صحة مسار المبيعات ووضع علامات على الصفقات المعرّضة للخطر
+* معالجة البيانات الواردة وتوجيهها إلى الفريق المناسب
+
+يعمل الوكلاء ضمن تدفقات العمل الحالية لديك، بحيث يمكنك الجمع بين الذكاء الاصطناعي والموافقات اليدوية، والمنطق الشرطي، واستدعاءات واجهات برمجة التطبيقات الخارجية.
+
+## الصلاحيات والسلامة
+
+يحترم الذكاء الاصطناعي في Twenty نموذج الصلاحيات لديك. يمكن للوكلاء الوصول فقط إلى الكائنات والحقول التي يمتلك المستخدم (أو الدور) صلاحية عرضها. تظل البيانات الحساسة محمية حتى عندما يكون الذكاء الاصطناعي مُستخدمًا.
+
+
+ مرجع تفصيلي حول روبوت المحادثة، والوكلاء، وضوابط الصلاحيات.
+
diff --git a/packages/twenty-docs/l/ar/getting-started/core-concepts/apps.mdx b/packages/twenty-docs/l/ar/getting-started/core-concepts/apps.mdx
new file mode 100644
index 0000000000..034cd293ea
--- /dev/null
+++ b/packages/twenty-docs/l/ar/getting-started/core-concepts/apps.mdx
@@ -0,0 +1,41 @@
+---
+title: التطبيقات
+icon: cube
+description: وسّع Twenty باستخدام التعليمات البرمجية — كائنات مخصصة، ومنطق على جانب الخادم، ومكونات واجهة المستخدم، ووكلاء الذكاء الاصطناعي، جميعها كحزم TypeScript.
+---
+
+توفر معظم أدوات إدارة علاقات العملاء (CRM) لك لوحة إعدادات. تمنحك Twenty منصة. التطبيقات هي الطريقة التي يمكّن بها المطوّرون Twenty من تجاوز ما توفره واجهة المستخدم — من خلال تعريف نماذج البيانات، ومنطق جانب الخادم، ومكونات واجهة المستخدم، وإمكانات الذكاء الاصطناعي كتعليمات برمجية، ثم نشرها في مساحة عمل واحدة أو أكثر.
+
+## لماذا توجد التطبيقات
+
+تغطي عمليات سير العمل الأتمتة بدون كود. ولكن بعض الأمور تحتاج إلى كود: محرّك تسعير مخصص، وخط تجميع إثراء مملوك، واختبار امتثال يُشغَّل عند كل تحديث للسجل، ولوحة واجهة مستخدم مخصصة تسحب البيانات من أداة داخلية.
+
+تمكّنك التطبيقات من إنشاء هذه كامتدادات من الدرجة الأولى — ليست نصوصًا هشة تتحدّث إلى واجهة برمجة تطبيقات من الخارج، بل تعليمات برمجية تعمل على المنصة مع وصول كامل إلى نظام الأنواع، ونموذج الأذونات، وواجهة المستخدم.
+
+## ما الذي يمكن للتطبيق أن يعرِّفه
+
+التطبيق هو حزمة TypeScript تُصرِّح عن **كيانات** باستخدام `twenty-sdk`:
+
+| كيان | ماذا يفعل |
+| ---------------------- | ----------------------------------------------------------------------------------------------- |
+| **الكائنات والحقول** | جداول بيانات جديدة وحقول للكائنات الموجودة — تُعامَل بالطريقة نفسها مثل المضمنة افتراضيًا |
+| **الوظائف المنطقية** | TypeScript على جانب الخادم يتم تشغيله عبر مسارات HTTP، أو جداول cron، أو أحداث قاعدة البيانات |
+| **المكوّنات الأمامية** | مكوّنات React معزولة تُعرَض داخل واجهة مستخدم Twenty (اللوحة الجانبية، الودجات، قائمة الأوامر). |
+| **المهارات والوكلاء** | قدرات الذكاء الاصطناعي — تعليمات قابلة لإعادة الاستخدام ومساعدون مستقلون ذاتيًا |
+| **طرق العرض والتنقّل** | طرق عرض قوائم مُعدّة مسبقًا وعناصر قائمة الشريط الجانبي |
+
+يتم اكتشاف كل شيء عبر تحليل AST وقت البناء — بدون ملفات إعداد وبدون روتين تسجيل متكرِّر. ضع `export default defineObject(...)` في أي ملف `.ts` وسيلتقطه الـ SDK.
+
+## كيفية عملها
+
+* **الدوال المنطقية** تُنفَّذ في عمليات Node.js معزولة، ومحمية عن المضيف. تصل إلى البيانات من خلال عميل API مضبوط الأنواع، ومقيَّد بأذونات دور التطبيق.
+* **المكوّنات الأمامية** تعمل ضمن Web Workers باستخدام Remote DOM — معزولة عن الصفحة الرئيسية لكنها تعرض عناصر DOM الأصلية (وليس iframes).
+* **الأذونات** تُطبَّق على مستوى واجهة API. لا يرى التطبيق إلا ما يسمح به دوره.
+
+## تجربة المطوّر
+
+تكتب تطبيقك كمشروع TypeScript على جهازك. تراقب أداة CLI ملفات المصدر لديك وتزامنها مباشرة مع خادم Twenty شغّال — عدِّل ملفًا لترى التغيير في واجهة المستخدم خلال ثانية واحدة. يُعاد توليد عميل API مضبوط الأنواع تلقائيًا عند تغيّر المخطط. عندما تكون مستعدًا، يقوم `yarn twenty app:publish --private` بالدفع إلى خادم إنتاج، أو يقوم `yarn twenty app:publish` بإدراج تطبيقك على npm وسوق Twenty.
+
+
+ دليل إرشادي من ثلاث مراحل — الإنشاء الأوّلي، تشغيل خادم محلّي، ومزامنة تغييراتك.
+
diff --git a/packages/twenty-docs/l/ar/getting-started/core-concepts/calendar-and-email.mdx b/packages/twenty-docs/l/ar/getting-started/core-concepts/calendar-and-email.mdx
new file mode 100644
index 0000000000..e73beca7bb
--- /dev/null
+++ b/packages/twenty-docs/l/ar/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 في سير العمل** | استدعِ أي واجهة برمجة تطبيقات خارجية كجزء من سير عمل مؤتمت |
+
+## تطبيقات مخصّصة
+
+يمكن للمطورين إنشاء تطبيقات متكاملة الإمكانات فوق Twenty — لإضافة واجهات مستخدم مخصّصة ومنطق على جانب الخادم وعمليات تكامل عميقة. يمكن نشر التطبيقات للمجتمع أو إبقاؤها خاصة.
+
+
+
+ إعداد مزامنة البريد الإلكتروني، ومزامنة التقويم، وحل المشكلات.
+
+
+ أنشئ عمليات تكامل مخصّصة باستخدام واجهة برمجة تطبيقات Twenty.
+
+
diff --git a/packages/twenty-docs/l/ar/getting-started/core-concepts/dashboards.mdx b/packages/twenty-docs/l/ar/getting-started/core-concepts/dashboards.mdx
new file mode 100644
index 0000000000..862a959130
--- /dev/null
+++ b/packages/twenty-docs/l/ar/getting-started/core-concepts/dashboards.mdx
@@ -0,0 +1,37 @@
+---
+title: لوحات القيادة
+description: تتبّع الأداء وقم بعرض بيانات CRM الخاصة بك بصريًا باستخدام لوحات معلومات مخصصة.
+icon: chart-bar
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+تمنحك لوحات المعلومات رؤية فورية في مؤشرات أداء عملك — صحة مسار المبيعات، أداء الفريق، اتجاهات الإيرادات، وأي شيء آخر تريد تتبّعه.
+
+
+
+## الأدوات
+
+تتكوّن كل لوحة معلومات من عناصر واجهة مستخدم. عنصر واجهة المستخدم هو مخطط واحد أو مقياس واحد مرتبط ببيانات CRM الخاصة بك. يمكنك تكوين:
+
+* **نوع المخطط** — شريطي، خطي، دائري، رقمي، وغير ذلك
+* **مصدر البيانات** — أي كيان في نموذج البيانات لديك (قياسي أو مخصص)
+* **عوامل التصفية** — تضييق النتائج إلى سجلات أو نطاقات زمنية أو شرائح محددة
+* **التجميع** — العد، المجموع، المتوسط، الحد الأدنى، الحد الأقصى لأي حقل رقمي
+* **التجميع حسب** — التفصيل حسب حقول محددة أو تواريخ أو علاقات
+
+## ما الذي يمكنك تتبّعه
+
+* قيمة مسار المبيعات حسب المرحلة
+* الصفقات المُغلقة عبر الزمن
+* متوسط حجم الصفقة حسب المصدر
+* معدلات إكمال المهام
+* مقاييس مخصصة على أي كيان
+
+## المشاركة
+
+لوحات المعلومات على مستوى مساحة العمل — يمكن للجميع في فريقك رؤيتها. رتّب عناصر واجهة المستخدم في تخطيط شبكي وقم بتغيير حجمها لإنشاء العرض الذي يناسب فريقك.
+
+
+ مرجع تفصيلي حول إنشاء لوحات المعلومات، وتكوين عناصر واجهة المستخدم، وإعدادات المخططات.
+
diff --git a/packages/twenty-docs/l/ar/getting-started/core-concepts/data-model.mdx b/packages/twenty-docs/l/ar/getting-started/core-concepts/data-model.mdx
new file mode 100644
index 0000000000..951acea2db
--- /dev/null
+++ b/packages/twenty-docs/l/ar/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 مجموعة واسعة من أنواع الحقول:
+
+| الفئة | الأنواع |
+| ---------- | --------------------------------------------------------------------------------------------------------- |
+| **أساسية** | نص، رقم، منطقي (Boolean)، تاريخ، عملة، تقييم، اختيار |
+| **مركّبة** | عنوان (الشارع، المدينة، الولاية، الرمز البريدي)، الاسم الكامل، الروابط، الهواتف، عناوين البريد الإلكتروني |
+| **خاصة** | علاقة، مرفق ملف، JSON، الفاعل (من قام بالإنشاء/التعديل) |
+
+يحصل كل كائن أيضًا على حقول نظام تلقائية: `id`، `createdAt`، `updatedAt`، `createdBy`، و`position`.
+
+## العلاقات
+
+تتصل الكائنات ببعضها البعض من خلال العلاقات. لدى الشركة العديد من الأشخاص، وتنتمي الفرصة إلى شركة، وهكذا. يمكنك إنشاء علاقات مخصّصة بين أي كائنات، بما في ذلك العلاقات من نوع متعدد إلى متعدد.
+
+## ما الذي يجعل هذا قويًا
+
+على عكس أنظمة إدارة علاقات العملاء (CRM) التقليدية حيث تكون مقيّدًا بحقول محددة مسبقًا على كائنات محددة مسبقًا، يتيح لك Twenty نمذجة بياناتك بالطريقة نفسها التي يعمل بها نشاطك التجاري بالضبط. تحصل الكائنات المخصّصة على نفس المعاملة من الدرجة الأولى مثل الكائنات المضمّنة — بما في ذلك نقاط نهاية واجهة برمجة التطبيقات (API endpoints)، وطرق العرض، والأذونات، ومشغلات سير العمل.
+
+
+ مرجع كامل للكائنات والحقول والعلاقات وكيفية تهيئتها.
+
+
+
diff --git a/packages/twenty-docs/l/ar/getting-started/core-concepts/glossary.mdx b/packages/twenty-docs/l/ar/getting-started/core-concepts/glossary.mdx
new file mode 100644
index 0000000000..3791336b67
--- /dev/null
+++ b/packages/twenty-docs/l/ar/getting-started/core-concepts/glossary.mdx
@@ -0,0 +1,105 @@
+---
+title: مسرد المصطلحات
+icon: كتاب
+description: المصطلحات الأساسية المستخدمة في Twenty.
+---
+
+## واجهة برمجة التطبيقات
+
+واجهة برمجة التطبيقات (API) تتيح لك ربط Twenty بأنظمة برمجية أخرى وبناء تكاملات مخصصة.
+
+## التطبيقات
+
+التطبيقات هي امتدادات مخصّصة مُنشأة على شكل شيفرة يمكنها تعريف نماذج البيانات والوظائف المنطقية. تمكّن المطورين من إنشاء تخصيصات قابلة لإعادة الاستخدام يمكن نشرها عبر مساحات عمل متعددة.
+
+## إجراءات الكود
+
+إجراءات الكود هي خطوات في سير العمل تتيح لك كتابة شيفرة JavaScript مخصصة لتحويل البيانات أو إجراء حسابات أو تنفيذ منطق معقد غير ممكن بالإجراءات المضمنة.
+
+## قائمة الأوامر
+
+قائمة الأوامر هي واجهة وصول سريع (تُفتح باستخدام `Cmd + K` على Mac و `Ctrl + K` على Windows) تتيح لك تنفيذ الإجراءات وإنشاء السجلات والتنقل بكفاءة في مساحة العمل الخاصة بك.
+
+## الشركات والأشخاص
+
+يتضمن نظام إدارة علاقات العملاء نوعين أساسيين من السجلات:
+
+* تمثل `الشركة` عملاً تجارياً أو منظمة.
+* `People` تمثل العملاء الحاليين والمحتملين لشركتك.
+
+## الحقول المخصصة
+
+الحقول المخصصة هي حقول بيانات تُنشئها لالتقاط معلومات خاصة باحتياجات وعمليات عملك.
+
+## نموذج البيانات
+
+نموذج البيانات هو الهيكل الذي يحدد كيفية تنظيم المعلومات في نظام إدارة علاقات العملاء الخاص بك، بما في ذلك الكائنات الموجودة وخصائصها وعلاقاتها معًا.
+
+## المفضلات
+
+المفضلات هي السجلات التي قمت بتحديدها للوصول السريع، وتظهر في الشريط الجانبي للتنقل الفوري للبيانات الهامة.
+
+## الحقل
+
+الحقل يشير إلى منطقة معينة يتم فيها تخزين بيانات محددة لكيان معين.
+
+## مكرر
+
+المكرر هو إجراء في سير العمل يتكرر عبر مصفوفة من العناصر، وينفذ الإجراءات اللاحقة لكل عنصر في القائمة.
+
+## كانبان
+
+الـ`كانبان` هو طريقة بصرية لمتابعة عمليات الأعمال باستخدام البطاقات والأعمدة. يمثّل كل عمود مرحلة في عمليتك (مثل: جديد، جارٍ، ربح، خسارة)، وتحرّك السجلات عبر هذه المراحل مع تقدّمها.
+
+## كائن
+
+الكائن هو هيكل بيانات يمثل نوعاً معيناً من الكيانات في نظام إدارة علاقات العملاء الخاص بك (مثل الأشخاص أو الشركات أو الفرص). يمكن أن تكون الكائنات قياسية (مدمجة) أو مخصصة (تم إنشاؤها بواسطتك).
+
+## الفرص
+
+الفرص في نظام Twenty لإدارة علاقات العملاء هي صفقات أو مبيعات محتملة مع الحسابات أو جهات الاتصال.
+
+## السجل
+
+السجل يشير إلى مثيل لكائن، مثل حساب معين أو جهة اتصال.
+
+## حقول العلاقات
+
+تُنشئ حقول العلاقات الروابط بين الكائنات المختلفة، مما يتيح لك ربط السجلات معًا (مثل ربط شخص بشركة).
+
+## الحقول القياسية
+
+الحقول القياسية هي حقول بيانات مدمجة تأتي مع الكائنات بشكل افتراضي وتوفر وظائف شائعة في جميع مساحات العمل.
+
+## المهام
+
+المهام في Twenty CRM هي أنشطة مُسندة تتعلق بجهات اتصال أو حسابات أو فرص.
+
+## المشغلات
+
+المشغلات هي نقطة البداية في سير العمل — الحدث أو الشرط الذي يبدأ الأتمتة. تشمل الأمثلة إنشاء السجلات، وتحديث السجلات، وخطافات الويب، أو الأوقات المجدولة.
+
+## العروض
+
+يمكنك تخصيص عرض سجلاتك باستخدام العروض، وتعيين عوامل تصفية مختلفة وتخطيطات وخيارات فرز لكل عرض.
+
+## Upsert
+
+Upsert هي عملية تجمع بين "update" و"insert" — فهي تحدّث سجلاً موجوداً إذا تم العثور على تطابق، أو تنشئ سجلاً جديداً إذا لم يوجد تطابق.
+
+## خطافات الويب
+
+الويب هوكس هي رسائل آلية ترسل من Twenty إلى تطبيقات أخرى عند حدوث أحداث معينة، مما يتيح مزامنة البيانات في الوقت الفعلي.
+
+## سير العمل
+
+مسارات العمل هي عمليات مؤتمتة تطلق إجراءات بناءً على شروط محددة، مما يساعدك على أتمتة المهام المتكررة والعمليات التجارية.
+
+## مساحة العمل
+
+`مساحة العمل` تمثل عادةً شركة تستخدم Twenty. تحتوي على جميع السجلات والبيانات التي تدخلها أنت وأعضاء فريقك إلى Twenty.
+لها اسم نطاق واحد، وهو عادةً الاسم الذي تستخدمه شركتك لعناوين البريد الإلكتروني للموظفين.
+
+## أعضاء مساحة العمل
+
+أعضاء مساحة العمل هم مستخدمو Twenty من فريقك الذين لديهم حق الوصول إلى مساحة العمل الخاصة بك. يمكن تعيينهم كمالكين أو معينين للسجلات.
diff --git a/packages/twenty-docs/l/ar/getting-started/core-concepts/layout.mdx b/packages/twenty-docs/l/ar/getting-started/core-concepts/layout.mdx
new file mode 100644
index 0000000000..2a3876a4b9
--- /dev/null
+++ b/packages/twenty-docs/l/ar/getting-started/core-concepts/layout.mdx
@@ -0,0 +1,74 @@
+---
+title: التخطيط
+description: كيفية التنقل والتصفح وعرض السجلات في Twenty.
+icon: table-columns
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+## التصميم الرئيسي
+
+مركز الشاشة هو المكان الذي تتواجد فيه سجلاتك — الأشخاص، الشركات، الفرص، المهام، الملاحظات، لوحات المعلومات، سير العمل، وأي كائنات مخصّصة. يمكنك هنا عرض السجلات وتحريرها وحذفها، وإنشاء عروض جديدة.
+
+
+
+## شريط التنقل
+
+يوفر لك الشريط الجانبي الأيسر:
+
+* **مبدّل مساحة العمل** — التبديل بين مساحات العمل أو إنشاء مساحة جديدة (القائمة المنسدلة العلوية)
+* **البحث** — اضغط على `/` للتركيز فورًا، يجري البحث عبر جميع الكائنات
+* **الإعدادات** — الوصول إليها من الأعلى يسارًا
+* **المفضّلات** — عروض مثبّتة، فريدة لكل مستخدم
+* **اختصارات الكائنات** — وصول سريع إلى الأشخاص والشركات والفرص، إلخ.
+* **Workflows** — إنشاء أتمتة
+
+اسحب العناصر لإعادة ترتيبها، وأنشئ مجلدات لتجميع الكائنات ذات الصلة، وأخفِ ما لا تستخدمه.
+
+
+
+## قائمة الأوامر
+
+اضغط على `Cmd+K` (Mac) أو `Ctrl+K` (Windows) — أو انقر على النقاط الثلاث في الأعلى يمينًا. من هنا يمكنك:
+
+* إنشاء سجلات جديدة
+* استيراد وتصدير البيانات عبر CSV
+* إنشاء عروض جديدة
+* الوصول إلى السجلات المحذوفة (يدعم Twenty عمليات الحذف المنطقي والدائم)
+* عرض اختصارات لوحة المفاتيح للتنقل في مساحة العمل الخاصة بك
+
+
+
+## بحث
+
+يمكن الوصول إليه عبر قائمة الأوامر، ومن أعلى شريط التنقل، أو بالضغط على `/`. يعمل البحث عبر جميع الكائنات.
+
+
+
+## اللوحة الجانبية
+
+انقر على سجل لفتح اللوحة الجانبية على اليمين — نظرة سريعة على المعلومات الرئيسية للسجل بدون مغادرة الصفحة الحالية. انقر على **Open** للانتقال إلى صفحة السجل الكاملة.
+
+
+
+## العروض
+
+يدعم كل كائن عروضًا متعددة — بدون حد لكل كائن. استخدم القائمة المنسدلة في الأعلى يسارًا للتبديل بينها.
+
+* **الجدول** — صفوف وأعمدة بأسلوب جداول البيانات، مع التجميع والتحرير المضمَّن وتخصيص الأعمدة
+* **كانبان** — بطاقات يمكن سحبها وإفلاتها منظَّمة حسب حقل محدد، مثالية لمسارات العمل
+* **التقويم** — سجلات موزَّعة حسب حقل تاريخ للتخطيط القائم على الوقت
+
+يحفظ كل عرض عوامل التصفية والفرز وظهور الحقول الخاصة به. شارك العروض مع مساحة العمل الخاصة بك أو احتفظ بها خاصة. اجعل العروض مفضّلة للوصول السريع من الشريط الجانبي.
+
+
+
+## صفحات السجل
+
+عند فتح سجل، تتكوّن صفحة التفاصيل من **علامات تبويب** و**عناصر واجهة** قابلة للتهيئة. أضف عناصر الواجهة واحذفها وأعد ترتيبها وغيّر حجمها ضمن شبكة — الحقول، السجلات ذات الصلة، رسائل البريد الإلكتروني، الخط الزمني، المهام، الملاحظات، الملفات، الرسوم البيانية، iframes، وغير ذلك. لكل نوع كائن تصميمه الخاص.
+
+
+ التنقل والعروض وصفحات السجلات — مرجع تفصيلي وأدلة كيفية التنفيذ.
+
+
+
diff --git a/packages/twenty-docs/l/ar/getting-started/core-concepts/workflows.mdx b/packages/twenty-docs/l/ar/getting-started/core-concepts/workflows.mdx
new file mode 100644
index 0000000000..5cd0fb3e45
--- /dev/null
+++ b/packages/twenty-docs/l/ar/getting-started/core-concepts/workflows.mdx
@@ -0,0 +1,55 @@
+---
+title: سير العمل
+description: قم بأتمتة عمليات عملك باستخدام أداة إنشاء سير العمل المرئية في Twenty.
+icon: bolt
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+تسمح لك سير العمل بأتمتة المهام المتكررة وربط Twenty بأدوات خارجية — دون كتابة كود (مع أنه يمكنك ذلك إذا أردت).
+
+
+
+## كيف تعمل سير العمل
+
+كل سير عمل يتكون من ثلاثة أجزاء:
+
+1. **المشغل (Trigger)** — ما يبدأ سير العمل
+2. **الخطوات (Steps)** — ما يحدث لاحقًا (إجراء واحد أو أكثر بالتسلسل)
+3. **المتغيرات (Variables)** — البيانات التي تتدفق بين الخطوات
+
+## المشغلات
+
+| المشغّل | متى يتم تشغيله |
+| ---------------------------- | ------------------------------------------------------------------------------- |
+| **حدث السجل (Record event)** | يتم إنشاء سجل أو تحديثه أو حذفه أو إجراء upsert له |
+| **يدوي** | ينقر المستخدم على زر (على سجل واحد أو سجلات متعددة أو على مستوى النظام بالكامل) |
+| **الجدولة (Schedule)** | على فاصل زمني متكرر (بصيغة cron) |
+| **الويب هوك** | نظام خارجي يرسل طلب HTTP POST |
+
+## الإجراءات
+
+يمكن لسير العمل ربط أي مجموعة من العناصر التالية:
+
+* **عمليات السجل (Record operations)** — إنشاء السجلات أو تحديثها أو البحث عنها أو حذفها أو إجراء upsert لها
+* **إرسال بريد إلكتروني (Send email)** — إرسال رسائل البريد الإلكتروني أو إعداد مسودات منها من الحسابات المتصلة
+* **طلب HTTP (HTTP request)** — استدعاء أي واجهة برمجة تطبيقات خارجية
+* **الكود (Code)** — تشغيل JavaScript مخصص من أجل منطق معقد
+* **التفرعات (Branches)** — شروط If/else لتقسيم مسار سير العمل
+* **Iterator** — التكرار عبر المصفوفات من البيانات
+* **وكيل ذكاء اصطناعي (AI Agent)** — تمكين وكيل ذكاء اصطناعي من معالجة البيانات بشكل مستقل
+* **التأخير (Delay)** — الانتظار قبل المتابعة
+* **النموذج (Form)** — جمع مدخلات المستخدم في منتصف سير العمل
+
+## ما الذي يمكنك بناؤه
+
+* إرسال تنبيهات Slack عند وصول صفقة إلى مرحلة معينة
+* إثراء جهات الاتصال الجديدة تلقائيًا ببيانات من واجهات برمجة تطبيقات خارجية
+* اكتشاف الفرص الراكدة وإخطار المالك
+* مزامنة البيانات بين Twenty ونظام الفوترة لديك
+* إنشاء ملفات PDF أو فواتير من بيانات السجل
+* الرد تلقائيًا على رسائل البريد الإلكتروني الواردة التي تطابق معايير معينة
+
+
+ مرجع تفصيلي حول المشغلات والإجراءات والمتغيرات ووصفات الأتمتة في العالم الحقيقي.
+
diff --git a/packages/twenty-docs/l/ar/getting-started/introduction.mdx b/packages/twenty-docs/l/ar/getting-started/introduction.mdx
new file mode 100644
index 0000000000..8b73b00b81
--- /dev/null
+++ b/packages/twenty-docs/l/ar/getting-started/introduction.mdx
@@ -0,0 +1,66 @@
+---
+title: لماذا Twenty
+icon: heart
+---
+
+import { CardTitle } from "/snippets/card-title.mdx"
+
+كنتَ دائمًا تختار بين برمجيات يسهل البدء بها لكن يستحيل تغييرها، وبين برمجيات مرنة لكنها تتطلب أشهرًا لإعدادها. Twenty هو الخيار الثالث: **نظام إدارة علاقات عملاء جاهز للإنتاج يمكنك إعادة تشكيله أثناء الاستخدام.**
+
+## ما الذي يجعل Twenty مختلفًا
+
+Twenty هو منصة يمكنك البناء عليها، وليس منتجًا تقوم فقط بتهيئته.
+
+
+
+ مصمَّم للوكلاء
+ يعمل الوكلاء داخل نموذج بياناتك مع صلاحيات حقيقية. مهارات، أدوات، MCP.
+
+
+ قابلية توسعة مؤمّنة
+ مرونة أدوات مشفَّرة بالجوهر على أسس مؤمّنة.
+
+
+ حزمة تقنية حديثة
+ React، TypeScript. فريقك يعرف بالفعل كيفية توسيع Twenty. لا لغات احتكارية، ولا حجب للوصول.
+
+
+ بدون احتجاز
+ نواة مفتوحة المصدر، وقابلية للاستضافة الذاتية، وإمكانية تصدير بياناتك في أي وقت.
+
+
+
+## لمن صُمِّم Twenty
+
+* **المؤسسات الكبرى التي تستبدل Salesforce** — فريقك يقضي وقتًا أطول في مقاومة الأداة بدلًا من استخدامها.
+ تشعر بأنك محتجز داخلها والتكاليف تستمر في الارتفاع.
+* **الشركات الناشئة ذات المؤسسين التقنيين** — لقد تجاوزتم مرحلة جداول البيانات وNotion. لديكم طموحات كبيرة وتريدون
+ نظام إدارة علاقات عملاء يتوسع معكم.
+* **فرق الدخول إلى السوق الباحثة عن ميزة تنافسية** — تريدون بناء نظام التصنيف الخاص بكم للعملاء المحتملين، ومنظومة الإثراء الخاصة بكم، وتدفّقات العمل الخارجية الخاصة بكم.
+* **المنظمات الحريصة على الخصوصية** — تحتاجون إلى
+ الاستضافة الذاتية وامتلاك بياناتكم من البداية إلى النهاية. بدافع المتطلبات التنظيمية،
+ أو التعاقدية، أو حتى المبدئية فقط.
+* **شركاء Salesforce** —
+ مطوّروكم سئموا من عرض زيادات تكاليف التراخيص على عملائكم.
+ تريدون تجربة تطوير أفضل، وتسليم المشاريع بشكل أسرع وبتكلفة تراخيص أقل لعملائكم.
+* **وكالات تطوير الويب** — فريقكم يعرف TypeScript، وReact،
+ وPostgreSQL. يفتح Twenty سوق أنظمة إدارة علاقات العملاء
+ أمامكم دون الحاجة إلى تعلّم APEX أو الحصول على شهادات احتكارية.
+
+## لمن لا يناسبه Twenty
+
+* **الفرق التي تريد نظام إدارة علاقات عملاء لا تحتاج أبدًا إلى التفكير فيه.** يكافئ Twenty الفرق التي تريد البقاء قريبة من أدواتها وتشكيلها بمرور الوقت. إذا كنتم تريدون
+ شيئًا مُدارًا بالكامل، فسيخدمكم Pipedrive أو
+ HubSpot جيدًا.
+* **الشركات التي تحتاج اليوم إلى مئات التكاملات الجاهزة مسبقًا.** نظامنا البيئي ينمو بسرعة، لكنه ليس بعد
+ بالاتساع نفسه الذي لدى Salesforce أو HubSpot. إذا كنتم مرتاحين
+ لبناء ما هو مفقود، فستحبونه. وإن لم تكونوا كذلك، امنحونا
+ عامًا آخر.
+* **المنظمات التي تُختار فيها الأدوات في غرف الاجتماعات،
+ وليس من قِبل الأشخاص الذين يستخدمونها.** لا نقوم بعشاءات فاخرة
+ ولا جلسات إحاطة تنفيذية. نحن ننجح مع الفرق التي لديها
+ صلاحية اختيار أدواتها الخاصة.
+
+
+ اضبط إعدادات Twenty في أقل من 5 دقائق — على السحابة أو بالاستضافة الذاتية.
+
diff --git a/packages/twenty-docs/l/ar/getting-started/key-features.mdx b/packages/twenty-docs/l/ar/getting-started/key-features.mdx
new file mode 100644
index 0000000000..4ed6b190bf
--- /dev/null
+++ b/packages/twenty-docs/l/ar/getting-started/key-features.mdx
@@ -0,0 +1,70 @@
+---
+title: الميزات الرئيسية
+description: جولة في كل ما يمكن أن يقدمه Twenty — بدءًا من نماذج البيانات المخصصة وصولًا إلى الأتمتة المدعومة بالذكاء الاصطناعي.
+icon: نجمة
+---
+
+import { CardTitle } from "/snippets/card-title.mdx"
+
+Twenty هو منصة إدارة علاقات عملاء (CRM) متكاملة المواصفات. إليك ما يمكنك بناؤه باستخدامه.
+
+
+
+ نموذج بيانات مخصص
+ عرّف هيكل البيانات الدقيق الذي يحتاجه عملك.
+ أنشئ كائنات مخصصة، وأضف حقولًا مخصصة مع أكثر من 20 نوعًا من الحقول، وأنشئ علاقات بين أي كائنات.
+
+
+
+ طرق العرض وخطوط العمل
+ بدّل بين طرق عرض الجدول، ولوحات كانبان، وطرق عرض التقويم.
+ قم بالتصفية باستخدام منطق AND/OR، ورتّب حسب عدة حقول، واجمع السجلات، واحفظ طرق عرض مخصصة.
+
+
+
+ سير العمل والأتمتة
+ أتمت أي عملية أعمال دون كتابة كود.
+ قم بتشغيل سير العمل عند تغيّر السجلات، أو وفق الجداول الزمنية، أو الإجراءات اليدوية، أو Webhooks الواردة.
+
+
+
+ مزامنة التقويم والبريد الإلكتروني
+ اربط حساب Google Workspace أو Microsoft 365 الخاص بك.
+ تظهر رسائل البريد الإلكتروني وأحداث التقويم تلقائيًا على سجلات إدارة علاقات العملاء (CRM) ذات الصلة.
+
+
+
+ الذكاء الاصطناعي
+ وكلاء ذكاء اصطناعي يعملون بشكل مستقل داخل نظام إدارة علاقات العملاء (CRM) — يجيبون عن الأسئلة، ويُثْرون السجلات، وينفّذون مهام متعددة الخطوات ضمن نموذج الأذونات الخاص بك.
+
+
+
+ لوحات المعلومات والتقارير
+ أنشئ لوحات معلومات مخصصة باستخدام عناصر واجهة في الوقت الفعلي.
+ تتبّع مقاييس خط العمل، وأداء الفريق، ومؤشرات الأداء الرئيسية للأعمال باستخدام مخططات وعوامل تصفية قابلة للتهيئة.
+
+
+
+ الصلاحيات والتحكم في الوصول
+ تحكم في الوصول قائم على الأدوار على كل المستويات — الكائنات والحقول والسجلات الفردية.
+ قم بتهيئة تسجيل الدخول الأحادي (SSO) باستخدام SAML أو OIDC. تسجلات التدقيق تتعقّب من فعل ماذا.
+
+
+
+ واجهة برمجة التطبيقات (API) وقابلية التوسّع
+ واجهة برمجة تطبيقات موجّهة للمطورين تتكيّف مع نموذج البيانات المخصص لديك.
+ نقاط نهاية GraphQL وREST معًا، مع توثيق يتم إنشاؤه تلقائيًا لكل مساحة عمل.
+
+
+
+ استيراد البيانات وتصديرها
+ استورد البيانات من ملفات CSV أو عبر واجهة برمجة التطبيقات (API).
+ تعيين الحقول، واكتشاف التكرار، والتعامل مع الأخطاء مدمجة في النظام. صدّر بياناتك في أي وقت — بدون أي قيود ارتباط بمنصة واحدة.
+
+
+
+ الاستضافة الذاتية
+ شغّل Twenty على بنيتك التحتية الخاصة باستخدام أمر Docker Compose واحد.
+ تحكّم كامل في بياناتك، وتحديثات وفق الجدول الزمني الذي يناسبك.
+
+
diff --git a/packages/twenty-docs/l/ar/getting-started/quickstart.mdx b/packages/twenty-docs/l/ar/getting-started/quickstart.mdx
new file mode 100644
index 0000000000..291f2cdbae
--- /dev/null
+++ b/packages/twenty-docs/l/ar/getting-started/quickstart.mdx
@@ -0,0 +1,73 @@
+---
+title: البدء السريع
+description: شغّل Twenty في أقل من 5 دقائق — على السحابة أو بالاستضافة الذاتية.
+icon: play
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+## التسجيل
+
+
+
+ انتقل إلى [app.twenty.com](https://app.twenty.com) وسجِّل باستخدام Google أو Microsoft أو البريد الإلكتروني.
+
+
+ اختر **30 يومًا** (مع بطاقة) أو **7 أيام** (بدون بطاقة). كلتاهما تتضمنان وصولًا كاملاً — عدد غير محدود من جهات الاتصال، تكامل البريد الإلكتروني، الكائنات المخصصة، وواجهة برمجة التطبيقات (API). يمكنك تغيير الخطة أو فترة الفوترة في أي وقت.
+
+
+ بعد تأكيد الدفع عبر Stripe، ستقوم بإعداد اسم مساحة العمل والملف الشخصي للمستخدم. يمكنك الإلغاء في أي وقت.
+
+
+
+
+
+## تهيئة مساحة عملك
+
+بمجرد دخولك، هناك ثلاث خطوات لتجعل Twenty ملكك:
+
+### ١. قم بتوصيل بريدك الإلكتروني
+
+انتقل إلى **الإعدادات → الحسابات** وقم بتوصيل حساب Google أو Microsoft الخاص بك. سيقوم Twenty باستيراد رسائل البريد الإلكتروني وفعاليات التقويم، وإنشاء جهات اتصال تلقائيًا من التفاعلات. هل تستخدم موفرًا آخر؟ يمكنك إضافة صناديق البريد عبر SMTP أو التقويمات عبر CalDAV من نفس الصفحة.
+
+ابدأ من هنا — توصيل صندوق بريد يمنح فريقك قيمة فورية من بيانات حقيقية قبل تخصيص أي شيء آخر.
+
+
+
+### ٢. شكِّل نموذج بياناتك
+
+انتقل إلى **الإعدادات → نموذج البيانات** لإنشاء الكائنات والحقول المخصصة. بعض الأمور التي يجب معرفتها:
+
+* الكائنات والحقول المخصصة **غير محدودة في جميع الخطط** — بدون بيع إضافي.
+* **الأشخاص، الشركات، والفرص** هي الكائنات التي تعرض رسائل البريد الإلكتروني والاجتماعات المتزامنة. استخدمها كأساس لديك وأضِف حقولًا لتصنيفها (مثلاً، حقل `Person Type`) بدلًا من إنشاء كائنات منفصلة لن تحتوي على سجل بالبريد الإلكتروني.
+* لا يمكن أن يشترك شخصان في نفس عنوان البريد الإلكتروني. لا يمكن أن تشترك شركتان في نفس النطاق.
+* يمكنك إلغاء تنشيط الحقول/الكائنات القياسية التي لا تحتاجها، وإخفاء الحقول من طرق العرض دون حذفها.
+
+[مرجع نموذج البيانات →](/l/ar/user-guide/data-model/overview)
+
+
+
+### ٣. استيراد بياناتك
+
+استخدم قائمة الأوامر (`Cmd+K` / `Ctrl+K`) لاستيراد الأشخاص، الشركات، الفرص، أو أي كائن مخصص عبر CSV. قم بتنزيل الملف النموذجي أولًا للاطلاع على التنسيق المتوقع. احصر الملفات في 10 آلاف سجل وأزل التكرار عن عناوين البريد الإلكتروني/النطاقات قبل الاستيراد.
+
+[دليل ترحيل البيانات →](/l/ar/user-guide/data-migration/overview)
+
+
+
+## الخطوات التالية
+
+
+
+ التنقّل، العروض، قائمة الأوامر، اللوحة الجانبية.
+
+
+ أتمِت عملياتك التجارية.
+
+
+ جدول، كانبان، تقويم — قم بتصفية بياناتك وفرزها.
+
+
+ مخطط لكل مستأجر عبر REST و GraphQL.
+
+
diff --git a/packages/twenty-docs/l/cs/getting-started/core-concepts/ai.mdx b/packages/twenty-docs/l/cs/getting-started/core-concepts/ai.mdx
new file mode 100644
index 0000000000..7a2e044389
--- /dev/null
+++ b/packages/twenty-docs/l/cs/getting-started/core-concepts/ai.mdx
@@ -0,0 +1,34 @@
+---
+title: AI
+description: Jak Twenty využívá AI ke zlepšení vašeho CRM prostředí.
+icon: robot
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+Twenty integruje AI přímo do vašeho CRM – ne jako trik, ale jako nástroj, který funguje v rámci vašeho datového modelu a systému oprávnění.
+
+## AI chatbot
+
+Ptejte se na svá data v přirozeném jazyce. AI chatbot může dotazovat záznamy ve vašem CRM, shrnovat informace a pomoci vám najít to, co hledáte, aniž byste museli vytvářet složité filtry.
+
+
+
+## AI agenti
+
+AI agenti jdou za hranice chatu – mohou autonomně provádět vícekrokové úlohy:
+
+* Obohacujte záznamy daty z externích zdrojů
+* Připravujte a odesílejte navazující e-maily
+* Analyzujte stav prodejního kanálu a označujte rizikové obchody
+* Zpracovávejte příchozí data a směrujte je na správný tým
+
+Agenti pracují v rámci vašich stávajících workflow, takže můžete kombinovat AI s ručním schvalováním, podmíněnou logikou a externími voláními API.
+
+## Oprávnění a bezpečnost
+
+AI v Twenty respektuje váš model oprávnění. Agenti mohou přistupovat pouze k objektům a polím, ke kterým má uživatel (nebo role) oprávnění k zobrazení. Citlivá data zůstávají chráněná i v situacích, kdy je zapojena AI.
+
+
+ Podrobná referenční příručka k chatbotu, agentům a řízení oprávnění.
+
diff --git a/packages/twenty-docs/l/cs/getting-started/core-concepts/apps.mdx b/packages/twenty-docs/l/cs/getting-started/core-concepts/apps.mdx
new file mode 100644
index 0000000000..783ffb86d8
--- /dev/null
+++ b/packages/twenty-docs/l/cs/getting-started/core-concepts/apps.mdx
@@ -0,0 +1,41 @@
+---
+title: Aplikace
+icon: cube
+description: Rozšiřte Twenty pomocí kódu – vlastních objektů, serverové logiky, UI komponent a AI agentů, to vše jako balíčky TypeScriptu.
+---
+
+Většina CRM vám poskytne konfigurační panel. Twenty vám poskytne platformu. Aplikace jsou způsob, jak vývojáři rozšiřují Twenty nad rámec toho, co nabízí uživatelské rozhraní – definují datové modely, serverovou logiku, komponenty uživatelského rozhraní a schopnosti AI jako kód a nasazují je do jednoho nebo více pracovních prostorů.
+
+## Proč aplikace existují
+
+Pracovní postupy pokrývají automatizaci bez kódu. Ale některé věci vyžadují kód: vlastní cenový modul, proprietární obohacovací datový řetězec, kontrolu souladu, která se spouští při každé aktualizaci záznamu, vlastní panel uživatelského rozhraní, který získává data z interního nástroje.
+
+Aplikace vám umožní budovat tyto věci jako plnohodnotná rozšíření – ne křehké skripty komunikující s API zvenčí, ale kód, který běží na platformě s plným přístupem k typovému systému, modelu oprávnění a UI.
+
+## Co může aplikace definovat
+
+Aplikace je balíček TypeScriptu, který deklaruje **entity** pomocí `twenty-sdk`:
+
+| Entita | K čemu slouží |
+| -------------------------- | -------------------------------------------------------------------------------------------------------------------------------- |
+| **Objekty a pole** | Nové datové tabulky a pole na existujících objektech — stejný režim jako pro vestavěné objekty |
+| **Logické funkce** | Serverový TypeScript spouštěný HTTP trasami, plánovačem cron nebo událostmi databáze |
+| **Frontendové komponenty** | Sandboxované komponenty Reactu, které se vykreslují v uživatelském rozhraní Twenty (postranní panel, widgety, příkazová nabídka) |
+| **Dovednosti a agenti** | Schopnosti AI — opakovaně použitelné pokyny a autonomní asistenti |
+| **Pohledy a navigace** | Předkonfigurované seznamové pohledy a položky postranní nabídky |
+
+Vše je detekováno pomocí analýzy AST v čase sestavení — bez konfiguračních souborů a bez registračního boilerplate kódu. Umístěte `export default defineObject(...)` do libovolného souboru `.ts` a SDK ho načte.
+
+## Jak běží
+
+* **Logické funkce** se spouštějí v izolovaných procesech Node.js, sandboxovaných od hostitele. K datům přistupují prostřednictvím typovaného klienta API, jehož rozsah je omezen oprávněními role aplikace.
+* **Frontendové komponenty** běží ve Web Workerech s využitím Remote DOM — jsou oddělené od hlavní stránky, ale vykreslují nativní prvky DOM (nikoli iframy).
+* **Oprávnění** jsou vynucována na úrovni API. Aplikace vidí pouze to, co jí její role dovoluje.
+
+## Zkušenost vývojáře
+
+Svou aplikaci píšete jako projekt v TypeScriptu na svém počítači. CLI sleduje vaše zdrojové soubory a živě je synchronizuje s běžícím serverem Twenty — upravte soubor a změnu uvidíte v uživatelském rozhraní během sekundy. Typovaný klient API se při změně schématu automaticky znovu vygeneruje. Až budete připraveni, `yarn twenty app:publish --private` nasadí na produkční server a `yarn twenty app:publish` uvede vaši aplikaci na npm a v tržišti Twenty.
+
+
+ Třífázový průvodce — vytvoření kostry projektu, spuštění lokálního serveru a synchronizace vašich změn.
+
diff --git a/packages/twenty-docs/l/cs/getting-started/core-concepts/calendar-and-email.mdx b/packages/twenty-docs/l/cs/getting-started/core-concepts/calendar-and-email.mdx
new file mode 100644
index 0000000000..c698c08ce2
--- /dev/null
+++ b/packages/twenty-docs/l/cs/getting-started/core-concepts/calendar-and-email.mdx
@@ -0,0 +1,46 @@
+---
+title: Kalendář a e-mail
+description: Synchronizujte svůj e-mail a kalendář s Twenty.
+icon: envelope
+---
+
+Twenty se propojí s vašimi stávajícími nástroji, takže váš CRM zůstane aktuální bez ručního zadávání dat.
+
+## Synchronizace e-mailu
+
+Připojte svou poštovní schránku **Google Workspace** nebo **Microsoft 365**. Po připojení:
+
+* E-maily se automaticky propojí s odpovídajícími záznamy Společnosti a Osoby
+* Celé e-mailové vlákno je viditelné na časové ose každého záznamu
+* E-maily můžete odesílat přímo z Twenty
+* Je podporováno více poštovních schránek na uživatele
+
+Máte pod kontrolou, co se importuje — filtrujte podle časového období nebo odesílatele, abyste se vyhnuli načítání nerelevantních e-mailů.
+
+## Synchronizace kalendáře
+
+Události v kalendáři se z vašeho připojeného účtu synchronizují automaticky. Události se zobrazují na relevantních záznamech v CRM, což vám poskytne kompletní přehled o vašich interakcích s každým kontaktem nebo společností.
+
+## Integrace
+
+Kromě e-mailu a kalendáře se Twenty propojuje s externími nástroji prostřednictvím:
+
+| Metoda | Případ použití |
+| -------------------------------- | -------------------------------------------------------------------------------- |
+| **API** | Vytvářejte vlastní integrace pomocí GraphQL nebo REST API |
+| **Webhooky** | Odesílejte notifikace v reálném čase do externích systémů, když se záznamy změní |
+| **Zapier** | Propojte se s více než 5 000 aplikacemi bez psaní kódu |
+| **HTTP akce pracovního postupu** | V rámci automatizovaného pracovního postupu volejte libovolné externí API |
+
+## Vlastní aplikace
+
+Vývojáři mohou na Twenty vytvářet plnohodnotné aplikace — přidávat vlastní uživatelské rozhraní, serverovou logiku a hluboké integrace. Aplikace mohou být publikovány pro komunitu nebo ponechány jako soukromé.
+
+
+
+ Nastavte synchronizaci e-mailu, synchronizaci kalendáře a řešte problémy.
+
+
+ Vytvářejte vlastní integrace pomocí Twenty API.
+
+
diff --git a/packages/twenty-docs/l/cs/getting-started/core-concepts/dashboards.mdx b/packages/twenty-docs/l/cs/getting-started/core-concepts/dashboards.mdx
new file mode 100644
index 0000000000..937fa2bf6b
--- /dev/null
+++ b/packages/twenty-docs/l/cs/getting-started/core-concepts/dashboards.mdx
@@ -0,0 +1,37 @@
+---
+title: Panely
+description: Sledujte výkon a vizualizujte svá data z CRM pomocí vlastních přehledových panelů.
+icon: chart-bar
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+Přehledové panely vám poskytují přehled o obchodních metrikách v reálném čase – zdraví pipeline, výkon týmu, trendy v příjmech a cokoli dalšího, co chcete sledovat.
+
+
+
+## Widgety
+
+Každý přehledový panel se skládá z widgetů. Widget je jeden graf nebo metrika napojená na vaše data z CRM. Můžete konfigurovat:
+
+* **Typ grafu** — sloupcový, spojnicový, koláčový, číselný a další
+* **Zdroj dat** — libovolný objekt ve vašem datovém modelu (standardní nebo vlastní)
+* **Filtry** — zúžení na konkrétní záznamy, časová období nebo segmenty
+* **Agregaci** — počet, součet, průměr, minimum, maximum pro libovolné číselné pole
+* **Seskupení** — rozdělení podle vybraných polí, dat nebo vztahů
+
+## Co můžete sledovat
+
+* Hodnota pipeline podle fáze
+* Uzavřené obchody v čase
+* Průměrná velikost obchodu podle zdroje
+* Míry dokončení úkolů
+* Vlastní metriky u libovolného objektu
+
+## Sdílení
+
+Přehledové panely jsou na úrovni pracovního prostoru – každý člen vašeho týmu je může vidět. Uspořádejte widgety do mřížky a změňte jejich velikost tak, abyste vytvořili zobrazení, které vašemu týmu vyhovuje.
+
+
+ Podrobná referenční příručka k vytváření přehledových panelů, konfiguraci widgetů a nastavení grafů.
+
diff --git a/packages/twenty-docs/l/cs/getting-started/core-concepts/data-model.mdx b/packages/twenty-docs/l/cs/getting-started/core-concepts/data-model.mdx
new file mode 100644
index 0000000000..a0bf93e0be
--- /dev/null
+++ b/packages/twenty-docs/l/cs/getting-started/core-concepts/data-model.mdx
@@ -0,0 +1,47 @@
+---
+title: Datový model
+description: Pochopte, jak Twenty strukturuje vaše data pomocí objektů, polí a relací.
+icon: database
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+Vše v Twenty je postaveno kolem **objektů** a **polí** — stavebních bloků vašeho datového modelu.
+
+## Objekty
+
+Objekty jsou tabulky, které uchovávají vaše data. Twenty obsahuje standardní objekty:
+
+* **Společnosti** — organizace, se kterými obchodujete
+* **Lidé** — jednotlivé kontakty
+* **Příležitosti** — obchodní případy ve vašem prodejním procesu
+* **Úkoly** — úkoly pro váš tým
+* **Poznámky** — volný text propojený se záznamy
+
+Můžete také vytvářet **vlastní objekty** pro cokoli, co vaše firma potřebuje — projekty, požadavky na podporu, produkty, smlouvy a cokoli dalšího.
+
+## Pole
+
+Pole jsou vlastnosti každého objektu. Twenty podporuje širokou škálu typů polí:
+
+| Kategorie | Typy |
+| ------------- | ----------------------------------------------------------------------- |
+| **Základní** | Text, Číslo, Logická hodnota, Datum, Měna, Hodnocení, Výběr |
+| **Složené** | Adresa (ulice, město, stát, PSČ), Celé jméno, Odkazy, Telefony, E‑maily |
+| **Speciální** | Relace, Příloha souboru, JSON, Autor (kdo vytvořil/upravil) |
+
+Každý objekt také získá automatická systémová pole: `id`, `createdAt`, `updatedAt`, `createdBy` a `position`.
+
+## Vztahy
+
+Objekty se propojují mezi sebou prostřednictvím relací. Společnost má mnoho lidí, příležitost patří ke společnosti a tak dále. Můžete vytvářet vlastní relace mezi libovolnými objekty, včetně vztahů mnoho‑k‑mnohým.
+
+## V čem spočívá jeho síla
+
+Na rozdíl od tradičních CRM, kde jste omezeni předdefinovanými poli na předdefinovaných objektech, vám Twenty umožňuje namodelovat data přesně tak, jak funguje vaše firma. Vlastní objekty mají stejný prvotřídní status jako vestavěné — včetně koncových bodů API, zobrazení, oprávnění a spouštěčů pracovních postupů.
+
+
+ Kompletní reference k objektům, polím, relacím a k tomu, jak je konfigurovat.
+
+
+
diff --git a/packages/twenty-docs/l/cs/getting-started/core-concepts/glossary.mdx b/packages/twenty-docs/l/cs/getting-started/core-concepts/glossary.mdx
new file mode 100644
index 0000000000..237ea8dde3
--- /dev/null
+++ b/packages/twenty-docs/l/cs/getting-started/core-concepts/glossary.mdx
@@ -0,0 +1,105 @@
+---
+title: Glosář
+icon: kniha
+description: Klíčové pojmy používané v Twenty.
+---
+
+## API
+
+API (rozhraní pro programování aplikací) umožňuje propojení Twenty s dalšími softwarovými systémy a vytváření vlastních integrací.
+
+## Aplikace
+
+Aplikace jsou vlastní rozšíření vytvořená jako kód, která mohou definovat datové modely a logické funkce. Umožňují vývojářům vytvářet znovupoužitelné přizpůsobení, které lze nasadit do více pracovních prostorů.
+
+## Akce kódu
+
+Akce kódu jsou kroky pracovního postupu, které vám umožní psát vlastní JavaScript pro transformaci dat, provádět výpočty nebo realizovat složitou logiku, kterou není možné dosáhnout pomocí vestavěných akcí.
+
+## Nabídka příkazů
+
+Nabídka příkazů je rozhraní pro rychlý přístup (otevírá se `Cmd + K` na Macu a `Ctrl + K` na Windows), které vám umožní provádět akce, vytvářet záznamy a efektivně se pohybovat ve vašem pracovním prostoru.
+
+## Společnost & Lidé
+
+CRM má dva základní typy záznamů:
+
+* "Společnost" představuje podnik nebo organizaci.
+* "Lidé" představují vaše aktuální a potenciální zákazníky nebo klienty.
+
+## Vlastní pole
+
+Vlastní pole jsou datová pole, která vytváříte k zachycení informací specifických pro vaše obchodní potřeby a procesy.
+
+## Datový model
+
+Datový model je struktura, která definuje, jak jsou informace v CRM uspořádány, včetně toho, jaké objekty existují, jejich vlastnosti (pole) a jak se navzájem vztahují.
+
+## Oblíbené
+
+Oblíbené jsou záznamy, které jste označili pro rychlý přístup, objevují se na postranní liště pro okamžitou navigaci k důležitým datům.
+
+## Pole
+
+Pole představuje konkrétní oblast, kde jsou u entity uložena určitá data.
+
+## Iterátor
+
+Iterátor je akce pracovního postupu, která prochází pole položek a pro každou položku v seznamu spouští následující akce.
+
+## Kanban
+
+"Kanban" je vizuální způsob sledování obchodních procesů pomocí karet a sloupců. Každý sloupec představuje fázi vašeho procesu (například: nové, probíhající, vyhrané, ztracené) a záznamy přesouváte prostřednictvím těchto fází podle postupu.
+
+## Objekt
+
+Objekt je datová struktura, která představuje specifický typ entity ve vašem CRM (např. Lidé, Společnosti nebo Příležitosti). Objekty mohou být standardní (vestavěné) nebo vlastní (vytvořené vámi).
+
+## Příležitosti
+
+Příležitosti v Twenty CRM jsou potenciální obchody nebo prodeje s účty či kontakty.
+
+## Záznam
+
+Záznam označuje instanci objektu, například konkrétní účet nebo kontakt.
+
+## Relační pole
+
+Relační pole vytvářejí propojení mezi různými objekty, což umožňuje propojovat záznamy mezi sebou (například propojit osobu se společností).
+
+## Standardní pole
+
+Standardní pole jsou předem vytvořená datová pole, která jsou s objekty přítomná již ve výchozím stavu a poskytují běžnou funkčnost v rámci všech pracovních prostorů.
+
+## Úkoly
+
+Úkoly v Twenty CRM jsou přiřazené aktivity týkající se kontaktů, účtů nebo příležitostí.
+
+## Spouštěče
+
+Spouštěče jsou výchozím bodem pracovního postupu — událost nebo podmínka, která spustí automatizaci. Patří sem například vytvoření záznamu, aktualizace záznamu, webhooky nebo naplánované časy.
+
+## Zobrazení
+
+Zobrazení záznamů si můžete přizpůsobit pomocí pohledů a pro každý pohled nastavit různé filtry, rozvržení a možnosti řazení.
+
+## Upsert
+
+Upsert je operace, která kombinuje "update" a "insert" — pokud se najde shoda, aktualizuje existující záznam, nebo vytvoří nový záznam, pokud shoda neexistuje.
+
+## Webhooky
+
+Webhooky jsou automatizované zprávy odesílané z Twenty na jiné aplikace při výskytu specifických událostí, což umožňuje synchronizaci dat v reálném čase.
+
+## Pracovní postupy
+
+Pracovní postupy jsou automatizované procesy, které spouštějí akce na základě specifických podmínek a pomáhají vám automatizovat opakující se úkoly a obchodní procesy.
+
+## Pracovní prostor
+
+"Pracovní prostor" obvykle představuje společnost používající Twenty. Obsahuje všechny záznamy a data, která vy a členové vašeho týmu do Twenty přidáte.
+Má jedno doménové jméno, kterým je obvykle doména, kterou vaše společnost používá pro e-mailové adresy zaměstnanců.
+
+## Členové pracovního prostoru
+
+Členové pracovního prostoru jsou uživatelé Twenty z vašeho týmu, kteří mají přístup k vašemu pracovnímu prostoru. Mohou být u záznamů přiřazeni jako vlastníci nebo přiřazené osoby.
diff --git a/packages/twenty-docs/l/cs/getting-started/core-concepts/layout.mdx b/packages/twenty-docs/l/cs/getting-started/core-concepts/layout.mdx
new file mode 100644
index 0000000000..7c3ddd1e4e
--- /dev/null
+++ b/packages/twenty-docs/l/cs/getting-started/core-concepts/layout.mdx
@@ -0,0 +1,74 @@
+---
+title: Rozvržení
+description: Jak v Twenty navigovat, procházet a zobrazovat záznamy.
+icon: table-columns
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+## Hlavní rozvržení
+
+Střed obrazovky je místo, kde se nacházejí vaše záznamy — lidé, společnosti, příležitosti, úkoly, poznámky, řídicí panely, pracovní postupy a jakékoli vlastní objekty. Zde záznamy zobrazujete, upravujete, mažete a vytváříte nová zobrazení.
+
+
+
+## Navigační panel
+
+Levý postranní panel vám poskytuje:
+
+* **Přepínač pracovních prostorů** — přepínejte mezi pracovními prostory nebo vytvořte nový (rozbalovací nabídka nahoře)
+* **Vyhledávání** — stiskněte `/` pro okamžité zaměření, vyhledává napříč všemi objekty
+* **Nastavení** — přístup vlevo nahoře
+* **Oblíbené** — připnutá zobrazení, jedinečná pro každého uživatele
+* **Zkratky objektů** — rychlý přístup k People, Companies, Opportunities atd.
+* **Workflows** — vytvářejte automatizace
+
+Přetažením položek změňte jejich pořadí, vytvářejte složky pro seskupení souvisejících objektů, skryjte to, co nepoužíváte.
+
+
+
+## Nabídka příkazů
+
+Stiskněte `Cmd+K` (Mac) nebo `Ctrl+K` (Windows) — nebo klikněte na tři tečky vpravo nahoře. Odtud můžete:
+
+* Vytvářejte nové záznamy
+* Importujte a exportujte data pomocí CSV
+* Vytvářejte nová zobrazení
+* Přistupujte k smazaným záznamům (Twenty podporuje logické i trvalé mazání)
+* Podívejte se na klávesové zkratky pro navigaci ve vašem pracovním prostoru
+
+
+
+## Hledat
+
+Dostupné přes Command Menu, v horní části navigačního panelu nebo stisknutím `/`. Vyhledávání funguje napříč všemi objekty.
+
+
+
+## Postranní panel
+
+Kliknutím na záznam otevřete postranní panel vpravo — rychlý přehled klíčových informací o záznamu bez opuštění aktuální stránky. Kliknutím na **Open** přejdete na stránku plného záznamu.
+
+
+
+## Zobrazení
+
+Každý objekt podporuje více zobrazení — neomezeně na objekt. Pomocí rozbalovací nabídky vlevo nahoře mezi nimi přepínejte.
+
+* **Tabulka** — řádky a sloupce ve stylu tabulkového procesoru se seskupováním, inline úpravami a přizpůsobením sloupců
+* **Kanban** — karty přetažením, uspořádané podle vybraného pole, ideální pro pipeline
+* **Kalendář** — záznamy zakreslené podle datového pole pro časové plánování
+
+Každé zobrazení si ukládá vlastní filtry, řazení a viditelnost polí. Sdílejte zobrazení se svým pracovním prostorem nebo je ponechte soukromá. Přidejte si zobrazení do oblíbených pro rychlý přístup z postranního panelu.
+
+
+
+## Stránky záznamů
+
+Po otevření záznamu je stránka detailu tvořena konfigurovatelnými **kartami** a **widgety**. Přidávejte, odebírejte, měňte pořadí a měňte velikost widgetů v mřížce — pole, související záznamy, e-maily, časová osa, úkoly, poznámky, soubory, grafy, iframy a další. Každý typ objektu má vlastní rozvržení.
+
+
+ Navigace, zobrazení, stránky záznamů — podrobný referenční přehled a návody.
+
+
+
diff --git a/packages/twenty-docs/l/cs/getting-started/core-concepts/workflows.mdx b/packages/twenty-docs/l/cs/getting-started/core-concepts/workflows.mdx
new file mode 100644
index 0000000000..ffac61d99e
--- /dev/null
+++ b/packages/twenty-docs/l/cs/getting-started/core-concepts/workflows.mdx
@@ -0,0 +1,55 @@
+---
+title: Pracovní postupy
+description: Automatizujte své obchodní procesy pomocí vizuálního nástroje pro tvorbu workflow v Twenty.
+icon: bolt
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+Workflow vám umožňují automatizovat opakující se úkoly a propojit Twenty s externími nástroji — bez psaní kódu (pokud ovšem nechcete).
+
+
+
+## Jak workflow fungují
+
+Každé workflow má tři části:
+
+1. **Trigger** — Co workflow spustí
+2. **Steps** — Co se stane dál (jedna nebo více akcí v posloupnosti)
+3. **Variables** — Data, která proudí mezi kroky
+
+## Spouštěče
+
+| Spouštěč | Kdy se spouští |
+| ---------------- | ----------------------------------------------------------------------------- |
+| **Record event** | Záznam je vytvořen, aktualizován, smazán nebo upsertován |
+| **Ruční** | Uživatel klikne na tlačítko (na jednom záznamu, více záznamech nebo globálně) |
+| **Schedule** | V opakovaném intervalu (syntax cron) |
+| **Webhook** | Externí systém odešle HTTP POST |
+
+## Akce
+
+Workflow mohou řetězit libovolnou kombinaci:
+
+* **Record operations** — Vytváření, aktualizace, vyhledávání, mazání nebo upsertování záznamů
+* **Send email** — Odesílání nebo vytváření konceptů e‑mailů z propojených účtů
+* **HTTP request** — Volání libovolného externího API
+* **Code** — Spouštění vlastního JavaScriptu pro složitou logiku
+* **Branches** — Podmínky if/else pro rozdělení cesty workflow
+* **Iterator** — Procházení (loop) přes pole dat
+* **AI Agent** — Umožní agentovi AI autonomně zpracovávat data
+* **Delay** — Čekání před pokračováním
+* **Form** — Sběr vstupů od uživatele uprostřed workflow
+
+## Co můžete vytvořit
+
+* Posílejte upozornění na Slack, když obchod dosáhne určité fáze
+* Automaticky obohacujte nové kontakty daty z externích API
+* Detekujte neaktivní příležitosti a upozorněte jejich vlastníka
+* Synchronizujte data mezi Twenty a vaším fakturačním systémem
+* Generujte PDF nebo faktury z dat v záznamech
+* Automaticky odpovídejte na příchozí e‑maily, které splňují určitá kritéria
+
+
+ Podrobná reference ke spouštěčům, akcím, proměnným a praktickým receptům na automatizaci.
+
diff --git a/packages/twenty-docs/l/cs/getting-started/introduction.mdx b/packages/twenty-docs/l/cs/getting-started/introduction.mdx
new file mode 100644
index 0000000000..6be91c3969
--- /dev/null
+++ b/packages/twenty-docs/l/cs/getting-started/introduction.mdx
@@ -0,0 +1,62 @@
+---
+title: Proč Twenty
+icon: heart
+---
+
+import { CardTitle } from "/snippets/card-title.mdx"
+
+Doposud jste si vybírali mezi softwarem, který je snadné začít používat, ale je nemožné ho změnit, a softwarem, který je flexibilní, ale jeho nastavení trvá měsíce. Twenty je třetí možnost: **produkčně připravené CRM, které můžete průběžně přetvářet podle sebe.**
+
+## Čím se Twenty liší
+
+Twenty je platforma, na které můžete stavět, ne produkt, který jen nakonfigurujete.
+
+
+
+ Postaveno pro agenty
+ Agenti pracují přímo ve vašem datovém modelu se skutečnými oprávněními. Dovednosti, nástroje, MCP.
+
+
+ Zabezpeřitelná rozšiřitelnost
+ Flexibilita nástrojů typu "vibe-coded" na bezpečných základech.
+
+
+ Moderní stack
+ React, TypeScript. Váš tým už ví, jak Twenty rozšiřovat. Žádné proprietární jazyky, žádné gatekeepingové bariéry.
+
+
+ Bez uzamčení
+ Open-source jádro, možnost self-hostingu, exportujte svá data kdykoli.
+
+
+
+## Pro koho je Twenty určeno
+
+* **Velké podniky nahrazující Salesforce** — váš tým tráví víc času bojem s nástrojem než jeho používáním.
+ Cítíte se uzamčeni a náklady neustále rostou.
+* **Startupy s technickými zakladateli** — přerostli jste tabulky a Notion. Máte velké ambice a chcete CRM, které s vámi poroste.
+* **GTM týmy hledající výhodu** — chcete si vybudovat vlastní lead scoring, vlastní enrichment, vlastní outbound workflows.
+* **Organizace dbající na soukromí** — potřebujete self-hosting a plné vlastnictví svých dat od začátku do konce. Regulatorně,
+ smluvně nebo prostě z principu.
+* **Salesforce partneři** —
+ vaši vývojáři jsou unavení z toho, že musí vašim klientům představovat další a další zvýšení licenčních poplatků.
+ Chcete lepší DX a dodávat projekty rychleji s nižšími licenčními náklady pro své klienty.
+* **Webové vývojářské agentury** — váš tým zná TypeScript, React
+ a PostgreSQL. Twenty vám otevírá trh s CRM
+ bez nutnosti učit se APEX nebo získávat proprietární certifikace.
+
+## Pro koho Twenty není určeno
+
+* **Týmy, které chtějí CRM, na které nikdy nemusí myslet.** Twenty odměňuje týmy, které chtějí být svým nástrojům nablízku a postupně je formovat. Pokud chcete
+ něco plně spravovaného, Pipedrive nebo
+ HubSpot vám dobře poslouží.
+* **Firmy, které dnes potřebují stovky předpřipravených integrací.** Náš ekosystém rychle roste, ale zatím není tak široký jako u Salesforce nebo HubSpotu. Pokud jste v pohodě s tím, že si postavíte to, co chybí, budete ho milovat. Pokud ne, dejte nám
+ ještě rok.
+* **Organizace, kde se nástroje vybírají v zasedačkách,
+ ne lidmi, kteří je používají.** Neděláme steakové večeře
+ ani exekutivní briefingy. Vyhráváme u týmů, které mají
+ pravomoc volit si vlastní nástroje.
+
+
+ Nastavte Twenty za méně než 5 minut — v cloudu nebo jako self-hosted řešení.
+
diff --git a/packages/twenty-docs/l/cs/getting-started/key-features.mdx b/packages/twenty-docs/l/cs/getting-started/key-features.mdx
new file mode 100644
index 0000000000..526a294e40
--- /dev/null
+++ b/packages/twenty-docs/l/cs/getting-started/key-features.mdx
@@ -0,0 +1,70 @@
+---
+title: Klíčové funkce
+description: Přehled všeho, co Twenty dokáže – od vlastních datových modelů po automatizaci poháněnou AI.
+icon: hvězda
+---
+
+import { CardTitle } from "/snippets/card-title.mdx"
+
+Twenty je plnohodnotná platforma CRM. Zde je přehled toho, co s ní můžete vytvořit.
+
+
+
+ Vlastní datový model
+ Definujte přesnou datovou strukturu, kterou vaše firma potřebuje.
+ Vytvářejte vlastní objekty, přidávejte vlastní pole s více než 20 typy polí a budujte vztahy mezi libovolnými objekty.
+
+
+
+ Zobrazení & pipeline
+ Přepínejte mezi tabulkovými zobrazeními, kanbanovými nástěnkami a kalendářovými zobrazeními.
+ Filtrovat můžete pomocí logiky AND/OR, třídit podle více polí, seskupovat záznamy a ukládat vlastní zobrazení.
+
+
+
+ Workflows & automatizace
+ Automatizujte jakýkoli obchodní proces bez psaní kódu.
+ Spouštějte workflows při změnách záznamů, podle harmonogramu, ručních akcí nebo příchozích webhooks.
+
+
+
+ Synchronizace kalendáře a e-mailu
+ Propojte svůj účet Google Workspace nebo Microsoft 365.
+ E-maily a události v kalendáři se automaticky zobrazí v příslušných záznamech CRM.
+
+
+
+ AI
+ AI agenti, kteří autonomně pracují ve vašem CRM – odpovídají na dotazy, obohacují záznamy a provádějí vícekrokové úlohy v rámci vašeho modelu oprávnění.
+
+
+
+ Řídicí panely & reportování
+ Vytvářejte vlastní řídicí panely s widgety v reálném čase.
+ Sledujte metriky pipeline, výkonnost týmu a obchodní KPI pomocí konfigurovatelných grafů a filtrů.
+
+
+
+ Oprávnění & řízení přístupu
+ Řízení přístupu založené na rolích na všech úrovních – objekty, pole i jednotlivé záznamy.
+ Nakonfigurujte SSO pomocí SAML nebo OIDC. Auditní záznamy sledují, kdo co udělal.
+
+
+
+ API & rozšiřitelnost
+ API navržené primárně pro vývojáře, které se přizpůsobí vašemu vlastnímu datovému modelu.
+ GraphQL i REST endpoints s automaticky generovanou dokumentací pro každý workspace.
+
+
+
+ Import a export dat
+ Importujte data ze souborů CSV nebo přes API.
+ Vestavěné mapování polí, detekce duplicit a zpracování chyb. Exportujte svá data kdykoli – žádné uzamčení.
+
+
+
+ Self-hosting
+ Spusťte Twenty na vlastní infrastruktuře jediným příkazem Docker Compose.
+ Plná kontrola nad vašimi daty, aktualizace podle vašeho harmonogramu.
+
+
diff --git a/packages/twenty-docs/l/cs/getting-started/quickstart.mdx b/packages/twenty-docs/l/cs/getting-started/quickstart.mdx
new file mode 100644
index 0000000000..4e539a4a59
--- /dev/null
+++ b/packages/twenty-docs/l/cs/getting-started/quickstart.mdx
@@ -0,0 +1,73 @@
+---
+title: Rychlý start
+description: Spusťte Twenty a zprovozněte ho za méně než 5 minut – v cloudu nebo jako self-hosted řešení.
+icon: play
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+## Registrace
+
+
+
+ Přejděte na [app.twenty.com](https://app.twenty.com) a zaregistrujte se pomocí Google, Microsoftu nebo e-mailu.
+
+
+ Zvolte **30 dní** (s kartou) nebo **7 dní** (bez karty). Obě možnosti zahrnují plný přístup — neomezené kontakty, e-mailovou integraci, vlastní objekty, API. Tarif nebo fakturační období můžete kdykoli změnit.
+
+
+ Po potvrzení platby přes Stripe nastavíte název svého pracovního prostoru a uživatelský profil. Můžete kdykoli zrušit.
+
+
+
+
+
+## Nakonfigurujte svůj pracovní prostor
+
+Jakmile jste uvnitř, stačí tři kroky, aby byl Twenty přesně podle vás:
+
+### 1. Připojte svou e-mailovou schránku
+
+Přejděte do **Nastavení → Účty** a připojte svůj účet Google nebo Microsoft. Twenty naimportuje vaše e-maily a události v kalendáři a automaticky vytvoří kontakty z interakcí. Používáte jiného poskytovatele? Ze stejné stránky můžete přidat schránky přes SMTP nebo kalendáře přes CalDAV.
+
+Začněte zde — připojení poštovní schránky dá vašemu týmu okamžitou hodnotu díky reálným datům ještě předtím, než cokoli dalšího přizpůsobíte.
+
+
+
+### 2. Navrhněte svůj datový model
+
+Přejděte do **Nastavení → Datový model** a vytvořte vlastní objekty a pole. Několik věcí, které je dobré vědět:
+
+* Vlastní objekty a pole jsou **neomezené ve všech tarifech** — žádné dodatečné příplatky.
+* **Lidé, Společnosti a Příležitosti** jsou objekty, které zobrazují synchronizované e‑maily a schůzky. Použijte je jako základ a přidávejte pole pro kategorizaci (např. pole `Person Type`) místo vytváření samostatných objektů, které nebudou mít historii e-mailů.
+* Dva lidé nemohou mít stejnou e‑mailovou adresu. Dvě společnosti nemohou mít stejnou doménu.
+* Standardní pole/objekty, které nepotřebujete, můžete deaktivovat a pole skrýt z pohledů, aniž byste je mazali.
+
+[Referenční příručka k datovému modelu →](/l/cs/user-guide/data-model/overview)
+
+
+
+### 3. Importujte svá data
+
+Použijte příkazovou nabídku (`Cmd+K` / `Ctrl+K`), abyste importovali Lidi, Společnosti, Příležitosti nebo libovolný vlastní objekt pomocí CSV. Nejprve si stáhněte ukázkový soubor, abyste viděli očekávaný formát. Omezte soubory na 10 000 záznamů a před importem odstraňte duplicity e-mailů/domén.
+
+[Průvodce migrací dat →](/l/cs/user-guide/data-migration/overview)
+
+
+
+## Další kroky
+
+
+
+ Navigace, zobrazení, příkazová nabídka, boční panel.
+
+
+ Automatizujte své obchodní procesy.
+
+
+ Tabulka, kanban, kalendář — filtrujte a třiďte svá data.
+
+
+ REST a GraphQL s odděleným schématem pro každého tenanta.
+
+
diff --git a/packages/twenty-docs/l/de/getting-started/core-concepts/ai.mdx b/packages/twenty-docs/l/de/getting-started/core-concepts/ai.mdx
new file mode 100644
index 0000000000..3ec7cb5b1b
--- /dev/null
+++ b/packages/twenty-docs/l/de/getting-started/core-concepts/ai.mdx
@@ -0,0 +1,34 @@
+---
+title: KI
+description: Wie Twenty KI einsetzt, um Ihr CRM-Erlebnis zu verbessern.
+icon: robot
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+Twenty integriert KI direkt in Ihr CRM – nicht als Spielerei, sondern als Werkzeug, das innerhalb Ihres Datenmodells und Ihres Berechtigungssystems funktioniert.
+
+## KI-Chatbot
+
+Stellen Sie Fragen zu Ihren Daten in natürlicher Sprache. Der KI-Chatbot kann Ihre CRM-Datensätze abfragen, Informationen zusammenfassen und Ihnen helfen, das Gesuchte zu finden, ohne komplexe Filter erstellen zu müssen.
+
+
+
+## KI-Agenten
+
+KI-Agenten gehen über den Chat hinaus – sie können mehrstufige Aufgaben eigenständig ausführen:
+
+* Datensätze mit Daten aus externen Quellen anreichern
+* Follow-up-E-Mails verfassen und versenden
+* Pipeline-Gesundheit analysieren und gefährdete Deals kennzeichnen
+* Eingehende Daten verarbeiten und an das richtige Team weiterleiten
+
+Agenten arbeiten innerhalb Ihrer bestehenden Workflows, sodass Sie KI mit manuellen Genehmigungen, bedingter Logik und externen API-Aufrufen kombinieren können.
+
+## Berechtigungen & Sicherheit
+
+KI in Twenty respektiert Ihr Berechtigungsmodell. Agenten können nur auf Objekte und Felder zugreifen, für die der Benutzer (oder die Rolle) eine Anzeigeberechtigung hat. Sensible Daten bleiben geschützt, auch wenn KI im Spiel ist.
+
+
+ Ausführliche Referenz zum Chatbot, zu Agenten und Berechtigungskontrollen.
+
diff --git a/packages/twenty-docs/l/de/getting-started/core-concepts/apps.mdx b/packages/twenty-docs/l/de/getting-started/core-concepts/apps.mdx
new file mode 100644
index 0000000000..4b4cf5fa74
--- /dev/null
+++ b/packages/twenty-docs/l/de/getting-started/core-concepts/apps.mdx
@@ -0,0 +1,41 @@
+---
+title: Apps
+icon: cube
+description: Erweitern Sie Twenty mit Code – benutzerdefinierte Objekte, serverseitige Logik, UI-Komponenten und KI-Agenten, alles als TypeScript-Pakete.
+---
+
+Die meisten CRMs bieten Ihnen ein Konfigurationspanel. Twenty bietet Ihnen eine Plattform. Apps sind die Art und Weise, wie Entwickler Twenty über das hinaus erweitern, was die UI bietet – sie definieren Datenmodelle, serverseitige Logik, UI-Komponenten und KI-Funktionen als Code und stellen diese dann in einem oder mehreren Workspaces bereit.
+
+## Warum Apps existieren
+
+Workflows decken No-Code-Automatisierung ab. Aber einige Dinge erfordern Code: eine benutzerdefinierte Preis-Engine, eine proprietäre Enrichment-Pipeline, eine Compliance-Prüfung, die bei jeder Datensatzaktualisierung ausgeführt wird, ein benutzerdefiniertes UI-Panel, das Daten aus einem internen Tool abruft.
+
+Mit Apps können Sie diese als erstklassige Erweiterungen erstellen – nicht als fragile Skripte, die von außen mit einer API sprechen, sondern als Code, der auf der Plattform läuft und vollen Zugriff auf das Typsystem, das Berechtigungsmodell und die UI hat.
+
+## Was eine App definieren kann
+
+Eine App ist ein TypeScript-Paket, das **Entitäten** mit dem `twenty-sdk` deklariert:
+
+| Entität | Was es tut |
+| -------------------------- | ----------------------------------------------------------------------------------------------------------- |
+| **Objekte & Felder** | Neue Datentabellen und Felder für bestehende Objekte – gleiche Behandlung wie die eingebauten. |
+| **Logikfunktionen** | Serverseitiges TypeScript, ausgelöst durch HTTP-Routen, Cron-Zeitpläne oder Datenbankereignisse |
+| **Frontend-Komponenten** | Sandboxed React-Komponenten, die in der UI von Twenty gerendert werden (Seitenleiste, Widgets, Befehlsmenü) |
+| **Fähigkeiten & Agenten** | KI-Funktionen — wiederverwendbare Anweisungen und autonome Assistenten |
+| **Ansichten & Navigation** | Vorkonfigurierte Listenansichten und Seitenleisteneinträge |
+
+Alles wird zur Build-Zeit über eine AST-Analyse erkannt – keine Konfigurationsdateien, kein Registrierungs-Boilerplate. Fügen Sie `export default defineObject(...)` in jede `.ts`-Datei ein, und das SDK erkennt es automatisch.
+
+## Wie sie ausgeführt werden
+
+* **Logikfunktionen** werden in isolierten Node.js-Prozessen ausgeführt, die vom Host getrennt sind. Sie greifen über einen typisierten API-Client auf Daten zu, der auf die Rollenberechtigungen der App begrenzt ist.
+* **Frontend-Komponenten** laufen in Web Workers mit Remote DOM — von der Hauptseite isoliert, rendern aber native DOM-Elemente (keine iframes).
+* **Berechtigungen** werden auf API-Ebene durchgesetzt. Eine App sieht nur das, was ihre Rolle zulässt.
+
+## Die Developer Experience
+
+Sie schreiben Ihre App als TypeScript-Projekt auf Ihrem Rechner. Die CLI beobachtet Ihre Quelldateien und synchronisiert sie in Echtzeit mit einem laufenden Twenty-Server – bearbeiten Sie eine Datei und sehen Sie die Änderung innerhalb einer Sekunde in der UI. Der typisierte API-Client wird automatisch neu generiert, wenn sich das Schema ändert. Wenn Sie fertig sind, pusht `yarn twenty app:publish --private` auf einen Produktionsserver, oder `yarn twenty app:publish` listet Ihre App auf npm und im Twenty-Marktplatz.
+
+
+ Dreiphasige Schritt-für-Schritt-Anleitung – Gerüst erzeugen, lokalen Server ausführen, Ihre Änderungen synchronisieren.
+
diff --git a/packages/twenty-docs/l/de/getting-started/core-concepts/calendar-and-email.mdx b/packages/twenty-docs/l/de/getting-started/core-concepts/calendar-and-email.mdx
new file mode 100644
index 0000000000..1e0414e05f
--- /dev/null
+++ b/packages/twenty-docs/l/de/getting-started/core-concepts/calendar-and-email.mdx
@@ -0,0 +1,46 @@
+---
+title: Kalender & E-Mail
+description: Synchronisieren Sie Ihre E-Mail und Ihren Kalender mit Twenty.
+icon: envelope
+---
+
+Twenty verbindet sich mit Ihren bestehenden Tools, damit Ihr CRM ohne manuelle Dateneingabe immer auf dem neuesten Stand bleibt.
+
+## E-Mail-Synchronisierung
+
+Verbinden Sie Ihr **Google Workspace**- oder **Microsoft 365**-Postfach. Sobald verbunden:
+
+* E-Mails werden automatisch mit den passenden Unternehmens- und Personendatensätzen verknüpft
+* Vollständige E-Mail-Verläufe sind in der Chronik jedes Datensatzes sichtbar
+* Sie können E-Mails direkt aus Twenty senden
+* Mehrere Postfächer pro Benutzer werden unterstützt
+
+Sie steuern, was importiert wird – filtern Sie nach Datumsbereich oder Absender, um irrelevante E-Mails zu vermeiden.
+
+## Kalender-Synchronisierung
+
+Kalenderereignisse werden automatisch von Ihrem verbundenen Konto synchronisiert. Ereignisse erscheinen in den entsprechenden CRM-Datensätzen und geben Ihnen ein vollständiges Bild Ihrer Interaktionen mit jedem Kontakt oder Unternehmen.
+
+## Integrationen
+
+Über E-Mail und Kalender hinaus verbindet sich Twenty über Folgendes mit externen Tools:
+
+| Methode | Anwendungsfall |
+| -------------------------- | ------------------------------------------------------------------------------------- |
+| **API** | Erstellen Sie benutzerdefinierte Integrationen mit der GraphQL- oder REST-API |
+| **Webhooks** | Senden Sie Echtzeitbenachrichtigungen an externe Systeme, wenn sich Datensätze ändern |
+| **Zapier** | Verbinden Sie sich ohne Code mit über 5.000 Apps |
+| **Workflow-HTTP-Aktionen** | Rufen Sie im Rahmen eines automatisierten Workflows jede externe API auf |
+
+## Benutzerdefinierte Apps
+
+Entwickler können voll funktionsfähige Apps auf Basis von Twenty erstellen – mit benutzerdefinierter UI, serverseitiger Logik und tiefen Integrationen. Apps können für die Community veröffentlicht oder privat gehalten werden.
+
+
+
+ Richten Sie die E-Mail-Synchronisierung und Kalender-Synchronisierung ein und beheben Sie Probleme.
+
+
+ Erstellen Sie benutzerdefinierte Integrationen mit der Twenty-API.
+
+
diff --git a/packages/twenty-docs/l/de/getting-started/core-concepts/dashboards.mdx b/packages/twenty-docs/l/de/getting-started/core-concepts/dashboards.mdx
new file mode 100644
index 0000000000..3ed48f756e
--- /dev/null
+++ b/packages/twenty-docs/l/de/getting-started/core-concepts/dashboards.mdx
@@ -0,0 +1,37 @@
+---
+title: Dashboards
+description: Verfolgen Sie die Leistung und visualisieren Sie Ihre CRM-Daten mit benutzerdefinierten Dashboards.
+icon: chart-bar
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+Dashboards geben Ihnen eine Echtzeit-Sicht auf Ihre Geschäftskennzahlen – Pipeline-Gesundheit, Teamleistung, Umsatztrends und alles andere, was Sie verfolgen möchten.
+
+
+
+## Widgets
+
+Jedes Dashboard besteht aus Widgets. Ein Widget ist ein einzelnes Diagramm oder eine einzelne Kennzahl, die mit Ihren CRM-Daten verknüpft ist. Sie können konfigurieren:
+
+* **Diagrammtyp** — Balken, Linie, Kreis, Zahl und mehr
+* **Datenquelle** — Jedes Objekt in Ihrem Datenmodell (standard oder benutzerdefiniert)
+* **Filter** — Eingrenzen auf bestimmte Einträge, Datumsbereiche oder Segmente
+* **Aggregation** — Anzahl, Summe, Durchschnitt, Minimum, Maximum für jedes numerische Feld
+* **Gruppierung** — Aufschlüsselung nach ausgewählten Feldern, Daten oder Relationen
+
+## Was Sie verfolgen können
+
+* Pipeline-Wert nach Phase
+* Abgeschlossene Deals im Zeitverlauf
+* Durchschnittliche Deal-Größe nach Quelle
+* Aufgabenabschlussraten
+* Benutzerdefinierte Kennzahlen für jedes Objekt
+
+## Freigabe
+
+Dashboards gelten auf Arbeitsbereichsebene – alle in Ihrem Team können sie sehen. Ordnen Sie Widgets in einem Rasterlayout an und ändern Sie ihre Größe, um die Ansicht zu erstellen, die für Ihr Team funktioniert.
+
+
+ Ausführliche Referenz zum Erstellen von Dashboards, Konfigurieren von Widgets und Diagrammeinstellungen.
+
diff --git a/packages/twenty-docs/l/de/getting-started/core-concepts/data-model.mdx b/packages/twenty-docs/l/de/getting-started/core-concepts/data-model.mdx
new file mode 100644
index 0000000000..763cd930dc
--- /dev/null
+++ b/packages/twenty-docs/l/de/getting-started/core-concepts/data-model.mdx
@@ -0,0 +1,47 @@
+---
+title: Datenmodell
+description: Verstehen Sie, wie Twenty Ihre Daten mit Objekten, Feldern und Beziehungen strukturiert.
+icon: database
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+Alles in Twenty ist rund um **Objekte** und **Felder** aufgebaut – die Bausteine Ihres Datenmodells.
+
+## Objekte
+
+Objekte sind die Tabellen, die Ihre Daten enthalten. Twenty enthält Standardobjekte:
+
+* **Companies** — Organisationen, mit denen Sie Geschäfte machen
+* **People** — Einzelkontakte
+* **Opportunities** — Deals in Ihrer Pipeline
+* **Tasks** — Aufgaben für Ihr Team
+* **Notes** — Freitext, der mit Datensätzen verknüpft ist
+
+Sie können auch **benutzerdefinierte Objekte** für alles erstellen, was Ihr Unternehmen benötigt – Projekte, Support-Tickets, Produkte, Verträge oder alles andere.
+
+## Felder
+
+Felder sind die Eigenschaften jedes Objekts. Twenty unterstützt eine breite Palette von Feldtypen:
+
+| Kategorie | Typen |
+| ------------------- | ----------------------------------------------------------------------------------------------------- |
+| **Grundlegend** | Text, Zahl, Boolesch, Datum, Währung, Bewertung, Auswahl |
+| **Zusammengesetzt** | Adresse (Straße, Stadt, Bundesland, Postleitzahl), Vollständiger Name, Links, Telefonnummern, E-Mails |
+| **Spezielle** | Beziehung, Dateianhang, JSON, Benutzer (wer erstellt/geändert hat) |
+
+Jedes Objekt erhält außerdem automatische Systemfelder: `id`, `createdAt`, `updatedAt`, `createdBy` und `position`.
+
+## Beziehungen
+
+Objekte sind über Beziehungen miteinander verbunden. Ein Unternehmen hat viele Personen, eine Opportunity gehört zu einem Unternehmen, und so weiter. Sie können benutzerdefinierte Beziehungen zwischen beliebigen Objekten erstellen, einschließlich Viele-zu-Viele-Beziehungen.
+
+## Warum das so leistungsfähig ist
+
+Anders als bei herkömmlichen CRM-Systemen, bei denen Sie auf vordefinierte Felder in vordefinierten Objekten beschränkt sind, können Sie mit Twenty Ihre Daten genau so modellieren, wie Ihr Unternehmen arbeitet. Benutzerdefinierte Objekte werden wie eingebaute Objekte als erstklassige Elemente behandelt – einschließlich API-Endpunkten, Ansichten, Berechtigungen und Workflow-Auslösern.
+
+
+ Vollständige Referenz zu Objekten, Feldern, Beziehungen und deren Konfiguration.
+
+
+
diff --git a/packages/twenty-docs/l/de/getting-started/core-concepts/glossary.mdx b/packages/twenty-docs/l/de/getting-started/core-concepts/glossary.mdx
new file mode 100644
index 0000000000..3d8601b466
--- /dev/null
+++ b/packages/twenty-docs/l/de/getting-started/core-concepts/glossary.mdx
@@ -0,0 +1,105 @@
+---
+title: Glossar
+icon: Buch
+description: Schlüsselbegriffe, die in Twenty verwendet werden.
+---
+
+## API
+
+API (Application Programming Interface) ermöglicht es Ihnen, Twenty mit anderen Softwaresystemen zu verbinden und benutzerdefinierte Integrationen zu erstellen.
+
+## Apps
+
+Apps sind benutzerdefinierte Erweiterungen, die als Code erstellt werden und Datenmodelle sowie Logikfunktionen definieren können. Damit können Entwickler wiederverwendbare Anpassungen erstellen, die in mehreren Workspaces bereitgestellt werden können.
+
+## Code-Aktionen
+
+Code-Aktionen sind Workflow-Schritte, mit denen Sie benutzerdefiniertes JavaScript schreiben können, um Daten zu transformieren, Berechnungen durchzuführen oder komplexe Logik auszuführen, die mit integrierten Aktionen nicht möglich ist.
+
+## Befehlsmenü
+
+Das Befehlsmenü ist eine Schnellzugriffsoberfläche (geöffnet mit `Cmd + K` auf dem Mac und `Strg + K` unter Windows), mit der Sie Aktionen ausführen, Datensätze erstellen und effizient in Ihrem Arbeitsbereich navigieren können.
+
+## Unternehmen & Personen
+
+Das CRM verfügt über zwei grundlegende Arten von Datensätzen:
+
+* Eine `Company` repräsentiert ein Unternehmen oder eine Organisation.
+* `People` repräsentieren die aktuellen und potenziellen Kunden oder Klienten Ihres Unternehmens.
+
+## Benutzerdefinierte Felder
+
+Benutzerdefinierte Felder sind Datenfelder, die Sie erstellen, um Informationen zu erfassen, die speziell auf die Bedürfnisse und Prozesse Ihres Unternehmens zugeschnitten sind.
+
+## Datenmodell
+
+Ein Datenmodell ist die Struktur, die definiert, wie Informationen in Ihrem CRM organisiert sind, einschließlich der vorhandenen Objekte, deren Eigenschaften (Felder) und wie sie zueinander in Beziehung stehen.
+
+## Favoriten
+
+Favoriten sind Datensätze, die Sie für den Schnellzugriff markiert haben und die in Ihrer Seitenleiste erscheinen, um einen schnellen Zugriff auf wichtige Daten zu ermöglichen.
+
+## Feld
+
+Ein Feld bezeichnet einen bestimmten Bereich, in dem bestimmte Daten für eine Entität gespeichert werden.
+
+## Iterator
+
+Ein Iterator ist eine Workflow-Aktion, die ein Array von Elementen durchläuft und für jedes Element in der Liste die nachfolgenden Aktionen ausführt.
+
+## Kanban
+
+Ein `Kanban` ist eine visuelle Möglichkeit, Ihre Geschäftsprozesse mit Karten und Spalten zu verfolgen. Jede Spalte stellt eine Phase in Ihrem Prozess dar (zum Beispiel: neu, laufend, gewonnen, verloren), und Sie verschieben Datensätze durch diese Phasen, während sie fortschreiten.
+
+## Objekt
+
+Ein Objekt ist eine Datenstruktur, die einen bestimmten Entitätstyp in Ihrem CRM repräsentiert (wie People, Companies oder Opportunities). Objekte können standardmäßig (eingebaut) oder benutzerdefiniert (von Ihnen erstellt) sein.
+
+## Opportunities
+
+Opportunities in Twenty CRM sind potenzielle Deals oder Verkäufe mit Accounts oder Kontakten.
+
+## Datensatz
+
+Ein Datensatz zeigt eine Instanz eines Objekts an, wie ein bestimmtes Konto oder einen bestimmten Kontakt.
+
+## Relationsfelder
+
+Relationsfelder stellen Verbindungen zwischen verschiedenen Objekten her und ermöglichen es Ihnen, Datensätze miteinander zu verknüpfen (zum Beispiel die Verbindung einer Person mit einem Unternehmen).
+
+## Standardfelder
+
+Standardfelder sind vorgefertigte Datenfelder, die standardmäßig mit Objekten geliefert werden und in allen Arbeitsbereichen gebräuchliche Funktionen bieten.
+
+## Aufgaben
+
+Tasks in Twenty CRM sind zugewiesene Aktivitäten in Bezug auf Kontakte, Accounts oder Opportunities.
+
+## Auslöser
+
+Trigger sind der Ausgangspunkt eines Workflows — das Ereignis oder die Bedingung, die die Automatisierung auslöst. Beispiele sind das Erstellen von Datensätzen, Aktualisierungen von Datensätzen, Webhooks oder geplante Zeitpunkte.
+
+## Ansichten
+
+Sie können die Anzeige Ihrer Datensätze mit Ansichten anpassen, indem Sie verschiedene Filter, Layouts und Sortierungsoptionen für jede Ansicht festlegen.
+
+## Upsert
+
+Upsert ist eine Operation, die "update" und "insert" kombiniert — sie aktualisiert einen vorhandenen Datensatz, wenn eine Übereinstimmung gefunden wird, oder erstellt einen neuen Datensatz, wenn keine Übereinstimmung vorhanden ist.
+
+## Webhooks
+
+Webhooks sind automatisierte Nachrichten, die von Twenty an andere Anwendungen gesendet werden, wenn bestimmte Ereignisse eintreten, und ermöglichen die Synchronisierung von Daten in Echtzeit.
+
+## Workflows
+
+Workflows sind automatisierte Prozesse, die basierend auf bestimmten Bedingungen Aktionen auslösen und Ihnen helfen, sich wiederholende Aufgaben und Geschäftsprozesse zu automatisieren.
+
+## Arbeitsbereich
+
+Ein `Arbeitsbereich` repräsentiert typischerweise ein Unternehmen, das Twenty verwendet. Er enthält alle Datensätze und Daten, die Sie und Ihre Teammitglieder zu Twenty hinzufügen.
+Er hat einen einzigen Domainnamen, der typischerweise der Domainname ist, den Ihr Unternehmen für Mitarbeiter-E-Mail-Adressen verwendet.
+
+## Arbeitsbereichsmitglieder
+
+Arbeitsbereichsmitglieder sind die Twenty-Benutzer aus Ihrem Team, die Zugriff auf Ihren Arbeitsbereich haben. Sie können als Eigentümer oder Beauftragte für Datensätze zugewiesen werden.
diff --git a/packages/twenty-docs/l/de/getting-started/core-concepts/layout.mdx b/packages/twenty-docs/l/de/getting-started/core-concepts/layout.mdx
new file mode 100644
index 0000000000..cec4a0b6ca
--- /dev/null
+++ b/packages/twenty-docs/l/de/getting-started/core-concepts/layout.mdx
@@ -0,0 +1,74 @@
+---
+title: Layout
+description: Wie Sie in Twenty navigieren, darin stöbern und Datensätze anzeigen.
+icon: table-columns
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+## Das Hauptlayout
+
+In der Mitte des Bildschirms befinden sich Ihre Datensätze – Personen, Unternehmen, Verkaufschancen, Aufgaben, Notizen, Dashboards, Workflows und alle benutzerdefinierten Objekte. Hier können Sie Datensätze anzeigen, bearbeiten und löschen sowie neue Ansichten erstellen.
+
+
+
+## Navigationsleiste
+
+Die linke Seitenleiste bietet Ihnen:
+
+* **Arbeitsbereichs-Umschalter** — wechseln Sie zwischen Arbeitsbereichen oder erstellen Sie einen neuen (Dropdown oben)
+* **Suche** — drücken Sie `/`, um sie sofort zu fokussieren; durchsucht alle Objekte
+* **Einstellungen** — Zugriff über die obere linke Ecke
+* **Favoriten** — angeheftete Ansichten, eindeutig pro Benutzer
+* **Objekt-Schnellzugriffe** — schneller Zugriff auf Personen, Unternehmen, Verkaufschancen usw.
+* **Workflows** — Automatisierungen erstellen
+
+Ziehen Sie Elemente, um sie neu anzuordnen, erstellen Sie Ordner, um verwandte Objekte zu gruppieren, und blenden Sie aus, was Sie nicht verwenden.
+
+
+
+## Befehlsmenü
+
+Drücken Sie `Cmd+K` (Mac) oder `Ctrl+K` (Windows) – oder klicken Sie auf die drei Punkte oben rechts. Von hier aus können Sie:
+
+* Neue Datensätze erstellen
+* Daten über CSV importieren und exportieren
+* Neue Ansichten erstellen
+* Auf gelöschte Datensätze zugreifen (Twenty unterstützt weiches und hartes Löschen)
+* Sehen Sie sich die Tastenkürzel für die Navigation in Ihrem Arbeitsbereich an
+
+
+
+## Suche
+
+Aufrufbar über das Befehl-Menü, oben in der Navigationsleiste oder durch Drücken von `/`. Die Suche funktioniert über alle Objekte hinweg.
+
+
+
+## Seitenbereich
+
+Klicken Sie auf einen Datensatz, um den Seitenbereich auf der rechten Seite zu öffnen – eine schnelle Übersicht über die wichtigsten Informationen des Datensatzes, ohne die aktuelle Seite zu verlassen. Klicken Sie auf **Open**, um zur vollständigen Datensatzseite zu wechseln.
+
+
+
+## Ansichten
+
+Jedes Objekt unterstützt mehrere Ansichten – unbegrenzt pro Objekt. Verwenden Sie das Dropdown oben links, um zwischen ihnen zu wechseln.
+
+* **Tabelle** — zeilen- und spaltenbasiert wie eine Tabellenkalkulation, mit Gruppierung, Inline-Bearbeitung und Spaltenanpassung
+* **Kanban** — Drag-and-drop-Karten, die nach einem Auswahlsfeld organisiert sind, ideal für Pipelines
+* **Kalender** — Datensätze, die nach einem Datumsfeld für zeitbasierte Planung dargestellt werden
+
+Jede Ansicht speichert ihre eigenen Filter, Sortierung und Feldsichtbarkeit. Teilen Sie Ansichten mit Ihrem Arbeitsbereich oder behalten Sie sie privat. Markieren Sie Ansichten als Favoriten, um schnell über die Seitenleiste darauf zuzugreifen.
+
+
+
+## Datensatzseiten
+
+Wenn Sie einen Datensatz öffnen, wird die Detailseite aus konfigurierbaren **Tabs** und **Widgets** aufgebaut. Fügen Sie Widgets in einem Raster hinzu, entfernen, ordnen Sie sie neu an und ändern Sie ihre Größe – Felder, verwandte Datensätze, E-Mails, Zeitleiste, Aufgaben, Notizen, Dateien, Diagramme, iframes und mehr. Jeder Objekttyp hat sein eigenes Layout.
+
+
+ Navigation, Ansichten, Datensatzseiten – detaillierte Referenz und Anleitungen.
+
+
+
diff --git a/packages/twenty-docs/l/de/getting-started/core-concepts/workflows.mdx b/packages/twenty-docs/l/de/getting-started/core-concepts/workflows.mdx
new file mode 100644
index 0000000000..70e29714d6
--- /dev/null
+++ b/packages/twenty-docs/l/de/getting-started/core-concepts/workflows.mdx
@@ -0,0 +1,55 @@
+---
+title: Workflows
+description: Automatisieren Sie Ihre Geschäftsprozesse mit dem visuellen Workflow-Builder von Twenty.
+icon: bolt
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+Workflows ermöglichen es Ihnen, wiederkehrende Aufgaben zu automatisieren und Twenty mit externen Tools zu verbinden – ohne Code zu schreiben (auch wenn Sie das möchten).
+
+
+
+## Wie Workflows funktionieren
+
+Jeder Workflow besteht aus drei Teilen:
+
+1. **Trigger** — Was den Workflow startet
+2. **Schritte** — Was als Nächstes passiert (eine oder mehrere Aktionen in Folge)
+3. **Variablen** — Daten, die zwischen Schritten fließen
+
+## Auslöser
+
+| Auslöser | Wann er ausgelöst wird |
+| --------------------- | ----------------------------------------------------------------------------------------------------------- |
+| **Datensatzereignis** | Ein Datensatz wird erstellt, aktualisiert, gelöscht oder upserted |
+| **Manuell** | Ein Benutzer klickt auf eine Schaltfläche (bei einem einzelnen Datensatz, mehreren Datensätzen oder global) |
+| **Zeitplan** | In einem wiederkehrenden Intervall (Cron-Syntax) |
+| **Webhook** | Ein externes System sendet einen HTTP POST |
+
+## Aktionen
+
+Workflows können beliebige Kombinationen verketten aus:
+
+* **Datensatzvorgänge** — Datensätze erstellen, aktualisieren, finden, löschen oder upserted ausführen
+* **E-Mail senden** — E-Mails von verbundenen Konten senden oder als Entwurf erstellen
+* **HTTP-Anfrage** — Beliebige externe API aufrufen
+* **Code** — Benutzerdefiniertes JavaScript für komplexe Logik ausführen
+* **Verzweigungen** — If/else-Bedingungen, um den Workflow-Pfad aufzuteilen
+* **Iterator** — Über Arrays von Daten iterieren
+* **KI-Agent** — Einen KI-Agenten Daten autonom verarbeiten lassen
+* **Verzögerung** — Warten, bevor fortgefahren wird
+* **Formular** — Benutzereingaben mitten im Workflow erfassen
+
+## Was Sie erstellen können
+
+* Slack-Benachrichtigungen senden, wenn ein Deal einen bestimmten Status erreicht
+* Neue Kontakte automatisch mit Daten aus externen APIs anreichern
+* Veraltete Opportunities erkennen und den Eigentümer benachrichtigen
+* Daten zwischen Twenty und Ihrem Abrechnungssystem synchronisieren
+* PDFs oder Rechnungen aus Datensatzdaten generieren
+* Automatisch auf eingehende E-Mails antworten, die bestimmten Kriterien entsprechen
+
+
+ Detaillierte Referenz zu Triggern, Aktionen, Variablen und praxisnahen Automatisierungs-Workflows.
+
diff --git a/packages/twenty-docs/l/de/getting-started/introduction.mdx b/packages/twenty-docs/l/de/getting-started/introduction.mdx
new file mode 100644
index 0000000000..f5e87a963d
--- /dev/null
+++ b/packages/twenty-docs/l/de/getting-started/introduction.mdx
@@ -0,0 +1,72 @@
+---
+title: Warum Twenty
+icon: heart
+---
+
+import { CardTitle } from "/snippets/card-title.mdx"
+
+Sie haben bisher zwischen Software gewählt, die einfach zu starten, aber unmöglich zu ändern ist, und Software, die flexibel ist, deren Einrichtung aber Monate dauert. Twenty ist die dritte Option: **ein produktionsreifes CRM, das Sie nach Bedarf umgestalten können.**
+
+## Was Twenty anders macht
+
+Twenty ist eine Plattform, auf der Sie aufbauen können, kein Produkt, das Sie nur konfigurieren.
+
+
+
+ Für Agents entwickelt
+ Agents arbeiten innerhalb Ihres Datenmodells mit echten Berechtigungen. Skills, Tools, MCP.
+
+
+ Gesicherte Erweiterbarkeit
+ Die Flexibilität von vibe-codierten Tools auf gesicherten Grundlagen.
+
+
+ Moderne Stack
+ React, TypeScript. Ihr Team weiß bereits, wie man Twenty erweitert. Keine proprietären Sprachen, kein Gatekeeping.
+
+
+ Kein Lock-in
+ Open-Source-Core, selbst hostbar, exportieren Sie Ihre Daten jederzeit.
+
+
+
+## Für wen Twenty ist
+
+* **Große Unternehmen, die Salesforce ersetzen** – Ihr Team
+ verbringt mehr Zeit damit, gegen das Tool zu kämpfen, als es zu nutzen.
+ Sie fühlen sich eingesperrt und die Kosten steigen ständig.
+* **Startups mit technischen Gründern** – Sie sind
+ aus Tabellenkalkulationen und Notion herausgewachsen. Sie haben große Ambitionen und möchten
+ ein CRM, das mit Ihnen skaliert.
+* **GTM-Teams, die nach einem Vorteil suchen** – Sie möchten
+ Ihr eigenes Lead-Scoring, Ihre eigene Anreicherung, Ihre eigenen
+ Outbound-Workflows aufbauen.
+* **Datenschutzbewusste Organisationen** – Sie müssen
+ selbst hosten und Ihre Daten Ende-zu-Ende besitzen. Regulatorisch,
+ vertraglich oder einfach aus Prinzip.
+* **Salesforce-Partner** –
+ Ihre Entwickler sind es leid, Ihren Kunden Lizenzkostenerhöhungen zu präsentieren.
+ Sie möchten eine bessere DX und Projekte schneller mit geringeren Lizenzkosten für Ihre Kunden liefern.
+* **Webentwicklungsagenturen** – Ihr Team kennt TypeScript, React
+ und PostgreSQL. Twenty eröffnet Ihnen den CRM-Markt,
+ ohne dass Sie APEX erlernen oder proprietäre Zertifizierungen erwerben müssen.
+
+## Für wen Twenty nicht ist
+
+* **Teams, die ein CRM wollen, über das sie nie nachdenken
+ müssen.** Twenty belohnt Teams, die nah an ihren Tools bleiben und sie im Laufe der Zeit formen möchten. Wenn Sie
+ etwas vollständig Verwaltetes wollen, sind Pipedrive oder
+ HubSpot eine gute Wahl für Sie.
+* **Unternehmen, die heute Hunderte vorgefertigte Integrationen
+ benötigen.** Unser Ökosystem wächst schnell, ist aber noch nicht
+ so breit wie das von Salesforce oder HubSpot. Wenn Sie sich damit wohlfühlen,
+ das Fehlende selbst aufzubauen, werden Sie es lieben. Wenn nicht, geben Sie uns
+ noch ein Jahr.
+* **Organisationen, in denen Tools im Vorstandszimmer ausgewählt werden,
+ nicht von den Menschen, die sie nutzen.** Wir machen keine Steak-Dinners
+ und Executive-Briefings. Wir gewinnen bei Teams, die die
+ Autorität haben, ihre eigenen Tools auszuwählen.
+
+
+ Richten Sie Twenty in weniger als 5 Minuten ein – in der Cloud oder selbst gehostet.
+
diff --git a/packages/twenty-docs/l/de/getting-started/key-features.mdx b/packages/twenty-docs/l/de/getting-started/key-features.mdx
new file mode 100644
index 0000000000..e48af1ebe8
--- /dev/null
+++ b/packages/twenty-docs/l/de/getting-started/key-features.mdx
@@ -0,0 +1,70 @@
+---
+title: Wichtige Funktionen
+description: Eine Tour durch alles, was Twenty kann – von benutzerdefinierten Datenmodellen bis hin zu KI-gestützter Automatisierung.
+icon: Stern
+---
+
+import { CardTitle } from "/snippets/card-title.mdx"
+
+Twenty ist eine funktionsreiche CRM-Plattform. Hier ist, was Sie damit erstellen können.
+
+
+
+ Benutzerdefiniertes Datenmodell
+ Definieren Sie die genaue Datenstruktur, die Ihr Unternehmen benötigt.
+ Erstellen Sie benutzerdefinierte Objekte, fügen Sie benutzerdefinierte Felder mit über 20 Feldtypen hinzu und erstellen Sie Beziehungen zwischen beliebigen Objekten.
+
+
+
+ Ansichten & Pipelines
+ Wechseln Sie zwischen Tabellenansichten, Kanban-Boards und Kalenderansichten.
+ Filtern Sie mit UND-/ODER-Logik, sortieren Sie nach mehreren Feldern, gruppieren Sie Datensätze und speichern Sie benutzerdefinierte Ansichten.
+
+
+
+ Workflows & Automatisierung
+ Automatisieren Sie jeden Geschäftsprozess, ohne Code zu schreiben.
+ Lösen Sie Workflows bei Datensatzänderungen, Zeitplänen, manuellen Aktionen oder eingehenden Webhooks aus.
+
+
+
+ Kalender- & E-Mail-Synchronisierung
+ Verbinden Sie Ihr Google-Workspace- oder Microsoft-365-Konto.
+ E-Mails und Kalenderereignisse erscheinen automatisch in den relevanten CRM-Datensätzen.
+
+
+
+ KI
+ KI-Agenten, die autonom in Ihrem CRM arbeiten – sie beantworten Fragen, reichern Datensätze an und führen mehrstufige Aufgaben innerhalb Ihres Berechtigungsmodells aus.
+
+
+
+ Dashboards & Berichte
+ Erstellen Sie benutzerdefinierte Dashboards mit Echtzeit-Widgets.
+ Verfolgen Sie Pipeline-Kennzahlen, Teamleistung und Geschäfts-KPIs mit konfigurierbaren Diagrammen und Filtern.
+
+
+
+ Berechtigungen & Zugriffskontrolle
+ Rollenbasierte Zugriffskontrolle auf jeder Ebene – Objekte, Felder und einzelne Datensätze.
+ Konfigurieren Sie SSO mit SAML oder OIDC. Prüfprotokolle verfolgen, wer was getan hat.
+
+
+
+ API & Erweiterbarkeit
+ Eine Developer-First-API, die sich an Ihr benutzerdefiniertes Datenmodell anpasst.
+ Sowohl GraphQL- als auch REST-Endpunkte mit automatisch generierter Dokumentation pro Workspace.
+
+
+
+ Datenimport & -export
+ Importieren Sie Daten aus CSV-Dateien oder über die API.
+ Feldzuordnung, Dublettenerkennung und Fehlerbehandlung sind integriert. Exportieren Sie Ihre Daten jederzeit – kein Vendor-Lock-in.
+
+
+
+ Self-Hosting
+ Führen Sie Twenty in Ihrer eigenen Infrastruktur mit einem einzigen Docker-Compose-Befehl aus.
+ Volle Kontrolle über Ihre Daten, Updates nach Ihrem Zeitplan.
+
+
diff --git a/packages/twenty-docs/l/de/getting-started/quickstart.mdx b/packages/twenty-docs/l/de/getting-started/quickstart.mdx
new file mode 100644
index 0000000000..6cb44f3d68
--- /dev/null
+++ b/packages/twenty-docs/l/de/getting-started/quickstart.mdx
@@ -0,0 +1,73 @@
+---
+title: Schnellstart
+description: Bringen Sie Twenty in weniger als 5 Minuten zum Laufen – in der Cloud oder selbst gehostet.
+icon: play
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+## Registrierung
+
+
+
+ Gehen Sie zu [app.twenty.com](https://app.twenty.com) und registrieren Sie sich mit Google, Microsoft oder E-Mail.
+
+
+ Wählen Sie **30 Tage** (mit Kreditkarte) oder **7 Tage** (ohne Kreditkarte). Beide Optionen bieten vollständigen Zugriff – unbegrenzte Kontakte, E-Mail-Integration, benutzerdefinierte Objekte, API. Sie können den Tarif oder das Abrechnungsintervall jederzeit ändern.
+
+
+ Nach der Zahlungsbestätigung über Stripe legen Sie den Namen Ihres Arbeitsbereichs und Ihr Benutzerprofil fest. Sie können jederzeit kündigen.
+
+
+
+
+
+## Konfigurieren Sie Ihren Arbeitsbereich
+
+Sobald Sie eingeloggt sind, genügen drei Schritte, um Twenty zu Ihrem eigenen zu machen:
+
+### 1. Verbinden Sie Ihr Postfach
+
+Gehen Sie zu **Einstellungen → Konten** und verbinden Sie Ihr Google- oder Microsoft-Konto. Twenty importiert Ihre E-Mails und Kalendereinträge und erstellt automatisch Kontakte aus Interaktionen. Verwenden Sie einen anderen Anbieter? Sie können Postfächer per SMTP oder Kalender per CalDAV auf derselben Seite hinzufügen.
+
+Beginnen Sie hier – das Verbinden eines Postfachs bietet Ihrem Team sofortigen Mehrwert mit echten Daten, noch bevor Sie irgendetwas anderes anpassen.
+
+
+
+### 2. Gestalten Sie Ihr Datenmodell
+
+Gehen Sie zu **Settings → Data Model**, um benutzerdefinierte Objekte und Felder zu erstellen. Ein paar Dinge, die Sie wissen sollten:
+
+* Benutzerdefinierte Objekte und Felder sind **in allen Tarifen unbegrenzt** – kein Upselling.
+* **Personen, Unternehmen und Opportunities** sind die Objekte, in denen synchronisierte E-Mails und Meetings angezeigt werden. Verwenden Sie sie als Grundlage und fügen Sie Felder zur Kategorisierung hinzu (z. B. ein `Person Type`-Feld), anstatt separate Objekte zu erstellen, die keine E-Mail-Historie haben.
+* Zwei Personen können nicht dieselbe E-Mail-Adresse haben. Zwei Unternehmen können nicht dieselbe Domain haben.
+* Sie können Standardfelder/-objekte, die Sie nicht benötigen, deaktivieren und Felder aus Ansichten ausblenden, ohne sie zu löschen.
+
+[Datenmodell-Referenz →](/l/de/user-guide/data-model/overview)
+
+
+
+### 3. Importieren Sie Ihre Daten
+
+Verwenden Sie das Befehlsmenü (`Cmd+K` / `Ctrl+K`), um Personen, Unternehmen, Opportunities oder benutzerdefinierte Objekte über CSV zu importieren. Laden Sie zuerst die Beispieldatei herunter, um das erwartete Format zu sehen. Begrenzen Sie Dateien auf 10.000 Datensätze und entfernen Sie doppelte E-Mails/Domains, bevor Sie importieren.
+
+[Datenmigrationsleitfaden →](/l/de/user-guide/data-migration/overview)
+
+
+
+## Nächste Schritte
+
+
+
+ Navigation, Ansichten, Befehlsmenü, Seitenleiste.
+
+
+ Automatisieren Sie Ihre Geschäftsprozesse.
+
+
+ Tabelle, Kanban, Kalender – filtern und sortieren Sie Ihre Daten.
+
+
+ Mandantenspezifisches Schema für REST und GraphQL.
+
+
diff --git a/packages/twenty-docs/l/es/getting-started/core-concepts/ai.mdx b/packages/twenty-docs/l/es/getting-started/core-concepts/ai.mdx
new file mode 100644
index 0000000000..741646624a
--- /dev/null
+++ b/packages/twenty-docs/l/es/getting-started/core-concepts/ai.mdx
@@ -0,0 +1,34 @@
+---
+title: IA
+description: Cómo Twenty utiliza la IA para mejorar tu experiencia de CRM.
+icon: robot
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+Twenty integra la IA directamente en tu CRM, no como un truco publicitario, sino como una herramienta que funciona dentro de tu modelo de datos y sistema de permisos.
+
+## Chatbot de IA
+
+Haz preguntas sobre tus datos en lenguaje natural. El chatbot de IA puede consultar tus registros de CRM, resumir información y ayudarte a encontrar lo que buscas sin crear filtros complejos.
+
+
+
+## Agentes de IA
+
+Los agentes de IA van más allá del chat: pueden ejecutar tareas de varios pasos de forma autónoma:
+
+* Enriquecer registros con datos de fuentes externas
+* Redactar y enviar correos electrónicos de seguimiento
+* Analizar la salud del pipeline y marcar los acuerdos en riesgo
+* Procesar datos entrantes y dirigirlos al equipo adecuado
+
+Los agentes funcionan dentro de tus flujos de trabajo existentes, por lo que puedes combinar la IA con aprobaciones manuales, lógica condicional y llamadas a API externas.
+
+## Permisos y seguridad
+
+La IA en Twenty respeta tu modelo de permisos. Los agentes solo pueden acceder a objetos y campos que el usuario (o el rol) tiene permiso para ver. Los datos sensibles permanecen protegidos incluso cuando interviene la IA.
+
+
+ Referencia detallada sobre el chatbot, los agentes y los controles de permisos.
+
diff --git a/packages/twenty-docs/l/es/getting-started/core-concepts/apps.mdx b/packages/twenty-docs/l/es/getting-started/core-concepts/apps.mdx
new file mode 100644
index 0000000000..5557ce64e1
--- /dev/null
+++ b/packages/twenty-docs/l/es/getting-started/core-concepts/apps.mdx
@@ -0,0 +1,41 @@
+---
+title: Aplicaciones
+icon: cube
+description: "Amplía Twenty con código: objetos personalizados, lógica del lado del servidor, componentes de IU y agentes de IA, todo como paquetes de TypeScript."
+---
+
+La mayoría de los CRM te dan un panel de configuración. Twenty te da una plataforma. Las aplicaciones son la forma en que los desarrolladores amplían Twenty más allá de lo que ofrece la IU: definen modelos de datos, lógica del lado del servidor, componentes de IU y capacidades de IA como código, y luego los implementan en uno o más espacios de trabajo.
+
+## Por qué existen las aplicaciones
+
+Los flujos de trabajo cubren la automatización sin código. Pero algunas cosas necesitan código: un motor de precios personalizado, una canalización de enriquecimiento propietaria, una verificación de cumplimiento que se ejecute en cada actualización de registro, un panel de IU personalizado que obtenga datos de una herramienta interna.
+
+Las aplicaciones te permiten crear estos como extensiones de primera clase: no son scripts frágiles que se comunican con una API desde fuera, sino código que se ejecuta en la plataforma con acceso completo al sistema de tipos, el modelo de permisos y la IU.
+
+## Lo que una aplicación puede definir
+
+Una aplicación es un paquete de TypeScript que declara **entidades** usando `twenty-sdk`:
+
+| Entidad | Qué hace |
+| --------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
+| **Objetos y campos** | Nuevas tablas de datos y campos en objetos existentes, con el mismo tratamiento que los integrados. |
+| **Funciones de lógica** | Funciones de TypeScript del lado del servidor activadas por rutas HTTP, programaciones de cron o eventos de base de datos |
+| **Componentes de frontend** | Componentes de React aislados (sandboxed) que se renderizan dentro de la interfaz de Twenty (panel lateral, widgets, menú de comandos) |
+| **Habilidades y agentes** | Capacidades de IA — instrucciones reutilizables y asistentes autónomos |
+| **Vistas y navegación** | Vistas de lista preconfiguradas y elementos del menú lateral |
+
+Todo se detecta mediante análisis de AST en tiempo de compilación; sin archivos de configuración ni código repetitivo de registro. Coloca un `export default defineObject(...)` en cualquier archivo `.ts` y el SDK lo detecta.
+
+## Cómo se ejecutan
+
+* **Las funciones de lógica** se ejecutan en procesos de Node.js aislados, en entornos sandbox separados del host. Acceden a los datos a través de un cliente de API tipado, limitado al ámbito de los permisos de rol de la app.
+* **Los componentes de frontend** se ejecutan en Web Workers usando Remote DOM — aislados de la página principal pero renderizando elementos DOM nativos (no iframes).
+* **Los permisos** se aplican a nivel de API. Una app solo ve lo que su rol permite.
+
+## La experiencia del desarrollador
+
+Escribes tu app como un proyecto de TypeScript en tu máquina. La CLI observa tus archivos fuente y los sincroniza en tiempo real con un servidor de Twenty en ejecución: edita un archivo y ve el cambio en la interfaz en cuestión de un segundo. El cliente de API tipado se regenera automáticamente cuando cambia el esquema. Cuando estés listo, `yarn twenty app:publish --private` envía la app a un servidor de producción, o `yarn twenty app:publish` publica tu app en npm y en el marketplace de Twenty.
+
+
+ Recorrido guiado en tres fases: generar el andamiaje, ejecutar un servidor local y sincronizar tus cambios.
+
diff --git a/packages/twenty-docs/l/es/getting-started/core-concepts/calendar-and-email.mdx b/packages/twenty-docs/l/es/getting-started/core-concepts/calendar-and-email.mdx
new file mode 100644
index 0000000000..08461fc105
--- /dev/null
+++ b/packages/twenty-docs/l/es/getting-started/core-concepts/calendar-and-email.mdx
@@ -0,0 +1,46 @@
+---
+title: Calendario y correo electrónico
+description: Sincroniza tu correo electrónico y calendario con Twenty.
+icon: envelope
+---
+
+Twenty se conecta con tus herramientas existentes para que tu CRM se mantenga actualizado sin necesidad de introducir datos manualmente.
+
+## Sincronización del correo electrónico
+
+Conecta tu buzón de **Google Workspace** o **Microsoft 365**. Una vez conectado:
+
+* Los correos electrónicos se vinculan automáticamente a los registros de Empresa y Personas correspondientes
+* Los hilos de correo electrónico completos son visibles en la cronología de cada registro
+* Puedes enviar correos electrónicos directamente desde Twenty
+* Se admiten múltiples buzones por usuario
+
+Tú controlas lo que se importa: filtra por rango de fechas o remitente para evitar incorporar correos electrónicos irrelevantes.
+
+## Sincronización del calendario
+
+Los eventos del calendario se sincronizan automáticamente desde tu cuenta conectada. Los eventos aparecen en los registros pertinentes del CRM, lo que te ofrece una visión completa de tus interacciones con cada contacto o empresa.
+
+## Integraciones
+
+Más allá del correo electrónico y el calendario, Twenty se conecta a herramientas externas mediante:
+
+| Método | Caso de uso |
+| -------------------------------------- | ------------------------------------------------------------------------------------ |
+| **API** | Crea integraciones personalizadas con la API GraphQL o REST |
+| **Webhooks** | Envía notificaciones en tiempo real a sistemas externos cuando cambian los registros |
+| **Zapier** | Conéctate a más de 5.000 aplicaciones sin código |
+| **Acciones HTTP de flujos de trabajo** | Llama a cualquier API externa como parte de un flujo de trabajo automatizado |
+
+## Aplicaciones personalizadas
+
+Los desarrolladores pueden crear aplicaciones completas sobre Twenty, añadiendo interfaz de usuario personalizada, lógica del lado del servidor e integraciones profundas. Las aplicaciones pueden publicarse para la comunidad o mantenerse privadas.
+
+
+
+ Configura la sincronización del correo electrónico, la sincronización del calendario y soluciona problemas.
+
+
+ Crea integraciones personalizadas con la API de Twenty.
+
+
diff --git a/packages/twenty-docs/l/es/getting-started/core-concepts/dashboards.mdx b/packages/twenty-docs/l/es/getting-started/core-concepts/dashboards.mdx
new file mode 100644
index 0000000000..2b9ed7d1b8
--- /dev/null
+++ b/packages/twenty-docs/l/es/getting-started/core-concepts/dashboards.mdx
@@ -0,0 +1,37 @@
+---
+title: Tableros
+description: Supervisa el rendimiento y visualiza tus datos de CRM con paneles personalizados.
+icon: chart-bar
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+Los paneles te ofrecen visibilidad en tiempo real de los indicadores de tu negocio: estado del pipeline, rendimiento del equipo, tendencias de ingresos y cualquier otra cosa que quieras supervisar.
+
+
+
+## Widgets
+
+Cada panel está compuesto por widgets. Un widget es un solo gráfico o indicador vinculado a tus datos de CRM. Puedes configurar:
+
+* **Tipo de gráfico** — Barras, líneas, pastel, número y más
+* **Origen de datos** — Cualquier objeto en tu modelo de datos (estándar o personalizado)
+* **Filtros** — Restringe a registros específicos, rangos de fechas o segmentos
+* **Agregación** — Recuento, suma, promedio, mínimo, máximo en cualquier campo numérico
+* **Agrupación** — Desglosa por campos seleccionados, fechas o relaciones
+
+## Lo que puedes supervisar
+
+* Valor del pipeline por etapa
+* Acuerdos cerrados a lo largo del tiempo
+* Tamaño medio de los acuerdos por origen
+* Tasas de finalización de tareas
+* Métricas personalizadas en cualquier objeto
+
+## Uso compartido
+
+Los paneles son a nivel de espacio de trabajo: todos los miembros de tu equipo pueden verlos. Organiza los widgets en una cuadrícula y cambia su tamaño para crear la vista que mejor funcione para tu equipo.
+
+
+ Referencia detallada sobre la creación de paneles, la configuración de widgets y los ajustes de gráficos.
+
diff --git a/packages/twenty-docs/l/es/getting-started/core-concepts/data-model.mdx b/packages/twenty-docs/l/es/getting-started/core-concepts/data-model.mdx
new file mode 100644
index 0000000000..0f389913f7
--- /dev/null
+++ b/packages/twenty-docs/l/es/getting-started/core-concepts/data-model.mdx
@@ -0,0 +1,47 @@
+---
+title: Modelo de datos
+description: Comprende cómo Twenty estructura tus datos con objetos, campos y relaciones.
+icon: database
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+Todo en Twenty se basa en **objetos** y **campos**, los componentes básicos de tu modelo de datos.
+
+## Objetos
+
+Los objetos son las tablas que contienen tus datos. Twenty incluye objetos estándar de forma predeterminada:
+
+* **Companies** — Organizaciones con las que haces negocios
+* **People** — Contactos individuales
+* **Opportunities** — Acuerdos en tu flujo de ventas
+* **Tasks** — Elementos de acción para tu equipo
+* **Notes** — Texto de formato libre vinculado a registros
+
+También puedes crear **objetos personalizados** para todo lo que tu negocio necesite: proyectos, tickets de soporte, productos, contratos o cualquier otra cosa.
+
+## Campos
+
+Los campos son las propiedades de cada objeto. Twenty admite una amplia variedad de tipos de campo:
+
+| Categoría | Tipos |
+| ------------- | ----------------------------------------------------------------------------------------------------------- |
+| **Básico** | Texto, Número, Booleano, Fecha, Moneda, Valoración, Selección |
+| **Compuesto** | Dirección (calle, ciudad, estado, código postal), Nombre completo, Enlaces, Teléfonos, Correos electrónicos |
+| **Especial** | Relación, Archivo adjunto, JSON, Actor (quién creó/modificó) |
+
+Cada objeto también obtiene campos de sistema automáticos: `id`, `createdAt`, `updatedAt`, `createdBy` y `position`.
+
+## Relaciones
+
+Los objetos se conectan entre sí mediante relaciones. Una Company tiene muchas People, una Opportunity pertenece a una Company, y así sucesivamente. Puedes crear relaciones personalizadas entre cualquier objeto, incluidas relaciones de muchos a muchos.
+
+## Por qué esto es tan potente
+
+A diferencia de los CRM tradicionales, donde estás limitado a campos predefinidos en objetos predefinidos, Twenty te permite modelar tus datos exactamente de la misma manera en que funciona tu negocio. Los objetos personalizados reciben el mismo tratamiento de primera clase que los incorporados, incluidos los endpoints de API, las vistas, los permisos y los disparadores de flujos de trabajo.
+
+
+ Referencia completa sobre objetos, campos, relaciones y cómo configurarlos.
+
+
+
diff --git a/packages/twenty-docs/l/es/getting-started/core-concepts/glossary.mdx b/packages/twenty-docs/l/es/getting-started/core-concepts/glossary.mdx
new file mode 100644
index 0000000000..40464606f9
--- /dev/null
+++ b/packages/twenty-docs/l/es/getting-started/core-concepts/glossary.mdx
@@ -0,0 +1,105 @@
+---
+title: Glosario
+icon: book
+description: Términos clave utilizados en Twenty.
+---
+
+## API
+
+La API (Interfaz de Programación de Aplicaciones) permite conectar Twenty con otros sistemas de software y construir integraciones personalizadas.
+
+## Aplicaciones
+
+Las aplicaciones son extensiones personalizadas desarrolladas mediante código que pueden definir modelos de datos y funciones de lógica. Permiten que los desarrolladores creen personalizaciones reutilizables que pueden desplegarse en varios espacios de trabajo.
+
+## Acciones de código
+
+Las Acciones de código son pasos de flujo de trabajo que te permiten escribir JavaScript personalizado para transformar datos, realizar cálculos o ejecutar lógica compleja que no es posible con las acciones integradas.
+
+## Menú de Comandos
+
+El Menú de Comandos es una interfaz de acceso rápido (se abre con `Cmd + K` en Mac y `Ctrl + K` en Windows) que te permite realizar acciones, crear registros y navegar por tu espacio de trabajo de manera eficiente.
+
+## Empresa y Personas
+
+El CRM tiene dos tipos fundamentales de registros:
+
+* Una `Empresa` representa un negocio u organización.
+* `Personas` representan los clientes o prospectos actuales de tu empresa.
+
+## Campos Personalizados
+
+Los Campos Personalizados son campos de datos que creas para capturar información específica según las necesidades y procesos de tu negocio.
+
+## Modelo de datos
+
+Un Modelo de Datos es la estructura que define cómo se organiza la información en tu CRM, incluyendo qué objetos existen, sus propiedades (campos) y cómo se relacionan entre ellos.
+
+## Favoritos
+
+Los Favoritos son registros que has marcado para acceso rápido, apareciendo en tu barra lateral para una navegación instantánea a datos importantes.
+
+## Campo
+
+Un campo se refiere a un área específica donde se almacenan datos particulares de una entidad.
+
+## Iterador
+
+Un Iterador es una acción de flujo de trabajo que itera sobre un array de elementos, ejecutando acciones posteriores para cada elemento de la lista.
+
+## Kanban
+
+Un `Kanban` es una manera visual de rastrear los procesos de tu negocio utilizando tarjetas y columnas. Cada columna representa una etapa en tu proceso (por ejemplo: nuevo, en curso, ganado, perdido), y se mueven los registros a través de estas etapas a medida que progresan.
+
+## Objeto
+
+Un Objeto es una estructura de datos que representa un tipo específico de entidad en tu CRM (como Personas, Empresas u Oportunidades). Los Objetos pueden ser estándar (integrados) o personalizados (creados por ti).
+
+## Oportunidades
+
+Las Oportunidades en el CRM de Twenty son posibles tratos o ventas con cuentas o contactos.
+
+## Registro
+
+Un Registro indica una instancia de un objeto, como una cuenta o contacto específico.
+
+## Campos de Relación
+
+Los Campos de Relación crean conexiones entre diferentes objetos, permitiendo vincular registros (como conectar una Persona a una Empresa).
+
+## Campos Estándar
+
+Los Campos Estándar son campos de datos preconstruidos que vienen con los objetos por defecto y proporcionan funcionalidad común en todos los espacios de trabajo.
+
+## Tareas
+
+Las Tareas en el CRM de Twenty son actividades asignadas relacionadas con contactos, cuentas u oportunidades.
+
+## Disparadores
+
+Los disparadores son el punto de inicio de un flujo de trabajo — el evento o la condición que inicia la automatización. Entre los ejemplos se incluyen la creación de registros, las actualizaciones de registros, los webhooks o horarios programados.
+
+## Vistas
+
+Puedes personalizar la visualización de tus registros usando vistas, configurando diferentes filtros, diseños y opciones de clasificación para cada vista.
+
+## Upsert
+
+Upsert es una operación que combina "update" y "insert" — actualiza un registro existente si se encuentra una coincidencia, o crea un registro nuevo si no existe ninguna.
+
+## Webhooks
+
+Los Webhooks son mensajes automatizados que se envían desde Twenty a otras aplicaciones cuando ocurren eventos específicos, habilitando la sincronización de datos en tiempo real.
+
+## Flujos de trabajo
+
+Los Flujos de Trabajo son procesos automatizados que desencadenan acciones basadas en condiciones específicas, ayudándote a automatizar tareas repetitivas y procesos empresariales.
+
+## Espacio de trabajo
+
+Un `Espacio de Trabajo` típicamente representa una empresa que usa Twenty. Contiene todos los registros y datos que tú y los miembros de tu equipo añaden a Twenty.
+Tiene un único nombre de dominio, que generalmente es el nombre de dominio que tu empresa utiliza para las direcciones de correo electrónico de los empleados.
+
+## Miembros del espacio de trabajo
+
+Los Miembros del Espacio de Trabajo son los usuarios de Twenty de tu equipo que tienen acceso a tu espacio de trabajo. Pueden asignarse como propietarios o responsables de registros.
diff --git a/packages/twenty-docs/l/es/getting-started/core-concepts/layout.mdx b/packages/twenty-docs/l/es/getting-started/core-concepts/layout.mdx
new file mode 100644
index 0000000000..0e3afa517b
--- /dev/null
+++ b/packages/twenty-docs/l/es/getting-started/core-concepts/layout.mdx
@@ -0,0 +1,74 @@
+---
+title: Diseño
+description: Cómo navegar, explorar y visualizar registros en Twenty.
+icon: table-columns
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+## El diseño principal
+
+El centro de la pantalla es donde viven tus registros: personas, empresas, oportunidades, tareas, notas, paneles de control, flujos de trabajo y cualquier objeto personalizado. Aquí puedes ver, editar y eliminar registros, y crear nuevas vistas.
+
+
+
+## Barra de navegación
+
+La barra lateral izquierda te ofrece:
+
+* **Selector de espacios de trabajo** — cambia entre espacios de trabajo o crea uno nuevo (desplegable superior)
+* **Búsqueda** — presiona `/` para enfocarla al instante; busca en todos los objetos
+* **Ajustes** — accede desde la parte superior izquierda
+* **Favoritos** — vistas fijadas, únicas por usuario
+* **Accesos directos a objetos** — acceso rápido a People, Companies, Opportunities, etc.
+* **Workflows** — crea automatizaciones
+
+Arrastra elementos para reordenarlos, crea carpetas para agrupar objetos relacionados y oculta lo que no uses.
+
+
+
+## Menú de Comandos
+
+Pulsa `Cmd+K` (Mac) o `Ctrl+K` (Windows), o haz clic en los tres puntos de la esquina superior derecha. Desde aquí puedes:
+
+* Crea nuevos registros
+* Importa y exporta datos en formato CSV
+* Crea nuevas vistas
+* Accede a los registros eliminados (Twenty admite eliminaciones lógicas y definitivas)
+* Consulta los atajos de teclado para navegar por tu espacio de trabajo
+
+
+
+## Buscar
+
+Accesible mediante el Command Menu, la parte superior de la barra de navegación o presionando `/`. La búsqueda funciona en todos los objetos.
+
+
+
+## Panel lateral
+
+Haz clic en un registro para abrir el panel lateral a la derecha: una vista rápida de la información clave del registro sin salir de la página actual. Haz clic en **Open** para ir a la página completa del registro.
+
+
+
+## Vistas
+
+Cada objeto admite varias vistas, sin límite por objeto. Usa el menú desplegable de la parte superior izquierda para cambiar entre ellas.
+
+* **Tabla** — filas y columnas al estilo de una hoja de cálculo, con agrupación, edición en línea y personalización de columnas
+* **Kanban** — tarjetas de arrastrar y soltar organizadas por un campo de selección, ideal para pipelines
+* **Calendario** — registros colocados según un campo de fecha para la planificación basada en el tiempo
+
+Cada vista guarda sus propios filtros, ordenación y visibilidad de campos. Comparte vistas con tu espacio de trabajo o mantenlas privadas. Marca vistas como favoritas para un acceso rápido desde la barra lateral.
+
+
+
+## Páginas de registro
+
+Cuando abres un registro, la página de detalles se compone de **pestañas** y **widgets** configurables. Añade, elimina, reordena y cambia el tamaño de los widgets en una cuadrícula: campos, registros relacionados, correos electrónicos, cronología, tareas, notas, archivos, gráficos, iframes y más. Cada tipo de objeto tiene su propio diseño.
+
+
+ Navegación, vistas, páginas de registros: referencia detallada y guías prácticas.
+
+
+
diff --git a/packages/twenty-docs/l/es/getting-started/core-concepts/workflows.mdx b/packages/twenty-docs/l/es/getting-started/core-concepts/workflows.mdx
new file mode 100644
index 0000000000..3bb076d0a7
--- /dev/null
+++ b/packages/twenty-docs/l/es/getting-started/core-concepts/workflows.mdx
@@ -0,0 +1,55 @@
+---
+title: Flujos de trabajo
+description: Automatiza tus procesos empresariales con el creador visual de flujos de trabajo de Twenty.
+icon: bolt
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+Los flujos de trabajo te permiten automatizar tareas repetitivas y conectar Twenty con herramientas externas, sin escribir código (aunque puedes hacerlo si quieres).
+
+
+
+## Cómo funcionan los flujos de trabajo
+
+Cada flujo de trabajo tiene tres partes:
+
+1. **Disparador** — Lo que inicia el flujo de trabajo
+2. **Pasos** — Lo que ocurre a continuación (una o más acciones en secuencia)
+3. **Variables** — Datos que fluyen entre los pasos
+
+## Disparadores
+
+| Disparador | Cuándo se activa |
+| ---------------------- | ------------------------------------------------------------------------------------------------- |
+| **Evento de registro** | Se crea, actualiza, elimina o upsertea un registro |
+| **Manual** | Un usuario hace clic en un botón (en un único registro, en múltiples registros o de forma global) |
+| **Programación** | En un intervalo recurrente (sintaxis cron) |
+| **Webhook** | Un sistema externo envía un HTTP POST |
+
+## Acciones
+
+Los flujos de trabajo pueden encadenar cualquier combinación de:
+
+* **Operaciones de registro** — Crear, actualizar, buscar, eliminar o upsertear registros
+* **Enviar correo electrónico** — Enviar o redactar correos electrónicos desde cuentas conectadas
+* **Solicitud HTTP** — Llamar a cualquier API externa
+* **Código** — Ejecutar JavaScript personalizado para lógica compleja
+* **Ramificaciones** — Condiciones if/else para dividir la ruta del flujo de trabajo
+* **Iterador** — Recorrer arrays de datos
+* **Agente de IA** — Permitir que un agente de IA procese datos de forma autónoma
+* **Espera** — Pausar antes de continuar
+* **Formulario** — Recoger la información del usuario en mitad del flujo de trabajo
+
+## Lo que puedes crear
+
+* Enviar alertas de Slack cuando una oportunidad alcance una determinada etapa
+* Enriquecer automáticamente los nuevos contactos con datos de APIs externas
+* Detectar oportunidades estancadas y notificar al propietario
+* Sincronizar datos entre Twenty y tu sistema de facturación
+* Generar archivos PDF o facturas a partir de los datos de los registros
+* Responder automáticamente a los correos electrónicos entrantes que cumplan determinados criterios
+
+
+ Referencia detallada sobre disparadores, acciones, variables y recetas de automatización del mundo real.
+
diff --git a/packages/twenty-docs/l/es/getting-started/introduction.mdx b/packages/twenty-docs/l/es/getting-started/introduction.mdx
new file mode 100644
index 0000000000..841c755695
--- /dev/null
+++ b/packages/twenty-docs/l/es/getting-started/introduction.mdx
@@ -0,0 +1,73 @@
+---
+title: Por qué Twenty
+icon: heart
+---
+
+import { CardTitle } from "/snippets/card-title.mdx"
+
+Has estado eligiendo entre software que es fácil de empezar a usar pero imposible de cambiar, y software que es flexible pero tarda meses en configurarse. Twenty es la tercera opción: **un CRM listo para producción que puedes remodelar sobre la marcha.**
+
+## Qué hace diferente a Twenty
+
+Twenty es una plataforma sobre la que puedes construir, no un producto que configuras.
+
+
+
+ Diseñado para agentes
+ Los agentes operan dentro de tu modelo de datos con permisos reales. Habilidades, herramientas, MCP.
+
+
+ Extensibilidad segura
+ La flexibilidad de las herramientas con código de ambiente, sobre cimientos seguros.
+
+
+ Pila moderna
+ React, TypeScript. Tu equipo ya sabe cómo ampliar Twenty. Sin lenguajes propietarios, sin guardianes del acceso.
+
+
+ Sin bloqueo
+ Núcleo de código abierto, autoalojable, exporta tus datos en cualquier momento.
+
+
+
+## Para quién es Twenty
+
+* **Grandes empresas que sustituyen Salesforce**: tu equipo
+ pasa más tiempo luchando contra la herramienta que utilizándola.
+ Te sientes atrapado y los costos no dejan de subir.
+* **Startups con fundadores técnicos**: han superado
+ las hojas de cálculo y Notion. Tienen grandes ambiciones y quieren
+ un CRM que escale con ustedes.
+* **Equipos de GTM que buscan una ventaja competitiva**: quieren crear
+ su propia puntuación de leads, su propio enriquecimiento, sus propios
+ flujos de trabajo de salida.
+* **Organizaciones conscientes de la privacidad**: necesitan
+ autoalojar y poseer sus datos de punta a punta. Por normativa,
+ contractual o simplemente por principios.
+* **Socios de Salesforce**:
+ tus desarrolladores están cansados de presentar aumentos en los costos de licencias a tus clientes.
+ Quieren una mejor DX y entregar proyectos más rápido con un menor costo de licencia para sus clientes.
+* **Agencias de desarrollo web**: tu equipo sabe TypeScript, React
+ y PostgreSQL. Twenty abre el mercado de CRM
+ para ustedes sin tener que aprender APEX ni obtener certificaciones propietarias.
+
+## Para quién no es Twenty
+
+* **Equipos que quieren un CRM del que nunca tengan que
+ preocuparse.** Twenty recompensa a los equipos que quieren mantenerse cerca de
+ sus herramientas y moldearlas con el tiempo. Si quieren
+ algo totalmente gestionado, Pipedrive o
+ HubSpot les funcionará muy bien.
+* **Empresas que necesitan cientos de integraciones preconfiguradas
+ hoy.** Nuestro ecosistema está creciendo rápido, pero aún no es
+ tan amplio como Salesforce o HubSpot. Si se sienten cómodos
+ construyendo lo que falta, les encantará. Si no, dennos
+ un año más.
+* **Organizaciones donde las herramientas se eligen en las salas de juntas,
+ no por las personas que las usan.** No hacemos cenas con bistec
+ ni sesiones informativas ejecutivas. Ganamos con los equipos que tienen la
+ autoridad para elegir sus propias herramientas.
+
+
+ Configura Twenty en menos de 5 minutos, en la nube o con alojamiento propio.
+
diff --git a/packages/twenty-docs/l/es/getting-started/key-features.mdx b/packages/twenty-docs/l/es/getting-started/key-features.mdx
new file mode 100644
index 0000000000..cc1198b4b2
--- /dev/null
+++ b/packages/twenty-docs/l/es/getting-started/key-features.mdx
@@ -0,0 +1,70 @@
+---
+title: Características clave
+description: Un recorrido por todo lo que Twenty puede hacer, desde modelos de datos personalizados hasta automatización con IA.
+icon: star
+---
+
+import { CardTitle } from "/snippets/card-title.mdx"
+
+Twenty es una plataforma de CRM con todas las funciones. Esto es lo que puede crear con ella.
+
+
+
+ Modelo de datos personalizado
+ Defina la estructura de datos exacta que su empresa necesita.
+ Cree objetos personalizados, añada campos personalizados con más de 20 tipos de campos y cree relaciones entre cualquier objeto.
+
+
+
+ Vistas y canalizaciones
+ Cambie entre vistas de tabla, tableros kanban y vistas de calendario.
+ Filtre con lógica AND/OR, ordene por varios campos, agrupe registros y guarde vistas personalizadas.
+
+
+
+ Flujos de trabajo y automatización
+ Automatice cualquier proceso empresarial sin escribir código.
+ Active flujos de trabajo ante cambios en los registros, programaciones, acciones manuales o webhooks entrantes.
+
+
+
+ Sincronización de calendario y correo electrónico
+ Conecte su cuenta de Google Workspace o Microsoft 365.
+ Los correos electrónicos y los eventos de calendario aparecen automáticamente en los registros de CRM correspondientes.
+
+
+
+ IA
+ Agentes de IA que trabajan de forma autónoma dentro de su CRM, respondiendo preguntas, enriqueciendo registros y ejecutando tareas de varios pasos dentro de su modelo de permisos.
+
+
+
+ Paneles e informes
+ Cree paneles personalizados con widgets en tiempo real.
+ Supervise métricas de canalización, rendimiento del equipo y KPI empresariales con gráficos y filtros configurables.
+
+
+
+ Permisos y control de acceso
+ Control de acceso basado en roles en todos los niveles: objetos, campos y registros individuales.
+ Configure SSO con SAML u OIDC. Los registros de auditoría rastrean quién hizo qué.
+
+
+
+ API y extensibilidad
+ Una API enfocada en desarrolladores que se adapta a su modelo de datos personalizado.
+ Tanto endpoints GraphQL como REST, con documentación generada automáticamente por espacio de trabajo.
+
+
+
+ Importación y exportación de datos
+ Importe datos desde archivos CSV o mediante API.
+ Asignación de campos, detección de duplicados y gestión de errores integrada. Exporte sus datos en cualquier momento; sin bloqueo.
+
+
+
+ Alojamiento propio
+ Ejecute Twenty en su propia infraestructura con un solo comando de Docker Compose.
+ Control total sobre sus datos y actualizaciones según su programación.
+
+
diff --git a/packages/twenty-docs/l/es/getting-started/quickstart.mdx b/packages/twenty-docs/l/es/getting-started/quickstart.mdx
new file mode 100644
index 0000000000..2e426efbef
--- /dev/null
+++ b/packages/twenty-docs/l/es/getting-started/quickstart.mdx
@@ -0,0 +1,73 @@
+---
+title: Inicio rápido
+description: Pon Twenty en funcionamiento en menos de 5 minutos, en la nube o con alojamiento propio.
+icon: play
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+## Registro
+
+
+
+ Ve a [app.twenty.com](https://app.twenty.com) y regístrate con Google, Microsoft o correo electrónico.
+
+
+ Elige **30 días** (con tarjeta) o **7 días** (sin tarjeta). Ambas incluyen acceso completo: contactos ilimitados, integración de correo, objetos personalizados, API. Puedes cambiar de plan o el intervalo de facturación en cualquier momento.
+
+
+ Después de la confirmación de pago a través de Stripe, configurarás el nombre de tu espacio de trabajo y tu perfil de usuario. Puedes cancelar en cualquier momento.
+
+
+
+
+
+## Configura tu espacio de trabajo
+
+Una vez dentro, tres pasos para hacer Twenty tuyo:
+
+### 1. Conecta tu buzón de correo
+
+Ve a **Ajustes → Cuentas** y conecta tu cuenta de Google o Microsoft. Twenty importará tus correos y eventos de calendario y creará automáticamente contactos a partir de las interacciones. ¿Usas otro proveedor? Puedes añadir buzones mediante SMTP o calendarios mediante CalDAV desde la misma página.
+
+Empieza aquí: conectar un buzón le da a tu equipo valor inmediato con datos reales antes de que personalices nada más.
+
+
+
+### 2. Da forma a tu modelo de datos
+
+Ve a **Ajustes → Modelo de datos** para crear objetos y campos personalizados. Algunas cosas que debes saber:
+
+* Los objetos y campos personalizados son **ilimitados en todos los planes**: no hay ventas adicionales.
+* **Personas, Empresas y Oportunidades** son los objetos que muestran correos electrónicos y reuniones sincronizados. Úsalos como base y añade campos para categorizar (por ejemplo, un campo `Tipo de persona`) en lugar de crear objetos separados que no tendrán historial de correos.
+* Dos personas no pueden compartir el mismo correo electrónico. Dos empresas no pueden compartir el mismo dominio.
+* Puedes desactivar campos/objetos estándar que no necesites y ocultar campos de las vistas sin eliminarlos.
+
+[Referencia del modelo de datos →](/l/es/user-guide/data-model/overview)
+
+
+
+### 3. Importa tus datos
+
+Usa el menú de comandos (`Cmd+K` / `Ctrl+K`) para importar Personas, Empresas, Oportunidades o cualquier objeto personalizado mediante CSV. Descarga primero el archivo de muestra para ver el formato esperado. Limita los archivos a 10k registros y elimina duplicados de correos/dominios antes de importar.
+
+[Guía de migración de datos →](/l/es/user-guide/data-migration/overview)
+
+
+
+## Próximos pasos
+
+
+
+ Navegación, vistas, menú de comandos, panel lateral.
+
+
+ Automatiza tus procesos empresariales.
+
+
+ Tabla, kanban, calendario: filtra y ordena tus datos.
+
+
+ REST y GraphQL con esquema por cliente.
+
+
diff --git a/packages/twenty-docs/l/fr/getting-started/core-concepts/ai.mdx b/packages/twenty-docs/l/fr/getting-started/core-concepts/ai.mdx
new file mode 100644
index 0000000000..c1244b3e6e
--- /dev/null
+++ b/packages/twenty-docs/l/fr/getting-started/core-concepts/ai.mdx
@@ -0,0 +1,34 @@
+---
+title: IA
+description: Comment Twenty utilise l’IA pour améliorer votre expérience CRM.
+icon: robot
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+Twenty intègre l’IA directement dans votre CRM — non pas comme un gadget, mais comme un outil qui fonctionne au sein de votre modèle de données et de votre système d’autorisations.
+
+## Chatbot IA
+
+Posez des questions sur vos données en langage naturel. Le chatbot IA peut interroger les enregistrements de votre CRM, résumer les informations et vous aider à trouver ce que vous cherchez sans créer de filtres complexes.
+
+
+
+## Agents IA
+
+Les agents IA vont au-delà du simple chat — ils peuvent exécuter des tâches multi-étapes de manière autonome :
+
+* Enrichir les enregistrements avec des données provenant de sources externes
+* Rédiger et envoyer des e-mails de suivi
+* Analyser la santé du pipeline et signaler les opportunités à risque
+* Traiter les données entrantes et les acheminer vers la bonne équipe
+
+Les agents travaillent au sein de vos workflows existants, ce qui vous permet de combiner l’IA avec des validations manuelles, une logique conditionnelle et des appels à des API externes.
+
+## Autorisations et sécurité
+
+L’IA dans Twenty respecte votre modèle d’autorisations. Les agents ne peuvent accéder qu’aux objets et aux champs que l’utilisateur (ou le rôle) est autorisé à voir. Les données sensibles restent protégées même lorsque l’IA est impliquée.
+
+
+ Référence détaillée sur le chatbot, les agents et les contrôles d’autorisations.
+
diff --git a/packages/twenty-docs/l/fr/getting-started/core-concepts/apps.mdx b/packages/twenty-docs/l/fr/getting-started/core-concepts/apps.mdx
new file mode 100644
index 0000000000..1d6f11bf00
--- /dev/null
+++ b/packages/twenty-docs/l/fr/getting-started/core-concepts/apps.mdx
@@ -0,0 +1,41 @@
+---
+title: Applications
+icon: cube
+description: Étendez Twenty avec du code — des objets personnalisés, de la logique côté serveur, des composants d’interface utilisateur et des agents IA, tous sous forme de packages TypeScript.
+---
+
+La plupart des CRM vous donnent un panneau de configuration. Twenty vous offre une plateforme. Les applications sont le moyen par lequel les développeurs étendent Twenty au-delà de ce que l’interface utilisateur propose — en définissant des modèles de données, de la logique côté serveur, des composants d’interface utilisateur et des fonctionnalités d’IA sous forme de code, puis en les déployant sur un ou plusieurs espaces de travail.
+
+## Pourquoi les applications existent
+
+Les flux de travail couvrent l’automatisation sans code. Mais certaines choses nécessitent du code : un moteur de tarification personnalisé, un pipeline d’enrichissement propriétaire, une vérification de conformité qui s’exécute à chaque mise à jour d’enregistrement, un panneau d’interface utilisateur personnalisé qui extrait des données d’un outil interne.
+
+Les applications vous permettent de créer ces éléments en tant qu’extensions de première classe — non pas des scripts fragiles qui communiquent avec une API depuis l’extérieur, mais du code qui s’exécute sur la plateforme avec un accès complet au système de types, au modèle d’autorisations et à l’interface utilisateur.
+
+## Ce qu’une application peut définir
+
+Une application est un package TypeScript qui déclare des **entités** en utilisant le `twenty-sdk` :
+
+| Entité | Ce que cela fait |
+| ------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
+| **Objets et champs** | Nouvelles tables de données et champs sur des objets existants — même traitement que les objets intégrés |
+| **Fonctions logiques** | Fonctions TypeScript côté serveur déclenchées par des routes HTTP, des tâches cron ou des événements de base de données |
+| **Composants frontaux** | Composants React isolés qui s’affichent dans l’interface de Twenty (panneau latéral, widgets, menu de commandes) |
+| **Compétences et agents** | Fonctionnalités d’IA — instructions réutilisables et assistants autonomes |
+| **Vues et navigation** | Vues de liste préconfigurées et éléments de menu de la barre latérale |
+
+Tout est détecté via une analyse AST au moment de la compilation — aucun fichier de configuration, aucun code générique d’enregistrement. Ajoutez un `export default defineObject(...)` dans n’importe quel fichier `.ts` et le SDK le détectera.
+
+## Leur mode d’exécution
+
+* **Les fonctions logiques** s’exécutent dans des processus Node.js isolés, en bac à sable par rapport à l’hôte. Elles accèdent aux données via un client d’API typé, restreint aux autorisations de rôle de l’application.
+* **Les composants frontaux** s’exécutent dans des Web Workers en utilisant Remote DOM — isolés en bac à sable de la page principale mais rendant des éléments DOM natifs (pas d’iframes).
+* **Les autorisations** sont appliquées au niveau de l’API. Une application ne voit que ce que son rôle autorise.
+
+## L’expérience développeur
+
+Vous écrivez votre application comme un projet TypeScript sur votre machine. La CLI surveille vos fichiers sources et les synchronise en direct avec un serveur Twenty en cours d’exécution — modifiez un fichier et voyez le changement dans l’interface en une seconde. Le client d’API typé est régénéré automatiquement lorsque le schéma change. Quand vous êtes prêt, `yarn twenty app:publish --private` envoie l’application vers un serveur de production, ou `yarn twenty app:publish` publie votre application sur npm et sur la place de marché Twenty.
+
+
+ Tutoriel en trois phases — création de l’ossature, exécution d’un serveur local, synchronisation de vos modifications.
+
diff --git a/packages/twenty-docs/l/fr/getting-started/core-concepts/calendar-and-email.mdx b/packages/twenty-docs/l/fr/getting-started/core-concepts/calendar-and-email.mdx
new file mode 100644
index 0000000000..530fe27461
--- /dev/null
+++ b/packages/twenty-docs/l/fr/getting-started/core-concepts/calendar-and-email.mdx
@@ -0,0 +1,46 @@
+---
+title: Calendrier et e-mails
+description: Synchronisez votre messagerie et votre calendrier avec Twenty.
+icon: envelope
+---
+
+Twenty se connecte à vos outils existants afin que votre CRM reste à jour sans saisie manuelle de données.
+
+## Synchronisation des e-mails
+
+Connectez votre boîte aux lettres **Google Workspace** ou **Microsoft 365**. Une fois connecté :
+
+* Les e-mails sont automatiquement liés aux enregistrements Entreprise et Personnes correspondants
+* Les fils de discussion complets sont visibles sur la chronologie de chaque enregistrement
+* Vous pouvez envoyer des e-mails directement depuis Twenty
+* Plusieurs boîtes aux lettres par utilisateur sont prises en charge
+
+Vous contrôlez ce qui est importé — filtrez par plage de dates ou par expéditeur afin d’éviter de récupérer des e-mails non pertinents.
+
+## Synchronisation du calendrier
+
+Les événements de calendrier sont synchronisés automatiquement depuis votre compte connecté. Les événements apparaissent sur les enregistrements CRM concernés, vous donnant une vue complète de vos interactions avec chaque contact ou entreprise.
+
+## Intégrations
+
+Au-delà de la messagerie et du calendrier, Twenty se connecte à des outils externes via :
+
+| Méthode | Cas d'utilisation |
+| ----------------------------------- | ------------------------------------------------------------------------------------------------------- |
+| **API** | Créez des intégrations personnalisées avec l’API GraphQL ou REST |
+| **Webhooks** | Envoyez des notifications en temps réel vers des systèmes externes lorsque les enregistrements changent |
+| **Zapier** | Connectez-vous à plus de 5 000 applications sans code |
+| **Actions HTTP de flux de travail** | Appelez n’importe quelle API externe dans le cadre d’un flux de travail automatisé |
+
+## Applications personnalisées
+
+Les développeurs peuvent créer des applications complètes au-dessus de Twenty — en ajoutant une interface utilisateur personnalisée, une logique côté serveur et des intégrations poussées. Les applications peuvent être publiées pour la communauté ou rester privées.
+
+
+
+ Configurez la synchronisation des e-mails, la synchronisation du calendrier et résolvez les problèmes.
+
+
+ Créez des intégrations personnalisées avec l’API Twenty.
+
+
diff --git a/packages/twenty-docs/l/fr/getting-started/core-concepts/dashboards.mdx b/packages/twenty-docs/l/fr/getting-started/core-concepts/dashboards.mdx
new file mode 100644
index 0000000000..d0cbe7fc16
--- /dev/null
+++ b/packages/twenty-docs/l/fr/getting-started/core-concepts/dashboards.mdx
@@ -0,0 +1,37 @@
+---
+title: Tableaux de bord
+description: Suivez les performances et visualisez vos données CRM avec des tableaux de bord personnalisés.
+icon: chart-bar
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+Les tableaux de bord vous offrent une visibilité en temps réel sur vos indicateurs métier — santé du pipeline, performance de l’équipe, tendances de revenus, et tout autre élément que vous souhaitez suivre.
+
+
+
+## Widgets
+
+Chaque tableau de bord est composé de widgets. Un widget est un graphique ou un indicateur unique lié à vos données CRM. Vous pouvez configurer :
+
+* **Type de graphique** — Histogramme, courbe, camembert, nombre, et plus encore
+* **Source de données** — N’importe quel objet de votre modèle de données (standard ou personnalisé)
+* **Filtres** — Affinez sur des enregistrements, des plages de dates ou des segments spécifiques
+* **Agrégation** — Compter, sommer, moyenner, min, max sur n’importe quel champ numérique
+* **Regroupement** — Ventilez par champs sélectionnés, dates ou relations
+
+## Ce que vous pouvez suivre
+
+* Valeur du pipeline par étape
+* Transactions conclues au fil du temps
+* Taille moyenne des transactions par source
+* Taux d’achèvement des tâches
+* Indicateurs personnalisés sur n’importe quel objet
+
+## Partage
+
+Les tableaux de bord sont au niveau de l’espace de travail — tout le monde dans votre équipe peut les voir. Organisez les widgets dans une grille et redimensionnez-les pour construire la vue qui fonctionne le mieux pour votre équipe.
+
+
+ Référence détaillée sur la création de tableaux de bord, la configuration des widgets et les paramètres des graphiques.
+
diff --git a/packages/twenty-docs/l/fr/getting-started/core-concepts/data-model.mdx b/packages/twenty-docs/l/fr/getting-started/core-concepts/data-model.mdx
new file mode 100644
index 0000000000..c53c8d3a0b
--- /dev/null
+++ b/packages/twenty-docs/l/fr/getting-started/core-concepts/data-model.mdx
@@ -0,0 +1,47 @@
+---
+title: Modèle de données
+description: Comprenez comment Twenty structure vos données avec des objets, des champs et des relations.
+icon: database
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+Dans Twenty, tout est construit autour des **objets** et des **champs** — les blocs de base de votre modèle de données.
+
+## Objets
+
+Les objets sont les tables qui contiennent vos données. Twenty inclut des objets standard :
+
+* **Companies** — Organisations avec lesquelles vous faites des affaires
+* **People** — Contacts individuels
+* **Opportunities** — Affaires dans votre pipeline
+* **Tasks** — Éléments d’action pour votre équipe
+* **Notes** — Texte libre associé aux enregistrements
+
+Vous pouvez également créer des **objets personnalisés** pour tout ce dont votre entreprise a besoin — projets, tickets de support, produits, contrats, ou tout autre élément.
+
+## Champs
+
+Les champs sont les propriétés de chaque objet. Twenty prend en charge un large éventail de types de champs :
+
+| Catégorie | Types |
+| ------------ | -------------------------------------------------------------------------------- |
+| **De base** | Texte, Nombre, Booléen, Date, Devise, Évaluation, Sélection |
+| **Composés** | Adresse (rue, ville, état, code postal), Nom complet, Liens, Téléphones, E-mails |
+| **Spéciaux** | Relation, Pièce jointe, JSON, Auteur (qui a créé/modifié) |
+
+Chaque objet reçoit également des champs système automatiques : `id`, `createdAt`, `updatedAt`, `createdBy` et `position`.
+
+## Relations
+
+Les objets sont reliés entre eux par des relations. Une société compte plusieurs contacts, une opportunité appartient à une société, et ainsi de suite. Vous pouvez créer des relations personnalisées entre n’importe quels objets, y compris des relations plusieurs-à-plusieurs.
+
+## Ce qui le rend puissant
+
+Contrairement aux CRM traditionnels, où vous êtes limité à des champs prédéfinis sur des objets prédéfinis, Twenty vous permet de modéliser vos données exactement comme fonctionne votre entreprise. Les objets personnalisés bénéficient du même traitement de premier ordre que les objets intégrés — y compris des points de terminaison d’API, des vues, des autorisations et des déclencheurs de flux de travail.
+
+
+ Référence complète sur les objets, les champs, les relations et la façon de les configurer.
+
+
+
diff --git a/packages/twenty-docs/l/fr/getting-started/core-concepts/glossary.mdx b/packages/twenty-docs/l/fr/getting-started/core-concepts/glossary.mdx
new file mode 100644
index 0000000000..428d2b40a8
--- /dev/null
+++ b/packages/twenty-docs/l/fr/getting-started/core-concepts/glossary.mdx
@@ -0,0 +1,105 @@
+---
+title: Glossaire
+icon: book
+description: Termes clés utilisés dans Twenty.
+---
+
+## API
+
+L'API (Interface de Programmation d'Applications) permet de connecter Twenty avec d'autres systèmes logiciels et de créer des intégrations personnalisées.
+
+## Applications
+
+Les applications sont des extensions personnalisées, créées sous forme de code, qui peuvent définir des modèles de données et des fonctions de logique métier. Elles permettent aux développeurs de créer des personnalisations réutilisables pouvant être déployées sur plusieurs espaces de travail.
+
+## Actions de code
+
+Les Actions de code sont des étapes de flux de travail qui vous permettent d'écrire du JavaScript personnalisé pour transformer des données, effectuer des calculs ou exécuter une logique complexe qui n'est pas possible avec les actions intégrées.
+
+## Menu de commandes
+
+Le menu de commandes est une interface d'accès rapide (ouverte avec `Cmd + K` sur Mac et `Ctrl + K` sur Windows) qui vous permet d'effectuer des actions, de créer des enregistrements et de naviguer efficacement dans votre espace de travail.
+
+## Entreprise & Personnes
+
+Le CRM a deux types fondamentaux d'enregistrements :
+
+* Une `Entreprise` représente une entreprise ou une organisation.
+* Les `Personnes` représentent les clients ou prospects actuels ou potentiels de votre entreprise.
+
+## Champs Personnalisés
+
+Les Champs Personnalisés sont des champs de données que vous créez pour capturer des informations spécifiques aux besoins et processus de votre entreprise.
+
+## Modèle de données
+
+Un Modèle de Données est la structure qui définit comment les informations sont organisées dans votre CRM, y compris quels objets existent, leurs propriétés (champs) et comment ils sont liés les uns aux autres.
+
+## Favoris
+
+Les Favoris sont des enregistrements que vous avez marqués pour un accès rapide, apparaissant dans votre barre latérale pour une navigation instantanée vers des données importantes.
+
+## Champ
+
+Un champ se réfère à une zone spécifique où des données particulières sont stockées pour une entité.
+
+## Itérateur
+
+Un itérateur est une action de flux de travail qui parcourt un tableau d'éléments et exécute les actions suivantes pour chaque élément de la liste.
+
+## Kanban
+
+Un `Kanban` est une manière visuelle de suivre vos processus commerciaux en utilisant des cartes et des colonnes. Chaque colonne représente une étape dans votre processus (par exemple : nouveau, en cours, gagné, perdu), et vous déplacez les enregistrements à travers ces étapes au fur et à mesure de leur progression.
+
+## Objet
+
+Un Objet est une structure de données qui représente un type spécifique d'entité dans votre CRM (comme Personnes, Entreprises ou Opportunités). Les Objets peuvent être standards (intégrés) ou personnalisés (créés par vous).
+
+## Opportunités
+
+Les opportunités dans Twenty CRM sont des affaires ou ventes potentielles avec des comptes ou des contacts.
+
+## Enregistrement
+
+Un enregistrement indique une instance d'objet, comme un compte ou un contact spécifique.
+
+## Champs de relation
+
+Les Champs de Relation créent des connexions entre différents objets, vous permettant de lier des enregistrements ensemble (comme relier une Personne à une Entreprise).
+
+## Champs Standards
+
+Les Champs Standards sont des champs de données prédéfinis qui viennent avec des objets par défaut et fournissent une fonctionnalité commune à tous les espaces de travail.
+
+## Tâches
+
+Les Tâches dans le CRM Twenty sont des activités assignées concernant des contacts, des comptes ou des opportunités.
+
+## Déclencheurs
+
+Les déclencheurs sont le point de départ d'un flux de travail — l'événement ou la condition qui lance l'automatisation. Exemples : création d'enregistrements, mises à jour d'enregistrements, webhooks ou heures planifiées.
+
+## Vues
+
+Vous pouvez personnaliser l'affichage de vos enregistrements en utilisant des vues, en définissant différents filtres, mises en page et options de tri pour chaque vue.
+
+## Upsert
+
+L'upsert est une opération qui combine "update" et "insert" — elle met à jour un enregistrement existant si une correspondance est trouvée, ou crée un nouvel enregistrement si aucune correspondance n'existe.
+
+## Webhooks
+
+Les Webhooks sont des messages automatisés envoyés de Twenty à d'autres applications lorsque des événements spécifiques se produisent, permettant une synchronisation des données en temps réel.
+
+## Flux de travail
+
+Les flux de travail sont des processus automatisés qui déclenchent des actions selon des conditions spécifiques, vous aidant à automatiser des tâches répétitives et des processus métier.
+
+## Espace de travail
+
+Un `Espace de travail` représente généralement une entreprise utilisant Twenty. Il contient tous les enregistrements et données que vous et les membres de votre équipe ajoutez à Twenty.
+Il a un nom de domaine unique, qui est généralement le nom de domaine que votre entreprise utilise pour les adresses e-mail des employés.
+
+## Membres de l'espace de travail
+
+Les membres de l'espace de travail sont les utilisateurs de Twenty de votre équipe qui ont accès à votre espace de travail. Ils peuvent être désignés comme propriétaires ou assignés à des enregistrements.
diff --git a/packages/twenty-docs/l/fr/getting-started/core-concepts/layout.mdx b/packages/twenty-docs/l/fr/getting-started/core-concepts/layout.mdx
new file mode 100644
index 0000000000..bbd202ff73
--- /dev/null
+++ b/packages/twenty-docs/l/fr/getting-started/core-concepts/layout.mdx
@@ -0,0 +1,74 @@
+---
+title: Disposition
+description: Comment naviguer, parcourir et afficher les enregistrements dans Twenty.
+icon: table-columns
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+## La mise en page principale
+
+Le centre de l'écran est l'endroit où vivent vos enregistrements — personnes, entreprises, opportunités, tâches, notes, tableaux de bord, flux de travail et tout objet personnalisé. Vous affichez, modifiez et supprimez les enregistrements ici, et vous créez de nouvelles vues.
+
+
+
+## Barre de navigation
+
+La barre latérale gauche vous donne :
+
+* **Sélecteur d'espace de travail** — basculez entre les espaces de travail ou créez-en un nouveau (menu déroulant en haut)
+* **Recherche** — appuyez sur `/` pour y accéder instantanément, recherche dans tous les objets
+* **Paramètres** — accessible depuis le coin supérieur gauche
+* **Favoris** — vues épinglées, propres à chaque utilisateur
+* **Raccourcis d'objet** — accès rapide à People, Companies, Opportunities, etc.
+* **Workflows** — créez des automatisations
+
+Faites glisser les éléments pour les réorganiser, créez des dossiers pour regrouper les objets liés, masquez ce que vous n'utilisez pas.
+
+
+
+## Menu de commandes
+
+Appuyez sur `Cmd+K` (Mac) ou `Ctrl+K` (Windows) — ou cliquez sur les trois points en haut à droite. À partir d'ici, vous pouvez :
+
+* Créer de nouveaux enregistrements
+* Importer et exporter des données au format CSV
+* Créer de nouvelles vues
+* Accéder aux enregistrements supprimés (Twenty prend en charge les suppressions logiques et définitives)
+* Voir les raccourcis clavier pour naviguer dans votre espace de travail
+
+
+
+## Recherche
+
+Accessible via le menu Commande, en haut de la barre de navigation, ou en appuyant sur `/`. La recherche fonctionne sur tous les objets.
+
+
+
+## Panneau latéral
+
+Cliquez sur un enregistrement pour ouvrir le panneau latéral sur la droite — un aperçu rapide des informations clés de l'enregistrement sans quitter la page actuelle. Cliquez sur **Open** pour accéder à la page complète de l'enregistrement.
+
+
+
+## Vues
+
+Chaque objet prend en charge plusieurs vues — un nombre illimité par objet. Utilisez le menu déroulant en haut à gauche pour passer de l'une à l'autre.
+
+* **Tableau** — lignes et colonnes de type feuille de calcul, avec regroupement, édition en ligne et personnalisation des colonnes
+* **Kanban** — cartes en glisser-déposer organisées par un champ de sélection, idéal pour les pipelines
+* **Calendrier** — enregistrements positionnés selon un champ de date pour une planification dans le temps
+
+Chaque vue enregistre ses propres filtres, critères de tri et visibilité des champs. Partagez des vues avec votre espace de travail ou gardez-les privées. Ajoutez des vues aux favoris pour un accès rapide depuis la barre latérale.
+
+
+
+## Pages d'enregistrement
+
+Lorsque vous ouvrez un enregistrement, la page de détails est composée d'**onglets** et de **widgets** configurables. Ajoutez, supprimez, réorganisez et redimensionnez les widgets sur une grille — champs, enregistrements liés, e-mails, chronologie, tâches, notes, fichiers, graphiques, iframes, et plus encore. Chaque type d'objet a sa propre mise en page.
+
+
+ Navigation, vues, pages d'enregistrement — référence détaillée et guides pratiques.
+
+
+
diff --git a/packages/twenty-docs/l/fr/getting-started/core-concepts/workflows.mdx b/packages/twenty-docs/l/fr/getting-started/core-concepts/workflows.mdx
new file mode 100644
index 0000000000..69bff7d881
--- /dev/null
+++ b/packages/twenty-docs/l/fr/getting-started/core-concepts/workflows.mdx
@@ -0,0 +1,55 @@
+---
+title: Flux de travail
+description: Automatisez vos processus métier avec le créateur de workflows visuels de Twenty.
+icon: bolt
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+Les workflows vous permettent d'automatiser les tâches répétitives et de connecter Twenty à des outils externes, sans écrire de code (même si vous pouvez le faire si vous le souhaitez).
+
+
+
+## Fonctionnement des workflows
+
+Chaque workflow comporte trois parties :
+
+1. **Déclencheur** — Ce qui démarre le workflow
+2. **Étapes** — Ce qui se passe ensuite (une ou plusieurs actions en séquence)
+3. **Variables** — Les données qui circulent entre les étapes
+
+## Déclencheurs
+
+| Déclencheur | Moment où il se déclenche |
+| ------------------------------ | ------------------------------------------------------------------------------------------------------------ |
+| **Événement d'enregistrement** | Un enregistrement est créé, mis à jour, supprimé ou upserté |
+| **Manuel** | Un utilisateur clique sur un bouton (sur un enregistrement unique, plusieurs enregistrements ou globalement) |
+| **Planification** | À un intervalle récurrent (syntaxe cron) |
+| **Webhook** | Un système externe envoie une requête HTTP POST |
+
+## Actions
+
+Les workflows peuvent enchaîner n'importe quelle combinaison de :
+
+* **Opérations sur les enregistrements** — Créer, mettre à jour, rechercher, supprimer ou upserter des enregistrements
+* **Envoyer un e-mail** — Envoyer ou rédiger des e-mails à partir de comptes connectés
+* **Requête HTTP** — Appeler n'importe quelle API externe
+* **Code** — Exécuter du JavaScript personnalisé pour une logique complexe
+* **Branches** — Conditions if/else pour scinder le chemin du workflow
+* **Iterator** — Parcourir des tableaux de données
+* **Agent IA** — Laisser un agent IA traiter les données de manière autonome
+* **Délai** — Attendre avant de continuer
+* **Formulaire** — Collecter les saisies utilisateur en cours de workflow
+
+## Ce que vous pouvez créer
+
+* Envoyer des alertes Slack lorsqu'une affaire atteint une certaine étape
+* Enrichir automatiquement les nouveaux contacts avec des données provenant d'API externes
+* Détecter les opportunités obsolètes et avertir le propriétaire
+* Synchroniser les données entre Twenty et votre système de facturation
+* Générer des PDF ou des factures à partir des données d'enregistrement
+* Répondre automatiquement aux e-mails entrants correspondant à certains critères
+
+
+ Référence détaillée sur les déclencheurs, les actions, les variables et des exemples concrets d'automatisation.
+
diff --git a/packages/twenty-docs/l/fr/getting-started/introduction.mdx b/packages/twenty-docs/l/fr/getting-started/introduction.mdx
new file mode 100644
index 0000000000..baa65cf013
--- /dev/null
+++ b/packages/twenty-docs/l/fr/getting-started/introduction.mdx
@@ -0,0 +1,71 @@
+---
+title: Pourquoi Twenty
+icon: heart
+---
+
+import { CardTitle } from "/snippets/card-title.mdx"
+
+Vous avez toujours dû choisir entre des logiciels faciles à prendre en main mais impossibles à faire évoluer, et des logiciels flexibles mais qui demandent des mois de mise en place. Twenty est la troisième option : **un CRM prêt pour la production que vous pouvez remodeler au fur et à mesure.**
+
+## En quoi Twenty est différent
+
+Twenty est une plateforme sur laquelle vous pouvez construire, pas un produit que vous vous contentez de configurer.
+
+
+
+ Conçu pour les agents
+ Les agents opèrent à l'intérieur de votre modèle de données avec de vrais droits d'accès. Compétences, outils, MCP.
+
+
+ Extensibilité sécurisée
+ La flexibilité d’outils "vibe-coded" sur des bases sécurisées.
+
+
+ Pile moderne
+ React, TypeScript. Votre équipe sait déjà comment étendre Twenty. Aucun langage propriétaire, aucun gatekeeping.
+
+
+ Sans verrouillage
+ Noyau open source, auto-hébergeable, exportez vos données à tout moment.
+
+
+
+## Pour qui est Twenty
+
+* **Grandes entreprises remplaçant Salesforce** — votre équipe
+ passe plus de temps à se battre avec l’outil qu’à l’utiliser.
+ Vous vous sentez enfermés et les coûts ne cessent d’augmenter.
+* **Startups avec fondateurs techniques** — vous avez dépassé
+ le stade des feuilles de calcul et de Notion. Vous avez de grandes ambitions et vous voulez
+ un CRM qui évolue avec vous.
+* **Équipes go-to-market à la recherche d’un avantage concurrentiel** — vous voulez créer
+ votre propre scoring de leads, votre propre enrichissement, vos propres
+ workflows sortants.
+* **Organisations soucieuses de la confidentialité** — vous devez
+ vous auto-héberger et posséder vos données de bout en bout. Réglementaire,
+ contractuel, ou par simple principe.
+* **Partenaires Salesforce** —
+ vos développeurs en ont assez de présenter des hausses de coûts de licence à vos clients.
+ Vous voulez une meilleure DX, et livrer des projets plus rapidement avec un coût de licence plus faible pour vos clients.
+* **Agences de développement web** — votre équipe connaît TypeScript, React,
+ et PostgreSQL. Twenty ouvre le marché des CRM
+ pour vous, sans devoir apprendre APEX ni obtenir de certifications propriétaires.
+
+## Pour qui Twenty n’est pas fait
+
+* **Équipes qui veulent un CRM auquel elles n’aient jamais à penser.** Twenty récompense les équipes qui veulent rester proches de
+ leurs outils et les façonner dans la durée. Si vous voulez
+ quelque chose de totalement géré, Pipedrive ou
+ HubSpot vous conviendront très bien.
+* **Entreprises qui ont besoin dès aujourd’hui de centaines d’intégrations prêtes à l’emploi.** Notre écosystème grandit vite, mais il n’est pas encore
+ aussi vaste que celui de Salesforce ou HubSpot. Si vous êtes à l’aise
+ pour construire ce qui manque, vous allez adorer. Sinon, laissez-nous
+ encore un an.
+* **Organisations où les outils sont choisis en salle de conseil,
+ et non par les personnes qui les utilisent.** Nous ne faisons pas de dîners au steak
+ ni de briefings pour dirigeants. Nous gagnons avec les équipes qui ont
+ le pouvoir de choisir leurs propres outils.
+
+
+ Configurez Twenty en moins de 5 minutes — dans le cloud ou en auto-hébergement.
+
diff --git a/packages/twenty-docs/l/fr/getting-started/key-features.mdx b/packages/twenty-docs/l/fr/getting-started/key-features.mdx
new file mode 100644
index 0000000000..3960ee2b37
--- /dev/null
+++ b/packages/twenty-docs/l/fr/getting-started/key-features.mdx
@@ -0,0 +1,70 @@
+---
+title: Fonctionnalités clés
+description: Un tour d’horizon de tout ce que Twenty peut faire — des modèles de données personnalisés à l’automatisation alimentée par l’IA.
+icon: étoile
+---
+
+import { CardTitle } from "/snippets/card-title.mdx"
+
+Twenty est une plateforme CRM complète. Voici ce que vous pouvez créer avec.
+
+
+
+ Modèle de données personnalisé
+ Définissez exactement la structure de données dont votre entreprise a besoin.
+ Créez des objets personnalisés, ajoutez des champs personnalisés avec plus de 20 types de champs et créez des relations entre n’importe quels objets.
+
+
+
+ Vues et pipelines
+ Basculez entre des vues en tableau, des tableaux kanban et des vues de calendrier.
+ Filtrez avec une logique AND/OR, triez par plusieurs champs, regroupez les enregistrements et enregistrez des vues personnalisées.
+
+
+
+ Workflows et automatisation
+ Automatisez n’importe quel processus métier sans écrire de code.
+ Déclenchez des workflows lors de modifications d’enregistrements, selon des plannings, par actions manuelles ou par webhooks entrants.
+
+
+
+ Synchronisation calendrier et e-mail
+ Connectez votre compte Google Workspace ou Microsoft 365.
+ Les e-mails et les événements de calendrier apparaissent automatiquement sur les enregistrements CRM concernés.
+
+
+
+ IA
+ Des agents IA qui travaillent de manière autonome dans votre CRM — répondant aux questions, enrichissant les enregistrements et exécutant des tâches multi-étapes au sein de votre modèle d’autorisations.
+
+
+
+ Tableaux de bord et rapports
+ Créez des tableaux de bord personnalisés avec des widgets en temps réel.
+ Suivez les métriques de pipeline, la performance des équipes et les KPI métier avec des graphiques et des filtres configurables.
+
+
+
+ Permissions et contrôle d’accès
+ Contrôle d’accès basé sur les rôles à tous les niveaux — objets, champs et enregistrements individuels.
+ Configurez le SSO avec SAML ou OIDC. Les journaux d’audit suivent qui a fait quoi.
+
+
+
+ API et extensibilité
+ Une API conçue pour les développeurs qui s’adapte à votre modèle de données personnalisé.
+ GraphQL et REST sont tous deux disponibles, avec une documentation auto-générée par espace de travail.
+
+
+
+ Importation et exportation de données
+ Importez des données à partir de fichiers CSV ou via API.
+ Cartographie des champs, détection des doublons et gestion des erreurs intégrées. Exportez vos données à tout moment — sans verrouillage.
+
+
+
+ Auto-hébergement
+ Exécutez Twenty sur votre propre infrastructure avec une seule commande Docker Compose.
+ Contrôle total sur vos données, mises à jour selon votre planning.
+
+
diff --git a/packages/twenty-docs/l/fr/getting-started/quickstart.mdx b/packages/twenty-docs/l/fr/getting-started/quickstart.mdx
new file mode 100644
index 0000000000..33c646a024
--- /dev/null
+++ b/packages/twenty-docs/l/fr/getting-started/quickstart.mdx
@@ -0,0 +1,73 @@
+---
+title: Démarrage rapide
+description: Mettez Twenty en route en moins de 5 minutes, sur le cloud ou en auto‑hébergement.
+icon: play
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+## Inscription
+
+
+
+ Accédez à [app.twenty.com](https://app.twenty.com) et inscrivez-vous avec Google, Microsoft ou une adresse e-mail.
+
+
+ Choisissez **30 jours** (avec carte) ou **7 jours** (sans carte). Les deux incluent un accès complet — contacts illimités, intégration e-mail, objets personnalisés, API. Vous pouvez changer de formule ou d’intervalle de facturation à tout moment.
+
+
+ Après la confirmation du paiement via Stripe, vous configurerez le nom de votre espace de travail et votre profil utilisateur. Vous pouvez annuler à tout moment.
+
+
+
+
+
+## Configurez votre espace de travail
+
+Une fois que vous êtes connecté, trois étapes pour faire de Twenty votre outil :
+
+### 1. Connectez votre boîte mail
+
+Accédez à **Paramètres → Comptes** et connectez votre compte Google ou Microsoft. Twenty importera vos e-mails et événements de calendrier, et créera automatiquement des contacts à partir des interactions. Vous utilisez un autre fournisseur ? Vous pouvez ajouter des boîtes mail via SMTP ou des calendriers via CalDAV depuis la même page.
+
+Commencez ici — connecter une boîte mail donne à votre équipe une valeur immédiate avec des données réelles avant de personnaliser quoi que ce soit d’autre.
+
+
+
+### 2. Définissez votre modèle de données
+
+Accédez à **Paramètres → Modèle de données** pour créer des objets et des champs personnalisés. Quelques points à connaître :
+
+* Les objets et champs personnalisés sont **illimités sur toutes les formules** — sans surcoût.
+* **Personnes, Entreprises et Opportunités** sont les objets qui affichent les e-mails et réunions synchronisés. Utilisez-les comme base et ajoutez des champs pour catégoriser (par exemple, un champ `Person Type`) plutôt que de créer des objets séparés qui n’auront pas d’historique d’e-mails.
+* Deux personnes ne peuvent pas partager la même adresse e-mail. Deux entreprises ne peuvent pas partager le même domaine.
+* Vous pouvez désactiver les champs/objets standard dont vous n’avez pas besoin et masquer des champs dans les vues sans les supprimer.
+
+[Référence du modèle de données →](/l/fr/user-guide/data-model/overview)
+
+
+
+### 3. Importez vos données
+
+Utilisez le menu Commande (`Cmd+K` / `Ctrl+K`) pour importer des Personnes, Entreprises, Opportunités ou tout objet personnalisé via CSV. Téléchargez d’abord le fichier exemple pour voir le format attendu. Limitez les fichiers à 10 000 enregistrements et dédupliquez les e-mails/domaines avant l’import.
+
+[Guide de migration des données →](/l/fr/user-guide/data-migration/overview)
+
+
+
+## Prochaines étapes
+
+
+
+ Navigation, vues, menu de commandes, panneau latéral.
+
+
+ Automatisez vos processus métier.
+
+
+ Tableau, kanban, calendrier — filtrez et triez vos données.
+
+
+ Schéma par locataire, REST et GraphQL.
+
+
diff --git a/packages/twenty-docs/l/it/getting-started/core-concepts/ai.mdx b/packages/twenty-docs/l/it/getting-started/core-concepts/ai.mdx
new file mode 100644
index 0000000000..63edc090ec
--- /dev/null
+++ b/packages/twenty-docs/l/it/getting-started/core-concepts/ai.mdx
@@ -0,0 +1,34 @@
+---
+title: AI
+description: Come Twenty utilizza l'IA per migliorare la tua esperienza CRM.
+icon: robot
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+Twenty integra l'IA direttamente nel tuo CRM — non come un espediente, ma come uno strumento che funziona all'interno del tuo modello di dati e del tuo sistema di autorizzazioni.
+
+## Chatbot con IA
+
+Fai domande sui tuoi dati in linguaggio naturale. Il chatbot con IA può interrogare i record del tuo CRM, riassumere le informazioni e aiutarti a trovare ciò che stai cercando senza creare filtri complessi.
+
+
+
+## Agenti AI
+
+Gli agenti con IA vanno oltre la semplice chat — possono eseguire autonomamente attività multi-step:
+
+* Arricchisci i record con dati provenienti da fonti esterne
+* Scrivi e invia email di follow-up
+* Analizza lo stato della pipeline e segnala le trattative a rischio
+* Elabora i dati in arrivo e instradali al team corretto
+
+Gli agenti lavorano all'interno dei tuoi workflow esistenti, così puoi combinare l'IA con approvazioni manuali, logica condizionale e chiamate API esterne.
+
+## Autorizzazioni & sicurezza
+
+L'IA in Twenty rispetta il tuo modello di autorizzazioni. Gli agenti possono accedere solo a oggetti e campi che l'utente (o il ruolo) ha l'autorizzazione a visualizzare. I dati sensibili rimangono protetti anche quando è coinvolta l'IA.
+
+
+ Riferimento dettagliato sul chatbot, sugli agenti e sui controlli delle autorizzazioni.
+
diff --git a/packages/twenty-docs/l/it/getting-started/core-concepts/apps.mdx b/packages/twenty-docs/l/it/getting-started/core-concepts/apps.mdx
new file mode 100644
index 0000000000..9f7e8ba5bc
--- /dev/null
+++ b/packages/twenty-docs/l/it/getting-started/core-concepts/apps.mdx
@@ -0,0 +1,41 @@
+---
+title: App
+icon: cube
+description: Estendi Twenty con il codice — oggetti personalizzati, logica lato server, componenti UI e agenti IA, tutti come pacchetti TypeScript.
+---
+
+La maggior parte dei CRM ti offre un pannello di configurazione. Twenty ti offre una piattaforma. Le app sono il modo in cui gli sviluppatori estendono Twenty oltre ciò che offre la UI — definendo modelli di dati, logica lato server, componenti UI e funzionalità di IA come codice, quindi distribuendoli a uno o più workspace.
+
+## Perché esistono le app
+
+I flussi di lavoro coprono l’automazione no-code. Ma alcune cose richiedono codice: un motore di prezzi personalizzato, una pipeline di arricchimento proprietaria, un controllo di conformità che viene eseguito a ogni aggiornamento di un record, un pannello UI personalizzato che recupera dati da uno strumento interno.
+
+Le app ti permettono di creare questi elementi come estensioni di prima classe — non script fragili che parlano con un’API dall’esterno, ma codice che viene eseguito sulla piattaforma con pieno accesso al sistema di tipi, al modello di autorizzazioni e all’interfaccia utente.
+
+## Cosa può definire un’app
+
+Un’app è un pacchetto TypeScript che dichiara **entità** utilizzando `twenty-sdk`:
+
+| Entità | Cosa fa |
+| ------------------------ | --------------------------------------------------------------------------------------------------------------------------- |
+| **Oggetti e campi** | Nuove tabelle di dati e campi su oggetti esistenti — stesso trattamento di quelli integrati |
+| **Funzioni logiche** | TypeScript lato server attivato da route HTTP, pianificazioni cron o eventi del database |
+| **Componenti front-end** | Componenti React sandboxed che vengono renderizzati all'interno dell'UI di Twenty (pannello laterale, widget, menu comandi) |
+| **Skill e agenti** | Funzionalità di IA — istruzioni riutilizzabili e assistenti autonomi |
+| **Viste e navigazione** | Viste elenco preconfigurate e voci di menu della barra laterale |
+
+Tutto viene rilevato tramite analisi AST in fase di build — nessun file di configurazione, nessun boilerplate di registrazione. Inserisci un `export default defineObject(...)` in qualsiasi file `.ts` e l'SDK lo rileva.
+
+## Come vengono eseguite
+
+* **Le funzioni logiche** vengono eseguite in processi Node.js isolati, sandboxed rispetto all'host. Accedono ai dati tramite un client API tipizzato con ambito limitato alle autorizzazioni del ruolo dell'app.
+* **I componenti front-end** vengono eseguiti in Web Workers utilizzando il Remote DOM — isolati dalla pagina principale ma renderizzando elementi DOM nativi (non iframe).
+* **Le autorizzazioni** vengono applicate a livello di API. Un'app vede solo ciò che il suo ruolo consente.
+
+## L'esperienza di sviluppo
+
+Scrivi la tua app come un progetto TypeScript sulla tua macchina. La CLI osserva i file sorgente e li sincronizza in tempo reale con un server Twenty in esecuzione — modifica un file e vedi il cambiamento nell'UI entro un secondo. Il client API tipizzato viene rigenerato automaticamente quando lo schema cambia. Quando sei pronto, `yarn twenty app:publish --private` esegue il push su un server di produzione, oppure `yarn twenty app:publish` elenca la tua app su npm e sul marketplace di Twenty.
+
+
+ Procedura guidata in tre fasi — crea lo scaffold, esegui un server locale, sincronizza le tue modifiche.
+
diff --git a/packages/twenty-docs/l/it/getting-started/core-concepts/calendar-and-email.mdx b/packages/twenty-docs/l/it/getting-started/core-concepts/calendar-and-email.mdx
new file mode 100644
index 0000000000..171af52186
--- /dev/null
+++ b/packages/twenty-docs/l/it/getting-started/core-concepts/calendar-and-email.mdx
@@ -0,0 +1,46 @@
+---
+title: Calendario & Email
+description: Sincronizza la tua email e il tuo calendario con Twenty.
+icon: envelope
+---
+
+Twenty si collega ai tuoi strumenti esistenti così che il tuo CRM rimanga aggiornato senza inserimento manuale dei dati.
+
+## Sincronizzazione email
+
+Collega la tua casella di posta di **Google Workspace** o **Microsoft 365**. Una volta connesso:
+
+* Le email vengono collegate automaticamente ai relativi record di Aziende e Persone
+* Le conversazioni email complete sono visibili nella timeline di ogni record
+* Puoi inviare email direttamente da Twenty
+* Sono supportate più caselle di posta per utente
+
+Controlli tu cosa viene importato — filtra per intervallo di date o mittente per evitare di importare email irrilevanti.
+
+## Sincronizzazione del calendario
+
+Gli eventi del calendario vengono sincronizzati automaticamente dal tuo account connesso. Gli eventi compaiono sui relativi record del CRM, offrendoti una visione completa delle tue interazioni con ogni contatto o azienda.
+
+## Integrazioni
+
+Oltre a email e calendario, Twenty si collega a strumenti esterni tramite:
+
+| Metodo | Caso d'uso |
+| ---------------------------- | ------------------------------------------------------------------------- |
+| **API** | Crea integrazioni personalizzate con l'API GraphQL o REST |
+| **Webhooks** | Invia notifiche in tempo reale a sistemi esterni quando i record cambiano |
+| **Zapier** | Connettiti a più di 5.000 app senza codice |
+| **Azioni HTTP dei workflow** | Chiama qualsiasi API esterna come parte di un workflow automatizzato |
+
+## App personalizzate
+
+Gli sviluppatori possono creare app complete su Twenty, aggiungendo UI personalizzata, logica lato server e integrazioni avanzate. Le app possono essere pubblicate per la community o mantenute private.
+
+
+
+ Configura la sincronizzazione delle email e del calendario e risolvi eventuali problemi.
+
+
+ Crea integrazioni personalizzate con l'API di Twenty.
+
+
diff --git a/packages/twenty-docs/l/it/getting-started/core-concepts/dashboards.mdx b/packages/twenty-docs/l/it/getting-started/core-concepts/dashboards.mdx
new file mode 100644
index 0000000000..a02cbdc470
--- /dev/null
+++ b/packages/twenty-docs/l/it/getting-started/core-concepts/dashboards.mdx
@@ -0,0 +1,37 @@
+---
+title: Cruscotti
+description: Monitora le prestazioni e visualizza i dati del tuo CRM con dashboard personalizzate.
+icon: chart-bar
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+Le dashboard ti offrono visibilità in tempo reale sulle metriche della tua attività — stato della pipeline, prestazioni del team, trend dei ricavi e qualsiasi altra cosa tu voglia monitorare.
+
+
+
+## Widget
+
+Ogni dashboard è composta da widget. Un widget è un singolo grafico o una singola metrica collegata ai tuoi dati del CRM. Puoi configurare:
+
+* **Tipo di grafico** — Barre, linee, torta, numerico e altro ancora
+* **Fonte dati** — Qualsiasi oggetto nel tuo modello dati (standard o personalizzato)
+* **Filtri** — Restringi a record specifici, intervalli di date o segmenti
+* **Aggregazione** — Conteggio, somma, media, minimo, massimo su qualsiasi campo numerico
+* **Raggruppamento** — Suddividi per campi selezionati, date o relazioni
+
+## Cosa puoi monitorare
+
+* Valore della pipeline per fase
+* Offerte chiuse nel tempo
+* Dimensione media dell’offerta per fonte
+* Tassi di completamento delle attività
+* Metriche personalizzate su qualsiasi oggetto
+
+## Condivisione
+
+Le dashboard sono a livello di spazio di lavoro — tutti nel tuo team possono vederle. Disponi i widget in una griglia e ridimensionali per creare la visualizzazione che funziona per il tuo team.
+
+
+ Riferimento dettagliato sulla creazione di dashboard, sulla configurazione dei widget e sulle impostazioni dei grafici.
+
diff --git a/packages/twenty-docs/l/it/getting-started/core-concepts/data-model.mdx b/packages/twenty-docs/l/it/getting-started/core-concepts/data-model.mdx
new file mode 100644
index 0000000000..d1b551d8dd
--- /dev/null
+++ b/packages/twenty-docs/l/it/getting-started/core-concepts/data-model.mdx
@@ -0,0 +1,47 @@
+---
+title: Modello dati
+description: Comprendi come Twenty struttura i tuoi dati con oggetti, campi e relazioni.
+icon: database
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+Tutto in Twenty è costruito attorno a **oggetti** e **campi**, i mattoni fondamentali del tuo modello di dati.
+
+## Oggetti
+
+Gli oggetti sono le tabelle che contengono i tuoi dati. Twenty include oggetti standard pronti all’uso:
+
+* **Aziende** — Organizzazioni con cui fai affari
+* **Persone** — Contatti individuali
+* **Opportunità** — Trattative nella tua pipeline
+* **Attività** — Elementi di azione per il tuo team
+* **Note** — Testo libero collegato ai record
+
+Puoi anche creare **oggetti personalizzati** per qualsiasi esigenza della tua azienda: progetti, ticket di supporto, prodotti, contratti o qualsiasi altra cosa.
+
+## Campi
+
+I campi sono le proprietà su ciascun oggetto. Twenty supporta un’ampia gamma di tipi di campo:
+
+| Categoria | Tipi |
+| ------------- | ------------------------------------------------------------------------ |
+| **Di base** | Testo, Numero, Booleano, Data, Valuta, Valutazione, Selezione |
+| **Composito** | Indirizzo (via, città, stato, CAP), Nome completo, Link, Telefoni, Email |
+| **Speciale** | Relazione, Allegato file, JSON, Attore (chi ha creato/modificato) |
+
+Ogni oggetto ottiene anche campi di sistema automatici: `id`, `createdAt`, `updatedAt`, `createdBy` e `position`.
+
+## Relazioni
+
+Gli oggetti si collegano tra loro tramite relazioni. Un’Azienda ha molte Persone, un’Opportunità appartiene a un’Azienda e così via. Puoi creare relazioni personalizzate tra qualsiasi oggetto, incluse relazioni molti-a-molti.
+
+## Cosa rende tutto questo potente
+
+A differenza dei CRM tradizionali, in cui sei limitato a campi predefiniti su oggetti predefiniti, Twenty ti permette di modellare i tuoi dati esattamente come funziona la tua azienda. Gli oggetti personalizzati ricevono lo stesso trattamento di prima classe di quelli integrati, inclusi endpoint API, viste, autorizzazioni e trigger di workflow.
+
+
+ Riferimento completo su oggetti, campi, relazioni e su come configurarli.
+
+
+
diff --git a/packages/twenty-docs/l/it/getting-started/core-concepts/glossary.mdx b/packages/twenty-docs/l/it/getting-started/core-concepts/glossary.mdx
new file mode 100644
index 0000000000..ba9d266fce
--- /dev/null
+++ b/packages/twenty-docs/l/it/getting-started/core-concepts/glossary.mdx
@@ -0,0 +1,105 @@
+---
+title: Glossario
+icon: book
+description: Termini chiave utilizzati in tutto Twenty.
+---
+
+## API
+
+Le API (Interfaccia di Programmazione delle Applicazioni) ti consentono di connettere Twenty con altri sistemi software e creare integrazioni personalizzate.
+
+## App
+
+Le app sono estensioni personalizzate sviluppate sotto forma di codice che possono definire modelli di dati e funzioni di logica. Consentono agli sviluppatori di creare personalizzazioni riutilizzabili che possono essere distribuite in più spazi di lavoro.
+
+## Azioni di codice
+
+Le Azioni di codice sono passaggi del flusso di lavoro che ti permettono di scrivere JavaScript personalizzato per trasformare i dati, eseguire calcoli o applicare logiche complesse non possibili con le azioni predefinite.
+
+## Menu Comandi
+
+Il Menu Comandi è un'interfaccia di accesso rapido (aperta con `Cmd + K` su Mac e `Ctrl + K` su Windows) che ti consente di eseguire azioni, creare record e navigare nel tuo workspace in modo efficiente.
+
+## Azienda & Persone
+
+Il CRM ha due tipi fondamentali di record:
+
+* Una `Company` rappresenta un'azienda o un'organizzazione.
+* Le `People` rappresentano i clienti attuali e potenziali della tua azienda.
+
+## Campi Personalizzati
+
+I Campi Personalizzati sono campi di dati che crei per catturare informazioni specifiche alle esigenze e ai processi della tua azienda.
+
+## Modello dati
+
+Un Modello di Dati è la struttura che definisce come le informazioni sono organizzate nel tuo CRM, inclusi quali oggetti esistono, le loro proprietà (campi) e come sono correlati tra loro.
+
+## Preferiti
+
+I Preferiti sono record che hai contrassegnato per un accesso rapido, apparendo nella tua barra laterale per una navigazione istantanea ai dati importanti.
+
+## Campo
+
+Un campo si riferisce a un'area specifica dove sono memorizzati dati particolari per un'entità.
+
+## Iteratore
+
+Un Iterator è un'azione del flusso di lavoro che itera su un array di elementi, eseguendo le azioni successive per ciascun elemento nell'elenco.
+
+## Kanban
+
+Un `Kanban` è un modo visivo per monitorare i tuoi processi aziendali utilizzando carte e colonne. Ogni colonna rappresenta una fase nel tuo processo (ad esempio: nuovo, in corso, vinto, perso), e sposti i record attraverso queste fasi man mano che progrediscono.
+
+## Oggetto
+
+Un Oggetto è una struttura dati che rappresenta un tipo specifico di entità nel tuo CRM (come Persone, Aziende o Opportunità). Gli Oggetti possono essere standard (di sistema) o personalizzati (creati da te).
+
+## Opportunità
+
+Le Opportunità in Twenty CRM sono potenziali accordi o vendite con aziende o contatti.
+
+## Record
+
+Un Record indica un'istanza di un oggetto, come una specifica azienda o un contatto.
+
+## Campi di Relazione
+
+I campi di relazione creano connessioni tra oggetti diversi, consentendo di collegare i record tra loro (ad esempio collegare una Persona a un'Azienda).
+
+## Campi Standard
+
+I Campi Standard sono campi dati predefiniti che vengono forniti con oggetti di default e forniscono funzionalità comuni in tutti i workspace.
+
+## Attività
+
+Le Attività in Twenty CRM sono attività assegnate relative a contatti, aziende o opportunità.
+
+## Trigger
+
+I trigger sono il punto di partenza di un flusso di lavoro — l'evento o la condizione che avvia l'automazione. Esempi includono la creazione di record, l'aggiornamento di record, i webhook o orari pianificati.
+
+## Viste
+
+Puoi personalizzare la visualizzazione dei tuoi record usando le viste, impostando diversi filtri, layout e opzioni di ordinamento per ciascuna vista.
+
+## Upsert
+
+Upsert è un'operazione che combina "update" e "insert" — aggiorna un record esistente se viene trovata una corrispondenza, oppure crea un nuovo record se non esiste alcuna corrispondenza.
+
+## Webhooks
+
+I webhook sono messaggi automatici inviati da Twenty ad altre applicazioni quando si verificano eventi specifici, consentendo la sincronizzazione dei dati in tempo reale.
+
+## Flussi di lavoro
+
+I Flussi di Lavoro sono processi automatizzati che attivano azioni in base a condizioni specifiche, aiutandoti ad automatizzare attività ripetitive e processi aziendali.
+
+## Workspace
+
+Un `Workspace` rappresenta tipicamente un'azienda che utilizza Twenty. Contiene tutti i record e i dati che tu e i membri del tuo team aggiungete a Twenty.
+Ha un singolo nome di dominio, che di solito è il nome di dominio che la tua azienda usa per gli indirizzi email dei dipendenti.
+
+## Membri del Workspace
+
+I Membri del Workspace sono gli utenti di Twenty del tuo team che hanno accesso al tuo Workspace. Possono essere assegnati come proprietari o assegnatari per i record.
diff --git a/packages/twenty-docs/l/it/getting-started/core-concepts/layout.mdx b/packages/twenty-docs/l/it/getting-started/core-concepts/layout.mdx
new file mode 100644
index 0000000000..e190b1a0ab
--- /dev/null
+++ b/packages/twenty-docs/l/it/getting-started/core-concepts/layout.mdx
@@ -0,0 +1,74 @@
+---
+title: Layout
+description: Come navigare, esplorare e visualizzare i record in Twenty.
+icon: table-columns
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+## Il layout principale
+
+Il centro dello schermo è dove vivono i tuoi record — persone, aziende, opportunità, attività, note, dashboard, workflow e qualsiasi oggetto personalizzato. Qui visualizzi, modifichi ed elimini i record e crei nuove viste.
+
+
+
+## Barra di navigazione
+
+La barra laterale sinistra ti offre:
+
+* **Selettore dello spazio di lavoro** — passa da uno spazio di lavoro all'altro o creane uno nuovo (menu a discesa in alto)
+* **Ricerca** — premi `/` per metterla subito a fuoco, esegue ricerche su tutti gli oggetti
+* **Impostazioni** — accesso dall'angolo in alto a sinistra
+* **Preferiti** — viste aggiunte ai preferiti, uniche per ogni utente
+* **Scorciatoie oggetti** — accesso rapido a Persone, Aziende, Opportunità, ecc.
+* **Workflow** — crea automazioni
+
+Trascina gli elementi per riordinarli, crea cartelle per raggruppare oggetti correlati, nascondi ciò che non usi.
+
+
+
+## Menu Comandi
+
+Premi `Cmd+K` (Mac) o `Ctrl+K` (Windows), oppure fai clic sui tre puntini in alto a destra. Da qui puoi:
+
+* Crea nuovi record
+* Importa ed esporta dati tramite CSV
+* Crea nuove viste
+* Accedi ai record eliminati (Twenty supporta eliminazioni temporanee e definitive)
+* Consulta le scorciatoie da tastiera per navigare nel tuo spazio di lavoro
+
+
+
+## Cerca
+
+Accessibile tramite il Command Menu, la parte superiore della barra di navigazione o premendo `/`. La ricerca funziona su tutti gli oggetti.
+
+
+
+## Pannello laterale
+
+Fai clic su un record per aprire il pannello laterale a destra: una panoramica rapida delle informazioni chiave del record senza lasciare la pagina corrente. Fai clic su **Open** per andare alla pagina completa del record.
+
+
+
+## Viste
+
+Ogni oggetto supporta più viste — illimitate per oggetto. Usa il menu a discesa in alto a sinistra per passare da una vista all'altra.
+
+* **Tabella** — righe e colonne in stile foglio di calcolo, con raggruppamenti, modifica in linea e personalizzazione delle colonne
+* **Kanban** — schede drag-and-drop organizzate in base a un campo di tipo select, ideale per le pipeline
+* **Calendario** — record posizionati su una linea temporale in base a un campo data, per pianificazioni basate sul tempo
+
+Ogni vista salva i propri filtri, l'ordinamento e la visibilità dei campi. Condividi le viste con il tuo spazio di lavoro o mantienile private. Aggiungi le viste ai preferiti per un accesso rapido dalla barra laterale.
+
+
+
+## Pagine dei record
+
+Quando apri un record, la pagina dei dettagli è composta da **schede** e **widget** configurabili. Aggiungi, rimuovi, riordina e ridimensiona i widget in una griglia — campi, record correlati, email, timeline, attività, note, file, grafici, iframe e altro ancora. Ogni tipo di oggetto ha il proprio layout.
+
+
+ Navigazione, viste, pagine dei record — guida di riferimento dettagliata e istruzioni pratiche.
+
+
+
diff --git a/packages/twenty-docs/l/it/getting-started/core-concepts/workflows.mdx b/packages/twenty-docs/l/it/getting-started/core-concepts/workflows.mdx
new file mode 100644
index 0000000000..c573db3b4d
--- /dev/null
+++ b/packages/twenty-docs/l/it/getting-started/core-concepts/workflows.mdx
@@ -0,0 +1,55 @@
+---
+title: Flussi di lavoro
+description: Automatizza i processi aziendali con il builder di workflow visivi di Twenty.
+icon: bolt
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+I workflow ti permettono di automatizzare attività ripetitive e collegare Twenty a strumenti esterni, senza scrivere codice (anche se puoi farlo se vuoi).
+
+
+
+## Come funzionano i workflow
+
+Ogni workflow è composto da tre parti:
+
+1. **Trigger** — Cosa avvia il workflow
+2. **Steps** — Cosa succede dopo (una o più azioni in sequenza)
+3. **Variables** — Dati che fluiscono tra gli step
+
+## Trigger
+
+| Scatenante | Quando viene attivato |
+| ---------------- | ------------------------------------------------------------------------------------------ |
+| **Record event** | Un record viene creato, aggiornato, eliminato o eseguito come upsert |
+| **Manuale** | Un utente fa clic su un pulsante (su un singolo record, su più record o a livello globale) |
+| **Schedule** | A intervalli ricorrenti (sintassi cron) |
+| **Webhook** | Un sistema esterno invia una HTTP POST |
+
+## Azioni
+
+I workflow possono concatenare qualsiasi combinazione di:
+
+* **Record operations** — Crea, aggiorna, trova, elimina o esegui upsert sui record
+* **Send email** — Invia o prepara bozze di email dagli account collegati
+* **HTTP request** — Chiama qualsiasi API esterna
+* **Code** — Esegui JavaScript personalizzato per logiche complesse
+* **Branches** — Condizioni if/else per dividere il percorso del workflow
+* **Iterator** — Itera sugli array di dati
+* **AI Agent** — Consenti a un agente AI di elaborare i dati in modo autonomo
+* **Delay** — Attendi prima di continuare
+* **Form** — Raccogli input dell’utente a metà workflow
+
+## Cosa puoi creare
+
+* Invia avvisi Slack quando un deal raggiunge una certa fase
+* Arricchisci automaticamente i nuovi contatti con dati provenienti da API esterne
+* Rileva le opportunità inattive e avvisa il proprietario
+* Sincronizza i dati tra Twenty e il tuo sistema di fatturazione
+* Genera PDF o fatture dai dati dei record
+* Invia risposte automatiche alle email in arrivo che corrispondono a determinati criteri
+
+
+ Riferimento dettagliato su trigger, azioni, variabili e casi d’uso reali di automazione.
+
diff --git a/packages/twenty-docs/l/it/getting-started/introduction.mdx b/packages/twenty-docs/l/it/getting-started/introduction.mdx
new file mode 100644
index 0000000000..7fd07e52c1
--- /dev/null
+++ b/packages/twenty-docs/l/it/getting-started/introduction.mdx
@@ -0,0 +1,72 @@
+---
+title: Perché Twenty
+icon: heart
+---
+
+import { CardTitle } from "/snippets/card-title.mdx"
+
+Hai sempre dovuto scegliere tra software facili da iniziare a usare ma impossibili da modificare, e software flessibili ma che richiedono mesi per essere configurati. Twenty è la terza opzione: **un CRM pronto per la produzione che puoi rimodellare man mano che procedi.**
+
+## Cosa rende Twenty diverso
+
+Twenty è una piattaforma su cui puoi costruire, non un prodotto che configuri.
+
+
+
+ Creato per gli agenti
+ Gli agenti operano all'interno del tuo modello di dati con permessi reali. Competenze, strumenti, MCP.
+
+
+ Estendibilità sicura
+ La flessibilità degli strumenti vibe-coded su fondamenta sicure.
+
+
+ Stack moderno
+ React, TypeScript. Il tuo team sa già come estendere Twenty. Nessun linguaggio proprietario, nessun gatekeeping.
+
+
+ Nessun lock-in
+ Core open source, self-hostable, puoi esportare i tuoi dati in qualsiasi momento.
+
+
+
+## Per chi è Twenty
+
+* **Grandi aziende che sostituiscono Salesforce** — il tuo team
+ passa più tempo a lottare contro lo strumento che a usarlo.
+ Ti senti in lock-in e i costi continuano ad aumentare.
+* **Startup con founder tecnici** — hai superato i limiti di
+ fogli di calcolo e Notion. Hai grandi ambizioni e vuoi
+ un CRM che cresca con te.
+* **Team GTM in cerca di un vantaggio competitivo** — vuoi creare
+ il tuo lead scoring, il tuo enrichment, i tuoi
+ workflow in uscita.
+* **Organizzazioni attente alla privacy** — devi
+ effettuare il self-hosting e possedere i tuoi dati end-to-end. Per motivi normativi,
+ contrattuali o semplicemente di principio.
+* **Partner Salesforce** —
+ i tuoi sviluppatori sono stanchi di presentare aumenti dei costi di licenza ai tuoi clienti.
+ Vuoi una DX migliore e consegnare progetti più velocemente a un costo di licenza inferiore per i tuoi clienti.
+* **Agenzie di sviluppo web** — il tuo team conosce TypeScript, React,
+ e PostgreSQL. Twenty apre per te il mercato dei CRM
+ senza dover imparare APEX o ottenere certificazioni proprietarie.
+
+## Per chi non è Twenty
+
+* **Team che vogliono un CRM di cui non dover mai
+ preoccuparsi.** Twenty premia i team che vogliono restare vicini ai
+ propri strumenti e plasmarli nel tempo. Se vuoi
+ qualcosa di completamente gestito, Pipedrive o
+ HubSpot andranno benissimo.
+* **Aziende che oggi hanno bisogno di centinaia di integrazioni predefinite.** Il nostro ecosistema sta crescendo rapidamente, ma non è ancora
+ così ampio come Salesforce o HubSpot. Se ti senti a tuo agio
+ a costruire ciò che manca, lo amerai. Altrimenti, concedici
+ un altro anno.
+* **Organizzazioni in cui gli strumenti vengono scelti nelle sale riunioni,
+ non da chi li utilizza.** Non facciamo cene di gala
+ e briefing esecutivi. Vinciamo con i team che hanno
+ l'autorità di scegliere i propri strumenti.
+
+
+ Configura Twenty in meno di 5 minuti — sul cloud o in modalità self-hosted.
+
diff --git a/packages/twenty-docs/l/it/getting-started/key-features.mdx b/packages/twenty-docs/l/it/getting-started/key-features.mdx
new file mode 100644
index 0000000000..e727a57b78
--- /dev/null
+++ b/packages/twenty-docs/l/it/getting-started/key-features.mdx
@@ -0,0 +1,70 @@
+---
+title: Caratteristiche principali
+description: Una panoramica di tutto ciò che Twenty può fare — dai modelli di dati personalizzati all’automazione basata sull’AI.
+icon: star
+---
+
+import { CardTitle } from "/snippets/card-title.mdx"
+
+Twenty è una piattaforma CRM completa di tutte le funzionalità. Ecco cosa puoi creare con essa.
+
+
+
+ Modello di dati personalizzato
+ Definisci l’esatta struttura dei dati di cui la tua azienda ha bisogno.
+ Crea oggetti personalizzati, aggiungi campi personalizzati con oltre 20 tipi di campo e crea relazioni tra qualsiasi oggetto.
+
+
+
+ Viste e pipeline
+ Passa da viste tabellari, bacheche Kanban e viste calendario.
+ Filtra con logica AND/OR, ordina per più campi, raggruppa i record e salva viste personalizzate.
+
+
+
+ Workflow e automazione
+ Automatizza qualsiasi processo aziendale senza scrivere codice.
+ Attiva i workflow in base alle modifiche ai record, alle pianificazioni, alle azioni manuali o ai webhooks in ingresso.
+
+
+
+ Sincronizzazione calendario ed email
+ Collega il tuo account Google Workspace o Microsoft 365.
+ Email e eventi di calendario compaiono automaticamente sui relativi record CRM.
+
+
+
+ AI
+ Agenti AI che lavorano in modo autonomo all’interno del tuo CRM — rispondendo alle domande, arricchendo i record ed eseguendo attività multi-step all’interno del tuo modello di autorizzazioni.
+
+
+
+ Dashboard e reportistica
+ Crea dashboard personalizzate con widget in tempo reale.
+ Monitora le metriche della pipeline, le performance del team e le KPI aziendali con grafici e filtri configurabili.
+
+
+
+ Permessi e controllo accessi
+ Controllo degli accessi basato sui ruoli a ogni livello — oggetti, campi e singoli record.
+ Configura SSO con SAML o OIDC. I log di audit tracciano chi ha fatto cosa.
+
+
+
+ API ed estendibilità
+ Un’API a misura di sviluppatore che si adatta al tuo modello di dati personalizzato.
+ Endpoint sia GraphQL che REST, con documentazione generata automaticamente per ogni workspace.
+
+
+
+ Importazione ed esportazione dei dati
+ Importa dati da file CSV o tramite API.
+ Mapping dei campi, rilevamento dei duplicati e gestione degli errori integrati. Esporta i tuoi dati in qualsiasi momento — nessun vincolo.
+
+
+
+ Self-hosting
+ Esegui Twenty sulla tua infrastruttura con un singolo comando Docker Compose.
+ Pieno controllo sui tuoi dati, aggiornamenti in base alla tua pianificazione.
+
+
diff --git a/packages/twenty-docs/l/it/getting-started/quickstart.mdx b/packages/twenty-docs/l/it/getting-started/quickstart.mdx
new file mode 100644
index 0000000000..3511c71404
--- /dev/null
+++ b/packages/twenty-docs/l/it/getting-started/quickstart.mdx
@@ -0,0 +1,73 @@
+---
+title: Guida rapida
+description: Metti Twenty in funzione in meno di 5 minuti — sul cloud o in modalità self-hosted.
+icon: play
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+## Registrati
+
+
+
+ Vai su [app.twenty.com](https://app.twenty.com) e registrati con Google, Microsoft o email.
+
+
+ Scegli **30 giorni** (con carta) o **7 giorni** (senza carta). Entrambe includono accesso completo — contatti illimitati, integrazione email, oggetti personalizzati, API. Puoi cambiare piano o intervallo di fatturazione in qualsiasi momento.
+
+
+ Dopo la conferma del pagamento tramite Stripe, imposterai il nome del tuo spazio di lavoro e il profilo utente. Puoi annullare in qualsiasi momento.
+
+
+
+
+
+## Configura il tuo spazio di lavoro
+
+Una volta dentro, tre passaggi per rendere Twenty tuo:
+
+### 1. Collega la tua casella di posta
+
+Vai a **Impostazioni → Account** e collega il tuo account Google o Microsoft. Twenty importerà le tue email e gli eventi del calendario e creerà automaticamente contatti dalle interazioni. Stai usando un altro provider? Puoi aggiungere caselle di posta tramite SMTP o calendari tramite CalDAV dalla stessa pagina.
+
+Inizia da qui — collegare una casella di posta offre al tuo team un valore immediato con dati reali prima che tu personalizzi qualsiasi altra cosa.
+
+
+
+### 2. Definisci il tuo modello di dati
+
+Vai a **Settings → Data Model** per creare oggetti e campi personalizzati. Alcune cose da sapere:
+
+* Gli oggetti e i campi personalizzati sono **illimitati in tutti i piani** — nessun upsell.
+* **Persone, Aziende e Opportunità** sono gli oggetti che mostrano email e riunioni sincronizzate. Usali come base e aggiungi campi per categorizzare (ad esempio, un campo `Person Type`) invece di creare oggetti separati che non avranno la cronologia delle email.
+* Due Persone non possono avere la stessa email. Due Aziende non possono avere lo stesso dominio.
+* Puoi disattivare i campi/oggetti standard di cui non hai bisogno e nascondere i campi dalle viste senza eliminarli.
+
+[Riferimento al modello di dati →](/l/it/user-guide/data-model/overview)
+
+
+
+### 3. Importa i tuoi dati
+
+Usa il menu Comando (`Cmd+K` / `Ctrl+K`) per importare Persone, Aziende, Opportunità o qualsiasi oggetto personalizzato tramite CSV. Scarica prima il file di esempio per vedere il formato previsto. Limita i file a 10.000 record e rimuovi i duplicati di email/domini prima di importarli.
+
+[Guida alla migrazione dei dati →](/l/it/user-guide/data-migration/overview)
+
+
+
+## Prossimi passaggi
+
+
+
+ Navigazione, viste, menu comandi, pannello laterale.
+
+
+ Automatizza i tuoi processi aziendali.
+
+
+ Tabella, kanban, calendario — filtra e ordina i tuoi dati.
+
+
+ Schema-per-tenant REST e GraphQL.
+
+
diff --git a/packages/twenty-docs/l/ko/getting-started/core-concepts/ai.mdx b/packages/twenty-docs/l/ko/getting-started/core-concepts/ai.mdx
new file mode 100644
index 0000000000..da5784f820
--- /dev/null
+++ b/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 레코드를 조회하고 정보를 요약하여, 복잡한 필터를 만들지 않고도 원하는 내용을 찾을 수 있도록 도와줍니다.
+
+
+
+## AI 에이전트
+
+AI 에이전트는 단순한 채팅을 넘어, 여러 단계를 포함한 작업을 자율적으로 실행할 수 있습니다:
+
+* 외부 소스의 데이터로 레코드를 보강
+* 후속 이메일을 작성하고 발송
+* 파이프라인 상태를 분석하고 위험 거래를 표시
+* 수신 데이터를 처리하고 적절한 팀으로 라우팅
+
+에이전트는 기존 워크플로 내에서 작동하므로, AI를 수동 승인, 조건부 로직, 외부 API 호출과 결합할 수 있습니다.
+
+## 권한 및 보안
+
+Twenty의 AI는 귀하의 권한 모델을 준수합니다. 에이전트는 사용자(또는 역할)에 조회 권한이 있는 오브젝트와 필드에만 접근할 수 있습니다. 민감한 데이터는 AI가 개입하더라도 계속 보호됩니다.
+
+
+ 챗봇, 에이전트, 권한 제어에 대한 자세한 레퍼런스입니다.
+
diff --git a/packages/twenty-docs/l/ko/getting-started/core-concepts/apps.mdx b/packages/twenty-docs/l/ko/getting-started/core-concepts/apps.mdx
new file mode 100644
index 0000000000..ee0de0682c
--- /dev/null
+++ b/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 마켓플레이스에 게시할 수 있습니다.
+
+
+ 3단계 워크스루 — 스캐폴딩, 로컬 서버 실행, 변경 사항 동기화.
+
diff --git a/packages/twenty-docs/l/ko/getting-started/core-concepts/calendar-and-email.mdx b/packages/twenty-docs/l/ko/getting-started/core-concepts/calendar-and-email.mdx
new file mode 100644
index 0000000000..05bb535a5c
--- /dev/null
+++ b/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개 이상의 앱과 연동하세요. |
+| **Workflow HTTP actions** | 자동화된 워크플로우의 일부로 모든 외부 API를 호출할 수 있습니다. |
+
+## 사용자 지정 앱
+
+개발자는 Twenty 위에 전체 기능을 갖춘 앱을 구축하여, 사용자 지정 UI, 서버 측 로직 및 심층 통합을 추가할 수 있습니다. 앱은 커뮤니티에 공개하거나 비공개로 유지할 수 있습니다.
+
+
+
+ 이메일 동기화, 캘린더 동기화를 설정하고 문제를 해결하세요.
+
+
+ Twenty API로 맞춤형 통합을 구축하세요.
+
+
diff --git a/packages/twenty-docs/l/ko/getting-started/core-concepts/dashboards.mdx b/packages/twenty-docs/l/ko/getting-started/core-concepts/dashboards.mdx
new file mode 100644
index 0000000000..1623168efb
--- /dev/null
+++ b/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';
+
+대시보드를 사용하면 파이프라인 건전성, 팀 성과, 수익 추세 및 그 외에 추적하고 싶은 모든 비즈니스 지표를 실시간으로 파악할 수 있습니다.
+
+
+
+## 위젯
+
+각 대시보드는 여러 위젯으로 구성됩니다. 위젯은 CRM 데이터에 연결된 단일 차트 또는 지표입니다. 다음을 구성할 수 있습니다:
+
+* **차트 유형** — 막대, 꺾은선, 원형, 숫자 등
+* **데이터 소스** — 데이터 모델(표준 또는 커스텀)에 있는 모든 오브젝트
+* **필터** — 특정 레코드, 날짜 범위 또는 세그먼트로 범위를 좁히기
+* **집계** — 숫자 필드에 대해 개수, 합계, 평균, 최소값, 최대값 계산
+* **그룹화** — 선택한 필드, 날짜 또는 관계별로 분류
+
+## 추적할 수 있는 내용
+
+* 단계별 파이프라인 금액
+* 시간 경과에 따른 거래 성사 수
+* 소스별 평균 거래 규모
+* 작업 완료율
+* 任의 오브젝트에 대한 맞춤형 지표
+
+## 공유
+
+대시보드는 워크스페이스 수준에서 관리되며, 팀의 모든 사람이 볼 수 있습니다. 그리드 레이아웃에서 위젯을 배치하고 크기를 조정하여 팀에 적합한 보기를 만들 수 있습니다.
+
+
+ 대시보드 만들기, 위젯 구성 및 차트 설정에 대한 자세한 참고 자료입니다.
+
diff --git a/packages/twenty-docs/l/ko/getting-started/core-concepts/data-model.mdx b/packages/twenty-docs/l/ko/getting-started/core-concepts/data-model.mdx
new file mode 100644
index 0000000000..6f76720d29
--- /dev/null
+++ b/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 엔드포인트, 뷰, 권한, 워크플로 트리거 등을 포함해 기본 제공 객체와 동일한 최상위 수준으로 취급됩니다.
+
+
+ 객체, 필드, 관계 및 이를 구성하는 방법에 대한 전체 레퍼런스입니다.
+
+
+
diff --git a/packages/twenty-docs/l/ko/getting-started/core-concepts/glossary.mdx b/packages/twenty-docs/l/ko/getting-started/core-concepts/glossary.mdx
new file mode 100644
index 0000000000..84151a0e4a
--- /dev/null
+++ b/packages/twenty-docs/l/ko/getting-started/core-concepts/glossary.mdx
@@ -0,0 +1,105 @@
+---
+title: 용어집
+icon: 도서
+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 사용자입니다. 이들은 기록의 소유자 또는 담당자로 지정될 수 있습니다.
diff --git a/packages/twenty-docs/l/ko/getting-started/core-concepts/layout.mdx b/packages/twenty-docs/l/ko/getting-started/core-concepts/layout.mdx
new file mode 100644
index 0000000000..c9dc2fd4ea
--- /dev/null
+++ b/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';
+
+## 메인 레이아웃
+
+화면 중앙은 레코드가 있는 곳으로, 사람, 회사, 영업 기회, 작업, 노트, 대시보드, 워크플로우, 그리고 모든 사용자 정의 객체가 위치합니다. 이곳에서 레코드를 조회, 편집, 삭제하고, 새로운 보기를 생성합니다.
+
+
+
+## 내비게이션 바
+
+왼쪽 사이드바에서는 다음을 사용할 수 있습니다:
+
+* **워크스페이스 전환기** — 워크스페이스 간 전환 또는 새 워크스페이스 생성 (상단 드롭다운)
+* **검색** — `/`를 눌러 즉시 포커스를 맞추고, 모든 객체를 대상으로 검색합니다.
+* **설정** — 왼쪽 상단에서 접근
+* **즐겨찾기** — 고정된 보기, 사용자별로 고유함
+* **객체 바로가기** — People, Companies, Opportunities 등으로 빠르게 이동
+* **워크플로우** — 자동화를 생성합니다.
+
+항목을 끌어 순서를 변경하고, 관련 객체를 폴더로 묶고, 사용하지 않는 항목은 숨기세요.
+
+
+
+## 명령 메뉴
+
+`Cmd+K`(Mac) 또는 `Ctrl+K`(Windows)를 누르거나 오른쪽 상단의 점 세 개를 클릭합니다. 여기에서 다음 작업을 수행할 수 있습니다:
+
+* 새 기록물을 생성
+* CSV를 통해 데이터를 가져오고 내보냅니다.
+* 새 보기를 생성
+* 삭제된 기록에 접근 (Twenty는 소프트 삭제와 하드 삭제를 지원합니다)
+* 워크스페이스를 탐색하는 데 사용할 수 있는 키보드 단축키를 확인하세요.
+
+
+
+## 검색
+
+Command Menu, 내비게이션 바 상단 또는 `/`를 눌러 접근할 수 있습니다. 검색은 모든 객체 전반에서 작동합니다.
+
+
+
+## 사이드 패널
+
+레코드를 클릭하면 오른쪽에 사이드 패널이 열립니다. 현재 페이지를 벗어나지 않고 해당 레코드의 핵심 정보를 빠르게 확인할 수 있습니다. 전체 레코드 페이지로 이동하려면 **Open**을 클릭하세요.
+
+
+
+## 보기
+
+모든 객체는 여러 보기를 지원하며, 객체별 보기 개수에는 제한이 없습니다. 왼쪽 상단의 드롭다운을 사용해 보기 간 전환을 할 수 있습니다.
+
+* **테이블** — 스프레드시트 스타일의 행과 열 보기로, 그룹화, 인라인 편집, 열 사용자 지정을 지원합니다.
+* **칸반** — 선택 필드를 기준으로 카드를 드래그 앤 드롭해 구성하며, 파이프라인에 적합합니다.
+* **캘린더** — 날짜 필드를 기준으로 레코드를 배치해 일정 기반 계획에 활용합니다.
+
+각 보기는 자체 필터, 정렬, 필드 가시성을 저장합니다. 보기를 워크스페이스와 공유하거나 비공개로 유지할 수 있습니다. 사이드바에서 빠르게 접근할 수 있도록 보기를 즐겨찾기에 추가하세요.
+
+
+
+## 레코드 페이지
+
+레코드를 열면, 상세 페이지는 구성 가능한 **탭**과 **위젯**으로 구성됩니다. 필드, 관련 레코드, 이메일, 타임라인, 작업, 노트, 파일, 차트, iframes 등 위젯을 그리드에서 추가, 제거, 재정렬, 크기 조절할 수 있습니다. 각 객체 유형은 고유한 레이아웃을 가집니다.
+
+
+ 내비게이션, 보기, 레코드 페이지에 대한 상세 참조와 사용 방법 안내입니다.
+
+
+
diff --git a/packages/twenty-docs/l/ko/getting-started/core-concepts/workflows.mdx b/packages/twenty-docs/l/ko/getting-started/core-concepts/workflows.mdx
new file mode 100644
index 0000000000..d080f3a6ac
--- /dev/null
+++ b/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를 외부 도구와 연결할 수 있습니다. 코드 작성 없이 사용할 수 있지만, 원하면 코드를 작성할 수도 있습니다.
+
+
+
+## 워크플로우의 동작 방식
+
+모든 워크플로우는 세 가지 부분으로 구성됩니다:
+
+1. **트리거** — 워크플로우를 시작하는 요소
+2. **단계** — 이후에 수행되는 작업(하나 이상의 작업이 순차적으로 실행됨)
+3. **변수** — 단계 간에 흐르는 데이터
+
+## 트리거
+
+| 트리거 | 실행 시점 |
+| ----------- | --------------------------------------- |
+| **레코드 이벤트** | 레코드가 생성, 업데이트, 삭제 또는 업서트될 때 |
+| **수동** | 사용자가 버튼을 클릭할 때(단일 레코드, 여러 레코드 또는 전역적으로) |
+| **일정** | 주기적으로(cron 구문) |
+| **웹훅** | 외부 시스템이 HTTP POST를 전송할 때 |
+
+## 작업
+
+워크플로우는 다음을 어떤 조합으로든 연결할 수 있습니다:
+
+* **레코드 작업** — 레코드를 생성, 업데이트, 조회, 삭제 또는 업서트
+* **이메일 보내기** — 연결된 계정에서 이메일을 보내거나 초안을 작성
+* **HTTP 요청** — 외부 API 호출
+* **코드** — 복잡한 로직을 위한 커스텀 JavaScript 실행
+* **분기** — if/else 조건으로 워크플로우 경로를 분기
+* **이터레이터** — 데이터 배열을 반복 처리
+* **AI 에이전트** — AI 에이전트가 데이터를 자율적으로 처리하도록 함
+* **지연** — 계속 진행하기 전에 대기
+* **양식** — 워크플로우 중간에 사용자 입력 수집
+
+## 만들 수 있는 것
+
+* 거래가 특정 단계에 도달하면 Slack 알림 보내기
+* 외부 API 데이터를 사용해 신규 연락처를 자동 보강
+* 정체된 기회를 감지하고 담당자에게 알림
+* Twenty와 청구 시스템 간에 데이터를 동기화
+* 레코드 데이터를 기반으로 PDF 또는 인보이스 생성
+* 특정 조건과 일치하는 수신 이메일에 자동 회신
+
+
+ 트리거, 작업, 변수 및 실제 자동화 레시피에 대한 상세 레퍼런스입니다.
+
diff --git a/packages/twenty-docs/l/ko/getting-started/introduction.mdx b/packages/twenty-docs/l/ko/getting-started/introduction.mdx
new file mode 100644
index 0000000000..1c60d639e4
--- /dev/null
+++ b/packages/twenty-docs/l/ko/getting-started/introduction.mdx
@@ -0,0 +1,55 @@
+---
+title: Why Twenty
+icon: heart
+---
+
+import { CardTitle } from "/snippets/card-title.mdx"
+
+지금까지 여러분은 시작하기는 쉽지만 변경이 불가능한 소프트웨어와, 유연하지만 설정하는 데 몇 달이 걸리는 소프트웨어 사이에서 선택해 왔습니다. Twenty는 세 번째 선택지입니다: **사용 준비가 이미 끝났고, 사용하면서 계속 재구성할 수 있는 CRM입니다.**
+
+## Twenty의 차별점
+
+Twenty는 설정만 하는 제품이 아니라, 그 위에 구축할 수 있는 플랫폼입니다.
+
+
+
+ 에이전트를 위해 설계됨
+ 에이전트는 실제 권한으로 여러분의 데이터 모델 안에서 작업합니다. 기술, 도구, MCP.
+
+
+ 보안이 보장된 확장성
+ 보안성이 검증된 기반 위에서, 바이브 코딩 도구의 유연성을 제공합니다.
+
+
+ 모던 스택
+ React, TypeScript. 여러분의 팀은 이미 Twenty를 확장하는 방법을 알고 있습니다. 독점 언어도, 진입 장벽도 없습니다.
+
+
+ 락인 없음
+ 오픈 소스 코어, 셀프 호스팅 가능, 언제든지 데이터를 내보낼 수 있습니다.
+
+
+
+## Twenty는 누구를 위한 것인가
+
+* **Salesforce를 대체하려는 대기업** — 여러분의 팀은 이 도구를 활용하기보다, 이 도구와 싸우는 데 더 많은 시간을 쓰고 있습니다.
+ 락인된 느낌이고, 비용은 계속해서 증가합니다.
+* **기술 창업자가 있는 스타트업** — 이제는 스프레드시트와 Notion만으로는 부족합니다. 여러분에게는 큰 포부가 있고, 함께 성장할 수 있는 CRM을 원합니다.
+* **우위를 찾는 GTM 팀** — 자체 리드 스코어링, 자체 데이터 보강, 자체 아웃바운드 워크플로를 구축하고 싶어 합니다.
+* **프라이버시에 민감한 조직** — 셀프 호스팅이 필요하고, 데이터를 처음부터 끝까지 직접 소유해야 합니다. 규제, 계약, 혹은 단지 원칙 때문일 수 있습니다.
+* **Salesforce 파트너** —
+ 여러분의 개발자는 고객에게 라이선스 비용 인상을 설명하는 데 지쳤습니다.
+ 더 나은 DX를 원하고, 고객에게 더 낮은 라이선스 비용으로 더 빠르게 프로젝트를 제공하고 싶어 합니다.
+* **웹 개발 에이전시** — 여러분의 팀은 TypeScript, React,
+ 그리고 PostgreSQL을 이미 알고 있습니다. Twenty는 APEX를 배우거나 독점 자격증을 취득하지 않고도 CRM 시장에 진입할 수 있게 해 줍니다.
+
+## Twenty가 맞지 않은 경우
+
+* **다시는 신경 쓰지 않아도 되는 CRM을 원하는 팀.** Twenty는 도구에 밀접하게 관여해, 시간이 지남에 따라 함께 다듬어 가고자 하는 팀에게 더 큰 가치를 제공합니다. 완전 관리형 서비스를 원한다면 Pipedrive나
+ HubSpot이 좋은 선택이 될 것입니다.
+* **오늘 당장 수백 개의 사전 구축 통합이 필요한 회사.** 우리의 에코시스템은 빠르게 성장하고 있지만, 아직 Salesforce나 HubSpot만큼 폭넓지는 않습니다. 부족한 부분을 직접 구축할 수 있다면, 분명 마음에 드실 것입니다. 그렇지 않다면, 1년 뒤에 다시 찾아와 주세요.
+* **도구를 실제로 쓰는 사람이 아니라, 이사회 회의실에서 도구를 결정하는 조직.** 우리는 스테이크 디너나 경영진 브리핑을 제공하지 않습니다. 우리는 스스로 사용할 도구를 선택할 권한이 있는 팀과 함께 승리합니다.
+
+
+ 클라우드 또는 셀프 호스팅 환경에서 Twenty를 5분 이내에 설정해 보세요.
+
diff --git a/packages/twenty-docs/l/ko/getting-started/key-features.mdx b/packages/twenty-docs/l/ko/getting-started/key-features.mdx
new file mode 100644
index 0000000000..103826378d
--- /dev/null
+++ b/packages/twenty-docs/l/ko/getting-started/key-features.mdx
@@ -0,0 +1,70 @@
+---
+title: 핵심 기능
+description: 커스텀 데이터 모델부터 AI 기반 자동화까지, Twenty가 제공하는 모든 기능 둘러보기.
+icon: 별
+---
+
+import { CardTitle } from "/snippets/card-title.mdx"
+
+Twenty는 완전한 기능을 갖춘 CRM 플랫폼입니다. 이를 통해 무엇을 구축할 수 있는지 살펴보세요.
+
+
+
+ Custom Data Model
+ 비즈니스에 필요한 정확한 데이터 구조를 정의하세요.
+ 커스텀 오브젝트를 만들고, 20개 이상의 필드 유형으로 커스텀 필드를 추가하며, 어떤 오브젝트끼리든 관계를 구성하세요.
+
+
+
+ Views & Pipelines
+ 테이블 뷰, 칸반 보드, 캘린더 뷰 간에 전환하세요.
+ AND/OR 로직으로 필터링하고, 여러 필드 기준으로 정렬하며, 레코드를 그룹화하고, 커스텀 뷰를 저장하세요.
+
+
+
+ Workflows & Automation
+ 코드를 작성하지 않고도 모든 비즈니스 프로세스를 자동화하세요.
+ 레코드 변경, 일정, 수동 작업 또는 수신 `webhooks`를 트리거로 `workflows`를 실행하세요.
+
+
+
+ Calendar & Email Sync
+ Google Workspace 또는 Microsoft 365 계정을 연결하세요.
+ 이메일과 캘린더 이벤트가 관련 CRM 레코드에 자동으로 표시됩니다.
+
+
+
+ AI
+ CRM 내에서 자율적으로 작동하는 AI 에이전트가 질문에 답변하고, 레코드를 보강하며, 권한 모델 내에서 다단계 작업을 실행합니다.
+
+
+
+ Dashboards & Reporting
+ 실시간 위젯으로 커스텀 대시보드를 구축하세요.
+ 구성 가능한 차트와 필터로 파이프라인 지표, 팀 성과, 비즈니스 KPI를 추적하세요.
+
+
+
+ Permissions & Access Control
+ 오브젝트, 필드, 개별 레코드 등 모든 수준에서 역할 기반 액세스 제어를 구성하세요.
+ SAML 또는 OIDC로 SSO를 구성하세요. 감사 로그를 통해 누가 무엇을 했는지 추적할 수 있습니다.
+
+
+
+ API & Extensibility
+ 커스텀 데이터 모델에 맞게 확장되는 개발자 우선 API입니다.
+ 워크스페이스별로 자동 생성되는 문서를 갖춘 GraphQL 및 REST 엔드포인트를 모두 제공합니다.
+
+
+
+ Data Import & Export
+ CSV 파일 또는 API를 통해 데이터를 가져오세요.
+ 필드 매핑, 중복 감지, 오류 처리가 내장되어 있습니다. 언제든지 데이터를 내보낼 수 있어 벤더 종속이 없습니다.
+
+
+
+ Self-Hosting
+ 단일 Docker Compose 명령으로 자체 인프라에서 Twenty를 실행하세요.
+ 데이터에 대한 완전한 제어와, 일정에 맞춘 업데이트를 제공받으세요.
+
+
diff --git a/packages/twenty-docs/l/ko/getting-started/quickstart.mdx b/packages/twenty-docs/l/ko/getting-started/quickstart.mdx
new file mode 100644
index 0000000000..9c6dca46c5
--- /dev/null
+++ b/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';
+
+## 가입하기
+
+
+
+ [app.twenty.com](https://app.twenty.com)으로 이동하여 Google, Microsoft 또는 이메일로 가입하세요.
+
+
+ **30일**(카드 필요) 또는 **7일**(카드 없이) 중에서 선택하세요. 두 옵션 모두 전체 액세스를 포함합니다. 연락처 무제한, 이메일 통합, 커스텀 객체, API를 모두 사용할 수 있습니다. 요금제나 결제 주기는 언제든지 변경할 수 있습니다.
+
+
+ Stripe를 통한 결제가 확인된 후 워크스페이스 이름과 사용자 프로필을 설정하게 됩니다. 언제든지 취소할 수 있습니다.
+
+
+
+
+
+## 워크스페이스 구성
+
+접속하면 Twenty를 내 환경에 맞게 설정하는 세 단계는 다음과 같습니다:
+
+### 1. 메일박스 연결하기
+
+**설정 → 계정**으로 이동하여 Google 또는 Microsoft 계정을 연결하세요. Twenty는 이메일과 캘린더 이벤트를 가져오고, 상호작용을 기반으로 자동으로 연락처를 생성합니다. 다른 공급자를 사용 중이신가요? 같은 페이지에서 SMTP를 통해 메일박스를 추가하거나 CalDAV를 통해 캘린더를 추가할 수 있습니다.
+
+여기서 시작하세요 — 메일박스를 연결하면 다른 항목을 맞춤설정하기 전에 실제 데이터를 통해 팀에 즉각적인 가치를 제공합니다.
+
+
+
+### 2. 데이터 모델 구성하기
+
+**설정 → 데이터 모델**로 이동하여 커스텀 객체와 필드를 생성하세요. 알아두면 좋은 몇 가지 사항:
+
+* 커스텀 객체와 필드는 **모든 요금제에서 무제한으로 제공**되며, 추가 과금이 없습니다.
+* **People, Companies, Opportunities**는 동기화된 이메일과 미팅을 표시하는 객체입니다. 이들을 기본으로 사용하고, 이메일 이력이 없는 별도 객체를 만들기보다는 (예: `Person Type` 필드처럼) 필드를 추가해 분류하세요.
+* 두 People은 동일한 이메일을 공유할 수 없습니다. 두 Companies는 동일한 도메인을 공유할 수 없습니다.
+* 필요하지 않은 기본 필드/객체는 비활성화할 수 있으며, 삭제하지 않고도 보기에서 필드를 숨길 수 있습니다.
+
+[데이터 모델 참고 자료 →](/l/ko/user-guide/data-model/overview)
+
+
+
+### 3. 데이터 가져오기
+
+Command 메뉴 (`Cmd+K` / `Ctrl+K`)를 사용하여 CSV를 통해 People, Companies, Opportunities 또는 임의의 커스텀 객체를 가져오세요. 먼저 샘플 파일을 다운로드하여 예상되는 형식을 확인하세요. 파일은 최대 10,000개 레코드로 제한하고, 가져오기 전에 이메일/도메인 중복을 제거하세요.
+
+[데이터 마이그레이션 가이드 →](/l/ko/user-guide/data-migration/overview)
+
+
+
+## 다음 단계
+
+
+
+ 탐색, 보기, 명령 메뉴, 사이드 패널.
+
+
+ 비즈니스 프로세스를 자동화하세요.
+
+
+ 테이블, 칸반, 캘린더 — 데이터를 필터링하고 정렬하세요.
+
+
+ 테넌트별 스키마 기반 REST 및 GraphQL.
+
+
diff --git a/packages/twenty-docs/l/pt/getting-started/core-concepts/ai.mdx b/packages/twenty-docs/l/pt/getting-started/core-concepts/ai.mdx
new file mode 100644
index 0000000000..fcca5437b9
--- /dev/null
+++ b/packages/twenty-docs/l/pt/getting-started/core-concepts/ai.mdx
@@ -0,0 +1,34 @@
+---
+title: IA
+description: Como a Twenty utiliza IA para melhorar a sua experiência de CRM.
+icon: robot
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+A Twenty integra IA diretamente no seu CRM — não como um truque, mas como uma ferramenta que funciona dentro do seu modelo de dados e sistema de permissões.
+
+## Chatbot de IA
+
+Faça perguntas sobre os seus dados em linguagem natural. O chatbot de IA pode consultar os seus registos de CRM, resumir informações e ajudá‑lo a encontrar o que procura sem criar filtros complexos.
+
+
+
+## Agentes de IA
+
+Os agentes de IA vão além do chat — conseguem executar tarefas com vários passos de forma autónoma:
+
+* Enriquecer registos com dados de fontes externas
+* Redigir e enviar emails de seguimento
+* Analisar a saúde do funil e sinalizar negócios em risco
+* Processar dados recebidos e encaminhá‑los para a equipa correta
+
+Os agentes trabalham dentro dos seus fluxos de trabalho existentes, para que possa combinar IA com aprovações manuais, lógica condicional e chamadas a APIs externas.
+
+## Permissões e segurança
+
+A IA na Twenty respeita o seu modelo de permissões. Os agentes só podem aceder a objetos e campos que o utilizador (ou função) tem permissão para ver. Os dados sensíveis permanecem protegidos mesmo quando a IA está envolvida.
+
+
+ Referência detalhada sobre o chatbot, os agentes e os controlos de permissões.
+
diff --git a/packages/twenty-docs/l/pt/getting-started/core-concepts/apps.mdx b/packages/twenty-docs/l/pt/getting-started/core-concepts/apps.mdx
new file mode 100644
index 0000000000..29cedbedf0
--- /dev/null
+++ b/packages/twenty-docs/l/pt/getting-started/core-concepts/apps.mdx
@@ -0,0 +1,41 @@
+---
+title: Aplicativos
+icon: cube
+description: Estenda o Twenty com código — objetos personalizados, lógica do lado do servidor, componentes de UI e agentes de IA, todos como pacotes em TypeScript.
+---
+
+A maioria dos CRMs oferece um painel de configuração. O Twenty oferece uma plataforma. Os aplicativos são como os desenvolvedores estendem o Twenty além do que a UI oferece — definindo modelos de dados, lógica do lado do servidor, componentes de UI e recursos de IA como código e, depois, implantando-os em um ou mais espaços de trabalho.
+
+## Por que os aplicativos existem
+
+Fluxos de trabalho abrangem automação sem código. Mas algumas coisas precisam de código: um mecanismo de precificação personalizado, um pipeline de enriquecimento proprietário, uma verificação de conformidade que é executada a cada atualização de registro, um painel de interface de usuário personalizado que obtém dados de uma ferramenta interna.
+
+Os aplicativos permitem criar tudo isso como extensões de primeira classe — não scripts frágeis que conversam com uma API externa, mas código que roda na plataforma com acesso total ao sistema de tipos, ao modelo de permissões e à UI.
+
+## O que um aplicativo pode definir
+
+Um aplicativo é um pacote TypeScript que declara **entidades** usando o `twenty-sdk`:
+
+| Entidade | O que faz |
+| ---------------------------- | ------------------------------------------------------------------------------------------------------------------ |
+| **Objetos e campos** | Novas tabelas de dados e campos em objetos existentes — com o mesmo tratamento dos nativos. |
+| **Funções lógicas** | Funções TypeScript do lado do servidor acionadas por rotas HTTP, agendamentos do cron ou eventos de banco de dados |
+| **Componentes de front-end** | Componentes React em sandbox que são renderizados na UI do Twenty (painel lateral, widgets, menu de comandos). |
+| **Habilidades e agentes** | Recursos de IA — instruções reutilizáveis e assistentes autônomos |
+| **Exibições e navegação** | Exibições de lista pré-configuradas e itens de menu da barra lateral |
+
+Tudo é detectado por meio de análise de AST em tempo de build — sem arquivos de configuração, sem código boilerplate de registro. Coloque um `export default defineObject(...)` em qualquer arquivo `.ts` e o SDK o detecta.
+
+## Como elas são executadas
+
+* **Funções lógicas** são executadas em processos Node.js isolados, em sandbox do host. Elas acessam dados por meio de um cliente de API tipado, restrito às permissões do papel do aplicativo.
+* **Componentes de front-end** executam em Web Workers usando Remote DOM — isolados da página principal, mas renderizando elementos DOM nativos (não iframes).
+* **Permissões** são aplicadas no nível da API. Um aplicativo só enxerga o que o seu papel permite.
+
+## A experiência do desenvolvedor
+
+Você escreve seu aplicativo como um projeto TypeScript na sua máquina. A CLI observa seus arquivos-fonte e os sincroniza em tempo real com um servidor Twenty em execução — edite um arquivo e veja a alteração na UI em segundos. O cliente de API tipado é regenerado automaticamente quando o esquema muda. Quando estiver pronto, `yarn twenty app:publish --private` faz o push para um servidor de produção, ou `yarn twenty app:publish` lista seu aplicativo no npm e no marketplace do Twenty.
+
+
+ Tutorial em três fases — gerar o esqueleto, executar um servidor local, sincronizar suas alterações.
+
diff --git a/packages/twenty-docs/l/pt/getting-started/core-concepts/calendar-and-email.mdx b/packages/twenty-docs/l/pt/getting-started/core-concepts/calendar-and-email.mdx
new file mode 100644
index 0000000000..9d123000de
--- /dev/null
+++ b/packages/twenty-docs/l/pt/getting-started/core-concepts/calendar-and-email.mdx
@@ -0,0 +1,46 @@
+---
+title: Calendário e email
+description: Sincronize o seu email e calendário com o Twenty.
+icon: envelope
+---
+
+O Twenty se conecta às suas ferramentas existentes para que o seu CRM permaneça atualizado sem entrada manual de dados.
+
+## Sincronização de email
+
+Conecte a sua caixa de correio do **Google Workspace** ou **Microsoft 365**. Depois de conectado:
+
+* Os emails são vinculados automaticamente aos registros de Empresa e Pessoas correspondentes
+* Tópicos completos de email ficam visíveis na linha do tempo de cada registro
+* Você pode enviar emails diretamente do Twenty
+* Várias caixas de correio por usuário são compatíveis
+
+Você controla o que é importado — filtre por intervalo de datas ou remetente para evitar trazer emails irrelevantes.
+
+## Sincronização de calendário
+
+Os eventos do calendário são sincronizados automaticamente a partir da sua conta conectada. Os eventos aparecem nos registros relevantes do CRM, oferecendo uma visão completa das suas interações com cada contato ou empresa.
+
+## Integrações
+
+Além de email e calendário, o Twenty se conecta a ferramentas externas por meio de:
+
+| Método | Caso de uso |
+| ----------------------------------- | ------------------------------------------------------------------------------------------- |
+| **API** | Crie integrações personalizadas com a API GraphQL ou REST |
+| **Webhooks** | Envie notificações em tempo real para sistemas externos quando os registros forem alterados |
+| **Zapier** | Conecte-se a mais de 5.000 apps sem código |
+| **Ações HTTP de fluxo de trabalho** | Chame qualquer API externa como parte de um fluxo de trabalho automatizado |
+
+## Apps personalizados
+
+Desenvolvedores podem criar apps completos em cima do Twenty — adicionando interface personalizada, lógica no servidor e integrações avançadas. Os apps podem ser publicados para a comunidade ou mantidos privados.
+
+
+
+ Configure a sincronização de email, a sincronização de calendário e solucione problemas.
+
+
+ Crie integrações personalizadas com a API do Twenty.
+
+
diff --git a/packages/twenty-docs/l/pt/getting-started/core-concepts/dashboards.mdx b/packages/twenty-docs/l/pt/getting-started/core-concepts/dashboards.mdx
new file mode 100644
index 0000000000..ff6d7cbbeb
--- /dev/null
+++ b/packages/twenty-docs/l/pt/getting-started/core-concepts/dashboards.mdx
@@ -0,0 +1,37 @@
+---
+title: Painéis
+description: Acompanhe o desempenho e visualize seus dados de CRM com painéis personalizados.
+icon: chart-bar
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+Os painéis oferecem visibilidade em tempo real sobre as métricas do seu negócio — saúde do pipeline, desempenho da equipe, tendências de receita e qualquer outra coisa que você queira acompanhar.
+
+
+
+## Widgets
+
+Cada painel é composto por widgets. Um widget é um único gráfico ou métrica vinculado aos seus dados de CRM. Você pode configurar:
+
+* **Tipo de gráfico** — barra, linha, pizza, número e mais
+* **Fonte de dados** — qualquer objeto no seu modelo de dados (padrão ou personalizado)
+* **Filtros** — refine para registros, intervalos de datas ou segmentos específicos
+* **Agregação** — contagem, soma, média, mínimo, máximo em qualquer campo numérico
+* **Agrupamento** — divisão por campos selecionados, datas ou relações
+
+## O que você pode acompanhar
+
+* Valor do pipeline por etapa
+* Negócios fechados ao longo do tempo
+* Tamanho médio do negócio por origem
+* Taxas de conclusão de tarefas
+* Métricas personalizadas em qualquer objeto
+
+## Compartilhamento
+
+Os painéis são no nível do workspace — todos na sua equipe podem vê-los. Organize os widgets em um layout de grade e redimensione-os para construir a visualização que funciona para sua equipe.
+
+
+ Referência detalhada sobre criação de painéis, configuração de widgets e definições de gráficos.
+
diff --git a/packages/twenty-docs/l/pt/getting-started/core-concepts/data-model.mdx b/packages/twenty-docs/l/pt/getting-started/core-concepts/data-model.mdx
new file mode 100644
index 0000000000..9f46ccaaac
--- /dev/null
+++ b/packages/twenty-docs/l/pt/getting-started/core-concepts/data-model.mdx
@@ -0,0 +1,47 @@
+---
+title: Modelo de dados
+description: Entenda como o Twenty estrutura seus dados com objetos, campos e relações.
+icon: database
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+Tudo no Twenty é construído em torno de **objetos** e **campos** — os blocos de construção do seu modelo de dados.
+
+## Objetos
+
+Objetos são as tabelas que armazenam seus dados. O Twenty vem com objetos padrão prontos para uso:
+
+* **Companies** — Organizações com as quais você faz negócios
+* **People** — Contatos individuais
+* **Opportunities** — Negócios no seu funil
+* **Tasks** — Itens de ação para sua equipe
+* **Notes** — Texto livre vinculado a registros
+
+Você também pode criar **objetos personalizados** para tudo o que a sua empresa precisar — projetos, tíquetes de suporte, produtos, contratos ou qualquer outra coisa.
+
+## Campos
+
+Campos são as propriedades de cada objeto. O Twenty é compatível com uma ampla variedade de tipos de campo:
+
+| Categoria | Tipos |
+| ------------ | ----------------------------------------------------------------------------- |
+| **Básico** | Texto, Número, Booleano, Data, Moeda, Avaliação, Seleção |
+| **Composto** | Endereço (rua, cidade, estado, CEP), Nome completo, Links, Telefones, E-mails |
+| **Especial** | Relação, Anexo de arquivo, JSON, Ator (quem criou/modificou) |
+
+Cada objeto também recebe campos de sistema automáticos: `id`, `createdAt`, `updatedAt`, `createdBy` e `position`.
+
+## Relações
+
+Os objetos se conectam entre si por meio de relações. Uma Company tem muitas People, uma Opportunity pertence a uma Company e assim por diante. Você pode criar relações personalizadas entre quaisquer objetos, incluindo relacionamentos muitos-para-muitos.
+
+## O que torna isso poderoso
+
+Ao contrário dos CRMs tradicionais, em que você fica limitado a campos predefinidos em objetos predefinidos, o Twenty permite modelar seus dados exatamente da forma como o seu negócio funciona. Objetos personalizados recebem o mesmo tratamento de primeira classe que os nativos — incluindo endpoints de API, visualizações, permissões e gatilhos de fluxo de trabalho.
+
+
+ Referência completa sobre objetos, campos, relações e como configurá-los.
+
+
+
diff --git a/packages/twenty-docs/l/pt/getting-started/core-concepts/glossary.mdx b/packages/twenty-docs/l/pt/getting-started/core-concepts/glossary.mdx
new file mode 100644
index 0000000000..25d2cac7a3
--- /dev/null
+++ b/packages/twenty-docs/l/pt/getting-started/core-concepts/glossary.mdx
@@ -0,0 +1,105 @@
+---
+title: Glossário
+icon: book
+description: Termos-chave usados em Twenty.
+---
+
+## API
+
+API (Interface de Programação de Aplicações) permite que você conecte o Twenty com outros sistemas de software e construa integrações personalizadas.
+
+## Aplicativos
+
+Os aplicativos são extensões personalizadas escritas em código que podem definir modelos de dados e funções de lógica. Eles permitem que desenvolvedores criem personalizações reutilizáveis que podem ser implantadas em vários espaços de trabalho.
+
+## Ações de código
+
+As Ações de código são etapas de fluxo de trabalho que permitem escrever JavaScript personalizado para transformar dados, realizar cálculos ou executar lógica complexa que não é possível com as ações integradas.
+
+## Menu de Comandos
+
+O Menu de Comandos é uma interface de acesso rápido (aberta com `Cmd + K` no Mac e `Ctrl + K` no Windows) que permite realizar ações, criar registros e navegar no seu espaço de trabalho de forma eficiente.
+
+## Empresa e Pessoas
+
+O CRM tem dois tipos fundamentais de registros:
+
+* Uma `Empresa` representa um negócio ou organização.
+* `Pessoas` representam os atuais e potenciais clientes ou contatos da sua empresa.
+
+## Campos Personalizados
+
+Campos Personalizados são campos de dados que você cria para capturar informações específicas das necessidades e processos do seu negócio.
+
+## Modelo de dados
+
+Um Modelo de Dados é a estrutura que define como a informação é organizada no seu CRM, incluindo quais objetos existem, suas propriedades (campos) e como se relacionam entre si.
+
+## Favoritos
+
+Favoritos são registros que você marcou para acesso rápido, aparecendo na sua barra lateral para navegação instantânea a dados importantes.
+
+## Campo
+
+Um campo refere-se a uma área específica onde dados particulares são armazenados para uma entidade.
+
+## Iterador
+
+O Iterator é uma ação de fluxo de trabalho que percorre um array de itens, executando as ações subsequentes para cada item da lista.
+
+## Kanban
+
+Um `Kanban` é uma maneira visual de rastrear os seus processos de negócios usando cartões e colunas. Cada coluna representa um estágio em seu processo (por exemplo: novo, em andamento, ganho, perdido) e você move os registros através desses estágios conforme eles progridem.
+
+## Objeto
+
+Um Objeto é uma estrutura de dados que representa um tipo específico de entidade no seu CRM (como Pessoas, Empresas ou Oportunidades). Objetos podem ser padrão (pré-construídos) ou personalizados (criados por você).
+
+## Oportunidades
+
+Oportunidades no Twenty CRM são potenciais negócios ou vendas com contas ou contatos.
+
+## Registro
+
+Um Registro indica uma instância de um objeto, como uma conta ou contato específico.
+
+## Campos de Relação
+
+Campos de Relação criam conexões entre diferentes objetos, permitindo que você vincule registros juntos (como conectar uma Pessoa a uma Empresa).
+
+## Campos Padrão
+
+Campos Padrão são campos de dados pré-construídos que vêm com objetos por padrão e oferecem funcionalidades comuns em todos os espaços de trabalho.
+
+## Tarefas
+
+Tarefas no Twenty CRM são atividades atribuídas relacionadas a contatos, contas ou oportunidades.
+
+## Disparadores
+
+Os gatilhos são o ponto de partida de um fluxo de trabalho — o evento ou condição que inicia a automação. Exemplos incluem a criação de registros, atualizações de registros, webhooks ou horários agendados.
+
+## Visualizações
+
+Você pode personalizar a exibição dos seus registros usando visualizações, definindo diferentes filtros, layouts e opções de ordenação para cada visualização.
+
+## Upsert
+
+Upsert é uma operação que combina "update" e "insert" — atualiza um registro existente se for encontrada uma correspondência, ou cria um novo registro se nenhuma correspondência existir.
+
+## Webhooks
+
+Webhooks são mensagens automáticas enviadas do Twenty a outras aplicações quando eventos específicos ocorrem, permitindo a sincronização de dados em tempo real.
+
+## Fluxos de trabalho
+
+Fluxos de trabalho são processos automatizados que desencadeiam ações com base em condições específicas, ajudando você a automatizar tarefas repetitivas e processos de negócios.
+
+## Espaço de trabalho
+
+Um `Espaço de Trabalho` normalmente representa uma empresa usando o Twenty. Ele contém todos os registros e dados que você e os membros da sua equipe adicionam ao Twenty.
+Ele tem um único nome de domínio, que normalmente é o nome de domínio que sua empresa usa para endereços de e-mail de funcionários.
+
+## Membros do Espaço de Trabalho
+
+Membros do Espaço de Trabalho são os usuários do Twenty da sua equipe que têm acesso ao seu espaço de trabalho. Eles podem ser designados como proprietários ou responsáveis por registros.
diff --git a/packages/twenty-docs/l/pt/getting-started/core-concepts/layout.mdx b/packages/twenty-docs/l/pt/getting-started/core-concepts/layout.mdx
new file mode 100644
index 0000000000..e61798dc92
--- /dev/null
+++ b/packages/twenty-docs/l/pt/getting-started/core-concepts/layout.mdx
@@ -0,0 +1,74 @@
+---
+title: Layout
+description: Como navegar, explorar e visualizar registos na Twenty.
+icon: table-columns
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+## O layout principal
+
+O centro do ecrã é onde os seus registos vivem — pessoas, empresas, oportunidades, tarefas, notas, dashboards, workflows e quaisquer objetos personalizados. Aqui pode visualizar, editar e eliminar registos e criar novas vistas.
+
+
+
+## Barra de navegação
+
+A barra lateral esquerda dá-lhe:
+
+* **Seletor de workspace** — alternar entre workspaces ou criar um novo (menu suspenso no topo)
+* **Pesquisa** — prima `/` para focar instantaneamente, pesquisa em todos os objetos
+* **Definições** — aceda a partir do canto superior esquerdo
+* **Favoritos** — vistas fixadas, únicas por utilizador
+* **Atalhos de objetos** — acesso rápido a People, Companies, Opportunities, etc.
+* **Workflows** — criar automatizações
+
+Arraste itens para reordenar, crie pastas para agrupar objetos relacionados, oculte o que não utiliza.
+
+
+
+## Menu de Comandos
+
+Prima `Cmd+K` (Mac) ou `Ctrl+K` (Windows) — ou clique nos três pontos no canto superior direito. A partir daqui você pode:
+
+* Criar novos registros
+* Importar e exportar dados via CSV
+* Criar novas visualizações
+* Acessar registros excluídos (Twenty dá suporte a exclusões lógicas e permanentes)
+* Ver os atalhos de teclado para navegar no seu workspace
+
+
+
+## Pesquisar
+
+Acessível através do Command Menu, do topo da barra de navegação ou premindo `/`. A pesquisa funciona em todos os objetos.
+
+
+
+## Painel lateral
+
+Clique num registo para abrir o painel lateral à direita — uma visão geral rápida das informações principais do registo sem sair da página atual. Clique em **Open** para ir para a página completa do registo.
+
+
+
+## Visualizações
+
+Cada objeto suporta múltiplas vistas — ilimitadas por objeto. Use o menu suspenso no canto superior esquerdo para alternar entre elas.
+
+* **Tabela** — linhas e colunas ao estilo de folha de cálculo, com agrupamento, edição inline e personalização de colunas
+* **Kanban** — cartões de arrastar e largar organizados por um campo de seleção, ideal para pipelines
+* **Calendário** — registos distribuídos por um campo de data para planeamento baseado em tempo
+
+Cada vista guarda os seus próprios filtros, ordenação e visibilidade de campos. Partilhe vistas com o seu workspace ou mantenha-as privadas. Marcar vistas como favoritas para acesso rápido a partir da barra lateral.
+
+
+
+## Páginas de Registos
+
+Quando abre um registo, a página de detalhes é construída a partir de **separadores** e **widgets** configuráveis. Adicione, remova, reordene e redimensione widgets numa grelha — campos, registos relacionados, e-mails, cronologia, tarefas, notas, ficheiros, gráficos, iframes e muito mais. Cada tipo de objeto tem o seu próprio layout.
+
+
+ Navegação, vistas, páginas de registos — referência detalhada e tutoriais.
+
+
+
diff --git a/packages/twenty-docs/l/pt/getting-started/core-concepts/workflows.mdx b/packages/twenty-docs/l/pt/getting-started/core-concepts/workflows.mdx
new file mode 100644
index 0000000000..4f3358149b
--- /dev/null
+++ b/packages/twenty-docs/l/pt/getting-started/core-concepts/workflows.mdx
@@ -0,0 +1,55 @@
+---
+title: Fluxos de trabalho
+description: Automatize os processos da sua empresa com o construtor visual de fluxos de trabalho do Twenty.
+icon: bolt
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+Os fluxos de trabalho permitem automatizar tarefas repetitivas e conectar o Twenty a ferramentas externas — sem escrever código (embora você possa, se quiser).
+
+
+
+## Como os fluxos de trabalho funcionam
+
+Cada fluxo de trabalho tem três partes:
+
+1. **Disparador** — O que inicia o fluxo de trabalho
+2. **Etapas** — O que acontece em seguida (uma ou mais ações em sequência)
+3. **Variáveis** — Dados que fluem entre as etapas
+
+## Disparadores
+
+| Disparador | Quando é acionado |
+| ---------------------- | --------------------------------------------------------------------------------------- |
+| **Evento de registro** | Um registro é criado, atualizado, excluído ou inserido/atualizado (upsert) |
+| **Manual** | Um usuário clica em um botão (em um único registro, em vários registros ou globalmente) |
+| **Agendamento** | Em um intervalo recorrente (sintaxe cron) |
+| **Webhook** | Um sistema externo envia um HTTP POST |
+
+## Ações
+
+Os fluxos de trabalho podem encadear qualquer combinação de:
+
+* **Operações de registro** — Criar, atualizar, localizar, excluir ou inserir/atualizar registros (upsert)
+* **Enviar e-mail** — Enviar ou rascunhar e-mails a partir de contas conectadas
+* **Solicitação HTTP** — Chamar qualquer API externa
+* **Código** — Executar JavaScript personalizado para lógica complexa
+* **Ramificações** — Condições if/else para dividir o caminho do fluxo de trabalho
+* **Iterador** — Percorrer arrays de dados
+* **Agente de IA** — Deixar um agente de IA processar dados de forma autônoma
+* **Atraso** — Aguardar antes de continuar
+* **Formulário** — Coletar entrada do usuário no meio do fluxo de trabalho
+
+## O que você pode criar
+
+* Enviar alertas no Slack quando um negócio atingir um determinado estágio
+* Enriquecer automaticamente novos contatos com dados de APIs externas
+* Detectar oportunidades estagnadas e notificar o responsável
+* Sincronizar dados entre o Twenty e o seu sistema de faturamento
+* Gerar PDFs ou faturas a partir de dados de registros
+* Responder automaticamente a e-mails recebidos que correspondam a certos critérios
+
+
+ Referência detalhada sobre disparadores, ações, variáveis e receitas de automação do mundo real.
+
diff --git a/packages/twenty-docs/l/pt/getting-started/introduction.mdx b/packages/twenty-docs/l/pt/getting-started/introduction.mdx
new file mode 100644
index 0000000000..89d5905a63
--- /dev/null
+++ b/packages/twenty-docs/l/pt/getting-started/introduction.mdx
@@ -0,0 +1,72 @@
+---
+title: Por que Twenty
+icon: heart
+---
+
+import { CardTitle } from "/snippets/card-title.mdx"
+
+Você vinha escolhendo entre softwares que são fáceis de começar, mas impossíveis de mudar, e softwares que são flexíveis, mas levam meses para serem configurados. Twenty é a terceira opção: **um CRM pronto para produção que você pode remodelar conforme avança.**
+
+## O que torna o Twenty diferente
+
+Twenty é uma plataforma sobre a qual você pode construir, não um produto que você apenas configura.
+
+
+
+ Feito para Agentes
+ Os agentes operam dentro do seu modelo de dados com permissões reais. Competências, Ferramentas, MCP.
+
+
+ Extensibilidade Segura
+ A flexibilidade de ferramentas "vibe-coded" sobre bases seguras.
+
+
+ Stack Moderno
+ React, TypeScript. A sua equipe já sabe como estender o Twenty. Sem linguagens proprietárias, sem restrições de acesso.
+
+
+ Sem Lock-in
+ Núcleo open source, possibilidade de auto-hospedagem, exporte seus dados a qualquer momento.
+
+
+
+## Para quem é o Twenty
+
+* **Grandes empresas substituindo o Salesforce** — sua equipe
+ passa mais tempo lutando contra a ferramenta do que usando-a.
+ Você se sente preso e os custos continuam aumentando.
+* **Startups com fundadores técnicos** — vocês deixaram
+ para trás as planilhas e o Notion. Vocês têm grandes ambições e querem
+ um CRM que escale com vocês.
+* **Equipes de GTM em busca de vantagem competitiva** — vocês querem construir
+ sua própria qualificação de leads, seu próprio enriquecimento, seus próprios
+ fluxos de trabalho de outbound.
+* **Organizações preocupadas com privacidade** — vocês precisam
+ de auto-hospedagem e de possuir seus dados de ponta a ponta. Regulatório,
+ contratual ou simplesmente por princípio.
+* **Parceiros Salesforce** —
+ seus desenvolvedores estão cansados de apresentar aumentos de custos de licença aos seus clientes.
+ Você quer uma melhor DX e entregar projetos mais rápido, com um custo de licença menor para seus clientes.
+* **Agências de desenvolvimento web** — sua equipe conhece TypeScript, React,
+ e PostgreSQL. Twenty abre o mercado de CRM
+ para você sem precisar aprender APEX ou obter certificações proprietárias.
+
+## Para quem o Twenty não é
+
+* **Equipes que querem um CRM sobre o qual nunca precisem pensar.** Twenty recompensa equipes que querem ficar próximas
+ das suas ferramentas e moldá-las ao longo do tempo. Se você quer
+ algo totalmente gerenciado, Pipedrive ou
+ HubSpot vão te atender bem.
+* **Empresas que precisam de centenas de integrações prontas
+ hoje.** Nosso ecossistema está crescendo rápido, mas ainda não é
+ tão amplo quanto o do Salesforce ou do HubSpot. Se você se sentir à vontade
+ para construir o que falta, vai adorar. Se não, nos dê
+ mais um ano.
+* **Organizações em que as ferramentas são escolhidas em salas de reunião,
+ não por quem as utiliza.** Nós não fazemos jantares sofisticados
+ e apresentações executivas. Ganhamos com equipes que têm a
+ autoridade para escolher suas próprias ferramentas.
+
+
+ Configure o Twenty em menos de 5 minutos — na nuvem ou em hospedagem própria.
+
diff --git a/packages/twenty-docs/l/pt/getting-started/key-features.mdx b/packages/twenty-docs/l/pt/getting-started/key-features.mdx
new file mode 100644
index 0000000000..fe40a61b62
--- /dev/null
+++ b/packages/twenty-docs/l/pt/getting-started/key-features.mdx
@@ -0,0 +1,70 @@
+---
+title: Principais funcionalidades
+description: Um tour por tudo o que o Twenty pode fazer — desde modelos de dados personalizados até automação com IA.
+icon: estrela
+---
+
+import { CardTitle } from "/snippets/card-title.mdx"
+
+O Twenty é uma plataforma de CRM completa. Veja o que você pode criar com ele.
+
+
+
+ Modelo de Dados Personalizado
+ Defina a estrutura exata de dados de que o seu negócio precisa.
+ Crie objetos personalizados, adicione campos personalizados com mais de 20 tipos de campo e crie relacionamentos entre quaisquer objetos.
+
+
+
+ Visualizações & Pipelines
+ Alterne entre visualizações em tabela, quadros kanban e visualizações de calendário.
+ Filtre com lógica AND/OR, ordene por vários campos, agrupe registros e salve visualizações personalizadas.
+
+
+
+ Workflows & Automação
+ Automatize qualquer processo de negócio sem escrever código.
+ Dispare workflows em alterações de registros, agendamentos, ações manuais ou webhooks recebidos.
+
+
+
+ Sincronização de Calendário & Email
+ Conecte sua conta do Google Workspace ou Microsoft 365.
+ Emails e eventos de calendário aparecem automaticamente nos registros de CRM relevantes.
+
+
+
+ IA
+ Agentes de IA que trabalham de forma autônoma dentro do seu CRM — respondendo a perguntas, enriquecendo registros e executando tarefas de múltiplas etapas dentro do seu modelo de permissões.
+
+
+
+ Dashboards & Relatórios
+ Crie dashboards personalizados com widgets em tempo real.
+ Acompanhe métricas de pipeline, desempenho da equipe e KPIs de negócios com gráficos e filtros configuráveis.
+
+
+
+ Permissões & Controle de Acesso
+ Controle de acesso baseado em função em todos os níveis — objetos, campos e registros individuais.
+ Configure SSO com SAML ou OIDC. Registros de auditoria rastreiam quem fez o quê.
+
+
+
+ API & Extensibilidade
+ Uma API voltada para desenvolvedores que se adapta ao seu modelo de dados personalizado.
+ Tanto endpoints GraphQL quanto REST, com documentação gerada automaticamente por workspace.
+
+
+
+ Importação & Exportação de Dados
+ Importe dados de arquivos CSV ou via API.
+ Mapeamento de campos, detecção de duplicidades e tratamento de erros integrados. Exporte seus dados a qualquer momento — sem aprisionamento.
+
+
+
+ Auto-hospedagem
+ Execute o Twenty na sua própria infraestrutura com um único comando Docker Compose.
+ Controle total sobre seus dados, atualizações no seu próprio cronograma.
+
+
diff --git a/packages/twenty-docs/l/pt/getting-started/quickstart.mdx b/packages/twenty-docs/l/pt/getting-started/quickstart.mdx
new file mode 100644
index 0000000000..f9ae0a6892
--- /dev/null
+++ b/packages/twenty-docs/l/pt/getting-started/quickstart.mdx
@@ -0,0 +1,73 @@
+---
+title: Guia rápido
+description: Coloque o Twenty em funcionamento em menos de 5 minutos — na nuvem ou em hospedagem própria.
+icon: play
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+## Inscreva-se
+
+
+
+ Acesse [app.twenty.com](https://app.twenty.com) e inscreva-se com Google, Microsoft ou e-mail.
+
+
+ Escolha **30 dias** (com cartão) ou **7 dias** (sem cartão). Ambos incluem acesso completo — contatos ilimitados, integração de e-mail, objetos personalizados, API. Você pode mudar de plano ou intervalo de cobrança a qualquer momento.
+
+
+ Após a confirmação do pagamento via Stripe, você definirá o nome do seu espaço de trabalho e o perfil de usuário. Você pode cancelar a qualquer momento.
+
+
+
+
+
+## Configure seu espaço de trabalho
+
+Depois de entrar, siga três etapas para tornar o Twenty seu:
+
+### 1. Conecte sua caixa de correio
+
+Vá para **Configurações → Contas** e conecte sua conta Google ou Microsoft. O Twenty importará seus e-mails e eventos de calendário e criará contatos automaticamente a partir das interações. Usando outro provedor? Você pode adicionar caixas de correio via SMTP ou calendários via CalDAV na mesma página.
+
+Comece aqui — conectar uma caixa de correio dá valor imediato à sua equipe com dados reais antes de você personalizar qualquer outra coisa.
+
+
+
+### 2. Estruture seu modelo de dados
+
+Vá para **Configurações → Modelo de Dados** para criar objetos e campos personalizados. Algumas coisas que você precisa saber:
+
+* Objetos e campos personalizados são **ilimitados em todos os planos** — sem upsell.
+* **Pessoas, Empresas e Oportunidades** são os objetos que exibem e-mails e reuniões sincronizados. Use-os como base e adicione campos para categorizar (por exemplo, um campo `Person Type`) em vez de criar objetos separados que não terão histórico de e-mail.
+* Duas Pessoas não podem ter o mesmo e-mail. Duas Empresas não podem ter o mesmo domínio.
+* Você pode desativar campos/objetos padrão de que não precisa e ocultar campos das visualizações sem excluí-los.
+
+[Referência do modelo de dados →](/l/pt/user-guide/data-model/overview)
+
+
+
+### 3. Importe seus dados
+
+Use o Menu de Comandos (`Cmd+K` / `Ctrl+K`) para importar Pessoas, Empresas, Oportunidades ou qualquer objeto personalizado via CSV. Baixe primeiro o arquivo de exemplo para ver o formato esperado. Limite os arquivos a 10 mil registros e remova duplicados de e-mails/domínios antes de importar.
+
+[Guia de migração de dados →](/l/pt/user-guide/data-migration/overview)
+
+
+
+## Próximos passos
+
+
+
+ Navegação, vistas, menu de comandos, painel lateral.
+
+
+ Automatize seus processos de negócios.
+
+
+ Tabela, kanban, calendário — filtre e ordene os seus dados.
+
+
+ Schema-per-tenant REST e GraphQL.
+
+
diff --git a/packages/twenty-docs/l/ro/getting-started/core-concepts/ai.mdx b/packages/twenty-docs/l/ro/getting-started/core-concepts/ai.mdx
new file mode 100644
index 0000000000..d91eba7b52
--- /dev/null
+++ b/packages/twenty-docs/l/ro/getting-started/core-concepts/ai.mdx
@@ -0,0 +1,34 @@
+---
+title: AI
+description: Cum utilizează Twenty inteligența artificială pentru a îmbunătăți experiența ta CRM.
+icon: robot
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+Twenty integrează inteligența artificială direct în CRM-ul tău — nu ca pe un artificiu, ci ca pe un instrument care funcționează în cadrul modelului tău de date și al sistemului tău de permisiuni.
+
+## Chatbot IA
+
+Adresează întrebări despre datele tale în limbaj natural. Chatbotul bazat pe inteligență artificială poate interoga înregistrările din CRM, poate rezuma informațiile și te poate ajuta să găsești ceea ce cauți fără să fie nevoie să construiești filtre complexe.
+
+
+
+## Agenți AI
+
+Agenții IA merg dincolo de simplul chat — pot executa autonom sarcini cu mai mulți pași:
+
+* Îmbogățește înregistrările cu date din surse externe
+* Redactează și trimite emailuri de urmărire
+* Analizează starea pipeline-ului și semnalează tranzacțiile cu risc
+* Procesează datele primite și le direcționează către echipa potrivită
+
+Agenții funcționează în cadrul fluxurilor tale de lucru existente, astfel încât poți combina IA cu aprobări manuale, logică condițională și apeluri API externe.
+
+## Permisiuni și siguranță
+
+Inteligența artificială din Twenty respectă modelul tău de permisiuni. Agenții pot accesa doar obiectele și câmpurile pe care utilizatorul (sau rolul) are permisiunea să le vizualizeze. Datele sensibile rămân protejate chiar și atunci când este implicată inteligența artificială.
+
+
+ Referință detaliată despre chatbot, agenți și controalele de permisiuni.
+
diff --git a/packages/twenty-docs/l/ro/getting-started/core-concepts/apps.mdx b/packages/twenty-docs/l/ro/getting-started/core-concepts/apps.mdx
new file mode 100644
index 0000000000..9a6d2d86bd
--- /dev/null
+++ b/packages/twenty-docs/l/ro/getting-started/core-concepts/apps.mdx
@@ -0,0 +1,41 @@
+---
+title: Aplicații
+icon: cube
+description: Extindeți Twenty cu cod — obiecte personalizate, logică pe partea de server, componente UI și agenți AI, toate sub formă de pachete TypeScript.
+---
+
+Majoritatea CRM-urilor vă oferă un panou de configurare. Twenty vă oferă o platformă. Aplicațiile sunt modul în care dezvoltatorii extind Twenty dincolo de ceea ce oferă interfața — definind modele de date, logică pe partea de server, componente UI și capabilități AI ca cod, apoi implementându-le într-unul sau mai multe spații de lucru.
+
+## De ce există aplicații
+
+Fluxurile de lucru acoperă automatizările fără cod. Dar unele lucruri au nevoie de cod: un motor de stabilire a prețurilor personalizat, un pipeline proprietar de îmbogățire a datelor, o verificare de conformitate care rulează la fiecare actualizare de înregistrare, un panou UI personalizat care preia date dintr-un instrument intern.
+
+Aplicațiile vă permit să le construiți ca extensii de primă clasă — nu scripturi fragile care comunică cu un API din exterior, ci cod care rulează pe platformă, cu acces complet la sistemul de tipuri, modelul de permisiuni și UI.
+
+## Ce poate defini o aplicație
+
+O aplicație este un pachet TypeScript care declară **entități** folosind `twenty-sdk`:
+
+| Entitate | Ce face |
+| --------------------------- | ----------------------------------------------------------------------------------------------------------- |
+| **Obiecte și câmpuri** | Tabele de date noi și câmpuri pe obiectele existente — același tratament ca pentru cele încorporate. |
+| **Funcții logice** | TypeScript pe server declanșat de rute HTTP, programări cron sau evenimente din baza de date |
+| **Componente front-end** | Componente React sandboxate care se afișează în UI-ul Twenty (panou lateral, widgeturi, meniul de comenzi). |
+| **Abilități și agenți** | Capabilități AI — instrucțiuni reutilizabile și asistenți autonomi |
+| **Vizualizări și navigare** | Vizualizări de listă preconfigurate și elemente de meniu în bara laterală |
+
+Totul este detectat prin analiză AST în timpul build-ului — fără fișiere de configurare, fără cod boilerplate de înregistrare. Puneți un `export default defineObject(...)` în orice fișier `.ts` și SDK-ul îl va detecta.
+
+## Cum rulează
+
+* **Funcțiile logice** se execută în procese Node.js izolate, sandboxate față de gazdă. Acestea accesează datele printr-un client API tipizat, limitat de permisiunile rolului aplicației.
+* **Componentele front-end** rulează în Web Workers folosind Remote DOM — izolate de pagina principală, dar randând elemente DOM native (nu iframes).
+* **Permisiunile** sunt aplicate la nivelul API-ului. O aplicație vede doar ceea ce îi permite rolul său.
+
+## Experiența dezvoltatorului
+
+Scrieți aplicația ca un proiect TypeScript pe mașina dvs. CLI-ul urmărește fișierele sursă și le sincronizează în timp real cu un server Twenty care rulează — editați un fișier și vedeți modificarea în UI în mai puțin de o secundă. Clientul API tipizat este regenerat automat atunci când schema se schimbă. Când sunteți gata, `yarn twenty app:publish --private` publică pe un server de producție, sau `yarn twenty app:publish` vă listează aplicația pe npm și în marketplace-ul Twenty.
+
+
+ Ghid în trei etape — generați scheletul, rulați un server local, sincronizați modificările.
+
diff --git a/packages/twenty-docs/l/ro/getting-started/core-concepts/calendar-and-email.mdx b/packages/twenty-docs/l/ro/getting-started/core-concepts/calendar-and-email.mdx
new file mode 100644
index 0000000000..26de176df1
--- /dev/null
+++ b/packages/twenty-docs/l/ro/getting-started/core-concepts/calendar-and-email.mdx
@@ -0,0 +1,46 @@
+---
+title: Calendar și e-mail
+description: Sincronizați-vă e-mailul și calendarul cu Twenty.
+icon: envelope
+---
+
+Twenty se conectează la instrumentele dvs. existente, astfel încât CRM-ul dvs. rămâne actualizat fără introducere manuală de date.
+
+## Sincronizare e-mail
+
+Conectați-vă căsuța poștală **Google Workspace** sau **Microsoft 365**. După conectare:
+
+* E-mailurile sunt asociate automat înregistrărilor Companie și Persoane corespunzătoare
+* Firele complete de e-mail sunt vizibile pe cronologia fiecărei înregistrări
+* Puteți trimite e-mailuri direct din Twenty
+* Sunt acceptate mai multe căsuțe poștale per utilizator
+
+Controlați ce este importat — filtrați după interval de date sau expeditor pentru a evita importul de e-mailuri nerelevante.
+
+## Sincronizare calendar
+
+Evenimentele din calendar se sincronizează automat din contul dvs. conectat. Evenimentele apar în înregistrările CRM relevante, oferindu-vă o imagine completă a interacțiunilor cu fiecare contact sau companie.
+
+## Integrări
+
+Dincolo de e-mail și calendar, Twenty se conectează la instrumente externe prin:
+
+| Metodă | Caz de utilizare |
+| ------------------------- | ---------------------------------------------------------------------------------------------- |
+| **API** | Creați integrări personalizate cu API-urile GraphQL sau REST |
+| **Webhook-uri** | Trimiteți notificări în timp real către sisteme externe atunci când înregistrările se modifică |
+| **Zapier** | Conectați-vă la peste 5.000 de aplicații fără cod |
+| **Acțiuni HTTP Workflow** | Apelați orice API extern ca parte a unui workflow automatizat |
+
+## Aplicații personalizate
+
+Dezvoltatorii pot construi aplicații complete peste Twenty — adăugând UI personalizat, logică de server și integrări profunde. Aplicațiile pot fi publicate pentru comunitate sau păstrate private.
+
+
+
+ Configurați sincronizarea e-mailului, sincronizarea calendarului și depanați problemele.
+
+
+ Creați integrări personalizate cu API-ul Twenty.
+
+
diff --git a/packages/twenty-docs/l/ro/getting-started/core-concepts/dashboards.mdx b/packages/twenty-docs/l/ro/getting-started/core-concepts/dashboards.mdx
new file mode 100644
index 0000000000..bc4373a3c1
--- /dev/null
+++ b/packages/twenty-docs/l/ro/getting-started/core-concepts/dashboards.mdx
@@ -0,0 +1,37 @@
+---
+title: Tablouri de Bord
+description: Monitorizați performanța și vizualizați datele CRM cu tablouri de bord personalizate.
+icon: chart-bar
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+Tablourile de bord vă oferă vizibilitate în timp real asupra indicatorilor de afaceri — starea pipeline-ului, performanța echipei, tendințele de venit și orice altceva doriți să urmăriți.
+
+
+
+## Widgeturi
+
+Fiecare tablou de bord este alcătuit din widget-uri. Un widget este o singură diagramă sau un singur indicator legat de datele CRM. Puteți configura:
+
+* **Tip de diagramă** — Bară, linie, plăcintă, număr și altele
+* **Sursă de date** — Orice obiect din modelul de date (standard sau personalizat)
+* **Filtre** — Restringeți la înregistrări, intervale de date sau segmente specifice
+* **Agregare** — Număr, sumă, medie, minim, maxim pentru orice câmp numeric
+* **Grupare** — Defalcați după câmpuri, date sau relații selectate
+
+## Ce puteți urmări
+
+* Valoarea pipeline-ului după stadiu
+* Oportunități închise în timp
+* Mărimea medie a oportunității după sursă
+* Rate de finalizare a sarcinilor
+* Indicatori personalizați pentru orice obiect
+
+## Partajare
+
+Tablourile de bord sunt la nivel de spațiu de lucru — toți membrii echipei le pot vedea. Aranjați widget-urile într-un layout tip grid și redimensionați-le pentru a construi vizualizarea care funcționează pentru echipa dvs.
+
+
+ Referință detaliată despre crearea tablourilor de bord, configurarea widget-urilor și setările diagramelor.
+
diff --git a/packages/twenty-docs/l/ro/getting-started/core-concepts/data-model.mdx b/packages/twenty-docs/l/ro/getting-started/core-concepts/data-model.mdx
new file mode 100644
index 0000000000..b66f4adb28
--- /dev/null
+++ b/packages/twenty-docs/l/ro/getting-started/core-concepts/data-model.mdx
@@ -0,0 +1,47 @@
+---
+title: Model de date
+description: Înțelege cum Twenty îți structurează datele cu obiecte, câmpuri și relații.
+icon: database
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+Totul în Twenty este construit în jurul **obiectelor** și **câmpurilor** — elementele de bază ale modelului tău de date.
+
+## Obiecte
+
+Obiectele sunt tabelele care îți conțin datele. Twenty include obiecte standard din start:
+
+* **Companies** — organizații cu care derulezi afaceri
+* **People** — contacte individuale
+* **Opportunities** — oferte în pipeline-ul tău
+* **Tasks** — elemente de acțiune pentru echipa ta
+* **Notes** — text liber asociat înregistrărilor
+
+Poți de asemenea să creezi **obiecte personalizate** pentru orice are nevoie afacerea ta — proiecte, tichete de suport, produse, contracte sau orice altceva.
+
+## Câmpuri
+
+Câmpurile sunt proprietățile fiecărui obiect. Twenty acceptă o gamă largă de tipuri de câmpuri:
+
+| Category | Tipuri |
+| ------------ | ------------------------------------------------------------------------------------ |
+| **De bază** | Text, Number, Boolean, Date, Currency, Rating, Select |
+| **Compuse** | Adresă (stradă, oraș, județ, cod poștal), Nume complet, Linkuri, Telefoane, Emailuri |
+| **Speciale** | Relație, atașament de fișier, JSON, Actor (cine a creat/modificat) |
+
+Fiecare obiect primește, de asemenea, câmpuri de sistem automate: `id`, `createdAt`, `updatedAt`, `createdBy` și `position`.
+
+## Relații
+
+Obiectele se conectează între ele prin relații. O Company are multe People, o Opportunity aparține unei Company și așa mai departe. Poți crea relații personalizate între orice obiecte, inclusiv relații de tip many-to-many.
+
+## De ce este asta puternic
+
+Spre deosebire de CRM-urile tradiționale, unde ești limitat la câmpuri predefinite pe obiecte predefinite, Twenty îți permite să modelezi datele exact așa cum funcționează afacerea ta. Obiectele personalizate primesc același tratament de prim rang ca și cele încorporate — inclusiv endpoint-uri API, vizualizări, permisiuni și declanșatoare de fluxuri de lucru.
+
+
+ Referință completă despre obiecte, câmpuri, relații și cum să le configurezi.
+
+
+
diff --git a/packages/twenty-docs/l/ro/getting-started/core-concepts/glossary.mdx b/packages/twenty-docs/l/ro/getting-started/core-concepts/glossary.mdx
new file mode 100644
index 0000000000..fce9fa4919
--- /dev/null
+++ b/packages/twenty-docs/l/ro/getting-started/core-concepts/glossary.mdx
@@ -0,0 +1,105 @@
+---
+title: Glosar
+icon: carte
+description: Termeni-cheie utilizați în întregul Twenty.
+---
+
+## API
+
+API (Interfața de Programare a Aplicațiilor) permite conectarea Twenty cu alte sisteme software și construirea de integrări personalizate.
+
+## Aplicații
+
+Aplicațiile sunt extensii personalizate sub formă de cod, care pot defini modele de date și funcții de logică. Acestea le permit dezvoltatorilor să creeze personalizări reutilizabile care pot fi implementate în mai multe spații de lucru.
+
+## Acțiuni de cod
+
+Acțiunile de cod sunt pași dintr-un flux de lucru care îți permit să scrii JavaScript personalizat pentru a transforma date, a efectua calcule sau a realiza logică complexă care nu este posibilă cu acțiunile integrate.
+
+## Meniu de comenzi
+
+Meniul de comenzi este o interfață de acces rapid (deschisă cu `Cmd + K` pe Mac și `Ctrl + K` pe Windows) care vă permite să efectuați acțiuni, să creați înregistrări și să navigați eficient în spațiul de lucru.
+
+## Companie & Persoane
+
+CRM-ul are două tipuri fundamentale de înregistrări:
+
+* O `Companie` reprezintă o afacere sau o organizație.
+* `People` reprezintă clienții actuali și potențiali ai companiei.
+
+## Câmpuri personalizate
+
+Câmpurile personalizate sunt câmpuri de date pe care le creați pentru a colecta informații specifice necesităților și proceselor dvs. de afaceri.
+
+## Model de date
+
+Un model de date este structura care definește modul în care informațiile sunt organizate în CRM-ul dvs., incluzând ce obiecte există, proprietățile lor (câmpuri) și cum se relaționează între ele.
+
+## Favorite
+
+Favoritele sunt înregistrări pe care le-ați marcat pentru acces rapid, apărând în bara laterală pentru o navigare instantanee către date importante.
+
+## Câmp
+
+Un câmp se referă la o zonă specifică în care sunt stocate datele pentru o entitate.
+
+## Iterator
+
+Un Iterator este o acțiune de flux de lucru care parcurge un tablou de elemente, executând acțiunile ulterioare pentru fiecare element din listă.
+
+## Kanban
+
+Un `Kanban` este o metodă vizuală de urmărire a proceselor de afaceri folosind carduri și coloane. Fiecare coloană reprezintă o etapă în procesul dvs. (de exemplu: nou, în derulare, câștigat, pierdut), iar înregistrările sunt mutate prin aceste etape pe măsură ce progresează.
+
+## Obiect
+
+Un obiect este o structură de date care reprezintă un tip specific de entitate în CRM-ul dvs. (cum ar fi Oameni, Companii sau Oportunități). Obiectele pot fi standard (încorporate) sau personalizate (create de dvs.).
+
+## Oportunități
+
+Oportunitățile în Twenty CRM sunt potențiale afaceri sau vânzări cu conturi sau contacte.
+
+## Înregistrare
+
+O înregistrare indică o instanță a unui obiect, cum ar fi un cont sau un contact specific.
+
+## Câmpuri de relație
+
+Câmpurile de relație creează conexiuni între diferite obiecte, permițându-vă să legați înregistrările între ele (cum ar fi conectarea unei Persoane la o Companie).
+
+## Câmpuri standard
+
+Câmpurile standard sunt câmpuri de date preconstruite care vin cu obiectele în mod implicit și oferă funcționalitate comună în toate spațiile de lucru.
+
+## Sarcini
+
+Sarcinile în Twenty CRM sunt activități atribuite care au legătură cu contacte, conturi sau oportunități.
+
+## Declanșatoare
+
+Declanșatoarele sunt punctul de pornire al unui flux de lucru — evenimentul sau condiția care inițiază automatizarea. Exemplele includ crearea de înregistrări, actualizări ale înregistrărilor, webhook-uri sau momente programate.
+
+## Vizualizări
+
+Puteți personaliza afișarea înregistrărilor dvs. folosind vizualizări, stabilind diferite filtre, aspecte și opțiuni de sortare pentru fiecare vizualizare.
+
+## Upsert
+
+Upsert este o operațiune care combină "update" și "insert" — actualizează o înregistrare existentă dacă se găsește o potrivire sau creează o înregistrare nouă dacă nu există nicio potrivire.
+
+## Webhook-uri
+
+Webhook-urile sunt mesaje automate trimise de la Twenty către alte aplicații atunci când au loc evenimente specifice, permițând sincronizarea datelor în timp real.
+
+## Fluxuri de lucru
+
+Fluxurile de lucru sunt procese automatizate care declanșează acțiuni pe baza unor condiții specifice, ajutându-te să automatizezi sarcini repetitive și procese de afaceri.
+
+## Spațiu de lucru
+
+Un `Spațiu de lucru` reprezintă de obicei o companie care folosește Twenty. Conține toate înregistrările și datele pe care dvs. și membrii echipei dvs. le adăugați la Twenty.
+Are un nume de domeniu unic, care este de obicei numele de domeniu folosit de compania dvs. pentru adresele de email ale angajaților.
+
+## Membri ai spațiului de lucru
+
+Membrii spațiului de lucru sunt utilizatorii Twenty din echipa dvs. care au acces la spațiul dvs. de lucru. Ei pot fi desemnați ca proprietari sau asignați pentru înregistrări.
diff --git a/packages/twenty-docs/l/ro/getting-started/core-concepts/layout.mdx b/packages/twenty-docs/l/ro/getting-started/core-concepts/layout.mdx
new file mode 100644
index 0000000000..5d4c63d2ac
--- /dev/null
+++ b/packages/twenty-docs/l/ro/getting-started/core-concepts/layout.mdx
@@ -0,0 +1,74 @@
+---
+title: Aspect
+description: Cum să navigați, să răsfoiți și să vizualizați înregistrări în Twenty.
+icon: table-columns
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+## Aspectul principal
+
+Centrul ecranului este locul unde se află înregistrările dvs. — persoane, companii, oportunități, sarcini, note, tablouri de bord, fluxuri de lucru și orice obiect personalizat. Aici vizualizați, editați și ștergeți înregistrări și creați noi vizualizări.
+
+
+
+## Bară de navigare
+
+Bara laterală din stânga vă oferă:
+
+* **Comutator spațiu de lucru** — comutați între spații de lucru sau creați unul nou (meniul derulant de sus)
+* **Căutare** — apăsați `/` pentru a focaliza instant, caută în toate obiectele
+* **Setări** — accesați din stânga sus
+* **Favorite** — vizualizări fixate, unice pentru fiecare utilizator
+* **Scurtături pentru obiecte** — acces rapid la Persoane, Companii, Oportunități etc.
+* **Workflows** — creați automatizări
+
+Trageți elementele pentru a le reordona, creați dosare pentru a grupa obiecte înrudite, ascundeți ceea ce nu folosiți.
+
+
+
+## Meniu de comenzi
+
+Apăsați `Cmd+K` (Mac) sau `Ctrl+K` (Windows) — sau faceți clic pe cele trei puncte din dreapta sus. De aici puteți:
+
+* Creați noi înregistrări
+* Importați și exportați date în format CSV
+* Creați noi vizualizări
+* Accesați înregistrările șterse (Twenty acceptă ștergeri temporare și permanente)
+* Vizualizați scurtăturile de la tastatură pentru a naviga în spațiul de lucru
+
+
+
+## Caută
+
+Accesibil prin Command Menu, din partea de sus a barei de navigare sau prin apăsarea tastei `/`. Căutarea funcționează pentru toate obiectele.
+
+
+
+## Panou lateral
+
+Faceți clic pe o înregistrare pentru a deschide panoul lateral din dreapta — o prezentare generală rapidă a informațiilor esențiale ale înregistrării, fără a părăsi pagina curentă. Faceți clic pe **Open** pentru a accesa pagina completă a înregistrării.
+
+
+
+## Vizualizări
+
+Fiecare obiect acceptă mai multe vizualizări — nelimitate pentru fiecare obiect. Folosiți meniul derulant din stânga sus pentru a comuta între ele.
+
+* **Tabel** — rânduri și coloane în stil foaie de calcul, cu grupare, editare în linie și personalizare a coloanelor
+* **Kanban** — carduri drag-and-drop organizate după un câmp select, ideal pentru fluxuri de vânzări
+* **Calendar** — înregistrări plasate în funcție de un câmp de tip dată pentru planificare în timp
+
+Fiecare vizualizare își salvează propriile filtre, ordonarea și vizibilitatea câmpurilor. Partajați vizualizările cu spațiul de lucru sau păstrați-le private. Adăugați vizualizările la favorite pentru acces rapid din bara laterală.
+
+
+
+## Pagini de înregistrare
+
+Când deschideți o înregistrare, pagina de detalii este construită din **file** și **widgeturi** configurabile. Adăugați, eliminați, reordonați și redimensionați widgeturile pe o grilă — câmpuri, înregistrări asociate, e-mailuri, cronologie, sarcini, note, fișiere, diagrame, iframe-uri și altele. Fiecare tip de obiect are propriul său layout.
+
+
+ Navigare, vizualizări, pagini de înregistrare — referințe detaliate și ghiduri practice.
+
+
+
diff --git a/packages/twenty-docs/l/ro/getting-started/core-concepts/workflows.mdx b/packages/twenty-docs/l/ro/getting-started/core-concepts/workflows.mdx
new file mode 100644
index 0000000000..51a53ac25f
--- /dev/null
+++ b/packages/twenty-docs/l/ro/getting-started/core-concepts/workflows.mdx
@@ -0,0 +1,55 @@
+---
+title: Fluxuri de lucru
+description: Automatizați-vă procesele de business cu constructorul vizual de fluxuri de lucru al Twenty.
+icon: bolt
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+Fluxurile de lucru vă permit să automatizați sarcinile repetitive și să conectați Twenty la instrumente externe — fără a scrie cod (deși puteți, dacă doriți).
+
+
+
+## Cum funcționează fluxurile de lucru
+
+Fiecare flux de lucru are trei părți:
+
+1. **Declanșator** — Ce pornește fluxul de lucru
+2. **Pași** — Ce se întâmplă în continuare (una sau mai multe acțiuni în secvență)
+3. **Variabile** — Datele care circulă între pași
+
+## Declanșatoare
+
+| Declanșator | Când este declanșat |
+| ----------------------------- | -------------------------------------------------------------------------------------------------------------- |
+| **Eveniment de înregistrare** | O înregistrare este creată, actualizată, ștearsă sau upsertată |
+| **Manual** | Un utilizator face clic pe un buton (pe o singură înregistrare, pe mai multe înregistrări sau la nivel global) |
+| **Programare** | La un interval recurent (sintaxă cron) |
+| **Webhook** | Un sistem extern trimite un HTTP POST |
+
+## Acțiuni
+
+Fluxurile de lucru pot lega în lanț orice combinație de:
+
+* **Operațiuni pe înregistrări** — Crearea, actualizarea, căutarea, ștergerea sau upsertarea înregistrărilor
+* **Trimitere e-mail** — Trimiteți sau redactați e-mailuri din conturile conectate
+* **Solicitare HTTP** — Apelați orice API extern
+* **Cod** — Rulați JavaScript personalizat pentru logică complexă
+* **Ramificații** — Condiții if/else pentru a diviza traseul fluxului de lucru
+* **Iterator** — Parcurgeți în buclă tablouri de date
+* **Agent AI** — Lăsați un agent AI să proceseze datele în mod autonom
+* **Întârziere** — Așteptați înainte de a continua
+* **Formular** — Colectați input-ul utilizatorului la mijlocul fluxului de lucru
+
+## Ce puteți construi
+
+* Trimiteți alerte Slack când un deal ajunge într-o anumită etapă
+* Îmbogățiți automat noii contacte cu date din API-uri externe
+* Detectați oportunitățile învechite și notificați deținătorul
+* Sincronizați datele între Twenty și sistemul dvs. de facturare
+* Generați PDF-uri sau facturi din datele înregistrărilor
+* Răspundeți automat la e-mailurile primite care corespund anumitor criterii
+
+
+ Referință detaliată despre declanșatoare, acțiuni, variabile și rețete de automatizare din lumea reală.
+
diff --git a/packages/twenty-docs/l/ro/getting-started/introduction.mdx b/packages/twenty-docs/l/ro/getting-started/introduction.mdx
new file mode 100644
index 0000000000..37b3929bea
--- /dev/null
+++ b/packages/twenty-docs/l/ro/getting-started/introduction.mdx
@@ -0,0 +1,72 @@
+---
+title: De ce Twenty
+icon: heart
+---
+
+import { CardTitle } from "/snippets/card-title.mdx"
+
+Ai tot ales între software ușor de pornit, dar imposibil de schimbat, și software flexibil, dar care necesită luni întregi pentru a fi configurat. Twenty este a treia opțiune: **un CRM gata de producție, pe care îl poți remodela pe parcurs.**
+
+## Ce face Twenty diferit
+
+Twenty este o platformă pe care poți construi, nu un produs pe care îl configurezi.
+
+
+
+ Creat pentru agenți
+ Agenții operează în interiorul modelului tău de date, cu permisiuni reale. Competențe, instrumente, MCP.
+
+
+ Extensibilitate securizată
+ Flexibilitatea instrumentelor cu vibe coding, pe fundații securizate.
+
+
+ Stack modern
+ React, TypeScript. Echipa ta știe deja cum să extindă Twenty. Fără limbaje proprietare, fără blocaje de acces.
+
+
+ Fără blocare
+ Nucleu open-source, poate fi autogăzduit, îți poți exporta datele oricând.
+
+
+
+## Pentru cine este Twenty
+
+* **Marile întreprinderi care înlocuiesc Salesforce** — echipa ta
+ petrece mai mult timp luptându-se cu instrumentul decât folosindu-l.
+ Te simți blocat, iar costurile continuă să crească.
+* **Startup-uri cu fondatori tehnici** — ai depășit
+ stadiul foilor de calcul și al Notion. Ai ambiții mari și vrei
+ un CRM care să crească odată cu tine.
+* **Echipe GTM care caută un avantaj competitiv** — vrei să îți construiești
+ propriul lead scoring, propriul enrichment, propriile
+ fluxuri de lucru outbound.
+* **Organizații atente la confidențialitate** — trebuie să
+ faci autogăzduire și să deții datele cap-coadă. Din motive de reglementare,
+ contractuale sau pur și simplu de principiu.
+* **Parteneri Salesforce** —
+ dezvoltatorii tăi s-au săturat să prezinte clienților creșteri de costuri de licență.
+ Vrei un DX mai bun și să livrezi proiecte mai rapid, cu un cost de licență mai mic pentru clienții tăi.
+* **Agenții de dezvoltare web** — echipa ta cunoaște TypeScript, React
+ și PostgreSQL. Twenty deschide piața de CRM
+ pentru tine, fără să fie nevoie să înveți APEX sau să obții certificări proprietare.
+
+## Pentru cine nu este Twenty
+
+* **Echipe care vor un CRM la care să nu fie nevoite să se gândească
+ niciodată.** Twenty răsplătește echipele care vor să rămână aproape de
+ instrumentele lor și să le modeleze în timp. Dacă vrei
+ ceva complet gestionat, Pipedrive sau
+ HubSpot îți vor fi de folos.
+* **Companii care au nevoie astăzi de sute de integrări predefinite.** Ecosistemul nostru crește rapid, dar încă nu este
+ la fel de extins ca Salesforce sau HubSpot. Dacă ești confortabil
+ să construiești ce lipsește, îți va plăcea. Dacă nu, mai acordă-ne
+ încă un an.
+* **Organizații în care instrumentele sunt alese în sălile de consiliu,
+ nu de către cei care le folosesc.** Nu facem cine cu friptură
+ și briefinguri executive. Câștigăm cu echipele care au
+ autoritatea de a-și alege propriile instrumente.
+
+
+ Configurează Twenty în mai puțin de 5 minute — în cloud sau autogăzduit.
+
diff --git a/packages/twenty-docs/l/ro/getting-started/key-features.mdx b/packages/twenty-docs/l/ro/getting-started/key-features.mdx
new file mode 100644
index 0000000000..5342013401
--- /dev/null
+++ b/packages/twenty-docs/l/ro/getting-started/key-features.mdx
@@ -0,0 +1,70 @@
+---
+title: Funcții cheie
+description: Un tur al tuturor funcționalităților Twenty — de la modele de date personalizate la automatizare bazată pe AI.
+icon: star
+---
+
+import { CardTitle } from "/snippets/card-title.mdx"
+
+Twenty este o platformă CRM completă. Iată ce puteți construi cu ea.
+
+
+
+ Model de date personalizat
+ Definiți structura exactă de date de care are nevoie afacerea dvs.
+ Creați obiecte personalizate, adăugați câmpuri personalizate cu peste 20 de tipuri de câmpuri și construiți relații între orice obiecte.
+
+
+
+ Vizualizări și pipeline-uri
+ Comutați între vizualizări tabelare, panouri kanban și vizualizări calendar.
+ Filtrați cu logică AND/OR, sortați după câmpuri multiple, grupați înregistrările și salvați vizualizări personalizate.
+
+
+
+ Fluxuri de lucru și automatizare
+ Automatizați orice proces de afaceri fără a scrie cod.
+ Declanșați fluxuri de lucru la modificări ale înregistrărilor, la programări, la acțiuni manuale sau la webhooks primite.
+
+
+
+ Sincronizare calendar și email
+ Conectați-vă contul Google Workspace sau Microsoft 365.
+ Emailurile și evenimentele din calendar apar automat pe înregistrările CRM relevante.
+
+
+
+ AI
+ Agenți AI care lucrează autonom în cadrul CRM-ului dvs. — răspunzând la întrebări, îmbogățind înregistrări și executând sarcini în mai mulți pași în limitele modelului dvs. de permisiuni.
+
+
+
+ Dashboarduri și raportare
+ Construiți dashboarduri personalizate cu widgeturi în timp real.
+ Monitorizați metricile pipeline-ului, performanța echipei și indicatorii-cheie de afaceri (KPI) cu diagrame și filtre configurabile.
+
+
+
+ Permisiuni și control al accesului
+ Control al accesului bazat pe rol la fiecare nivel — obiecte, câmpuri și înregistrări individuale.
+ Configurați SSO cu SAML sau OIDC. Jurnalele de audit urmăresc cine a făcut ce.
+
+
+
+ API și extensibilitate
+ Un API orientat către dezvoltatori, care se adaptează modelului dvs. de date personalizat.
+ Atât endpointuri GraphQL, cât și REST, cu documentație generată automat pentru fiecare workspace.
+
+
+
+ Import și export de date
+ Importați date din fișiere CSV sau prin API.
+ Mapare de câmpuri, detectare de duplicate și gestionare a erorilor încorporate. Exportați-vă datele oricând — fără blocare în platformă.
+
+
+
+ Self-hosting
+ Rulați Twenty pe propria infrastructură cu o singură comandă Docker Compose.
+ Control deplin asupra datelor dvs., actualizări după propriul program.
+
+
diff --git a/packages/twenty-docs/l/ro/getting-started/quickstart.mdx b/packages/twenty-docs/l/ro/getting-started/quickstart.mdx
new file mode 100644
index 0000000000..526b4dfa94
--- /dev/null
+++ b/packages/twenty-docs/l/ro/getting-started/quickstart.mdx
@@ -0,0 +1,73 @@
+---
+title: Ghid de pornire rapidă
+description: Pune Twenty în funcțiune în mai puțin de 5 minute — în cloud sau autogăzduit.
+icon: play
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+## Înregistrare
+
+
+
+ Accesează [app.twenty.com](https://app.twenty.com) și înscrie-te cu Google, Microsoft sau e-mail.
+
+
+ Alege **30 de zile** (cu card) sau **7 zile** (fără card). Ambele includ acces complet — contacte nelimitate, integrare e-mail, obiecte personalizate, API. Poți schimba oricând planul sau intervalul de facturare.
+
+
+ După confirmarea plății prin Stripe, vei configura numele spațiului de lucru și profilul de utilizator. Poți anula oricând.
+
+
+
+
+
+## Configurează-ți spațiul de lucru
+
+Odată ce ai intrat, ai trei pași pentru a face Twenty al tău:
+
+### 1. Conectează-ți căsuța de e-mail
+
+Accesează **Setări → Conturi** și conectează-ți contul Google sau Microsoft. Twenty va importa e-mailurile și evenimentele din calendar și va crea automat contacte din interacțiuni. Folosești un alt furnizor? Poți adăuga căsuțe poștale prin SMTP sau calendare prin CalDAV de pe aceeași pagină.
+
+Începe de aici — conectarea unei căsuțe poștale oferă echipei tale valoare imediată cu date reale înainte de a personaliza orice altceva.
+
+
+
+### 2. Definește-ți modelul de date
+
+Accesează **Setări → Model de date** pentru a crea obiecte și câmpuri personalizate. Câteva lucruri de știut:
+
+* Obiectele și câmpurile personalizate sunt **nelimitate în toate planurile** — fără costuri suplimentare.
+* **Persoane, Companii și Oportunități** sunt obiectele care afișează e-mailurile și întâlnirile sincronizate. Folosește-le ca bază și adaugă câmpuri pentru a categoriza (de ex., un câmp `Person Type`) în loc să creezi obiecte separate care nu vor avea istoric de e-mailuri.
+* Două Persoane nu pot avea același e-mail. Două Companii nu pot avea același domeniu.
+* Poți dezactiva câmpurile/obiectele standard de care nu ai nevoie și poți ascunde câmpuri din vizualizări fără a le șterge.
+
+[Model de date – referință →](/l/ro/user-guide/data-model/overview)
+
+
+
+### 3. Importă-ți datele
+
+Folosește meniul Comandă (`Cmd+K` / `Ctrl+K`) pentru a importa Persoane, Companii, Oportunități sau orice obiect personalizat prin CSV. Descarcă mai întâi fișierul exemplu pentru a vedea formatul așteptat. Limitează fișierele la 10.000 de înregistrări și elimină duplicatele de e-mailuri/domenii înainte de import.
+
+[Ghid de migrare a datelor →](/l/ro/user-guide/data-migration/overview)
+
+
+
+## Pașii următori
+
+
+
+ Navigare, vizualizări, meniul Comandă, panou lateral.
+
+
+ Automatizează-ți procesele de afaceri.
+
+
+ Tabel, kanban, calendar — filtrează și sortează-ți datele.
+
+
+ Schemă per tenant pentru REST și GraphQL.
+
+
diff --git a/packages/twenty-docs/l/ru/getting-started/core-concepts/ai.mdx b/packages/twenty-docs/l/ru/getting-started/core-concepts/ai.mdx
new file mode 100644
index 0000000000..ed672c79fe
--- /dev/null
+++ b/packages/twenty-docs/l/ru/getting-started/core-concepts/ai.mdx
@@ -0,0 +1,34 @@
+---
+title: ИИ
+description: Как Twenty использует ИИ, чтобы улучшить ваш опыт работы с CRM.
+icon: robot
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+Twenty интегрирует ИИ напрямую в вашу CRM — не как маркетинговый трюк, а как инструмент, который работает в рамках вашей модели данных и системы разрешений.
+
+## Чат-бот на базе ИИ
+
+Задавайте вопросы о своих данных на естественном языке. Чат-бот на базе ИИ может запрашивать записи в вашей CRM, суммировать информацию и помогать вам находить нужное, не создавая сложных фильтров.
+
+
+
+## Агенты ИИ
+
+AI-агенты выходят за рамки просто чата — они могут автономно выполнять многошаговые задачи:
+
+* Обогащать записи данными из внешних источников
+* Подготавливать и отправлять последующие письма
+* Анализировать состояние воронки и помечать сделки с повышенным риском
+* Обрабатывать входящие данные и направлять их в нужную команду
+
+Агенты работают в рамках ваших существующих рабочих процессов, поэтому вы можете сочетать ИИ с ручными утверждениями, условной логикой и внешними вызовами API.
+
+## Разрешения и безопасность
+
+ИИ в Twenty соблюдает вашу модель разрешений. Агенты могут получать доступ только к объектам и полям, к просмотру которых у пользователя (или роли) есть разрешение. Конфиденциальные данные остаются защищенными, даже когда используется ИИ.
+
+
+ Подробная справка по чат-боту, агентам и настройкам разрешений.
+
diff --git a/packages/twenty-docs/l/ru/getting-started/core-concepts/apps.mdx b/packages/twenty-docs/l/ru/getting-started/core-concepts/apps.mdx
new file mode 100644
index 0000000000..6a67e6f06e
--- /dev/null
+++ b/packages/twenty-docs/l/ru/getting-started/core-concepts/apps.mdx
@@ -0,0 +1,41 @@
+---
+title: Приложения
+icon: cube
+description: Расширяйте Twenty с помощью кода — пользовательских объектов, серверной логики, UI-компонентов и ИИ-агентов, всё в виде пакетов TypeScript.
+---
+
+Большинство CRM-систем дают вам панель настроек. Twenty даёт вам платформу. Приложения — это способ, с помощью которого разработчики расширяют Twenty за рамки возможностей интерфейса: они определяют модели данных, серверную логику, UI-компоненты и возможности ИИ как код, а затем развёртывают их в одном или нескольких рабочих пространствах.
+
+## Зачем нужны приложения
+
+Рабочие процессы охватывают автоматизацию без кода. Но для некоторых вещей нужен код: пользовательский механизм ценообразования, проприетарный конвейер обогащения данных, проверка на соответствие требованиям, которая запускается при каждом обновлении записи, пользовательская панель интерфейса, подтягивающая данные из внутреннего инструмента.
+
+Приложения позволяют создавать всё это как полноценные расширения — не хрупкие скрипты, которые снаружи обращаются к API, а код, который запускается на платформе с полным доступом к системе типов, модели прав доступа и пользовательскому интерфейсу.
+
+## Что может определять приложение
+
+Приложение — это пакет TypeScript, который объявляет **сущности** с помощью `twenty-sdk`:
+
+| Сущность | Что делает |
+| ----------------------------- | ------------------------------------------------------------------------------------------------------------------------ |
+| **Объекты и поля** | Новые таблицы данных и поля в существующих объектах — такой же подход, как и для встроенных. |
+| **Логические функции** | Серверный TypeScript, запускаемый HTTP-маршрутами, расписаниями cron или событиями базы данных |
+| **Компоненты фронтенда** | Изолированные React-компоненты, которые отображаются внутри интерфейса Twenty (боковая панель, виджеты, командное меню). |
+| **Навыки и агенты** | Возможности ИИ — многократно используемые инструкции и автономные помощники |
+| **Представления и навигация** | Предварительно настроенные представления списков и элементы бокового меню |
+
+Всё определяется с помощью анализа AST на этапе сборки — без конфигурационных файлов и шаблонного кода регистрации. Добавьте `export default defineObject(...)` в любой файл `.ts`, и SDK его подхватит.
+
+## Как они выполняются
+
+* **Логические функции** выполняются в изолированных процессах Node.js, отделённых от хоста. Они получают доступ к данным через типизированный клиент API, ограниченный правами роли приложения.
+* **Компоненты фронтенда** запускаются в Web Workers с использованием Remote DOM — изолированы от основной страницы, но при этом рендерят нативные элементы DOM (не iframes).
+* **Права доступа** применяются на уровне API. Приложение видит только то, что разрешает его роль.
+
+## Опыт разработки
+
+Вы пишете своё приложение как TypeScript-проект на своём компьютере. CLI отслеживает ваши исходные файлы и в реальном времени синхронизирует их с запущенным сервером Twenty — редактируйте файл и увидите изменения в интерфейсе за секунду. Типизированный клиент API автоматически пересоздаётся при изменении схемы. Когда будете готовы, `yarn twenty app:publish --private` развернёт приложение на production-сервере, а `yarn twenty app:publish` опубликует его в npm и на маркетплейсе Twenty.
+
+
+ Пошаговое руководство из трёх этапов — создание каркаса, запуск локального сервера, синхронизация изменений.
+
diff --git a/packages/twenty-docs/l/ru/getting-started/core-concepts/calendar-and-email.mdx b/packages/twenty-docs/l/ru/getting-started/core-concepts/calendar-and-email.mdx
new file mode 100644
index 0000000000..1d1edad052
--- /dev/null
+++ b/packages/twenty-docs/l/ru/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 — добавляя пользовательский интерфейс, серверную логику и глубокие интеграции. Приложения можно публиковать для сообщества или оставлять приватными.
+
+
+
+ Настройте синхронизацию электронной почты и календаря и устраните неполадки.
+
+
+ Создавайте собственные интеграции с помощью API Twenty.
+
+
diff --git a/packages/twenty-docs/l/ru/getting-started/core-concepts/dashboards.mdx b/packages/twenty-docs/l/ru/getting-started/core-concepts/dashboards.mdx
new file mode 100644
index 0000000000..7458b48485
--- /dev/null
+++ b/packages/twenty-docs/l/ru/getting-started/core-concepts/dashboards.mdx
@@ -0,0 +1,37 @@
+---
+title: Панели управления
+description: Отслеживайте эффективность и визуализируйте свои данные CRM с помощью настраиваемых панелей мониторинга.
+icon: chart-bar
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+Панели мониторинга дают вам доступ к показателям бизнеса в режиме реального времени — состоянию воронки, эффективности команды, динамике выручки и любым другим метрикам, которые вы хотите отслеживать.
+
+
+
+## Виджеты
+
+Каждая панель мониторинга состоит из виджетов. Виджет — это отдельный график или метрика, связанная с вашими данными CRM. Вы можете настроить:
+
+* **Тип диаграммы** — столбчатая, линейная, круговая, числовой показатель и другие
+* **Источник данных** — любой объект в вашей модели данных (стандартный или настраиваемый)
+* **Фильтры** — сузить выбор до конкретных записей, диапазонов дат или сегментов
+* **Агрегация** — количество, сумма, среднее, минимум, максимум по любому числовому полю
+* **Группировка** — разбивка по выбранным полям, датам или связям
+
+## Что вы можете отслеживать
+
+* Сумма воронки по этапам
+* Сделки, закрытые за период
+* Средний размер сделки по источнику
+* Показатели выполнения задач
+* Пользовательские метрики по любому объекту
+
+## Совместный доступ
+
+Панели мониторинга действуют на уровне рабочего пространства — каждый участник вашей команды может их видеть. Располагаете виджеты в виде сетки и изменяйте их размер, чтобы создать представление, которое подходит вашей команде.
+
+
+ Подробная справка по созданию панелей мониторинга, настройке виджетов и параметров диаграмм.
+
diff --git a/packages/twenty-docs/l/ru/getting-started/core-concepts/data-model.mdx b/packages/twenty-docs/l/ru/getting-started/core-concepts/data-model.mdx
new file mode 100644
index 0000000000..1996305786
--- /dev/null
+++ b/packages/twenty-docs/l/ru/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 поддерживает широкий набор типов полей:
+
+| Категория | Типы |
+| --------------- | ------------------------------------------------------------------------------ |
+| **Базовые** | Текст, Число, Булево значение, Дата, Валюта, Оценка, Список |
+| **Составные** | Адрес (улица, город, штат, индекс), Полное имя, Ссылки, Телефоны, Email-адреса |
+| **Специальные** | Связь, Файловое вложение, JSON, Участник (кто создал/изменил) |
+
+Каждый объект также получает автоматические системные поля: `id`, `createdAt`, `updatedAt`, `createdBy` и `position`.
+
+## Связи
+
+Объекты соединяются друг с другом с помощью связей. Компания имеет много людей, возможность принадлежит компании и так далее. Вы можете создавать пользовательские связи между любыми объектами, включая связи «многие ко многим».
+
+## Почему это мощно
+
+В отличие от традиционных CRM, где вы ограничены предопределёнными полями на предопределённых объектах, Twenty позволяет моделировать данные именно так, как устроен ваш бизнес. Пользовательские объекты получают такой же статус, как и встроенные, — включая API endpoints, представления, права доступа и триггеры рабочих процессов.
+
+
+ Полная справка по объектам, полям, связям и их настройке.
+
+
+
diff --git a/packages/twenty-docs/l/ru/getting-started/core-concepts/glossary.mdx b/packages/twenty-docs/l/ru/getting-started/core-concepts/glossary.mdx
new file mode 100644
index 0000000000..8aaf68e86c
--- /dev/null
+++ b/packages/twenty-docs/l/ru/getting-started/core-concepts/glossary.mdx
@@ -0,0 +1,105 @@
+---
+title: Глоссарий
+icon: книга
+description: Ключевые термины, использующиеся в Twenty.
+---
+
+## API
+
+API (интерфейс программирования приложений) позволяет подключать Twenty к другим программным системам и создавать пользовательские интеграции.
+
+## Приложения
+
+Приложения — это настраиваемые расширения, создаваемые в виде кода, которые могут определять модели данных и функции бизнес-логики. Они позволяют разработчикам создавать повторно используемые пользовательские настройки, которые можно развертывать в нескольких рабочих пространствах.
+
+## Действия кода
+
+Действия кода — это шаги рабочего процесса, которые позволяют писать пользовательский JavaScript для преобразования данных, выполнения вычислений или реализации сложной логики, недоступной во встроенных действиях.
+
+## Меню команд
+
+Меню команд — это интерфейс быстрого доступа (открывается с помощью `Cmd + K` на Mac и `Ctrl + K` на Windows), который позволяет выполнять действия, создавать записи и эффективно перемещаться по рабочему пространству.
+
+## Компания и Люди
+
+CRM имеет два основных типа записей:
+
+* «Компания» представляет собой бизнес или организацию.
+* «Люди» представляют собой текущих и потенциальных клиентов вашей компании.
+
+## Пользовательские поля
+
+Пользовательские поля — это поля данных, которые вы создаете для сбора информации, специфичной для ваших бизнес-потребностей и процессов.
+
+## Модель данных
+
+Модель данных — это структура, которая определяет, как информация организована в вашей CRM, включая какие объекты существуют, их свойства (поля) и как они связаны друг с другом.
+
+## Избранное
+
+Избранное — это записи, которые вы пометили для быстрого доступа, они появляются в вашей боковой панели для мгновенной навигации к важным данным.
+
+## Поле
+
+Поле относится к определенной области, в которой хранится конкретная информация для объекта.
+
+## Итератор
+
+Итератор — это действие рабочего процесса, которое перебирает массив элементов, выполняя последующие действия для каждого элемента в списке.
+
+## Канбан
+
+Канбан — это визуальный способ отслеживания бизнес-процессов с использованием карточек и колонок. Каждая колонка представляет этап в вашем процессе (например: новые, в работе, выиграны, потеряны), и вы перемещаете записи через эти этапы по мере их продвижения.
+
+## Объект
+
+Объект — это структура данных, представляющая определенный тип сущности в вашей CRM (например, Люди, Компании или Возможности). Объекты могут быть стандартными (встроенными) или пользовательскими (созданными вами).
+
+## Возможности
+
+Возможности в Twenty CRM — это потенциальные сделки или продажи с аккаунтами или контактами.
+
+## Запись
+
+Запись указывает на экземпляр объекта, например, определенный аккаунт или контакт.
+
+## Поля связи
+
+Поля связи создают связи между различными объектами, позволяя связывать записи друг с другом (например, связывать Человека с Компанией).
+
+## Стандартные поля
+
+Стандартные поля — это предустановленные поля данных, которые включены в объекты по умолчанию и обеспечивают общую функциональность во всех рабочих пространствах.
+
+## Задачи
+
+Задачи в Twenty CRM — это назначенные действия, связанные с контактами, аккаунтами или возможностями.
+
+## Триггеры
+
+Триггеры — отправная точка рабочего процесса — событие или условие, которое инициирует автоматизацию. К примерам относятся создание и обновление записей, вебхуки или запланированное время.
+
+## Представления
+
+Вы можете настраивать отображение своих записей, используя представления, устанавливая различные фильтры, макеты и параметры сортировки для каждого представления.
+
+## Upsert
+
+Upsert — это операция, сочетающая "update" и "insert" — она обновляет существующую запись, если найдено совпадение, или создает новую запись, если совпадения нет.
+
+## Вебхуки
+
+Вебхуки — это автоматизированные сообщения, отправляемые от Twenty в другие приложения при возникновении определенных событий, обеспечивая синхронизацию данных в реальном времени.
+
+## Рабочие процессы
+
+Рабочие процессы — это автоматизированные процессы, которые запускают действия на основе определенных условий, помогая автоматизировать повторяющиеся задачи и бизнес-процессы.
+
+## Рабочее пространство
+
+Рабочее пространство обычно представляет собой компанию, использующую Twenty. В нем хранятся все записи и данные, которые вы и участники вашей команды добавляете в Twenty.
+У него одно доменное имя — обычно то, которое ваша компания использует для адресов электронной почты сотрудников.
+
+## Участники рабочего пространства
+
+Участники рабочего пространства — это пользователи Twenty из вашей команды, которые имеют доступ к вашему рабочему пространству. Они могут быть назначены в качестве владельцев или ответственных за записи.
diff --git a/packages/twenty-docs/l/ru/getting-started/core-concepts/layout.mdx b/packages/twenty-docs/l/ru/getting-started/core-concepts/layout.mdx
new file mode 100644
index 0000000000..a2e7ceba3d
--- /dev/null
+++ b/packages/twenty-docs/l/ru/getting-started/core-concepts/layout.mdx
@@ -0,0 +1,74 @@
+---
+title: Макет
+description: Как ориентироваться, просматривать и открывать записи в Twenty.
+icon: table-columns
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+## Основная компоновка
+
+В центре экрана находятся ваши записи — люди, компании, сделки, задачи, заметки, дашборды, рабочие процессы и любые настраиваемые объекты. Здесь вы просматриваете, изменяете и удаляете записи, а также создаете новые представления.
+
+
+
+## Панель навигации
+
+Левая боковая панель содержит:
+
+* **Переключатель рабочих пространств** — переключайтесь между рабочими пространствами или создавайте новое (выпадающий список вверху)
+* **Поиск** — нажмите `/`, чтобы сразу перейти к нему; поиск выполняется по всем объектам
+* **Настройки** — доступ из левого верхнего угла
+* **Избранное** — закрепленные представления, уникальные для каждого пользователя
+* **Ярлыки объектов** — быстрый доступ к людям, компаниям, сделкам и т. д.
+* **Рабочие процессы** — создавайте автоматизации
+
+Перетаскивайте элементы, чтобы изменить порядок; создавайте папки для группировки связанных объектов; скрывайте то, чем не пользуетесь.
+
+
+
+## Меню команд
+
+Нажмите `Cmd+K` (Mac) или `Ctrl+K` (Windows) — либо кликните по трем точкам в правом верхнем углу. Отсюда вы можете:
+
+* Создавать новые записи
+* Импортировать и экспортировать данные в формате CSV
+* Создавать новые представления
+* Получать доступ к удалённым записям (в Twenty поддерживаются мягкое и жёсткое удаление)
+* Просматривать сочетания клавиш для навигации по рабочему пространству
+
+
+
+## Поиск
+
+Доступно через меню команд, в верхней части панели навигации или по нажатию `/`. Поиск работает по всем объектам.
+
+
+
+## Боковая панель
+
+Щелкните по записи, чтобы открыть боковую панель справа — краткий обзор ключевой информации о записи без перехода на другую страницу. Нажмите **Открыть**, чтобы перейти на полную страницу записи.
+
+
+
+## Представления
+
+Каждый объект поддерживает несколько представлений — без ограничений для каждого объекта. Используйте выпадающий список в левом верхнем углу, чтобы переключаться между ними.
+
+* **Таблица** — строки и столбцы в формате электронных таблиц с группировкой, встроенным редактированием и настройкой столбцов
+* **Канбан** — перетаскиваемые карточки, организованные по полю выбора, идеально для воронок
+* **Календарь** — записи, отображаемые по полю даты для планирования во времени
+
+Каждое представление сохраняет свои собственные фильтры, сортировку и видимость полей. Делитесь представлениями со своим рабочим пространством или оставляйте их личными. Добавляйте представления в избранное для быстрого доступа из боковой панели.
+
+
+
+## Страницы записей
+
+Когда вы открываете запись, страница сведений формируется из настраиваемых **вкладок** и **виджетов**. Добавляйте, удаляйте, меняйте порядок и изменяйте размер виджетов в сетке — поля, связанные записи, электронные письма, ленту активности, задачи, заметки, файлы, диаграммы, iframes и многое другое. У каждого типа объекта есть собственная компоновка.
+
+
+ Навигация, представления, страницы записей — подробная справка и практические инструкции.
+
+
+
diff --git a/packages/twenty-docs/l/ru/getting-started/core-concepts/workflows.mdx b/packages/twenty-docs/l/ru/getting-started/core-concepts/workflows.mdx
new file mode 100644
index 0000000000..eb9d76261d
--- /dev/null
+++ b/packages/twenty-docs/l/ru/getting-started/core-concepts/workflows.mdx
@@ -0,0 +1,55 @@
+---
+title: Рабочие процессы
+description: Автоматизируйте бизнес-процессы с помощью визуального конструктора рабочих процессов Twenty.
+icon: bolt
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+Рабочие процессы позволяют автоматизировать повторяющиеся задачи и подключать Twenty к внешним инструментам — без написания кода (хотя при желании вы можете его использовать).
+
+
+
+## Как работают рабочие процессы
+
+У каждого рабочего процесса есть три части:
+
+1. **Trigger** — что запускает рабочий процесс
+2. **Steps** — что происходит дальше (одно или несколько действий последовательно)
+3. **Variables** — данные, которые передаются между шагами
+
+## Триггеры
+
+| Триггер | Когда срабатывает |
+| ---------------- | --------------------------------------------------------------------------------- |
+| **Record event** | Запись создается, обновляется, удаляется или выполняется upsert |
+| **Вручную** | Пользователь нажимает кнопку (для одной записи, нескольких записей или глобально) |
+| **Schedule** | Через регулярные интервалы (синтаксис cron) |
+| **Вебхук** | Внешняя система отправляет HTTP POST |
+
+## Действия
+
+Рабочие процессы могут объединять в цепочку любую комбинацию следующих элементов:
+
+* **Record operations** — создание, обновление, поиск, удаление или upsert записей
+* **Send email** — отправка или подготовка писем из подключенных учетных записей
+* **HTTP request** — вызов любого внешнего API
+* **Code** — запуск пользовательского JavaScript для сложной логики
+* **Branches** — условия if/else для разветвления пути рабочего процесса
+* **Iterator** — перебор массивов данных
+* **AI Agent** — позволяет агенту ИИ автономно обрабатывать данные
+* **Delay** — ожидание перед продолжением
+* **Form** — сбор пользовательского ввода в середине рабочего процесса
+
+## Что вы можете создать
+
+* Отправляйте оповещения в Slack, когда сделка достигает определенного этапа
+* Автоматически обогащайте новые контакты данными из внешних API
+* Обнаруживайте «застаивающиеся» возможности и уведомляйте их владельца
+* Синхронизируйте данные между Twenty и вашей биллинговой системой
+* Генерируйте PDF или счета на основе данных записей
+* Автоматически отвечайте на входящие письма, соответствующие определенным критериям
+
+
+ Подробный справочник по триггерам, действиям, переменным и практическим сценариям автоматизации.
+
diff --git a/packages/twenty-docs/l/ru/getting-started/introduction.mdx b/packages/twenty-docs/l/ru/getting-started/introduction.mdx
new file mode 100644
index 0000000000..838965b055
--- /dev/null
+++ b/packages/twenty-docs/l/ru/getting-started/introduction.mdx
@@ -0,0 +1,72 @@
+---
+title: Почему Twenty
+icon: heart
+---
+
+import { CardTitle } from "/snippets/card-title.mdx"
+
+Вы выбирали между программным обеспечением, которое легко запустить, но невозможно менять, и программным обеспечением, которое гибкое, но требует месяцев на настройку. Twenty — это третий вариант: **готовая к продакшну CRM, которую вы можете менять по ходу дела.**
+
+## Чем Twenty отличается
+
+Twenty — это платформа, на основе которой вы можете строить решения, а не продукт, который вы просто настраиваете.
+
+
+
+ Создано для агентов
+ Агенты работают внутри вашей дата-модели с реальными правами доступа. Навыки, инструменты, MCP.
+
+
+ Безопасная расширяемость
+ Гибкость vibe-coded инструментов на защищённом фундаменте.
+
+
+ Современный стек
+ React, TypeScript. Ваша команда уже знает, как расширять Twenty. Никаких проприетарных языков, никакого гейткипинга.
+
+
+ Без эффекта блокировки
+ Open-source ядро, возможность self-host, экспортируйте свои данные в любой момент.
+
+
+
+## Для кого Twenty
+
+* **Крупные предприятия, заменяющие Salesforce** — ваша команда
+ тратит больше времени на борьбу с инструментом, чем на его использование.
+ Вы чувствуете себя запертыми в рамках решения, а затраты продолжают расти.
+* **Стартапы с техническими основателями** — вы переросли
+ таблицы и Notion. У вас большие амбиции, и вы хотите
+ CRM, которая будет масштабироваться вместе с вами.
+* **Команды GTM, ищущие преимущество** — вы хотите строить
+ собственный скоринг лидов, собственное обогащение, собственные
+ outbound-воркфлоу.
+* **Организации, ориентированные на конфиденциальность** — вам нужно
+ размещать решение у себя и полностью владеть своими данными от начала и до конца. По регуляторным,
+ договорным причинам или просто по принципу.
+* **Партнёры Salesforce** —
+ ваши разработчики устали рассказывать клиентам о повышении стоимости лицензий.
+ Вы хотите лучший DX и возможность сдавать проекты быстрее при более низкой лицензионной стоимости для своих клиентов.
+* **Веб-агентства по разработке** — ваша команда знает TypeScript, React
+ и PostgreSQL. Twenty открывает для вас рынок CRM,
+ не требуя изучения APEX или получения проприетарных сертификатов.
+
+## Для кого Twenty не подходит
+
+* **Команды, которым нужна CRM, о которой никогда не придётся
+ думать.** Twenty подходит командам, которые хотят оставаться близко к
+ своим инструментам и со временем формировать их под себя. Если вы хотите
+ полностью управляемое решение, Pipedrive или
+ HubSpot вас не подведут.
+* **Компании, которым уже сегодня нужны сотни готовых интеграций.** Наша экосистема быстро растёт, но она пока
+ не такая широкая, как у Salesforce или HubSpot. Если вы готовы
+ разрабатывать недостающее, вам это понравится. Если нет —
+ дайте нам ещё год.
+* **Организации, где инструменты выбирают в переговорных,
+ а не те, кто ими пользуется.** Мы не устраиваем стейк-ужины
+ и executive-брифинги. Мы побеждаем с командами, у которых
+ есть полномочия выбирать собственные инструменты.
+
+
+ Настройте Twenty менее чем за 5 минут — в облаке или на собственном сервере.
+
diff --git a/packages/twenty-docs/l/ru/getting-started/key-features.mdx b/packages/twenty-docs/l/ru/getting-started/key-features.mdx
new file mode 100644
index 0000000000..13ee3d46ca
--- /dev/null
+++ b/packages/twenty-docs/l/ru/getting-started/key-features.mdx
@@ -0,0 +1,70 @@
+---
+title: Ключевые функции
+description: Обзор всех возможностей Twenty — от настраиваемых моделей данных до автоматизации на базе ИИ.
+icon: star
+---
+
+import { CardTitle } from "/snippets/card-title.mdx"
+
+Twenty — это полнофункциональная платформа CRM. Вот что вы можете с ней создать.
+
+
+
+ Настраиваемая модель данных
+ Определяйте точную структуру данных, которая нужна вашему бизнесу.
+ Создавайте пользовательские объекты, добавляйте настраиваемые поля с более чем 20 типами полей и выстраивайте связи между любыми объектами.
+
+
+
+ Представления и воронки
+ Переключайтесь между табличными представлениями, досками канбан и календарными представлениями.
+ Фильтруйте с логикой AND/OR, сортируйте по нескольким полям, группируйте записи и сохраняйте пользовательские представления.
+
+
+
+ Рабочие процессы и автоматизация
+ Автоматизируйте любые бизнес-процессы без написания кода.
+ Запускайте рабочие процессы при изменении записей, по расписанию, вручную или при получении входящих webhooks.
+
+
+
+ Синхронизация календаря и электронной почты
+ Подключите свою учетную запись Google Workspace или Microsoft 365.
+ Письма и события календаря автоматически появляются в соответствующих записях CRM.
+
+
+
+ ИИ
+ Автономные ИИ-агенты, работающие внутри вашей CRM — отвечают на вопросы, обогащают записи и выполняют многошаговые задачи в рамках вашей модели разрешений.
+
+
+
+ Панели и отчеты
+ Создавайте настраиваемые панели с виджетами в реальном времени.
+ Отслеживайте метрики воронки, эффективность команды и бизнес-KPI с помощью настраиваемых диаграмм и фильтров.
+
+
+
+ Права и контроль доступа
+ Ролевое управление доступом на каждом уровне — объекты, поля и отдельные записи.
+ Настройте SSO с SAML или OIDC. Журналы аудита отслеживают, кто что сделал.
+
+
+
+ API и расширяемость
+ Ориентированный на разработчиков API, который адаптируется к вашей настраиваемой модели данных.
+ И GraphQL, и REST endpoints с автоматически генерируемой документацией для каждого workspace.
+
+
+
+ Импорт и экспорт данных
+ Импортируйте данные из файлов CSV или через API.
+ Встроены сопоставление полей, обнаружение дубликатов и обработка ошибок. Экспортируйте свои данные в любой момент — без ограничения поставщиком.
+
+
+
+ Самостоятельный хостинг
+ Запустите Twenty в своей инфраструктуре одной командой Docker Compose.
+ Полный контроль над вашими данными, обновления по вашему графику.
+
+
diff --git a/packages/twenty-docs/l/ru/getting-started/quickstart.mdx b/packages/twenty-docs/l/ru/getting-started/quickstart.mdx
new file mode 100644
index 0000000000..e216c36f7c
--- /dev/null
+++ b/packages/twenty-docs/l/ru/getting-started/quickstart.mdx
@@ -0,0 +1,73 @@
+---
+title: Быстрый старт
+description: Запустите Twenty и начните работу менее чем за 5 минут — в облаке или на собственном сервере.
+icon: play
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+## Регистрация
+
+
+
+ Перейдите на [app.twenty.com](https://app.twenty.com) и зарегистрируйтесь с помощью Google, Microsoft или электронной почты.
+
+
+ Выберите **30 дней** (с картой) или **7 дней** (без карты). Оба варианта включают полный доступ — неограниченное количество контактов, интеграцию с электронной почтой, пользовательские объекты, API. Вы можете изменить тариф или платёжный интервал в любое время.
+
+
+ После подтверждения оплаты через Stripe вы настроите название рабочего пространства и профиль пользователя. Вы можете отменить подписку в любое время.
+
+
+
+
+
+## Настройка рабочего пространства
+
+Когда вы войдёте в систему, выполните три шага, чтобы сделать Twenty именно вашим:
+
+### 1. Подключите свою почту
+
+Перейдите в раздел **Настройки → Аккаунты** и подключите свой аккаунт Google или Microsoft. Twenty импортирует ваши электронные письма и события в календаре и автоматически создаст контакты на основе взаимодействий. Пользуетесь другим провайдером? Вы можете добавить почтовые ящики через SMTP или календари через CalDAV на этой же странице.
+
+Начните отсюда — подключение почтового ящика даёт вашей команде мгновенную ценность за счёт реальных данных ещё до того, как вы настроите что‑либо ещё.
+
+
+
+### 2. Сформируйте свою модель данных
+
+Перейдите в раздел **Настройки → Модель данных**, чтобы создавать пользовательские объекты и поля. Несколько важных моментов:
+
+* Пользовательские объекты и поля **не ограничены на всех тарифах** — без дополнительных доплат.
+* **People, Companies и Opportunities** — это объекты, в которых отображаются синхронизированные письма и встречи. Используйте их как основу и добавляйте поля для категоризации (например, поле `Person Type`), вместо того чтобы создавать отдельные объекты без истории электронной почты.
+* Два человека не могут иметь один и тот же адрес электронной почты. Две компании не могут использовать один и тот же домен.
+* Вы можете деактивировать стандартные поля и объекты, которые вам не нужны, а также скрывать поля из представлений, не удаляя их.
+
+[Справочник по модели данных →](/l/ru/user-guide/data-model/overview)
+
+
+
+### 3. Импортируйте ваши данные
+
+Используйте меню команд (`Cmd+K` / `Ctrl+K`), чтобы импортировать People, Companies, Opportunities или любые пользовательские объекты через CSV. Сначала скачайте пример файла, чтобы увидеть ожидаемый формат. Ограничьте файлы 10 000 записей и удалите дубликаты адресов электронной почты/доменов перед импортом.
+
+[Руководство по миграции данных →](/l/ru/user-guide/data-migration/overview)
+
+
+
+## Следующие шаги
+
+
+
+ Навигация, представления, командное меню, боковая панель.
+
+
+ Автоматизируйте свои бизнес-процессы.
+
+
+ Таблица, канбан, календарь — фильтруйте и сортируйте свои данные.
+
+
+ REST и GraphQL с отдельной схемой для каждого арендатора.
+
+
diff --git a/packages/twenty-docs/l/tr/getting-started/core-concepts/ai.mdx b/packages/twenty-docs/l/tr/getting-started/core-concepts/ai.mdx
new file mode 100644
index 0000000000..2a7dc20f73
--- /dev/null
+++ b/packages/twenty-docs/l/tr/getting-started/core-concepts/ai.mdx
@@ -0,0 +1,34 @@
+---
+title: AI
+description: Twenty, CRM deneyiminizi geliştirmek için yapay zekayı nasıl kullanıyor.
+icon: robot
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+Twenty, yapay zekayı doğrudan CRM’inize entegre eder — bir göz boyama olarak değil, veri modeliniz ve izin sisteminiz içinde çalışan bir araç olarak.
+
+## Yapay Zeka Sohbet Botu
+
+Verileriniz hakkında doğal dilde sorular sorun. Yapay zeka sohbet botu, CRM kayıtlarınızı sorgulayabilir, bilgileri özetleyebilir ve karmaşık filtreler oluşturmadan aradığınızı bulmanıza yardımcı olabilir.
+
+
+
+## Yapay Zeka Temsilcileri
+
+Yapay zeka ajanları yalnızca sohbetin ötesine geçer — çok adımlı görevleri kendi kendilerine yerine getirebilir:
+
+* Kayıtları harici kaynaklardan gelen verilerle zenginleştirin
+* Takip e-postalarını taslak olarak hazırlayın ve gönderin
+* Boruhattı sağlığını analiz edin ve risk altındaki anlaşmaları işaretleyin
+* Gelen verileri işleyin ve doğru ekibe yönlendirin
+
+Ajanlar mevcut iş akışlarınız içinde çalışır, böylece yapay zekayı manuel onaylar, koşullu mantık ve harici API çağrılarıyla birleştirebilirsiniz.
+
+## İzinler ve güvenlik
+
+Twenty’deki yapay zeka, izin modelinize saygı duyar. Ajanlar yalnızca kullanıcının (veya rolün) görüntüleme iznine sahip olduğu nesnelere ve alanlara erişebilir. Hassas veriler, yapay zeka devreye girdiğinde bile koruma altında kalır.
+
+
+ Sohbet botu, ajanlar ve izin kontrolleri hakkında ayrıntılı başvuru.
+
diff --git a/packages/twenty-docs/l/tr/getting-started/core-concepts/apps.mdx b/packages/twenty-docs/l/tr/getting-started/core-concepts/apps.mdx
new file mode 100644
index 0000000000..c5d41055ff
--- /dev/null
+++ b/packages/twenty-docs/l/tr/getting-started/core-concepts/apps.mdx
@@ -0,0 +1,41 @@
+---
+title: Uygulamalar
+icon: cube
+description: Kod ile Twenty'yi genişletin — özel nesneler, sunucu tarafı mantık, UI bileşenleri ve yapay zeka ajanları; bunların tümü TypeScript paketleri olarak.
+---
+
+Çoğu CRM size bir yapılandırma paneli sunar. Twenty size bir platform sunar. Uygulamalar, geliştiricilerin Twenty'yi UI'nin sunduğunun ötesine genişletme yoludur — veri modellerini, sunucu tarafı mantığını, UI bileşenlerini ve yapay zeka yeteneklerini kod olarak tanımlayıp bunları bir veya daha fazla çalışma alanına dağıtırlar.
+
+## Uygulamaların var olma nedeni
+
+İş akışları kodsuz otomasyonu kapsar. Ancak bazı şeyler kod gerektirir: özel bir fiyatlandırma motoru, tescilli bir zenginleştirme hattı, her kayıt güncellemesinde çalışan bir uyumluluk kontrolü, dahili bir araçtan veri çeken özel bir UI paneli.
+
+Uygulamalar, bunları birinci sınıf uzantılar olarak oluşturmanıza olanak tanır — dışarıdan bir API ile konuşan kırılgan komut dosyaları değil, tür sistemi, izin modeli ve UI'ye tam erişimi olan, platformda çalışan kod olarak.
+
+## Bir uygulamanın tanımlayabilecekleri
+
+Bir uygulama, `twenty-sdk` kullanarak **varlıklar** bildiren bir TypeScript paketidir:
+
+| Varlık | Ne yapar |
+| ------------------------- | --------------------------------------------------------------------------------------------------------------------- |
+| **Nesneler ve Alanlar** | Yeni veri tabloları ve mevcut nesneler üzerindeki alanlar — yerleşik olanlarla aynı şekilde ele alınır |
+| **Mantıksal işlevler** | HTTP rotaları, cron zamanlamaları veya veritabanı olayları tarafından tetiklenen sunucu tarafı TypeScript |
+| **Ön uç bileşenleri** | Twenty'nin arayüzünde (yan panel, widget'lar, komut menüsü) oluşturulan, korumalı alanlarda çalışan React bileşenleri |
+| **Beceriler ve Aracılar** | Yapay zeka yetenekleri — yeniden kullanılabilir yönergeler ve otonom asistanlar |
+| **Görünümler ve Gezinme** | Önceden yapılandırılmış liste görünümleri ve kenar çubuğu menü öğeleri |
+
+Her şey, derleme zamanında AST analiziyle algılanır — yapılandırma dosyaları yok, kayıt için gereksiz şablon kodu yok. Herhangi bir `.ts` dosyasına `export default defineObject(...)` ekleyin, SDK onu algılar.
+
+## Nasıl çalışırlar
+
+* **Mantıksal işlevler** ana makineden yalıtılmış, izole Node.js süreçlerinde çalışır. Verilere, kapsamı uygulamanın rol izinleriyle sınırlandırılmış tipli bir API istemcisi üzerinden erişirler.
+* **Ön uç bileşenleri**, Remote DOM kullanan Web Worker'larda çalışır — ana sayfadan yalıtılmıştır ancak yerel DOM öğelerini (iframe'ler değil) oluşturur.
+* **İzinler**, API düzeyinde uygulanır. Bir uygulama yalnızca rolünün izin verdiği şeyleri görür.
+
+## Geliştirici deneyimi
+
+Uygulamanızı makinenizde bir TypeScript projesi olarak yazarsınız. CLI, kaynak dosyalarınızı izler ve bunları çalışan bir Twenty sunucusuyla canlı olarak senkronize eder — bir dosyayı düzenleyin, bir saniye içinde arayüzde değişikliği görün. Şema değiştiğinde tipli API istemcisi otomatik olarak yeniden oluşturulur. Hazır olduğunuzda, `yarn twenty app:publish --private` bir üretim sunucusuna gönderir veya `yarn twenty app:publish` uygulamanızı npm'de ve Twenty pazarında listeler.
+
+
+ Üç aşamalı bir adım adım rehber — iskelet oluşturun, yerel bir sunucu çalıştırın, değişikliklerinizi senkronize edin.
+
diff --git a/packages/twenty-docs/l/tr/getting-started/core-concepts/calendar-and-email.mdx b/packages/twenty-docs/l/tr/getting-started/core-concepts/calendar-and-email.mdx
new file mode 100644
index 0000000000..49f3f42140
--- /dev/null
+++ b/packages/twenty-docs/l/tr/getting-started/core-concepts/calendar-and-email.mdx
@@ -0,0 +1,46 @@
+---
+title: Takvim ve E-posta
+description: E-posta ve takviminizi Twenty ile senkronize edin.
+icon: envelope
+---
+
+Twenty, CRM'inizin manuel veri girişi olmadan güncel kalması için mevcut araçlarınıza bağlanır.
+
+## E-posta senkronizasyonu
+
+**Google Workspace** veya **Microsoft 365** posta kutunuzu bağlayın. Bağlandıktan sonra:
+
+* E-postalar, ilgili Şirket ve Kişi kayıtlarıyla otomatik olarak ilişkilendirilir
+* Tam e-posta dizileri her kaydın zaman çizelgesinde görünür
+* E-postaları doğrudan Twenty üzerinden gönderebilirsiniz
+* Kullanıcı başına birden çok posta kutusu desteklenir
+
+İçe aktarılanları siz kontrol edersiniz — ilgisiz e-postaların içe alınmasını önlemek için tarih aralığına veya gönderen kişiye göre filtreleyin.
+
+## Takvim senkronizasyonu
+
+Takvim etkinlikleri, bağlı hesabınızdan otomatik olarak senkronize edilir. Etkinlikler, her bir kişi veya şirketle etkileşimlerinizin eksiksiz bir görünümünü sunarak ilgili CRM kayıtlarında görünür.
+
+## Entegrasyonlar
+
+E-posta ve takvimin ötesinde, Twenty harici araçlara şu yollarla bağlanır:
+
+| Yöntem | Kullanım alanı |
+| ----------------------------- | -------------------------------------------------------------------------- |
+| **API** | GraphQL veya REST API ile özel entegrasyonlar oluşturun |
+| **Webhook'lar** | Kayıtlar değiştiğinde gerçek zamanlı bildirimleri harici sistemlere iletin |
+| **Zapier** | Kod yazmadan 5.000+ uygulamaya bağlanın |
+| **İş Akışı HTTP aksiyonları** | Otomatik bir iş akışının parçası olarak herhangi bir harici API'yi çağırın |
+
+## Özel uygulamalar
+
+Geliştiriciler, Twenty üzerinde özel arayüz, sunucu tarafı mantık ve derin entegrasyonlar ekleyerek tam özellikli uygulamalar oluşturabilir. Uygulamalar topluluk için yayımlanabilir veya gizli tutulabilir.
+
+
+
+ E-posta senkronizasyonunu, takvim senkronizasyonunu kurun ve sorunları giderin.
+
+
+ Twenty API'si ile özel entegrasyonlar oluşturun.
+
+
diff --git a/packages/twenty-docs/l/tr/getting-started/core-concepts/dashboards.mdx b/packages/twenty-docs/l/tr/getting-started/core-concepts/dashboards.mdx
new file mode 100644
index 0000000000..6bb742df7b
--- /dev/null
+++ b/packages/twenty-docs/l/tr/getting-started/core-concepts/dashboards.mdx
@@ -0,0 +1,37 @@
+---
+title: Gösterge Panelleri
+description: Performansı izleyin ve özel panolarla CRM verilerinizi görselleştirin.
+icon: chart-bar
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+Panolar size iş metriklerinize gerçek zamanlı görünürlük sağlar — satış hunisi durumu, ekip performansı, gelir trendleri ve izlemek istediğiniz diğer her şey.
+
+
+
+## Widget'lar
+
+Her pano bileşenlerden (widget) oluşur. Bir bileşen (widget), CRM verilerinize bağlı tek bir grafik veya metriktir. Şunları yapılandırabilirsiniz:
+
+* **Grafik türü** — Çubuk, çizgi, pasta, sayı ve daha fazlası
+* **Veri kaynağı** — Veri modelinizdeki (standart veya özel) herhangi bir nesne
+* **Filtreler** — Belirli kayıtlara, tarih aralıklarına veya segmentlere daraltın
+* **Birleştirme (Aggregation)** — Herhangi bir sayısal alan üzerinde sayma, toplama, ortalama, minimum, maksimum
+* **Gruplama** — Seçili alanlara, tarihlere veya ilişkilere göre bölün
+
+## Neleri izleyebilirsiniz
+
+* Aşamaya göre satış hunisindeki değer
+* Zaman içinde tamamlanan anlaşmalar
+* Kaynağa göre ortalama anlaşma büyüklüğü
+* Görev tamamlama oranları
+* Herhangi bir nesne üzerinde özel metrikler
+
+## Paylaşım
+
+Panolar çalışma alanı düzeyindedir — ekibinizdeki herkes bunları görebilir. Bileşenleri (widget) bir ızgara düzeninde sıralayın ve ekibiniz için işe yarayan görünümü oluşturmak üzere yeniden boyutlandırın.
+
+
+ Panolar oluşturma, bileşenleri (widget) yapılandırma ve grafik ayarları hakkında ayrıntılı başvuru.
+
diff --git a/packages/twenty-docs/l/tr/getting-started/core-concepts/data-model.mdx b/packages/twenty-docs/l/tr/getting-started/core-concepts/data-model.mdx
new file mode 100644
index 0000000000..f27cbd1892
--- /dev/null
+++ b/packages/twenty-docs/l/tr/getting-started/core-concepts/data-model.mdx
@@ -0,0 +1,47 @@
+---
+title: Veri modeli
+description: Twenty, verilerinizi nesneler, alanlar ve ilişkilerle nasıl yapılandırdığını anlayın.
+icon: database
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+Twenty içindeki her şey, veri modelinizin yapı taşları olan **nesneler** ve **alanlar** etrafında oluşturulmuştur.
+
+## Nesneler
+
+Nesneler, verilerinizi tutan tablolardır. Twenty, kutudan çıktığı haliyle standart nesnelerle birlikte gelir:
+
+* **Companies** — İş yaptığınız organizasyonlar
+* **People** — Bireysel kişiler
+* **Opportunities** — Boru hattınızdaki anlaşmalar
+* **Tasks** — Ekibiniz için eylem öğeleri
+* **Notes** — Kaydetlerle ilişkilendirilmiş serbest biçimli metin
+
+Ayrıca işletmenizin ihtiyaç duyduğu her şey için **özel nesneler** oluşturabilirsiniz — projeler, destek talepleri, ürünler, sözleşmeler veya başka herhangi bir şey.
+
+## Alanlar
+
+Alanlar, her nesnenin üzerindeki özelliklerdir. Twenty, çok çeşitli alan türlerini destekler:
+
+| Kategori | Türler |
+| ----------- | -------------------------------------------------------------------- |
+| **Temel** | Text, Number, Boolean, Date, Currency, Rating, Select |
+| **Bileşik** | Address (street, city, state, zip), Full Name, Links, Phones, Emails |
+| **Özel** | Relation, File Attachment, JSON, Actor (who created/modified) |
+
+Her nesne ayrıca otomatik sistem alanları da alır: `id`, `createdAt`, `updatedAt`, `createdBy` ve `position`.
+
+## İlişkiler
+
+Nesneler, ilişkiler aracılığıyla birbirine bağlanır. Bir Company'nin birçok People'ı vardır, bir Opportunity bir Company'ye aittir, vb. Herhangi nesneler arasında, çoktan çoğa ilişkiler de dahil olmak üzere, özel ilişkiler oluşturabilirsiniz.
+
+## Bunu güçlü kılan nedir
+
+Önceden tanımlanmış nesneler üzerindeki önceden tanımlanmış alanlarla sınırlı olduğunuz geleneksel CRM'lerin aksine, Twenty verilerinizi işletmenizin çalışma şekline tam olarak uygun biçimde modellemenizi sağlar. Özel nesneler, API uç noktaları, görünümler, izinler ve iş akışı tetikleyicileri dahil olmak üzere, yerleşik olanlarla aynı birinci sınıf muameleyi görür.
+
+
+ Nesneler, alanlar, ilişkiler ve bunların nasıl yapılandırılacağına ilişkin tam başvuru.
+
+
+
diff --git a/packages/twenty-docs/l/tr/getting-started/core-concepts/glossary.mdx b/packages/twenty-docs/l/tr/getting-started/core-concepts/glossary.mdx
new file mode 100644
index 0000000000..bddf0d57d3
--- /dev/null
+++ b/packages/twenty-docs/l/tr/getting-started/core-concepts/glossary.mdx
@@ -0,0 +1,105 @@
+---
+title: Sözlük
+icon: kitap
+description: Twenty boyunca kullanılan anahtar terimler.
+---
+
+## API
+
+API (Uygulama Programlama Arayüzü), Twenty'yi diğer yazılım sistemleriyle bağlamanızı ve özel entegrasyonlar oluşturmanızı sağlar.
+
+## Uygulamalar
+
+Uygulamalar, veri modellerini ve mantık işlevlerini tanımlayabilen, kod olarak oluşturulmuş özel uzantılardır. Geliştiricilerin birden çok çalışma alanına dağıtılabilen, yeniden kullanılabilir özelleştirmeler oluşturmasına olanak tanır.
+
+## Kod Eylemleri
+
+Kod Eylemleri, verileri dönüştürmek, hesaplamalar yapmak veya yerleşik eylemlerle mümkün olmayan karmaşık mantığı gerçekleştirmek için özel JavaScript yazmanıza olanak tanıyan iş akışı adımlarıdır.
+
+## Komut Menüsü
+
+Komut Menüsü, işlemleri gerçekleştirmenize, kayıtlar oluşturmanıza ve çalışma alanınızda verimli bir şekilde gezinmenize olanak tanıyan hızlı erişim arayüzüdür (`Mac`'te `Cmd + K`, `Windows`'ta `Ctrl + K` ile açılır).
+
+## Şirket & Kişiler
+
+CRM'de iki temel kayıt türü vardır:
+
+* Bir `Şirket`, bir iş veya organizasyonu temsil eder.
+* `People`, şirketinizin mevcut ve potansiyel müşterilerini temsil eder.
+
+## Özel Alanlar
+
+Özel Alanlar, iş ihtiyaçlarınıza ve süreçlerinize özgü bilgileri yakalamak için oluşturduğunuz veri alanlarıdır.
+
+## Veri modeli
+
+Bir Veri Modeli, CRM'nizde bilgilerin nasıl düzenlendiğini tanımlayan yapıdır, hangi nesnelerin var oldukları, özellikleri (alanlar) ve birbirleriyle nasıl ilişkili oldukları gibi.
+
+## Favoriler
+
+Favoriler, hızlı erişim için işaretlediğiniz kayıtlar olup, önemli verilere anında erişim için yan panelinizde görünürler.
+
+## Alan
+
+Bir alan, bir varlığa ait belirli verilerin depolandığı alandır.
+
+## Yineleyici
+
+Yineleyici (Iterator), bir iş akışı eylemidir; bir öğe dizisi üzerinde döngü kurar ve listedeki her öğe için sonraki eylemleri yürütür.
+
+## Kanban
+
+`Kanban`, kartlar ve sütunlar kullanarak iş süreçlerinizi takip etmenin görsel bir yoludur. Her sütun, sürecinizdeki bir aşamayı temsil eder (örneğin: yeni, devam eden, kazanılan, kaybedilen) ve kayıtları bu aşamalarda ilerledikçe taşırsınız.
+
+## Nesne
+
+Nesne, CRM'inizde belirli bir varlık türünü temsil eden bir veri yapısıdır (People, Companies veya Opportunities gibi). Nesneler standart (yerleşik) veya özelleştirilmiş (tarafınızdan oluşturulmuş) olabilir.
+
+## Fırsatlar
+
+Twenty CRM'deki Fırsatlar, hesaplar veya kişilerle potansiyel anlaşmalar veya satışlardır.
+
+## Kayıt
+
+Bir Kayıt, bir nesnenin örneğini belirtir, örneğin belirli bir hesap veya kişi.
+
+## İlişki Alanları
+
+İlişki Alanları, farklı nesneler arasında bağlantılar oluşturur; kayıtları birbirine bağlamanızı sağlar (örneğin bir Kişiyi bir Şirkete bağlamak gibi).
+
+## Standart Alanlar
+
+Standart Alanlar, varsayılan olarak nesnelerle birlikte gelen ve tüm çalışma alanlarında ortak işlevsellik sağlayan önceden yapılandırılmış veri alanlarıdır.
+
+## Görevler
+
+Twenty CRM'deki Görevler, kişilere, hesaplara veya fırsatlara ilişkin atanmış aktiviteleridir.
+
+## Tetikleyiciler
+
+Tetikleyiciler, bir iş akışının başlangıç noktasıdır — otomasyonu başlatan olay veya koşuldur. Örnekler arasında kayıt oluşturma, kayıt güncellemeleri, webhook'lar veya zamanlanmış saatler bulunur.
+
+## Görünümler
+
+Görünümleri kullanarak kayıtlarınızın görünümünü özelleştirebilir; her görünüm için farklı filtreler, düzenler ve sıralama seçenekleri ayarlayabilirsiniz.
+
+## Upsert
+
+Upsert, "update" ve "insert" işlemlerini birleştiren bir işlemdir — eşleşme bulunursa var olan bir kaydı günceller, eşleşme yoksa yeni bir kayıt oluşturur.
+
+## Webhooklar
+
+Webhook'lar, belirli olaylar gerçekleştiğinde Twenty'den diğer uygulamalara gönderilen otomatik mesajlardır ve gerçek zamanlı veri senkronizasyonu sağlar.
+
+## İş Akışları
+
+İş akışları, belirli koşullara göre tetiklenen otomatik süreçlerdir. Bu süreçler, tekrarlayan görevlerin ve iş süreçlerinin otomasyonuna yardımcı olur.
+
+## İş Alanı
+
+Bir `İş Alanı` genellikle Twenty'yi kullanan bir şirketi temsil eder. Siz ve ekip üyelerinizin Twenty'ye eklediği tüm kayıtları ve verileri barındırır.
+Tek bir alan adını barındırır, bu genellikle çalışan e-posta adresleri için şirketinizin kullandığı alan adıdır.
+
+## İş Alanı Üyeleri
+
+İş Alanı Üyeleri, ekibinizdeki Twenty kullanıcılarıdır ve iş alanınıza erişebilirler. Kayıtlar için sahip veya atanan olarak görevlendirilebilirler.
diff --git a/packages/twenty-docs/l/tr/getting-started/core-concepts/layout.mdx b/packages/twenty-docs/l/tr/getting-started/core-concepts/layout.mdx
new file mode 100644
index 0000000000..5502fbe314
--- /dev/null
+++ b/packages/twenty-docs/l/tr/getting-started/core-concepts/layout.mdx
@@ -0,0 +1,74 @@
+---
+title: Düzen
+description: Twenty'de nasıl gezinileceği, göz atılacağı ve kayıtların görüntüleneceği.
+icon: table-columns
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+## Ana düzen
+
+Ekranın ortası, kayıtlarınızın bulunduğu yerdir — kişiler, şirketler, fırsatlar, görevler, notlar, panolar, iş akışları ve tüm özel nesneler. Kayıtları burada görüntüler, düzenler ve siler, yeni görünümler oluşturursunuz.
+
+
+
+## Gezinti çubuğu
+
+Sol kenar çubuğu size şunları sağlar:
+
+* **Çalışma alanı değiştirici** — çalışma alanları arasında geçiş yapın veya yeni bir tane oluşturun (üst açılır menü)
+* **Arama** — anında odaklamak için `/` tuşuna basın, tüm nesnelerde arama yapar
+* **Ayarlar** — sol üstten erişin
+* **Sık kullanılanlar** — her kullanıcıya özgü sabitlenmiş görünümler
+* **Nesne kısayolları** — People, Companies, Opportunities vb. nesnelere hızlı erişim
+* **İş akışları** — otomasyonlar oluşturun
+
+Öğeleri yeniden sıralamak için sürükleyin, ilgili nesneleri gruplamak için klasörler oluşturun, kullanmadıklarınızı gizleyin.
+
+
+
+## Komut Menüsü
+
+`Cmd+K` (Mac) veya `Ctrl+K` (Windows) tuşlarına basın — ya da sağ üstteki üç noktaya tıklayın. Buradan şunları yapabilirsiniz:
+
+* Yeni kayıtlar oluşturun
+* CSV ile veri içe ve dışa aktarın
+* Yeni görünümler oluşturun
+* Silinen kayıtlara erişin (Twenty yumuşak ve kalıcı silmeleri destekler)
+* Çalışma alanınızda gezinmek için klavye kısayollarını görün
+
+
+
+## Ara
+
+Komut Menüsü, gezinme çubuğunun üst kısmı veya `/` tuşuna basarak erişilebilir. Arama tüm nesnelerde çalışır.
+
+
+
+## Yan panel
+
+Bir kayda tıklayarak sağdaki yan paneli açın — mevcut sayfadan ayrılmadan kaydın temel bilgilerinin hızlı bir özetini görürsünüz. Tam kayıt sayfasına gitmek için **Aç**'a tıklayın.
+
+
+
+## Görünümler
+
+Her nesne, nesne başına sınırsız olmak üzere birden çok görünümü destekler. Aralarına geçiş yapmak için sol üstteki açılır menüyü kullanın.
+
+* **Tablo** — gruplama, satır içi düzenleme ve sütun özelleştirme ile hesap tablosu tarzı satırlar ve sütunlar
+* **Kanban** — bir seçim alanına göre düzenlenmiş sürükle-bırak kartları, boru hatları için idealdir
+* **Takvim** — zamana dayalı planlama için bir tarih alanına göre yerleştirilmiş kayıtlar
+
+Her görünüm kendi filtrelerini, sıralamasını ve alan görünürlüğünü kaydeder. Görünümleri çalışma alanınızla paylaşın veya özel tutun. Kenar çubuğundan hızlı erişim için görünümleri sık kullanılanlara ekleyin.
+
+
+
+## Kayıt Sayfaları
+
+Bir kaydı açtığınızda, ayrıntı sayfası yapılandırılabilir **sekme** ve **widget**'lardan oluşturulur. Izgara üzerinde widget'ları ekleyin, kaldırın, yeniden sıralayın ve yeniden boyutlandırın — alanlar, ilişkili kayıtlar, e-postalar, zaman çizelgesi, görevler, notlar, dosyalar, grafikler, iframe'ler ve daha fazlası. Her nesne türünün kendi düzeni vardır.
+
+
+ Gezinme, görünümler, kayıt sayfaları — ayrıntılı başvuru ve nasıl yapılır kılavuzları.
+
+
+
diff --git a/packages/twenty-docs/l/tr/getting-started/core-concepts/workflows.mdx b/packages/twenty-docs/l/tr/getting-started/core-concepts/workflows.mdx
new file mode 100644
index 0000000000..89ef89fcd0
--- /dev/null
+++ b/packages/twenty-docs/l/tr/getting-started/core-concepts/workflows.mdx
@@ -0,0 +1,55 @@
+---
+title: İş Akışları
+description: Twenty'nin görsel iş akışı oluşturucusuyla iş süreçlerinizi otomatikleştirin.
+icon: bolt
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+İş akışları, tekrarlayan görevleri otomatikleştirmenize ve Twenty'yi harici araçlara kod yazmadan (isterseniz yazabilirsiniz) bağlamanıza olanak tanır.
+
+
+
+## İş akışları nasıl çalışır
+
+Her iş akışının üç bölümü vardır:
+
+1. **Tetikleyici** — İş akışını başlatan şey
+2. **Adımlar** — Sonrasında ne olur (ardışık bir veya daha fazla eylem)
+3. **Değişkenler** — Adımlar arasında akan veriler
+
+## Tetikleyiciler
+
+| Tetikleyici | Ne zaman tetiklenir |
+| --------------- | ---------------------------------------------------------------------------------------- |
+| **Kayıt olayı** | Bir kayıt oluşturulur, güncellenir, silinir veya upsert edilir |
+| **Manuel** | Bir kullanıcı bir düğmeye tıklar (tek bir kayıtta, birden çok kayıtta veya genel olarak) |
+| **Zamanlama** | Yinelenen bir aralıkta (cron söz dizimiyle) |
+| **Webhook** | Harici bir sistem bir HTTP POST gönderir |
+
+## Eylemler
+
+İş akışları, aşağıdakilerin herhangi bir kombinasyonunu zincirleyebilir:
+
+* **Kayıt işlemleri** — Kayıtları oluşturma, güncelleme, bulma, silme veya upsert etme
+* **E-posta gönder** — Bağlı hesaplardan e-posta gönderin veya taslak oluşturun
+* **HTTP isteği** — Herhangi bir harici API'yi çağırın
+* **Kod** — Karmaşık mantık için özel JavaScript çalıştırın
+* **Dallar** — İş akışı yolunu bölmek için if/else koşulları
+* **Yineleyici** — Veri dizileri üzerinde döngü kurun
+* **Yapay Zekâ Aracısı** — Bir yapay zekâ aracısının verileri otonom şekilde işlemesine izin verin
+* **Gecikme** — Devam etmeden önce bekleyin
+* **Form** — İş akışının ortasında kullanıcı girdisi toplayın
+
+## Oluşturabilecekleriniz
+
+* Bir anlaşma belirli bir aşamaya ulaştığında Slack uyarıları gönderin
+* Yeni kişileri harici API'lerden gelen verilerle otomatik olarak zenginleştirin
+* Eski fırsatları tespit edin ve sahibini bilgilendirin
+* Twenty ile faturalandırma sisteminiz arasında verileri senkronize edin
+* Kayıt verilerinden PDF'ler veya faturalar oluşturun
+* Belirli kriterlerle eşleşen gelen e-postalara otomatik yanıt verin
+
+
+ Tetikleyiciler, eylemler, değişkenler ve gerçek dünyadan otomasyon örnekleri hakkında ayrıntılı başvuru.
+
diff --git a/packages/twenty-docs/l/tr/getting-started/introduction.mdx b/packages/twenty-docs/l/tr/getting-started/introduction.mdx
new file mode 100644
index 0000000000..c7ec2e10a9
--- /dev/null
+++ b/packages/twenty-docs/l/tr/getting-started/introduction.mdx
@@ -0,0 +1,62 @@
+---
+title: Neden Twenty
+icon: heart
+---
+
+import { CardTitle } from "/snippets/card-title.mdx"
+
+Başlaması kolay ama değiştirmesi imkansız yazılımlarla, esnek ama kurulumu aylar süren yazılımlar arasında seçim yapıyordunuz. Twenty üçüncü seçenek: **gidişata göre yeniden şekillendirebileceğiniz, üretime hazır bir CRM.**
+
+## Twenty’yi farklı kılan nedir
+
+Twenty, yapılandırdığınız bir ürün değil, üzerine inşa edebileceğiniz bir platformdur.
+
+
+
+ Temsilciler için tasarlandı
+ Temsilciler, gerçek yetkilendirmelerle veri modelinizin içinde çalışırlar. Yetenekler, Araçlar, MCP.
+
+
+ Güvenli Genişletilebilirlik
+ Güvenli temeller üzerindeki vibe-coded araçların esnekliği.
+
+
+ Modern Yığın
+ React, TypeScript. Ekibiniz Twenty’yi nasıl genişleteceğini zaten biliyor. Tescilli diller yok, tekelcilik yok.
+
+
+ Bağımlılık Yok
+ Açık kaynak çekirdek, kendi kendinize barındırılabilir, verilerinizi istediğiniz zaman dışa aktarın.
+
+
+
+## Twenty kimin için
+
+* **Salesforce’u değiştiren büyük işletmeler** — ekibiniz
+ aracı kullanmaktan çok, onunla savaşmaya zaman harcıyor.
+ Kendinizi kilitlenmiş hissediyorsunuz ve maliyetler sürekli artıyor.
+* **Teknik kuruculara sahip girişimler** —
+ e-tabloları ve Notion’ı aştınız. Büyük hedefleriniz var ve sizinle birlikte ölçeklenecek bir CRM istiyorsunuz.
+* **Avantaj arayan GTM ekipleri** — kendi lead puanlamanızı, kendi zenginleştirmelerinizi, kendi
+ outbound iş akışlarınızı oluşturmak istiyorsunuz.
+* **Gizliliğe önem veren kuruluşlar** — verilerinizi uçtan uca
+ kendiniz barındırmanız ve sahiplenmeniz gerekiyor. Düzenleyici,
+ sözleşmeye dayalı ya da sadece prensip gereği.
+* **Salesforce iş ortakları** —
+ geliştiricileriniz, müşterilerinize lisans maliyeti artışlarını sunmaktan bıkmış durumda.
+ Daha iyi bir DX istiyorsunuz ve müşterileriniz için daha düşük lisans maliyetiyle projeleri daha hızlı teslim etmek istiyorsunuz.
+* **Web geliştirme ajansları** — ekibiniz TypeScript, React
+ ve PostgreSQL biliyor. Twenty, APEX öğrenmeden veya tescilli sertifikalar almadan CRM pazarını size açar.
+
+## Twenty kimin için değil
+
+* **Üzerine hiç düşünmek zorunda kalmayacakları bir CRM isteyen ekipler.** Twenty, araçlarına yakın durmak ve onları zamanla şekillendirmek isteyen ekipleri ödüllendirir. Tamamen yönetilen bir şey istiyorsanız,
+ Pipedrive veya
+ HubSpot işinizi görecektir.
+* **Bugün yüzlerce hazır entegrasyona ihtiyaç duyan şirketler.** Ekosistemimiz hızla büyüyor ama henüz Salesforce veya HubSpot kadar geniş değil. Eksik olanı inşa etmeyi sorun etmiyorsanız, bayılacaksınız. Değilse, bize bir yıl daha verin.
+* **Araçların, onları kullanan insanlar tarafından değil, yönetim kurulu odalarında seçildiği kurumlar.** Biftekli akşam yemekleri
+ ve yönetici brifingleri yapmıyoruz. Kendi araçlarını seçme yetkisine sahip ekiplerle kazanıyoruz.
+
+
+ Twenty’yi bulutta veya kendi sunucunuzda 5 dakikadan kısa sürede kurun.
+
diff --git a/packages/twenty-docs/l/tr/getting-started/key-features.mdx b/packages/twenty-docs/l/tr/getting-started/key-features.mdx
new file mode 100644
index 0000000000..f43781a913
--- /dev/null
+++ b/packages/twenty-docs/l/tr/getting-started/key-features.mdx
@@ -0,0 +1,70 @@
+---
+title: Temel Özellikler
+description: Özel veri modellerinden yapay zeka destekli otomasyona kadar Twenty’nin yapabildiği her şeyin bir turu.
+icon: star
+---
+
+import { CardTitle } from "/snippets/card-title.mdx"
+
+Twenty, tam özellikli bir CRM platformudur. Bununla neler oluşturabileceğinizi burada bulabilirsiniz.
+
+
+
+ Özel Veri Modeli
+ İşletmenizin ihtiyaç duyduğu tam veri yapısını tanımlayın.
+ Özel nesneler oluşturun, 20+ alan türüyle özel alanlar ekleyin ve herhangi nesneler arasında ilişkiler kurun.
+
+
+
+ Görünümler ve Boru Hatları
+ Tablo görünümleri, kanban panoları ve takvim görünümleri arasında geçiş yapın.
+ AND/OR mantığıyla filtreleyin, birden fazla alana göre sıralayın, kayıtları gruplayın ve özel görünümler kaydedin.
+
+
+
+ İş Akışları ve Otomasyon
+ Kod yazmadan herhangi bir iş sürecini otomatikleştirin.
+ İş akışlarını kayıt değişikliklerinde, zamanlamalarla, manuel işlemlerle veya gelen webhook’larla tetikleyin.
+
+
+
+ Takvim ve E-posta Eşitleme
+ Google Workspace veya Microsoft 365 hesabınızı bağlayın.
+ E-postalar ve takvim etkinlikleri ilgili CRM kayıtlarında otomatik olarak görünür.
+
+
+
+ Yapay Zeka
+ Soruları yanıtlayan, kayıtları zenginleştiren ve izin modeliniz dahilinde çok adımlı görevleri yürüten, CRM’iniz içinde özerk şekilde çalışan yapay zeka ajanları.
+
+
+
+ Panolar ve Raporlama
+ Gerçek zamanlı bileşenlerle özel panolar oluşturun.
+ Yapılandırılabilir grafikler ve filtrelerle boru hattı metriklerini, ekip performansını ve iş KPI’larını takip edin.
+
+
+
+ İzinler ve Erişim Kontrolü
+ Nesneler, alanlar ve tekil kayıtlar dahil her düzeyde role dayalı erişim kontrolü.
+ SAML veya OIDC ile SSO yapılandırın. Denetim günlükleri kimin ne yaptığını takip eder.
+
+
+
+ API ve Genişletilebilirlik
+ Özel veri modelinize uyum sağlayan, geliştirici öncelikli bir API.
+ Her çalışma alanı için otomatik oluşturulan dokümantasyonla birlikte hem GraphQL hem de REST uç noktaları.
+
+
+
+ Veri İçe/Dışa Aktarma
+ Verileri CSV dosyalarından veya API aracılığıyla içe aktarın.
+ Yerleşik alan eşleme, çoğalt tespiti ve hata yönetimi. Verilerinizi dilediğiniz zaman dışa aktarın — kilitlenme yok.
+
+
+
+ Kendi Kendine Barındırma
+ Twenty’yi kendi altyapınızda tek bir Docker Compose komutuyla çalıştırın.
+ Verileriniz üzerinde tam denetim, kendi takviminize göre güncellemeler.
+
+
diff --git a/packages/twenty-docs/l/tr/getting-started/quickstart.mdx b/packages/twenty-docs/l/tr/getting-started/quickstart.mdx
new file mode 100644
index 0000000000..d724f2d2c6
--- /dev/null
+++ b/packages/twenty-docs/l/tr/getting-started/quickstart.mdx
@@ -0,0 +1,73 @@
+---
+title: Hızlı Başlangıç
+description: Twenty’yi bulutta veya kendi sunucunuzda 5 dakikadan kısa sürede çalışır hâle getirin.
+icon: play
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+## Kaydol
+
+
+
+ [app.twenty.com](https://app.twenty.com) adresine gidin ve Google, Microsoft veya e-posta ile kayıt olun.
+
+
+ **30 gün** (kartla) veya **7 gün** (kartsız) seçin. Her ikisi de tam erişim içerir — sınırsız kişi, e-posta entegrasyonu, özel nesneler, API. Planı veya fatura aralığını istediğiniz zaman değiştirebilirsiniz.
+
+
+ Stripe üzerinden ödeme onayından sonra, çalışma alanı adınızı ve kullanıcı profilinizi ayarlayacaksınız. İstediğiniz zaman iptal edebilirsiniz.
+
+
+
+
+
+## Çalışma alanınızı yapılandırın
+
+İçeri girdikten sonra, Twenty'yi size özel kılmak için üç adım:
+
+### 1. Posta kutunuzu bağlayın
+
+**Ayarlar → Hesaplar**'a gidin ve Google veya Microsoft hesabınızı bağlayın. Twenty, e-postalarınızı ve takvim etkinliklerinizi içe aktaracak ve etkileşimlerden otomatik olarak kişiler oluşturacaktır. Başka bir sağlayıcı mı kullanıyorsunuz? Aynı sayfadan SMTP üzerinden posta kutuları veya CalDAV üzerinden takvimler ekleyebilirsiniz.
+
+Buradan başlayın — bir posta kutusunu bağlamak, başka herhangi bir özelleştirme yapmadan önce ekibinize gerçek verilerle anında değer sağlar.
+
+
+
+### 2. Veri modelinizi şekillendirin
+
+Özel nesneler ve alanlar oluşturmak için **Ayarlar → Veri Modeli**'ne gidin. Bilmeniz gereken birkaç nokta:
+
+* Özel nesneler ve alanlar **tüm planlarda sınırsızdır** — ek satış yoktur.
+* **Kişiler, Şirketler ve Fırsatlar**, senkronize edilmiş e-postaları ve toplantıları gösteren nesnelerdir. Bunları temeliniz olarak kullanın ve e-posta geçmişi olmayacak ayrı nesneler oluşturmak yerine kategorize etmek için alanlar ekleyin (örneğin, bir `Person Type` alanı).
+* İki Kişi aynı e-postayı paylaşamaz. İki Şirket aynı alan adını paylaşamaz.
+* İhtiyacınız olmayan standart alanları/nesneleri devre dışı bırakabilir ve alanları silmeden görünümlerden gizleyebilirsiniz.
+
+[Veri Modeli referansı →](/l/tr/user-guide/data-model/overview)
+
+
+
+### 3. Verilerinizi içe aktarın
+
+Komut Menüsünü (`Cmd+K` / `Ctrl+K`) kullanarak Kişileri, Şirketleri, Fırsatları veya herhangi bir özel nesneyi CSV ile içe aktarın. Beklenen formatı görmek için önce örnek dosyayı indirin. Dosyaları 10 bin kayda sınırlayın ve içe aktarmadan önce e-postaları/alan adlarını yinelenenlerden arındırın.
+
+[Veri Taşıma rehberi →](/l/tr/user-guide/data-migration/overview)
+
+
+
+## Sonraki adımlar
+
+
+
+ Gezinme, görünümler, komut menüsü, yan panel.
+
+
+ İş süreçlerinizi otomatikleştirin.
+
+
+ Tablo, kanban, takvim — verilerinizi filtreleyin ve sıralayın.
+
+
+ Kiracı başına şema — REST ve GraphQL.
+
+
diff --git a/packages/twenty-docs/l/zh/getting-started/core-concepts/ai.mdx b/packages/twenty-docs/l/zh/getting-started/core-concepts/ai.mdx
new file mode 100644
index 0000000000..b56f549cce
--- /dev/null
+++ b/packages/twenty-docs/l/zh/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 记录、总结信息,并在无需构建复杂筛选条件的情况下帮助你找到所需内容。
+
+
+
+## AI 代理
+
+AI 智能体不仅限于聊天——它们还能自主执行多步骤任务:
+
+* 使用来自外部来源的数据丰富记录
+* 撰写并发送跟进电子邮件
+* 分析销售管道健康状况并标记存在风险的交易
+* 处理传入数据并将其路由到合适的团队
+
+智能体在你现有的工作流中运行,因此你可以将 AI 与人工审批、条件逻辑以及外部 API 调用相结合。
+
+## 权限与安全
+
+Twenty 中的 AI 遵循你的权限模型。 智能体只能访问用户(或角色)有权查看的对象和字段。 即使在涉及 AI 时,敏感数据也始终受到保护。
+
+
+ 关于聊天机器人、智能体和权限控制的详细参考。
+
diff --git a/packages/twenty-docs/l/zh/getting-started/core-concepts/apps.mdx b/packages/twenty-docs/l/zh/getting-started/core-concepts/apps.mdx
new file mode 100644
index 0000000000..04e5db7cc3
--- /dev/null
+++ b/packages/twenty-docs/l/zh/getting-started/core-concepts/apps.mdx
@@ -0,0 +1,41 @@
+---
+title: 应用
+icon: cube
+description: 通过代码扩展 Twenty——将自定义对象、服务器端逻辑、UI 组件和 AI 代理全部构建为 TypeScript 软件包。
+---
+
+大多数 CRM 只给你一个配置面板。 Twenty 给你的是一个平台。 App 是开发者将 Twenty 扩展到超出 UI 所提供能力的方式——将数据模型、服务器端逻辑、UI 组件和 AI 能力定义为代码,然后将它们部署到一个或多个工作区。
+
+## App 存在的原因
+
+Workflows 覆盖了无代码自动化。 但有些事情需要代码:自定义定价引擎、专有的富化管道、在每次记录更新时运行的合规检查、从内部工具中提取数据的自定义 UI 面板。
+
+App 让你将这些构建为一等扩展——不是从外部与 API 通信的脆弱脚本,而是在平台上运行、完全访问类型系统、权限模型和 UI 的代码。
+
+## 一个 App 可以定义什么
+
+一个 App 是使用 `twenty-sdk` 声明 **实体(entities)** 的 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 服务器——编辑文件后,你可以在一秒内在 UI 中看到变更。 当模式发生变化时,会自动重新生成类型化的 API 客户端。 准备就绪后,使用 `yarn twenty app:publish --private` 推送到生产服务器,或者使用 `yarn twenty app:publish` 将你的应用发布到 npm 和 Twenty 应用市场。
+
+
+ 三阶段引导——脚手架搭建、本地服务器运行、同步你的更改。
+
diff --git a/packages/twenty-docs/l/zh/getting-started/core-concepts/calendar-and-email.mdx b/packages/twenty-docs/l/zh/getting-started/core-concepts/calendar-and-email.mdx
new file mode 100644
index 0000000000..27055e77fc
--- /dev/null
+++ b/packages/twenty-docs/l/zh/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 构建自定义集成 |
+| **Webhooks** | 当记录发生变更时,将实时通知推送到外部系统 |
+| **Zapier** | 无需编码即可连接 5,000+ 应用 |
+| **工作流 HTTP 操作** | 在自动化工作流中调用任意外部 API |
+
+## 自定义应用
+
+开发者可以在 Twenty 之上构建功能完整的应用,添加自定义 UI、服务端逻辑以及深度集成。 应用可以发布给社区,也可以保持私有。
+
+
+
+ 设置电子邮件同步、日历同步,并排查相关问题。
+
+
+ 使用 Twenty API 构建自定义集成。
+
+
diff --git a/packages/twenty-docs/l/zh/getting-started/core-concepts/dashboards.mdx b/packages/twenty-docs/l/zh/getting-started/core-concepts/dashboards.mdx
new file mode 100644
index 0000000000..eb2f9f68b4
--- /dev/null
+++ b/packages/twenty-docs/l/zh/getting-started/core-concepts/dashboards.mdx
@@ -0,0 +1,37 @@
+---
+title: 仪表板
+description: 通过自定义仪表板跟踪绩效并可视化您的 CRM 数据。
+icon: chart-bar
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+仪表板为您的业务指标提供实时可见性——销售管道健康状况、团队绩效、收入趋势,以及您希望跟踪的任何其他内容。
+
+
+
+## 小部件
+
+每个仪表板都由小部件组成。 小部件是与您的 CRM 数据关联的单个图表或指标。 您可以配置:
+
+* **图表类型** — 条形图、折线图、饼图、数字等
+* **数据源** — 数据模型中的任何对象(标准或自定义)
+* **筛选器** — 细化到特定记录、日期范围或细分
+* **聚合** — 对任何数值字段进行计数、求和、平均值、最小值、最大值
+* **分组** — 按选定字段、日期或关系进行细分
+
+## 可跟踪的内容
+
+* 按阶段划分的销售管道金额
+* 一段时间内成交的交易数量
+* 按来源划分的平均交易金额
+* 任务完成率
+* 任意对象上的自定义指标
+
+## 共享
+
+仪表板位于工作区级别——您团队中的每个人都可以看到它们。 以网格布局排列小部件并调整其大小,以构建适合您团队的视图。
+
+
+ 关于创建仪表板、配置小部件和图表设置的详细参考。
+
diff --git a/packages/twenty-docs/l/zh/getting-started/core-concepts/data-model.mdx b/packages/twenty-docs/l/zh/getting-started/core-concepts/data-model.mdx
new file mode 100644
index 0000000000..90c739efba
--- /dev/null
+++ b/packages/twenty-docs/l/zh/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 支持广泛的字段类型:
+
+| 类别 | 类型 |
+| ------ | ------------------------------ |
+| **基础** | 文本、数字、布尔值、日期、货币、评分、选择 |
+| **复合** | 地址(街道、城市、州/省、邮编)、全名、链接、电话、电子邮件 |
+| **特殊** | 关系、文件附件、JSON、操作者(创建/修改的人) |
+
+每个对象还会自动获得系统字段:`id`、`createdAt`、`updatedAt`、`createdBy` 和 `position`。
+
+## 关系
+
+对象通过关系相互连接。 一个公司拥有多个联系人,一个商机从属于一个公司,依此类推。 你可以在任意对象之间创建自定义关系,包括多对多关系。
+
+## 强大之处
+
+与传统 CRM 中受限于预定义对象和预定义字段不同,Twenty 允许你按照业务的实际运行方式来建模你的数据。 自定义对象与内置对象享有同等的一流待遇——包括 API 端点、视图、权限和工作流触发器。
+
+
+ 关于对象、字段、关系以及如何配置它们的完整参考。
+
+
+
diff --git a/packages/twenty-docs/l/zh/getting-started/core-concepts/glossary.mdx b/packages/twenty-docs/l/zh/getting-started/core-concepts/glossary.mdx
new file mode 100644
index 0000000000..326bde5f2f
--- /dev/null
+++ b/packages/twenty-docs/l/zh/getting-started/core-concepts/glossary.mdx
@@ -0,0 +1,105 @@
+---
+title: 术语表
+icon: 书
+description: 在 Twenty 中使用的关键术语。
+---
+
+## 接口
+
+API(应用程序接口)允许您将 Twenty 与其他软件系统连接并构建自定义集成。
+
+## 应用
+
+应用是以代码构建的自定义扩展,可定义数据模型和逻辑函数。 它使开发者能够创建可复用的自定义内容,并可部署到多个工作区。
+
+## 代码操作
+
+代码操作是工作流步骤,允许你编写自定义 JavaScript 来转换数据、进行计算,或执行内置操作无法实现的复杂逻辑。
+
+## 命令菜单
+
+命令菜单是一个快速访问界面(在 Mac 上用 `Cmd + K` 打开,Windows 上用 `Ctrl + K` 打开),可以让您执行操作、创建记录并高效地导航您的工作区。
+
+## 公司与人员
+
+CRM 有两种基本类型的记录:
+
+* `公司` 表示一个企业或组织。
+* `人员` 代表您的公司当前和潜在的客户。
+
+## 自定义字段
+
+自定义字段是您创建的数据字段,用于捕获特定于您的业务需求和流程的信息。
+
+## 数据模型
+
+数据模型是定义信息在您的 CRM 中如何组织的结构,包括哪些对象存在、它们的属性(字段)以及它们如何相互关联。
+
+## 收藏夹
+
+收藏是你标记用于快速访问的记录,会显示在侧边栏,便于即时导航到重要数据。
+
+## 字段
+
+字段是指为某个实体存储特定数据的特定区域。
+
+## 迭代器
+
+迭代器是一种工作流操作,用于遍历项目数组,并为列表中的每个项目执行后续操作。
+
+## 看板
+
+`看板` 是一种使用卡片和列来跟踪业务流程的可视化方法。 每一列代表您的流程中的一个阶段(例如:新建、进行中、赢得、失去),您可以随着进度将记录在这些阶段中移动。
+
+## 对象
+
+对象是一种数据结构,表示 CRM 中的特定类型的实体(如人员、公司或机会)。 对象可以是标准的(内置)或自定义的(由您创建)。
+
+## 机会
+
+在 Twenty CRM 中,机会是与帐户或联系人潜在的交易或销售。
+
+## 记录
+
+记录表示一个对象的实例,比如特定的帐户或联系人。
+
+## 关系字段
+
+关系字段在不同对象之间创建连接,允许您将记录链接在一起(例如连接一个人到一个公司)。
+
+## 标准字段
+
+标准字段是默认附带对象的预构建数据字段,并在所有工作空间中提供常见功能。
+
+## 任务
+
+在 Twenty CRM 中,任务是与联系人、帐户或机会相关的分配活动。
+
+## 触发器
+
+触发器是工作流的起点——用于启动自动化的事件或条件。 示例包括记录创建、记录更新、Webhook 或预定时间。
+
+## 视图
+
+您可以使用视图自定义记录的显示,为每个视图设置不同的过滤器、布局和排序选项。
+
+## 更新或插入
+
+更新或插入是一种将“更新”和“插入”合并的操作——如果找到匹配项,则更新现有记录;如果没有匹配,则创建新记录。
+
+## Webhooks
+
+Webhook 是在特定事件发生时从 Twenty 发送到其他应用的自动消息,实现实时数据同步。
+
+## 工作流
+
+工作流是基于特定条件触发动作的自动化过程,帮助您自动化重复性任务和业务流程。
+
+## 工作区
+
+一个 `工作区` 通常代表使用 Twenty 的公司。 它保存您和您的团队成员添加到 Twenty 的所有记录和数据。
+它有一个单一的域名,通常是您公司用于员工电子邮件地址的域名。
+
+## 工作区成员
+
+工作区成员是您的团队中有权访问您的工作区的 Twenty 用户。 他们可以被指定为记录的所有者或被分配人。
diff --git a/packages/twenty-docs/l/zh/getting-started/core-concepts/layout.mdx b/packages/twenty-docs/l/zh/getting-started/core-concepts/layout.mdx
new file mode 100644
index 0000000000..9b441fb11d
--- /dev/null
+++ b/packages/twenty-docs/l/zh/getting-started/core-concepts/layout.mdx
@@ -0,0 +1,74 @@
+---
+title: 布局
+description: 如何在 Twenty 中导航、浏览和查看记录。
+icon: table-columns
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+## 主布局
+
+屏幕中央是记录所在——人员、公司、商机、任务、备注、仪表板、工作流,以及任何自定义对象。 您可以在这里查看、编辑和删除记录,并创建新的视图。
+
+
+
+## 导航栏
+
+左侧侧边栏为您提供:
+
+* **工作区切换器**——在不同工作区之间切换或创建新的工作区(顶部下拉菜单)
+* **搜索**——按下 `/` 可立即聚焦,跨所有对象进行搜索
+* **设置**——从左上角进入
+* **收藏夹**——置顶视图,每个用户互相独立
+* **对象快捷方式**——快速访问 People、Companies、Opportunities 等对象
+* **Workflows**——创建自动化流程
+
+拖动项目以重新排序,创建文件夹对相关对象进行分组,隐藏不使用的内容。
+
+
+
+## 命令菜单
+
+按 `Cmd+K`(Mac)或 `Ctrl+K`(Windows),或单击右上角的三个点。 从这里您可以:
+
+* 创建新记录
+* 通过 CSV 导入和导出数据
+* 创建新视图
+* 访问已删除的记录(Twenty 支持软删除和硬删除)
+* 查看用于在工作区中导航的键盘快捷键
+
+
+
+## 搜索
+
+可通过命令菜单、导航栏顶部或按下 `/` 访问。 搜索可跨所有对象使用。
+
+
+
+## 侧边面板
+
+点击一条记录,在右侧打开侧边面板——在不离开当前页面的情况下快速总览该记录的关键信息。 点击 **Open** 进入完整记录页面。
+
+
+
+## 视图
+
+每个对象都支持多个视图——每个对象的视图数量不限。 使用左上角的下拉菜单在不同视图之间切换。
+
+* **表格**——类似电子表格的行和列,支持分组、行内编辑和列自定义
+* **看板**——按选择字段组织的拖放卡片,非常适合用于流程管道
+* **日历**——根据日期字段绘制记录,用于基于时间的规划
+
+每个视图都会保存其自己的筛选、排序和字段可见性。 可以将视图共享给整个工作区,或将其设为私有。 将视图添加到收藏夹,以便从侧边栏快速访问。
+
+
+
+## 记录页面
+
+打开记录时,详情页面由可配置的**选项卡**和**小组件**构成。 在网格上添加、删除、重新排序和调整小组件大小——字段、相关记录、电子邮件、时间线、任务、备注、文件、图表、iframe 等。 每种对象类型都有其自己的布局。
+
+
+ 导航、视图、记录页面——详细参考和操作指南。
+
+
+
diff --git a/packages/twenty-docs/l/zh/getting-started/core-concepts/workflows.mdx b/packages/twenty-docs/l/zh/getting-started/core-concepts/workflows.mdx
new file mode 100644
index 0000000000..674b78ebfc
--- /dev/null
+++ b/packages/twenty-docs/l/zh/getting-started/core-concepts/workflows.mdx
@@ -0,0 +1,55 @@
+---
+title: 工作流
+description: 使用 Twenty 的可视化工作流构建器自动化您的业务流程。
+icon: bolt
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+工作流可让您自动化重复性任务,并将 Twenty 连接到外部工具——无需编写代码(当然如果您愿意也可以编写)。
+
+
+
+## 工作流如何运作
+
+每个工作流由三部分组成:
+
+1. **触发器** — 启动工作流的条件
+2. **步骤** — 接下来发生的事情(一个或多个按顺序执行的操作)
+3. **变量** — 在步骤之间流动的数据
+
+## 触发器
+
+| 触发器 | 触发时机 |
+| ----------- | -------------------------- |
+| **记录事件** | 当记录被创建、更新、删除或执行 upsert 操作时 |
+| **手动** | 当用户点击按钮时(针对单条记录、多条记录或全局) |
+| **计划** | 按固定时间间隔(cron 语法) |
+| **Webhook** | 外部系统发送一个 HTTP POST |
+
+## 操作
+
+工作流可以以任意组合串联以下内容:
+
+* **记录操作** — 创建、更新、查找、删除或 upsert 记录
+* **发送电子邮件** — 从已连接的账户发送或撰写电子邮件
+* **HTTP 请求** — 调用任意外部 API
+* **代码** — 运行自定义 JavaScript 以处理复杂逻辑
+* **分支** — 使用 if/else 条件拆分工作流路径
+* **迭代器** — 遍历数据数组
+* **AI Agent** — 让 AI 代理自主处理数据
+* **延迟** — 在继续之前等待
+* **表单** — 在工作流中途收集用户输入
+
+## 你可以构建的内容
+
+* 当交易达到某个阶段时发送 Slack 警报
+* 使用外部 API 的数据自动丰富新联系人
+* 检测长期未跟进的机会并通知负责人
+* 在 Twenty 与您的计费系统之间同步数据
+* 从记录数据生成 PDF 或发票
+* 对符合特定条件的入站电子邮件自动回复
+
+
+ 关于触发器、操作、变量以及真实世界自动化方案的详细参考。
+
diff --git a/packages/twenty-docs/l/zh/getting-started/introduction.mdx b/packages/twenty-docs/l/zh/getting-started/introduction.mdx
new file mode 100644
index 0000000000..c78eae2230
--- /dev/null
+++ b/packages/twenty-docs/l/zh/getting-started/introduction.mdx
@@ -0,0 +1,53 @@
+---
+title: 为什么选择 Twenty
+icon: heart
+---
+
+import { CardTitle } from "/snippets/card-title.mdx"
+
+你一直在两类软件之间做选择:一类是容易上手却无法调整,另一类是高度灵活却需要几个月才能完成配置。 Twenty 是第三种选择:**一款可随时按你需求重塑的、可立即投入生产使用的 CRM。**
+
+## Twenty 有何不同
+
+Twenty 是一个可以在其之上进行构建的平台,而不是一个只能进行配置的产品。
+
+
+
+ 为智能体打造
+ Agents 在你的数据模型内部运行,并具备真实的权限控制。 技能、工具、MCP。
+
+
+ 安全可扩展性
+ 在安全基础之上的 vibe-coded 工具灵活性。
+
+
+ 现代技术栈
+ React,TypeScript。 你的团队已经知道如何扩展 Twenty。 没有专有语言,没有人为设限。
+
+
+ 无锁定
+ 开源内核,可自托管,随时导出你的数据。
+
+
+
+## Twenty 适合谁
+
+* **正在替换 Salesforce 的大型企业** —— 你的团队花在与工具“对抗”上的时间,比真正使用它的时间还多。
+ 你感觉被牢牢锁定,而成本却不断攀升。
+* **由技术型创始人领导的初创公司** —— 你已经不再满足于电子表格和 Notion。 你有远大目标,需要一款能够随你一同扩展的 CRM。
+* **寻求优势的 GTM 团队** —— 你希望构建你自己的潜在客户评分、你自己的数据丰富方案、你自己的外呼工作流。
+* **重视隐私的组织** —— 你需要自托管,并从端到端掌控你的数据。 出于监管、合同,或者纯粹是基于原则。
+* **Salesforce 合作伙伴** ——
+ 你的开发人员已经厌倦了不断向客户解释许可证费用上涨。
+ 你希望拥有更好的 DX,并以更低的许可证成本,更快地为客户交付项目。
+* **网页开发代理机构** —— 你的团队熟悉 TypeScript、React 和 PostgreSQL。 Twenty 让 CRM 市场向你敞开大门,而无需学习 APEX 或获取专有认证。
+
+## Twenty 不适合谁
+
+* **希望拥有一个完全不用操心的 CRM 的团队。** Twenty 更适合那些愿意贴近自己的工具,并在实践中持续打磨它们的团队。 如果你想要的是完全托管的方案,Pipedrive 或 HubSpot 会非常适合你。
+* **今天就需要数百个预构建集成的公司。** 我们的生态正在快速成长,但目前还没有 Salesforce 或 HubSpot 那么广泛。 如果你愿意动手构建那些目前还缺少的部分,你会非常喜欢它。 如果不愿意,那就再给我们一年时间。
+* **由会议室而不是一线使用者来决定工具的组织。** 我们不搞牛排晚宴和高层简报会。 我们之所以能赢,是因为我们服务的团队拥有选择自己工具的决策权。
+
+
+ 在不到 5 分钟内完成 Twenty 的设置——无论是在云端还是自托管。
+
diff --git a/packages/twenty-docs/l/zh/getting-started/key-features.mdx b/packages/twenty-docs/l/zh/getting-started/key-features.mdx
new file mode 100644
index 0000000000..02ac2c508e
--- /dev/null
+++ b/packages/twenty-docs/l/zh/getting-started/key-features.mdx
@@ -0,0 +1,70 @@
+---
+title: 关键功能
+description: 了解 Twenty 的全部功能之旅——从自定义数据模型到 AI 驱动的自动化。
+icon: 星标
+---
+
+import { CardTitle } from "/snippets/card-title.mdx"
+
+Twenty 是一款功能齐全的 CRM 平台。 以下是您可以用它构建的内容。
+
+
+
+ 自定义数据模型
+ 定义完全符合您业务需求的数据结构。
+ 创建自定义对象,使用 20 多种字段类型添加自定义字段,并在任意对象之间构建关联关系。
+
+
+
+ 视图与管道
+ 在表格视图、看板和日历视图之间切换。
+ 使用 AND/OR 逻辑进行筛选,可按多个字段排序,对记录进行分组,并保存自定义视图。
+
+
+
+ 工作流与自动化
+ 无需编写代码即可自动化任何业务流程。
+ 在记录变更、定时计划、手动操作或接收 webhooks 时触发工作流。
+
+
+
+ 日历与邮箱同步
+ 连接您的 Google Workspace 或 Microsoft 365 帐号。
+ 邮件和日历事件会自动显示在相关 CRM 记录中。
+
+
+
+ AI
+ 在您的 CRM 中自主运行的 AI 智能体——回答问题、丰富记录,并在您的权限模型内执行多步骤任务。
+
+
+
+ 仪表盘与报表
+ 使用实时小部件构建自定义仪表盘。
+ 通过可配置的图表和筛选器跟踪管道指标、团队绩效和业务 KPI。
+
+
+
+ 权限与访问控制
+ 在每个层级实施基于角色的访问控制——对象、字段以及单条记录。
+ 使用 SAML 或 OIDC 配置 SSO。 审计日志会记录是谁在何时做了什么。
+
+
+
+ API 与可扩展性
+ 面向开发者优先设计的 API,可适配您的自定义数据模型。
+ 同时提供 GraphQL 和 REST 端点,并为每个 workspace 自动生成文档。
+
+
+
+ 数据导入与导出
+ 通过 CSV 文件或 API 导入数据。
+ 内置字段映射、重复检测和错误处理功能。 随时导出您的数据——绝无锁定。
+
+
+
+ 自托管
+ 使用单条 Docker Compose 命令在您的自有基础设施上运行 Twenty。
+ 对您的数据拥有完全控制权,并按您的节奏进行更新。
+
+
diff --git a/packages/twenty-docs/l/zh/getting-started/quickstart.mdx b/packages/twenty-docs/l/zh/getting-started/quickstart.mdx
new file mode 100644
index 0000000000..3b2f6b699d
--- /dev/null
+++ b/packages/twenty-docs/l/zh/getting-started/quickstart.mdx
@@ -0,0 +1,73 @@
+---
+title: 快速入门
+description: 在不到 5 分钟内让 Twenty 运行起来——无论是在云端还是自托管。
+icon: play
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+## 注册
+
+
+
+ 访问 [app.twenty.com](https://app.twenty.com) 并使用 Google、Microsoft 或电子邮件注册。
+
+
+ 选择 **30 天**(需要信用卡)或 **7 天**(无需信用卡)。 两种选项都包含完整访问权限——不限联系人数量、电子邮件集成、自定义对象和 API。 您可随时更改套餐或计费周期。
+
+
+ 通过 Stripe 完成付款确认后,您将设置工作区名称和用户个人资料。 您可以随时取消。
+
+
+
+
+
+## 配置您的工作区
+
+进入后,完成以下三个步骤,让 Twenty 真正成为您的工具:
+
+### 1. 连接您的邮箱
+
+前往 **Settings → Accounts** 并连接您的 Google 或 Microsoft 帐户。 Twenty 将导入您的电子邮件和日历事件,并根据交互自动创建联系人。 使用其他服务提供商? 您可以在同一页面通过 SMTP 添加邮箱,或通过 CalDAV 添加日历。
+
+从这里开始——连接邮箱可以在您自定义其他内容之前,通过真实数据立即为团队带来价值。
+
+
+
+### 2. 塑造您的数据模型
+
+前往 **Settings → Data Model** 创建自定义对象和字段。 有几点需要了解:
+
+* 自定义对象和字段在所有套餐中均**不限量**——无额外加价。
+* **人员、公司和机会** 是显示已同步电子邮件和会议的对象。 将它们作为基础使用,并添加字段进行分类(例如,一个 `Person Type` 字段),而不是创建不会包含电子邮件历史记录的单独对象。
+* 两个人不能拥有相同的电子邮件地址。 两家公司不能拥有相同的域名。
+* 您可以停用不需要的标准字段/对象,并在不删除字段的情况下将其从视图中隐藏。
+
+[数据模型参考 →](/l/zh/user-guide/data-model/overview)
+
+
+
+### 3. 导入您的数据
+
+使用命令菜单 (`Cmd+K` / `Ctrl+K`) 通过 CSV 导入人员、公司、机会或任何自定义对象。 请先下载示例文件,以查看期望的格式。 将文件限制在最多 10,000 条记录,并在导入前去重电子邮件/域名。
+
+[数据迁移指南 →](/l/zh/user-guide/data-migration/overview)
+
+
+
+## 后续步骤
+
+
+
+ 导航、视图、命令菜单、侧边面板。
+
+
+ 自动化您的业务流程。
+
+
+ 表格、看板、日历——筛选并排序您的数据。
+
+
+ 每个租户独立 Schema 的 REST 和 GraphQL。
+
+