Skip to content

The open alternative to Salesforce, designed for AI.

i18n - docs translations (#21789)

github-actions[bot]2b3b2362db65
diff --git a/packages/twenty-docs/docs.json b/packages/twenty-docs/docs.json
index 939eff51cb6..e512d591551 100644
--- a/packages/twenty-docs/docs.json
+++ b/packages/twenty-docs/docs.json
@@ -469,10 +469,10 @@
"language": "fr",
"tabs": [
{
- "tab": "Getting Started",
+ "tab": "Prise en main",
"groups": [
{
- "group": "Welcome",
+ "group": "Bienvenue",
"pages": [
"getting-started/introduction",
"getting-started/key-features",
@@ -480,7 +480,7 @@
]
},
{
- "group": "Core Concepts",
+ "group": "Concepts clés",
"pages": [
"getting-started/core-concepts/data-model",
"getting-started/core-concepts/layout",
@@ -498,7 +498,7 @@
"tab": "Guide de l'utilisateur",
"groups": [
{
- "group": "Overview",
+ "group": "Vue d'ensemble",
"pages": [
"l/fr/user-guide/introduction"
]
@@ -509,7 +509,7 @@
"pages": [
"l/fr/user-guide/data-model/overview",
{
- "group": "Reference",
+ "group": "Référence",
"pages": [
"l/fr/user-guide/data-model/capabilities/objects",
"l/fr/user-guide/data-model/capabilities/fields",
@@ -535,7 +535,7 @@
"pages": [
"l/fr/user-guide/data-migration/overview",
{
- "group": "Reference",
+ "group": "Référence",
"pages": [
"l/fr/user-guide/data-migration/capabilities/file-formats",
"l/fr/user-guide/data-migration/capabilities/field-mapping",
@@ -567,7 +567,7 @@
"pages": [
"l/fr/user-guide/calendar-emails/overview",
{
- "group": "Reference",
+ "group": "Référence",
"pages": [
"l/fr/user-guide/calendar-emails/capabilities/mailbox",
"l/fr/user-guide/calendar-emails/capabilities/calendar"
@@ -592,7 +592,7 @@
"pages": [
"l/fr/user-guide/workflows/overview",
{
- "group": "Reference",
+ "group": "Référence",
"pages": [
"l/fr/user-guide/workflows/capabilities/workflow-triggers",
"l/fr/user-guide/workflows/capabilities/workflow-actions",
@@ -618,7 +618,7 @@
"l/fr/user-guide/workflows/how-tos/crm-automations/display-related-record-data",
"l/fr/user-guide/workflows/how-tos/crm-automations/closed-won-automations",
"l/fr/user-guide/workflows/how-tos/crm-automations/detect-stale-opportunities",
- "user-guide/workflows/how-tos/crm-automations/auto-reply-to-inbound-emails"
+ "l/fr/user-guide/workflows/how-tos/crm-automations/auto-reply-to-inbound-emails"
]
},
{
@@ -655,7 +655,7 @@
"pages": [
"l/fr/user-guide/ai/overview",
{
- "group": "Reference",
+ "group": "Référence",
"pages": [
"l/fr/user-guide/ai/capabilities/ai-chatbot",
"l/fr/user-guide/ai/capabilities/ai-agents",
@@ -671,16 +671,16 @@
]
},
{
- "group": "Layout",
+ "group": "Disposition",
"icon": "table-columns",
"pages": [
- "user-guide/layout/overview",
+ "l/fr/user-guide/layout/overview",
{
- "group": "Reference",
+ "group": "Référence",
"pages": [
- "user-guide/layout/capabilities/navigation",
+ "l/fr/user-guide/layout/capabilities/navigation",
{
- "group": "Views",
+ "group": "Vues",
"pages": [
"l/fr/user-guide/views-pipelines/capabilities/table-views",
"l/fr/user-guide/views-pipelines/capabilities/kanban-views",
@@ -690,11 +690,11 @@
"l/fr/user-guide/views-pipelines/capabilities/view-settings"
]
},
- "user-guide/layout/capabilities/record-pages"
+ "l/fr/user-guide/layout/capabilities/record-pages"
]
},
{
- "group": "How-Tos",
+ "group": "Guides pratiques",
"pages": [
"l/fr/user-guide/views-pipelines/how-tos/create-a-table-view-with-grouping",
"l/fr/user-guide/views-pipelines/how-tos/create-a-kanban-view-for-projects",
@@ -713,7 +713,7 @@
"pages": [
"l/fr/user-guide/dashboards/overview",
{
- "group": "Reference",
+ "group": "Référence",
"pages": [
"l/fr/user-guide/dashboards/capabilities/dashboards",
"l/fr/user-guide/dashboards/capabilities/widgets",
@@ -735,7 +735,7 @@
"pages": [
"l/fr/user-guide/permissions-access/overview",
{
- "group": "Reference",
+ "group": "Référence",
"pages": [
"l/fr/user-guide/permissions-access/capabilities/permissions",
"l/fr/user-guide/permissions-access/capabilities/sso-configuration"
@@ -755,7 +755,7 @@
"pages": [
"l/fr/user-guide/billing/overview",
{
- "group": "Reference",
+ "group": "Référence",
"pages": [
"l/fr/user-guide/billing/capabilities/pricing-plans",
"l/fr/user-guide/billing/capabilities/credits"
@@ -775,7 +775,7 @@
"pages": [
"l/fr/user-guide/settings/overview",
{
- "group": "Reference",
+ "group": "Référence",
"pages": [
"l/fr/user-guide/settings/capabilities/workspace-settings",
"l/fr/user-guide/settings/capabilities/member-management",
@@ -799,72 +799,72 @@
"tab": "Développeurs",
"groups": [
{
- "group": "Overview",
+ "group": "Vue d'ensemble",
"pages": [
"l/fr/developers/introduction"
]
},
{
- "group": "Apps",
+ "group": "Applications",
"pages": [
{
- "group": "Getting Started",
+ "group": "Prise en main",
"pages": [
- "developers/extend/apps/getting-started/quick-start",
- "developers/extend/apps/getting-started/concepts",
- "developers/extend/apps/getting-started/project-structure",
- "developers/extend/apps/getting-started/local-server",
- "developers/extend/apps/getting-started/scaffolding",
- "developers/extend/apps/getting-started/troubleshooting"
+ "l/fr/developers/extend/apps/getting-started/quick-start",
+ "l/fr/developers/extend/apps/getting-started/concepts",
+ "l/fr/developers/extend/apps/getting-started/project-structure",
+ "l/fr/developers/extend/apps/getting-started/local-server",
+ "l/fr/developers/extend/apps/getting-started/scaffolding",
+ "l/fr/developers/extend/apps/getting-started/troubleshooting"
]
},
{
- "group": "Config",
+ "group": "Configuration",
"pages": [
- "developers/extend/apps/config/overview",
- "developers/extend/apps/config/application",
- "developers/extend/apps/config/roles",
- "developers/extend/apps/config/install-hooks",
- "developers/extend/apps/config/public-assets"
+ "l/fr/developers/extend/apps/config/overview",
+ "l/fr/developers/extend/apps/config/application",
+ "l/fr/developers/extend/apps/config/roles",
+ "l/fr/developers/extend/apps/config/install-hooks",
+ "l/fr/developers/extend/apps/config/public-assets"
]
},
{
- "group": "Data",
+ "group": "Données",
"pages": [
- "developers/extend/apps/data/overview",
- "developers/extend/apps/data/objects",
- "developers/extend/apps/data/extending-objects",
- "developers/extend/apps/data/relations"
+ "l/fr/developers/extend/apps/data/overview",
+ "l/fr/developers/extend/apps/data/objects",
+ "l/fr/developers/extend/apps/data/extending-objects",
+ "l/fr/developers/extend/apps/data/relations"
]
},
{
- "group": "Logic",
+ "group": "Logique",
"pages": [
- "developers/extend/apps/logic/overview",
- "developers/extend/apps/logic/logic-functions",
- "developers/extend/apps/logic/skills-and-agents",
- "developers/extend/apps/logic/connections"
+ "l/fr/developers/extend/apps/logic/overview",
+ "l/fr/developers/extend/apps/logic/logic-functions",
+ "l/fr/developers/extend/apps/logic/skills-and-agents",
+ "l/fr/developers/extend/apps/logic/connections"
]
},
{
- "group": "Layout",
+ "group": "Disposition",
"pages": [
- "developers/extend/apps/layout/overview",
- "developers/extend/apps/layout/views",
- "developers/extend/apps/layout/navigation-menu-items",
- "developers/extend/apps/layout/page-layouts",
- "developers/extend/apps/layout/front-components",
- "developers/extend/apps/layout/command-menu-items"
+ "l/fr/developers/extend/apps/layout/overview",
+ "l/fr/developers/extend/apps/layout/views",
+ "l/fr/developers/extend/apps/layout/navigation-menu-items",
+ "l/fr/developers/extend/apps/layout/page-layouts",
+ "l/fr/developers/extend/apps/layout/front-components",
+ "l/fr/developers/extend/apps/layout/command-menu-items"
]
},
{
- "group": "Operations",
+ "group": "Opérations",
"pages": [
- "developers/extend/apps/operations/overview",
- "developers/extend/apps/operations/cli",
- "developers/extend/apps/operations/sync-and-recovery",
- "developers/extend/apps/operations/testing",
- "developers/extend/apps/operations/publishing"
+ "l/fr/developers/extend/apps/operations/overview",
+ "l/fr/developers/extend/apps/operations/cli",
+ "l/fr/developers/extend/apps/operations/sync-and-recovery",
+ "l/fr/developers/extend/apps/operations/testing",
+ "l/fr/developers/extend/apps/operations/publishing"
]
}
]
@@ -872,9 +872,9 @@
{
"group": "API",
"pages": [
- "developers/extend/api",
- "developers/extend/webhooks",
- "developers/extend/oauth"
+ "l/fr/developers/extend/api",
+ "l/fr/developers/extend/webhooks",
+ "l/fr/developers/extend/oauth"
]
},
{
@@ -890,8 +890,8 @@
"group": "Contribuer",
"pages": [
"l/fr/developers/contribute/capabilities/local-setup",
- "developers/contribute/commands",
- "developers/contribute/style-guide"
+ "l/fr/developers/contribute/commands",
+ "l/fr/developers/contribute/style-guide"
]
}
]
@@ -1241,63 +1241,63 @@
"group": "التطبيقات",
"pages": [
{
- "group": "Getting Started",
+ "group": "البدء",
"pages": [
- "developers/extend/apps/getting-started/quick-start",
- "developers/extend/apps/getting-started/concepts",
- "developers/extend/apps/getting-started/project-structure",
- "developers/extend/apps/getting-started/local-server",
- "developers/extend/apps/getting-started/scaffolding",
- "developers/extend/apps/getting-started/troubleshooting"
+ "l/ar/developers/extend/apps/getting-started/quick-start",
+ "l/ar/developers/extend/apps/getting-started/concepts",
+ "l/ar/developers/extend/apps/getting-started/project-structure",
+ "l/ar/developers/extend/apps/getting-started/local-server",
+ "l/ar/developers/extend/apps/getting-started/scaffolding",
+ "l/ar/developers/extend/apps/getting-started/troubleshooting"
]
},
{
- "group": "Config",
+ "group": "التهيئة",
"pages": [
- "developers/extend/apps/config/overview",
- "developers/extend/apps/config/application",
- "developers/extend/apps/config/roles",
- "developers/extend/apps/config/install-hooks",
- "developers/extend/apps/config/public-assets"
+ "l/ar/developers/extend/apps/config/overview",
+ "l/ar/developers/extend/apps/config/application",
+ "l/ar/developers/extend/apps/config/roles",
+ "l/ar/developers/extend/apps/config/install-hooks",
+ "l/ar/developers/extend/apps/config/public-assets"
]
},
{
- "group": "Data",
+ "group": "بيانات",
"pages": [
- "developers/extend/apps/data/overview",
- "developers/extend/apps/data/objects",
- "developers/extend/apps/data/extending-objects",
- "developers/extend/apps/data/relations"
+ "l/ar/developers/extend/apps/data/overview",
+ "l/ar/developers/extend/apps/data/objects",
+ "l/ar/developers/extend/apps/data/extending-objects",
+ "l/ar/developers/extend/apps/data/relations"
]
},
{
- "group": "Logic",
+ "group": "المنطق",
"pages": [
- "developers/extend/apps/logic/overview",
- "developers/extend/apps/logic/logic-functions",
- "developers/extend/apps/logic/skills-and-agents",
- "developers/extend/apps/logic/connections"
+ "l/ar/developers/extend/apps/logic/overview",
+ "l/ar/developers/extend/apps/logic/logic-functions",
+ "l/ar/developers/extend/apps/logic/skills-and-agents",
+ "l/ar/developers/extend/apps/logic/connections"
]
},
{
- "group": "Layout",
+ "group": "التخطيط",
"pages": [
- "developers/extend/apps/layout/overview",
- "developers/extend/apps/layout/views",
- "developers/extend/apps/layout/navigation-menu-items",
- "developers/extend/apps/layout/page-layouts",
- "developers/extend/apps/layout/front-components",
- "developers/extend/apps/layout/command-menu-items"
+ "l/ar/developers/extend/apps/layout/overview",
+ "l/ar/developers/extend/apps/layout/views",
+ "l/ar/developers/extend/apps/layout/navigation-menu-items",
+ "l/ar/developers/extend/apps/layout/page-layouts",
+ "l/ar/developers/extend/apps/layout/front-components",
+ "l/ar/developers/extend/apps/layout/command-menu-items"
]
},
{
- "group": "Operations",
+ "group": "العمليات",
"pages": [
- "developers/extend/apps/operations/overview",
- "developers/extend/apps/operations/cli",
- "developers/extend/apps/operations/sync-and-recovery",
- "developers/extend/apps/operations/testing",
- "developers/extend/apps/operations/publishing"
+ "l/ar/developers/extend/apps/operations/overview",
+ "l/ar/developers/extend/apps/operations/cli",
+ "l/ar/developers/extend/apps/operations/sync-and-recovery",
+ "l/ar/developers/extend/apps/operations/testing",
+ "l/ar/developers/extend/apps/operations/publishing"
]
}
]
@@ -1674,63 +1674,63 @@
"group": "Aplikace",
"pages": [
{
- "group": "Getting Started",
+ "group": "Začínáme",
"pages": [
- "developers/extend/apps/getting-started/quick-start",
- "developers/extend/apps/getting-started/concepts",
- "developers/extend/apps/getting-started/project-structure",
- "developers/extend/apps/getting-started/local-server",
- "developers/extend/apps/getting-started/scaffolding",
- "developers/extend/apps/getting-started/troubleshooting"
+ "l/cs/developers/extend/apps/getting-started/quick-start",
+ "l/cs/developers/extend/apps/getting-started/concepts",
+ "l/cs/developers/extend/apps/getting-started/project-structure",
+ "l/cs/developers/extend/apps/getting-started/local-server",
+ "l/cs/developers/extend/apps/getting-started/scaffolding",
+ "l/cs/developers/extend/apps/getting-started/troubleshooting"
]
},
{
- "group": "Config",
+ "group": "Konfigurace",
"pages": [
- "developers/extend/apps/config/overview",
- "developers/extend/apps/config/application",
- "developers/extend/apps/config/roles",
- "developers/extend/apps/config/install-hooks",
- "developers/extend/apps/config/public-assets"
+ "l/cs/developers/extend/apps/config/overview",
+ "l/cs/developers/extend/apps/config/application",
+ "l/cs/developers/extend/apps/config/roles",
+ "l/cs/developers/extend/apps/config/install-hooks",
+ "l/cs/developers/extend/apps/config/public-assets"
]
},
{
"group": "Data",
"pages": [
- "developers/extend/apps/data/overview",
- "developers/extend/apps/data/objects",
- "developers/extend/apps/data/extending-objects",
- "developers/extend/apps/data/relations"
+ "l/cs/developers/extend/apps/data/overview",
+ "l/cs/developers/extend/apps/data/objects",
+ "l/cs/developers/extend/apps/data/extending-objects",
+ "l/cs/developers/extend/apps/data/relations"
]
},
{
- "group": "Logic",
+ "group": "Logika",
"pages": [
- "developers/extend/apps/logic/overview",
- "developers/extend/apps/logic/logic-functions",
- "developers/extend/apps/logic/skills-and-agents",
- "developers/extend/apps/logic/connections"
+ "l/cs/developers/extend/apps/logic/overview",
+ "l/cs/developers/extend/apps/logic/logic-functions",
+ "l/cs/developers/extend/apps/logic/skills-and-agents",
+ "l/cs/developers/extend/apps/logic/connections"
]
},
{
- "group": "Layout",
+ "group": "Rozvržení",
"pages": [
- "developers/extend/apps/layout/overview",
- "developers/extend/apps/layout/views",
- "developers/extend/apps/layout/navigation-menu-items",
- "developers/extend/apps/layout/page-layouts",
- "developers/extend/apps/layout/front-components",
- "developers/extend/apps/layout/command-menu-items"
+ "l/cs/developers/extend/apps/layout/overview",
+ "l/cs/developers/extend/apps/layout/views",
+ "l/cs/developers/extend/apps/layout/navigation-menu-items",
+ "l/cs/developers/extend/apps/layout/page-layouts",
+ "l/cs/developers/extend/apps/layout/front-components",
+ "l/cs/developers/extend/apps/layout/command-menu-items"
]
},
{
- "group": "Operations",
+ "group": "Operace",
"pages": [
- "developers/extend/apps/operations/overview",
- "developers/extend/apps/operations/cli",
- "developers/extend/apps/operations/sync-and-recovery",
- "developers/extend/apps/operations/testing",
- "developers/extend/apps/operations/publishing"
+ "l/cs/developers/extend/apps/operations/overview",
+ "l/cs/developers/extend/apps/operations/cli",
+ "l/cs/developers/extend/apps/operations/sync-and-recovery",
+ "l/cs/developers/extend/apps/operations/testing",
+ "l/cs/developers/extend/apps/operations/publishing"
]
}
]
@@ -2201,10 +2201,10 @@
"language": "es",
"tabs": [
{
- "tab": "Getting Started",
+ "tab": "Primeros pasos",
"groups": [
{
- "group": "Welcome",
+ "group": "Bienvenido",
"pages": [
"getting-started/introduction",
"getting-started/key-features",
@@ -2212,7 +2212,7 @@
]
},
{
- "group": "Core Concepts",
+ "group": "Conceptos clave",
"pages": [
"getting-started/core-concepts/data-model",
"getting-started/core-concepts/layout",
@@ -2230,7 +2230,7 @@
"tab": "Guía de usuario",
"groups": [
{
- "group": "Overview",
+ "group": "Resumen",
"pages": [
"l/es/user-guide/introduction"
]
@@ -2241,7 +2241,7 @@
"pages": [
"l/es/user-guide/data-model/overview",
{
- "group": "Reference",
+ "group": "Referencia",
"pages": [
"l/es/user-guide/data-model/capabilities/objects",
"l/es/user-guide/data-model/capabilities/fields",
@@ -2267,7 +2267,7 @@
"pages": [
"l/es/user-guide/data-migration/overview",
{
- "group": "Reference",
+ "group": "Referencia",
"pages": [
"l/es/user-guide/data-migration/capabilities/file-formats",
"l/es/user-guide/data-migration/capabilities/field-mapping",
@@ -2299,7 +2299,7 @@
"pages": [
"l/es/user-guide/calendar-emails/overview",
{
- "group": "Reference",
+ "group": "Referencia",
"pages": [
"l/es/user-guide/calendar-emails/capabilities/mailbox",
"l/es/user-guide/calendar-emails/capabilities/calendar"
@@ -2324,7 +2324,7 @@
"pages": [
"l/es/user-guide/workflows/overview",
{
- "group": "Reference",
+ "group": "Referencia",
"pages": [
"l/es/user-guide/workflows/capabilities/workflow-triggers",
"l/es/user-guide/workflows/capabilities/workflow-actions",
@@ -2350,7 +2350,7 @@
"l/es/user-guide/workflows/how-tos/crm-automations/display-related-record-data",
"l/es/user-guide/workflows/how-tos/crm-automations/closed-won-automations",
"l/es/user-guide/workflows/how-tos/crm-automations/detect-stale-opportunities",
- "user-guide/workflows/how-tos/crm-automations/auto-reply-to-inbound-emails"
+ "l/es/user-guide/workflows/how-tos/crm-automations/auto-reply-to-inbound-emails"
]
},
{
@@ -2387,7 +2387,7 @@
"pages": [
"l/es/user-guide/ai/overview",
{
- "group": "Reference",
+ "group": "Referencia",
"pages": [
"l/es/user-guide/ai/capabilities/ai-chatbot",
"l/es/user-guide/ai/capabilities/ai-agents",
@@ -2403,16 +2403,16 @@
]
},
{
- "group": "Layout",
+ "group": "Diseño",
"icon": "table-columns",
"pages": [
- "user-guide/layout/overview",
+ "l/es/user-guide/layout/overview",
{
- "group": "Reference",
+ "group": "Referencia",
"pages": [
- "user-guide/layout/capabilities/navigation",
+ "l/es/user-guide/layout/capabilities/navigation",
{
- "group": "Views",
+ "group": "Vistas",
"pages": [
"l/es/user-guide/views-pipelines/capabilities/table-views",
"l/es/user-guide/views-pipelines/capabilities/kanban-views",
@@ -2422,11 +2422,11 @@
"l/es/user-guide/views-pipelines/capabilities/view-settings"
]
},
- "user-guide/layout/capabilities/record-pages"
+ "l/es/user-guide/layout/capabilities/record-pages"
]
},
{
- "group": "How-Tos",
+ "group": "Guías prácticas",
"pages": [
"l/es/user-guide/views-pipelines/how-tos/create-a-table-view-with-grouping",
"l/es/user-guide/views-pipelines/how-tos/create-a-kanban-view-for-projects",
@@ -2445,7 +2445,7 @@
"pages": [
"l/es/user-guide/dashboards/overview",
{
- "group": "Reference",
+ "group": "Referencia",
"pages": [
"l/es/user-guide/dashboards/capabilities/dashboards",
"l/es/user-guide/dashboards/capabilities/widgets",
@@ -2467,7 +2467,7 @@
"pages": [
"l/es/user-guide/permissions-access/overview",
{
- "group": "Reference",
+ "group": "Referencia",
"pages": [
"l/es/user-guide/permissions-access/capabilities/permissions",
"l/es/user-guide/permissions-access/capabilities/sso-configuration"
@@ -2487,7 +2487,7 @@
"pages": [
"l/es/user-guide/billing/overview",
{
- "group": "Reference",
+ "group": "Referencia",
"pages": [
"l/es/user-guide/billing/capabilities/pricing-plans",
"l/es/user-guide/billing/capabilities/credits"
@@ -2507,7 +2507,7 @@
"pages": [
"l/es/user-guide/settings/overview",
{
- "group": "Reference",
+ "group": "Referencia",
"pages": [
"l/es/user-guide/settings/capabilities/workspace-settings",
"l/es/user-guide/settings/capabilities/member-management",
@@ -2531,72 +2531,72 @@
"tab": "Desarrolladores",
"groups": [
{
- "group": "Overview",
+ "group": "Resumen",
"pages": [
"l/es/developers/introduction"
]
},
{
- "group": "Apps",
+ "group": "Aplicaciones",
"pages": [
{
- "group": "Getting Started",
+ "group": "Primeros pasos",
"pages": [
- "developers/extend/apps/getting-started/quick-start",
- "developers/extend/apps/getting-started/concepts",
- "developers/extend/apps/getting-started/project-structure",
- "developers/extend/apps/getting-started/local-server",
- "developers/extend/apps/getting-started/scaffolding",
- "developers/extend/apps/getting-started/troubleshooting"
+ "l/es/developers/extend/apps/getting-started/quick-start",
+ "l/es/developers/extend/apps/getting-started/concepts",
+ "l/es/developers/extend/apps/getting-started/project-structure",
+ "l/es/developers/extend/apps/getting-started/local-server",
+ "l/es/developers/extend/apps/getting-started/scaffolding",
+ "l/es/developers/extend/apps/getting-started/troubleshooting"
]
},
{
- "group": "Config",
+ "group": "Configuración",
"pages": [
- "developers/extend/apps/config/overview",
- "developers/extend/apps/config/application",
- "developers/extend/apps/config/roles",
- "developers/extend/apps/config/install-hooks",
- "developers/extend/apps/config/public-assets"
+ "l/es/developers/extend/apps/config/overview",
+ "l/es/developers/extend/apps/config/application",
+ "l/es/developers/extend/apps/config/roles",
+ "l/es/developers/extend/apps/config/install-hooks",
+ "l/es/developers/extend/apps/config/public-assets"
]
},
{
- "group": "Data",
+ "group": "Datos",
"pages": [
- "developers/extend/apps/data/overview",
- "developers/extend/apps/data/objects",
- "developers/extend/apps/data/extending-objects",
- "developers/extend/apps/data/relations"
+ "l/es/developers/extend/apps/data/overview",
+ "l/es/developers/extend/apps/data/objects",
+ "l/es/developers/extend/apps/data/extending-objects",
+ "l/es/developers/extend/apps/data/relations"
]
},
{
- "group": "Logic",
+ "group": "Lógica",
"pages": [
- "developers/extend/apps/logic/overview",
- "developers/extend/apps/logic/logic-functions",
- "developers/extend/apps/logic/skills-and-agents",
- "developers/extend/apps/logic/connections"
+ "l/es/developers/extend/apps/logic/overview",
+ "l/es/developers/extend/apps/logic/logic-functions",
+ "l/es/developers/extend/apps/logic/skills-and-agents",
+ "l/es/developers/extend/apps/logic/connections"
]
},
{
- "group": "Layout",
+ "group": "Diseño",
"pages": [
- "developers/extend/apps/layout/overview",
- "developers/extend/apps/layout/views",
- "developers/extend/apps/layout/navigation-menu-items",
- "developers/extend/apps/layout/page-layouts",
- "developers/extend/apps/layout/front-components",
- "developers/extend/apps/layout/command-menu-items"
+ "l/es/developers/extend/apps/layout/overview",
+ "l/es/developers/extend/apps/layout/views",
+ "l/es/developers/extend/apps/layout/navigation-menu-items",
+ "l/es/developers/extend/apps/layout/page-layouts",
+ "l/es/developers/extend/apps/layout/front-components",
+ "l/es/developers/extend/apps/layout/command-menu-items"
]
},
{
- "group": "Operations",
+ "group": "Operaciones",
"pages": [
- "developers/extend/apps/operations/overview",
- "developers/extend/apps/operations/cli",
- "developers/extend/apps/operations/sync-and-recovery",
- "developers/extend/apps/operations/testing",
- "developers/extend/apps/operations/publishing"
+ "l/es/developers/extend/apps/operations/overview",
+ "l/es/developers/extend/apps/operations/cli",
+ "l/es/developers/extend/apps/operations/sync-and-recovery",
+ "l/es/developers/extend/apps/operations/testing",
+ "l/es/developers/extend/apps/operations/publishing"
]
}
]
@@ -2604,9 +2604,9 @@
{
"group": "API",
"pages": [
- "developers/extend/api",
- "developers/extend/webhooks",
- "developers/extend/oauth"
+ "l/es/developers/extend/api",
+ "l/es/developers/extend/webhooks",
+ "l/es/developers/extend/oauth"
]
},
{
@@ -2622,8 +2622,8 @@
"group": "Contribuir",
"pages": [
"l/es/developers/contribute/capabilities/local-setup",
- "developers/contribute/commands",
- "developers/contribute/style-guide"
+ "l/es/developers/contribute/commands",
+ "l/es/developers/contribute/style-guide"
]
}
]
@@ -2973,63 +2973,63 @@
"group": "App",
"pages": [
{
- "group": "Getting Started",
+ "group": "Per iniziare",
"pages": [
- "developers/extend/apps/getting-started/quick-start",
- "developers/extend/apps/getting-started/concepts",
- "developers/extend/apps/getting-started/project-structure",
- "developers/extend/apps/getting-started/local-server",
- "developers/extend/apps/getting-started/scaffolding",
- "developers/extend/apps/getting-started/troubleshooting"
+ "l/it/developers/extend/apps/getting-started/quick-start",
+ "l/it/developers/extend/apps/getting-started/concepts",
+ "l/it/developers/extend/apps/getting-started/project-structure",
+ "l/it/developers/extend/apps/getting-started/local-server",
+ "l/it/developers/extend/apps/getting-started/scaffolding",
+ "l/it/developers/extend/apps/getting-started/troubleshooting"
]
},
{
- "group": "Config",
+ "group": "Configurazione",
"pages": [
- "developers/extend/apps/config/overview",
- "developers/extend/apps/config/application",
- "developers/extend/apps/config/roles",
- "developers/extend/apps/config/install-hooks",
- "developers/extend/apps/config/public-assets"
+ "l/it/developers/extend/apps/config/overview",
+ "l/it/developers/extend/apps/config/application",
+ "l/it/developers/extend/apps/config/roles",
+ "l/it/developers/extend/apps/config/install-hooks",
+ "l/it/developers/extend/apps/config/public-assets"
]
},
{
- "group": "Data",
+ "group": "Dati",
"pages": [
- "developers/extend/apps/data/overview",
- "developers/extend/apps/data/objects",
- "developers/extend/apps/data/extending-objects",
- "developers/extend/apps/data/relations"
+ "l/it/developers/extend/apps/data/overview",
+ "l/it/developers/extend/apps/data/objects",
+ "l/it/developers/extend/apps/data/extending-objects",
+ "l/it/developers/extend/apps/data/relations"
]
},
{
- "group": "Logic",
+ "group": "Logica",
"pages": [
- "developers/extend/apps/logic/overview",
- "developers/extend/apps/logic/logic-functions",
- "developers/extend/apps/logic/skills-and-agents",
- "developers/extend/apps/logic/connections"
+ "l/it/developers/extend/apps/logic/overview",
+ "l/it/developers/extend/apps/logic/logic-functions",
+ "l/it/developers/extend/apps/logic/skills-and-agents",
+ "l/it/developers/extend/apps/logic/connections"
]
},
{
"group": "Layout",
"pages": [
- "developers/extend/apps/layout/overview",
- "developers/extend/apps/layout/views",
- "developers/extend/apps/layout/navigation-menu-items",
- "developers/extend/apps/layout/page-layouts",
- "developers/extend/apps/layout/front-components",
- "developers/extend/apps/layout/command-menu-items"
+ "l/it/developers/extend/apps/layout/overview",
+ "l/it/developers/extend/apps/layout/views",
+ "l/it/developers/extend/apps/layout/navigation-menu-items",
+ "l/it/developers/extend/apps/layout/page-layouts",
+ "l/it/developers/extend/apps/layout/front-components",
+ "l/it/developers/extend/apps/layout/command-menu-items"
]
},
{
- "group": "Operations",
+ "group": "Operazioni",
"pages": [
- "developers/extend/apps/operations/overview",
- "developers/extend/apps/operations/cli",
- "developers/extend/apps/operations/sync-and-recovery",
- "developers/extend/apps/operations/testing",
- "developers/extend/apps/operations/publishing"
+ "l/it/developers/extend/apps/operations/overview",
+ "l/it/developers/extend/apps/operations/cli",
+ "l/it/developers/extend/apps/operations/sync-and-recovery",
+ "l/it/developers/extend/apps/operations/testing",
+ "l/it/developers/extend/apps/operations/publishing"
]
}
]
@@ -3500,10 +3500,10 @@
"language": "ko",
"tabs": [
{
- "tab": "Getting Started",
+ "tab": "시작하기",
"groups": [
{
- "group": "Welcome",
+ "group": "환영합니다",
"pages": [
"getting-started/introduction",
"getting-started/key-features",
@@ -3511,7 +3511,7 @@
]
},
{
- "group": "Core Concepts",
+ "group": "핵심 개념",
"pages": [
"getting-started/core-concepts/data-model",
"getting-started/core-concepts/layout",
@@ -3529,7 +3529,7 @@
"tab": "사용자 안내서",
"groups": [
{
- "group": "Overview",
+ "group": "개요",
"pages": [
"l/ko/user-guide/introduction"
]
@@ -3540,7 +3540,7 @@
"pages": [
"l/ko/user-guide/data-model/overview",
{
- "group": "Reference",
+ "group": "참고",
"pages": [
"l/ko/user-guide/data-model/capabilities/objects",
"l/ko/user-guide/data-model/capabilities/fields",
@@ -3566,7 +3566,7 @@
"pages": [
"l/ko/user-guide/data-migration/overview",
{
- "group": "Reference",
+ "group": "참고",
"pages": [
"l/ko/user-guide/data-migration/capabilities/file-formats",
"l/ko/user-guide/data-migration/capabilities/field-mapping",
@@ -3598,7 +3598,7 @@
"pages": [
"l/ko/user-guide/calendar-emails/overview",
{
- "group": "Reference",
+ "group": "참고",
"pages": [
"l/ko/user-guide/calendar-emails/capabilities/mailbox",
"l/ko/user-guide/calendar-emails/capabilities/calendar"
@@ -3623,7 +3623,7 @@
"pages": [
"l/ko/user-guide/workflows/overview",
{
- "group": "Reference",
+ "group": "참고",
"pages": [
"l/ko/user-guide/workflows/capabilities/workflow-triggers",
"l/ko/user-guide/workflows/capabilities/workflow-actions",
@@ -3649,7 +3649,7 @@
"l/ko/user-guide/workflows/how-tos/crm-automations/display-related-record-data",
"l/ko/user-guide/workflows/how-tos/crm-automations/closed-won-automations",
"l/ko/user-guide/workflows/how-tos/crm-automations/detect-stale-opportunities",
- "user-guide/workflows/how-tos/crm-automations/auto-reply-to-inbound-emails"
+ "l/ko/user-guide/workflows/how-tos/crm-automations/auto-reply-to-inbound-emails"
]
},
{
@@ -3686,7 +3686,7 @@
"pages": [
"l/ko/user-guide/ai/overview",
{
- "group": "Reference",
+ "group": "참고",
"pages": [
"l/ko/user-guide/ai/capabilities/ai-chatbot",
"l/ko/user-guide/ai/capabilities/ai-agents",
@@ -3702,16 +3702,16 @@
]
},
{
- "group": "Layout",
+ "group": "레이아웃",
"icon": "table-columns",
"pages": [
- "user-guide/layout/overview",
+ "l/ko/user-guide/layout/overview",
{
- "group": "Reference",
+ "group": "참고",
"pages": [
- "user-guide/layout/capabilities/navigation",
+ "l/ko/user-guide/layout/capabilities/navigation",
{
- "group": "Views",
+ "group": "보기",
"pages": [
"l/ko/user-guide/views-pipelines/capabilities/table-views",
"l/ko/user-guide/views-pipelines/capabilities/kanban-views",
@@ -3721,11 +3721,11 @@
"l/ko/user-guide/views-pipelines/capabilities/view-settings"
]
},
- "user-guide/layout/capabilities/record-pages"
+ "l/ko/user-guide/layout/capabilities/record-pages"
]
},
{
- "group": "How-Tos",
+ "group": "사용 방법",
"pages": [
"l/ko/user-guide/views-pipelines/how-tos/create-a-table-view-with-grouping",
"l/ko/user-guide/views-pipelines/how-tos/create-a-kanban-view-for-projects",
@@ -3744,7 +3744,7 @@
"pages": [
"l/ko/user-guide/dashboards/overview",
{
- "group": "Reference",
+ "group": "참고",
"pages": [
"l/ko/user-guide/dashboards/capabilities/dashboards",
"l/ko/user-guide/dashboards/capabilities/widgets",
@@ -3766,7 +3766,7 @@
"pages": [
"l/ko/user-guide/permissions-access/overview",
{
- "group": "Reference",
+ "group": "참고",
"pages": [
"l/ko/user-guide/permissions-access/capabilities/permissions",
"l/ko/user-guide/permissions-access/capabilities/sso-configuration"
@@ -3786,7 +3786,7 @@
"pages": [
"l/ko/user-guide/billing/overview",
{
- "group": "Reference",
+ "group": "참고",
"pages": [
"l/ko/user-guide/billing/capabilities/pricing-plans",
"l/ko/user-guide/billing/capabilities/credits"
@@ -3806,7 +3806,7 @@
"pages": [
"l/ko/user-guide/settings/overview",
{
- "group": "Reference",
+ "group": "참고",
"pages": [
"l/ko/user-guide/settings/capabilities/workspace-settings",
"l/ko/user-guide/settings/capabilities/member-management",
@@ -3830,72 +3830,72 @@
"tab": "개발자",
"groups": [
{
- "group": "Overview",
+ "group": "개요",
"pages": [
"l/ko/developers/introduction"
]
},
{
- "group": "Apps",
+ "group": "앱",
"pages": [
{
- "group": "Getting Started",
+ "group": "시작하기",
"pages": [
- "developers/extend/apps/getting-started/quick-start",
- "developers/extend/apps/getting-started/concepts",
- "developers/extend/apps/getting-started/project-structure",
- "developers/extend/apps/getting-started/local-server",
- "developers/extend/apps/getting-started/scaffolding",
- "developers/extend/apps/getting-started/troubleshooting"
+ "l/ko/developers/extend/apps/getting-started/quick-start",
+ "l/ko/developers/extend/apps/getting-started/concepts",
+ "l/ko/developers/extend/apps/getting-started/project-structure",
+ "l/ko/developers/extend/apps/getting-started/local-server",
+ "l/ko/developers/extend/apps/getting-started/scaffolding",
+ "l/ko/developers/extend/apps/getting-started/troubleshooting"
]
},
{
- "group": "Config",
+ "group": "설정",
"pages": [
- "developers/extend/apps/config/overview",
- "developers/extend/apps/config/application",
- "developers/extend/apps/config/roles",
- "developers/extend/apps/config/install-hooks",
- "developers/extend/apps/config/public-assets"
+ "l/ko/developers/extend/apps/config/overview",
+ "l/ko/developers/extend/apps/config/application",
+ "l/ko/developers/extend/apps/config/roles",
+ "l/ko/developers/extend/apps/config/install-hooks",
+ "l/ko/developers/extend/apps/config/public-assets"
]
},
{
- "group": "Data",
+ "group": "데이터",
"pages": [
- "developers/extend/apps/data/overview",
- "developers/extend/apps/data/objects",
- "developers/extend/apps/data/extending-objects",
- "developers/extend/apps/data/relations"
+ "l/ko/developers/extend/apps/data/overview",
+ "l/ko/developers/extend/apps/data/objects",
+ "l/ko/developers/extend/apps/data/extending-objects",
+ "l/ko/developers/extend/apps/data/relations"
]
},
{
- "group": "Logic",
+ "group": "로직",
"pages": [
- "developers/extend/apps/logic/overview",
- "developers/extend/apps/logic/logic-functions",
- "developers/extend/apps/logic/skills-and-agents",
- "developers/extend/apps/logic/connections"
+ "l/ko/developers/extend/apps/logic/overview",
+ "l/ko/developers/extend/apps/logic/logic-functions",
+ "l/ko/developers/extend/apps/logic/skills-and-agents",
+ "l/ko/developers/extend/apps/logic/connections"
]
},
{
- "group": "Layout",
+ "group": "레이아웃",
"pages": [
- "developers/extend/apps/layout/overview",
- "developers/extend/apps/layout/views",
- "developers/extend/apps/layout/navigation-menu-items",
- "developers/extend/apps/layout/page-layouts",
- "developers/extend/apps/layout/front-components",
- "developers/extend/apps/layout/command-menu-items"
+ "l/ko/developers/extend/apps/layout/overview",
+ "l/ko/developers/extend/apps/layout/views",
+ "l/ko/developers/extend/apps/layout/navigation-menu-items",
+ "l/ko/developers/extend/apps/layout/page-layouts",
+ "l/ko/developers/extend/apps/layout/front-components",
+ "l/ko/developers/extend/apps/layout/command-menu-items"
]
},
{
- "group": "Operations",
+ "group": "작업",
"pages": [
- "developers/extend/apps/operations/overview",
- "developers/extend/apps/operations/cli",
- "developers/extend/apps/operations/sync-and-recovery",
- "developers/extend/apps/operations/testing",
- "developers/extend/apps/operations/publishing"
+ "l/ko/developers/extend/apps/operations/overview",
+ "l/ko/developers/extend/apps/operations/cli",
+ "l/ko/developers/extend/apps/operations/sync-and-recovery",
+ "l/ko/developers/extend/apps/operations/testing",
+ "l/ko/developers/extend/apps/operations/publishing"
]
}
]
@@ -3903,9 +3903,9 @@
{
"group": "API",
"pages": [
- "developers/extend/api",
- "developers/extend/webhooks",
- "developers/extend/oauth"
+ "l/ko/developers/extend/api",
+ "l/ko/developers/extend/webhooks",
+ "l/ko/developers/extend/oauth"
]
},
{
@@ -3921,8 +3921,8 @@
"group": "기여",
"pages": [
"l/ko/developers/contribute/capabilities/local-setup",
- "developers/contribute/commands",
- "developers/contribute/style-guide"
+ "l/ko/developers/contribute/commands",
+ "l/ko/developers/contribute/style-guide"
]
}
]
diff --git a/packages/twenty-docs/l/ar/developers/extend/api.mdx b/packages/twenty-docs/l/ar/developers/extend/api.mdx
index c93c47e27de..5f1f6dc6baf 100644
--- a/packages/twenty-docs/l/ar/developers/extend/api.mdx
+++ b/packages/twenty-docs/l/ar/developers/extend/api.mdx
@@ -37,7 +37,7 @@ import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
Authorization: Bearer YOUR_API_KEY
```
-أنشئ مفتاح API من **الإعدادات → واجهات برمجة التطبيقات وخطافات الويب → + Create key**. انسخه فورًا — يُعرَض مرة واحدة فقط. يمكن تقييد نطاق المفاتيح بدور محدد ضمن **الإعدادات → الأدوار → علامة التبويب Assignment** للحد مما يمكنها الوصول إليه.
+أنشئ مفتاح API من **الإعدادات → واجهات برمجة التطبيقات وخطافات الويب → + Create key**. انسخه فورًا — يُعرَض مرة واحدة فقط. يمكن تقييد نطاق المفاتيح بدور محدد ضمن **الإعدادات → الأعضاء → الأدوار → علامة التبويب Assignment** للحد مما يمكنها الوصول إليه.
<VimeoEmbed videoId="928786722" title="إنشاء مفتاح API" />
diff --git a/packages/twenty-docs/l/ar/developers/extend/apps/config/application.mdx b/packages/twenty-docs/l/ar/developers/extend/apps/config/application.mdx
new file mode 100644
index 00000000000..553739b0fc6
--- /dev/null
+++ b/packages/twenty-docs/l/ar/developers/extend/apps/config/application.mdx
@@ -0,0 +1,64 @@
+---
+title: تكوين التطبيق
+description: عرّف هوية تطبيقك، والدور الافتراضي، والمتغيرات، وبيانات التعريف لسوق التطبيقات باستخدام defineApplication.
+icon: rocket
+---
+
+يجب أن يحتوي كل تطبيق على استدعاء واحد فقط لـ `defineApplication`. يحدّد ما يلي:
+
+* **الهوية** — المعرّف الشامل، واسم العرض، والوصف.
+* **الأذونات** — الدور الذي تعمل بموجبه دوال المنطق والمكوّنات الأمامية الخاصة به.
+* **المتغيرات** *(اختياري)* — أزواج مفتاح–قيمة تُتاح لكودك كمتغيرات بيئة.
+* **خطافات ما قبل التثبيت/ما بعد التثبيت** *(اختياري)* — راجع [Logic Functions](/l/ar/developers/extend/apps/logic/logic-functions).
+
+```ts src/application-config.ts
+import { defineApplication } from 'twenty-sdk/define';
+
+export default defineApplication({
+ universalIdentifier: '39783023-bcac-41e3-b0d2-ff1944d8465d',
+ displayName: 'My Twenty App',
+ description: 'My first Twenty app',
+ applicationVariables: {
+ DEFAULT_RECIPIENT_NAME: {
+ universalIdentifier: '19e94e59-d4fe-4251-8981-b96d0a9f74de',
+ description: 'Default recipient name for postcards',
+ value: 'Jane Doe',
+ isSecret: false,
+ },
+ },
+});
+```
+
+الملاحظات:
+
+* حقول `universalIdentifier` هي معرّفات حتمية تملكها أنت. أنشِئها مرة واحدة واحتفظ بها ثابتة عبر عمليات المزامنة.
+* `applicationVariables` تصبح متغيرات بيئة لوظائفك ومكوّناتك الأمامية. في وظائف المنطق (على جانب الخادم)، تكون متاحة على شكل `process.env.VARIABLE_NAME`. في المكوّنات الأمامية، استخدم `getApplicationVariable('VARIABLE_NAME')` من `twenty-sdk/front-component`. يتم حقن المتغيّرات المعلَّمة بـ `isSecret: true` في وظائف المنطق فقط. المكوّنات الأمامية تتلقّى المتغيّرات غير السرّية فقط.
+* يتم اكتشاف الدور الافتراضي تلقائيًا من ملف الدور المميز بـ [`defineApplicationRole()`](/l/ar/developers/extend/apps/config/roles) — لست بحاجة إلى الإشارة إليه من `defineApplication()`.
+* يتم اكتشاف دوال ما قبل التثبيت وما بعده تلقائيًا أثناء بناء البيان — لا حاجة للإشارة إليها في `defineApplication()`.
+* لا يزال تمرير `defaultRoleUniversalIdentifier` بشكل صريح مدعومًا من أجل التوافق مع الإصدارات السابقة، ولكنه مُهمل لصالح `defineApplicationRole()`.
+
+## الدور الافتراضي للوظيفة
+
+يتحكم الدور المعلن باستخدام [`defineApplicationRole()`](/l/ar/developers/extend/apps/config/roles) في ما يمكن لوظائف منطق التطبيق ومكوّنات الواجهة الوصول إليه:
+
+* رمز وقت التشغيل المحقون باسم `TWENTY_APP_ACCESS_TOKEN` مستمد من هذا الدور.
+* يكون عميل واجهة برمجة التطبيقات مضبوط الأنواع مقيّدًا بالأذونات الممنوحة لذلك الدور.
+* اتبع مبدأ أقل امتياز: صرّح فقط عن الأذونات التي تحتاجها دوالك.
+
+عند إنشاء هيكل لتطبيق جديد، ينشئ CLI ملف دور مبدئي في `src/roles/default-role.ts`. راجع [Roles & Permissions](/l/ar/developers/extend/apps/config/roles) للاطلاع على المرجع الكامل.
+
+## بيانات التعريف لسوق التطبيقات
+
+إذا كنت تخطط لـ [نشر تطبيقك](/l/ar/developers/extend/apps/operations/publishing)، فإن هذه الحقول الاختيارية تتحكّم في كيفية ظهوره في السوق:
+
+| الحقل | الوصف |
+| ------------------ | ------------------------------------------------------------------------------------------------------------ |
+| `author` | اسم المؤلف أو الشركة |
+| `category` | فئة التطبيق لتصفية سوق التطبيقات |
+| `logoUrl` | مسار شعار تطبيقك (مثلًا، `public/logo.png`) |
+| `screenshots` | مصفوفة لمسارات لقطات الشاشة (مثلًا، `public/screenshot-1.png`) |
+| `aboutDescription` | وصف ماركداون أطول لعلامة التبويب "حول". إذا لم يتم تضمينه، يستخدم السوق ملف `README.md` الخاص بالحزمة من npm |
+| `websiteUrl` | رابط إلى موقعك الإلكتروني |
+| `termsUrl` | رابط إلى شروط الخدمة |
+| `emailSupport` | عنوان البريد الإلكتروني للدعم |
+| `issueReportUrl` | رابط إلى متتبّع المشاكل |
diff --git a/packages/twenty-docs/l/ar/developers/extend/apps/config/install-hooks.mdx b/packages/twenty-docs/l/ar/developers/extend/apps/config/install-hooks.mdx
new file mode 100644
index 00000000000..58a76268bb4
--- /dev/null
+++ b/packages/twenty-docs/l/ar/developers/extend/apps/config/install-hooks.mdx
@@ -0,0 +1,206 @@
+---
+title: خطافات التثبيت
+description: شغّل منطقًا قبل التثبيت أو بعده — لتهيئة البيانات، أو نسخ السجلات احتياطيًا، أو التحقّق من صحة الترقية.
+icon: wrench
+---
+
+خطافات التثبيت هي دوال منطقية خاصة تعمل أثناء دورة حياة التثبيت أو الترقية. تستخدم نفس وقت تشغيل المعالج مثل [دوال المنطق](/l/ar/developers/extend/apps/logic/logic-functions) العادية وتتلقى `InstallPayload`، ولكن يتم التصريح عنها بدوال تعريف خاصة بها — `definePostInstallLogicFunction()` و`definePreInstallLogicFunction()` — وتعمل خارج نموذج المشغّل المعتاد (HTTP، وcron، وأحداث قاعدة البيانات).
+
+يمكن لكل تطبيق تعريف دالة واحدة على الأكثر لما قبل التثبيت ودالة واحدة على الأكثر لما بعد التثبيت. سيُنتِج إنشاء ملف البيان خطأً إذا تم اكتشاف أكثر من واحدة من أيٍّ منهما.
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│ install flow │
+│ │
+│ upload package → [pre-install] → metadata migration → │
+│ generate SDK → [post-install] │
+│ │
+│ old schema visible new schema visible │
+└─────────────────────────────────────────────────────────────┘
+```
+
+<AccordionGroup>
+<Accordion title="definePostInstallLogicFunction" description="تعمل بعد تطبيق ترحيل البيانات الوصفية لمساحة العمل">
+
+تعمل دالة ما بعد التثبيت تلقائيًا بمجرد انتهاء تثبيت تطبيقك على مساحة عمل. ينفّذه الخادم **بعد** مزامنة البيانات الوصفية للتطبيق وإنشاء عميل SDK، بحيث تكون مساحة العمل جاهزة تمامًا للاستخدام ويكون المخطط الجديد مطبَّقًا. تشمل حالات الاستخدام النموذجية تهيئة البيانات الافتراضية، وإنشاء السجلات الأولية، وتكوين إعدادات مساحة العمل، أو توفير الموارد على خدمات جهات خارجية.
+
+```ts src/logic-functions/post-install.ts
+import { definePostInstallLogicFunction, type InstallPayload } from 'twenty-sdk/define';
+
+const handler = async (payload: InstallPayload): Promise<void> => {
+ console.log('Post install logic function executed successfully!', payload.previousVersion);
+};
+
+export default definePostInstallLogicFunction({
+ universalIdentifier: 'f7a2b9c1-3d4e-5678-abcd-ef9876543210',
+ name: 'post-install',
+ description: 'Runs after installation to set up the application.',
+ timeoutSeconds: 300,
+ shouldRunOnVersionUpgrade: false,
+ shouldRunSynchronously: false,
+ handler,
+});
+```
+
+يمكنك أيضًا تنفيذ دالة ما بعد التثبيت يدويًا في أي وقت باستخدام CLI:
+
+```bash filename="Terminal"
+yarn twenty dev:function:exec --postInstall
+```
+
+النقاط الرئيسية:
+* تستخدم دوال ما بعد التثبيت `definePostInstallLogicFunction()` — إصدارًا متخصصًا يستبعد إعدادات المُشغِّل (`cronTriggerSettings` و`databaseEventTriggerSettings` و`httpRouteTriggerSettings` و`toolTriggerSettings` و`workflowActionTriggerSettings`).
+* يتلقى المعالج `InstallPayload` يحتوي على `{ previousVersion?: string; newVersion: string }` — حيث إن `newVersion` هو الإصدار الجاري تثبيته، و`previousVersion` هو الإصدار الذي كان مُثبّتًا سابقًا (أو `undefined` عند التثبيت الأولي). استخدم هذه القيم للتمييز بين عمليات التثبيت الجديدة والترقيات ولتشغيل منطق الترحيل الخاص بالإصدار.
+* **موعد تشغيل الخطاف**: في عمليات التثبيت الجديدة فقط، افتراضيًا. مرّر `shouldRunOnVersionUpgrade: true` إذا كنت تريد تشغيله أيضًا عند ترقية التطبيق من إصدار سابق. عند إغفاله، تكون القيمة الافتراضية للعلم `false`، وتتجاوز الترقيات هذا الخطاف.
+* **نموذج التنفيذ — غير متزامن افتراضيًا، والتزامني اختياري**: يتحكّم العلم `shouldRunSynchronously` في كيفية تنفيذ ما بعد التثبيت.
+ * `shouldRunSynchronously: false` *(الإعداد الافتراضي)* — يتم **إدراج الخطاف في قائمة الرسائل** مع `retryLimit: 3` ويعمل بشكل غير متزامن داخل عامل عمل. يعود ردّ التثبيت بمجرد وضع المهمة في الطابور، لذا فإن معالجًا بطيئًا أو متعطلًا لا يحجب المستدعي. سيُجرِّب العامل إعادة المحاولة حتى ثلاث مرات. **استخدم هذا للمهام طويلة التشغيل** — بَذر مجموعات بيانات كبيرة، استدعاء واجهات برمجة تطبيقات خارجية بطيئة، تهيئة موارد خارجية، أو أي شيء قد يتجاوز نافذة استجابة HTTP المعقولة.
+ * `shouldRunSynchronously: true` — يُنفّذ الخطاف **ضمن تدفّق التثبيت مباشرةً** (نفس المنفِّذ كما قبل التثبيت). يَحجُب طلب التثبيت حتى ينتهي المعالج، وإذا رمى استثناءً، سيتلقى مستدعي التثبيت `POST_INSTALL_ERROR`. لا توجد محاولات إعادة تلقائية. **استخدم هذا للمهام السريعة التي يجب إكمالها قبل الاستجابة** — مثل إظهار خطأ تحقق للمستخدم، أو إعداد سريع سيعتمد عليه العميل مباشرةً بعد عودة نداء التثبيت. ضع في اعتبارك أن ترحيل البيانات الوصفية يكون قد طُبِّق بالفعل عند تشغيل ما بعد التثبيت، لذلك فإن فشل الوضع المتزامن **لا** يعيد التغييرات على المخطط إلى الوراء — بل يكتفي بإبراز الخطأ.
+* تأكّد من أن معالجك قابل للتنفيذ المتكرر دون آثار جانبية. في الوضع غير المتزامن قد تُعيد قائمة الانتظار المحاولة حتى ثلاث مرات؛ وفي أي من الوضعين قد يعمل الخطاف مجددًا أثناء الترقيات عند ضبط `shouldRunOnVersionUpgrade: true`.
+* متغيرات البيئة `APPLICATION_ID` و`APP_ACCESS_TOKEN` و`API_URL` متاحة داخل المعالج (كما في أي دالة منطق أخرى)، لذا يمكنك استدعاء واجهة Twenty API باستخدام رمز وصول للتطبيق مقيّد بنطاق تطبيقك.
+* يُسمح بدالة ما بعد التثبيت واحدة فقط لكل تطبيق. سيُنتج إنشاء ملف البيان خطأً إذا تم اكتشاف أكثر من واحدة.
+* تُرفَق خصائص الدالة `universalIdentifier` و`shouldRunOnVersionUpgrade` و`shouldRunSynchronously` تلقائيًا ببيان التطبيق ضمن الحقل `postInstallLogicFunction` أثناء عملية البناء — ولا تحتاج إلى الإشارة إليها في [`defineApplication()`](/l/ar/developers/extend/apps/config/application).
+* تم تعيين مهلة افتراضية إلى 300 ثانية (5 دقائق) للسماح بمهام الإعداد الأطول مثل تهيئة البيانات.
+* **لا يُنفَّذ في وضع التطوير**: عند تسجيل تطبيق محليًا (عبر `yarn twenty dev`)، يتجاوز الخادم تدفّق التثبيت بالكامل ويُزامن الملفات مباشرةً عبر مراقِب CLI — لذا لن يعمل ما بعد التثبيت في وضع التطوير مطلقًا، بغضّ النظر عن `shouldRunSynchronously`. استخدم `yarn twenty dev:function:exec --postInstall` لتشغيله يدويًا على مساحة عمل قيد التشغيل.
+
+</Accordion>
+<Accordion title="definePreInstallLogicFunction" description="تعمل قبل تطبيق ترحيل البيانات الوصفية لمساحة العمل">
+
+تعمل دالة ما قبل التثبيت تلقائيًا أثناء التثبيت، **قبل تطبيق ترحيل البيانات الوصفية لمساحة العمل**. تتشارك نفس بنية الحمولة مع ما بعد التثبيت (`InstallPayload`)، لكنها موضوعة أبكر في تدفّق التثبيت كي تجهّز حالة يعتمد عليها الترحيل القادم — ومن الاستخدامات الشائعة: نسخ البيانات احتياطيًا، التحقق من التوافق مع المخطط الجديد، أو أرشفة السجلات التي ستُعاد هيكلتها أو ستُحذف.
+
+```ts src/logic-functions/pre-install.ts
+import { definePreInstallLogicFunction, type InstallPayload } from 'twenty-sdk/define';
+
+const handler = async (payload: InstallPayload): Promise<void> => {
+ console.log('Pre install logic function executed successfully!', payload.previousVersion);
+};
+
+export default definePreInstallLogicFunction({
+ universalIdentifier: 'a1b2c3d4-5678-90ab-cdef-1234567890ab',
+ name: 'pre-install',
+ description: 'Runs before installation to prepare the application.',
+ timeoutSeconds: 300,
+ shouldRunOnVersionUpgrade: true,
+ handler,
+});
+```
+
+يمكنك أيضًا تنفيذ دالة ما قبل التثبيت يدويًا في أي وقت باستخدام CLI:
+
+```bash filename="Terminal"
+yarn twenty dev:function:exec --preInstall
+```
+
+النقاط الرئيسية:
+* تستخدم دوال ما قبل التثبيت `definePreInstallLogicFunction()` — نفس الإعدادات المتخصصة كما في ما بعد التثبيت، لكنها مرتبطة بموضع مختلف ضمن دورة الحياة.
+* يتلقّى كلٌّ من معالجي ما قبل التثبيت وما بعد التثبيت النوع نفسه `InstallPayload`: `{ previousVersion?: string; newVersion: string }`. استورده مرة واحدة وأعد استخدامه لكلا الخطافين.
+* **موعد تشغيل الخطاف**: موضوع مباشرةً قبل ترحيل البيانات الوصفية لمساحة العمل (`synchronizeFromManifest`). قبل التنفيذ، يُشغِّل الخادم مزامنة "pared-down sync" ذات طابع إضافي فقط تقوم بتسجيل دالة ما قبل التثبيت للإصدار **الجديد** في البيانات الوصفية لمساحة العمل — دون لمس أي شيء آخر — ثم يُنفّذها. لأن هذه المزامنة «إضافية فقط»، تبقى كائنات وحقول وبيانات الإصدار السابق سليمة عند تشغيل معالجك: يمكنك قراءة حالة ما قبل الترحيل ونسخها احتياطيًا بأمان.
+* **نموذج التنفيذ**: يُنفَّذ ما قبل التثبيت **بشكل متزامن** و**يحجب عملية التثبيت**. إذا رمى المعالج استثناءً، تُلغى عملية التثبيت قبل تطبيق أي تغييرات على المخطط — وتبقى مساحة العمل على الإصدار السابق بحالة متّسقة. هذا مقصود: ما قبل التثبيت هو فرصتك الأخيرة لرفض ترقية تنطوي على مخاطر.
+* كما هو الحال مع ما بعد التثبيت، يُسمح بدالة ما قبل التثبيت واحدة فقط لكل تطبيق. تُربَط تلقائيًا ببيان التطبيق تحت `preInstallLogicFunction` أثناء عملية البناء.
+* **لا يُنفَّذ في وضع التطوير**: كما في ما بعد التثبيت — يتم تجاوز تدفّق التثبيت بالكامل للتطبيقات المسجّلة محليًا، لذا لن يعمل ما قبل التثبيت مطلقًا عند `yarn twenty dev`. استخدم `yarn twenty dev:function:exec --preInstall` لتشغيله يدويًا.
+
+</Accordion>
+<Accordion title="ما قبل التثبيت مقابل ما بعد التثبيت: متى تستخدم أيّهما" description="اختيار خطاف التثبيت المناسب">
+
+كلا الخطافين جزء من تدفّق التثبيت نفسه ويتلقّيان نفس `InstallPayload`. الاختلاف يكمن في **موعد** تشغيلهما نسبةً إلى ترحيل البيانات الوصفية لمساحة العمل، وهذا يغيّر البيانات التي يمكنهما التعامل معها بأمان.
+
+ما قبل التثبيت دائمًا **متزامن** (يحجب التثبيت ويمكنه إحباطه). ما بعد التثبيت **غير متزامن افتراضيًا** — يُدرج على عامل مع محاولات إعادة تلقائية — لكن يمكن التبديل إلى تنفيذ متزامن عبر `shouldRunSynchronously: true`. راجع الأكورديون `definePostInstallLogicFunction` أعلاه لمعرفة متى تستخدم كل وضع.
+
+**استخدم `post-install` لأي شيء يتطلّب وجود المخطط الجديد.** وهذا هو السيناريو الشائع:
+
+* بَذر بيانات افتراضية (إنشاء سجلات أولية وعروض افتراضية ومحتوى تجريبي) للكائنات والحقول المضافة حديثًا.
+* تسجيل خطافات الويب مع خدمات أطراف ثالثة بعد أن حصل التطبيق على بيانات الاعتماد الخاصة به.
+* استدعاء واجهة برمجة التطبيقات الخاصة بك لإكمال إعداد يعتمد على البيانات الوصفية المتزامنة.
+* منطق قابل للتنفيذ المتكرر دون آثار جانبية لتحقيق "تأكّد من وجود هذا" والذي ينبغي مواءمة الحالة في كل ترقية — بالاقتران مع `shouldRunOnVersionUpgrade: true`.
+
+مثال — بَذر سجل `PostCard` افتراضي بعد التثبيت:
+
+```ts src/logic-functions/post-install.ts
+import { definePostInstallLogicFunction, type InstallPayload } from 'twenty-sdk/define';
+import { createClient } from './generated/client';
+
+const handler = async ({ previousVersion }: InstallPayload): Promise<void> => {
+ if (previousVersion) return; // fresh installs only
+
+ const client = createClient();
+ await client.postCard.create({
+ data: { title: 'Welcome to Postcard', content: 'Your first card!' },
+ });
+};
+
+export default definePostInstallLogicFunction({
+ universalIdentifier: 'f7a2b9c1-3d4e-5678-abcd-ef9876543210',
+ name: 'post-install',
+ description: 'Seeds a welcome post card after install.',
+ timeoutSeconds: 300,
+ shouldRunOnVersionUpgrade: false,
+ handler,
+});
+```
+
+**استخدم `pre-install` عندما قد يُتلف الترحيل أو يدمّر البيانات الحالية.** لأن ما قبل التثبيت يعمل مقابل المخطط *السابق* وفشله يُرجِع الترقية إلى الوراء، فهو المكان المناسب لأي شيء محفوف بالمخاطر:
+
+* **نسخ البيانات احتياطيًا قبل حذفها أو إعادة هيكلتها** — مثل إزالة حقل في v2 وتحتاج إلى نسخ قيمه إلى حقل آخر أو تصديرها إلى التخزين قبل تشغيل الترحيل.
+* **أرشفة السجلات التي سيبطلها قيد جديد** — مثل أن يصبح حقل ما `NOT NULL` وتحتاج أولًا إلى حذف الصفوف ذات القيم الفارغة أو إصلاحها.
+* **التحقق من التوافق ورفض الترقية إذا تعذّر ترحيل البيانات الحالية بسلاسة** — ارمِ من داخل المعالج وسيُلغى التثبيت دون تطبيق أي تغييرات. هذا أكثر أمانًا من اكتشاف عدم التوافق في منتصف الترحيل.
+* **إعادة تسمية البيانات أو إعادة تعيين مفاتيحها** قبل تغيير في المخطط قد يؤدي إلى فقدان الارتباط.
+
+مثال — أرشف السجلات قبل ترحيل هدّام:
+
+```ts src/logic-functions/pre-install.ts
+import { definePreInstallLogicFunction, type InstallPayload } from 'twenty-sdk/define';
+import { createClient } from './generated/client';
+
+const handler = async ({ previousVersion, newVersion }: InstallPayload): Promise<void> => {
+ // Only the 1.x → 2.x upgrade drops the legacy `notes` field.
+ if (!previousVersion?.startsWith('1.') || !newVersion.startsWith('2.')) {
+ return;
+ }
+
+ const client = createClient();
+ const legacyRecords = await client.postCard.findMany({
+ where: { notes: { isNotNull: true } },
+ });
+
+ if (legacyRecords.length === 0) return;
+
+ // Copy legacy `notes` into the new `description` field before the migration
+ // drops the `notes` column. If this fails, the upgrade is aborted and the
+ // workspace stays on v1 with all data intact.
+ await Promise.all(
+ legacyRecords.map((record) =>
+ client.postCard.update({
+ where: { id: record.id },
+ data: { description: record.notes },
+ }),
+ ),
+ );
+};
+
+export default definePreInstallLogicFunction({
+ universalIdentifier: 'a1b2c3d4-5678-90ab-cdef-1234567890ab',
+ name: 'pre-install',
+ description: 'Backs up legacy notes into description before the v2 migration.',
+ timeoutSeconds: 300,
+ shouldRunOnVersionUpgrade: true,
+ handler,
+});
+```
+
+**قاعدة عامة:**
+
+| ترغب في... | استخدام |
+| ------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------ |
+| بذر بيانات افتراضية، تهيئة مساحة العمل، تسجيل موارد خارجية | `post-install` |
+| تشغيل بذر طويل الأمد أو استدعاءات أطراف ثالثة لا ينبغي أن تحجب استجابة التثبيت | `post-install` (الإعداد الافتراضي — `shouldRunSynchronously: false`، مع محاولات إعادة من العامل) |
+| تشغيل إعداد سريع سيعتمد عليه المستدعي مباشرةً بعد عودة نداء التثبيت | `post-install` مع `shouldRunSynchronously: true` |
+| قراءة البيانات أو نسخها احتياطيًا والتي قد يفقدها الترحيل القادم | `pre-install` |
+| رفض ترقية قد تُفسد البيانات الحالية | `pre-install` (ارمِ من المعالج) |
+| تنفيذ مواءمة في كل ترقية | `post-install` مع `shouldRunOnVersionUpgrade: true` |
+| تنفيذ إعداد لمرة واحدة في التثبيت الأول فقط | `post-install` مع `shouldRunOnVersionUpgrade: false` (الإعداد الافتراضي) |
+
+<Note>
+إذا ساورك الشك، فاجعل الافتراضي هو **post-install**. الجأ إلى ما قبل التثبيت فقط عندما يكون الترحيل نفسه هدّامًا وتحتاج إلى التقاط الحالة السابقة قبل أن تزول.
+</Note>
+
+</Accordion>
+</AccordionGroup>
diff --git a/packages/twenty-docs/l/ar/developers/extend/apps/config/overview.mdx b/packages/twenty-docs/l/ar/developers/extend/apps/config/overview.mdx
new file mode 100644
index 00000000000..651fb951886
--- /dev/null
+++ b/packages/twenty-docs/l/ar/developers/extend/apps/config/overview.mdx
@@ -0,0 +1,51 @@
+---
+title: نظرة عامة
+description: قم بتهيئة التطبيق نفسه — هويته، والأذونات الافتراضية، وما الذي يعمل في وقت التثبيت.
+icon: screwdriver-wrench
+---
+
+طبقة **الإعدادات (config layer)** لتطبيق Twenty هي ما يصف التطبيق *للمنصة* — هويته، والأذونات التي يمتلكها، والكود الذي يعمل أثناء التثبيت أو الترقية. هذه التصريحات لا تضيف أشكال بيانات جديدة أو سلوكًا وقت التشغيل؛ بل تخبر Twenty *من هو التطبيق* و*كيفية إعداده*.
+
+```text
+┌────────────────────────────────────────────────────────┐
+│ Application — identity, default role, variables, │
+│ marketplace metadata │
+│ │
+│ ┌──────────────────────────────────────────────────┐ │
+│ │ Role — what the app's logic functions can read │ │
+│ │ and write (referenced by Application) │ │
+│ └──────────────────────────────────────────────────┘ │
+└────────────────────────────────────────────────────────┘
+ │
+ ▼ (at install / upgrade time)
+ ┌──────────────────────────────────┐
+ │ Pre-install hook │ before metadata migration
+ └──────────────────────────────────┘
+ ┌──────────────────────────────────┐
+ │ Post-install hook │ after metadata migration
+ └──────────────────────────────────┘
+```
+
+## في هذا القسم
+
+<CardGroup cols={٢}>
+ <Card title="تكوين التطبيق" icon="rocket" href="/l/ar/developers/extend/apps/config/application">
+ `defineApplication` — الهوية، الدور الافتراضي، المتغيرات، والبيانات الوصفية لسوق التطبيقات.
+ </Card>
+ <Card title="الأدوار والصلاحيات" icon="shield-halved" href="/l/ar/developers/extend/apps/config/roles">
+ `defineRole` — حدِّد ما يمكن لوظائف منطق التطبيق قراءته وكتابته.
+ </Card>
+ <Card title="خطافات التثبيت" icon="wrench" href="/l/ar/developers/extend/apps/config/install-hooks">
+ `definePreInstallLogicFunction` و`definePostInstallLogicFunction` — نسخ البيانات احتياطيًا، تهيئة القيم الافتراضية، والتحقق من صحة الترقيات.
+ </Card>
+</CardGroup>
+
+## كيفية ترابط الأجزاء
+
+* **التطبيق (Application)** هو نقطة الدخول. يحتوي كل تطبيق على استدعاء واحد فقط `defineApplication()`، ويشير إلى **دور (Role)** واحد باعتباره الدور الافتراضي له.
+* يتحكم **الدور** في ما يمكن لوظائف منطق التطبيق ومكوّنات الواجهة الأمامية قراءته وكتابته. اتبع مبدأ أقل امتياز ممكن: امنح فقط الصلاحيات التي يحتاجها الكود فعليًا.
+* تعمل **خطافات التثبيت** أثناء التثبيت أو الترقية — ما قبل التثبيت قبل ترحيل البيانات الوصفية (كي تتمكن من رفض ترقية محفوفة بالمخاطر)، وما بعد التثبيت بعد الترحيل (كي تتمكن من تهيئة بيانات افتراضية وفق المخطط الجديد).
+
+<Note>
+تشارك خطافات التثبيت وقت تشغيل [وظيفة المنطق](/l/ar/developers/extend/apps/logic/logic-functions) — نفس توقيع المعالج (handler signature)، ونفس متغيرات البيئة، ونفس عميل واجهة برمجة التطبيقات (typed API client) — لكنها تُصرّح باستخدام دوال تعريف خاصة بها وتوجد خارج نموذج المشغلات العادي (HTTP، و cron، وأحداث قاعدة البيانات).
+</Note>
diff --git a/packages/twenty-docs/l/ar/developers/extend/apps/config/public-assets.mdx b/packages/twenty-docs/l/ar/developers/extend/apps/config/public-assets.mdx
new file mode 100644
index 00000000000..f1d8e01cff3
--- /dev/null
+++ b/packages/twenty-docs/l/ar/developers/extend/apps/config/public-assets.mdx
@@ -0,0 +1,67 @@
+---
+title: الأصول العامة
+description: وزّع الملفات الثابتة — الصور والأيقونات والخطوط — مع تطبيقك عبر مجلد public/.
+icon: folder-open
+---
+
+يحتوي مجلد `public/` في جذر تطبيقك على ملفات ثابتة — صور وأيقونات وخطوط وأي أصول أخرى يحتاجها تطبيقك وقت التشغيل. تُدرج هذه الملفات تلقائيًا في عمليات البناء، وتُزامَن أثناء وضع التطوير، وتُرفَع إلى الخادم.
+
+الملفات الموضوعة في `public/` هي:
+
+* **متاحة للعامة** — بمجرد مزامنتها إلى الخادم، تُقدَّم الأصول عبر عنوان URL عام. لا حاجة إلى مصادقة للوصول إليها.
+* **متاحة في المكوّنات الأمامية** — استخدم عناوين الأصول لعرض الصور أو الأيقونات أو أي وسائط داخل مكوّنات React لديك.
+* **متاحة في الدوال المنطقية** — أشِر إلى عناوين الأصول في رسائل البريد الإلكتروني أو استجابات واجهات البرمجة أو أي منطق على جهة الخادم.
+* **مستخدمة لبيانات تعريف السوق** — يشير حقلا `logoUrl` و`screenshots` في `defineApplication()` إلى ملفات من هذا المجلد (مثل `public/logo.png`). تُعرَض هذه عند نشر تطبيقك في السوق.
+* **تُزامَن تلقائيًا في وضع التطوير** — عند إضافة ملف في `public/` أو تحديثه أو حذفه، تتم مزامنته إلى الخادم تلقائيًا. لا حاجة لإعادة التشغيل.
+* **مضمَّنة في عمليات البناء** — يقوم `yarn twenty dev:build` بتجميع جميع الأصول العامة ضمن مخرجات التوزيع.
+
+## الوصول إلى الأصول العامة باستخدام `getPublicAssetUrl`
+
+استخدم المساعد `getPublicAssetUrl` من `twenty-sdk` للحصول على العنوان الكامل لملف في دليل `public/` لديك. يعمل ذلك في كلٍ من الدوال المنطقية والمكوّنات الأمامية.
+
+**في دالة منطقية:**
+
+```ts src/logic-functions/send-invoice.ts
+import { defineLogicFunction } from 'twenty-sdk/define';
+import { getPublicAssetUrl } from 'twenty-sdk/utils';
+
+const handler = async (): Promise<any> => {
+ const logoUrl = getPublicAssetUrl('logo.png');
+ const invoiceUrl = getPublicAssetUrl('templates/invoice.png');
+
+ // Fetch the file content (no auth required — public endpoint)
+ const response = await fetch(invoiceUrl);
+ const buffer = await response.arrayBuffer();
+
+ return { logoUrl, size: buffer.byteLength };
+};
+
+export default defineLogicFunction({
+ universalIdentifier: 'a1b2c3d4-...',
+ name: 'send-invoice',
+ description: 'Sends an invoice with the app logo',
+ timeoutSeconds: 10,
+ handler,
+});
+```
+
+**في مكوّن أمامي:**
+
+```tsx src/front-components/company-card.tsx
+import { defineFrontComponent } from 'twenty-sdk/define';
+import { getPublicAssetUrl } from 'twenty-sdk/utils';
+
+const CompanyCard = () => {
+ const logoUrl = getPublicAssetUrl('logo.png');
+
+ return <img src={logoUrl} alt="App logo" />;
+};
+
+export default defineFrontComponent({
+ universalIdentifier: '...',
+ name: 'company-card',
+ component: CompanyCard,
+});
+```
+
+وسيطة `path` نسبية إلى مجلد `public/` الخاص بتطبيقك. كلٌّ من `getPublicAssetUrl('logo.png')` و`getPublicAssetUrl('public/logo.png')` يُحلاّن إلى العنوان نفسه — تتم إزالة بادئة `public/` تلقائيًا إن وُجدت.
diff --git a/packages/twenty-docs/l/ar/developers/extend/apps/config/roles.mdx b/packages/twenty-docs/l/ar/developers/extend/apps/config/roles.mdx
new file mode 100644
index 00000000000..11879785db7
--- /dev/null
+++ b/packages/twenty-docs/l/ar/developers/extend/apps/config/roles.mdx
@@ -0,0 +1,94 @@
+---
+title: الأدوار والصلاحيات
+description: حدِّد الكائنات والحقول التي يمكن لوظائف منطق تطبيقك ومكوّنات الواجهة الأمامية قراءتها وكتابتها.
+icon: shield-halved
+---
+
+**الدور** هو مجموعة من الأذونات: الكائنات التي يمكن لتطبيق ما قراءتها أو كتابتها، والحقول التي يمكنه رؤيتها، والقدرات على مستوى المنصّة التي يمكنه استخدامها. ترث جميع وظائف منطق كل تطبيق ومكوّنات الواجهة الأمامية الأذونات الخاصة بالدور المُعلَّم باستخدام `defineApplicationRole()` (انظر [دور الدالة الافتراضي](#the-default-function-role) أدناه).
+
+```ts src/roles/restricted-company-role.ts
+import {
+ defineRole,
+ STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS,
+ SystemPermissionFlag,
+} from 'twenty-sdk/define';
+
+export default defineRole({
+ universalIdentifier: '2c80f640-2083-4803-bb49-003e38279de6',
+ label: 'My new role',
+ description: 'A role that can be used in your workspace',
+ canReadAllObjectRecords: false,
+ canUpdateAllObjectRecords: false,
+ canSoftDeleteAllObjectRecords: false,
+ canDestroyAllObjectRecords: false,
+ canUpdateAllSettings: false,
+ canBeAssignedToAgents: false,
+ canBeAssignedToUsers: false,
+ canBeAssignedToApiKeys: false,
+ objectPermissions: [
+ {
+ objectUniversalIdentifier:
+ STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS.company.universalIdentifier,
+ canReadObjectRecords: true,
+ canUpdateObjectRecords: true,
+ canSoftDeleteObjectRecords: false,
+ canDestroyObjectRecords: false,
+ },
+ ],
+ fieldPermissions: [
+ {
+ objectUniversalIdentifier:
+ STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS.company.universalIdentifier,
+ fieldUniversalIdentifier:
+ STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS.company.fields.name
+ .universalIdentifier,
+ canReadFieldValue: false,
+ canUpdateFieldValue: false,
+ },
+ ],
+ permissionFlagUniversalIdentifiers: [SystemPermissionFlag.APPLICATIONS],
+});
+```
+
+## الدور الافتراضي للوظيفة
+
+عند إنشاء هيكل لتطبيق جديد، ينشئ CLI ملف دور افتراضي مُصرَّحًا به باستخدام `defineApplicationRole()`:
+
+```ts src/roles/default-role.ts
+import { defineApplicationRole } from 'twenty-sdk/define';
+
+export const DEFAULT_ROLE_UNIVERSAL_IDENTIFIER =
+ 'b648f87b-1d26-4961-b974-0908fd991061';
+
+export default defineApplicationRole({
+ universalIdentifier: DEFAULT_ROLE_UNIVERSAL_IDENTIFIER,
+ label: 'Default function role',
+ description: 'Default role for function Twenty client',
+ canReadAllObjectRecords: true,
+ canUpdateAllObjectRecords: false,
+ canSoftDeleteAllObjectRecords: false,
+ canDestroyAllObjectRecords: false,
+ canUpdateAllSettings: false,
+ canBeAssignedToAgents: false,
+ canBeAssignedToUsers: false,
+ canBeAssignedToApiKeys: false,
+ objectPermissions: [],
+ fieldPermissions: [],
+ permissionFlagUniversalIdentifiers: [],
+});
+```
+
+تُعد `defineApplicationRole()` غلافًا بسيطًا حول `defineRole()` يشير إلى الدور المستخدم كإعداد افتراضي لتطبيقك وقت التثبيت. يتطابق التحقق من الصحة مع `defineRole`، لكن خط تجميع البناء يربط تلقائيًا قيمة `universalIdentifier` بصفة `defaultRoleUniversalIdentifier` في بيان التطبيق (manifest)، وبالتالي لا تحتاج إلى الإشارة إليه من [`defineApplication`](/l/ar/developers/extend/apps/config/application) بنفسك.
+
+الملاحظات:
+
+* يُسمح بوجود **استدعاء واحد فقط** لـ `defineApplicationRole(...)` لكل تطبيق — سيفشل إنشاء بيان التطبيق (manifest) إذا عثر على أكثر من واحد.
+* استخدم `defineRole()` (وليس `defineApplicationRole()`) لأي أدوار **إضافية** يأتي بها تطبيقك.
+* لا يزال تعيين `defaultRoleUniversalIdentifier` صراحةً على `defineApplication()` مدعومًا للتوافق مع الإصدارات السابقة، ولكنه مُهمَل لصالح `defineApplicationRole()`.
+
+## أفضل الممارسات
+
+* ابدأ من الدور المُنشأ تلقائيًا، ثم قم بتقييده تدريجيًا — إذ يمنح الإعداد الافتراضي صلاحيات قراءة واسعة، وهو ما نادرًا ما تريده في بيئة الإنتاج.
+* استبدل `objectPermissions` و`fieldPermissions` بالكائنات والحقول الدقيقة التي تحتاجها وظائفك فعليًا.
+* `permissionFlagUniversalIdentifiers` تتحكم في الوصول إلى القدرات على مستوى المنصة. اجعلها في حدّها الأدنى.
+* اطّلع على مثال عملي: [`hello-world/src/roles/function-role.ts`](https://github.com/twentyhq/twenty/blob/main/packages/twenty-apps/hello-world/src/roles/function-role.ts).
diff --git a/packages/twenty-docs/l/ar/developers/extend/apps/data/extending-objects.mdx b/packages/twenty-docs/l/ar/developers/extend/apps/data/extending-objects.mdx
new file mode 100644
index 00000000000..6bf27aa5b1c
--- /dev/null
+++ b/packages/twenty-docs/l/ar/developers/extend/apps/data/extending-objects.mdx
@@ -0,0 +1,50 @@
+---
+title: توسيع الكائنات
+description: أضِف حقولًا إلى كائنات Twenty القياسية (Person، Company، …) أو إلى كائنات من تطبيقات أخرى باستخدام defineField.
+icon: wand-magic-sparkles
+---
+
+استخدم `defineField()` لإضافة حقل إلى كائن لا تملكه — كائن Twenty قياسي مثل Person أو Company، أو كائن يتم توفيره بواسطة تطبيق آخر مُثبَّت. على خلاف الحقول المضمّنة داخل [`defineObject`](/l/ar/developers/extend/apps/data/objects)، تتطلّب الحقول المستقلة `objectUniversalIdentifier` لتحديد الكائن الذي تقوم بتوسيعه.
+
+```ts src/fields/company-loyalty-tier.field.ts
+import { defineField, FieldType } from 'twenty-sdk/define';
+
+export default defineField({
+ universalIdentifier: 'f2a1b3c4-d5e6-7890-abcd-ef1234567890',
+ objectUniversalIdentifier: '701aecb9-eb1c-4d84-9d94-b954b231b64b', // Company object
+ name: 'loyaltyTier',
+ type: FieldType.SELECT,
+ label: 'Loyalty Tier',
+ icon: 'IconStar',
+ options: [
+ { value: 'BRONZE', label: 'Bronze', position: 0, color: 'orange' },
+ { value: 'SILVER', label: 'Silver', position: 1, color: 'gray' },
+ { value: 'GOLD', label: 'Gold', position: 2, color: 'yellow' },
+ ],
+});
+```
+
+## النقاط الرئيسية
+
+* `objectUniversalIdentifier` يحدّد الكائن الهدف. بالنسبة لكائنات Twenty القياسية، استورد الثابت من `twenty-sdk`:
+
+ ```ts
+ import { STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS } from 'twenty-sdk/define';
+
+ // STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS.company.universalIdentifier
+ // STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS.person.universalIdentifier
+ // STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS.opportunity.universalIdentifier
+ // …
+ ```
+
+* عند تعريف الحقول بشكل مضمّن **داخل `defineObject()`**، **لا** تحتاج إلى `objectUniversalIdentifier` — إذ يُورَّث من الكائن الأب.
+
+* `defineField()` هي الطريقة الوحيدة لإضافة حقول إلى كائنات لم تُنشئها باستخدام `defineObject()`.
+
+* موقع الملف متروك لك. المتعارف عليه هو `src/fields/\<name>.field.ts`، لكن حزمة SDK تكتشف الحقول في أي مكان داخل `src/`.
+
+* لإضافة علامة تبويب إلى تخطيط صفحة قياسي (مثل صفحة تفاصيل Task أو Company)، استخدم [`definePageLayoutTab`](/l/ar/developers/extend/apps/layout/page-layouts#definepagelayouttab) مع `STANDARD_PAGE_LAYOUT_UNIVERSAL_IDENTIFIERS` من `twenty-sdk/define`.
+
+## إضافة علاقة إلى كائن موجود
+
+لإضافة حقل علاقة (مثل ربط الكائن المخصّص بكائن قياسي `Person`)، استخدم `defineField()` مع `FieldType.RELATION`. النمط هو نفسه الخاص بالعلاقات المضمّنة لكن مع تعيين `objectUniversalIdentifier` صراحةً. اطّلع على [Relations](/l/ar/developers/extend/apps/data/relations) للنمط ثنائي الاتجاه.
diff --git a/packages/twenty-docs/l/ar/developers/extend/apps/data/objects.mdx b/packages/twenty-docs/l/ar/developers/extend/apps/data/objects.mdx
new file mode 100644
index 00000000000..060759fe487
--- /dev/null
+++ b/packages/twenty-docs/l/ar/developers/extend/apps/data/objects.mdx
@@ -0,0 +1,104 @@
+---
+title: كائنات
+description: عرّف أنواعًا جديدة من السجلات — جداول مخصصة بحقولها الخاصة — باستخدام defineObject.
+icon: جدول
+---
+
+تُعد **الكائنات** المخصصة أنواع سجلات جديدة يضيفها تطبيقك إلى مساحة العمل — مثل بطاقة بريدية، أو فاتورة، أو اشتراك، أو أي شيء خاص بالمجال الذي تعمل فيه. يعلن كل كائن عن مخططه (الحقول، والعلاقات، والقيم الافتراضية) ومعرّف عالمي ثابت يستمر عبر عمليات المزامنة والنشر.
+
+```ts src/objects/post-card.object.ts
+import { defineObject, FieldType } from 'twenty-sdk/define';
+
+enum PostCardStatus {
+ DRAFT = 'DRAFT',
+ SENT = 'SENT',
+ DELIVERED = 'DELIVERED',
+ RETURNED = 'RETURNED',
+}
+
+export default defineObject({
+ universalIdentifier: '54b589ca-eeed-4950-a176-358418b85c05',
+ nameSingular: 'postCard',
+ namePlural: 'postCards',
+ labelSingular: 'Post Card',
+ labelPlural: 'Post Cards',
+ description: 'A post card object',
+ icon: 'IconMail',
+ fields: [
+ {
+ universalIdentifier: '58a0a314-d7ea-4865-9850-7fb84e72f30b',
+ name: 'content',
+ type: FieldType.TEXT,
+ label: 'Content',
+ description: "Postcard's content",
+ icon: 'IconAbc',
+ },
+ {
+ universalIdentifier: 'c6aa31f3-da76-4ac6-889f-475e226009ac',
+ name: 'recipientName',
+ type: FieldType.FULL_NAME,
+ label: 'Recipient name',
+ icon: 'IconUser',
+ },
+ {
+ universalIdentifier: '95045777-a0ad-49ec-98f9-22f9fc0c8266',
+ name: 'recipientAddress',
+ type: FieldType.ADDRESS,
+ label: 'Recipient address',
+ icon: 'IconHome',
+ },
+ {
+ universalIdentifier: '87b675b8-dd8c-4448-b4ca-20e5a2234a1e',
+ name: 'status',
+ type: FieldType.SELECT,
+ label: 'Status',
+ icon: 'IconSend',
+ defaultValue: `'${PostCardStatus.DRAFT}'`,
+ options: [
+ { value: PostCardStatus.DRAFT, label: 'Draft', position: 0, color: 'gray' },
+ { value: PostCardStatus.SENT, label: 'Sent', position: 1, color: 'orange' },
+ { value: PostCardStatus.DELIVERED, label: 'Delivered', position: 2, color: 'green' },
+ { value: PostCardStatus.RETURNED, label: 'Returned', position: 3, color: 'orange' },
+ ],
+ },
+ {
+ universalIdentifier: 'e06abe72-5b44-4e7f-93be-afc185a3c433',
+ name: 'deliveredAt',
+ type: FieldType.DATE_TIME,
+ label: 'Delivered at',
+ icon: 'IconCheck',
+ isNullable: true,
+ defaultValue: null,
+ },
+ ],
+});
+```
+
+## النقاط الرئيسية
+
+* `universalIdentifier` يجب أن يكون فريدًا وثابتًا عبر عمليات النشر.
+* يتطلب كل حقل `name` و`type` و`label` ومعرّف `universalIdentifier` ثابتًا خاصًا به.
+* المصفوفة `fields` اختيارية — يمكنك تعريف كائنات بدون حقول مخصصة.
+* لا تحتاج الحقول المضمّنة المُعرَّفة هنا إلى `objectUniversalIdentifier` — إذ تُورَّث من الكائن الأب. استخدم [`defineField()`](/l/ar/developers/extend/apps/data/extending-objects) لإضافة حقول إلى كائنات لا تمتلكها.
+* يمكنك إنشاء كائنات جديدة باستخدام `yarn twenty dev:add object`، والذي يرشدك خلال التسمية والحقول والعلاقات. راجع [Architecture → Scaffolding entities](/l/ar/developers/extend/apps/getting-started/scaffolding).
+
+<Note>
+**تُضاف الحقول الأساسية تلقائيًا.** عند تعريف كائن مخصص، ينشئ Twenty حقولًا قياسية مثل `id` و`name` و`createdAt` و`updatedAt` و`createdBy` و`updatedBy` و`deletedAt` من أجلك. لا تحتاج إلى تعريفها في مصفوفة `fields` — أضف فقط حقولك المخصصة. يمكنك تجاوز حقلًا افتراضيًا بتعريف حقل يحمل الاسم نفسه، لكن هذا نادرًا ما يكون فكرة جيدة.
+</Note>
+
+## القيم الافتراضية
+
+يجب تضمين القيم النصية الافتراضية بين علامات اقتباس أحادية **داخل** السلسلة — `defaultValue: "'Draft'"`، وليس `defaultValue: "Draft"`. لهذا السبب يستخدم الحقل `status` أعلاه `` `'${PostCardStatus.DRAFT}'` ``.
+
+السلاسل غير المحاطة بعلامات اقتباس محجوزة للقيم الافتراضية المحسوبة، والتي يتم تقييمها عند إنشاء سجل:
+
+* `'uuid'` — يُنشِئ UUID (لحقول `UUID`)
+* `'now'` — الطابع الزمني الحالي (لحقول `DATE_TIME`)
+
+ينطبق نفس الاصطلاح على الحقول الفرعية النصية للقيم الافتراضية المركّبة (على سبيل المثال `{ source: "'MANUAL'" }` في حقل `ACTOR`) وكذلك على قيم `SELECT`/`MULTI_SELECT`. سيتسبّب ترك قيمة افتراضية نصية حرفية بدون علامات اقتباس في ظهور تحذير عند إنشاء التطبيق.
+
+## ماذا بعد؟
+
+* **اربط هذا الكائن بغيره من الكائنات** — راجع صفحة [Relations](/l/ar/developers/extend/apps/data/relations) لمعرفة نمط العلاقة ثنائية الاتجاه.
+* **أضف حقولًا إلى الكائنات التابعة لتطبيقات أخرى** — راجع [Extending Objects](/l/ar/developers/extend/apps/data/extending-objects) لمعرفة المزيد حول `defineField()`.
+* **اعرض هذا الكائن في واجهة المستخدم** — راجع [Views](/l/ar/developers/extend/apps/layout/views) و[Navigation Menu Items](/l/ar/developers/extend/apps/layout/navigation-menu-items) لإظهاره في الشريط الجانبي.
diff --git a/packages/twenty-docs/l/ar/developers/extend/apps/data/overview.mdx b/packages/twenty-docs/l/ar/developers/extend/apps/data/overview.mdx
new file mode 100644
index 00000000000..7b9ca6e56ce
--- /dev/null
+++ b/packages/twenty-docs/l/ar/developers/extend/apps/data/overview.mdx
@@ -0,0 +1,97 @@
+---
+title: نظرة عامة
+description: شكّل البيانات التي يضيفها تطبيقك إلى مساحة العمل — الكائنات والحقول والعلاقات.
+icon: database
+---
+
+طبقة **البيانات** في تطبيق Twenty هي البيانات التي *يضيفها* تطبيقك إلى مساحة العمل — أنواع السجلات الجديدة التي يصرّح عنها، والأعمدة التي يضيفها إلى الكائنات الموجودة، وكيف ترتبط هذه السجلات ببعضها البعض.
+
+```text
+┌──────────────────────────────────────────────────┐
+│ Object — a record type, e.g. PostCard │
+│ ├─ Field (name, type, label) │
+│ ├─ Field │
+│ └─ Relation (link to another object) │
+└──────────────────────────────────────────────────┘
+ │
+ ├── lives in your app, OR
+ │
+ ▼
+┌──────────────────────────────────────────────────┐
+│ Standard / other apps' objects │
+│ └─ Field added by your app via defineField │
+└──────────────────────────────────────────────────┘
+```
+
+## في هذا القسم
+
+<CardGroup cols={٢}>
+ <Card title="كائنات" icon="جدول" href="/l/ar/developers/extend/apps/data/objects">
+ `defineObject` — صرّح عن أنواع سجلات جديدة مع حقولها الخاصة.
+ </Card>
+ <Card title="توسيع الكائنات" icon="wand-magic-sparkles" href="/l/ar/developers/extend/apps/data/extending-objects">
+ `defineField` — أضِف حقولًا إلى كائنات قياسية أو كائنات تطبيقات أخرى.
+ </Card>
+ <Card title="العلاقات" icon="diagram-project" href="/l/ar/developers/extend/apps/data/relations">
+ اتصالات ثنائية الاتجاه من نوع `MANY_TO_ONE` / `ONE_TO_MANY` بين الكائنات.
+ </Card>
+</CardGroup>
+
+## الكيانات بنظرة سريعة
+
+| كيان | الغرض | مُعرَّفة باستخدام |
+| ---------- | ------------------------------------------------------------------------------------------------------- | --------------------------------------- |
+| **الكائن** | نوع سجل مخصص جديد (مثل PostCard أو Invoice) مع حقوله الخاصة | `defineObject()` |
+| **الحقل** | عمود على كائن. يمكن للحقول المستقلة توسيع الكائنات التي لم تنشئها (مثل إضافة `loyaltyTier` إلى Company) | `defineField()` |
+| **علاقة** | ارتباط ثنائي الاتجاه بين كائنين — يُصرّح عن كلا الجانبين كحقول | `defineField()` مع `FieldType.RELATION` |
+| **الفهرس** | فهرس قاعدة بيانات لتسريع استعلام متكرر على أحد الكائنات لديك | `defineIndex()` |
+
+يكتشف SDK هذه العناصر عبر تحليل AST أثناء وقت البناء، لذا تنظيم الملفات يعود إليك — القاعدة المتّبعة هي `src/objects/` و `src/fields/` و `src/indexes/`. معرّفات UUID ثابتة من نوع `universalIdentifier` تربط كل شيء معًا عبر عمليات النشر.
+
+## الفهارس (اختياري)
+
+يمكن للتطبيقات إرفاق الفهارس مع الكائنات الخاصة بها للحفاظ على سرعة الاستعلامات المتكررة. أكثر الحالات شيوعًا هي عمود حالة أو مفتاح أجنبي تقوم بقراءته بشكل متكرر.
+
+```ts src/indexes/post-card-status.index.ts
+import { defineIndex } from 'twenty-sdk/define';
+
+import {
+ POST_CARD_UNIVERSAL_IDENTIFIER,
+ STATUS_FIELD_UNIVERSAL_IDENTIFIER,
+} from '../objects/post-card.object';
+
+export default defineIndex({
+ universalIdentifier: 'b6e9d2a1-5a4c-46ca-9d52-42c8f02d1ff0',
+ objectUniversalIdentifier: POST_CARD_UNIVERSAL_IDENTIFIER,
+ fields: [
+ {
+ universalIdentifier: 'b6e9d2a1-5a4c-46ca-9d52-42c8f02d1ff1',
+ fieldUniversalIdentifier: STATUS_FIELD_UNIVERSAL_IDENTIFIER,
+ },
+ ],
+});
+```
+
+### الفهارس الفريدة
+
+تقبل `defineIndex` الخيار `isUnique: true` لكلٍّ من التفرد على عمود واحد أو على عدّة أعمدة. هذه هي البنية الموصى بها — إن `defineField({ isUnique: true })` مهملة وسيتم إزالتها في إصدار قادم.
+
+```ts
+defineIndex({
+ universalIdentifier: '…',
+ objectUniversalIdentifier: PERSON_UNIVERSAL_IDENTIFIER,
+ isUnique: true,
+ fields: [{ universalIdentifier: '…', fieldUniversalIdentifier: EMAIL_FIELD_UNIVERSAL_IDENTIFIER }],
+});
+```
+
+### قيود أخرى
+
+* تظل عبارات `WHERE` الجزئية تحت تحكم المشرف — لا يمكن للتطبيقات التصريح بها.
+* يتم تقييد كل كائن بعدد 10 فهارس مخصصة (لا تُحتسب فهارس الإطار نفسه).
+
+رتّب مصفوفة `fields` بالطريقة التي ينبغي على Postgres استخدامها — العمود في أقصى اليسار أولًا، مثل دليل الهاتف. الفهارس ليست مجانية: كل عملية كتابة في الجدول تقوم بتحديثها. أضِف واحدًا فقط عندما يكون لديك استعلام يحتاج إليه.
+
+<Note>
+هل تبحث عن **Application Config** أو **Roles & Permissions**؟ هذه تصف التطبيق نفسه بدلًا من البيانات التي يضيفها — وتوجد ضمن [Config](/l/ar/developers/extend/apps/config/overview). هل تبحث عن **Connections** (Linear, GitHub, Slack OAuth)؟ هذه وُجِدت ليتم استدعاؤها *من* دوال المنطق وتوجد ضمن [Logic](/l/ar/developers/extend/apps/logic/connections).
+</Note>
diff --git a/packages/twenty-docs/l/ar/developers/extend/apps/data/relations.mdx b/packages/twenty-docs/l/ar/developers/extend/apps/data/relations.mdx
new file mode 100644
index 00000000000..f1c784e8276
--- /dev/null
+++ b/packages/twenty-docs/l/ar/developers/extend/apps/data/relations.mdx
@@ -0,0 +1,160 @@
+---
+title: العلاقات
+description: وصِل الكائنات معًا بعلاقات MANY_TO_ONE / ONE_TO_MANY ثنائية الاتجاه.
+icon: diagram-project
+---
+
+تربط العلاقات كائنين معًا. في Twenty، تكون العلاقات دائمًا **ثنائية الاتجاه** — لكل علاقة جانبَان، ويُصرَّح عن كل جانب كحقل يُشير إلى الآخر.
+
+| نوع العلاقة | الوصف | هل لديه مفتاح خارجي؟ |
+| ------------- | ------------------------------------------------------ | ---------------------- |
+| `MANY_TO_ONE` | تشير العديد من سجلات هذا الكائن إلى سجل واحد من الهدف | نعم (`joinColumnName`) |
+| `ONE_TO_MANY` | يحتوي سجل واحد من هذا الكائن على العديد من سجلات الهدف | لا (الجانب العكسي) |
+
+## كيف تعمل العلاقات
+
+تتطلّب كل علاقة **حقلين** يشيران إلى بعضهما البعض:
+
+1. جانب **MANY_TO_ONE** — يوجد على الكائن الذي يحمل المفتاح الخارجي.
+2. جانب **ONE_TO_MANY** — يوجد على الكائن الذي يملك المجموعة.
+
+يستخدم كلا الحقلين `FieldType.RELATION` ويُحيل كلٌ منهما إلى الآخر عبر `relationTargetFieldMetadataUniversalIdentifier`.
+
+## مثال: البطاقة البريدية لديها العديد من المستلمين
+
+يمكن إرسال `PostCard` إلى العديد من سجلات `PostCardRecipient`. ينتمي كل مستلم إلى بطاقة بريدية واحدة بالضبط.
+
+**الخطوة 1: عرّف جانب ONE_TO_MANY على PostCard** (جانب "الواحد"):
+
+```ts src/fields/post-card-recipients-on-post-card.field.ts
+import { defineField, FieldType, RelationType } from 'twenty-sdk/define';
+import { POST_CARD_UNIVERSAL_IDENTIFIER } from '../objects/post-card.object';
+import { POST_CARD_RECIPIENT_UNIVERSAL_IDENTIFIER } from '../objects/post-card-recipient.object';
+
+// Export so the other side can reference it
+export const POST_CARD_RECIPIENTS_FIELD_ID = 'a1111111-1111-1111-1111-111111111111';
+// Import from the other side
+import { POST_CARD_FIELD_ID } from './post-card-on-post-card-recipient.field';
+
+export default defineField({
+ universalIdentifier: POST_CARD_RECIPIENTS_FIELD_ID,
+ objectUniversalIdentifier: POST_CARD_UNIVERSAL_IDENTIFIER,
+ type: FieldType.RELATION,
+ name: 'postCardRecipients',
+ label: 'Post Card Recipients',
+ icon: 'IconUsers',
+ relationTargetObjectMetadataUniversalIdentifier: POST_CARD_RECIPIENT_UNIVERSAL_IDENTIFIER,
+ relationTargetFieldMetadataUniversalIdentifier: POST_CARD_FIELD_ID,
+ universalSettings: {
+ relationType: RelationType.ONE_TO_MANY,
+ },
+});
+```
+
+**الخطوة 2: عرّف جانب MANY_TO_ONE على PostCardRecipient** (جانب "العديد" — يحمل المفتاح الخارجي):
+
+```ts src/fields/post-card-on-post-card-recipient.field.ts
+import { defineField, FieldType, RelationType, OnDeleteAction } from 'twenty-sdk/define';
+import { POST_CARD_UNIVERSAL_IDENTIFIER } from '../objects/post-card.object';
+import { POST_CARD_RECIPIENT_UNIVERSAL_IDENTIFIER } from '../objects/post-card-recipient.object';
+
+// Export so the other side can reference it
+export const POST_CARD_FIELD_ID = 'b2222222-2222-2222-2222-222222222222';
+// Import from the other side
+import { POST_CARD_RECIPIENTS_FIELD_ID } from './post-card-recipients-on-post-card.field';
+
+export default defineField({
+ universalIdentifier: POST_CARD_FIELD_ID,
+ objectUniversalIdentifier: POST_CARD_RECIPIENT_UNIVERSAL_IDENTIFIER,
+ type: FieldType.RELATION,
+ name: 'postCard',
+ label: 'Post Card',
+ icon: 'IconMail',
+ relationTargetObjectMetadataUniversalIdentifier: POST_CARD_UNIVERSAL_IDENTIFIER,
+ relationTargetFieldMetadataUniversalIdentifier: POST_CARD_RECIPIENTS_FIELD_ID,
+ universalSettings: {
+ relationType: RelationType.MANY_TO_ONE,
+ onDelete: OnDeleteAction.CASCADE,
+ joinColumnName: 'postCardId',
+ },
+});
+```
+
+<Note>
+**الاستيرادات الدائرية:** كلا حقلي العلاقة يُشير كلٌّ منهما إلى `universalIdentifier` الخاص بالآخر. لتجنّب مشكلات الاستيراد الدائري، صدِّر معرّفات الحقول كثوابت مسمّاة من كل ملف، واستورِدها في الملف الآخر. يقوم نظام البناء بحلّها في وقت التجميع.
+</Note>
+
+## الربط مع الكائنات القياسية
+
+لإنشاء علاقة مع كائن Twenty مضمّن (Person, Company, etc.)، استخدم `STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS`:
+
+```ts src/fields/person-on-self-hosting-user.field.ts
+import {
+ defineField,
+ FieldType,
+ RelationType,
+ OnDeleteAction,
+ STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS,
+} from 'twenty-sdk/define';
+import { SELF_HOSTING_USER_UNIVERSAL_IDENTIFIER } from '../objects/self-hosting-user.object';
+
+export const PERSON_FIELD_ID = 'c3333333-3333-3333-3333-333333333333';
+export const SELF_HOSTING_USER_REVERSE_FIELD_ID = 'd4444444-4444-4444-4444-444444444444';
+
+export default defineField({
+ universalIdentifier: PERSON_FIELD_ID,
+ objectUniversalIdentifier: SELF_HOSTING_USER_UNIVERSAL_IDENTIFIER,
+ type: FieldType.RELATION,
+ name: 'person',
+ label: 'Person',
+ description: 'Person matching with the self hosting user',
+ isNullable: true,
+ relationTargetObjectMetadataUniversalIdentifier:
+ STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS.person.universalIdentifier,
+ relationTargetFieldMetadataUniversalIdentifier: SELF_HOSTING_USER_REVERSE_FIELD_ID,
+ universalSettings: {
+ relationType: RelationType.MANY_TO_ONE,
+ onDelete: OnDeleteAction.SET_NULL,
+ joinColumnName: 'personId',
+ },
+});
+```
+
+## خصائص حقل العلاقة
+
+| الخاصية | مطلوب | الوصف |
+| ------------------------------------------------- | --------------- | -------------------------------------------------------------------------------------- |
+| `type` | نعم | يجب أن يكون `FieldType.RELATION` |
+| `relationTargetObjectMetadataUniversalIdentifier` | نعم | قيمة `universalIdentifier` للكائن الهدف |
+| `relationTargetFieldMetadataUniversalIdentifier` | نعم | قيمة `universalIdentifier` للحقل المطابق على الكائن الهدف |
+| `universalSettings.relationType` | نعم | `RelationType.MANY_TO_ONE` أو `RelationType.ONE_TO_MANY` |
+| `universalSettings.onDelete` | MANY_TO_ONE فقط | ماذا يحدث عند حذف السجل المشار إليه: `CASCADE`، `SET_NULL`، `RESTRICT`، أو `NO_ACTION` |
+| `universalSettings.joinColumnName` | MANY_TO_ONE فقط | اسم عمود قاعدة البيانات للمفتاح الخارجي (مثل `postCardId`) |
+
+## حقول العلاقات المضمَّنة
+
+يمكنك أيضًا إعلان علاقة مباشرة داخل [`defineObject`](/l/ar/developers/extend/apps/data/objects). عند كونها مضمَّنة، احذِف `objectUniversalIdentifier` — إذ يُورَّث من الكائن الأب:
+
+```ts
+export default defineObject({
+ universalIdentifier: '...',
+ nameSingular: 'postCardRecipient',
+ // ...
+ fields: [
+ {
+ universalIdentifier: POST_CARD_FIELD_ID,
+ type: FieldType.RELATION,
+ name: 'postCard',
+ label: 'Post Card',
+ relationTargetObjectMetadataUniversalIdentifier: POST_CARD_UNIVERSAL_IDENTIFIER,
+ relationTargetFieldMetadataUniversalIdentifier: POST_CARD_RECIPIENTS_FIELD_ID,
+ universalSettings: {
+ relationType: RelationType.MANY_TO_ONE,
+ onDelete: OnDeleteAction.CASCADE,
+ joinColumnName: 'postCardId',
+ },
+ },
+ // … other fields
+ ],
+});
+```
diff --git a/packages/twenty-docs/l/ar/developers/extend/apps/getting-started/concepts.mdx b/packages/twenty-docs/l/ar/developers/extend/apps/getting-started/concepts.mdx
new file mode 100644
index 00000000000..f3354131332
--- /dev/null
+++ b/packages/twenty-docs/l/ar/developers/extend/apps/getting-started/concepts.mdx
@@ -0,0 +1,101 @@
+---
+title: المفاهيم
+description: كيفية عمل تطبيقات Twenty — نموذج الكيان، العزل (sandboxing)، ودورة حياة التثبيت.
+icon: sitemap
+---
+
+تطبيقات Twenty هي حزم TypeScript توسّع مساحة عملك بكائنات مخصّصة، ومنطق، ومكوّنات واجهة مستخدم (UI)، وقدرات ذكاء اصطناعي. تعمل على منصة Twenty مع عزل كامل وضوابط الأذونات.
+
+## كيف تعمل التطبيقات
+
+التطبيق عبارة عن مجموعة من **الكيانات** يتم إعلانها باستخدام دوال `defineEntity()` من حزمة `twenty-sdk`. يكتشف SDK هذه التصريحات عبر تحليل AST وقت البناء وينتج **ملف بيان** — وصفًا كاملًا لما يضيفه تطبيقك إلى مساحة العمل. تتحقق هذه الدوال من تكوينك وقت البناء وتوفّر إكمالًا تلقائيًا في بيئة التطوير وأمان الأنواع.
+
+```
+your-app/
+├── src/
+│ ├── application-config.ts ← defineApplication (required, one per app)
+│ ├── roles/ ← defineRole
+│ ├── objects/ ← defineObject
+│ ├── fields/ ← defineField
+│ ├── logic-functions/ ← defineLogicFunction
+│ ├── front-components/ ← defineFrontComponent
+│ ├── skills/ ← defineSkill
+│ ├── agents/ ← defineAgent
+│ ├── views/ ← defineView
+│ ├── navigation-menu-items/ ← defineNavigationMenuItem
+│ └── page-layouts/ ← definePageLayout
+├── public/ ← Static assets (images, icons)
+└── package.json
+```
+
+<Note>
+ **تنظيم الملفات متروك لك.** يعتمد اكتشاف الكيانات على AST — يعثر SDK على استدعاءات `export default defineEntity(...)` بغض النظر عن مكان وجود الملف. بنية المجلدات أعلاه هي اصطلاح وليست متطلبًا.
+</Note>
+
+## أنواع الكيانات
+
+| كيان | الغرض | وثائق |
+| ---------------------- | ---------------------------------------------------------------- | --------------------------------------------------------------------------- |
+| **تطبيق** | هوية التطبيق، الدور الافتراضي، والمتغيرات | [تهيئة التطبيق](/l/ar/developers/extend/apps/config/application) |
+| **دور** | مجموعات الأذونات للكائنات والحقول | [الأدوار والأذونات](/l/ar/developers/extend/apps/config/roles) |
+| **الكائن** | أنواع سجلات مخصّصة مع حقول | [الكائنات](/l/ar/developers/extend/apps/data/objects) |
+| **الحقل** | إضافة حقول إلى الكائنات من تطبيقات أخرى | [توسيع الكائنات](/l/ar/developers/extend/apps/data/extending-objects) |
+| **علاقة** | روابط ثنائية الاتجاه بين الكائنات | [العلاقات](/l/ar/developers/extend/apps/data/relations) |
+| **دالة منطقية** | TypeScript على جانب الخادم مع مشغّلات | [الوظائف المنطقية](/l/ar/developers/extend/apps/logic/logic-functions) |
+| **مهارة** | تعليمات قابلة لإعادة الاستخدام لوكلاء الذكاء الاصطناعي | [المهارات والوكلاء](/l/ar/developers/extend/apps/logic/skills-and-agents) |
+| **وكيل** | مساعدو الذكاء الاصطناعي بموجهات مخصّصة | [المهارات والوكلاء](/l/ar/developers/extend/apps/logic/skills-and-agents) |
+| **موفر الاتصال** | بيانات اعتماد OAuth لواجهات برمجة التطبيقات التابعة لجهات خارجية | [الاتصالات](/l/ar/developers/extend/apps/logic/connections) |
+| **عرض** | عروض قوائم السجلات المكوّنة مسبقًا | [العروض](/l/ar/developers/extend/apps/layout/views) |
+| **عنصر قائمة التنقّل** | عناصر الشريط الجانبي المخصّصة | [عناصر قائمة التنقّل](/l/ar/developers/extend/apps/layout/navigation-menu-items) |
+| **تخطيط الصفحة** | علامات التبويب وعناصر الواجهة في صفحة تفاصيل السجل | [تخطيطات الصفحات](/l/ar/developers/extend/apps/layout/page-layouts) |
+| **مكوّن أمامي** | واجهة مستخدم React معزولة داخل Twenty | [المكوّنات الأمامية](/l/ar/developers/extend/apps/layout/front-components) |
+| **عنصر قائمة الأوامر** | إجراءات سريعة ومدخلات Cmd+K | [عناصر قائمة الأوامر](/l/ar/developers/extend/apps/layout/command-menu-items) |
+
+## العزل
+
+* **الدوال المنطقية** تعمل في عمليات Node.js معزولة على الخادم. لا تصل إلى البيانات إلا عبر عميل API مضبوط الأنواع، ومقيَّد بأذونات دور التطبيق.
+* **المكوّنات الأمامية** تعمل ضمن Web Workers باستخدام Remote DOM — معزولة عن الصفحة الرئيسية لكنها تعرض عناصر DOM الأصلية (وليس iframes). تتواصل مع Twenty عبر واجهة API للمضيف تعتمد تمرير الرسائل.
+* **الأذونات** تُطبَّق على مستوى واجهة API. يُشتق رمز وقت التشغيل (`TWENTY_APP_ACCESS_TOKEN`) من الدور المعرَّف في `defineApplication()`.
+
+## دورة حياة التطبيق
+
+```
+┌─────────────────────────────────────────────────────────┐
+│ Development │
+│ npx create-twenty-app → yarn twenty dev (live sync) │
+├─────────────────────────────────────────────────────────┤
+│ Build & Deploy │
+│ yarn twenty dev:build → yarn twenty app:publish │
+├─────────────────────────────────────────────────────────┤
+│ Install flow │
+│ upload → [pre-install] → metadata migration → │
+│ generate SDK → [post-install] │
+├─────────────────────────────────────────────────────────┤
+│ Publish │
+│ npm publish → appears in Twenty marketplace │
+└─────────────────────────────────────────────────────────┘
+```
+
+* **`yarn twenty dev`** — يراقب ملفات المصدر لديك ويزامن التغييرات مباشرةً إلى خادم Twenty متصل. يُعاد توليد عميل API مضبوط الأنواع تلقائيًا عند تغيّر المخطط.
+* **`yarn twenty dev:build`** — يجمّع TypeScript، ويضمّن الدوال المنطقية والمكوّنات الأمامية باستخدام esbuild، وينتج ملف بيان.
+* **خطّافات ما قبل/ما بعد التثبيت** — دوال اختيارية تعمل أثناء التثبيت. راجع [خطّافات التثبيت](/l/ar/developers/extend/apps/config/install-hooks) للتفاصيل.
+
+## الخطوات التالية
+
+<CardGroup cols={2}>
+ <Card title="التهيئة" icon="screwdriver-wrench" href="/l/ar/developers/extend/apps/config/overview">
+ هوية التطبيق، الدور الافتراضي، وخطّافات التثبيت.
+ </Card>
+ <Card title="بيانات" icon="database" href="/l/ar/developers/extend/apps/data/overview">
+ الكائنات، الحقول، والعلاقات ثنائية الاتجاه.
+ </Card>
+ <Card title="المنطق" icon="bolt" href="/l/ar/developers/extend/apps/logic/overview">
+ دوال منطقية، مهارات، وكلاء، واتصالات OAuth.
+ </Card>
+ <Card title="التخطيط" icon="table-columns" href="/l/ar/developers/extend/apps/layout/overview">
+ العروض، التنقّل، تخطيطات الصفحات، ومكوّنات الواجهة الأمامية.
+ </Card>
+ <Card title="العمليات" icon="rocket" href="/l/ar/developers/extend/apps/operations/overview">
+ سطر الأوامر (CLI)، الاختبار، المستودعات البعيدة (remotes)، التكامل المستمر (CI)، ونشر تطبيقك.
+ </Card>
+</CardGroup>
diff --git a/packages/twenty-docs/l/ar/developers/extend/apps/getting-started/local-server.mdx b/packages/twenty-docs/l/ar/developers/extend/apps/getting-started/local-server.mdx
new file mode 100644
index 00000000000..1371fc36200
--- /dev/null
+++ b/packages/twenty-docs/l/ar/developers/extend/apps/getting-started/local-server.mdx
@@ -0,0 +1,87 @@
+---
+title: الخادم المحلي
+description: إدارة خادم Twenty المحلي المستند إلى Docker — بدء التشغيل، الإيقاف، الترقية، مثيل اختبار متوازٍ، وإعداد SDK اليدوي.
+icon: server
+---
+
+## إدارة الخادم المحلي
+
+استخدم `yarn twenty docker:*` للتحكّم في حاوية Twenty المحلية:
+
+| أمر | ماذا يفعل |
+| -------------------------------------- | -------------------------------------------------- |
+| `yarn twenty docker:start` | بدء تشغيل الخادم (يسحب الصورة إذا لزم الأمر) |
+| `yarn twenty docker:start 2.2.0` | بدء إصدار محدد من الخادم |
+| `yarn twenty docker:start --port 3030` | بدء التشغيل على منفذ مخصّص |
+| `yarn twenty docker:stop` | إيقاف الخادم (مع الحفاظ على البيانات) |
+| `yarn twenty docker:status` | عرض عنوان URL والإصدار وبيانات اعتماد تسجيل الدخول |
+| `yarn twenty docker:logs` | بث سجلات الخادم |
+| `yarn twenty docker:reset` | مسح البيانات والبدء من جديد |
+| `yarn twenty docker:upgrade` | سحب أحدث صورة `twenty-app-dev` |
+| `yarn twenty docker:upgrade 2.2.0` | الترقية إلى إصدار محدد |
+
+تظل البيانات محفوظة عبر عمليات إعادة التشغيل في وحدتي تخزين Docker (`twenty-app-dev-data` لـ PostgreSQL، و`twenty-app-dev-storage` للملفات). استخدم `reset` لمسح كل شيء.
+
+## تثبيت إصدار الخادم
+
+عند عدم تمرير أي إصدار، يقوم `docker:start` باشتقاق الإصدار من النطاق `engines.twenty` في ملف `package.json` لتطبيقك — وهو نفس النطاق الذي يتحقق منه الخادم عند تثبيت تطبيقك. يشغّل أحدث صورة منشورة لـ `twenty-app-dev` التي تُلبي هذا النطاق، مع الرجوع إلى `latest` عندما يكون الحقل غير موجودًا أو لا يتطابق أي إصدار منشور:
+
+```json filename="package.json"
+{
+ "engines": {
+ "twenty": ">=2.2.0"
+ }
+}
+```
+
+مرِّر إصدارًا بشكلٍ صريح لتجاوز النطاق لتشغيلٍ واحد فقط: `yarn twenty docker:start 2.3.0`. إذا كانت هناك حاوية موجودة بالفعل على إصدار مختلف، يقوم `docker:start` بترقيتها في مكانها (مع إعادة إنشاء الحاوية مع الحفاظ على وحدات تخزين بياناتك).
+
+## ترقية صورة الخادم
+
+يقوم `yarn twenty docker:upgrade` بسحب أحدث صورة، ومقارنة التجزئات، ولا يعيد إنشاء الحاوية إلا إذا حدث تغيير فعلي. تظل وحدات التخزين محفوظة — ويتم استبدال الحاوية فقط. إذا تم سحب صورة جديدة وكانت الحاوية تعمل، فستبدأ عملية الترقية تلقائيًا حاوية جديدة؛ شغّل بعد ذلك `yarn twenty docker:start` للانتظار حتى تصبح سليمة.
+
+```bash filename="Terminal"
+yarn twenty docker:upgrade # Latest
+yarn twenty docker:upgrade 2.2.0 # Specific version
+```
+
+تحقّق من الإصدار الجاري باستخدام `yarn twenty docker:status` (يعرض قيمة `APP_VERSION` المضمنة في الحاوية).
+
+## تشغيل مثيل اختبار متوازٍ
+
+مرّر `--test` إلى أي أمر `docker:*` لإدارة مثيل ثانٍ معزول تمامًا — مفيد لاختبارات التكامل أو للتجربة من دون لمس بيانات التطوير الرئيسية لديك:
+
+| أمر | ماذا يفعل |
+| ----------------------------------- | ----------------------------------------- |
+| `yarn twenty docker:start --test` | بدء مثيل الاختبار (المنفذ الافتراضي 2021) |
+| `yarn twenty docker:stop --test` | إيقافه |
+| `yarn twenty docker:status --test` | عرض حالته |
+| `yarn twenty docker:logs --test` | بث سجلاته |
+| `yarn twenty docker:reset --test` | مسح بياناته |
+| `yarn twenty docker:upgrade --test` | ترقية صورته |
+
+يملك مثيل الاختبار حاويته الخاصة (`twenty-app-dev-test`) ووحدات التخزين الخاصة به (`twenty-app-dev-test-data`، `twenty-app-dev-test-storage`) وتهيئته — ويعمل جنبًا إلى جنب مع مثيلك الرئيسي بدون تعارضات. اجمع `--test` مع `--port` لتجاوز المنفذ 2021.
+
+## إعداد يدوي (بدون أداة توليد الهيكل)
+
+تجاوز أداة توليد الهيكل إذا كنت تضيف SDK إلى مشروع قائم:
+
+```bash filename="Terminal"
+yarn add twenty-sdk twenty-client-sdk
+```
+
+أضِف النص البرمجي إلى `package.json`:
+
+```json filename="package.json"
+{
+ "scripts": {
+ "twenty": "twenty"
+ }
+}
+```
+
+يمكنك الآن تشغيل `yarn twenty dev`، و`yarn twenty docker:start`، والبقية.
+
+<Note>
+لا تثبّت `twenty-sdk` عالميًا — ثبِّته لكل مشروع بحيث يستخدم كل تطبيق إصداره الخاص.
+</Note>
diff --git a/packages/twenty-docs/l/ar/developers/extend/apps/getting-started/project-structure.mdx b/packages/twenty-docs/l/ar/developers/extend/apps/getting-started/project-structure.mdx
new file mode 100644
index 00000000000..64f4972a9ff
--- /dev/null
+++ b/packages/twenty-docs/l/ar/developers/extend/apps/getting-started/project-structure.mdx
@@ -0,0 +1,61 @@
+---
+title: هيكل المشروع
+description: ما الذي يوجد داخل تطبيق Twenty المُهيكل مسبقًا — الملفات والمجلدات، وما الذي يفعله كلٌّ منها.
+icon: folder-tree
+---
+
+يبدو التطبيق الجديد الذي يتم إنشاؤه بواسطة `npx create-twenty-app` كما يلي:
+
+```text filename="my-twenty-app/"
+my-twenty-app/
+ package.json
+ src/
+ application-config.ts # Required — your app's entry point
+ default-role.ts # Permissions for logic functions
+ constants/
+ universal-identifiers.ts # Auto-generated UUIDs and metadata
+ __tests__/
+ setup-test.ts
+ app-install.integration-test.ts
+ .github/workflows/ci.yml # GitHub Actions
+ public/ # Static assets
+ vitest.config.ts # Test runner config
+ tsconfig.json, tsconfig.spec.json
+ .nvmrc, .yarnrc.yml, .oxlintrc.json
+ README.md, LLMS.md
+```
+
+## الملفات الرئيسية
+
+| ملف / مجلد | الغرض |
+| ---------------------------------------- | ------------------------------------------------------------------- |
+| `src/application-config.ts` | **مطلوب.** ملف الإعداد الرئيسي لتطبيقك. |
+| `src/default-role.ts` | دور افتراضي يتحكّم بما يمكن لدوال المنطق الوصول إليه. |
+| `src/constants/universal-identifiers.ts` | معرّفات UUID وبيانات تعريف يتم توليدها تلقائيًا (اسم العرض، الوصف). |
+| `src/__tests__/` | اختبارات تكامل (إعداد + اختبار مثال). |
+| `public/` | أصول ثابتة (صور، خطوط) تُقدَّم مع تطبيقك. |
+
+<Note>
+**تنظيم الملفات متروك لك.** المجلدات المذكورة أعلاه هي أعراف متَّبعة — يكتشف SDK الكيانات عبر تحليل AST على استدعاءات `export default defineEntity(...)` بغض النظر عن مكان وجود الملف.
+</Note>
+
+## التبعيات
+
+ينبغي أن تكون حزمتا SDK الخاصتان بـ Twenty ضمن `devDependencies`، وليس ضمن `dependencies`:
+
+```json filename="package.json"
+{
+ "dependencies": {},
+ "devDependencies": {
+ "twenty-client-sdk": "^2.13.0",
+ "twenty-sdk": "^2.13.0"
+ }
+}
+```
+
+* توفّر **`twenty-sdk`** أداة `twenty` CLI وأدوات البناء/إنشاء الهياكل (scaffolding). يعمل فقط أثناء التطوير ووقت البناء، ولا يتم استيراده أبدًا في وقت تشغيل تطبيقك المنشور.
+* يتم استيراد **`twenty-client-sdk`** بواسطة كود تطبيقك (`CoreApiClient`، `MetadataApiClient`، `RestApiClient`)؛ لكن Twenty توفّره في وقت التشغيل — حيث تحصل عليه دوال المنطق من طبقة SDK مُولَّدة، وتحصل عليه مكوّنات الواجهة من وحدات يتم تقديمها من الخادم. يُستخدَم الإصدار المثبّت لديك فقط لفحص الأنواع (typechecking) ولبناء النشر (deploy-time build)، لذا لا يلزم أبدًا أن يتم تضمينه في حزمة النشر.
+
+الاحتفاظ بأي من الحزمتين ضمن `dependencies` يؤدي إلى سحبها داخل حزمة وقت تشغيل التطبيق المثبّت، حيث تكون عبئًا زائدًا بلا فائدة. يُطلق `twenty build` تحذيرًا عندما تكون أيٌّ منهما ما تزال مدرجة ضمن `dependencies`.
+
+أضِف تبعيات وقت التشغيل الخاصة بتطبيقك (المكتبات التي تستوردها دوال المنطق لديك فعلًا في وقت التشغيل) ضمن `dependencies` كالمعتاد.
diff --git a/packages/twenty-docs/l/ar/developers/extend/apps/getting-started/quick-start.mdx b/packages/twenty-docs/l/ar/developers/extend/apps/getting-started/quick-start.mdx
new file mode 100644
index 00000000000..3d28211656e
--- /dev/null
+++ b/packages/twenty-docs/l/ar/developers/extend/apps/getting-started/quick-start.mdx
@@ -0,0 +1,176 @@
+---
+title: البدء السريع
+icon: rocket
+description: أنشئ أول تطبيق Twenty خلال دقائق.
+---
+
+## المتطلبات الأساسية
+
+* **Node.js 24+** — [تنزيل](https://nodejs.org/)
+* **Yarn 4** — يأتي مع Node.js عبر Corepack. قم بتمكينه: `corepack enable`
+* **Docker** — [تنزيل](https://www.docker.com/products/docker-desktop/). مطلوب لتشغيل خادم Twenty محليًا. تخطَّ ذلك إذا كان لديك Twenty يعمل في مكان آخر.
+
+يتكوّن إنشاء تطبيق Twenty من ثلاث مراحل. تقوم أداة توليد الهيكل بدمجها في أمر واحد لمسار الاستخدام المثالي، لكن كل مرحلة تمثّل مفهومًا منفصلًا — وعند حدوث فشل، فإن معرفة المرحلة التي أنت فيها تُخبرك بما ينبغي إصلاحه.
+
+| المرحلة | ماذا تفعل | الأداة | النتيجة |
+| ------------------- | ---------------------------------- | ----------------------------- | ------------------------------- |
+| **1. تهيئة الهيكل** | توليد الشفرة المصدرية للتطبيق | `npx create-twenty-app` | مشروع TypeScript على القرص |
+| **2. تشغيل خادم** | بدء تشغيل خادم Twenty للمزامنة معه | Docker + `yarn twenty server` | مثيل Twenty قيد التشغيل |
+| **3. مزامنة** | قم بمزامنة شفرتك مباشرةً مع الخادم | `yarn twenty dev` | تظهر تغييراتك في واجهة المستخدم |
+
+---
+
+## المرحلة 1 — تهيئة هيكل مشروعك
+
+أنشئ تطبيقًا جديدًا من القالب:
+
+```bash filename="Terminal"
+npx create-twenty-app@latest my-twenty-app
+```
+
+ستتم مطالبتك باسم ووصف — اضغط **Enter** للقيم الافتراضية. يُنشئ هذا مشروع TypeScript في `my-twenty-app/` يتضمن ملف بداية `application-config.ts`، ودورًا افتراضيًا، وسير عمل CI، واختبار تكامل.
+
+**بعد هذه المرحلة:** سيكون لديك الشفرة المصدرية لتطبيق على جهازك. ليس قيد التشغيل بعد — وهذه هي المرحلة 2.
+
+---
+
+## المرحلة 2 — تشغيل خادم Twenty محلي
+
+يحتاج تطبيقك إلى خادم Twenty للمزامنة معه. الخادم هو مثيل Twenty كامل — واجهة مستخدم، واجهة برمجة تطبيقات GraphQL، PostgreSQL — يعمل محليًا داخل Docker. ترفع شفرتك المحلية تعريفاتها إلى ذلك الخادم، مما يجعلها تظهر في واجهة المستخدم.
+
+تقترح أداة توليد الهيكل تشغيل خادم لك:
+
+> **هل ترغب في إعداد مثيل محلي من Twenty؟**
+
+* **نعم (موصى به)** — ستسحب صورة Docker `twentycrm/twenty-app-dev` وتبدأ تشغيلها على المنفذ `2020`. تأكّد أولًا من أن Docker قيد التشغيل.
+* **لا** — اختر هذا إذا كان لديك بالفعل خادم Twenty تريد الاتصال به. يمكنك ربطه لاحقًا باستخدام `yarn twenty remote:add`.
+
+<div style={{textAlign: 'center'}}>
+ <img src="/images/docs/developers/extends/apps/start-instance.png" alt="هل يجب بدء المثيل المحلي؟" />
+</div>
+
+بمجرد أن يصبح الخادم جاهزًا، سيفتح المتصفح لإجراء تسجيل الدخول. استخدم حساب العرض التوضيحي المُجهَّز مسبقًا:
+
+* **البريد الإلكتروني:** `[email protected]`
+* **كلمة المرور:** `[email protected]`
+
+<div style={{textAlign: 'center'}}>
+ <img src="/images/docs/developers/extends/apps/login.png" alt="شاشة تسجيل الدخول إلى Twenty" />
+</div>
+
+انقر **Authorize** في الشاشة التالية — يمنح هذا واجهة سطر الأوامر CLI حق الوصول إلى مساحة العمل الخاصة بك.
+
+<div style={{textAlign: 'center'}}>
+ <img src="/images/docs/developers/extends/apps/authorize.png" alt="شاشة تفويض واجهة الأوامر (CLI) الخاصة بـ Twenty" />
+</div>
+
+ستؤكّد الطرفية أن كل شيء قد تم إعداده.
+
+<div style={{textAlign: 'center'}}>
+ <img src="/images/docs/developers/extends/apps/scaffolded.png" alt="تم إنشاء هيكل التطبيق بنجاح" />
+</div>
+
+**بعد هذه المرحلة:** لديك خادم Twenty قيد التشغيل على [http://localhost:2020](http://localhost:2020)، مع تفويض CLI لديك للمزامنة معه.
+
+<Note>
+إذا لم يكن Docker مثبتًا أو قيد التشغيل، فستخبرك أداة توليد الهيكل بأمر البدء المناسب لنظام التشغيل لديك. عند تشغيل Docker، يمكنك المتابعة باستخدام `yarn twenty docker:start` — لا حاجة لإعادة إنشاء الهيكل.
+</Note>
+
+---
+
+## المرحلة 3 — مزامنة تغييراتك
+
+هذه هي الحلقة الداخلية التي ستقضي معظم وقتك فيها.
+
+```bash filename="Terminal"
+cd my-twenty-app
+yarn twenty dev
+```
+
+يراقب هذا المجلد `src/`، ويُعيد البناء عند كل تغيير، ويزامن الناتج إلى الخادم. حرّر ملفًا، واحفظه، وخلال بضع ثوانٍ سينعكس التغيير على الخادم. سترى لوحة حالة مباشرة في الطرفية.
+
+للحصول على مخرجات أكثر تفصيلاً (سجلات البناء، طلبات المزامنة، تتبعات الأخطاء)، أضِف `--verbose`.
+
+<div style={{textAlign: 'center'}}>
+ <img src="/images/docs/developers/extends/apps/dev.png" alt="مخرجات الطرفية في وضع التطوير" />
+</div>
+
+افتح [http://localhost:2020/settings/applications#developer](http://localhost:2020/settings/applications#developer). يفترض أن ترى تطبيقك ضمن **Your Apps**.
+
+<div style={{textAlign: 'center'}}>
+ <img src="/images/docs/developers/extends/apps/app-in-ui-1.png" alt="قائمة &#x22;Your Apps&#x22; تعرض &#x22;My twenty app&#x22;" />
+</div>
+
+انقر **My twenty app** لعرض **تسجيل التطبيق** — وهو سجل على مستوى الخادم يصف تطبيقك (الاسم، المعرّف، بيانات اعتماد OAuth، المصدر). يمكن تثبيت تسجيل واحد عبر عدة مساحات عمل على الخادم نفسه.
+
+<div style={{textAlign: 'center'}}>
+ <img src="/images/docs/developers/extends/apps/app-in-ui-2.png" alt="تفاصيل تسجيل التطبيق" />
+</div>
+
+انقر **View installed app** لعرض التثبيت في مساحة العمل. تعرض علامة التبويب **About** الإصدار وخيارات الإدارة.
+
+<div style={{textAlign: 'center'}}>
+ <img src="/images/docs/developers/extends/apps/app-in-ui-3.png" alt="التطبيق المثبت" />
+</div>
+
+**بعد هذه المرحلة:** لديك دورة تطوير حيّة. حرّر أي ملف في `src/` وسيظهر في واجهة المستخدم.
+
+### مزامنة لمرة واحدة لـ CI والبرامج النصية
+
+مرّر `--once` لتشغيل عملية بناء واحدة + مزامنة واحدة ثم الخروج — نفس خط الأنابيب، من دون مراقِب:
+
+```bash filename="Terminal"
+yarn twenty dev --once
+```
+
+| أمر | السلوك | متى يُستخدم |
+| ---------------------------------- | ------------------------------------------------------------------- | --------------------------------------------------------------------------- |
+| `yarn twenty dev` | يراقب ويعيد المزامنة عند كل تغيير. يستمر في العمل حتى توقفه. | تطوير محلي تفاعلي. |
+| `yarn twenty dev --once` | بناء واحد + مزامنة واحدة، يخرج برمز `0` عند النجاح، و`1` عند الفشل. | CI، وخطافات ما قبل الالتزام، ووكلاء الذكاء الاصطناعي، وسير عمل مكتوب بنصوص. |
+| `yarn twenty dev --once --dry-run` | يبني تغييرات البيانات الوصفية ويطبعها **من دون تطبيقها**. | فحص ما الذي سيُغيِّره التزامن قبل تطبيقه. |
+
+كلا الوضعين يحتاجان إلى جهة بعيدة موثَّقة. راجع قسم [المزامنة والاستعادة](/l/ar/developers/extend/apps/operations/sync-and-recovery#previewing-changes-dry-run) للحصول على المزيد من المعلومات حول `--dry-run`.
+
+### خيارات وضع التطوير
+
+| خيار | الوصف |
+| ------------------------------------- | ------------------------------------------------------------------------------------- |
+| `--once` | قم بالإنشاء والمزامنة مرة واحدة، ثم اخرج. |
+| `--dry-run` | باستخدام `--once`، يمكنك معاينة تغييرات البيانات الوصفية دون تطبيقها. لا يكتب أي شيء. |
+| `--debounceMs \<ms>` | اضبط مهلة إزالة الارتداد لتغييرات الملفات بالميلي ثانية (القيمة الافتراضية: `2000`). |
+| `--verbose` / `--debug` | إظهار سجلات إنشاء تفصيلية، وطلبات المزامنة، وتتبع الأخطاء. |
+
+## ما الذي يمكنك بناؤه
+
+تتكون التطبيقات من **كيانات** — يُعرَّف كل منها كملف TypeScript يحتوي على `export default` واحد:
+
+| كيان | ماذا يفعل |
+| ---------------------- | --------------------------------------------------------------------------------------------- |
+| **الكائنات والحقول** | نماذج بيانات مخصّصة (بطاقة بريدية، فاتورة، إلخ) بحقول ذات أنواع محددة |
+| **الوظائف المنطقية** | TypeScript على جانب الخادم يتم تشغيله عبر مسارات HTTP، أو جداول cron، أو أحداث قاعدة البيانات |
+| **المكوّنات الأمامية** | مكوّنات React تُعرَض داخل واجهة مستخدم Twenty (اللوحة الجانبية، الودجات، قائمة الأوامر) |
+| **المهارات والوكلاء** | قدرات الذكاء الاصطناعي — تعليمات قابلة لإعادة الاستخدام ومساعدون مستقلون ذاتيًا |
+| **طرق العرض والتنقّل** | طرق عرض قوائم مُعدّة مسبقًا وعناصر قائمة الشريط الجانبي |
+| **تخطيطات الصفحات** | صفحات تفاصيل سجلات مخصصة تتضمن علامات تبويب وعناصر واجهة |
+
+مرجع كامل: [المفاهيم](/l/ar/developers/extend/apps/getting-started/concepts).
+
+## الخطوات التالية
+
+<CardGroup cols={2}>
+ <Card title="التهيئة" icon="screwdriver-wrench" href="/l/ar/developers/extend/apps/config/overview">
+ هوية التطبيق، الدور الافتراضي، وخطّافات التثبيت، والأصول العامة.
+ </Card>
+ <Card title="بيانات" icon="database" href="/l/ar/developers/extend/apps/data/overview">
+ الكائنات، الحقول، والعلاقات ثنائية الاتجاه.
+ </Card>
+ <Card title="المنطق" icon="bolt" href="/l/ar/developers/extend/apps/logic/overview">
+ الوظائف المنطقية، المهارات، الوكلاء، واتصالات OAuth.
+ </Card>
+ <Card title="التخطيط" icon="table-columns" href="/l/ar/developers/extend/apps/layout/overview">
+ العروض، التنقل، تخطيطات الصفحات، ومكوّنات الواجهة الأمامية.
+ </Card>
+ <Card title="العمليات" icon="rocket" href="/l/ar/developers/extend/apps/operations/overview">
+ سطر الأوامر (CLI)، الاختبار، الوجهات البعيدة، التكامل المستمر (CI)، ونشر تطبيقك.
+ </Card>
+</CardGroup>
diff --git a/packages/twenty-docs/l/ar/developers/extend/apps/getting-started/scaffolding.mdx b/packages/twenty-docs/l/ar/developers/extend/apps/getting-started/scaffolding.mdx
new file mode 100644
index 00000000000..924a3971c28
--- /dev/null
+++ b/packages/twenty-docs/l/ar/developers/extend/apps/getting-started/scaffolding.mdx
@@ -0,0 +1,58 @@
+---
+title: إنشاء القوالب
+description: أنشئ ملفات الكيانات بشكل تفاعلي باستخدام yarn twenty dev:add — بما في ذلك الكائنات والحقول والعروض والدوال المنطقية والمزيد.
+icon: wand-magic-sparkles
+---
+
+بدلًا من إنشاء ملفات الكيانات يدويًا، استخدم أداة القوالب التفاعلية:
+
+```bash filename="Terminal"
+yarn twenty dev:add
+```
+
+ستطلب منك اختيار نوع الكيان وتُرشدك عبر الحقول المطلوبة، ثم تُنشئ ملفًا جاهزًا للاستخدام يحتوي على `universalIdentifier` ثابت واستدعاء `defineEntity()` الصحيح.
+
+يمكنك أيضًا تمرير نوع الكيان مباشرة لتخطي المطالبة الأولى:
+
+```bash filename="Terminal"
+yarn twenty dev:add object
+yarn twenty dev:add logicFunction
+yarn twenty dev:add frontComponent
+```
+
+## أنواع الكيانات المتاحة
+
+| نوع الكيان | أمر | الملف المُولَّد |
+| ------------------ | ---------------------------------------- | ------------------------------------------------------- |
+| كائن | `yarn twenty dev:add object` | `src/objects/\<name>.ts` |
+| الحقل | `yarn twenty dev:add field` | `src/fields/\<name>.ts` |
+| دالة منطقية | `yarn twenty dev:add logicFunction` | `src/logic-functions/\<name>.ts` |
+| مكوّن أمامي | `yarn twenty dev:add frontComponent` | `src/front-components/\<name>.tsx` |
+| دور | `yarn twenty dev:add role` | `src/roles/\<name>.ts` |
+| مهارة | `yarn twenty dev:add skill` | `src/skills/\<name>.ts` |
+| وكيل | `yarn twenty dev:add agent` | `src/agents/\<name>.ts` |
+| عرض | `yarn twenty dev:add view` | `src/views/\<name>.ts` |
+| عنصر قائمة التنقّل | `yarn twenty dev:add navigationMenuItem` | `src/navigation-menu-items/\<name>.ts` |
+| تخطيط الصفحة | `yarn twenty dev:add pageLayout` | `src/page-layouts/\<name>.ts` |
+
+## ما الذي تُنشئه أداة القوالب
+
+لكل نوع كيان قالب خاص به. على سبيل المثال، يسأل `yarn twenty dev:add object` عن:
+
+1. **الاسم (مفرد)** — مثل `invoice`
+2. **الاسم (جمع)** — مثل `invoices`
+3. **التسمية (مفرد)** — تُستمد تلقائيًا من الاسم (مثل `Invoice`)
+4. **التسمية (جمع)** — تُملأ تلقائيًا (مثل `Invoices`)
+5. **إنشاء عرض وعنصر تنقّل؟** — إذا أجبت بنعم، فستُنشئ أداة القوالب أيضًا عرضًا مطابقًا ورابط شريط جانبي للكائن الجديد.
+
+أنواع الكيانات الأخرى لها مطالبات أبسط — فمعظمها يطلب اسمًا فقط.
+
+نوع الكيان `field` أكثر تفصيلاً: يطلب اسم الحقل وتسمية الحقل ونوعه (من قائمة بكل أنواع الحقول المتاحة مثل `TEXT` و`NUMBER` و`SELECT` و`RELATION` وغيرها)، ومعرّف `universalIdentifier` للكائن الهدف.
+
+## مسار خرج مخصّص
+
+استخدم العلم `--path` لوضع الملف المُولَّد في موقع مخصّص:
+
+```bash filename="Terminal"
+yarn twenty dev:add logicFunction --path src/custom-folder
+```
diff --git a/packages/twenty-docs/l/ar/developers/extend/apps/getting-started/troubleshooting.mdx b/packages/twenty-docs/l/ar/developers/extend/apps/getting-started/troubleshooting.mdx
new file mode 100644
index 00000000000..0cc4bce849e
--- /dev/null
+++ b/packages/twenty-docs/l/ar/developers/extend/apps/getting-started/troubleshooting.mdx
@@ -0,0 +1,14 @@
+---
+title: استكشاف الأخطاء وإصلاحها
+description: مشكلات التشغيل الأول الشائعة — Docker، إصدار Node، Yarn، والتبعيات.
+icon: wrench
+---
+
+* **أخطاء Docker** — تأكّد من أن Docker Desktop (أو الـ daemon) قيد التشغيل قبل `yarn twenty docker:start`. ستعرض رسالة الخطأ أمر البدء المناسب لنظام التشغيل لديك.
+* **إصدار Node غير صحيح** — نحتاج 24 أو أحدث. تحقّق باستخدام `node -v`.
+* **Yarn 4 غير موجود** — شغّل `corepack enable`.
+* **تبعيات تالفة** — `rm -rf node_modules && yarn install`.
+* **أخطاء `twenty-sdk` بعد الترقية إلى v2.8.0** — تم نقله من `dependencies` إلى `devDependencies` في الإصدار v2.8.0. انظر إلى [بنية المشروع → التبعيات](/l/ar/developers/extend/apps/getting-started/project-structure#dependencies).
+* **`twenty build` يُصدر تحذيرًا بشأن `twenty-client-sdk` تحت `dependencies`** — يتم توفيره في وقت التشغيل بواسطة Twenty، لذلك يجب نقله إلى `devDependencies` جنبًا إلى جنب مع `twenty-sdk`. انظر إلى [بنية المشروع → التبعيات](/l/ar/developers/extend/apps/getting-started/project-structure#dependencies).
+
+هل علِقت؟ اطلب المساعدة على [خادم Twenty على Discord](https://discord.com/channels/1130383047699738754/1130386664812982322).
diff --git a/packages/twenty-docs/l/ar/developers/extend/apps/layout/command-menu-items.mdx b/packages/twenty-docs/l/ar/developers/extend/apps/layout/command-menu-items.mdx
new file mode 100644
index 00000000000..a60734ee07d
--- /dev/null
+++ b/packages/twenty-docs/l/ar/developers/extend/apps/layout/command-menu-items.mdx
@@ -0,0 +1,148 @@
+---
+title: عناصر قائمة الأوامر
+description: اعرض مكوّنات الواجهة الأمامية كإجراءات سريعة ومدخلات في قائمة الأوامر (Cmd+K) باستخدام ‎defineCommandMenuItem‎.
+icon: الطرفية
+---
+
+يُعَدّ **عنصر قائمة الأوامر** الجسر بين المستخدم و[مكوّن الواجهة الأمامية](/l/ar/developers/extend/apps/layout/front-components). يسجّل هذا العنصر المكوّن في قائمة الأوامر في Twenty‏ (Cmd+K)، وبشكل اختياري، كزر إجراء سريع مُثبَّت في الزاوية العلوية اليمنى من الصفحة.
+
+```ts src/command-menu-items/open-dashboard.command-menu-item.ts
+import { defineCommandMenuItem } from 'twenty-sdk/define';
+
+export default defineCommandMenuItem({
+ universalIdentifier: 'a1b2c3d4-e5f6-7890-abcd-ef1234567890',
+ label: 'Open Dashboard',
+ shortLabel: 'Dashboard',
+ icon: 'IconLayoutDashboard',
+ isPinned: true,
+ availabilityType: 'GLOBAL',
+ frontComponentUniversalIdentifier: '74c526eb-cb68-4cf7-b05c-0dd8c288d948',
+});
+```
+
+## حقول التكوين
+
+| الحقل | مطلوب | الوصف |
+| --------------------------------------- | ----- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `universalIdentifier` | نعم | معرّف فريد ثابت للأمر |
+| `label` | نعم | التسمية الكاملة المعروضة في قائمة الأوامر (Cmd+K) |
+| `frontComponentUniversalIdentifier` | نعم | قيمة `universalIdentifier` للمكوّن الأمامي الذي يفتحه هذا الأمر |
+| `shortLabel` | لا | تسمية أقصر تُعرَض على زر الإجراء السريع المثبّت |
+| `icon` | لا | اسم الأيقونة المعروض بجانب التسمية (مثل `'IconBolt'` و`'IconSend'`) |
+| `isPinned` | لا | عند كونها `true`، يعرض الأمر كزر إجراء سريع في الزاوية العلوية اليمنى من الصفحة |
+| `availabilityType` | لا | تتحكّم في مكان ظهور الأمر: `'GLOBAL'` (متاح دائمًا)، و`'RECORD_SELECTION'` (فقط عند تحديد سجلات)، أو `'FALLBACK'` (يُعرَض عند عدم تطابق أي أوامر أخرى) |
+| `availabilityObjectUniversalIdentifier` | لا | تقييد الأمر بصفحات نوع كائن معيّن (مثل سجلات Company فقط) |
+| `conditionalAvailabilityExpression` | لا | تعبير منطقي يتحكّم ديناميكيًا في الظهور (انظر أدناه) |
+
+## أوامر بدون واجهة
+
+يُعَدّ عنصر قائمة الأوامر المقترن بـ[مكوّن واجهة أمامية بدون واجهة](/l/ar/developers/extend/apps/layout/front-components#headless-vs-non-headless) الطريقة القياسية لتوفير إجراء بنقرة واحدة — لتشغيل الشفرة أو التنقّل أو التأكيد ثم التنفيذ. تغطي صفحة مكوّنات الواجهة الأمامية [مكوّنات الأوامر في SDK](/l/ar/developers/extend/apps/layout/front-components#sdk-command-components) ‎(`Command`, `CommandLink`, `CommandModal`, `CommandOpenSidePanelPage`)‎ التي تتعامل مع نمط الإجراء-ثم-إلغاء التركيب.
+
+تدفق نموذجي:
+
+```tsx src/front-components/run-action.tsx
+import { defineFrontComponent } from 'twenty-sdk/define';
+import { Command } from 'twenty-sdk/command';
+import { CoreApiClient } from 'twenty-sdk/clients';
+
+const RunAction = () => {
+ const execute = async () => {
+ const client = new CoreApiClient();
+ await client.mutation({
+ createTask: {
+ __args: { data: { title: 'Created by my app' } },
+ id: true,
+ },
+ });
+ };
+
+ return <Command execute={execute} />;
+};
+
+export default defineFrontComponent({
+ universalIdentifier: 'e5f6a7b8-c9d0-1234-efab-345678901234',
+ name: 'run-action',
+ description: 'Creates a task from the command menu',
+ component: RunAction,
+ isHeadless: true,
+});
+```
+
+```ts src/command-menu-items/run-action.command-menu-item.ts
+import { defineCommandMenuItem } from 'twenty-sdk/define';
+
+export default defineCommandMenuItem({
+ universalIdentifier: 'f6a7b8c9-d0e1-2345-fabc-456789012345',
+ label: 'Run my action',
+ icon: 'IconPlayerPlay',
+ frontComponentUniversalIdentifier: 'e5f6a7b8-c9d0-1234-efab-345678901234',
+});
+```
+
+## تعابير الإتاحة الشرطية
+
+يتيح لك الحقل `conditionalAvailabilityExpression` التحكّم في وقت ظهور الأمر بناءً على سياق الصفحة الحالي. استورد متغيّرات ومشغّلات مضبوطة الأنواع من `twenty-sdk` لبناء التعابير:
+
+```ts src/command-menu-items/bulk-update.command-menu-item.ts
+import {
+ defineCommandMenuItem,
+ objectPermissions,
+ everyEquals,
+} from 'twenty-sdk/define';
+
+export default defineCommandMenuItem({
+ universalIdentifier: '...',
+ label: 'Bulk Update',
+ availabilityType: 'RECORD_SELECTION',
+ frontComponentUniversalIdentifier: '...',
+ conditionalAvailabilityExpression: everyEquals(
+ objectPermissions,
+ 'canUpdateObjectRecords',
+ true,
+ ),
+});
+```
+
+<Note>
+ `RECORD_SELECTION` تعني بالفعل وجود تحديد غير فارغ — استخدم `numberOfSelectedRecords` فقط لعرض الأعداد المحددة (على سبيل المثال `>= 2`).
+</Note>
+
+### متغيّرات السياق
+
+تُمثّل هذه المتغيّرات الحالة الحالية للصفحة:
+
+| المتغيّر | النوع | الوصف |
+| ------------------------------ | --------- | --------------------------------------------------------------- |
+| `pageType` | `string` | نوع الصفحة الحالي (مثل `'RecordIndexPage'` و`'RecordShowPage'`) |
+| `isInSidePanel` | `boolean` | ما إذا كان المكوّن معروضًا في لوحة جانبية |
+| `numberOfSelectedRecords` | `number` | عدد السجلات المحدّدة حاليًا |
+| `isSelectAll` | `boolean` | ما إذا كان "تحديد الكل" مفعّلًا |
+| `selectedRecords` | `array` | كائنات السجلات المحدّدة |
+| `favoriteRecordIds` | `array` | معرّفات السجلات المفضّلة |
+| `objectPermissions` | `object` | الأذونات الخاصة بنوع الكائن الحالي |
+| `targetObjectReadPermissions` | `object` | أذونات القراءة للكائن الهدف |
+| `targetObjectWritePermissions` | `object` | أذونات الكتابة للكائن الهدف |
+| `featureFlags` | `object` | أعلام الميزات المفعَّلة |
+| `objectMetadataItem` | `object` | بيانات التعريف لنوع الكائن الحالي |
+| `hasAnySoftDeleteFilterOnView` | `boolean` | ما إذا كان العرض الحالي يحتوي على مرشّح حذف منطقي |
+
+### المُشغِّلات
+
+جمّع المتغيّرات في تعابير منطقية:
+
+| المُشغِّل | الوصف |
+| ----------------------------------- | ------------------------------------------------------------------ |
+| `isDefined(value)` | `true` إذا لم تكن القيمة null/undefined |
+| `isNonEmptyString(value)` | `true` إذا كانت القيمة سلسلة غير فارغة |
+| `includes(array, value)` | `true` إذا كانت المصفوفة تحتوي على القيمة |
+| `includesEvery(array, prop, value)` | `true` إذا كانت خاصية كل عنصر تتضمن القيمة |
+| `every(array, prop)` | `true` إذا كانت الخاصية تُقيَّم كقيمة صادقة في كل عنصر |
+| `everyDefined(array, prop)` | `true` إذا كانت الخاصية معرّفة في كل عنصر |
+| `everyEquals(array, prop, value)` | `true` إذا كانت الخاصية تساوي القيمة في كل عنصر |
+| `some(array, prop)` | `true` إذا كانت الخاصية تُقيَّم كقيمة صادقة في عنصر واحد على الأقل |
+| `someDefined(array, prop)` | `true` إذا كانت الخاصية معرّفة في عنصر واحد على الأقل |
+| `someEquals(array, prop, value)` | `true` إذا كانت الخاصية تساوي القيمة في عنصر واحد على الأقل |
+| `someNonEmptyString(array, prop)` | `true` إذا كانت الخاصية سلسلة غير فارغة في عنصر واحد على الأقل |
+| `none(array, prop)` | `true` إذا كانت الخاصية تُقيَّم كقيمة زائفة في كل عنصر |
+| `noneDefined(array, prop)` | `true` إذا كانت الخاصية غير معرّفة في كل عنصر |
+| `noneEquals(array, prop, value)` | `true` إذا لم تكن الخاصية تساوي القيمة في أي عنصر |
diff --git a/packages/twenty-docs/l/ar/developers/extend/apps/layout/front-components.mdx b/packages/twenty-docs/l/ar/developers/extend/apps/layout/front-components.mdx
new file mode 100644
index 00000000000..7c83aab6eba
--- /dev/null
+++ b/packages/twenty-docs/l/ar/developers/extend/apps/layout/front-components.mdx
@@ -0,0 +1,545 @@
+---
+title: المكوّنات الأمامية
+description: أنشئ مكونات React تُعرَض داخل واجهة مستخدم Twenty ضمن بيئة معزولة (sandbox).
+icon: window-maximize
+---
+
+المكوّنات الأمامية هي مكوّنات React تُعرَض مباشرة داخل واجهة مستخدم Twenty. تعمل ضمن **Web Worker** معزول باستخدام Remote DOM — تكون شيفرتك في صندوق عزل لكنها تُعرَض أصيلًا داخل الصفحة، وليس ضمن iframe.
+
+## أين يمكن استخدام مكوّنات الواجهة الأمامية
+
+يمكن عرض مكوّنات الواجهة الأمامية في موقعين داخل Twenty:
+
+* **اللوحة الجانبية** — المكوّنات غير عديمة الرأس تفتح في اللوحة الجانبية اليمنى. هذا هو السلوك الافتراضي عندما يتم تشغيل مكوّن واجهة أمامية من قائمة الأوامر.
+* **الويدجت (لوحات المعلومات وصفحات السجلات)** — يمكن تضمين مكوّنات الواجهة الأمامية كويدجت داخل [تخطيطات الصفحات](/l/ar/developers/extend/apps/layout/page-layouts). عند تكوين لوحة معلومات أو تخطيط صفحة سجل، يمكن للمستخدمين إضافة ويدجت لمكوّن واجهة أمامية.
+
+مكوّن الواجهة الأمامية بمفرده لا يمكن الوصول إليه من واجهة المستخدم — تحتاج إلى *عرضه*. هناك طريقتان للقيام بذلك:
+
+* **إقرانه مع [عنصر قائمة الأوامر](/l/ar/developers/extend/apps/layout/command-menu-items)** — يقوم بتسجيله في قائمة الأوامر (Cmd+K) واختياريًا كإجراء سريع مُثبّت.
+* **تضمينه كويدجت في [تخطيط صفحة](/l/ar/developers/extend/apps/layout/page-layouts)** — يضعه في صفحة تفاصيل السجل أو لوحة المعلومات.
+
+## مثال أساسي
+
+أسرع طريقة لرؤية مكوّن الواجهة الأمامية أثناء العمل هي إقرانه مع [`defineCommandMenuItem`](/l/ar/developers/extend/apps/layout/command-menu-items)، بحيث يظهر كزر إجراء سريع في الزاوية العلوية اليمنى من الصفحة:
+
+```tsx src/front-components/hello-world.tsx
+import { defineFrontComponent } from 'twenty-sdk/define';
+
+const HelloWorld = () => {
+ return (
+ <div style={{ padding: '20px', fontFamily: 'sans-serif' }}>
+ <h1>Hello from my app!</h1>
+ <p>This component renders inside Twenty.</p>
+ </div>
+ );
+};
+
+export default defineFrontComponent({
+ universalIdentifier: '74c526eb-cb68-4cf7-b05c-0dd8c288d948',
+ name: 'hello-world',
+ description: 'A simple front component',
+ component: HelloWorld,
+});
+```
+
+```ts src/command-menu-items/hello-world.command-menu-item.ts
+import { defineCommandMenuItem } from 'twenty-sdk/define';
+
+export default defineCommandMenuItem({
+ universalIdentifier: 'd4e5f6a7-b8c9-0123-defa-456789012345',
+ shortLabel: 'Hello',
+ label: 'Hello World',
+ icon: 'IconBolt',
+ isPinned: true,
+ availabilityType: 'GLOBAL',
+ frontComponentUniversalIdentifier: '74c526eb-cb68-4cf7-b05c-0dd8c288d948',
+});
+```
+
+بعد المزامنة باستخدام `yarn twenty dev` (أو تشغيل الأمر لمرة واحدة `yarn twenty dev --once`)، يظهر الإجراء السريع في الزاوية العلوية اليمنى من الصفحة:
+
+<div style={{textAlign: 'center'}}>
+ <img src="/images/docs/developers/extends/apps/quick-action.png" alt="زر إجراء سريع في الزاوية العلوية اليمنى" />
+</div>
+
+انقره لعرض المكوّن مضمنًا داخل الصفحة.
+
+## حقول التكوين
+
+| الحقل | مطلوب | الوصف |
+| --------------------- | ----- | ------------------------------------------------------------- |
+| `universalIdentifier` | نعم | معرّف فريد ثابت لهذا المكوّن |
+| `component` | نعم | دالة مكوّن React |
+| `name` | لا | الاسم المعروض |
+| `description` | لا | وصف لما يفعله المكوّن |
+| `isHeadless` | لا | عيّنه على `true` إذا كان المكوّن بلا واجهة مرئية (انظر أدناه) |
+
+## وضع مكوّن أمامي على صفحة
+
+إضافةً إلى الأوامر، يمكنك تضمين مكوّن أمامي مباشرةً في صفحة سجل عبر إضافته كودجت في **تخطيط صفحة**. لمزيد من التفاصيل، راجع [تخطيطات الصفحات](/l/ar/developers/extend/apps/layout/page-layouts).
+
+## عديم الرأس مقابل غير عديم الرأس
+
+تأتي مكوّنات الواجهة الأمامية بوضعَي عرض يتحكّم بهما الخيار `isHeadless`:
+
+**غير عديم الرأس (افتراضي)** — يعرض المكوّن واجهة مستخدم مرئية. عند تشغيله من قائمة الأوامر يفتح في اللوحة الجانبية. هذا هو السلوك الافتراضي عندما تكون `isHeadless` تساوي `false` أو يتم تجاهلها.
+
+**عديم الرأس (`isHeadless: true`)** — يتم تركيب المكوّن بشكل غير مرئي في الخلفية. لا يفتح اللوحة الجانبية. تم تصميم المكوّنات عديمة الرأس لإجراءات تنفّذ منطقًا ثم تُزيل تركيبها ذاتيًا — على سبيل المثال، تشغيل مهمة غير متزامنة، أو الانتقال إلى صفحة، أو إظهار نافذة تأكيد منبثقة. تتوافق بشكل طبيعي مع مكوّنات Command في SDK الموصوفة أدناه.
+
+```tsx src/front-components/sync-tracker.tsx
+import { defineFrontComponent } from 'twenty-sdk/define';
+import { useRecordId, enqueueSnackbar } from 'twenty-sdk/front-component';
+import { useEffect } from 'react';
+
+const SyncTracker = () => {
+ const recordId = useRecordId();
+
+ useEffect(() => {
+ enqueueSnackbar({ message: `Tracking record ${recordId}`, variant: 'info' });
+ }, [recordId]);
+
+ return null;
+};
+
+export default defineFrontComponent({
+ universalIdentifier: '...',
+ name: 'sync-tracker',
+ description: 'Tracks record views silently',
+ isHeadless: true,
+ component: SyncTracker,
+});
+```
+
+نظرًا لأن المكوّن يُرجع `null`، فإن Twenty يتخطّى عرض حاوية له — ولن تظهر مساحة فارغة في التخطيط. لا يزال لدى المكوّن إمكانية الوصول إلى جميع الخطافات وواجهة برمجة الاتصال مع المضيف.
+
+## مكوّنات Command في SDK
+
+توفر حزمة `twenty-sdk` أربعة مكوّنات مساعدة من نوع Command مصممة للمكوّنات عديمة الرأس في الواجهة الأمامية. كل مكوّن ينفّذ إجراءً عند التركيب، ويتعامل مع الأخطاء بعرض إشعار Snackbar، ويزيل تركيب مكوّن الواجهة الأمامية تلقائيًا عند الانتهاء.
+
+استوردها من `twenty-sdk/command`:
+
+* **`Command`** — يشغّل رد نداء غير متزامن عبر الخاصية `execute`.
+* **`CommandLink`** — ينتقل إلى مسار في التطبيق. الخصائص: `to`، `params`، `queryParams`، `options`.
+* **`CommandModal`** — يفتح نافذة تأكيد منبثقة. إذا أكّد المستخدم، ينفّذ رد النداء `execute`. الخصائص: `title`، `subtitle`، `execute`، `confirmButtonText`، `confirmButtonAccent`.
+* **`CommandOpenSidePanelPage`** — يفتح صفحة محدّدة في اللوحة الجانبية. الخصائص: `page`، `pageTitle`، `pageIcon`.
+
+فيما يلي مثال كامل لمكوّن واجهة أمامية عديم الرأس يستخدم `Command` لتشغيل إجراء من قائمة الأوامر:
+
+```tsx src/front-components/run-action.tsx
+import { defineFrontComponent } from 'twenty-sdk/define';
+import { Command } from 'twenty-sdk/command';
+import { CoreApiClient } from 'twenty-sdk/clients';
+
+const RunAction = () => {
+ const execute = async () => {
+ const client = new CoreApiClient();
+
+ await client.mutation({
+ createTask: {
+ __args: { data: { title: 'Created by my app' } },
+ id: true,
+ },
+ });
+ };
+
+ return <Command execute={execute} />;
+};
+
+export default defineFrontComponent({
+ universalIdentifier: 'e5f6a7b8-c9d0-1234-efab-345678901234',
+ name: 'run-action',
+ description: 'Creates a task from the command menu',
+ component: RunAction,
+ isHeadless: true,
+});
+```
+
+```ts src/command-menu-items/run-action.command-menu-item.ts
+import { defineCommandMenuItem } from 'twenty-sdk/define';
+
+export default defineCommandMenuItem({
+ universalIdentifier: 'f6a7b8c9-d0e1-2345-fabc-456789012345',
+ label: 'Run my action',
+ icon: 'IconPlayerPlay',
+ frontComponentUniversalIdentifier: 'e5f6a7b8-c9d0-1234-efab-345678901234',
+});
+```
+
+ومثال يستخدم `CommandModal` لطلب التأكيد قبل التنفيذ:
+
+```tsx src/front-components/delete-draft.tsx
+import { defineFrontComponent } from 'twenty-sdk/define';
+import { CommandModal } from 'twenty-sdk/command';
+
+const DeleteDraft = () => {
+ const execute = async () => {
+ // perform the deletion
+ };
+
+ return (
+ <CommandModal
+ title="Delete draft?"
+ subtitle="This action cannot be undone."
+ execute={execute}
+ confirmButtonText="Delete"
+ confirmButtonAccent="danger"
+ />
+ );
+};
+
+export default defineFrontComponent({
+ universalIdentifier: 'a7b8c9d0-e1f2-3456-abcd-567890123456',
+ name: 'delete-draft',
+ description: 'Deletes a draft with confirmation',
+ component: DeleteDraft,
+ isHeadless: true,
+});
+```
+
+## استدعاء دالة منطقية
+
+تعمل مكونات الواجهة الأمامية في المتصفح داخل Web Worker معزول، بينما تعمل [الدوال المنطقية](/l/ar/developers/extend/apps/logic/logic-functions) على جانب الخادم. لا توجد استدعاءات مباشرة ضمن العملية بين الاثنين — بدلاً من ذلك، يصل مكون الواجهة الأمامية إلى الدالة المنطقية عبر HTTP.
+
+يتم إتاحة الدالة المنطقية المُعلَنة باستخدام `httpRouteTriggerSettings` تحت نقطة النهاية `/s/` عند `${TWENTY_API_URL}/s\<path>`. يستدعي مكون الواجهة الأمامية ذلك المسار باستخدام `RestApiClient` من `twenty-client-sdk/rest`، والذي يقوم بالمصادقة باستخدام `TWENTY_APP_ACCESS_TOKEN` الذي تقوم Twenty بحقنه في الـ worker.
+
+تم تصميم `RestApiClient` خصيصًا لهذا الغرض. يقوم بقراءة `TWENTY_API_URL` و`TWENTY_APP_ACCESS_TOKEN` من بيئة الـ worker، وإرفاق ترويسة `Authorization: Bearer`، وتسلسل وتحليل JSON، وإثارة `RestApiClientError` عندما يكون الرمز المميز أو عنوان URL مفقودًا أو عندما يكون الرد غير 2xx — حتى لا تعيد تنفيذ هذا الـ boilerplate في كل مكون.
+
+يمكن لمكون واجهة أمامية عديم الرأس تنفيذ الاستدعاء عند التركيب عبر مكون `Command`، ثم إلغاء التركيب تلقائيًا:
+
+```tsx src/front-components/sync-prs.tsx
+import { defineFrontComponent } from 'twenty-sdk/define';
+import { Command } from 'twenty-sdk/command';
+import { RestApiClient } from 'twenty-client-sdk/rest';
+
+const SyncPrs = () => {
+ const execute = async () => {
+ const client = new RestApiClient();
+
+ await client.post('/s/github/fetch-prs', {
+ owner: 'twentyhq',
+ repo: 'twenty',
+ });
+ };
+
+ return <Command execute={execute} />;
+};
+
+export default defineFrontComponent({
+ universalIdentifier: '...',
+ name: 'sync-prs',
+ description: 'Triggers the fetch-prs logic function',
+ isHeadless: true,
+ component: SyncPrs,
+});
+```
+
+المسار المُمرَّر إلى العميل هو المسار العام للمسار (route) — قيمة `httpRouteTriggerSettings.path` الخاصة بدالة المنطق (logic function) مع إضافة البادئة `/s`. أبقِ `isAuthRequired: true`؛ يزوّد العميل مكوّنك برمز وصول التطبيق الذي تُصدِره Twenty:
+
+```ts src/logic-functions/fetch-prs.logic-function.ts
+import { defineLogicFunction } from 'twenty-sdk/define';
+import type { RoutePayload } from 'twenty-sdk/logic-function';
+
+const handler = async (event: RoutePayload) => {
+ const { owner, repo } = (event.body ?? {}) as { owner: string; repo: string };
+ // ...fetch from GitHub and persist records...
+ return { ok: true };
+};
+
+export default defineLogicFunction({
+ universalIdentifier: '...',
+ name: 'fetch-prs',
+ handler,
+ httpRouteTriggerSettings: {
+ path: '/github/fetch-prs',
+ httpMethod: 'POST',
+ isAuthRequired: true,
+ },
+});
+```
+
+<Note>
+يتم حقن `TWENTY_API_URL` و`TWENTY_APP_ACCESS_TOKEN` تلقائيًا — انظر [متغيرات التطبيق](#application-variables). نظرًا لأن متغيرات التطبيق السرية لا تُعرَض أبدًا على مكونات الواجهة الأمامية، احتفِظ بمفاتيح واجهة برمجة التطبيقات والمنطق الحساس الآخر داخل الدالة المنطقية، وليس في مكون الواجهة الأمامية.
+</Note>
+
+### مرجع RestApiClient
+
+استورد `RestApiClient` من `twenty-client-sdk/rest`. ينتمي إلى نفس عائلة العملاء مثل `CoreApiClient` و`MetadataApiClient`، لكنه يستهدف مسارات HTTP الخاصة بتطبيقك بدلاً من واجهة GraphQL API.
+
+| طريقة | الوصف |
+| --------------------------------- | -------------------------- |
+| `get(path, options?)` | يرسل طلبًا من نوع `GET` |
+| `post(path, body?, options?)` | يرسل طلبًا من نوع `POST` |
+| `put(path, body?, options?)` | يرسل طلبًا من نوع `PUT` |
+| `patch(path, body?, options?)` | يرسل طلبًا من نوع `PATCH` |
+| `delete(path, options?)` | يرسل طلبًا من نوع `DELETE` |
+| `request(method, path, options?)` | طلب عام بأي طريقة HTTP |
+
+تدعم `options` كلًا من `headers` و`query` (سجل لمعاملات query-string؛ يتم تخطي القيم nullish) و`AbortSignal` عبر `signal`. يتم تسلسل كائن `body` غير من النوع `FormData` إلى JSON تلقائيًا. عند حدوث `401`، يقوم العميل بتحديث رمز الوصول مرة واحدة عبر المضيف ثم يعيد محاولة الطلب.
+
+يتم تحديد عنوان URL الأساسي والرمز من بيئة التشغيل بشكل افتراضي. مرِّر معاملات تجاوز (overrides) إلى المُنشئ (constructor) عند الحاجة — على سبيل المثال في الاختبارات:
+
+```ts
+const client = new RestApiClient({
+ baseUrl: 'https://api.example.com',
+ token: 'my-token',
+});
+```
+
+ترمي الطلبات الفاشلة خطأً من نوع `RestApiClientError` يعرِّض خصائص `status` و`statusText` و`url` بالإضافة إلى `body` بعد تحليله (parsed):
+
+```tsx
+import { RestApiClient, RestApiClientError } from 'twenty-client-sdk/rest';
+
+const client = new RestApiClient();
+
+try {
+ const prs = await client.get('/s/github/fetch-prs', {
+ query: { state: 'open' },
+ });
+} catch (error) {
+ if (error instanceof RestApiClientError) {
+ console.error(error.status, error.body);
+ }
+}
+```
+
+## الوصول إلى سياق وقت التشغيل
+
+داخل مكوّنك، استخدم خطافات SDK للوصول إلى المستخدم الحالي، والسجل، ومثيل المكوّن:
+
+```tsx src/front-components/record-info.tsx
+import { defineFrontComponent } from 'twenty-sdk/define';
+import {
+ useUserId,
+ useRecordId,
+ useFrontComponentId,
+} from 'twenty-sdk/front-component';
+
+const RecordInfo = () => {
+ const userId = useUserId();
+ const recordId = useRecordId();
+ const componentId = useFrontComponentId();
+
+ return (
+ <div>
+ <p>User: {userId}</p>
+ <p>Record: {recordId ?? 'No record context'}</p>
+ <p>Component: {componentId}</p>
+ </div>
+ );
+};
+
+export default defineFrontComponent({
+ universalIdentifier: 'b2c3d4e5-f6a7-8901-bcde-f23456789012',
+ name: 'record-info',
+ component: RecordInfo,
+});
+```
+
+الخطافات المتاحة:
+
+| الخطّاف | القيم المعادة | الوصف |
+| --------------------------------------------- | --------------------- | ---------------------------------------------------------------------- |
+| `useUserId()` | `string` أو `null` | معرّف المستخدم الحالي |
+| `useSelectedRecordIds()` | `string[]` | جميع معرّفات السجلات المحددة (مصفوفة فارغة إذا لم يتم تحديد أي منها) |
+| `useRecordId()` | `string` أو `null` | **مهمل.** استخدم `useSelectedRecordIds()` بدلاً من ذلك |
+| `useFrontComponentId()` | `string` | معرّف مثيل هذا المكوّن |
+| `useColorScheme()` | `'light'` أو `'dark'` | نظام الألوان النشط لواجهة المستخدم المضيفة (`System` تم تحديده بالفعل) |
+| `useFrontComponentExecutionContext(selector)` | يختلف | الوصول إلى سياق التنفيذ الكامل عبر دالة محدِّد |
+
+## متغيرات التطبيق
+
+متغيرات التطبيق المُعرَّفة في [`defineApplication()`](/l/ar/developers/extend/apps/config/application) مع `isSecret: false` تكون متاحة داخل مكوّنات الواجهة عبر أداة `getApplicationVariable`:
+
+```tsx src/front-components/greeting.tsx
+import { defineFrontComponent } from 'twenty-sdk/define';
+import { getApplicationVariable } from 'twenty-sdk/front-component';
+
+const Greeting = () => {
+ const recipientName = getApplicationVariable('DEFAULT_RECIPIENT_NAME') ?? 'World';
+
+ return <p>Hello, {recipientName}!</p>;
+};
+
+export default defineFrontComponent({
+ universalIdentifier: '...',
+ name: 'greeting',
+ component: Greeting,
+});
+```
+
+<Warning>
+المتغيرات السرّية (`isSecret: true`) **لا** يتم كشفها لمكوّنات الواجهة. هي متاحة فقط في [دوال المنطق](/l/ar/developers/extend/apps/logic/logic-functions)، التي تعمل على جهة الخادم. هذا يمنع إرسال القيم الحساسة مثل مفاتيح API إلى المتصفح.
+</Warning>
+
+متغيرات النظام التالية تكون متاحة دائمًا عبر `process.env`:
+
+| المتغيّر | الوصف |
+| ------------------------- | --------------------------------------- |
+| `TWENTY_API_URL` | عنوان URL الأساسي لـ Twenty API |
+| `TWENTY_APP_ACCESS_TOKEN` | رمز مميز قصير العمر مُقيَّد بدور تطبيقك |
+
+## واجهة الاتصال مع المضيف
+
+يمكن للمكوّنات الأمامية تشغيل التنقّل والنوافذ المنبثقة والإشعارات باستخدام دوال من `twenty-sdk`:
+
+| دالة | الوصف |
+| ----------------------------------------------- | ------------------------------ |
+| `navigate(to, params?, queryParams?, options?)` | الانتقال إلى صفحة داخل التطبيق |
+| `openSidePanelPage(params)` | فتح لوحة جانبية |
+| `closeSidePanel()` | إغلاق اللوحة الجانبية |
+| `openCommandConfirmationModal(params)` | عرض مربع حوار تأكيد |
+| `enqueueSnackbar(params)` | عرض إشعار توست |
+| `unmountFrontComponent()` | إلغاء تركيب المكوّن |
+| `updateProgress(progress)` | تحديث مؤشّر التقدّم |
+
+فيما يلي مثال يستخدم واجهة برمجة تطبيقات المضيف لعرض Snackbar وإغلاق اللوحة الجانبية بعد اكتمال الإجراء:
+
+```tsx src/front-components/archive-record.tsx
+import { defineFrontComponent } from 'twenty-sdk/define';
+import { useRecordId } from 'twenty-sdk/front-component';
+import { enqueueSnackbar, closeSidePanel } from 'twenty-sdk/front-component';
+import { CoreApiClient } from 'twenty-sdk/clients';
+
+const ArchiveRecord = () => {
+ const recordId = useRecordId();
+
+ const handleArchive = async () => {
+ const client = new CoreApiClient();
+
+ await client.mutation({
+ updateTask: {
+ __args: { id: recordId, data: { status: 'ARCHIVED' } },
+ id: true,
+ },
+ });
+
+ await enqueueSnackbar({
+ message: 'Record archived',
+ variant: 'success',
+ });
+
+ await closeSidePanel();
+ };
+
+ return (
+ <div style={{ padding: '20px' }}>
+ <p>Archive this record?</p>
+ <button onClick={handleArchive}>Archive</button>
+ </div>
+ );
+};
+
+export default defineFrontComponent({
+ universalIdentifier: 'c9d0e1f2-a3b4-5678-cdef-789012345678',
+ name: 'archive-record',
+ description: 'Archives the current record',
+ component: ArchiveRecord,
+});
+```
+
+### العمل مع سجلات متعددة
+
+استخدم `useSelectedRecordIds()` لمعالجة عدة سجلات محددة. هذا مفيد للعمليات المجمّعة:
+
+```tsx src/front-components/bulk-export.tsx
+import { defineFrontComponent, numberOfSelectedRecords } from 'twenty-sdk/define';
+import { useSelectedRecordIds } from 'twenty-sdk/front-component';
+import { enqueueSnackbar, closeSidePanel } from 'twenty-sdk/front-component';
+import { CoreApiClient } from 'twenty-sdk/clients';
+
+const BulkExport = () => {
+ const selectedRecordIds = useSelectedRecordIds();
+
+ const handleExport = async () => {
+ const client = new CoreApiClient();
+
+ for (const recordId of selectedRecordIds) {
+ await client.mutation({
+ updateTask: {
+ __args: { id: recordId, data: { exported: true } },
+ id: true,
+ },
+ });
+ }
+
+ await enqueueSnackbar({
+ message: `Exported ${selectedRecordIds.length} records`,
+ variant: 'success',
+ });
+
+ await closeSidePanel();
+ };
+
+ return (
+ <div style={{ padding: '20px' }}>
+ <p>Export {selectedRecordIds.length} selected record(s)?</p>
+ <button onClick={handleExport}>Export</button>
+ </div>
+ );
+};
+
+export default defineFrontComponent({
+ universalIdentifier: 'd0e1f2a3-b4c5-6789-defa-012345678901',
+ name: 'bulk-export',
+ description: 'Export selected records',
+ component: BulkExport,
+ command: {
+ universalIdentifier: 'd0e1f2a3-b4c5-6789-defa-012345678902',
+ label: 'Bulk Export',
+ availabilityType: 'RECORD_SELECTION',
+ conditionalAvailabilityExpression: numberOfSelectedRecords > 0,
+ },
+});
+```
+
+## الأصول العامة
+
+يمكن للمكوّنات الأمامية الوصول إلى ملفات من دليل `public/` للتطبيق باستخدام `getPublicAssetUrl`:
+
+```tsx
+import { defineFrontComponent } from 'twenty-sdk/define';
+import { getPublicAssetUrl } from 'twenty-sdk/utils';
+
+const Logo = () => <img src={getPublicAssetUrl('logo.png')} alt="Logo" />;
+
+export default defineFrontComponent({
+ universalIdentifier: '...',
+ name: 'logo',
+ component: Logo,
+});
+```
+
+راجع [قسم الأصول العامة](/l/ar/developers/extend/apps/config/public-assets) للتفاصيل.
+
+## التنسيق
+
+تدعم المكوّنات الأمامية عدة أساليب للتنسيق. يمكنك استخدام:
+
+* **أنماط مضمنة** — `style={{ color: 'red' }}`
+* **مكوّنات Twenty لواجهة المستخدم** — استورد من `twenty-sdk/ui` (Button وTag وStatus وChip وAvatar وغيرها)
+* **Emotion** — CSS-in-JS مع `@emotion/react`
+* **Styled-components** — أنماط `styled.div`
+* **Tailwind CSS** — أصناف مساعدة
+* **أي مكتبة CSS-in-JS** متوافقة مع React
+
+```tsx
+import { defineFrontComponent } from 'twenty-sdk/define';
+import { Button, Tag, Status } from 'twenty-sdk/ui';
+
+const StyledWidget = () => {
+ return (
+ <div style={{ padding: '16px', display: 'flex', gap: '8px' }}>
+ <Button title="Click me" onClick={() => alert('Clicked!')} />
+ <Tag text="Active" color="green" />
+ <Status color="green" text="Online" />
+ </div>
+ );
+};
+
+export default defineFrontComponent({
+ universalIdentifier: 'e5f6a7b8-c9d0-1234-efab-567890123456',
+ name: 'styled-widget',
+ component: StyledWidget,
+});
+```
diff --git a/packages/twenty-docs/l/ar/developers/extend/apps/layout/navigation-menu-items.mdx b/packages/twenty-docs/l/ar/developers/extend/apps/layout/navigation-menu-items.mdx
new file mode 100644
index 00000000000..43fe180a165
--- /dev/null
+++ b/packages/twenty-docs/l/ar/developers/extend/apps/layout/navigation-menu-items.mdx
@@ -0,0 +1,44 @@
+---
+title: عناصر قائمة التنقّل
+description: أضِف إدخالات مخصّصة إلى الشريط الجانبي لمساحة العمل — روابط إلى العروض المحفوظة أو عناوين URL خارجية.
+icon: bars
+---
+
+يُعَدّ **عنصر قائمة التنقّل** إدخالًا في الشريط الجانبي الأيسر. استخدم `defineNavigationMenuItem()` لتوفير روابط شريط جانبي مخصّصة — عادةً واحدًا لكل [عرض](/l/ar/developers/extend/apps/layout/views) توفّره — أو للإشارة إلى عناوين URL خارجية.
+
+```ts src/navigation-menu-items/example-navigation-menu-item.ts
+import { defineNavigationMenuItem, NavigationMenuItemType } from 'twenty-sdk/define';
+import { EXAMPLE_VIEW_UNIVERSAL_IDENTIFIER } from '../views/example-view';
+
+export default defineNavigationMenuItem({
+ universalIdentifier: '9327db91-afa1-41b6-bd9d-2b51a26efb4c',
+ name: 'example-navigation-menu-item',
+ icon: 'IconList',
+ color: 'blue',
+ position: 0,
+ type: NavigationMenuItemType.VIEW,
+ viewUniversalIdentifier: EXAMPLE_VIEW_UNIVERSAL_IDENTIFIER,
+});
+```
+
+## النقاط الرئيسية
+
+* يحدّد `type` ما الذي يرتبط به عنصر القائمة. كل نوع يقترن بحقل معرّف محدّد:
+
+ | النوع | ماذا يفعل | حقل مطلوب |
+ | ------------------------------------ | ------------------------------------- | -------------------------------------------------------------------------- |
+ | `NavigationMenuItemType.VIEW` | يفتح عرضًا محفوظًا | `viewUniversalIdentifier` |
+ | `NavigationMenuItemType.LINK` | يفتح عنوان URL خارجيًا | `link` |
+ | `NavigationMenuItemType.FOLDER` | يجمع العناصر المتداخلة تحت تسمية | `name` (وتشير العناصر الفرعية إلى المجلّد عبر `folderUniversalIdentifier`) |
+ | `NavigationMenuItemType.OBJECT` | يفتح صفحة الفهرس الافتراضية لكائنٍ ما | `targetObjectUniversalIdentifier` |
+ | `NavigationMenuItemType.PAGE_LAYOUT` | يفتح مخطّط صفحة مستقلًا | `pageLayoutUniversalIdentifier` |
+
+* `position` يتحكّم في الترتيب ضمن الشريط الجانبي.
+
+* `icon` و`color` اختياريان ويخصّصان مظهر الإدخال.
+
+* `folderUniversalIdentifier` متاح أيضًا على أي عنصر لوضعه متداخلًا داخل عنصر أب من النوع `FOLDER`.
+
+<Note>
+**مشكلة شائعة:** إنشاء كائن بدون عرض مرتبط + عنصر قائمة تنقّل يجعل ذلك الكائن غير مرئي للمستخدمين. ما لم يكن كائنًا تقنيًا/داخليًا، يجب أن يحتوي كل كائن مخصّص على عرض افتراضي *وعنصر* في الشريط الجانبي يشير إليه.
+</Note>
diff --git a/packages/twenty-docs/l/ar/developers/extend/apps/layout/overview.mdx b/packages/twenty-docs/l/ar/developers/extend/apps/layout/overview.mdx
new file mode 100644
index 00000000000..dff8c971f83
--- /dev/null
+++ b/packages/twenty-docs/l/ar/developers/extend/apps/layout/overview.mdx
@@ -0,0 +1,56 @@
+---
+title: نظرة عامة
+description: ضع تطبيقك داخل واجهة مستخدم Twenty — إدخالات الشريط الجانبي، العروض المحفوظة، علامات تبويب صفحة السجل، ومكوّنات React المعزولة (sandboxed).
+icon: table-columns
+---
+
+تمثّل **طبقة التخطيط** في تطبيق Twenty كل ما يراه المستخدم: مكان ظهور التطبيق في الشريط الجانبي، العروض القائِمية التي يوفّرها، كيفية ترتيب صفحات تفاصيل السجل، وأي مكوّنات React مخصّصة يتم عرضها داخل تلك الصفحات.
+
+```text
+ Sidebar Record list Record detail page
+ ─────── ─────────── ──────────────────
+ [📋 My View] ────▶ ┌──────────┐ ┌─────────────────────┐
+ [📋 Drafts ] │ Companies│ │ Tabs: [Overview ] │
+ [📋 Inbox ] │ ──────── │ │ [Notes ] │
+ ▲ │ Apple │ │ [Hello ]◀──── definePageLayoutTab
+ │ │ Acme │ │ │ adds a tab...
+ └ defineNavi- │ … │ │ ┌────────────────┐ │
+ gationMenu- └────▲─────┘ │ │ │ │
+ Item points │ │ │ React UI │◀── …with a
+ to a defineView │ │ │ (sandboxed in │ │ defineFrontComponent
+ └ defineView │ │ a Worker) │ │ widget inside
+ picks columns │ └────────────────┘ │
+ and filters └─────────────────────┘
+```
+
+## في هذا القسم
+
+<CardGroup cols={2}>
+ <Card title="العروض" icon="list" href="/l/ar/developers/extend/apps/layout/views">
+ `defineView` — تكوينات قوائم محفوظة: الأعمدة الظاهرة، وعوامل التصفية، والمجموعات.
+ </Card>
+ <Card title="عناصر قائمة التنقّل" icon="bars" href="/l/ar/developers/extend/apps/layout/navigation-menu-items">
+ `defineNavigationMenuItem` — إدخالات في الشريط الجانبي تشير إلى العروض أو عناوين URL الخارجية.
+ </Card>
+ <Card title="تخطيطات الصفحات" icon="table-columns" href="/l/ar/developers/extend/apps/layout/page-layouts">
+ `definePageLayout` و`definePageLayoutTab` — علامات التبويب والويدجتات في صفحة تفاصيل السجل.
+ </Card>
+ <Card title="المكوّنات الأمامية" icon="window-maximize" href="/l/ar/developers/extend/apps/layout/front-components">
+ `defineFrontComponent` — مكوّنات React معزولة (sandboxed) يتم عرضها داخل Twenty.
+ </Card>
+ <Card title="عناصر قائمة الأوامر" icon="terminal" href="/l/ar/developers/extend/apps/layout/command-menu-items">
+ `defineCommandMenuItem` — تسجيل مكوّنات الواجهة الأمامية كإدخالات Cmd+K وإجراءات سريعة.
+ </Card>
+</CardGroup>
+
+## أين يظهر التطبيق
+
+| موضع الظهور | ما الذي يتحكّم فيه | كيان |
+| ------------------------- | ------------------------------------------------------------------------- | ----------------------------------------- |
+| **الشريط الجانبي** | إدخال مخصّص يربط بعرض محفوظ أو عنوان URL خارجي | `defineNavigationMenuItem` |
+| **قائمة السجلات** | تكوين محفوظ لكائن — الأعمدة الظاهرة، والترتيب، وعوامل التصفية، والمجموعات | `defineView` |
+| **صفحة تفاصيل السجل** | علامات التبويب والويدجتات في صفحة السجل (لكائنك الخاص أو لكائن قياسي) | `definePageLayout`, `definePageLayoutTab` |
+| **داخل أي مما سبق** | ويدجت React مخصّص — أزرار، نماذج، لوحات بيانات، تكاملات | `defineFrontComponent` |
+| **قائمة الأوامر (Cmd+K)** | إجراء سريع مُثبّت أو أمر مخفي | `defineCommandMenuItem` |
+
+تعمل مكوّنات الواجهة الأمامية داخل Web Worker معزول باستخدام Remote DOM — يتم عرضها بشكل أصيل داخل الصفحة (وليس داخل iframe)، لكنها لا تستطيع الوصول مباشرةً إلى صفحة المضيف أو إلى DOM. يحدث التواصل مع Twenty من خلال واجهة API للمضيف تعتمد تمرير الرسائل.
diff --git a/packages/twenty-docs/l/ar/developers/extend/apps/layout/page-layouts.mdx b/packages/twenty-docs/l/ar/developers/extend/apps/layout/page-layouts.mdx
new file mode 100644
index 00000000000..58fe0cc2b08
--- /dev/null
+++ b/packages/twenty-docs/l/ar/developers/extend/apps/layout/page-layouts.mdx
@@ -0,0 +1,132 @@
+---
+title: تخطيطات الصفحات
+description: خصص صفحات تفاصيل السجل — الألسنة، وعناصر الواجهة (widgets)، وأماكن عرض مكوّنات الواجهة الأمامية (front components) — باستخدام `definePageLayout` و `definePageLayoutTab`.
+icon: table-columns
+---
+
+يتحكم **تخطيط الصفحة** في كيفية ترتيب صفحة تفاصيل السجل: ما هي الألسنة التي تظهر وما عناصر الواجهة (widgets) التي تحتوي عليها. استخدم `definePageLayout()` للتصريح عن تخطيط لكائن تملكه، أو `definePageLayoutTab()` لإضافة لسان واحد إلى تخطيط موجود مسبقًا (سواء كان مِلكك أو تخطيط Twenty قياسيًا).
+
+| حالة استخدام | كيان |
+| -------------------------------------------------------------- | --------------------- |
+| عرِّف التخطيط الكامل لصفحة سجل على كائن تملكه | `definePageLayout` |
+| أضف لسانًا واحدًا إلى تخطيط موجود (لكائن تملكه أو تخطيط قياسي) | `definePageLayoutTab` |
+
+## definePageLayout
+
+استخدم هذا عندما تملك صفحة التفاصيل بالكامل — عادةً لكائن مخصص قمت بتعريفه بنفسك.
+
+```ts src/page-layouts/example-record-page-layout.ts
+import { definePageLayout, PageLayoutTabLayoutMode } from 'twenty-sdk/define';
+import { EXAMPLE_OBJECT_UNIVERSAL_IDENTIFIER } from '../objects/example-object';
+import { HELLO_WORLD_FRONT_COMPONENT_UNIVERSAL_IDENTIFIER } from '../front-components/hello-world';
+
+export default definePageLayout({
+ universalIdentifier: '203aeb94-6701-46d6-9af1-be2bbcc9e134',
+ name: 'Example Record Page',
+ type: 'RECORD_PAGE',
+ objectUniversalIdentifier: EXAMPLE_OBJECT_UNIVERSAL_IDENTIFIER,
+ tabs: [
+ {
+ universalIdentifier: '6ed26b60-a51d-4ad7-86dd-1c04c7f3cac5',
+ title: 'Hello World',
+ position: 50,
+ icon: 'IconWorld',
+ layoutMode: PageLayoutTabLayoutMode.CANVAS,
+ widgets: [
+ {
+ universalIdentifier: 'aa4234e0-2e5f-4c02-a96a-573449e2351d',
+ title: 'Hello World',
+ type: 'FRONT_COMPONENT',
+ configuration: {
+ configurationType: 'FRONT_COMPONENT',
+ frontComponentUniversalIdentifier:
+ HELLO_WORLD_FRONT_COMPONENT_UNIVERSAL_IDENTIFIER,
+ },
+ },
+ ],
+ },
+ ],
+});
+```
+
+### النقاط الرئيسية
+
+* `type` يكون عادة `'RECORD_PAGE'` لتخصيص عرض التفاصيل لكائن محدّد.
+* `objectUniversalIdentifier` يحدّد الكائن الذي ينطبق عليه هذا التخطيط.
+* يُعرّف كل `tab` قسمًا من الصفحة مع `title` و`position` و`layoutMode` (`CANVAS` لتخطيط حرّ).
+* يمكن لكل `widget` داخل لسان أن يعرض [front component](/l/ar/developers/extend/apps/layout/front-components)، أو قائمة علاقات، أو أنواعًا أخرى من عناصر الواجهة (widgets) المدمجة.
+* `position` على الألسنة يتحكّم في ترتيبها. استخدم قيمًا أعلى (مثل 50) لوضع الألسنة المخصّصة بعد الألسنة المدمجة.
+
+## definePageLayoutTab
+
+استخدم هذا عندما تريد فقط **إضافة** لسان إلى تخطيط موجود — على سبيل المثال، لسان تحليلات في صفحة Company القياسية، أو لسان ملخص بالذكاء الاصطناعي مرفق بتخطيط الكائن الخاص بك.
+
+```ts src/page-layouts/example-extra-tab.ts
+import {
+ definePageLayoutTab,
+ PageLayoutTabLayoutMode,
+ STANDARD_PAGE_LAYOUT_UNIVERSAL_IDENTIFIERS,
+} from 'twenty-sdk/define';
+import { HELLO_WORLD_FRONT_COMPONENT_UNIVERSAL_IDENTIFIER } from '../front-components/hello-world';
+
+export default definePageLayoutTab({
+ universalIdentifier: 'b1b2b3b4-b5b6-4000-8000-000000000001',
+ pageLayoutUniversalIdentifier:
+ STANDARD_PAGE_LAYOUT_UNIVERSAL_IDENTIFIERS.companyRecordPage
+ .universalIdentifier,
+ title: 'Hello World',
+ position: 1000,
+ icon: 'IconWorld',
+ layoutMode: PageLayoutTabLayoutMode.CANVAS,
+ widgets: [
+ {
+ universalIdentifier: 'b1b2b3b4-b5b6-4000-8000-000000000002',
+ title: 'Hello World',
+ type: 'FRONT_COMPONENT',
+ configuration: {
+ configurationType: 'FRONT_COMPONENT',
+ frontComponentUniversalIdentifier:
+ HELLO_WORLD_FRONT_COMPONENT_UNIVERSAL_IDENTIFIER,
+ },
+ },
+ ],
+});
+```
+
+### النقاط الرئيسية
+
+* إن `pageLayoutUniversalIdentifier` **مطلوب** ويجب أن يشير إلى تخطيط صفحة موجود بالفعل وقت التثبيت — سواء كان تخطيط Twenty قياسيًا أو تخطيطًا معرّفًا بواسطة تطبيقك الخاص. المراجع المتقاطعة بين التطبيقات إلى التخطيطات المملوكة لتطبيق آخر مُثبَّت غير مدعومة حاليًا. عند فقدان التخطيط الأب، يفشل التثبيت مع ظهور خطأ تحقق واضح.
+
+* بالنسبة لتخطيطات Twenty القياسية، استورد المعرفات من `twenty-sdk/define`:
+
+ ```ts
+ import { STANDARD_PAGE_LAYOUT_UNIVERSAL_IDENTIFIERS } from 'twenty-sdk/define';
+
+ // STANDARD_PAGE_LAYOUT_UNIVERSAL_IDENTIFIERS.companyRecordPage.universalIdentifier
+ // STANDARD_PAGE_LAYOUT_UNIVERSAL_IDENTIFIERS.personRecordPage.universalIdentifier
+ // STANDARD_PAGE_LAYOUT_UNIVERSAL_IDENTIFIERS.taskRecordPage.universalIdentifier
+ // STANDARD_PAGE_LAYOUT_UNIVERSAL_IDENTIFIERS.opportunityRecordPage.universalIdentifier
+ // STANDARD_PAGE_LAYOUT_UNIVERSAL_IDENTIFIERS.noteRecordPage.universalIdentifier
+ // …
+ ```
+
+ كل إدخال تخطيط يوفّر أيضًا `tabs` الخاصة به و`widgets` التابعة لها، بحيث يمكنك الرجوع إلى أي مستوى:
+
+ ```ts
+ STANDARD_PAGE_LAYOUT_UNIVERSAL_IDENTIFIERS.taskRecordPage.tabs.home.universalIdentifier
+ STANDARD_PAGE_LAYOUT_UNIVERSAL_IDENTIFIERS.taskRecordPage.tabs.home.widgets.fields.universalIdentifier
+ ```
+
+ يتوفر أيضًا اسم قصير `STANDARD_PAGE_LAYOUT`:
+
+ ```ts
+ import { STANDARD_PAGE_LAYOUT } from 'twenty-sdk/define';
+
+ STANDARD_PAGE_LAYOUT.companyRecordPage.universalIdentifier;
+ ```
+
+* يكون نطاق `widgets` مقتصرًا على هذا اللسان فقط — فهي تشير إلى [front components](/l/ar/developers/extend/apps/layout/front-components)، والعروض، وما إلى ذلك تمامًا مثل عناصر الواجهة (widgets) المُعرَّفة مضمّنة داخل `definePageLayout`.
+
+* `position` يتحكّم في الترتيب مقارنةً بعلامات التبويب الموجودة على التخطيط المستهدف. اختر قيمة تضع علامة التبويب الخاصة بك في الموضع الذي تريده بالنسبة إلى علامات التبويب المضمنة.
+
+* استخدم هذا بدلًا من `definePageLayout` عندما تريد فقط الإضافة إلى تخطيط موجود. استخدم `definePageLayout` عندما تملك التخطيط بالكامل.
diff --git a/packages/twenty-docs/l/ar/developers/extend/apps/layout/views.mdx b/packages/twenty-docs/l/ar/developers/extend/apps/layout/views.mdx
new file mode 100644
index 00000000000..5a0ae63a709
--- /dev/null
+++ b/packages/twenty-docs/l/ar/developers/extend/apps/layout/views.mdx
@@ -0,0 +1,97 @@
+---
+title: العروض
+description: قم بتوفير عروض محفوظة مُعدّة مسبقًا — ترتيب الأعمدة، المرشّحات، المجموعات — للكائنات في تطبيقك.
+icon: list
+---
+
+يُعد **العرض** تكوينًا محفوظًا لكيفية عرض سجلات كائن معيّن: ما هي الحقول التي تظهر، وترتيبها، وما إذا كانت مرئية، وأي عوامل تصفية أو مجموعات مُطبَّقة. استخدم `defineView()` لتوفير عروض مُعدّة مسبقًا مع تطبيقك — عادةً عرض فهرس افتراضي لكل كائن مخصص تقوم بإنشائه.
+
+```ts src/views/example-view.ts
+import { defineView, ViewKey } from 'twenty-sdk/define';
+import { EXAMPLE_OBJECT_UNIVERSAL_IDENTIFIER } from '../objects/example-object';
+import { NAME_FIELD_UNIVERSAL_IDENTIFIER } from '../objects/example-object';
+
+export default defineView({
+ universalIdentifier: 'a1b2c3d4-e5f6-7890-abcd-ef1234567890',
+ name: 'All example items',
+ objectUniversalIdentifier: EXAMPLE_OBJECT_UNIVERSAL_IDENTIFIER,
+ icon: 'IconList',
+ key: ViewKey.INDEX,
+ position: 0,
+ fields: [
+ {
+ universalIdentifier: 'f926bdb7-6af7-4683-9a09-adbca56c29f0',
+ fieldMetadataUniversalIdentifier: NAME_FIELD_UNIVERSAL_IDENTIFIER,
+ position: 0,
+ isVisible: true,
+ size: 200,
+ },
+ ],
+});
+```
+
+## النقاط الرئيسية
+
+* `objectUniversalIdentifier` يحدّد الكائن الذي ينطبق عليه هذا العرض. يمكن أن يكون كائنًا مخصصًا قمتَ بتعريفه أو كائن Twenty قياسيًا.
+* يحدّد `key` نوع العرض — يمثّل `ViewKey.INDEX` عرض القائمة الرئيسي للكائن.
+* يتحكّم `fields` في الأعمدة التي تظهر وترتيبها. يشير كل حقل إلى `fieldMetadataUniversalIdentifier`.
+* يمكنك أيضًا تعريف `filters` و`filterGroups` و`groups` و`fieldGroups` لتكوينات أكثر تقدمًا.
+* يتحكّم `position` في الترتيب عند وجود عدة عروض لنفس الكائن.
+
+## الفلاتر
+
+يمكن أن تأتي طريقة العرض مع عوامل تصفية مُطبَّقة مسبقًا. لكل عامل تصفية ثلاثة مكونات: **الحقل** الذي تُطبَّق عليه التصفية، و**المعامل** (كيفية المقارنة)، و**القيمة** (ما تتم المقارنة به). يجب أن تتطابق العناصر الثلاثة جميعًا — حيث سيتم رفض استخدام معامل لا ينطبق على نوع الحقل في وقت المزامنة.
+
+```ts
+import { ViewFilterOperand } from 'twenty-shared/types';
+
+filters: [
+ {
+ universalIdentifier: '...',
+ fieldMetadataUniversalIdentifier: STATUS_FIELD_UNIVERSAL_IDENTIFIER,
+ operand: ViewFilterOperand.IS,
+ value: ['ACTIVE'],
+ },
+],
+```
+
+### المعاملات المدعومة حسب نوع الحقل
+
+| نوع الحقل | العوامل المدعومة |
+| -------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------ |
+| `TEXT`, `EMAILS`, `FULL_NAME`, `ADDRESS`, `LINKS`, `PHONES`, `RAW_JSON`, `FILES`, `ACTOR`, `ARRAY` | `CONTAINS`, `DOES_NOT_CONTAIN`, `IS_EMPTY`, `IS_NOT_EMPTY` |
+| `ACTOR.source`, `ACTOR.workspaceMemberId` | `IS`, `IS_NOT`, `IS_EMPTY`, `IS_NOT_EMPTY` |
+| `SELECT` | `IS`, `IS_NOT`, `IS_EMPTY`, `IS_NOT_EMPTY` |
+| `MULTI_SELECT` | `CONTAINS`, `DOES_NOT_CONTAIN`, `IS_EMPTY`, `IS_NOT_EMPTY` |
+| `RELATION` | `IS`, `IS_NOT`, `IS_EMPTY`, `IS_NOT_EMPTY` |
+| `NUMBER` | `IS`, `IS_NOT`, `GREATER_THAN_OR_EQUAL`, `LESS_THAN_OR_EQUAL`, `IS_EMPTY`, `IS_NOT_EMPTY` |
+| `RATING` | `IS`, `GREATER_THAN_OR_EQUAL`, `LESS_THAN_OR_EQUAL`, `IS_EMPTY`, `IS_NOT_EMPTY` |
+| `CURRENCY`, `CURRENCY.amountMicros` | `GREATER_THAN_OR_EQUAL`, `LESS_THAN_OR_EQUAL`, `IS`, `IS_NOT`, `IS_EMPTY`, `IS_NOT_EMPTY` |
+| `CURRENCY.currencyCode` | `IS`, `IS_NOT`, `IS_EMPTY`, `IS_NOT_EMPTY` |
+| `DATE`, `DATE_TIME` | `IS`, `IS_RELATIVE`, `IS_IN_PAST`, `IS_IN_FUTURE`, `IS_TODAY`, `IS_BEFORE`, `IS_AFTER`, `IS_EMPTY`, `IS_NOT_EMPTY` |
+| `BOOLEAN` | `IS` |
+| `UUID` | `IS`, `IS_NOT`, `IS_EMPTY`, `IS_NOT_EMPTY` |
+| `TS_VECTOR` | `VECTOR_SEARCH` |
+
+> يمكن لأنواع الحقول ذات الأسماء المتشابهة أن تستخدم عوامل مختلفة تمامًا — حيث يُعد `SELECT` و`MULTI_SELECT` حالة شائعة.
+
+### شكل القيمة لكل عامل
+
+حقل `value` هو دائمًا قيمة قابلة للتسلسل إلى JSON، لكن شكله المتوقَّع يعتمد على العامل:
+
+| عائلة العامل | شكل القيمة | مثال |
+| ------------------------------------------------------- | -------------------------------------- | ------------------------ |
+| `IS`, `IS_NOT` على `SELECT` | مصفوفة من مفاتيح الخيارات (سلاسل نصية) | `['ACTIVE', 'PENDING']` |
+| `CONTAINS`, `DOES_NOT_CONTAIN` على `MULTI_SELECT` | مصفوفة من مفاتيح الخيارات (سلاسل نصية) | `['TAG_A']` |
+| `IS`, `IS_NOT` على `RELATION` | مصفوفة من معرّفات السجلات (uuids) | `['c5a1...']` |
+| `CONTAINS`, `DOES_NOT_CONTAIN` على الحقول المشابهة للنص | سلسلة نصية | `'acme'` |
+| `IS`, `IS_NOT` على `NUMBER` | سلسلة نصية (القيمة) | `'5'` |
+| `IS` على `RATING` / `UUID` | سلسلة نصية (القيمة) | `'5'` |
+| `GREATER_THAN_OR_EQUAL`, `LESS_THAN_OR_EQUAL` | سلسلة نصية (الحد) | `'10'` |
+| `IS`, `IS_BEFORE`, `IS_AFTER` على `DATE` / `DATE_TIME` | سلسلة نصية بتنسيق ISO 8601 | `'2025-01-01T00:00:00Z'` |
+| `IS_EMPTY`, `IS_NOT_EMPTY` | سلسلة فارغة | `''` |
+| `IS` على `BOOLEAN` | `'true'` أو `'false'` | `'true'` |
+
+## كيفية ظهور العروض في واجهة المستخدم
+
+لا يمكن الوصول إلى العرض بمفرده من الشريط الجانبي. لجعله يظهر هناك، قم بربطه مع [عنصر قائمة تنقّل](/l/ar/developers/extend/apps/layout/navigation-menu-items) من النوع `VIEW` يشير إلى قيمة `universalIdentifier` الخاصة بالعرض. هذا هو النمط القياسي: عادةً ما يوفّر كل كائن مخصص عرضًا افتراضيًا + إدخالًا في الشريط الجانبي يفتحه.
diff --git a/packages/twenty-docs/l/ar/developers/extend/apps/logic/connections.mdx b/packages/twenty-docs/l/ar/developers/extend/apps/logic/connections.mdx
new file mode 100644
index 00000000000..a22d7b4c784
--- /dev/null
+++ b/packages/twenty-docs/l/ar/developers/extend/apps/logic/connections.mdx
@@ -0,0 +1,192 @@
+---
+title: الاتصالات
+description: اسمح لتطبيقك بالتصرف نيابةً عن المستخدم في خدمات الجهات الخارجية عبر OAuth.
+icon: plug
+---
+
+الاتصالات هي بيانات اعتماد يحتفظ بها المستخدم لخدمة خارجية (Linear وGitHub وSlack، ...). يحدّد تطبيقك **كيف** يتم الحصول على تلك بيانات الاعتماد — **موفّر اتصال** — ويستخدمها وقت التشغيل لإجراء استدعاءات مُصادَقة إلى واجهة برمجة تطبيقات الطرف الثالث.
+
+حاليًا لا يُدعَم سوى OAuth 2.0. ستندمج الأنواع المستقبلية من بيانات الاعتماد (رموز الوصول الشخصية، مفاتيح API، المصادقة الأساسية) مع نفس الواجهة — التطبيقات التي تستخدم بالفعل `defineConnectionProvider({ type: 'oauth', ... })` لن تحتاج إلى الترحيل.
+
+<AccordionGroup>
+
+<Accordion title="defineConnectionProvider" description="عرّف كيفية الحصول على اتصالات تطبيقك">
+
+يصف موفّر الاتصال عملية المصافحة الخاصة بـ OAuth التي يحتاجها تطبيقك. ينقر المستخدم على "إضافة اتصال" في إعدادات تطبيقك، ويُكمل شاشة موافقة المزوّد، ثم يتم إنشاء صف `ConnectedAccount` في مساحة عمله.
+
+يتطلّب الإعداد العملي **ملفّين** — موفّر الاتصال، وتصريح `serverVariables` مطابق في `defineApplication` يحتفظ ببيانات اعتماد عميل OAuth.
+
+```ts src/connection-providers/linear-connection.ts
+import { defineConnectionProvider } from 'twenty-sdk/define';
+
+export default defineConnectionProvider({
+ universalIdentifier: '9c7d1f5e-6a0b-4d44-be0c-3f8b5a9d4e6f',
+ name: 'linear',
+ displayName: 'Linear',
+ icon: 'IconBrandLinear',
+ type: 'oauth',
+ oauth: {
+ authorizationEndpoint: 'https://linear.app/oauth/authorize',
+ tokenEndpoint: 'https://api.linear.app/oauth/token',
+ scopes: ['read', 'write'],
+ // These must match keys in `defineApplication.serverVariables` below.
+ clientIdVariable: 'LINEAR_CLIENT_ID',
+ clientSecretVariable: 'LINEAR_CLIENT_SECRET',
+ // Optional: defaults to 'json'. Some providers (Linear, Slack) want
+ // 'form-urlencoded' for the token request.
+ tokenRequestContentType: 'form-urlencoded',
+ // Optional: defaults to true. Disable only if the provider rejects PKCE.
+ usePkce: false,
+ // Optional: extra query params on the authorize URL.
+ // authorizationParams: { prompt: 'consent' },
+ // Optional: provider's RFC 7009 token revocation endpoint, called on disconnect.
+ // revokeEndpoint: 'https://example.com/oauth/revoke',
+ },
+});
+```
+
+```ts src/application.config.ts
+import { defineApplication } from 'twenty-sdk/define';
+
+export default defineApplication({
+ universalIdentifier: '...',
+ displayName: 'Linear',
+ description: 'Connect Linear to Twenty.',
+ // OAuth client credentials live on the app registration (one OAuth app per
+ // Twenty server, configured by the admin) — not per-workspace. Declare them
+ // as serverVariables so the admin can fill them in once for all installs.
+ serverVariables: {
+ LINEAR_CLIENT_ID: {
+ description: 'OAuth client ID from your Linear OAuth application.',
+ isSecret: false,
+ isRequired: true,
+ },
+ LINEAR_CLIENT_SECRET: {
+ description: 'OAuth client secret from your Linear OAuth application.',
+ isSecret: true,
+ isRequired: true,
+ },
+ },
+});
+```
+
+النقاط الرئيسية:
+
+* `name` هي سلسلة المعرّف الفريدة المستخدمة في `listConnections({ providerName })` (بصيغة kebab-case، ويجب أن تطابق `^[a-z][a-z0-9-]*$`).
+* `displayName` يظهر في علامة تبويب إعدادات كل تطبيق وفي قائمة أدوات الذكاء الاصطناعي.
+* `clientIdVariable` / `clientSecretVariable` هي **أسماء**، وليست قيماً — ويجب أن تطابق المفاتيح المصرَّح بها في `defineApplication.serverVariables`. يُدخِل مسؤول الخادم القيم الفعلية `client_id` و`client_secret` عبر واجهة تسجيل التطبيق، ولا تُضمَّن أبدًا في مستودعك.
+* استخدم `serverVariables` (وليس `applicationVariables`) — بيانات اعتماد OAuth على مستوى الخادم، ويوجد تطبيق OAuth واحد لكل خادم Twenty.
+* إلى أن يتم ملء كلا `serverVariables`، تعرض علامة تبويب إعدادات كل تطبيق تلميح "بحاجة إلى مسؤول الخادم" ويكون زر "إضافة اتصال" معطّلًا.
+* `type: 'oauth'` هي القيمة الوحيدة المدعومة حاليًا. المميِّز متوافق مع الإصدارات المستقبلية: الأنواع المستقبلية (`'pat'`، `'api-key'`، ...) ستضيف كُتل تهيئة فرعية جديدة إلى جانب `oauth`.
+
+عنوان URL لردّ النداء الخاص بـ OAuth الذي يحتاج موفّرك إلى إضافته إلى قائمة السماح هو:
+
+```
+https://<your-twenty-server>/auth/apps/callback
+```
+
+</Accordion>
+
+<Accordion title="listConnections / getConnection" description="استخدم الاتصالات من دالة منطقية">
+
+داخل معالج دالة منطقية، تُرجِع `listConnections({ providerName })` صفوف `ConnectedAccount` الخاصة بهذا التطبيق للمزوّد المحدَّد، مع رموز وصول محدَّثة.
+
+```ts src/logic-functions/handlers/create-linear-issue-handler.ts
+import { listConnections } from 'twenty-sdk/logic-function';
+
+export const createLinearIssueHandler = async (input: {
+ teamId?: string;
+ title?: string;
+}) => {
+ if (!input.teamId || !input.title) {
+ return { success: false, error: 'teamId and title are required' };
+ }
+
+ const connections = await listConnections({ providerName: 'linear' });
+
+ // Workspace-shared credentials win when present; fall back to the first
+ // user-visibility one. For HTTP-route triggers you typically pick the
+ // request user's connection via event.userWorkspaceId instead.
+ const connection =
+ connections.find((c) => c.visibility === 'workspace') ?? connections[0];
+
+ if (!connection) {
+ return {
+ success: false,
+ error:
+ 'Linear is not connected. Open the app settings and click "Add connection".',
+ };
+ }
+
+ // Use connection.accessToken to call the third-party API.
+ const response = await fetch('https://api.linear.app/graphql', {
+ method: 'POST',
+ headers: {
+ Authorization: `Bearer ${connection.accessToken}`,
+ 'Content-Type': 'application/json',
+ },
+ body: JSON.stringify({
+ query: `mutation { issueCreate(input: { teamId: "${input.teamId}", title: "${input.title}" }) { success } }`,
+ }),
+ });
+
+ return { success: response.ok };
+};
+```
+
+يحتوي كل اتصال على:
+
+| الحقل | الوصف |
+| ----------------- | ------------------------------------------------------------------------------------------------- |
+| `id` | معرّف صف فريد؛ مرّره إلى `getConnection(id)` لإعادة جلب واحد فقط |
+| `visibility` | `'user'` (خاص بعضو واحد في مساحة العمل) أو `'workspace'` (مشترك مع جميع الأعضاء) |
+| `scopes` | أذونات OAuth الممنوحة من قِبل المزوّد الأصلي (مختلفة عن `visibility` — ولا علاقة لها به) |
+| `userWorkspaceId` | معرّف userWorkspace للمالك — مفيد لاختيار "اتصال مستخدم الطلب" في مشغّلات مسارات HTTP |
+| `accessToken` | رمز وصول OAuth حديث (يُحدَّث تلقائيًا إذا انتهت صلاحيته) |
+| `name` / `handle` | الاسم المعروض للاتصال (يُستمد تلقائيًا عند ردّ نداء OAuth، وقابل لإعادة التسمية من قِبل المستخدم) |
+| `authFailedAt` | يُضبط عند فشل أحدث عملية تحديث؛ يجب على المستخدم إعادة الاتصال |
+
+النقاط الرئيسية:
+
+* مرّر `{ providerName }` للتصفية حسب المزوّد؛ واحذفه للحصول على كل الاتصالات التي يملكها هذا التطبيق عبر جميع المزوّدين.
+* يقوم الخادم بتحديث رمز الوصول بشفافية قبل الإرجاع. يرى معالجك دائمًا رمزًا صالحًا للاستخدام (أو سيكون `authFailedAt` مُعيّنًا).
+* `getConnection(id)` هي المعادِل لصف واحد.
+
+</Accordion>
+
+<Accordion title="رؤية خاصة بالمستخدم مقابل المشاركة على مستوى مساحة العمل" description="كيف يختار المستخدمون بين بيانات اعتماد خاصة ومشتركة">
+
+عند نقر المستخدم "إضافة اتصال"، سيُطلب منه اختيار مستوى الرؤية:
+
+* **لي فقط** — بيانات الاعتماد خاصة بالمستخدم الذي قام بالاتصال. ستتمكّن أي دالة منطقية تُستدعى بالنيابة عنه (مشغّل مسار HTTP مع `isAuthRequired: true`) من رؤيتها؛ أمّا مشغّلات cron وأحداث قاعدة البيانات فلا.
+* **مشتركة على مستوى مساحة العمل** — يمكن لأي عضو في مساحة العمل استخدام بيانات الاعتماد. يمكن لمشغّلات cron/قاعدة البيانات رؤيتها أيضًا، لأنها لا تملك مستخدم طلب.
+
+استخدم الخيار المناسب لكل معالج:
+
+```ts
+// HTTP-route trigger — prefer the request user's own connection.
+const conn =
+ connections.find((c) => c.userWorkspaceId === event.userWorkspaceId) ??
+ connections.find((c) => c.visibility === 'workspace');
+
+// Cron trigger — no request user; only shared credentials are sensible.
+const conn = connections.find((c) => c.visibility === 'workspace');
+```
+
+يُسمح بوجود اتصالات متعددة لكل (مستخدم، مزوّد)، لذا يمكن للمستخدم نفسه امتلاك "Linear شخصي" و"Linear للعمل" جنبًا إلى جنب.
+
+</Accordion>
+
+<Accordion title="إعداد المزوّد لمرة واحدة" description="سجّل تطبيق OAuth الخاص بك لدى خدمة الطرف الثالث">
+
+بالنسبة لكل موفّر اتصال، يحتاج مسؤول الخادم أولًا إلى تسجيل تطبيق OAuth لدى الطرف الثالث.
+
+1. انتقل إلى إعدادات المطوّر لدى المزوّد (مثل https://linear.app/settings/api/applications/new).
+2. عيّن **Redirect URI** إلى `\<SERVER_URL>/auth/apps/callback`.
+3. انسخ **Client ID** و**Client Secret** المُنشأين.
+4. افتح التطبيق المُثبَّت في Twenty كمسؤول خادم → عيّن القيم على `serverVariables` المقابلة.
+5. بعد ذلك، يمكن لأعضاء مساحة العمل إضافة الاتصالات من قسم **الاتصالات** الخاص بكل تطبيق.
+
+</Accordion>
+
+</AccordionGroup>
diff --git a/packages/twenty-docs/l/ar/developers/extend/apps/logic/logic-functions.mdx b/packages/twenty-docs/l/ar/developers/extend/apps/logic/logic-functions.mdx
new file mode 100644
index 00000000000..8dc9935ed6f
--- /dev/null
+++ b/packages/twenty-docs/l/ar/developers/extend/apps/logic/logic-functions.mdx
@@ -0,0 +1,514 @@
+---
+title: الوظائف المنطقية
+description: عرّف دوال TypeScript على جانب الخادم مع HTTP وcron ومشغّلات أحداث قاعدة البيانات.
+icon: bolt
+---
+
+دوال المنطق هي دوال TypeScript على جانب الخادم تعمل على منصة Twenty. يمكن تشغيلها بواسطة طلبات HTTP أو جداول cron أو أحداث قاعدة البيانات — كما يمكن إتاحتها كأدوات لوكلاء الذكاء الاصطناعي.
+
+<AccordionGroup>
+<Accordion title="defineLogicFunction" description="عرّف الدوال المنطقية ومشغّلاتها">
+
+كل ملف وظيفة يستخدم `defineLogicFunction()` لتصدير تكوين مع معالج ومشغّلات اختيارية.
+
+```ts src/logic-functions/createPostCard.logic-function.ts
+import { defineLogicFunction } from 'twenty-sdk/define';
+import type { RoutePayload } from 'twenty-sdk/logic-function';
+import { CoreApiClient } from 'twenty-client-sdk/core';
+
+const handler = async (params: RoutePayload) => {
+ const client = new CoreApiClient();
+ const body = (params.body ?? {}) as { name?: string };
+ const name = body.name ?? process.env.DEFAULT_RECIPIENT_NAME ?? 'Hello world';
+
+ const result = await client.mutation({
+ createPostCard: {
+ __args: { data: { name } },
+ id: true,
+ name: true,
+ },
+ });
+ return result;
+};
+
+export default defineLogicFunction({
+ universalIdentifier: 'e56d363b-0bdc-4d8a-a393-6f0d1c75bdcf',
+ name: 'create-new-post-card',
+ timeoutSeconds: 2,
+ handler,
+ httpRouteTriggerSettings: {
+ path: '/post-card/create',
+ httpMethod: 'POST',
+ isAuthRequired: true,
+ },
+ /*databaseEventTriggerSettings: {
+ eventName: 'people.created',
+ },*/
+ /*cronTriggerSettings: {
+ pattern: '0 0 1 1 *',
+ },*/
+});
+```
+
+أنواع المشغّلات المتاحة:
+* **httpRoute**: يعرِض وظيفتك على مسار وطريقة HTTP **تحت نقطة النهاية `/s/`**:
+> مثال: `path: '/post-card/create'` يمكن استدعاؤه عبر `https://your-twenty-server.com/s/post-card/create`
+
+<Note>
+لاستدعاء دالة منطقية يتم تشغيلها بواسطة مسار من مكون واجهة (بدون واجهة رسومية)، راجع قسم [استدعاء دالة منطقية](/l/ar/developers/extend/apps/layout/front-components#calling-a-logic-function).
+</Note>
+* **cron**: يشغّل وظيفتك على جدول باستخدام تعبير CRON.
+* **databaseEvent**: يعمل على أحداث دورة حياة كائنات مساحة العمل. عندما تكون عملية الحدث هي `updated`، يمكن تحديد الحقول المحددة المراد الاستماع إليها في مصفوفة `updatedFields`. إذا تُركت غير معرّفة أو فارغة، فسيؤدي أي تحديث إلى تشغيل الدالة.
+> مثال: `person.updated`، `*.created`، `company.*`
+
+<Note>
+يمكنك أيضًا تنفيذ دالة يدويًا باستخدام CLI:
+
+```bash filename="Terminal"
+yarn twenty dev:function:exec -n create-new-post-card -p '{"key": "value"}'
+```
+
+```bash filename="Terminal"
+yarn twenty dev:function:exec -u e56d363b-0bdc-4d8a-a393-6f0d1c75bdcf
+```
+
+يمكنك متابعة السجلات باستخدام:
+
+```bash filename="Terminal"
+yarn twenty dev:function:logs
+```
+</Note>
+
+#### حمولة مشغل المسار
+
+عندما يستدعي مُشغِّل المسار وظيفتك المنطقية، فإنها تتلقّى كائن `RoutePayload` الذي يتبع [صيغة AWS HTTP API v2](https://docs.aws.amazon.com/apigateway/latest/developerguide/http-api-develop-integrations-lambda.html).
+استورد نوع `RoutePayload` من `twenty-sdk/logic-function`:
+
+```ts
+import type { RoutePayload } from 'twenty-sdk/logic-function';
+
+const handler = async (event: RoutePayload) => {
+ const { headers, queryStringParameters, pathParameters, body } = event;
+ const { method, path } = event.requestContext.http;
+
+ return { message: 'Success' };
+};
+```
+
+يحتوي نوع `RoutePayload` على البنية التالية:
+
+ | الخاصية | النوع | الوصف | مثال |
+ | ---------------------------- | ------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------- |
+ | `headers` | `Record\<string, string \| undefined>` | رؤوس HTTP (فقط تلك المدرجة في `forwardedRequestHeaders`) | انظر القسم أدناه |
+ | `queryStringParameters` | `Record\<string, string \| undefined>` | معلمات سلسلة الاستعلام (تُضمّ القيم المتعددة باستخدام فواصل) | `/users?ids=1&ids=2&ids=3&name=Alice` -> `{ ids: '1,2,3', name: 'Alice' }` |
+ | `pathParameters` | `Record\<string, string \| undefined>` | معلمات المسار المستخرجة من نمط المسار | `/users/:id`, `/users/123` -> `{ id: '123' }` |
+ | `body` | `object \| null` | جسم الطلب المُحلَّل (JSON) | `{ id: 1 }` -> `{ id: 1 }` |
+ | `rawBody` | `string \| undefined` | نص الطلب الأصلي بترميز UTF-8، قبل تحليل JSON. مفيد للتحقق من تواقيع خطافات الويب على نمط HMAC (مثل `X-Hub-Signature-256` الخاص بـ GitHub وStripe). `undefined` عندما لم يحتفظ وقت التشغيل بها. | |
+ | `isBase64Encoded` | `boolean` | ما إذا كان جسم الطلب مُرمَّزًا بترميز base64 | |
+ | `requestContext.http.method` | `string` | طريقة HTTP (GET, POST, PUT, PATCH, DELETE) | |
+ | `requestContext.http.path` | `string` | المسار الخام للطلب | |
+
+
+#### forwardedRequestHeaders
+
+افتراضيًا، **لا** تُمرَّر رؤوس HTTP من الطلبات الواردة إلى دالتك المنطقية لأسباب أمنية.
+للوصول إلى رؤوس محددة، أدرِجها في مصفوفة `forwardedRequestHeaders`:
+
+```ts
+export default defineLogicFunction({
+ universalIdentifier: 'e56d363b-0bdc-4d8a-a393-6f0d1c75bdcf',
+ name: 'webhook-handler',
+ handler,
+ httpRouteTriggerSettings: {
+ path: '/webhook',
+ httpMethod: 'POST',
+ isAuthRequired: false,
+ forwardedRequestHeaders: ['x-webhook-signature', 'content-type'],
+ },
+});
+```
+
+في معالجك، يمكنك الوصول إلى الرؤوس المُمرَّرة بهذه الطريقة:
+
+```ts
+const handler = async (event: RoutePayload) => {
+ const signature = event.headers['x-webhook-signature'];
+ const contentType = event.headers['content-type'];
+
+ // Validate webhook signature...
+ return { received: true };
+};
+```
+
+<Note>
+تُحوَّل أسماء الرؤوس إلى أحرف صغيرة. يمكنك الوصول إليها باستخدام مفاتيح بأحرف صغيرة (على سبيل المثال، `event.headers['content-type']`).
+</Note>
+
+#### استجابة HTTP مخصصة
+
+بشكل افتراضي، فإن إرجاع قيمة بسيطة من المعالج الخاص بك يعيدها كاستجابة `200` (بصيغة JSON للكائنات و`text/plain` للسلاسل النصية). للتحكم في رمز الحالة ورؤوس الاستجابة، أعد كائن `Response` من `twenty-sdk/logic-function`:
+
+```ts
+import { Response } from 'twenty-sdk/logic-function';
+
+const handler = async (event: RoutePayload) => {
+ return new Response('<h1>Hello</h1>', {
+ status: 201,
+ headers: { 'content-type': 'text/html' },
+ });
+};
+```
+
+لأسباب أمنية، يتم تقييد ترويسات الاستجابة بقائمة مسموح بها. يتم إسقاط أي ترويسة ليست في القائمة (مثل `Set-Cookie`، وترويسات CORS مثل `Access-Control-Allow-Origin`، أو ترويسات `X-*` المخصصة) بصمت قبل إرسال الاستجابة. ترويسات الاستجابة المسموح بها هي:
+
+* `content-type`
+* `content-language`
+* `content-disposition`
+* `cache-control`
+* `retry-after`
+
+<Note>
+يجب أن يكون رمز الحالة رمز حالة HTTP صالحًا (بين 100 و599). تتم مطابقة أسماء ترويسات الاستجابة دون حساسية لحالة الأحرف.
+</Note>
+
+#### حمولة مُحفِّز حدث قاعدة البيانات
+
+عندما يستدعي مُحفِّز حدث قاعدة البيانات دالة المنطق الخاصة بك، فإنه يستقبل كائن `DatabaseEventPayload` واحدًا لكل سجل تم تغييره. تجمع الحمولة بين البيانات الوصفية حول مساحة العمل والكائن المصدر وبين الحدث على مستوى السجل.
+
+```ts
+import type {
+ DatabaseEventPayload,
+ ObjectRecordCreateEvent,
+ ObjectRecordDestroyEvent,
+ ObjectRecordUpdateEvent,
+} from 'twenty-sdk/logic-function';
+
+type Person = {
+ id: string;
+ emails?: { primaryEmail?: string };
+};
+```
+
+تتضمن الحمولة ما يلي:
+
+| الخاصية | الوصف |
+| ------------------------------------------------ | ----------------------------------------------------------------------------------------------- |
+| `name` | اسم الحدث، مثل `person.updated`. |
+| `workspaceId` | مساحة العمل التي وقع فيها الحدث. |
+| `objectMetadata` | بيانات وصفية للكائن الذي تم تغييره. |
+| `recordId` | معرّف السجل الذي تم تغييره. |
+| `userId`, `userWorkspaceId`, `workspaceMemberId` | حقول الفاعل عندما يكون الحدث ناتجًا عن مستخدم في مساحة العمل. |
+| `properties` | بيانات السجل الخاصة بالحدث، مع `before` و`after` و`diff` و`updatedFields` اعتمادًا على العملية. |
+
+| حدث | بيانات السجل |
+| ------------------ | -------------------------------------------------------------------------------------------------------------- |
+| `person.created` | `event.properties.after` |
+| `person.updated` | `event.properties.before`, `event.properties.after`, `event.properties.diff`, `event.properties.updatedFields` |
+| `person.destroyed` | `event.properties.before` |
+
+في عمليات الحذف اللين (soft deletes)، يتبع `.deleted` بنية نمط التحديث لأن حقل `deletedAt` في السجل يتغيّر.
+في عمليات الحذف الدائم، استخدم `.destroyed`.
+
+<Note>
+`databaseEventTriggerSettings.updatedFields` يرشّح أيّ أحداث التحديث التي تُشغِّل الدالة.
+`event.properties.updatedFields` يوضّح لك أي الحقول تغيّرت فعليًا في الحدث الحالي.
+</Note>
+
+مثال على حدث الإنشاء:
+
+```ts
+type PersonCreatedEvent = DatabaseEventPayload<
+ ObjectRecordCreateEvent<Person>
+>;
+
+const handler = async (event: PersonCreatedEvent) => {
+ const person = event.properties.after;
+
+ return {
+ personId: event.recordId,
+ email: person.emails?.primaryEmail,
+ };
+};
+```
+
+مثال على حدث التحديث:
+
+```ts
+type PersonUpdatedEvent = DatabaseEventPayload<
+ ObjectRecordUpdateEvent<Person>
+>;
+
+const handler = async (event: PersonUpdatedEvent) => {
+ const { before, after, diff, updatedFields } = event.properties;
+
+ return {
+ personId: event.recordId,
+ updatedFields,
+ previousEmail: before.emails?.primaryEmail,
+ currentEmail: after.emails?.primaryEmail,
+ emailDiff: diff.emails,
+ };
+};
+```
+
+تشغيل المشغّل فقط عند تحديثات البريد الإلكتروني:
+
+```ts
+export default defineLogicFunction({
+ ...,
+ databaseEventTriggerSettings: {
+ eventName: 'person.updated',
+ updatedFields: ['emails'],
+ },
+});
+```
+
+مثال على حدث الحذف:
+
+```ts
+type PersonDestroyedEvent = DatabaseEventPayload<
+ ObjectRecordDestroyEvent<Person>
+>;
+
+const handler = async (event: PersonDestroyedEvent) => {
+ const personBeforeDestroy = event.properties.before;
+
+ return {
+ personId: event.recordId,
+ email: personBeforeDestroy.emails?.primaryEmail,
+ };
+};
+```
+
+#### إتاحة دالة كأداة ذكاء اصطناعي أو كإجراء ضمن سير العمل
+
+يمكن إتاحة دوال المنطق على واجهتين، ولكلٍ منهما مشغِّل خاص به:
+
+* **`toolTriggerSettings`** — يجعل الدالة قابلة للاكتشاف عبر ميزات الذكاء الاصطناعي الخاصة بـ Twenty (الدردشة، MCP، استدعاء الدوال). يستخدم JSON Schema القياسي، وهو التنسيق الذي تفهمه LLMs أصلاً.
+* **`workflowActionTriggerSettings`** — يجعل الدالة تظهر كخطوة في منشئ سير العمل المرئي. يستخدم `InputSchema` الغني الخاص بـ Twenty لكي يتمكن المُنشئ من عرض محرّرات الحقول المناسبة، وأدوات انتقاء المتغيّرات، والتسميات.
+
+يمكن للدالة اختيار أحدهما، أو الآخر، أو كليهما. توجد جنبًا إلى جنب مع `cronTriggerSettings` و`databaseEventTriggerSettings` و`httpRouteTriggerSettings` — النمط نفسه، والشكل نفسه.
+
+```ts src/logic-functions/enrich-company.logic-function.ts
+import { defineLogicFunction } from 'twenty-sdk/define';
+import { CoreApiClient } from 'twenty-client-sdk/core';
+
+const handler = async (params: { companyName: string; domain?: string }) => {
+ const client = new CoreApiClient();
+
+ const result = await client.mutation({
+ createTask: {
+ __args: {
+ data: {
+ title: `Enrich data for ${params.companyName}`,
+ body: `Domain: ${params.domain ?? 'unknown'}`,
+ },
+ },
+ id: true,
+ },
+ });
+
+ return { taskId: result.createTask.id };
+};
+
+export default defineLogicFunction({
+ universalIdentifier: 'f47ac10b-58cc-4372-a567-0e02b2c3d479',
+ name: 'enrich-company',
+ description: 'Enrich a company record with external data',
+ timeoutSeconds: 10,
+ handler,
+ toolTriggerSettings: {},
+});
+```
+
+النقاط الرئيسية:
+
+* يمكن للدالة مزج الواجهات — صرِّح بكلٍ من `toolTriggerSettings` و`workflowActionTriggerSettings` لإتاحتها في الدردشة وفي منشئ سير العمل.
+* `toolTriggerSettings.inputSchema` و`workflowActionTriggerSettings.inputSchema` كلاهما اختياري. عند الإغفال، يستنتج مُنشئ البيان هذه المخططات من الشيفرة المصدرية للمعالج (JSON Schema لأداة الذكاء الاصطناعي، و`InputSchema` الخاصة بـ Twenty لإجراء سير العمل). قدّم واحدًا صراحةً عندما ترغب في أنواع أكثر ثراءً — على سبيل المثال، مع حقول واعية بـ `FieldMetadataType` مثل `CURRENCY` أو `RELATION` لمنشئ سير العمل، أو مع حقول `description` التي يمكن لوكيل الذكاء الاصطناعي قراءتها:
+
+```ts
+export default defineLogicFunction({
+ ...,
+ toolTriggerSettings: {
+ inputSchema: {
+ type: 'object',
+ properties: {
+ companyName: {
+ type: 'string',
+ description: 'The name of the company to enrich',
+ },
+ domain: {
+ type: 'string',
+ description: 'The company website domain (optional)',
+ },
+ },
+ required: ['companyName'],
+ },
+ },
+});
+```
+
+<Note>
+**اكتب `description` جيدًا.** يعتمد وكلاء الذكاء الاصطناعي على حقل `description` الخاص بالدالة لتحديد وقت استخدام الأداة. كن محددًا بشأن ما تفعله الأداة ومتى ينبغي استدعاؤها.
+</Note>
+
+</Accordion>
+</AccordionGroup>
+
+<Note>
+**خطافات التثبيت** — معالجات ما قبل التثبيت وما بعد التثبيت — تشترك في وقت التشغيل نفسه، ولكن يُصرَّح عنها بدوال تعريف خاصة بها ولا تأخذ إعدادات المشغّلات. راجع [خطافات التثبيت (Install Hooks)](/l/ar/developers/extend/apps/config/install-hooks) لمعرفة `definePreInstallLogicFunction` و `definePostInstallLogicFunction`.
+</Note>
+
+## عملاء واجهة برمجة تطبيقات مضبوطة الأنواع (`twenty-client-sdk`)
+
+توفر حزمة `twenty-client-sdk` عميلين لـ GraphQL ذوي أنواع ثابتة للتفاعل مع واجهة Twenty البرمجية من وظائفك المنطقية ومكوّنات الواجهة الأمامية.
+
+| العميل | استيراد | نقطة النهاية | مُولَّد؟ |
+| ------------------- | ---------------------------- | --------------------------------------------------- | -------------------------- |
+| `CoreApiClient` | `twenty-client-sdk/core` | `/graphql` — بيانات مساحة العمل (السجلات، الكائنات) | نعم، في وقت التطوير/البناء |
+| `MetadataApiClient` | `twenty-client-sdk/metadata` | `/metadata` — تكوين مساحة العمل، رفع الملفات | لا، يأتي مُجهزًا مسبقًا |
+
+<AccordionGroup>
+<Accordion title="CoreApiClient" description="استعلام وتعديل بيانات مساحة العمل (السجلات، الكائنات)">
+
+`CoreApiClient` هو العميل الرئيسي للاستعلام وتعديل بيانات مساحة العمل. يُولَّد **من مخطط مساحة العمل لديك** أثناء `yarn twenty dev` أو `yarn twenty dev:build`، لذا فهو مضبوط الأنواع بالكامل ليتوافق مع كائناتك وحقولك.
+
+```ts
+import { CoreApiClient } from 'twenty-client-sdk/core';
+
+const client = new CoreApiClient();
+
+// Query records
+const { companies } = await client.query({
+ companies: {
+ edges: {
+ node: {
+ id: true,
+ name: true,
+ domainName: {
+ primaryLinkLabel: true,
+ primaryLinkUrl: true,
+ },
+ },
+ },
+ },
+});
+
+// Create a record
+const { createCompany } = await client.mutation({
+ createCompany: {
+ __args: {
+ data: {
+ name: 'Acme Corp',
+ },
+ },
+ id: true,
+ name: true,
+ },
+});
+```
+
+يستخدم العميل صياغة مجموعة اختيار: مرِّر `true` لتضمين حقل، واستخدم `__args` للوسيطات، وعشّش الكائنات للعلاقات. ستحصل على إكمال تلقائي كامل وفحص للأنواع يعتمد على مخطط مساحة العمل لديك.
+
+<Note>
+**يتم توليد CoreApiClient في وقت التطوير/البناء.** إذا استخدمته دون تشغيل `yarn twenty dev` أو `yarn twenty dev:build` أولًا، فسيؤدي ذلك إلى خطأ. تحدث عملية التوليد تلقائيًا — إذ يستطلع CLI مخطط GraphQL لمساحة عملك وينشئ عميلًا مضبوط الأنواع باستخدام `@genql/cli`.
+</Note>
+
+#### استخدام CoreSchema للتعليقات التوضيحية للأنواع
+
+`CoreSchema` يوفّر أنواع TypeScript المطابقة لكائنات مساحة العمل لديك — مفيد لتعيين أنواع حالة المكوّن أو معاملات الدوال:
+
+```ts
+import { CoreApiClient, CoreSchema } from 'twenty-client-sdk/core';
+import { useState } from 'react';
+
+const [company, setCompany] = useState<
+ Pick<CoreSchema.Company, 'id' | 'name'> | undefined
+>(undefined);
+
+const client = new CoreApiClient();
+const result = await client.query({
+ company: {
+ __args: { filter: { position: { eq: 1 } } },
+ id: true,
+ name: true,
+ },
+});
+setCompany(result.company);
+```
+
+</Accordion>
+<Accordion title="MetadataApiClient" description="إعدادات مساحة العمل، والتطبيقات، ورفع الملفات">
+
+يأتي `MetadataApiClient` مُجهّزًا مسبقًا مع SDK (لا حاجة للتوليد). يستعلم عن نقطة النهاية `/metadata` للحصول على تكوين مساحة العمل والتطبيقات ورفع الملفات.
+
+```ts
+import { MetadataApiClient } from 'twenty-client-sdk/metadata';
+
+const metadataClient = new MetadataApiClient();
+
+// List first 10 objects in the workspace
+const { objects } = await metadataClient.query({
+ objects: {
+ edges: {
+ node: {
+ id: true,
+ nameSingular: true,
+ namePlural: true,
+ labelSingular: true,
+ isCustom: true,
+ },
+ },
+ __args: {
+ filter: {},
+ paging: { first: 10 },
+ },
+ },
+});
+```
+
+#### رفع الملفات
+
+يتضمن `MetadataApiClient` طريقة `uploadFile` لإرفاق الملفات بالحقول من نوع الملف:
+
+```ts
+import { MetadataApiClient } from 'twenty-client-sdk/metadata';
+import * as fs from 'fs';
+
+const metadataClient = new MetadataApiClient();
+
+const fileBuffer = fs.readFileSync('./invoice.pdf');
+
+const uploadedFile = await metadataClient.uploadFile(
+ fileBuffer, // file contents as a Buffer
+ 'invoice.pdf', // filename
+ 'application/pdf', // MIME type
+ '58a0a314-d7ea-4865-9850-7fb84e72f30b', // field universalIdentifier
+);
+
+console.log(uploadedFile);
+// { id: '...', path: '...', size: 12345, createdAt: '...', url: 'https://...' }
+```
+
+| المعلمة | النوع | الوصف |
+| ---------------------------------- | -------- | ---------------------------------------------------------------------- |
+| `fileBuffer` | `Buffer` | المحتوى الخام للملف |
+| `filename` | `string` | اسم الملف (يُستخدم للتخزين والعرض) |
+| `contentType` | `string` | نوع MIME (القيمة الافتراضية `application/octet-stream` إذا لم يُحدَّد) |
+| `fieldMetadataUniversalIdentifier` | `string` | قيمة `universalIdentifier` لحقل نوع الملف في كائنك |
+
+النقاط الرئيسية:
+* يستخدم `universalIdentifier` الخاص بالحقل (وليس معرّفه الخاص بمساحة العمل)، بحيث يعمل كود الرفع لديك عبر أي مساحة عمل مُثبَّت فيها تطبيقك.
+* العنوان `url` المُعاد هو عنوان URL موقّع يمكنك استخدامه للوصول إلى الملف المرفوع.
+
+</Accordion>
+</AccordionGroup>
+
+<Note>
+ عند تشغيل كودك على Twenty (وظائف منطقية أو مكوّنات أمامية)، يقوم النظام الأساسي بحقن بيانات الاعتماد كمتغيرات بيئية:
+
+ * `TWENTY_API_URL` — عنوان URL الأساسي لواجهة Twenty البرمجية
+ * `TWENTY_APP_ACCESS_TOKEN` — مفتاح قصير العمر ذو نطاق يقتصر على الدور الافتراضي لوظيفة تطبيقك
+
+ لست **بحاجة** إلى تمرير هذه القيم إلى العملاء — فهي تُقرأ تلقائيًا من `process.env`. تُحدَّد أذونات مفتاح واجهة برمجة التطبيقات بواسطة الدور المُعلن باستخدام `defineApplicationRole()` (أو المشار إليه عبر `defaultRoleUniversalIdentifier` في `application-config.ts`).
+</Note>
diff --git a/packages/twenty-docs/l/ar/developers/extend/apps/logic/overview.mdx b/packages/twenty-docs/l/ar/developers/extend/apps/logic/overview.mdx
new file mode 100644
index 00000000000..c5697d167b9
--- /dev/null
+++ b/packages/twenty-docs/l/ar/developers/extend/apps/logic/overview.mdx
@@ -0,0 +1,55 @@
+---
+title: نظرة عامة
+description: TypeScript على جانب الخادم الذي يعمل داخل Twenty — يتم تشغيله بواسطة مسارات HTTP، وجداول كرون، وأحداث قاعدة البيانات، وأدوات الذكاء الاصطناعي، أو إجراءات سير العمل.
+icon: bolt
+---
+
+**طبقة المنطق** في تطبيق Twenty هي الشيفرة التي *تعمل* — معالِجات TypeScript على جانب الخادم تستجيب لطلبات HTTP، وجداول كرون، وتغييرات السجلات؛ ومهارات ووكلاء الذكاء الاصطناعي التي تعمل داخل مساحة العمل؛ واتصالات OAuth التي تتيح لدوالّك العمل نيابةً عن المستخدم في الخدمات الخارجية.
+
+```text
+ ┌─ HTTP route ──┐
+ │ Cron schedule │
+ │ Database event │ ┌────────────────────┐
+ triggers ─┤ AI tool call ├─────▶│ Logic function │
+ │ Workflow action │ │ (your handler) │
+ │ Manual exec │ └────────────────────┘
+ └────────────────────┘ │
+ ▼
+ ┌────────────────────────────┐
+ │ Twenty API (records) │
+ │ Third-party API │
+ │ (via Connection token) │
+ └────────────────────────────┘
+```
+
+## في هذا القسم
+
+<CardGroup cols={٢}>
+ <Card title="الوظائف المنطقية" icon="bolt" href="/l/ar/developers/extend/apps/logic/logic-functions">
+ لبنة البناء الأساسية — أنواع المشغلات، والحمولات، وعميل واجهة برمجة التطبيقات ذو الأنواع.
+ </Card>
+ <Card title="المهارات والوكلاء" icon="robot" href="/l/ar/developers/extend/apps/logic/skills-and-agents">
+ تعليمات قابلة لإعادة الاستخدام لوكلاء الذكاء الاصطناعي ومساعدين مع مطالبات نظام مخصّصة.
+ </Card>
+ <Card title="الاتصالات" icon="قابس" href="/l/ar/developers/extend/apps/logic/connections">
+ بيانات اعتماد OAuth التي يحتفظ بها تطبيقك للخدمات الخارجية — مثل Linear وGitHub وSlack وغيرها.
+ </Card>
+</CardGroup>
+
+## لمحة عن أنواع المشغلات
+
+دالة المنطق تختار واحدًا أو أكثر من المشغلات — كل إدخال أدناه هو حقل منفصل في `defineLogicFunction()`:
+
+| المشغّل | متى يعمل | الإعداد |
+| ---------------------- | -------------------------------------------------------------- | ------------------------------- |
+| **مسار HTTP** | طلب يصل إلى نقطة نهاية `/s/\<path>` الخاصة بك | `httpRouteTriggerSettings` |
+| **كرون** | عند تطابق تعبير CRON | `cronTriggerSettings` |
+| **حدث قاعدة البيانات** | يتم إنشاء سجل في مساحة العمل أو تحديثه أو حذفه | `databaseEventTriggerSettings` |
+| **أداة ذكاء اصطناعي** | ميزة ذكاء اصطناعي في Twenty تقرر استدعاء دالتك | `toolTriggerSettings` |
+| **إجراء سير العمل** | تستدعي خطوة في سير العمل دالتك | `workflowActionTriggerSettings` |
+
+تعمل الدوال ضمن عمليات Node.js معزولة، وتصل إلى مساحة العمل عبر عميل واجهة برمجة تطبيقات مضبوط الأنواع ومحدّد النطاق بالدور المصرّح عنه في [`defineApplication()`](/l/ar/developers/extend/apps/config/application).
+
+<Note>
+**خطافات وقت التثبيت** — الشيفرة التي تعمل قبل التثبيت أو بعده — تشارك بيئة التشغيل هذه ولكنها تستخدم دوال تعريف خاصة بها وتوجد ضمن [Config → Install Hooks](/l/ar/developers/extend/apps/config/install-hooks).
+</Note>
diff --git a/packages/twenty-docs/l/ar/developers/extend/apps/logic/skills-and-agents.mdx b/packages/twenty-docs/l/ar/developers/extend/apps/logic/skills-and-agents.mdx
new file mode 100644
index 00000000000..35228063d9e
--- /dev/null
+++ b/packages/twenty-docs/l/ar/developers/extend/apps/logic/skills-and-agents.mdx
@@ -0,0 +1,138 @@
+---
+title: المهارات والوكلاء
+description: عرّف مهارات ووكلاء الذكاء الاصطناعي لتطبيقك.
+icon: robot
+---
+
+<Warning>
+ المهارات والوكلاء حاليًا في مرحلة الألفا. الميزة تعمل لكنها لا تزال قيد التطور.
+</Warning>
+
+يمكن للتطبيقات تعريف قدرات ذكاء اصطناعي تعمل داخل مساحة العمل — تعليمات مهارات قابلة لإعادة الاستخدام ووكلاء بموجهات نظام مخصّصة.
+
+<AccordionGroup>
+<Accordion title="defineSkill" description="عرّف مهارات وكلاء الذكاء الاصطناعي">
+
+تُحدِّد المهارات تعليمات وإمكانات قابلة لإعادة الاستخدام يمكن لوكلاء الذكاء الاصطناعي استخدامها داخل مساحة العمل لديك. استخدم `defineSkill()` لتعريف مهارات مع تحقّق مدمج:
+
+```ts src/skills/example-skill.ts
+import { defineSkill } from 'twenty-sdk/define';
+
+export default defineSkill({
+ universalIdentifier: 'a1b2c3d4-e5f6-7890-abcd-ef1234567890',
+ name: 'sales-outreach',
+ label: 'Sales Outreach',
+ description: 'Guides the AI agent through a structured sales outreach process',
+ icon: 'IconBrain',
+ content: `You are a sales outreach assistant. When reaching out to a prospect:
+1. Research the company and recent news
+2. Identify the prospect's role and likely pain points
+3. Draft a personalized message referencing specific details
+4. Keep the tone professional but conversational`,
+});
+```
+
+النقاط الرئيسية:
+* `name` هي سلسلة معرّف فريدة للمهارة (يُنصَح باستخدام kebab-case).
+* `label` هو اسم العرض المقروء للبشر الظاهر في واجهة المستخدم.
+* `content` يحتوي على تعليمات المهارة — وهو النص الذي يستخدمه وكيل الذكاء الاصطناعي.
+* `icon` (اختياري) يحدّد الأيقونة المعروضة في واجهة المستخدم.
+* `description` (اختياري) يوفّر سياقًا إضافيًا حول غرض المهارة.
+
+</Accordion>
+<Accordion title="defineAgent" description="عرِّف وكلاء الذكاء الاصطناعي باستخدام موجهات مخصّصة">
+
+الوكلاء هم مساعدون ذكاء اصطناعي يعيشون داخل مساحة العمل لديك. استخدم `defineAgent()` لإنشاء وكلاء بموجه نظام مخصّص:
+
+```ts src/agents/example-agent.ts
+import { defineAgent } from 'twenty-sdk/define';
+
+export default defineAgent({
+ universalIdentifier: 'b3c4d5e6-f7a8-9012-bcde-f34567890123',
+ name: 'sales-assistant',
+ label: 'Sales Assistant',
+ description: 'Helps the sales team draft outreach emails and research prospects',
+ icon: 'IconRobot',
+ prompt: 'You are a helpful sales assistant. Help users with their questions and tasks.',
+});
+```
+
+النقاط الرئيسية:
+* `name` هي سلسلة معرّف فريدة للوكيل (يُنصح باستخدام kebab-case).
+* `label` هو اسم العرض الظاهر في واجهة المستخدم.
+* `prompt` هو موجه النظام الذي يحدّد سلوك الوكيل.
+* `description` (اختياري) يوفّر سياقًا حول ما يفعله الوكيل.
+* `icon` (اختياري) يحدّد الأيقونة المعروضة في واجهة المستخدم.
+* `modelId` (اختياري) يتجاوز نموذج الذكاء الاصطناعي الافتراضي الذي يستخدمه الوكيل.
+* `responseFormat` (اختياري) يتحكم في شكل مخرجات الوكيل. القيمة الافتراضية هي `{ type: 'text' }` للنص الحر. استخدم `{ type: 'json', schema }` لفرض مخرجات JSON منظمة.
+
+بشكل افتراضي، يعيد الوكيل نصًا حرًا. للحصول على مخرجات منظمة، عيّن `responseFormat` إلى `{ type: 'json' }` ووفّر `schema`:
+
+```ts src/agents/structured-agent.ts
+import { defineAgent } from 'twenty-sdk/define';
+
+export default defineAgent({
+ universalIdentifier: 'c4d5e6f7-a8b9-0123-cdef-456789012345',
+ name: 'lead-scorer',
+ label: 'Lead Scorer',
+ prompt: 'Score the lead and explain your reasoning.',
+ responseFormat: {
+ type: 'json',
+ schema: {
+ type: 'object',
+ properties: {
+ score: { type: 'number', description: 'Lead score from 0 to 100' },
+ summary: { type: 'string', description: 'Short reasoning for the score' },
+ },
+ required: ['score', 'summary'],
+ additionalProperties: false,
+ },
+ },
+});
+```
+
+ملاحظات حول المخطط:
+* المخطط كائن مسطح: يجب أن يكون `type` لكل خاصية نوعًا بدائيًا (`string` أو `number` أو `boolean`). الكائنات المتداخلة والمصفوفات غير مدعومة.
+* `description` (اختياري) على كل خاصية يوجه النموذج لما يجب وضعه هناك.
+* `required` (اختياري) يسرد الخصائص التي يجب على النموذج إرجاعها دائمًا.
+* `additionalProperties: false` (اختياري) يمنع أي خاصية غير معرّفة في `properties`.
+
+</Accordion>
+<Accordion title="runAgent" description="تشغيل وكيل من دالة منطقية">
+
+تتيح `runAgent()` لدالة منطقية تشغيل أحد وكلاء تطبيقك (مع مهاراته وأدواته). عرِّف الوكيل عن طريق `universalIdentifier` الذي مررته إلى `defineAgent()`:
+
+```ts src/logic-functions/run-enricher.ts
+import { runAgent } from 'twenty-sdk/logic-function';
+
+const { result, error, success } = await runAgent({
+ agentUniversalIdentifier: 'b3c4d5e6-f7a8-9012-bcde-f34567890123',
+ prompt: 'Enrich House Ad <recordId>: fill empty fields from its listing URL.',
+});
+```
+
+النقاط الرئيسية:
+* يعمل الوكيل **بشكل متزامن** ويمكنه قراءة/تحديث السجلات بنفسه عبر أدواته الخاصة — يتم حل `runAgent()` بمجرد اكتمال التشغيل.
+* لا يمكن للتطبيق تشغيل سوى وكلائه الخاصين.
+* يجب أن يمنح [الدور الافتراضي](/l/ar/developers/extend/apps/config/roles) للتطبيق علامة الإذن `AI` — أضِف `SystemPermissionFlag.AI` إلى `permissionFlagUniversalIdentifiers` الخاصة به (أو عيِّن `canAccessAllTools: true`).
+ بدون ذلك، تفشل `runAgent()` بخطأ في الأذونات.
+* اضبط قيمة كبيرة لـ `timeoutSeconds` على الدالة المنطقية — قد يستغرق تشغيل الوكيل عدة ثوانٍ.
+* يكون `success` بقيمة `true` و`result` غير فارغ عند اكتمال التشغيل؛ في حال الفشل يكون `success` بقيمة `false`، و`result` بقيمة `null`، وتحتوي `error` على السبب (على سبيل المثال، عندما تنفد أرصدة الذكاء الاصطناعي الخاصة بمساحة العمل أثناء التشغيل).
+
+```ts src/roles/default-role.ts
+import { defineApplicationRole, SystemPermissionFlag } from 'twenty-sdk/define';
+
+export default defineApplicationRole({
+ universalIdentifier: 'b648f87b-1d26-4961-b974-0908fd991061',
+ label: 'Default function role',
+ // runAgent() requires the AI permission flag on the app's default role.
+ permissionFlagUniversalIdentifiers: [SystemPermissionFlag.AI],
+});
+```
+
+<Warning>
+ **تجنب الحلقات:** إذا استدعيت `runAgent()` من مشغل حدث قاعدة بيانات من نوع `*.updated` وقام الوكيل بتحديث نفس السجل، فحدد نطاق المشغل باستخدام `updatedFields` إلى حقل لا يكتبه الوكيل أبدًا (مثل عنوان URL المصدر)، أو تحقَّق مما إذا كان أي حقل مستهدف لا يزال فارغًا قبل استدعاء `runAgent()`.
+</Warning>
+
+</Accordion>
+</AccordionGroup>
diff --git a/packages/twenty-docs/l/ar/developers/extend/apps/operations/cli.mdx b/packages/twenty-docs/l/ar/developers/extend/apps/operations/cli.mdx
new file mode 100644
index 00000000000..33c18ee7842
--- /dev/null
+++ b/packages/twenty-docs/l/ar/developers/extend/apps/operations/cli.mdx
@@ -0,0 +1,105 @@
+---
+title: CLI
+description: أوامر yarn twenty لتنفيذ الدوال، وبثّ السجلات، وإدارة تثبيتات التطبيقات، والتبديل بين الريموتات.
+icon: الطرفية
+---
+
+إلى جانب `dev` و`dev:build` و`dev:add` و`dev:typecheck`، يوفّر `yarn twenty` CLI أوامر لتنفيذ الدوال، وعرض السجلات، وإدارة تثبيتات التطبيقات.
+
+## تنفيذ الدوال (`yarn twenty dev:function:exec`)
+
+تشغيل دالة منطقية يدويًا دون تشغيلها عبر HTTP أو cron أو حدث قاعدة بيانات:
+
+```bash filename="Terminal"
+# Execute by function name
+yarn twenty dev:function:exec -n create-new-post-card
+
+# Execute by universalIdentifier
+yarn twenty dev:function:exec -u e56d363b-0bdc-4d8a-a393-6f0d1c75bdcf
+
+# Pass a JSON payload
+yarn twenty dev:function:exec -n create-new-post-card -p '{"name": "Hello"}'
+
+# Execute the post-install function
+yarn twenty dev:function:exec --postInstall
+```
+
+## عرض سجلات الدوال (`yarn twenty dev:function:logs`)
+
+بثّ سجلات التنفيذ لدوال تطبيقك المنطقية:
+
+```bash filename="Terminal"
+# Stream all function logs
+yarn twenty dev:function:logs
+
+# Filter by function name
+yarn twenty dev:function:logs -n create-new-post-card
+
+# Filter by universalIdentifier
+yarn twenty dev:function:logs -u e56d363b-0bdc-4d8a-a393-6f0d1c75bdcf
+```
+
+<Note>
+يختلف هذا عن `yarn twenty docker:logs`، الذي يعرض سجلات حاوية Docker. يعرض `yarn twenty dev:function:logs` سجلات تنفيذ دوال تطبيقك من خادم Twenty.
+</Note>
+
+## توليد العميل محدد الأنواع (`yarn twenty dev:generate-client`)
+
+أعد توليد عميل واجهة برمجة التطبيقات محدد الأنواع (`twenty-client-sdk`) من مخطط الجهة البعيدة النشطة، دون بناء تطبيق أو مزامنته. استخدمه للحصول على عميل محدد الأنواع في أي مشروع — مثل خدمة خلفية موجودة في مستودع منفصل — يتواصل مع مثيل Twenty الخاص بك:
+
+```bash filename="Terminal"
+# In your project (no Twenty app definition required)
+yarn add twenty-sdk twenty-client-sdk
+
+# Connect to the Twenty instance to generate the client from
+yarn twenty remote:add
+
+# Generate the typed client into node_modules/twenty-client-sdk
+yarn twenty dev:generate-client
+```
+
+ثم استورد العميل في شيفرتك:
+
+```typescript
+import { CoreApiClient } from 'twenty-client-sdk/core';
+```
+
+أعد تشغيل الأمر كلما تغيّر نموذج البيانات لديك لتحديث الأنواع المُولَّدة.
+
+<Note>
+يتم إنشاء العميل البرمجي داخل `node_modules`، لذا لا يُدرج مع شيفرتك في الالتزامات (commits). شغّل `yarn twenty dev:generate-client` بعد كل عملية تثبيت (على سبيل المثال في سكربت `postinstall` أو في CI).
+</Note>
+
+## إلغاء تثبيت تطبيق (`yarn twenty app:uninstall`)
+
+أزل تطبيقك من مساحة العمل النشطة:
+
+```bash filename="Terminal"
+yarn twenty app:uninstall
+
+# Skip the confirmation prompt
+yarn twenty app:uninstall --yes
+```
+
+## إدارة الريموتات
+
+**الريموت** هو خادم Twenty يتصل به تطبيقك. أثناء الإعداد، تُنشئ أداة إنشاء الهيكل واحدًا لك تلقائيًا. يمكنك إضافة ريموتات أخرى أو التبديل بينها في أي وقت.
+
+```bash filename="Terminal"
+# Add a new remote (opens a browser for OAuth login)
+yarn twenty remote:add
+
+# Connect to a local Twenty server (auto-detects port 2020 or 3000)
+yarn twenty remote:add --local
+
+# Add a remote non-interactively (useful for CI)
+yarn twenty remote:add --url https://your-twenty-server.com --api-key $TWENTY_API_KEY --as my-remote
+
+# List all configured remotes
+yarn twenty remote:list
+
+# Set the active remote
+yarn twenty remote:use <name>
+```
+
+تُخزَّن بيانات اعتمادك في `~/.twenty/config.json`.
diff --git a/packages/twenty-docs/l/ar/developers/extend/apps/operations/overview.mdx b/packages/twenty-docs/l/ar/developers/extend/apps/operations/overview.mdx
new file mode 100644
index 00000000000..36eab471ed4
--- /dev/null
+++ b/packages/twenty-docs/l/ar/developers/extend/apps/operations/overview.mdx
@@ -0,0 +1,32 @@
+---
+title: نظرة عامة
+description: قم ببناء تطبيقك واختباره وإصداره — أوامر CLI، واختبارات التكامل، وCI، والنشر إلى خادم أو إلى npm.
+icon: rocket
+---
+
+**طبقة العمليات** هي كل ما تفعله *على* تطبيقك وليس *به*: استدعاء أوامر CLI، وتشغيل اختبارات التكامل على خادم Twenty حقيقي، وإعداد CI، وإطلاق الإصدارات — إما كملف tarball يُنشر على خادم واحد أو كحزمة npm مُدرجة في المتجر.
+
+```text
+ develop ─▶ test ─▶ build ─▶ deploy / publish
+ ─────── ──── ───── ─────────────────
+ yarn yarn yarn yarn twenty app:publish --private (tarball → one server)
+ twenty test twenty
+ dev dev:build yarn twenty app:publish (npm → marketplace)
+```
+
+## في هذا القسم
+
+<CardGroup cols={٢}>
+ <Card title="CLI" icon="الطرفية" href="/l/ar/developers/extend/apps/operations/cli">
+ مرجع `yarn twenty` — exec، logs، uninstall، remotes.
+ </Card>
+ <Card title="المزامنة والاستعادة" icon="بوصلة" href="/l/ar/developers/extend/apps/operations/sync-and-recovery">
+ أي أمر يُستخدم ومتى، وكيفية قراءة فروق المزامنة، وسلّم الاستعادة.
+ </Card>
+ <Card title="الاختبار" icon="flask" href="/l/ar/developers/extend/apps/operations/testing">
+ إعداد Vitest، اختبارات التكامل، فحص الأنواع، سير عمل CI.
+ </Card>
+ <Card title="النشر" icon="رفع" href="/l/ar/developers/extend/apps/operations/publishing">
+ البناء، نشر ملف tarball، النشر إلى npm، التثبيت.
+ </Card>
+</CardGroup>
diff --git a/packages/twenty-docs/l/ar/developers/extend/apps/operations/publishing.mdx b/packages/twenty-docs/l/ar/developers/extend/apps/operations/publishing.mdx
new file mode 100644
index 00000000000..902a239a3ef
--- /dev/null
+++ b/packages/twenty-docs/l/ar/developers/extend/apps/operations/publishing.mdx
@@ -0,0 +1,294 @@
+---
+title: النشر
+icon: رفع
+description: وزّع تطبيق Twenty الخاص بك على سوق Twenty أو انشره داخليًا.
+---
+
+## نظرة عامة
+
+بمجرد أن يكون تطبيقك [مبنيًا ومختبرًا محليًا](/l/ar/developers/extend/apps/getting-started/concepts)، لديك مساران لتوزيعه:
+
+* **نشر أرشيف tar** — ارفع تطبيقك مباشرةً إلى خادم Twenty محدد للاستخدام الداخلي أو الخاص.
+* **النشر على npm** — أدرج تطبيقك في سوق Twenty ليتسنى لأي مساحة عمل اكتشافه وتثبيته.
+
+كلا المسارين يبدآن من نفس خطوة **build**.
+
+## بناء تطبيقك
+
+شغّل أمر build لتجميع تطبيقك وإنشاء ملف `manifest.json` جاهز للتوزيع:
+
+```bash filename="Terminal"
+yarn twenty dev:build
+```
+
+يقوم هذا بتجميع مصادر TypeScript، وتحويل دوال المنطق ومكوّنات الواجهة الأمامية، وكتابة كل شيء إلى `.twenty/output/`. أضِف `--tarball` لإنتاج حزمة `.tgz` أيضًا للتوزيع اليدوي أو لأمر publish.
+
+## النشر إلى خادم (tarball)
+
+بالنسبة للتطبيقات التي لا تريد إتاحتها للعامة — مثل الأدوات المملوكة، أو عمليات التكامل الخاصة بالمؤسسات فقط، أو الإصدارات التجريبية — يمكنك نشر tarball مباشرةً إلى خادم Twenty.
+
+### المتطلبات الأساسية
+
+قبل النشر، تحتاج إلى remote مُعدّ يشير إلى خادم الهدف. تُخزّن remotes عنوان URL للخادم وبيانات اعتماد المصادقة محليًا في `~/.twenty/config.json`.
+
+أضِف remote:
+
+```bash filename="Terminal"
+yarn twenty remote:add --url https://your-twenty-server.com --as production
+```
+
+### النشر
+
+بناء تطبيقك ورفعه إلى الخادم في خطوة واحدة:
+
+```bash filename="Terminal"
+yarn twenty app:publish --private
+# To deploy to a specific remote:
+# yarn twenty app:publish --private --remote production
+```
+
+### مشاركة تطبيق منشور
+
+<Warning>
+تُعد مشاركة التطبيقات الخاصة (tarball) عبر مساحات العمل ميزة ضمن **Enterprise**. ستعرض علامة التبويب **التوزيع** مطالبة بالترقية بدلًا من عناصر التحكم في المشاركة حتى تحتوي مساحة العمل لديك على مفتاح Enterprise صالح. اطلع على [الإعدادات > لوحة الإدارة > Enterprise](/settings/admin-panel#enterprise) لتنشيطه.
+</Warning>
+
+تطبيقات tarball لا تُدرَج في السوق العامة، لذا لن تكتشفها مساحات العمل الأخرى على الخادم نفسه عبر الاستعراض. بمجرد أن تصبح مساحة العمل لديك ضمن خطة Enterprise، يمكنك مشاركة تطبيق تم نشره كما يلي:
+
+1. اذهب إلى **الإعدادات > التطبيقات > التسجيلات** وافتح تطبيقك
+2. في علامة التبويب **التوزيع**، انقر **نسخ رابط المشاركة**
+3. شارك هذا الرابط مع المستخدمين في مساحات عمل أخرى — سيأخذهم مباشرةً إلى صفحة تثبيت التطبيق
+
+يستخدم رابط المشاركة عنوان URL الأساسي للخادم (من دون أي نطاق فرعي لمساحة عمل)، لذا يعمل مع أي مساحة عمل على الخادم.
+
+### إدارة الإصدارات
+
+عند تحديث تطبيق tarball منشور مسبقًا، يشترط الخادم أن تكون قيمة `version` في `package.json` **أعلى قطعًا** (وفق ترتيب [الإصدار الدلالي](https://semver.org)) من الإصدار المنشور حاليًا. إعادة نشر الإصدار نفسه، أو دفع إصدار أدنى، يُرفَض قبل تخزين ملف tarball — سترى خطأ `VERSION_ALREADY_EXISTS` من CLI.
+
+لطرح تحديث:
+
+1. قم بزيادة الحقل `version` في ملف `package.json` (مثلًا: `1.2.3` → `1.2.4`، `1.3.0`، أو `2.0.0`)
+2. شغّل `yarn twenty app:publish --private` (أو `yarn twenty app:publish --private --remote production`)
+3. سترى مساحات العمل التي ثبّتت التطبيق الترقية متاحة في إعداداتها
+
+<Note>
+علامات ما قبل الإصدار تعمل كما هو متوقع: زيادة `1.0.0-rc.1` → `1.0.0-rc.2` مسموح بها، ويُعترَف بالإصدار النهائي مثل `1.0.0` على أنه أعلى من `1.0.0-rc.5`. يجب أن يكون الإصدار في `package.json` بنفسه سلسلة semver صالحة.
+</Note>
+
+{/* TODO: add screenshot of the Upgrade button */}
+
+### توافق إصدار الخادم
+
+إذا كان تطبيقك يستخدم ميزة تم تقديمها في إصدار معيّن من خادم Twenty (على سبيل المثال، موفّرو OAuth الذين أضيفوا في v2.3.0)، فيجب عليك التصريح بأدنى إصدار من الخادم يتطلبه تطبيقك باستخدام الحقل `engines.twenty` في `package.json`:
+
+```json filename="package.json"
+{
+ "name": "twenty-my-app",
+ "version": "1.0.0",
+ "engines": {
+ "node": "^24.5.0",
+ "twenty": ">=2.3.0"
+ }
+}
+```
+
+القيمة عبارة عن [نطاق semver](https://github.com/npm/node-semver#ranges) قياسي. أنماط شائعة:
+
+| النطاق | المعنى |
+| ---------------------------------- | ------------------------------------------------ |
+| `>=2.3.0` | أي خادم من 2.3.0 فصاعدًا |
+| `>=2.3.0 \<3.0.0` | 2.3.0 أو أحدث، لكن أقل من الإصدار الرئيسي التالي |
+| `^2.3.0` | مماثل لـ `>=2.3.0 \<3.0.0` |
+
+**ماذا يحدث وقت النشر والتثبيت:**
+
+* إذا تم تعيين `engines.twenty` ولم يستوفِ إصدار الخادم الهدف النطاق، فسيتم رفض النشر (tarball upload) أو التثبيت بخطأ `SERVER_VERSION_INCOMPATIBLE` ورسالة تُشير إلى كلٍ من النطاق المطلوب وإصدار الخادم الفعلي.
+* إذا كان `engines.twenty` **غير مُعين**، فسيُقبل التطبيق على أي إصدار من الخادم (متوافق مع الإصدارات السابقة للتطبيقات الحالية).
+* إذا لم يكن لدى الخادم قيمة `APP_VERSION` مُكوَّنة، فسيتم تخطي الفحص.
+
+<Note>
+الخادم هو الجهة المرجعية للفحص — إذ يتحقق من `engines.twenty` عند كلٍ من رفع tarball وتثبيت مساحة العمل. إذا قمت بنشر tarball خارج القناة المعتادة أو التثبيت من السوق، فسيظل الخادم يفرض التوافق.
+</Note>
+
+## CI/CD المؤتمتة (مهام سير عمل مُولَّدة بالقوالب)
+
+التطبيقات المُولَّدة باستخدام `create-twenty-app` تأتي افتراضيًا مع مهمَّتي سير عمل من GitHub Actions ضمن `.github/workflows/`. هي جاهزة للتشغيل بمجرد دفع المستودع إلى GitHub — لا حاجة لأي إعداد إضافي لـ CI، وCD يتطلّب سرًّا واحدًا فقط.
+
+### CI — `ci.yml`
+
+يشغّل اختبارات التكامل عند كل دفع إلى `main` وعند كل طلب سحب.
+
+**ماذا يفعل:**
+
+1. يجلب مصدر تطبيقك.
+2. ينشئ مثيلاً اختبارياً معزولاً من Twenty باستخدام الإجراء المركّب `twentyhq/twenty/.github/actions/spawn-twenty-app-dev-test@main` (المكافئ في CI للأمر `yarn twenty docker:start --test`).
+3. يُفعِّل Corepack، ويُعدّ Node.js من ملف `.nvmrc` لديك، ويثبّت التبعيات بواسطة `yarn install --immutable`.
+4. يشغّل `yarn test`، ويمرّر `TWENTY_API_URL` و`TWENTY_API_KEY` من المثيل الذي تم إنشاؤه بحيث تتمكّن اختباراتك من التواصل مع خادم حقيقي.
+
+**خيارات التكوين:**
+
+* `TWENTY_VERSION` (متغيّر بيئة، القيمة الافتراضية `latest`) — ثبّت نسخة خادم Twenty المستخدمة في CI عبر تعديل هذا في `ci.yml`.
+* يتم تجميع التشغيل المتزامن حسب `github.ref` ويلغي التشغيلات قيد التقدّم عند أي دفع جديد.
+
+لا تتطلّب أي أسرار — مثيل الاختبار مؤقّت ويستمر فقط طوال مدّة المهمّة.
+
+### CD — `cd.yml`
+
+ينشر تطبيقك إلى خادم Twenty مُهيّأ عند كل دفع إلى `main`، وبشكل اختياري من طلب سحب عند تطبيق الوسم `deploy`.
+
+**ماذا يفعل:**
+
+1. يجلب رأس طلب السحب (للطلبات الموسومة) أو الالتزام المدفوع.
+2. يشغّل `twentyhq/twenty/.github/actions/deploy-twenty-app@main` — وهو المكافئ في CI للأمر `yarn twenty app:publish --private`.
+3. يشغّل `twentyhq/twenty/.github/actions/install-twenty-app@main` بحيث تُثبَّت النسخة المُنشَرة حديثًا في مساحة العمل المستهدفة.
+
+**التكوين المطلوب:**
+
+| الإعداد | حيث | الغرض |
+| ----------------------- | --------------------------------------------------------------- | ---------------------------------------------------------------------------------------- |
+| `TWENTY_DEPLOY_URL` | `env` في `cd.yml` (القيمة الافتراضية `http://localhost:3000`) | خادم Twenty الذي سيتم النشر إليه. غيّر هذا إلى عنوان URL لخادمك الحقيقي قبل أول استخدام. |
+| `TWENTY_DEPLOY_API_KEY` | في مستودع GitHub **Settings → Secrets and variables → Actions** | مفتاح API يمتلك إذن النشر على الخادم المستهدف. |
+
+<Note>
+القيمة الافتراضية لـ `TWENTY_DEPLOY_URL` وهي `http://localhost:3000` مجرد عنصر نائب — لن تصل إلى أي شيء من مُشغِّل مستضاف لدى GitHub. حدّثها إلى عنوان URL العام لخادمك (أو استخدم مُشغِّلًا مستضافًا ذاتيًا مع وصول شبكي) قبل تمكين CD.
+</Note>
+
+**تشغيل نشر معاينة من طلب سحب:**
+
+أضِف الوسم `deploy` إلى طلب سحب. الشرط `if:` في `cd.yml` سيشغّل المهمّة لذلك الطلب مستخدمًا التزام رأس الطلب، مما يتيح لك التحقّق من التغيير على الخادم المستهدف قبل الدمج.
+
+### تثبيت الإجراءات القابلة لإعادة الاستخدام
+
+يشير كلا سيرَي العمل إلى إجراءات قابلة لإعادة الاستخدام عند `@main`، لذا تُلتقط تحديثات الإجراءات في مستودع `twentyhq/twenty` تلقائيًا. إذا كنت تريد بناءات حتمية، فاستبدِل `@main` بقيمة SHA لالتزام أو بوسم إصدار في كل سطر `uses:`.
+
+## النشر على npm
+
+يُتيح النشر على npm إمكانية العثور على تطبيقك في سوق Twenty. يمكن لأي مساحة عمل في Twenty استعراض تطبيقات السوق وتثبيتها وترقيتها مباشرةً من واجهة المستخدم.
+
+### المتطلبات
+
+* حساب على [npm](https://www.npmjs.com)
+* الكلمة المفتاحية `twenty-app` في مصفوفة `keywords` في `package.json` (أضفها يدويًا — فهي غير مضمنة افتراضيًا في قالب `create-twenty-app`)
+
+```json filename="package.json"
+{
+ "name": "twenty-app-postcard-sender",
+ "version": "1.0.0",
+ "keywords": ["twenty-app"]
+}
+```
+
+### بيانات التعريف لسوق التطبيقات
+
+يدعم إعداد `defineApplication()` حقولًا اختيارية تتحكم في كيفية ظهور تطبيقك في السوق. استخدم `logoUrl` و`screenshots` للإشارة إلى الصور من مجلد `public/`:
+
+```ts src/application-config.ts
+export default defineApplication({
+ universalIdentifier: '...',
+ displayName: 'My App',
+ description: 'A great app',
+ logoUrl: 'public/logo.png',
+ screenshots: [
+ 'public/screenshot-1.png',
+ 'public/screenshot-2.png',
+ ],
+});
+```
+
+اطّلع على [أكورديون defineApplication](/l/ar/developers/extend/apps/config/application#marketplace-metadata) في صفحة بناء التطبيقات للاطلاع على القائمة الكاملة لحقول السوق (`author` و`category` و`aboutDescription` و`websiteUrl` و`termsUrl` وغيرها).
+
+#### أبعاد لقطات الشاشة الموصى بها
+
+يعرض السوق `screenshots` داخل حاوية ثابتة بنسبة `8:5` (على سبيل المثال، `1600×1000 px`).
+
+<Note>
+تعرض لقطات الشاشة بأي نسبة عرض إلى ارتفاع بالكامل ولن يتم اقتطاعها مطلقًا، ولكن أي شيء أطول أو أضيق بكثير من `8:5` سيظهر مساحات فارغة على الجانبين.
+</Note>
+
+### النشر
+
+```bash filename="Terminal"
+yarn twenty app:publish
+```
+
+للنشر تحت dist-tag معيّن (مثلًا: `beta` أو `next`):
+
+```bash filename="Terminal"
+yarn twenty app:publish --tag beta
+```
+
+### كيف تعمل آلية الاكتشاف في السوق
+
+يقوم خادم Twenty بمزامنة كتالوج السوق من سجل npm **كل ساعة**.
+
+يمكنك تشغيل المزامنة فورًا بدلًا من الانتظار:
+
+```bash filename="Terminal"
+yarn twenty dev:catalog-sync
+# To target a specific remote:
+# yarn twenty dev:catalog-sync --remote production
+```
+
+تأتي بيانات التعريف المعروضة في السوق من إعداد `defineApplication()` — حقول مثل `displayName` و`description` و`author` و`category` و`logoUrl` و`screenshots` و`aboutDescription` و`websiteUrl` و`termsUrl`.
+
+<Note>
+إذا لم يحدد تطبيقك `aboutDescription` في `defineApplication()`، فسيستخدم السوق تلقائيًا ملف `README.md` الخاص بحزمتك من npm كمحتوى لصفحة حول. هذا يعني أنه يمكنك الاحتفاظ بملف README واحد لكل من npm وسوق Twenty. إذا كنت تريد وصفًا مختلفًا في السوق، فقم بتعيين `aboutDescription` بشكل صريح.
+</Note>
+
+### النشر عبر CI
+
+استخدم سير عمل GitHub Actions هذا للنشر تلقائيًا مع كل إصدار (يستخدم [OIDC](https://docs.npmjs.com/trusted-publishers)):
+
+```yaml filename=".github/workflows/publish.yml"
+name: Publish
+on:
+ release:
+ types: [published]
+
+permissions:
+ contents: read
+ id-token: write
+
+jobs:
+ publish:
+ runs-on: ubuntu-latest
+ steps:
+ - uses: actions/checkout@v4
+ - uses: actions/setup-node@v4
+ with:
+ node-version: "24"
+ registry-url: https://registry.npmjs.org
+ - run: yarn install --immutable
+ - run: npx twenty dev:build
+ - run: npm publish --provenance --access public
+ working-directory: .twenty/output
+```
+
+بالنسبة لأنظمة CI الأخرى (GitLab CI، وCircleCI، إلخ)، تنطبق الأوامر الثلاثة نفسها: `yarn install`، ثم `yarn twenty dev:build`، ثم `npm publish` من `.twenty/output`.
+
+<Note>
+**npm provenance** اختياري ولكنه موصى به. يضيف النشر باستخدام `--provenance` شارة ثقة إلى إدراجك على npm، مما يتيح للمستخدمين التحقق من أن الحزمة تم بناؤها من التزام محدد ضمن خط أنابيب CI عام. راجع [وثائق npm provenance](https://docs.npmjs.com/generating-provenance-statements) للحصول على تعليمات الإعداد.
+</Note>
+
+## تثبيت التطبيقات
+
+بعد نشر التطبيق (npm) أو نشره (tarball)، يمكن لمساحات العمل تثبيته عبر واجهة المستخدم.
+
+اذهب إلى صفحة **الإعدادات > التطبيقات** في Twenty، حيث يمكن استعراض تطبيقات السوق والتطبيقات المنشورة عبر tarball وتثبيتها.
+
+{/* TODO: add screenshot of the UI when the app is registered */}
+
+يمكنك أيضًا تثبيت التطبيقات من سطر الأوامر:
+
+```bash filename="Terminal"
+yarn twenty app:install
+```
+
+<Note>
+يفرض الخادم اعتماد إصدارات semver عند التثبيت، بما يعكس القواعد المطبّقة عند النشر:
+
+* تثبيت الإصدار نفسه المثبّت بالفعل في مساحة عملك يُرفَض بخطأ `APP_ALREADY_INSTALLED`.
+* تثبيت إصدار أدنى من الإصدار المثبّت حاليًا يُرفَض بخطأ `CANNOT_DOWNGRADE_APPLICATION`.
+
+لتثبيت إصدار أحدث، انشره (deploy) أو انشره إلى السجل (publish) أولًا، ثم أعد تشغيل `yarn twenty app:install`.
+</Note>
diff --git a/packages/twenty-docs/l/ar/developers/extend/apps/operations/sync-and-recovery.mdx b/packages/twenty-docs/l/ar/developers/extend/apps/operations/sync-and-recovery.mdx
new file mode 100644
index 00000000000..4e3e8062147
--- /dev/null
+++ b/packages/twenty-docs/l/ar/developers/extend/apps/operations/sync-and-recovery.mdx
@@ -0,0 +1,111 @@
+---
+title: المزامنة والاستعادة
+description: أي أمر تستخدمه ومتى، وكيفية قراءة مخرجات المزامنة، وسلّم استعادة لما يجب فعله عندما تنحرف البيانات الوصفية المحلية — قبل الوصول إلى إعادة تعيين كاملة.
+icon: بوصلة
+---
+
+يدور تطوير التطبيقات محليًا حول **المزامنة**: يقوم الـ CLI بإعادة إنشاء ملف manifest الخاص بك ويطبّق الخادم فقط الفرق بينه وبين البيانات الوصفية الموجودة بالفعل في مساحة العمل لديك. تغطي هذه الصفحة الأمر الذي ينبغي استخدامه، وكيفية قراءة ما غيّرته المزامنة، وما الذي يجب فعله — بالترتيب — عندما تبدو الحالة المحلية غير متسقة.
+
+## أي أمر، ومتى
+
+<Note>
+للتكرار اليومي المحلي ستحتاج تقريبًا دائمًا إلى `yarn twenty dev`. يُستخدم النشر والإصدار لإطلاق الإصدارات، **وليس** للحلقة المحلية.
+</Note>
+
+| ترغب في… | أمر | الملاحظات |
+| ------------------------------------------------ | ----------------------------------- | ---------------------------------------------------------------------------------------------------------------------- |
+| التكرار محليًا مع المزامنة الحية | `yarn twenty dev` | يراقب ملفاتك ويجري مزامنة عند كل تغيير. |
+| مزامنة واحدة ثم إنهاء (CI، السكربتات، الخطّافات) | `yarn twenty dev --once` | عملية إنشاء واحدة + مزامنة، ثم إنهاء. |
+| معاينة التغييرات **بدون تطبيقها** | `yarn twenty dev --once --dry-run` | يحتسب الفرق ويطبعه؛ ولا يكتب أي شيء. |
+| إزالة التطبيق من مساحة العمل | `yarn twenty app:uninstall` | أضف `--yes` لتخطي رسالة التأكيد. |
+| إرسال ملف tarball إلى خادم | `yarn twenty app:publish --private` | يتطلّب إصدارًا **أعلى بشكل صارم** في `package.json` — راجع قسم [النشر](/l/ar/developers/extend/apps/operations/publishing). |
+| النشر في السوق (npm) | `yarn twenty app:publish` | — |
+| تثبيت / ترقية إصدار منشور | `yarn twenty app:install` | يُثبّت الإصدار المنشور حاليًا. |
+| مسح الخادم المحلي والبدء من جديد | `yarn twenty docker:reset` | يحذف **كل** البيانات المحلية — كملاذ أخير. |
+
+### لا تحتاج المزامنة المحلية إلى زيادة في الإصدار
+
+تنطبق قاعدة `version` المتزايدة بدقة (`VERSION_ALREADY_EXISTS` عند النشر، و`APP_ALREADY_INSTALLED` / `CANNOT_DOWNGRADE_APPLICATION` عند التثبيت) على **`app:publish` / `app:install`** — مسار الإصدارات. يقوم `yarn twenty dev` بمزامنة ملف manifest في مكانه ولا يتطلّب تغيير الإصدار أبدًا، لذا لست بحاجة إلى تعديل `package.json` للتكرار. إذا وجدت نفسك تزيد الإصدار لاختبار تغيير محلي، فأنت تستخدم مسار الإصدارات بينما ما تريده هو حلقة التطوير.
+
+## قراءة مخرجات المزامنة
+
+كل عملية مزامنة تطبع التغييرات في البيانات الوصفية التي تم تطبيقها (أو التي سيتم تطبيقها، مع خيار `--dry-run`):
+
+```text filename="Terminal"
+Metadata changes: 2 created, 1 updated, 1 deleted
+ created objectMetadata rocket
+ created fieldMetadata timelineActivities
+ updated fieldMetadata launchedAt
+ deleted pageLayout legacyTab
+✓ Synced
+```
+
+هذه أداتك الأولى للتشخيص: تُخبرك بدقة ما الكائنات والحقول والتخطيطات التي تغيّرت، بحيث يمكنك التأكد من أن المزامنة أنجزت ما توقّعته قبل التحقّق من واجهة المستخدم.
+
+عندما تفشل المزامنة على كيان واحد، يذكر الخطأ اسم الكيان المسبب للمشكلة و`universalIdentifier` الخاص به، على سبيل المثال:
+
+```text
+Migration action 'create' for 'fieldMetadata' (universalIdentifier: 2020...4337) failed
+```
+
+استخدم ذلك المعرّف للعثور على الكيان في ملف manifest الخاص بك (وإن لزم الأمر، في مساحة العمل) بدلًا من تخمين أيّها يتعارض.
+
+## معاينة التغييرات (تشغيل تجريبي dry run)
+
+يبني `yarn twenty dev --once --dry-run` ملف manifest الخاص بك، ويطلب من الخادم خطة الترحيل، ويطبعها — **بدون تطبيق أي شيء**. إنها الطريقة الآمنة للإجابة عن سؤال "ما الذي ستغيّره هذه المزامنة؟" قبل الالتزام بها.
+
+```bash filename="Terminal"
+yarn twenty dev --once --dry-run
+```
+
+```text filename="Terminal"
+Building manifest...
+Computing metadata diff (dry run, nothing will be applied)...
+Metadata changes: 1 created, 1 updated
+ created fieldMetadata timelineActivities
+ updated objectMetadata rocket
+✓ Dry run complete for My App — no changes were applied
+```
+
+تشغيل تجريبي:
+
+* **لا يكتب أي شيء** — لا ترحيل لبيانات وصفية، ولا تحديث لسجل التطبيق، ولا تغييرات في الأدوار/التبويبات الافتراضية، ولا توليد لعميل API.
+* يُرجع **نفس الفرق** الذي ستُطبِّقه مزامنة حقيقية، حتى تتمكن من مراجعة الكيانات التي سيتم إنشاؤها/تحديثها/حذفها مسبقًا.
+* يكون مفيدًا قبل إجراء تغيير محفوف بالمخاطر، أو عند مراجعة تغيير تم إنشاؤه بواسطة الذكاء الاصطناعي، أو في سكربت يجب أن يفشل إذا كان تغيير غير متوقَّع على وشك الحدوث.
+
+<Note>
+يُعاين التشغيل التجريبي فقط **تغييرات البيانات الوصفية**، ويتطلّب أن يكون التطبيق قد تمت مزامنته مرة واحدة على الأقل (حتى تعرف به مساحة العمل). إذا شغّلته ضد تطبيق لم تتم مزامنته من قبل، سيبلغ الخادم أن التطبيق غير مُثبّت — شغّل `yarn twenty dev` مرة واحدة أولًا.
+</Note>
+
+## سلّم الاستعادة
+
+عندما تبدو البيانات الوصفية المحلية غير صحيحة، صعِّد الإجراءات بهذا الترتيب وتوقّف بمجرد زوال العائق. كل خطوة أكثر إرباكًا من التي قبلها.
+
+1. **أعد المزامنة.** شغّل `yarn twenty dev --once` مرة أخرى. عمليات المزامنة متطابِقة الأثر (idempotent) — إعادة تشغيل ملف manifest النظيف آمنة وغالبًا ما تحل تعثرًا عابرًا.
+2. **عاين الخطة.** شغّل `yarn twenty dev --once --dry-run` لرؤية ما الذي تنوي المزامنة التالية تغييره بالضبط، بدون تطبيقه.
+3. **اقرأ الخطأ المسمّى.** إذا فشلت المزامنة، لاحظ نوع البيانات الوصفية و`universalIdentifier` في الرسالة (انظر أعلاه) وحدّد ذلك الكيان في ملف manifest الخاص بك. يشير التعارض عادةً إلى معرّف مكرر أو مُعاد استخدامه.
+4. **إلغاء التثبيت وإعادة التثبيت.** شغّل `yarn twenty app:uninstall`، ثم أجرِ مزامنة مرة أخرى (`yarn twenty dev`). هذا يعيد بناء بيانات التطبيق الوصفية من نقطة بداية نظيفة مع إبقاء باقي مساحة العمل سليمة.
+5. **إعادة تعيين كاملة (الملاذ الأخير).** شغّل `yarn twenty docker:reset`، ثم أعد التهيئة والمزامنة.
+
+<Warning>
+يقوم `yarn twenty docker:reset` بحذف **كل** البيانات في النسخة المحلية لديك — كل مساحة عمل، وكل سجل، وكل تطبيق. استخدمه فقط بعد فشل الخطوات السابقة.
+</Warning>
+
+<Note>
+هل واجهت خطأ في البيانات الوصفية؟ يرجى [فتح مشكلة](https://github.com/twentyhq/twenty/issues/new/choose) وإرفاق رسالة الترحيل الفاشلة (بما في ذلك نوع البيانات الوصفية و`universalIdentifier`)، ومخرجات `Metadata changes` من عملية المزامنة، والأوامر التي شغّلتها.
+</Note>
+
+## تجنّب إجراء مزامنات متزامنة على مساحة عمل واحدة
+
+تطبّق المزامنة عمليات ترحيل للبيانات الوصفية. قد يؤدّي تشغيل عدة عمليات مزامنة أو نشر أو تثبيت ضد **نفس** مساحة العمل في الوقت نفسه — على سبيل المثال، عدّة نوافذ طرفية أو وكلاء ذكاء اصطناعي يتكرّرون بالتوازي — إلى تداخل عمليات الترحيل تلك وترك البيانات الوصفية في حالة مطبَّقة جزئيًا.
+
+يقوم الخادم بتسلسل عمليات المزامنة لكل مساحة عمل لمنع ذلك، لكن ما زال ينبغي عليك تمرير عمليات البيانات الوصفية الحساسة عبر عملية **واحدة** بدلًا من تنفيذها بالتوازي. إذا كنت تنظّم التطوير باستخدام عدة وكلاء، فمرّر استدعاءات المزامنة/النشر/التثبيت عبر طابور واحد حتى تعمل واحدة فقط في الوقت نفسه.
+
+## تمييز أنواع الإخفاقات
+
+عندما يحدث خلل ما، يتيح لك فرق البيانات الوصفية والأخطاء المسمّاة تحديد موضع الفشل:
+
+* **خطأ في إنشاء ملف manifest** — يفشل الـ CLI قبل إجراء المزامنة (`MANIFEST_BUILD_FAILED`، `TYPECHECK_FAILED`)؛ أصلِح كود التطبيق لديك.
+* **خطأ في المزامنة / الترحيل** — تنجح عملية الإنشاء لكن يفشل تطبيق الفرق، مع تسمية الكيان و`universalIdentifier`؛ أصلِح البيانات الوصفية المتعارِضة.
+* **خطأ في وقت تشغيل كود التطبيق** — تتم المزامنة بنجاح، ولكن دوال المنطق أو المكوّنات لديك لا تعمل بشكل صحيح أثناء وقت التشغيل؛ تحقّق من [سجلات الدوال](/l/ar/developers/extend/apps/operations/cli).
+* **حالة المثيل المحلي** — لا ينطبق أيّ مما سبق وما زالت مساحة العمل تبدو غير صحيحة؛ تابع النزول في سلّم الاستعادة.
diff --git a/packages/twenty-docs/l/ar/developers/extend/apps/operations/testing.mdx b/packages/twenty-docs/l/ar/developers/extend/apps/operations/testing.mdx
new file mode 100644
index 00000000000..89282760dd0
--- /dev/null
+++ b/packages/twenty-docs/l/ar/developers/extend/apps/operations/testing.mdx
@@ -0,0 +1,301 @@
+---
+title: الاختبار
+description: إعداد Vitest، واختبارات تكامل مقابل خادم Twenty حقيقي، والتحقق من الأنواع، والتكامل المستمر (CI) باستخدام GitHub Actions.
+icon: flask
+---
+
+يوفّر SDK واجهات برمجة قابلة للتنفيذ برمجيًا تمكّنك من بناء تطبيقك ونشره وتثبيته وإلغاء تثبيته من شيفرة الاختبار. بالاقتران مع [Vitest](https://vitest.dev/) وعملاء واجهة البرمجة مضبوطي الأنواع، يمكنك كتابة اختبارات تكامل تتحقّق من أن تطبيقك يعمل من البداية إلى النهاية مقابل خادم Twenty حقيقي.
+
+## استخدام حِزَم npm
+
+يمكنك تثبيت واستخدام أي حزمة npm في تطبيقك. يتم تجميع كلٍ من الدوال المنطقية والمكوّنات الأمامية باستخدام [esbuild](https://esbuild.github.io/)، والذي يُضمّن جميع التبعيات ضمن المخرجات — لا حاجة إلى `node_modules` وقت التشغيل.
+
+### تثبيت حزمة
+
+```bash filename="Terminal"
+yarn add axios
+```
+
+ثم استوردها في شيفرتك:
+
+```ts src/logic-functions/fetch-data.ts
+import { defineLogicFunction } from 'twenty-sdk/define';
+import axios from 'axios';
+
+const handler = async (): Promise<any> => {
+ const { data } = await axios.get('https://api.example.com/data');
+
+ return { data };
+};
+
+export default defineLogicFunction({
+ universalIdentifier: '...',
+ name: 'fetch-data',
+ description: 'Fetches data from an external API',
+ timeoutSeconds: 10,
+ handler,
+});
+```
+
+وينطبق الأمر نفسه على المكوّنات الأمامية:
+
+```tsx src/front-components/chart.tsx
+import { defineFrontComponent } from 'twenty-sdk/define';
+import { format } from 'date-fns';
+
+const DateWidget = () => {
+ return <p>Today is {format(new Date(), 'MMMM do, yyyy')}</p>;
+};
+
+export default defineFrontComponent({
+ universalIdentifier: '...',
+ name: 'date-widget',
+ component: DateWidget,
+});
+```
+
+### كيف يعمل التجميع
+
+تستخدم خطوة البناء أداة esbuild لإنتاج ملف واحد مستقل لكل دالة منطقية ولكل مكوّن أمامي. تُضمَّن جميع الحزم المستوردة داخل الحزمة.
+
+**الدوال المنطقية** تعمل في بيئة Node.js. الوحدات المدمجة في Node (`fs` و`path` و`crypto` و`http` وغيرها) متاحة ولا تحتاج إلى تثبيت.
+
+**المكوّنات الأمامية** تعمل ضمن Web Worker. وحدات Node المدمجة غير متاحة — المتاح فقط واجهات برمجة المتصفّح وحِزَم npm التي تعمل في بيئة المتصفّح.
+
+كلتا البيئتين تحتويان على `twenty-client-sdk/core` و`twenty-client-sdk/metadata` كوحدات متاحة مُسبقًا — لا تُضمَّن هذه ضمن الحزم بل تُحلّ وقت التشغيل بواسطة الخادم.
+
+## إعداد
+
+يتضمّن التطبيق المُولَّد بالقالب بالفعل Vitest. إذا أعددته يدويًا، فثبّت التبعيات:
+
+```bash filename="Terminal"
+yarn add -D vitest vite-tsconfig-paths
+```
+
+أنشئ `vitest.config.ts` في جذر تطبيقك:
+
+```ts vitest.config.ts
+import tsconfigPaths from 'vite-tsconfig-paths';
+import { defineConfig } from 'vitest/config';
+
+export default defineConfig({
+ plugins: [
+ tsconfigPaths({
+ projects: ['tsconfig.spec.json'],
+ ignoreConfigErrors: true,
+ }),
+ ],
+ test: {
+ testTimeout: 120_000,
+ hookTimeout: 120_000,
+ include: ['src/**/*.integration-test.ts'],
+ setupFiles: ['src/__tests__/setup-test.ts'],
+ env: {
+ TWENTY_API_URL: 'http://localhost:2020',
+ TWENTY_API_KEY: 'your-api-key',
+ },
+ },
+});
+```
+
+أنشئ ملف إعداد يتحقّق من إمكانية الوصول إلى الخادم قبل تشغيل الاختبارات:
+
+```ts src/__tests__/setup-test.ts
+import * as fs from 'fs';
+import * as os from 'os';
+import * as path from 'path';
+import { beforeAll } from 'vitest';
+
+const TWENTY_API_URL = process.env.TWENTY_API_URL ?? 'http://localhost:2020';
+const TEST_CONFIG_DIR = path.join(os.tmpdir(), '.twenty-sdk-test');
+
+beforeAll(async () => {
+ // Verify the server is running
+ const response = await fetch(`${TWENTY_API_URL}/healthz`);
+
+ if (!response.ok) {
+ throw new Error(
+ `Twenty server is not reachable at ${TWENTY_API_URL}. ` +
+ 'Start the server before running integration tests.',
+ );
+ }
+
+ // Write a temporary config for the SDK
+ fs.mkdirSync(TEST_CONFIG_DIR, { recursive: true });
+
+ fs.writeFileSync(
+ path.join(TEST_CONFIG_DIR, 'config.json'),
+ JSON.stringify({
+ remotes: {
+ local: {
+ apiUrl: process.env.TWENTY_API_URL,
+ apiKey: process.env.TWENTY_API_KEY,
+ },
+ },
+ defaultRemote: 'local',
+ }, null, 2),
+ );
+});
+```
+
+## واجهات SDK البرمجية
+
+يُصدِّر المسار الفرعي `twenty-sdk/cli` دوالًا يمكنك استدعاؤها مباشرةً من شيفرة الاختبار:
+
+| دالة | الوصف |
+| -------------- | ----------------------------------------- |
+| `appBuild` | بناء التطبيق واختياريًا حزم ملف tarball |
+| `appDeploy` | رفع ملف tarball إلى الخادم |
+| `appInstall` | تثبيت التطبيق على مساحة العمل النشطة |
+| `appUninstall` | إلغاء تثبيت التطبيق من مساحة العمل النشطة |
+
+تُرجع كل دالة كائن نتيجة يحتوي على `success: boolean` وعلى إمّا `data` أو `error`.
+
+## كتابة اختبار تكامل
+
+إليك مثالًا كاملًا يبني التطبيق وينشره ويثبّته، ثم يتحقّق من ظهوره في مساحة العمل:
+
+```ts src/__tests__/app-install.integration-test.ts
+import { APPLICATION_UNIVERSAL_IDENTIFIER } from 'src/application-config';
+import { appBuild, appDeploy, appInstall, appUninstall } from 'twenty-sdk/cli';
+import { MetadataApiClient } from 'twenty-client-sdk/metadata';
+import { afterAll, beforeAll, describe, expect, it } from 'vitest';
+
+const APP_PATH = process.cwd();
+
+describe('App installation', () => {
+ beforeAll(async () => {
+ const buildResult = await appBuild({
+ appPath: APP_PATH,
+ tarball: true,
+ onProgress: (message: string) => console.log(`[build] ${message}`),
+ });
+
+ if (!buildResult.success) {
+ throw new Error(`Build failed: ${buildResult.error?.message}`);
+ }
+
+ const deployResult = await appDeploy({
+ tarballPath: buildResult.data.tarballPath!,
+ onProgress: (message: string) => console.log(`[deploy] ${message}`),
+ });
+
+ if (!deployResult.success) {
+ throw new Error(`Deploy failed: ${deployResult.error?.message}`);
+ }
+
+ const installResult = await appInstall({ appPath: APP_PATH });
+
+ if (!installResult.success) {
+ throw new Error(`Install failed: ${installResult.error?.message}`);
+ }
+ });
+
+ afterAll(async () => {
+ await appUninstall({ appPath: APP_PATH });
+ });
+
+ it('should find the installed app in the workspace', async () => {
+ const metadataClient = new MetadataApiClient();
+
+ const result = await metadataClient.query({
+ findManyApplications: {
+ id: true,
+ name: true,
+ universalIdentifier: true,
+ },
+ });
+
+ const installedApp = result.findManyApplications.find(
+ (app: { universalIdentifier: string }) =>
+ app.universalIdentifier === APPLICATION_UNIVERSAL_IDENTIFIER,
+ );
+
+ expect(installedApp).toBeDefined();
+ });
+});
+```
+
+## تشغيل الاختبارات
+
+تأكّد من تشغيل خادم Twenty المحلي لديك، ثم:
+
+```bash filename="Terminal"
+yarn test
+```
+
+أو في وضع المراقبة أثناء التطوير:
+
+```bash filename="Terminal"
+yarn test:watch
+```
+
+## التحقق من الأنواع
+
+يمكنك أيضًا تشغيل التحقق من الأنواع على تطبيقك دون تشغيل الاختبارات:
+
+```bash filename="Terminal"
+yarn twenty dev:typecheck
+```
+
+يشغِّل هذا الأمر `tsc --noEmit` ويبلغ عن أي أخطاء في الأنواع.
+
+## التكامل المستمر (CI) باستخدام GitHub Actions
+
+تولّد أداة إنشاء الهيكل سير عمل GitHub Actions جاهزًا للاستخدام في `.github/workflows/ci.yml`. يشغّل اختبارات التكامل لديك تلقائيًا عند كل دفع إلى `main` وعلى طلبات السحب.
+
+سير العمل:
+
+1. يجلب الشيفرة الخاصة بك
+2. يشغّل خادم Twenty مؤقتًا باستخدام الإجراء `twentyhq/twenty/.github/actions/spawn-twenty-docker-image`
+3. يثبّت التبعيات باستخدام `yarn install --immutable`
+4. يشغّل `yarn test` مع حقن `TWENTY_API_URL` و`TWENTY_API_KEY` من مخرجات الإجراء
+
+```yaml .github/workflows/ci.yml
+name: CI
+
+on:
+ push:
+ branches:
+ - main
+ pull_request: {}
+
+env:
+ TWENTY_VERSION: latest
+
+jobs:
+ test:
+ runs-on: ubuntu-latest
+ steps:
+ - name: Checkout
+ uses: actions/checkout@v4
+
+ - name: Spawn Twenty instance
+ id: twenty
+ uses: twentyhq/twenty/.github/actions/spawn-twenty-docker-image@main
+ with:
+ twenty-version: ${{ env.TWENTY_VERSION }}
+ github-token: ${{ secrets.GITHUB_TOKEN }}
+
+ - name: Enable Corepack
+ run: corepack enable
+
+ - name: Setup Node.js
+ uses: actions/setup-node@v4
+ with:
+ node-version-file: '.nvmrc'
+ cache: 'yarn'
+
+ - name: Install dependencies
+ run: yarn install --immutable
+
+ - name: Run integration tests
+ run: yarn test
+ env:
+ TWENTY_API_URL: ${{ steps.twenty.outputs.server-url }}
+ TWENTY_API_KEY: ${{ steps.twenty.outputs.access-token }}
+```
+
+لا تحتاج إلى تهيئة أي أسرار — إذ يبدأ إجراء `spawn-twenty-docker-image` خادم Twenty عابرًا مباشرة في المشغّل ويُخرِج تفاصيل الاتصال. يتم توفير السر `GITHUB_TOKEN` تلقائيًا من قِبل GitHub.
+
+لتثبيت إصدار محدّد من Twenty بدلًا من `latest`، غيّر متغير البيئة `TWENTY_VERSION` في أعلى سير العمل.
diff --git a/packages/twenty-docs/l/ar/developers/extend/capabilities/apis.mdx b/packages/twenty-docs/l/ar/developers/extend/capabilities/apis.mdx
index 6039d0e7f56..fb54564d1db 100644
--- a/packages/twenty-docs/l/ar/developers/extend/capabilities/apis.mdx
+++ b/packages/twenty-docs/l/ar/developers/extend/capabilities/apis.mdx
@@ -88,7 +88,7 @@ Authorization: Bearer YOUR_API_KEY
لتحسين الأمان، عيّن دوراً محدداً لتقييد الوصول:
-1. اذهب إلى **الإعدادات → الأدوار**
+1. انتقل إلى **الإعدادات → الأعضاء → الأدوار**
2. انقر على الدور الذي ترغب في تعيينه
3. افتح علامة التبويب **التعيين**
4. ضمن **مفاتيح API**، انقر على **+ تعيين إلى مفتاح API**
diff --git a/packages/twenty-docs/l/ar/developers/self-host/capabilities/docker-compose.mdx b/packages/twenty-docs/l/ar/developers/self-host/capabilities/docker-compose.mdx
index 3d8c0eb0ad6..741c3324839 100644
--- a/packages/twenty-docs/l/ar/developers/self-host/capabilities/docker-compose.mdx
+++ b/packages/twenty-docs/l/ar/developers/self-host/capabilities/docker-compose.mdx
@@ -51,7 +51,7 @@ VERSION=vx.y.z BRANCH=branch-name bash <(curl -sL https://raw.githubusercontent.
curl -o .env https://raw.githubusercontent.com/twentyhq/twenty/refs/heads/main/packages/twenty-docker/.env.example
```
-2. **إنشاء رموز سرية**
+2. **إنشاء مفتاح تشفير**
قم بتشغيل الأمر التالي لإنشاء سلسلة عشوائية فريدة:
@@ -59,16 +59,18 @@ VERSION=vx.y.z BRANCH=branch-name bash <(curl -sL https://raw.githubusercontent.
openssl rand -base64 32
```
- **مهم:** احتفظ بهذه القيمة سرية ولا تشاركها.
+ **مهم:** احتفظ بهذه القيمة سرية ولا تشاركها. فقدان `ENCRYPTION_KEY` يعني فقدان الوصول إلى كل سر مخزَّن في قاعدة البيانات (رموز OAuth، متغيرات التطبيق، أسرار TOTP، إلخ).
3. **تحديث الـ `.env`**
استبدل قيمة النائب في ملف .env بالقيمة الرمزية المولدة:
```ini
- APP_SECRET=first_random_string
+ ENCRYPTION_KEY=random_string
```
+ راجع [دليل تدوير المفاتيح](/l/ar/developers/self-host/capabilities/key-rotation) للحصول على إرشادات حول تدويره بدون توقّف عن العمل.
+
4. **تعيين كلمة مرور PostgreSQL**
قم بتحديث قيمة `PG_DATABASE_PASSWORD` في ملف .env باستخدام كلمة مرور قوية بدون أحرف خاصة.
diff --git a/packages/twenty-docs/l/ar/developers/self-host/capabilities/key-rotation.mdx b/packages/twenty-docs/l/ar/developers/self-host/capabilities/key-rotation.mdx
new file mode 100644
index 00000000000..486bd0d2411
--- /dev/null
+++ b/packages/twenty-docs/l/ar/developers/self-host/capabilities/key-rotation.mdx
@@ -0,0 +1,60 @@
+---
+title: تدوير المفاتيح
+icon: rotate
+---
+
+يمتلك Twenty عائلتين مستقلتين من المفاتيح:
+
+* **مفاتيح توقيع JWT** — أزواج مفاتيح غير متماثلة ES256 (مع علامة `kid`) مُخزَّنة في `core."signingKey"`، تُستخدم لتوقيع والتحقق من رموز الوصول / التحديث.
+* **مفتاح التشفير أثناء السكون (At-rest encryption key)** — `ENCRYPTION_KEY`، يُستخدم لتشفير رموز OAuth، ومتغيرات التطبيق، ومفاتيح التوقيع الخاصة، وقيم الإعدادات الحساسة، وأسرار TOTP داخل غلاف `enc:v2:`.
+
+يُعد `APP_SECRET` سراً قديماً مُحتفَظاً به لأغراض التوافق مع الإصدارات السابقة: عندما لا يكون `ENCRYPTION_KEY` مضبوطاً، فإنه يعمل كحل احتياطي لمفتاح التشفير أثناء السكون / ملفات تعريف الارتباط للجلسة، ولا يزال يتحقق من رموز الوصول HS256 الموجودة مسبقاً. سيتم إهماله (إيقاف دعمه).
+
+## مفاتيح توقيع JWT
+
+يحمل كل مفتاح قيمة `publicKey` (يُحتفَظ بها إلى أجل غير مسمى حتى يمكنها التحقق من الرموز المصدرة مسبقاً)، و`privateKey` مُشفَّراً (يُستخدم فقط أثناء كون المفتاح حالياً)، وراية `isCurrent` (صف واحد فقط في كل وقت)، وحقل `revokedAt` اختياري.
+
+### تدوير المفتاح الحالي
+
+اضبط `SIGNING_KEY_ROTATION_DAYS` للتفعيل: عندها تصدر مهمة cron يومية مفتاحًا حاليًا جديدًا بمجرد أن يصبح المفتاح القائم أقدم من تلك العتبة. لا يتم إبطال المفاتيح السابقة، لذلك تستمر الرموز الموقعة تحتها في التحقق. اترك المتغير غير معيّن لتعطيل التدوير التلقائي.
+
+<Note>ميزة التدوير التلقائي متوفّرة ابتداءً من الإصدار v2.6+.</Note>
+
+### إبطال مفتاح (في حالات التسريب / الطوارئ فقط)
+
+**Settings → Admin Panel → Signing keys → Revoke** على صف غير حالي. تعمل على مسح المادة الخاصة المشفرة، وتعيين `revokedAt`، ورفض كل رمز حالي موقَّع تحت هذا الـ `kid`.
+
+## تدوير `ENCRYPTION_KEY`
+
+<Note>أمر `secret-encryption:rotate` الموضَّح أدناه متوفر ابتداءً من الإصدار v2.6+.</Note>
+
+يُغلَّف كل مقدار مُشفَّر بالشكل `enc:v2:\<keyId>:\<payload>`، حيث إن `\<keyId>` هو بادئة مكوَّنة من 8 أرقام ست عشرية مشتقة من المفتاح الخام. تتم عملية التدوير (الاستبدال) أثناء العمل، وقابلة للاستئناف.
+
+1. **إنشاء مفتاح جديد**: `openssl rand -base64 32`.
+
+2. **ضَبْط المفتاحين معاً جنباً إلى جنب** في ملف `.env`، ثم إعادة تشغيل الخدمة:
+ ```ini
+ ENCRYPTION_KEY=NEW_VALUE
+ FALLBACK_ENCRYPTION_KEY=OLD_VALUE
+ ```
+ تستخدم عمليات الكتابة الجديدة المفتاح الجديد، بينما لا تزال الصفوف الحالية تُفك تشفيرها عبر المفتاح الاحتياطي (fallback).
+
+3. **إعادة تشفير الصفوف الحالية**:
+
+ ```bash
+ docker exec -it {server_container} yarn command:prod secret-encryption:rotate
+ ```
+
+ يتناول الأمر ستة مواقع (`connected-account-tokens`، `application-variable`، `application-registration-variable`، `signing-key-private-keys`، `sensitive-config-storage`، `totp-secrets`). يُهمِل عامل تصفية SQL الصفوف الموجودة بالفعل على `\<keyId>` الجديد، لذلك يكون الأمر عديم الأثر التكراري (idempotent): يمكنك مقاطعته وإعادة تشغيله حسب الحاجة. يخرج بقيمة مختلفة عن الصفر إذا فشل أي صف — أعد تشغيله لإعادة المحاولة.
+
+ | خيار | الوصف |
+ | ---------------------------------------- | ------------------------------------------------------------- |
+ | `-s, --site \<site>` | حصر التنفيذ على موقع واحد فقط. |
+ | `-b, --batch-size \<n>` | عدد الصفوف في كل دفعة (الافتراضي `200`، والحد الأقصى `5000`). |
+ | `-d, --dry-run` | فك التشفير + إعادة التشفير في الذاكرة، مع تخطي جملة `UPDATE`. |
+
+4. **إزالة المفتاح الاحتياطي (fallback)** بمجرد أن يُظهِر الخيار `--dry-run` عدم وجود صفوف متبقية: أزِل `FALLBACK_ENCRYPTION_KEY` وأعد التشغيل.
+
+## دعم `APP_SECRET` القديم
+
+تستخدم النُسخ الأقدم التي لم تُعيِّن `ENCRYPTION_KEY` مطلقاً المتغيِّر `APP_SECRET` كمفتاح التشفير أثناء السكون (وكسرّ ملف تعريف الارتباط الخاص بالجلسة، المشتقّ منه). يُحفَظ هذا المسار لأغراض التوافق مع الإصدارات السابقة ولكنه **مهمل (موقوف الدعم)** — عيِّن متغير `ENCRYPTION_KEY` مخصَّصاً واتبع إجراء التدوير الموضَّح أعلاه للانتقال بعيداً عنه. يبقى `APP_SECRET` نفسه قيد الاستخدام للتحقق من رموز الوصول HS256 القديمة.
diff --git a/packages/twenty-docs/l/ar/developers/self-host/capabilities/setup.mdx b/packages/twenty-docs/l/ar/developers/self-host/capabilities/setup.mdx
index 9cbd4582c31..ab47013a135 100644
--- a/packages/twenty-docs/l/ar/developers/self-host/capabilities/setup.mdx
+++ b/packages/twenty-docs/l/ar/developers/self-host/capabilities/setup.mdx
@@ -43,11 +43,26 @@ IS_CONFIG_VARIABLES_IN_DB_ENABLED=true # افتراضي
<Warning>
كل متغير موثق بوصف في لوحة الإدارة الخاصة بك في **الإعدادات → لوحة الإدارة → متغيرات التكوين**.
-بعض إعدادات البنية التحتية مثل اتصالات قاعدة البيانات (`PG_DATABASE_URL`)، عناوين الخوادم (`SERVER_URL`)، وأسرار التطبيقات (`APP_SECRET`) يمكن ضبطها فقط عبر ملف `.env`.
+بعض إعدادات البنية التحتية مثل اتصالات قاعدة البيانات (`PG_DATABASE_URL`)، عناوين الخوادم (`SERVER_URL`)، والأسرار (`ENCRYPTION_KEY`, `FALLBACK_ENCRYPTION_KEY`) يمكن ضبطها فقط عبر ملف `.env`.
[مرجع تقني كامل →](https://github.com/twentyhq/twenty/blob/main/packages/twenty-server/src/engine/core-modules/twenty-config/config-variables.ts)
</Warning>
+## مفاتيح التشفير
+
+تستخدم Twenty مفتاحَي تشفير يحددان حصراً عبر متغيرات البيئة:
+
+| المتغيّر | الغرض | مطلوب |
+| ------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------- |
+| `ENCRYPTION_KEY` | المفتاح الأساسي المستخدم لتشفير الأسرار أثناء التخزين (رموز OAuth، متغيرات التطبيق، المفاتيح الخاصة لمفاتيح التوقيع، أسرار TOTP، قيم الإعدادات الحساسة). | نعم في عمليات التثبيت الجديدة (قد تعتمد عمليات التثبيت القديمة بدلاً من ذلك على `APP_SECRET` — انظر أدناه) |
+| `FALLBACK_ENCRYPTION_KEY` | مفتاح مخصص للتحقق فقط. يتم تعيينه أثناء التدوير ليكون `ENCRYPTION_KEY` السابق حتى تظل الصفوف الحالية قابلة لفك التشفير. | فقط أثناء التدوير |
+
+لضمان التوافق مع الإصدارات السابقة، إذا لم يتم تعيين `ENCRYPTION_KEY`، فإن Twenty تستخدم `APP_SECRET` كبديل لتشفير البيانات أثناء التخزين — بما يطابق سلوك الإصدارات القديمة في عمليات النشر الأقدم. يجب على عمليات التثبيت الجديدة دائماً تعيين قيمة مخصصة لـ `ENCRYPTION_KEY`.
+
+قم بإنشاء القيم باستخدام الأمر `openssl rand -base64 32` وخزنها في مكان آمن (مثل مدير الأسرار، إعدادات مُشفَّرة، إلخ). فقدان `ENCRYPTION_KEY` يعني فقدان الوصول إلى كل سر مخزن في قاعدة البيانات.
+
+لتدوير `ENCRYPTION_KEY` بدون وقت توقف، راجع [دليل تدوير المفاتيح](/l/ar/developers/self-host/capabilities/key-rotation).
+
## 2. إعداد بيئي فقط
```bash
diff --git a/packages/twenty-docs/l/ar/developers/self-host/capabilities/upgrade-guide.mdx b/packages/twenty-docs/l/ar/developers/self-host/capabilities/upgrade-guide.mdx
index 52f677ffe3c..2563549e590 100644
--- a/packages/twenty-docs/l/ar/developers/self-host/capabilities/upgrade-guide.mdx
+++ b/packages/twenty-docs/l/ar/developers/self-host/capabilities/upgrade-guide.mdx
@@ -31,6 +31,18 @@ cat databases_backup.sql | docker exec -i {db_container_name_or_id} psql -U {pos
على سبيل المثال، الترقية من v1.22 مباشرةً إلى v2.0 مدعومة بالكامل.
+## الترقية إلى v2.5+ — غلاف التشفير للبيانات الساكنة (at-rest)
+
+بدءًا من **v2.5**، يقوم Twenty بتخزين الأسرار أثناء السكون (at-rest) — مثل رموز OAuth، ومتغيرات التطبيق، ومفاتيح التوقيع الخاصة، وقيم الإعدادات الحساسة، وأسرار TOTP — داخل غلاف ذي إصدار `enc:v2:` ومشفّر باستخدام `ENCRYPTION_KEY` (أو `APP_SECRET` إذا لم يتم تعيين `ENCRYPTION_KEY`).
+
+أول إقلاع على v2.5 يشغّل أوامر ترقية بطيئة تقوم بإجراء **ملء رجعي** للصفوف الموجودة داخل الغلاف الجديد. هذه الأوامر عديمة الأثر عند التكرار (idempotent) — إيقاف الخادم وإعادة تشغيله يستأنف من حيث توقّف — لكنها قد تستغرق بعض الوقت على قواعد البيانات الكبيرة. يمكنك متابعة التقدّم باستخدام `upgrade:status`.
+
+يجب تعيين `ENCRYPTION_KEY` مخصص **قبل** الترقية إلى v2.5 لكي يكتب الملء الرجعي الصفوف باستخدامه منذ البداية. يتطلّب تبديل المفاتيح بعد الملء الرجعي إجراء [تدوير](/l/ar/developers/self-host/capabilities/key-rotation).
+
+## تدوير الأسرار ومفاتيح التوقيع
+
+لمهام التشغيل اليومية مثل تدوير `ENCRYPTION_KEY`، أو تدوير مفتاح توقيع JWT، أو إبطال مفتاح توقيع تم تسريبه، راجع [دليل تدوير المفاتيح (Key rotation guide)](/l/ar/developers/self-host/capabilities/key-rotation).
+
## التحقق من حالة الترقية
يتيح لك الأمر `upgrade:status` فحص الحالة الحالية لمثيلك وعمليات ترحيل مساحات العمل. يكون مفيدًا لاستكشاف مشكلات الترقية وإصلاحها أو عند تقديم طلب دعم.
diff --git a/packages/twenty-docs/l/ar/navigation.json b/packages/twenty-docs/l/ar/navigation.json
index 9125e270548..6459fff16c9 100644
--- a/packages/twenty-docs/l/ar/navigation.json
+++ b/packages/twenty-docs/l/ar/navigation.json
@@ -155,7 +155,27 @@
"label": "نظرة عامة"
},
"apps": {
- "label": "التطبيقات"
+ "label": "التطبيقات",
+ "groups": {
+ "appsGettingStarted": {
+ "label": "البدء"
+ },
+ "appsConfig": {
+ "label": "التهيئة"
+ },
+ "appsData": {
+ "label": "بيانات"
+ },
+ "appsLogic": {
+ "label": "المنطق"
+ },
+ "appsLayout": {
+ "label": "التخطيط"
+ },
+ "appsOperations": {
+ "label": "العمليات"
+ }
+ }
},
"api": {
"label": "واجهة برمجة التطبيقات"
diff --git a/packages/twenty-docs/l/ar/twenty-ui/input/buttons.mdx b/packages/twenty-docs/l/ar/twenty-ui/input/buttons.mdx
index 93f1b4d03ce..66443f7fdc7 100644
--- a/packages/twenty-docs/l/ar/twenty-ui/input/buttons.mdx
+++ b/packages/twenty-docs/l/ar/twenty-ui/input/buttons.mdx
@@ -13,7 +13,7 @@ icon: مؤشر اليد
<Tabs>
-<Tab title="27332A2E2F2745">
+<Tab title="Usage">
```jsx
import { Button } from "@/ui/input/button/components/Button";
diff --git a/packages/twenty-docs/l/ar/twenty-ui/input/color-scheme.mdx b/packages/twenty-docs/l/ar/twenty-ui/input/color-scheme.mdx
index 33b3fea6327..4a569976992 100644
--- a/packages/twenty-docs/l/ar/twenty-ui/input/color-scheme.mdx
+++ b/packages/twenty-docs/l/ar/twenty-ui/input/color-scheme.mdx
@@ -12,7 +12,7 @@ icon: لوحة الألوان
يمثل مخططات ألوان مختلفة ومخصص بشكل خاص للمواضيع الفاتحة والداكنة.
<Tabs>
-<Tab title="27332A2E2F2745">
+<Tab title="Usage">
```jsx
import { ColorSchemeCard } from "twenty-ui/display";
diff --git a/packages/twenty-docs/l/ar/twenty-ui/input/image-input.mdx b/packages/twenty-docs/l/ar/twenty-ui/input/image-input.mdx
index 05031a7ffc5..d1bab5e4afb 100644
--- a/packages/twenty-docs/l/ar/twenty-ui/input/image-input.mdx
+++ b/packages/twenty-docs/l/ar/twenty-ui/input/image-input.mdx
@@ -1,12 +1,12 @@
---
-title: "\x062A\x062F\x062E\x064A\x0644 \x0627\x0644\x0635\x0648\x0631\x0629"
+title: Image Input
---
<Frame>
<img src="/images/user-guide/objects/objects.png" alt="رأس الصفحة" />
</Frame>
-4A4F33452D 44445245332A2E2F454A46 28452F 482532274429 35483129.
+Allows users to upload and remove an image.
<Tabs>
<Tab title="استخدام">
@@ -25,7 +25,7 @@ export const MyComponent = () => {
| الخصائص | النوع | الوصف |
| ------------ | ----------- | --------------------------------------------------------------------------------- |
-| صورة | نص | 3946482746 45352F31 274435483129 27442544432A3148464A |
+| صورة | نص | The image source URL |
| onUpload | دالة | الدالة التي تُستدعى عند قيام المستخدم بتحميل صورة جديدة. تستقبل كائن `File` كوسيط |
| onRemove | دالة | الدالة التي تُستدعى عند نقر المستخدم على زر الإزالة |
| onAbort | دالة | الدالة التي تُستدعى عند نقر المستخدم على زر الإلغاء أثناء تحميل الصورة |
diff --git a/packages/twenty-docs/l/ar/twenty-ui/input/radio.mdx b/packages/twenty-docs/l/ar/twenty-ui/input/radio.mdx
index 45f79f2615d..316a48fcce3 100644
--- a/packages/twenty-docs/l/ar/twenty-ui/input/radio.mdx
+++ b/packages/twenty-docs/l/ar/twenty-ui/input/radio.mdx
@@ -38,7 +38,7 @@ export const MyComponent = () => {
/>
);
};
-},{
+
```
diff --git a/packages/twenty-docs/l/ar/twenty-ui/input/text.mdx b/packages/twenty-docs/l/ar/twenty-ui/input/text.mdx
index 0a486c641e1..31ca0ca7db6 100644
--- a/packages/twenty-docs/l/ar/twenty-ui/input/text.mdx
+++ b/packages/twenty-docs/l/ar/twenty-ui/input/text.mdx
@@ -12,7 +12,7 @@ title: نص
<Tabs>
-<Tab title="27332A2E2F2745">
+<Tab title="Usage">
```jsx
import { TextInput } from "@/ui/input/components/TextInput";
diff --git a/packages/twenty-docs/l/ar/twenty-ui/navigation/links.mdx b/packages/twenty-docs/l/ar/twenty-ui/navigation/links.mdx
index 332eb0783f7..17b3a514945 100644
--- a/packages/twenty-docs/l/ar/twenty-ui/navigation/links.mdx
+++ b/packages/twenty-docs/l/ar/twenty-ui/navigation/links.mdx
@@ -12,7 +12,7 @@ icon: رابط
مكون رابط منمق لعرض معلومات الاتصال.
<Tabs>
-<Tab title="27332A2E2F2745">
+<Tab title="Usage">
```jsx
import { BrowserRouter as Router } from 'react-router-dom';
@@ -35,7 +35,7 @@ export const MyComponent = () => {
</ContactLink>
</Router>
);
-};},{
+};
```
diff --git a/packages/twenty-docs/l/ar/user-guide/ai/capabilities/mcp.mdx b/packages/twenty-docs/l/ar/user-guide/ai/capabilities/mcp.mdx
index 0ebb7eb82c8..5072f52976b 100644
--- a/packages/twenty-docs/l/ar/user-guide/ai/capabilities/mcp.mdx
+++ b/packages/twenty-docs/l/ar/user-guide/ai/capabilities/mcp.mdx
@@ -103,11 +103,10 @@ MCP حاليًا في مرحلة **ألفا** وهو متاح فقط في بعض
بعد الاتصال، يوفّر خادم MCP أدوات تعكس واجهة برمجة تطبيقات Twenty (API). سير العمل الموصى به هو:
-1. **`get_tool_catalog`** — اكتشف جميع الأدوات المتاحة
-2. **`learn_tools`** — احصل على مخطط الإدخال لأدوات محددة
-3. **`execute_tool`** — شغّل أداة
+1. **`learn_tools`** — احصل على مخطط الإدخال لأدوات محددة
+2. **`execute_tool`** — شغّل أداة
-لا تحتاج إلى تذكّر أسماء الأدوات. اسأل مساعد الذكاء الاصطناعي عمّا يمكنه فعله وسيستدعي `get_tool_catalog` تلقائيًا.
+لا تحتاج إلى تذكّر أسماء الأدوات. اسأل مساعد الذكاء الاصطناعي عمّا يمكنه فعله وسيستدعي `learn_tools` تلقائيًا.
## الصلاحيات
diff --git a/packages/twenty-docs/l/ar/user-guide/ai/capabilities/permissions-access-control.mdx b/packages/twenty-docs/l/ar/user-guide/ai/capabilities/permissions-access-control.mdx
index fe7142975dd..fceb31d0b1b 100644
--- a/packages/twenty-docs/l/ar/user-guide/ai/capabilities/permissions-access-control.mdx
+++ b/packages/twenty-docs/l/ar/user-guide/ai/capabilities/permissions-access-control.mdx
@@ -9,7 +9,7 @@ description: تحكّم بما يمكن لوكلاء الذكاء الاصطنا
## تعيين دور لوكيل ذكاء اصطناعي
-1. اذهب إلى **الإعدادات → الأدوار**
+1. انتقل إلى **الإعدادات → الأعضاء → الأدوار**
2. انقر على الدور الذي ترغب في تعيينه
3. افتح علامة التبويب **التعيين**
4. ضمن **وكلاء الذكاء الاصطناعي**، انقر **+ تعيين لوكيل ذكاء اصطناعي**
diff --git a/packages/twenty-docs/l/ar/user-guide/ai/how-tos/ai-faq.mdx b/packages/twenty-docs/l/ar/user-guide/ai/how-tos/ai-faq.mdx
index 47513752f60..05931310dee 100644
--- a/packages/twenty-docs/l/ar/user-guide/ai/how-tos/ai-faq.mdx
+++ b/packages/twenty-docs/l/ar/user-guide/ai/how-tos/ai-faq.mdx
@@ -17,7 +17,7 @@ description: الأسئلة الشائعة حول ميزات الذكاء الا
</Accordion>
<Accordion title="هل سيكون لوكلاء الذكاء الاصطناعي حق الوصول إلى جميع بياناتي؟">
- سيعمل وكلاء الذكاء الاصطناعي ضمن نظام الأذونات. يمكنك تعيين أدوار محددة لوكلاء الذكاء الاصطناعي ضمن **الإعدادات → الأدوار**، مما يمنحك سيطرة كاملة على البيانات التي يمكنهم الوصول إليها والإجراءات التي يمكنهم القيام بها.
+ سيعمل وكلاء الذكاء الاصطناعي ضمن نظام الأذونات. يمكنك تعيين أدوار محددة لوكلاء الذكاء الاصطناعي ضمن **الإعدادات → الأعضاء → الأدوار**، مما يمنحك سيطرة كاملة على البيانات التي يمكنهم الوصول إليها والإجراءات التي يمكنهم القيام بها.
</Accordion>
<Accordion title="كيف ستعمل أرصدة الذكاء الاصطناعي؟">
diff --git a/packages/twenty-docs/l/ar/user-guide/ai/overview.mdx b/packages/twenty-docs/l/ar/user-guide/ai/overview.mdx
index 8baa5e85d2e..97c251caf86 100644
--- a/packages/twenty-docs/l/ar/user-guide/ai/overview.mdx
+++ b/packages/twenty-docs/l/ar/user-guide/ai/overview.mdx
@@ -48,7 +48,7 @@ description: ميزات مدعومة بالذكاء الاصطناعي قادم
سيُدار وكلاء الذكاء الاصطناعي عبر نظام الأذونات الحالي:
-1. اذهب إلى **الإعدادات → الأدوار**
+1. انتقل إلى **الإعدادات → الأعضاء → الأدوار**
2. حدِّد البيانات التي يمكن لكل وكيل ذكاء اصطناعي الوصول إليها
3. عيّن أذونات القراءة/الكتابة لكل كائن
diff --git a/packages/twenty-docs/l/ar/user-guide/billing/capabilities/pricing-plans.mdx b/packages/twenty-docs/l/ar/user-guide/billing/capabilities/pricing-plans.mdx
index 1e029638c46..6f44952235e 100644
--- a/packages/twenty-docs/l/ar/user-guide/billing/capabilities/pricing-plans.mdx
+++ b/packages/twenty-docs/l/ar/user-guide/billing/capabilities/pricing-plans.mdx
@@ -19,7 +19,7 @@ description: تعرّف على خطط تسعير Twenty وكيفية التبد
* دعم قياسي
<Note>
-Premium features (SSO, row-level permissions and AI usage data) are not included in the Pro plan.
+الميزات المتميزة (SSO، أذونات على مستوى الصف وبيانات استخدام الذكاء الاصطناعي) غير مشمولة في خطة Pro.
</Note>
### المؤسسة (سحابي)
@@ -27,7 +27,7 @@ Premium features (SSO, row-level permissions and AI usage data) are not included
للفرق الأكبر ذات الاحتياجات المتقدّمة:
* كل ما في Pro
-* **Premium features**: SSO integration, row-level permissions and AI usage data
+* **الميزات المتميزة**: تكامل SSO، أذونات على مستوى الصف وبيانات استخدام الذكاء الاصطناعي
* دعم متميز
## خطط الاستضافة الذاتية
@@ -45,7 +45,7 @@ Premium features (SSO, row-level permissions and AI usage data) are not included
للفرق التي تحتاج إلى ميزات متميزة أثناء الاستضافة الذاتية:
* جميع ميزات Pro
-* **Premium features**: SSO integration, row-level permissions and AI usage data
+* **الميزات المتميزة**: تكامل SSO، أذونات على مستوى الصف وبيانات استخدام الذكاء الاصطناعي
* دعم فريق Twenty
* لا يُشترط نشر الشيفرة المخصّصة كمفتوح المصدر قبل التوزيع
@@ -55,7 +55,7 @@ Premium features (SSO, row-level permissions and AI usage data) are not included
* **تكامل SSO**: تسجيل دخول أحادي مع موفّر الهوية لديك
* **أذونات على مستوى الصف**: تحكّم دقيق في الوصول على مستوى السجل
-* **AI usage data**: Track AI consumption across the workspace
+* **بيانات استخدام الذكاء الاصطناعي**: تتبع استهلاك الذكاء الاصطناعي عبر مساحة العمل
## التبديل بين الخطط
@@ -79,14 +79,14 @@ Premium features (SSO, row-level permissions and AI usage data) are not included
تواصل مع الدعم للعودة إلى الفوترة الشهرية.
-## Obtain an Enterprise Key for Organization (Self-Hosted)
+## احصل على مفتاح Enterprise لخطة Organization (Self-Hosted)
-To use the Organization (Self-Hosted) plan, you need to obtain an Enterprise key:
+لاستخدام خطة Organization (Self-Hosted)، تحتاج إلى الحصول على مفتاح Enterprise:
-1. Go to **Settings → Admin Panel → Enterprise**
+1. اذهب إلى **الإعدادات → لوحة الإدارة → Enterprise**
-<img src="/images/user-guide/billing/enterprise-key.png" alt="Enterprise key" />
+<img src="/images/user-guide/billing/enterprise-key.png" alt="مفتاح Enterprise" />
-2. Click **Get Enterprise Key**
-3. When you are redirected to Stripe, enter your payment details and confirm
-4. When your Enterprise key is displayed, paste it into the Enterprise settings page and activate the Organization license
+2. انقر **احصل على مفتاح Enterprise**
+3. عند إعادة توجيهك إلى Stripe، أدخل تفاصيل الدفع الخاصة بك وأكّد
+4. عند عرض مفتاح Enterprise الخاص بك، الصقه في صفحة إعدادات Enterprise وقم بتفعيل ترخيص Organization
diff --git a/packages/twenty-docs/l/ar/user-guide/calendar-emails/overview.mdx b/packages/twenty-docs/l/ar/user-guide/calendar-emails/overview.mdx
index cf2f7015c63..d6a9d4abda1 100644
--- a/packages/twenty-docs/l/ar/user-guide/calendar-emails/overview.mdx
+++ b/packages/twenty-docs/l/ar/user-guide/calendar-emails/overview.mdx
@@ -25,15 +25,25 @@ description: Connect your email and calendar accounts to Twenty.
6. Configure calendar sync settings (visibility, auto-creation) → click **Add Account**
7. ستبدأ رسائل البريد الإلكتروني وفعاليات التقويم بالمزامنة تلقائيًا
-### إعداد SMTP/CalDAV (مزودون آخرون)
+### إعداد IMAP/SMTP/CalDAV (مزودون آخرون)
بالنسبة لمزودي البريد الإلكتروني والتقويم الآخرين:
1. اذهب إلى **الإعدادات → الحسابات**
-2. قم بتكوين إعدادات SMTP للبريد الإلكتروني
+2. قم بتهيئة إعدادات IMAP لمزامنة رسائل البريد الإلكتروني الواردة وإعدادات SMTP لإرسال البريد الإلكتروني
3. قم بتكوين إعدادات CalDAV للتقويم
4. اختبر الاتصال
+<Note>
+**الاستضافة الذاتية على شبكة معزولة هوائيًا أو شبكة داخلية**: بشكل افتراضي، يرفض Twenty الاتصالات الصادرة إلى عناوين IP الخاصة/الداخلية (حماية SSRF). إذا كان خادم البريد أو التقويم يعمل على عنوان IP محلي/خاص (مثل خادم داخلي على شبكة LAN)، فسيتم حظر الاتصالات به. للسماح بهذه الاتصالات، قم بتعيين متغير البيئة التالي على الخادم:
+
+```
+OUTBOUND_HTTP_SAFE_MODE_ENABLED=false
+```
+
+هذا يعطّل الوضع الآمن لكل طلبات الإرسال الصادرة (**HTTP workflow actions**، و **webhooks**، واتصالات **IMAP/SMTP/CalDAV**)، لذا لا تقم بتفعيله إلا على الشبكات المعزولة والموثوقة حيث لا تكون حماية SSRF مطلوبة.
+</Note>
+
### صناديق بريد متعددة
* **حسابات غير محدودة**: ربط حسابات بريد إلكتروني متعددة لكل مستخدم
@@ -59,10 +69,19 @@ description: Connect your email and calendar accounts to Twenty.
* **معطل**: لا يتم إنشاء جهات اتصال تلقائيًا
* **للرسائل المرسلة والمستلمة**: إنشاء جهات اتصال لجميع التفاعلات البريدية الخارجية
* **للرسائل المرسلة فقط**: إنشاء جهات اتصال فقط لرسائل البريد التي ترسلها
-* **ملاحظة**: لا تتم مزامنة رسائل البريد الداخلية (نفس النطاق) للحفاظ على الخصوصية
+* **ملاحظة**: بشكل افتراضي، لا تتم مزامنة الرسائل الإلكترونية الداخلية (عندما يشترك جميع المشاركين في نفس النطاق) لحماية الخصوصية
<Note>When enabled, contacts are automatically linked to their Company records based on their email domain. If the company doesn't exist yet, Twenty creates it for you.</Note>
+<Note>
+**مزامنة الرسائل الإلكترونية الداخلية**: سلوك "عدم مزامنة الرسائل الإلكترونية الداخلية" هو السلوك الافتراضي، ولكن يمكن إيقافه. مفتاح التبديل موجود في الإعدادات المتقدمة:
+1. افتح **الإعدادات** وفعّل مفتاح التبديل **المتقدمة** في أسفل صفحة الإعدادات
+2. اذهب إلى **عام → الأمان**
+3. فعّل مفتاح التبديل **مزامنة الرسائل الإلكترونية الداخلية** لتضمين الرسائل الإلكترونية التي يشترك فيها جميع المشاركين في نفس النطاق
+
+هذا إعداد على مستوى مساحة العمل (مفيد للجامعات أو المؤسسات ذات النطاق المشترك).
+</Note>
+
### التحكم بالرسائل التي تتم مزامنتها من خلال اختيار مجلد الرسائل
تحكم بما تم مزامنته من مجلدات البريد الإلكتروني مع Twenty:
@@ -79,7 +98,7 @@ description: Connect your email and calendar accounts to Twenty.
**ما الذي يتم مزامنته:**
* **رسائل البريد الخارجية**: جميع رسائل البريد الإلكتروني مع جهات اتصال خارجية من المجلدات المحددة
-* **الرسائل الداخلية**: لا يتم مزامنتها (تبقى رسائل البريد من نفس النطاق خاصة)
+* **الرسائل الداخلية**: لا تتم مزامنتها بشكل افتراضي (تبقى رسائل البريد من نفس النطاق خاصة). فعّل مفتاح التبديل **المتقدمة** في أسفل **الإعدادات**، ثم شغّل **مزامنة الرسائل الإلكترونية الداخلية** ضمن **عام → الأمان** لتضمينها على مستوى مساحة العمل.
* **المرفقات**: ستأتي في النصف الأول من 2026
**ملاحظة**: لا نقدم عنوان بريد إلكتروني لنسخة كربونية للمزامنة الانتقائية. بدلاً من ذلك، استخدم ميزة مجلد الرسائل المذكورة أعلاه لتحقيق نفس مستوى التحكم حول أي الرسائل يتم مزامنتها مع Twenty.
diff --git a/packages/twenty-docs/l/ar/user-guide/data-migration/capabilities/field-mapping.mdx b/packages/twenty-docs/l/ar/user-guide/data-migration/capabilities/field-mapping.mdx
index 88c6b724149..04fef427aad 100644
--- a/packages/twenty-docs/l/ar/user-guide/data-migration/capabilities/field-mapping.mdx
+++ b/packages/twenty-docs/l/ar/user-guide/data-migration/capabilities/field-mapping.mdx
@@ -56,7 +56,7 @@ import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
استخدم التنسيق التالي:
```
-[\"value1\",\"value2\"]
+["value1","value2"]
```
### حقول القيم المنطقية
@@ -94,7 +94,7 @@ import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
* للبريد الإلكتروني الإضافي: استخدم **Emails / Primary Email** للبريد الرئيسي، و**Emails / Additional Emails** بهذا التنسيق:
```
```
### حقول المعرّف
@@ -125,7 +125,7 @@ import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
* للروابط الثانوية، استخدم عمود **Links / Secondary Links** بهذا التنسيق:
```
-[{\"url\":\"https://twenty.com\",\"label\":\"Twenty\"}]
+[{"url":"https://twenty.com","label":"Twenty"}]
```
### حقول التحديد المتعدد
@@ -133,7 +133,7 @@ import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
استخدم **أسماء واجهة برمجة التطبيقات (API)** (وليس تسميات العرض) بالتنسيق التالي:
```
-[\"VALUE1\",\"VALUE2\"]
+["VALUE1","VALUE2"]
```
اطّلع [هنا](#finding-api-names-for-select-fields) لمعرفة مكان العثور على أسماء واجهة برمجة التطبيقات.
@@ -143,7 +143,7 @@ import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
<Warning>
**الاستيراد يستبدل، لا يضيف.**
-إذا كان السجل يحتوي بالفعل على `VALUE2` و`VALUE3` محدّدين، ثم استوردت `[\"VALUE1\"]`، فسيحتوي السجل على `VALUE1` فقط بعد الاستيراد. يتم استبدال التحديدات السابقة، وليس دمجها.
+إذا كان السجل يحتوي بالفعل على `VALUE2` و`VALUE3` محدّدين، ثم استوردت `["VALUE1"]`، فسيحتوي السجل على `VALUE1` فقط بعد الاستيراد. يتم استبدال التحديدات السابقة، وليس دمجها.
</Warning>
### حقول الأرقام
diff --git a/packages/twenty-docs/l/ar/user-guide/data-migration/capabilities/file-formats.mdx b/packages/twenty-docs/l/ar/user-guide/data-migration/capabilities/file-formats.mdx
index 9a4773e6127..11f2adddbb3 100644
--- a/packages/twenty-docs/l/ar/user-guide/data-migration/capabilities/file-formats.mdx
+++ b/packages/twenty-docs/l/ar/user-guide/data-migration/capabilities/file-formats.mdx
@@ -25,7 +25,7 @@ description: تنسيقات الملفات المدعومة لاستيراد ا
## أفضل الممارسات لملفات CSV
* **المحدد**: استخدم الفاصلة (`,`) أو الفاصلة المنقوطة (`;`)
-* **محدد النص**: استخدم علامات الاقتباس المزدوجة (`\"`) للنص الذي يحتوي على فواصل
+* **محدد النص**: استخدم علامات الاقتباس المزدوجة (`"`) للنص الذي يحتوي على فواصل
* **نهايات الأسطر**: Windows (CRLF) أو Unix (LF) كلاهما مدعومان
* **القيم الفارغة**: اترك الخلايا فارغة، لا تستخدم "NULL" أو "N/A"
diff --git a/packages/twenty-docs/l/ar/user-guide/data-migration/how-tos/migrating-from-other-crms.mdx b/packages/twenty-docs/l/ar/user-guide/data-migration/how-tos/migrating-from-other-crms.mdx
index 1f114815937..ba730e4e707 100644
--- a/packages/twenty-docs/l/ar/user-guide/data-migration/how-tos/migrating-from-other-crms.mdx
+++ b/packages/twenty-docs/l/ar/user-guide/data-migration/how-tos/migrating-from-other-crms.mdx
@@ -214,7 +214,7 @@ Jane,Doe,[email protected],https://widgets.co
### تكوين الأدوار والصلاحيات
-* قم بإعداد الأدوار في **الإعدادات → الأدوار**
+* قم بإعداد الأدوار في **الإعدادات → الأعضاء → الأدوار**
* عيّن المستخدمين إلى الأدوار المناسبة
### اربط البريد الإلكتروني والتقويم
diff --git a/packages/twenty-docs/l/ar/user-guide/data-migration/how-tos/migrating-from-self-hosted-to-cloud.mdx b/packages/twenty-docs/l/ar/user-guide/data-migration/how-tos/migrating-from-self-hosted-to-cloud.mdx
index 3374e2f1610..fb1cba151af 100644
--- a/packages/twenty-docs/l/ar/user-guide/data-migration/how-tos/migrating-from-self-hosted-to-cloud.mdx
+++ b/packages/twenty-docs/l/ar/user-guide/data-migration/how-tos/migrating-from-self-hosted-to-cloud.mdx
@@ -127,7 +127,7 @@ Acme Corp,https://acme.com,[email protected]
### الأدوار والصلاحيات
-* قم بتكوين الأدوار في **الإعدادات → الأدوار**
+* قم بتكوين الأدوار في **الإعدادات → الأعضاء → الأدوار**
* عيّن المستخدمين إلى الأدوار المناسبة
### التكاملات
diff --git a/packages/twenty-docs/l/ar/user-guide/data-migration/how-tos/prepare-your-csv-files.mdx b/packages/twenty-docs/l/ar/user-guide/data-migration/how-tos/prepare-your-csv-files.mdx
index 62b1a05b7da..25aa9ac1ccb 100644
--- a/packages/twenty-docs/l/ar/user-guide/data-migration/how-tos/prepare-your-csv-files.mdx
+++ b/packages/twenty-docs/l/ar/user-guide/data-migration/how-tos/prepare-your-csv-files.mdx
@@ -65,7 +65,7 @@ description: دليل كامل خطوة بخطوة لتنسيق بياناتك
* للعناوين الإضافية للبريد الإلكتروني، استخدم هذا التنسيق في عمود **Emails / Additional Emails**:
```
```
### حقول النطاق
diff --git a/packages/twenty-docs/l/ar/user-guide/data-migration/how-tos/update-existing-records-via-import.mdx b/packages/twenty-docs/l/ar/user-guide/data-migration/how-tos/update-existing-records-via-import.mdx
index 467c2728435..6374761830d 100644
--- a/packages/twenty-docs/l/ar/user-guide/data-migration/how-tos/update-existing-records-via-import.mdx
+++ b/packages/twenty-docs/l/ar/user-guide/data-migration/how-tos/update-existing-records-via-import.mdx
@@ -27,9 +27,9 @@ description: دليل كامل خطوة بخطوة لتحديث السجلات
<Warning>
**يتم استبدال حقول الاختيار المتعدد، ولا يتم دمجها.**
-إذا كان السجل محدّدًا فيه `Option A` و`Option B`، وقمتَ باستيراد `[\"Option C\"]`، فسيحتوي السجل على `Option C` فقط بعد الاستيراد. تستبدل عملية الاستيراد جميع الاختيارات السابقة — ولا تضيف إليها.
+إذا كان السجل محدّدًا فيه `Option A` و`Option B`، وقمتَ باستيراد `["Option C"]`، فسيحتوي السجل على `Option C` فقط بعد الاستيراد. تستبدل عملية الاستيراد جميع الاختيارات السابقة — ولا تضيف إليها.
-للاحتفاظ بالقيم الحالية، ضمّنها جميعًا في عملية الاستيراد: `[\"Option A\",\"Option B\",\"Option C\"]`
+للاحتفاظ بالقيم الحالية، ضمّنها جميعًا في عملية الاستيراد: `["Option A","Option B","Option C"]`
</Warning>
## الخطوة 1: تصدير بياناتك الحالية
diff --git a/packages/twenty-docs/l/ar/user-guide/data-model/capabilities/fields.mdx b/packages/twenty-docs/l/ar/user-guide/data-model/capabilities/fields.mdx
index a70ec1786d0..b0c6b558fde 100644
--- a/packages/twenty-docs/l/ar/user-guide/data-model/capabilities/fields.mdx
+++ b/packages/twenty-docs/l/ar/user-guide/data-model/capabilities/fields.mdx
@@ -101,6 +101,10 @@ import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
إذا ظهرت لك رسالة خطأ عند تعيين خاصية التفرد، فتحقق من وجود قيم مكررة في بياناتك (بما في ذلك السجلات المحذوفة).
+## الفهارس (متقدّم)
+
+تُدار فهارس قاعدة البيانات تلقائيًا — ونادرًا ما تكون إضافة فهارسك الخاصة ضرورية، ومن السهل الوقوع في الأخطاء عند القيام بذلك. مع تفعيل الوضع المتقدّم، يكون لكل كائن قسم **Indexes** تحت `Settings → Data Model → <object>` للحالات التي تعلم فيها أنك بحاجة إلى فهرس.
+
## أفضل ممارسات تكوين الحقول
### اتفاقيات التسمية والقيود
diff --git a/packages/twenty-docs/l/ar/user-guide/permissions-access/capabilities/permissions.mdx b/packages/twenty-docs/l/ar/user-guide/permissions-access/capabilities/permissions.mdx
index 7336b516f8b..c7585085745 100644
--- a/packages/twenty-docs/l/ar/user-guide/permissions-access/capabilities/permissions.mdx
+++ b/packages/twenty-docs/l/ar/user-guide/permissions-access/capabilities/permissions.mdx
@@ -13,7 +13,7 @@ description: تحكّم في الوصول إلى الكائنات والحقول
لإنشاء دور جديد:
-1. اذهب إلى **الإعدادات → الأدوار**
+1. انتقل إلى **الإعدادات → الأعضاء → الأدوار**
2. تحت **كل الأدوار**، انقر على **+ إنشاء دور**
3. أدخل اسم الدور
4. في علامة التبويب الافتراضية **الأذونات**، [كوّن الأذونات](#customize-permissions)
@@ -23,7 +23,7 @@ description: تحكّم في الوصول إلى الكائنات والحقول
لحذف دور:
-1. اذهب إلى **الإعدادات → الأدوار**
+1. انتقل إلى **الإعدادات → الأعضاء → الأدوار**
2. انقر على الدور الذي ترغب في إزالته
3. افتح علامة التبويب **الإعدادات**، ثم انقر على **حذف الدور**
4. انقر على **تأكيد** في النافذة المنبثقة
@@ -36,13 +36,13 @@ description: تحكّم في الوصول إلى الكائنات والحقول
### عرض التعيينات الحالية
-* اذهب إلى **الإعدادات → الأدوار**
+* انتقل إلى **الإعدادات → الأعضاء → الأدوار**
* رؤية جميع الأدوار وعدد الأعضاء المعينين لكل منها
* عرض الأعضاء الذين لديهم الأدوار المختلفة
### تعيين دور لعضو
-1. اذهب إلى **الإعدادات → الأدوار**
+1. انتقل إلى **الإعدادات → الأعضاء → الأدوار**
2. انقر على الدور الذي ترغب في تعيينه
3. افتح علامة التبويب **التعيين**
4. انقر على **+ تعيين لعضو**
@@ -51,7 +51,7 @@ description: تحكّم في الوصول إلى الكائنات والحقول
### تعيين الدور الافتراضي
-1. اذهب إلى **الإعدادات → الأدوار**
+1. انتقل إلى **الإعدادات → الأعضاء → الأدوار**
2. في قسم **الخيارات**، اعثر على **الدور الافتراضي**
3. اختر أي دور يجب أن يحصل عليه الأعضاء الجدد تلقائيًا
4. سيتم تعيين أعضاء مساحة العمل الجدد هذا الدور عند انضمامهم
@@ -98,6 +98,22 @@ description: تحكّم في الوصول إلى الكائنات والحقول
| الفرص → تعطيل "عرض السجلات" | لا يمكن للمتدرب رؤية كائن الفرص إطلاقًا |
| الأشخاص → تفعيل "تحرير السجلات" | يمكن للمتدرب تحرير سجلات الأشخاص (ولكن ليس الكائنات الأخرى) |
+### أذونات مستوى الصف
+
+<Note>
+أذونات مستوى الصف هي **ميزة Premium** متاحة ضمن خطة **Organization** (السحابي والمستضاف ذاتيًا).
+</Note>
+
+تتيح لك أذونات مستوى الصف تقييد السجلات الفردية التي يمكن للدور عرضها أو تعديلها، بناءً على معايير ديناميكية. على عكس أذونات الكائن (التي تنطبق على نوع الكائن بالكامل)، تقوم أذونات مستوى الصف بتقييم كل سجل بشكل مستقل.
+
+**أمثلة لحالات الاستخدام:**
+
+* يمكن لمندوبي المبيعات رؤية الفرص الخاصة بهم فقط
+* يمكن للمديرين رؤية جميع السجلات في منطقتهم
+* يمكن لوكلاء الدعم عرض التذاكر المخصصة لهم فقط
+
+لتهيئة أذونات مستوى الصف، افتح دورًا معيّنًا، وانتقل إلى علامة تبويب **Objects**، واستخدم قسم **Row-Level** لتحديد شروط التصفية لكائن معيّن.
+
### أذونات الحقول
داخل كل قاعدة على مستوى الكائن، يمكنك المتابعة أبعد من ذلك وتكوين **أذونات على مستوى الحقل** للتحكم في الوصول إلى حقول محددة.
@@ -168,7 +184,7 @@ description: تحكّم في الوصول إلى الكائنات والحقول
### تعيين دور لمفتاح API
-1. اذهب إلى **الإعدادات → الأدوار**
+1. انتقل إلى **الإعدادات → الأعضاء → الأدوار**
2. انقر على الدور الذي ترغب في تعيينه
3. افتح علامة التبويب **التعيين**
4. ضمن **مفاتيح API**، انقر على **+ تعيين إلى مفتاح API**
@@ -183,7 +199,7 @@ description: تحكّم في الوصول إلى الكائنات والحقول
### تعيين دور لوكيل ذكاء اصطناعي
-1. اذهب إلى **الإعدادات → الأدوار**
+1. انتقل إلى **الإعدادات → الأعضاء → الأدوار**
2. انقر على الدور الذي ترغب في تعيينه
3. افتح علامة التبويب **التعيين**
4. ضمن **وكلاء الذكاء الاصطناعي**، انقر على **+ تعيين إلى وكيل ذكاء اصطناعي**
diff --git a/packages/twenty-docs/l/ar/user-guide/permissions-access/how-tos/permissions-faq.mdx b/packages/twenty-docs/l/ar/user-guide/permissions-access/how-tos/permissions-faq.mdx
index 69e7b185be3..7905e659a01 100644
--- a/packages/twenty-docs/l/ar/user-guide/permissions-access/how-tos/permissions-faq.mdx
+++ b/packages/twenty-docs/l/ar/user-guide/permissions-access/how-tos/permissions-faq.mdx
@@ -19,7 +19,7 @@ description: الأسئلة الشائعة حول الأدوار والصلاح
</Accordion>
<Accordion title="كيف أعيّن دورًا افتراضيًا للأعضاء الجدد؟">
-انتقل إلى **Settings → Roles**، وابحث عن خيار **Default Role**، ثم اختر الدور الذي يجب أن يحصل عليه الأعضاء الجدد تلقائيًا عند انضمامهم.
+انتقل إلى **الإعدادات → الأعضاء → الأدوار**، وابحث عن خيار **Default Role**، ثم اختر الدور الذي يجب أن يحصل عليه الأعضاء الجدد تلقائيًا عند انضمامهم.
</Accordion>
<Accordion title="هل يمكنني تعيين عدة أدوار لمستخدم واحد؟">
@@ -60,11 +60,11 @@ description: الأسئلة الشائعة حول الأدوار والصلاح
</Accordion>
<Accordion title="هل يمكنني تقييد الوصول إلى سجلات محددة (صلاحيات على مستوى الصف)؟">
-ستكون الصلاحيات على مستوى الصف متاحة ضمن خطة **Organization** بحلول الربع الأول من عام 2026. يتيح لك ذلك تقييد الوصول إلى سجلات محددة بناءً على معايير معينة (مثل: رؤية فرصك الخاصة فقط).
+تتوفر الصلاحيات على مستوى الصف ضمن خطة **Organization**. يتيح لك ذلك تقييد الوصول إلى سجلات محددة بناءً على معايير معينة (مثل: رؤية فرصك الخاصة فقط).
</Accordion>
<Accordion title="كيف أجعل حقلًا للقراءة فقط لمستخدمين معيّنين؟">
-1. اذهب إلى **الإعدادات → الأدوار**
+1. انتقل إلى **الإعدادات → الأعضاء → الأدوار**
2. اختر الدور
3. انتقل إلى الكائن الذي يحتوي على الحقل
4. عيّن صلاحية الحقل إلى **See Field** (من دون Edit Field)
diff --git a/packages/twenty-docs/l/ar/user-guide/settings/capabilities/domains-settings.mdx b/packages/twenty-docs/l/ar/user-guide/settings/capabilities/domains-settings.mdx
index 80edf2f5d83..d3477a4378a 100644
--- a/packages/twenty-docs/l/ar/user-guide/settings/capabilities/domains-settings.mdx
+++ b/packages/twenty-docs/l/ar/user-guide/settings/capabilities/domains-settings.mdx
@@ -3,10 +3,12 @@ title: إعدادات النطاق
description: قم بتكوين نطاق مساحة العمل، ونطاقات الوصول المعتمدة، والنطاقات العامة.
---
-قم بتكوين إعدادات النطاق ضمن **الإعدادات → النطاقات**.
+إعدادات النطاق موجودة في ثلاثة أماكن، حسب ما تريد تكوينه.
## نطاق مساحة العمل
+قم بالتكوين ضمن **الإعدادات → عام → نطاق مساحة العمل**.
+
قم بتعديل اسم النطاق الفرعي الخاص بك أو عيّن نطاقًا مخصصًا لمساحة العمل.
### تخصيص النطاق
@@ -19,6 +21,8 @@ description: قم بتكوين نطاق مساحة العمل، ونطاقات
## النطاقات المعتمدة
+قم بالتكوين ضمن **الإعدادات → الأعضاء → دعوة**.
+
يُسمح لأي شخص لديه عنوان بريد إلكتروني ضمن هذه النطاقات بالتسجيل تلقائيًا في مساحة العمل هذه.
### إضافة نطاق وصول معتمد
@@ -35,13 +39,16 @@ description: قم بتكوين نطاق مساحة العمل، ونطاقات
## النطاقات العامة
-توفير بيئة استضافة كاملة وآمنة على هذه النطاقات.
+قم بالتكوين ضمن **الإعدادات → التطبيقات → المطور**.
+
+توفير بيئة استضافة كاملة وآمنة على هذه النطاقات. يمكن ربط نطاق عام بتطبيق معيّن — عند ربطه، تكون دوال منطق HTTP الموجهة لهذا التطبيق وحدها قابلة للوصول على هذا النطاق. اترك الربط فارغًا لكشف جميع مسارات HTTP في مساحة العمل.
### إضافة نطاق عام
1. انقر **إضافة نطاق عام**
2. أدخل النطاق الذي تريد استخدامه
-3. قم بتكوين إعدادات DNS وفق التعليمات
-4. تحقق من النطاق
+3. اربطه اختياريًا بتطبيق
+4. قم بتكوين إعدادات DNS وفق التعليمات
+5. تحقق من النطاق
يتم توفير شهادات SSL تلقائيًا للنطاقات العامة.
diff --git a/packages/twenty-docs/l/ar/user-guide/settings/capabilities/member-management.mdx b/packages/twenty-docs/l/ar/user-guide/settings/capabilities/member-management.mdx
index 04f9a0e3566..cbf8eccb05a 100644
--- a/packages/twenty-docs/l/ar/user-guide/settings/capabilities/member-management.mdx
+++ b/packages/twenty-docs/l/ar/user-guide/settings/capabilities/member-management.mdx
@@ -77,7 +77,7 @@ description: دعوة أعضاء الفريق وإدارة الوصول إلى
السماح لأعضاء الفريق بالانضمام تلقائيًا بناءً على نطاق بريدهم الإلكتروني:
-1. اذهب إلى **الإعدادات → النطاقات**
+1. انتقل إلى **الإعدادات → الأعضاء → دعوة**
2. أضف نطاق شركتك (مثل: `yourcompany.com`)
3. يمكن لأي شخص ينتمي بريده الإلكتروني إلى ذلك النطاق الانضمام من دون دعوة
diff --git a/packages/twenty-docs/l/ar/user-guide/settings/how-tos/settings-faq.mdx b/packages/twenty-docs/l/ar/user-guide/settings/how-tos/settings-faq.mdx
index 0bdd4721343..fbf4f5a6a2b 100644
--- a/packages/twenty-docs/l/ar/user-guide/settings/how-tos/settings-faq.mdx
+++ b/packages/twenty-docs/l/ar/user-guide/settings/how-tos/settings-faq.mdx
@@ -137,7 +137,7 @@ description: الأسئلة الشائعة حول إعدادات Twenty.
<AccordionGroup>
<Accordion title="هل يمكنني تخصيص دومين مساحة العمل الخاصة بي؟">
-نعم! اذهب إلى **الإعدادات → النطاقات** ثم انقر **تخصيص النطاق**. لديك خياران:
+نعم! اذهب إلى **الإعدادات → عام → نطاق مساحة العمل** ثم انقر **تخصيص النطاق**. لديك خياران:
* **النطاق الفرعي**: استخدم نطاقًا فرعيًا من Twenty مثل `yourcompany.twenty.com`
* **نطاق مخصص**: استخدم نطاقك الخاص مثل `crm.yourcompany.com` (يتطلب تهيئة DNS)
@@ -146,7 +146,7 @@ description: الأسئلة الشائعة حول إعدادات Twenty.
</Accordion>
<Accordion title="كيف تعمل نطاقات الوصول المعتمدة؟">
-يمكنك تكوين نطاقات الوصول المعتمدة بحيث يتمكن أعضاء الفريق ذوو عناوين البريد الإلكتروني الخاصة بالشركة من الانضمام تلقائيًا إلى مساحة العمل الخاصة بك. اذهب إلى **الإعدادات → النطاقات** وأضف نطاق شركتك (مثلًا، `yourcompany.com`).
+يمكنك تكوين نطاقات الوصول المعتمدة بحيث يتمكن أعضاء الفريق ذوو عناوين البريد الإلكتروني الخاصة بالشركة من الانضمام تلقائيًا إلى مساحة العمل الخاصة بك. اذهب إلى **الإعدادات → الأعضاء → دعوة** وأضف نطاق شركتك (مثلًا، `yourcompany.com`).
</Accordion>
</AccordionGroup>
diff --git a/packages/twenty-docs/l/ar/user-guide/settings/overview.mdx b/packages/twenty-docs/l/ar/user-guide/settings/overview.mdx
index 463481b9d8c..f14bc7278b6 100644
--- a/packages/twenty-docs/l/ar/user-guide/settings/overview.mdx
+++ b/packages/twenty-docs/l/ar/user-guide/settings/overview.mdx
@@ -44,7 +44,7 @@ description: قم بإعداد مساحة عملك في Twenty باستخدام
4. عيّن الأدوار المناسبة
<Note>
-قبل دعوة فريقك، تحقّق من الدور الافتراضي ضمن **الإعدادات → الأدوار**. يتم تعيين هذا الدور تلقائيًا للأعضاء الجدد عند انضمامهم.
+قبل دعوة فريقك، تحقّق من الدور الافتراضي ضمن **الإعدادات → الأعضاء → الأدوار**. يتم تعيين هذا الدور تلقائيًا للأعضاء الجدد عند انضمامهم.
</Note>
## قائمة التحقق لإعدادات مساحة العمل
diff --git a/packages/twenty-docs/l/ar/user-guide/views-pipelines/how-tos/show-expected-amount-in-pipeline.mdx b/packages/twenty-docs/l/ar/user-guide/views-pipelines/how-tos/show-expected-amount-in-pipeline.mdx
index bef5832bea1..bf4ee63f558 100644
--- a/packages/twenty-docs/l/ar/user-guide/views-pipelines/how-tos/show-expected-amount-in-pipeline.mdx
+++ b/packages/twenty-docs/l/ar/user-guide/views-pipelines/how-tos/show-expected-amount-in-pipeline.mdx
@@ -38,7 +38,7 @@ description: احسب واعرض قيم الصفقات الموزونة استن
إذا كنت لا تريد أن يحرّر المستخدمون هذه الحقول المحسوبة يدويًا:
-1. اذهب إلى **الإعدادات → الأدوار**
+1. انتقل إلى **الإعدادات → الأعضاء → الأدوار**
2. حدِّد الدور لتكوينه
3. اعثر على كائن «الفرص»
4. عيّن حقلي **الاحتمال** و**المبلغ المتوقع** كحقول للقراءة فقط
diff --git a/packages/twenty-docs/l/ar/user-guide/views-pipelines/how-tos/track-time-in-stage.mdx b/packages/twenty-docs/l/ar/user-guide/views-pipelines/how-tos/track-time-in-stage.mdx
index 3ce2b64a452..0db72c9271d 100644
--- a/packages/twenty-docs/l/ar/user-guide/views-pipelines/how-tos/track-time-in-stage.mdx
+++ b/packages/twenty-docs/l/ar/user-guide/views-pipelines/how-tos/track-time-in-stage.mdx
@@ -61,7 +61,7 @@ description: راقِب سرعة الصفقات بتتبُّع وقت دخول
إذا كنت لا تريد أن يحرّر المستخدمون هذه الحقول المحسوبة يدويًا:
-1. اذهب إلى **الإعدادات → الأدوار**
+1. انتقل إلى **الإعدادات → الأعضاء → الأدوار**
2. حدِّد الدور لتهيئته
3. اعثر على كائن الفرص
4. عيِّن حقول "آخر دخول" و"الأيام في" كحقول للقراءة فقط
diff --git a/packages/twenty-docs/l/ar/user-guide/workflows/capabilities/workflow-actions.mdx b/packages/twenty-docs/l/ar/user-guide/workflows/capabilities/workflow-actions.mdx
index 808b91d29f3..ebf10683e51 100644
--- a/packages/twenty-docs/l/ar/user-guide/workflows/capabilities/workflow-actions.mdx
+++ b/packages/twenty-docs/l/ar/user-guide/workflows/capabilities/workflow-actions.mdx
@@ -307,5 +307,5 @@ import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
</Note>
<Note>
-يحترم وكلاء الذكاء الاصطناعي الأذونات المستندة إلى الأدوار. يمكنك تعيين أدوار محددة للوكلاء ضمن **الإعدادات → الأدوار** للتحكم في البيانات التي يمكنهم الوصول إليها. راجع [الأذونات](/l/ar/user-guide/permissions-access/capabilities/permissions) للحصول على التفاصيل.
+يحترم وكلاء الذكاء الاصطناعي الأذونات المستندة إلى الأدوار. يمكنك تعيين أدوار محددة للوكلاء ضمن **الإعدادات → الأعضاء → الأدوار** للتحكم في البيانات التي يمكنهم الوصول إليها. راجع [الأذونات](/l/ar/user-guide/permissions-access/capabilities/permissions) للحصول على التفاصيل.
</Note>
diff --git a/packages/twenty-docs/l/ar/user-guide/workflows/how-tos/need-more-help/workflows-faq.mdx b/packages/twenty-docs/l/ar/user-guide/workflows/how-tos/need-more-help/workflows-faq.mdx
index b01fb9ec0f6..a7db85ce868 100644
--- a/packages/twenty-docs/l/ar/user-guide/workflows/how-tos/need-more-help/workflows-faq.mdx
+++ b/packages/twenty-docs/l/ar/user-guide/workflows/how-tos/need-more-help/workflows-faq.mdx
@@ -8,7 +8,7 @@ description: الأسئلة الشائعة حول سير العمل في Twenty.
<Accordion title="لماذا لا أستطيع تفعيل سير عمل؟">
من المحتمل أن تكون مشكلة أذونات. تحتاج إلى صلاحية الوصول إلى سير العمل لإنشائها وتفعيلها.
- **الحل**: تواصل مع مسؤول مساحة العمل لمنحك صلاحية الوصول إلى سير العمل ضمن **الإعدادات → الأدوار**.
+ **الحل**: تواصل مع مسؤول مساحة العمل لمنحك صلاحية الوصول إلى سير العمل ضمن **الإعدادات → الأعضاء → الأدوار**.
إذا لم ترَ قسم سير العمل إطلاقاً في الشريط الجانبي لديك، فهذا يؤكد أنها مشكلة أذونات.
</Accordion>
diff --git a/packages/twenty-docs/l/cs/developers/extend/api.mdx b/packages/twenty-docs/l/cs/developers/extend/api.mdx
index 1a38fee1d08..638f6ca7969 100644
--- a/packages/twenty-docs/l/cs/developers/extend/api.mdx
+++ b/packages/twenty-docs/l/cs/developers/extend/api.mdx
@@ -37,7 +37,7 @@ Both are available as REST and GraphQL. GraphQL adds batch upserts and the abili
Authorization: Bearer YOUR_API_KEY
```
-Create an API key in **Settings → API & Webhooks → + Create key**. Copy it immediately — it's shown once. Keys can be scoped to a specific role under **Settings → Roles → Assignment tab** to limit what they can access.
+Create an API key in **Settings → API & Webhooks → + Create key**. Copy it immediately — it's shown once. API klíče lze omezit na konkrétní roli v **Settings → Members → Roles → Assignment tab**, aby se omezilo, k čemu mají přístup.
<VimeoEmbed videoId="928786722" title="Vytvoření klíče API" />
diff --git a/packages/twenty-docs/l/cs/developers/extend/apps/config/application.mdx b/packages/twenty-docs/l/cs/developers/extend/apps/config/application.mdx
new file mode 100644
index 00000000000..0df39dc7efa
--- /dev/null
+++ b/packages/twenty-docs/l/cs/developers/extend/apps/config/application.mdx
@@ -0,0 +1,64 @@
+---
+title: Konfigurace aplikace
+description: Deklarujte identitu své aplikace, výchozí roli, proměnné a metadata tržiště pomocí defineApplication.
+icon: rocket
+---
+
+Každá aplikace musí mít právě jedno volání `defineApplication`. Deklaruje:
+
+* **Identita** — univerzální identifikátor, zobrazovaný název, popis.
+* **Oprávnění** — pod jakou rolí běží její logické funkce a frontendové komponenty.
+* **Proměnné** *(volitelné)* — páry klíč–hodnota zpřístupněné vašemu kódu jako proměnné prostředí.
+* **Předinstalační / postinstalační hooky** *(volitelné)* — viz [Logické funkce](/l/cs/developers/extend/apps/logic/logic-functions).
+
+```ts src/application-config.ts
+import { defineApplication } from 'twenty-sdk/define';
+
+export default defineApplication({
+ universalIdentifier: '39783023-bcac-41e3-b0d2-ff1944d8465d',
+ displayName: 'My Twenty App',
+ description: 'My first Twenty app',
+ applicationVariables: {
+ DEFAULT_RECIPIENT_NAME: {
+ universalIdentifier: '19e94e59-d4fe-4251-8981-b96d0a9f74de',
+ description: 'Default recipient name for postcards',
+ value: 'Jane Doe',
+ isSecret: false,
+ },
+ },
+});
+```
+
+Poznámky:
+
+* Pole `universalIdentifier` jsou deterministické identifikátory, které vlastníte. Vygenerujte je jednou a zachovejte je stabilní napříč synchronizacemi.
+* `applicationVariables` se stanou proměnnými prostředí pro vaše funkce a frontendové komponenty. V logických funkcích (na straně serveru) jsou dostupné jako `process.env.VARIABLE_NAME`. Ve frontendových komponentách použijte `getApplicationVariable('VARIABLE_NAME')` z `twenty-sdk/front-component`. Proměnné označené jako `isSecret: true` jsou předávány pouze do logických funkcí. Frontendové komponenty přijímají pouze proměnné, které nejsou tajné.
+* Výchozí role je automaticky detekována ze souboru role označeného pomocí [`defineApplicationRole()`](/l/cs/developers/extend/apps/config/roles) — není potřeba na ni odkazovat z `defineApplication()`.
+* Předinstalační a postinstalační funkce jsou při sestavení manifestu detekovány automaticky — není třeba na ně odkazovat v `defineApplication()`.
+* Předávání `defaultRoleUniversalIdentifier` explicitně je stále podporováno kvůli zpětné kompatibilitě, ale je zastaralé ve prospěch `defineApplicationRole()`.
+
+## Výchozí role funkce
+
+Role deklarovaná pomocí [`defineApplicationRole()`](/l/cs/developers/extend/apps/config/roles) určuje, k čemu mají přístup logické funkce a front-endové komponenty aplikace:
+
+* Běhový token vložený jako `TWENTY_APP_ACCESS_TOKEN` je odvozen z této role.
+* Typovaný klient API je omezen na oprávnění udělená této roli.
+* Dodržujte princip nejmenších oprávnění: deklarujte pouze ta oprávnění, která vaše funkce potřebují.
+
+Když vygenerujete novou aplikaci, CLI vytvoří úvodní soubor role v `src/roles/default-role.ts`. Úplnou referenci najdete v části [Role a oprávnění](/l/cs/developers/extend/apps/config/roles).
+
+## Metadata tržiště
+
+Pokud plánujete [zveřejnit svou aplikaci](/l/cs/developers/extend/apps/operations/publishing), tato volitelná pole určují, jak se vaše aplikace zobrazuje v tržišti:
+
+| Pole | Popis |
+| ------------------ | ------------------------------------------------------------------------------------------------------------- |
+| `author` | Jméno autora nebo název společnosti |
+| `category` | Kategorie aplikace pro filtrování v tržišti |
+| `logoUrl` | Cesta k logu vaší aplikace (např. `public/logo.png`) |
+| `screenshots` | Pole cest ke snímkům obrazovky (např. `public/screenshot-1.png`) |
+| `aboutDescription` | Delší popis v Markdownu pro kartu "O aplikaci". Pokud je vynecháno, tržiště použije `README.md` balíčku z npm |
+| `websiteUrl` | Odkaz na váš web |
+| `termsUrl` | Odkaz na podmínky služby |
+| `emailSupport` | E-mailová adresa podpory |
+| `issueReportUrl` | Odkaz na nástroj pro sledování problémů |
diff --git a/packages/twenty-docs/l/cs/developers/extend/apps/config/install-hooks.mdx b/packages/twenty-docs/l/cs/developers/extend/apps/config/install-hooks.mdx
new file mode 100644
index 00000000000..402f9aaf194
--- /dev/null
+++ b/packages/twenty-docs/l/cs/developers/extend/apps/config/install-hooks.mdx
@@ -0,0 +1,206 @@
+---
+title: Instalační hooky
+description: Spouštějte logiku před instalací nebo po ní — naplňte data, zazálohujte záznamy, ověřte aktualizaci.
+icon: klíč
+---
+
+Instalační hooky jsou speciální logické funkce, které se spouštějí během životního cyklu instalace nebo upgradu. Sdílí stejný runtime handleru jako běžné [logické funkce](/l/cs/developers/extend/apps/logic/logic-functions) a přijímají `InstallPayload`, ale deklarují se pomocí vlastních definičních funkcí — `definePostInstallLogicFunction()` a `definePreInstallLogicFunction()` — a fungují mimo běžný model triggerů (HTTP, cron, databázové události).
+
+Každá aplikace může definovat **nanejvýš jednu pre-install** a **nanejvýš jednu post-install** funkci. Sestavení manifestu skončí chybou, pokud je zjištěno více než jedno.
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│ install flow │
+│ │
+│ upload package → [pre-install] → metadata migration → │
+│ generate SDK → [post-install] │
+│ │
+│ old schema visible new schema visible │
+└─────────────────────────────────────────────────────────────┘
+```
+
+<AccordionGroup>
+<Accordion title="definePostInstallLogicFunction" description="Spouští se po aplikování migrace metadat pracovního prostoru">
+
+Postinstalační funkce se spustí automaticky, jakmile je instalace vaší aplikace v pracovním prostoru dokončena. Server ji provede **poté**, co byla synchronizována metadata aplikace a vygenerován klient SDK, takže je pracovní prostor plně připraven k použití a nové schéma je zavedeno. Mezi typické případy použití patří naplnění výchozími daty, vytvoření počátečních záznamů, konfigurace nastavení pracovního prostoru nebo zřizování prostředků ve službách třetích stran.
+
+```ts src/logic-functions/post-install.ts
+import { definePostInstallLogicFunction, type InstallPayload } from 'twenty-sdk/define';
+
+const handler = async (payload: InstallPayload): Promise<void> => {
+ console.log('Post install logic function executed successfully!', payload.previousVersion);
+};
+
+export default definePostInstallLogicFunction({
+ universalIdentifier: 'f7a2b9c1-3d4e-5678-abcd-ef9876543210',
+ name: 'post-install',
+ description: 'Runs after installation to set up the application.',
+ timeoutSeconds: 300,
+ shouldRunOnVersionUpgrade: false,
+ shouldRunSynchronously: false,
+ handler,
+});
+```
+
+Postinstalační funkci můžete také kdykoli spustit ručně pomocí CLI:
+
+```bash filename="Terminal"
+yarn twenty dev:function:exec --postInstall
+```
+
+Hlavní body:
+* Postinstalační funkce používají `definePostInstallLogicFunction()` — specializovanou variantu, která vynechává nastavení spouštěčů (`cronTriggerSettings`, `databaseEventTriggerSettings`, `httpRouteTriggerSettings`, `toolTriggerSettings`, `workflowActionTriggerSettings`).
+* Obslužná funkce obdrží `InstallPayload` s `{ previousVersion?: string; newVersion: string }` — `newVersion` je verze, která se instaluje, a `previousVersion` je verze, která byla nainstalována dříve (nebo `undefined` při čisté instalaci). Tyto hodnoty použijte k rozlišení čistých instalací od aktualizací a ke spuštění migrační logiky specifické pro verzi.
+* **Kdy se hook spouští**: ve výchozím nastavení pouze při čistých instalacích. Předejte `shouldRunOnVersionUpgrade: true`, pokud chcete, aby se spouštěl i při aktualizaci aplikace z předchozí verze. Pokud je vynechán, příznak má výchozí hodnotu `false` a při aktualizacích se hook přeskočí.
+* **Model provádění — ve výchozím nastavení asynchronní, synchronní volitelně**: příznak `shouldRunSynchronously` určuje *jak* se spouští post-install.
+ * `shouldRunSynchronously: false` *(výchozí)* — hook je **zařazen do fronty zpráv** s `retryLimit: 3` a běží asynchronně ve workeru. Odezva instalace se vrátí hned po zařazení úlohy do fronty, takže pomalá nebo chybující obslužná funkce neblokuje volajícího. Worker se pokusí o opakování až třikrát. **Použijte pro dlouho běžící úlohy** — plnění velkých datových sad, volání pomalých externích API, zřizování externích prostředků, cokoli, co by mohlo přesáhnout rozumné časové okno HTTP odezvy.
+ * `shouldRunSynchronously: true` — hook se provádí **inline během instalačního procesu** (stejný vykonavatel jako pre-install). Instalační požadavek blokuje, dokud obslužná funkce nedokončí, a pokud vyvolá výjimku, volající instalace obdrží `POST_INSTALL_ERROR`. Žádné automatické opakování. **Použijte pro rychlé úlohy, které se musí dokončit před odpovědí** — například vrácení validační chyby uživateli nebo rychlé nastavení, na kterém bude klient záviset ihned po návratu volání instalace. Mějte na paměti, že v době, kdy se spustí post-install, už byla migrace metadat aplikována, takže selhání v synchronním režimu změny schématu **ne**vrací zpět — pouze odhalí chybu.
+* Ujistěte se, že vaše obslužná funkce je idempotentní. V asynchronním režimu se může fronta pokusit až třikrát; v obou režimech se může hook znovu spustit při aktualizacích, pokud je `shouldRunOnVersionUpgrade: true`.
+* Proměnné prostředí `APPLICATION_ID`, `APP_ACCESS_TOKEN` a `API_URL` jsou dostupné uvnitř obslužné funkce (stejně jako u jakékoli jiné logické funkce), takže můžete volat Twenty API s aplikačním přístupovým tokenem omezeným na vaši aplikaci.
+* Na jednu aplikaci je povolena pouze jedna postinstalační funkce. Sestavení manifestu skončí chybou, pokud je zjištěna více než jedna.
+* Atributy funkce `universalIdentifier`, `shouldRunOnVersionUpgrade` a `shouldRunSynchronously` jsou během buildu automaticky připojeny k manifestu aplikace do pole `postInstallLogicFunction` — není potřeba je uvádět v [`defineApplication()`](/l/cs/developers/extend/apps/config/application).
+* Výchozí časový limit je nastaven na 300 sekund (5 minut), aby umožnil delší úlohy nastavení, jako je naplnění daty.
+* **Nespouští se v režimu dev**: když je aplikace registrována lokálně (pomocí `yarn twenty dev`), server zcela přeskočí instalační tok a synchronizuje soubory přímo prostřednictvím sledovače CLI — takže se post-install v režimu dev nikdy nespustí bez ohledu na `shouldRunSynchronously`. Použijte `yarn twenty dev:function:exec --postInstall` k ručnímu spuštění nad běžícím pracovním prostorem.
+
+</Accordion>
+<Accordion title="definePreInstallLogicFunction" description="Spouští se před aplikováním migrace metadat pracovního prostoru">
+
+Předinstalační funkce se během instalace spouští automaticky, **před aplikováním migrace metadat pracovního prostoru**. Má stejný tvar payloadu jako post-install (`InstallPayload`), ale je zařazena dříve v instalačním toku, aby mohla připravit stav, na němž nadcházející migrace závisí — typické použití zahrnuje zálohování dat, ověření kompatibility s novým schématem nebo archivaci záznamů, které se chystají přeuspořádat nebo odstranit.
+
+```ts src/logic-functions/pre-install.ts
+import { definePreInstallLogicFunction, type InstallPayload } from 'twenty-sdk/define';
+
+const handler = async (payload: InstallPayload): Promise<void> => {
+ console.log('Pre install logic function executed successfully!', payload.previousVersion);
+};
+
+export default definePreInstallLogicFunction({
+ universalIdentifier: 'a1b2c3d4-5678-90ab-cdef-1234567890ab',
+ name: 'pre-install',
+ description: 'Runs before installation to prepare the application.',
+ timeoutSeconds: 300,
+ shouldRunOnVersionUpgrade: true,
+ handler,
+});
+```
+
+Předinstalační funkci můžete také kdykoli spustit ručně pomocí CLI:
+
+```bash filename="Terminal"
+yarn twenty dev:function:exec --preInstall
+```
+
+Hlavní body:
+* Funkce pre-install používají `definePreInstallLogicFunction()` — stejné specializované nastavení jako u post-install, pouze připojené k jiné fázi životního cyklu.
+* Obě obslužné funkce pre- i post-install přijímají stejný typ `InstallPayload`: `{ previousVersion?: string; newVersion: string }`. Importujte jej jednou a znovu použijte pro oba hooky.
+* **Kdy se hook spouští**: umístěn těsně před migrací metadat pracovního prostoru (`synchronizeFromManifest`). Před spuštěním server provede čistě aditivní "zjednodušenou synchronizaci", která v metadatech pracovního prostoru zaregistruje pre-install funkci **nové** verze — ničeho dalšího se nedotkne — a poté ji spustí. Protože tato synchronizace je pouze aditivní, objekty, pole a data předchozí verze zůstávají při spuštění vaší obslužné funkce zachována: můžete bezpečně číst a zálohovat stav před migrací.
+* **Model provádění**: pre-install se provádí **synchronně** a **blokuje instalaci**. Pokud obslužná funkce vyvolá výjimku, instalace se přeruší ještě před aplikováním jakýchkoli změn schématu — pracovní prostor zůstane na předchozí verzi v konzistentním stavu. Je to záměrné: pre-install je vaše poslední šance odmítnout rizikovou aktualizaci.
+* Stejně jako u post-install je na jednu aplikaci povolena pouze jedna funkce pre-install. Během buildu je automaticky připojena k manifestu aplikace pod `preInstallLogicFunction`.
+* **Nespouští se v režimu dev**: stejně jako u post-install — u lokálně registrovaných aplikací je instalační tok zcela přeskočen, takže se pre-install pod `yarn twenty dev` nikdy nespustí. Použijte `yarn twenty dev:function:exec --preInstall` k ručnímu spuštění.
+
+</Accordion>
+<Accordion title="Pre-install vs post-install: kdy použít který" description="Výběr správného instalačního hooku">
+
+Oba hooky jsou součástí téhož instalačního toku a přijímají stejný `InstallPayload`. Rozdíl je v tom, **kdy** se spouštějí vzhledem k migraci metadat pracovního prostoru, a to určuje, jakých dat se mohou bezpečně dotýkat.
+
+Pre-install je vždy **synchronní** (blokuje instalaci a může ji přerušit). Post-install je **ve výchozím nastavení asynchronní** — zařazen do workeru s automatickými pokusy o opakování — ale může přejít na synchronní provádění pomocí `shouldRunSynchronously: true`. Viz accordion `definePostInstallLogicFunction` výše, kdy použít jednotlivé režimy.
+
+**Použijte `post-install` pro cokoli, co vyžaduje existenci nového schématu.** To je běžný případ:
+
+* Plnění výchozími daty (vytváření počátečních záznamů, výchozích pohledů, demo obsahu) vůči nově přidaným objektům a polím.
+* Registrace webhooků u služeb třetích stran poté, co má aplikace své přihlašovací údaje.
+* Volání vlastního API k dokončení nastavení, které závisí na synchronizovaných metadatech.
+* Idempotentní logika "zajisti, že to existuje", která má při každé aktualizaci uvést stav do souladu — kombinujte s `shouldRunOnVersionUpgrade: true`.
+
+Příklad — po instalaci naplňte výchozí záznam `PostCard`:
+
+```ts src/logic-functions/post-install.ts
+import { definePostInstallLogicFunction, type InstallPayload } from 'twenty-sdk/define';
+import { createClient } from './generated/client';
+
+const handler = async ({ previousVersion }: InstallPayload): Promise<void> => {
+ if (previousVersion) return; // fresh installs only
+
+ const client = createClient();
+ await client.postCard.create({
+ data: { title: 'Welcome to Postcard', content: 'Your first card!' },
+ });
+};
+
+export default definePostInstallLogicFunction({
+ universalIdentifier: 'f7a2b9c1-3d4e-5678-abcd-ef9876543210',
+ name: 'post-install',
+ description: 'Seeds a welcome post card after install.',
+ timeoutSeconds: 300,
+ shouldRunOnVersionUpgrade: false,
+ handler,
+});
+```
+
+**Použijte `pre-install`, pokud by migrace jinak zničila nebo poškodila existující data.** Protože pre-install běží proti *předchozímu* schématu a jeho selhání vrací aktualizaci zpět, je to správné místo pro cokoli rizikového:
+
+* **Zálohování dat, která se chystají odstranit nebo přeuspořádat** — např. odstraňujete pole ve verzi v2 a potřebujete jeho hodnoty zkopírovat do jiného pole nebo je před spuštěním migrace exportovat do úložiště.
+* **Archivace záznamů, které by nové omezení zneplatnilo** — např. pole se stává `NOT NULL` a je třeba nejprve smazat nebo opravit řádky s hodnotami null.
+* **Ověření kompatibility a odmítnutí aktualizace, pokud nelze aktuální data čistě migrovat** — vyhoďte výjimku z obslužné funkce a instalace se ukončí bez provedených změn. Je to bezpečnější, než zjistit nekompatibilitu uprostřed migrace.
+* **Přejmenování nebo změna klíčů dat** před změnou schématu, která by ztratila vazby.
+
+Příklad — archivujte záznamy před destruktivní migrací:
+
+```ts src/logic-functions/pre-install.ts
+import { definePreInstallLogicFunction, type InstallPayload } from 'twenty-sdk/define';
+import { createClient } from './generated/client';
+
+const handler = async ({ previousVersion, newVersion }: InstallPayload): Promise<void> => {
+ // Only the 1.x → 2.x upgrade drops the legacy `notes` field.
+ if (!previousVersion?.startsWith('1.') || !newVersion.startsWith('2.')) {
+ return;
+ }
+
+ const client = createClient();
+ const legacyRecords = await client.postCard.findMany({
+ where: { notes: { isNotNull: true } },
+ });
+
+ if (legacyRecords.length === 0) return;
+
+ // Copy legacy `notes` into the new `description` field before the migration
+ // drops the `notes` column. If this fails, the upgrade is aborted and the
+ // workspace stays on v1 with all data intact.
+ await Promise.all(
+ legacyRecords.map((record) =>
+ client.postCard.update({
+ where: { id: record.id },
+ data: { description: record.notes },
+ }),
+ ),
+ );
+};
+
+export default definePreInstallLogicFunction({
+ universalIdentifier: 'a1b2c3d4-5678-90ab-cdef-1234567890ab',
+ name: 'pre-install',
+ description: 'Backs up legacy notes into description before the v2 migration.',
+ timeoutSeconds: 300,
+ shouldRunOnVersionUpgrade: true,
+ handler,
+});
+```
+
+**Zlaté pravidlo:**
+
+| Chcete... | Použít |
+| ------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------- |
+| Naplňte výchozí data, nakonfigurujte pracovní prostor, zaregistrujte externí prostředky | `post-install` |
+| Spusťte dlouho běžící plnění nebo volání třetích stran, která by neměla blokovat odezvu instalace | `post-install` (výchozí — `shouldRunSynchronously: false`, s opakovanými pokusy workeru) |
+| Spusťte rychlé nastavení, na které bude volající spoléhat ihned po návratu volání instalace | `post-install` s `shouldRunSynchronously: true` |
+| Čtěte nebo zálohujte data, která by nadcházející migrace ztratila | `pre-install` |
+| Odmítněte aktualizaci, která by poškodila existující data | `pre-install` (vyhoďte výjimku z obslužné funkce) |
+| Spouštějte srovnání stavu při každé aktualizaci | `post-install` s `shouldRunOnVersionUpgrade: true` |
+| Proveďte jednorázové nastavení pouze při první instalaci | `post-install` s `shouldRunOnVersionUpgrade: false` (výchozí) |
+
+<Note>
+Pokud si nejste jisti, výchozí volbou je **post-install**. Po pre-install sáhněte pouze tehdy, když je samotná migrace destruktivní a potřebujete zachytit předchozí stav, než zmizí.
+</Note>
+
+</Accordion>
+</AccordionGroup>
diff --git a/packages/twenty-docs/l/cs/developers/extend/apps/config/overview.mdx b/packages/twenty-docs/l/cs/developers/extend/apps/config/overview.mdx
new file mode 100644
index 00000000000..4a6f98f5b1b
--- /dev/null
+++ b/packages/twenty-docs/l/cs/developers/extend/apps/config/overview.mdx
@@ -0,0 +1,51 @@
+---
+title: Přehled
+description: Nakonfigurujte samotnou aplikaci – její identitu, výchozí oprávnění a to, co se spouští při instalaci.
+icon: screwdriver-wrench
+---
+
+**Konfigurační vrstva** aplikace Twenty popisuje aplikaci *platformě* – její identitu, oprávnění, která má, a kód, který se spouští během instalace nebo aktualizace. Tato deklarativní nastavení nepřidávají nové datové struktury ani chování za běhu; říkají Twenty, *co je aplikace zač* a *jak ji nastavit*.
+
+```text
+┌────────────────────────────────────────────────────────┐
+│ Application — identity, default role, variables, │
+│ marketplace metadata │
+│ │
+│ ┌──────────────────────────────────────────────────┐ │
+│ │ Role — what the app's logic functions can read │ │
+│ │ and write (referenced by Application) │ │
+│ └──────────────────────────────────────────────────┘ │
+└────────────────────────────────────────────────────────┘
+ │
+ ▼ (at install / upgrade time)
+ ┌──────────────────────────────────┐
+ │ Pre-install hook │ before metadata migration
+ └──────────────────────────────────┘
+ ┌──────────────────────────────────┐
+ │ Post-install hook │ after metadata migration
+ └──────────────────────────────────┘
+```
+
+## V této části
+
+<CardGroup cols={2}>
+ <Card title="Konfigurace aplikace" icon="rocket" href="/l/cs/developers/extend/apps/config/application">
+ `defineApplication` – identita, výchozí role, proměnné, metadata pro marketplace.
+ </Card>
+ <Card title="Role a oprávnění" icon="shield-halved" href="/l/cs/developers/extend/apps/config/roles">
+ `defineRole` – deklaruje, co mohou logické funkce vaší aplikace číst a zapisovat.
+ </Card>
+ <Card title="Instalační hooky" icon="wrench" href="/l/cs/developers/extend/apps/config/install-hooks">
+ `definePreInstallLogicFunction` a `definePostInstallLogicFunction` – zálohují data, nastavují výchozí hodnoty, validují aktualizace.
+ </Card>
+</CardGroup>
+
+## Jak spolu části souvisejí
+
+* **Aplikace** je vstupní bod. Každá aplikace má právě jedno volání `defineApplication()`, které ukazuje na jednu **roli** jako výchozí.
+* **Role** určuje, co mohou logické funkce aplikace a front-endové komponenty číst a zapisovat. Dodržujte zásadu nejmenších oprávnění: udělujte pouze ta oprávnění, která váš kód skutečně potřebuje.
+* **Instalační hooky** se spouštějí během instalace nebo aktualizace – pre-install před migrací metadat (aby mohly odmítnout rizikovou aktualizaci), post-install po migraci (aby mohly proti novému schématu naplnit výchozí data).
+
+<Note>
+Instalační hooky sdílejí běhové prostředí [logických funkcí](/l/cs/developers/extend/apps/logic/logic-functions) – stejný podpis handleru, stejné proměnné prostředí, stejný typovaný klient API – ale deklarují se pomocí vlastních funkcí define a fungují mimo běžný model spouštěčů (HTTP, cron, databázové události).
+</Note>
diff --git a/packages/twenty-docs/l/cs/developers/extend/apps/config/public-assets.mdx b/packages/twenty-docs/l/cs/developers/extend/apps/config/public-assets.mdx
new file mode 100644
index 00000000000..6d6495c04e9
--- /dev/null
+++ b/packages/twenty-docs/l/cs/developers/extend/apps/config/public-assets.mdx
@@ -0,0 +1,67 @@
+---
+title: Veřejné soubory
+description: Doručujte statické soubory — obrázky, ikony, písma — spolu se svou aplikací prostřednictvím složky public/.
+icon: folder-open
+---
+
+Složka `public/` v kořenu vaší aplikace obsahuje statické soubory — obrázky, ikony, písma a další prostředky, které vaše aplikace potřebuje za běhu. Tyto soubory jsou automaticky zahrnuty do buildů, synchronizovány během vývojového režimu a nahrávány na server.
+
+Soubory umístěné v `public/` jsou:
+
+* **Veřejně přístupné** — po synchronizaci na server jsou prostředky dostupné na veřejné URL. K přístupu k nim není potřeba žádná autentizace.
+* **Dostupné ve frontendových komponentách** — použijte URL prostředků k zobrazení obrázků, ikon či jiných médií uvnitř komponent Reactu.
+* **Dostupné v logických funkcích** — odkazujte na URL prostředků v e-mailech, odpovědích API či jiné serverové logice.
+* **Používány pro metadata Marketplace** — pole `logoUrl` a `screenshots` v `defineApplication()` odkazují na soubory z této složky (např. `public/logo.png`). Zobrazují se v Marketplace, když je vaše aplikace zveřejněna.
+* **Automaticky synchronizované ve vývojovém režimu** — když v `public/` přidáte, aktualizujete nebo smažete soubor, je automaticky synchronizován na server. Není potřeba restartovat.
+* **Zahrnuté do buildů** — `yarn twenty dev:build` zabalí všechny veřejné prostředky do distribučního výstupu.
+
+## Přístup k veřejným prostředkům pomocí `getPublicAssetUrl`
+
+K získání plné URL souboru ve vaší složce `public/` použijte pomocnou funkci `getPublicAssetUrl` z `twenty-sdk`. Funguje jak v logických funkcích, tak ve frontendových komponentách.
+
+**V logické funkci:**
+
+```ts src/logic-functions/send-invoice.ts
+import { defineLogicFunction } from 'twenty-sdk/define';
+import { getPublicAssetUrl } from 'twenty-sdk/utils';
+
+const handler = async (): Promise<any> => {
+ const logoUrl = getPublicAssetUrl('logo.png');
+ const invoiceUrl = getPublicAssetUrl('templates/invoice.png');
+
+ // Fetch the file content (no auth required — public endpoint)
+ const response = await fetch(invoiceUrl);
+ const buffer = await response.arrayBuffer();
+
+ return { logoUrl, size: buffer.byteLength };
+};
+
+export default defineLogicFunction({
+ universalIdentifier: 'a1b2c3d4-...',
+ name: 'send-invoice',
+ description: 'Sends an invoice with the app logo',
+ timeoutSeconds: 10,
+ handler,
+});
+```
+
+**Ve frontendové komponentě:**
+
+```tsx src/front-components/company-card.tsx
+import { defineFrontComponent } from 'twenty-sdk/define';
+import { getPublicAssetUrl } from 'twenty-sdk/utils';
+
+const CompanyCard = () => {
+ const logoUrl = getPublicAssetUrl('logo.png');
+
+ return <img src={logoUrl} alt="App logo" />;
+};
+
+export default defineFrontComponent({
+ universalIdentifier: '...',
+ name: 'company-card',
+ component: CompanyCard,
+});
+```
+
+Argument `path` je relativní ke složce `public/` vaší aplikace. Jak `getPublicAssetUrl('logo.png')`, tak `getPublicAssetUrl('public/logo.png')` se vyhodnotí na stejnou URL — předpona `public/` je, je-li přítomna, automaticky odstraněna.
diff --git a/packages/twenty-docs/l/cs/developers/extend/apps/config/roles.mdx b/packages/twenty-docs/l/cs/developers/extend/apps/config/roles.mdx
new file mode 100644
index 00000000000..4b835413f51
--- /dev/null
+++ b/packages/twenty-docs/l/cs/developers/extend/apps/config/roles.mdx
@@ -0,0 +1,94 @@
+---
+title: Role a oprávnění
+description: Určete, které objekty a pole mohou funkce aplikační logiky a front-endové komponenty vaší aplikace číst a zapisovat.
+icon: shield-halved
+---
+
+**Role** je sada oprávnění: které objekty může aplikace číst nebo zapisovat, která pole může vidět a jaké schopnosti na úrovni platformy může používat. Všechny logické funkce aplikace a front-endové komponenty dědí oprávnění role označené pomocí `defineApplicationRole()` (viz [Výchozí role funkce](#the-default-function-role) níže).
+
+```ts src/roles/restricted-company-role.ts
+import {
+ defineRole,
+ STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS,
+ SystemPermissionFlag,
+} from 'twenty-sdk/define';
+
+export default defineRole({
+ universalIdentifier: '2c80f640-2083-4803-bb49-003e38279de6',
+ label: 'My new role',
+ description: 'A role that can be used in your workspace',
+ canReadAllObjectRecords: false,
+ canUpdateAllObjectRecords: false,
+ canSoftDeleteAllObjectRecords: false,
+ canDestroyAllObjectRecords: false,
+ canUpdateAllSettings: false,
+ canBeAssignedToAgents: false,
+ canBeAssignedToUsers: false,
+ canBeAssignedToApiKeys: false,
+ objectPermissions: [
+ {
+ objectUniversalIdentifier:
+ STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS.company.universalIdentifier,
+ canReadObjectRecords: true,
+ canUpdateObjectRecords: true,
+ canSoftDeleteObjectRecords: false,
+ canDestroyObjectRecords: false,
+ },
+ ],
+ fieldPermissions: [
+ {
+ objectUniversalIdentifier:
+ STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS.company.universalIdentifier,
+ fieldUniversalIdentifier:
+ STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS.company.fields.name
+ .universalIdentifier,
+ canReadFieldValue: false,
+ canUpdateFieldValue: false,
+ },
+ ],
+ permissionFlagUniversalIdentifiers: [SystemPermissionFlag.APPLICATIONS],
+});
+```
+
+## Výchozí role funkce
+
+Když vygenerujete novou aplikaci, CLI vytvoří výchozí soubor role deklarovaný pomocí `defineApplicationRole()`:
+
+```ts src/roles/default-role.ts
+import { defineApplicationRole } from 'twenty-sdk/define';
+
+export const DEFAULT_ROLE_UNIVERSAL_IDENTIFIER =
+ 'b648f87b-1d26-4961-b974-0908fd991061';
+
+export default defineApplicationRole({
+ universalIdentifier: DEFAULT_ROLE_UNIVERSAL_IDENTIFIER,
+ label: 'Default function role',
+ description: 'Default role for function Twenty client',
+ canReadAllObjectRecords: true,
+ canUpdateAllObjectRecords: false,
+ canSoftDeleteAllObjectRecords: false,
+ canDestroyAllObjectRecords: false,
+ canUpdateAllSettings: false,
+ canBeAssignedToAgents: false,
+ canBeAssignedToUsers: false,
+ canBeAssignedToApiKeys: false,
+ objectPermissions: [],
+ fieldPermissions: [],
+ permissionFlagUniversalIdentifiers: [],
+});
+```
+
+`defineApplicationRole()` je tenký wrapper kolem `defineRole()`, který označuje **tu** roli, jež je při instalaci použita jako výchozí role vaší aplikace. Validace je shodná s `defineRole`, ale build pipeline automaticky propojí její `universalIdentifier` s `defaultRoleUniversalIdentifier` v manifestu aplikace — takže na něj nemusíte v [`defineApplication`](/l/cs/developers/extend/apps/config/application) sami odkazovat.
+
+Poznámky:
+
+* Na jednu aplikaci je povolena přesně **jedna** definice `defineApplicationRole(...)` — pokud build manifestu najde více než jednu, sestavení selže.
+* Pro všechny **další** role, které vaše aplikace poskytuje, použijte `defineRole()` (nikoli `defineApplicationRole()`).
+* Explicitní nastavení `defaultRoleUniversalIdentifier` v `defineApplication()` je stále podporováno kvůli zpětné kompatibilitě, ale je označeno jako zastaralé ve prospěch `defineApplicationRole()`.
+
+## Osvědčené postupy
+
+* Začněte od vygenerované role a postupně ji omezujte — výchozí nastavení poskytuje široká oprávnění pro čtení, což je v produkci zřídka žádoucí.
+* Nahraďte `objectPermissions` a `fieldPermissions` přesně těmi objekty a poli, které vaše funkce skutečně potřebují.
+* `permissionFlagUniversalIdentifiers` řídí přístup k schopnostem na úrovni platformy. Udržujte je co nejmenší.
+* Podívejte se na funkční příklad: [`hello-world/src/roles/function-role.ts`](https://github.com/twentyhq/twenty/blob/main/packages/twenty-apps/hello-world/src/roles/function-role.ts).
diff --git a/packages/twenty-docs/l/cs/developers/extend/apps/data/extending-objects.mdx b/packages/twenty-docs/l/cs/developers/extend/apps/data/extending-objects.mdx
new file mode 100644
index 00000000000..805b267ecbe
--- /dev/null
+++ b/packages/twenty-docs/l/cs/developers/extend/apps/data/extending-objects.mdx
@@ -0,0 +1,50 @@
+---
+title: Rozšiřování objektů
+description: Přidávejte pole ke standardním objektům Twenty (Person, Company, …) nebo k objektům z jiných aplikací pomocí `defineField`.
+icon: wand-magic-sparkles
+---
+
+Použijte `defineField()` pro přidání pole k objektu, který nevlastníte — standardnímu objektu Twenty, jako je Person nebo Company, nebo objektu dodanému jinou nainstalovanou aplikací. Na rozdíl od inline polí deklarovaných uvnitř [`defineObject`](/l/cs/developers/extend/apps/data/objects) vyžadují samostatná pole `objectUniversalIdentifier` k určení, který objekt rozšiřují.
+
+```ts src/fields/company-loyalty-tier.field.ts
+import { defineField, FieldType } from 'twenty-sdk/define';
+
+export default defineField({
+ universalIdentifier: 'f2a1b3c4-d5e6-7890-abcd-ef1234567890',
+ objectUniversalIdentifier: '701aecb9-eb1c-4d84-9d94-b954b231b64b', // Company object
+ name: 'loyaltyTier',
+ type: FieldType.SELECT,
+ label: 'Loyalty Tier',
+ icon: 'IconStar',
+ options: [
+ { value: 'BRONZE', label: 'Bronze', position: 0, color: 'orange' },
+ { value: 'SILVER', label: 'Silver', position: 1, color: 'gray' },
+ { value: 'GOLD', label: 'Gold', position: 2, color: 'yellow' },
+ ],
+});
+```
+
+## Hlavní body
+
+* `objectUniversalIdentifier` identifikuje cílový objekt. Pro standardní objekty Twenty importujte konstantu z `twenty-sdk`:
+
+ ```ts
+ import { STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS } from 'twenty-sdk/define';
+
+ // STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS.company.universalIdentifier
+ // STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS.person.universalIdentifier
+ // STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS.opportunity.universalIdentifier
+ // …
+ ```
+
+* Při definování polí **inline uvnitř `defineObject()`** `objectUniversalIdentifier` **nepotřebujete** — dědí se z nadřazeného objektu.
+
+* `defineField()` je jediný způsob, jak přidat pole k objektům, které jste nevytvořili pomocí `defineObject()`.
+
+* Umístění souboru je na vás. Konvence je `src/fields/\<name>.field.ts`, ale SDK rozpozná pole kdekoli v `src/`.
+
+* Chcete-li přidat kartu ke standardnímu rozvržení stránky (např. na detailní stránku Task nebo Company), použijte [`definePageLayoutTab`](/l/cs/developers/extend/apps/layout/page-layouts#definepagelayouttab) s `STANDARD_PAGE_LAYOUT_UNIVERSAL_IDENTIFIERS` z `twenty-sdk/define`.
+
+## Přidání relace k existujícímu objektu
+
+Chcete-li přidat relační pole (např. pro propojení vlastního objektu se standardním `Person`), použijte `defineField()` s `FieldType.RELATION`. Vzor je stejný jako u inline relací, ale s `objectUniversalIdentifier` nastaveným explicitně. Obousměrný vzor najdete v části [Relations](/l/cs/developers/extend/apps/data/relations).
diff --git a/packages/twenty-docs/l/cs/developers/extend/apps/data/objects.mdx b/packages/twenty-docs/l/cs/developers/extend/apps/data/objects.mdx
new file mode 100644
index 00000000000..498b9764f4d
--- /dev/null
+++ b/packages/twenty-docs/l/cs/developers/extend/apps/data/objects.mdx
@@ -0,0 +1,104 @@
+---
+title: Objekty
+description: Deklarujte nové typy záznamů – vlastní tabulky s jejich vlastními poli – pomocí defineObject.
+icon: tabulka
+---
+
+Vlastní **objekty** jsou nové typy záznamů, které vaše aplikace přidává do pracovního prostoru — pohlednice, faktura, předplatné, cokoli specifického pro vaši doménu. Každý objekt definuje své schéma (pole, vztahy, výchozí hodnoty) a stabilní univerzální identifikátor, který přetrvá mezi synchronizacemi a nasazeními.
+
+```ts src/objects/post-card.object.ts
+import { defineObject, FieldType } from 'twenty-sdk/define';
+
+enum PostCardStatus {
+ DRAFT = 'DRAFT',
+ SENT = 'SENT',
+ DELIVERED = 'DELIVERED',
+ RETURNED = 'RETURNED',
+}
+
+export default defineObject({
+ universalIdentifier: '54b589ca-eeed-4950-a176-358418b85c05',
+ nameSingular: 'postCard',
+ namePlural: 'postCards',
+ labelSingular: 'Post Card',
+ labelPlural: 'Post Cards',
+ description: 'A post card object',
+ icon: 'IconMail',
+ fields: [
+ {
+ universalIdentifier: '58a0a314-d7ea-4865-9850-7fb84e72f30b',
+ name: 'content',
+ type: FieldType.TEXT,
+ label: 'Content',
+ description: "Postcard's content",
+ icon: 'IconAbc',
+ },
+ {
+ universalIdentifier: 'c6aa31f3-da76-4ac6-889f-475e226009ac',
+ name: 'recipientName',
+ type: FieldType.FULL_NAME,
+ label: 'Recipient name',
+ icon: 'IconUser',
+ },
+ {
+ universalIdentifier: '95045777-a0ad-49ec-98f9-22f9fc0c8266',
+ name: 'recipientAddress',
+ type: FieldType.ADDRESS,
+ label: 'Recipient address',
+ icon: 'IconHome',
+ },
+ {
+ universalIdentifier: '87b675b8-dd8c-4448-b4ca-20e5a2234a1e',
+ name: 'status',
+ type: FieldType.SELECT,
+ label: 'Status',
+ icon: 'IconSend',
+ defaultValue: `'${PostCardStatus.DRAFT}'`,
+ options: [
+ { value: PostCardStatus.DRAFT, label: 'Draft', position: 0, color: 'gray' },
+ { value: PostCardStatus.SENT, label: 'Sent', position: 1, color: 'orange' },
+ { value: PostCardStatus.DELIVERED, label: 'Delivered', position: 2, color: 'green' },
+ { value: PostCardStatus.RETURNED, label: 'Returned', position: 3, color: 'orange' },
+ ],
+ },
+ {
+ universalIdentifier: 'e06abe72-5b44-4e7f-93be-afc185a3c433',
+ name: 'deliveredAt',
+ type: FieldType.DATE_TIME,
+ label: 'Delivered at',
+ icon: 'IconCheck',
+ isNullable: true,
+ defaultValue: null,
+ },
+ ],
+});
+```
+
+## Hlavní body
+
+* Hodnota `universalIdentifier` musí být jedinečná a stabilní napříč nasazeními.
+* Každé pole vyžaduje `name`, `type`, `label` a svůj vlastní stabilní `universalIdentifier`.
+* Pole `fields` je volitelné — objekty můžete definovat i bez vlastních polí.
+* Pole definovaná zde inline **nepotřebují** `objectUniversalIdentifier` — dědí se z nadřazeného objektu. Pomocí [`defineField()`](/l/cs/developers/extend/apps/data/extending-objects) můžete přidávat pole k objektům, které nevlastníte.
+* Nové objekty můžete vygenerovat pomocí `yarn twenty dev:add object`, který vás provede pojmenováním, poli a vztahy. Viz [Architektura → Scaffolding entit](/l/cs/developers/extend/apps/getting-started/scaffolding).
+
+<Note>
+**Základní pole jsou přidána automaticky.** Když definujete vlastní objekt, Twenty pro vás vytvoří standardní pole jako `id`, `name`, `createdAt`, `updatedAt`, `createdBy`, `updatedBy` a `deletedAt`. Nemusíte je uvádět v poli `fields` — pouze svá vlastní pole. Výchozí pole můžete přepsat tak, že deklarujete pole se stejným názvem, ale jen zřídka je to dobrý nápad.
+</Note>
+
+## Výchozí hodnoty
+
+Výchozí textové hodnoty musí být uzavřené v jednoduchých uvozovkách **uvnitř** řetězce — `defaultValue: "'Draft'"`, ne `defaultValue: "Draft"`. Proto pole `status` výše používá `` `'${PostCardStatus.DRAFT}'` ``.
+
+Neuzavřené (necitované) řetězce jsou vyhrazené pro vypočítané výchozí hodnoty, které se vyhodnocují při vytvoření záznamu:
+
+* `'uuid'` — generuje UUID (pro pole `UUID`)
+* `'now'` — aktuální časové razítko (pro pole `DATE_TIME`)
+
+Stejná konvence platí pro řetězcová podpola složených výchozích hodnot (např. `{ source: "'MANUAL'" }` u pole `ACTOR`) a pro hodnoty `SELECT`/`MULTI_SELECT`. Doslovná řetězcová výchozí hodnota ponechaná bez uvozovek vyvolá při sestavení aplikace varování.
+
+## Co dál
+
+* **Propojte tento objekt s ostatními** — vzor obousměrných vztahů najdete v části [Relations](/l/cs/developers/extend/apps/data/relations).
+* **Přidávejte pole k objektům z jiných aplikací** — viz [Extending Objects](/l/cs/developers/extend/apps/data/extending-objects) pro `defineField()`.
+* **Zobrazte tento objekt v uživatelském rozhraní** — viz [Views](/l/cs/developers/extend/apps/layout/views) a [Navigation Menu Items](/l/cs/developers/extend/apps/layout/navigation-menu-items) pro umístění do postranního panelu.
diff --git a/packages/twenty-docs/l/cs/developers/extend/apps/data/overview.mdx b/packages/twenty-docs/l/cs/developers/extend/apps/data/overview.mdx
new file mode 100644
index 00000000000..dc8e6a544d9
--- /dev/null
+++ b/packages/twenty-docs/l/cs/developers/extend/apps/data/overview.mdx
@@ -0,0 +1,97 @@
+---
+title: Přehled
+description: Formujte data, která vaše aplikace přidává do pracovního prostoru — objekty, pole a vztahy.
+icon: database
+---
+
+**Datová vrstva** aplikace Twenty představuje data, která vaše aplikace *přidává* do pracovního prostoru — nové typy záznamů, které deklaruje, sloupce, které přidává k existujícím objektům a způsob, jakým se tyto záznamy vzájemně propojují.
+
+```text
+┌──────────────────────────────────────────────────┐
+│ Object — a record type, e.g. PostCard │
+│ ├─ Field (name, type, label) │
+│ ├─ Field │
+│ └─ Relation (link to another object) │
+└──────────────────────────────────────────────────┘
+ │
+ ├── lives in your app, OR
+ │
+ ▼
+┌──────────────────────────────────────────────────┐
+│ Standard / other apps' objects │
+│ └─ Field added by your app via defineField │
+└──────────────────────────────────────────────────┘
+```
+
+## V této části
+
+<CardGroup cols={2}>
+ <Card title="Objekty" icon="tabulka" href="/l/cs/developers/extend/apps/data/objects">
+ `defineObject` — deklarujte nové typy záznamů s jejich vlastními poli.
+ </Card>
+ <Card title="Rozšiřování objektů" icon="wand-magic-sparkles" href="/l/cs/developers/extend/apps/data/extending-objects">
+ `defineField` — přidejte pole ke standardním objektům nebo objektům jiných aplikací.
+ </Card>
+ <Card title="Vztahy" icon="diagram-project" href="/l/cs/developers/extend/apps/data/relations">
+ Obousměrná `MANY_TO_ONE` / `ONE_TO_MANY` propojení mezi objekty.
+ </Card>
+</CardGroup>
+
+## Entity v kostce
+
+| Entita | Účel | Definováno pomocí |
+| ---------- | ---------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------- |
+| **Objekt** | Nový vlastní typ záznamu (např. PostCard, Invoice) s vlastními poli | `defineObject()` |
+| **Pole** | Sloupec v objektu. Samostatná pole mohou rozšiřovat objekty, které jste nevytvořili (např. přidat `loyaltyTier` k objektu Company) | `defineField()` |
+| **Vztah** | Obousměrné propojení mezi dvěma objekty — obě strany deklarované jako pole | `defineField()` s `FieldType.RELATION` |
+| **Index** | Databázový index pro zrychlení opakovaného dotazu na jeden z vašich objektů | `defineIndex()` |
+
+SDK je detekuje pomocí analýzy AST v době buildu, takže organizace souborů je na vás — zažitou konvencí je `src/objects/`, `src/fields/` a `src/indexes/`. Stabilní UUID `universalIdentifier` vše propojují napříč nasazeními.
+
+## Indexy (volitelné)
+
+Aplikace mohou dodávat indexy společně se svými objekty, aby udržely opakované dotazy rychlými. Nejčastějším případem je sloupec se stavem nebo cizím klíčem, který často čtete.
+
+```ts src/indexes/post-card-status.index.ts
+import { defineIndex } from 'twenty-sdk/define';
+
+import {
+ POST_CARD_UNIVERSAL_IDENTIFIER,
+ STATUS_FIELD_UNIVERSAL_IDENTIFIER,
+} from '../objects/post-card.object';
+
+export default defineIndex({
+ universalIdentifier: 'b6e9d2a1-5a4c-46ca-9d52-42c8f02d1ff0',
+ objectUniversalIdentifier: POST_CARD_UNIVERSAL_IDENTIFIER,
+ fields: [
+ {
+ universalIdentifier: 'b6e9d2a1-5a4c-46ca-9d52-42c8f02d1ff1',
+ fieldUniversalIdentifier: STATUS_FIELD_UNIVERSAL_IDENTIFIER,
+ },
+ ],
+});
+```
+
+### Jedinečné indexy
+
+`defineIndex` přijímá `isUnique: true` jak pro jedinečnost jednoho sloupce, tak vícesloupcovou jedinečnost. Toto je doporučené primitivum — `defineField({ isUnique: true })` je zastaralé a bude odstraněno v některém z příštích vydání.
+
+```ts
+defineIndex({
+ universalIdentifier: '…',
+ objectUniversalIdentifier: PERSON_UNIVERSAL_IDENTIFIER,
+ isUnique: true,
+ fields: [{ universalIdentifier: '…', fieldUniversalIdentifier: EMAIL_FIELD_UNIVERSAL_IDENTIFIER }],
+});
+```
+
+### Další omezení
+
+* Částečné klauzule `WHERE` zůstávají pod kontrolou administrátora — aplikace je nemohou deklarovat.
+* Každý objekt je omezen na 10 vlastních indexů (indexy samotného frameworku se nepočítají).
+
+Seřaďte pole `fields` tak, jak je má Postgres používat — nejlevější sloupec jako první, jako v telefonním seznamu. Indexy nejsou zadarmo: každý zápis do tabulky je aktualizuje. Přidávejte je jen tehdy, když máte dotaz, který je potřebuje.
+
+<Note>
+Hledáte **Application Config** nebo **Roles & Permissions**? Ty popisují samotnou aplikaci, nikoli data, která přidává — najdete je pod [Config](/l/cs/developers/extend/apps/config/overview). Hledáte **Connections** (Linear, GitHub, Slack OAuth)? Ty existují proto, aby byly volány *z* logických funkcí, a najdete je pod [Logic](/l/cs/developers/extend/apps/logic/connections).
+</Note>
diff --git a/packages/twenty-docs/l/cs/developers/extend/apps/data/relations.mdx b/packages/twenty-docs/l/cs/developers/extend/apps/data/relations.mdx
new file mode 100644
index 00000000000..1b90a19971e
--- /dev/null
+++ b/packages/twenty-docs/l/cs/developers/extend/apps/data/relations.mdx
@@ -0,0 +1,160 @@
+---
+title: Vztahy
+description: Propojte objekty obousměrnými relacemi MANY_TO_ONE / ONE_TO_MANY.
+icon: diagram-project
+---
+
+Relace propojují dva objekty. Ve Twenty jsou relace vždy **obousměrné** — každá relace má dvě strany a každá strana je deklarována jako pole, které odkazuje na tu druhou.
+
+| Typ vztahu | Popis | Má cizí klíč? |
+| ------------- | --------------------------------------------------------------------- | ---------------------- |
+| `MANY_TO_ONE` | Mnoho záznamů tohoto objektu ukazuje na jeden záznam cílového objektu | Ano (`joinColumnName`) |
+| `ONE_TO_MANY` | Jeden záznam tohoto objektu má mnoho záznamů cílového objektu | Ne (inverzní strana) |
+
+## Jak fungují relace
+
+Každá relace vyžaduje dvě pole, která na sebe vzájemně odkazují:
+
+1. Strana MANY_TO_ONE — je na objektu, který drží cizí klíč.
+2. Strana ONE_TO_MANY — je na objektu, který vlastní kolekci.
+
+Obě pole používají `FieldType.RELATION` a vzájemně se odkazují prostřednictvím `relationTargetFieldMetadataUniversalIdentifier`.
+
+## Příklad: Pohlednice má mnoho příjemců
+
+`PostCard` lze odeslat mnoha záznamům `PostCardRecipient`. Každý příjemce náleží přesně jedné pohlednici.
+
+**Krok 1: Definujte stranu ONE_TO_MANY na PostCard** (strana "one"):
+
+```ts src/fields/post-card-recipients-on-post-card.field.ts
+import { defineField, FieldType, RelationType } from 'twenty-sdk/define';
+import { POST_CARD_UNIVERSAL_IDENTIFIER } from '../objects/post-card.object';
+import { POST_CARD_RECIPIENT_UNIVERSAL_IDENTIFIER } from '../objects/post-card-recipient.object';
+
+// Export so the other side can reference it
+export const POST_CARD_RECIPIENTS_FIELD_ID = 'a1111111-1111-1111-1111-111111111111';
+// Import from the other side
+import { POST_CARD_FIELD_ID } from './post-card-on-post-card-recipient.field';
+
+export default defineField({
+ universalIdentifier: POST_CARD_RECIPIENTS_FIELD_ID,
+ objectUniversalIdentifier: POST_CARD_UNIVERSAL_IDENTIFIER,
+ type: FieldType.RELATION,
+ name: 'postCardRecipients',
+ label: 'Post Card Recipients',
+ icon: 'IconUsers',
+ relationTargetObjectMetadataUniversalIdentifier: POST_CARD_RECIPIENT_UNIVERSAL_IDENTIFIER,
+ relationTargetFieldMetadataUniversalIdentifier: POST_CARD_FIELD_ID,
+ universalSettings: {
+ relationType: RelationType.ONE_TO_MANY,
+ },
+});
+```
+
+**Krok 2: Definujte stranu MANY_TO_ONE na PostCardRecipient** (strana "many" — drží cizí klíč):
+
+```ts src/fields/post-card-on-post-card-recipient.field.ts
+import { defineField, FieldType, RelationType, OnDeleteAction } from 'twenty-sdk/define';
+import { POST_CARD_UNIVERSAL_IDENTIFIER } from '../objects/post-card.object';
+import { POST_CARD_RECIPIENT_UNIVERSAL_IDENTIFIER } from '../objects/post-card-recipient.object';
+
+// Export so the other side can reference it
+export const POST_CARD_FIELD_ID = 'b2222222-2222-2222-2222-222222222222';
+// Import from the other side
+import { POST_CARD_RECIPIENTS_FIELD_ID } from './post-card-recipients-on-post-card.field';
+
+export default defineField({
+ universalIdentifier: POST_CARD_FIELD_ID,
+ objectUniversalIdentifier: POST_CARD_RECIPIENT_UNIVERSAL_IDENTIFIER,
+ type: FieldType.RELATION,
+ name: 'postCard',
+ label: 'Post Card',
+ icon: 'IconMail',
+ relationTargetObjectMetadataUniversalIdentifier: POST_CARD_UNIVERSAL_IDENTIFIER,
+ relationTargetFieldMetadataUniversalIdentifier: POST_CARD_RECIPIENTS_FIELD_ID,
+ universalSettings: {
+ relationType: RelationType.MANY_TO_ONE,
+ onDelete: OnDeleteAction.CASCADE,
+ joinColumnName: 'postCardId',
+ },
+});
+```
+
+<Note>
+**Cyklické importy:** obě relační pole odkazují na `universalIdentifier` toho druhého. Abyste předešli problémům s cyklickými importy, exportujte ID polí jako pojmenované konstanty z každého souboru a v druhém je importujte. Build systém je vyřeší v době kompilace.
+</Note>
+
+## Vazby na standardní objekty
+
+Chcete-li vytvořit relaci s vestavěným objektem Twenty (Person, Company atd.), použijte `STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS`:
+
+```ts src/fields/person-on-self-hosting-user.field.ts
+import {
+ defineField,
+ FieldType,
+ RelationType,
+ OnDeleteAction,
+ STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS,
+} from 'twenty-sdk/define';
+import { SELF_HOSTING_USER_UNIVERSAL_IDENTIFIER } from '../objects/self-hosting-user.object';
+
+export const PERSON_FIELD_ID = 'c3333333-3333-3333-3333-333333333333';
+export const SELF_HOSTING_USER_REVERSE_FIELD_ID = 'd4444444-4444-4444-4444-444444444444';
+
+export default defineField({
+ universalIdentifier: PERSON_FIELD_ID,
+ objectUniversalIdentifier: SELF_HOSTING_USER_UNIVERSAL_IDENTIFIER,
+ type: FieldType.RELATION,
+ name: 'person',
+ label: 'Person',
+ description: 'Person matching with the self hosting user',
+ isNullable: true,
+ relationTargetObjectMetadataUniversalIdentifier:
+ STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS.person.universalIdentifier,
+ relationTargetFieldMetadataUniversalIdentifier: SELF_HOSTING_USER_REVERSE_FIELD_ID,
+ universalSettings: {
+ relationType: RelationType.MANY_TO_ONE,
+ onDelete: OnDeleteAction.SET_NULL,
+ joinColumnName: 'personId',
+ },
+});
+```
+
+## Vlastnosti relačních polí
+
+| Vlastnost | Povinné | Popis |
+| ------------------------------------------------- | ----------------- | ------------------------------------------------------------------------------------------------- |
+| `type` | Ano | Musí být `FieldType.RELATION` |
+| `relationTargetObjectMetadataUniversalIdentifier` | Ano | `universalIdentifier` cílového objektu |
+| `relationTargetFieldMetadataUniversalIdentifier` | Ano | `universalIdentifier` odpovídajícího pole na cílovém objektu |
+| `universalSettings.relationType` | Ano | `RelationType.MANY_TO_ONE` nebo `RelationType.ONE_TO_MANY` |
+| `universalSettings.onDelete` | Pouze MANY_TO_ONE | Co se stane, když je smazán odkazovaný záznam: `CASCADE`, `SET_NULL`, `RESTRICT` nebo `NO_ACTION` |
+| `universalSettings.joinColumnName` | Pouze MANY_TO_ONE | Název databázového sloupce pro cizí klíč (např. `postCardId`) |
+
+## Vložená relační pole
+
+Relaci můžete také deklarovat přímo uvnitř [`defineObject`](/l/cs/developers/extend/apps/data/objects). Pokud je pole vložené, vynechejte `objectUniversalIdentifier` — dědí se z nadřazeného objektu:
+
+```ts
+export default defineObject({
+ universalIdentifier: '...',
+ nameSingular: 'postCardRecipient',
+ // ...
+ fields: [
+ {
+ universalIdentifier: POST_CARD_FIELD_ID,
+ type: FieldType.RELATION,
+ name: 'postCard',
+ label: 'Post Card',
+ relationTargetObjectMetadataUniversalIdentifier: POST_CARD_UNIVERSAL_IDENTIFIER,
+ relationTargetFieldMetadataUniversalIdentifier: POST_CARD_RECIPIENTS_FIELD_ID,
+ universalSettings: {
+ relationType: RelationType.MANY_TO_ONE,
+ onDelete: OnDeleteAction.CASCADE,
+ joinColumnName: 'postCardId',
+ },
+ },
+ // … other fields
+ ],
+});
+```
diff --git a/packages/twenty-docs/l/cs/developers/extend/apps/getting-started/concepts.mdx b/packages/twenty-docs/l/cs/developers/extend/apps/getting-started/concepts.mdx
new file mode 100644
index 00000000000..cf0f5808e1c
--- /dev/null
+++ b/packages/twenty-docs/l/cs/developers/extend/apps/getting-started/concepts.mdx
@@ -0,0 +1,101 @@
+---
+title: Pojmy
+description: Jak aplikace Twenty fungují — model entit, sandboxing a životní cyklus instalace.
+icon: sitemap
+---
+
+Aplikace Twenty jsou balíčky TypeScriptu, které rozšiřují váš pracovní prostor o vlastní objekty, logiku, komponenty UI a funkce AI. Běží na platformě Twenty s plnou izolací (sandboxingem) a řízením oprávnění.
+
+## Jak aplikace fungují
+
+Aplikace je kolekce **entit** deklarovaných pomocí funkcí `defineEntity()` z balíčku `twenty-sdk`. SDK tyto deklarace detekuje pomocí analýzy AST při sestavení a vytváří **manifest** — úplný popis toho, co vaše aplikace přidává do pracovního prostoru. Tyto funkce validují vaši konfiguraci v době sestavení a poskytují automatické doplňování v IDE a typovou bezpečnost.
+
+```
+your-app/
+├── src/
+│ ├── application-config.ts ← defineApplication (required, one per app)
+│ ├── roles/ ← defineRole
+│ ├── objects/ ← defineObject
+│ ├── fields/ ← defineField
+│ ├── logic-functions/ ← defineLogicFunction
+│ ├── front-components/ ← defineFrontComponent
+│ ├── skills/ ← defineSkill
+│ ├── agents/ ← defineAgent
+│ ├── views/ ← defineView
+│ ├── navigation-menu-items/ ← defineNavigationMenuItem
+│ └── page-layouts/ ← definePageLayout
+├── public/ ← Static assets (images, icons)
+└── package.json
+```
+
+<Note>
+ **Uspořádání souborů je na vás.** Detekce entit je založená na AST — SDK najde volání `export default defineEntity(...)` bez ohledu na to, kde se soubor nachází. Výše uvedená struktura složek je konvence, nikoli požadavek.
+</Note>
+
+## Typy entit
+
+| Entita | Účel | Dokumentace |
+| ----------------------------- | --------------------------------------------------------------- | ----------------------------------------------------------------------------- |
+| **Aplikace** | Identita aplikace, výchozí role, proměnné | [Application Config](/l/cs/developers/extend/apps/config/application) |
+| **Role** | Sady oprávnění pro objekty a pole | [Roles & Permissions](/l/cs/developers/extend/apps/config/roles) |
+| **Objekt** | Vlastní typy záznamů s poli | [Objects](/l/cs/developers/extend/apps/data/objects) |
+| **Pole** | Přidání polí k objektům z jiných aplikací | [Extending Objects](/l/cs/developers/extend/apps/data/extending-objects) |
+| **Vztah** | Obousměrná propojení mezi objekty | [Relations](/l/cs/developers/extend/apps/data/relations) |
+| **Logická funkce** | TypeScript na straně serveru se spouštěči | [Logické funkce](/l/cs/developers/extend/apps/logic/logic-functions) |
+| **Dovednost** | Znovupoužitelné pokyny pro AI agenty | [Dovednosti a agenti](/l/cs/developers/extend/apps/logic/skills-and-agents) |
+| **Agent** | AI asistenti s vlastními prompty | [Dovednosti a agenti](/l/cs/developers/extend/apps/logic/skills-and-agents) |
+| **Poskytovatel připojení** | Přihlašovací údaje OAuth pro externí rozhraní API třetích stran | [Connections](/l/cs/developers/extend/apps/logic/connections) |
+| **Zobrazení** | Předkonfigurovaná zobrazení seznamu záznamů | [Views](/l/cs/developers/extend/apps/layout/views) |
+| **Položka navigační nabídky** | Vlastní položky postranního panelu | [Navigation Menu Items](/l/cs/developers/extend/apps/layout/navigation-menu-items) |
+| **Rozvržení stránky** | Karty a widgety na stránce s podrobnostmi záznamu | [Page Layouts](/l/cs/developers/extend/apps/layout/page-layouts) |
+| **Frontendová komponenta** | Izolované React UI uvnitř Twenty | [Frontendové komponenty](/l/cs/developers/extend/apps/layout/front-components) |
+| **Položka příkazové nabídky** | Rychlé akce a položky Cmd+K | [Command Menu Items](/l/cs/developers/extend/apps/layout/command-menu-items) |
+
+## Izolace (sandboxing)
+
+* **Logické funkce** běží v izolovaných procesech Node.js na serveru. K datům přistupují pouze prostřednictvím typovaného klienta API, a to v rozsahu oprávnění 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). Komunikují s Twenty prostřednictvím hostitelského API pro předávání zpráv.
+* **Oprávnění** jsou vynucována na úrovni API. Běhový token (`TWENTY_APP_ACCESS_TOKEN`) je odvozen z role definované v `defineApplication()`.
+
+## Životní cyklus aplikace
+
+```
+┌─────────────────────────────────────────────────────────┐
+│ Development │
+│ npx create-twenty-app → yarn twenty dev (live sync) │
+├─────────────────────────────────────────────────────────┤
+│ Build & Deploy │
+│ yarn twenty dev:build → yarn twenty app:publish │
+├─────────────────────────────────────────────────────────┤
+│ Install flow │
+│ upload → [pre-install] → metadata migration → │
+│ generate SDK → [post-install] │
+├─────────────────────────────────────────────────────────┤
+│ Publish │
+│ npm publish → appears in Twenty marketplace │
+└─────────────────────────────────────────────────────────┘
+```
+
+* **`yarn twenty dev`** — sleduje vaše zdrojové soubory a průběžně synchronizuje změny s připojeným serverem Twenty. Typovaný klient API se při změně schématu automaticky znovu vygeneruje.
+* **`yarn twenty dev:build`** — zkompiluje TypeScript, zabalí logické funkce a frontendové komponenty pomocí esbuild a vytvoří manifest.
+* **Pre/post-install hooks** — volitelné funkce, které běží během instalace. Podrobnosti viz [Install Hooks](/l/cs/developers/extend/apps/config/install-hooks).
+
+## Další kroky
+
+<CardGroup cols={2}>
+ <Card title="Konfigurace" icon="screwdriver-wrench" href="/l/cs/developers/extend/apps/config/overview">
+ Identita aplikace, výchozí role a instalační hooky.
+ </Card>
+ <Card title="Data" icon="database" href="/l/cs/developers/extend/apps/data/overview">
+ Objekty, pole a obousměrné relace.
+ </Card>
+ <Card title="Logika" icon="bolt" href="/l/cs/developers/extend/apps/logic/overview">
+ Logické funkce, dovednosti, agenti a připojení přes OAuth.
+ </Card>
+ <Card title="Rozvržení" icon="table-columns" href="/l/cs/developers/extend/apps/layout/overview">
+ Zobrazení, navigace, rozvržení stránek, frontendové komponenty.
+ </Card>
+ <Card title="Operace" icon="rocket" href="/l/cs/developers/extend/apps/operations/overview">
+ CLI, testování, vzdálené repozitáře, CI a publikování vaší aplikace.
+ </Card>
+</CardGroup>
diff --git a/packages/twenty-docs/l/cs/developers/extend/apps/getting-started/local-server.mdx b/packages/twenty-docs/l/cs/developers/extend/apps/getting-started/local-server.mdx
new file mode 100644
index 00000000000..765f1bb379d
--- /dev/null
+++ b/packages/twenty-docs/l/cs/developers/extend/apps/getting-started/local-server.mdx
@@ -0,0 +1,87 @@
+---
+title: Lokální server
+description: Spravujte lokální Docker server Twenty – spouštění, zastavení, upgrade, paralelní testovací instance a ruční nastavení SDK.
+icon: server
+---
+
+## Správa lokálního serveru
+
+K ovládání lokálního kontejneru Twenty použijte `yarn twenty docker:*`:
+
+| Příkaz | K čemu slouží |
+| -------------------------------------- | ---------------------------------------------- |
+| `yarn twenty docker:start` | Spustí server (v případě potřeby stáhne image) |
+| `yarn twenty docker:start 2.2.0` | Spustit konkrétní verzi serveru |
+| `yarn twenty docker:start --port 3030` | Spustí na vlastním portu |
+| `yarn twenty docker:stop` | Zastaví server (zachová data) |
+| `yarn twenty docker:status` | Zobrazí URL, verzi a přihlašovací údaje |
+| `yarn twenty docker:logs` | Streamuje protokoly serveru |
+| `yarn twenty docker:reset` | Vymaže data a začne znovu |
+| `yarn twenty docker:upgrade` | Stáhne nejnovější image `twenty-app-dev` |
+| `yarn twenty docker:upgrade 2.2.0` | Aktualizuje na konkrétní verzi |
+
+Data přetrvávají při restartech ve dvou svazcích Dockeru (`twenty-app-dev-data` pro PostgreSQL, `twenty-app-dev-storage` pro soubory). Pomocí `reset` vymažte vše.
+
+## Fixace verze serveru
+
+Když není předána žádná verze, `docker:start` určí verzi z rozsahu `engines.twenty` vaší aplikace v `package.json` — stejného rozsahu, vůči kterému server ověřuje, když je vaše aplikace nainstalována. Spustí nejnovější publikovaný image `twenty-app-dev`, který splňuje tento rozsah, a pokud pole chybí nebo žádná publikovaná verze neodpovídá, použije `latest`:
+
+```json filename="package.json"
+{
+ "engines": {
+ "twenty": ">=2.2.0"
+ }
+}
+```
+
+Předáním verze můžete rozsah pro jedno spuštění přepsat: `yarn twenty docker:start 2.3.0`. Pokud už kontejner existuje v jiné verzi, `docker:start` jej na místě aktualizuje (znovu vytvoří kontejner při zachování vašich datových svazků).
+
+## Aktualizace obrazu serveru
+
+`yarn twenty docker:upgrade` stáhne nejnovější image, porovná digesty a znovu vytvoří kontejner pouze v případě, že se skutečně něco změnilo. Svazky zůstanou zachovány — nahradí se pouze kontejner. Pokud byl stažen nový image a kontejner běžel, upgrade automaticky spustí nový kontejner; poté spusťte `yarn twenty docker:start`, abyste počkali, než bude ve stavu 'healthy'.
+
+```bash filename="Terminal"
+yarn twenty docker:upgrade # Latest
+yarn twenty docker:upgrade 2.2.0 # Specific version
+```
+
+Běžící verzi ověříte pomocí `yarn twenty docker:status` (zobrazí `APP_VERSION` zabudovanou v kontejneru).
+
+## Spuštění paralelní testovací instance
+
+Předejte `--test` libovolnému příkazu `docker:*` pro správu druhé, plně izolované instance — užitečné pro integrační testy nebo experimentování bez zásahu do vašich hlavních vývojových dat:
+
+| Příkaz | K čemu slouží |
+| ----------------------------------- | ------------------------------------------------ |
+| `yarn twenty docker:start --test` | Spustí testovací instanci (výchozí port je 2021) |
+| `yarn twenty docker:stop --test` | Zastaví ji |
+| `yarn twenty docker:status --test` | Zobrazí její stav |
+| `yarn twenty docker:logs --test` | Streamuje její protokoly |
+| `yarn twenty docker:reset --test` | Vymaže její data |
+| `yarn twenty docker:upgrade --test` | Aktualizuje její image |
+
+Testovací instance má vlastní kontejner (`twenty-app-dev-test`), svazky (`twenty-app-dev-test-data`, `twenty-app-dev-test-storage`) a konfiguraci — běží souběžně s vaší hlavní instancí bez konfliktů. Zkombinujte `--test` s `--port` pro změnu výchozího portu 2021.
+
+## Ruční nastavení (bez generátoru kostry)
+
+Pokud přidáváte SDK do existujícího projektu, generátor kostry přeskočte:
+
+```bash filename="Terminal"
+yarn add twenty-sdk twenty-client-sdk
+```
+
+Přidejte skript do `package.json`:
+
+```json filename="package.json"
+{
+ "scripts": {
+ "twenty": "twenty"
+ }
+}
+```
+
+Nyní můžete spouštět `yarn twenty dev`, `yarn twenty docker:start` a další.
+
+<Note>
+Neinstalujte `twenty-sdk` globálně — nainstalujte jej v každém projektu zvlášť, aby každá aplikace používala svou vlastní verzi.
+</Note>
diff --git a/packages/twenty-docs/l/cs/developers/extend/apps/getting-started/project-structure.mdx b/packages/twenty-docs/l/cs/developers/extend/apps/getting-started/project-structure.mdx
new file mode 100644
index 00000000000..6568a7fc963
--- /dev/null
+++ b/packages/twenty-docs/l/cs/developers/extend/apps/getting-started/project-structure.mdx
@@ -0,0 +1,61 @@
+---
+title: Struktura projektu
+description: Co obsahuje vygenerovaná aplikace Twenty — soubory, složky a k čemu každý z nich slouží.
+icon: folder-tree
+---
+
+Nová aplikace vygenerovaná pomocí `npx create-twenty-app` vypadá takto:
+
+```text filename="my-twenty-app/"
+my-twenty-app/
+ package.json
+ src/
+ application-config.ts # Required — your app's entry point
+ default-role.ts # Permissions for logic functions
+ constants/
+ universal-identifiers.ts # Auto-generated UUIDs and metadata
+ __tests__/
+ setup-test.ts
+ app-install.integration-test.ts
+ .github/workflows/ci.yml # GitHub Actions
+ public/ # Static assets
+ vitest.config.ts # Test runner config
+ tsconfig.json, tsconfig.spec.json
+ .nvmrc, .yarnrc.yml, .oxlintrc.json
+ README.md, LLMS.md
+```
+
+## Klíčové soubory
+
+| Soubor / Složka | Účel |
+| ---------------------------------------- | ----------------------------------------------------------------------- |
+| `src/application-config.ts` | **Povinné.** Hlavní konfigurační soubor vaší aplikace. |
+| `src/default-role.ts` | Výchozí role, která řídí, k čemu mohou vaše logické funkce přistupovat. |
+| `src/constants/universal-identifiers.ts` | Automaticky generovaná UUID a metadata (zobrazovaný název, popis). |
+| `src/__tests__/` | Integrační testy (nastavení + ukázkový test). |
+| `public/` | Statické soubory (obrázky, písma) doručované vaší aplikací. |
+
+<Note>
+**Uspořádání souborů je na vás.** Výše uvedené složky jsou konvence — SDK detekuje entity pomocí analýzy AST u volání `export default defineEntity(...)` bez ohledu na to, kde se soubor nachází.
+</Note>
+
+## Závislosti
+
+Oba balíčky Twenty SDK patří pod `devDependencies`, ne pod `dependencies`:
+
+```json filename="package.json"
+{
+ "dependencies": {},
+ "devDependencies": {
+ "twenty-client-sdk": "^2.13.0",
+ "twenty-sdk": "^2.13.0"
+ }
+}
+```
+
+* **`twenty-sdk`** dodává `twenty` CLI a nástroje pro sestavení/scaffolding. Běží pouze při vývoji a sestavování a nikdy není importován za běhu zveřejněné aplikace.
+* **`twenty-client-sdk`** je importován kódem vaší aplikace (`CoreApiClient`, `MetadataApiClient`, `RestApiClient`), ale Twenty ho poskytuje za běhu — logické funkce ho získávají z vygenerované SDK vrstvy a front-endové komponenty ho načítají z modulů poskytovaných serverem. Vaše nainstalovaná kopie se používá pouze pro kontrolu typů a build v době nasazení, takže ji nikdy není potřeba přibalit do nasazeného balíčku.
+
+Ponechání kteréhokoli balíčku pod `dependencies` ho vtáhne do runtime balíčku nainstalované aplikace, kde je jen mrtvou vahou. `twenty build` vypíše varování, pokud je kterýkoli z nich stále uveden pod `dependencies`.
+
+Vlastní runtime závislosti vaší aplikace (knihovny, které vaše logické funkce skutečně importují za běhu) přidejte jako obvykle pod `dependencies`.
diff --git a/packages/twenty-docs/l/cs/developers/extend/apps/getting-started/quick-start.mdx b/packages/twenty-docs/l/cs/developers/extend/apps/getting-started/quick-start.mdx
new file mode 100644
index 00000000000..ebb6f01dd32
--- /dev/null
+++ b/packages/twenty-docs/l/cs/developers/extend/apps/getting-started/quick-start.mdx
@@ -0,0 +1,176 @@
+---
+title: Rychlý start
+icon: rocket
+description: Vytvořte svou první aplikaci Twenty během několika minut.
+---
+
+## Předpoklady
+
+* **Node.js 24+** — [Stáhnout](https://nodejs.org/)
+* **Yarn 4** — je součástí Node.js prostřednictvím Corepacku. Povolte jej: `corepack enable`
+* **Docker** — [Stáhnout](https://www.docker.com/products/docker-desktop/). Nutné pro spuštění lokálního serveru Twenty. Přeskočte, pokud už máte Twenty spuštěné jinde.
+
+Vytváření aplikace Twenty má tři fáze. Generátor kostry je spojuje do jediného příkazu pro ideální scénář, ale každá fáze je samostatný koncept — když se něco nepovede, znalost aktuální fáze napoví, co opravit.
+
+| Fáze | Co děláte | Nástroj | Výsledek |
+| ---------------------- | -------------------------------------------------------- | ----------------------------- | -------------------------------------------- |
+| **1. Vytvořit kostru** | Vygenerovat zdrojový kód aplikace | `npx create-twenty-app` | Projekt v TypeScriptu na disku |
+| **2. Spustit server** | Spustit server Twenty, do kterého se bude synchronizovat | Docker + `yarn twenty server` | Běžící instance Twenty |
+| **3. Synchronizovat** | Živě synchronizovat kód na server | `yarn twenty dev` | Vaše změny se objeví v uživatelském rozhraní |
+
+---
+
+## Fáze 1 — Vytvořte kostru projektu
+
+Vytvořte novou aplikaci ze šablony:
+
+```bash filename="Terminal"
+npx create-twenty-app@latest my-twenty-app
+```
+
+Budete vyzváni k zadání názvu a popisu — výchozí hodnoty potvrdíte klávesou **Enter**. Tím se v `my-twenty-app/` vytvoří projekt v TypeScriptu se startovacím `application-config.ts`, výchozí rolí, CI workflow a integračním testem.
+
+**Po této fázi:** máte na svém počítači zdrojový kód aplikace. Zatím neběží — to je předmětem Fáze 2.
+
+---
+
+## Fáze 2 — Spusťte lokální server Twenty
+
+Vaše aplikace potřebuje server Twenty, do kterého se bude synchronizovat. Server je plnohodnotná instance Twenty — UI, GraphQL API, PostgreSQL — běžící lokálně v Dockeru. Váš lokální kód nahrává své definice na tento server, díky čemuž se objeví v UI.
+
+Generátor kostry nabídne, že vám jej spustí:
+
+> **Chcete nastavit lokální instanci Twenty?**
+
+* **Ano (doporučeno)** — stáhne Docker image `twentycrm/twenty-app-dev` a spustí jej na portu `2020`. Nejprve se ujistěte, že Docker běží.
+* **Ne** — zvolte, pokud už máte server Twenty, ke kterému se chcete připojit. Můžete jej propojit později pomocí `yarn twenty remote:add`.
+
+<div style={{textAlign: 'center'}}>
+ <img src="/images/docs/developers/extends/apps/start-instance.png" alt="Spustit lokální instanci?" />
+</div>
+
+Jakmile server běží, otevře se prohlížeč pro přihlášení. Použijte předpřipravený demo účet:
+
+* **E-mail:** `[email protected]`
+* **Heslo:** `[email protected]`
+
+<div style={{textAlign: 'center'}}>
+ <img src="/images/docs/developers/extends/apps/login.png" alt="Přihlašovací obrazovka Twenty" />
+</div>
+
+Na další obrazovce klikněte na **Authorize** — tím udělíte nástroji CLI přístup k vašemu pracovnímu prostoru.
+
+<div style={{textAlign: 'center'}}>
+ <img src="/images/docs/developers/extends/apps/authorize.png" alt="Autorizační obrazovka Twenty CLI" />
+</div>
+
+Váš terminál potvrdí, že je vše nastaveno.
+
+<div style={{textAlign: 'center'}}>
+ <img src="/images/docs/developers/extends/apps/scaffolded.png" alt="Aplikace byla úspěšně vygenerována" />
+</div>
+
+**Po této fázi:** máte spuštěný server Twenty na [http://localhost:2020](http://localhost:2020) a vaše CLI má oprávnění se k němu synchronizovat.
+
+<Note>
+Pokud Docker není nainstalovaný nebo neběží, generátor kostry vám sdělí správný příkaz pro spuštění ve vašem operačním systému. Jakmile Docker poběží, můžete pokračovat pomocí `yarn twenty docker:start` — není potřeba znovu vytvářet kostru.
+</Note>
+
+---
+
+## Fáze 3 — Synchronizujte své změny
+
+Toto je vnitřní smyčka, ve které strávíte většinu času.
+
+```bash filename="Terminal"
+cd my-twenty-app
+yarn twenty dev
+```
+
+Tento proces sleduje `src/`, při každé změně znovu sestaví a synchronizuje výsledek na server. Upravte soubor, uložte a během několika vteřin se změna projeví na serveru. V terminálu uvidíte panel se stavem v reálném čase.
+
+Pro podrobnější výstup (protokoly sestavení, požadavky na synchronizaci, stopy chyb) přidejte `--verbose`.
+
+<div style={{textAlign: 'center'}}>
+ <img src="/images/docs/developers/extends/apps/dev.png" alt="Výstup terminálu ve vývojovém režimu" />
+</div>
+
+Otevřete [http://localhost:2020/settings/applications#developer](http://localhost:2020/settings/applications#developer). Vaše aplikace by měla být uvedena v části **Your Apps**.
+
+<div style={{textAlign: 'center'}}>
+ <img src="/images/docs/developers/extends/apps/app-in-ui-1.png" alt="Seznam Your Apps se zobrazenou aplikací My twenty app" />
+</div>
+
+Klikněte na **My twenty app** a zobrazí se jeho **registrace aplikace** — záznam na úrovni serveru, který popisuje vaši aplikaci (název, identifikátor, přihlašovací údaje OAuth, zdroj). Jedna registrace může být nainstalována ve více pracovních prostorech na stejném serveru.
+
+<div style={{textAlign: 'center'}}>
+ <img src="/images/docs/developers/extends/apps/app-in-ui-2.png" alt="Podrobnosti registrace aplikace" />
+</div>
+
+Klikněte na **View installed app**, abyste zobrazili instalaci v pracovním prostoru. Karta **About** zobrazuje verzi a možnosti správy.
+
+<div style={{textAlign: 'center'}}>
+ <img src="/images/docs/developers/extends/apps/app-in-ui-3.png" alt="Nainstalovaná aplikace" />
+</div>
+
+**Po této fázi:** máte průběžný vývojový cyklus. Upravte libovolný soubor v `src/` a projeví se to v UI.
+
+### Jednorázová synchronizace pro CI a skripty
+
+Předejte `--once` pro provedení jednoho sestavení + synchronizace a ukončení — stejný postup, bez sledování změn:
+
+```bash filename="Terminal"
+yarn twenty dev --once
+```
+
+| Příkaz | Chování | Kdy použít |
+| ---------------------------------- | ---------------------------------------------------------------------------------- | ------------------------------------------------------------------------ |
+| `yarn twenty dev` | Sleduje změny a při každé změně znovu synchronizuje. Běží, dokud jej nezastavíte. | Interaktivní lokální vývoj. |
+| `yarn twenty dev --once` | Jedno sestavení + synchronizace, ukončí se s kódem `0` při úspěchu, `1` při chybě. | CI, pre-commit hooky, AI agenti, skriptované pracovní postupy. |
+| `yarn twenty dev --once --dry-run` | Sestaví a vypíše změny metadat **bez jejich použití**. | Kontrola toho, co by synchronizace změnila, ještě před jejím potvrzením. |
+
+Oba režimy vyžadují autentizovaný vzdálený server. Více informací o `--dry-run` najdete v části [Synchronizace a obnovení](/l/cs/developers/extend/apps/operations/sync-and-recovery#previewing-changes-dry-run).
+
+### Možnosti vývojového režimu
+
+| Přepínač | Popis |
+| ------------------------------------- | --------------------------------------------------------------------------------------------- |
+| `--once` | Jednou sestavit a synchronizovat, poté ukončit. |
+| `--dry-run` | Pomocí `--once` zobrazíte náhled změn metadat, aniž byste je použili. Nic nezapisuje. |
+| `--debounceMs \<ms>` | Nastaví prodlevu pro potlačení zákmitů při změnách souborů v milisekundách (výchozí: `2000`). |
+| `--verbose` / `--debug` | Zobrazí podrobné protokoly sestavení, požadavky synchronizace a trasování chyb. |
+
+## Co můžete vytvořit
+
+Aplikace se skládají z **entit** — každá je definována jako soubor TypeScriptu s jediným `export default`:
+
+| Entita | K čemu slouží |
+| -------------------------- | ------------------------------------------------------------------------------------------------------------------- |
+| **Objekty a pole** | Vlastní datové modely (pohlednice, faktura apod.) s typovanými poli |
+| **Logické funkce** | Serverový TypeScript spouštěný HTTP trasami, plánovačem cron nebo událostmi databáze |
+| **Frontendové komponenty** | 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 |
+| **Rozvržení stránek** | Vlastní stránky detailu záznamu s kartami a widgety |
+
+Úplná reference: [Koncepty](/l/cs/developers/extend/apps/getting-started/concepts).
+
+## Další kroky
+
+<CardGroup cols={2}>
+ <Card title="Konfigurace" icon="screwdriver-wrench" href="/l/cs/developers/extend/apps/config/overview">
+ Identita aplikace, výchozí role, instalační hooky, veřejná aktiva.
+ </Card>
+ <Card title="Data" icon="database" href="/l/cs/developers/extend/apps/data/overview">
+ Objekty, pole a obousměrné relace.
+ </Card>
+ <Card title="Logika" icon="bolt" href="/l/cs/developers/extend/apps/logic/overview">
+ Logické funkce, dovednosti, agenti a připojení přes OAuth.
+ </Card>
+ <Card title="Rozvržení" icon="table-columns" href="/l/cs/developers/extend/apps/layout/overview">
+ Zobrazení, navigace, rozvržení stránek, frontendové komponenty.
+ </Card>
+ <Card title="Operace" icon="rocket" href="/l/cs/developers/extend/apps/operations/overview">
+ CLI, testování, vzdálené repozitáře, CI a publikování vaší aplikace.
+ </Card>
+</CardGroup>
diff --git a/packages/twenty-docs/l/cs/developers/extend/apps/getting-started/scaffolding.mdx b/packages/twenty-docs/l/cs/developers/extend/apps/getting-started/scaffolding.mdx
new file mode 100644
index 00000000000..204631717d5
--- /dev/null
+++ b/packages/twenty-docs/l/cs/developers/extend/apps/getting-started/scaffolding.mdx
@@ -0,0 +1,58 @@
+---
+title: Vytvoření kostry
+description: Interaktivně generujte soubory entit pomocí yarn twenty dev:add – objekty, pole, zobrazení, logické funkce a další.
+icon: wand-magic-sparkles
+---
+
+Místo ručního vytváření souborů entit použijte interaktivní generátor:
+
+```bash filename="Terminal"
+yarn twenty dev:add
+```
+
+Vyžádá si, abyste vybrali typ entity, provede vás požadovanými poli a poté zapíše připravený soubor s pevně daným `universalIdentifier` a správným voláním `defineEntity()`.
+
+Můžete také předat typ entity přímo a přeskočit první dotaz:
+
+```bash filename="Terminal"
+yarn twenty dev:add object
+yarn twenty dev:add logicFunction
+yarn twenty dev:add frontComponent
+```
+
+## Dostupné typy entit
+
+| Typ entity | Příkaz | Vygenerovaný soubor |
+| ------------------------- | ---------------------------------------- | ------------------------------------------------------- |
+| Objekt | `yarn twenty dev:add object` | `src/objects/\<name>.ts` |
+| Pole | `yarn twenty dev:add field` | `src/fields/\<name>.ts` |
+| Logická funkce | `yarn twenty dev:add logicFunction` | `src/logic-functions/\<name>.ts` |
+| Frontendová komponenta | `yarn twenty dev:add frontComponent` | `src/front-components/\<name>.tsx` |
+| Role | `yarn twenty dev:add role` | `src/roles/\<name>.ts` |
+| Dovednost | `yarn twenty dev:add skill` | `src/skills/\<name>.ts` |
+| Agent | `yarn twenty dev:add agent` | `src/agents/\<name>.ts` |
+| Zobrazení | `yarn twenty dev:add view` | `src/views/\<name>.ts` |
+| Položka navigační nabídky | `yarn twenty dev:add navigationMenuItem` | `src/navigation-menu-items/\<name>.ts` |
+| Rozvržení stránky | `yarn twenty dev:add pageLayout` | `src/page-layouts/\<name>.ts` |
+
+## Co generátor vytváří
+
+Každý typ entity má vlastní šablonu. Například `yarn twenty dev:add object` se zeptá na:
+
+1. **Název (jednotné číslo)** — např. `invoice`
+2. **Název (množné číslo)** — např. `invoices`
+3. **Štítek (jednotné číslo)** — automaticky doplněn z názvu (např. `Invoice`)
+4. **Štítek (množné číslo)** — automaticky doplněn (např. `Invoices`)
+5. **Vytvořit zobrazení a položku navigace?** — pokud odpovíte ano, generátor také vytvoří odpovídající zobrazení a odkaz v postranním panelu pro nový objekt.
+
+Ostatní typy entit mají jednodušší dotazy — většinou se ptají pouze na název.
+
+Typ entity `field` je podrobnější: ptá se na název pole, štítek, typ (ze seznamu všech dostupných typů polí jako `TEXT`, `NUMBER`, `SELECT`, `RELATION` atd.) a `universalIdentifier` cílového objektu.
+
+## Vlastní výstupní cesta
+
+Pomocí příznaku `--path` umístíte vygenerovaný soubor do vlastního umístění:
+
+```bash filename="Terminal"
+yarn twenty dev:add logicFunction --path src/custom-folder
+```
diff --git a/packages/twenty-docs/l/cs/developers/extend/apps/getting-started/troubleshooting.mdx b/packages/twenty-docs/l/cs/developers/extend/apps/getting-started/troubleshooting.mdx
new file mode 100644
index 00000000000..4112924b195
--- /dev/null
+++ b/packages/twenty-docs/l/cs/developers/extend/apps/getting-started/troubleshooting.mdx
@@ -0,0 +1,14 @@
+---
+title: Řešení potíží
+description: Časté problémy při prvním spuštění — Docker, verze Node, Yarn, závislosti.
+icon: klíč
+---
+
+* **Chyby Dockeru** — Před spuštěním `yarn twenty docker:start` se ujistěte, že Docker Desktop (nebo démon) běží. Chybová zpráva ukáže správný příkaz pro spuštění pro váš operační systém.
+* **Nesprávná verze Node** — Je potřeba 24+. Ověřte pomocí `node -v`.
+* **Chybí Yarn 4** — Spusťte `corepack enable`.
+* **Rozbité závislosti** — `rm -rf node_modules && yarn install`.
+* **Chyby `twenty-sdk` po upgradu na v2.8.0** — V 2.8.0 byl přesunut z `dependencies` do `devDependencies`. Viz [Struktura projektu → Závislosti](/l/cs/developers/extend/apps/getting-started/project-structure#dependencies).
+* **`twenty build` upozorňuje na `twenty-client-sdk` v sekci `dependencies`** — je poskytován za běhu Twenty, takže by měl být přesunut do `devDependencies` vedle `twenty-sdk`. Viz [Struktura projektu → Závislosti](/l/cs/developers/extend/apps/getting-started/project-structure#dependencies).
+
+Zasekli jste se? Zeptejte se na [Discordu Twenty](https://discord.com/channels/1130383047699738754/1130386664812982322).
diff --git a/packages/twenty-docs/l/cs/developers/extend/apps/layout/command-menu-items.mdx b/packages/twenty-docs/l/cs/developers/extend/apps/layout/command-menu-items.mdx
new file mode 100644
index 00000000000..feb8ad48cd8
--- /dev/null
+++ b/packages/twenty-docs/l/cs/developers/extend/apps/layout/command-menu-items.mdx
@@ -0,0 +1,148 @@
+---
+title: Položky příkazové nabídky
+description: Zpřístupněte front komponenty jako rychlé akce a položky příkazového menu (Cmd+K) pomocí defineCommandMenuItem.
+icon: terminal
+---
+
+**Položka příkazového menu** je most mezi uživatelem a [front komponentou](/l/cs/developers/extend/apps/layout/front-components). Registruje komponentu v příkazovém menu Twenty (Cmd+K) a volitelně také jako připnuté tlačítko rychlé akce v pravém horním rohu stránky.
+
+```ts src/command-menu-items/open-dashboard.command-menu-item.ts
+import { defineCommandMenuItem } from 'twenty-sdk/define';
+
+export default defineCommandMenuItem({
+ universalIdentifier: 'a1b2c3d4-e5f6-7890-abcd-ef1234567890',
+ label: 'Open Dashboard',
+ shortLabel: 'Dashboard',
+ icon: 'IconLayoutDashboard',
+ isPinned: true,
+ availabilityType: 'GLOBAL',
+ frontComponentUniversalIdentifier: '74c526eb-cb68-4cf7-b05c-0dd8c288d948',
+});
+```
+
+## Konfigurační pole
+
+| Pole | Povinné | Popis |
+| --------------------------------------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `universalIdentifier` | Ano | Stabilní jedinečné ID pro příkaz |
+| `label` | Ano | Plný popisek zobrazený v příkazovém menu (Cmd+K) |
+| `frontComponentUniversalIdentifier` | Ano | `universalIdentifier` frontendové komponenty, kterou tento příkaz otevírá |
+| `shortLabel` | Ne | Kratší popisek zobrazený na připnutém tlačítku rychlé akce |
+| `icon` | Ne | Název ikony zobrazený vedle popisku (např. `'IconBolt'`, `'IconSend'`) |
+| `isPinned` | Ne | Pokud je `true`, zobrazí příkaz jako tlačítko rychlé akce v pravém horním rohu stránky |
+| `availabilityType` | Ne | Určuje, kde se příkaz zobrazuje: `'GLOBAL'` (vždy dostupné), `'RECORD_SELECTION'` (pouze když jsou vybrány záznamy) nebo `'FALLBACK'` (zobrazeno, když neodpovídají žádné jiné příkazy) |
+| `availabilityObjectUniversalIdentifier` | Ne | Omezí příkaz na stránky konkrétního typu objektu (např. pouze u záznamů Company) |
+| `conditionalAvailabilityExpression` | Ne | Logický výraz, který dynamicky řídí viditelnost (viz níže) |
+
+## Příkazy bez rozhraní
+
+Položka příkazového menu spárovaná s [front komponentou bez rozhraní](/l/cs/developers/extend/apps/layout/front-components#headless-vs-non-headless) je idiomatický způsob, jak dodat akci na jedno kliknutí — spustit kód, přejít na stránku nebo potvrdit a provést. Stránka Front Components popisuje [SDK Command komponenty](/l/cs/developers/extend/apps/layout/front-components#sdk-command-components) (`Command`, `CommandLink`, `CommandModal`, `CommandOpenSidePanelPage`), které obsluhují pattern akce-a-unmount.
+
+Typický průběh:
+
+```tsx src/front-components/run-action.tsx
+import { defineFrontComponent } from 'twenty-sdk/define';
+import { Command } from 'twenty-sdk/command';
+import { CoreApiClient } from 'twenty-sdk/clients';
+
+const RunAction = () => {
+ const execute = async () => {
+ const client = new CoreApiClient();
+ await client.mutation({
+ createTask: {
+ __args: { data: { title: 'Created by my app' } },
+ id: true,
+ },
+ });
+ };
+
+ return <Command execute={execute} />;
+};
+
+export default defineFrontComponent({
+ universalIdentifier: 'e5f6a7b8-c9d0-1234-efab-345678901234',
+ name: 'run-action',
+ description: 'Creates a task from the command menu',
+ component: RunAction,
+ isHeadless: true,
+});
+```
+
+```ts src/command-menu-items/run-action.command-menu-item.ts
+import { defineCommandMenuItem } from 'twenty-sdk/define';
+
+export default defineCommandMenuItem({
+ universalIdentifier: 'f6a7b8c9-d0e1-2345-fabc-456789012345',
+ label: 'Run my action',
+ icon: 'IconPlayerPlay',
+ frontComponentUniversalIdentifier: 'e5f6a7b8-c9d0-1234-efab-345678901234',
+});
+```
+
+## Výrazy podmíněné dostupnosti
+
+Pole `conditionalAvailabilityExpression` vám umožní řídit viditelnost příkazu na základě aktuálního kontextu stránky. Pro sestavení výrazů importujte typované proměnné a operátory z `twenty-sdk`:
+
+```ts src/command-menu-items/bulk-update.command-menu-item.ts
+import {
+ defineCommandMenuItem,
+ objectPermissions,
+ everyEquals,
+} from 'twenty-sdk/define';
+
+export default defineCommandMenuItem({
+ universalIdentifier: '...',
+ label: 'Bulk Update',
+ availabilityType: 'RECORD_SELECTION',
+ frontComponentUniversalIdentifier: '...',
+ conditionalAvailabilityExpression: everyEquals(
+ objectPermissions,
+ 'canUpdateObjectRecords',
+ true,
+ ),
+});
+```
+
+<Note>
+ `RECORD_SELECTION` již znamená neprázdný výběr — použijte `numberOfSelectedRecords` pouze pro konkrétní počty (např. `>= 2`).
+</Note>
+
+### Kontextové proměnné
+
+Tyto proměnné reprezentují aktuální stav stránky:
+
+| Proměnná | Typ | Popis |
+| ------------------------------ | --------- | -------------------------------------------------------------------- |
+| `pageType` | `string` | Aktuální typ stránky (např. `'RecordIndexPage'`, `'RecordShowPage'`) |
+| `isInSidePanel` | `boolean` | Zda je komponenta vykreslena v postranním panelu |
+| `numberOfSelectedRecords` | `number` | Počet aktuálně vybraných záznamů |
+| `isSelectAll` | `boolean` | Zda je aktivní "vybrat vše" |
+| `selectedRecords` | `array` | Vybrané objekty záznamů |
+| `favoriteRecordIds` | `array` | ID oblíbených záznamů |
+| `objectPermissions` | `object` | Oprávnění pro aktuální typ objektu |
+| `targetObjectReadPermissions` | `object` | Oprávnění ke čtení pro cílový objekt |
+| `targetObjectWritePermissions` | `object` | Oprávnění k zápisu pro cílový objekt |
+| `featureFlags` | `object` | Aktivní příznaky funkcí |
+| `objectMetadataItem` | `object` | Metadata aktuálního typu objektu |
+| `hasAnySoftDeleteFilterOnView` | `boolean` | Zda má aktuální zobrazení filtr soft-delete |
+
+### Operátory
+
+Kombinujte proměnné do logických výrazů:
+
+| Operátor | Popis |
+| ----------------------------------- | ------------------------------------------------------------------------------ |
+| `isDefined(value)` | `true`, pokud hodnota není null/undefined |
+| `isNonEmptyString(value)` | `true`, pokud je hodnota neprázdným řetězcem |
+| `includes(array, value)` | `true`, pokud pole obsahuje danou hodnotu |
+| `includesEvery(array, prop, value)` | `true`, pokud vlastnost každé položky zahrnuje danou hodnotu |
+| `every(array, prop)` | `true`, pokud je vlastnost u každé položky pravdivá (truthy) |
+| `everyDefined(array, prop)` | `true`, pokud je vlastnost definována u každé položky |
+| `everyEquals(array, prop, value)` | `true`, pokud se vlastnost rovná hodnotě u každé položky |
+| `some(array, prop)` | `true`, pokud je vlastnost pravdivá (truthy) alespoň u jedné položky |
+| `someDefined(array, prop)` | `true`, pokud je vlastnost definována alespoň u jedné položky |
+| `someEquals(array, prop, value)` | `true`, pokud se vlastnost rovná hodnotě alespoň u jedné položky |
+| `someNonEmptyString(array, prop)` | `true`, pokud má vlastnost alespoň u jedné položky hodnotu neprázdného řetězce |
+| `none(array, prop)` | `true`, pokud je vlastnost u všech položek nepravdivá (falsy) |
+| `noneDefined(array, prop)` | `true`, pokud je vlastnost u všech položek nedefinovaná |
+| `noneEquals(array, prop, value)` | `true`, pokud se vlastnost nerovná hodnotě u žádné položky |
diff --git a/packages/twenty-docs/l/cs/developers/extend/apps/layout/front-components.mdx b/packages/twenty-docs/l/cs/developers/extend/apps/layout/front-components.mdx
new file mode 100644
index 00000000000..ded574d80d2
--- /dev/null
+++ b/packages/twenty-docs/l/cs/developers/extend/apps/layout/front-components.mdx
@@ -0,0 +1,545 @@
+---
+title: Frontendové komponenty
+description: Vytvářejte komponenty Reactu, které se vykreslují uvnitř uživatelského rozhraní Twenty se sandboxovou izolací.
+icon: window-maximize
+---
+
+Frontendové komponenty jsou React komponenty, které se vykreslují přímo v uživatelském rozhraní Twenty. Běží v **izolovaném Web Workeru** s využitím Remote DOM — váš kód je sandboxovaný, ale vykresluje se nativně na stránce, nikoli v iframu.
+
+## Kde lze použít frontendové komponenty
+
+Frontendové komponenty se mohou vykreslovat na dvou místech v rámci Twenty:
+
+* **Postranní panel** — Frontendové komponenty, které nejsou headless, se otevírají v pravém postranním panelu. Toto je výchozí chování, když je frontendová komponenta vyvolána z příkazového menu.
+* **Widgety (nástěnky a stránky záznamů)** — front komponenty lze vkládat jako widgety do [rozložení stránky](/l/cs/developers/extend/apps/layout/page-layouts). Při konfiguraci nástěnky nebo rozložení stránky záznamu mohou uživatelé přidat widget frontendové komponenty.
+
+Samotná frontendová komponenta není z uživatelského rozhraní dostupná — je potřeba ji zpřístupnit. Dva způsoby, jak to udělat, jsou:
+
+* **Spárujte ji s [položkou příkazové nabídky](/l/cs/developers/extend/apps/layout/command-menu-items)** — zaregistruje ji v příkazové nabídce (Cmd+K) a volitelně také jako připnutou rychlou akci.
+* **Vložte ji jako widget do [rozložení stránky](/l/cs/developers/extend/apps/layout/page-layouts)** — umístí ji na detailní stránku záznamu nebo na nástěnku.
+
+## Základní příklad
+
+Nejrychlejší způsob, jak vidět front komponentu v akci, je spárovat ji s [`defineCommandMenuItem`](/l/cs/developers/extend/apps/layout/command-menu-items), aby se objevila jako tlačítko rychlé akce v pravém horním rohu stránky:
+
+```tsx src/front-components/hello-world.tsx
+import { defineFrontComponent } from 'twenty-sdk/define';
+
+const HelloWorld = () => {
+ return (
+ <div style={{ padding: '20px', fontFamily: 'sans-serif' }}>
+ <h1>Hello from my app!</h1>
+ <p>This component renders inside Twenty.</p>
+ </div>
+ );
+};
+
+export default defineFrontComponent({
+ universalIdentifier: '74c526eb-cb68-4cf7-b05c-0dd8c288d948',
+ name: 'hello-world',
+ description: 'A simple front component',
+ component: HelloWorld,
+});
+```
+
+```ts src/command-menu-items/hello-world.command-menu-item.ts
+import { defineCommandMenuItem } from 'twenty-sdk/define';
+
+export default defineCommandMenuItem({
+ universalIdentifier: 'd4e5f6a7-b8c9-0123-defa-456789012345',
+ shortLabel: 'Hello',
+ label: 'Hello World',
+ icon: 'IconBolt',
+ isPinned: true,
+ availabilityType: 'GLOBAL',
+ frontComponentUniversalIdentifier: '74c526eb-cb68-4cf7-b05c-0dd8c288d948',
+});
+```
+
+Po synchronizaci pomocí `yarn twenty dev` (nebo po jednorázovém spuštění `yarn twenty dev --once`) se rychlá akce zobrazí v pravém horním rohu stránky:
+
+<div style={{textAlign: 'center'}}>
+ <img src="/images/docs/developers/extends/apps/quick-action.png" alt="Tlačítko rychlé akce v pravém horním rohu" />
+</div>
+
+Kliknutím na něj vykreslíte komponentu přímo ve stránce.
+
+## Konfigurační pole
+
+| Pole | Povinné | Popis |
+| --------------------- | ------- | ----------------------------------------------------------------- |
+| `universalIdentifier` | Ano | Stabilní jedinečné ID pro tuto komponentu |
+| `component` | Ano | Funkce komponenty React |
+| `name` | Ne | Zobrazovaný název |
+| `description` | Ne | Popis toho, co komponenta dělá |
+| `isHeadless` | Ne | Nastavte na `true`, pokud komponenta nemá viditelné UI (viz níže) |
+
+## Umístění frontendové komponenty na stránku
+
+Mimo příkazy můžete frontendovou komponentu vložit přímo na stránku záznamu přidáním jako widget v **rozvržení stránky**. Podrobnosti viz [Rozložení stránek](/l/cs/developers/extend/apps/layout/page-layouts).
+
+## Headless vs. ne-headless
+
+Front-endové komponenty existují ve dvou režimech vykreslování řízených volbou `isHeadless`:
+
+**Ne-headless (výchozí)** — Komponenta vykreslí viditelné uživatelské rozhraní. Po vyvolání z menu příkazů se otevře v postranním panelu. Toto je výchozí chování, když je `isHeadless` `false` nebo když tato volba není uvedena.
+
+**Headless (`isHeadless: true`)** — Komponenta se neviditelně inicializuje na pozadí. Neotevírá postranní panel. Headless komponenty jsou určené pro akce, které provedou logiku a poté se odpojí — například spuštění asynchronního úkolu, navigaci na stránku nebo zobrazení potvrzovacího modálního okna. Přirozeně se hodí ke komponentám SDK Command popsaným níže.
+
+```tsx src/front-components/sync-tracker.tsx
+import { defineFrontComponent } from 'twenty-sdk/define';
+import { useRecordId, enqueueSnackbar } from 'twenty-sdk/front-component';
+import { useEffect } from 'react';
+
+const SyncTracker = () => {
+ const recordId = useRecordId();
+
+ useEffect(() => {
+ enqueueSnackbar({ message: `Tracking record ${recordId}`, variant: 'info' });
+ }, [recordId]);
+
+ return null;
+};
+
+export default defineFrontComponent({
+ universalIdentifier: '...',
+ name: 'sync-tracker',
+ description: 'Tracks record views silently',
+ isHeadless: true,
+ component: SyncTracker,
+});
+```
+
+Protože komponenta vrací `null`, Twenty přeskočí vykreslení kontejneru — v rozvržení se neobjeví žádné prázdné místo. Komponenta má však stále přístup ke všem hookům a API komunikace s hostitelem.
+
+## Komponenty SDK Command
+
+Balíček `twenty-sdk` poskytuje čtyři pomocné komponenty Command navržené pro headless front-endové komponenty. Každá komponenta při připojení provede akci, chyby zpracuje zobrazením oznámení ve snackbaru a po dokončení automaticky odpojí front-endovou komponentu.
+
+Importujte je z `twenty-sdk/command`:
+
+* **`Command`** — Spustí asynchronní callback přes prop `execute`.
+* **`CommandLink`** — Naviguje na cestu v aplikaci. Props: `to`, `params`, `queryParams`, `options`.
+* **`CommandModal`** — Otevře potvrzovací modální okno. Pokud uživatel potvrdí, provede callback `execute`. Props: `title`, `subtitle`, `execute`, `confirmButtonText`, `confirmButtonAccent`.
+* **`CommandOpenSidePanelPage`** — Otevře konkrétní stránku postranního panelu. Props: `page`, `pageTitle`, `pageIcon`.
+
+Zde je kompletní příklad headless front-endové komponenty, která pomocí `Command` spouští akci z menu příkazů:
+
+```tsx src/front-components/run-action.tsx
+import { defineFrontComponent } from 'twenty-sdk/define';
+import { Command } from 'twenty-sdk/command';
+import { CoreApiClient } from 'twenty-sdk/clients';
+
+const RunAction = () => {
+ const execute = async () => {
+ const client = new CoreApiClient();
+
+ await client.mutation({
+ createTask: {
+ __args: { data: { title: 'Created by my app' } },
+ id: true,
+ },
+ });
+ };
+
+ return <Command execute={execute} />;
+};
+
+export default defineFrontComponent({
+ universalIdentifier: 'e5f6a7b8-c9d0-1234-efab-345678901234',
+ name: 'run-action',
+ description: 'Creates a task from the command menu',
+ component: RunAction,
+ isHeadless: true,
+});
+```
+
+```ts src/command-menu-items/run-action.command-menu-item.ts
+import { defineCommandMenuItem } from 'twenty-sdk/define';
+
+export default defineCommandMenuItem({
+ universalIdentifier: 'f6a7b8c9-d0e1-2345-fabc-456789012345',
+ label: 'Run my action',
+ icon: 'IconPlayerPlay',
+ frontComponentUniversalIdentifier: 'e5f6a7b8-c9d0-1234-efab-345678901234',
+});
+```
+
+A příklad s použitím `CommandModal` k vyžádání potvrzení před provedením:
+
+```tsx src/front-components/delete-draft.tsx
+import { defineFrontComponent } from 'twenty-sdk/define';
+import { CommandModal } from 'twenty-sdk/command';
+
+const DeleteDraft = () => {
+ const execute = async () => {
+ // perform the deletion
+ };
+
+ return (
+ <CommandModal
+ title="Delete draft?"
+ subtitle="This action cannot be undone."
+ execute={execute}
+ confirmButtonText="Delete"
+ confirmButtonAccent="danger"
+ />
+ );
+};
+
+export default defineFrontComponent({
+ universalIdentifier: 'a7b8c9d0-e1f2-3456-abcd-567890123456',
+ name: 'delete-draft',
+ description: 'Deletes a draft with confirmation',
+ component: DeleteDraft,
+ isHeadless: true,
+});
+```
+
+## Volání logické funkce
+
+Front komponenty běží v prohlížeči v izolovaném web workeru, zatímco [logické funkce](/l/cs/developers/extend/apps/logic/logic-functions) běží na serveru. Neexistuje mezi nimi žádné přímé volání v rámci jednoho procesu — místo toho se front komponenta k logické funkci připojuje přes HTTP.
+
+Logická funkce deklarovaná pomocí `httpRouteTriggerSettings` je vystavena pod endpointem `/s/` na `${TWENTY_API_URL}/s\<path>`. Vaše front komponenta volá tuto trasu pomocí `RestApiClient` z `twenty-client-sdk/rest`, který se autentizuje pomocí `TWENTY_APP_ACCESS_TOKEN`, který Twenty do workeru vkládá.
+
+`RestApiClient` je přesně pro tento účel. Z worker prostředí čte `TWENTY_API_URL` a `TWENTY_APP_ACCESS_TOKEN`, přidává hlavičku `Authorization: Bearer`, serializuje a parsuje JSON a vyhazuje `RestApiClientError`, pokud token nebo URL chybí nebo je odpověď mimo rozsah 2xx — takže nemusíte tento boilerplate znovu implementovat v každé komponentě.
+
+Headless front komponenta může volání spustit při mountu přes komponentu `Command` a poté se automaticky odmountovat:
+
+```tsx src/front-components/sync-prs.tsx
+import { defineFrontComponent } from 'twenty-sdk/define';
+import { Command } from 'twenty-sdk/command';
+import { RestApiClient } from 'twenty-client-sdk/rest';
+
+const SyncPrs = () => {
+ const execute = async () => {
+ const client = new RestApiClient();
+
+ await client.post('/s/github/fetch-prs', {
+ owner: 'twentyhq',
+ repo: 'twenty',
+ });
+ };
+
+ return <Command execute={execute} />;
+};
+
+export default defineFrontComponent({
+ universalIdentifier: '...',
+ name: 'sync-prs',
+ description: 'Triggers the fetch-prs logic function',
+ isHeadless: true,
+ component: SyncPrs,
+});
+```
+
+Cesta předaná klientovi je veřejná cesta trasy — `httpRouteTriggerSettings.path` logické funkce s předponou `/s`. Ponechte `isAuthRequired: true`; klient poskytuje pro vaši komponentu přístupový token aplikace vydaný Twenty:
+
+```ts src/logic-functions/fetch-prs.logic-function.ts
+import { defineLogicFunction } from 'twenty-sdk/define';
+import type { RoutePayload } from 'twenty-sdk/logic-function';
+
+const handler = async (event: RoutePayload) => {
+ const { owner, repo } = (event.body ?? {}) as { owner: string; repo: string };
+ // ...fetch from GitHub and persist records...
+ return { ok: true };
+};
+
+export default defineLogicFunction({
+ universalIdentifier: '...',
+ name: 'fetch-prs',
+ handler,
+ httpRouteTriggerSettings: {
+ path: '/github/fetch-prs',
+ httpMethod: 'POST',
+ isAuthRequired: true,
+ },
+});
+```
+
+<Note>
+`TWENTY_API_URL` a `TWENTY_APP_ACCESS_TOKEN` jsou vloženy automaticky — viz [Proměnné aplikace](#application-variables). Protože tajné proměnné aplikace nejsou nikdy vystaveny front komponentám, ponechte API klíče a další citlivou logiku v logické funkci, ne ve front komponentě.
+</Note>
+
+### Reference `RestApiClient`
+
+Importujte `RestApiClient` z `twenty-client-sdk/rest`. Patří do stejné rodiny klientů jako `CoreApiClient` a `MetadataApiClient`, ale cílí na HTTP trasy vaší aplikace místo na GraphQL API.
+
+| Metoda | Popis |
+| --------------------------------- | ------------------------------------------ |
+| `get(path, options?)` | Odešle požadavek `GET` |
+| `post(path, body?, options?)` | Odešle požadavek `POST` |
+| `put(path, body?, options?)` | Odešle požadavek `PUT` |
+| `patch(path, body?, options?)` | Odešle požadavek `PATCH` |
+| `delete(path, options?)` | Odešle požadavek `DELETE` |
+| `request(method, path, options?)` | Obecný požadavek s libovolnou metodou HTTP |
+
+`options` přijímá `headers`, `query` (záznam parametrů dotazovacího řetězce; hodnoty typu nullish jsou vynechány) a `AbortSignal` prostřednictvím `signal`. Objekt `body`, který není typu `FormData`, je automaticky serializován do JSON. Při `401` klient jednou obnoví přístupový token prostřednictvím hostitele a požadavek znovu odešle.
+
+Základní URL a token jsou ve výchozím nastavení odvozeny z prostředí. Podle potřeby předávejte konstruktoru přepsané hodnoty — například v testech:
+
+```ts
+const client = new RestApiClient({
+ baseUrl: 'https://api.example.com',
+ token: 'my-token',
+});
+```
+
+Neúspěšné požadavky vyvolají `RestApiClientError`, který zpřístupňuje `status`, `statusText`, `url` a parsované `body`:
+
+```tsx
+import { RestApiClient, RestApiClientError } from 'twenty-client-sdk/rest';
+
+const client = new RestApiClient();
+
+try {
+ const prs = await client.get('/s/github/fetch-prs', {
+ query: { state: 'open' },
+ });
+} catch (error) {
+ if (error instanceof RestApiClientError) {
+ console.error(error.status, error.body);
+ }
+}
+```
+
+## Přístup k běhovému kontextu
+
+Uvnitř komponenty použijte hooky SDK pro přístup k aktuálnímu uživateli, záznamu a instanci komponenty:
+
+```tsx src/front-components/record-info.tsx
+import { defineFrontComponent } from 'twenty-sdk/define';
+import {
+ useUserId,
+ useRecordId,
+ useFrontComponentId,
+} from 'twenty-sdk/front-component';
+
+const RecordInfo = () => {
+ const userId = useUserId();
+ const recordId = useRecordId();
+ const componentId = useFrontComponentId();
+
+ return (
+ <div>
+ <p>User: {userId}</p>
+ <p>Record: {recordId ?? 'No record context'}</p>
+ <p>Component: {componentId}</p>
+ </div>
+ );
+};
+
+export default defineFrontComponent({
+ universalIdentifier: 'b2c3d4e5-f6a7-8901-bcde-f23456789012',
+ name: 'record-info',
+ component: RecordInfo,
+});
+```
+
+Dostupné hooky:
+
+| Hook | Vrací | Popis |
+| --------------------------------------------- | ----------------------- | ------------------------------------------------------------------------------------ |
+| `useUserId()` | `string` nebo `null` | ID aktuálního uživatele |
+| `useSelectedRecordIds()` | `string[]` | Všechna vybraná ID záznamů (prázdné pole, pokud není nic vybráno) |
+| `useRecordId()` | `string` nebo `null` | **Zastaralé.** Použijte místo toho `useSelectedRecordIds()` |
+| `useFrontComponentId()` | `string` | ID této instance komponenty |
+| `useColorScheme()` | `'light'` nebo `'dark'` | Aktivní barevné schéma uživatelského rozhraní hostitele (`System` je již vyhodnocen) |
+| `useFrontComponentExecutionContext(selector)` | různé | Přístup k úplnému kontextu běhu pomocí selektorové funkce |
+
+## Aplikační proměnné
+
+Aplikační proměnné definované v [`defineApplication()`](/l/cs/developers/extend/apps/config/application) s `isSecret: false` jsou k dispozici ve front-endových komponentách prostřednictvím pomocné funkce `getApplicationVariable`:
+
+```tsx src/front-components/greeting.tsx
+import { defineFrontComponent } from 'twenty-sdk/define';
+import { getApplicationVariable } from 'twenty-sdk/front-component';
+
+const Greeting = () => {
+ const recipientName = getApplicationVariable('DEFAULT_RECIPIENT_NAME') ?? 'World';
+
+ return <p>Hello, {recipientName}!</p>;
+};
+
+export default defineFrontComponent({
+ universalIdentifier: '...',
+ name: 'greeting',
+ component: Greeting,
+});
+```
+
+<Warning>
+Tajné proměnné (`isSecret: true`) **nejsou** zpřístupněny front-endovým komponentám. Jsou k dispozici pouze v [logických funkcích](/l/cs/developers/extend/apps/logic/logic-functions), které běží na straně serveru. Tím se zabrání odesílání citlivých hodnot, jako jsou API klíče, do prohlížeče.
+</Warning>
+
+Následující systémové proměnné jsou vždy dostupné přes `process.env`:
+
+| Proměnná | Popis |
+| ------------------------- | -------------------------------------------------------------- |
+| `TWENTY_API_URL` | Základní URL Twenty API |
+| `TWENTY_APP_ACCESS_TOKEN` | Krátkodobý token s oprávněními omezenými na roli vaší aplikace |
+
+## API komunikace s hostitelem
+
+Frontendové komponenty mohou pomocí funkcí z `twenty-sdk` vyvolávat navigaci, modály a oznámení:
+
+| Funkce | Popis |
+| ----------------------------------------------- | ------------------------------ |
+| `navigate(to, params?, queryParams?, options?)` | Přejít na stránku v aplikaci |
+| `openSidePanelPage(params)` | Otevřít postranní panel |
+| `closeSidePanel()` | Zavřít postranní panel |
+| `openCommandConfirmationModal(params)` | Zobrazit potvrzovací dialog |
+| `enqueueSnackbar(params)` | Zobrazit oznámení typu toast |
+| `unmountFrontComponent()` | Odpojit komponentu |
+| `updateProgress(progress)` | Aktualizovat indikátor průběhu |
+
+Zde je příklad, který používá hostitelské API k zobrazení snackbaru a zavření postranního panelu po dokončení akce:
+
+```tsx src/front-components/archive-record.tsx
+import { defineFrontComponent } from 'twenty-sdk/define';
+import { useRecordId } from 'twenty-sdk/front-component';
+import { enqueueSnackbar, closeSidePanel } from 'twenty-sdk/front-component';
+import { CoreApiClient } from 'twenty-sdk/clients';
+
+const ArchiveRecord = () => {
+ const recordId = useRecordId();
+
+ const handleArchive = async () => {
+ const client = new CoreApiClient();
+
+ await client.mutation({
+ updateTask: {
+ __args: { id: recordId, data: { status: 'ARCHIVED' } },
+ id: true,
+ },
+ });
+
+ await enqueueSnackbar({
+ message: 'Record archived',
+ variant: 'success',
+ });
+
+ await closeSidePanel();
+ };
+
+ return (
+ <div style={{ padding: '20px' }}>
+ <p>Archive this record?</p>
+ <button onClick={handleArchive}>Archive</button>
+ </div>
+ );
+};
+
+export default defineFrontComponent({
+ universalIdentifier: 'c9d0e1f2-a3b4-5678-cdef-789012345678',
+ name: 'archive-record',
+ description: 'Archives the current record',
+ component: ArchiveRecord,
+});
+```
+
+### Práce s více záznamy
+
+Použijte `useSelectedRecordIds()` pro zpracování více vybraných záznamů. To je užitečné pro hromadné operace:
+
+```tsx src/front-components/bulk-export.tsx
+import { defineFrontComponent, numberOfSelectedRecords } from 'twenty-sdk/define';
+import { useSelectedRecordIds } from 'twenty-sdk/front-component';
+import { enqueueSnackbar, closeSidePanel } from 'twenty-sdk/front-component';
+import { CoreApiClient } from 'twenty-sdk/clients';
+
+const BulkExport = () => {
+ const selectedRecordIds = useSelectedRecordIds();
+
+ const handleExport = async () => {
+ const client = new CoreApiClient();
+
+ for (const recordId of selectedRecordIds) {
+ await client.mutation({
+ updateTask: {
+ __args: { id: recordId, data: { exported: true } },
+ id: true,
+ },
+ });
+ }
+
+ await enqueueSnackbar({
+ message: `Exported ${selectedRecordIds.length} records`,
+ variant: 'success',
+ });
+
+ await closeSidePanel();
+ };
+
+ return (
+ <div style={{ padding: '20px' }}>
+ <p>Export {selectedRecordIds.length} selected record(s)?</p>
+ <button onClick={handleExport}>Export</button>
+ </div>
+ );
+};
+
+export default defineFrontComponent({
+ universalIdentifier: 'd0e1f2a3-b4c5-6789-defa-012345678901',
+ name: 'bulk-export',
+ description: 'Export selected records',
+ component: BulkExport,
+ command: {
+ universalIdentifier: 'd0e1f2a3-b4c5-6789-defa-012345678902',
+ label: 'Bulk Export',
+ availabilityType: 'RECORD_SELECTION',
+ conditionalAvailabilityExpression: numberOfSelectedRecords > 0,
+ },
+});
+```
+
+## Veřejné soubory
+
+Frontendové komponenty mohou přistupovat k souborům ze složky aplikace `public/` pomocí `getPublicAssetUrl`:
+
+```tsx
+import { defineFrontComponent } from 'twenty-sdk/define';
+import { getPublicAssetUrl } from 'twenty-sdk/utils';
+
+const Logo = () => <img src={getPublicAssetUrl('logo.png')} alt="Logo" />;
+
+export default defineFrontComponent({
+ universalIdentifier: '...',
+ name: 'logo',
+ component: Logo,
+});
+```
+
+Podrobnosti viz [sekci veřejných souborů](/l/cs/developers/extend/apps/config/public-assets).
+
+## Stylování
+
+Frontendové komponenty podporují více přístupů ke stylování. Můžete použít:
+
+* **Inline styly** — `style={{ color: 'red' }}`
+* **Komponenty Twenty UI** — import z `twenty-sdk/ui` (Button, Tag, Status, Chip, Avatar a další)
+* **Emotion** — CSS-in-JS s `@emotion/react`
+* **Styled-components** — vzory `styled.div`
+* **Tailwind CSS** — utilitní třídy
+* **Jakákoli CSS-in-JS knihovna** kompatibilní s Reactem
+
+```tsx
+import { defineFrontComponent } from 'twenty-sdk/define';
+import { Button, Tag, Status } from 'twenty-sdk/ui';
+
+const StyledWidget = () => {
+ return (
+ <div style={{ padding: '16px', display: 'flex', gap: '8px' }}>
+ <Button title="Click me" onClick={() => alert('Clicked!')} />
+ <Tag text="Active" color="green" />
+ <Status color="green" text="Online" />
+ </div>
+ );
+};
+
+export default defineFrontComponent({
+ universalIdentifier: 'e5f6a7b8-c9d0-1234-efab-567890123456',
+ name: 'styled-widget',
+ component: StyledWidget,
+});
+```
diff --git a/packages/twenty-docs/l/cs/developers/extend/apps/layout/navigation-menu-items.mdx b/packages/twenty-docs/l/cs/developers/extend/apps/layout/navigation-menu-items.mdx
new file mode 100644
index 00000000000..13e713a1057
--- /dev/null
+++ b/packages/twenty-docs/l/cs/developers/extend/apps/layout/navigation-menu-items.mdx
@@ -0,0 +1,44 @@
+---
+title: Položky navigační nabídky
+description: Přidejte vlastní položky do postranního panelu pracovního prostoru — odkazy na uložená zobrazení nebo externí adresy URL.
+icon: bars
+---
+
+**Položka navigační nabídky** je položka v levém postranním panelu. Použijte `defineNavigationMenuItem()` k přidání vlastních odkazů do postranního panelu — obvykle jeden pro každé [zobrazení](/l/cs/developers/extend/apps/layout/views), které dodáváte — nebo pro odkaz na externí adresy URL.
+
+```ts src/navigation-menu-items/example-navigation-menu-item.ts
+import { defineNavigationMenuItem, NavigationMenuItemType } from 'twenty-sdk/define';
+import { EXAMPLE_VIEW_UNIVERSAL_IDENTIFIER } from '../views/example-view';
+
+export default defineNavigationMenuItem({
+ universalIdentifier: '9327db91-afa1-41b6-bd9d-2b51a26efb4c',
+ name: 'example-navigation-menu-item',
+ icon: 'IconList',
+ color: 'blue',
+ position: 0,
+ type: NavigationMenuItemType.VIEW,
+ viewUniversalIdentifier: EXAMPLE_VIEW_UNIVERSAL_IDENTIFIER,
+});
+```
+
+## Hlavní body
+
+* `type` určuje, na co položka nabídky odkazuje. Každý typ je spárován s konkrétním identifikačním polem:
+
+ | Typ | K čemu slouží | Povinné pole |
+ | ------------------------------------ | ---------------------------------------- | ------------------------------------------------------------------------------------------- |
+ | `NavigationMenuItemType.VIEW` | Otevře uložené zobrazení | `viewUniversalIdentifier` |
+ | `NavigationMenuItemType.LINK` | Otevře externí adresu URL | `link` |
+ | `NavigationMenuItemType.FOLDER` | Seskupuje vnořené položky pod štítkem | `name` (a podřízené položky odkazují na složku prostřednictvím `folderUniversalIdentifier`) |
+ | `NavigationMenuItemType.OBJECT` | Otevře výchozí indexovou stránku objektu | `targetObjectUniversalIdentifier` |
+ | `NavigationMenuItemType.PAGE_LAYOUT` | Otevře samostatné rozvržení stránky | `pageLayoutUniversalIdentifier` |
+
+* `position` určuje pořadí v postranním panelu.
+
+* `icon` a `color` jsou volitelné a upravují, jak položka vypadá.
+
+* `folderUniversalIdentifier` je k dispozici také na libovolné položce, aby ji bylo možné vložit do nadřazené položky typu `FOLDER`.
+
+<Note>
+**Častý problém:** vytvoření objektu bez souvisejícího zobrazení a položky navigační nabídky způsobí, že je tento objekt pro uživatele neviditelný. Pokud nejde o technický/interní objekt, měl by mít každý vlastní objekt výchozí zobrazení *a* položku v postranním panelu, která na něj odkazuje.
+</Note>
diff --git a/packages/twenty-docs/l/cs/developers/extend/apps/layout/overview.mdx b/packages/twenty-docs/l/cs/developers/extend/apps/layout/overview.mdx
new file mode 100644
index 00000000000..3070c3f96ff
--- /dev/null
+++ b/packages/twenty-docs/l/cs/developers/extend/apps/layout/overview.mdx
@@ -0,0 +1,56 @@
+---
+title: Přehled
+description: Umístěte svou aplikaci do uživatelského rozhraní Twenty – položky v postranním panelu, uložená zobrazení, karty na stránce záznamu a sandboxované komponenty Reactu.
+icon: table-columns
+---
+
+**Vrstva rozvržení** aplikace Twenty zahrnuje vše, co uživatel vidí: kde se aplikace zobrazuje v postranním panelu, jaká seznamová zobrazení obsahuje, jak jsou uspořádány její stránky s podrobnostmi záznamů a které vlastní komponenty Reactu se na těchto stránkách vykreslují.
+
+```text
+ Sidebar Record list Record detail page
+ ─────── ─────────── ──────────────────
+ [📋 My View] ────▶ ┌──────────┐ ┌─────────────────────┐
+ [📋 Drafts ] │ Companies│ │ Tabs: [Overview ] │
+ [📋 Inbox ] │ ──────── │ │ [Notes ] │
+ ▲ │ Apple │ │ [Hello ]◀──── definePageLayoutTab
+ │ │ Acme │ │ │ adds a tab...
+ └ defineNavi- │ … │ │ ┌────────────────┐ │
+ gationMenu- └────▲─────┘ │ │ │ │
+ Item points │ │ │ React UI │◀── …with a
+ to a defineView │ │ │ (sandboxed in │ │ defineFrontComponent
+ └ defineView │ │ a Worker) │ │ widget inside
+ picks columns │ └────────────────┘ │
+ and filters └─────────────────────┘
+```
+
+## V této části
+
+<CardGroup cols={2}>
+ <Card title="Zobrazení" icon="list" href="/l/cs/developers/extend/apps/layout/views">
+ `defineView` — uložené konfigurace seznamu: viditelné sloupce, filtry, skupiny.
+ </Card>
+ <Card title="Položky navigační nabídky" icon="bars" href="/l/cs/developers/extend/apps/layout/navigation-menu-items">
+ `defineNavigationMenuItem` — položky v postranním panelu odkazující na zobrazení nebo externí adresy URL.
+ </Card>
+ <Card title="Rozvržení stránek" icon="table-columns" href="/l/cs/developers/extend/apps/layout/page-layouts">
+ `definePageLayout` a `definePageLayoutTab` — karty a widgety na stránce s podrobnostmi záznamu.
+ </Card>
+ <Card title="Frontendové komponenty" icon="window-maximize" href="/l/cs/developers/extend/apps/layout/front-components">
+ `defineFrontComponent` — sandboxované komponenty Reactu, které se vykreslují uvnitř Twenty.
+ </Card>
+ <Card title="Položky příkazové nabídky" icon="terminal" href="/l/cs/developers/extend/apps/layout/command-menu-items">
+ `defineCommandMenuItem` — zaregistruje frontendové komponenty jako položky Cmd+K a rychlé akce.
+ </Card>
+</CardGroup>
+
+## Kde se aplikace zobrazuje
+
+| Umístění | Co řídí | Entita |
+| --------------------------------------- | ------------------------------------------------------------------------------- | ----------------------------------------- |
+| **Postranní panel** | Vlastní položka odkazující na uložené zobrazení nebo externí adresu URL | `defineNavigationMenuItem` |
+| **Seznam záznamů** | Uložené nastavení pro objekt — viditelné sloupce, pořadí, filtry, skupiny | `defineView` |
+| **Stránka s podrobnostmi záznamu** | Karty a widgety na stránce záznamu (vašeho vlastního objektu nebo standardního) | `definePageLayout`, `definePageLayoutTab` |
+| **Uvnitř kteréhokoli z výše uvedených** | Vlastní widget Reactu — tlačítka, formuláře, přehledové panely, integrace | `defineFrontComponent` |
+| **Příkazová nabídka (Cmd+K)** | Připnutá rychlá akce nebo skrytý příkaz | `defineCommandMenuItem` |
+
+Frontendové komponenty běží uvnitř izolovaného Web Workeru pomocí Remote DOM — vykreslují se na stránce nativně (ne uvnitř iframe), ale nemají přímý přístup k hostitelské stránce ani DOM. Komunikace s Twenty probíhá prostřednictvím hostitelského API pro předávání zpráv.
diff --git a/packages/twenty-docs/l/cs/developers/extend/apps/layout/page-layouts.mdx b/packages/twenty-docs/l/cs/developers/extend/apps/layout/page-layouts.mdx
new file mode 100644
index 00000000000..5b1e284d805
--- /dev/null
+++ b/packages/twenty-docs/l/cs/developers/extend/apps/layout/page-layouts.mdx
@@ -0,0 +1,132 @@
+---
+title: Rozvržení stránek
+description: Přizpůsobte stránky s detailem záznamu – karty, widgety a místa, kde se vykreslují frontendové komponenty – pomocí `definePageLayout` a `definePageLayoutTab`.
+icon: table-columns
+---
+
+**Rozvržení stránky** určuje, jak je uspořádána stránka s detailem záznamu: které karty se zobrazí a jaké widgety obsahují. Použijte `definePageLayout()` k deklaraci rozvržení pro objekt, který vlastníte, nebo `definePageLayoutTab()` k přidání jedné karty do rozvržení, které již existuje (vašeho nebo standardního rozvržení Twenty).
+
+| Případ použití | Entita |
+| ----------------------------------------------------------------------------------------------------------- | --------------------- |
+| Definujte celé rozvržení pro stránku záznamu u objektu, který vlastníte | `definePageLayout` |
+| Přidejte jednu kartu do existujícího rozvržení (k rozvržení vašeho vlastního objektu nebo ke standardnímu). | `definePageLayoutTab` |
+
+## definePageLayout
+
+Použijte to, když vlastníte celou stránku s detailem záznamu – typicky pro vlastní objekt, který jste si definovali sami.
+
+```ts src/page-layouts/example-record-page-layout.ts
+import { definePageLayout, PageLayoutTabLayoutMode } from 'twenty-sdk/define';
+import { EXAMPLE_OBJECT_UNIVERSAL_IDENTIFIER } from '../objects/example-object';
+import { HELLO_WORLD_FRONT_COMPONENT_UNIVERSAL_IDENTIFIER } from '../front-components/hello-world';
+
+export default definePageLayout({
+ universalIdentifier: '203aeb94-6701-46d6-9af1-be2bbcc9e134',
+ name: 'Example Record Page',
+ type: 'RECORD_PAGE',
+ objectUniversalIdentifier: EXAMPLE_OBJECT_UNIVERSAL_IDENTIFIER,
+ tabs: [
+ {
+ universalIdentifier: '6ed26b60-a51d-4ad7-86dd-1c04c7f3cac5',
+ title: 'Hello World',
+ position: 50,
+ icon: 'IconWorld',
+ layoutMode: PageLayoutTabLayoutMode.CANVAS,
+ widgets: [
+ {
+ universalIdentifier: 'aa4234e0-2e5f-4c02-a96a-573449e2351d',
+ title: 'Hello World',
+ type: 'FRONT_COMPONENT',
+ configuration: {
+ configurationType: 'FRONT_COMPONENT',
+ frontComponentUniversalIdentifier:
+ HELLO_WORLD_FRONT_COMPONENT_UNIVERSAL_IDENTIFIER,
+ },
+ },
+ ],
+ },
+ ],
+});
+```
+
+### Hlavní body
+
+* `type` je obvykle `'RECORD_PAGE'` pro úpravu detailního zobrazení konkrétního objektu.
+* `objectUniversalIdentifier` určuje, na který objekt se toto rozvržení vztahuje.
+* Každá `tab` definuje sekci stránky s `title`, `position` a `layoutMode` (`CANVAS` pro volné rozvržení).
+* Každý `widget` uvnitř karty může vykreslit [front component](/l/cs/developers/extend/apps/layout/front-components), seznam relací nebo jiné vestavěné typy widgetů.
+* `position` na kartách určuje jejich pořadí. Použijte vyšší hodnoty (např. 50) pro umístění vlastních karet za vestavěné.
+
+## definePageLayoutTab
+
+Použijte to, když chcete do existujícího rozvržení pouze **přidat** kartu – například kartu analytiky na standardní stránce Company nebo kartu se souhrnem AI připojenou k rozvržení vašeho vlastního objektu.
+
+```ts src/page-layouts/example-extra-tab.ts
+import {
+ definePageLayoutTab,
+ PageLayoutTabLayoutMode,
+ STANDARD_PAGE_LAYOUT_UNIVERSAL_IDENTIFIERS,
+} from 'twenty-sdk/define';
+import { HELLO_WORLD_FRONT_COMPONENT_UNIVERSAL_IDENTIFIER } from '../front-components/hello-world';
+
+export default definePageLayoutTab({
+ universalIdentifier: 'b1b2b3b4-b5b6-4000-8000-000000000001',
+ pageLayoutUniversalIdentifier:
+ STANDARD_PAGE_LAYOUT_UNIVERSAL_IDENTIFIERS.companyRecordPage
+ .universalIdentifier,
+ title: 'Hello World',
+ position: 1000,
+ icon: 'IconWorld',
+ layoutMode: PageLayoutTabLayoutMode.CANVAS,
+ widgets: [
+ {
+ universalIdentifier: 'b1b2b3b4-b5b6-4000-8000-000000000002',
+ title: 'Hello World',
+ type: 'FRONT_COMPONENT',
+ configuration: {
+ configurationType: 'FRONT_COMPONENT',
+ frontComponentUniversalIdentifier:
+ HELLO_WORLD_FRONT_COMPONENT_UNIVERSAL_IDENTIFIER,
+ },
+ },
+ ],
+});
+```
+
+### Hlavní body
+
+* `pageLayoutUniversalIdentifier` je **povinný** a musí odkazovat na rozvržení stránky, které již existuje v době instalace – buď na standardní rozvržení Twenty, nebo na rozvržení definované vaší vlastní aplikací. Meziaplikační odkazy na rozvržení ve vlastnictví jiné nainstalované aplikace nejsou v současnosti podporovány. Když nadřazené rozvržení chybí, instalace selže s jasnou validační chybou.
+
+* Pro standardní rozvržení Twenty importujte identifikátory z `twenty-sdk/define`:
+
+ ```ts
+ import { STANDARD_PAGE_LAYOUT_UNIVERSAL_IDENTIFIERS } from 'twenty-sdk/define';
+
+ // STANDARD_PAGE_LAYOUT_UNIVERSAL_IDENTIFIERS.companyRecordPage.universalIdentifier
+ // STANDARD_PAGE_LAYOUT_UNIVERSAL_IDENTIFIERS.personRecordPage.universalIdentifier
+ // STANDARD_PAGE_LAYOUT_UNIVERSAL_IDENTIFIERS.taskRecordPage.universalIdentifier
+ // STANDARD_PAGE_LAYOUT_UNIVERSAL_IDENTIFIERS.opportunityRecordPage.universalIdentifier
+ // STANDARD_PAGE_LAYOUT_UNIVERSAL_IDENTIFIERS.noteRecordPage.universalIdentifier
+ // …
+ ```
+
+ Každá položka rozvržení také zpřístupňuje své `tabs` a jejich `widgets`, takže můžete odkazovat na libovolnou úroveň:
+
+ ```ts
+ STANDARD_PAGE_LAYOUT_UNIVERSAL_IDENTIFIERS.taskRecordPage.tabs.home.universalIdentifier
+ STANDARD_PAGE_LAYOUT_UNIVERSAL_IDENTIFIERS.taskRecordPage.tabs.home.widgets.fields.universalIdentifier
+ ```
+
+ K dispozici je také krátký alias `STANDARD_PAGE_LAYOUT`:
+
+ ```ts
+ import { STANDARD_PAGE_LAYOUT } from 'twenty-sdk/define';
+
+ STANDARD_PAGE_LAYOUT.companyRecordPage.universalIdentifier;
+ ```
+
+* `widgets` mají rozsah pouze pro tuto kartu – odkazují na [front components](/l/cs/developers/extend/apps/layout/front-components), zobrazení apod. úplně stejně jako widgety definované přímo v `definePageLayout`.
+
+* `position` určuje pořadí vzhledem ke stávajícím kartám v cílovém rozvržení. Zvolte hodnotu, která umístí vaši kartu tam, kde ji chcete mít, relativně k vestavěným kartám.
+
+* Použijte to místo `definePageLayout`, když chcete do existujícího rozvržení pouze přidat. Použijte `definePageLayout`, když vlastníte celé rozvržení.
diff --git a/packages/twenty-docs/l/cs/developers/extend/apps/layout/views.mdx b/packages/twenty-docs/l/cs/developers/extend/apps/layout/views.mdx
new file mode 100644
index 00000000000..9eb73842588
--- /dev/null
+++ b/packages/twenty-docs/l/cs/developers/extend/apps/layout/views.mdx
@@ -0,0 +1,97 @@
+---
+title: Zobrazení
+description: Dodávejte předem nakonfigurovaná uložená zobrazení – pořadí sloupců, filtry, seskupení – pro objekty ve své aplikaci.
+icon: list
+---
+
+**Zobrazení** je uložená konfigurace toho, jak se zobrazují záznamy objektu: která pole se zobrazují, v jakém pořadí, zda jsou viditelná a jaké filtry nebo seskupení jsou použity. Pomocí `defineView()` můžete s aplikací dodávat předem nakonfigurovaná zobrazení – obvykle výchozí indexové zobrazení pro každý vlastní objekt, který vytvoříte.
+
+```ts src/views/example-view.ts
+import { defineView, ViewKey } from 'twenty-sdk/define';
+import { EXAMPLE_OBJECT_UNIVERSAL_IDENTIFIER } from '../objects/example-object';
+import { NAME_FIELD_UNIVERSAL_IDENTIFIER } from '../objects/example-object';
+
+export default defineView({
+ universalIdentifier: 'a1b2c3d4-e5f6-7890-abcd-ef1234567890',
+ name: 'All example items',
+ objectUniversalIdentifier: EXAMPLE_OBJECT_UNIVERSAL_IDENTIFIER,
+ icon: 'IconList',
+ key: ViewKey.INDEX,
+ position: 0,
+ fields: [
+ {
+ universalIdentifier: 'f926bdb7-6af7-4683-9a09-adbca56c29f0',
+ fieldMetadataUniversalIdentifier: NAME_FIELD_UNIVERSAL_IDENTIFIER,
+ position: 0,
+ isVisible: true,
+ size: 200,
+ },
+ ],
+});
+```
+
+## Hlavní body
+
+* `objectUniversalIdentifier` určuje, na který objekt se toto zobrazení vztahuje. Může to být vlastní objekt, který jste definovali, nebo standardní objekt Twenty.
+* `key` určuje typ zobrazení — `ViewKey.INDEX` je hlavní seznamové zobrazení pro daný objekt.
+* `fields` určuje, které sloupce se zobrazí a v jakém pořadí. Každé pole odkazuje na `fieldMetadataUniversalIdentifier`.
+* Pro pokročilé konfigurace můžete také deklarovat `filters`, `filterGroups`, `groups` a `fieldGroups`.
+* `position` určuje pořadí, pokud pro stejný objekt existuje více zobrazení.
+
+## Filtry
+
+Zobrazení může být dodáno s předem aplikovanými filtry. Každý filtr má tři souřadnice: **pole**, které se filtruje, **operand** (jak porovnávat) a **hodnotu** (proti čemu porovnávat). Všechny tři musí být v souladu — použití operandu, který se nehodí k typu pole, bude při synchronizaci odmítnuto.
+
+```ts
+import { ViewFilterOperand } from 'twenty-shared/types';
+
+filters: [
+ {
+ universalIdentifier: '...',
+ fieldMetadataUniversalIdentifier: STATUS_FIELD_UNIVERSAL_IDENTIFIER,
+ operand: ViewFilterOperand.IS,
+ value: ['ACTIVE'],
+ },
+],
+```
+
+### Podporované operandy podle typu pole
+
+| Typ pole | Podporované operandy |
+| -------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------ |
+| `TEXT`, `EMAILS`, `FULL_NAME`, `ADDRESS`, `LINKS`, `PHONES`, `RAW_JSON`, `FILES`, `ACTOR`, `ARRAY` | `CONTAINS`, `DOES_NOT_CONTAIN`, `IS_EMPTY`, `IS_NOT_EMPTY` |
+| `ACTOR.source`, `ACTOR.workspaceMemberId` | `IS`, `IS_NOT`, `IS_EMPTY`, `IS_NOT_EMPTY` |
+| `SELECT` | `IS`, `IS_NOT`, `IS_EMPTY`, `IS_NOT_EMPTY` |
+| `MULTI_SELECT` | `CONTAINS`, `DOES_NOT_CONTAIN`, `IS_EMPTY`, `IS_NOT_EMPTY` |
+| `RELATION` | `IS`, `IS_NOT`, `IS_EMPTY`, `IS_NOT_EMPTY` |
+| `NUMBER` | `IS`, `IS_NOT`, `GREATER_THAN_OR_EQUAL`, `LESS_THAN_OR_EQUAL`, `IS_EMPTY`, `IS_NOT_EMPTY` |
+| `RATING` | `IS`, `GREATER_THAN_OR_EQUAL`, `LESS_THAN_OR_EQUAL`, `IS_EMPTY`, `IS_NOT_EMPTY` |
+| `CURRENCY`, `CURRENCY.amountMicros` | `GREATER_THAN_OR_EQUAL`, `LESS_THAN_OR_EQUAL`, `IS`, `IS_NOT`, `IS_EMPTY`, `IS_NOT_EMPTY` |
+| `CURRENCY.currencyCode` | `IS`, `IS_NOT`, `IS_EMPTY`, `IS_NOT_EMPTY` |
+| `DATE`, `DATE_TIME` | `IS`, `IS_RELATIVE`, `IS_IN_PAST`, `IS_IN_FUTURE`, `IS_TODAY`, `IS_BEFORE`, `IS_AFTER`, `IS_EMPTY`, `IS_NOT_EMPTY` |
+| `BOOLEAN` | `IS` |
+| `UUID` | `IS`, `IS_NOT`, `IS_EMPTY`, `IS_NOT_EMPTY` |
+| `TS_VECTOR` | `VECTOR_SEARCH` |
+
+> Typy polí s podobnými názvy mohou používat zcela odlišné operandy — běžným případem jsou `SELECT` a `MULTI_SELECT`.
+
+### Tvar hodnoty podle operandu
+
+Pole `value` je vždy hodnota serializovatelná do JSON, ale její očekávaný tvar závisí na operandu:
+
+| Skupina operandů | Tvar hodnoty | Příklad |
+| --------------------------------------------------------------------- | ----------------------------- | ------------------------ |
+| `IS`, `IS_NOT` na `SELECT` | pole klíčů možností (řetězce) | `['ACTIVE', 'PENDING']` |
+| `CONTAINS`, `DOES_NOT_CONTAIN` na `MULTI_SELECT` | pole klíčů možností (řetězce) | `['TAG_A']` |
+| `IS`, `IS_NOT` na `RELATION` | pole ID záznamů (uuid) | `['c5a1...']` |
+| `CONTAINS`, `DOES_NOT_CONTAIN` na textových polích a podobných typech | textový řetězec | `'acme'` |
+| `IS`, `IS_NOT` na `NUMBER` | řetězec (hodnota) | `'5'` |
+| `IS` na `RATING` / `UUID` | řetězec (hodnota) | `'5'` |
+| `GREATER_THAN_OR_EQUAL`, `LESS_THAN_OR_EQUAL` | řetězec (mezní hodnota) | `'10'` |
+| `IS`, `IS_BEFORE`, `IS_AFTER` na `DATE` / `DATE_TIME` | řetězec ve formátu ISO 8601 | `'2025-01-01T00:00:00Z'` |
+| `IS_EMPTY`, `IS_NOT_EMPTY` | prázdný řetězec | `''` |
+| `IS` na `BOOLEAN` | `'true'` nebo `'false'` | `'true'` |
+
+## Jak se zobrazení objevují v uživatelském rozhraní
+
+Samotné zobrazení není z postranního panelu dostupné. Aby se tam zobrazilo, spárujte ho s [položkou navigačního menu](/l/cs/developers/extend/apps/layout/navigation-menu-items) typu `VIEW`, která odkazuje na `universalIdentifier` daného zobrazení. To je kanonický vzor: každý vlastní objekt obvykle dodává výchozí zobrazení + položku v postranním panelu, která ho otevírá.
diff --git a/packages/twenty-docs/l/cs/developers/extend/apps/logic/connections.mdx b/packages/twenty-docs/l/cs/developers/extend/apps/logic/connections.mdx
new file mode 100644
index 00000000000..48840d4a0e7
--- /dev/null
+++ b/packages/twenty-docs/l/cs/developers/extend/apps/logic/connections.mdx
@@ -0,0 +1,192 @@
+---
+title: Připojení
+description: Umožněte své aplikaci jednat jménem uživatele ve službách třetích stran prostřednictvím OAuth.
+icon: plug
+---
+
+Připojení jsou pověření, která uživatel uchovává pro externí službu (Linear, GitHub, Slack, ...). Vaše aplikace deklaruje, **jak** se tato pověření získávají — **poskytovatel připojení** — a za běhu je používá k provádění ověřených volání na rozhraní API třetí strany.
+
+V současnosti je podporován pouze OAuth 2.0. Budoucí typy pověření (osobní přístupové tokeny, klíče API, základní autentizace) se připojí ke stejnému rozhraní — aplikace, které již používají `defineConnectionProvider({ type: 'oauth', ... })` nebudou muset migrovat.
+
+<AccordionGroup>
+
+<Accordion title="defineConnectionProvider" description="Definujte, jak vaše aplikace získává připojení">
+
+Poskytovatel připojení popisuje OAuth handshake, který vaše aplikace potřebuje. Uživatel klikne v nastavení vaší aplikace na "Přidat připojení", projde souhlasovou obrazovkou poskytovatele a v jeho pracovním prostoru se vytvoří řádek `ConnectedAccount`.
+
+Funkční nastavení vyžaduje **dva soubory** — poskytovatele připojení a odpovídající deklaraci `serverVariables` v `defineApplication`, která obsahuje klientská pověření OAuth.
+
+```ts src/connection-providers/linear-connection.ts
+import { defineConnectionProvider } from 'twenty-sdk/define';
+
+export default defineConnectionProvider({
+ universalIdentifier: '9c7d1f5e-6a0b-4d44-be0c-3f8b5a9d4e6f',
+ name: 'linear',
+ displayName: 'Linear',
+ icon: 'IconBrandLinear',
+ type: 'oauth',
+ oauth: {
+ authorizationEndpoint: 'https://linear.app/oauth/authorize',
+ tokenEndpoint: 'https://api.linear.app/oauth/token',
+ scopes: ['read', 'write'],
+ // These must match keys in `defineApplication.serverVariables` below.
+ clientIdVariable: 'LINEAR_CLIENT_ID',
+ clientSecretVariable: 'LINEAR_CLIENT_SECRET',
+ // Optional: defaults to 'json'. Some providers (Linear, Slack) want
+ // 'form-urlencoded' for the token request.
+ tokenRequestContentType: 'form-urlencoded',
+ // Optional: defaults to true. Disable only if the provider rejects PKCE.
+ usePkce: false,
+ // Optional: extra query params on the authorize URL.
+ // authorizationParams: { prompt: 'consent' },
+ // Optional: provider's RFC 7009 token revocation endpoint, called on disconnect.
+ // revokeEndpoint: 'https://example.com/oauth/revoke',
+ },
+});
+```
+
+```ts src/application.config.ts
+import { defineApplication } from 'twenty-sdk/define';
+
+export default defineApplication({
+ universalIdentifier: '...',
+ displayName: 'Linear',
+ description: 'Connect Linear to Twenty.',
+ // OAuth client credentials live on the app registration (one OAuth app per
+ // Twenty server, configured by the admin) — not per-workspace. Declare them
+ // as serverVariables so the admin can fill them in once for all installs.
+ serverVariables: {
+ LINEAR_CLIENT_ID: {
+ description: 'OAuth client ID from your Linear OAuth application.',
+ isSecret: false,
+ isRequired: true,
+ },
+ LINEAR_CLIENT_SECRET: {
+ description: 'OAuth client secret from your Linear OAuth application.',
+ isSecret: true,
+ isRequired: true,
+ },
+ },
+});
+```
+
+Hlavní body:
+
+* `name` je jedinečný identifikátor (řetězec) používaný v `listConnections({ providerName })` (kebab-case, musí odpovídat `^[a-z][a-z0-9-]*$`).
+* `displayName` se zobrazuje na kartě nastavení jednotlivé aplikace a v seznamu nástrojů AI.
+* `clientIdVariable` / `clientSecretVariable` jsou názvy, ne hodnoty — musí odpovídat klíčům deklarovaným v `defineApplication.serverVariables`. Skutečné `client_id` a `client_secret` zadává správce serveru prostřednictvím rozhraní pro registraci aplikace, nikdy se necommitují do vašeho repozitáře.
+* Použijte `serverVariables` (nikoli `applicationVariables`) — pověření OAuth jsou celoserverová a na jeden server Twenty je jedna aplikace OAuth.
+* Dokud nejsou vyplněny obě `serverVariables`, karta nastavení aplikace zobrazuje nápovědu "vyžaduje správce serveru" a tlačítko "Přidat připojení" je zakázané.
+* `type: 'oauth'` je dnes jediná podporovaná hodnota. Rozlišovač je kompatibilní do budoucna: budoucí typy (`'pat'`, `'api-key'`, ...) přidají nové podbloky konfigurace vedle `oauth`.
+
+URL zpětného volání OAuth, kterou musí váš poskytovatel zařadit na seznam povolených, je:
+
+```
+https://<your-twenty-server>/auth/apps/callback
+```
+
+</Accordion>
+
+<Accordion title="listConnections / getConnection" description="Použijte připojení z logické funkce">
+
+Uvnitř handleru logické funkce vrací `listConnections({ providerName })` řádky `ConnectedAccount` této aplikace pro daného poskytovatele s obnovenými přístupovými tokeny.
+
+```ts src/logic-functions/handlers/create-linear-issue-handler.ts
+import { listConnections } from 'twenty-sdk/logic-function';
+
+export const createLinearIssueHandler = async (input: {
+ teamId?: string;
+ title?: string;
+}) => {
+ if (!input.teamId || !input.title) {
+ return { success: false, error: 'teamId and title are required' };
+ }
+
+ const connections = await listConnections({ providerName: 'linear' });
+
+ // Workspace-shared credentials win when present; fall back to the first
+ // user-visibility one. For HTTP-route triggers you typically pick the
+ // request user's connection via event.userWorkspaceId instead.
+ const connection =
+ connections.find((c) => c.visibility === 'workspace') ?? connections[0];
+
+ if (!connection) {
+ return {
+ success: false,
+ error:
+ 'Linear is not connected. Open the app settings and click "Add connection".',
+ };
+ }
+
+ // Use connection.accessToken to call the third-party API.
+ const response = await fetch('https://api.linear.app/graphql', {
+ method: 'POST',
+ headers: {
+ Authorization: `Bearer ${connection.accessToken}`,
+ 'Content-Type': 'application/json',
+ },
+ body: JSON.stringify({
+ query: `mutation { issueCreate(input: { teamId: "${input.teamId}", title: "${input.title}" }) { success } }`,
+ }),
+ });
+
+ return { success: response.ok };
+};
+```
+
+Každé připojení má:
+
+| Pole | Popis |
+| ----------------- | ---------------------------------------------------------------------------------------------------------- |
+| `id` | Jedinečné ID řádku; předejte do `getConnection(id)` pro opětovné načtení jednoho záznamu |
+| `visibility` | `'user'` (soukromé pro jednoho člena pracovního prostoru) nebo `'workspace'` (sdílené se všemi členy) |
+| `scopes` | Oprávnění OAuth udělená poskytovatelem (odlišná od `visibility` — ty spolu nesouvisejí) |
+| `userWorkspaceId` | ID `userWorkspace` vlastníka — užitečné pro výběr "připojení uživatele požadavku" ve spouštěčích tras HTTP |
+| `accessToken` | Aktuální přístupový token OAuth (v případě vypršení je automaticky obnoven) |
+| `name` / `handle` | Zobrazovaný název připojení (automaticky odvozený při OAuth callbacku, uživatelem přejmenovatelný) |
+| `authFailedAt` | Nastaveno, když poslední obnovení selhalo; uživatel se musí znovu připojit |
+
+Hlavní body:
+
+* Předejte `{ providerName }` pro filtrování podle poskytovatele; vynechejte jej, chcete-li získat všechna připojení, která tato aplikace vlastní napříč všemi poskytovateli.
+* Server před vrácením výsledku transparentně obnoví přístupový token. Váš handler vždy uvidí použitelný token (nebo nastavené `authFailedAt`).
+* `getConnection(id)` je jednořádkový ekvivalent.
+
+</Accordion>
+
+<Accordion title="Viditelnost pro jednotlivce vs. sdílená v pracovním prostoru" description="Jak si uživatelé vybírají mezi soukromými a sdílenými pověřeními">
+
+Když uživatel klikne na "Přidat připojení", je vyzván k výběru viditelnosti:
+
+* **Jen pro mě** — pověření je soukromé pro připojujícího se uživatele. Jakákoli logická funkce volaná jejich jménem (spouštěč HTTP trasy s `isAuthRequired: true`) jej uvidí; spouštěče cron a události databáze nikoli.
+* **Sdíleno v pracovním prostoru** — jakýkoli člen pracovního prostoru může pověření použít. Spouštěče cron/databáze jej také uvidí, protože nemají žádného uživatele požadavku.
+
+Pro každý handler použijte tu správnou variantu:
+
+```ts
+// HTTP-route trigger — prefer the request user's own connection.
+const conn =
+ connections.find((c) => c.userWorkspaceId === event.userWorkspaceId) ??
+ connections.find((c) => c.visibility === 'workspace');
+
+// Cron trigger — no request user; only shared credentials are sensible.
+const conn = connections.find((c) => c.visibility === 'workspace');
+```
+
+Více připojení na (uživatele, poskytovatele) je povoleno, takže tentýž uživatel může mít vedle sebe "Personal Linear" a "Work Linear".
+
+</Accordion>
+
+<Accordion title="Jednorázové nastavení poskytovatele" description="Zaregistrujte svou aplikaci OAuth u služby třetí strany">
+
+Pro každého poskytovatele připojení musí správce serveru nejprve zaregistrovat u třetí strany aplikaci OAuth.
+
+1. Přejděte do vývojářského nastavení poskytovatele (např. https://linear.app/settings/api/applications/new).
+2. Nastavte **Redirect URI** na `\<SERVER_URL>/auth/apps/callback`.
+3. Zkopírujte vygenerované **Client ID** a **Client Secret**.
+4. Otevřete nainstalovanou aplikaci v Twenty jako správce serveru → nastavte hodnoty na odpovídajících `serverVariables`.
+5. Členové pracovního prostoru pak mohou přidávat připojení v sekci aplikace **Připojení**.
+
+</Accordion>
+
+</AccordionGroup>
diff --git a/packages/twenty-docs/l/cs/developers/extend/apps/logic/logic-functions.mdx b/packages/twenty-docs/l/cs/developers/extend/apps/logic/logic-functions.mdx
new file mode 100644
index 00000000000..8d296f03cd4
--- /dev/null
+++ b/packages/twenty-docs/l/cs/developers/extend/apps/logic/logic-functions.mdx
@@ -0,0 +1,515 @@
+---
+title: Logické funkce
+description: Definujte serverové funkce v TypeScriptu se spouštěči pro HTTP, cron a databázové události.
+icon: bolt
+---
+
+Logické funkce jsou serverové funkce v TypeScriptu, které běží na platformě Twenty. Mohou být spouštěny požadavky HTTP, plány cronu nebo databázovými událostmi — a lze je také zpřístupnit jako nástroje pro agenty AI.
+
+<AccordionGroup>
+<Accordion title="defineLogicFunction" description="Definujte logické funkce a jejich spouštěče">
+
+Každý soubor funkce používá `defineLogicFunction()` k exportu konfigurace s obslužnou funkcí (handlerem) a volitelnými spouštěči.
+
+```ts src/logic-functions/createPostCard.logic-function.ts
+import { defineLogicFunction } from 'twenty-sdk/define';
+import type { RoutePayload } from 'twenty-sdk/logic-function';
+import { CoreApiClient } from 'twenty-client-sdk/core';
+
+const handler = async (params: RoutePayload) => {
+ const client = new CoreApiClient();
+ const body = (params.body ?? {}) as { name?: string };
+ const name = body.name ?? process.env.DEFAULT_RECIPIENT_NAME ?? 'Hello world';
+
+ const result = await client.mutation({
+ createPostCard: {
+ __args: { data: { name } },
+ id: true,
+ name: true,
+ },
+ });
+ return result;
+};
+
+export default defineLogicFunction({
+ universalIdentifier: 'e56d363b-0bdc-4d8a-a393-6f0d1c75bdcf',
+ name: 'create-new-post-card',
+ timeoutSeconds: 2,
+ handler,
+ httpRouteTriggerSettings: {
+ path: '/post-card/create',
+ httpMethod: 'POST',
+ isAuthRequired: true,
+ },
+ /*databaseEventTriggerSettings: {
+ eventName: 'people.created',
+ },*/
+ /*cronTriggerSettings: {
+ pattern: '0 0 1 1 *',
+ },*/
+});
+```
+
+Dostupné typy spouštěčů:
+* **httpRoute**: Zpřístupní vaši funkci na HTTP cestě a metodě **pod koncovým bodem `/s/`**:
+> např. `path: '/post-card/create'` je volatelné na `https://your-twenty-server.com/s/post-card/create`
+
+<Note>
+Chcete-li vyvolat logickou funkci spuštěnou trasou z (bezhlavé) front-endové komponenty, podívejte se na [Volání logické funkce](/l/cs/developers/extend/apps/layout/front-components#calling-a-logic-function).
+</Note>
+* **cron**: Spouští vaši funkci podle plánu pomocí výrazu CRON.
+* **databaseEvent**: Spouští se při událostech životního cyklu objektů v pracovním prostoru. Když je operace události `updated`, lze konkrétní sledovaná pole určit v poli `updatedFields`. Pokud zůstane nedefinované nebo prázdné, spustí funkci jakákoli aktualizace.
+> např. `person.updated`, `*.created`, `company.*`
+
+<Note>
+Funkci můžete také spustit ručně pomocí CLI:
+
+```bash filename="Terminal"
+yarn twenty dev:function:exec -n create-new-post-card -p '{"key": "value"}'
+```
+
+```bash filename="Terminal"
+yarn twenty dev:function:exec -u e56d363b-0bdc-4d8a-a393-6f0d1c75bdcf
+```
+
+Logy můžete sledovat pomocí:
+
+```bash filename="Terminal"
+yarn twenty dev:function:logs
+```
+</Note>
+
+#### Payload spouštěče trasy
+
+Když spouštěč typu route vyvolá vaši logickou funkci, ta obdrží objekt `RoutePayload`, který odpovídá
+[AWS HTTP API v2 formátu](https://docs.aws.amazon.com/apigateway/latest/developerguide/http-api-develop-integrations-lambda.html).
+Importujte typ `RoutePayload` z `twenty-sdk/logic-function`:
+
+```ts
+import type { RoutePayload } from 'twenty-sdk/logic-function';
+
+const handler = async (event: RoutePayload) => {
+ const { headers, queryStringParameters, pathParameters, body } = event;
+ const { method, path } = event.requestContext.http;
+
+ return { message: 'Success' };
+};
+```
+
+Typ `RoutePayload` má následující strukturu:
+
+ | Vlastnost | Typ | Popis | Příklad |
+ | ---------------------------- | ------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------- |
+ | `headers` | `Record\<string, string \| undefined>` | Záhlaví HTTP (pouze ta uvedená v `forwardedRequestHeaders`) | viz sekci níže |
+ | `queryStringParameters` | `Record\<string, string \| undefined>` | Parametry query stringu (více hodnot spojených čárkami) | `/users?ids=1&ids=2&ids=3&name=Alice` -> `{ ids: '1,2,3', name: 'Alice' }` |
+ | `pathParameters` | `Record\<string, string \| undefined>` | Parametry cesty extrahované ze vzoru trasy | `/users/:id`, `/users/123` -> `{ id: '123' }` |
+ | `body` | `object \| null` | Parsované tělo požadavku (JSON) | `{ id: 1 }` -> `{ id: 1 }` |
+ | `rawBody` | `string \| undefined` | Původní tělo požadavku v UTF-8, před parsováním JSONu. Užitečné pro ověřování podpisů webhooků typu HMAC (např. GitHubův `X-Hub-Signature-256`, Stripe). `undefined`, pokud jej běhové prostředí nezachovalo. | |
+ | `isBase64Encoded` | `boolean` | Zda je tělo kódováno base64 | |
+ | `requestContext.http.method` | `string` | Metoda HTTP (GET, POST, PUT, PATCH, DELETE) | |
+ | `requestContext.http.path` | `string` | Nezpracovaná cesta požadavku | |
+
+
+#### forwardedRequestHeaders
+
+Ve výchozím nastavení se záhlaví HTTP z příchozích požadavků z bezpečnostních důvodů do vaší logické funkce **ne** předávají.
+Chcete-li zpřístupnit konkrétní záhlaví, výslovně je uveďte v poli `forwardedRequestHeaders`:
+
+```ts
+export default defineLogicFunction({
+ universalIdentifier: 'e56d363b-0bdc-4d8a-a393-6f0d1c75bdcf',
+ name: 'webhook-handler',
+ handler,
+ httpRouteTriggerSettings: {
+ path: '/webhook',
+ httpMethod: 'POST',
+ isAuthRequired: false,
+ forwardedRequestHeaders: ['x-webhook-signature', 'content-type'],
+ },
+});
+```
+
+Ve vašem handleru k přeposlaným záhlavím přistupujte takto:
+
+```ts
+const handler = async (event: RoutePayload) => {
+ const signature = event.headers['x-webhook-signature'];
+ const contentType = event.headers['content-type'];
+
+ // Validate webhook signature...
+ return { received: true };
+};
+```
+
+<Note>
+Názvy záhlaví jsou normalizovány na malá písmena. Přistupujte k nim pomocí klíčů s malými písmeny (například `event.headers['content-type']`).
+</Note>
+
+#### Vlastní odpověď HTTP
+
+Ve výchozím nastavení vrácení prosté hodnoty z vašeho handleru odešle tuto hodnotu zpět jako odpověď `200` (JSON pro objekty, `text/plain` pro řetězce). Pro kontrolu stavového kódu a hlaviček odpovědi vraťte `Response` z `twenty-sdk/logic-function`:
+
+```ts
+import { Response } from 'twenty-sdk/logic-function';
+
+const handler = async (event: RoutePayload) => {
+ return new Response('<h1>Hello</h1>', {
+ status: 201,
+ headers: { 'content-type': 'text/html' },
+ });
+};
+```
+
+Z bezpečnostních důvodů jsou hlavičky odpovědi omezeny na seznam povolených položek. Jakákoli hlavička, která není na seznamu (např. `Set-Cookie`, CORS hlavičky jako `Access-Control-Allow-Origin` nebo vlastní hlavičky `X-*`), je tiše zahozena před odesláním odpovědi. Povolené hlavičky odpovědi jsou:
+
+* `content-type`
+* `content-language`
+* `content-disposition`
+* `cache-control`
+* `retry-after`
+
+<Note>
+Stavový kód musí být platný stavový kód HTTP (mezi 100 a 599). Názvy hlaviček odpovědi se porovnávají bez rozlišení velikosti písmen.
+</Note>
+
+#### Payload spouštěče databázové události
+
+Když spouštěč databázové události vyvolá vaši logickou funkci, obdrží jeden `DatabaseEventPayload` pro každý změněný záznam. Payload kombinuje metadata o zdrojovém pracovním prostoru a objektu s událostí na úrovni záznamu.
+
+```ts
+import type {
+ DatabaseEventPayload,
+ ObjectRecordCreateEvent,
+ ObjectRecordDestroyEvent,
+ ObjectRecordUpdateEvent,
+} from 'twenty-sdk/logic-function';
+
+type Person = {
+ id: string;
+ emails?: { primaryEmail?: string };
+};
+```
+
+Tělo zprávy obsahuje:
+
+| Vlastnost | Popis |
+| ------------------------------------------------ | ------------------------------------------------------------------------------------------------ |
+| `name` | Název události, například `person.updated`. |
+| `workspaceId` | Pracovní prostor, ve kterém k události došlo. |
+| `objectMetadata` | Metadata objektu, který se změnil. |
+| `recordId` | ID změněného záznamu. |
+| `userId`, `userWorkspaceId`, `workspaceMemberId` | Pole aktéra, pokud byla událost způsobena uživatelem pracovního prostoru. |
+| `properties` | Data záznamu pro událost, s `before`, `after`, `diff` a `updatedFields` v závislosti na operaci. |
+
+| Událost | Data záznamu |
+| ------------------ | -------------------------------------------------------------------------------------------------------------- |
+| `person.created` | `event.properties.after` |
+| `person.updated` | `event.properties.before`, `event.properties.after`, `event.properties.diff`, `event.properties.updatedFields` |
+| `person.destroyed` | `event.properties.before` |
+
+U logických smazání má `.deleted` podobu jako u aktualizace, protože se změní pole `deletedAt` záznamu.
+Pro trvalá smazání použijte `.destroyed`.
+
+<Note>
+`databaseEventTriggerSettings.updatedFields` filtruje, které události aktualizace spustí funkci.
+`event.properties.updatedFields` říká, která pole se v aktuální události skutečně změnila.
+</Note>
+
+Příklad události vytvoření:
+
+```ts
+type PersonCreatedEvent = DatabaseEventPayload<
+ ObjectRecordCreateEvent<Person>
+>;
+
+const handler = async (event: PersonCreatedEvent) => {
+ const person = event.properties.after;
+
+ return {
+ personId: event.recordId,
+ email: person.emails?.primaryEmail,
+ };
+};
+```
+
+Příklad události aktualizace:
+
+```ts
+type PersonUpdatedEvent = DatabaseEventPayload<
+ ObjectRecordUpdateEvent<Person>
+>;
+
+const handler = async (event: PersonUpdatedEvent) => {
+ const { before, after, diff, updatedFields } = event.properties;
+
+ return {
+ personId: event.recordId,
+ updatedFields,
+ previousEmail: before.emails?.primaryEmail,
+ currentEmail: after.emails?.primaryEmail,
+ emailDiff: diff.emails,
+ };
+};
+```
+
+Spouštění pouze při aktualizacích e‑mailu:
+
+```ts
+export default defineLogicFunction({
+ ...,
+ databaseEventTriggerSettings: {
+ eventName: 'person.updated',
+ updatedFields: ['emails'],
+ },
+});
+```
+
+Příklad události smazání:
+
+```ts
+type PersonDestroyedEvent = DatabaseEventPayload<
+ ObjectRecordDestroyEvent<Person>
+>;
+
+const handler = async (event: PersonDestroyedEvent) => {
+ const personBeforeDestroy = event.properties.before;
+
+ return {
+ personId: event.recordId,
+ email: personBeforeDestroy.emails?.primaryEmail,
+ };
+};
+```
+
+#### Zpřístupnění funkce jako nástroje AI nebo akce pracovního postupu
+
+Logické funkce lze zpřístupnit na dvou rozhraních, z nichž každé má vlastní spouštěč:
+
+* **`toolTriggerSettings`** — zpřístupní funkci AI funkcím Twenty (chat, MCP, volání funkcí). Používá standardní JSON Schema, formát, kterému modely LLM nativně rozumějí.
+* **`workflowActionTriggerSettings`** — zobrazí funkci jako krok ve vizuálním builderu workflow. Používá bohaté `InputSchema` od Twenty, aby builder mohl vykreslit správné editory polí, voliče proměnných a štítky.
+
+Funkce se může rozhodnout pro jedno, druhé nebo obě. Stojí po boku `cronTriggerSettings`, `databaseEventTriggerSettings` a `httpRouteTriggerSettings` — stejný vzor, stejná struktura.
+
+```ts src/logic-functions/enrich-company.logic-function.ts
+import { defineLogicFunction } from 'twenty-sdk/define';
+import { CoreApiClient } from 'twenty-client-sdk/core';
+
+const handler = async (params: { companyName: string; domain?: string }) => {
+ const client = new CoreApiClient();
+
+ const result = await client.mutation({
+ createTask: {
+ __args: {
+ data: {
+ title: `Enrich data for ${params.companyName}`,
+ body: `Domain: ${params.domain ?? 'unknown'}`,
+ },
+ },
+ id: true,
+ },
+ });
+
+ return { taskId: result.createTask.id };
+};
+
+export default defineLogicFunction({
+ universalIdentifier: 'f47ac10b-58cc-4372-a567-0e02b2c3d479',
+ name: 'enrich-company',
+ description: 'Enrich a company record with external data',
+ timeoutSeconds: 10,
+ handler,
+ toolTriggerSettings: {},
+});
+```
+
+Hlavní body:
+
+* Funkce může míchat rozhraní — deklarujte jak `toolTriggerSettings`, tak `workflowActionTriggerSettings`, abyste ji zpřístupnili v chatu i ve workflow builderu.
+* `toolTriggerSettings.inputSchema` a `workflowActionTriggerSettings.inputSchema` jsou obě volitelné. Pokud jsou vynechány, sestavovač manifestu je odvodí ze zdrojového kódu handleru (JSON Schema pro nástroj AI, `InputSchema` od Twenty pro akci workflow). Uveďte jej explicitně, když chcete bohatší typování — například u polí s podporou `FieldMetadataType`, jako `CURRENCY` nebo `RELATION` pro workflow builder, nebo s poli `description`, která si AI agent může přečíst:
+
+```ts
+export default defineLogicFunction({
+ ...,
+ toolTriggerSettings: {
+ inputSchema: {
+ type: 'object',
+ properties: {
+ companyName: {
+ type: 'string',
+ description: 'The name of the company to enrich',
+ },
+ domain: {
+ type: 'string',
+ description: 'The company website domain (optional)',
+ },
+ },
+ required: ['companyName'],
+ },
+ },
+});
+```
+
+<Note>
+**Napište kvalitní `description`.** Agenti AI se spoléhají na pole funkce `description` při rozhodování, kdy nástroj použít. Buďte konkrétní ohledně toho, co nástroj dělá a kdy se má volat.
+</Note>
+
+</Accordion>
+</AccordionGroup>
+
+<Note>
+**Instalační hooky** — předinstalační a poinstalační handlery — sdílejí toto běhové prostředí, ale deklarují se vlastními funkcemi `define` a nepřebírají nastavení spouštěče (triggeru). Viz [Instalační hooky](/l/cs/developers/extend/apps/config/install-hooks) pro `definePreInstallLogicFunction` a `definePostInstallLogicFunction`.
+</Note>
+
+## Typovaní klienti API (twenty-client-sdk)
+
+Balíček `twenty-client-sdk` poskytuje dva typované klienty GraphQL pro práci s Twenty API z vašich logických funkcí a frontendových komponent.
+
+| Klient | Importovat | Koncový bod | Generováno? |
+| ------------------- | ---------------------------- | ---------------------------------------------------------------- | ------------------------------ |
+| `CoreApiClient` | `twenty-client-sdk/core` | `/graphql` — data pracovního prostoru (záznamy, objekty) | Ano, při vývoji/sestavení |
+| `MetadataApiClient` | `twenty-client-sdk/metadata` | `/metadata` — konfigurace pracovního prostoru, nahrávání souborů | Ne, dodává se předem sestavený |
+
+<AccordionGroup>
+<Accordion title="CoreApiClient" description="Dotazování a změny dat pracovního prostoru (záznamy, objekty)">
+
+`CoreApiClient` je hlavní klient pro dotazování a mutace dat pracovního prostoru. Generuje se **z vašeho schématu pracovního prostoru** během `yarn twenty dev` nebo `yarn twenty dev:build`, takže je plně typovaný tak, aby odpovídal vašim objektům a polím.
+
+```ts
+import { CoreApiClient } from 'twenty-client-sdk/core';
+
+const client = new CoreApiClient();
+
+// Query records
+const { companies } = await client.query({
+ companies: {
+ edges: {
+ node: {
+ id: true,
+ name: true,
+ domainName: {
+ primaryLinkLabel: true,
+ primaryLinkUrl: true,
+ },
+ },
+ },
+ },
+});
+
+// Create a record
+const { createCompany } = await client.mutation({
+ createCompany: {
+ __args: {
+ data: {
+ name: 'Acme Corp',
+ },
+ },
+ id: true,
+ name: true,
+ },
+});
+```
+
+Klient používá syntaxi výběrové sady (selection-set): předáním `true` zahrnete pole, pro argumenty použijte `__args` a pro relace vnořujte objekty. Získáte plné automatické doplňování a kontrolu typů založené na schématu vašeho pracovního prostoru.
+
+<Note>
+**CoreApiClient je generován při vývoji/sestavení.** Pokud jej použijete bez předchozího spuštění `yarn twenty dev` nebo `yarn twenty dev:build`, vyvolá chybu. Generování probíhá automaticky — CLI prozkoumá GraphQL schéma vašeho pracovního prostoru a vygeneruje typovaného klienta pomocí `@genql/cli`.
+</Note>
+
+#### Použití CoreSchema pro anotace typů
+
+`CoreSchema` poskytuje typy TypeScriptu odpovídající objektům vašeho pracovního prostoru — hodí se pro typování stavu komponent nebo parametrů funkcí:
+
+```ts
+import { CoreApiClient, CoreSchema } from 'twenty-client-sdk/core';
+import { useState } from 'react';
+
+const [company, setCompany] = useState<
+ Pick<CoreSchema.Company, 'id' | 'name'> | undefined
+>(undefined);
+
+const client = new CoreApiClient();
+const result = await client.query({
+ company: {
+ __args: { filter: { position: { eq: 1 } } },
+ id: true,
+ name: true,
+ },
+});
+setCompany(result.company);
+```
+
+</Accordion>
+<Accordion title="MetadataApiClient" description="Konfigurace pracovního prostoru, aplikace a nahrávání souborů">
+
+`MetadataApiClient` je dodáván předem sestavený v rámci SDK (není vyžadováno žádné generování). Odesílá dotazy na endpoint `/metadata` pro konfiguraci pracovního prostoru, aplikace a nahrávání souborů.
+
+```ts
+import { MetadataApiClient } from 'twenty-client-sdk/metadata';
+
+const metadataClient = new MetadataApiClient();
+
+// List first 10 objects in the workspace
+const { objects } = await metadataClient.query({
+ objects: {
+ edges: {
+ node: {
+ id: true,
+ nameSingular: true,
+ namePlural: true,
+ labelSingular: true,
+ isCustom: true,
+ },
+ },
+ __args: {
+ filter: {},
+ paging: { first: 10 },
+ },
+ },
+});
+```
+
+#### Nahrávání souborů
+
+`MetadataApiClient` obsahuje metodu `uploadFile` pro připojování souborů k polím typu souboru:
+
+```ts
+import { MetadataApiClient } from 'twenty-client-sdk/metadata';
+import * as fs from 'fs';
+
+const metadataClient = new MetadataApiClient();
+
+const fileBuffer = fs.readFileSync('./invoice.pdf');
+
+const uploadedFile = await metadataClient.uploadFile(
+ fileBuffer, // file contents as a Buffer
+ 'invoice.pdf', // filename
+ 'application/pdf', // MIME type
+ '58a0a314-d7ea-4865-9850-7fb84e72f30b', // field universalIdentifier
+);
+
+console.log(uploadedFile);
+// { id: '...', path: '...', size: 12345, createdAt: '...', url: 'https://...' }
+```
+
+| Parametr | Typ | Popis |
+| ---------------------------------- | -------- | ------------------------------------------------------------------- |
+| `fileBuffer` | `Buffer` | Surový obsah souboru |
+| `filename` | `string` | Název souboru (používá se pro ukládání a zobrazení) |
+| `contentType` | `string` | Typ MIME (pokud je vynechán, výchozí je `application/octet-stream`) |
+| `fieldMetadataUniversalIdentifier` | `string` | `universalIdentifier` pole typu souboru ve vašem objektu |
+
+Hlavní body:
+* Používá `universalIdentifier` pole (nikoli jeho ID specifické pro pracovní prostor), takže váš kód pro nahrávání funguje v jakémkoli pracovním prostoru, kde je vaše aplikace nainstalována.
+* Vrácená hodnota `url` je podepsaná adresa URL, kterou můžete použít k přístupu k nahranému souboru.
+
+</Accordion>
+</AccordionGroup>
+
+<Note>
+ Když váš kód běží na Twenty (logické funkce nebo frontendové komponenty), platforma vloží přihlašovací údaje jako proměnné prostředí:
+
+ * `TWENTY_API_URL` — Základní URL Twenty API
+ * `TWENTY_APP_ACCESS_TOKEN` — krátkodobý klíč s rozsahem omezeným na výchozí roli funkce vaší aplikace
+
+ Není nutné je předávat klientům — čtou je automaticky z `process.env`. Oprávnění API klíče jsou určena rolí deklarovanou pomocí `defineApplicationRole()` (nebo odkazovanou prostřednictvím `defaultRoleUniversalIdentifier` v `application-config.ts`).
+</Note>
diff --git a/packages/twenty-docs/l/cs/developers/extend/apps/logic/overview.mdx b/packages/twenty-docs/l/cs/developers/extend/apps/logic/overview.mdx
new file mode 100644
index 00000000000..6a58244f477
--- /dev/null
+++ b/packages/twenty-docs/l/cs/developers/extend/apps/logic/overview.mdx
@@ -0,0 +1,55 @@
+---
+title: Přehled
+description: Server-side TypeScript, který běží uvnitř Twenty — spouštěný pomocí HTTP rout, plánů CRON, databázových událostí, nástrojů AI nebo akcí pracovního postupu.
+icon: bolt
+---
+
+**Logická vrstva** aplikace Twenty je kód, který *běží* — server-side TypeScript handlery reagující na HTTP požadavky, plány CRON a změny záznamů; AI dovednosti a agenti, kteří fungují uvnitř pracovního prostoru; a připojení OAuth, která umožňují vašim funkcím jednat jménem uživatele ve službách třetích stran.
+
+```text
+ ┌─ HTTP route ──┐
+ │ Cron schedule │
+ │ Database event │ ┌────────────────────┐
+ triggers ─┤ AI tool call ├─────▶│ Logic function │
+ │ Workflow action │ │ (your handler) │
+ │ Manual exec │ └────────────────────┘
+ └────────────────────┘ │
+ ▼
+ ┌────────────────────────────┐
+ │ Twenty API (records) │
+ │ Third-party API │
+ │ (via Connection token) │
+ └────────────────────────────┘
+```
+
+## V této části
+
+<CardGroup cols={2}>
+ <Card title="Logické funkce" icon="bolt" href="/l/cs/developers/extend/apps/logic/logic-functions">
+ Základní stavební blok — typy spouštěčů, payloady a typovaný klient API.
+ </Card>
+ <Card title="Dovednosti a agenti" icon="robot" href="/l/cs/developers/extend/apps/logic/skills-and-agents">
+ Opakovaně použitelné pokyny pro agenty AI a asistenti s vlastními systémovými prompty.
+ </Card>
+ <Card title="Připojení" icon="plug" href="/l/cs/developers/extend/apps/logic/connections">
+ Přihlašovací údaje OAuth, které vaše aplikace uchovává pro služby třetích stran — Linear, GitHub, Slack a další.
+ </Card>
+</CardGroup>
+
+## Přehled typů spouštěčů
+
+Logická funkce volí jeden nebo více spouštěčů — každá z níže uvedených položek je samostatné pole v `defineLogicFunction()`:
+
+| Spouštěč | Kdy se spouští | Nastavení |
+| --------------------------- | ----------------------------------------------------------------- | ------------------------------- |
+| **HTTP route** | Požadavek dorazí na váš koncový bod `/s/\<path>` | `httpRouteTriggerSettings` |
+| **Cron** | CRON výraz se shoduje | `cronTriggerSettings` |
+| **Událost databáze** | Záznam v pracovním prostoru je vytvořen, aktualizován nebo smazán | `databaseEventTriggerSettings` |
+| **Nástroj AI** | Funkce Twenty AI se rozhodne zavolat vaši funkci | `toolTriggerSettings` |
+| **Akce pracovního postupu** | Krok pracovního postupu vyvolá vaši funkci | `workflowActionTriggerSettings` |
+
+Funkce běží v izolovaných sandboxovaných procesech Node.js a přistupují k pracovnímu prostoru přes typovaného klienta API omezeného na roli deklarovanou v [`defineApplication()`](/l/cs/developers/extend/apps/config/application).
+
+<Note>
+**Instalační hooky** — kód, který běží před nebo po instalaci — sdílejí toto běhové prostředí, ale používají vlastní funkce `define` a nacházejí se pod [Config → Install Hooks](/l/cs/developers/extend/apps/config/install-hooks).
+</Note>
diff --git a/packages/twenty-docs/l/cs/developers/extend/apps/logic/skills-and-agents.mdx b/packages/twenty-docs/l/cs/developers/extend/apps/logic/skills-and-agents.mdx
new file mode 100644
index 00000000000..c8eda98bf80
--- /dev/null
+++ b/packages/twenty-docs/l/cs/developers/extend/apps/logic/skills-and-agents.mdx
@@ -0,0 +1,138 @@
+---
+title: Dovednosti a agenti
+description: Definujte dovednosti a agenty AI pro svou aplikaci.
+icon: robot
+---
+
+<Warning>
+ Dovednosti a agenti jsou aktuálně v alfa fázi. Funkce funguje, ale stále se vyvíjí.
+</Warning>
+
+Aplikace mohou definovat schopnosti AI, které fungují přímo v pracovním prostoru — znovupoužitelné pokyny pro dovednosti a agenty s vlastními systémovými prompty.
+
+<AccordionGroup>
+<Accordion title="defineSkill" description="Definujte dovednosti agentů AI">
+
+Dovednosti definují znovupoužitelné pokyny a schopnosti, které mohou agenti AI používat ve vašem pracovním prostoru. K definování dovedností s vestavěnou validací použijte `defineSkill()`:
+
+```ts src/skills/example-skill.ts
+import { defineSkill } from 'twenty-sdk/define';
+
+export default defineSkill({
+ universalIdentifier: 'a1b2c3d4-e5f6-7890-abcd-ef1234567890',
+ name: 'sales-outreach',
+ label: 'Sales Outreach',
+ description: 'Guides the AI agent through a structured sales outreach process',
+ icon: 'IconBrain',
+ content: `You are a sales outreach assistant. When reaching out to a prospect:
+1. Research the company and recent news
+2. Identify the prospect's role and likely pain points
+3. Draft a personalized message referencing specific details
+4. Keep the tone professional but conversational`,
+});
+```
+
+Hlavní body:
+* `name` je jedinečný identifikátor dovednosti (doporučuje se kebab-case).
+* `label` je uživatelsky čitelný název zobrazovaný v UI.
+* `content` obsahuje pokyny dovednosti — je to text, který agent AI používá.
+* `icon` (volitelné) nastavuje ikonu zobrazovanou v UI.
+* `description` (volitelné) poskytuje doplňující kontext o účelu dovednosti.
+
+</Accordion>
+<Accordion title="defineAgent" description="Definujte AI agenty s vlastními prompty">
+
+Agenti jsou asistenti AI, kteří běží ve vašem pracovním prostoru. K vytvoření agentů s vlastním systémovým promptem použijte `defineAgent()`:
+
+```ts src/agents/example-agent.ts
+import { defineAgent } from 'twenty-sdk/define';
+
+export default defineAgent({
+ universalIdentifier: 'b3c4d5e6-f7a8-9012-bcde-f34567890123',
+ name: 'sales-assistant',
+ label: 'Sales Assistant',
+ description: 'Helps the sales team draft outreach emails and research prospects',
+ icon: 'IconRobot',
+ prompt: 'You are a helpful sales assistant. Help users with their questions and tasks.',
+});
+```
+
+Hlavní body:
+* `name` je jedinečný identifikátor agenta (doporučuje se kebab-case).
+* `label` je zobrazovaný název v UI.
+* `prompt` je systémový prompt, který definuje chování agenta.
+* `description` (volitelné) poskytuje kontext o tom, co agent dělá.
+* `icon` (volitelné) nastavuje ikonu zobrazovanou v UI.
+* `modelId` (volitelné) přepíše výchozí model AI používaný agentem.
+* `responseFormat` (volitelně) určuje tvar výstupu agenta. Výchozí hodnota je `{ type: 'text' }` pro volný text. Použijte `{ type: 'json', schema }` k vynucení strukturovaného výstupu ve formátu JSON.
+
+Ve výchozím nastavení agent vrací volný text. Chcete-li získat strukturovaný výstup, nastavte `responseFormat` na `{ type: 'json' }` a poskytněte `schema`:
+
+```ts src/agents/structured-agent.ts
+import { defineAgent } from 'twenty-sdk/define';
+
+export default defineAgent({
+ universalIdentifier: 'c4d5e6f7-a8b9-0123-cdef-456789012345',
+ name: 'lead-scorer',
+ label: 'Lead Scorer',
+ prompt: 'Score the lead and explain your reasoning.',
+ responseFormat: {
+ type: 'json',
+ schema: {
+ type: 'object',
+ properties: {
+ score: { type: 'number', description: 'Lead score from 0 to 100' },
+ summary: { type: 'string', description: 'Short reasoning for the score' },
+ },
+ required: ['score', 'summary'],
+ additionalProperties: false,
+ },
+ },
+});
+```
+
+Poznámky ke schématu:
+* Schéma je plochý objekt: `type` každé vlastnosti musí být primitivní typ (`string`, `number` nebo `boolean`). Vnořené objekty a pole nejsou podporovány.
+* `description` (volitelně) u každé vlastnosti navádí model, co má na toto místo doplnit.
+* `required` (volitelně) vypisuje vlastnosti, které musí model vždy vrátit.
+* `additionalProperties: false` (volitelně) zakáže jakoukoli vlastnost, která není deklarována v `properties`.
+
+</Accordion>
+<Accordion title="runAgent" description="Spuštění agenta z logické funkce">
+
+`runAgent()` umožňuje logické funkci spustit jednoho z agentů vaší aplikace (s jeho dovednostmi a nástroji). Identifikujte agenta pomocí `universalIdentifier`, který jste předali do `defineAgent()`:
+
+```ts src/logic-functions/run-enricher.ts
+import { runAgent } from 'twenty-sdk/logic-function';
+
+const { result, error, success } = await runAgent({
+ agentUniversalIdentifier: 'b3c4d5e6-f7a8-9012-bcde-f34567890123',
+ prompt: 'Enrich House Ad <recordId>: fill empty fields from its listing URL.',
+});
+```
+
+Hlavní body:
+* Agent běží **synchronně** a může sám číst/aktualizovat záznamy pomocí vlastních nástrojů — `runAgent()` vrátí výsledek až po dokončení běhu.
+* Aplikace může spouštět pouze své vlastní agenty.
+* [Výchozí role](/l/cs/developers/extend/apps/config/roles) aplikace musí udělovat příznak oprávnění `AI` — přidejte `SystemPermissionFlag.AI` do `permissionFlagUniversalIdentifiers` (nebo nastavte `canAccessAllTools: true`).
+ Bez něj `runAgent()` selže s chybou oprávnění.
+* Nastavte u logické funkce velkorysou hodnotu `timeoutSeconds` — běh agenta může trvat několik sekund.
+* `success` je `true` a `result` není null po dokončení běhu; při chybě je `success` `false`, `result` je `null` a `error` obsahuje důvod (například když během běhu workspace vyčerpal AI kredity).
+
+```ts src/roles/default-role.ts
+import { defineApplicationRole, SystemPermissionFlag } from 'twenty-sdk/define';
+
+export default defineApplicationRole({
+ universalIdentifier: 'b648f87b-1d26-4961-b974-0908fd991061',
+ label: 'Default function role',
+ // runAgent() requires the AI permission flag on the app's default role.
+ permissionFlagUniversalIdentifiers: [SystemPermissionFlag.AI],
+});
+```
+
+<Warning>
+ **Vyhněte se smyčkám:** pokud voláte `runAgent()` z databázového triggeru `*.updated` a agent aktualizuje stejný záznam, omezte trigger pomocí `updatedFields` na pole, do kterého agent nikdy nezapisuje (např. zdrojovou URL), nebo před voláním `runAgent()` zkontrolujte, zda je některé cílové pole stále prázdné.
+</Warning>
+
+</Accordion>
+</AccordionGroup>
diff --git a/packages/twenty-docs/l/cs/developers/extend/apps/operations/cli.mdx b/packages/twenty-docs/l/cs/developers/extend/apps/operations/cli.mdx
new file mode 100644
index 00000000000..be09dd9da05
--- /dev/null
+++ b/packages/twenty-docs/l/cs/developers/extend/apps/operations/cli.mdx
@@ -0,0 +1,105 @@
+---
+title: CLI
+description: příkazy `yarn twenty` pro spouštění funkcí, streamování logů, správu instalací aplikací a přepínání vzdálených serverů.
+icon: terminal
+---
+
+Kromě `dev`, `dev:build`, `dev:add` a `dev:typecheck` poskytuje `yarn twenty` CLI příkazy pro spouštění funkcí, zobrazení logů a správu instalací aplikací.
+
+## Spouštění funkcí (`yarn twenty dev:function:exec`)
+
+Spusťte logickou funkci ručně bez vyvolání přes HTTP, cron nebo databázovou událost:
+
+```bash filename="Terminal"
+# Execute by function name
+yarn twenty dev:function:exec -n create-new-post-card
+
+# Execute by universalIdentifier
+yarn twenty dev:function:exec -u e56d363b-0bdc-4d8a-a393-6f0d1c75bdcf
+
+# Pass a JSON payload
+yarn twenty dev:function:exec -n create-new-post-card -p '{"name": "Hello"}'
+
+# Execute the post-install function
+yarn twenty dev:function:exec --postInstall
+```
+
+## Zobrazení logů funkcí (`yarn twenty dev:function:logs`)
+
+Streamujte výstupní logy běhu logických funkcí vaší aplikace:
+
+```bash filename="Terminal"
+# Stream all function logs
+yarn twenty dev:function:logs
+
+# Filter by function name
+yarn twenty dev:function:logs -n create-new-post-card
+
+# Filter by universalIdentifier
+yarn twenty dev:function:logs -u e56d363b-0bdc-4d8a-a393-6f0d1c75bdcf
+```
+
+<Note>
+To se liší od `yarn twenty docker:logs`, který zobrazuje logy kontejneru Docker. `yarn twenty dev:function:logs` zobrazuje logy běhu funkcí vaší aplikace ze serveru Twenty.
+</Note>
+
+## Generování typovaného klienta (`yarn twenty dev:generate-client`)
+
+Znovu vygenerujte typovaného klienta API (`twenty-client-sdk`) ze schématu aktivního vzdáleného serveru, bez sestavování nebo synchronizace aplikace. Použijte jej k získání typovaného klienta v libovolném projektu – například backendové služby v samostatném repozitáři – který komunikuje s vaší instancí Twenty:
+
+```bash filename="Terminal"
+# In your project (no Twenty app definition required)
+yarn add twenty-sdk twenty-client-sdk
+
+# Connect to the Twenty instance to generate the client from
+yarn twenty remote:add
+
+# Generate the typed client into node_modules/twenty-client-sdk
+yarn twenty dev:generate-client
+```
+
+Poté klienta importujte ve svém kódu:
+
+```typescript
+import { CoreApiClient } from 'twenty-client-sdk/core';
+```
+
+Spusťte příkaz znovu pokaždé, když se změní váš datový model, abyste aktualizovali vygenerované typy.
+
+<Note>
+Klient je vygenerován uvnitř `node_modules`, takže není verzován spolu s vaším kódem. Spusťte `yarn twenty dev:generate-client` po každé instalaci (například ve skriptu `postinstall` nebo v CI).
+</Note>
+
+## Odinstalace aplikace (`yarn twenty app:uninstall`)
+
+Odeberte svou aplikaci z aktivního pracovního prostoru:
+
+```bash filename="Terminal"
+yarn twenty app:uninstall
+
+# Skip the confirmation prompt
+yarn twenty app:uninstall --yes
+```
+
+## Správa vzdálených serverů
+
+**Remote** je server Twenty, ke kterému se vaše aplikace připojuje. Během nastavení jej generátor kostry automaticky vytvoří. Můžete kdykoli přidat další vzdálené servery nebo mezi nimi přepínat.
+
+```bash filename="Terminal"
+# Add a new remote (opens a browser for OAuth login)
+yarn twenty remote:add
+
+# Connect to a local Twenty server (auto-detects port 2020 or 3000)
+yarn twenty remote:add --local
+
+# Add a remote non-interactively (useful for CI)
+yarn twenty remote:add --url https://your-twenty-server.com --api-key $TWENTY_API_KEY --as my-remote
+
+# List all configured remotes
+yarn twenty remote:list
+
+# Set the active remote
+yarn twenty remote:use <name>
+```
+
+Vaše přihlašovací údaje jsou uloženy v `~/.twenty/config.json`.
diff --git a/packages/twenty-docs/l/cs/developers/extend/apps/operations/overview.mdx b/packages/twenty-docs/l/cs/developers/extend/apps/operations/overview.mdx
new file mode 100644
index 00000000000..e53072d1c67
--- /dev/null
+++ b/packages/twenty-docs/l/cs/developers/extend/apps/operations/overview.mdx
@@ -0,0 +1,32 @@
+---
+title: Přehled
+description: Sestavte, otestujte a doručte svou aplikaci — příkazy CLI, integrační testy, CI a publikování na server nebo do npm.
+icon: rocket
+---
+
+**Provozní vrstva** je všechno, co děláte *na* své aplikaci, nikoli *pomocí* ní: spouštění příkazů CLI, provádění integračních testů proti reálnému serveru Twenty, konfigurace CI a vydávání verzí — buď jako tarball nasazený na jednom serveru, nebo jako balíček npm uvedený v Marketplace.
+
+```text
+ develop ─▶ test ─▶ build ─▶ deploy / publish
+ ─────── ──── ───── ─────────────────
+ yarn yarn yarn yarn twenty app:publish --private (tarball → one server)
+ twenty test twenty
+ dev dev:build yarn twenty app:publish (npm → marketplace)
+```
+
+## V této části
+
+<CardGroup cols={2}>
+ <Card title="CLI" icon="terminal" href="/l/cs/developers/extend/apps/operations/cli">
+ Referenční přehled `yarn twenty` — exec, logs, uninstall, remotes.
+ </Card>
+ <Card title="Synchronizace a obnovení" icon="kompas" href="/l/cs/developers/extend/apps/operations/sync-and-recovery">
+ Který příkaz kdy použít, jak číst diff synchronizace a postup obnovy.
+ </Card>
+ <Card title="Testování" icon="flask" href="/l/cs/developers/extend/apps/operations/testing">
+ Nastavení Vitestu, integrační testy, kontrola typů, workflow CI.
+ </Card>
+ <Card title="Publikování" icon="nahrát" href="/l/cs/developers/extend/apps/operations/publishing">
+ Sestavit, nasadit tarball, publikovat do npm, nainstalovat.
+ </Card>
+</CardGroup>
diff --git a/packages/twenty-docs/l/cs/developers/extend/apps/operations/publishing.mdx b/packages/twenty-docs/l/cs/developers/extend/apps/operations/publishing.mdx
new file mode 100644
index 00000000000..7454d2d080c
--- /dev/null
+++ b/packages/twenty-docs/l/cs/developers/extend/apps/operations/publishing.mdx
@@ -0,0 +1,294 @@
+---
+title: Publikování
+icon: nahrát
+description: Distribuujte svou aplikaci Twenty do Marketplace nebo ji nasaďte interně.
+---
+
+## Přehled
+
+Jakmile je vaše aplikace [sestavena a otestována lokálně](/l/cs/developers/extend/apps/getting-started/concepts), máte dvě cesty, jak ji distribuovat:
+
+* **Nasaďte tarball** — nahrajte svou aplikaci přímo na konkrétní server Twenty pro interní nebo soukromé použití.
+* **Publish to npm** — uveďte svou aplikaci v Marketplace Twenty, aby ji mohl kterýkoli pracovní prostor objevit a nainstalovat.
+
+Obě cesty začínají stejným krokem **build**.
+
+## Sestavení vaší aplikace
+
+Spusťte příkaz build ke zkompilování své aplikace a k vygenerování souboru `manifest.json` připraveného k distribuci:
+
+```bash filename="Terminal"
+yarn twenty dev:build
+```
+
+Tím se zkompilují zdrojové soubory TypeScriptu, transpilují logické funkce a frontendové komponenty a vše se zapíše do `.twenty/output/`. Přidejte `--tarball`, abyste také vytvořili balíček `.tgz` pro ruční distribuci nebo příkaz publish.
+
+## Nasazení na server (tarball)
+
+U aplikací, které nechcete zpřístupnit veřejně — proprietární nástroje, integrace pouze pro enterprise nebo experimentální buildy — můžete nasadit tarball přímo na server Twenty.
+
+### Předpoklady
+
+Před nasazením potřebujete nakonfigurovaný vzdálený cíl směřující na cílový server. Vzdálené cíle ukládají adresu URL serveru a přihlašovací údaje lokálně v `~/.twenty/config.json`.
+
+Přidat vzdálený cíl:
+
+```bash filename="Terminal"
+yarn twenty remote:add --url https://your-twenty-server.com --as production
+```
+
+### Nasazení
+
+Sestavte a nahrajte svou aplikaci na server v jednom kroku:
+
+```bash filename="Terminal"
+yarn twenty app:publish --private
+# To deploy to a specific remote:
+# yarn twenty app:publish --private --remote production
+```
+
+### Sdílení nasazené aplikace
+
+<Warning>
+Sdílení soukromých (tarball) aplikací napříč pracovními prostory je funkcí **Enterprise**. Karta **Distribuce** bude místo ovládacích prvků sdílení zobrazovat výzvu k upgradu, dokud váš pracovní prostor nebude mít platný klíč Enterprise. Přejděte do [Nastavení > Admin Panel > Enterprise](/settings/admin-panel#enterprise) a aktivujte ji.
+</Warning>
+
+Aplikace ve formě tarball nejsou uvedeny ve veřejném tržišti, takže je ostatní pracovní prostory na tomtéž serveru procházením neobjeví. Jakmile je váš pracovní prostor na tarifu Enterprise, můžete sdílet nasazenou aplikaci takto:
+
+1. Přejděte do **Nastavení > Aplikace > Registrace** a otevřete svou aplikaci
+2. Na kartě **Distribuce** klikněte na **Zkopírovat odkaz ke sdílení**
+3. Sdílejte tento odkaz s uživateli v jiných pracovních prostorech — zavede je přímo na instalační stránku aplikace
+
+Odkaz ke sdílení používá základní adresu URL serveru (bez jakékoli subdomény pracovního prostoru), takže funguje pro libovolný pracovní prostor na serveru.
+
+### Správa verzí
+
+Při aktualizaci již nasazené tarballové aplikace server vyžaduje, aby hodnota `version` v `package.json` byla **přísně vyšší** (podle řazení [semver](https://semver.org)) než aktuálně nasazená verze. Opětovné nasazení stejné verze nebo odeslání nižší verze je odmítnuto ještě před uložením tarballu — v CLI uvidíte chybu `VERSION_ALREADY_EXISTS`.
+
+Chcete-li vydat aktualizaci:
+
+1. Zvyšte hodnotu pole `version` v souboru `package.json` (např. `1.2.3` → `1.2.4`, `1.3.0` nebo `2.0.0`)
+2. Spusťte `yarn twenty app:publish --private` (nebo `yarn twenty app:publish --private --remote production`)
+3. Pracovní prostory, které mají aplikaci nainstalovanou, uvidí dostupnou aktualizaci ve svém nastavení
+
+<Note>
+Předběžné tagy fungují podle očekávání: zvýšení z `1.0.0-rc.1` → `1.0.0-rc.2` je povoleno a finální vydání jako `1.0.0` je správně rozpoznáno jako vyšší než `1.0.0-rc.5`. Verze v `package.json` musí být platným řetězcem semver.
+</Note>
+
+{/* TODO: add screenshot of the Upgrade button */}
+
+### Kompatibilita verze serveru
+
+Pokud vaše aplikace používá funkci zavedenou v konkrétní verzi serveru Twenty (například poskytovatelé OAuth přidaní ve verzi 2.3.0), měli byste deklarovat minimální verzi serveru, kterou vaše aplikace vyžaduje, pomocí pole `engines.twenty` v `package.json`:
+
+```json filename="package.json"
+{
+ "name": "twenty-my-app",
+ "version": "1.0.0",
+ "engines": {
+ "node": "^24.5.0",
+ "twenty": ">=2.3.0"
+ }
+}
+```
+
+Hodnota je standardní [rozsah SemVer](https://github.com/npm/node-semver#ranges). Běžné vzory:
+
+| Rozsah | Význam |
+| ---------------------------------- | ---------------------------------------------- |
+| `>=2.3.0` | Jakýkoli server od verze 2.3.0 výše |
+| `>=2.3.0 \<3.0.0` | 2.3.0 nebo novější, ale pod další hlavní verzí |
+| `^2.3.0` | Stejné jako `>=2.3.0 \<3.0.0` |
+
+**Co se děje při nasazení a instalaci:**
+
+* Pokud je `engines.twenty` nastaveno a verze cílového serveru nevyhovuje rozsahu, nasazení (nahrání tarballu) nebo instalace je odmítnuto chybou `SERVER_VERSION_INCOMPATIBLE` a zprávou, která uvádí jak požadovaný rozsah, tak skutečnou verzi serveru.
+* Pokud `engines.twenty` **není nastaveno**, aplikace je přijata na jakékoli verzi serveru (zpětně kompatibilní se stávajícími aplikacemi).
+* Pokud server nemá nakonfigurované `APP_VERSION`, kontrola se přeskočí.
+
+<Note>
+Server je rozhodující autoritou — ověřuje `engines.twenty` jak při nahrání tarballu, tak při instalaci do pracovního prostoru. Pokud nasazujete tarball mimo standardní proces nebo instalujete z marketplace, server přesto vynucuje kompatibilitu.
+</Note>
+
+## Automatizované CI/CD (předpřipravené workflowy)
+
+Aplikace vygenerované pomocí `create-twenty-app` jsou hned připravené se dvěma workflowy GitHub Actions ve složce `.github/workflows/`. Jsou připravené ke spuštění hned, jakmile repozitář pushnete na GitHub — pro CI není potřeba žádné další nastavení a CD vyžaduje pouze jeden secret.
+
+### CI — `ci.yml`
+
+Automaticky spouští integrační testy při každém pushi do `main` a u pull requestů.
+
+**K čemu slouží:**
+
+1. Provede checkout zdrojového kódu vaší aplikace.
+2. Spustí izolovanou testovací instanci Twenty pomocí složené akce `twentyhq/twenty/.github/actions/spawn-twenty-app-dev-test@main` (ekvivalent v CI k `yarn twenty docker:start --test`).
+3. Povolí Corepack, nastaví Node.js podle vašeho `.nvmrc` a nainstaluje závislosti pomocí `yarn install --immutable`.
+4. Spustí `yarn test` a předá `TWENTY_API_URL` a `TWENTY_API_KEY` ze spuštěné instance, aby vaše testy mohly komunikovat se skutečným serverem.
+
+**Konfigurační volby:**
+
+* `TWENTY_VERSION` (env, výchozí hodnota `latest`) — uzamkněte v CI používanou verzi serveru Twenty úpravou této hodnoty v `ci.yml`.
+* Souběžné běhy jsou seskupeny podle `github.ref` a při nových pushích ruší právě probíhající běhy.
+
+Nejsou potřeba žádné secrety — testovací instance je efemérní a existuje pouze po dobu běhu úlohy.
+
+### CD — `cd.yml`
+
+Nasazuje vaši aplikaci na nakonfigurovaný server Twenty při každém pushi do `main` a volitelně také z pull requestu, pokud je přidán štítek `deploy`.
+
+**K čemu slouží:**
+
+1. Provede checkout headu PR (u označených PR) nebo pushnutého commitu.
+2. Spustí `twentyhq/twenty/.github/actions/deploy-twenty-app@main` — ekvivalent v CI k `yarn twenty app:publish --private`.
+3. Spustí `twentyhq/twenty/.github/actions/install-twenty-app@main`, aby se nově nasazená verze nainstalovala do cílového pracovního prostoru.
+
+**Požadovaná konfigurace:**
+
+| Nastavení | Kde | Účel |
+| ----------------------- | --------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- |
+| `TWENTY_DEPLOY_URL` | `env` v `cd.yml` (výchozí `http://localhost:3000`) | Server Twenty, na který se nasazuje. Před prvním použitím to změňte na skutečnou URL vašeho serveru. |
+| `TWENTY_DEPLOY_API_KEY` | GitHub repozitář **Settings → Secrets and variables → Actions** | API klíč s oprávněním k nasazení na cílovém serveru. |
+
+<Note>
+Výchozí `TWENTY_DEPLOY_URL` `http://localhost:3000` je pouze zástupná hodnota — z runneru hostovaného GitHubem tato adresa nebude dosažitelná. Před povolením CD ji aktualizujte na veřejnou URL vašeho serveru (nebo použijte self-hosted runner s přístupem do sítě).
+</Note>
+
+**Spuštění náhledového nasazení z PR:**
+
+Přidejte k pull requestu štítek `deploy`. Podmínka `if:` v `cd.yml` spustí úlohu pro dané PR s použitím head commitu PR, což vám umožní ověřit změnu na cílovém serveru před sloučením.
+
+### Připnutí verzí znovupoužitelných akcí
+
+Obě workflowy odkazují na znovupoužitelné akce na `@main`, takže aktualizace akcí v repozitáři `twentyhq/twenty` se přeberou automaticky. Pokud chcete deterministická sestavení, nahraďte `@main` v každém řádku `uses:` za commit SHA nebo tag vydání.
+
+## Publikování na npm
+
+Publikování na npm zajistí, že bude vaše aplikace dohledatelná v Marketplace Twenty. Jakýkoli pracovní prostor Twenty může procházet, instalovat a aktualizovat aplikace z Marketplace přímo z UI.
+
+### Požadavky
+
+* Účet na [npm](https://www.npmjs.com)
+* Klíčové slovo `twenty-app` ve vašem poli `keywords` v souboru `package.json` (přidejte ho ručně — ve výchozím nastavení není zahrnuto v šabloně `create-twenty-app`)
+
+```json filename="package.json"
+{
+ "name": "twenty-app-postcard-sender",
+ "version": "1.0.0",
+ "keywords": ["twenty-app"]
+}
+```
+
+### Metadata tržiště
+
+Konfigurace `defineApplication()` podporuje volitelná pole, která určují, jak se vaše aplikace zobrazuje v tržišti. Použijte `logoUrl` a `screenshots` k odkazování na obrázky ze složky `public/`:
+
+```ts src/application-config.ts
+export default defineApplication({
+ universalIdentifier: '...',
+ displayName: 'My App',
+ description: 'A great app',
+ logoUrl: 'public/logo.png',
+ screenshots: [
+ 'public/screenshot-1.png',
+ 'public/screenshot-2.png',
+ ],
+});
+```
+
+Podívejte se na [sekci defineApplication](/l/cs/developers/extend/apps/config/application#marketplace-metadata) na stránce Building Apps pro úplný seznam polí tržiště (`author`, `category`, `aboutDescription`, `websiteUrl`, `termsUrl` atd.).
+
+#### Doporučené rozměry snímků obrazovky
+
+Tržiště zobrazuje `screenshots` v pevném kontejneru s poměrem stran `8:5` (například `1600×1000 px`).
+
+<Note>
+Snímky obrazovky libovolného poměru stran se zobrazují celé a nikdy se neořezávají, ale cokoli výrazně vyššího nebo užšího než `8:5` bude mít po stranách prázdné pruhy.
+</Note>
+
+### Publikování
+
+```bash filename="Terminal"
+yarn twenty app:publish
+```
+
+Chcete-li publikovat pod konkrétním dist-tagem (např. `beta` nebo `next`):
+
+```bash filename="Terminal"
+yarn twenty app:publish --tag beta
+```
+
+### Jak funguje objevování v tržišti
+
+Server Twenty synchronizuje svůj katalog tržiště z registru npm **každou hodinu**.
+
+Synchronizaci můžete spustit okamžitě místo čekání:
+
+```bash filename="Terminal"
+yarn twenty dev:catalog-sync
+# To target a specific remote:
+# yarn twenty dev:catalog-sync --remote production
+```
+
+Metadata zobrazená v tržišti pocházejí z vaší konfigurace `defineApplication()` — z polí jako `displayName`, `description`, `author`, `category`, `logoUrl`, `screenshots`, `aboutDescription`, `websiteUrl` a `termsUrl`.
+
+<Note>
+Pokud vaše aplikace nedefinuje `aboutDescription` v `defineApplication()`, tržiště automaticky použije soubor `README.md` vašeho balíčku z npm jako obsah stránky O aplikaci. To znamená, že můžete spravovat jediný soubor README jak pro npm, tak pro tržiště Twenty. Pokud chcete v tržišti jiný popis, explicitně nastavte `aboutDescription`.
+</Note>
+
+### Publikování pomocí CI
+
+Použijte tento pracovní postup GitHub Actions k automatickému publikování při každém vydání (používá [OIDC](https://docs.npmjs.com/trusted-publishers)):
+
+```yaml filename=".github/workflows/publish.yml"
+name: Publish
+on:
+ release:
+ types: [published]
+
+permissions:
+ contents: read
+ id-token: write
+
+jobs:
+ publish:
+ runs-on: ubuntu-latest
+ steps:
+ - uses: actions/checkout@v4
+ - uses: actions/setup-node@v4
+ with:
+ node-version: "24"
+ registry-url: https://registry.npmjs.org
+ - run: yarn install --immutable
+ - run: npx twenty dev:build
+ - run: npm publish --provenance --access public
+ working-directory: .twenty/output
+```
+
+Pro jiné systémy CI (GitLab CI, CircleCI atd.) platí stejné tři příkazy: `yarn install`, `yarn twenty dev:build` a poté `npm publish` z `.twenty/output`.
+
+<Note>
+**npm provenance** je volitelné, ale doporučené. Publikování s `--provenance` přidá k vašemu záznamu na npm odznak důvěryhodnosti a umožní uživatelům ověřit, že balíček byl sestaven z konkrétního commitu ve veřejné CI pipeline. Pokyny k nastavení najdete v [dokumentaci k npm provenance](https://docs.npmjs.com/generating-provenance-statements).
+</Note>
+
+## Instalace aplikací
+
+Jakmile je aplikace publikována (npm) nebo nasazena (tarball), mohou ji pracovní prostory nainstalovat prostřednictvím uživatelského rozhraní.
+
+Přejděte na stránku **Nastavení > Aplikace** v Twenty, kde lze procházet a instalovat jak aplikace z tržiště, tak aplikace nasazené jako tarball.
+
+{/* TODO: add screenshot of the UI when the app is registered */}
+
+Aplikace můžete nainstalovat také z příkazového řádku:
+
+```bash filename="Terminal"
+yarn twenty app:install
+```
+
+<Note>
+Server při instalaci vynucuje verzování semver a zrcadlí pravidla pro nasazení:
+
+* Instalace stejné verze, která je již nainstalována ve vašem pracovním prostoru, je odmítnuta s chybou `APP_ALREADY_INSTALLED`.
+* Instalace nižší verze, než je aktuálně nainstalovaná, je odmítnuta s chybou `CANNOT_DOWNGRADE_APPLICATION`.
+
+K instalaci novější verze ji nejprve nasaďte nebo publikujte, poté znovu spusťte `yarn twenty app:install`.
+</Note>
diff --git a/packages/twenty-docs/l/cs/developers/extend/apps/operations/sync-and-recovery.mdx b/packages/twenty-docs/l/cs/developers/extend/apps/operations/sync-and-recovery.mdx
new file mode 100644
index 00000000000..b7661be6c40
--- /dev/null
+++ b/packages/twenty-docs/l/cs/developers/extend/apps/operations/sync-and-recovery.mdx
@@ -0,0 +1,111 @@
+---
+title: Synchronizace a obnovení
+description: Který příkaz kdy použít, jak číst výstup synchronizace a jak postupovat po jednotlivých krocích při obnově v případě odchýlení lokálních metadat — ještě předtím, než sáhnete k úplnému resetu.
+icon: kompas
+---
+
+Lokální vývoj aplikací se točí kolem **synchronizace**: CLI znovu sestaví váš manifest a server aplikuje pouze rozdíly mezi ním a metadaty, která už jsou ve vašem pracovním prostoru. Tato stránka popisuje, po kterém příkazu sáhnout, jak číst, co synchronizace změnila, a co dělat — v daném pořadí — když lokální stav vypadá nekonzistentně.
+
+## Jaký příkaz, kdy
+
+<Note>
+Pro každodenní lokální iteraci téměř vždy chcete `yarn twenty dev`. Nasazování a publikování slouží k vydávání verzí, **ne** pro lokální vývojovou smyčku.
+</Note>
+
+| Chcete… | Příkaz | Poznámky |
+| --------------------------------------------------------- | ----------------------------------- | -------------------------------------------------------------------------------------------------------------------- |
+| Iterujte lokálně s živou synchronizací | `yarn twenty dev` | Sleduje vaše soubory a při každé změně spustí synchronizaci. |
+| Jednorázová synchronizace a ukončení (CI, skripty, hooky) | `yarn twenty dev --once` | Provede jedno sestavení + synchronizaci a skončí. |
+| Náhled změn **bez jejich aplikování** | `yarn twenty dev --once --dry-run` | Spočítá a vypíše rozdíly; nic nezapisuje. |
+| Odebrat aplikaci z pracovního prostoru | `yarn twenty app:uninstall` | Přidejte `--yes` pro přeskočení výzvy. |
+| Odeslat tarball na server | `yarn twenty app:publish --private` | Vyžaduje **přísně vyšší** verzi v `package.json` — viz [Publikování](/l/cs/developers/extend/apps/operations/publishing). |
+| Publikovat na marketplace (npm) | `yarn twenty app:publish` | — |
+| Nainstalovat / aktualizovat nasazenou verzi | `yarn twenty app:install` | Nainstaluje aktuálně nasazenou verzi. |
+| Vymazat lokální server a začít znovu | `yarn twenty docker:reset` | Smaže **všechna** lokální data — krajní řešení. |
+
+### Lokální synchronizace nevyžaduje zvýšení verze
+
+Pravidlo striktně rostoucí `version` (`VERSION_ALREADY_EXISTS` při nasazení, `APP_ALREADY_INSTALLED` / `CANNOT_DOWNGRADE_APPLICATION` při instalaci) platí pro **`app:publish` / `app:install`** — cestu vydání. `yarn twenty dev` synchronizuje váš manifest na místě a nikdy nevyžaduje změnu verze, takže kvůli iteraci nemusíte sahat na `package.json`. Pokud zvyšujete verzi, abyste otestovali lokální změnu, používáte cestu vydání, i když chcete vývojovou smyčku.
+
+## Čtení výstupu synchronizace
+
+Každá synchronizace vypíše změny metadat, které aplikovala (nebo by aplikovala s `--dry-run`):
+
+```text filename="Terminal"
+Metadata changes: 2 created, 1 updated, 1 deleted
+ created objectMetadata rocket
+ created fieldMetadata timelineActivities
+ updated fieldMetadata launchedAt
+ deleted pageLayout legacyTab
+✓ Synced
+```
+
+To je váš první diagnostický nástroj: přesně ukazuje, které objekty, pole a rozložení se změnily, takže si můžete ověřit, že synchronizace udělala to, co jste očekávali, ještě před kontrolou v UI.
+
+Když synchronizace selže na jedné entitě, chyba uvede problematickou entitu a její `universalIdentifier`, například:
+
+```text
+Migration action 'create' for 'fieldMetadata' (universalIdentifier: 2020...4337) failed
+```
+
+Tento identifikátor použijte k nalezení entity ve vašem manifestu (a případně v pracovním prostoru) místo hádání, která je v konfliktu.
+
+## Náhled změn (dry run)
+
+`yarn twenty dev --once --dry-run` sestaví váš manifest, požádá server o migrační plán a vypíše ho — aniž by cokoli aplikoval. Je to bezpečný způsob, jak si předem zodpovědět otázku „co by tato synchronizace změnila?“ ještě předtím, než se k ní zavážete.
+
+```bash filename="Terminal"
+yarn twenty dev --once --dry-run
+```
+
+```text filename="Terminal"
+Building manifest...
+Computing metadata diff (dry run, nothing will be applied)...
+Metadata changes: 1 created, 1 updated
+ created fieldMetadata timelineActivities
+ updated objectMetadata rocket
+✓ Dry run complete for My App — no changes were applied
+```
+
+Spuštění nanečisto:
+
+* **Nic nezapisuje** — žádná migrace metadat, žádná aktualizace záznamu aplikace, žádné změny výchozí role / karty a žádná generace API klienta.
+* Vrací **stejný diff**, jaký by aplikovala skutečná synchronizace, takže můžete předem zkontrolovat vytvořené / aktualizované / smazané entity.
+* Je užitečný před rizikovou změnou, při kontrole změny vygenerované pomocí AI nebo ve skriptu, který má selhat, pokud se má provést neočekávaná změna.
+
+<Note>
+Režim dry run zobrazuje pouze náhled změn **metadat** a vyžaduje, aby byla aplikace alespoň jednou synchronizovaná (aby o ní pracovní prostor věděl). Pokud jej spustíte proti aplikaci, která nikdy nebyla synchronizovaná, server ohlásí, že aplikace není nainstalovaná — nejprve jednou spusťte `yarn twenty dev`.
+</Note>
+
+## Postup obnovy
+
+Když lokální metadata vypadají špatně, postupujte v tomto pořadí a zastavte se, jakmile se problém vyřeší. Každý další krok je rušivější než ten předchozí.
+
+1. **Znovu synchronizujte.** Znovu spusťte `yarn twenty dev --once`. Synchronizace jsou idempotentní — znovu spuštěný čistý manifest je bezpečný a často vyřeší přechodný problém.
+2. **Prohlédněte si plán.** Spusťte `yarn twenty dev --once --dry-run`, abyste přesně viděli, co chce další synchronizace změnit, aniž by to aplikovala.
+3. **Přečtěte si pojmenovanou chybu.** Pokud synchronizace selže, poznamenejte si typ metadat a `universalIdentifier` ve zprávě (viz výše) a tuto entitu najděte ve svém manifestu. Konflikt obvykle ukazuje na duplicitní nebo znovu použitý identifikátor.
+4. **Odinstalujte a znovu nainstalujte.** `yarn twenty app:uninstall`, poté znovu synchronizujte (`yarn twenty dev`). Tím znovu vybudujete metadata aplikace z čistého stavu, zatímco zbytek vašeho pracovního prostoru zůstane nedotčený.
+5. **Úplný reset (krajní řešení).** `yarn twenty docker:reset`, poté znovu naplňte data a synchronizujte.
+
+<Warning>
+`yarn twenty docker:reset` smaže **veškerá** data ve vaší lokální instanci — každý pracovní prostor, záznam i aplikaci. Použijte jej až tehdy, když selžou předchozí kroky.
+</Warning>
+
+<Note>
+Nastala chyba v metadatech? Prosíme, [vytvořte issue](https://github.com/twentyhq/twenty/issues/new/choose) a přiložte chybovou zprávu selhané migrace (s typem metadat a `universalIdentifier`), výstup `Metadata changes` ze synchronizace a příkazy, které jste spustili.
+</Note>
+
+## Vyhněte se souběžným synchronizacím v jednom pracovním prostoru
+
+Synchronizace aplikuje migrace metadat. Spouštění několika synchronizačních, nasazovacích nebo instalačních operací proti **stejnému pracovnímu prostoru ve stejnou dobu** — například z víc terminálů nebo od více AI agentů iterujících paralelně — může tyto migrace prokládat a zanechat metadata v částečně aplikovaném stavu.
+
+Server serializuje synchronizace pro každý pracovní prostor, aby tomu zabránil, ale přesto byste citlivé operace s metadaty měli směrovat přes **jeden jediný** proces místo toho, abyste je spouštěli souběžně. Pokud orchestrujete vývoj s více agenty, směrujte jejich volání sync/deploy/install přes jednu frontu, aby vždy běžel jen jeden proces.
+
+## Rozlišení typů selhání
+
+Když se něco pokazí, diff metadat a pojmenované chyby vám umožní lokalizovat selhání:
+
+* **Chyba sestavení manifestu** — CLI selže ještě před synchronizací (`MANIFEST_BUILD_FAILED`, `TYPECHECK_FAILED`); opravte zdrojový kód své aplikace.
+* **Chyba synchronizace / migrace** — sestavení proběhne úspěšně, ale aplikování diffu selže a uvede entitu a `universalIdentifier`; opravte konfliktní metadata.
+* **Chyba za běhu aplikačního kódu** — synchronizace proběhne úspěšně, ale vaše logické funkce nebo komponenty se za běhu chovají nesprávně; zkontrolujte [protokoly funkcí](/l/cs/developers/extend/apps/operations/cli).
+* **Lokální stav instance** — neplatí nic z výše uvedeného a pracovní prostor stále vypadá chybně; pokračujte dolů po žebříčku obnovy.
diff --git a/packages/twenty-docs/l/cs/developers/extend/apps/operations/testing.mdx b/packages/twenty-docs/l/cs/developers/extend/apps/operations/testing.mdx
new file mode 100644
index 00000000000..e9b454f9c1a
--- /dev/null
+++ b/packages/twenty-docs/l/cs/developers/extend/apps/operations/testing.mdx
@@ -0,0 +1,301 @@
+---
+title: Testování
+description: Nastavení Vitestu, integrační testy proti reálnému serveru Twenty, kontrola typů a CI s GitHub Actions.
+icon: flask
+---
+
+SDK poskytuje programová rozhraní, která vám umožní z testovacího kódu aplikaci sestavit, nasadit, nainstalovat a odinstalovat. V kombinaci s [Vitest](https://vitest.dev/) a typovanými klienty API můžete psát integrační testy, které ověří, že vaše aplikace funguje end-to-end proti reálnému serveru Twenty.
+
+## Používání balíčků npm
+
+Ve své aplikaci můžete nainstalovat a používat libovolný balíček npm. Logické funkce i frontendové komponenty se bundlují pomocí [esbuild](https://esbuild.github.io/), který vloží všechny závislosti přímo do výstupu — za běhu nejsou potřeba žádné `node_modules`.
+
+### Instalace balíčku
+
+```bash filename="Terminal"
+yarn add axios
+```
+
+Poté jej importujte ve svém kódu:
+
+```ts src/logic-functions/fetch-data.ts
+import { defineLogicFunction } from 'twenty-sdk/define';
+import axios from 'axios';
+
+const handler = async (): Promise<any> => {
+ const { data } = await axios.get('https://api.example.com/data');
+
+ return { data };
+};
+
+export default defineLogicFunction({
+ universalIdentifier: '...',
+ name: 'fetch-data',
+ description: 'Fetches data from an external API',
+ timeoutSeconds: 10,
+ handler,
+});
+```
+
+Stejně to funguje i pro frontendové komponenty:
+
+```tsx src/front-components/chart.tsx
+import { defineFrontComponent } from 'twenty-sdk/define';
+import { format } from 'date-fns';
+
+const DateWidget = () => {
+ return <p>Today is {format(new Date(), 'MMMM do, yyyy')}</p>;
+};
+
+export default defineFrontComponent({
+ universalIdentifier: '...',
+ name: 'date-widget',
+ component: DateWidget,
+});
+```
+
+### Jak funguje bundlování
+
+Krok sestavení používá esbuild k vytvoření jediného samostatného souboru pro každou logickou funkci a každou frontendovou komponentu. Všechny importované balíčky jsou vloženy přímo do bundlu.
+
+**Logické funkce** běží v prostředí Node.js. Vestavěné moduly Node (`fs`, `path`, `crypto`, `http` atd.) jsou k dispozici a není je třeba instalovat.
+
+**Frontendové komponenty** běží ve Web Workeru. Vestavěné moduly Node nejsou k dispozici — pouze prohlížečová API a balíčky npm, které fungují v prohlížečovém prostředí.
+
+V obou prostředích jsou jako předpřipravené moduly k dispozici `twenty-client-sdk/core` a `twenty-client-sdk/metadata` — nejsou součástí bundlu, ale server je za běhu načítá.
+
+## Nastavení
+
+Vygenerovaná aplikace již obsahuje Vitest. Pokud to nastavujete ručně, nainstalujte závislosti:
+
+```bash filename="Terminal"
+yarn add -D vitest vite-tsconfig-paths
+```
+
+Vytvořte `vitest.config.ts` v kořeni vaší aplikace:
+
+```ts vitest.config.ts
+import tsconfigPaths from 'vite-tsconfig-paths';
+import { defineConfig } from 'vitest/config';
+
+export default defineConfig({
+ plugins: [
+ tsconfigPaths({
+ projects: ['tsconfig.spec.json'],
+ ignoreConfigErrors: true,
+ }),
+ ],
+ test: {
+ testTimeout: 120_000,
+ hookTimeout: 120_000,
+ include: ['src/**/*.integration-test.ts'],
+ setupFiles: ['src/__tests__/setup-test.ts'],
+ env: {
+ TWENTY_API_URL: 'http://localhost:2020',
+ TWENTY_API_KEY: 'your-api-key',
+ },
+ },
+});
+```
+
+Vytvořte soubor nastavení, který před spuštěním testů ověří dostupnost serveru:
+
+```ts src/__tests__/setup-test.ts
+import * as fs from 'fs';
+import * as os from 'os';
+import * as path from 'path';
+import { beforeAll } from 'vitest';
+
+const TWENTY_API_URL = process.env.TWENTY_API_URL ?? 'http://localhost:2020';
+const TEST_CONFIG_DIR = path.join(os.tmpdir(), '.twenty-sdk-test');
+
+beforeAll(async () => {
+ // Verify the server is running
+ const response = await fetch(`${TWENTY_API_URL}/healthz`);
+
+ if (!response.ok) {
+ throw new Error(
+ `Twenty server is not reachable at ${TWENTY_API_URL}. ` +
+ 'Start the server before running integration tests.',
+ );
+ }
+
+ // Write a temporary config for the SDK
+ fs.mkdirSync(TEST_CONFIG_DIR, { recursive: true });
+
+ fs.writeFileSync(
+ path.join(TEST_CONFIG_DIR, 'config.json'),
+ JSON.stringify({
+ remotes: {
+ local: {
+ apiUrl: process.env.TWENTY_API_URL,
+ apiKey: process.env.TWENTY_API_KEY,
+ },
+ },
+ defaultRemote: 'local',
+ }, null, 2),
+ );
+});
+```
+
+## Programová rozhraní SDK
+
+Subcesta `twenty-sdk/cli` exportuje funkce, které můžete volat přímo z testovacího kódu:
+
+| Funkce | Popis |
+| -------------- | ----------------------------------------------------- |
+| `appBuild` | Sestaví aplikaci a volitelně zabalí tarball |
+| `appDeploy` | Nahraje tarball na server |
+| `appInstall` | Nainstaluje aplikaci do aktivního pracovního prostoru |
+| `appUninstall` | Odinstaluje aplikaci z aktivního pracovního prostoru |
+
+Každá funkce vrací objekt výsledku se `success: boolean` a buď `data`, nebo `error`.
+
+## Psání integračního testu
+
+Zde je kompletní příklad, který aplikaci sestaví, nasadí a nainstaluje a poté ověří, že se objeví v pracovním prostoru:
+
+```ts src/__tests__/app-install.integration-test.ts
+import { APPLICATION_UNIVERSAL_IDENTIFIER } from 'src/application-config';
+import { appBuild, appDeploy, appInstall, appUninstall } from 'twenty-sdk/cli';
+import { MetadataApiClient } from 'twenty-client-sdk/metadata';
+import { afterAll, beforeAll, describe, expect, it } from 'vitest';
+
+const APP_PATH = process.cwd();
+
+describe('App installation', () => {
+ beforeAll(async () => {
+ const buildResult = await appBuild({
+ appPath: APP_PATH,
+ tarball: true,
+ onProgress: (message: string) => console.log(`[build] ${message}`),
+ });
+
+ if (!buildResult.success) {
+ throw new Error(`Build failed: ${buildResult.error?.message}`);
+ }
+
+ const deployResult = await appDeploy({
+ tarballPath: buildResult.data.tarballPath!,
+ onProgress: (message: string) => console.log(`[deploy] ${message}`),
+ });
+
+ if (!deployResult.success) {
+ throw new Error(`Deploy failed: ${deployResult.error?.message}`);
+ }
+
+ const installResult = await appInstall({ appPath: APP_PATH });
+
+ if (!installResult.success) {
+ throw new Error(`Install failed: ${installResult.error?.message}`);
+ }
+ });
+
+ afterAll(async () => {
+ await appUninstall({ appPath: APP_PATH });
+ });
+
+ it('should find the installed app in the workspace', async () => {
+ const metadataClient = new MetadataApiClient();
+
+ const result = await metadataClient.query({
+ findManyApplications: {
+ id: true,
+ name: true,
+ universalIdentifier: true,
+ },
+ });
+
+ const installedApp = result.findManyApplications.find(
+ (app: { universalIdentifier: string }) =>
+ app.universalIdentifier === APPLICATION_UNIVERSAL_IDENTIFIER,
+ );
+
+ expect(installedApp).toBeDefined();
+ });
+});
+```
+
+## Spuštění testů
+
+Ujistěte se, že běží váš lokální server Twenty, a poté:
+
+```bash filename="Terminal"
+yarn test
+```
+
+Nebo v režimu watch během vývoje:
+
+```bash filename="Terminal"
+yarn test:watch
+```
+
+## Kontrola typů
+
+Kontrolu typů můžete spustit i na vaší aplikaci bez spuštění testů:
+
+```bash filename="Terminal"
+yarn twenty dev:typecheck
+```
+
+Spustí se `tsc --noEmit` a nahlásí se případné chyby typů.
+
+## CI s GitHub Actions
+
+Generátor kostry vytvoří připravený k použití workflow GitHub Actions v `.github/workflows/ci.yml`. Automaticky spouští integrační testy při každém pushi do `main` a u pull requestů.
+
+Workflow:
+
+1. Načte váš kód (checkout).
+2. Spustí dočasný server Twenty pomocí akce `twentyhq/twenty/.github/actions/spawn-twenty-docker-image`
+3. Nainstaluje závislosti pomocí `yarn install --immutable`
+4. Spustí `yarn test` s proměnnými `TWENTY_API_URL` a `TWENTY_API_KEY` vloženými z výstupů akce
+
+```yaml .github/workflows/ci.yml
+name: CI
+
+on:
+ push:
+ branches:
+ - main
+ pull_request: {}
+
+env:
+ TWENTY_VERSION: latest
+
+jobs:
+ test:
+ runs-on: ubuntu-latest
+ steps:
+ - name: Checkout
+ uses: actions/checkout@v4
+
+ - name: Spawn Twenty instance
+ id: twenty
+ uses: twentyhq/twenty/.github/actions/spawn-twenty-docker-image@main
+ with:
+ twenty-version: ${{ env.TWENTY_VERSION }}
+ github-token: ${{ secrets.GITHUB_TOKEN }}
+
+ - name: Enable Corepack
+ run: corepack enable
+
+ - name: Setup Node.js
+ uses: actions/setup-node@v4
+ with:
+ node-version-file: '.nvmrc'
+ cache: 'yarn'
+
+ - name: Install dependencies
+ run: yarn install --immutable
+
+ - name: Run integration tests
+ run: yarn test
+ env:
+ TWENTY_API_URL: ${{ steps.twenty.outputs.server-url }}
+ TWENTY_API_KEY: ${{ steps.twenty.outputs.access-token }}
+```
+
+Není potřeba konfigurovat žádné secrets — akce `spawn-twenty-docker-image` spustí dočasný server Twenty přímo v runneru a vypíše podrobnosti připojení. Secret `GITHUB_TOKEN` je poskytován GitHubem automaticky.
+
+Chcete-li připnout konkrétní verzi Twenty místo `latest`, změňte proměnnou prostředí `TWENTY_VERSION` na začátku workflow.
diff --git a/packages/twenty-docs/l/cs/developers/extend/capabilities/apis.mdx b/packages/twenty-docs/l/cs/developers/extend/capabilities/apis.mdx
index e9f738487ed..b6406f571fa 100644
--- a/packages/twenty-docs/l/cs/developers/extend/capabilities/apis.mdx
+++ b/packages/twenty-docs/l/cs/developers/extend/capabilities/apis.mdx
@@ -88,7 +88,7 @@ Váš klíč API poskytuje přístup k citlivým datům. Nesdílejte ho s nedův
Pro vyšší bezpečnost přiřaďte konkrétní roli, abyste omezili přístup:
-1. Přejděte na **Nastavení → Role**
+1. Přejděte na **Nastavení → Členové → Role**
2. Klikněte na roli, kterou chcete přiřadit
3. Otevřete záložku **Přiřazení**
4. V části **API Keys** klikněte na **+ Přiřadit ke klíči API**
diff --git a/packages/twenty-docs/l/cs/developers/self-host/capabilities/docker-compose.mdx b/packages/twenty-docs/l/cs/developers/self-host/capabilities/docker-compose.mdx
index 76b0fbe6504..e7a3f7c46d5 100644
--- a/packages/twenty-docs/l/cs/developers/self-host/capabilities/docker-compose.mdx
+++ b/packages/twenty-docs/l/cs/developers/self-host/capabilities/docker-compose.mdx
@@ -51,7 +51,7 @@ Postupujte podle těchto kroků pro ruční nastavení.
curl -o .env https://raw.githubusercontent.com/twentyhq/twenty/refs/heads/main/packages/twenty-docker/.env.example
```
-2. **Vygenerujte tajné tokeny**
+2. **Vygenerujte šifrovací klíč**
Spusťte následující příkaz k generování jedinečného náhodného řetězce:
@@ -59,16 +59,18 @@ Postupujte podle těchto kroků pro ruční nastavení.
openssl rand -base64 32
```
- **Důležité:** Udržujte tuto hodnotu v tajnosti / nesdílejte ji.
+ **Důležité:** Udržujte tuto hodnotu v tajnosti / nesdílejte ji. Ztráta `ENCRYPTION_KEY` znamená ztrátu přístupu ke všem tajným údajům uloženým v databázi (OAuth tokeny, aplikační proměnné, TOTP tajemství atd.).
3. **Aktualizujte `.env` soubor**
Nahraďte místoblokovou hodnotu ve svém .env souboru vygenerovaným tokenem:
```ini
- APP_SECRET=první_náhodný_řetězec
+ ENCRYPTION_KEY=random_string
```
+ Podívejte se na [průvodce rotací klíče](/l/cs/developers/self-host/capabilities/key-rotation) pro pokyny, jak jej rotovat bez prostojů.
+
4. **Nastavte Heslo pro Postgres**
Aktualizujte hodnotu `PG_DATABASE_PASSWORD` ve vašem .env souboru silným heslem bez speciálních znaků.
diff --git a/packages/twenty-docs/l/cs/developers/self-host/capabilities/key-rotation.mdx b/packages/twenty-docs/l/cs/developers/self-host/capabilities/key-rotation.mdx
new file mode 100644
index 00000000000..3b48efc2bfc
--- /dev/null
+++ b/packages/twenty-docs/l/cs/developers/self-host/capabilities/key-rotation.mdx
@@ -0,0 +1,60 @@
+---
+title: Rotace klíčů
+icon: rotate
+---
+
+Twenty má dvě nezávislé rodiny klíčů:
+
+* **Klíče pro podepisování JWT** — asymetrické páry klíčů ES256 (označené `kid`), uložené v `core."signingKey"`, používané k podepisování a ověřování přístupových/obnovovacích tokenů.
+* **Šifrovací klíč pro data v klidu** — `ENCRYPTION_KEY`, používaný k šifrování OAuth tokenů, aplikačních proměnných, soukromých klíčů podepisovacích klíčů, citlivých konfiguračních hodnot a TOTP tajemství uvnitř obálky `enc:v2:`.
+
+`APP_SECRET` je starší tajný klíč ponechaný kvůli zpětné kompatibilitě: pokud `ENCRYPTION_KEY` není nastaven, slouží jako záložní řešení pro šifrování dat v klidu i pro soubory cookie relace a stále ověřuje dříve existující HS256 přístupové tokeny. Bude označen jako zastaralý (deprecated).
+
+## Klíče pro podepisování JWT
+
+Každý klíč nese `publicKey` (uchovávaný neomezeně dlouho, aby mohl ověřovat dříve vydané tokeny), zašifrovaný `privateKey` (používaný pouze tehdy, když je klíč aktuální), příznak `isCurrent` (vždy přesně jeden záznam) a volitelné `revokedAt`.
+
+### Rotace aktuálního klíče
+
+Nastavte `SIGNING_KEY_ROTATION_DAYS`, chcete-li funkci povolit: denní cron poté vydá nový klíč jako aktuální, jakmile je stávající starší než zadaný práh. Předchozí klíče *nejsou* odvolány, takže tokeny pod nimi podepsané se dál úspěšně ověřují. Ponechte proměnnou nenastavenou, abyste deaktivovali automatickou rotaci.
+
+<Note>Automatická rotace je k dispozici od verze v2.6+.</Note>
+
+### Odvolání klíče (pouze při úniku / v nouzi)
+
+**Settings → Admin Panel → Signing keys → Revoke** na neaktuálním řádku. Smaže zašifrovaný privátní materiál, nastaví `revokedAt` a odmítne každý existující token podepsaný pod daným `kid`.
+
+## Rotace `ENCRYPTION_KEY`
+
+<Note>Příkaz `secret-encryption:rotate` popsaný níže je k dispozici od verze v2.6+.</Note>
+
+Každá zašifrovaná hodnota je zabalena jako `enc:v2:\<keyId>:\<payload>`, kde `\<keyId>` je 8místný hexadecimální prefix odvozený ze surového klíče. Rotace probíhá online a je možné ji kdykoli znovu spustit.
+
+1. **Vygenerujte nový klíč**: `openssl rand -base64 32`.
+
+2. **Nakonfigurujte oba klíče vedle sebe** v `.env` a poté restartujte:
+ ```ini
+ ENCRYPTION_KEY=NEW_VALUE
+ FALLBACK_ENCRYPTION_KEY=OLD_VALUE
+ ```
+ Nové zápisy používají nový klíč, existující řádky se stále dešifrují pomocí záložního klíče.
+
+3. **Znovu zašifrujte existující řádky**:
+
+ ```bash
+ docker exec -it {server_container} yarn command:prod secret-encryption:rotate
+ ```
+
+ Příkaz prochází šest míst (`connected-account-tokens`, `application-variable`, `application-registration-variable`, `signing-key-private-keys`, `sensitive-config-storage`, `totp-secrets`). SQL filtr přeskočí řádky, které už jsou na novém `\<keyId>`, takže příkaz je idempotentní: přerušte ho a znovu spusťte podle potřeby. Ukončí se s nenulovým kódem, pokud jakýkoli řádek selže — spusťte znovu pro opakování.
+
+ | Přepínač | Popis |
+ | ---------------------------------------- | -------------------------------------------------------- |
+ | `-s, --site \<site>` | Omezí běh na jedno místo (site). |
+ | `-b, --batch-size \<n>` | Počet řádků v dávce (výchozí `200`, maximum `5000`). |
+ | `-d, --dry-run` | Dešifruje + znovu zašifruje v paměti, přeskočí `UPDATE`. |
+
+4. **Odstraňte záložní klíč** jakmile `--dry-run` ukáže, že nezbývají žádné řádky: odeberte `FALLBACK_ENCRYPTION_KEY` a restartujte.
+
+## Podpora staršího `APP_SECRET`
+
+Starší instance, které nikdy nenastavily `ENCRYPTION_KEY`, používají `APP_SECRET` jako šifrovací klíč pro data v klidu (a jako tajemství pro soubor cookie relace, odvozené z něj). Tato cesta je zachována kvůli zpětné kompatibilitě, ale je **zastaralá (deprecated)** — nastavte vyhrazený `ENCRYPTION_KEY` a podle výše uvedeného postupu rotace proveďte migraci pryč od něj. Samotný `APP_SECRET` zůstává v používání pro ověřování starších HS256 přístupových tokenů.
diff --git a/packages/twenty-docs/l/cs/developers/self-host/capabilities/setup.mdx b/packages/twenty-docs/l/cs/developers/self-host/capabilities/setup.mdx
index 7be493c838d..846407eef03 100644
--- a/packages/twenty-docs/l/cs/developers/self-host/capabilities/setup.mdx
+++ b/packages/twenty-docs/l/cs/developers/self-host/capabilities/setup.mdx
@@ -43,11 +43,26 @@ IS_CONFIG_VARIABLES_IN_DB_ENABLED=true # výchozí
<Warning>
Každá proměnná je dokumentována s popisy ve vašem administračním panelu v sekci **Nastavení → Admin panel → Konfigurační proměnné**.
-Některá nastavení infrastruktury, jako připojení k databázi (`PG_DATABASE_URL`), URL serveru (`SERVER_URL`) a tajemství aplikace (`APP_SECRET`), lze konfigurovat pouze prostřednictvím souboru `.env`.
+Některá nastavení infrastruktury, jako připojení k databázi (`PG_DATABASE_URL`), URL serveru (`SERVER_URL`) a tajné klíče (`ENCRYPTION_KEY`, `FALLBACK_ENCRYPTION_KEY`), lze konfigurovat pouze prostřednictvím souboru `.env`.
[Kompletní technická referenční příručka →](https://github.com/twentyhq/twenty/blob/main/packages/twenty-server/src/engine/core-modules/twenty-config/config-variables.ts)
</Warning>
+## Šifrovací klíče
+
+Twenty používá dva šifrovací klíče dostupné pouze přes proměnné prostředí:
+
+| Proměnná | Účel | Povinné |
+| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------- |
+| `ENCRYPTION_KEY` | Primární klíč používaný k šifrování tajných hodnot „v klidu“ (tokeny OAuth, aplikační proměnné, privátní klíče podepisovacích klíčů, TOTP tajné kódy, citlivé konfigurační hodnoty). | Ano pro nové instalace (starší instalace se mohou místo toho spoléhat na `APP_SECRET` — viz níže) |
+| `FALLBACK_ENCRYPTION_KEY` | Klíč používaný pouze k ověřování. Během rotace se nastavuje na *předchozí* hodnotu `ENCRYPTION_KEY`, aby bylo možné dešifrovat stávající řádky. | Pouze během rotace |
+
+Kvůli zpětné kompatibilitě, pokud `ENCRYPTION_KEY` není nastaven, Twenty používá pro šifrování „v klidu“ záložně `APP_SECRET`, což odpovídá původnímu chování starších nasazení. Nové instalace by vždy měly nastavit dedikovaný `ENCRYPTION_KEY`.
+
+Hodnoty vygenerujte pomocí `openssl rand -base64 32` a uložte je na bezpečné místo (správce tajných klíčů, zapečetěná konfigurace apod.). Ztráta `ENCRYPTION_KEY` znamená ztrátu přístupu ke všem tajným hodnotám uloženým v databázi.
+
+Jak provést rotaci `ENCRYPTION_KEY` bez výpadku, najdete v [průvodci rotací klíče](/l/cs/developers/self-host/capabilities/key-rotation).
+
## 2. Konfigurace pouze přes prostředí
```bash
diff --git a/packages/twenty-docs/l/cs/developers/self-host/capabilities/upgrade-guide.mdx b/packages/twenty-docs/l/cs/developers/self-host/capabilities/upgrade-guide.mdx
index 9f2b4a2b0b5..0bc8cd6f052 100644
--- a/packages/twenty-docs/l/cs/developers/self-host/capabilities/upgrade-guide.mdx
+++ b/packages/twenty-docs/l/cs/developers/self-host/capabilities/upgrade-guide.mdx
@@ -31,6 +31,18 @@ Počínaje **v1.22** podporuje Twenty upgrade napříč verzemi. Můžete přej
Například přechod z v1.22 přímo na v2.0 je plně podporován.
+## Aktualizace na v2.5+ — obálka pro šifrování dat v klidu
+
+Od **v2.5** ukládá Twenty tajné údaje v klidu (OAuth tokeny, aplikační proměnné, privátní klíče pro podepisování, citlivé konfigurační hodnoty, TOTP tajemství) do verzované obálky `enc:v2:`, která je šifrovaná pomocí `ENCRYPTION_KEY` (nebo `APP_SECRET`, pokud není `ENCRYPTION_KEY` nastavený).
+
+Při prvním startu na v2.5 se spustí pomalé aktualizační příkazy, které **zpětně doplní** stávající řádky do nové obálky. Jsou idempotentní — při přerušení a opětovném spuštění server pokračuje tam, kde skončil — ale u velkých databází to může chvíli trvat. Postup můžete sledovat pomocí `upgrade:status`.
+
+Měli byste nastavit vyhrazený `ENCRYPTION_KEY` **před** upgradem na v2.5, aby zpětné doplňování od začátku zapisovalo řádky pod tímto klíčem. Změna klíčů po dokončení doplnění vyžaduje [rotaci](/l/cs/developers/self-host/capabilities/key-rotation).
+
+## Rotace tajemství a podepisovacích klíčů
+
+Pro běžné provozní úkony, jako je rotace `ENCRYPTION_KEY`, rotace podepisovacího klíče JWT nebo zneplatnění uniklého podepisovacího klíče, viz samostatný [průvodce rotací klíčů](/l/cs/developers/self-host/capabilities/key-rotation).
+
## Kontrola stavu upgradu
Příkaz `upgrade:status` vám umožní zkontrolovat aktuální stav vaší instance a migrací pracovních prostorů. Je užitečný pro ladění problémů s upgradem nebo při podávání požadavku na podporu.
diff --git a/packages/twenty-docs/l/cs/navigation.json b/packages/twenty-docs/l/cs/navigation.json
index 0e2312bdee2..796d5edacb4 100644
--- a/packages/twenty-docs/l/cs/navigation.json
+++ b/packages/twenty-docs/l/cs/navigation.json
@@ -155,7 +155,27 @@
"label": "Přehled"
},
"apps": {
- "label": "Aplikace"
+ "label": "Aplikace",
+ "groups": {
+ "appsGettingStarted": {
+ "label": "Začínáme"
+ },
+ "appsConfig": {
+ "label": "Konfigurace"
+ },
+ "appsData": {
+ "label": "Data"
+ },
+ "appsLogic": {
+ "label": "Logika"
+ },
+ "appsLayout": {
+ "label": "Rozvržení"
+ },
+ "appsOperations": {
+ "label": "Operace"
+ }
+ }
},
"api": {
"label": "API"
diff --git a/packages/twenty-docs/l/cs/twenty-ui/input/text.mdx b/packages/twenty-docs/l/cs/twenty-ui/input/text.mdx
index c323d68ddbd..a6e7e6ce66c 100644
--- a/packages/twenty-docs/l/cs/twenty-ui/input/text.mdx
+++ b/packages/twenty-docs/l/cs/twenty-ui/input/text.mdx
@@ -39,7 +39,7 @@ export const MyComponent = () => {
/>
);
};
-},{
+
```
diff --git a/packages/twenty-docs/l/cs/user-guide/ai/capabilities/mcp.mdx b/packages/twenty-docs/l/cs/user-guide/ai/capabilities/mcp.mdx
index c1d971065aa..1e1a45a0557 100644
--- a/packages/twenty-docs/l/cs/user-guide/ai/capabilities/mcp.mdx
+++ b/packages/twenty-docs/l/cs/user-guide/ai/capabilities/mcp.mdx
@@ -103,11 +103,10 @@ Požádejte svého AI asistenta, aby pracoval s vaším CRM:
Po připojení server MCP zpřístupní nástroje, které odpovídají rozhraní Twenty API. Doporučený pracovní postup je:
-1. **`get_tool_catalog`** — zjistit všechny dostupné nástroje
-2. **`learn_tools`** — získat vstupní schéma pro konkrétní nástroje
-3. **`execute_tool`** — spustit nástroj
+1. **`learn_tools`** — získat vstupní schéma pro konkrétní nástroje
+2. **`execute_tool`** — spustit nástroj
-Není potřeba si pamatovat názvy nástrojů. Zeptejte se svého AI asistenta, co umí, a automaticky zavolá `get_tool_catalog`.
+Není potřeba si pamatovat názvy nástrojů. Zeptejte se svého AI asistenta, co umí, a automaticky zavolá `learn_tools`.
## Oprávnění
diff --git a/packages/twenty-docs/l/cs/user-guide/ai/capabilities/permissions-access-control.mdx b/packages/twenty-docs/l/cs/user-guide/ai/capabilities/permissions-access-control.mdx
index 915c707a181..ce678b9ade9 100644
--- a/packages/twenty-docs/l/cs/user-guide/ai/capabilities/permissions-access-control.mdx
+++ b/packages/twenty-docs/l/cs/user-guide/ai/capabilities/permissions-access-control.mdx
@@ -9,7 +9,7 @@ Agenti AI respektují vaši stávající strukturu oprávnění. To je obzvláš
## Přiřadit roli agentovi AI
-1. Přejděte na **Nastavení → Role**
+1. Přejděte na **Nastavení → Členové → Role**
2. Klikněte na roli, kterou chcete přiřadit
3. Otevřete záložku **Přiřazení**
4. V části **Agenti AI** klikněte na **+ Přiřadit agentovi AI**
diff --git a/packages/twenty-docs/l/cs/user-guide/ai/how-tos/ai-faq.mdx b/packages/twenty-docs/l/cs/user-guide/ai/how-tos/ai-faq.mdx
index 3811ecb18d6..e5f36562c4c 100644
--- a/packages/twenty-docs/l/cs/user-guide/ai/how-tos/ai-faq.mdx
+++ b/packages/twenty-docs/l/cs/user-guide/ai/how-tos/ai-faq.mdx
@@ -17,7 +17,7 @@ description: Často kladené otázky k funkcím AI v Twenty.
</Accordion>
<Accordion title="Budou mít AI agenti přístup ke všem mým datům?">
- AI agenti budou fungovat v rámci systému oprávnění. V části **Nastavení → Role** můžete AI agentům přiřadit konkrétní role, čímž získáte plnou kontrolu nad tím, k jakým datům mají přístup a jaké akce mohou provádět.
+ AI agenti budou fungovat v rámci systému oprávnění. V části **Nastavení → Členové → Role** můžete AI agentům přiřadit konkrétní role, čímž získáte plnou kontrolu nad tím, k jakým datům mají přístup a jaké akce mohou provádět.
</Accordion>
<Accordion title="Jak budou fungovat kredity pro AI?">
diff --git a/packages/twenty-docs/l/cs/user-guide/ai/overview.mdx b/packages/twenty-docs/l/cs/user-guide/ai/overview.mdx
index 37c61d0b37e..162ff64cc28 100644
--- a/packages/twenty-docs/l/cs/user-guide/ai/overview.mdx
+++ b/packages/twenty-docs/l/cs/user-guide/ai/overview.mdx
@@ -48,7 +48,7 @@ Rozšiřte své pracovní postupy o akce poháněné AI a autonomní agenty.
AI agenti budou spravováni prostřednictvím stávajícího systému oprávnění:
-1. Přejděte na **Nastavení → Role**
+1. Přejděte na **Nastavení → Členové → Role**
2. Nastavte, k jakým datům může mít každý AI agent přístup
3. Nastavte oprávnění pro čtení/zápis pro jednotlivé objekty
diff --git a/packages/twenty-docs/l/cs/user-guide/billing/capabilities/pricing-plans.mdx b/packages/twenty-docs/l/cs/user-guide/billing/capabilities/pricing-plans.mdx
index 17a7eeb54dc..88a2f743f95 100644
--- a/packages/twenty-docs/l/cs/user-guide/billing/capabilities/pricing-plans.mdx
+++ b/packages/twenty-docs/l/cs/user-guide/billing/capabilities/pricing-plans.mdx
@@ -19,7 +19,7 @@ Pro týmy připravené škálovat:
* Standardní podpora
<Note>
-Premium features (SSO, row-level permissions and AI usage data) are not included in the Pro plan.
+Prémiové funkce (SSO, oprávnění na úrovni řádků a údaje o využití AI) nejsou součástí plánu Pro.
</Note>
### Organizace (Cloud)
@@ -27,7 +27,7 @@ Premium features (SSO, row-level permissions and AI usage data) are not included
Pro větší týmy s pokročilými potřebami:
* Vše z plánu Pro
-* **Premium features**: SSO integration, row-level permissions and AI usage data
+* **Prémiové funkce**: integrace SSO, oprávnění na úrovni řádků a údaje o využití AI
* Prioritní podpora
## Plány pro self‑hosting
@@ -45,7 +45,7 @@ Hostujte Twenty na vlastní infrastruktuře bez poplatků:
Pro týmy, které při self‑hostingu potřebují prémiové funkce:
* Všechny funkce plánu Pro
-* **Premium features**: SSO integration, row-level permissions and AI usage data
+* **Prémiové funkce**: integrace SSO, oprávnění na úrovni řádků a údaje o využití AI
* Podpora týmu Twenty
* Není vyžadováno zveřejnit vlastní kód jako open‑source před distribucí
@@ -55,7 +55,7 @@ Prémiové funkce jsou dostupné pouze v plánech Organizace (Cloud nebo self‑
* **Integrace SSO**: jednotné přihlášení s vaším poskytovatelem identity
* **Oprávnění na úrovni řádků**: jemně odstupňované řízení přístupu na úrovni záznamu
-* **AI usage data**: Track AI consumption across the workspace
+* **Údaje o využití AI**: Sledujte spotřebu AI napříč pracovním prostorem
## Přepínání plánů
@@ -79,14 +79,14 @@ Chcete-li přejít na nižší plán, kontaktujte podporu.
Chcete-li přepnout zpět na měsíční fakturaci, kontaktujte podporu.
-## Obtain an Enterprise Key for Organization (Self-Hosted)
+## Získejte klíč Enterprise pro Organization (Self-Hosted)
-To use the Organization (Self-Hosted) plan, you need to obtain an Enterprise key:
+Chcete-li používat plán Organization (Self-Hosted), musíte získat klíč Enterprise:
-1. Go to **Settings → Admin Panel → Enterprise**
+1. Jděte na **Nastavení → Admin panel → Enterprise**
-<img src="/images/user-guide/billing/enterprise-key.png" alt="Enterprise key" />
+<img src="/images/user-guide/billing/enterprise-key.png" alt="Klíč Enterprise" />
-2. Click **Get Enterprise Key**
-3. When you are redirected to Stripe, enter your payment details and confirm
-4. When your Enterprise key is displayed, paste it into the Enterprise settings page and activate the Organization license
+2. Klikněte na **Získat klíč Enterprise**
+3. Po přesměrování na Stripe zadejte platební údaje a potvrďte
+4. Jakmile se zobrazí váš klíč Enterprise, vložte jej na stránku nastavení Enterprise a aktivujte licenci Organization
diff --git a/packages/twenty-docs/l/cs/user-guide/calendar-emails/overview.mdx b/packages/twenty-docs/l/cs/user-guide/calendar-emails/overview.mdx
index 5c2cc77b01f..db08603d896 100644
--- a/packages/twenty-docs/l/cs/user-guide/calendar-emails/overview.mdx
+++ b/packages/twenty-docs/l/cs/user-guide/calendar-emails/overview.mdx
@@ -25,15 +25,25 @@ description: Připojte své účty e-mailu a kalendáře k Twenty.
6. Nastavte synchronizaci kalendáře (viditelnost, automatické vytváření) → klikněte na **Přidat účet**
7. Vaše e-maily a události v kalendáři se začnou synchronizovat automaticky
-### Nastavení SMTP/CalDAV (Další Poskytovatelé)
+### Nastavení IMAP/SMTP/CalDAV (Další poskytovatelé)
Pro další poskytovatele emailu a kalendáře:
1. Přejděte na **Nastavení → Účty**
-2. Nakonfigurujte nastavení SMTP pro email
+2. Nakonfigurujte nastavení IMAP pro synchronizaci příchozích e-mailů a nastavení SMTP pro odesílání e-mailů
3. Nakonfigurujte nastavení CalDAV pro kalendář
4. Otestujte připojení
+<Note>
+**Vlastní hostování v oddělené (air-gapped) nebo interní síti**: Ve výchozím nastavení Twenty odmítá odchozí připojení na soukromé/interní IP adresy (ochrana proti SSRF). Pokud váš poštovní nebo kalendářový server běží na místní/soukromé IP adrese (např. on-premise server v síti LAN), připojení k němu budou blokována. Abyste je povolili, nastavte na serveru následující proměnnou prostředí:
+
+```
+OUTBOUND_HTTP_SAFE_MODE_ENABLED=false
+```
+
+Tímto deaktivujete bezpečný režim pro **všechny** odchozí požadavky (HTTP akce v pracovních postupech, webhooky a IMAP/SMTP/CalDAV připojení), takže jej nastavujte pouze v důvěryhodných, izolovaných sítích, kde není ochrana proti SSRF potřeba.
+</Note>
+
### Více Poštovních Schránek
* **Neomezené Účty**: Připojte více emailových účtů na uživatele
@@ -59,10 +69,19 @@ Vyberte různé úrovně viditelnosti pro vaše emaily:
* **Deaktivováno**: Žádné automatické vytváření kontaktů
* **Pro zprávy odeslané a přijaté**: Vytvářejte kontakty pro všechny externí emailové interakce
* **Pouze pro odeslané zprávy**: Vytvářejte kontakty pouze pro emaily, které posíláte
-* **Poznámka**: Interní emaily (stejná doména) nejsou synchronizovány kvůli zachování soukromí
+* **Poznámka**: Ve výchozím nastavení se interní e-maily (kde všichni účastníci sdílejí vaši doménu) nesynchronizují z důvodu ochrany soukromí
<Note>Když je povoleno, kontakty se automaticky propojí se svými záznamy společnosti podle jejich e-mailové domény. Pokud společnost ještě neexistuje, Twenty ji pro vás vytvoří.</Note>
+<Note>
+**Synchronizace interních e-mailů**: Chování „interní e-maily se nesynchronizují“ je výchozí, ale lze jej vypnout. Přepínač se nachází v pokročilém nastavení:
+1. Otevřete **Nastavení** a v dolní části stránky s nastavením zapněte přepínač **Pokročilé**
+2. Přejděte na **Obecné → Zabezpečení**
+3. Zapněte přepínač **Synchronizovat interní e-maily**, aby byly zahrnuty e-maily, kde všichni účastníci sdílejí stejnou doménu
+
+Jedná se o nastavení pro celý workspace (užitečné pro univerzity nebo organizace se sdílenou doménou).
+</Note>
+
### Nastavte, které e-maily se budou synchronizovat pomocí Výběru Složek Zpráv
Ovládejte, které emailové složky se synchronizují s Twenty:
@@ -79,7 +98,7 @@ Toto vám dává přesnou kontrolu nad tím, které emaily se objeví ve vašem
**Co se Synchronizuje:**
* **Externí Emaily**: Všechny emaily s externími kontakty z vybraných složek
-* **Interní Emaily**: Není synchronizováno (emaily ve stejné doméně zůstávají soukromé)
+* **Interní e-maily**: Ve výchozím nastavení se nesynchronizují (e-maily ve stejné doméně zůstávají soukromé). V dolní části **Nastavení** zapněte přepínač **Pokročilé** a poté v **Obecné → Zabezpečení** zapněte **Synchronizovat interní e-maily**, abyste je zahrnuli v rámci celého workspace.
* **Přílohy**: Přichází v H1 2026
**Poznámka**: Neposkytujeme CC emailovou adresu pro selektivní synchronizaci. Místo toho použijte výše uvedenou funkci Složka Zpráv pro dosažení stejné úrovně kontroly nad tím, které emaily se synchronizují s Twenty.
diff --git a/packages/twenty-docs/l/cs/user-guide/data-migration/capabilities/field-mapping.mdx b/packages/twenty-docs/l/cs/user-guide/data-migration/capabilities/field-mapping.mdx
index 2df33637034..c78c5045dfd 100644
--- a/packages/twenty-docs/l/cs/user-guide/data-migration/capabilities/field-mapping.mdx
+++ b/packages/twenty-docs/l/cs/user-guide/data-migration/capabilities/field-mapping.mdx
@@ -56,7 +56,7 @@ Adresa je vnořené pole s více sloupci. Některé lze ponechat prázdné.
Použijte následující formát:
```
-[\"value1\",\"value2\"]
+["value1","value2"]
```
### Booleovská pole
@@ -94,7 +94,7 @@ Podporované formáty:
* Pro další e‑maily: použijte **E‑maily / Primární e‑mail** pro hlavní e‑mail a **E‑maily / Další e‑maily** v tomto formátu:
```
```
### Pole ID
@@ -125,7 +125,7 @@ Podobně jako u doménových polí:
* Pro sekundární odkazy použijte sloupec **Odkazy / Sekundární odkazy** v tomto formátu:
```
-[{\"url\":\"https://twenty.com\",\"label\":\"Twenty\"}]
+[{"url":"https://twenty.com","label":"Twenty"}]
```
### Pole s vícenásobným výběrem
@@ -133,7 +133,7 @@ Podobně jako u doménových polí:
Použijte **názvy API** (nikoli zobrazované popisky) v následujícím formátu:
```
-[\"VALUE1\",\"VALUE2\"]
+["VALUE1","VALUE2"]
```
Viz [zde](#finding-api-names-for-select-fields), kde najdete názvy API.
@@ -143,7 +143,7 @@ Viz [zde](#finding-api-names-for-select-fields), kde najdete názvy API.
<Warning>
**Import přepisuje, nepřidává.**
-Pokud má záznam již vybrány `VALUE2` a `VALUE3` a vy importujete `[\"VALUE1\"]`, bude mít po importu pouze `VALUE1`. Předchozí výběry se nahrazují, neslučují.
+Pokud má záznam již vybrány `VALUE2` a `VALUE3` a vy importujete `["VALUE1"]`, bude mít po importu pouze `VALUE1`. Předchozí výběry se nahrazují, neslučují.
</Warning>
### Číselná pole
diff --git a/packages/twenty-docs/l/cs/user-guide/data-migration/capabilities/file-formats.mdx b/packages/twenty-docs/l/cs/user-guide/data-migration/capabilities/file-formats.mdx
index 121d6c02918..d34b6262c28 100644
--- a/packages/twenty-docs/l/cs/user-guide/data-migration/capabilities/file-formats.mdx
+++ b/packages/twenty-docs/l/cs/user-guide/data-migration/capabilities/file-formats.mdx
@@ -25,7 +25,7 @@ Twenty podporuje pro import tři formáty souborů:
## Osvědčené postupy pro CSV
* **Oddělovač**: Použijte čárku (`,`) nebo středník (`;`)
-* **Textový kvalifikátor**: Použijte dvojité uvozovky (`\"`) pro text obsahující čárky
+* **Textový kvalifikátor**: Použijte dvojité uvozovky (`"`) pro text obsahující čárky
* **Konce řádků**: Windows (CRLF) nebo Unix (LF), obojí je podporováno
* **Prázdné hodnoty**: Nechte buňky prázdné, nepoužívejte "NULL" ani "N/A"
diff --git a/packages/twenty-docs/l/cs/user-guide/data-migration/how-tos/migrating-from-other-crms.mdx b/packages/twenty-docs/l/cs/user-guide/data-migration/how-tos/migrating-from-other-crms.mdx
index 7ea5b8fedb1..90f68adb076 100644
--- a/packages/twenty-docs/l/cs/user-guide/data-migration/how-tos/migrating-from-other-crms.mdx
+++ b/packages/twenty-docs/l/cs/user-guide/data-migration/how-tos/migrating-from-other-crms.mdx
@@ -214,7 +214,7 @@ Po importu dat dokončete konfiguraci pracovního prostoru:
### Nakonfigurujte role a oprávnění
-* Nakonfigurujte role v **Settings → Roles**
+* Nakonfigurujte role v **Settings → Members → Roles**
* Přiřaďte uživatele ke vhodným rolím
### Propojte e-mail a kalendář
diff --git a/packages/twenty-docs/l/cs/user-guide/data-migration/how-tos/migrating-from-self-hosted-to-cloud.mdx b/packages/twenty-docs/l/cs/user-guide/data-migration/how-tos/migrating-from-self-hosted-to-cloud.mdx
index d36620215e5..2bf1149eff7 100644
--- a/packages/twenty-docs/l/cs/user-guide/data-migration/how-tos/migrating-from-self-hosted-to-cloud.mdx
+++ b/packages/twenty-docs/l/cs/user-guide/data-migration/how-tos/migrating-from-self-hosted-to-cloud.mdx
@@ -127,7 +127,7 @@ Po importu dat ručně znovu vytvořte:
### Role a oprávnění
-* Nakonfigurujte role v **Settings → Roles**
+* Nakonfigurujte role v **Settings → Members → Roles**
* Přiřaďte uživatele ke vhodným rolím
### Integrace
diff --git a/packages/twenty-docs/l/cs/user-guide/data-migration/how-tos/prepare-your-csv-files.mdx b/packages/twenty-docs/l/cs/user-guide/data-migration/how-tos/prepare-your-csv-files.mdx
index 0c3c5d13137..8e40e9cbc3d 100644
--- a/packages/twenty-docs/l/cs/user-guide/data-migration/how-tos/prepare-your-csv-files.mdx
+++ b/packages/twenty-docs/l/cs/user-guide/data-migration/how-tos/prepare-your-csv-files.mdx
@@ -65,7 +65,7 @@ Různé typy polí vyžadují specifické formáty. Zde je úplný přehled:
* Pro další e‑maily použijte tento formát ve sloupci **E‑maily / Další e‑maily**:
```
```
### Doménová pole
diff --git a/packages/twenty-docs/l/cs/user-guide/data-model/capabilities/fields.mdx b/packages/twenty-docs/l/cs/user-guide/data-model/capabilities/fields.mdx
index 5c8f1dbf127..8571338d9ca 100644
--- a/packages/twenty-docs/l/cs/user-guide/data-model/capabilities/fields.mdx
+++ b/packages/twenty-docs/l/cs/user-guide/data-model/capabilities/fields.mdx
@@ -101,6 +101,10 @@ Udělte poli unikátnost, abyste zajistili, že různé záznamy nemohou mít st
Pokud narazíte na chybu při nastavování unikátnosti, zkontrolujte duplicitní hodnoty ve svých datech (včetně smazaných záznamů).
+## Indexy (pokročilé)
+
+Databázové indexy jsou spravovány automaticky — přidávání vlastních je jen zřídka nutné a je snadné je udělat špatně. Když je zapnutý pokročilý režim, má každý objekt sekci **Indexy** v `Settings → Data Model → <object>` pro případy, kdy víte, že ho potřebujete.
+
## Nejlepší praktiky pro konfiguraci polí
### Nejlepší praktiky pro konfiguraci polí
diff --git a/packages/twenty-docs/l/cs/user-guide/permissions-access/capabilities/permissions.mdx b/packages/twenty-docs/l/cs/user-guide/permissions-access/capabilities/permissions.mdx
index 717f6263389..18d230f24db 100644
--- a/packages/twenty-docs/l/cs/user-guide/permissions-access/capabilities/permissions.mdx
+++ b/packages/twenty-docs/l/cs/user-guide/permissions-access/capabilities/permissions.mdx
@@ -13,7 +13,7 @@ Systém oprávnění v Twenty vám umožňuje řídit přístup ke třem hlavní
Chcete-li vytvořit novou roli:
-1. Přejděte na **Nastavení → Role**
+1. Přejděte na **Nastavení → Členové → Role**
2. V sekci **Všechny role** klikněte na **+ Vytvořit roli**
3. Zadejte název role
4. Na výchozí kartě **Oprávnění** [nakonfigurujte oprávnění](#customize-permissions)
@@ -23,7 +23,7 @@ Chcete-li vytvořit novou roli:
Chcete-li smazat roli:
-1. Přejděte na **Nastavení → Role**
+1. Přejděte na **Nastavení → Členové → Role**
2. Klikněte na roli, kterou chcete odebrat
3. Otevřete záložku **Nastavení** a klikněte na **Smazat roli**
4. Klikněte na **Potvrdit** v modálním okně
@@ -36,13 +36,13 @@ Pokud je role smazána, každý člen pracovního prostoru přiřazený k této
### Zobrazit aktuální přiřazení
-* Přejděte na **Nastavení → Role**
+* Přejděte na **Nastavení → Členové → Role**
* Zjistěte všechny role a kolik členů je ke každé přiřazeno
* Zobrazit, kteří členové mají jaké role
### Přiřadit roli členu
-1. Přejděte na **Nastavení → Role**
+1. Přejděte na **Nastavení → Členové → Role**
2. Klikněte na roli, kterou chcete přiřadit
3. Otevřete záložku **Přiřazení**
4. Klikněte na **+ Přiřadit členu**
@@ -51,7 +51,7 @@ Pokud je role smazána, každý člen pracovního prostoru přiřazený k této
### Nastavit výchozí roli
-1. Přejděte na **Nastavení → Role**
+1. Přejděte na **Nastavení → Členové → Role**
2. V sekci **Možnosti** najděte **Výchozí roli**
3. Vyberte, kterou roli by noví členové měli automaticky obdržet
4. Noví členové pracovního prostoru budou při příchodu k této roli přiřazeni.
@@ -98,6 +98,22 @@ Klikněte na **+ Přidat pravidlo** a vyberte objekt pro vytvoření výjimky.
| Příležitosti → zakažte "Zobrazit záznamy" | Stážista vůbec nemůže vidět objekt Příležitosti |
| Lidé → povolte "Upravovat záznamy" | Stážista může upravovat záznamy objektu Lidé (ale ne ostatní objekty) |
+### Oprávnění na úrovni řádků
+
+<Note>
+Oprávnění na úrovni řádků jsou **prémiová funkce** dostupná v tarifu **Organization** (Cloud i Self-Hosted).
+</Note>
+
+Oprávnění na úrovni řádků vám umožňují omezit, které jednotlivé záznamy může role zobrazit nebo upravovat, a to na základě dynamických kritérií. Na rozdíl od oprávnění na úrovni objektu (která se vztahují na celý typ objektu) vyhodnocují oprávnění na úrovni řádků každý záznam samostatně.
+
+**Příklady použití:**
+
+* Obchodní zástupci mohou vidět pouze své vlastní příležitosti
+* Manažeři mohou vidět všechny záznamy ve svém regionu
+* Pracovníci podpory mohou zobrazit pouze tikety, které jsou jim přiřazené
+
+Chcete-li nakonfigurovat oprávnění na úrovni řádků, otevřete roli, přejděte na kartu **Objects** a v části **Row-Level** definujte podmínky filtru pro konkrétní objekt.
+
### Oprávnění k polím
V rámci každého pravidla na úrovni objektu můžete jít dál a nakonfigurovat **oprávnění na úrovni pole** pro řízení přístupu ke konkrétním polím.
@@ -168,7 +184,7 @@ Kromě členů pracovního prostoru lze role přiřadit také ke **klíčům API
### Přiřaďte roli klíči API
-1. Přejděte na **Nastavení → Role**
+1. Přejděte na **Nastavení → Členové → Role**
2. Klikněte na roli, kterou chcete přiřadit
3. Otevřete záložku **Přiřazení**
4. V části **Klíče API** klikněte na **+ Přiřadit ke klíči API**
@@ -183,7 +199,7 @@ Klíče API bez přiřazené role používají výchozí oprávnění. Pro vyš
### Přiřaďte roli agentovi AI
-1. Přejděte na **Nastavení → Role**
+1. Přejděte na **Nastavení → Členové → Role**
2. Klikněte na roli, kterou chcete přiřadit
3. Otevřete záložku **Přiřazení**
4. V části **Agenti AI** klikněte na **+ Přiřadit agentovi AI**
diff --git a/packages/twenty-docs/l/cs/user-guide/permissions-access/how-tos/permissions-faq.mdx b/packages/twenty-docs/l/cs/user-guide/permissions-access/how-tos/permissions-faq.mdx
index acc48001486..eac41092e99 100644
--- a/packages/twenty-docs/l/cs/user-guide/permissions-access/how-tos/permissions-faq.mdx
+++ b/packages/twenty-docs/l/cs/user-guide/permissions-access/how-tos/permissions-faq.mdx
@@ -19,7 +19,7 @@ Každý člen pracovního prostoru přiřazený k této roli bude automaticky p
</Accordion>
<Accordion title="Jak nastavím výchozí roli pro nové členy?">
-Přejděte do **Nastavení → Role**, najděte možnost **Výchozí role** a vyberte, kterou roli mají noví členové po připojení automaticky získat.
+Přejděte na **Nastavení → Členové → Role**, najděte možnost **Výchozí role** a vyberte, kterou roli mají noví členové po připojení automaticky získat.
</Accordion>
<Accordion title="Mohu jednomu uživateli přiřadit více rolí?">
@@ -60,11 +60,11 @@ Pro pole:
</Accordion>
<Accordion title="Mohu omezit přístup ke konkrétním záznamům (oprávnění na úrovni řádků)?">
-Oprávnění na úrovni řádků budou k dispozici v tarifu **Organization** v 1. čtvrtletí 2026. To umožní omezit přístup ke konkrétním záznamům na základě kritérií (např. zobrazovat pouze vlastní příležitosti).
+Oprávnění na úrovni řádků jsou k dispozici v tarifu **Organization**. To umožní omezit přístup ke konkrétním záznamům na základě kritérií (např. zobrazovat pouze vlastní příležitosti).
</Accordion>
<Accordion title="Jak nastavím pole jen pro čtení pro určité uživatele?">
-1. Přejděte na **Nastavení → Role**
+1. Přejděte na **Nastavení → Členové → Role**
2. Vyberte roli
3. Přejděte k objektu, který pole obsahuje
4. Nastavte oprávnění pole na **Zobrazit pole** (bez Upravit pole)
diff --git a/packages/twenty-docs/l/cs/user-guide/settings/capabilities/domains-settings.mdx b/packages/twenty-docs/l/cs/user-guide/settings/capabilities/domains-settings.mdx
index c1c25d101b2..d0224178f94 100644
--- a/packages/twenty-docs/l/cs/user-guide/settings/capabilities/domains-settings.mdx
+++ b/packages/twenty-docs/l/cs/user-guide/settings/capabilities/domains-settings.mdx
@@ -3,10 +3,12 @@ title: Nastavení domén
description: Nastavte doménu pracovního prostoru, schválené přístupové domény a veřejné domény.
---
-Nakonfigurujte nastavení domén v **Settings → Domains**.
+Nastavení domény se nachází na třech místech v závislosti na tom, co právě konfigurujete.
## Doména pracovního prostoru
+Nastavte v **Nastavení → Obecné → Doména pracovního prostoru**.
+
Upravte název své subdomény nebo nastavte vlastní doménu pro svůj pracovní prostor.
### Přizpůsobit doménu
@@ -19,6 +21,8 @@ U vlastních domén budete muset u svého poskytovatele domény nakonfigurovat n
## Schválené domény
+Nastavte v **Nastavení → Členové → Pozvat**.
+
Kdokoli s e-mailovou adresou na těchto doménách se může do tohoto pracovního prostoru automaticky zaregistrovat.
### Přidat schválenou přístupovou doménu
@@ -35,13 +39,16 @@ To je užitečné, protože umožní celému vašemu týmu registrovat se samost
## Veřejné domény
-Zajistěte kompletní a bezpečné hostingové prostředí na těchto doménách.
+Nastavte v **Nastavení → Aplikace → Vývojář**.
+
+Zajistěte kompletní a bezpečné hostingové prostředí na těchto doménách. Veřejnou doménu lze přiřadit ke konkrétní aplikaci — pokud je přiřazená, jsou na této doméně dostupné pouze funkce aplikační logiky této aplikace směrované přes HTTP. Nechte přiřazení prázdné, aby byly zpřístupněny všechny HTTP trasy pracovního prostoru.
### Přidat veřejnou doménu
1. Klikněte na **Přidat veřejnou doménu**
2. Zadejte doménu, kterou chcete použít
-3. Nakonfigurujte nastavení DNS podle pokynů
-4. Ověřte doménu
+3. Volitelně ji přiřaďte k aplikaci
+4. Nakonfigurujte nastavení DNS podle pokynů
+5. Ověřte doménu
Pro veřejné domény se certifikáty SSL zřizují automaticky.
diff --git a/packages/twenty-docs/l/cs/user-guide/settings/capabilities/member-management.mdx b/packages/twenty-docs/l/cs/user-guide/settings/capabilities/member-management.mdx
index 0e8771afe42..e5a7755d10e 100644
--- a/packages/twenty-docs/l/cs/user-guide/settings/capabilities/member-management.mdx
+++ b/packages/twenty-docs/l/cs/user-guide/settings/capabilities/member-management.mdx
@@ -77,7 +77,7 @@ Spravujte pozvánky, které dosud nebyly přijaty:
Umožněte členům týmu připojit se automaticky podle jejich e-mailové domény:
-1. Přejděte na **Nastavení → Domény**
+1. Přejděte na **Nastavení → Členové → Pozvat**
2. Přidejte doménu své společnosti (např. `yourcompany.com`)
3. Kdokoli s touto e-mailovou doménou se může připojit bez pozvánky
diff --git a/packages/twenty-docs/l/cs/user-guide/settings/how-tos/settings-faq.mdx b/packages/twenty-docs/l/cs/user-guide/settings/how-tos/settings-faq.mdx
index d3762755474..d33568e2bc6 100644
--- a/packages/twenty-docs/l/cs/user-guide/settings/how-tos/settings-faq.mdx
+++ b/packages/twenty-docs/l/cs/user-guide/settings/how-tos/settings-faq.mdx
@@ -137,7 +137,7 @@ Ano, můžete připojit více e-mailových účtů. Přejděte do **Nastavení
<AccordionGroup>
<Accordion title="Mohu přizpůsobit doménu své pracovní oblasti?">
-Ano! Přejděte do **Nastavení → Domény** a klikněte na **Přizpůsobit doménu**. Máte dvě možnosti:
+Ano! Přejděte do **Nastavení → Obecné → Doména pracovního prostoru** a klikněte na **Přizpůsobit doménu**. Máte dvě možnosti:
* **Poddoména**: Použijte poddoménu Twenty, například `yourcompany.twenty.com`
* **Vlastní doména**: Použijte svou vlastní doménu, například `crm.yourcompany.com` (vyžaduje konfiguraci DNS)
@@ -146,7 +146,7 @@ Poddoménu nastavíte rychle, zatímco vlastní doména poskytne vašemu týmu p
</Accordion>
<Accordion title="Jak fungují schválené přístupové domény?">
-Můžete nastavit schválené přístupové domény tak, aby se členové týmu s firemními e-mailovými adresami mohli automaticky připojit k vašemu pracovnímu prostoru. Přejděte do **Nastavení → Domény** a přidejte svou firemní doménu (např. `yourcompany.com`).
+Můžete nastavit schválené přístupové domény tak, aby se členové týmu s firemními e-mailovými adresami mohli automaticky připojit k vašemu pracovnímu prostoru. Přejděte do **Nastavení → Členové → Pozvat** a přidejte svou firemní doménu (např. `yourcompany.com`).
</Accordion>
</AccordionGroup>
diff --git a/packages/twenty-docs/l/cs/user-guide/settings/overview.mdx b/packages/twenty-docs/l/cs/user-guide/settings/overview.mdx
index 2adc82d1698..91c28f2f77e 100644
--- a/packages/twenty-docs/l/cs/user-guide/settings/overview.mdx
+++ b/packages/twenty-docs/l/cs/user-guide/settings/overview.mdx
@@ -44,7 +44,7 @@ Přidejte členy týmu do svého pracovního prostoru:
4. Přiřaďte příslušné role
<Note>
-Před pozváním týmu zkontrolujte výchozí roli v **Nastavení → Role**. Novým členům je tato role automaticky přiřazena, když se připojí.
+Před pozváním týmu zkontrolujte výchozí roli v **Nastavení → Členové → Role**. Novým členům je tato role automaticky přiřazena, když se připojí.
</Note>
## Kontrolní seznam nastavení pracovního prostoru
diff --git a/packages/twenty-docs/l/cs/user-guide/views-pipelines/how-tos/show-expected-amount-in-pipeline.mdx b/packages/twenty-docs/l/cs/user-guide/views-pipelines/how-tos/show-expected-amount-in-pipeline.mdx
index 0ec4adcdd5a..4f4cb86a33e 100644
--- a/packages/twenty-docs/l/cs/user-guide/views-pipelines/how-tos/show-expected-amount-in-pipeline.mdx
+++ b/packages/twenty-docs/l/cs/user-guide/views-pipelines/how-tos/show-expected-amount-in-pipeline.mdx
@@ -38,7 +38,7 @@ Na objektu Příležitosti potřebujete dvě vlastní pole.
Pokud nechcete, aby uživatelé ručně upravovali tato vypočtená pole:
-1. Přejděte na **Nastavení → Role**
+1. Přejděte na **Nastavení → Členové → Role**
2. Vyberte roli k nastavení
3. Najděte objekt Příležitosti
4. Nastavte pole **Pravděpodobnost** a **Očekávaná částka** jako pouze pro čtení
diff --git a/packages/twenty-docs/l/cs/user-guide/views-pipelines/how-tos/track-time-in-stage.mdx b/packages/twenty-docs/l/cs/user-guide/views-pipelines/how-tos/track-time-in-stage.mdx
index bd1305db76c..9b7d5f8b5da 100644
--- a/packages/twenty-docs/l/cs/user-guide/views-pipelines/how-tos/track-time-in-stage.mdx
+++ b/packages/twenty-docs/l/cs/user-guide/views-pipelines/how-tos/track-time-in-stage.mdx
@@ -61,7 +61,7 @@ Pole "Dny v" pro Uzavřeno – vyhráno a Uzavřeno – prohráno nepotřebujete
Nechcete-li, aby uživatelé ručně upravovali tato vypočítávaná pole:
-1. Přejděte na **Nastavení → Role**
+1. Přejděte na **Nastavení → Členové → Role**
2. Vyberte roli k nastavení
3. Najděte objekt Obchodní příležitosti
4. Nastavte pole "Poslední vstup" a "Dny v" jako jen pro čtení
diff --git a/packages/twenty-docs/l/cs/user-guide/workflows/capabilities/send-emails-from-workflows.mdx b/packages/twenty-docs/l/cs/user-guide/workflows/capabilities/send-emails-from-workflows.mdx
index 018c6905269..440894cfad8 100644
--- a/packages/twenty-docs/l/cs/user-guide/workflows/capabilities/send-emails-from-workflows.mdx
+++ b/packages/twenty-docs/l/cs/user-guide/workflows/capabilities/send-emails-from-workflows.mdx
@@ -71,7 +71,7 @@ Tým
1. **Spouštěč**: Záznam je vytvořen (Lidé)
2. **Přidat akci Filtr**:
- * Podmínka: `{{trigger.object.source}}` se rovná `\"Website\"`
+ * Podmínka: `{{trigger.object.source}}` se rovná `"Website"`
* Pokud ano → pokračujte k vítacímu e-mailu pro web
3. **Větev pro jiné zdroje**:
diff --git a/packages/twenty-docs/l/cs/user-guide/workflows/capabilities/workflow-actions.mdx b/packages/twenty-docs/l/cs/user-guide/workflows/capabilities/workflow-actions.mdx
index ce310dcc6c1..7e982fa64d3 100644
--- a/packages/twenty-docs/l/cs/user-guide/workflows/capabilities/workflow-actions.mdx
+++ b/packages/twenty-docs/l/cs/user-guide/workflows/capabilities/workflow-actions.mdx
@@ -307,5 +307,5 @@ Akce agenta AI spotřebovávají kredity pracovního postupu podle použitého m
</Note>
<Note>
-Agenti AI respektují oprávnění založená na rolích. V části **Nastavení → Role** můžete agentům přiřadit konkrétní role, abyste řídili, k jakým datům mají přístup. Podrobnosti viz [Oprávnění](/l/cs/user-guide/permissions-access/capabilities/permissions).
+Agenti AI respektují oprávnění založená na rolích. V části **Nastavení → Členové → Role** můžete agentům přiřadit konkrétní role, abyste řídili, k jakým datům mají přístup. Podrobnosti viz [Oprávnění](/l/cs/user-guide/permissions-access/capabilities/permissions).
</Note>
diff --git a/packages/twenty-docs/l/cs/user-guide/workflows/how-tos/need-more-help/workflows-faq.mdx b/packages/twenty-docs/l/cs/user-guide/workflows/how-tos/need-more-help/workflows-faq.mdx
index 4edd4fc8f80..b0d84aeca92 100644
--- a/packages/twenty-docs/l/cs/user-guide/workflows/how-tos/need-more-help/workflows-faq.mdx
+++ b/packages/twenty-docs/l/cs/user-guide/workflows/how-tos/need-more-help/workflows-faq.mdx
@@ -8,7 +8,7 @@ description: Často kladené otázky k pracovním postupům v Twenty.
<Accordion title="Proč nemohu aktivovat pracovní postup?">
Pravděpodobně jde o problém s oprávněními. K vytváření a aktivaci potřebujete přístup k pracovním postupům.
- **Řešení**: Kontaktujte správce pracovního prostoru, aby vám v **Settings → Roles** udělil přístup k pracovním postupům.
+ **Řešení**: Kontaktujte správce pracovního prostoru, aby vám v **Settings → Members → Roles** udělil přístup k pracovním postupům.
Pokud v postranním panelu vůbec nevidíte sekci Pracovní postupy, potvrzuje to, že jde o problém s oprávněními.
</Accordion>
diff --git a/packages/twenty-docs/l/de/twenty-ui/input/text.mdx b/packages/twenty-docs/l/de/twenty-ui/input/text.mdx
index 1cd1f854644..bf7320e22e0 100644
--- a/packages/twenty-docs/l/de/twenty-ui/input/text.mdx
+++ b/packages/twenty-docs/l/de/twenty-ui/input/text.mdx
@@ -39,7 +39,7 @@ export const MyComponent = () => {
/>
);
};
-},{
+
```
diff --git a/packages/twenty-docs/l/de/user-guide/data-migration/capabilities/field-mapping.mdx b/packages/twenty-docs/l/de/user-guide/data-migration/capabilities/field-mapping.mdx
index f747829b27d..815b82749d7 100644
--- a/packages/twenty-docs/l/de/user-guide/data-migration/capabilities/field-mapping.mdx
+++ b/packages/twenty-docs/l/de/user-guide/data-migration/capabilities/field-mapping.mdx
@@ -143,7 +143,7 @@ Siehe [hier](#finding-api-names-for-select-fields), wo Sie die API-Namen finden.
<Warning>
**Der Import überschreibt, er fügt nichts hinzu.**
-Wenn ein Datensatz bereits `VALUE2` und `VALUE3` ausgewählt hat und Sie `[\"VALUE1\"]` importieren, hat der Datensatz nach dem Import nur noch `VALUE1`. Die bisherigen Auswahlen werden ersetzt, nicht zusammengeführt.
+Wenn ein Datensatz bereits `VALUE2` und `VALUE3` ausgewählt hat und Sie `["VALUE1"]` importieren, hat der Datensatz nach dem Import nur noch `VALUE1`. Die bisherigen Auswahlen werden ersetzt, nicht zusammengeführt.
</Warning>
### Zahlenfelder
diff --git a/packages/twenty-docs/l/de/user-guide/data-migration/capabilities/file-formats.mdx b/packages/twenty-docs/l/de/user-guide/data-migration/capabilities/file-formats.mdx
index 53bc98c0814..17bd390ada1 100644
--- a/packages/twenty-docs/l/de/user-guide/data-migration/capabilities/file-formats.mdx
+++ b/packages/twenty-docs/l/de/user-guide/data-migration/capabilities/file-formats.mdx
@@ -25,7 +25,7 @@ Twenty unterstützt drei Dateiformate für den Import:
## CSV: Beste Praktiken
* **Trennzeichen**: Verwenden Sie Komma (`,`) oder Semikolon (`;`)
-* **Textbegrenzer**: Verwenden Sie doppelte Anführungszeichen (`\"`) für Text, der Kommas enthält
+* **Textbegrenzer**: Verwenden Sie doppelte Anführungszeichen (`"`) für Text, der Kommas enthält
* **Zeilenenden**: Sowohl Windows (CRLF) als auch Unix (LF) werden unterstützt
* **Leere Werte**: Zellen leer lassen, nicht "NULL" oder "N/A" verwenden
diff --git a/packages/twenty-docs/l/de/user-guide/data-migration/how-tos/update-existing-records-via-import.mdx b/packages/twenty-docs/l/de/user-guide/data-migration/how-tos/update-existing-records-via-import.mdx
index a02bcab0499..818b81ef7d5 100644
--- a/packages/twenty-docs/l/de/user-guide/data-migration/how-tos/update-existing-records-via-import.mdx
+++ b/packages/twenty-docs/l/de/user-guide/data-migration/how-tos/update-existing-records-via-import.mdx
@@ -27,9 +27,9 @@ Wenn Sie eine Datei importieren, die einen **eindeutigen Bezeichner** enthält,
<Warning>
**Mehrfachauswahl-Felder werden überschrieben, nicht zusammengeführt.**
-Wenn in einem Datensatz `Option A` und `Option B` ausgewählt sind und Sie `[\"Option C\"]` importieren, hat der Datensatz nach dem Import nur noch `Option C`. Der Import ersetzt alle bisherigen Auswahlen — er fügt ihnen nichts hinzu.
+Wenn in einem Datensatz `Option A` und `Option B` ausgewählt sind und Sie `["Option C"]` importieren, hat der Datensatz nach dem Import nur noch `Option C`. Der Import ersetzt alle bisherigen Auswahlen — er fügt ihnen nichts hinzu.
-Um vorhandene Werte beizubehalten, schließen Sie sie alle in Ihren Import ein: `[\"Option A\",\"Option B\",\"Option C\"]`
+Um vorhandene Werte beizubehalten, schließen Sie sie alle in Ihren Import ein: `["Option A","Option B","Option C"]`
</Warning>
## Schritt 1: Exportieren Sie Ihre aktuellen Daten
diff --git a/packages/twenty-docs/l/es/developers/contribute/capabilities/backend-development/custom-objects.mdx b/packages/twenty-docs/l/es/developers/contribute/capabilities/backend-development/custom-objects.mdx
index 7ce5c14c0b3..b7295557bc4 100644
--- a/packages/twenty-docs/l/es/developers/contribute/capabilities/backend-development/custom-objects.mdx
+++ b/packages/twenty-docs/l/es/developers/contribute/capabilities/backend-development/custom-objects.mdx
@@ -11,7 +11,7 @@ Los objetos personalizados son objetos que puedes crear para almacenar informaci
## Esquema de alto nivel
<div style={{textAlign: 'center'}}>
- <img src="/images/docs/server/custom-object-schema.png" alt="Esquema de alto nivel" />
+ <img src="/images/docs/server/custom-object-schema.png" alt="Esquema de alto nivel" />
</div>
<br />
@@ -27,7 +27,7 @@ Los objetos personalizados provienen de tablas de metadatos que determinan la fo
Para añadir un objeto personalizado, el workspaceMember consultará la API de /metadata. Esto actualiza los metadatos de acuerdo y calcula un esquema GraphQL basado en los metadatos, almacenándolo en un caché de GQL para su uso posterior.
<div style={{textAlign: 'center'}}>
- <img src="/images/docs/server/add-custom-objects.jpeg" alt="Consultando la API de /metadata para añadir objetos personalizados" />
+ <img src="/images/docs/server/add-custom-objects.jpeg" alt="Consultando la API de /metadata para añadir objetos personalizados" />
</div>
<br />
@@ -35,5 +35,5 @@ Para añadir un objeto personalizado, el workspaceMember consultará la API de /
Para obtener datos, el proceso implica hacer consultas a través del endpoint /graphql y pasarlos a través del Query Resolver.
<div style={{textAlign: 'center'}}>
- <img src="/images/docs/server/custom-object-schema.png" alt="Consulta el endpoint /graphql para obtener datos" />
+ <img src="/images/docs/server/custom-object-schema.png" alt="Consulta el endpoint /graphql para obtener datos" />
</div>
diff --git a/packages/twenty-docs/l/es/developers/contribute/capabilities/backend-development/server-commands.mdx b/packages/twenty-docs/l/es/developers/contribute/capabilities/backend-development/server-commands.mdx
index e1b96c639e7..76c6b24e668 100644
--- a/packages/twenty-docs/l/es/developers/contribute/capabilities/backend-development/server-commands.mdx
+++ b/packages/twenty-docs/l/es/developers/contribute/capabilities/backend-development/server-commands.mdx
@@ -1,5 +1,6 @@
---
title: Comandos de Backend
+icon: terminal
---
## Comandos útiles
diff --git a/packages/twenty-docs/l/es/developers/contribute/capabilities/backend-development/zapier.mdx b/packages/twenty-docs/l/es/developers/contribute/capabilities/backend-development/zapier.mdx
index 3a853d4d22b..b8e4019c1f2 100644
--- a/packages/twenty-docs/l/es/developers/contribute/capabilities/backend-development/zapier.mdx
+++ b/packages/twenty-docs/l/es/developers/contribute/capabilities/backend-development/zapier.mdx
@@ -43,7 +43,9 @@ Reemplaza el valor de **YOUR_API_KEY** en el archivo `.env` con la clave API que
## Desarrollo
<Warning>
- Asegúrate de ejecutar `yarn build` antes de cualquier comando `zapier`.
+
+Asegúrate de ejecutar `yarn build` antes de cualquier comando `zapier`.
+
</Warning>
### Prueba
diff --git a/packages/twenty-docs/l/es/developers/contribute/capabilities/bug-and-requests.mdx b/packages/twenty-docs/l/es/developers/contribute/capabilities/bug-and-requests.mdx
index fe5ba34c841..4cbff0d22b1 100644
--- a/packages/twenty-docs/l/es/developers/contribute/capabilities/bug-and-requests.mdx
+++ b/packages/twenty-docs/l/es/developers/contribute/capabilities/bug-and-requests.mdx
@@ -1,5 +1,6 @@
---
title: Errores, solicitudes y pull requests
+icon: bug
info: Informa de problemas, solicita funcionalidades y contribuye con código
---
diff --git a/packages/twenty-docs/l/es/developers/contribute/capabilities/frontend-development/best-practices-front.mdx b/packages/twenty-docs/l/es/developers/contribute/capabilities/frontend-development/best-practices-front.mdx
index 909d9403708..eb7ba200f53 100644
--- a/packages/twenty-docs/l/es/developers/contribute/capabilities/frontend-development/best-practices-front.mdx
+++ b/packages/twenty-docs/l/es/developers/contribute/capabilities/frontend-development/best-practices-front.mdx
@@ -1,5 +1,6 @@
---
title: Mejores prácticas
+icon: star
---
Este documento describe las mejores prácticas que debes seguir al trabajar en el frontend.
@@ -8,12 +9,14 @@ Este documento describe las mejores prácticas que debes seguir al trabajar en e
React y Jotai manejan la gestión de estado en la base de código.
-### Usa `useAtomState` para almacenar el estado
+### Usa átomos de Jotai para almacenar el estado
Es buena práctica crear tantos átomos como necesites para almacenar tu estado.
<Warning>
- Es mejor usar átomos adicionales que intentar ser demasiado concisos con la perforación de props.
+
+Es mejor usar átomos adicionales que intentar ser demasiado concisos con la perforación de props.
+
</Warning>
```tsx
@@ -43,7 +46,7 @@ export const MyComponent = () => {
Evita usar `useRef` para almacenar el estado.
-If you want to store state, you should use `useState` or `useAtomState`.
+Si deseas almacenar el estado, deberías usar `useState` o átomos de Jotai con `useAtomState`.
Consulta [cómo gestionar las re-renderizaciones](#managing-re-renders) si sientes que necesitas `useRef` para evitar algunas re-renderizaciones.
@@ -80,7 +83,7 @@ If you feel like you need to add a `useEffect` in your root component, you shoul
Puedes aplicar lo mismo para la lógica de obtención de datos, con hooks de Apollo.
```tsx
-// ❌ Malo, provocará re-renderizados incluso si los datos no cambian,
+// ❌ Malo, provocará re-renderizados incluso si los datos no están cambiando,
// porque useEffect necesita volver a evaluarse
export const PageComponent = () => {
const [data, setData] = useAtomState(dataState);
@@ -101,7 +104,7 @@ export const App = () => (
```
```tsx
-// ✅ Bueno, no provocará re-renderizados si los datos no cambian,
+// ✅ Bueno, no provocará re-renderizados si los datos no están cambiando,
// porque useEffect se vuelve a evaluar en otro componente hermano
export const PageComponent = () => {
const [data, setData] = useAtomState(dataState);
@@ -130,9 +133,9 @@ export const App = () => (
);
```
-### Usa estados de familia de jotai y selectores de familia de jotai
+### Usa familias de átomos y familias de selectores
-Los estados y selectores de familia de jotai son una gran manera de evitar re-renderizaciones.
+Las familias de átomos y las familias de selectores son una gran manera de evitar re-renderizados.
Son útiles cuando necesitas almacenar una lista de elementos.
diff --git a/packages/twenty-docs/l/es/developers/contribute/capabilities/frontend-development/folder-architecture-front.mdx b/packages/twenty-docs/l/es/developers/contribute/capabilities/frontend-development/folder-architecture-front.mdx
index c0b423302ff..533d75a69c8 100644
--- a/packages/twenty-docs/l/es/developers/contribute/capabilities/frontend-development/folder-architecture-front.mdx
+++ b/packages/twenty-docs/l/es/developers/contribute/capabilities/frontend-development/folder-architecture-front.mdx
@@ -1,5 +1,6 @@
---
title: Arquitectura de Carpetas
+icon: folder-tree
info: Una mirada detallada a nuestra arquitectura de carpetas
---
@@ -84,7 +85,7 @@ Ver [Hooks](https://react.dev/learn/reusing-logic-with-custom-hooks) para más d
Contiene la lógica de gestión de estado. [Jotai](https://jotai.org) maneja esto.
-* Selectores: Los átomos derivados (usando `createAtomSelector`) calculan valores a partir de otros átomos y se memorizan automáticamente.
+* Selectores: Los átomos derivados (usando `createAtomSelector`) calculan valores a partir de otros átomos y se memoizan automáticamente.
La gestión de estado incorporada de React todavía maneja el estado dentro de un componente.
diff --git a/packages/twenty-docs/l/es/developers/contribute/capabilities/frontend-development/frontend-commands.mdx b/packages/twenty-docs/l/es/developers/contribute/capabilities/frontend-development/frontend-commands.mdx
index e03c8328614..5d148039947 100644
--- a/packages/twenty-docs/l/es/developers/contribute/capabilities/frontend-development/frontend-commands.mdx
+++ b/packages/twenty-docs/l/es/developers/contribute/capabilities/frontend-development/frontend-commands.mdx
@@ -1,5 +1,6 @@
---
title: Comandos del Frontend
+icon: terminal
---
## Comandos útiles
@@ -77,7 +78,7 @@ To avoid unnecessary [re-renders](/l/es/developers/contribute/capabilities/front
### Gestión del Estado
-[Jotai](https://jotai.org/) maneja la gestión del estado.
+[Jotai](https://jotai.org/) gestiona el estado.
Ver [mejores prácticas](/l/es/developers/contribute/capabilities/frontend-development/best-practices-front#state-management) para más información sobre la gestión del estado.
diff --git a/packages/twenty-docs/l/es/developers/contribute/capabilities/frontend-development/hotkeys.mdx b/packages/twenty-docs/l/es/developers/contribute/capabilities/frontend-development/hotkeys.mdx
index 248e1bb2402..9f14f30cbdb 100644
--- a/packages/twenty-docs/l/es/developers/contribute/capabilities/frontend-development/hotkeys.mdx
+++ b/packages/twenty-docs/l/es/developers/contribute/capabilities/frontend-development/hotkeys.mdx
@@ -160,7 +160,7 @@ export enum PageHotkeyScope {
}
```
-Internamente, el ámbito seleccionado se almacena en un estado de Jotai que se comparte en toda la aplicación:
+Internamente, el ámbito seleccionado actualmente se almacena en un átomo de Jotai que se comparte en toda la aplicación:
```tsx
export const currentHotkeyScopeState = createState<HotkeyScope>({
@@ -169,10 +169,10 @@ export const currentHotkeyScopeState = createState<HotkeyScope>({
});
```
-¡Pero este estado de Jotai nunca debe manejarse manualmente! Veremos cómo usarlo en la siguiente sección.
+¡Pero este átomo nunca debe manejarse manualmente! Veremos cómo usarlo en la siguiente sección.
## ¿Cómo funciona internamente?
Hicimos un contenedor delgado sobre [react-hotkeys-hook](https://react-hotkeys-hook.vercel.app/docs/intro) que lo hace más eficiente y evita renders innecesarios.
-También creamos un estado de Jotai para manejar el estado del ámbito de atajos de teclado y hacerlo disponible en toda la aplicación.
+También creamos un átomo de Jotai para manejar el estado del ámbito de atajos de teclado y hacerlo disponible en toda la aplicación.
diff --git a/packages/twenty-docs/l/es/developers/contribute/capabilities/frontend-development/style-guide.mdx b/packages/twenty-docs/l/es/developers/contribute/capabilities/frontend-development/style-guide.mdx
index f413ec87cff..2e5c16fdc9c 100644
--- a/packages/twenty-docs/l/es/developers/contribute/capabilities/frontend-development/style-guide.mdx
+++ b/packages/twenty-docs/l/es/developers/contribute/capabilities/frontend-development/style-guide.mdx
@@ -1,5 +1,6 @@
---
title: Guía de Estilo
+icon: pincel
---
Este documento incluye las reglas a seguir al escribir código.
@@ -281,7 +282,7 @@ import { Meta, StoryObj } from '@storybook/react';
* **Mantenibilidad**: Mejora la mantenibilidad de la base de código porque los desarrolladores pueden identificar y localizar importaciones solo de tipo al revisar o modificar el código.
-### regla de Oxlint
+### Regla de Oxlint
Una regla de Oxlint, `typescript/consistent-type-imports`, impone el estándar de no usar "type" en las importaciones. Esta regla generará errores o advertencias sobre cualquier violación de importación de tipo.
diff --git a/packages/twenty-docs/l/es/developers/contribute/capabilities/frontend-development/work-with-figma.mdx b/packages/twenty-docs/l/es/developers/contribute/capabilities/frontend-development/work-with-figma.mdx
index 85382f32b16..27812d0a636 100644
--- a/packages/twenty-docs/l/es/developers/contribute/capabilities/frontend-development/work-with-figma.mdx
+++ b/packages/twenty-docs/l/es/developers/contribute/capabilities/frontend-development/work-with-figma.mdx
@@ -13,7 +13,9 @@ Esta guía explica cómo puedes colaborar con Figma.
Las características clave solo están disponibles para usuarios registrados, como el modo desarrollador y la capacidad de seleccionar un marco dedicado.
<Warning>
- No podrás colaborar efectivamente sin una cuenta.
+
+No podrás colaborar efectivamente sin una cuenta.
+
</Warning>
## Estructura de Figma
diff --git a/packages/twenty-docs/l/es/developers/contribute/capabilities/local-setup.mdx b/packages/twenty-docs/l/es/developers/contribute/capabilities/local-setup.mdx
index e3ec80dbdff..0a0f28ea43e 100644
--- a/packages/twenty-docs/l/es/developers/contribute/capabilities/local-setup.mdx
+++ b/packages/twenty-docs/l/es/developers/contribute/capabilities/local-setup.mdx
@@ -1,71 +1,72 @@
---
title: Configuración Local
+icon: laptop-code
description: La guía para los colaboradores (o desarrolladores curiosos) que quieren ejecutar Twenty localmente.
---
## Prerrequisitos
<Tabs>
- <Tab title="Linux y MacOS">
- Antes de que puedas instalar y usar Twenty, asegúrate de instalar lo siguiente en tu computadora:
-
- * [Git](https://git-scm.com/book/en/v2/Getting-Started-Installing-Git)
- * [Node v24.5.0](https://nodejs.org/en/download)
- * [yarn v4](https://yarnpkg.com/getting-started/install)
- * [nvm](https://github.com/nvm-sh/nvm/blob/master/README.md)
-
- <Warning>
- `npm` no funcionará, deberías usar `yarn` en su lugar. Yarn ahora se envía con Node.js, por lo que no necesitas instalarlo por separado.
- Solo tienes que ejecutar `corepack enable` para habilitar Yarn si aún no lo has hecho.
- </Warning>
- </Tab>
+<Tab title="Linux y macOS">
- <Tab title="Windows (WSL)">
- 1. Instalar WSL
- Abre PowerShell como Administrador y ejecuta:
+Antes de que puedas instalar y usar Twenty, asegúrate de instalar lo siguiente en tu computadora:
+* [Git](https://git-scm.com/book/en/v2/Getting-Started-Installing-Git)
+* [Node v24.5.0](https://nodejs.org/en/download)
+* [yarn v4](https://yarnpkg.com/getting-started/install)
+* [nvm](https://github.com/nvm-sh/nvm/blob/master/README.md)
- ```powershell
- wsl --install
- ```
+<Warning>
+`npm` no funcionará, deberías usar `yarn` en su lugar. Yarn ahora se envía con Node.js, por lo que no necesitas instalarlo por separado.
+Solo tienes que ejecutar `corepack enable` para habilitar Yarn si aún no lo has hecho.
+</Warning>
- Ahora deberías ver un aviso para reiniciar tu computadora. Si no, reiníciala manualmente.
+</Tab>
- Al reiniciar, se abrirá una ventana de PowerShell e instalará Ubuntu. Esto puede tomar algo de tiempo.
- Verás un aviso para crear un nombre de usuario y contraseña para tu instalación de Ubuntu.
+<Tab title="Windows (WSL)">
- 2. Instalar y configurar git
+1. Instalar WSL
+ Abre PowerShell como Administrador y ejecuta:
+```powershell
+wsl --install
+```
+Ahora deberías ver un aviso para reiniciar tu computadora. Si no, reiníciala manualmente.
- ```bash
- sudo apt-get install git
+Al reiniciar, se abrirá una ventana de PowerShell e instalará Ubuntu. Esto puede tomar algo de tiempo.
+Verás un aviso para crear un nombre de usuario y contraseña para tu instalación de Ubuntu.
- git config --global user.name "Your Name"
+2. Instalar y configurar git
- git config --global user.email "[email protected]"
- ```
+```bash
+sudo apt-get install git
- 3. Instalar nvm, node.js y yarn
+git config --global user.name "Your Name"
- <Warning>
- Usa `nvm` para instalar la versión correcta de `node`. El `.nvmrc` asegura que todos los colaboradores usen la misma versión.
- </Warning>
+git config --global user.email "[email protected]"
+```
- ```bash
- sudo apt-get install curl
+3. Instalar nvm, node.js y yarn
- curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/master/install.sh | bash
- ```
+<Warning>
+Usa `nvm` para instalar la versión correcta de `node`. El `.nvmrc` asegura que todos los colaboradores usen la misma versión.
+</Warning>
- Cierra y vuelve a abrir tu terminal para usar nvm. Luego ejecuta los siguientes comandos.
+```bash
+sudo apt-get install curl
- ```bash
+curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/master/install.sh | bash
+```
+Cierra y vuelve a abrir tu terminal para usar nvm. Luego ejecuta los siguientes comandos.
- nvm install # installs recommended node version
+```bash
- nvm use # use recommended node version
+nvm install # installs recommended node version
- corepack enable
- ```
- </Tab>
+nvm use # use recommended node version
+
+corepack enable
+```
+
+</Tab>
</Tabs>
---
@@ -75,19 +76,19 @@ description: La guía para los colaboradores (o desarrolladores curiosos) que qu
En tu terminal, ejecuta el siguiente comando.
<Tabs>
- <Tab title="SSH (Recomendado)">
- Si aún no has configurado claves SSH, puedes aprender cómo hacerlo [aquí](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/about-ssh).
+<Tab title="SSH (Recomendado)">
+Si aún no has configurado claves SSH, puedes aprender cómo hacerlo [aquí](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/about-ssh).
+```bash
+git clone [email protected]:twentyhq/twenty.git
+```
+</Tab>
+<Tab title="HTTPS">
- ```bash
- git clone [email protected]:twentyhq/twenty.git
- ```
- </Tab>
+```bash
+git clone https://github.com/twentyhq/twenty.git
+```
- <Tab title="HTTPS">
- ```bash
- git clone https://github.com/twentyhq/twenty.git
- ```
- </Tab>
+</Tab>
</Tabs>
## Paso 2: Ubícate en la raíz
@@ -102,22 +103,18 @@ Debes ejecutar todos los comandos de los siguientes pasos desde la raíz del pro
<Tabs>
<Tab title="Linux">
- **Opción 1 (preferido):** Para aprovisionar tu base de datos localmente:
+ **Opción 1 (preferida):** Para aprovisionar tu base de datos localmente:
Usa el siguiente enlace para instalar PostgreSQL en tu máquina Linux: [Instalación de PostgreSQL](https://www.postgresql.org/download/linux/)
-
```bash
psql postgres -c "CREATE DATABASE \"default\";" -c "CREATE DATABASE test;"
```
-
Nota: Puede que necesites agregar `sudo -u postgres` antes del comando `psql` para evitar errores de permisos.
**Opción 2:** Si tienes Docker instalado:
-
```bash
make -C packages/twenty-docker postgres-on-docker
```
</Tab>
-
<Tab title="Mac OS">
**Opción 1 (preferido):** Para aprovisionar tu base de datos localmente con `brew`:
@@ -129,7 +126,6 @@ Debes ejecutar todos los comandos de los siguientes pasos desde la raíz del pro
```
Puedes verificar si el servidor PostgreSQL está corriendo ejecutando:
-
```bash
brew services list
```
@@ -138,7 +134,6 @@ Debes ejecutar todos los comandos de los siguientes pasos desde la raíz del pro
vía Homebrew en macOS. En cambio, crea un rol de PostgreSQL que coincide con tu
nombre de usuario de macOS (por ejemplo, "john").
Para comprobar y crear el usuario `postgres` si es necesario, sigue estos pasos:
-
```bash
# Connect to PostgreSQL
psql postgres
@@ -147,70 +142,61 @@ Debes ejecutar todos los comandos de los siguientes pasos desde la raíz del pro
```
Una vez en el comando psql (postgres=#), ejecuta:
-
- ```bash
- # List existing PostgreSQL roles
- \du
- ```
-
+ ```bash
+ # List existing PostgreSQL roles
+ \du
+ ```
Verás una salida similar a:
-
- ```bash
- Role name | Attributes | Member of
- -----------+-------------+-----------
- john | Superuser | {}
- ```
+ ```bash
+ Role name | Attributes | Member of
+ -----------+-------------+-----------
+ john | Superuser | {}
+ ```
Si no ves un rol `postgres` listado, procede al siguiente paso.
Crea el rol `postgres` manualmente:
-
- ```bash
- CREATE ROLE postgres WITH SUPERUSER LOGIN;
- ```
-
+ ```bash
+ CREATE ROLE postgres WITH SUPERUSER LOGIN;
+ ```
Esto crea un rol de superusuario llamado `postgres` con acceso de inicio de sesión.
-
- ```bash
- Nombre del rol | Atributos | Miembro de
- -----------+-------------+-----------
- postgres | Superuser | {}
- john | Superuser | {}
- ```
+ ```bash
+ Nombre del rol | Atributos | Miembro de
+ -----------+-------------+-----------
+ postgres | Superuser | {}
+ john | Superuser | {}
+ ```
**Opción 2:** Si tienes Docker instalado:
-
```bash
make -C packages/twenty-docker postgres-on-docker
```
</Tab>
-
<Tab title="Windows (WSL)">
Todos los siguientes pasos deben ejecutarse en la terminal de WSL (dentro de tu máquina virtual)
**Opción 1:** Para aprovisionar tu PostgreSQL localmente:
Usa el siguiente enlace para instalar PostgreSQL en tu máquina virtual Linux: [Instalación de PostgreSQL](https://www.postgresql.org/download/linux/)
-
```bash
psql postgres -c "CREATE DATABASE \"default\";" -c "CREATE DATABASE test;"
```
-
Nota: Puede que necesites agregar `sudo -u postgres` antes del comando `psql` para evitar errores de permisos.
**Opción 2:** Si tienes Docker instalado:
Ejecutar Docker en WSL agrega una capa extra de complejidad.
Solo usa esta opción si estás cómodo con los pasos extras involucrados, incluyendo activar [Docker Desktop WSL2](https://docs.docker.com/desktop/wsl).
-
```bash
make -C packages/twenty-docker postgres-on-docker
```
</Tab>
</Tabs>
-Ahora puedes acceder a la base de datos en [localhost:5432](localhost:5432), con usuario `postgres` y contraseña `postgres`.
+Ahora puedes acceder a la base de datos en `localhost:5432`.
+
+Si utilizaste la opción de Docker anterior, las credenciales predeterminadas son usuario `postgres` y contraseña `postgres`. Para instalaciones nativas de PostgreSQL, usa las credenciales y los roles configurados en tu máquina.
## Paso 4: Configurar una Base de Datos Redis (cache)
-Twenty requiere un caché de redis para proporcionar el mejor rendimiento
+Twenty requiere un caché de Redis para proporcionar el mejor rendimiento.
<Tabs>
<Tab title="Linux">
@@ -218,46 +204,41 @@ Twenty requiere un caché de redis para proporcionar el mejor rendimiento
Usa el siguiente enlace para instalar Redis en tu máquina Linux: [Instalación de Redis](https://redis.io/docs/latest/operate/oss_and_stack/install/install-redis/install-redis-on-linux/)
**Opción 2:** Si tienes Docker instalado:
-
```bash
make -C packages/twenty-docker redis-on-docker
```
</Tab>
-
<Tab title="Mac OS">
**Opción 1 (preferido):** Para aprovisionar tu Redis localmente con `brew`:
-
```bash
brew install redis
```
-
- Inicia tu servidor redis:
- `brew services start redis`
+ Inicia tu servidor de Redis:
+ ```bash
+ brew services start redis
+ ```
**Opción 2:** Si tienes Docker instalado:
-
```bash
make -C packages/twenty-docker redis-on-docker
```
</Tab>
-
<Tab title="Windows (WSL)">
**Opción 1:** Para aprovisionar tu Redis localmente:
Usa el siguiente enlace para instalar Redis en tu máquina virtual Linux: [Instalación de Redis](https://redis.io/docs/latest/operate/oss_and_stack/install/install-redis/install-redis-on-linux/)
**Opción 2:** Si tienes Docker instalado:
-
```bash
make -C packages/twenty-docker redis-on-docker
```
</Tab>
</Tabs>
-Si necesitas una interfaz gráfica de cliente, recomendamos [Redis Insight](https://redis.io/insight/) (versión gratuita disponible)
+Si necesitas una interfaz gráfica de cliente, recomendamos [Redis Insight](https://redis.io/insight/) (versión gratuita disponible).
## Paso 5: Configurar las variables de entorno
-Usa variables de entorno o archivos `.env` para configurar tu proyecto. Más información [aquí](/l/es/developers/self-host/capabilities/setup)
+Usa variables de entorno o archivos `.env` para configurar tu proyecto. Más información [aquí](/l/es/developers/self-host/capabilities/setup).
Copia los archivos `.env.example` en `/front` y `/server`:
@@ -267,7 +248,7 @@ cp ./packages/twenty-server/.env.example ./packages/twenty-server/.env
```
<Info>
- **Modo de múltiples espacios de trabajo:** De forma predeterminada, Twenty se ejecuta en modo de un solo espacio de trabajo, donde solo se puede crear un espacio de trabajo. Para habilitar la compatibilidad con múltiples espacios de trabajo (útil para probar funciones basadas en subdominios), establece `IS_MULTIWORKSPACE_ENABLED=true` en el archivo `.env` de tu servidor. Consulta [Modo de múltiples espacios de trabajo](/l/es/developers/self-host/capabilities/setup#multi-workspace-mode) para más detalles.
+**Modo de múltiples espacios de trabajo:** De forma predeterminada, Twenty se ejecuta en modo de un solo espacio de trabajo, donde solo se puede crear un espacio de trabajo. Para habilitar la compatibilidad con múltiples espacios de trabajo (útil para probar funciones basadas en subdominios), establece `IS_MULTIWORKSPACE_ENABLED=true` en el archivo `.env` de tu servidor. Consulta [Modo de múltiples espacios de trabajo](/l/es/developers/self-host/capabilities/setup#multi-workspace-mode) para más detalles.
</Info>
## Paso 6: Instalación de dependencias
@@ -287,15 +268,12 @@ Ten en cuenta que `npm` o `pnpm` no funcionarán
Dependiendo de tu distribución de Linux, el servidor Redis podría iniciarse automáticamente.
Si no, revisa la [guía de instalación de Redis](https://redis.io/docs/latest/operate/oss_and_stack/install/install-redis/) para tu distribución.
</Tab>
-
<Tab title="Mac OS">
- Redis ya debería estar funcionando. Si no, ejecuta:
-
+ Redis ya debería estar funcionando. Si no, ejecuta:
```bash
brew services start redis
```
</Tab>
-
<Tab title="Windows (WSL)">
Dependiendo de tu distribución de Linux, el servidor Redis podría iniciarse automáticamente.
Si no es así, consulte la [guía de instalación de Redis](https://redis.io/docs/latest/operate/oss_and_stack/install/install-redis/) para su distribución.
diff --git a/packages/twenty-docs/l/es/developers/contribute/commands.mdx b/packages/twenty-docs/l/es/developers/contribute/commands.mdx
new file mode 100644
index 00000000000..54a95460eaf
--- /dev/null
+++ b/packages/twenty-docs/l/es/developers/contribute/commands.mdx
@@ -0,0 +1,77 @@
+---
+title: Comandos
+icon: terminal
+description: Comandos útiles para desarrollar Twenty.
+---
+
+Los comandos se pueden ejecutar desde la raíz del repositorio usando `npx nx`. Usa `npx nx run {project}:{command}` para especificar explícitamente el destino.
+
+## Iniciando la aplicación
+
+```bash
+npx nx start twenty-front # Frontend dev server (http://localhost:3001)
+npx nx start twenty-server # Backend server (http://localhost:3000)
+npx nx run twenty-server:worker # Background worker
+```
+
+## Base de datos
+
+```bash
+npx nx database:reset twenty-server # Reset and seed database
+npx nx run twenty-server:database:migrate:prod # Run migrations
+npx nx run twenty-server:database:migrate:generate --name <name> --type <fast|slow> # Generate a migration
+```
+
+## Análisis de código
+
+```bash
+npx nx lint:diff-with-main twenty-front # Lint changed files (fastest)
+npx nx lint:diff-with-main twenty-server
+npx nx lint twenty-front --configuration=fix # Auto-fix
+```
+
+## Comprobación de tipos
+
+```bash
+npx nx typecheck twenty-front
+npx nx typecheck twenty-server
+```
+
+## Pruebas
+
+```bash
+# Frontend
+npx nx test twenty-front # Jest unit tests
+npx nx storybook:build twenty-front # Build Storybook
+npx nx storybook:test twenty-front # Storybook tests
+
+# Backend
+npx nx run twenty-server:test:unit # Unit tests
+npx nx run twenty-server:test:integration # Integration tests
+npx nx run twenty-server:test:integration:with-db-reset # Integration with DB reset
+
+# Single file (fastest)
+npx jest path/to/test.test.ts --config=packages/{project}/jest.config.mjs
+```
+
+## GraphQL
+
+```bash
+npx nx run twenty-front:graphql:generate # Regenerate types
+npx nx run twenty-front:graphql:generate --configuration=metadata # Metadata schema
+```
+
+## Traducciones
+
+```bash
+npx nx run twenty-front:lingui:extract # Extract strings
+npx nx run twenty-front:lingui:compile # Compile translations
+```
+
+## Compilar
+
+```bash
+npx nx build twenty-shared # Must be built first
+npx nx build twenty-front
+npx nx build twenty-server
+```
diff --git a/packages/twenty-docs/l/es/developers/contribute/contribute.mdx b/packages/twenty-docs/l/es/developers/contribute/contribute.mdx
index f5b6ce47b63..8b31e741ff6 100644
--- a/packages/twenty-docs/l/es/developers/contribute/contribute.mdx
+++ b/packages/twenty-docs/l/es/developers/contribute/contribute.mdx
@@ -25,7 +25,6 @@ Twenty es de código abierto y da la bienvenida a las contribuciones de la comun
<Card title="Informes de errores y solicitudes" icon="bug" href="/l/es/developers/contribute/capabilities/bug-and-requests">
Reporta problemas o solicita funcionalidades
</Card>
-
<Card title="Desarrollo Frontend" icon="browser" href="/l/es/developers/contribute/capabilities/frontend-development">
Contribuye a la interfaz de usuario
</Card>
diff --git a/packages/twenty-docs/l/es/developers/contribute/style-guide.mdx b/packages/twenty-docs/l/es/developers/contribute/style-guide.mdx
new file mode 100644
index 00000000000..97a8c7b2652
--- /dev/null
+++ b/packages/twenty-docs/l/es/developers/contribute/style-guide.mdx
@@ -0,0 +1,176 @@
+---
+title: Guía de Estilo
+icon: pincel
+description: Convenciones de código y buenas prácticas para contribuir a Twenty.
+---
+
+## React
+
+### Solo componentes funcionales
+
+Siempre usa componentes funcionales TSX con exportaciones con nombre.
+
+```tsx
+// ❌ Bad
+const MyComponent = () => {
+ return <div>Hello World</div>;
+};
+export default MyComponent;
+
+// ✅ Good
+export function MyComponent() {
+ return <div>Hello World</div>;
+};
+```
+
+### "Props"
+
+Crea un tipo llamado `{ComponentName}Props`. Usa la desestructuración. No uses `React.FC`.
+
+```tsx
+type MyComponentProps = {
+ name: string;
+};
+
+export const MyComponent = ({ name }: MyComponentProps) => <div>Hello {name}</div>;
+```
+
+### Sin propagación de props de una sola variable
+
+```tsx
+// ❌ Bad
+const MyComponent = (props: MyComponentProps) => <Other {...props} />;
+
+// ✅ Good
+const MyComponent = ({ prop1, prop2 }: MyComponentProps) => <Other {...{ prop1, prop2 }} />;
+```
+
+## Gestión del Estado
+
+### Átomos de Jotai para estado global
+
+```tsx
+import { createAtomState } from '@/ui/utilities/state/jotai/utils/createAtomState';
+import { useAtomState } from '@/ui/utilities/state/jotai/hooks/useAtomState';
+
+export const myAtomState = createAtomState<string>({
+ key: 'myAtomState',
+ defaultValue: 'default value',
+});
+```
+
+* Prefiere átomos en lugar de prop drilling
+* No uses `useRef` para estado — usa `useState` o átomos
+* Usa familias de átomos y selectores para listas
+
+### Evita renderizados innecesarios
+
+* Extrae `useEffect` y la obtención de datos en componentes sidecar hermanos
+* Prefiere los manejadores de eventos (`handleClick`, `handleChange`) en lugar de `useEffect`
+* No uses `React.memo()` — en su lugar, corrige la causa raíz
+* Limita el uso de `useCallback` / `useMemo`
+
+```tsx
+// ❌ Bad — useEffect in the same component causes re-renders
+export const Page = () => {
+ const [data, setData] = useAtomState(dataState);
+ const [dep] = useAtomState(depState);
+ useEffect(() => { setData(dep); }, [dep]);
+ return <div>{data}</div>;
+};
+
+// ✅ Good — extract into sibling
+export const PageData = () => {
+ const [data, setData] = useAtomState(dataState);
+ const [dep] = useAtomState(depState);
+ useEffect(() => { setData(dep); }, [dep]);
+ return <></>;
+};
+export const Page = () => {
+ const [data] = useAtomState(dataState);
+ return <div>{data}</div>;
+};
+```
+
+## TypeScript
+
+* **`type` mejor que `interface`** — más flexible, más fácil de componer
+* **Literales de cadena mejor que enums** — excepto para los enums de codegen de GraphQL y las APIs internas de la biblioteca
+* **Sin `any`** — TypeScript estricto obligatorio
+* **Sin importaciones de tipos** — usa importaciones normales (aplicado por Oxlint `typescript/consistent-type-imports`)
+* **Usa [Zod](https://github.com/colinhacks/zod)** para la validación en tiempo de ejecución de objetos no tipados
+
+## JavaScript
+
+```tsx
+// Use nullish-coalescing (??) instead of ||
+const value = process.env.MY_VALUE ?? 'default';
+
+// Use optional chaining
+onClick?.();
+```
+
+## Nomenclatura
+
+* **Variables**: camelCase, descriptivas (`email` no `value`, `fieldMetadata` no `fm`)
+* **Constantes**: SCREAMING_SNAKE_CASE
+* **Tipos/Clases**: PascalCase
+* **Archivos/directorios**: kebab-case (`.component.tsx`, `.service.ts`, `.entity.ts`)
+* **Manejadores de eventos**: `handleClick` (no `onClick` para la función manejadora)
+* **Props de componentes**: anteponer el nombre del componente (`ButtonProps`)
+* **Componentes con estilo**: anteponer `Styled` (`StyledTitle`)
+
+## Estilo
+
+Usa componentes con estilo de [Linaria](https://github.com/callstack/linaria). Usa valores del tema — evita `px`, `rem` o colores fijos.
+
+```tsx
+// ❌ Bad
+const StyledButton = styled.button`
+ color: #333333;
+ font-size: 1rem;
+ margin-left: 4px;
+`;
+
+// ✅ Good
+const StyledButton = styled.button`
+ color: ${({ theme }) => theme.font.color.primary};
+ font-size: ${({ theme }) => theme.font.size.md};
+ margin-left: ${({ theme }) => theme.spacing(1)};
+`;
+```
+
+## Importar
+
+Usa alias en lugar de rutas relativas:
+
+```tsx
+// ❌ Bad
+import { Foo } from '../../../../../testing/decorators/Foo';
+
+// ✅ Good
+import { Foo } from '~/testing/decorators/Foo';
+import { Bar } from '@/modules/bar/components/Bar';
+```
+
+## Estructura de carpetas
+
+```
+front
+└── modules/ # Feature modules
+│ └── module1/
+│ ├── components/
+│ ├── constants/
+│ ├── contexts/
+│ ├── graphql/ (fragments, queries, mutations)
+│ ├── hooks/
+│ ├── states/ (atoms, selectors)
+│ ├── types/
+│ └── utils/
+└── pages/ # Route-level components
+└── ui/ # Reusable UI components (display, input, feedback, ...)
+```
+
+* Los módulos pueden importar desde otros módulos, pero `ui/` debe permanecer sin dependencias
+* Usa subcarpetas `internal/` para código privado del módulo
+* Componentes de menos de 300 líneas, servicios de menos de 500 líneas
diff --git a/packages/twenty-docs/l/es/developers/extend/api.mdx b/packages/twenty-docs/l/es/developers/extend/api.mdx
new file mode 100644
index 00000000000..0319557543d
--- /dev/null
+++ b/packages/twenty-docs/l/es/developers/extend/api.mdx
@@ -0,0 +1,55 @@
+---
+title: APIs
+icon: plug
+description: APIs REST y GraphQL generadas a partir del esquema de tu espacio de trabajo.
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+## APIs con esquema por tenant
+
+No existe una referencia estática de la API para Twenty. Cada espacio de trabajo tiene su propio esquema — cuando agregas un objeto personalizado (por ejemplo, `Invoice`), inmediatamente obtiene endpoints REST y GraphQL idénticos a los objetos integrados como `Company` o `Person`. La API se genera a partir del esquema, por lo que los endpoints usan directamente los nombres de tus objetos y campos — sin identificadores opacos.
+
+La documentación de la API específica de tu espacio de trabajo está disponible en **Configuración → APIs y Webhooks** después de crear una clave de API. Incluye un entorno de pruebas interactivo donde puedes ejecutar llamadas reales contra tus datos.
+
+## Dos APIs
+
+**API principal** — `/rest/` y `/graphql/`
+
+CRUD sobre registros: Personas, Empresas, Oportunidades y tus objetos personalizados. Consultar, filtrar, recorrer relaciones.
+
+**API de metadatos** — `/rest/metadata/` y `/metadata/`
+
+Gestión del esquema: crear/modificar/eliminar objetos, campos y relaciones. Así es como cambias tu modelo de datos de forma programática.
+
+Ambas están disponibles como REST y GraphQL. GraphQL añade operaciones upsert por lotes y la capacidad de recorrer relaciones en una única consulta. Los mismos datos subyacentes en ambos casos.
+
+## URLs base
+
+| Entorno | URL base |
+| --------------- | ------------------------- |
+| Nube | `https://api.twenty.com/` |
+| Autoalojamiento | `https://{your-domain}/` |
+
+## Autenticación
+
+```
+Authorization: Bearer YOUR_API_KEY
+```
+
+Crea una clave de API en **Configuración → APIs y Webhooks → + Create key**. Cópiala de inmediato — se muestra una sola vez. Las claves pueden acotarse a un rol específico en **Configuración → Members → Roles → Assignment tab** para limitar a qué pueden acceder.
+
+<VimeoEmbed videoId="928786722" title="Creación de clave de API" />
+
+Para el acceso basado en OAuth (aplicaciones externas que actúan en nombre de los usuarios), consulta [OAuth](/l/es/developers/extend/oauth).
+
+## Operaciones por lotes
+
+Tanto REST como GraphQL admiten el procesamiento por lotes de hasta 60 registros por solicitud — crear, actualizar o eliminar. GraphQL también admite upsert por lotes (crear o actualizar en una sola llamada) usando nombres en plural como `CreateCompanies`.
+
+## Límites de tasa
+
+| Límite | Valor |
+| --------------- | -------------------------- |
+| Solicitudes | 100 solicitudes por minuto |
+| Tamaño del lote | 60 registros por llamada |
diff --git a/packages/twenty-docs/l/es/developers/extend/apps/config/application.mdx b/packages/twenty-docs/l/es/developers/extend/apps/config/application.mdx
new file mode 100644
index 00000000000..b67c15ca5f9
--- /dev/null
+++ b/packages/twenty-docs/l/es/developers/extend/apps/config/application.mdx
@@ -0,0 +1,64 @@
+---
+title: Configuración de la aplicación
+description: Declara la identidad de tu aplicación, el rol predeterminado, las variables y los metadatos del marketplace con defineApplication.
+icon: rocket
+---
+
+Cada aplicación debe tener exactamente una llamada a `defineApplication`. Declara:
+
+* **Identidad** — identificador universal, nombre para mostrar, descripción.
+* **Permisos** — bajo qué rol se ejecutan sus funciones de lógica y componentes de frontend.
+* **Variables** *(opcionales)* — pares clave–valor expuestos a tu código como variables de entorno.
+* **Hooks de preinstalación / postinstalación** *(opcionales)* — consulta [Funciones de lógica](/l/es/developers/extend/apps/logic/logic-functions).
+
+```ts src/application-config.ts
+import { defineApplication } from 'twenty-sdk/define';
+
+export default defineApplication({
+ universalIdentifier: '39783023-bcac-41e3-b0d2-ff1944d8465d',
+ displayName: 'My Twenty App',
+ description: 'My first Twenty app',
+ applicationVariables: {
+ DEFAULT_RECIPIENT_NAME: {
+ universalIdentifier: '19e94e59-d4fe-4251-8981-b96d0a9f74de',
+ description: 'Default recipient name for postcards',
+ value: 'Jane Doe',
+ isSecret: false,
+ },
+ },
+});
+```
+
+Notas:
+
+* Los campos `universalIdentifier` son identificadores deterministas que te pertenecen. Genéralos una vez y mantenlos estables entre sincronizaciones.
+* `applicationVariables` se convierten en variables de entorno para tus funciones y componentes de frontend. En las funciones lógicas (del lado del servidor), están disponibles como `process.env.VARIABLE_NAME`. En los componentes de frontend, usa `getApplicationVariable('VARIABLE_NAME')` de `twenty-sdk/front-component`. Las variables marcadas con `isSecret: true` solo se inyectan en las funciones lógicas. Los componentes de frontend solo reciben variables no secretas.
+* El rol predeterminado se detecta automáticamente a partir del archivo de rol marcado con [`defineApplicationRole()`](/l/es/developers/extend/apps/config/roles); no necesitas hacer referencia a él desde `defineApplication()`.
+* Las funciones de preinstalación y posinstalación se detectan automáticamente durante la compilación del manifiesto; no necesitas referenciarlas en `defineApplication()`.
+* Pasar `defaultRoleUniversalIdentifier` explícitamente sigue siendo compatible por motivos de retrocompatibilidad, pero está en desuso en favor de `defineApplicationRole()`.
+
+## Rol de función predeterminado
+
+El rol declarado con [`defineApplicationRole()`](/l/es/developers/extend/apps/config/roles) controla a qué pueden acceder las funciones de lógica y los componentes de interfaz de la aplicación:
+
+* El token en tiempo de ejecución inyectado como `TWENTY_APP_ACCESS_TOKEN` se deriva de este rol.
+* El cliente de API tipado está restringido a los permisos otorgados a ese rol.
+* Sigue el principio de mínimo privilegio: declara solo los permisos que necesitan tus funciones.
+
+Cuando generas una nueva aplicación, la CLI crea un archivo de rol inicial en `src/roles/default-role.ts`. Consulta [Roles y permisos](/l/es/developers/extend/apps/config/roles) para obtener la referencia completa.
+
+## Metadatos del Marketplace
+
+Si planeas [publicar tu aplicación](/l/es/developers/extend/apps/operations/publishing), estos campos opcionales controlan cómo aparece en el marketplace:
+
+| Campo | Descripción |
+| ------------------ | -------------------------------------------------------------------------------------------------------------------------------------- |
+| `author` | Nombre del autor o de la empresa |
+| `category` | Categoría de la aplicación para el filtrado en el marketplace |
+| `logoUrl` | Ruta al logotipo de tu aplicación (p. ej., `public/logo.png`) |
+| `screenshots` | Arreglo de rutas de capturas de pantalla (p. ej., `public/screenshot-1.png`) |
+| `aboutDescription` | Descripción en Markdown más extensa para la pestaña "Acerca de". Si se omite, el marketplace utiliza el `README.md` del paquete en npm |
+| `websiteUrl` | Enlace a tu sitio web |
+| `termsUrl` | Enlace a los términos del servicio |
+| `emailSupport` | Dirección de correo electrónico de soporte |
+| `issueReportUrl` | Enlace al rastreador de incidencias |
diff --git a/packages/twenty-docs/l/es/developers/extend/apps/config/install-hooks.mdx b/packages/twenty-docs/l/es/developers/extend/apps/config/install-hooks.mdx
new file mode 100644
index 00000000000..3b1ba0f235a
--- /dev/null
+++ b/packages/twenty-docs/l/es/developers/extend/apps/config/install-hooks.mdx
@@ -0,0 +1,206 @@
+---
+title: Hooks de instalación
+description: "Ejecuta lógica antes o después de la instalación: introduce datos iniciales, haz copias de seguridad de los registros, valida la actualización."
+icon: llave inglesa
+---
+
+Los hooks de instalación son funciones de lógica especiales que se ejecutan durante el ciclo de vida de la instalación o actualización. Comparten el mismo tiempo de ejecución del controlador que las [logic functions](/l/es/developers/extend/apps/logic/logic-functions) normales y reciben un `InstallPayload`, pero se declaran con sus propias funciones de definición — `definePostInstallLogicFunction()` y `definePreInstallLogicFunction()` — y están fuera del modelo de desencadenadores normal (HTTP, cron, eventos de base de datos).
+
+Cada aplicación puede definir **como máximo una función de preinstalación** y **como máximo una función de posinstalación**. La compilación del manifiesto generará un error si se detecta más de una de cualquiera de las dos.
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│ install flow │
+│ │
+│ upload package → [pre-install] → metadata migration → │
+│ generate SDK → [post-install] │
+│ │
+│ old schema visible new schema visible │
+└─────────────────────────────────────────────────────────────┘
+```
+
+<AccordionGroup>
+<Accordion title="definePostInstallLogicFunction" description="Se ejecuta después de que se aplique la migración de metadatos del espacio de trabajo">
+
+Una función de posinstalación se ejecuta automáticamente una vez que tu aplicación ha terminado de instalarse en un espacio de trabajo. El servidor la ejecuta **después** de que se hayan sincronizado los metadatos de la aplicación y se haya generado el cliente del SDK, de modo que el espacio de trabajo esté completamente listo para usarse y el nuevo esquema esté disponible. Los casos de uso típicos incluyen poblar datos predeterminados, crear registros iniciales, configurar los ajustes del espacio de trabajo o aprovisionar recursos en servicios de terceros.
+
+```ts src/logic-functions/post-install.ts
+import { definePostInstallLogicFunction, type InstallPayload } from 'twenty-sdk/define';
+
+const handler = async (payload: InstallPayload): Promise<void> => {
+ console.log('Post install logic function executed successfully!', payload.previousVersion);
+};
+
+export default definePostInstallLogicFunction({
+ universalIdentifier: 'f7a2b9c1-3d4e-5678-abcd-ef9876543210',
+ name: 'post-install',
+ description: 'Runs after installation to set up the application.',
+ timeoutSeconds: 300,
+ shouldRunOnVersionUpgrade: false,
+ shouldRunSynchronously: false,
+ handler,
+});
+```
+
+También puedes ejecutar manualmente la función de posinstalación en cualquier momento usando la CLI:
+
+```bash filename="Terminal"
+yarn twenty dev:function:exec --postInstall
+```
+
+Puntos clave:
+* Las funciones de posinstalación usan `definePostInstallLogicFunction()` — una variante especializada que omite la configuración de desencadenadores (`cronTriggerSettings`, `databaseEventTriggerSettings`, `httpRouteTriggerSettings`, `toolTriggerSettings`, `workflowActionTriggerSettings`).
+* El controlador recibe un `InstallPayload` con `{ previousVersion?: string; newVersion: string }` — `newVersion` es la versión que se está instalando, y `previousVersion` es la versión que se instaló previamente (o `undefined` en una instalación nueva). Use estos valores para distinguir instalaciones nuevas de actualizaciones y para ejecutar lógica de migración específica de la versión.
+* **Cuándo se ejecuta el hook**: solo en instalaciones nuevas, de forma predeterminada. Pase `shouldRunOnVersionUpgrade: true` si también quiere que se ejecute cuando la app se actualice desde una versión anterior. Si se omite, el indicador es `false` por defecto y las actualizaciones omiten el hook.
+* **Modelo de ejecución — asíncrono por defecto, sincronía opcional**: el indicador `shouldRunSynchronously` controla *cómo* se ejecuta la post-instalación.
+ * `shouldRunSynchronously: false` *(predeterminado)* — el hook se **encola en la cola de mensajes** con `retryLimit: 3` y se ejecuta de forma asíncrona en un worker. La respuesta de instalación se devuelve tan pronto como el trabajo se encola, por lo que un controlador lento o con fallos no bloquea al solicitante. El worker reintentará hasta tres veces. **Úselo para trabajos de larga duración** — sembrar conjuntos de datos grandes, llamar a APIs de terceros lentas, aprovisionar recursos externos, cualquier cosa que pueda exceder una ventana de respuesta HTTP razonable.
+ * `shouldRunSynchronously: true` — el hook se ejecuta **en línea durante el flujo de instalación** (el mismo ejecutor que la pre-instalación). La solicitud de instalación se bloquea hasta que el controlador finaliza y, si arroja una excepción, quien realiza la instalación recibe un `POST_INSTALL_ERROR`. Sin reintentos automáticos. **Úselo para trabajo rápido que debe completarse antes de la respuesta** — por ejemplo, emitir un error de validación al usuario, o una configuración rápida de la que el cliente dependerá inmediatamente después de que regrese la llamada de instalación. Tenga en cuenta que la migración de metadatos ya se ha aplicado cuando se ejecuta la post-instalación, por lo que un fallo en modo síncrono **no** revierte los cambios de esquema — solo expone el error.
+* Asegúrese de que su controlador sea idempotente. En modo asíncrono, la cola puede reintentar hasta tres veces; en cualquier modo, el hook puede ejecutarse de nuevo en las actualizaciones cuando `shouldRunOnVersionUpgrade: true`.
+* Las variables de entorno `APPLICATION_ID`, `APP_ACCESS_TOKEN` y `API_URL` están disponibles dentro del controlador (igual que en cualquier otra función de lógica), por lo que puede llamar a la API de Twenty con un token de acceso de aplicación con alcance a su app.
+* Solo se permite una función de posinstalación por aplicación. La compilación del manifiesto generará un error si se detecta más de una.
+* Los `universalIdentifier`, `shouldRunOnVersionUpgrade` y `shouldRunSynchronously` de la función se adjuntan automáticamente al manifiesto de la aplicación en el campo `postInstallLogicFunction` durante la compilación; no es necesario que los referencies en [`defineApplication()`](/l/es/developers/extend/apps/config/application).
+* El tiempo de espera predeterminado se establece en 300 segundos (5 minutos) para permitir tareas de configuración más largas como la carga inicial de datos.
+* **No se ejecuta en modo de desarrollo**: cuando una app se registra localmente (mediante `yarn twenty dev`), el servidor omite por completo el flujo de instalación y sincroniza archivos directamente a través del observador de la CLI — por lo tanto, la post-instalación nunca se ejecuta en modo de desarrollo, independientemente de `shouldRunSynchronously`. Use `yarn twenty dev:function:exec --postInstall` para activarlo manualmente en un espacio de trabajo en ejecución.
+
+</Accordion>
+<Accordion title="definePreInstallLogicFunction" description="Se ejecuta antes de que se aplique la migración de metadatos del espacio de trabajo">
+
+Una función de preinstalación se ejecuta automáticamente durante la instalación, **antes de que se aplique la migración de metadatos del espacio de trabajo**. Comparte la misma forma de payload que la post-instalación (`InstallPayload`), pero está situada antes en el flujo de instalación para poder preparar el estado del que depende la próxima migración — usos típicos incluyen hacer copias de seguridad de datos, validar la compatibilidad con el nuevo esquema o archivar registros que están a punto de ser reestructurados o eliminados.
+
+```ts src/logic-functions/pre-install.ts
+import { definePreInstallLogicFunction, type InstallPayload } from 'twenty-sdk/define';
+
+const handler = async (payload: InstallPayload): Promise<void> => {
+ console.log('Pre install logic function executed successfully!', payload.previousVersion);
+};
+
+export default definePreInstallLogicFunction({
+ universalIdentifier: 'a1b2c3d4-5678-90ab-cdef-1234567890ab',
+ name: 'pre-install',
+ description: 'Runs before installation to prepare the application.',
+ timeoutSeconds: 300,
+ shouldRunOnVersionUpgrade: true,
+ handler,
+});
+```
+
+También puedes ejecutar manualmente la función de preinstalación en cualquier momento usando la CLI:
+
+```bash filename="Terminal"
+yarn twenty dev:function:exec --preInstall
+```
+
+Puntos clave:
+* Las funciones de pre-instalación usan `definePreInstallLogicFunction()` — la misma configuración especializada que la post-instalación, solo que adjunta a un punto diferente del ciclo de vida.
+* Tanto los controladores de pre- como de post-instalación reciben el mismo tipo `InstallPayload`: `{ previousVersion?: string; newVersion: string }`. Impórtelo una vez y reutilícelo para ambos hooks.
+* **Cuándo se ejecuta el hook**: se ubica justo antes de la migración de metadatos del espacio de trabajo (`synchronizeFromManifest`). Antes de ejecutarse, el servidor realiza una "sincronización simplificada" puramente aditiva que registra la función de pre-instalación de la versión **nueva** en los metadatos del espacio de trabajo — no se toca nada más — y luego la ejecuta. Debido a que esta sincronización es solo aditiva, los objetos, campos y datos de la versión anterior siguen intactos cuando se ejecuta su controlador: puede leer y respaldar de forma segura el estado premigración.
+* **Modelo de ejecución**: la pre-instalación se ejecuta **de forma síncrona** y **bloquea la instalación**. Si el controlador lanza una excepción, la instalación se aborta antes de que se apliquen cambios de esquema — el espacio de trabajo permanece en la versión anterior en un estado consistente. Esto es intencional: la pre-instalación es su última oportunidad para rechazar una actualización arriesgada.
+* Al igual que con la post-instalación, solo se permite una función de preinstalación por aplicación. Se adjunta automáticamente al manifiesto de la aplicación bajo `preInstallLogicFunction` durante la compilación.
+* **No se ejecuta en modo de desarrollo**: igual que la post-instalación — el flujo de instalación se omite por completo para las apps registradas localmente, por lo que la pre-instalación nunca se ejecuta con `yarn twenty dev`. Use `yarn twenty dev:function:exec --preInstall` para activarlo manualmente.
+
+</Accordion>
+<Accordion title="Pre-instalación vs post-instalación: cuándo usar cada una" description="Elegir el hook de instalación adecuado">
+
+Ambos hooks forman parte del mismo flujo de instalación y reciben el mismo `InstallPayload`. La diferencia es **cuándo** se ejecutan con respecto a la migración de metadatos del espacio de trabajo, y eso cambia qué datos pueden tocar de forma segura.
+
+La pre-instalación siempre es **síncrona** (bloquea la instalación y puede abortarla). La post-instalación es **asíncrona por defecto** — se pone en cola en un worker con reintentos automáticos — pero puede optar por ejecución síncrona con `shouldRunSynchronously: true`. Consulte el acordeón `definePostInstallLogicFunction` de arriba para saber cuándo usar cada modo.
+
+**Use `post-install` para cualquier cosa que necesite que exista el nuevo esquema.** Este es el caso más común:
+
+* Sembrar datos predeterminados (crear registros iniciales, vistas predeterminadas, contenido de demostración) sobre objetos y campos recién añadidos.
+* Registrar webhooks con servicios de terceros ahora que la app ya tiene sus credenciales.
+* Llamar a su propia API para finalizar una configuración que depende de los metadatos sincronizados.
+* Lógica idempotente de "asegurar que esto exista" que debe reconciliar el estado en cada actualización — combínela con `shouldRunOnVersionUpgrade: true`.
+
+Ejemplo — sembrar un registro `PostCard` predeterminado después de la instalación:
+
+```ts src/logic-functions/post-install.ts
+import { definePostInstallLogicFunction, type InstallPayload } from 'twenty-sdk/define';
+import { createClient } from './generated/client';
+
+const handler = async ({ previousVersion }: InstallPayload): Promise<void> => {
+ if (previousVersion) return; // fresh installs only
+
+ const client = createClient();
+ await client.postCard.create({
+ data: { title: 'Welcome to Postcard', content: 'Your first card!' },
+ });
+};
+
+export default definePostInstallLogicFunction({
+ universalIdentifier: 'f7a2b9c1-3d4e-5678-abcd-ef9876543210',
+ name: 'post-install',
+ description: 'Seeds a welcome post card after install.',
+ timeoutSeconds: 300,
+ shouldRunOnVersionUpgrade: false,
+ handler,
+});
+```
+
+**Use `pre-install` cuando una migración, de otro modo, destruiría o corrompería datos existentes.** Como la pre-instalación se ejecuta contra el esquema *anterior* y su fallo revierte la actualización, es el lugar adecuado para cualquier cosa arriesgada:
+
+* **Hacer copia de seguridad de datos que están a punto de eliminarse o reestructurarse** — p. ej., está quitando un campo en la v2 y necesita copiar sus valores a otro campo o exportarlos a almacenamiento antes de que se ejecute la migración.
+* **Archivar registros que una nueva restricción invalidaría** — p. ej., un campo pasará a ser `NOT NULL` y primero necesita eliminar o corregir filas con valores nulos.
+* **Validar la compatibilidad y rechazar la actualización si los datos actuales no pueden migrarse limpiamente** — lance desde el controlador y la instalación se abortará sin aplicar cambios. Esto es más seguro que descubrir la incompatibilidad a mitad de la migración.
+* **Renombrar o reasignar claves de datos** antes de un cambio de esquema que perdería la asociación.
+
+Ejemplo — archivar registros antes de una migración destructiva:
+
+```ts src/logic-functions/pre-install.ts
+import { definePreInstallLogicFunction, type InstallPayload } from 'twenty-sdk/define';
+import { createClient } from './generated/client';
+
+const handler = async ({ previousVersion, newVersion }: InstallPayload): Promise<void> => {
+ // Only the 1.x → 2.x upgrade drops the legacy `notes` field.
+ if (!previousVersion?.startsWith('1.') || !newVersion.startsWith('2.')) {
+ return;
+ }
+
+ const client = createClient();
+ const legacyRecords = await client.postCard.findMany({
+ where: { notes: { isNotNull: true } },
+ });
+
+ if (legacyRecords.length === 0) return;
+
+ // Copy legacy `notes` into the new `description` field before the migration
+ // drops the `notes` column. If this fails, the upgrade is aborted and the
+ // workspace stays on v1 with all data intact.
+ await Promise.all(
+ legacyRecords.map((record) =>
+ client.postCard.update({
+ where: { id: record.id },
+ data: { description: record.notes },
+ }),
+ ),
+ );
+};
+
+export default definePreInstallLogicFunction({
+ universalIdentifier: 'a1b2c3d4-5678-90ab-cdef-1234567890ab',
+ name: 'pre-install',
+ description: 'Backs up legacy notes into description before the v2 migration.',
+ timeoutSeconds: 300,
+ shouldRunOnVersionUpgrade: true,
+ handler,
+});
+```
+
+**Regla general:**
+
+| Quiere... | Usar |
+| -------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------- |
+| Sembrar datos predeterminados, configurar el espacio de trabajo, registrar recursos externos | `post-install` |
+| Ejecutar siembras de larga duración o llamadas a terceros que no deberían bloquear la respuesta de instalación | `post-install` (predeterminado — `shouldRunSynchronously: false`, con reintentos del worker) |
+| Ejecutar una configuración rápida de la que el cliente dependerá inmediatamente después de que regrese la llamada de instalación | `post-install` con `shouldRunSynchronously: true` |
+| Leer o hacer copia de seguridad de datos que la próxima migración perdería | `pre-install` |
+| Rechazar una actualización que corrompería datos existentes | `pre-install` (lanzar desde el controlador) |
+| Ejecutar reconciliación en cada actualización | `post-install` con `shouldRunOnVersionUpgrade: true` |
+| Realizar una configuración única solo en la primera instalación | `post-install` con `shouldRunOnVersionUpgrade: false` (predeterminado) |
+
+<Note>
+En caso de duda, elija **post-install** como predeterminado. Recurra a la pre-instalación solo cuando la propia migración sea destructiva y necesite interceptar el estado anterior antes de que desaparezca.
+</Note>
+
+</Accordion>
+</AccordionGroup>
diff --git a/packages/twenty-docs/l/es/developers/extend/apps/config/overview.mdx b/packages/twenty-docs/l/es/developers/extend/apps/config/overview.mdx
new file mode 100644
index 00000000000..6d8fa766dbd
--- /dev/null
+++ b/packages/twenty-docs/l/es/developers/extend/apps/config/overview.mdx
@@ -0,0 +1,51 @@
+---
+title: Resumen
+description: "Configura la propia app: su identidad, los permisos predeterminados y lo que se ejecuta en el momento de la instalación."
+icon: screwdriver-wrench
+---
+
+La **capa de configuración** de una app de Twenty es lo que describe la app *a la plataforma*: su identidad, los permisos que posee y el código que se ejecuta durante la instalación o la actualización. Estas declaraciones no añaden nuevas estructuras de datos ni comportamiento en tiempo de ejecución; le indican a Twenty *quién es la app* y *cómo configurarla*.
+
+```text
+┌────────────────────────────────────────────────────────┐
+│ Application — identity, default role, variables, │
+│ marketplace metadata │
+│ │
+│ ┌──────────────────────────────────────────────────┐ │
+│ │ Role — what the app's logic functions can read │ │
+│ │ and write (referenced by Application) │ │
+│ └──────────────────────────────────────────────────┘ │
+└────────────────────────────────────────────────────────┘
+ │
+ ▼ (at install / upgrade time)
+ ┌──────────────────────────────────┐
+ │ Pre-install hook │ before metadata migration
+ └──────────────────────────────────┘
+ ┌──────────────────────────────────┐
+ │ Post-install hook │ after metadata migration
+ └──────────────────────────────────┘
+```
+
+## En esta sección
+
+<CardGroup cols={2}>
+ <Card title="Configuración de la aplicación" icon="rocket" href="/l/es/developers/extend/apps/config/application">
+ `defineApplication`: identidad, rol predeterminado, variables y metadatos del marketplace.
+ </Card>
+ <Card title="Roles y permisos" icon="shield-halved" href="/l/es/developers/extend/apps/config/roles">
+ `defineRole`: declara qué pueden leer y escribir las funciones lógicas de tu app.
+ </Card>
+ <Card title="Hooks de instalación" icon="wrench" href="/l/es/developers/extend/apps/config/install-hooks">
+ `definePreInstallLogicFunction` y `definePostInstallLogicFunction`: hacen copias de seguridad de los datos, cargan valores predeterminados y validan actualizaciones.
+ </Card>
+</CardGroup>
+
+## Cómo se relacionan las piezas
+
+* **Application** es el punto de entrada. Cada app tiene exactamente una llamada a `defineApplication()`, y apunta a un **Role** como su valor predeterminado.
+* El **Role** controla qué pueden leer y escribir las funciones lógicas y los componentes de interfaz de la app. Sigue el principio de privilegios mínimos: concede solo los permisos que tu código realmente necesita.
+* Los **hooks de instalación** se ejecutan durante la instalación o la actualización: el hook de preinstalación antes de la migración de metadatos (para poder rechazar una actualización arriesgada) y el hook de postinstalación después de la migración (para poder cargar datos predeterminados con el nuevo esquema).
+
+<Note>
+Los hooks de instalación comparten el entorno de ejecución de la [función lógica](/l/es/developers/extend/apps/logic/logic-functions): misma firma del handler, mismas variables de entorno, mismo cliente de API tipado, pero se declaran con sus propias funciones de definición y viven fuera del modelo de triggers habitual (HTTP, cron, eventos de base de datos).
+</Note>
diff --git a/packages/twenty-docs/l/es/developers/extend/apps/config/public-assets.mdx b/packages/twenty-docs/l/es/developers/extend/apps/config/public-assets.mdx
new file mode 100644
index 00000000000..b9f81d11ecb
--- /dev/null
+++ b/packages/twenty-docs/l/es/developers/extend/apps/config/public-assets.mdx
@@ -0,0 +1,67 @@
+---
+title: Recursos públicos
+description: Distribuye archivos estáticos — imágenes, íconos, fuentes — junto con tu aplicación mediante la carpeta `public/`.
+icon: folder-open
+---
+
+La carpeta `public/` en la raíz de tu aplicación contiene archivos estáticos: imágenes, íconos, fuentes o cualquier otro recurso que tu aplicación necesite en tiempo de ejecución. Estos archivos se incluyen automáticamente en las compilaciones, se sincronizan durante el modo de desarrollo y se suben al servidor.
+
+Los archivos ubicados en `public/` son:
+
+* **De acceso público** — una vez sincronizados con el servidor, los recursos se sirven en una URL pública. No se necesita autenticación para acceder a ellos.
+* **Disponibles en componentes de frontend** — usa las URLs de los recursos para mostrar imágenes, íconos o cualquier medio dentro de tus componentes de React.
+* **Disponibles en funciones de lógica** — referencia las URLs de los recursos en correos electrónicos, respuestas de API o cualquier lógica del lado del servidor.
+* **Usados para metadatos del marketplace** — los campos `logoUrl` y `screenshots` en `defineApplication()` referencian archivos de esta carpeta (p. ej., `public/logo.png`). Estos se muestran en el marketplace cuando se publica tu aplicación.
+* **Sincronizados automáticamente en modo de desarrollo** — cuando agregas, actualizas o eliminas un archivo en `public/`, se sincroniza automáticamente con el servidor. No se necesita reiniciar.
+* **Incluidos en las compilaciones** — `yarn twenty dev:build` agrupa todos los recursos públicos en la salida de distribución.
+
+## Acceder a recursos públicos con `getPublicAssetUrl`
+
+Usa el helper `getPublicAssetUrl` de `twenty-sdk` para obtener la URL completa de un archivo en tu directorio `public/`. Funciona tanto en **funciones de lógica** como en **componentes de frontend**.
+
+**En una función de lógica:**
+
+```ts src/logic-functions/send-invoice.ts
+import { defineLogicFunction } from 'twenty-sdk/define';
+import { getPublicAssetUrl } from 'twenty-sdk/utils';
+
+const handler = async (): Promise<any> => {
+ const logoUrl = getPublicAssetUrl('logo.png');
+ const invoiceUrl = getPublicAssetUrl('templates/invoice.png');
+
+ // Fetch the file content (no auth required — public endpoint)
+ const response = await fetch(invoiceUrl);
+ const buffer = await response.arrayBuffer();
+
+ return { logoUrl, size: buffer.byteLength };
+};
+
+export default defineLogicFunction({
+ universalIdentifier: 'a1b2c3d4-...',
+ name: 'send-invoice',
+ description: 'Sends an invoice with the app logo',
+ timeoutSeconds: 10,
+ handler,
+});
+```
+
+**En un componente de frontend:**
+
+```tsx src/front-components/company-card.tsx
+import { defineFrontComponent } from 'twenty-sdk/define';
+import { getPublicAssetUrl } from 'twenty-sdk/utils';
+
+const CompanyCard = () => {
+ const logoUrl = getPublicAssetUrl('logo.png');
+
+ return <img src={logoUrl} alt="App logo" />;
+};
+
+export default defineFrontComponent({
+ universalIdentifier: '...',
+ name: 'company-card',
+ component: CompanyCard,
+});
+```
+
+El argumento `path` es relativo a la carpeta `public/` de tu aplicación. Tanto `getPublicAssetUrl('logo.png')` como `getPublicAssetUrl('public/logo.png')` resuelven a la misma URL — el prefijo `public/` se elimina automáticamente si está presente.
diff --git a/packages/twenty-docs/l/es/developers/extend/apps/config/roles.mdx b/packages/twenty-docs/l/es/developers/extend/apps/config/roles.mdx
new file mode 100644
index 00000000000..eda6e97a72e
--- /dev/null
+++ b/packages/twenty-docs/l/es/developers/extend/apps/config/roles.mdx
@@ -0,0 +1,94 @@
+---
+title: Roles y permisos
+description: Declara qué objetos y campos pueden leer y escribir las funciones de lógica y los componentes de interfaz de tu aplicación.
+icon: shield-halved
+---
+
+Un **rol** es un conjunto de permisos: qué objetos puede leer o escribir una aplicación, qué campos puede ver y qué capacidades a nivel de plataforma puede usar. Las funciones lógicas y los componentes de interfaz de cada aplicación heredan los permisos del rol marcado con `defineApplicationRole()` (consulta [El rol de función predeterminado](#the-default-function-role) más abajo).
+
+```ts src/roles/restricted-company-role.ts
+import {
+ defineRole,
+ STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS,
+ SystemPermissionFlag,
+} from 'twenty-sdk/define';
+
+export default defineRole({
+ universalIdentifier: '2c80f640-2083-4803-bb49-003e38279de6',
+ label: 'My new role',
+ description: 'A role that can be used in your workspace',
+ canReadAllObjectRecords: false,
+ canUpdateAllObjectRecords: false,
+ canSoftDeleteAllObjectRecords: false,
+ canDestroyAllObjectRecords: false,
+ canUpdateAllSettings: false,
+ canBeAssignedToAgents: false,
+ canBeAssignedToUsers: false,
+ canBeAssignedToApiKeys: false,
+ objectPermissions: [
+ {
+ objectUniversalIdentifier:
+ STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS.company.universalIdentifier,
+ canReadObjectRecords: true,
+ canUpdateObjectRecords: true,
+ canSoftDeleteObjectRecords: false,
+ canDestroyObjectRecords: false,
+ },
+ ],
+ fieldPermissions: [
+ {
+ objectUniversalIdentifier:
+ STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS.company.universalIdentifier,
+ fieldUniversalIdentifier:
+ STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS.company.fields.name
+ .universalIdentifier,
+ canReadFieldValue: false,
+ canUpdateFieldValue: false,
+ },
+ ],
+ permissionFlagUniversalIdentifiers: [SystemPermissionFlag.APPLICATIONS],
+});
+```
+
+## El rol de función predeterminado
+
+Cuando generas una nueva aplicación, la CLI crea un archivo de rol predeterminado declarado con `defineApplicationRole()`:
+
+```ts src/roles/default-role.ts
+import { defineApplicationRole } from 'twenty-sdk/define';
+
+export const DEFAULT_ROLE_UNIVERSAL_IDENTIFIER =
+ 'b648f87b-1d26-4961-b974-0908fd991061';
+
+export default defineApplicationRole({
+ universalIdentifier: DEFAULT_ROLE_UNIVERSAL_IDENTIFIER,
+ label: 'Default function role',
+ description: 'Default role for function Twenty client',
+ canReadAllObjectRecords: true,
+ canUpdateAllObjectRecords: false,
+ canSoftDeleteAllObjectRecords: false,
+ canDestroyAllObjectRecords: false,
+ canUpdateAllSettings: false,
+ canBeAssignedToAgents: false,
+ canBeAssignedToUsers: false,
+ canBeAssignedToApiKeys: false,
+ objectPermissions: [],
+ fieldPermissions: [],
+ permissionFlagUniversalIdentifiers: [],
+});
+```
+
+`defineApplicationRole()` es una envoltura ligera alrededor de `defineRole()` que marca **el** rol utilizado como predeterminado de tu aplicación en el momento de la instalación. La validación es idéntica a `defineRole`, pero la canalización de compilación conecta automáticamente su `universalIdentifier` con `defaultRoleUniversalIdentifier` del manifiesto de la aplicación, por lo que no necesitas hacer referencia a él desde [`defineApplication`](/l/es/developers/extend/apps/config/application).
+
+Notas:
+
+* Se permite exactamente **una** llamada a `defineApplicationRole(...)` por aplicación; la compilación del manifiesto fallará si encuentra más de una.
+* Usa `defineRole()` (no `defineApplicationRole()`) para cualquier rol **adicional** que distribuya tu aplicación.
+* Configurar `defaultRoleUniversalIdentifier` explícitamente en `defineApplication()` sigue siendo compatible por motivos de retrocompatibilidad, pero está en desuso en favor de `defineApplicationRole()`.
+
+## Mejores prácticas
+
+* Parte del rol generado automáticamente y luego restríngeelo progresivamente; el valor predeterminado concede un acceso amplio de lectura, lo cual rara vez es lo que quieres en producción.
+* Reemplaza `objectPermissions` y `fieldPermissions` con los objetos y campos que realmente necesitan tus funciones.
+* `permissionFlagUniversalIdentifiers` controla el acceso a capacidades a nivel de plataforma. Manténlos al mínimo.
+* Consulta un ejemplo funcional: [`hello-world/src/roles/function-role.ts`](https://github.com/twentyhq/twenty/blob/main/packages/twenty-apps/hello-world/src/roles/function-role.ts).
diff --git a/packages/twenty-docs/l/es/developers/extend/apps/data/extending-objects.mdx b/packages/twenty-docs/l/es/developers/extend/apps/data/extending-objects.mdx
new file mode 100644
index 00000000000..c3efb836299
--- /dev/null
+++ b/packages/twenty-docs/l/es/developers/extend/apps/data/extending-objects.mdx
@@ -0,0 +1,50 @@
+---
+title: Extender objetos
+description: Añade campos a los objetos estándar de Twenty (Person, Company, …) o a objetos de otras aplicaciones usando defineField.
+icon: wand-magic-sparkles
+---
+
+Usa `defineField()` para añadir un campo a un objeto que no te pertenece — un objeto estándar de Twenty como Person o Company, u otro objeto proporcionado por otra aplicación instalada. A diferencia de los campos en línea declarados dentro de [`defineObject`](/l/es/developers/extend/apps/data/objects), los campos independientes requieren un `objectUniversalIdentifier` para especificar qué objeto extienden.
+
+```ts src/fields/company-loyalty-tier.field.ts
+import { defineField, FieldType } from 'twenty-sdk/define';
+
+export default defineField({
+ universalIdentifier: 'f2a1b3c4-d5e6-7890-abcd-ef1234567890',
+ objectUniversalIdentifier: '701aecb9-eb1c-4d84-9d94-b954b231b64b', // Company object
+ name: 'loyaltyTier',
+ type: FieldType.SELECT,
+ label: 'Loyalty Tier',
+ icon: 'IconStar',
+ options: [
+ { value: 'BRONZE', label: 'Bronze', position: 0, color: 'orange' },
+ { value: 'SILVER', label: 'Silver', position: 1, color: 'gray' },
+ { value: 'GOLD', label: 'Gold', position: 2, color: 'yellow' },
+ ],
+});
+```
+
+## Puntos clave
+
+* `objectUniversalIdentifier` identifica el objeto de destino. Para los objetos estándar de Twenty, importa la constante desde `twenty-sdk`:
+
+ ```ts
+ import { STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS } from 'twenty-sdk/define';
+
+ // STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS.company.universalIdentifier
+ // STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS.person.universalIdentifier
+ // STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS.opportunity.universalIdentifier
+ // …
+ ```
+
+* Al definir campos **en línea dentro de `defineObject()`**, **no** necesitas `objectUniversalIdentifier` — se hereda del objeto padre.
+
+* `defineField()` es la única forma de añadir campos a objetos que no creaste con `defineObject()`.
+
+* La ubicación del archivo depende de ti. La convención es `src/fields/\<name>.field.ts`, pero el SDK detecta campos en cualquier lugar de `src/`.
+
+* Para agregar una pestaña a un diseño de página estándar (por ejemplo, la página de detalles de la Tarea o de la Empresa), usa [`definePageLayoutTab`](/l/es/developers/extend/apps/layout/page-layouts#definepagelayouttab) con `STANDARD_PAGE_LAYOUT_UNIVERSAL_IDENTIFIERS` de `twenty-sdk/define`.
+
+## Añadir una relación a un objeto existente
+
+Para añadir un campo de relación (por ejemplo, vinculando tu objeto personalizado a un `Person` estándar), usa `defineField()` con `FieldType.RELATION`. El patrón es el mismo que para las relaciones en línea, pero con `objectUniversalIdentifier` establecido explícitamente. Consulta [Relaciones](/l/es/developers/extend/apps/data/relations) para conocer el patrón bidireccional.
diff --git a/packages/twenty-docs/l/es/developers/extend/apps/data/objects.mdx b/packages/twenty-docs/l/es/developers/extend/apps/data/objects.mdx
new file mode 100644
index 00000000000..d9edf1f2f00
--- /dev/null
+++ b/packages/twenty-docs/l/es/developers/extend/apps/data/objects.mdx
@@ -0,0 +1,104 @@
+---
+title: Objetos
+description: Declara nuevos tipos de registro (tablas personalizadas con sus propios campos) usando defineObject.
+icon: tabla
+---
+
+Los **objetos** personalizados son nuevos tipos de registro que tu aplicación añade a un espacio de trabajo — Tarjeta postal, Factura, Suscripción, cualquier cosa específica de tu dominio. Cada objeto declara su esquema (campos, relaciones, valores predeterminados) y un identificador universal estable que se mantiene a través de sincronizaciones e implementaciones.
+
+```ts src/objects/post-card.object.ts
+import { defineObject, FieldType } from 'twenty-sdk/define';
+
+enum PostCardStatus {
+ DRAFT = 'DRAFT',
+ SENT = 'SENT',
+ DELIVERED = 'DELIVERED',
+ RETURNED = 'RETURNED',
+}
+
+export default defineObject({
+ universalIdentifier: '54b589ca-eeed-4950-a176-358418b85c05',
+ nameSingular: 'postCard',
+ namePlural: 'postCards',
+ labelSingular: 'Post Card',
+ labelPlural: 'Post Cards',
+ description: 'A post card object',
+ icon: 'IconMail',
+ fields: [
+ {
+ universalIdentifier: '58a0a314-d7ea-4865-9850-7fb84e72f30b',
+ name: 'content',
+ type: FieldType.TEXT,
+ label: 'Content',
+ description: "Postcard's content",
+ icon: 'IconAbc',
+ },
+ {
+ universalIdentifier: 'c6aa31f3-da76-4ac6-889f-475e226009ac',
+ name: 'recipientName',
+ type: FieldType.FULL_NAME,
+ label: 'Recipient name',
+ icon: 'IconUser',
+ },
+ {
+ universalIdentifier: '95045777-a0ad-49ec-98f9-22f9fc0c8266',
+ name: 'recipientAddress',
+ type: FieldType.ADDRESS,
+ label: 'Recipient address',
+ icon: 'IconHome',
+ },
+ {
+ universalIdentifier: '87b675b8-dd8c-4448-b4ca-20e5a2234a1e',
+ name: 'status',
+ type: FieldType.SELECT,
+ label: 'Status',
+ icon: 'IconSend',
+ defaultValue: `'${PostCardStatus.DRAFT}'`,
+ options: [
+ { value: PostCardStatus.DRAFT, label: 'Draft', position: 0, color: 'gray' },
+ { value: PostCardStatus.SENT, label: 'Sent', position: 1, color: 'orange' },
+ { value: PostCardStatus.DELIVERED, label: 'Delivered', position: 2, color: 'green' },
+ { value: PostCardStatus.RETURNED, label: 'Returned', position: 3, color: 'orange' },
+ ],
+ },
+ {
+ universalIdentifier: 'e06abe72-5b44-4e7f-93be-afc185a3c433',
+ name: 'deliveredAt',
+ type: FieldType.DATE_TIME,
+ label: 'Delivered at',
+ icon: 'IconCheck',
+ isNullable: true,
+ defaultValue: null,
+ },
+ ],
+});
+```
+
+## Puntos clave
+
+* El `universalIdentifier` debe ser único y estable entre implementaciones.
+* Cada campo requiere `name`, `type`, `label` y su propio `universalIdentifier` estable.
+* La matriz `fields` es opcional: puedes definir objetos sin campos personalizados.
+* Los campos en línea definidos aquí **no** necesitan un `objectUniversalIdentifier`, ya que se hereda del objeto padre. Usa [`defineField()`](/l/es/developers/extend/apps/data/extending-objects) para añadir campos a objetos que no te pertenecen.
+* Puedes generar nuevos objetos con `yarn twenty dev:add object`, que te guía en la asignación de nombres, los campos y las relaciones. Consulta [Arquitectura → Generación de entidades](/l/es/developers/extend/apps/getting-started/scaffolding).
+
+<Note>
+**Los campos base se añaden automáticamente.** Cuando defines un objeto personalizado, Twenty crea campos estándar como `id`, `name`, `createdAt`, `updatedAt`, `createdBy`, `updatedBy` y `deletedAt` por ti. No necesitas declararlos en tu matriz `fields`, solo tus campos personalizados. Puedes sobrescribir un campo predeterminado declarando uno con el mismo nombre, pero esto rara vez es una buena idea.
+</Note>
+
+## Valores predeterminados
+
+Los valores predeterminados de cadenas literales deben ir entre comillas simples **dentro** de la cadena — `defaultValue: "'Draft'"`, no `defaultValue: "Draft"`. Por eso el campo `status` anterior utiliza `` `'${PostCardStatus.DRAFT}'` ``.
+
+Las cadenas sin comillas se reservan para valores predeterminados calculados, evaluados cuando se crea un registro:
+
+* `'uuid'` — genera un UUID (para campos `UUID`)
+* `'now'` — la marca de tiempo actual (para campos `DATE_TIME`)
+
+La misma convención se aplica a los subcampos de tipo cadena de los valores predeterminados compuestos (por ejemplo, `{ source: "'MANUAL'" }` en un campo `ACTOR`) y a los valores de `SELECT`/`MULTI_SELECT`. Un valor predeterminado de tipo cadena literal dejado sin comillas genera una advertencia cuando se compila tu aplicación.
+
+## ¿Qué sigue?
+
+* **Conecta este objeto con otros**: consulta [Relaciones](/l/es/developers/extend/apps/data/relations) para el patrón de relación bidireccional.
+* **Añade campos a objetos de otras aplicaciones**: consulta [Extender objetos](/l/es/developers/extend/apps/data/extending-objects) para `defineField()`.
+* **Muestra este objeto en la interfaz de usuario**: consulta [Vistas](/l/es/developers/extend/apps/layout/views) y [Elementos del menú de navegación](/l/es/developers/extend/apps/layout/navigation-menu-items) para colocarlo en la barra lateral.
diff --git a/packages/twenty-docs/l/es/developers/extend/apps/data/overview.mdx b/packages/twenty-docs/l/es/developers/extend/apps/data/overview.mdx
new file mode 100644
index 00000000000..db4d13f69f8
--- /dev/null
+++ b/packages/twenty-docs/l/es/developers/extend/apps/data/overview.mdx
@@ -0,0 +1,97 @@
+---
+title: Resumen
+description: "Da forma a los datos que tu aplicación agrega a un espacio de trabajo: objetos, campos y relaciones."
+icon: database
+---
+
+La **capa de datos** de una aplicación de Twenty es el conjunto de datos que tu aplicación *agrega* a un espacio de trabajo — los nuevos tipos de registros que declara, las columnas que agrega a los objetos existentes y cómo esos registros se conectan entre sí.
+
+```text
+┌──────────────────────────────────────────────────┐
+│ Object — a record type, e.g. PostCard │
+│ ├─ Field (name, type, label) │
+│ ├─ Field │
+│ └─ Relation (link to another object) │
+└──────────────────────────────────────────────────┘
+ │
+ ├── lives in your app, OR
+ │
+ ▼
+┌──────────────────────────────────────────────────┐
+│ Standard / other apps' objects │
+│ └─ Field added by your app via defineField │
+└──────────────────────────────────────────────────┘
+```
+
+## En esta sección
+
+<CardGroup cols={2}>
+ <Card title="Objetos" icon="table" href="/l/es/developers/extend/apps/data/objects">
+ `defineObject` — declara nuevos tipos de registros con sus propios campos.
+ </Card>
+ <Card title="Extender objetos" icon="wand-magic-sparkles" href="/l/es/developers/extend/apps/data/extending-objects">
+ `defineField` — agrega campos a objetos estándar o de otras aplicaciones.
+ </Card>
+ <Card title="Relaciones" icon="diagram-project" href="/l/es/developers/extend/apps/data/relations">
+ Conexiones bidireccionales `MANY_TO_ONE` / `ONE_TO_MANY` entre objetos.
+ </Card>
+</CardGroup>
+
+## Entidades de un vistazo
+
+| Entidad | Propósito | Definido con |
+| ------------ | ---------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------- |
+| **Objeto** | Un nuevo tipo de registro personalizado (por ejemplo, PostCard, Invoice) con sus propios campos | `defineObject()` |
+| **Campo** | Una columna en un objeto. Los campos independientes pueden ampliar objetos que no creaste (por ejemplo, agregar `loyaltyTier` a Company) | `defineField()` |
+| **Relación** | Un vínculo bidireccional entre dos objetos: ambos lados se declaran como campos | `defineField()` con `FieldType.RELATION` |
+| **Índice** | Un índice de base de datos para acelerar una consulta recurrente sobre uno de tus objetos | `defineIndex()` |
+
+El SDK detecta estos mediante análisis AST en tiempo de compilación, por lo que la organización de archivos depende de ti; la convención es `src/objects/`, `src/fields/` y `src/indexes/`. Los UUID `universalIdentifier` estables vinculan todo a través de los despliegues.
+
+## Índices (opcional)
+
+Las aplicaciones pueden incluir índices junto con sus objetos para mantener rápidas las consultas recurrentes. El caso más habitual es una columna de estado o de clave externa que lees con frecuencia.
+
+```ts src/indexes/post-card-status.index.ts
+import { defineIndex } from 'twenty-sdk/define';
+
+import {
+ POST_CARD_UNIVERSAL_IDENTIFIER,
+ STATUS_FIELD_UNIVERSAL_IDENTIFIER,
+} from '../objects/post-card.object';
+
+export default defineIndex({
+ universalIdentifier: 'b6e9d2a1-5a4c-46ca-9d52-42c8f02d1ff0',
+ objectUniversalIdentifier: POST_CARD_UNIVERSAL_IDENTIFIER,
+ fields: [
+ {
+ universalIdentifier: 'b6e9d2a1-5a4c-46ca-9d52-42c8f02d1ff1',
+ fieldUniversalIdentifier: STATUS_FIELD_UNIVERSAL_IDENTIFIER,
+ },
+ ],
+});
+```
+
+### Índices únicos
+
+`defineIndex` acepta `isUnique: true` tanto para unicidad de una sola columna como de varias columnas. Este es el elemento primitivo recomendado — `defineField({ isUnique: true })` está obsoleto y se eliminará en una versión futura.
+
+```ts
+defineIndex({
+ universalIdentifier: '…',
+ objectUniversalIdentifier: PERSON_UNIVERSAL_IDENTIFIER,
+ isUnique: true,
+ fields: [{ universalIdentifier: '…', fieldUniversalIdentifier: EMAIL_FIELD_UNIVERSAL_IDENTIFIER }],
+});
+```
+
+### Otras restricciones
+
+* Las cláusulas `WHERE` parciales permanecen bajo el control del administrador: las aplicaciones no pueden declararlas.
+* Cada objeto está limitado a 10 índices personalizados (los índices propios del framework no cuentan).
+
+Ordena el arreglo `fields` de la forma en que Postgres debería usarlo: la columna más a la izquierda primero, como en una guía telefónica. Los índices no son gratuitos: cada escritura en la tabla los actualiza. Añade uno solo cuando tengas una consulta que lo necesite.
+
+<Note>
+¿Buscas **Application Config** o **Roles & Permissions**? Esos describen la propia aplicación en lugar de los datos que agrega; se encuentran en [Config](/l/es/developers/extend/apps/config/overview). ¿Buscas **Connections** (Linear, GitHub, Slack OAuth)? Estas existen para ser llamadas *desde* las funciones lógicas y se encuentran en [Logic](/l/es/developers/extend/apps/logic/connections).
+</Note>
diff --git a/packages/twenty-docs/l/es/developers/extend/apps/data/relations.mdx b/packages/twenty-docs/l/es/developers/extend/apps/data/relations.mdx
new file mode 100644
index 00000000000..c9da4c2e9ca
--- /dev/null
+++ b/packages/twenty-docs/l/es/developers/extend/apps/data/relations.mdx
@@ -0,0 +1,160 @@
+---
+title: Relaciones
+description: Conecta objetos entre sí con relaciones bidireccionales MANY_TO_ONE / ONE_TO_MANY.
+icon: diagram-project
+---
+
+Las relaciones conectan dos objetos entre sí. En Twenty, las relaciones siempre son **bidireccionales**: cada relación tiene dos lados, y cada lado se declara como un campo que hace referencia al otro.
+
+| Tipo de relación | Descripción | ¿Tiene clave foránea? |
+| ---------------- | --------------------------------------------------------------------------- | --------------------- |
+| `MANY_TO_ONE` | Muchos registros de este objeto apuntan a un registro del objeto de destino | Sí (`joinColumnName`) |
+| `ONE_TO_MANY` | Un registro de este objeto tiene muchos registros del objeto de destino | No (lado inverso) |
+
+## Cómo funcionan las relaciones
+
+Cada relación requiere **dos campos** que se referencian entre sí:
+
+1. El lado **MANY_TO_ONE** — vive en el objeto que contiene la clave foránea.
+2. El lado **ONE_TO_MANY** — vive en el objeto que es propietario de la colección.
+
+Ambos campos usan `FieldType.RELATION` y se hacen referencia cruzada mediante `relationTargetFieldMetadataUniversalIdentifier`.
+
+## Ejemplo: la tarjeta postal tiene muchos destinatarios
+
+Un `PostCard` puede enviarse a muchos registros `PostCardRecipient`. Cada destinatario pertenece exactamente a una tarjeta postal.
+
+**Paso 1: Define el lado ONE_TO_MANY en PostCard** (el lado "uno"):
+
+```ts src/fields/post-card-recipients-on-post-card.field.ts
+import { defineField, FieldType, RelationType } from 'twenty-sdk/define';
+import { POST_CARD_UNIVERSAL_IDENTIFIER } from '../objects/post-card.object';
+import { POST_CARD_RECIPIENT_UNIVERSAL_IDENTIFIER } from '../objects/post-card-recipient.object';
+
+// Export so the other side can reference it
+export const POST_CARD_RECIPIENTS_FIELD_ID = 'a1111111-1111-1111-1111-111111111111';
+// Import from the other side
+import { POST_CARD_FIELD_ID } from './post-card-on-post-card-recipient.field';
+
+export default defineField({
+ universalIdentifier: POST_CARD_RECIPIENTS_FIELD_ID,
+ objectUniversalIdentifier: POST_CARD_UNIVERSAL_IDENTIFIER,
+ type: FieldType.RELATION,
+ name: 'postCardRecipients',
+ label: 'Post Card Recipients',
+ icon: 'IconUsers',
+ relationTargetObjectMetadataUniversalIdentifier: POST_CARD_RECIPIENT_UNIVERSAL_IDENTIFIER,
+ relationTargetFieldMetadataUniversalIdentifier: POST_CARD_FIELD_ID,
+ universalSettings: {
+ relationType: RelationType.ONE_TO_MANY,
+ },
+});
+```
+
+**Paso 2: Define el lado MANY_TO_ONE en PostCardRecipient** (el lado "muchos" — contiene la clave foránea):
+
+```ts src/fields/post-card-on-post-card-recipient.field.ts
+import { defineField, FieldType, RelationType, OnDeleteAction } from 'twenty-sdk/define';
+import { POST_CARD_UNIVERSAL_IDENTIFIER } from '../objects/post-card.object';
+import { POST_CARD_RECIPIENT_UNIVERSAL_IDENTIFIER } from '../objects/post-card-recipient.object';
+
+// Export so the other side can reference it
+export const POST_CARD_FIELD_ID = 'b2222222-2222-2222-2222-222222222222';
+// Import from the other side
+import { POST_CARD_RECIPIENTS_FIELD_ID } from './post-card-recipients-on-post-card.field';
+
+export default defineField({
+ universalIdentifier: POST_CARD_FIELD_ID,
+ objectUniversalIdentifier: POST_CARD_RECIPIENT_UNIVERSAL_IDENTIFIER,
+ type: FieldType.RELATION,
+ name: 'postCard',
+ label: 'Post Card',
+ icon: 'IconMail',
+ relationTargetObjectMetadataUniversalIdentifier: POST_CARD_UNIVERSAL_IDENTIFIER,
+ relationTargetFieldMetadataUniversalIdentifier: POST_CARD_RECIPIENTS_FIELD_ID,
+ universalSettings: {
+ relationType: RelationType.MANY_TO_ONE,
+ onDelete: OnDeleteAction.CASCADE,
+ joinColumnName: 'postCardId',
+ },
+});
+```
+
+<Note>
+**Importaciones circulares:** ambos campos de relación hacen referencia al `universalIdentifier` del otro. Para evitar problemas de importaciones circulares, exporta los ID de tus campos como constantes con nombre desde cada archivo e impórtalos en el otro. El sistema de compilación los resuelve en tiempo de compilación.
+</Note>
+
+## Relacionar con objetos estándar
+
+Para crear una relación con un objeto integrado de Twenty (Person, Company, etc.), usa `STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS`:
+
+```ts src/fields/person-on-self-hosting-user.field.ts
+import {
+ defineField,
+ FieldType,
+ RelationType,
+ OnDeleteAction,
+ STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS,
+} from 'twenty-sdk/define';
+import { SELF_HOSTING_USER_UNIVERSAL_IDENTIFIER } from '../objects/self-hosting-user.object';
+
+export const PERSON_FIELD_ID = 'c3333333-3333-3333-3333-333333333333';
+export const SELF_HOSTING_USER_REVERSE_FIELD_ID = 'd4444444-4444-4444-4444-444444444444';
+
+export default defineField({
+ universalIdentifier: PERSON_FIELD_ID,
+ objectUniversalIdentifier: SELF_HOSTING_USER_UNIVERSAL_IDENTIFIER,
+ type: FieldType.RELATION,
+ name: 'person',
+ label: 'Person',
+ description: 'Person matching with the self hosting user',
+ isNullable: true,
+ relationTargetObjectMetadataUniversalIdentifier:
+ STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS.person.universalIdentifier,
+ relationTargetFieldMetadataUniversalIdentifier: SELF_HOSTING_USER_REVERSE_FIELD_ID,
+ universalSettings: {
+ relationType: RelationType.MANY_TO_ONE,
+ onDelete: OnDeleteAction.SET_NULL,
+ joinColumnName: 'personId',
+ },
+});
+```
+
+## Propiedades del campo de relación
+
+| Propiedad | Obligatorio | Descripción |
+| ------------------------------------------------- | --------------------- | ------------------------------------------------------------------------------------------------------ |
+| `type` | Sí | Debe ser `FieldType.RELATION` |
+| `relationTargetObjectMetadataUniversalIdentifier` | Sí | El `universalIdentifier` del objeto de destino |
+| `relationTargetFieldMetadataUniversalIdentifier` | Sí | El `universalIdentifier` del campo correspondiente en el objeto de destino |
+| `universalSettings.relationType` | Sí | `RelationType.MANY_TO_ONE` o `RelationType.ONE_TO_MANY` |
+| `universalSettings.onDelete` | Solo para MANY_TO_ONE | Qué sucede cuando se elimina el registro referenciado: `CASCADE`, `SET_NULL`, `RESTRICT` o `NO_ACTION` |
+| `universalSettings.joinColumnName` | Solo para MANY_TO_ONE | Nombre de la columna de base de datos para la clave foránea (p. ej., `postCardId`) |
+
+## Campos de relación en línea
+
+También puedes declarar una relación directamente dentro de [`defineObject`](/l/es/developers/extend/apps/data/objects). Cuando es en línea, omite `objectUniversalIdentifier` — se hereda del objeto padre:
+
+```ts
+export default defineObject({
+ universalIdentifier: '...',
+ nameSingular: 'postCardRecipient',
+ // ...
+ fields: [
+ {
+ universalIdentifier: POST_CARD_FIELD_ID,
+ type: FieldType.RELATION,
+ name: 'postCard',
+ label: 'Post Card',
+ relationTargetObjectMetadataUniversalIdentifier: POST_CARD_UNIVERSAL_IDENTIFIER,
+ relationTargetFieldMetadataUniversalIdentifier: POST_CARD_RECIPIENTS_FIELD_ID,
+ universalSettings: {
+ relationType: RelationType.MANY_TO_ONE,
+ onDelete: OnDeleteAction.CASCADE,
+ joinColumnName: 'postCardId',
+ },
+ },
+ // … other fields
+ ],
+});
+```
diff --git a/packages/twenty-docs/l/es/developers/extend/apps/getting-started/concepts.mdx b/packages/twenty-docs/l/es/developers/extend/apps/getting-started/concepts.mdx
new file mode 100644
index 00000000000..862c825a20e
--- /dev/null
+++ b/packages/twenty-docs/l/es/developers/extend/apps/getting-started/concepts.mdx
@@ -0,0 +1,101 @@
+---
+title: Conceptos
+description: "Cómo funcionan las aplicaciones de Twenty: modelo de entidad, sandboxing y ciclo de vida de la instalación."
+icon: sitemap
+---
+
+Las aplicaciones de Twenty son paquetes de TypeScript que amplían tu espacio de trabajo con objetos personalizados, lógica, componentes de UI y capacidades de IA. Se ejecutan en la plataforma Twenty con sandboxing completo y controles de permisos.
+
+## Cómo funcionan las aplicaciones
+
+Una aplicación es un conjunto de **entidades** declaradas usando funciones `defineEntity()` del paquete `twenty-sdk`. El SDK detecta estas declaraciones mediante análisis de AST en tiempo de compilación y produce un **manifiesto** — una descripción completa de lo que tu aplicación agrega a un espacio de trabajo. Estas funciones validan tu configuración en tiempo de compilación y proporcionan autocompletado en el IDE y seguridad de tipos.
+
+```
+your-app/
+├── src/
+│ ├── application-config.ts ← defineApplication (required, one per app)
+│ ├── roles/ ← defineRole
+│ ├── objects/ ← defineObject
+│ ├── fields/ ← defineField
+│ ├── logic-functions/ ← defineLogicFunction
+│ ├── front-components/ ← defineFrontComponent
+│ ├── skills/ ← defineSkill
+│ ├── agents/ ← defineAgent
+│ ├── views/ ← defineView
+│ ├── navigation-menu-items/ ← defineNavigationMenuItem
+│ └── page-layouts/ ← definePageLayout
+├── public/ ← Static assets (images, icons)
+└── package.json
+```
+
+<Note>
+ **La organización de archivos depende de ti.** La detección de entidades se basa en el AST — el SDK encuentra llamadas a `export default defineEntity(...)` sin importar dónde se encuentre el archivo. La estructura de carpetas anterior es una convención, no un requisito.
+</Note>
+
+## Tipos de entidades
+
+| Entidad | Propósito | Documentación |
+| ----------------------------------- | ---------------------------------------------------------------- | ---------------------------------------------------------------------------------------- |
+| **Aplicación** | Identidad de la aplicación, rol predeterminado, variables | [Configuración de la aplicación](/l/es/developers/extend/apps/config/application) |
+| **Rol** | Conjuntos de permisos para objetos y campos | [Roles y permisos](/l/es/developers/extend/apps/config/roles) |
+| **Objeto** | Tipos de registros personalizados con campos | [Objetos](/l/es/developers/extend/apps/data/objects) |
+| **Campo** | Agregar campos a objetos de otras aplicaciones | [Ampliar objetos](/l/es/developers/extend/apps/data/extending-objects) |
+| **Relación** | Vínculos bidireccionales entre objetos | [Relaciones](/l/es/developers/extend/apps/data/relations) |
+| **Función de lógica** | TypeScript del lado del servidor con activadores | [Funciones de lógica](/l/es/developers/extend/apps/logic/logic-functions) |
+| **Habilidad** | Instrucciones reutilizables para agentes de IA | [Habilidades y agentes](/l/es/developers/extend/apps/logic/skills-and-agents) |
+| **Agente** | Asistentes de IA con prompts personalizados | [Habilidades y agentes](/l/es/developers/extend/apps/logic/skills-and-agents) |
+| **Proveedor de conexión** | Credenciales OAuth para APIs de terceros | [Conexiones](/l/es/developers/extend/apps/logic/connections) |
+| **Vista** | Vistas de listas de registros preconfiguradas | [Vistas](/l/es/developers/extend/apps/layout/views) |
+| **Elemento del menú de navegación** | Entradas personalizadas de la barra lateral | [Elementos del menú de navegación](/l/es/developers/extend/apps/layout/navigation-menu-items) |
+| **Diseño de página** | Pestañas y widgets en la página de detalles de un registro | [Diseños de página](/l/es/developers/extend/apps/layout/page-layouts) |
+| **Componente de frontend** | Interfaz de usuario de React en entorno aislado dentro de Twenty | [Componentes de frontend](/l/es/developers/extend/apps/layout/front-components) |
+| **Elemento del menú de comandos** | Acciones rápidas y entradas Cmd+K | [Elementos del menú de comandos](/l/es/developers/extend/apps/layout/command-menu-items) |
+
+## Sandboxing
+
+* **Las funciones de lógica** se ejecutan en procesos de Node.js aislados en el servidor. Solo acceden a los datos a través del cliente de API tipado, limitado a los permisos del rol de la aplicación.
+* **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). Se comunican con Twenty a través de una API de host de paso de mensajes.
+* **Los permisos** se aplican a nivel de API. El token de tiempo de ejecución (`TWENTY_APP_ACCESS_TOKEN`) se deriva del rol definido en `defineApplication()`.
+
+## Ciclo de vida de la aplicación
+
+```
+┌─────────────────────────────────────────────────────────┐
+│ Development │
+│ npx create-twenty-app → yarn twenty dev (live sync) │
+├─────────────────────────────────────────────────────────┤
+│ Build & Deploy │
+│ yarn twenty dev:build → yarn twenty app:publish │
+├─────────────────────────────────────────────────────────┤
+│ Install flow │
+│ upload → [pre-install] → metadata migration → │
+│ generate SDK → [post-install] │
+├─────────────────────────────────────────────────────────┤
+│ Publish │
+│ npm publish → appears in Twenty marketplace │
+└─────────────────────────────────────────────────────────┘
+```
+
+* **`yarn twenty dev`** — observa tus archivos fuente y sincroniza en tiempo real los cambios con un servidor de Twenty conectado. El cliente de API tipado se regenera automáticamente cuando cambia el esquema.
+* **`yarn twenty dev:build`** — compila TypeScript, agrupa las funciones de lógica y los componentes de frontend con esbuild, y produce un manifiesto.
+* **Hooks de pre/post-instalación** — funciones opcionales que se ejecutan durante la instalación. Consulta [Hooks de instalación](/l/es/developers/extend/apps/config/install-hooks) para más detalles.
+
+## Próximos pasos
+
+<CardGroup cols={2}>
+ <Card title="Configuración" icon="screwdriver-wrench" href="/l/es/developers/extend/apps/config/overview">
+ Identidad de la aplicación, rol predeterminado y hooks de instalación.
+ </Card>
+ <Card title="Datos" icon="database" href="/l/es/developers/extend/apps/data/overview">
+ Objetos, campos y relaciones bidireccionales.
+ </Card>
+ <Card title="Lógica" icon="bolt" href="/l/es/developers/extend/apps/logic/overview">
+ Funciones de lógica, habilidades, agentes y conexiones OAuth.
+ </Card>
+ <Card title="Diseño" icon="table-columns" href="/l/es/developers/extend/apps/layout/overview">
+ Vistas, navegación, diseños de página y componentes de frontend.
+ </Card>
+ <Card title="Operaciones" icon="rocket" href="/l/es/developers/extend/apps/operations/overview">
+ CLI, pruebas, remotos, CI y publicación de tu aplicación.
+ </Card>
+</CardGroup>
diff --git a/packages/twenty-docs/l/es/developers/extend/apps/getting-started/local-server.mdx b/packages/twenty-docs/l/es/developers/extend/apps/getting-started/local-server.mdx
new file mode 100644
index 00000000000..08eded2f256
--- /dev/null
+++ b/packages/twenty-docs/l/es/developers/extend/apps/getting-started/local-server.mdx
@@ -0,0 +1,87 @@
+---
+title: Servidor local
+description: "Administra el servidor Docker local de Twenty: inícialo, deténlo, actualízalo, crea una instancia de prueba en paralelo y realiza la configuración manual del SDK."
+icon: server
+---
+
+## Administrar el servidor local
+
+Usa `yarn twenty docker:*` para controlar el contenedor local de Twenty:
+
+| Comando | Qué hace |
+| -------------------------------------- | ----------------------------------------------------------------- |
+| `yarn twenty docker:start` | Inicia el servidor local (descarga la imagen si es necesario) |
+| `yarn twenty docker:start 2.2.0` | Iniciar una versión específica del servidor |
+| `yarn twenty docker:start --port 3030` | Inicia en un puerto personalizado |
+| `yarn twenty docker:stop` | Detiene el servidor (conserva los datos) |
+| `yarn twenty docker:status` | Muestra la URL, la versión y las credenciales de inicio de sesión |
+| `yarn twenty docker:logs` | Transmite los registros del servidor |
+| `yarn twenty docker:reset` | Elimina los datos y comienza desde cero |
+| `yarn twenty docker:upgrade` | Descarga la última imagen `twenty-app-dev` |
+| `yarn twenty docker:upgrade 2.2.0` | Actualiza a una versión específica |
+
+Los datos se conservan entre reinicios en dos volúmenes de Docker (`twenty-app-dev-data` para PostgreSQL, `twenty-app-dev-storage` para archivos). Usa `reset` para borrar todo.
+
+## Fijar la versión del servidor
+
+Cuando no se pasa ninguna versión, `docker:start` resuelve la versión a partir del rango `engines.twenty` de tu aplicación en `package.json`, el mismo rango con el que el servidor valida cuando tu aplicación se instala. Inicia la imagen publicada más reciente de `twenty-app-dev` que satisface el rango, recurriendo a `latest` cuando el campo está ausente o ninguna versión publicada coincide:
+
+```json filename="package.json"
+{
+ "engines": {
+ "twenty": ">=2.2.0"
+ }
+}
+```
+
+Pasa una versión explícitamente para anular el rango en una sola ejecución: `yarn twenty docker:start 2.3.0`. Si ya existe un contenedor en una versión diferente, `docker:start` lo actualiza in situ (recreando el contenedor mientras conserva tus volúmenes de datos).
+
+## Actualización de la imagen del servidor
+
+`yarn twenty docker:upgrade` descarga la última imagen, compara los digests y solo recrea el contenedor si realmente cambió algo. Los volúmenes se conservan — solo se reemplaza el contenedor. Si se descargó una nueva imagen y el contenedor estaba en ejecución, la actualización inicia automáticamente un contenedor nuevo; ejecuta `yarn twenty docker:start` después para esperar a que esté en buen estado.
+
+```bash filename="Terminal"
+yarn twenty docker:upgrade # Latest
+yarn twenty docker:upgrade 2.2.0 # Specific version
+```
+
+Puedes verificar la versión en ejecución con `yarn twenty docker:status` (muestra el `APP_VERSION` incluido en el contenedor).
+
+## Ejecutar una instancia de prueba en paralelo
+
+Pasa `--test` a cualquier comando de `docker:*` para administrar una segunda instancia completamente aislada — útil para ejecutar pruebas de integración o experimentar sin tocar los datos principales de desarrollo:
+
+| Comando | Qué hace |
+| ----------------------------------- | -------------------------------------------------------------- |
+| `yarn twenty docker:start --test` | Inicia la instancia de prueba (usa el puerto 2021 por defecto) |
+| `yarn twenty docker:stop --test` | Deténla |
+| `yarn twenty docker:status --test` | Muestra su estado |
+| `yarn twenty docker:logs --test` | Transmite sus registros |
+| `yarn twenty docker:reset --test` | Borra sus datos |
+| `yarn twenty docker:upgrade --test` | Actualiza su imagen |
+
+La instancia de prueba se ejecuta en su propio contenedor de Docker (`twenty-app-dev-test`) con volúmenes dedicados (`twenty-app-dev-test-data`, `twenty-app-dev-test-storage`) y configuración dedicada, por lo que puede ejecutarse en paralelo con la instancia principal sin conflictos. Combina `--test` con `--port` para anular el puerto predeterminado (2021).
+
+## Configuración manual (sin el generador)
+
+Omite el generador si vas a agregar el SDK a un proyecto existente:
+
+```bash filename="Terminal"
+yarn add twenty-sdk twenty-client-sdk
+```
+
+Agrega el script a `package.json`:
+
+```json filename="package.json"
+{
+ "scripts": {
+ "twenty": "twenty"
+ }
+}
+```
+
+Ahora puedes ejecutar `yarn twenty dev`, `yarn twenty docker:start` y todos los demás comandos.
+
+<Note>
+No instales `twenty-sdk` globalmente — fíjalo por proyecto para que cada app use su propia versión.
+</Note>
diff --git a/packages/twenty-docs/l/es/developers/extend/apps/getting-started/project-structure.mdx b/packages/twenty-docs/l/es/developers/extend/apps/getting-started/project-structure.mdx
new file mode 100644
index 00000000000..11ed884f9b7
--- /dev/null
+++ b/packages/twenty-docs/l/es/developers/extend/apps/getting-started/project-structure.mdx
@@ -0,0 +1,61 @@
+---
+title: Estructura del proyecto
+description: Qué hay dentro de una app de Twenty generada mediante scaffolding — archivos, carpetas y lo que hace cada uno.
+icon: folder-tree
+---
+
+Una nueva app generada por `npx create-twenty-app` se ve así:
+
+```text filename="my-twenty-app/"
+my-twenty-app/
+ package.json
+ src/
+ application-config.ts # Required — your app's entry point
+ default-role.ts # Permissions for logic functions
+ constants/
+ universal-identifiers.ts # Auto-generated UUIDs and metadata
+ __tests__/
+ setup-test.ts
+ app-install.integration-test.ts
+ .github/workflows/ci.yml # GitHub Actions
+ public/ # Static assets
+ vitest.config.ts # Test runner config
+ tsconfig.json, tsconfig.spec.json
+ .nvmrc, .yarnrc.yml, .oxlintrc.json
+ README.md, LLMS.md
+```
+
+## Archivos clave
+
+| Archivo / Carpeta | Propósito |
+| ---------------------------------------- | ----------------------------------------------------------------------------------------- |
+| `src/application-config.ts` | **Obligatorio.** El archivo de configuración principal de tu app. |
+| `src/default-role.ts` | Rol predeterminado que controla a qué pueden acceder tus funciones lógicas. |
+| `src/constants/universal-identifiers.ts` | UUIDs generados automáticamente y metadatos de la app (nombre para mostrar, descripción). |
+| `src/__tests__/` | Pruebas de integración (configuración + prueba de ejemplo). |
+| `public/` | Recursos estáticos (imágenes, fuentes) servidos con tu app. |
+
+<Note>
+**La organización de archivos depende de ti.** Las carpetas anteriores son convenciones: el SDK detecta entidades mediante análisis AST en llamadas a `export default defineEntity(...)`, sin importar dónde se encuentre el archivo.
+</Note>
+
+## Dependencias
+
+Ambos paquetes del SDK de Twenty pertenecen a `devDependencies`, no a `dependencies`:
+
+```json filename="package.json"
+{
+ "dependencies": {},
+ "devDependencies": {
+ "twenty-client-sdk": "^2.13.0",
+ "twenty-sdk": "^2.13.0"
+ }
+}
+```
+
+* **`twenty-sdk`** incluye el CLI `twenty` y las herramientas de build/scaffolding. Solo se ejecuta en el desarrollo y durante el build, y nunca lo importa el runtime de la app que publicas.
+* **`twenty-client-sdk`** *sí* es importado por el código de tu app (`CoreApiClient`, `MetadataApiClient`, `RestApiClient`), pero Twenty lo proporciona en tiempo de ejecución: las funciones lógicas lo obtienen de una capa SDK generada y los componentes de front lo resuelven desde módulos servidos por el servidor. Tu copia instalada solo se utiliza para la comprobación de tipos y el build en tiempo de despliegue, por lo que nunca necesita incluirse en el bundle desplegado.
+
+Mantener cualquiera de los paquetes bajo `dependencies` lo introduce en el bundle de runtime de la app instalada, donde es peso muerto. `twenty build` emite una advertencia cuando cualquiera de ellos sigue listado bajo `dependencies`.
+
+Añade las dependencias de runtime propias de tu app (las bibliotecas que tus funciones lógicas realmente importan en tiempo de ejecución) bajo `dependencies` como de costumbre.
diff --git a/packages/twenty-docs/l/es/developers/extend/apps/getting-started/quick-start.mdx b/packages/twenty-docs/l/es/developers/extend/apps/getting-started/quick-start.mdx
new file mode 100644
index 00000000000..5c11a871526
--- /dev/null
+++ b/packages/twenty-docs/l/es/developers/extend/apps/getting-started/quick-start.mdx
@@ -0,0 +1,176 @@
+---
+title: Inicio rápido
+icon: rocket
+description: Crea tu primera aplicación de Twenty en minutos.
+---
+
+## Prerrequisitos
+
+* **Node.js 24+** — [Descargar](https://nodejs.org/)
+* **Yarn 4** — incluido con Node.js a través de Corepack. Actívalo: `corepack enable`
+* **Docker** — [Descargar](https://www.docker.com/products/docker-desktop/). Necesario para ejecutar un servidor local de Twenty. Omítelo si ya tienes Twenty ejecutándose en otro lugar.
+
+La creación de una app de Twenty tiene tres fases. El generador las combina en un único comando de ruta ideal, pero cada fase es un concepto independiente — cuando algo falla, saber en qué fase estás te indica qué debes corregir.
+
+| Fase | Qué haces | Herramienta | Resultado |
+| --------------------------- | --------------------------------------------------- | ----------------------------- | ------------------------------------ |
+| **1. Generar estructura** | Genera el código fuente de la app | `npx create-twenty-app` | Un proyecto de TypeScript en disco |
+| **2. Ejecutar un servidor** | Inicia un servidor de Twenty con el que sincronizar | Docker + `yarn twenty server` | Una instancia de Twenty en ejecución |
+| **3. Sincronizar** | Sincroniza en vivo tu código con el servidor | `yarn twenty dev` | Tus cambios aparecen en la UI |
+
+---
+
+## Fase 1 — Genera la estructura de tu proyecto
+
+Crea una app nueva a partir de la plantilla:
+
+```bash filename="Terminal"
+npx create-twenty-app@latest my-twenty-app
+```
+
+Se te pedirá un nombre y una descripción — pulsa **Enter** para usar los valores predeterminados. Esto genera un proyecto de TypeScript en `my-twenty-app/` con un `application-config.ts` inicial, un rol predeterminado, un flujo de trabajo de CI y una prueba de integración.
+
+**Después de esta fase:** tienes el código fuente de tu app en tu máquina. Aún no se está ejecutando — esa es la Fase 2.
+
+---
+
+## Fase 2 — Ejecuta un servidor local de Twenty
+
+Tu app necesita un servidor de Twenty con el que sincronizar. El servidor es una instancia completa de Twenty — UI, API GraphQL, PostgreSQL — ejecutándose localmente en Docker. Tu código local sube sus definiciones a ese servidor, lo que hace que aparezcan en la UI.
+
+El generador ofrece iniciar uno por ti:
+
+> **¿Te gustaría configurar una instancia local de Twenty?**
+
+* **Sí (recomendado)** — descarga la imagen de Docker `twentycrm/twenty-app-dev` y la inicia en el puerto `2020`. Asegúrate de que Docker esté en ejecución antes.
+* **No** — elige esto si ya tienes un servidor de Twenty al que te quieres conectar. Puedes conectarlo más tarde con `yarn twenty remote:add`.
+
+<div style={{textAlign: 'center'}}>
+ <img src="/images/docs/developers/extends/apps/start-instance.png" alt="¿Debería iniciar una instancia local?" />
+</div>
+
+Una vez que el servidor esté en marcha, se abrirá un navegador para iniciar sesión. Inicia sesión con la cuenta de demostración precargada:
+
+* **Correo electrónico:** `[email protected]`
+* **Contraseña:** `[email protected]`
+
+<div style={{textAlign: 'center'}}>
+ <img src="/images/docs/developers/extends/apps/login.png" alt="Pantalla de inicio de sesión de Twenty" />
+</div>
+
+Haz clic en **Authorize** en la siguiente pantalla — esto le da a la CLI acceso a tu espacio de trabajo.
+
+<div style={{textAlign: 'center'}}>
+ <img src="/images/docs/developers/extends/apps/authorize.png" alt="Pantalla de autorización de la CLI de Twenty" />
+</div>
+
+Tu terminal confirmará que todo está configurado.
+
+<div style={{textAlign: 'center'}}>
+ <img src="/images/docs/developers/extends/apps/scaffolded.png" alt="Aplicación generada correctamente" />
+</div>
+
+**Después de esta fase:** tienes un servidor de Twenty en ejecución en [http://localhost:2020](http://localhost:2020) con tu CLI autorizada para sincronizar con él.
+
+<Note>
+Si Docker no está instalado o en ejecución, el generador te indicará el comando de inicio correcto para tu sistema operativo. Una vez que Docker esté en marcha, puedes reanudar con `yarn twenty docker:start` — no es necesario volver a generar la estructura.
+</Note>
+
+---
+
+## Fase 3 — Sincroniza tus cambios
+
+Este es el ciclo interno en el que pasarás la mayor parte del tiempo.
+
+```bash filename="Terminal"
+cd my-twenty-app
+yarn twenty dev
+```
+
+Esto observa `src/`, recompila en cada cambio y sincroniza el resultado con el servidor. Edita un archivo, guarda y, en cuestión de unos segundos, el servidor reflejará el cambio. Verás un panel de estado en vivo en tu terminal.
+
+Para una salida más detallada (registros de compilación, solicitudes de sincronización, trazas de errores), añade `--verbose`.
+
+<div style={{textAlign: 'center'}}>
+ <img src="/images/docs/developers/extends/apps/dev.png" alt="Salida del modo de desarrollo en la terminal" />
+</div>
+
+Abre [http://localhost:2020/settings/applications#developer](http://localhost:2020/settings/applications#developer) en tu navegador. Deberías ver tu app listada en **Your Apps**.
+
+<div style={{textAlign: 'center'}}>
+ <img src="/images/docs/developers/extends/apps/app-in-ui-1.png" alt="Lista de Your Apps que muestra My twenty app" />
+</div>
+
+Haz clic en **My twenty app** para ver su **registro de la aplicación** — un registro a nivel de servidor que describe tu app (nombre, identificador, credenciales de OAuth, origen). Un único registro puede instalarse en varios espacios de trabajo del mismo servidor.
+
+<div style={{textAlign: 'center'}}>
+ <img src="/images/docs/developers/extends/apps/app-in-ui-2.png" alt="Detalles del registro de la aplicación" />
+</div>
+
+Haz clic en **View installed app** para ver la instalación en el espacio de trabajo. La pestaña **About** muestra la versión actual y las opciones de gestión.
+
+<div style={{textAlign: 'center'}}>
+ <img src="/images/docs/developers/extends/apps/app-in-ui-3.png" alt="Aplicación instalada" />
+</div>
+
+**Después de esta fase:** tienes un ciclo de desarrollo en vivo. Edita cualquier archivo en `src/` y aparecerá en la UI.
+
+### Sincronización de una sola vez para CI y scripts
+
+Pasa `--once` para ejecutar una sola compilación + sincronización y salir — mismo pipeline, sin watcher:
+
+```bash filename="Terminal"
+yarn twenty dev --once
+```
+
+| Comando | Comportamiento | Cuándo usarlo |
+| ---------------------------------- | ----------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------- |
+| `yarn twenty dev` | Supervisa tus archivos fuente y vuelve a sincronizar en cada cambio. Se ejecuta hasta que lo detengas. | Desarrollo local interactivo. |
+| `yarn twenty dev --once` | Realiza una sola compilación + sincronización y luego sale con el código `0` si tiene éxito o `1` si falla. | CI, hooks de pre-commit, agentes de IA, flujos de trabajo con scripts. |
+| `yarn twenty dev --once --dry-run` | Genera y muestra los cambios de metadatos **sin aplicarlos**. | Inspeccionar qué cambiaría una sincronización antes de confirmarla. |
+
+Ambos modos necesitan un remoto autenticado. Consulta [Sincronización y recuperación](/l/es/developers/extend/apps/operations/sync-and-recovery#previewing-changes-dry-run) para obtener más información sobre `--dry-run`.
+
+### Opciones del modo de desarrollo
+
+| Opción | Descripción |
+| ------------------------------------- | -------------------------------------------------------------------------------------------------------------- |
+| `--once` | Compila y sincroniza una vez y luego finaliza. |
+| `--dry-run` | Con `--once`, obtén una vista previa de los cambios de metadatos sin aplicarlos. No escribe nada. |
+| `--debounceMs \<ms>` | Establece el tiempo de antirrebote para los cambios de archivo en milisegundos (valor predeterminado: `2000`). |
+| `--verbose` / `--debug` | Muestra registros de compilación detallados, solicitudes de sincronización y seguimientos de errores. |
+
+## Lo que puedes crear
+
+Las apps se componen de **entidades** — cada una definida como un archivo de TypeScript con un único `export default`:
+
+| Entidad | Qué hace |
+| --------------------------- | ------------------------------------------------------------------------------------------------------------------------- |
+| **Objetos y campos** | Modelos de datos personalizados (Post Card, Invoice, etc.). con campos tipados |
+| **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 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 |
+| **Diseños de página** | Páginas de detalle de registros personalizadas con pestañas y widgets |
+
+Referencia completa: [Conceptos](/l/es/developers/extend/apps/getting-started/concepts).
+
+## Próximos pasos
+
+<CardGroup cols={2}>
+ <Card title="Configuración" icon="screwdriver-wrench" href="/l/es/developers/extend/apps/config/overview">
+ Identidad de la aplicación, rol predeterminado, hooks de instalación y recursos públicos.
+ </Card>
+ <Card title="Datos" icon="database" href="/l/es/developers/extend/apps/data/overview">
+ Objetos, campos y relaciones bidireccionales.
+ </Card>
+ <Card title="Lógica" icon="bolt" href="/l/es/developers/extend/apps/logic/overview">
+ Funciones de lógica, habilidades, agentes y conexiones OAuth.
+ </Card>
+ <Card title="Diseño" icon="table-columns" href="/l/es/developers/extend/apps/layout/overview">
+ Vistas, navegación, diseños de página y componentes de frontend.
+ </Card>
+ <Card title="Operaciones" icon="rocket" href="/l/es/developers/extend/apps/operations/overview">
+ CLI, pruebas, remotos, CI y publicación de tu aplicación.
+ </Card>
+</CardGroup>
diff --git a/packages/twenty-docs/l/es/developers/extend/apps/getting-started/scaffolding.mdx b/packages/twenty-docs/l/es/developers/extend/apps/getting-started/scaffolding.mdx
new file mode 100644
index 00000000000..38a5fd57bbb
--- /dev/null
+++ b/packages/twenty-docs/l/es/developers/extend/apps/getting-started/scaffolding.mdx
@@ -0,0 +1,58 @@
+---
+title: Andamiaje
+description: Genera archivos de entidad de forma interactiva con yarn twenty dev:add — objetos, campos, vistas, funciones de lógica y más.
+icon: wand-magic-sparkles
+---
+
+En lugar de crear archivos de entidad a mano, usa el generador interactivo:
+
+```bash filename="Terminal"
+yarn twenty dev:add
+```
+
+Te pide que elijas un tipo de entidad y te guía por los campos requeridos; luego escribe un archivo listo para usar con un `universalIdentifier` estable y la llamada correcta a `defineEntity()`.
+
+También puedes pasar el tipo de entidad directamente para omitir la primera pregunta:
+
+```bash filename="Terminal"
+yarn twenty dev:add object
+yarn twenty dev:add logicFunction
+yarn twenty dev:add frontComponent
+```
+
+## Tipos de entidad disponibles
+
+| Tipo de entidad | Comando | Archivo generado |
+| ------------------------------- | ---------------------------------------- | ------------------------------------------------------- |
+| Objeto | `yarn twenty dev:add object` | `src/objects/\<name>.ts` |
+| Campo | `yarn twenty dev:add field` | `src/fields/\<name>.ts` |
+| Función de lógica | `yarn twenty dev:add logicFunction` | `src/logic-functions/\<name>.ts` |
+| Componente de frontend | `yarn twenty dev:add frontComponent` | `src/front-components/\<name>.tsx` |
+| Rol | `yarn twenty dev:add role` | `src/roles/\<name>.ts` |
+| Habilidad | `yarn twenty dev:add skill` | `src/skills/\<name>.ts` |
+| Agente | `yarn twenty dev:add agent` | `src/agents/\<name>.ts` |
+| Vista | `yarn twenty dev:add view` | `src/views/\<name>.ts` |
+| Elemento del menú de navegación | `yarn twenty dev:add navigationMenuItem` | `src/navigation-menu-items/\<name>.ts` |
+| Diseño de página | `yarn twenty dev:add pageLayout` | `src/page-layouts/\<name>.ts` |
+
+## Qué genera el generador
+
+Cada tipo de entidad tiene su propia plantilla. Por ejemplo, `yarn twenty dev:add object` solicita:
+
+1. **Nombre (singular)** — p. ej., `invoice`
+2. **Nombre (plural)** — p. ej., `invoices`
+3. **Etiqueta (singular)** — se completa automáticamente a partir del nombre (p. ej., `Invoice`)
+4. **Etiqueta (plural)** — se completa automáticamente (p. ej., `Invoices`)
+5. **¿Crear una vista y un elemento de navegación?** — si respondes que sí, el generador también crea una vista correspondiente y un enlace en la barra lateral para el nuevo objeto.
+
+Otros tipos de entidad tienen indicaciones más simples: la mayoría solo piden un nombre.
+
+El tipo de entidad `field` es más detallado: pide el nombre del campo, etiqueta, tipo (de una lista de todos los tipos de campo disponibles como `TEXT`, `NUMBER`, `SELECT`, `RELATION`, etc.) y el `universalIdentifier` del objeto de destino.
+
+## Ruta de salida personalizada
+
+Usa la opción `--path` para colocar el archivo generado en una ubicación personalizada:
+
+```bash filename="Terminal"
+yarn twenty dev:add logicFunction --path src/custom-folder
+```
diff --git a/packages/twenty-docs/l/es/developers/extend/apps/getting-started/troubleshooting.mdx b/packages/twenty-docs/l/es/developers/extend/apps/getting-started/troubleshooting.mdx
new file mode 100644
index 00000000000..0ccbcfd9859
--- /dev/null
+++ b/packages/twenty-docs/l/es/developers/extend/apps/getting-started/troubleshooting.mdx
@@ -0,0 +1,14 @@
+---
+title: Solución de problemas
+description: "Problemas comunes en la primera ejecución: Docker, versión de Node, Yarn, dependencias."
+icon: llave inglesa
+---
+
+* **Errores de Docker** — Asegúrate de que Docker Desktop (o el daemon) esté en ejecución antes de `yarn twenty docker:start`. El mensaje de error mostrará el comando de inicio correcto para tu sistema operativo.
+* **Versión de Node incorrecta** — Se requiere 24+. Compruébalo con `node -v`.
+* **Falta Yarn 4** — Ejecuta `corepack enable`.
+* **Dependencias rotas** — `rm -rf node_modules && yarn install`.
+* **Errores de `twenty-sdk` tras actualizar a la v2.8.0** — Pasó de `dependencies` a `devDependencies` en la v2.8.0. Consulta [Estructura del proyecto → Dependencias](/l/es/developers/extend/apps/getting-started/project-structure#dependencies).
+* **`twenty build` muestra una advertencia sobre `twenty-client-sdk` en `dependencies`** — Twenty lo proporciona en tiempo de ejecución, por lo que debería trasladarse a `devDependencies` junto con `twenty-sdk`. Consulta [Estructura del proyecto → Dependencias](/l/es/developers/extend/apps/getting-started/project-structure#dependencies).
+
+¿Atascado? Pide ayuda en el [Discord de Twenty](https://discord.com/channels/1130383047699738754/1130386664812982322).
diff --git a/packages/twenty-docs/l/es/developers/extend/apps/layout/command-menu-items.mdx b/packages/twenty-docs/l/es/developers/extend/apps/layout/command-menu-items.mdx
new file mode 100644
index 00000000000..c02fd35d6b5
--- /dev/null
+++ b/packages/twenty-docs/l/es/developers/extend/apps/layout/command-menu-items.mdx
@@ -0,0 +1,148 @@
+---
+title: Elementos del menú de comandos
+description: Expón componentes de frontend como acciones rápidas y entradas del menú de comandos (Cmd+K) con defineCommandMenuItem.
+icon: terminal
+---
+
+Un **elemento del menú de comandos** es el puente entre el usuario y un [componente de frontend](/l/es/developers/extend/apps/layout/front-components). Registra el componente en el menú de comandos de Twenty (Cmd+K) y, opcionalmente, como un botón de acción rápida anclado en la esquina superior derecha de la página.
+
+```ts src/command-menu-items/open-dashboard.command-menu-item.ts
+import { defineCommandMenuItem } from 'twenty-sdk/define';
+
+export default defineCommandMenuItem({
+ universalIdentifier: 'a1b2c3d4-e5f6-7890-abcd-ef1234567890',
+ label: 'Open Dashboard',
+ shortLabel: 'Dashboard',
+ icon: 'IconLayoutDashboard',
+ isPinned: true,
+ availabilityType: 'GLOBAL',
+ frontComponentUniversalIdentifier: '74c526eb-cb68-4cf7-b05c-0dd8c288d948',
+});
+```
+
+## Campos de configuración
+
+| Campo | Obligatorio | Descripción |
+| --------------------------------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `universalIdentifier` | Sí | ID único estable para el comando |
+| `label` | Sí | Etiqueta completa mostrada en el menú de comandos (Cmd+K) |
+| `frontComponentUniversalIdentifier` | Sí | El `universalIdentifier` del componente de frontend que abre este comando |
+| `shortLabel` | No | Etiqueta corta mostrada en el botón de acción rápida anclado |
+| `icon` | No | Nombre del ícono mostrado junto a la etiqueta (p. ej., 'IconBolt', 'IconSend') |
+| `isPinned` | No | Cuando es `true`, muestra el comando como un botón de acción rápida en la esquina superior derecha de la página |
+| `availabilityType` | No | Controla dónde aparece el comando: 'GLOBAL' (siempre disponible), 'RECORD_SELECTION' (solo cuando hay registros seleccionados) o 'FALLBACK' (se muestra cuando ningún otro comando coincide) |
+| `availabilityObjectUniversalIdentifier` | No | Restringe el comando a páginas de un tipo de objeto específico (p. ej., solo en registros de Company) |
+| `conditionalAvailabilityExpression` | No | Una expresión booleana que controla dinámicamente la visibilidad (ver abajo) |
+
+## Comandos sin interfaz
+
+Un elemento del menú de comandos emparejado con un [headless front component](/l/es/developers/extend/apps/layout/front-components#headless-vs-non-headless) es la forma idónea de ofrecer una acción de un solo clic: ejecutar código, navegar o confirmar y ejecutar. La página Front Components abarca los [SDK Command components](/l/es/developers/extend/apps/layout/front-components#sdk-command-components) (`Command`, `CommandLink`, `CommandModal`, `CommandOpenSidePanelPage`) que gestionan el patrón de acción y desmontaje.
+
+Un flujo típico:
+
+```tsx src/front-components/run-action.tsx
+import { defineFrontComponent } from 'twenty-sdk/define';
+import { Command } from 'twenty-sdk/command';
+import { CoreApiClient } from 'twenty-sdk/clients';
+
+const RunAction = () => {
+ const execute = async () => {
+ const client = new CoreApiClient();
+ await client.mutation({
+ createTask: {
+ __args: { data: { title: 'Created by my app' } },
+ id: true,
+ },
+ });
+ };
+
+ return <Command execute={execute} />;
+};
+
+export default defineFrontComponent({
+ universalIdentifier: 'e5f6a7b8-c9d0-1234-efab-345678901234',
+ name: 'run-action',
+ description: 'Creates a task from the command menu',
+ component: RunAction,
+ isHeadless: true,
+});
+```
+
+```ts src/command-menu-items/run-action.command-menu-item.ts
+import { defineCommandMenuItem } from 'twenty-sdk/define';
+
+export default defineCommandMenuItem({
+ universalIdentifier: 'f6a7b8c9-d0e1-2345-fabc-456789012345',
+ label: 'Run my action',
+ icon: 'IconPlayerPlay',
+ frontComponentUniversalIdentifier: 'e5f6a7b8-c9d0-1234-efab-345678901234',
+});
+```
+
+## Expresiones de disponibilidad condicional
+
+El campo `conditionalAvailabilityExpression` te permite controlar cuándo es visible un comando en función del contexto de la página actual. Importa variables tipadas y operadores desde `twenty-sdk` para construir expresiones:
+
+```ts src/command-menu-items/bulk-update.command-menu-item.ts
+import {
+ defineCommandMenuItem,
+ objectPermissions,
+ everyEquals,
+} from 'twenty-sdk/define';
+
+export default defineCommandMenuItem({
+ universalIdentifier: '...',
+ label: 'Bulk Update',
+ availabilityType: 'RECORD_SELECTION',
+ frontComponentUniversalIdentifier: '...',
+ conditionalAvailabilityExpression: everyEquals(
+ objectPermissions,
+ 'canUpdateObjectRecords',
+ true,
+ ),
+});
+```
+
+<Note>
+ `RECORD_SELECTION` ya implica una selección no vacía; usa `numberOfSelectedRecords` solo para recuentos específicos (por ejemplo, `>= 2`).
+</Note>
+
+### Variables de contexto
+
+Estas representan el estado actual de la página:
+
+| Variable | Tipo | Descripción |
+| ------------------------------ | --------- | ------------------------------------------------------------------- |
+| `pageType` | `string` | Tipo de página actual (p. ej., 'RecordIndexPage', 'RecordShowPage') |
+| `isInSidePanel` | `boolean` | Si el componente se renderiza en un panel lateral |
+| `numberOfSelectedRecords` | `number` | Número de registros seleccionados actualmente |
+| `isSelectAll` | `boolean` | Si "seleccionar todo" está activo |
+| `selectedRecords` | `array` | Los objetos de registro seleccionados |
+| `favoriteRecordIds` | `array` | IDs de registros marcados como favoritos |
+| `objectPermissions` | `object` | Permisos para el tipo de objeto actual |
+| `targetObjectReadPermissions` | `object` | Permisos de lectura para el objeto de destino |
+| `targetObjectWritePermissions` | `object` | Permisos de escritura para el objeto de destino |
+| `featureFlags` | `object` | Indicadores de características activos |
+| `objectMetadataItem` | `object` | Metadatos del tipo de objeto actual |
+| `hasAnySoftDeleteFilterOnView` | `boolean` | Si la vista actual tiene un filtro de eliminación lógica |
+
+### Operadores
+
+Combina variables en expresiones booleanas:
+
+| Operador | Descripción |
+| ----------------------------------- | --------------------------------------------------------------------- |
+| `isDefined(value)` | `true` si el valor no es null/undefined |
+| `isNonEmptyString(value)` | `true` si el valor es una cadena no vacía |
+| `includes(array, value)` | `true` si el arreglo contiene el valor |
+| `includesEvery(array, prop, value)` | `true` si la propiedad de cada elemento incluye el valor |
+| `every(array, prop)` | `true` si la propiedad es truthy en cada elemento |
+| `everyDefined(array, prop)` | `true` si la propiedad está definida en cada elemento |
+| `everyEquals(array, prop, value)` | `true` si la propiedad es igual al valor en cada elemento |
+| `some(array, prop)` | `true` si la propiedad es truthy en al menos un elemento |
+| `someDefined(array, prop)` | `true` si la propiedad está definida en al menos un elemento |
+| `someEquals(array, prop, value)` | `true` si la propiedad es igual al valor en al menos un elemento |
+| `someNonEmptyString(array, prop)` | `true` si la propiedad es una cadena no vacía en al menos un elemento |
+| `none(array, prop)` | `true` si la propiedad es falsy en cada elemento |
+| `noneDefined(array, prop)` | `true` si la propiedad es undefined en cada elemento |
+| `noneEquals(array, prop, value)` | `true` si la propiedad no es igual al valor en ningún elemento |
diff --git a/packages/twenty-docs/l/es/developers/extend/apps/layout/front-components.mdx b/packages/twenty-docs/l/es/developers/extend/apps/layout/front-components.mdx
new file mode 100644
index 00000000000..c2bebfc8648
--- /dev/null
+++ b/packages/twenty-docs/l/es/developers/extend/apps/layout/front-components.mdx
@@ -0,0 +1,545 @@
+---
+title: Componentes de frontend
+description: Crea componentes de React que se renderizan dentro de la UI de Twenty con aislamiento en entorno sandbox.
+icon: window-maximize
+---
+
+Los componentes de frontend son componentes de React que se renderizan directamente dentro de la UI de Twenty. Se ejecutan en un **Web Worker aislado** usando Remote DOM: tu código está aislado (sandboxed) pero se renderiza de forma nativa en la página, no en un iframe.
+
+## Dónde se pueden usar los componentes de front
+
+Los componentes de front pueden renderizarse en dos ubicaciones dentro de Twenty:
+
+* **Panel lateral** — Los componentes de front no headless se abren en el panel lateral derecho. Este es el comportamiento predeterminado cuando un componente de front se activa desde el menú de comandos.
+* **Widgets (tableros y páginas de registros)** — Los componentes de front pueden incrustarse como widgets dentro de los [diseños de página](/l/es/developers/extend/apps/layout/page-layouts). Al configurar un tablero o el diseño de una página de registro, los usuarios pueden agregar un widget de componente de front.
+
+Un componente de front por sí solo no es accesible desde la interfaz de usuario; necesitas *exponerlo*. Las dos formas de hacerlo son:
+
+* **Emparejarlo con un [elemento del menú de comandos](/l/es/developers/extend/apps/layout/command-menu-items)**: lo registra en el menú de comandos (Cmd+K) y, de forma opcional, como una acción rápida fijada.
+* **Incrustarlo como widget en un [diseño de página](/l/es/developers/extend/apps/layout/page-layouts)**: lo coloca en la página de detalles de un registro o en un tablero.
+
+## Ejemplo básico
+
+La forma más rápida de ver un componente de front en acción es emparejarlo con un [`defineCommandMenuItem`](/l/es/developers/extend/apps/layout/command-menu-items), de modo que aparezca como un botón de acción rápida en la esquina superior derecha de la página:
+
+```tsx src/front-components/hello-world.tsx
+import { defineFrontComponent } from 'twenty-sdk/define';
+
+const HelloWorld = () => {
+ return (
+ <div style={{ padding: '20px', fontFamily: 'sans-serif' }}>
+ <h1>Hello from my app!</h1>
+ <p>This component renders inside Twenty.</p>
+ </div>
+ );
+};
+
+export default defineFrontComponent({
+ universalIdentifier: '74c526eb-cb68-4cf7-b05c-0dd8c288d948',
+ name: 'hello-world',
+ description: 'A simple front component',
+ component: HelloWorld,
+});
+```
+
+```ts src/command-menu-items/hello-world.command-menu-item.ts
+import { defineCommandMenuItem } from 'twenty-sdk/define';
+
+export default defineCommandMenuItem({
+ universalIdentifier: 'd4e5f6a7-b8c9-0123-defa-456789012345',
+ shortLabel: 'Hello',
+ label: 'Hello World',
+ icon: 'IconBolt',
+ isPinned: true,
+ availabilityType: 'GLOBAL',
+ frontComponentUniversalIdentifier: '74c526eb-cb68-4cf7-b05c-0dd8c288d948',
+});
+```
+
+Después de sincronizar con `yarn twenty dev` (o ejecutar una sola vez `yarn twenty dev --once`), la acción rápida aparece en la esquina superior derecha de la página:
+
+<div style={{textAlign: 'center'}}>
+ <img src="/images/docs/developers/extends/apps/quick-action.png" alt="Botón de acción rápida en la esquina superior derecha" />
+</div>
+
+Haz clic para renderizar el componente en línea.
+
+## Campos de configuración
+
+| Campo | Obligatorio | Descripción |
+| --------------------- | ----------- | -------------------------------------------------------------------- |
+| `universalIdentifier` | Sí | ID único estable para este componente |
+| `component` | Sí | Una función de componente de React |
+| `name` | No | Nombre para mostrar |
+| `description` | No | Descripción de lo que hace el componente |
+| `isHeadless` | No | Configura en `true` si el componente no tiene UI visible (ver abajo) |
+
+## Colocar un componente de frontend en una página
+
+Más allá de los comandos, puedes incrustar un componente de frontend directamente en una página de registro agregándolo como un widget en un **diseño de página**. Consulta [Diseños de página](/l/es/developers/extend/apps/layout/page-layouts) para más detalles.
+
+## Headless vs no headless
+
+Los componentes de front vienen en dos modos de renderizado controlados por la opción `isHeadless`:
+
+**No headless (predeterminado)** — El componente renderiza una UI visible. Cuando se activa desde el menú de comandos, se abre en el panel lateral. Este es el comportamiento predeterminado cuando `isHeadless` es `false` o se omite.
+
+**Headless (`isHeadless: true`)** — El componente se monta de forma invisible en segundo plano. No abre el panel lateral. Los componentes headless están diseñados para acciones que ejecutan lógica y luego se desmontan — por ejemplo, ejecutar una tarea asíncrona, navegar a una página o mostrar un modal de confirmación. Se combinan de forma natural con los componentes Command del SDK descritos a continuación.
+
+```tsx src/front-components/sync-tracker.tsx
+import { defineFrontComponent } from 'twenty-sdk/define';
+import { useRecordId, enqueueSnackbar } from 'twenty-sdk/front-component';
+import { useEffect } from 'react';
+
+const SyncTracker = () => {
+ const recordId = useRecordId();
+
+ useEffect(() => {
+ enqueueSnackbar({ message: `Tracking record ${recordId}`, variant: 'info' });
+ }, [recordId]);
+
+ return null;
+};
+
+export default defineFrontComponent({
+ universalIdentifier: '...',
+ name: 'sync-tracker',
+ description: 'Tracks record views silently',
+ isHeadless: true,
+ component: SyncTracker,
+});
+```
+
+Como el componente devuelve `null`, Twenty omite renderizar un contenedor para él — no aparece espacio vacío en el diseño. El componente sigue teniendo acceso a todos los hooks y a la API de comunicación con el host.
+
+## Componentes Command del SDK
+
+El paquete `twenty-sdk` proporciona cuatro componentes auxiliares Command diseñados para componentes de front headless. Cada componente ejecuta una acción al montarse, gestiona los errores mostrando una notificación tipo snackbar y desmonta automáticamente el componente de front al finalizar.
+
+Impórtalos desde `twenty-sdk/command`:
+
+* **`Command`** — Ejecuta un callback asíncrono mediante la prop `execute`.
+* **`CommandLink`** — Navega a una ruta de la aplicación. Props: `to`, `params`, `queryParams`, `options`.
+* **`CommandModal`** — Abre un modal de confirmación. Si el usuario confirma, ejecuta el callback `execute`. Props: `title`, `subtitle`, `execute`, `confirmButtonText`, `confirmButtonAccent`.
+* **`CommandOpenSidePanelPage`** — Abre una página específica del panel lateral. Props: `page`, `pageTitle`, `pageIcon`.
+
+Aquí tienes un ejemplo completo de un componente de front headless que usa `Command` para ejecutar una acción desde el menú de comandos:
+
+```tsx src/front-components/run-action.tsx
+import { defineFrontComponent } from 'twenty-sdk/define';
+import { Command } from 'twenty-sdk/command';
+import { CoreApiClient } from 'twenty-sdk/clients';
+
+const RunAction = () => {
+ const execute = async () => {
+ const client = new CoreApiClient();
+
+ await client.mutation({
+ createTask: {
+ __args: { data: { title: 'Created by my app' } },
+ id: true,
+ },
+ });
+ };
+
+ return <Command execute={execute} />;
+};
+
+export default defineFrontComponent({
+ universalIdentifier: 'e5f6a7b8-c9d0-1234-efab-345678901234',
+ name: 'run-action',
+ description: 'Creates a task from the command menu',
+ component: RunAction,
+ isHeadless: true,
+});
+```
+
+```ts src/command-menu-items/run-action.command-menu-item.ts
+import { defineCommandMenuItem } from 'twenty-sdk/define';
+
+export default defineCommandMenuItem({
+ universalIdentifier: 'f6a7b8c9-d0e1-2345-fabc-456789012345',
+ label: 'Run my action',
+ icon: 'IconPlayerPlay',
+ frontComponentUniversalIdentifier: 'e5f6a7b8-c9d0-1234-efab-345678901234',
+});
+```
+
+Y un ejemplo que usa `CommandModal` para pedir confirmación antes de ejecutar:
+
+```tsx src/front-components/delete-draft.tsx
+import { defineFrontComponent } from 'twenty-sdk/define';
+import { CommandModal } from 'twenty-sdk/command';
+
+const DeleteDraft = () => {
+ const execute = async () => {
+ // perform the deletion
+ };
+
+ return (
+ <CommandModal
+ title="Delete draft?"
+ subtitle="This action cannot be undone."
+ execute={execute}
+ confirmButtonText="Delete"
+ confirmButtonAccent="danger"
+ />
+ );
+};
+
+export default defineFrontComponent({
+ universalIdentifier: 'a7b8c9d0-e1f2-3456-abcd-567890123456',
+ name: 'delete-draft',
+ description: 'Deletes a draft with confirmation',
+ component: DeleteDraft,
+ isHeadless: true,
+});
+```
+
+## Llamar a una función de lógica
+
+Los componentes de front se ejecutan en el navegador dentro de un Web Worker aislado (sandboxed), mientras que las [funciones de lógica](/l/es/developers/extend/apps/logic/logic-functions) se ejecutan en el servidor. No hay una llamada directa en el mismo proceso entre ambos; en su lugar, un componente de front accede a una función de lógica a través de HTTP.
+
+Una función de lógica declarada con `httpRouteTriggerSettings` se expone bajo el endpoint `/s/` en `${TWENTY_API_URL}/s\<path>`. Tu componente de front llama a esa ruta con el `RestApiClient` de `twenty-client-sdk/rest`, que se autentica con el `TWENTY_APP_ACCESS_TOKEN` que Twenty inyecta en el worker.
+
+El `RestApiClient` está diseñado precisamente para esto. Lee `TWENTY_API_URL` y `TWENTY_APP_ACCESS_TOKEN` del entorno del worker, añade la cabecera `Authorization: Bearer`, serializa y analiza JSON, y lanza un `RestApiClientError` cuando faltan el token o la URL o la respuesta no es 2xx, para que no tengas que volver a implementar ese código repetitivo en cada componente.
+
+Un componente de front sin interfaz (headless) puede ejecutar la llamada al montar mediante el componente `Command` y luego desmontarse automáticamente:
+
+```tsx src/front-components/sync-prs.tsx
+import { defineFrontComponent } from 'twenty-sdk/define';
+import { Command } from 'twenty-sdk/command';
+import { RestApiClient } from 'twenty-client-sdk/rest';
+
+const SyncPrs = () => {
+ const execute = async () => {
+ const client = new RestApiClient();
+
+ await client.post('/s/github/fetch-prs', {
+ owner: 'twentyhq',
+ repo: 'twenty',
+ });
+ };
+
+ return <Command execute={execute} />;
+};
+
+export default defineFrontComponent({
+ universalIdentifier: '...',
+ name: 'sync-prs',
+ description: 'Triggers the fetch-prs logic function',
+ isHeadless: true,
+ component: SyncPrs,
+});
+```
+
+La ruta que se pasa al cliente es la ruta pública de la ruta: el `httpRouteTriggerSettings.path` de la función lógica con el prefijo `/s`. Mantén `isAuthRequired: true`; el cliente proporciona el token de acceso de la aplicación que Twenty emite para tu componente:
+
+```ts src/logic-functions/fetch-prs.logic-function.ts
+import { defineLogicFunction } from 'twenty-sdk/define';
+import type { RoutePayload } from 'twenty-sdk/logic-function';
+
+const handler = async (event: RoutePayload) => {
+ const { owner, repo } = (event.body ?? {}) as { owner: string; repo: string };
+ // ...fetch from GitHub and persist records...
+ return { ok: true };
+};
+
+export default defineLogicFunction({
+ universalIdentifier: '...',
+ name: 'fetch-prs',
+ handler,
+ httpRouteTriggerSettings: {
+ path: '/github/fetch-prs',
+ httpMethod: 'POST',
+ isAuthRequired: true,
+ },
+});
+```
+
+<Note>
+`TWENTY_API_URL` y `TWENTY_APP_ACCESS_TOKEN` se inyectan automáticamente; consulta [Variables de la aplicación](#application-variables). Dado que las variables de aplicación secretas nunca se exponen a los componentes de front, mantén las claves de API y otra lógica confidencial en la función de lógica, no en el componente de front.
+</Note>
+
+### Referencia de `RestApiClient`
+
+Importa `RestApiClient` desde `twenty-client-sdk/rest`. Pertenece a la misma familia de clientes que `CoreApiClient` y `MetadataApiClient`, pero se dirige a las rutas HTTP de tu aplicación en lugar de a la API de GraphQL.
+
+| Método | Descripción |
+| --------------------------------- | -------------------------------------------- |
+| `get(path, options?)` | Envía una solicitud `GET` |
+| `post(path, body?, options?)` | Envía una solicitud `POST` |
+| `put(path, body?, options?)` | Envía una solicitud `PUT` |
+| `patch(path, body?, options?)` | Envía una solicitud `PATCH` |
+| `delete(path, options?)` | Envía una solicitud `DELETE` |
+| `request(method, path, options?)` | Solicitud genérica con cualquier método HTTP |
+
+`options` acepta `headers`, `query` (un registro de parámetros de cadena de consulta; los valores nulos o indefinidos se omiten) y un `AbortSignal` mediante `signal`. Un objeto `body` que no sea de tipo `FormData` se serializa automáticamente como JSON. Ante un `401`, el cliente actualiza el token de acceso una vez a través del host y vuelve a intentar la solicitud.
+
+La URL base y el token se resuelven desde el entorno de forma predeterminada. Pasa opciones de sobrescritura al constructor cuando sea necesario — por ejemplo, en pruebas:
+
+```ts
+const client = new RestApiClient({
+ baseUrl: 'https://api.example.com',
+ token: 'my-token',
+});
+```
+
+Las solicitudes fallidas lanzan un `RestApiClientError` que expone `status`, `statusText`, `url` y el `body` analizado:
+
+```tsx
+import { RestApiClient, RestApiClientError } from 'twenty-client-sdk/rest';
+
+const client = new RestApiClient();
+
+try {
+ const prs = await client.get('/s/github/fetch-prs', {
+ query: { state: 'open' },
+ });
+} catch (error) {
+ if (error instanceof RestApiClientError) {
+ console.error(error.status, error.body);
+ }
+}
+```
+
+## Acceder al contexto de ejecución
+
+Dentro de tu componente, usa hooks del SDK para acceder al usuario actual, el registro y la instancia del componente:
+
+```tsx src/front-components/record-info.tsx
+import { defineFrontComponent } from 'twenty-sdk/define';
+import {
+ useUserId,
+ useRecordId,
+ useFrontComponentId,
+} from 'twenty-sdk/front-component';
+
+const RecordInfo = () => {
+ const userId = useUserId();
+ const recordId = useRecordId();
+ const componentId = useFrontComponentId();
+
+ return (
+ <div>
+ <p>User: {userId}</p>
+ <p>Record: {recordId ?? 'No record context'}</p>
+ <p>Component: {componentId}</p>
+ </div>
+ );
+};
+
+export default defineFrontComponent({
+ universalIdentifier: 'b2c3d4e5-f6a7-8901-bcde-f23456789012',
+ name: 'record-info',
+ component: RecordInfo,
+});
+```
+
+Hooks disponibles:
+
+| Hook | Devuelve | Descripción |
+| --------------------------------------------- | -------------------- | ----------------------------------------------------------------------------------------------- |
+| `useUserId()` | `string` o `null` | El ID del usuario actual |
+| `useSelectedRecordIds()` | `string[]` | Todos los ID de los registros seleccionados (array vacío si no hay ninguno seleccionado) |
+| `useRecordId()` | `string` o `null` | **Obsoleto.** Usa `useSelectedRecordIds()` en su lugar |
+| `useFrontComponentId()` | `string` | El ID de esta instancia del componente |
+| `useColorScheme()` | `'light'` o `'dark'` | La combinación de colores activa de la interfaz de usuario del host (`System` ya está resuelto) |
+| `useFrontComponentExecutionContext(selector)` | varía | Accede al contexto de ejecución completo con una función selectora |
+
+## Variables de aplicación
+
+Las variables de aplicación definidas en [`defineApplication()`](/l/es/developers/extend/apps/config/application) con `isSecret: false` están disponibles dentro de los componentes de front mediante la utilidad `getApplicationVariable`:
+
+```tsx src/front-components/greeting.tsx
+import { defineFrontComponent } from 'twenty-sdk/define';
+import { getApplicationVariable } from 'twenty-sdk/front-component';
+
+const Greeting = () => {
+ const recipientName = getApplicationVariable('DEFAULT_RECIPIENT_NAME') ?? 'World';
+
+ return <p>Hello, {recipientName}!</p>;
+};
+
+export default defineFrontComponent({
+ universalIdentifier: '...',
+ name: 'greeting',
+ component: Greeting,
+});
+```
+
+<Warning>
+Las variables secretas (`isSecret: true`) **no** se exponen a los componentes de front. Solo están disponibles en las [funciones de lógica](/l/es/developers/extend/apps/logic/logic-functions), que se ejecutan del lado del servidor. Esto evita que valores confidenciales como las claves de API se envíen al navegador.
+</Warning>
+
+Las siguientes variables de sistema siempre están disponibles a través de `process.env`:
+
+| Variable | Descripción |
+| ------------------------- | -------------------------------------------------------- |
+| `TWENTY_API_URL` | URL base de la API de Twenty |
+| `TWENTY_APP_ACCESS_TOKEN` | Token de corta duración limitado al rol de tu aplicación |
+
+## API de comunicación con el host
+
+Los componentes de frontend pueden activar navegación, modales y notificaciones usando funciones de `twenty-sdk`:
+
+| Función | Descripción |
+| ----------------------------------------------- | -------------------------------------------- |
+| `navigate(to, params?, queryParams?, options?)` | Navegar a una página en la aplicación |
+| `openSidePanelPage(params)` | Abrir un panel lateral |
+| `closeSidePanel()` | Cerrar el panel lateral |
+| `openCommandConfirmationModal(params)` | Mostrar un cuadro de diálogo de confirmación |
+| `enqueueSnackbar(params)` | Mostrar una notificación tipo toast |
+| `unmountFrontComponent()` | Desmontar el componente |
+| `updateProgress(progress)` | Actualizar un indicador de progreso |
+
+Aquí tienes un ejemplo que usa la API del host para mostrar un snackbar y cerrar el panel lateral después de que una acción finaliza:
+
+```tsx src/front-components/archive-record.tsx
+import { defineFrontComponent } from 'twenty-sdk/define';
+import { useRecordId } from 'twenty-sdk/front-component';
+import { enqueueSnackbar, closeSidePanel } from 'twenty-sdk/front-component';
+import { CoreApiClient } from 'twenty-sdk/clients';
+
+const ArchiveRecord = () => {
+ const recordId = useRecordId();
+
+ const handleArchive = async () => {
+ const client = new CoreApiClient();
+
+ await client.mutation({
+ updateTask: {
+ __args: { id: recordId, data: { status: 'ARCHIVED' } },
+ id: true,
+ },
+ });
+
+ await enqueueSnackbar({
+ message: 'Record archived',
+ variant: 'success',
+ });
+
+ await closeSidePanel();
+ };
+
+ return (
+ <div style={{ padding: '20px' }}>
+ <p>Archive this record?</p>
+ <button onClick={handleArchive}>Archive</button>
+ </div>
+ );
+};
+
+export default defineFrontComponent({
+ universalIdentifier: 'c9d0e1f2-a3b4-5678-cdef-789012345678',
+ name: 'archive-record',
+ description: 'Archives the current record',
+ component: ArchiveRecord,
+});
+```
+
+### Trabajar con varios registros
+
+Usa `useSelectedRecordIds()` para manejar varios registros seleccionados. Esto es útil para operaciones por lotes:
+
+```tsx src/front-components/bulk-export.tsx
+import { defineFrontComponent, numberOfSelectedRecords } from 'twenty-sdk/define';
+import { useSelectedRecordIds } from 'twenty-sdk/front-component';
+import { enqueueSnackbar, closeSidePanel } from 'twenty-sdk/front-component';
+import { CoreApiClient } from 'twenty-sdk/clients';
+
+const BulkExport = () => {
+ const selectedRecordIds = useSelectedRecordIds();
+
+ const handleExport = async () => {
+ const client = new CoreApiClient();
+
+ for (const recordId of selectedRecordIds) {
+ await client.mutation({
+ updateTask: {
+ __args: { id: recordId, data: { exported: true } },
+ id: true,
+ },
+ });
+ }
+
+ await enqueueSnackbar({
+ message: `Exported ${selectedRecordIds.length} records`,
+ variant: 'success',
+ });
+
+ await closeSidePanel();
+ };
+
+ return (
+ <div style={{ padding: '20px' }}>
+ <p>Export {selectedRecordIds.length} selected record(s)?</p>
+ <button onClick={handleExport}>Export</button>
+ </div>
+ );
+};
+
+export default defineFrontComponent({
+ universalIdentifier: 'd0e1f2a3-b4c5-6789-defa-012345678901',
+ name: 'bulk-export',
+ description: 'Export selected records',
+ component: BulkExport,
+ command: {
+ universalIdentifier: 'd0e1f2a3-b4c5-6789-defa-012345678902',
+ label: 'Bulk Export',
+ availabilityType: 'RECORD_SELECTION',
+ conditionalAvailabilityExpression: numberOfSelectedRecords > 0,
+ },
+});
+```
+
+## Recursos públicos
+
+Los componentes de frontend pueden acceder a archivos del directorio `public/` de la aplicación usando `getPublicAssetUrl`:
+
+```tsx
+import { defineFrontComponent } from 'twenty-sdk/define';
+import { getPublicAssetUrl } from 'twenty-sdk/utils';
+
+const Logo = () => <img src={getPublicAssetUrl('logo.png')} alt="Logo" />;
+
+export default defineFrontComponent({
+ universalIdentifier: '...',
+ name: 'logo',
+ component: Logo,
+});
+```
+
+Consulta la [sección de recursos públicos](/l/es/developers/extend/apps/config/public-assets) para más detalles.
+
+## Estilo
+
+Los componentes de frontend admiten varios enfoques de estilos. Puedes usar:
+
+* **Estilos en línea** — `style={{ color: 'red' }}`
+* **Componentes de Twenty UI** — importa desde `twenty-sdk/ui` (Button, Tag, Status, Chip, Avatar y más)
+* **Emotion** — CSS-in-JS con `@emotion/react`
+* **Styled-components** — patrones de `styled.div`
+* **Tailwind CSS** — clases utilitarias
+* **Cualquier librería CSS-in-JS** compatible con React
+
+```tsx
+import { defineFrontComponent } from 'twenty-sdk/define';
+import { Button, Tag, Status } from 'twenty-sdk/ui';
+
+const StyledWidget = () => {
+ return (
+ <div style={{ padding: '16px', display: 'flex', gap: '8px' }}>
+ <Button title="Click me" onClick={() => alert('Clicked!')} />
+ <Tag text="Active" color="green" />
+ <Status color="green" text="Online" />
+ </div>
+ );
+};
+
+export default defineFrontComponent({
+ universalIdentifier: 'e5f6a7b8-c9d0-1234-efab-567890123456',
+ name: 'styled-widget',
+ component: StyledWidget,
+});
+```
diff --git a/packages/twenty-docs/l/es/developers/extend/apps/layout/navigation-menu-items.mdx b/packages/twenty-docs/l/es/developers/extend/apps/layout/navigation-menu-items.mdx
new file mode 100644
index 00000000000..bd0f1b223e4
--- /dev/null
+++ b/packages/twenty-docs/l/es/developers/extend/apps/layout/navigation-menu-items.mdx
@@ -0,0 +1,44 @@
+---
+title: Elementos del menú de navegación
+description: Agrega entradas personalizadas a la barra lateral del espacio de trabajo — enlaces a vistas guardadas o URLs externas.
+icon: bars
+---
+
+Un **elemento del menú de navegación** es una entrada en la barra lateral izquierda. Usa `defineNavigationMenuItem()` para distribuir enlaces personalizados en la barra lateral — normalmente uno por cada [vista](/l/es/developers/extend/apps/layout/views) que publiques — o para apuntar a URL externas.
+
+```ts src/navigation-menu-items/example-navigation-menu-item.ts
+import { defineNavigationMenuItem, NavigationMenuItemType } from 'twenty-sdk/define';
+import { EXAMPLE_VIEW_UNIVERSAL_IDENTIFIER } from '../views/example-view';
+
+export default defineNavigationMenuItem({
+ universalIdentifier: '9327db91-afa1-41b6-bd9d-2b51a26efb4c',
+ name: 'example-navigation-menu-item',
+ icon: 'IconList',
+ color: 'blue',
+ position: 0,
+ type: NavigationMenuItemType.VIEW,
+ viewUniversalIdentifier: EXAMPLE_VIEW_UNIVERSAL_IDENTIFIER,
+});
+```
+
+## Puntos clave
+
+* `type` determina a qué enlaza el elemento del menú. Cada tipo se asocia con un campo identificador específico:
+
+ | Tipo | Qué hace | Campo obligatorio |
+ | ------------------------------------ | ---------------------------------------------------- | ------------------------------------------------------------------------------------------------------- |
+ | `NavigationMenuItemType.VIEW` | Abre una vista guardada | `viewUniversalIdentifier` |
+ | `NavigationMenuItemType.LINK` | Abre una URL externa | `link` |
+ | `NavigationMenuItemType.FOLDER` | Agrupa elementos anidados bajo una etiqueta | `name` (y los elementos secundarios hacen referencia a la carpeta mediante `folderUniversalIdentifier`) |
+ | `NavigationMenuItemType.OBJECT` | Abre la página de índice predeterminada de un objeto | `targetObjectUniversalIdentifier` |
+ | `NavigationMenuItemType.PAGE_LAYOUT` | Abre un diseño de página independiente | `pageLayoutUniversalIdentifier` |
+
+* `position` controla el orden en la barra lateral.
+
+* `icon` y `color` son opcionales y personalizan el aspecto de la entrada.
+
+* `folderUniversalIdentifier` también está disponible en cualquier elemento para anidarlo dentro de un elemento padre de tipo `FOLDER`.
+
+<Note>
+**Error común:** crear un objeto sin una vista asociada y un elemento del menú de navegación hace que ese objeto sea invisible para los usuarios. A menos que sea un objeto técnico/interno, cada objeto personalizado debería tener una vista predeterminada *y* una entrada en la barra lateral que apunte a ella.
+</Note>
diff --git a/packages/twenty-docs/l/es/developers/extend/apps/layout/overview.mdx b/packages/twenty-docs/l/es/developers/extend/apps/layout/overview.mdx
new file mode 100644
index 00000000000..1297743710e
--- /dev/null
+++ b/packages/twenty-docs/l/es/developers/extend/apps/layout/overview.mdx
@@ -0,0 +1,56 @@
+---
+title: Resumen
+description: Coloca tu aplicación dentro de la interfaz de usuario de Twenty — entradas de la barra lateral, vistas guardadas, pestañas de la página de registro y componentes React aislados.
+icon: table-columns
+---
+
+La **capa de diseño** de una aplicación de Twenty es todo lo que el usuario ve: dónde aparece la aplicación en la barra lateral, qué vistas de lista incluye, cómo se organizan sus páginas de detalles de registro y qué componentes React personalizados se renderizan dentro de esas páginas.
+
+```text
+ Sidebar Record list Record detail page
+ ─────── ─────────── ──────────────────
+ [📋 My View] ────▶ ┌──────────┐ ┌─────────────────────┐
+ [📋 Drafts ] │ Companies│ │ Tabs: [Overview ] │
+ [📋 Inbox ] │ ──────── │ │ [Notes ] │
+ ▲ │ Apple │ │ [Hello ]◀──── definePageLayoutTab
+ │ │ Acme │ │ │ adds a tab...
+ └ defineNavi- │ … │ │ ┌────────────────┐ │
+ gationMenu- └────▲─────┘ │ │ │ │
+ Item points │ │ │ React UI │◀── …with a
+ to a defineView │ │ │ (sandboxed in │ │ defineFrontComponent
+ └ defineView │ │ a Worker) │ │ widget inside
+ picks columns │ └────────────────┘ │
+ and filters └─────────────────────┘
+```
+
+## En esta sección
+
+<CardGroup cols={2}>
+ <Card title="Vistas" icon="list" href="/l/es/developers/extend/apps/layout/views">
+ `defineView` — configuraciones de listas guardadas: columnas visibles, filtros, grupos.
+ </Card>
+ <Card title="Elementos del menú de navegación" icon="bars" href="/l/es/developers/extend/apps/layout/navigation-menu-items">
+ `defineNavigationMenuItem` — entradas de la barra lateral que apuntan a vistas o URL externas.
+ </Card>
+ <Card title="Diseños de Página" icon="table-columns" href="/l/es/developers/extend/apps/layout/page-layouts">
+ `definePageLayout` y `definePageLayoutTab` — pestañas y widgets en la página de detalles de un registro.
+ </Card>
+ <Card title="Componentes de frontend" icon="window-maximize" href="/l/es/developers/extend/apps/layout/front-components">
+ `defineFrontComponent` — componentes React aislados que se renderizan dentro de Twenty.
+ </Card>
+ <Card title="Elementos del menú de comandos" icon="terminal" href="/l/es/developers/extend/apps/layout/command-menu-items">
+ `defineCommandMenuItem` — registra componentes de frontend como entradas Cmd+K y acciones rápidas.
+ </Card>
+</CardGroup>
+
+## Dónde aparece la aplicación
+
+| Ubicación | Qué controla | Entidad |
+| ------------------------------------------ | ---------------------------------------------------------------------------------------- | ----------------------------------------- |
+| **Barra lateral** | Una entrada personalizada que enlaza a una vista guardada o a una URL externa | `defineNavigationMenuItem` |
+| **Lista de registros** | Una configuración guardada para un objeto — columnas visibles, orden, filtros, grupos | `defineView` |
+| **Página de detalles del registro** | Las pestañas y widgets en una página de registro (de tu propio objeto o de uno estándar) | `definePageLayout`, `definePageLayoutTab` |
+| **Dentro de cualquiera de las anteriores** | Un widget React personalizado — botones, formularios, paneles, integraciones | `defineFrontComponent` |
+| **Menú de comandos (Cmd+K)** | Una acción rápida fijada o un comando oculto | `defineCommandMenuItem` |
+
+Los componentes de frontend se ejecutan dentro de un Web Worker aislado usando Remote DOM — se renderizan de forma nativa en la página (no dentro de un iframe), pero no pueden acceder directamente a la página o al DOM del host. La comunicación con Twenty ocurre a través de una API de host de paso de mensajes.
diff --git a/packages/twenty-docs/l/es/developers/extend/apps/layout/page-layouts.mdx b/packages/twenty-docs/l/es/developers/extend/apps/layout/page-layouts.mdx
new file mode 100644
index 00000000000..2bb753837fc
--- /dev/null
+++ b/packages/twenty-docs/l/es/developers/extend/apps/layout/page-layouts.mdx
@@ -0,0 +1,132 @@
+---
+title: Diseños de Página
+description: Personaliza las páginas de detalle de los registros — pestañas, widgets y dónde se renderizan los componentes de frontend — usando `definePageLayout` y `definePageLayoutTab`.
+icon: table-columns
+---
+
+Un **page layout** controla cómo se organiza la página de detalle de un registro: qué pestañas aparecen y qué widgets contienen. Usa `definePageLayout()` para declarar un layout para un objeto que posees, o `definePageLayoutTab()` para agregar una sola pestaña a un layout que ya existe (tuyo o uno estándar de Twenty).
+
+| Caso de uso | Entidad |
+| -------------------------------------------------------------------------- | --------------------- |
+| Define todo el layout para una página de registro en un objeto que posees | `definePageLayout` |
+| Agrega una pestaña a un layout existente (tu propio objeto o uno estándar) | `definePageLayoutTab` |
+
+## definePageLayout
+
+Usa esto cuando eres propietario de toda la página de detalle; normalmente para un objeto personalizado que definiste tú mismo.
+
+```ts src/page-layouts/example-record-page-layout.ts
+import { definePageLayout, PageLayoutTabLayoutMode } from 'twenty-sdk/define';
+import { EXAMPLE_OBJECT_UNIVERSAL_IDENTIFIER } from '../objects/example-object';
+import { HELLO_WORLD_FRONT_COMPONENT_UNIVERSAL_IDENTIFIER } from '../front-components/hello-world';
+
+export default definePageLayout({
+ universalIdentifier: '203aeb94-6701-46d6-9af1-be2bbcc9e134',
+ name: 'Example Record Page',
+ type: 'RECORD_PAGE',
+ objectUniversalIdentifier: EXAMPLE_OBJECT_UNIVERSAL_IDENTIFIER,
+ tabs: [
+ {
+ universalIdentifier: '6ed26b60-a51d-4ad7-86dd-1c04c7f3cac5',
+ title: 'Hello World',
+ position: 50,
+ icon: 'IconWorld',
+ layoutMode: PageLayoutTabLayoutMode.CANVAS,
+ widgets: [
+ {
+ universalIdentifier: 'aa4234e0-2e5f-4c02-a96a-573449e2351d',
+ title: 'Hello World',
+ type: 'FRONT_COMPONENT',
+ configuration: {
+ configurationType: 'FRONT_COMPONENT',
+ frontComponentUniversalIdentifier:
+ HELLO_WORLD_FRONT_COMPONENT_UNIVERSAL_IDENTIFIER,
+ },
+ },
+ ],
+ },
+ ],
+});
+```
+
+### Puntos clave
+
+* `type` suele ser `'RECORD_PAGE'` para personalizar la vista de detalles de un objeto específico.
+* `objectUniversalIdentifier` especifica a qué objeto se aplica este diseño.
+* Cada `tab` define una sección de la página con un `title`, `position` y `layoutMode` (`CANVAS` para un diseño libre).
+* Cada `widget` dentro de una pestaña puede renderizar un [componente de frontend](/l/es/developers/extend/apps/layout/front-components), una lista de relaciones u otros tipos de widget integrados.
+* `position` en las pestañas controla su orden. Usa valores más altos (p. ej., 50) para colocar pestañas personalizadas después de las integradas.
+
+## definePageLayoutTab
+
+Usa esto cuando solo quieras **agregar** una pestaña a un layout existente; por ejemplo, una pestaña de analíticas en la página estándar de Company o una pestaña de resumen de IA añadida al layout de tu propio objeto.
+
+```ts src/page-layouts/example-extra-tab.ts
+import {
+ definePageLayoutTab,
+ PageLayoutTabLayoutMode,
+ STANDARD_PAGE_LAYOUT_UNIVERSAL_IDENTIFIERS,
+} from 'twenty-sdk/define';
+import { HELLO_WORLD_FRONT_COMPONENT_UNIVERSAL_IDENTIFIER } from '../front-components/hello-world';
+
+export default definePageLayoutTab({
+ universalIdentifier: 'b1b2b3b4-b5b6-4000-8000-000000000001',
+ pageLayoutUniversalIdentifier:
+ STANDARD_PAGE_LAYOUT_UNIVERSAL_IDENTIFIERS.companyRecordPage
+ .universalIdentifier,
+ title: 'Hello World',
+ position: 1000,
+ icon: 'IconWorld',
+ layoutMode: PageLayoutTabLayoutMode.CANVAS,
+ widgets: [
+ {
+ universalIdentifier: 'b1b2b3b4-b5b6-4000-8000-000000000002',
+ title: 'Hello World',
+ type: 'FRONT_COMPONENT',
+ configuration: {
+ configurationType: 'FRONT_COMPONENT',
+ frontComponentUniversalIdentifier:
+ HELLO_WORLD_FRONT_COMPONENT_UNIVERSAL_IDENTIFIER,
+ },
+ },
+ ],
+});
+```
+
+### Puntos clave
+
+* `pageLayoutUniversalIdentifier` es **obligatorio** y debe apuntar a un page layout que ya exista en el momento de la instalación, ya sea un layout estándar de Twenty o uno definido por tu propia app. Las referencias entre apps a layouts que pertenecen a otra app instalada no son compatibles hoy en día. Cuando falta el layout padre, la instalación falla con un error de validación claro.
+
+* Para los diseños estándar de Twenty, importa los identificadores desde `twenty-sdk/define`:
+
+ ```ts
+ import { STANDARD_PAGE_LAYOUT_UNIVERSAL_IDENTIFIERS } from 'twenty-sdk/define';
+
+ // STANDARD_PAGE_LAYOUT_UNIVERSAL_IDENTIFIERS.companyRecordPage.universalIdentifier
+ // STANDARD_PAGE_LAYOUT_UNIVERSAL_IDENTIFIERS.personRecordPage.universalIdentifier
+ // STANDARD_PAGE_LAYOUT_UNIVERSAL_IDENTIFIERS.taskRecordPage.universalIdentifier
+ // STANDARD_PAGE_LAYOUT_UNIVERSAL_IDENTIFIERS.opportunityRecordPage.universalIdentifier
+ // STANDARD_PAGE_LAYOUT_UNIVERSAL_IDENTIFIERS.noteRecordPage.universalIdentifier
+ // …
+ ```
+
+ Cada entrada de diseño también expone sus `tabs` y sus `widgets`, para que puedas hacer referencia a cualquier nivel:
+
+ ```ts
+ STANDARD_PAGE_LAYOUT_UNIVERSAL_IDENTIFIERS.taskRecordPage.tabs.home.universalIdentifier
+ STANDARD_PAGE_LAYOUT_UNIVERSAL_IDENTIFIERS.taskRecordPage.tabs.home.widgets.fields.universalIdentifier
+ ```
+
+ También hay disponible un alias corto `STANDARD_PAGE_LAYOUT`:
+
+ ```ts
+ import { STANDARD_PAGE_LAYOUT } from 'twenty-sdk/define';
+
+ STANDARD_PAGE_LAYOUT.companyRecordPage.universalIdentifier;
+ ```
+
+* `widgets` están limitados solo a esta pestaña: hacen referencia a [componentes de frontend](/l/es/developers/extend/apps/layout/front-components), vistas, etc., exactamente igual que los widgets definidos en línea en `definePageLayout`.
+
+* `position` controla el orden con respecto a las pestañas existentes en el diseño de página de destino. Elige un valor que sitúe tu pestaña donde la quieras, en relación con las pestañas integradas.
+
+* Usa esto en lugar de `definePageLayout` cuando solo quieras agregar a un layout existente. Usa `definePageLayout` cuando eres propietario de todo el layout.
diff --git a/packages/twenty-docs/l/es/developers/extend/apps/layout/views.mdx b/packages/twenty-docs/l/es/developers/extend/apps/layout/views.mdx
new file mode 100644
index 00000000000..3c791bcf2e0
--- /dev/null
+++ b/packages/twenty-docs/l/es/developers/extend/apps/layout/views.mdx
@@ -0,0 +1,97 @@
+---
+title: Vistas
+description: Incluye vistas guardadas preconfiguradas — orden de columnas, filtros y grupos — para los objetos de tu aplicación.
+icon: lista
+---
+
+Una **vista** es una configuración guardada de cómo se muestran los registros de un objeto: qué campos aparecen, su orden, si son visibles y qué filtros o grupos se aplican. Usa `defineView()` para incluir vistas preconfiguradas con tu aplicación — normalmente una vista de índice predeterminada para cada objeto personalizado que crees.
+
+```ts src/views/example-view.ts
+import { defineView, ViewKey } from 'twenty-sdk/define';
+import { EXAMPLE_OBJECT_UNIVERSAL_IDENTIFIER } from '../objects/example-object';
+import { NAME_FIELD_UNIVERSAL_IDENTIFIER } from '../objects/example-object';
+
+export default defineView({
+ universalIdentifier: 'a1b2c3d4-e5f6-7890-abcd-ef1234567890',
+ name: 'All example items',
+ objectUniversalIdentifier: EXAMPLE_OBJECT_UNIVERSAL_IDENTIFIER,
+ icon: 'IconList',
+ key: ViewKey.INDEX,
+ position: 0,
+ fields: [
+ {
+ universalIdentifier: 'f926bdb7-6af7-4683-9a09-adbca56c29f0',
+ fieldMetadataUniversalIdentifier: NAME_FIELD_UNIVERSAL_IDENTIFIER,
+ position: 0,
+ isVisible: true,
+ size: 200,
+ },
+ ],
+});
+```
+
+## Puntos clave
+
+* `objectUniversalIdentifier` especifica a qué objeto se aplica esta vista. Puede ser un objeto personalizado que hayas definido o un objeto estándar de Twenty.
+* `key` determina el tipo de vista — `ViewKey.INDEX` es la vista de lista principal para el objeto.
+* `fields` controla qué columnas aparecen y en qué orden. Cada campo referencia un `fieldMetadataUniversalIdentifier`.
+* También puedes definir `filters`, `filterGroups`, `groups` y `fieldGroups` para configuraciones avanzadas.
+* `position` controla el orden cuando existen múltiples vistas para el mismo objeto.
+
+## Filtros
+
+Una vista puede incluir filtros preaplicados. Cada filtro tiene tres coordenadas: el **campo** que se está filtrando, el **operando** (cómo comparar) y el **valor** (contra qué comparar). Las tres deben alinearse: usar un operando que no aplique a un tipo de campo será rechazado en el momento de la sincronización.
+
+```ts
+import { ViewFilterOperand } from 'twenty-shared/types';
+
+filters: [
+ {
+ universalIdentifier: '...',
+ fieldMetadataUniversalIdentifier: STATUS_FIELD_UNIVERSAL_IDENTIFIER,
+ operand: ViewFilterOperand.IS,
+ value: ['ACTIVE'],
+ },
+],
+```
+
+### Operandos admitidos por tipo de campo
+
+| Tipo de campo | Operandos admitidos |
+| -------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------ |
+| `TEXT`, `EMAILS`, `FULL_NAME`, `ADDRESS`, `LINKS`, `PHONES`, `RAW_JSON`, `FILES`, `ACTOR`, `ARRAY` | `CONTAINS`, `DOES_NOT_CONTAIN`, `IS_EMPTY`, `IS_NOT_EMPTY` |
+| `ACTOR.source`, `ACTOR.workspaceMemberId` | `IS`, `IS_NOT`, `IS_EMPTY`, `IS_NOT_EMPTY` |
+| `SELECT` | `IS`, `IS_NOT`, `IS_EMPTY`, `IS_NOT_EMPTY` |
+| `MULTI_SELECT` | `CONTAINS`, `DOES_NOT_CONTAIN`, `IS_EMPTY`, `IS_NOT_EMPTY` |
+| `RELATION` | `IS`, `IS_NOT`, `IS_EMPTY`, `IS_NOT_EMPTY` |
+| `NUMBER` | `IS`, `IS_NOT`, `GREATER_THAN_OR_EQUAL`, `LESS_THAN_OR_EQUAL`, `IS_EMPTY`, `IS_NOT_EMPTY` |
+| `RATING` | `IS`, `GREATER_THAN_OR_EQUAL`, `LESS_THAN_OR_EQUAL`, `IS_EMPTY`, `IS_NOT_EMPTY` |
+| `CURRENCY`, `CURRENCY.amountMicros` | `GREATER_THAN_OR_EQUAL`, `LESS_THAN_OR_EQUAL`, `IS`, `IS_NOT`, `IS_EMPTY`, `IS_NOT_EMPTY` |
+| `CURRENCY.currencyCode` | `IS`, `IS_NOT`, `IS_EMPTY`, `IS_NOT_EMPTY` |
+| `DATE`, `DATE_TIME` | `IS`, `IS_RELATIVE`, `IS_IN_PAST`, `IS_IN_FUTURE`, `IS_TODAY`, `IS_BEFORE`, `IS_AFTER`, `IS_EMPTY`, `IS_NOT_EMPTY` |
+| `BOOLEAN` | `IS` |
+| `UUID` | `IS`, `IS_NOT`, `IS_EMPTY`, `IS_NOT_EMPTY` |
+| `TS_VECTOR` | `VECTOR_SEARCH` |
+
+> Los tipos de campo con nombres similares pueden usar operandos completamente diferentes; `SELECT` y `MULTI_SELECT` son un caso común.
+
+### Forma del valor por operando
+
+El campo `value` siempre es un valor serializable en JSON, pero su forma esperada depende del operando:
+
+| Familia de operandos | Forma del valor | Ejemplo |
+| ------------------------------------------------------ | ------------------------------------- | ------------------------ |
+| `IS`, `IS_NOT` en `SELECT` | array de claves de opciones (cadenas) | `['ACTIVE', 'PENDING']` |
+| `CONTAINS`, `DOES_NOT_CONTAIN` en `MULTI_SELECT` | array de claves de opciones (cadenas) | `['TAG_A']` |
+| `IS`, `IS_NOT` en `RELATION` | array de IDs de registros (uuids) | `['c5a1...']` |
+| `CONTAINS`, `DOES_NOT_CONTAIN` en campos de tipo texto | cadena | `'acme'` |
+| `IS`, `IS_NOT` en `NUMBER` | cadena (el valor) | `'5'` |
+| `IS` en `RATING` / `UUID` | cadena (el valor) | `'5'` |
+| `GREATER_THAN_OR_EQUAL`, `LESS_THAN_OR_EQUAL` | cadena (el límite) | `'10'` |
+| `IS`, `IS_BEFORE`, `IS_AFTER` en `DATE` / `DATE_TIME` | cadena ISO 8601 | `'2025-01-01T00:00:00Z'` |
+| `IS_EMPTY`, `IS_NOT_EMPTY` | cadena vacía | `''` |
+| `IS` en `BOOLEAN` | `'true'` o `'false'` | `'true'` |
+
+## Cómo aparecen las vistas en la interfaz de usuario
+
+Una vista por sí sola no es accesible desde la barra lateral. Para que aparezca allí, vincúlala con un [elemento del menú de navegación](/l/es/developers/extend/apps/layout/navigation-menu-items) de tipo `VIEW` que apunte al `universalIdentifier` de la vista. Ese es el patrón canónico: cada objeto personalizado suele incluir una vista predeterminada + una entrada en la barra lateral que la abre.
diff --git a/packages/twenty-docs/l/es/developers/extend/apps/logic/connections.mdx b/packages/twenty-docs/l/es/developers/extend/apps/logic/connections.mdx
new file mode 100644
index 00000000000..2e7e02da7f8
--- /dev/null
+++ b/packages/twenty-docs/l/es/developers/extend/apps/logic/connections.mdx
@@ -0,0 +1,192 @@
+---
+title: Conexiones
+description: Permite que tu aplicación actúe en nombre de un usuario en servicios de terceros mediante OAuth.
+icon: plug
+---
+
+Las conexiones son credenciales que un usuario posee para un servicio externo (Linear, GitHub, Slack, ...). Tu aplicación declara **cómo** se obtienen esas credenciales — un **proveedor de conexión** — y las consume en tiempo de ejecución para realizar llamadas autenticadas a la API de terceros.
+
+Actualmente solo se admite OAuth 2.0. Los futuros tipos de credenciales (tokens de acceso personal, claves de API, autenticación básica) se integrarán en la misma interfaz — las aplicaciones que ya usan `defineConnectionProvider({ type: 'oauth', ... })` no necesitarán migrar.
+
+<AccordionGroup>
+
+<Accordion title="defineConnectionProvider" description="Declara cómo se obtienen las conexiones de tu aplicación">
+
+Un proveedor de conexión describe el flujo de OAuth que tu aplicación necesita. El usuario hace clic en "Agregar conexión" en la configuración de tu aplicación, completa la pantalla de consentimiento del proveedor y se crea una fila `ConnectedAccount` en su espacio de trabajo.
+
+Una configuración funcional necesita **dos archivos** — el proveedor de conexión y una declaración `serverVariables` correspondiente en `defineApplication` que contiene las credenciales del cliente OAuth.
+
+```ts src/connection-providers/linear-connection.ts
+import { defineConnectionProvider } from 'twenty-sdk/define';
+
+export default defineConnectionProvider({
+ universalIdentifier: '9c7d1f5e-6a0b-4d44-be0c-3f8b5a9d4e6f',
+ name: 'linear',
+ displayName: 'Linear',
+ icon: 'IconBrandLinear',
+ type: 'oauth',
+ oauth: {
+ authorizationEndpoint: 'https://linear.app/oauth/authorize',
+ tokenEndpoint: 'https://api.linear.app/oauth/token',
+ scopes: ['read', 'write'],
+ // These must match keys in `defineApplication.serverVariables` below.
+ clientIdVariable: 'LINEAR_CLIENT_ID',
+ clientSecretVariable: 'LINEAR_CLIENT_SECRET',
+ // Optional: defaults to 'json'. Some providers (Linear, Slack) want
+ // 'form-urlencoded' for the token request.
+ tokenRequestContentType: 'form-urlencoded',
+ // Optional: defaults to true. Disable only if the provider rejects PKCE.
+ usePkce: false,
+ // Optional: extra query params on the authorize URL.
+ // authorizationParams: { prompt: 'consent' },
+ // Optional: provider's RFC 7009 token revocation endpoint, called on disconnect.
+ // revokeEndpoint: 'https://example.com/oauth/revoke',
+ },
+});
+```
+
+```ts src/application.config.ts
+import { defineApplication } from 'twenty-sdk/define';
+
+export default defineApplication({
+ universalIdentifier: '...',
+ displayName: 'Linear',
+ description: 'Connect Linear to Twenty.',
+ // OAuth client credentials live on the app registration (one OAuth app per
+ // Twenty server, configured by the admin) — not per-workspace. Declare them
+ // as serverVariables so the admin can fill them in once for all installs.
+ serverVariables: {
+ LINEAR_CLIENT_ID: {
+ description: 'OAuth client ID from your Linear OAuth application.',
+ isSecret: false,
+ isRequired: true,
+ },
+ LINEAR_CLIENT_SECRET: {
+ description: 'OAuth client secret from your Linear OAuth application.',
+ isSecret: true,
+ isRequired: true,
+ },
+ },
+});
+```
+
+Puntos clave:
+
+* `name` es la cadena de identificador única utilizada en `listConnections({ providerName })` (kebab-case, debe coincidir con `^[a-z][a-z0-9-]*$`).
+* `displayName` se muestra en la pestaña de configuración por aplicación y en la lista de herramientas de IA.
+* `clientIdVariable` / `clientSecretVariable` son **nombres**, no valores — deben coincidir con las claves declaradas en `defineApplication.serverVariables`. Los `client_id` y `client_secret` reales los introduce el administrador del servidor a través de la interfaz de registro de la aplicación; nunca se incluyen en tu repositorio.
+* Usa `serverVariables` (no `applicationVariables`) — las credenciales de OAuth son a nivel de servidor y hay una aplicación OAuth por servidor de Twenty.
+* Hasta que ambos `serverVariables` estén completos, la pestaña de configuración por aplicación muestra un aviso de "requiere administrador del servidor" y el botón "Agregar conexión" está deshabilitado.
+* `type: 'oauth'` es el único valor admitido actualmente. El discriminador es compatible hacia adelante: tipos futuros (`'pat'`, `'api-key'`, ...) agregarán nuevos bloques de subconfiguración junto a `oauth`.
+
+La URL de callback de OAuth que tu proveedor debe autorizar es:
+
+```
+https://<your-twenty-server>/auth/apps/callback
+```
+
+</Accordion>
+
+<Accordion title="listConnections / getConnection" description="Usa conexiones desde una función de lógica">
+
+Dentro de un controlador de función de lógica, `listConnections({ providerName })` devuelve las filas `ConnectedAccount` de esta aplicación para el proveedor indicado, con tokens de acceso actualizados.
+
+```ts src/logic-functions/handlers/create-linear-issue-handler.ts
+import { listConnections } from 'twenty-sdk/logic-function';
+
+export const createLinearIssueHandler = async (input: {
+ teamId?: string;
+ title?: string;
+}) => {
+ if (!input.teamId || !input.title) {
+ return { success: false, error: 'teamId and title are required' };
+ }
+
+ const connections = await listConnections({ providerName: 'linear' });
+
+ // Workspace-shared credentials win when present; fall back to the first
+ // user-visibility one. For HTTP-route triggers you typically pick the
+ // request user's connection via event.userWorkspaceId instead.
+ const connection =
+ connections.find((c) => c.visibility === 'workspace') ?? connections[0];
+
+ if (!connection) {
+ return {
+ success: false,
+ error:
+ 'Linear is not connected. Open the app settings and click "Add connection".',
+ };
+ }
+
+ // Use connection.accessToken to call the third-party API.
+ const response = await fetch('https://api.linear.app/graphql', {
+ method: 'POST',
+ headers: {
+ Authorization: `Bearer ${connection.accessToken}`,
+ 'Content-Type': 'application/json',
+ },
+ body: JSON.stringify({
+ query: `mutation { issueCreate(input: { teamId: "${input.teamId}", title: "${input.title}" }) { success } }`,
+ }),
+ });
+
+ return { success: response.ok };
+};
+```
+
+Cada conexión tiene:
+
+| Campo | Descripción |
+| ----------------- | -------------------------------------------------------------------------------------------------------------------------------- |
+| `id` | ID de fila único; pásalo a `getConnection(id)` para volver a obtener una sola conexión |
+| `visibility` | `'user'` (privada para un miembro del espacio de trabajo) o `'workspace'` (compartida con todos los miembros) |
+| `scopes` | Permisos de OAuth concedidos por el proveedor de origen (distintos de `visibility` — no están relacionados) |
+| `userWorkspaceId` | El id de userWorkspace del propietario — útil para elegir "la conexión del usuario de la solicitud" en activadores de rutas HTTP |
+| `accessToken` | Token de acceso OAuth actualizado (se renueva automáticamente si ha expirado) |
+| `name` / `handle` | El nombre para mostrar de la conexión (derivado automáticamente en el callback de OAuth, el usuario puede cambiarlo) |
+| `authFailedAt` | Se establece cuando la actualización más reciente falló; el usuario debe reconectarse |
+
+Puntos clave:
+
+* Pasa `{ providerName }` para filtrar por proveedor; omítelo para obtener todas las conexiones que posee esta aplicación en todos los proveedores.
+* El servidor actualiza de forma transparente el token de acceso antes de devolver la respuesta. Tu controlador siempre ve un token utilizable (o `authFailedAt` establecido).
+* `getConnection(id)` es el equivalente de una sola fila.
+
+</Accordion>
+
+<Accordion title="Visibilidad por usuario vs. compartida con el espacio de trabajo" description="Cómo los usuarios eligen entre credenciales privadas y compartidas">
+
+Cuando un usuario hace clic en "Agregar conexión", se le solicita que elija una visibilidad:
+
+* **Solo para mí** — la credencial es privada para el usuario que se conecta. Cualquier función de lógica llamada en su nombre (activador de ruta HTTP con `isAuthRequired: true`) la ve; los activadores de cron y los eventos de base de datos no.
+* **Compartida en el espacio de trabajo** — cualquier miembro del espacio de trabajo puede usar la credencial. Los activadores de cron y de base de datos también la ven, ya que no tienen usuario de la solicitud.
+
+Usa la adecuada para cada controlador:
+
+```ts
+// HTTP-route trigger — prefer the request user's own connection.
+const conn =
+ connections.find((c) => c.userWorkspaceId === event.userWorkspaceId) ??
+ connections.find((c) => c.visibility === 'workspace');
+
+// Cron trigger — no request user; only shared credentials are sensible.
+const conn = connections.find((c) => c.visibility === 'workspace');
+```
+
+Se permiten múltiples conexiones por (usuario, proveedor), por lo que el mismo usuario puede tener "Linear personal" y "Linear de trabajo" a la vez.
+
+</Accordion>
+
+<Accordion title="Configuración única del proveedor" description="Registra tu aplicación OAuth con el servicio de terceros">
+
+Para cada proveedor de conexión, el administrador del servidor debe registrar primero una aplicación OAuth en el servicio de terceros.
+
+1. Ve a la configuración de desarrollador del proveedor (p. ej., https://linear.app/settings/api/applications/new).
+2. Configura el **URI de redirección** en `\<SERVER_URL>/auth/apps/callback`.
+3. Copia el **Client ID** y el **Client Secret** generados.
+4. Abre la aplicación instalada en Twenty como administrador del servidor → establece los valores en los `serverVariables` correspondientes.
+5. Luego, los miembros del espacio de trabajo pueden agregar conexiones desde la sección **Conexiones** por aplicación.
+
+</Accordion>
+
+</AccordionGroup>
diff --git a/packages/twenty-docs/l/es/developers/extend/apps/logic/logic-functions.mdx b/packages/twenty-docs/l/es/developers/extend/apps/logic/logic-functions.mdx
new file mode 100644
index 00000000000..68769150ff0
--- /dev/null
+++ b/packages/twenty-docs/l/es/developers/extend/apps/logic/logic-functions.mdx
@@ -0,0 +1,515 @@
+---
+title: Funciones de lógica
+description: Defina funciones de TypeScript del lado del servidor con activadores HTTP, de cron y de eventos de base de datos.
+icon: bolt
+---
+
+Las funciones lógicas son funciones de TypeScript del lado del servidor que se ejecutan en la plataforma Twenty. Pueden activarse mediante solicitudes HTTP, programaciones de cron o eventos de base de datos — y también pueden exponerse como herramientas para agentes de IA.
+
+<AccordionGroup>
+<Accordion title="defineLogicFunction" description="Define funciones de lógica y sus desencadenadores">
+
+Cada archivo de función usa `defineLogicFunction()` para exportar una configuración con un controlador y desencadenadores opcionales.
+
+```ts src/logic-functions/createPostCard.logic-function.ts
+import { defineLogicFunction } from 'twenty-sdk/define';
+import type { RoutePayload } from 'twenty-sdk/logic-function';
+import { CoreApiClient } from 'twenty-client-sdk/core';
+
+const handler = async (params: RoutePayload) => {
+ const client = new CoreApiClient();
+ const body = (params.body ?? {}) as { name?: string };
+ const name = body.name ?? process.env.DEFAULT_RECIPIENT_NAME ?? 'Hello world';
+
+ const result = await client.mutation({
+ createPostCard: {
+ __args: { data: { name } },
+ id: true,
+ name: true,
+ },
+ });
+ return result;
+};
+
+export default defineLogicFunction({
+ universalIdentifier: 'e56d363b-0bdc-4d8a-a393-6f0d1c75bdcf',
+ name: 'create-new-post-card',
+ timeoutSeconds: 2,
+ handler,
+ httpRouteTriggerSettings: {
+ path: '/post-card/create',
+ httpMethod: 'POST',
+ isAuthRequired: true,
+ },
+ /*databaseEventTriggerSettings: {
+ eventName: 'people.created',
+ },*/
+ /*cronTriggerSettings: {
+ pattern: '0 0 1 1 *',
+ },*/
+});
+```
+
+Tipos de desencadenadores disponibles:
+* **httpRoute**: Expone tu función en una ruta y método HTTP **bajo el endpoint `/s/`**:
+> p. ej., `path: '/post-card/create'` se puede invocar en `https://your-twenty-server.com/s/post-card/create`
+
+<Note>
+Para invocar una función de lógica activada por una ruta desde un componente de frontend (headless), consulta [Llamar a una función de lógica](/l/es/developers/extend/apps/layout/front-components#calling-a-logic-function).
+</Note>
+* **cron**: Ejecuta tu función en un horario usando una expresión CRON.
+* **databaseEvent**: Se ejecuta en eventos del ciclo de vida de objetos del espacio de trabajo. Cuando la operación del evento es `updated`, se pueden especificar campos específicos que se deben escuchar en la matriz `updatedFields`. Si se deja sin definir o vacío, cualquier actualización activará la función.
+> p. ej. `person.updated`, `*.created`, `company.*`
+
+<Note>
+También puedes ejecutar manualmente una función usando la CLI:
+
+```bash filename="Terminal"
+yarn twenty dev:function:exec -n create-new-post-card -p '{"key": "value"}'
+```
+
+```bash filename="Terminal"
+yarn twenty dev:function:exec -u e56d363b-0bdc-4d8a-a393-6f0d1c75bdcf
+```
+
+Puedes ver los registros con:
+
+```bash filename="Terminal"
+yarn twenty dev:function:logs
+```
+</Note>
+
+#### Carga útil del disparador de ruta
+
+Cuando un desencadenador de ruta invoca tu función de lógica, esta recibe un objeto `RoutePayload` que sigue el
+[formato AWS HTTP API v2](https://docs.aws.amazon.com/apigateway/latest/developerguide/http-api-develop-integrations-lambda.html).
+Importa el tipo `RoutePayload` desde `twenty-sdk/logic-function`:
+
+```ts
+import type { RoutePayload } from 'twenty-sdk/logic-function';
+
+const handler = async (event: RoutePayload) => {
+ const { headers, queryStringParameters, pathParameters, body } = event;
+ const { method, path } = event.requestContext.http;
+
+ return { message: 'Success' };
+};
+```
+
+El tipo `RoutePayload` tiene la siguiente estructura:
+
+ | Propiedad | Tipo | Descripción | Ejemplo |
+ | ---------------------------- | ------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------- |
+ | `headers` | `Record\<string, string \| undefined>` | Encabezados HTTP (solo aquellos listados en `forwardedRequestHeaders`) | consulta la sección de abajo |
+ | `queryStringParameters` | `Record\<string, string \| undefined>` | Parámetros de consulta (valores múltiples unidos con comas) | `/users?ids=1&ids=2&ids=3&name=Alice` -> `{ ids: '1,2,3', name: 'Alice' }` |
+ | `pathParameters` | `Record\<string, string \| undefined>` | Parámetros de ruta extraídos del patrón de la ruta | `/users/:id`, `/users/123` -> `{ id: '123' }` |
+ | `body` | `object \| null` | Cuerpo de la solicitud analizado (JSON) | `{ id: 1 }` -> `{ id: 1 }` |
+ | `rawBody` | `string \| undefined` | Cuerpo de la solicitud UTF-8 original, antes del análisis de JSON. Útil para verificar firmas de webhooks de estilo HMAC (p. ej., `X-Hub-Signature-256` de GitHub, Stripe). `undefined` cuando el entorno de ejecución no lo conservó. | |
+ | `isBase64Encoded` | `boolean` | Indica si el cuerpo está codificado en base64 | |
+ | `requestContext.http.method` | `string` | Método HTTP (GET, POST, PUT, PATCH, DELETE) | |
+ | `requestContext.http.path` | `string` | Ruta de la solicitud sin procesar | |
+
+
+#### forwardedRequestHeaders
+
+De forma predeterminada, los encabezados HTTP de las solicitudes entrantes **no** se pasan a tu función de lógica por razones de seguridad.
+Para acceder a encabezados específicos, enuméralos explícitamente en el arreglo `forwardedRequestHeaders`:
+
+```ts
+export default defineLogicFunction({
+ universalIdentifier: 'e56d363b-0bdc-4d8a-a393-6f0d1c75bdcf',
+ name: 'webhook-handler',
+ handler,
+ httpRouteTriggerSettings: {
+ path: '/webhook',
+ httpMethod: 'POST',
+ isAuthRequired: false,
+ forwardedRequestHeaders: ['x-webhook-signature', 'content-type'],
+ },
+});
+```
+
+En tu controlador, accede a los encabezados reenviados así:
+
+```ts
+const handler = async (event: RoutePayload) => {
+ const signature = event.headers['x-webhook-signature'];
+ const contentType = event.headers['content-type'];
+
+ // Validate webhook signature...
+ return { received: true };
+};
+```
+
+<Note>
+Los nombres de los encabezados se normalizan a minúsculas. Accede a ellos usando claves en minúsculas (p. ej., `event.headers['content-type']`).
+</Note>
+
+#### Respuesta HTTP personalizada
+
+De forma predeterminada, devolver un valor sencillo desde tu controlador lo envía de vuelta como una respuesta `200` (JSON para objetos, `text/plain` para cadenas). Para controlar el código de estado y los encabezados de la respuesta, devuelve un `Response` desde `twenty-sdk/logic-function`:
+
+```ts
+import { Response } from 'twenty-sdk/logic-function';
+
+const handler = async (event: RoutePayload) => {
+ return new Response('<h1>Hello</h1>', {
+ status: 201,
+ headers: { 'content-type': 'text/html' },
+ });
+};
+```
+
+Por razones de seguridad, los encabezados de la respuesta están restringidos a una lista de permitidos. Cualquier encabezado que no esté en la lista (por ejemplo, `Set-Cookie`, encabezados CORS como `Access-Control-Allow-Origin`, o encabezados personalizados `X-*`) se descarta silenciosamente antes de que se envíe la respuesta. Los encabezados de respuesta permitidos son:
+
+* `content-type`
+* `content-language`
+* `content-disposition`
+* `cache-control`
+* `retry-after`
+
+<Note>
+El código de estado debe ser un código de estado HTTP válido (entre 100 y 599). Los nombres de los encabezados de respuesta se comparan sin distinguir mayúsculas de minúsculas.
+</Note>
+
+#### Payload del disparador de evento de base de datos
+
+Cuando un disparador de evento de base de datos invoca tu función de lógica, esta recibe un `DatabaseEventPayload` por cada registro modificado. El payload combina metadatos sobre el espacio de trabajo y el objeto de origen con el evento a nivel de registro.
+
+```ts
+import type {
+ DatabaseEventPayload,
+ ObjectRecordCreateEvent,
+ ObjectRecordDestroyEvent,
+ ObjectRecordUpdateEvent,
+} from 'twenty-sdk/logic-function';
+
+type Person = {
+ id: string;
+ emails?: { primaryEmail?: string };
+};
+```
+
+La carga útil incluye:
+
+| Propiedad | Descripción |
+| ------------------------------------------------ | ------------------------------------------------------------------------------------------------------ |
+| `name` | Nombre del evento, como `person.updated`. |
+| `workspaceId` | Espacio de trabajo donde ocurrió el evento. |
+| `objectMetadata` | Metadatos del objeto que cambió. |
+| `recordId` | Id del registro que cambió. |
+| `userId`, `userWorkspaceId`, `workspaceMemberId` | Campos del actor cuando el evento fue causado por un usuario del espacio de trabajo. |
+| `propiedades` | Datos del registro para el evento, con `before`, `after`, `diff` y `updatedFields` según la operación. |
+
+| Evento | Datos del registro |
+| ------------------ | -------------------------------------------------------------------------------------------------------------- |
+| `person.created` | `event.properties.after` |
+| `person.updated` | `event.properties.before`, `event.properties.after`, `event.properties.diff`, `event.properties.updatedFields` |
+| `person.destroyed` | `event.properties.before` |
+
+Para eliminaciones lógicas (soft deletes), `.deleted` sigue la estructura de estilo de actualización porque el campo `deletedAt` del registro cambia.
+Para eliminaciones permanentes, usa `.destroyed`.
+
+<Note>
+`databaseEventTriggerSettings.updatedFields` filtra qué eventos de actualización activan la función.
+`event.properties.updatedFields` te indica qué campos realmente cambiaron en el evento actual.
+</Note>
+
+Ejemplo de evento de creación:
+
+```ts
+type PersonCreatedEvent = DatabaseEventPayload<
+ ObjectRecordCreateEvent<Person>
+>;
+
+const handler = async (event: PersonCreatedEvent) => {
+ const person = event.properties.after;
+
+ return {
+ personId: event.recordId,
+ email: person.emails?.primaryEmail,
+ };
+};
+```
+
+Ejemplo de evento de actualización:
+
+```ts
+type PersonUpdatedEvent = DatabaseEventPayload<
+ ObjectRecordUpdateEvent<Person>
+>;
+
+const handler = async (event: PersonUpdatedEvent) => {
+ const { before, after, diff, updatedFields } = event.properties;
+
+ return {
+ personId: event.recordId,
+ updatedFields,
+ previousEmail: before.emails?.primaryEmail,
+ currentEmail: after.emails?.primaryEmail,
+ emailDiff: diff.emails,
+ };
+};
+```
+
+Ejecutar solo en actualizaciones de correo electrónico:
+
+```ts
+export default defineLogicFunction({
+ ...,
+ databaseEventTriggerSettings: {
+ eventName: 'person.updated',
+ updatedFields: ['emails'],
+ },
+});
+```
+
+Ejemplo de evento de eliminación:
+
+```ts
+type PersonDestroyedEvent = DatabaseEventPayload<
+ ObjectRecordDestroyEvent<Person>
+>;
+
+const handler = async (event: PersonDestroyedEvent) => {
+ const personBeforeDestroy = event.properties.before;
+
+ return {
+ personId: event.recordId,
+ email: personBeforeDestroy.emails?.primaryEmail,
+ };
+};
+```
+
+#### Exponer una función como herramienta de IA o acción de flujo de trabajo
+
+Las funciones lógicas pueden exponerse en dos ámbitos, cada uno con su propio disparador:
+
+* **`toolTriggerSettings`** — hace que la función sea descubrible por las funciones de IA de Twenty (chat, MCP, llamadas a funciones). Usa el JSON Schema estándar, el formato que los LLM entienden de forma nativa.
+* **`workflowActionTriggerSettings`** — hace que la función aparezca como un paso en el constructor visual de flujos de trabajo. Usa el `InputSchema` completo de Twenty para que el constructor pueda renderizar editores de campos adecuados, selectores de variables y etiquetas.
+
+Una función puede optar por una, por la otra o por ambas. Se ubican junto a `cronTriggerSettings`, `databaseEventTriggerSettings` y `httpRouteTriggerSettings` — mismo patrón, misma estructura.
+
+```ts src/logic-functions/enrich-company.logic-function.ts
+import { defineLogicFunction } from 'twenty-sdk/define';
+import { CoreApiClient } from 'twenty-client-sdk/core';
+
+const handler = async (params: { companyName: string; domain?: string }) => {
+ const client = new CoreApiClient();
+
+ const result = await client.mutation({
+ createTask: {
+ __args: {
+ data: {
+ title: `Enrich data for ${params.companyName}`,
+ body: `Domain: ${params.domain ?? 'unknown'}`,
+ },
+ },
+ id: true,
+ },
+ });
+
+ return { taskId: result.createTask.id };
+};
+
+export default defineLogicFunction({
+ universalIdentifier: 'f47ac10b-58cc-4372-a567-0e02b2c3d479',
+ name: 'enrich-company',
+ description: 'Enrich a company record with external data',
+ timeoutSeconds: 10,
+ handler,
+ toolTriggerSettings: {},
+});
+```
+
+Puntos clave:
+
+* Una función puede mezclar superficies — declara tanto `toolTriggerSettings` como `workflowActionTriggerSettings` para exponerla en el chat Y en el constructor de flujos de trabajo.
+* Ambos, `toolTriggerSettings.inputSchema` y `workflowActionTriggerSettings.inputSchema`, son opcionales. Cuando se omiten, el generador del manifiesto los infiere a partir del código fuente del controlador (JSON Schema para la herramienta de IA, `InputSchema` de Twenty para la acción de flujo de trabajo). Proporciona uno explícitamente cuando quieras un tipado más rico — por ejemplo, con campos compatibles con `FieldMetadataType` como `CURRENCY` o `RELATION` para el constructor de flujos de trabajo, o con campos `description` que el agente de IA pueda leer:
+
+```ts
+export default defineLogicFunction({
+ ...,
+ toolTriggerSettings: {
+ inputSchema: {
+ type: 'object',
+ properties: {
+ companyName: {
+ type: 'string',
+ description: 'The name of the company to enrich',
+ },
+ domain: {
+ type: 'string',
+ description: 'The company website domain (optional)',
+ },
+ },
+ required: ['companyName'],
+ },
+ },
+});
+```
+
+<Note>
+**Escribe una buena `description`.** Los agentes de IA dependen del campo `description` de la función para decidir cuándo usar la herramienta. Sé específico acerca de lo que hace la herramienta y cuándo debe invocarse.
+</Note>
+
+</Accordion>
+</AccordionGroup>
+
+<Note>
+**Hooks de instalación** — los controladores de preinstalación y postinstalación — comparten este entorno de ejecución, pero se declaran con sus propias funciones 'define' y no aceptan configuraciones de disparador. Consulta [Hooks de instalación](/l/es/developers/extend/apps/config/install-hooks) para `definePreInstallLogicFunction` y `definePostInstallLogicFunction`.
+</Note>
+
+## Clientes de API tipados (twenty-client-sdk)
+
+El paquete `twenty-client-sdk` proporciona dos clientes GraphQL tipados para interactuar con la API de Twenty desde tus funciones de lógica y componentes de frontend.
+
+| Cliente | Importar | Endpoint | ¿Generado? |
+| ------------------- | ---------------------------- | ---------------------------------------------------------------------- | --------------------------------------- |
+| `CoreApiClient` | `twenty-client-sdk/core` | `/graphql` — datos del espacio de trabajo (registros, objetos) | Sí, en tiempo de desarrollo/compilación |
+| `MetadataApiClient` | `twenty-client-sdk/metadata` | `/metadata` — configuración del espacio de trabajo, cargas de archivos | No, viene preconstruido |
+
+<AccordionGroup>
+<Accordion title="CoreApiClient" description="Consultar y modificar datos del espacio de trabajo (registros, objetos)">
+
+`CoreApiClient` es el cliente principal para consultar y mutar datos del espacio de trabajo. Se **genera a partir del esquema de tu espacio de trabajo** durante `yarn twenty dev` o `yarn twenty dev:build`, por lo que está completamente tipado para coincidir con tus objetos y campos.
+
+```ts
+import { CoreApiClient } from 'twenty-client-sdk/core';
+
+const client = new CoreApiClient();
+
+// Query records
+const { companies } = await client.query({
+ companies: {
+ edges: {
+ node: {
+ id: true,
+ name: true,
+ domainName: {
+ primaryLinkLabel: true,
+ primaryLinkUrl: true,
+ },
+ },
+ },
+ },
+});
+
+// Create a record
+const { createCompany } = await client.mutation({
+ createCompany: {
+ __args: {
+ data: {
+ name: 'Acme Corp',
+ },
+ },
+ id: true,
+ name: true,
+ },
+});
+```
+
+El cliente usa una sintaxis de conjunto de selección: pasa `true` para incluir un campo, usa `__args` para los argumentos y anida objetos para las relaciones. Obtienes autocompletado completo y verificación de tipos basados en el esquema de tu espacio de trabajo.
+
+<Note>
+**CoreApiClient se genera en tiempo de desarrollo/compilación.** Si intentas usarlo sin ejecutar primero `yarn twenty dev` o `yarn twenty dev:build`, lanzará un error. La generación ocurre automáticamente: la CLI inspecciona el esquema GraphQL de tu espacio de trabajo y genera un cliente tipado usando `@genql/cli`.
+</Note>
+
+#### Uso de CoreSchema para anotaciones de tipos
+
+`CoreSchema` proporciona tipos de TypeScript que coinciden con los objetos de tu espacio de trabajo; útil para tipar el estado de componentes o parámetros de funciones:
+
+```ts
+import { CoreApiClient, CoreSchema } from 'twenty-client-sdk/core';
+import { useState } from 'react';
+
+const [company, setCompany] = useState<
+ Pick<CoreSchema.Company, 'id' | 'name'> | undefined
+>(undefined);
+
+const client = new CoreApiClient();
+const result = await client.query({
+ company: {
+ __args: { filter: { position: { eq: 1 } } },
+ id: true,
+ name: true,
+ },
+});
+setCompany(result.company);
+```
+
+</Accordion>
+<Accordion title="MetadataApiClient" description="Configuración del espacio de trabajo, aplicaciones y cargas de archivos">
+
+`MetadataApiClient` viene preconstruido con el SDK (no se requiere generación). Consulta el endpoint `/metadata` para la configuración del espacio de trabajo, las aplicaciones y las cargas de archivos.
+
+```ts
+import { MetadataApiClient } from 'twenty-client-sdk/metadata';
+
+const metadataClient = new MetadataApiClient();
+
+// List first 10 objects in the workspace
+const { objects } = await metadataClient.query({
+ objects: {
+ edges: {
+ node: {
+ id: true,
+ nameSingular: true,
+ namePlural: true,
+ labelSingular: true,
+ isCustom: true,
+ },
+ },
+ __args: {
+ filter: {},
+ paging: { first: 10 },
+ },
+ },
+});
+```
+
+#### Subir archivos
+
+El `MetadataApiClient` incluye un método `uploadFile` para adjuntar archivos a los campos de tipo archivo:
+
+```ts
+import { MetadataApiClient } from 'twenty-client-sdk/metadata';
+import * as fs from 'fs';
+
+const metadataClient = new MetadataApiClient();
+
+const fileBuffer = fs.readFileSync('./invoice.pdf');
+
+const uploadedFile = await metadataClient.uploadFile(
+ fileBuffer, // file contents as a Buffer
+ 'invoice.pdf', // filename
+ 'application/pdf', // MIME type
+ '58a0a314-d7ea-4865-9850-7fb84e72f30b', // field universalIdentifier
+);
+
+console.log(uploadedFile);
+// { id: '...', path: '...', size: 12345, createdAt: '...', url: 'https://...' }
+```
+
+| Parámetro | Tipo | Descripción |
+| ---------------------------------- | -------- | ----------------------------------------------------------------------------- |
+| `fileBuffer` | `Buffer` | El contenido sin procesar del archivo |
+| `filename` | `string` | El nombre del archivo (se utiliza para el almacenamiento y la visualización) |
+| `contentType` | `string` | Tipo MIME (de forma predeterminada es `application/octet-stream` si se omite) |
+| `fieldMetadataUniversalIdentifier` | `string` | El `universalIdentifier` del campo de tipo de archivo de tu objeto |
+
+Puntos clave:
+* Utiliza el `universalIdentifier` del campo (no su ID específico del espacio de trabajo), por lo que tu código de carga funciona en cualquier espacio de trabajo donde esté instalada tu aplicación.
+* La `url` devuelta es una URL firmada que puedes usar para acceder al archivo cargado.
+
+</Accordion>
+</AccordionGroup>
+
+<Note>
+ Cuando tu código se ejecuta en Twenty (funciones de lógica o componentes de frontend), la plataforma inyecta credenciales como variables de entorno:
+
+ * `TWENTY_API_URL` — URL base de la API de Twenty
+ * `TWENTY_APP_ACCESS_TOKEN` — Token de corta duración con alcance al rol de función predeterminado de tu aplicación
+
+ No necesitas pasar estas credenciales a los clientes — leen de `process.env` automáticamente. Los permisos de la clave de API están determinados por el rol declarado con `defineApplicationRole()` (o referenciado mediante `defaultRoleUniversalIdentifier` en `application-config.ts`).
+</Note>
diff --git a/packages/twenty-docs/l/es/developers/extend/apps/logic/overview.mdx b/packages/twenty-docs/l/es/developers/extend/apps/logic/overview.mdx
new file mode 100644
index 00000000000..a7475eedf61
--- /dev/null
+++ b/packages/twenty-docs/l/es/developers/extend/apps/logic/overview.mdx
@@ -0,0 +1,55 @@
+---
+title: Resumen
+description: TypeScript del lado del servidor que se ejecuta dentro de Twenty, activado por rutas HTTP, programaciones cron, eventos de base de datos, herramientas de IA o acciones de flujos de trabajo.
+icon: bolt
+---
+
+La **capa de lógica** de una app de Twenty es el código que *se ejecuta*: controladores de TypeScript del lado del servidor que reaccionan a solicitudes HTTP, programaciones cron y cambios en registros; habilidades y agentes de IA que viven dentro del espacio de trabajo; y conexiones OAuth que permiten que tus funciones actúen en nombre de un usuario en servicios de terceros.
+
+```text
+ ┌─ HTTP route ──┐
+ │ Cron schedule │
+ │ Database event │ ┌────────────────────┐
+ triggers ─┤ AI tool call ├─────▶│ Logic function │
+ │ Workflow action │ │ (your handler) │
+ │ Manual exec │ └────────────────────┘
+ └────────────────────┘ │
+ ▼
+ ┌────────────────────────────┐
+ │ Twenty API (records) │
+ │ Third-party API │
+ │ (via Connection token) │
+ └────────────────────────────┘
+```
+
+## En esta sección
+
+<CardGroup cols={2}>
+ <Card title="Funciones de lógica" icon="bolt" href="/l/es/developers/extend/apps/logic/logic-functions">
+ El bloque de construcción principal: tipos de disparadores, cargas útiles y el cliente de API tipado.
+ </Card>
+ <Card title="Habilidades y agentes" icon="robot" href="/l/es/developers/extend/apps/logic/skills-and-agents">
+ Instrucciones reutilizables para agentes de IA y asistentes con mensajes de sistema personalizados.
+ </Card>
+ <Card title="Conexiones" icon="plug" href="/l/es/developers/extend/apps/logic/connections">
+ Credenciales OAuth que tu app mantiene para servicios de terceros — Linear, GitHub, Slack y más.
+ </Card>
+</CardGroup>
+
+## Tipos de disparadores de un vistazo
+
+Una función de lógica selecciona uno o más disparadores: cada entrada a continuación es un campo independiente en `defineLogicFunction()`:
+
+| Disparador | Cuándo se ejecuta | Configuración |
+| ------------------------------- | --------------------------------------------------------------- | ------------------------------- |
+| **Ruta HTTP** | Una solicitud llega a tu endpoint `/s/\<path>` | `httpRouteTriggerSettings` |
+| **Cron** | Coincide una expresión CRON | `cronTriggerSettings` |
+| **Evento de base de datos** | Se crea, actualiza o elimina un registro del espacio de trabajo | `databaseEventTriggerSettings` |
+| **Herramienta de IA** | Una funcionalidad de IA de Twenty decide llamar a tu función | `toolTriggerSettings` |
+| **Acción del Flujo de Trabajo** | Un paso de flujo de trabajo invoca tu función | `workflowActionTriggerSettings` |
+
+Las funciones se ejecutan en un entorno aislado en procesos independientes de Node.js y acceden al espacio de trabajo a través de un cliente de API tipado con un ámbito limitado al rol declarado en [`defineApplication()`](/l/es/developers/extend/apps/config/application).
+
+<Note>
+**Hooks de instalación**: el código que se ejecuta antes o después de la instalación comparte este entorno de ejecución pero usa sus propias funciones define y se encuentra en [Config → Install Hooks](/l/es/developers/extend/apps/config/install-hooks).
+</Note>
diff --git a/packages/twenty-docs/l/es/developers/extend/apps/logic/skills-and-agents.mdx b/packages/twenty-docs/l/es/developers/extend/apps/logic/skills-and-agents.mdx
new file mode 100644
index 00000000000..0f55371476c
--- /dev/null
+++ b/packages/twenty-docs/l/es/developers/extend/apps/logic/skills-and-agents.mdx
@@ -0,0 +1,138 @@
+---
+title: Habilidades y agentes
+description: Define habilidades y agentes de IA para tu aplicación.
+icon: robot
+---
+
+<Warning>
+ Las habilidades y los agentes están actualmente en pruebas alfa. La funcionalidad es operativa, pero sigue evolucionando.
+</Warning>
+
+Las aplicaciones pueden definir capacidades de IA que residen dentro del espacio de trabajo — instrucciones de habilidades reutilizables y agentes con prompts de sistema personalizados.
+
+<AccordionGroup>
+<Accordion title="defineSkill" description="Define habilidades para agentes de IA">
+
+Las habilidades definen instrucciones y capacidades reutilizables que los agentes de IA pueden usar dentro de tu espacio de trabajo. Usa `defineSkill()` para definir habilidades con validación incorporada:
+
+```ts src/skills/example-skill.ts
+import { defineSkill } from 'twenty-sdk/define';
+
+export default defineSkill({
+ universalIdentifier: 'a1b2c3d4-e5f6-7890-abcd-ef1234567890',
+ name: 'sales-outreach',
+ label: 'Sales Outreach',
+ description: 'Guides the AI agent through a structured sales outreach process',
+ icon: 'IconBrain',
+ content: `You are a sales outreach assistant. When reaching out to a prospect:
+1. Research the company and recent news
+2. Identify the prospect's role and likely pain points
+3. Draft a personalized message referencing specific details
+4. Keep the tone professional but conversational`,
+});
+```
+
+Puntos clave:
+* `name` es una cadena identificadora única de la habilidad (se recomienda kebab-case).
+* `label` es el nombre para mostrar, legible para humanos, que aparece en la interfaz de usuario.
+* `content` contiene las instrucciones de la habilidad — este es el texto que usa el agente de IA.
+* `icon` (opcional) establece el icono mostrado en la interfaz de usuario.
+* `description` (opcional) proporciona contexto adicional sobre el propósito de la habilidad.
+
+</Accordion>
+<Accordion title="defineAgent" description="Define agentes de IA con prompts personalizados">
+
+Los agentes son asistentes de IA que viven dentro de tu espacio de trabajo. Usa `defineAgent()` para crear agentes con un prompt de sistema personalizado:
+
+```ts src/agents/example-agent.ts
+import { defineAgent } from 'twenty-sdk/define';
+
+export default defineAgent({
+ universalIdentifier: 'b3c4d5e6-f7a8-9012-bcde-f34567890123',
+ name: 'sales-assistant',
+ label: 'Sales Assistant',
+ description: 'Helps the sales team draft outreach emails and research prospects',
+ icon: 'IconRobot',
+ prompt: 'You are a helpful sales assistant. Help users with their questions and tasks.',
+});
+```
+
+Puntos clave:
+* `name` es una cadena identificadora única del agente (se recomienda kebab-case).
+* `label` es el nombre para mostrar que aparece en la interfaz de usuario.
+* `prompt` es el mensaje del sistema que define el comportamiento del agente.
+* `description` (opcional) proporciona contexto sobre lo que hace el agente.
+* `icon` (opcional) establece el icono mostrado en la interfaz de usuario.
+* `modelId` (opcional) reemplaza el modelo de IA predeterminado usado por el agente.
+* `responseFormat` (opcional) controla la forma de la salida del agente. De forma predeterminada es `{ type: 'text' }` para texto de formato libre. Usa `{ type: 'json', schema }` para forzar una salida JSON estructurada.
+
+De forma predeterminada, un agente devuelve texto de formato libre. Para obtener una salida estructurada, establece `responseFormat` en `{ type: 'json' }` y proporciona un `schema`:
+
+```ts src/agents/structured-agent.ts
+import { defineAgent } from 'twenty-sdk/define';
+
+export default defineAgent({
+ universalIdentifier: 'c4d5e6f7-a8b9-0123-cdef-456789012345',
+ name: 'lead-scorer',
+ label: 'Lead Scorer',
+ prompt: 'Score the lead and explain your reasoning.',
+ responseFormat: {
+ type: 'json',
+ schema: {
+ type: 'object',
+ properties: {
+ score: { type: 'number', description: 'Lead score from 0 to 100' },
+ summary: { type: 'string', description: 'Short reasoning for the score' },
+ },
+ required: ['score', 'summary'],
+ additionalProperties: false,
+ },
+ },
+});
+```
+
+Notas sobre el esquema:
+* El esquema es un objeto plano: el `type` de cada propiedad debe ser un tipo primitivo (`string`, `number` o `boolean`). Los objetos anidados y los arrays no son compatibles.
+* `description` (opcional) en cada propiedad guía al modelo sobre qué debe poner allí.
+* `required` (opcional) enumera las propiedades que el modelo siempre debe devolver.
+* `additionalProperties: false` (opcional) prohíbe cualquier propiedad que no esté declarada en `properties`.
+
+</Accordion>
+<Accordion title="runAgent" description="Ejecutar un agente desde una función de lógica">
+
+`runAgent()` permite que una función de lógica ejecute uno de los agentes de tu app (con sus skills y tools). Identifica el agente mediante el `universalIdentifier` que pasaste a `defineAgent()`:
+
+```ts src/logic-functions/run-enricher.ts
+import { runAgent } from 'twenty-sdk/logic-function';
+
+const { result, error, success } = await runAgent({
+ agentUniversalIdentifier: 'b3c4d5e6-f7a8-9012-bcde-f34567890123',
+ prompt: 'Enrich House Ad <recordId>: fill empty fields from its listing URL.',
+});
+```
+
+Puntos clave:
+* El agente se ejecuta **sincrónicamente** y puede leer/actualizar registros por sí mismo mediante sus propias tools; `runAgent()` se resuelve una vez que la ejecución finaliza.
+* Una app solo puede ejecutar sus propios agentes.
+* El [rol predeterminado](/l/es/developers/extend/apps/config/roles) de la app debe conceder el indicador de permiso `AI`; agrega `SystemPermissionFlag.AI` a sus `permissionFlagUniversalIdentifiers` (o establece `canAccessAllTools: true`).
+ Sin esto, `runAgent()` falla con un error de permisos.
+* Establece un valor generoso de `timeoutSeconds` en la función de lógica: las ejecuciones de agentes pueden tardar varios segundos.
+* `success` es `true` y `result` es no nulo cuando la ejecución finaliza; en caso de fallo `success` es `false`, `result` es `null`, y `error` contiene el motivo (por ejemplo, cuando el espacio de trabajo se queda sin créditos de AI en mitad de la ejecución).
+
+```ts src/roles/default-role.ts
+import { defineApplicationRole, SystemPermissionFlag } from 'twenty-sdk/define';
+
+export default defineApplicationRole({
+ universalIdentifier: 'b648f87b-1d26-4961-b974-0908fd991061',
+ label: 'Default function role',
+ // runAgent() requires the AI permission flag on the app's default role.
+ permissionFlagUniversalIdentifiers: [SystemPermissionFlag.AI],
+});
+```
+
+<Warning>
+ **Evita los bucles:** si llamas a `runAgent()` desde un trigger de evento de base de datos `*.updated` y el agente actualiza el mismo registro, limita el alcance del trigger con `updatedFields` a un campo que el agente nunca escriba (por ejemplo, la URL de origen), o comprueba si algún campo de destino sigue vacío antes de llamar a `runAgent()`.
+</Warning>
+
+</Accordion>
+</AccordionGroup>
diff --git a/packages/twenty-docs/l/es/developers/extend/apps/operations/cli.mdx b/packages/twenty-docs/l/es/developers/extend/apps/operations/cli.mdx
new file mode 100644
index 00000000000..7a26b76116c
--- /dev/null
+++ b/packages/twenty-docs/l/es/developers/extend/apps/operations/cli.mdx
@@ -0,0 +1,105 @@
+---
+title: CLI
+description: Comandos de `yarn twenty` para ejecutar funciones, transmitir registros en tiempo real, gestionar instalaciones de aplicaciones y cambiar entre remotos.
+icon: terminal
+---
+
+Más allá de `dev`, `dev:build`, `dev:add` y `dev:typecheck`, la CLI de `yarn twenty` proporciona comandos para ejecutar funciones, ver registros y gestionar instalaciones de aplicaciones.
+
+## Ejecutar funciones (`yarn twenty dev:function:exec`)
+
+Ejecuta manualmente una función de lógica sin activarla mediante HTTP, cron o evento de base de datos:
+
+```bash filename="Terminal"
+# Execute by function name
+yarn twenty dev:function:exec -n create-new-post-card
+
+# Execute by universalIdentifier
+yarn twenty dev:function:exec -u e56d363b-0bdc-4d8a-a393-6f0d1c75bdcf
+
+# Pass a JSON payload
+yarn twenty dev:function:exec -n create-new-post-card -p '{"name": "Hello"}'
+
+# Execute the post-install function
+yarn twenty dev:function:exec --postInstall
+```
+
+## Ver registros de funciones (`yarn twenty dev:function:logs`)
+
+Transmitir en tiempo real los registros de ejecución de las funciones de lógica de tu aplicación:
+
+```bash filename="Terminal"
+# Stream all function logs
+yarn twenty dev:function:logs
+
+# Filter by function name
+yarn twenty dev:function:logs -n create-new-post-card
+
+# Filter by universalIdentifier
+yarn twenty dev:function:logs -u e56d363b-0bdc-4d8a-a393-6f0d1c75bdcf
+```
+
+<Note>
+Esto es diferente de `yarn twenty docker:logs`, que muestra los registros del contenedor de Docker. `yarn twenty dev:function:logs` muestra los registros de ejecución de funciones de tu aplicación desde el servidor de Twenty.
+</Note>
+
+## Generando el cliente tipado (`yarn twenty dev:generate-client`)
+
+Regenera el cliente de API tipado (`twenty-client-sdk`) a partir del esquema del remoto activo, sin compilar ni sincronizar una aplicación. Úsalo para obtener un cliente tipado en cualquier proyecto — como un servicio backend que vive en un repositorio separado — que se comunica con tu instancia de Twenty:
+
+```bash filename="Terminal"
+# In your project (no Twenty app definition required)
+yarn add twenty-sdk twenty-client-sdk
+
+# Connect to the Twenty instance to generate the client from
+yarn twenty remote:add
+
+# Generate the typed client into node_modules/twenty-client-sdk
+yarn twenty dev:generate-client
+```
+
+Luego importa el cliente en tu código:
+
+```typescript
+import { CoreApiClient } from 'twenty-client-sdk/core';
+```
+
+Vuelve a ejecutar el comando cada vez que cambie tu modelo de datos para actualizar los tipos generados.
+
+<Note>
+El cliente se genera dentro de `node_modules`, por lo que no se incluye en tus commits de código. Ejecuta `yarn twenty dev:generate-client` después de cada instalación (por ejemplo, en un script de `postinstall` o en CI).
+</Note>
+
+## Desinstalar una aplicación (`yarn twenty app:uninstall`)
+
+Elimina tu aplicación del espacio de trabajo activo:
+
+```bash filename="Terminal"
+yarn twenty app:uninstall
+
+# Skip the confirmation prompt
+yarn twenty app:uninstall --yes
+```
+
+## Gestión de remotos
+
+Un **remoto** es un servidor de Twenty al que se conecta tu app. Durante la configuración, el generador crea uno automáticamente para ti. Puedes añadir más remotos o cambiar entre ellos en cualquier momento.
+
+```bash filename="Terminal"
+# Add a new remote (opens a browser for OAuth login)
+yarn twenty remote:add
+
+# Connect to a local Twenty server (auto-detects port 2020 or 3000)
+yarn twenty remote:add --local
+
+# Add a remote non-interactively (useful for CI)
+yarn twenty remote:add --url https://your-twenty-server.com --api-key $TWENTY_API_KEY --as my-remote
+
+# List all configured remotes
+yarn twenty remote:list
+
+# Set the active remote
+yarn twenty remote:use <name>
+```
+
+Tus credenciales se almacenan en `~/.twenty/config.json`.
diff --git a/packages/twenty-docs/l/es/developers/extend/apps/operations/overview.mdx b/packages/twenty-docs/l/es/developers/extend/apps/operations/overview.mdx
new file mode 100644
index 00000000000..45e497e16f2
--- /dev/null
+++ b/packages/twenty-docs/l/es/developers/extend/apps/operations/overview.mdx
@@ -0,0 +1,32 @@
+---
+title: Resumen
+description: "Compila, prueba y envía tu aplicación: comandos de CLI, pruebas de integración, CI y publicación en un servidor o en npm."
+icon: rocket
+---
+
+La **capa de operaciones** es todo lo que haces *a* tu aplicación en lugar de *con* ella: invocar comandos de CLI, ejecutar pruebas de integración contra un servidor Twenty real, configurar CI y enviar versiones, ya sea como un tarball implementado en un único servidor o como un paquete de npm listado en el marketplace.
+
+```text
+ develop ─▶ test ─▶ build ─▶ deploy / publish
+ ─────── ──── ───── ─────────────────
+ yarn yarn yarn yarn twenty app:publish --private (tarball → one server)
+ twenty test twenty
+ dev dev:build yarn twenty app:publish (npm → marketplace)
+```
+
+## En esta sección
+
+<CardGroup cols={2}>
+ <Card title="CLI" icon="terminal" href="/l/es/developers/extend/apps/operations/cli">
+ Referencia de `yarn twenty` — exec, logs, uninstall, remotes.
+ </Card>
+ <Card title="Sincronización y recuperación" icon="brújula" href="/l/es/developers/extend/apps/operations/sync-and-recovery">
+ Qué comando usar y cuándo, cómo leer el diff de sincronización y una guía escalonada de recuperación.
+ </Card>
+ <Card title="Pruebas" icon="flask" href="/l/es/developers/extend/apps/operations/testing">
+ Configuración de Vitest, pruebas de integración, comprobación de tipos, flujo de trabajo de CI.
+ </Card>
+ <Card title="Publicación" icon="subir" href="/l/es/developers/extend/apps/operations/publishing">
+ Compilar, desplegar un tarball, publicar en npm, instalar.
+ </Card>
+</CardGroup>
diff --git a/packages/twenty-docs/l/es/developers/extend/apps/operations/publishing.mdx b/packages/twenty-docs/l/es/developers/extend/apps/operations/publishing.mdx
new file mode 100644
index 00000000000..e651be4d321
--- /dev/null
+++ b/packages/twenty-docs/l/es/developers/extend/apps/operations/publishing.mdx
@@ -0,0 +1,294 @@
+---
+title: Publicación
+icon: subir
+description: Distribuye tu aplicación de Twenty en el marketplace o despliégala internamente.
+---
+
+## Resumen
+
+Una vez que tu aplicación esté [compilada y probada localmente](/l/es/developers/extend/apps/getting-started/concepts), tienes dos vías para distribuirla:
+
+* **Desplegar un paquete tar** — sube tu aplicación directamente a un servidor Twenty específico para uso interno o privado.
+* **Publicar en npm** — incluye tu aplicación en el marketplace de Twenty para que cualquier espacio de trabajo la descubra e instale.
+
+Ambas rutas comienzan en el mismo paso de **build**.
+
+## Compilar tu aplicación
+
+Ejecuta el comando `build` para compilar tu aplicación y generar un `manifest.json` listo para distribución:
+
+```bash filename="Terminal"
+yarn twenty dev:build
+```
+
+Esto compila el código fuente de TypeScript, transpila las funciones de lógica y los componentes de frontend, y escribe todo en `.twenty/output/`. Agrega `--tarball` para generar también un paquete `.tgz` para la distribución manual o para el comando `publish`.
+
+## Despliegue en un servidor (tarball)
+
+Para aplicaciones que no quieres que estén disponibles públicamente — herramientas propietarias, integraciones solo para empresas o compilaciones experimentales — puedes desplegar un tarball directamente en un servidor de Twenty.
+
+### Prerrequisitos
+
+Antes de desplegar, necesitas un remoto configurado que apunte al servidor de destino. Los remotos almacenan la URL del servidor y las credenciales de autenticación localmente en `~/.twenty/config.json`.
+
+Agrega un remoto:
+
+```bash filename="Terminal"
+yarn twenty remote:add --url https://your-twenty-server.com --as production
+```
+
+### Despliegue
+
+Compila y sube tu aplicación al servidor en un solo paso:
+
+```bash filename="Terminal"
+yarn twenty app:publish --private
+# To deploy to a specific remote:
+# yarn twenty app:publish --private --remote production
+```
+
+### Compartir una aplicación desplegada
+
+<Warning>
+Compartir aplicaciones privadas (tarball) entre espacios de trabajo es una función de **Enterprise**. La pestaña **Distribución** mostrará un aviso de actualización en lugar de los controles para compartir hasta que tu espacio de trabajo tenga una clave de Enterprise válida. Ve a [Configuración > Panel de administración > Enterprise](/settings/admin-panel#enterprise) para habilitarla.
+</Warning>
+
+Las aplicaciones en tarball no se listan en el marketplace público, por lo que otros espacios de trabajo en el mismo servidor no las descubrirán navegando. Una vez que tu espacio de trabajo esté en el plan Enterprise, puedes compartir una aplicación desplegada de esta manera:
+
+1. Ve a **Configuración > Aplicaciones > Registros** y abre tu aplicación
+2. En la pestaña **Distribución**, haz clic en **Copiar enlace para compartir**
+3. Comparte este enlace con usuarios de otros espacios de trabajo — los llevará directamente a la página de instalación de la aplicación
+
+El enlace para compartir usa la URL base del servidor (sin ningún subdominio de espacio de trabajo), por lo que funciona para cualquier espacio de trabajo en el servidor.
+
+### Gestión de versiones
+
+Al actualizar una aplicación tarball ya desplegada, el servidor requiere que la `version` en `package.json` sea **estrictamente mayor** (según el orden de [semver](https://semver.org)) que la versión actualmente desplegada. Volver a desplegar la misma versión, o subir una inferior, se rechaza antes de que se almacene el tarball — verás un error `VERSION_ALREADY_EXISTS` en la CLI.
+
+Para publicar una actualización:
+
+1. Incrementa el campo `version` en tu `package.json` (p. ej., `1.2.3` → `1.2.4`, `1.3.0` o `2.0.0`)
+2. Ejecuta `yarn twenty app:publish --private` (o `yarn twenty app:publish --private --remote production`)
+3. Los espacios de trabajo que tengan la aplicación instalada verán la actualización disponible en su configuración
+
+<Note>
+Las etiquetas de prelanzamiento funcionan como se espera: incrementar `1.0.0-rc.1` → `1.0.0-rc.2` está permitido, y una versión final como `1.0.0` se reconoce correctamente como superior a `1.0.0-rc.5`. La versión en `package.json` debe ser en sí misma una cadena semver válida.
+</Note>
+
+{/* TODO: add screenshot of the Upgrade button */}
+
+### Compatibilidad de la versión del servidor
+
+Si tu app usa una función introducida en una versión específica del servidor Twenty (por ejemplo, proveedores de OAuth agregados en v2.3.0), debes declarar la versión mínima del servidor que tu app requiere usando el campo `engines.twenty` en `package.json`:
+
+```json filename="package.json"
+{
+ "name": "twenty-my-app",
+ "version": "1.0.0",
+ "engines": {
+ "node": "^24.5.0",
+ "twenty": ">=2.3.0"
+ }
+}
+```
+
+El valor es un [rango semver](https://github.com/npm/node-semver#ranges) estándar. Patrones comunes:
+
+| Rango | Significado |
+| ---------------------------------- | -------------------------------------------------------------------- |
+| `>=2.3.0` | Cualquier servidor desde 2.3.0 en adelante |
+| `>=2.3.0 \<3.0.0` | 2.3.0 o posterior, pero por debajo de la siguiente versión principal |
+| `^2.3.0` | Igual que `>=2.3.0 \<3.0.0` |
+
+**Qué sucede durante la implementación e instalación:**
+
+* Si `engines.twenty` está configurado y la versión del servidor de destino no cumple el rango, la implementación (carga del tarball) o la instalación se rechaza con un error `SERVER_VERSION_INCOMPATIBLE` y un mensaje que indica tanto el rango requerido como la versión real del servidor.
+* Si `engines.twenty` **no está configurado**, la app se acepta en cualquier versión del servidor (retrocompatible con las apps existentes).
+* Si el servidor no tiene `APP_VERSION` configurado, se omite la comprobación.
+
+<Note>
+El servidor es la autoridad en la comprobación — valida `engines.twenty` tanto en la carga del tarball como en la instalación en el espacio de trabajo. Si implementas un tarball fuera de banda o instalas desde el marketplace, el servidor sigue garantizando la compatibilidad.
+</Note>
+
+## CI/CD automatizado (flujos de trabajo preconfigurados)
+
+Las aplicaciones generadas con `create-twenty-app` incluyen de forma predeterminada dos flujos de trabajo de GitHub Actions, en `.github/workflows/`. Están listas para ejecutarse en cuanto hagas push del repositorio a GitHub — no se necesita configuración adicional para CI, y CD solo requiere un único secreto.
+
+### CI — `ci.yml`
+
+Ejecuta pruebas de integración en cada push a `main` y en cada pull request.
+
+**Qué hace:**
+
+1. Obtiene el código fuente de tu aplicación.
+2. Inicia una instancia de prueba aislada de Twenty usando la acción compuesta `twentyhq/twenty/.github/actions/spawn-twenty-app-dev-test@main` (el equivalente en CI de `yarn twenty docker:start --test`).
+3. Habilita Corepack, configura Node.js desde tu `.nvmrc` e instala las dependencias con `yarn install --immutable`.
+4. Ejecuta `yarn test`, pasando `TWENTY_API_URL` y `TWENTY_API_KEY` de la instancia iniciada para que tus pruebas puedan comunicarse con un servidor real.
+
+**Ajustes de configuración:**
+
+* `TWENTY_VERSION` (variable de entorno; por defecto `latest`) — fija la versión del servidor de Twenty usada en CI editando esto en `ci.yml`.
+* La concurrencia se agrupa por `github.ref` y cancela las ejecuciones en progreso cuando hay nuevos pushes.
+
+No se requieren secretos — la instancia de prueba es efímera y existe solo durante la ejecución del trabajo.
+
+### CD — `cd.yml`
+
+Despliega tu aplicación en un servidor de Twenty configurado en cada push a `main` y, opcionalmente, desde un pull request cuando se aplica la etiqueta `deploy`.
+
+**Qué hace:**
+
+1. Obtiene el head del PR (para PR etiquetados) o el commit enviado.
+2. Ejecuta `twentyhq/twenty/.github/actions/deploy-twenty-app@main` — el equivalente en CI de `yarn twenty app:publish --private`.
+3. Ejecuta `twentyhq/twenty/.github/actions/install-twenty-app@main` para que la versión recién desplegada se instale en el espacio de trabajo de destino.
+
+**Configuración necesaria:**
+
+| Configuración | Dónde | Propósito |
+| ----------------------- | -------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------- |
+| `TWENTY_DEPLOY_URL` | `env` en `cd.yml` (por defecto `http://localhost:3000`) | El servidor de Twenty al que se va a desplegar. Cámbialo por la URL real de tu servidor antes del primer uso. |
+| `TWENTY_DEPLOY_API_KEY` | Repositorio de GitHub **Settings → Secrets and variables → Actions** | Clave de API con permiso de despliegue en el servidor de destino. |
+
+<Note>
+La `TWENTY_DEPLOY_URL` predeterminada de `http://localhost:3000` es un marcador de posición — no alcanzará nada desde un runner alojado por GitHub. Actualízala a la URL pública de tu servidor (o usa un runner autohospedado con acceso a la red) antes de habilitar CD.
+</Note>
+
+**Activar un despliegue de vista previa desde un PR:**
+
+Añade la etiqueta `deploy` a un pull request. La condición `if:` en `cd.yml` ejecutará el trabajo para ese PR usando el commit head del PR, lo que te permitirá validar un cambio en el servidor de destino antes de hacer merge.
+
+### Fijar las acciones reutilizables
+
+Ambos flujos de trabajo hacen referencia a acciones reutilizables en `@main`, por lo que las actualizaciones de acciones en el repositorio `twentyhq/twenty` se aplican automáticamente. Si quieres compilaciones deterministas, reemplaza `@main` por un SHA de commit o una etiqueta de versión en cada línea `uses:`.
+
+## Publicación en npm
+
+Publicarla en npm hace que tu aplicación sea visible en el marketplace de Twenty. Cualquier espacio de trabajo de Twenty puede explorar, instalar y actualizar aplicaciones del marketplace directamente desde la interfaz de usuario.
+
+### Requisitos
+
+* Una cuenta de [npm](https://www.npmjs.com)
+* La palabra clave `twenty-app` en la matriz `keywords` de tu `package.json` (agrégala manualmente — no se incluye de forma predeterminada en la plantilla `create-twenty-app`)
+
+```json filename="package.json"
+{
+ "name": "twenty-app-postcard-sender",
+ "version": "1.0.0",
+ "keywords": ["twenty-app"]
+}
+```
+
+### Metadatos del Marketplace
+
+La configuración de `defineApplication()` admite campos opcionales que controlan cómo aparece tu aplicación en el marketplace. Usa `logoUrl` y `screenshots` para hacer referencia a imágenes de la carpeta `public/`:
+
+```ts src/application-config.ts
+export default defineApplication({
+ universalIdentifier: '...',
+ displayName: 'My App',
+ description: 'A great app',
+ logoUrl: 'public/logo.png',
+ screenshots: [
+ 'public/screenshot-1.png',
+ 'public/screenshot-2.png',
+ ],
+});
+```
+
+Consulta el [acordeón de defineApplication](/l/es/developers/extend/apps/config/application#marketplace-metadata) en la página Building Apps para ver la lista completa de campos del marketplace (`author`, `category`, `aboutDescription`, `websiteUrl`, `termsUrl`, etc.).
+
+#### Dimensiones recomendadas de las capturas de pantalla
+
+El marketplace muestra `screenshots` en un contenedor fijo de `8:5` (por ejemplo, `1600×1000 px`).
+
+<Note>
+Las capturas de pantalla de cualquier relación de aspecto se muestran completas y nunca se recortan, pero las que sean significativamente más altas o más estrechas que `8:5` mostrarán franjas vacías a los lados.
+</Note>
+
+### Publicar
+
+```bash filename="Terminal"
+yarn twenty app:publish
+```
+
+Para publicar con una dist-tag específica (p. ej., `beta` o `next`):
+
+```bash filename="Terminal"
+yarn twenty app:publish --tag beta
+```
+
+### Cómo funciona el descubrimiento en el marketplace
+
+El servidor de Twenty sincroniza su catálogo del marketplace desde el registro de npm **cada hora**.
+
+Puedes activar la sincronización de inmediato en lugar de esperar:
+
+```bash filename="Terminal"
+yarn twenty dev:catalog-sync
+# To target a specific remote:
+# yarn twenty dev:catalog-sync --remote production
+```
+
+Los metadatos que se muestran en el marketplace provienen de tu configuración de `defineApplication()` — campos como `displayName`, `description`, `author`, `category`, `logoUrl`, `screenshots`, `aboutDescription`, `websiteUrl` y `termsUrl`.
+
+<Note>
+Si tu aplicación no define un `aboutDescription` en `defineApplication()`, el marketplace usará automáticamente el `README.md` de tu paquete en npm como el contenido de la página Acerca de. Esto significa que puedes mantener un único README tanto para npm como para el marketplace de Twenty. Si quieres una descripción diferente en el marketplace, establece explícitamente `aboutDescription`.
+</Note>
+
+### Publicación en CI
+
+Usa este flujo de trabajo de GitHub Actions para publicar automáticamente en cada versión (usa [OIDC](https://docs.npmjs.com/trusted-publishers)):
+
+```yaml filename=".github/workflows/publish.yml"
+name: Publish
+on:
+ release:
+ types: [published]
+
+permissions:
+ contents: read
+ id-token: write
+
+jobs:
+ publish:
+ runs-on: ubuntu-latest
+ steps:
+ - uses: actions/checkout@v4
+ - uses: actions/setup-node@v4
+ with:
+ node-version: "24"
+ registry-url: https://registry.npmjs.org
+ - run: yarn install --immutable
+ - run: npx twenty dev:build
+ - run: npm publish --provenance --access public
+ working-directory: .twenty/output
+```
+
+Para otros sistemas de CI (GitLab CI, CircleCI, etc.), se aplican los mismos tres comandos: `yarn install`, `yarn twenty dev:build` y luego `npm publish` desde `.twenty/output`.
+
+<Note>
+**npm provenance** es opcional pero recomendable. Publicar con `--provenance` añade una insignia de confianza a tu ficha de npm, permitiendo que los usuarios verifiquen que el paquete se compiló a partir de un commit específico en una canalización de CI pública. Consulta la [documentación de npm sobre provenance](https://docs.npmjs.com/generating-provenance-statements) para las instrucciones de configuración.
+</Note>
+
+## Instalar aplicaciones
+
+Una vez que una aplicación esté publicada (npm) o desplegada (tarball), los espacios de trabajo pueden instalarla a través de la interfaz de usuario.
+
+Ve a la página **Configuración > Aplicaciones** en Twenty, donde se pueden explorar e instalar tanto las aplicaciones del marketplace como las desplegadas mediante tarball.
+
+{/* TODO: add screenshot of the UI when the app is registered */}
+
+También puedes instalar aplicaciones desde la línea de comandos:
+
+```bash filename="Terminal"
+yarn twenty app:install
+```
+
+<Note>
+El servidor aplica el versionado semver al instalar, reflejando las reglas del despliegue:
+
+* Instalar la misma versión que ya está instalada en tu espacio de trabajo se rechaza con un error `APP_ALREADY_INSTALLED`.
+* Instalar una versión inferior a la que está instalada actualmente se rechaza con un error `CANNOT_DOWNGRADE_APPLICATION`.
+
+Para instalar una versión más reciente, primero despliégala o publícala y luego vuelve a ejecutar `yarn twenty app:install`.
+</Note>
diff --git a/packages/twenty-docs/l/es/developers/extend/apps/operations/sync-and-recovery.mdx b/packages/twenty-docs/l/es/developers/extend/apps/operations/sync-and-recovery.mdx
new file mode 100644
index 00000000000..db90f4fec10
--- /dev/null
+++ b/packages/twenty-docs/l/es/developers/extend/apps/operations/sync-and-recovery.mdx
@@ -0,0 +1,111 @@
+---
+title: Sincronización y recuperación
+description: Qué comando usar y cuándo, cómo leer la salida de sincronización y una escalera de recuperación para cuando los metadatos locales se desvían, antes de llegar a un restablecimiento completo.
+icon: brújula
+---
+
+El desarrollo de aplicaciones locales gira en torno a la **sincronización**: la CLI recompila tu manifiesto y el servidor aplica solo la diferencia entre este y los metadatos que ya se encuentran en tu espacio de trabajo. Esta página explica qué comando usar, cómo leer qué cambió una sincronización y qué hacer, en orden, cuando el estado local parece inconsistente.
+
+## Qué comando usar y cuándo
+
+<Note>
+Para la iteración local del día a día casi siempre quieres `yarn twenty dev`. La implementación y la publicación son para enviar versiones, **no** para el ciclo local.
+</Note>
+
+| Quieres… | Comando | Notas |
+| --------------------------------------------------- | ----------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
+| Iterar localmente con sincronización en tiempo real | `yarn twenty dev` | Supervisa tus archivos y sincroniza en cada cambio. |
+| Sincronizar una vez y salir (CI, scripts, hooks) | `yarn twenty dev --once` | Una compilación + sincronización, luego sale. |
+| Previsualizar cambios **sin aplicarlos** | `yarn twenty dev --once --dry-run` | Calcula e imprime el diff; no escribe nada. |
+| Eliminar la aplicación del espacio de trabajo | `yarn twenty app:uninstall` | Agrega `--yes` para omitir la confirmación. |
+| Enviar un tarball a un servidor | `yarn twenty app:publish --private` | Requiere una versión de `package.json` **estrictamente superior**; consulta [Publicación](/l/es/developers/extend/apps/operations/publishing). |
+| Publicar en el marketplace (npm) | `yarn twenty app:publish` | — |
+| Instalar / actualizar una versión implementada | `yarn twenty app:install` | Instala la versión actualmente implementada. |
+| Borrar el servidor local y empezar desde cero | `yarn twenty docker:reset` | Elimina **todos** los datos locales: último recurso. |
+
+### La sincronización local no necesita un aumento de versión
+
+La regla de `version` estrictamente creciente (`VERSION_ALREADY_EXISTS` al implementar, `APP_ALREADY_INSTALLED` / `CANNOT_DOWNGRADE_APPLICATION` al instalar) se aplica a **`app:publish` / `app:install`**: la ruta de publicación. `yarn twenty dev` sincroniza tu manifiesto en su lugar y nunca requiere un cambio de versión, por lo que no necesitas tocar `package.json` para iterar. Si te encuentras aumentando la versión para probar un cambio local, estás usando la ruta de publicación cuando lo que quieres es el ciclo de desarrollo.
+
+## Leer la salida de la sincronización
+
+Cada sincronización muestra los cambios de metadatos que aplicó (o aplicaría, con `--dry-run`):
+
+```text filename="Terminal"
+Metadata changes: 2 created, 1 updated, 1 deleted
+ created objectMetadata rocket
+ created fieldMetadata timelineActivities
+ updated fieldMetadata launchedAt
+ deleted pageLayout legacyTab
+✓ Synced
+```
+
+Este es tu primer diagnóstico: te indica exactamente qué objetos, campos y diseños cambiaron, para que puedas confirmar que una sincronización hizo lo que esperabas antes de revisar la interfaz de usuario.
+
+Cuando una sincronización falla en una sola entidad, el error nombra la entidad implicada y su `universalIdentifier`, por ejemplo:
+
+```text
+Migration action 'create' for 'fieldMetadata' (universalIdentifier: 2020...4337) failed
+```
+
+Usa ese identificador para encontrar la entidad en tu manifiesto (y, si es necesario, en el espacio de trabajo) en lugar de adivinar cuál entra en conflicto.
+
+## Previsualizar cambios (simulación)
+
+`yarn twenty dev --once --dry-run` compila tu manifiesto, le pide al servidor el plan de migración y lo imprime, **sin aplicar nada**. Es la forma segura de responder "¿qué cambiaría esta sincronización?" antes de comprometerte a ella.
+
+```bash filename="Terminal"
+yarn twenty dev --once --dry-run
+```
+
+```text filename="Terminal"
+Building manifest...
+Computing metadata diff (dry run, nothing will be applied)...
+Metadata changes: 1 created, 1 updated
+ created fieldMetadata timelineActivities
+ updated objectMetadata rocket
+✓ Dry run complete for My App — no changes were applied
+```
+
+Una simulación:
+
+* **No escribe nada**: sin migración de metadatos, sin actualización del registro de la aplicación, sin cambios de roles/pestañas predeterminados y sin generación del cliente de la API.
+* Devuelve el **mismo diff** que aplicaría una sincronización real, para que puedas revisar por adelantado las entidades creadas/actualizadas/eliminadas.
+* Es útil antes de un cambio arriesgado, al revisar un cambio generado por IA o en un script que deba fallar si está a punto de producirse un cambio inesperado.
+
+<Note>
+Una simulación solo previsualiza cambios de **metadatos** y requiere que la aplicación se haya sincronizado al menos una vez (para que el espacio de trabajo la conozca). Si la ejecutas con una aplicación que nunca se sincronizó, el servidor indicará que la aplicación no está instalada; ejecuta `yarn twenty dev` una vez primero.
+</Note>
+
+## Escalera de recuperación
+
+Cuando los metadatos locales parezcan incorrectos, ve escalando en este orden y detente en cuanto te hayas desbloqueado. Cada paso es más disruptivo que el anterior.
+
+1. **Volver a sincronizar.** Ejecuta `yarn twenty dev --once` de nuevo. Las sincronizaciones son idempotentes: volver a ejecutar un manifiesto limpio es seguro y suele resolver un problema transitorio.
+2. **Previsualizar el plan.** Ejecuta `yarn twenty dev --once --dry-run` para ver exactamente qué pretende cambiar la siguiente sincronización, sin aplicarlo.
+3. Lee el error identificado. Un conflicto suele señalar un identificador duplicado o reutilizado.
+4. **Desinstalar y volver a instalar.** `yarn twenty app:uninstall`, luego vuelve a sincronizar (`yarn twenty dev`). Esto reconstruye los metadatos de la aplicación desde cero manteniendo intacto el resto de tu espacio de trabajo.
+5. **Restablecimiento completo (último recurso).** `yarn twenty docker:reset`, luego vuelve a sembrar los datos y a sincronizar.
+
+<Warning>
+`yarn twenty docker:reset` elimina **todos** los datos de tu instancia local: todos los espacios de trabajo, registros y aplicaciones. Úsalo solo cuando los pasos anteriores hayan fallado.
+</Warning>
+
+<Note>
+¿Te has encontrado con un error de metadatos? Por favor, [abre una incidencia](https://github.com/twentyhq/twenty/issues/new/choose) e incluye el mensaje de migración con error (con su tipo de metadatos y `universalIdentifier`), la salida de `Metadata changes` de la sincronización y los comandos que ejecutaste.
+</Note>
+
+## Evita sincronizaciones concurrentes en un mismo espacio de trabajo
+
+La sincronización aplica migraciones de metadatos. Ejecutar varias operaciones de sincronización, implementación o instalación contra el **mismo espacio de trabajo al mismo tiempo** (por ejemplo, múltiples terminales o agentes de IA iterando en paralelo) puede entremezclar esas migraciones y dejar los metadatos en un estado parcialmente aplicado.
+
+El servidor serializa las sincronizaciones por espacio de trabajo para evitar esto, pero aun así deberías canalizar las operaciones de metadatos sensibles a través de un proceso **único** en lugar de lanzarlas de forma concurrente. Si orquestas el desarrollo con varios agentes, enruta sus llamadas de sincronización/implementación/instalación a través de una sola cola de modo que solo una se ejecute a la vez.
+
+## Distinguir los tipos de error
+
+Cuando algo sale mal, el diff de metadatos y los errores con nombre te permiten situar el fallo:
+
+* **Error de compilación del manifiesto**: la CLI falla antes de sincronizar (`MANIFEST_BUILD_FAILED`, `TYPECHECK_FAILED`); corrige el código fuente de tu aplicación.
+* **Error de sincronización / migración**: la compilación tiene éxito, pero aplicar el diff falla, nombrando la entidad y el `universalIdentifier`; corrige los metadatos en conflicto.
+* **Error de tiempo de ejecución del código de la aplicación**: la sincronización se completa correctamente, pero tus funciones lógicas o componentes se comportan de forma incorrecta en tiempo de ejecución; revisa los [registros de funciones](/l/es/developers/extend/apps/operations/cli).
+* **Estado de instancia local**: nada de lo anterior aplica y el espacio de trabajo sigue viéndose mal; desciende por la escalera de recuperación.
diff --git a/packages/twenty-docs/l/es/developers/extend/apps/operations/testing.mdx b/packages/twenty-docs/l/es/developers/extend/apps/operations/testing.mdx
new file mode 100644
index 00000000000..c15ba57c69e
--- /dev/null
+++ b/packages/twenty-docs/l/es/developers/extend/apps/operations/testing.mdx
@@ -0,0 +1,301 @@
+---
+title: Pruebas
+description: Configuración de Vitest, pruebas de integración contra un servidor real de Twenty, comprobación de tipos e integración continua (CI) con GitHub Actions.
+icon: flask
+---
+
+El SDK proporciona APIs programáticas que te permiten compilar, desplegar, instalar y desinstalar tu aplicación desde código de pruebas. Combinado con [Vitest](https://vitest.dev/) y los clientes de API tipados, puedes escribir pruebas de integración que verifiquen que tu aplicación funciona de extremo a extremo contra un servidor real de Twenty.
+
+## Uso de paquetes de npm
+
+Puedes instalar y usar cualquier paquete de npm en tu aplicación. Tanto las funciones de lógica como los componentes de frontend se empaquetan con [esbuild](https://esbuild.github.io/), que incorpora todas las dependencias en la salida — no se necesitan `node_modules` en tiempo de ejecución.
+
+### Instalar un paquete
+
+```bash filename="Terminal"
+yarn add axios
+```
+
+Luego impórtalo en tu código:
+
+```ts src/logic-functions/fetch-data.ts
+import { defineLogicFunction } from 'twenty-sdk/define';
+import axios from 'axios';
+
+const handler = async (): Promise<any> => {
+ const { data } = await axios.get('https://api.example.com/data');
+
+ return { data };
+};
+
+export default defineLogicFunction({
+ universalIdentifier: '...',
+ name: 'fetch-data',
+ description: 'Fetches data from an external API',
+ timeoutSeconds: 10,
+ handler,
+});
+```
+
+Lo mismo funciona para los componentes de frontend:
+
+```tsx src/front-components/chart.tsx
+import { defineFrontComponent } from 'twenty-sdk/define';
+import { format } from 'date-fns';
+
+const DateWidget = () => {
+ return <p>Today is {format(new Date(), 'MMMM do, yyyy')}</p>;
+};
+
+export default defineFrontComponent({
+ universalIdentifier: '...',
+ name: 'date-widget',
+ component: DateWidget,
+});
+```
+
+### Cómo funciona el empaquetado
+
+El paso de compilación usa esbuild para producir un solo archivo autónomo por función de lógica y por componente de frontend. Todos los paquetes importados se insertan en el bundle.
+
+**Las funciones de lógica** se ejecutan en un entorno Node.js. Los módulos integrados de Node (`fs`, `path`, `crypto`, `http`, etc.) están disponibles y no necesitan instalarse.
+
+**Los componentes de frontend** se ejecutan en un Web Worker. Los módulos integrados de Node **no** están disponibles — solo las APIs del navegador y paquetes de npm que funcionen en un entorno de navegador.
+
+Ambos entornos tienen `twenty-client-sdk/core` y `twenty-client-sdk/metadata` disponibles como módulos preproporcionados — estos no se incluyen en el bundle sino que se resuelven en tiempo de ejecución por el servidor.
+
+## Configuración
+
+La aplicación generada ya incluye Vitest. Si lo configuras manualmente, instala las dependencias:
+
+```bash filename="Terminal"
+yarn add -D vitest vite-tsconfig-paths
+```
+
+Crea un `vitest.config.ts` en la raíz de tu aplicación:
+
+```ts vitest.config.ts
+import tsconfigPaths from 'vite-tsconfig-paths';
+import { defineConfig } from 'vitest/config';
+
+export default defineConfig({
+ plugins: [
+ tsconfigPaths({
+ projects: ['tsconfig.spec.json'],
+ ignoreConfigErrors: true,
+ }),
+ ],
+ test: {
+ testTimeout: 120_000,
+ hookTimeout: 120_000,
+ include: ['src/**/*.integration-test.ts'],
+ setupFiles: ['src/__tests__/setup-test.ts'],
+ env: {
+ TWENTY_API_URL: 'http://localhost:2020',
+ TWENTY_API_KEY: 'your-api-key',
+ },
+ },
+});
+```
+
+Crea un archivo de configuración que verifique que el servidor es accesible antes de ejecutar las pruebas:
+
+```ts src/__tests__/setup-test.ts
+import * as fs from 'fs';
+import * as os from 'os';
+import * as path from 'path';
+import { beforeAll } from 'vitest';
+
+const TWENTY_API_URL = process.env.TWENTY_API_URL ?? 'http://localhost:2020';
+const TEST_CONFIG_DIR = path.join(os.tmpdir(), '.twenty-sdk-test');
+
+beforeAll(async () => {
+ // Verify the server is running
+ const response = await fetch(`${TWENTY_API_URL}/healthz`);
+
+ if (!response.ok) {
+ throw new Error(
+ `Twenty server is not reachable at ${TWENTY_API_URL}. ` +
+ 'Start the server before running integration tests.',
+ );
+ }
+
+ // Write a temporary config for the SDK
+ fs.mkdirSync(TEST_CONFIG_DIR, { recursive: true });
+
+ fs.writeFileSync(
+ path.join(TEST_CONFIG_DIR, 'config.json'),
+ JSON.stringify({
+ remotes: {
+ local: {
+ apiUrl: process.env.TWENTY_API_URL,
+ apiKey: process.env.TWENTY_API_KEY,
+ },
+ },
+ defaultRemote: 'local',
+ }, null, 2),
+ );
+});
+```
+
+## APIs programáticas del SDK
+
+La subruta `twenty-sdk/cli` exporta funciones que puedes invocar directamente desde el código de pruebas:
+
+| Función | Descripción |
+| -------------- | ------------------------------------------------------------ |
+| `appBuild` | Compilar la aplicación y opcionalmente empaquetar un tarball |
+| `appDeploy` | Subir un tarball al servidor |
+| `appInstall` | Instalar la aplicación en el espacio de trabajo activo |
+| `appUninstall` | Desinstalar la aplicación del espacio de trabajo activo |
+
+Cada función devuelve un objeto de resultado con `success: boolean` y `data` o `error`.
+
+## Escribir una prueba de integración
+
+Aquí tienes un ejemplo completo que compila, despliega e instala la aplicación, y luego verifica que aparezca en el espacio de trabajo:
+
+```ts src/__tests__/app-install.integration-test.ts
+import { APPLICATION_UNIVERSAL_IDENTIFIER } from 'src/application-config';
+import { appBuild, appDeploy, appInstall, appUninstall } from 'twenty-sdk/cli';
+import { MetadataApiClient } from 'twenty-client-sdk/metadata';
+import { afterAll, beforeAll, describe, expect, it } from 'vitest';
+
+const APP_PATH = process.cwd();
+
+describe('App installation', () => {
+ beforeAll(async () => {
+ const buildResult = await appBuild({
+ appPath: APP_PATH,
+ tarball: true,
+ onProgress: (message: string) => console.log(`[build] ${message}`),
+ });
+
+ if (!buildResult.success) {
+ throw new Error(`Build failed: ${buildResult.error?.message}`);
+ }
+
+ const deployResult = await appDeploy({
+ tarballPath: buildResult.data.tarballPath!,
+ onProgress: (message: string) => console.log(`[deploy] ${message}`),
+ });
+
+ if (!deployResult.success) {
+ throw new Error(`Deploy failed: ${deployResult.error?.message}`);
+ }
+
+ const installResult = await appInstall({ appPath: APP_PATH });
+
+ if (!installResult.success) {
+ throw new Error(`Install failed: ${installResult.error?.message}`);
+ }
+ });
+
+ afterAll(async () => {
+ await appUninstall({ appPath: APP_PATH });
+ });
+
+ it('should find the installed app in the workspace', async () => {
+ const metadataClient = new MetadataApiClient();
+
+ const result = await metadataClient.query({
+ findManyApplications: {
+ id: true,
+ name: true,
+ universalIdentifier: true,
+ },
+ });
+
+ const installedApp = result.findManyApplications.find(
+ (app: { universalIdentifier: string }) =>
+ app.universalIdentifier === APPLICATION_UNIVERSAL_IDENTIFIER,
+ );
+
+ expect(installedApp).toBeDefined();
+ });
+});
+```
+
+## Ejecutar pruebas
+
+Asegúrate de que tu servidor local de Twenty esté en ejecución y luego:
+
+```bash filename="Terminal"
+yarn test
+```
+
+O en modo watch durante el desarrollo:
+
+```bash filename="Terminal"
+yarn test:watch
+```
+
+## Comprobación de tipos
+
+También puedes ejecutar la comprobación de tipos en tu aplicación sin ejecutar pruebas:
+
+```bash filename="Terminal"
+yarn twenty dev:typecheck
+```
+
+Esto ejecuta `tsc --noEmit` e informa cualquier error de tipo.
+
+## CI con GitHub Actions
+
+El generador crea un flujo de trabajo de GitHub Actions listo para usar en `.github/workflows/ci.yml`. Ejecuta tus pruebas de integración automáticamente en cada push a `main` y en los pull requests.
+
+El flujo de trabajo:
+
+1. Obtiene tu código
+2. Inicia un servidor temporal de Twenty usando la acción `twentyhq/twenty/.github/actions/spawn-twenty-docker-image`
+3. Instala las dependencias con `yarn install --immutable`
+4. Ejecuta `yarn test` con `TWENTY_API_URL` y `TWENTY_API_KEY` inyectados a partir de las salidas de la acción
+
+```yaml .github/workflows/ci.yml
+name: CI
+
+on:
+ push:
+ branches:
+ - main
+ pull_request: {}
+
+env:
+ TWENTY_VERSION: latest
+
+jobs:
+ test:
+ runs-on: ubuntu-latest
+ steps:
+ - name: Checkout
+ uses: actions/checkout@v4
+
+ - name: Spawn Twenty instance
+ id: twenty
+ uses: twentyhq/twenty/.github/actions/spawn-twenty-docker-image@main
+ with:
+ twenty-version: ${{ env.TWENTY_VERSION }}
+ github-token: ${{ secrets.GITHUB_TOKEN }}
+
+ - name: Enable Corepack
+ run: corepack enable
+
+ - name: Setup Node.js
+ uses: actions/setup-node@v4
+ with:
+ node-version-file: '.nvmrc'
+ cache: 'yarn'
+
+ - name: Install dependencies
+ run: yarn install --immutable
+
+ - name: Run integration tests
+ run: yarn test
+ env:
+ TWENTY_API_URL: ${{ steps.twenty.outputs.server-url }}
+ TWENTY_API_KEY: ${{ steps.twenty.outputs.access-token }}
+```
+
+No necesitas configurar secretos: la acción `spawn-twenty-docker-image` inicia un servidor efímero de Twenty directamente en el runner y devuelve los detalles de conexión. El secreto `GITHUB_TOKEN` lo proporciona GitHub automáticamente.
+
+Para fijar una versión específica de Twenty en lugar de `latest`, cambia la variable de entorno `TWENTY_VERSION` al inicio del flujo de trabajo.
diff --git a/packages/twenty-docs/l/es/developers/extend/capabilities/apis.mdx b/packages/twenty-docs/l/es/developers/extend/capabilities/apis.mdx
index 65f08139df4..5f4f2a53dcf 100644
--- a/packages/twenty-docs/l/es/developers/extend/capabilities/apis.mdx
+++ b/packages/twenty-docs/l/es/developers/extend/capabilities/apis.mdx
@@ -17,7 +17,7 @@ Twenty genera APIs específicamente para tu modelo de datos:
* **Documentación personalizada**: Generada específicamente para el modelo de datos de tu espacio de trabajo.
<Note>
- Tu documentación personalizada de la API está disponible en **Configuración → API & Webhooks** después de crear una clave de API. Como Twenty genera APIs que coinciden con tu modelo de datos personalizado, la documentación es única para tu espacio de trabajo.
+Tu documentación personalizada de la API está disponible en **Configuración → API & Webhooks** después de crear una clave de API. Como Twenty genera APIs que coinciden con tu modelo de datos personalizado, la documentación es única para tu espacio de trabajo.
</Note>
## Los dos tipos de API
@@ -81,14 +81,14 @@ Authorization: Bearer YOUR_API_KEY
<VimeoEmbed videoId="928786722" title="Creación de clave de API" />
<Warning>
- Tu clave de API concede acceso a datos sensibles. No la compartas con servicios no confiables. Si se ve comprometida, desactívala de inmediato y genera una nueva.
+Tu clave de API concede acceso a datos sensibles. No la compartas con servicios no confiables. Si se ve comprometida, desactívala de inmediato y genera una nueva.
</Warning>
### Asignar un rol a una clave de API
Para mayor seguridad, asigna un rol específico para limitar el acceso:
-1. Ve a **Configuración → Roles**
+1. Ve a **Ajustes → Miembros → Roles**
2. Haz clic en el rol que deseas asignar
3. Abre la pestaña **Asignación**
4. En **Claves de API**, haz clic en **+ Asignar a clave de API**
@@ -143,5 +143,5 @@ Las solicitudes a la API se limitan para garantizar la estabilidad de la platafo
| **Tamaño del lote** | 60 registros por llamada |
<Tip>
- Usa operaciones por lotes para maximizar el rendimiento — procesa hasta 60 registros en una sola llamada a la API en lugar de hacer solicitudes individuales.
+Usa operaciones por lotes para maximizar el rendimiento — procesa hasta 60 registros en una sola llamada a la API en lugar de hacer solicitudes individuales.
</Tip>
diff --git a/packages/twenty-docs/l/es/developers/extend/capabilities/webhooks.mdx b/packages/twenty-docs/l/es/developers/extend/capabilities/webhooks.mdx
index aa938bf3227..b4e66c46190 100644
--- a/packages/twenty-docs/l/es/developers/extend/capabilities/webhooks.mdx
+++ b/packages/twenty-docs/l/es/developers/extend/capabilities/webhooks.mdx
@@ -62,7 +62,7 @@ Cada webhook envía una solicitud HTTP POST con un cuerpo JSON:
| `marca de tiempo` | Cuándo ocurrió el evento (UTC) |
<Note>
- Responde con un **estado HTTP 2xx** (200-299) para confirmar la recepción. Las respuestas que no sean 2xx se registran como errores de entrega.
+Responde con un **estado HTTP 2xx** (200-299) para confirmar la recepción. Las respuestas que no sean 2xx se registran como errores de entrega.
</Note>
## Validación de Webhook
diff --git a/packages/twenty-docs/l/es/developers/extend/extend.mdx b/packages/twenty-docs/l/es/developers/extend/extend.mdx
index f6445743ecb..deed9b09890 100644
--- a/packages/twenty-docs/l/es/developers/extend/extend.mdx
+++ b/packages/twenty-docs/l/es/developers/extend/extend.mdx
@@ -1,7 +1,6 @@
---
title: Ampliar
description: Amplía la funcionalidad de Twenty con APIs, webhooks y aplicaciones personalizadas.
-redirect: /developers/introduction
---
<Frame>
@@ -16,20 +15,18 @@ Twenty está diseñado para ser extensible. Usa nuestras APIs, webhooks y el fra
* **APIs**: Consulta y modifica tus datos de CRM de forma programática usando REST o GraphQL
* **Webhooks**: Recibe notificaciones en tiempo real cuando ocurran eventos en Twenty
-* **Aplicaciones**: Crea aplicaciones personalizadas que amplíen las capacidades de Twenty - Próximamente.
+* **Aplicaciones**: Crea aplicaciones personalizadas que amplíen las capacidades de Twenty
## Primeros pasos
<CardGroup cols={2}>
- <Card title="APIs" icon="código" href="/l/es/developers/api">
+ <Card title="APIs" icon="código" href="/l/es/developers/extend/api">
Conéctate a Twenty de forma programática
</Card>
-
- <Card title="Webhooks" icon="bell" href="/l/es/developers/webhooks">
+ <Card title="Webhooks" icon="bell" href="/l/es/developers/extend/webhooks">
Recibe notificaciones de eventos en tiempo real
</Card>
-
- <Card title="Aplicaciones" icon="puzzle-piece" href="/l/es/developers/apps/apps">
- Crea personalizaciones como código (Alpha)
+ <Card title="Aplicaciones" icon="puzzle-piece" href="/l/es/developers/extend/apps/getting-started">
+ Crea personalizaciones como código
</Card>
</CardGroup>
diff --git a/packages/twenty-docs/l/es/developers/extend/oauth.mdx b/packages/twenty-docs/l/es/developers/extend/oauth.mdx
new file mode 100644
index 00000000000..94a8fd8d3b2
--- /dev/null
+++ b/packages/twenty-docs/l/es/developers/extend/oauth.mdx
@@ -0,0 +1,189 @@
+---
+title: OAuth
+icon: clave
+description: Flujo de código de autorización con PKCE y credenciales de cliente para acceso de servidor a servidor.
+---
+
+Twenty implementa OAuth 2.0 con código de autorización + PKCE para aplicaciones orientadas al usuario y credenciales de cliente para acceso de servidor a servidor. Los clientes se registran dinámicamente mediante [RFC 7591](https://datatracker.ietf.org/doc/html/rfc7591) — sin configuración manual en un panel.
+
+## Cuándo usar OAuth
+
+| Escenario | Método de autenticación |
+| ---------------------------------------------------- | ------------------------------------------------------------------------------------------- |
+| Scripts internos, automatización | [Clave de API](/l/es/developers/extend/api#authentication) |
+| Aplicación externa que actúa en nombre de un usuario | **OAuth — Código de autorización** |
+| De servidor a servidor, sin contexto de usuario | **OAuth — Credenciales de cliente** |
+| Aplicación de Twenty con extensiones de UI | [Aplicaciones](/l/es/developers/extend/apps/getting-started) (OAuth se gestiona automáticamente) |
+
+## Registrar un cliente
+
+Twenty admite el **registro dinámico de clientes** según [RFC 7591](https://datatracker.ietf.org/doc/html/rfc7591). No se necesita configuración manual — regístrelo de forma programática:
+
+```bash
+POST /oauth/register
+Content-Type: application/json
+
+{
+ "client_name": "My Integration",
+ "redirect_uris": ["https://myapp.com/callback"],
+ "grant_types": ["authorization_code"],
+ "token_endpoint_auth_method": "client_secret_post"
+}
+```
+
+**Respuesta:**
+
+```json
+{
+ "client_id": "abc123",
+ "client_secret": "secret456",
+ "client_name": "My Integration",
+ "redirect_uris": ["https://myapp.com/callback"]
+}
+```
+
+<Warning>
+Almacene el `client_secret` de forma segura — no se puede recuperar más tarde.
+</Warning>
+
+## Ámbitos
+
+| Ámbito | Acceso |
+| --------- | ----------------------------------------------------------------- |
+| `api` | Acceso completo de lectura/escritura a las API de Core y Metadata |
+| `profile` | Leer la información de perfil del usuario autenticado |
+
+Solicite los ámbitos como una cadena separada por espacios: `scope=api profile`
+
+## Flujo de código de autorización
+
+Use este flujo cuando su aplicación actúe en nombre de un usuario de Twenty.
+
+### 1. Redirija al usuario para autorizar
+
+```
+GET /oauth/authorize?
+ client_id=YOUR_CLIENT_ID&
+ response_type=code&
+ redirect_uri=https://myapp.com/callback&
+ scope=api&
+ state=random_state_value&
+ code_challenge=CHALLENGE&
+ code_challenge_method=S256
+```
+
+| Parámetro | Obligatorio | Descripción |
+| ----------------------- | ----------- | -------------------------------------------------------------------- |
+| `client_id` | Sí | Su ID de cliente registrado |
+| `response_type` | Sí | Debe ser `code` |
+| `redirect_uri` | Sí | Debe coincidir con un URI de redirección registrado |
+| `scope` | No | Ámbitos separados por espacios (valor predeterminado: `api`) |
+| `state` | Recomendado | Cadena aleatoria para evitar ataques CSRF |
+| `code_challenge` | Recomendado | Desafío PKCE (hash SHA-256 del verificador, codificado en base64url) |
+| `code_challenge_method` | Recomendado | Debe ser `S256` al usar PKCE |
+
+El usuario ve una pantalla de consentimiento y aprueba o deniega el acceso.
+
+### 2. Gestione el callback
+
+Tras la autorización, Twenty redirige de vuelta a su `redirect_uri`:
+
+```
+https://myapp.com/callback?code=AUTH_CODE&state=random_state_value
+```
+
+Verifique que `state` coincida con lo que envió.
+
+### 3. Intercambie el código por tokens
+
+```bash
+POST /oauth/token
+Content-Type: application/x-www-form-urlencoded
+
+grant_type=authorization_code&
+code=AUTH_CODE&
+redirect_uri=https://myapp.com/callback&
+client_id=YOUR_CLIENT_ID&
+client_secret=YOUR_CLIENT_SECRET&
+code_verifier=YOUR_PKCE_VERIFIER
+```
+
+**Respuesta:**
+
+```json
+{
+ "access_token": "eyJhbG...",
+ "token_type": "Bearer",
+ "expires_in": 3600,
+ "refresh_token": "dGhpcyBpcyBh..."
+}
+```
+
+### 4. Use el token de acceso
+
+```bash
+GET /rest/companies
+Authorization: Bearer ACCESS_TOKEN
+```
+
+### 5. Actualice cuando caduque
+
+```bash
+POST /oauth/token
+Content-Type: application/x-www-form-urlencoded
+
+grant_type=refresh_token&
+refresh_token=YOUR_REFRESH_TOKEN&
+client_id=YOUR_CLIENT_ID&
+client_secret=YOUR_CLIENT_SECRET
+```
+
+## Flujo de credenciales de cliente
+
+Para integraciones de servidor a servidor sin interacción del usuario:
+
+```bash
+POST /oauth/token
+Content-Type: application/x-www-form-urlencoded
+
+grant_type=client_credentials&
+client_id=YOUR_CLIENT_ID&
+client_secret=YOUR_CLIENT_SECRET&
+scope=api
+```
+
+El token devuelto tiene acceso a nivel de espacio de trabajo, no está vinculado a ningún usuario específico.
+
+## Descubrimiento del servidor
+
+Twenty publica su configuración de OAuth en un endpoint de descubrimiento estándar:
+
+```
+GET /.well-known/oauth-authorization-server
+```
+
+Esto devuelve todos los endpoints, los tipos de concesión compatibles, los ámbitos y las capacidades — útil para crear clientes OAuth genéricos.
+
+## Resumen de Puntos de Acceso de API
+
+| Endpoint | Propósito |
+| ----------------------------------------- | ---------------------------------------- |
+| `/.well-known/oauth-authorization-server` | Descubrimiento de metadatos del servidor |
+| `/oauth/register` | Registro dinámico de clientes |
+| `/oauth/authorize` | Autorización del usuario |
+| `/oauth/token` | Intercambio y renovación de tokens |
+
+| Entorno | URL base |
+| ------------------- | ------------------------ |
+| **Nube** | `https://api.twenty.com` |
+| **Autoalojamiento** | `https://{your-domain}` |
+
+## OAuth frente a claves de API
+
+| | Claves API | OAuth |
+| ------------------------ | --------------------------------------- | ------------------------------------------------- |
+| **Configuración** | Generar en Ajustes | Registrar un cliente, implementar el flujo |
+| **Contexto del usuario** | Ninguno (a nivel de espacio de trabajo) | Permisos de un usuario específico |
+| **Ideal para** | Scripts, herramientas internas | Aplicaciones externas, integraciones multiusuario |
+| **Rotación de tokens** | Manual | Automática mediante tokens de actualización |
+| **Acceso con ámbitos** | Acceso completo a la API | Granular mediante ámbitos |
diff --git a/packages/twenty-docs/l/es/developers/extend/webhooks.mdx b/packages/twenty-docs/l/es/developers/extend/webhooks.mdx
new file mode 100644
index 00000000000..7126f9a7900
--- /dev/null
+++ b/packages/twenty-docs/l/es/developers/extend/webhooks.mdx
@@ -0,0 +1,117 @@
+---
+title: Webhooks
+icon: satellite-dish
+description: Recibe notificaciones cuando los registros cambien — HTTP POST a tu endpoint en cada creación, actualización o eliminación.
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+Twenty envía un HTTP POST a tu URL cada vez que se crea, actualiza o elimina un registro. Todos los tipos de objetos están cubiertos, incluidos los objetos personalizados.
+
+## Crear un webhook
+
+1. Ve a **Configuración → APIs y Webhooks → Webhooks**
+2. Haz clic en **+ Crear webhook**
+3. Introduce la URL de tu webhook (debe ser públicamente accesible)
+4. Haz clic en **Guardar**
+
+El webhook se activa de inmediato y comienza a enviar notificaciones.
+
+<VimeoEmbed videoId="928786708" title="Crear un webhook" />
+
+### Gestionar webhooks
+
+**Editar**: Haz clic en el webhook → Actualizar la URL → **Guardar**
+
+**Eliminar**: Haz clic en el webhook → **Eliminar** → Confirmar
+
+## Eventos
+
+Twenty envía webhooks para estos tipos de eventos:
+
+| Evento | Ejemplo |
+| ---------------------------- | ---------------------------------------------------------- |
+| **Se crea un registro** | `person.created`, `company.created`, `note.created` |
+| **Se actualiza un registro** | `person.updated`, `company.updated`, `opportunity.updated` |
+| **Se elimina un registro** | `person.deleted`, `company.deleted` |
+
+Todos los tipos de eventos se envían a la URL de tu webhook. Es posible que se agregue el filtrado de eventos en versiones futuras.
+
+## Formato de la carga útil
+
+Cada webhook envía una solicitud HTTP POST con un cuerpo JSON:
+
+```json
+{
+ "event": "person.created",
+ "data": {
+ "id": "abc12345",
+ "firstName": "Alice",
+ "lastName": "Doe",
+ "email": "[email protected]",
+ "createdAt": "2025-02-10T15:30:45Z",
+ "createdBy": "user_123"
+ },
+ "timestamp": "2025-02-10T15:30:50Z"
+}
+```
+
+| Campo | Descripción |
+| ----------- | -------------------------------------------------- |
+| `event` | Qué ocurrió (p. ej., `person.created`) |
+| `data` | El registro completo que se creó/actualizó/eliminó |
+| `timestamp` | Cuándo ocurrió el evento (UTC) |
+
+<Note>
+Responde con un **estado HTTP 2xx** (200-299) para confirmar la recepción. Las respuestas que no sean 2xx se registran como errores de entrega.
+</Note>
+
+## Validación de webhook
+
+Twenty firma cada solicitud de webhook por seguridad. Valida las firmas para garantizar que las solicitudes sean auténticas.
+
+### Encabezados
+
+| Encabezado | Descripción |
+| ---------------------------- | ------------------------------- |
+| `X-Twenty-Webhook-Signature` | Firma HMAC SHA256 |
+| `X-Twenty-Webhook-Timestamp` | Marca de tiempo de la solicitud |
+
+### Pasos de validación
+
+1. Obtén la marca de tiempo de `X-Twenty-Webhook-Timestamp`
+2. Crea la cadena: `{timestamp}:{JSON payload}`
+3. Calcula HMAC SHA256 usando tu secreto de webhook
+4. Compara con `X-Twenty-Webhook-Signature`
+
+### Ejemplo (Node.js)
+
+```javascript
+const crypto = require("crypto");
+
+const timestamp = req.headers["x-twenty-webhook-timestamp"];
+const payload = JSON.stringify(req.body);
+const secret = "your-webhook-secret";
+
+const stringToSign = `${timestamp}:${payload}`;
+const expectedSignature = crypto
+ .createHmac("sha256", secret)
+ .update(stringToSign)
+ .digest("hex");
+
+const receivedSignature = req.headers["x-twenty-webhook-signature"];
+const isValid = crypto.timingSafeEqual(
+ Buffer.from(expectedSignature, "hex"),
+ Buffer.from(receivedSignature, "hex")
+);
+```
+
+## Webhooks vs flujos de trabajo
+
+| Método | Dirección | Caso de uso |
+| --------------------------------------------- | --------- | --------------------------------------------------------------------------------- |
+| **Webhooks** | SALIDA | Notificar automáticamente a los sistemas externos cualquier cambio en un registro |
+| **Flujo de trabajo + solicitud HTTP** | SALIDA | Enviar datos con lógica personalizada (filtros, transformaciones) |
+| **Disparador de webhook de flujo de trabajo** | ENTRADA | Recibir datos en Twenty desde sistemas externos |
+
+Para recibir datos externos, consulta [Configurar un disparador de webhook](/l/es/user-guide/workflows/how-tos/connect-to-other-tools/set-up-a-webhook-trigger).
diff --git a/packages/twenty-docs/l/es/developers/introduction.mdx b/packages/twenty-docs/l/es/developers/introduction.mdx
index 9cfad10e099..6374b1ef3a6 100644
--- a/packages/twenty-docs/l/es/developers/introduction.mdx
+++ b/packages/twenty-docs/l/es/developers/introduction.mdx
@@ -1,33 +1,28 @@
---
-title: Primeros pasos
-description: Bienvenido a la documentación para desarrolladores de Twenty, tus recursos para ampliar, autoalojar y contribuir a Twenty.
+title: Desarrolladores
+description: Crea aplicaciones, usa la API, aloja por tu cuenta o contribuye a la base de código.
---
import { CardTitle } from "/snippets/card-title.mdx"
-<CardGroup cols={2}>
- <Card href="/l/es/developers/api" icon="code">
- <CardTitle>API</CardTitle>
- Consulta y modifica los datos de tu CRM con REST o GraphQL.
- </Card>
-
- <Card href="/l/es/developers/webhooks" icon="bell">
- <CardTitle>Webhooks</CardTitle>
- Recibe notificaciones en tiempo real cuando ocurran eventos.
+<CardGroup cols={3}>
+ <Card href="/l/es/developers/extend/apps/getting-started" img="/images/user-guide/halftone/dev-apps.png">
+ <CardTitle>Aplicaciones</CardTitle>
+ Amplía Twenty con objetos personalizados, lógica del lado del servidor, componentes de IU y agentes de IA — todo como paquetes de TypeScript.
</Card>
- <Card href="/l/es/developers/apps/apps" icon="puzzle-piece">
- <CardTitle>Apps</CardTitle>
- Crea aplicaciones personalizadas que amplíen las capacidades de Twenty.
+ <Card href="/l/es/developers/extend/api" img="/images/user-guide/halftone/dev-api.png">
+ <CardTitle>API</CardTitle>
+ APIs REST y GraphQL, ganchos web y OAuth.
</Card>
- <Card href="/l/es/developers/self-host/self-host" icon="desktop">
+ <Card href="/l/es/developers/self-host/capabilities/docker-compose" img="/images/user-guide/halftone/dev-self-host.png">
<CardTitle>Autoalojar</CardTitle>
- Despliega y administra Twenty en tu propia infraestructura.
+ Ejecuta Twenty en tu propia infraestructura.
</Card>
- <Card href="/l/es/developers/contribute/contribute" icon="github">
+ <Card href="/l/es/developers/contribute/capabilities/local-setup" img="/images/user-guide/halftone/dev-contribute.png">
<CardTitle>Contribuir</CardTitle>
- Únete a nuestra comunidad de código abierto y contribuye a Twenty.
+ Configura el monorepo localmente y envía PRs.
</Card>
</CardGroup>
diff --git a/packages/twenty-docs/l/es/developers/self-host/capabilities/docker-compose.mdx b/packages/twenty-docs/l/es/developers/self-host/capabilities/docker-compose.mdx
index 538160baade..204092cb161 100644
--- a/packages/twenty-docs/l/es/developers/self-host/capabilities/docker-compose.mdx
+++ b/packages/twenty-docs/l/es/developers/self-host/capabilities/docker-compose.mdx
@@ -1,9 +1,10 @@
---
-title: 1-Clic con Docker Compose
+title: Docker Compose
+icon: docker
---
<Warning>
- Los contenedores de Docker son para alojamiento en producción o autoalojamiento, para la contribución por favor revise la [Configuración Local](/l/es/developers/contribute/capabilities/local-setup).
+Los contenedores de Docker son para alojamiento en producción o autoalojamiento. Para contribuir, consulta la [Configuración local](/l/es/developers/contribute/capabilities/local-setup).
</Warning>
## Resumen
@@ -12,7 +13,7 @@ Esta guía proporciona instrucciones paso a paso para instalar y configurar la a
**Importante:** Solo modifica configuraciones explícitamente mencionadas en esta guía. Alterar otras configuraciones puede causar problemas.
-Consulta los documentos [Configurar Variables de Entorno](/l/es/developers/self-host/capabilities/setup) para configuraciones avanzadas. Todas las variables de entorno deben ser declaradas en el archivo docker-compose.yml en el nivel del servidor y/o trabajador dependiendo de la variable.
+Consulta [Configurar variables de entorno](/l/es/developers/self-host/capabilities/setup) para configuraciones avanzadas. Todas las variables de entorno deben declararse en el archivo `docker-compose.yml` a nivel de servidor y/o trabajador, dependiendo de la variable.
## Requisitos del sistema
@@ -50,7 +51,7 @@ Sigue estos pasos para una configuración manual.
curl -o .env https://raw.githubusercontent.com/twentyhq/twenty/refs/heads/main/packages/twenty-docker/.env.example
```
-2. **Generar tokens secretos**
+2. **Generar una clave de cifrado**
Ejecuta el siguiente comando para generar una cadena única aleatoria:
@@ -58,16 +59,18 @@ Sigue estos pasos para una configuración manual.
openssl rand -base64 32
```
- **Importante:** Mantén este valor en secreto / no lo compartas.
+ **Importante:** Mantén este valor en secreto / no lo compartas. Perder `ENCRYPTION_KEY` significa perder el acceso a todos los secretos almacenados en la base de datos (tokens OAuth, variables de la aplicación, secretos TOTP, etc.).
3. **Actualiza el `.env`**
Reemplaza el valor de marcador de posición en tu archivo .env con el token generado:
```ini
- APP_SECRET=first_random_string
+ ENCRYPTION_KEY=random_string
```
+ Consulta la [guía de rotación de claves](/l/es/developers/self-host/capabilities/key-rotation) para obtener instrucciones sobre cómo rotarla sin tiempo de inactividad.
+
4. **Establecer la contraseña de Postgres**
Actualiza el valor de `PG_DATABASE_PASSWORD` en el archivo .env con una contraseña fuerte sin caracteres especiales.
diff --git a/packages/twenty-docs/l/es/developers/self-host/capabilities/key-rotation.mdx b/packages/twenty-docs/l/es/developers/self-host/capabilities/key-rotation.mdx
new file mode 100644
index 00000000000..4e0df528685
--- /dev/null
+++ b/packages/twenty-docs/l/es/developers/self-host/capabilities/key-rotation.mdx
@@ -0,0 +1,60 @@
+---
+title: Rotación de claves
+icon: rotate
+---
+
+Twenty tiene dos familias de claves independientes:
+
+* **Claves de firma JWT** — pares de claves asimétricas ES256 (etiquetados con `kid`) almacenados en `core."signingKey"`, utilizados para firmar y verificar tokens de acceso/renovación.
+* **Clave de cifrado en reposo** — `ENCRYPTION_KEY`, se usa para cifrar tokens OAuth, variables de la aplicación, claves privadas de las claves de firma, valores de configuración confidenciales y secretos TOTP dentro de un sobre `enc:v2:`.
+
+`APP_SECRET` es un secreto heredado mantenido para compatibilidad retroactiva: cuando `ENCRYPTION_KEY` no está definido actúa como el cifrado en reposo / alternativa para la cookie de sesión, y todavía verifica los tokens de acceso HS256 preexistentes. Quedará obsoleto.
+
+## Claves de firma JWT
+
+Cada clave contiene una `publicKey` (conservada indefinidamente para poder verificar los tokens emitidos anteriormente), una `privateKey` cifrada (usada solo mientras la clave sea la actual), un indicador `isCurrent` (exactamente una fila a la vez) y un `revokedAt` opcional.
+
+### Rotar la clave actual
+
+Establece `SIGNING_KEY_ROTATION_DAYS` para habilitarlo: un cron diario emite una nueva clave actual cuando la existente es más antigua que ese umbral. Las claves anteriores *no* se revocan, por lo que los tokens firmados con ellas siguen verificándose. Deja la variable sin configurar para desactivar la rotación automática.
+
+<Note>La rotación automática se incluye a partir de la versión v2.6+.</Note>
+
+### Revocar una clave (solo en caso de filtración / emergencia)
+
+**Settings → Admin Panel → Signing keys → Revoke** en una fila que no sea la actual. Borra el material privado cifrado, establece `revokedAt` y rechaza todos los tokens existentes firmados con ese `kid`.
+
+## Rotar `ENCRYPTION_KEY`
+
+<Note>El comando `secret-encryption:rotate` descrito a continuación se incluye a partir de la versión v2.6+.</Note>
+
+Cada valor cifrado se encapsula como `enc:v2:\<keyId>:\<payload>`, donde `\<keyId>` es un prefijo hexadecimal de 8 caracteres derivado de la clave en bruto. La rotación es en línea y reanudable.
+
+1. **Generar una nueva clave**: `openssl rand -base64 32`.
+
+2. **Configurar ambas claves en paralelo** en `.env`, luego reinicie:
+ ```ini
+ ENCRYPTION_KEY=NEW_VALUE
+ FALLBACK_ENCRYPTION_KEY=OLD_VALUE
+ ```
+ Las nuevas escrituras usan la nueva clave, las filas existentes todavía se descifran mediante la clave de respaldo.
+
+3. **Volver a cifrar las filas existentes**:
+
+ ```bash
+ docker exec -it {server_container} yarn command:prod secret-encryption:rotate
+ ```
+
+ El comando recorre seis sitios (`connected-account-tokens`, `application-variable`, `application-registration-variable`, `signing-key-private-keys`, `sensitive-config-storage`, `totp-secrets`). Un filtro SQL omite las filas que ya están en el nuevo `\<keyId>`, por lo que el comando es idempotente: interrúmpalo y vuelva a ejecutarlo según sea necesario. Finaliza con código distinto de cero si falla alguna fila; vuelva a ejecutar para reintentar.
+
+ | Opción | Descripción |
+ | ---------------------------------------- | ----------------------------------------------------------- |
+ | `-s, --site \<site>` | Limitar a un solo sitio. |
+ | `-b, --batch-size \<n>` | Filas por lote (predeterminado `200`, máximo `5000`). |
+ | `-d, --dry-run` | Descifrar + volver a cifrar en memoria, omitir el `UPDATE`. |
+
+4. **Elimine la clave de respaldo** una vez que `--dry-run` muestre cero filas restantes: quite `FALLBACK_ENCRYPTION_KEY` y reinicie.
+
+## Compatibilidad heredada con `APP_SECRET`
+
+Las instancias más antiguas que nunca configuraron `ENCRYPTION_KEY` usan `APP_SECRET` como la clave de cifrado en reposo (y como el secreto de la cookie de sesión, derivado de esta). Esta ruta se conserva por compatibilidad retroactiva, pero está **en desuso**: configure una `ENCRYPTION_KEY` dedicada y siga el procedimiento de rotación anterior para migrar y dejar de usarla. El propio `APP_SECRET` sigue utilizándose para verificar tokens de acceso HS256 heredados.
diff --git a/packages/twenty-docs/l/es/developers/self-host/capabilities/setup.mdx b/packages/twenty-docs/l/es/developers/self-host/capabilities/setup.mdx
index 20ca962fed5..a7688598418 100644
--- a/packages/twenty-docs/l/es/developers/self-host/capabilities/setup.mdx
+++ b/packages/twenty-docs/l/es/developers/self-host/capabilities/setup.mdx
@@ -1,11 +1,12 @@
---
title: Configuración
+icon: engranaje
---
# Gestión de Configuración
<Warning>
- **¿Instalando por primera vez?** Siga la [guía de instalación de Docker Compose](/l/es/developers/self-host/capabilities/docker-compose) para ejecutar Twenty, luego regrese aquí para la configuración.
+**¿Instalando por primera vez?** Siga la [guía de instalación de Docker Compose](/l/es/developers/self-host/capabilities/docker-compose) para ejecutar Twenty, luego regrese aquí para la configuración.
</Warning>
Twenty ofrece **dos modos de configuración** para adaptarse a diferentes necesidades de implementación:
@@ -26,7 +27,7 @@ IS_CONFIG_VARIABLES_IN_DB_ENABLED=true # default
4. Los cambios se aplican inmediatamente (dentro de 15 segundos para implementaciones multicontenedor)
<Warning>
- **Implementaciones Multicontenedor:** Al usar la configuración de base de datos (`IS_CONFIG_VARIABLES_IN_DB_ENABLED=true`), tanto los contenedores del servidor como los de trabajo leen de la misma base de datos. Los cambios en el panel de administración afectan a ambos automáticamente, eliminando la necesidad de duplicar las variables de entorno entre contenedores (excepto para las variables de infraestructura).
+**Implementaciones Multicontenedor:** Al usar la configuración de base de datos (`IS_CONFIG_VARIABLES_IN_DB_ENABLED=true`), tanto los contenedores del servidor como los de trabajo leen de la misma base de datos. Los cambios en el panel de administración afectan a ambos automáticamente, eliminando la necesidad de duplicar las variables de entorno entre contenedores (excepto para las variables de infraestructura).
</Warning>
**Qué se puede configurar a través del panel de administración:**
@@ -41,12 +42,27 @@ IS_CONFIG_VARIABLES_IN_DB_ENABLED=true # default
![Variables de Configuración del Panel de Administración](/images/user-guide/setup/admin-panel-config-variables.png)
<Warning>
- Cada variable está documentada con descripciones en su panel de administración en **Configuración → Panel de Administración → Variables de Configuración**.
- Algunas configuraciones de infraestructura como las conexiones de base de datos (`PG_DATABASE_URL`), URLs del servidor (`SERVER_URL`), y secretos de la aplicación (`APP_SECRET`) solo se pueden configurar a través del archivo `.env`.
+Cada variable está documentada con descripciones en su panel de administración en **Configuración → Panel de Administración → Variables de Configuración**.
+Algunas configuraciones de infraestructura como las conexiones de base de datos (`PG_DATABASE_URL`), URLs del servidor (`SERVER_URL`), y secretos (`ENCRYPTION_KEY`, `FALLBACK_ENCRYPTION_KEY`) solo se pueden configurar a través del archivo `.env`.
- [Referencia técnica completa →](https://github.com/twentyhq/twenty/blob/main/packages/twenty-server/src/engine/core-modules/twenty-config/config-variables.ts)
+[Referencia técnica completa →](https://github.com/twentyhq/twenty/blob/main/packages/twenty-server/src/engine/core-modules/twenty-config/config-variables.ts)
</Warning>
+## Claves de cifrado
+
+Twenty utiliza dos claves de cifrado definidas únicamente mediante variables de entorno:
+
+| Variable | Propósito | Obligatorio |
+| ------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- |
+| `ENCRYPTION_KEY` | Clave principal utilizada para cifrar secretos en reposo (tokens OAuth, variables de la aplicación, claves privadas de firma, secretos TOTP, valores de configuración confidenciales). | Sí para nuevas instalaciones (las instalaciones heredadas pueden en su lugar depender de `APP_SECRET` — ver más abajo) |
+| `FALLBACK_ENCRYPTION_KEY` | Clave solo para verificación. Se establece durante una rotación como la *anterior* `ENCRYPTION_KEY` para que las filas existentes sigan siendo descifrables. | Solo durante la rotación |
+
+Para mantener la compatibilidad con versiones anteriores, si `ENCRYPTION_KEY` no está definida, Twenty recurre a `APP_SECRET` para el cifrado en reposo, lo que coincide con el comportamiento heredado de implementaciones más antiguas. Las nuevas instalaciones siempre deben establecer una `ENCRYPTION_KEY` dedicada.
+
+Genera valores con `openssl rand -base64 32` y guárdalos en un lugar seguro (un gestor de secretos, configuración sellada, etc.). Perder la `ENCRYPTION_KEY` significa perder el acceso a todos los secretos almacenados en la base de datos.
+
+Para rotar `ENCRYPTION_KEY` sin tiempo de inactividad, consulta la [Guía de rotación de claves](/l/es/developers/self-host/capabilities/key-rotation).
+
## 2. Configuración Solo de Entorno
```bash
@@ -93,7 +109,7 @@ Habilita el modo de múltiples espacios de trabajo para implementaciones tipo Sa
* Configuraciones específicas del espacio de trabajo, como subdominio y dominio personalizado, están disponibles en la configuración del espacio de trabajo
<Warning>
- **Configuración solo por entorno:** `IS_MULTIWORKSPACE_ENABLED` solo se puede configurar mediante el archivo `.env` y requiere un reinicio. No se puede cambiar a través del panel de administración.
+**Configuración solo por entorno:** `IS_MULTIWORKSPACE_ENABLED` solo se puede configurar mediante el archivo `.env` y requiere un reinicio. No se puede cambiar a través del panel de administración.
</Warning>
### Configuración de DNS para múltiples espacios de trabajo
@@ -149,7 +165,7 @@ Cuando está habilitado, solo los usuarios con `canAccessFullAdminPanel` pueden
* `AUTH_GOOGLE_APIS_CALLBACK_URL=https://{your-domain}/auth/google-apis/get-access-token`
<Warning>
- **Modo solo de entorno:** Si establece `IS_CONFIG_VARIABLES_IN_DB_ENABLED=false`, agregue estas variables a su archivo `.env` en su lugar.
+**Modo solo de entorno:** Si establece `IS_CONFIG_VARIABLES_IN_DB_ENABLED=false`, agregue estas variables a su archivo `.env` en su lugar.
</Warning>
**Ámbitos requeridos** (configurados automáticamente):
@@ -168,7 +184,7 @@ En [Pantalla de consentimiento OAuth](https://console.cloud.google.com/apis/cred
## Integración con Microsoft 365
<Warning>
- Los usuarios deben tener una [licencia de Microsoft 365](https://admin.microsoft.com/Adminportal/Home) para poder usar la API de Calendar y Messaging. No podrán sincronizar su cuenta en Twenty sin una.
+Los usuarios deben tener una [licencia de Microsoft 365](https://admin.microsoft.com/Adminportal/Home) para poder usar la API de Calendar y Messaging. No podrán sincronizar su cuenta en Twenty sin una.
</Warning>
### Cree un proyecto en Microsoft Azure
@@ -211,7 +227,7 @@ Necesita agregar las siguientes URIs de redirección a su proyecto:
* `AUTH_MICROSOFT_APIS_CALLBACK_URL=https://{your-domain}/auth/microsoft-apis/get-access-token`
<Warning>
- **Modo solo de entorno:** Si establece `IS_CONFIG_VARIABLES_IN_DB_ENABLED=false`, agregue estas variables a su archivo `.env` en su lugar.
+**Modo solo de entorno:** Si establece `IS_CONFIG_VARIABLES_IN_DB_ENABLED=false`, agregue estas variables a su archivo `.env` en su lugar.
</Warning>
### Configurar ámbitos
@@ -256,82 +272,111 @@ yarn command:prod cron:workflow:automated-cron-trigger
3. Configure su configuración SMTP:
<ArticleTabs label1="Gmail" label2="Office365" label3="Smtp4dev">
+
<ArticleTab>
- Necesitará proporcionar una [Contraseña de Aplicación](https://support.google.com/accounts/answer/185833).
- * EMAIL_DRIVER=smtp
- * EMAIL_SMTP_HOST=smtp.gmail.com
- * EMAIL_SMTP_PORT=465
- * EMAIL_SMTP_USER=gmail_email_address
- * EMAIL_SMTP_PASSWORD='gmail_app_password'
+ Necesitará proporcionar una [Contraseña de Aplicación](https://support.google.com/accounts/answer/185833).
+ * EMAIL_DRIVER=smtp
+ * EMAIL_SMTP_HOST=smtp.gmail.com
+ * EMAIL_SMTP_PORT=465
+ * EMAIL_SMTP_USER=gmail_email_address
+ * EMAIL_SMTP_PASSWORD='gmail_app_password'
+
</ArticleTab>
<ArticleTab>
- Tenga en cuenta que si tiene la autenticación de dos factores habilitada, necesitará proporcionar una [Contraseña de Aplicación](https://support.microsoft.com/en-us/account-billing/manage-app-passwords-for-two-step-verification-d6dc8c6d-4bf7-4851-ad95-6d07799387e9).
- * EMAIL_DRIVER=smtp
- * EMAIL_SMTP_HOST=smtp.office365.com
- * EMAIL_SMTP_PORT=587
- * EMAIL_SMTP_USER=office365_email_address
- * EMAIL_SMTP_PASSWORD='office365_password'
+ Tenga en cuenta que si tiene la autenticación de dos factores habilitada, necesitará proporcionar una [Contraseña de Aplicación](https://support.microsoft.com/en-us/account-billing/manage-app-passwords-for-two-step-verification-d6dc8c6d-4bf7-4851-ad95-6d07799387e9).
+ * EMAIL_DRIVER=smtp
+ * EMAIL_SMTP_HOST=smtp.office365.com
+ * EMAIL_SMTP_PORT=587
+ * EMAIL_SMTP_USER=office365_email_address
+ * EMAIL_SMTP_PASSWORD='office365_password'
+
</ArticleTab>
<ArticleTab>
- **smtp4dev** es un servidor de correo SMTP falso para desarrollo y pruebas.
-
- * Ejecute la imagen de smtp4dev: `docker run --rm -it -p 8090:80 -p 2525:25 rnwood/smtp4dev`
- * Acceda a la interfaz de smtp4dev aquí: [http://localhost:8090](http://localhost:8090)
- * Establezca las siguientes variables:
- * EMAIL_DRIVER=smtp
- * EMAIL_SMTP_HOST=localhost
- * EMAIL_SMTP_PORT=2525
+
+ **smtp4dev** es un servidor de correo SMTP falso para desarrollo y pruebas.
+ * Ejecute la imagen de smtp4dev: `docker run --rm -it -p 8090:80 -p 2525:25 rnwood/smtp4dev`
+ * Acceda a la interfaz de smtp4dev aquí: [http://localhost:8090](http://localhost:8090)
+ * Establezca las siguientes variables:
+ * EMAIL_DRIVER=smtp
+ * EMAIL_SMTP_HOST=localhost
+ * EMAIL_SMTP_PORT=2525
+
</ArticleTab>
+
</ArticleTabs>
<Warning>
- **Modo solo de entorno:** Si establece `IS_CONFIG_VARIABLES_IN_DB_ENABLED=false`, agregue estas variables a su archivo `.env` en su lugar.
+**Modo solo de entorno:** Si establece `IS_CONFIG_VARIABLES_IN_DB_ENABLED=false`, agregue estas variables a su archivo `.env` en su lugar.
</Warning>
-## Funciones de lógica
+## Almacenamiento de S3
+
+<Warning>
+De forma predeterminada, Twenty almacena los archivos cargados en el sistema de archivos local. Para implementaciones en producción, usa S3 o un servicio compatible con S3 (MinIO, DigitalOcean Spaces, etc.). para garantizar que los archivos persistan tras los reinicios de los contenedores y escalen en varias instancias de servidor.
+</Warning>
+
+Establece `STORAGE_TYPE=S_3` y configura las variables `STORAGE_S3_*` a través del panel de administración o `.env`. Consulta la [referencia de config-variables.ts](https://github.com/twentyhq/twenty/blob/main/packages/twenty-server/src/engine/core-modules/twenty-config/config-variables.ts) para ver la lista completa de variables de S3.
+
+Al usar S3 con funciones que dependen de CORS (p. ej., descargas de archivos en el navegador), asegúrate de que tu bucket permita el origen de tu frontend de Twenty en su configuración de CORS.
-Twenty admite funciones de lógica para flujos de trabajo y lógica personalizada. El entorno de ejecución se configura mediante la variable de entorno `SERVERLESS_TYPE`.
+## Funciones de lógica e intérprete de código
+
+Twenty admite funciones de lógica para flujos de trabajo y el intérprete de código para el análisis de datos con IA. Ambos ejecutan código proporcionado por el usuario y requieren una configuración explícita por motivos de seguridad.
+
+### Valores Predeterminados de Seguridad
+
+**En producción (NODE_ENV=production):** Tanto las funciones de lógica como el intérprete de código tienen como valor predeterminado **Desactivado**. Debes habilitarlos explícitamente con `LOGIC_FUNCTION_TYPE` y `CODE_INTERPRETER_TYPE` si necesitas estas funciones.
+
+**En desarrollo (NODE_ENV=development):** Ambos usan **LOCAL** de forma predeterminada para mayor comodidad al ejecutarse localmente.
<Warning>
- **Aviso de seguridad:** El controlador local (`SERVERLESS_TYPE=LOCAL`) ejecuta código directamente en el host en un proceso de Node.js sin aislamiento. Solo debe utilizarse para código de confianza en desarrollo. Para implementaciones de producción que manejen código no confiable, recomendamos encarecidamente usar `SERVERLESS_TYPE=LAMBDA` o `SERVERLESS_TYPE=DISABLED`.
+**Aviso de seguridad:** El controlador local (`LOGIC_FUNCTION_TYPE=LOCAL` o `CODE_INTERPRETER_TYPE=LOCAL`) ejecuta código directamente en el host en un proceso de Node.js sin aislamiento. Solo debe utilizarse para código de confianza en desarrollo. Para implementaciones de producción que manejen código no confiable, use `LOGIC_FUNCTION_TYPE=LAMBDA` o `CODE_INTERPRETER_TYPE=E2B` (con sandboxing), o manténgalos deshabilitados.
</Warning>
-### Controladores disponibles
+### Funciones de lógica - Controladores disponibles
-| Controlador | Variable de entorno | Caso de uso | Nivel de seguridad |
-| ----------- | -------------------------- | ------------------------------------------------ | -------------------------------------- |
-| Desactivado | `SERVERLESS_TYPE=DISABLED` | Desactivar completamente las funciones de lógica | N/A |
-| Local | `SERVERLESS_TYPE=LOCAL` | Entornos de desarrollo y de confianza | Bajo (sin aislamiento) |
-| Lambda | `SERVERLESS_TYPE=LAMBDA` | Producción con código no confiable | Alto (aislamiento a nivel de hardware) |
+| Controlador | Variable de entorno | Caso de uso | Nivel de seguridad |
+| ----------- | ------------------------------ | ------------------------------------------------ | -------------------------------------- |
+| Desactivado | `LOGIC_FUNCTION_TYPE=DISABLED` | Desactivar completamente las funciones de lógica | N/A |
+| Local | `LOGIC_FUNCTION_TYPE=LOCAL` | Entornos de desarrollo y de confianza | Bajo (sin aislamiento) |
+| Lambda | `LOGIC_FUNCTION_TYPE=LAMBDA` | Producción con código no confiable | Alto (aislamiento a nivel de hardware) |
-### Configuración recomendada
+### Funciones de lógica - Configuración recomendada
**Para desarrollo:**
```bash
-SERVERLESS_TYPE=LOCAL # default
+LOGIC_FUNCTION_TYPE=LOCAL # default when NODE_ENV=development
```
**Para producción (AWS):**
```bash
-SERVERLESS_TYPE=LAMBDA
-SERVERLESS_LAMBDA_REGION=us-east-1
-SERVERLESS_LAMBDA_ROLE=arn:aws:iam::123456789:role/your-lambda-role
-SERVERLESS_LAMBDA_ACCESS_KEY_ID=your-access-key
-SERVERLESS_LAMBDA_SECRET_ACCESS_KEY=your-secret-key
+LOGIC_FUNCTION_TYPE=LAMBDA
+LOGIC_FUNCTION_LAMBDA_REGION=us-east-1
+LOGIC_FUNCTION_LAMBDA_ROLE=arn:aws:iam::123456789:role/your-lambda-role
+LOGIC_FUNCTION_LAMBDA_ACCESS_KEY_ID=your-access-key
+LOGIC_FUNCTION_LAMBDA_SECRET_ACCESS_KEY=your-secret-key
```
**Para desactivar las funciones de lógica:**
```bash
-SERVERLESS_TYPE=DISABLED
+LOGIC_FUNCTION_TYPE=DISABLED # default when NODE_ENV=production
```
+### Intérprete de código - Controladores disponibles
+
+| Controlador | Variable de entorno | Caso de uso | Nivel de seguridad |
+| ----------- | -------------------------------- | ----------------------------------------- | ---------------------- |
+| Desactivado | `CODE_INTERPRETER_TYPE=DISABLED` | Deshabilitar la ejecución de código de IA | N/A |
+| Local | `CODE_INTERPRETER_TYPE=LOCAL` | Solo para desarrollo | Bajo (sin aislamiento) |
+| E2B | `CODE_INTERPRETER_TYPE=E_2_B` | Producción con ejecución en sandbox | Alta (sandbox aislado) |
+
<Note>
- Al usar `SERVERLESS_TYPE=DISABLED`, cualquier intento de ejecutar una función de lógica devolverá un error. Esto es útil si desea ejecutar Twenty sin capacidades de funciones de lógica.
+Al usar `LOGIC_FUNCTION_TYPE=DISABLED` o `CODE_INTERPRETER_TYPE=DISABLED`, cualquier intento de ejecución devolverá un error. Esto es útil si desea ejecutar Twenty sin estas capacidades.
</Note>
diff --git a/packages/twenty-docs/l/es/developers/self-host/capabilities/troubleshooting.mdx b/packages/twenty-docs/l/es/developers/self-host/capabilities/troubleshooting.mdx
index fad4c8c15bf..6308faf59b7 100644
--- a/packages/twenty-docs/l/es/developers/self-host/capabilities/troubleshooting.mdx
+++ b/packages/twenty-docs/l/es/developers/self-host/capabilities/troubleshooting.mdx
@@ -1,5 +1,6 @@
---
title: Solución de problemas
+icon: llave inglesa
---
## Solución de Problemas
@@ -53,7 +54,7 @@ Asegúrese de ejecutar yarn en el directorio raíz y luego ejecute `npx nx serve
#### Lint on Save no funciona
-Esto debería funcionar sin configuración adicional con la extensión de Oxlint instalada. Si esto no funciona, intente agregar esto a su configuración de vscode (en el ámbito del contenedor de desarrollo):
+Esto debería funcionar sin configuración adicional con la extensión de Oxc (`oxc.oxc-vscode`) instalada. Si esto no funciona, intente agregar esto a su configuración de vscode (en el ámbito del contenedor de desarrollo):
```
"editor.codeActionsOnSave": {
@@ -166,6 +167,10 @@ plugins: [
Ejecute `UPDATE core."user" SET "canAccessFullAdminPanel" = TRUE WHERE email = '[email protected]';` en el contenedor de la base de datos para obtener acceso al panel de administración.
+#### Al ejecutar un flujo de trabajo, la ejecución del flujo de trabajo falla con "La ejecución de la función lógica está deshabilitada. Configura LOGIC_FUNCTION_TYPE en LOCAL o LAMBDA para habilitarlas."
+
+En producción, las funciones lógicas están deshabilitadas de forma predeterminada. Configura la variable de entorno `LOGIC_FUNCTION_TYPE` en `LOCAL` o `LAMBDA` para habilitarlas. Esto se puede configurar mediante variables de entorno o a través de las variables de base de datos del panel de administración. Consulta la [guía de configuración de funciones lógicas](/l/es/developers/self-host/capabilities/setup#logic-functions-available-drivers) para obtener más detalles.
+
### 1-clic con Docker Compose
#### No se puede iniciar sesión
diff --git a/packages/twenty-docs/l/es/developers/self-host/capabilities/upgrade-guide.mdx b/packages/twenty-docs/l/es/developers/self-host/capabilities/upgrade-guide.mdx
index ec90dff2600..3841aeb83fa 100644
--- a/packages/twenty-docs/l/es/developers/self-host/capabilities/upgrade-guide.mdx
+++ b/packages/twenty-docs/l/es/developers/self-host/capabilities/upgrade-guide.mdx
@@ -1,379 +1,102 @@
---
title: Guía de actualización
+icon: arrow-up-right-dots
---
## Guías generales
-**Asegúrese siempre de respaldar su base de datos antes de iniciar el proceso de actualización** ejecutando `docker exec -it {db_container_name_or_id} pg_dumpall -U {postgres_user} > databases_backup.sql`.
-
-Para restaurar el respaldo, ejecute `cat databases_backup.sql | docker exec -i {db_container_name_or_id} psql -U {postgres_user}`.
-
-Si usó Docker Compose, siga estos pasos:
-
-1. En una terminal, en el host donde Twenty está funcionando, apague Twenty: `docker compose down`
-
-2. Actualice la versión cambiando el valor de `TAG` en el archivo .env cerca de su docker-compose. ( Recomendamos consumir la versión `major.minor` como `v0.53` )
-
-3. Vuelva a conectar Twenty con `docker compose up -d`
-
-Si desea actualizar su instancia por algunas versiones, por ejemplo de v0.33.0 a v0.35.0, debe actualizar su instancia secuencialmente, en este ejemplo de v0.33.0 a v0.34.0, luego de v0.34.0 a v0.35.0.
-
-**Asegúrese de que después de cada versión actualizada tenga una copia de respaldo no corrupta.**
-
-## Pasos de actualización específicos por versión
-
-## v1.0
-
-¡Hola Twenty v1.0! 🎉
-
-## v0.60
-
-### Mejoras de rendimiento
-
-Todas las interacciones con la API de metadatos han sido optimizadas para un mejor rendimiento, particularmente para la manipulación de metadatos de objetos y operaciones de creación de espacios de trabajo.
-
-Hemos reestructurado nuestra estrategia de almacenamiento en caché para priorizar los aciertos de caché sobre las consultas de base de datos cuando sea posible, mejorando significativamente el rendimiento de las operaciones de la API de metadatos.
-
-Si encuentra problemas de ejecución después de actualizar, es posible que deba vaciar su caché para asegurar que esté sincronizado con los cambios más recientes. Ejecute este comando en su contenedor del servidor de twenty:
+**Haga siempre una copia de seguridad de su base de datos antes de iniciar el proceso de actualización** ejecutando:
```bash
-yarn command:prod cache:flush
+docker exec -it {db_container_name_or_id} pg_dumpall -U {postgres_user} > databases_backup.sql
```
-### v0.55
-
-Actualice su instancia de Twenty para usar la imagen v0.55
-
-Ya no necesita ejecutar ningún comando, la nueva imagen se encargará automáticamente de ejecutar todas las migraciones necesarias.
-
-### Error: `El usuario no tiene permiso`
-
-Si encuentra errores de autorización en la mayoría de solicitudes después de actualizar, es posible que deba vaciar su caché para recalcular los permisos más recientes.
-
-En su contenedor `twenty-server`, ejecute:
+Para restaurar desde la copia de seguridad:
```bash
-yarn command:prod cache:flush
-```
-
-Este problema es específico de esta versión de Twenty y no debería ser necesario para futuras actualizaciones.
-
-### v0.54
-
-Desde la versión `0.53`, no se necesitan acciones manuales.
-
-#### Desaparición del esquema de metadatos
-
-Hemos fusionado el esquema `metadata` en el esquema `core` para simplificar la recuperación de datos desde `TypeORM`.
-Hemos fusionado el paso del comando `migrate` dentro del comando `upgrade`. No recomendamos ejecutar `migrate` manualmente dentro de ninguno de sus contenedores de servidor/trabajador.
-
-### Desde v0.53
-
-A partir de `0.53`, la actualización se realiza de forma programática dentro del `DockerFile`, esto significa que de ahora en adelante, no debería necesitar ejecutar ningún comando manualmente.
-
-Asegúrese de seguir actualizando su instancia secuencialmente, sin omitir ninguna versión principal (por ejemplo, de `0.43.3` a `0.44.0` está permitido, pero de `0.43.1` a `0.45.0` no lo está), de lo contrario, podría provocar un desincronización de la versión del espacio de trabajo que podría resultar en errores de ejecución y funciones faltantes.
-
-Para verificar si un espacio de trabajo se ha migrado correctamente, puede revisar su versión en la base de datos en la tabla `core.workspace`.
-
-Siempre debería estar dentro del rango de la versión `major.minor` actual de su instancia de Twenty; puede ver la versión de su instancia en el panel de administración (en `/settings/admin-panel`, accesible si su usuario tiene la propiedad `canAccessFullAdminPanel` establecida en verdadero en la base de datos) o ejecutando `echo $APP_VERSION` en su contenedor `twenty-server`.
-
-Para corregir una versión de espacio de trabajo desincronizada, tendrá que actualizar desde la correspondiente versión de twenty siguiendo la guía de actualización relacionada secuencialmente, y así sucesivamente hasta alcanzar la versión deseada.
-
-#### Eliminación de `auditLog`
-
-Hemos eliminado el objeto estándar auditLog, lo que significa que el tamaño de su copia de seguridad podría reducirse significativamente después de esta migración.
-
-### v0.51 a v0.52
-
-Actualice su instancia de Twenty para usar la imagen v0.52
-
-```
-yarn database:migrate:prod
-yarn command:prod upgrade
-```
-
-#### Tengo un espacio de trabajo bloqueado en la versión entre `0.52.0` y `0.52.6`
-
-Desafortunadamente, `0.52.0` y `0.52.6` se han eliminado completamente de dockerHub.
-Tendrá que actualizar manualmente la versión de su espacio de trabajo a `0.51.0` en la base de datos y actualizar usando la versión twenty `0.52.11` siguiendo su guía de actualización justo arriba.
-
-### v0.50 a v0.51
-
-Actualice su instancia de Twenty para usar la imagen v0.51
-
-```
-yarn database:migrate:prod
-yarn command:prod upgrade
-```
-
-### v0.44.0 a v0.50.0
-
-Actualice su instancia de Twenty para usar la imagen v0.50.0
-
-```
-yarn database:migrate:prod
-yarn command:prod upgrade
-```
-
-#### Mutación del docker-compose.yml
-
-Esta versión incluye una mutación del `docker-compose.yml` para dar acceso al servicio `worker` al volumen `server-local-data`.
-Actualice su `docker-compose.yml` local con el [docker-compose.yml de v0.50.0](https://github.com/twentyhq/twenty/blob/v0.50.0/packages/twenty-docker/docker-compose.yml)
-
-### v0.43.0 a v0.44.0
-
-Actualice su instancia de Twenty para usar la imagen v0.44.0
-
-```
-yarn database:migrate:prod
-yarn command:prod upgrade
-```
-
-### v0.42.0 a v0.43.0
-
-Actualice su instancia de Twenty para usar la imagen v0.43.0
-
-```
-yarn database:migrate:prod
-yarn command:prod upgrade
-```
-
-En esta versión, también hemos cambiado a la imagen de postgres:16 en docker-compose.yml.
-
-#### (Opción 1) Migración de base de datos
-
-Mantener la imagen postgres-spilo existente está bien, pero tendrá que congelar la versión en su docker-compose.yml a 0.43.0.
-
-#### (Opción 2) Migración de base de datos
-
-Si desea migrar su base de datos a la nueva imagen de postgres:16, siga estos pasos:
-
-1. Descargue su base de datos del contenedor antiguo de postgres-spilo
-
-```
-docker exec -it twenty-db-1 sh
-pg_dump -U {YOUR_POSTGRES_USER} -d {YOUR_POSTGRES_DB} > databases_backup.sql
-exit
-docker cp twenty-db-1:/home/postgres/databases_backup.sql .
-```
-
-Asegúrese de que su archivo de respaldo no esté vacío.
-
-2. Actualice su docker-compose.yml para usar la imagen de postgres:16 como en el archivo [docker-compose.yml](https://raw.githubusercontent.com/twentyhq/twenty/main/packages/twenty-docker/docker-compose.yml).
-
-3. Restaure la base de datos al nuevo contenedor postgres:16
-
+cat databases_backup.sql | docker exec -i {db_container_name_or_id} psql -U {postgres_user}
```
-docker cp databases_backup.sql twenty-db-1:/databases_backup.sql
-docker exec -it twenty-db-1 sh
-psql -U {YOUR_POSTGRES_USER} -d {YOUR_POSTGRES_DB} -f databases_backup.sql
-exit
-```
-
-### v0.41.0 a v0.42.0
-Actualice su instancia de Twenty para usar la imagen v0.42.0
+Si usa Docker Compose, siga estos pasos:
-```
-yarn database:migrate:prod
-yarn command:prod upgrade-0.42
-```
-
-**Variables del entorno**
+1. Detenga Twenty: `docker compose down`
+2. Cambie el valor de `TAG` en el archivo `.env` junto a su `docker-compose.yml`
+3. Inicie Twenty: `docker compose up -d`
-* Removidos: `FRONT_PORT`, `FRONT_PROTOCOL`, `FRONT_DOMAIN`, `PORT`
-* Agregados: `FRONTEND_URL`, `NODE_PORT`, `MAX_NUMBER_OF_WORKSPACES_DELETED_PER_EXECUTION`, `MESSAGING_PROVIDER_MICROSOFT_ENABLED`, `CALENDAR_PROVIDER_MICROSOFT_ENABLED`, `IS_MICROSOFT_SYNC_ENABLED`
+El servidor ejecuta automáticamente todas las migraciones de actualización necesarias al iniciarse. No se requiere ningún comando manual.
-### v0.40.0 a v0.41.0
+## Actualizaciones entre versiones (v1.22+)
-Actualice su instancia de Twenty para usar la imagen v0.41.0
+A partir de la **v1.22**, Twenty admite actualizaciones entre versiones. Puede actualizar directamente desde cualquier versión compatible a la última versión sin tener que pasar por cada versión intermedia.
-```
-yarn database:migrate:prod
-yarn command:prod upgrade-0.41
-```
+Por ejemplo, actualizar de la v1.22 directamente a la v2.0 está totalmente admitido.
-**Variables del entorno**
+## Actualización a v2.5+ — envoltura de cifrado de datos en reposo
-* Removido: `AUTH_MICROSOFT_TENANT_ID`
+A partir de la **v2.5**, Twenty almacena los secretos en reposo (tokens OAuth, variables de aplicación, claves privadas de firma, valores de configuración sensibles, secretos TOTP) dentro de una envoltura versionada `enc:v2:` cifrada con `ENCRYPTION_KEY` (o `APP_SECRET` si `ENCRYPTION_KEY` no está definido).
-### v0.35.0 a v0.40.0
+El primer arranque en la v2.5 ejecuta comandos de actualización lentos que **rellenan** las filas existentes en la nueva envoltura. Son idempotentes: si se interrumpe y se reinicia el servidor, se reanuda desde donde se quedó, pero pueden tardar un tiempo en bases de datos grandes. Puedes supervisar el progreso con `upgrade:status`.
-Actualice su instancia de Twenty para usar la imagen v0.40.0
-
-```
-yarn database:migrate:prod
-yarn command:prod upgrade-0.40
-```
-
-**Variables del entorno**
-
-* Agregados: `IS_EMAIL_VERIFICATION_REQUIRED`, `EMAIL_VERIFICATION_TOKEN_EXPIRES_IN`, `WORKFLOW_EXEC_THROTTLE_LIMIT`, `WORKFLOW_EXEC_THROTTLE_TTL`
-
-### v0.34.0 a v0.35.0
-
-Actualice su instancia de Twenty para usar la imagen v0.35.0
-
-```
-yarn database:migrate:prod
-yarn command:prod upgrade-0.35
-```
-
-El comando `yarn database:migrate:prod` aplicará las migraciones a la estructura de la base de datos (esquemas core y metadata)
-El `yarn command:prod upgrade-0.35` se encarga de la migración de datos de todos los espacios de trabajo.
-
-**Variables del entorno**
-
-* Reemplazamos `ENABLE_DB_MIGRATIONS` por `DISABLE_DB_MIGRATIONS` (valor predeterminado ahora es `false`, probablemente no tenga que establecer nada)
-
-### v0.33.0 a v0.34.0
-
-Actualice su instancia de Twenty para usar la imagen v0.34.0
-
-```
-yarn database:migrate:prod
-yarn command:prod upgrade-0.34
-```
-
-El comando `yarn database:migrate:prod` aplicará las migraciones a la estructura de la base de datos (esquemas core y metadata)
-El `yarn command:prod upgrade-0.34` se encarga de la migración de datos de todos los espacios de trabajo.
-
-**Variables del entorno**
-
-* Removido: `FRONT_BASE_URL`
-* Agregados: `FRONT_DOMAIN`, `FRONT_PROTOCOL`, `FRONT_PORT`
-
-Hemos actualizado la forma en que manejamos la URL del frontend.
-Ahora puede configurar la URL del frontend usando las variables `FRONT_DOMAIN`, `FRONT_PROTOCOL` y `FRONT_PORT`.
-Si FRONT_DOMAIN no está configurado, la URL del frontend volverá a `SERVER_URL`.
-
-### v0.32.0 a v0.33.0
-
-Actualice su instancia de Twenty para usar la imagen v0.33.0
-
-```
-yarn command:prod cache:flush
-yarn database:migrate:prod
-yarn command:prod upgrade-0.33
-```
+Debes establecer una `ENCRYPTION_KEY` dedicada **antes** de la actualización a v2.5 para que el proceso de relleno escriba las filas bajo esa clave desde el principio. Cambiar de clave después del relleno requiere una [rotación](/l/es/developers/self-host/capabilities/key-rotation).
-El comando `yarn command:prod cache:flush` eliminará la caché de Redis.
-El comando `yarn database:migrate:prod` aplicará las migraciones a la estructura de la base de datos (esquemas core y metadata)
-El `yarn command:prod upgrade-0.33` se encarga de la migración de datos de todos los espacios de trabajo.
+## Rotación de secretos y claves de firma
-A partir de esta versión, la imagen twenty-postgres para DB quedó obsoleta y ahora se usa twenty-postgres-spilo.
-Si desea seguir usando la imagen twenty-postgres, simplemente reemplace `twentycrm/twenty-postgres:${TAG}` con `twentycrm/twenty-postgres` en docker-compose.yml.
+Para las tareas operativas del día a día, como rotar `ENCRYPTION_KEY`, rotar la clave de firma JWT o revocar una clave de firma filtrada, consulta la [Guía de rotación de claves](/l/es/developers/self-host/capabilities/key-rotation).
-### v0.31.0 a v0.32.0
+## Comprobación del estado de la actualización
-Actualice su instancia de Twenty para usar la imagen v0.32.0
+El comando `upgrade:status` le permite inspeccionar el estado actual de su instancia y de las migraciones de los espacios de trabajo. Es útil para depurar problemas de actualización o al enviar una solicitud de soporte.
-**Migración de esquemas y datos**
+Ejecútelo desde el contenedor del servidor:
-```
-yarn database:migrate:prod
-yarn command:prod upgrade-0.32
-```
-
-El comando `yarn database:migrate:prod` aplicará las migraciones a la estructura de la base de datos (esquemas core y metadata)
-El `yarn command:prod upgrade-0.32` se encarga de la migración de datos de todos los espacios de trabajo.
-
-**Variables del entorno**
-
-Hemos actualizado la forma en que manejamos la conexión Redis.
-
-* Removidos: `REDIS_HOST`, `REDIS_PORT`, `REDIS_USERNAME`, `REDIS_PASSWORD`
-* Agregado: `REDIS_URL`
-
-Actualice su archivo `.env` para usar la nueva variable `REDIS_URL` en lugar de los parámetros de conexión individuales de Redis.
-
-También hemos simplificado la forma en que manejamos los tokens JWT.
-
-* Removidos: `ACCESS_TOKEN_SECRET`, `LOGIN_TOKEN_SECRET`, `REFRESH_TOKEN_SECRET`, `FILE_TOKEN_SECRET`
-* Agregado: `APP_SECRET`
-
-Actualice su archivo `.env` para usar la nueva variable `APP_SECRET` en lugar de los secretos de tokens individuales (puede usar el mismo secreto que antes o generar una nueva cadena aleatoria)
-
-**Cuenta conectada**
-
-Si está utilizando cuentas conectadas para sincronizar sus correos electrónicos y calendarios de Google, deberá activar la [API de People](https://developers.google.com/people) en su consola de administración de Google.
-
-### v0.30.0 a v0.31.0
-
-Actualice su instancia de Twenty para usar la imagen v0.31.0
-
-**Migración de esquemas y datos:**
-
-```
-yarn database:migrate:prod
-yarn command:prod upgrade-0.31
+```bash
+docker exec -it {server_container_name_or_id} yarn command:prod upgrade:status
```
-El comando `yarn database:migrate:prod` aplicará las migraciones a la estructura de la base de datos (esquemas core y metadata)
-El `yarn command:prod upgrade-0.31` se encarga de la migración de datos de todos los espacios de trabajo.
+Salida de ejemplo:
-### v0.24.0 a v0.30.0
+```sh
+APP_VERSION: v1.23.0
-Actualice su instancia de Twenty para usar la imagen v0.30.0
+Instance
+ Inferred version: 1.23.0
+ Latest command: 1.23.0_DropWorkspaceVersionColumnFastInstanceCommand_1785000000000
+ Status: Up to date
+ Executed by: v1.23.0
+ At: 2026-04-16T11:43:58.823Z
-**Cambio importante**:
-Para mejorar el rendimiento, Twenty ahora requiere que la caché redis esté configurada. Hemos actualizado nuestro [docker-compose.yml](https://raw.githubusercontent.com/twentyhq/twenty/main/packages/twenty-docker/docker-compose.yml) para reflejar esto.
-Asegúrese de actualizar su configuración y sus variables de entorno en consecuencia:
+Workspace
+ Apple (20202020-1c25-4d02-bf25-6aeccf7ea419)
+ Inferred version: 1.23.0
+ Latest command: 1.23.0_UpdateGlobalObjectContextCommandMenuItemsCommand_1780000005000
+ Status: Up to date
+ Executed by: v1.23.0
+ At: 2026-04-16T11:44:09.361Z
+Summary
+ Instance: Up to date
+ Workspaces: 1 up to date, 0 behind, 0 failed (1 total)
```
-REDIS_HOST={your-redis-host}
-REDIS_PORT={your-redis-port}
-CACHE_STORAGE_TYPE=redis
-```
-
-**Migración de esquemas y datos:**
-
-```
-yarn database:migrate:prod
-yarn command:prod upgrade-0.30
-```
-
-El comando `yarn database:migrate:prod` aplicará las migraciones a la estructura de la base de datos (esquemas core y metadata)
-El `yarn command:prod upgrade-0.30` se encarga de la migración de datos de todos los espacios de trabajo.
-
-### v0.23.0 a v0.24.0
-
-Actualice su instancia de Twenty para usar la imagen v0.24.0
-
-Ejecución de los siguientes comandos:
-```
-yarn database:migrate:prod
-yarn command:prod upgrade-0.24
-```
+### Opciones
-El comando `yarn database:migrate:prod` aplicará las migraciones a la estructura de la base de datos (esquemas core y metadata)
-El `yarn command:prod upgrade-0.24` se encarga de la migración de datos de todos los espacios de trabajo.
+| Opción | Descripción |
+| ------------------------- | -------------------------------------------------------------------------------------------------------- |
+| `-w, --workspace-id <id>` | Filtra por un espacio de trabajo específico. Puede pasarse varias veces. |
+| `-f, --failed-only` | Oculta los espacios de trabajo actualizados, y solo muestra los que están desactualizados o han fallado. |
-### v0.22.0 a v0.23.0
+## Solución de Problemas
-Actualice su instancia de Twenty para usar la imagen v0.23.0
+Si la actualización falla en algunos espacios de trabajo, el servidor no avanzará más allá del paso con errores. Al reiniciar el servidor (`docker compose up -d`), se reintentará la actualización desde donde se detuvo.
-Ejecución de los siguientes comandos:
+Para identificar rápidamente los problemas, ejecute:
+```bash
+docker exec -it {server_container_name_or_id} yarn command:prod upgrade:status --failed-only
```
-yarn database:migrate:prod
-yarn command:prod upgrade-0.23
-```
-
-El comando `yarn database:migrate:prod` aplicará las migraciones a la base de datos.
-El `yarn command:prod upgrade-0.23` se encarga de la migración de datos, incluyendo la transferencia de actividades a tareas/notas.
-### v0.21.0 a v0.22.0
+Esto muestra únicamente los espacios de trabajo que están desactualizados o han fallado, junto con el mensaje de error de cada fallo.
-Actualice su instancia de Twenty para usar la imagen v0.22.0
-
-Ejecución de los siguientes comandos:
-
-```
-yarn database:migrate:prod
-yarn command:prod upgrade-0.22
-```
+## Antes de la v1.22
-El comando `yarn database:migrate:prod` aplicará las migraciones a la base de datos.
-El comando `yarn command:prod upgrade-0.22` aplicará transformaciones de datos específicas para adaptarse a las nuevas opciones predeterminadas de instrumentación de solicitud de objetos.
+Si su instancia es anterior a la v1.22, debe actualizar de forma incremental a través de cada versión principal etiquetada (de la v1.6 a la v1.7, luego de la v1.7 a la v1.8, y así sucesivamente) hasta llegar a la v1.22. A partir de ahí, puede actualizar directamente a la última versión.
diff --git a/packages/twenty-docs/l/es/navigation.json b/packages/twenty-docs/l/es/navigation.json
index 4b022c374e1..fba951d368b 100644
--- a/packages/twenty-docs/l/es/navigation.json
+++ b/packages/twenty-docs/l/es/navigation.json
@@ -1,24 +1,27 @@
{
"tabs": {
+ "gettingStarted": {
+ "label": "Primeros pasos",
+ "groups": {
+ "welcome": {
+ "label": "Bienvenido"
+ },
+ "coreConcepts": {
+ "label": "Conceptos clave"
+ }
+ }
+ },
"userGuide": {
"label": "Guía de usuario",
"groups": {
- "discoverTwenty": {
- "label": "Descubre Twenty",
- "groups": {
- "gettingStartedCapabilities": {
- "label": "Capacidades"
- },
- "gettingStartedHowTos": {
- "label": "Guías prácticas"
- }
- }
+ "userGuideOverview": {
+ "label": "Resumen"
},
"dataModel": {
"label": "Modelo de datos",
"groups": {
- "dataModelCapabilities": {
- "label": "Capacidades"
+ "dataModelReference": {
+ "label": "Referencia"
},
"dataModelHowTos": {
"label": "Guías prácticas"
@@ -28,8 +31,8 @@
"dataMigration": {
"label": "Migración de datos",
"groups": {
- "dataMigrationCapabilities": {
- "label": "Capacidades"
+ "dataMigrationReference": {
+ "label": "Referencia"
},
"dataMigrationHowTos": {
"label": "Guías prácticas"
@@ -39,8 +42,8 @@
"calendarEmails": {
"label": "Calendario y correos electrónicos",
"groups": {
- "calendarEmailsCapabilities": {
- "label": "Capacidades"
+ "calendarEmailsReference": {
+ "label": "Referencia"
},
"calendarEmailsHowTos": {
"label": "Guías prácticas"
@@ -50,8 +53,8 @@
"workflows": {
"label": "Flujos de trabajo",
"groups": {
- "workflowsCapabilities": {
- "label": "Capacidades"
+ "workflowsReference": {
+ "label": "Referencia"
},
"workflowsHowTos": {
"label": "Guías prácticas",
@@ -75,21 +78,26 @@
"ai": {
"label": "IA",
"groups": {
- "aiCapabilities": {
- "label": "Capacidades"
+ "aiReference": {
+ "label": "Referencia"
},
"aiHowTos": {
"label": "Guías prácticas"
}
}
},
- "viewsPipelines": {
- "label": "Vistas y canalizaciones",
+ "layout": {
+ "label": "Diseño",
"groups": {
- "viewsPipelinesCapabilities": {
- "label": "Capacidades"
+ "layoutReference": {
+ "label": "Referencia",
+ "groups": {
+ "layoutViews": {
+ "label": "Vistas"
+ }
+ }
},
- "viewsPipelinesHowTos": {
+ "layoutHowTos": {
"label": "Guías prácticas"
}
}
@@ -97,8 +105,8 @@
"dashboards": {
"label": "Tableros",
"groups": {
- "dashboardsCapabilities": {
- "label": "Capacidades"
+ "dashboardsReference": {
+ "label": "Referencia"
},
"dashboardsHowTos": {
"label": "Guías prácticas"
@@ -108,8 +116,8 @@
"permissionsAccess": {
"label": "Permisos y acceso",
"groups": {
- "permissionsAccessCapabilities": {
- "label": "Capacidades"
+ "permissionsAccessReference": {
+ "label": "Referencia"
},
"permissionsAccessHowTos": {
"label": "Guías prácticas"
@@ -119,8 +127,8 @@
"billing": {
"label": "Facturación",
"groups": {
- "billingCapabilities": {
- "label": "Capacidades"
+ "billingReference": {
+ "label": "Referencia"
},
"billingHowTos": {
"label": "Guías prácticas"
@@ -130,8 +138,8 @@
"settings": {
"label": "Configuración",
"groups": {
- "settingsCapabilities": {
- "label": "Capacidades"
+ "settingsReference": {
+ "label": "Referencia"
},
"settingsHowTos": {
"label": "Guías prácticas"
@@ -143,59 +151,40 @@
"developers": {
"label": "Desarrolladores",
"groups": {
- "developersGroup": {
- "label": "Desarrolladores"
+ "developersOverview": {
+ "label": "Resumen"
},
- "extend": {
- "label": "Ampliar",
+ "apps": {
+ "label": "Aplicaciones",
"groups": {
- "extendCapabilities": {
- "label": "Capacidades"
+ "appsGettingStarted": {
+ "label": "Primeros pasos"
+ },
+ "appsConfig": {
+ "label": "Configuración"
+ },
+ "appsData": {
+ "label": "Datos"
+ },
+ "appsLogic": {
+ "label": "Lógica"
+ },
+ "appsLayout": {
+ "label": "Diseño"
+ },
+ "appsOperations": {
+ "label": "Operaciones"
}
}
},
+ "api": {
+ "label": "API"
+ },
"selfHost": {
- "label": "Autoalojamiento",
- "groups": {
- "selfHostCapabilities": {
- "label": "Capacidades"
- }
- }
+ "label": "Autoalojamiento"
},
"contribute": {
- "label": "Contribuir",
- "groups": {
- "contributeCapabilities": {
- "label": "Capacidades",
- "groups": {
- "frontendDevelopment": {
- "label": "Desarrollo Frontend",
- "groups": {
- "twentyUi": {
- "label": "Twenty UI",
- "groups": {
- "display": {
- "label": "Mostrar"
- },
- "feedback": {
- "label": "Retroalimentación"
- },
- "input": {
- "label": "Entrada"
- },
- "navigation": {
- "label": "Navegación"
- }
- }
- }
- }
- },
- "backendDevelopment": {
- "label": "Desarrollo Backend"
- }
- }
- }
- }
+ "label": "Contribuir"
}
}
}
diff --git a/packages/twenty-docs/l/es/twenty-ui/display/app-tooltip.mdx b/packages/twenty-docs/l/es/twenty-ui/display/app-tooltip.mdx
index 6d56450f2a2..8aafa173b75 100644
--- a/packages/twenty-docs/l/es/twenty-ui/display/app-tooltip.mdx
+++ b/packages/twenty-docs/l/es/twenty-ui/display/app-tooltip.mdx
@@ -1,5 +1,6 @@
---
title: Consejo de la aplicación
+icon: mensaje
---
<Frame>
@@ -9,46 +10,54 @@ title: Consejo de la aplicación
Un breve mensaje que muestra información adicional cuando un usuario interactúa con un elemento.
<Tabs>
- <Tab title="Uso">
- ```jsx
- import { AppTooltip } from "@/ui/display/tooltip/AppTooltip";
-
- export const MyComponent = () => {
- return (
- <>
- <p id="hoverText" style={{ display: "inline-block" }}>
- Customer Insights
- </p>
- <AppTooltip
- className
- anchorSelect="#hoverText"
- content="Explore customer behavior and preferences"
- delayHide={0}
- offset={6}
- noArrow={false}
- isOpen={true}
- place="bottom"
- positionStrategy="absolute"
- />
- </>
- );
- };
- ```
- </Tab>
-
- <Tab title="Props">
- | Props | Tipo | Descripción |
- | ------------------ | -------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
- | nombreDeClase | cadena | Clase CSS opcional para estilo adicional |
- | anchorSelect | Selector CSS | Selector para el ancla del consejo (el elemento que activa el consejo) |
- | contenido | cadena | El contenido que desea mostrar dentro del consejo |
- | delayHide | número | The delay in seconds before hiding the tooltip after the cursor leaves the anchor |
- | desplazamiento | número | El desplazamiento en píxeles para posicionar el consejo |
- | sinFlecha | booleano | Si es `true`, oculta la flecha en el consejo |
- | estáAbierto | booleano | Si es `true`, el consejo está abierto por defecto |
- | lugar | Cadena `PlacesType` de `react-tooltip` | Especifica la colocación del consejo. Los valores incluyen `inferior`, `izquierda`, `derecha`, `superior`, `superior-inicio`, `superior-fin`, `derecha-inicio`, `derecha-fin`, `inferior-inicio`, `inferior-fin`, `izquierda-inicio` y `izquierda-fin` |
- | estrategiaPosicion | Cadena `PositionStrategy` de `react-tooltip` | Estrategia de posición para el consejo. Tiene dos valores: `absoluto` y `fijo` |
- </Tab>
+<Tab title="Uso">
+
+```jsx
+import { AppTooltip } from "@/ui/display/tooltip/AppTooltip";
+
+export const MyComponent = () => {
+ return (
+ <>
+ <p id="hoverText" style={{ display: "inline-block" }}>
+ Customer Insights
+ </p>
+ <AppTooltip
+ className
+ anchorSelect="#hoverText"
+ content="Explore customer behavior and preferences"
+ delayHide={0}
+ offset={6}
+ noArrow={false}
+ isOpen={true}
+ place="bottom"
+ positionStrategy="absolute"
+ />
+ </>
+ );
+};
+```
+
+</Tab>
+
+<Tab title="Props">
+
+
+| Props | Tipo | Descripción |
+| ------------------ | -------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| nombreDeClase | cadena | Clase CSS opcional para estilo adicional |
+| anchorSelect | Selector CSS | Selector para el ancla del consejo (el elemento que activa el consejo) |
+| contenido | cadena | El contenido que desea mostrar dentro del consejo |
+| delayHide | número | The delay in seconds before hiding the tooltip after the cursor leaves the anchor |
+| desplazamiento | número | El desplazamiento en píxeles para posicionar el consejo |
+| sinFlecha | booleano | Si es `true`, oculta la flecha en el consejo |
+| estáAbierto | booleano | Si es `true`, el consejo está abierto por defecto |
+| lugar | Cadena `PlacesType` de `react-tooltip` | Especifica la colocación del consejo. Los valores incluyen `inferior`, `izquierda`, `derecha`, `superior`, `superior-inicio`, `superior-fin`, `derecha-inicio`, `derecha-fin`, `inferior-inicio`, `inferior-fin`, `izquierda-inicio` y `izquierda-fin` |
+| estrategiaPosicion | Cadena `PositionStrategy` de `react-tooltip` | Estrategia de posición para el consejo. Tiene dos valores: `absoluto` y `fijo` |
+
+
+
+</Tab>
+
</Tabs>
## Texto Desbordante con Consejo
@@ -56,22 +65,30 @@ Un breve mensaje que muestra información adicional cuando un usuario interactú
Maneja texto desbordante y muestra un consejo cuando el texto se desborda.
<Tabs>
- <Tab title="Uso">
- ```jsx
- import { OverflowingTextWithTooltip } from 'twenty-ui/display';
-
- export const MyComponent = () => {
- const crmTaskDescription =
- 'Follow up with client regarding their recent product inquiry. Discuss pricing options, address any concerns, and provide additional product information. Record the details of the conversation in the CRM for future reference.';
-
- return <OverflowingTextWithTooltip text={crmTaskDescription} />;
- };
- ```
- </Tab>
-
- <Tab title="Props">
- | Props | Tipo | Descripción |
- | ----- | ------ | -------------------------------------------------------------- |
- | texto | cadena | El contenido que desea mostrar en el área de texto desbordante |
- </Tab>
+<Tab title="Uso">
+
+```jsx
+import { OverflowingTextWithTooltip } from 'twenty-ui/display';
+
+export const MyComponent = () => {
+ const crmTaskDescription =
+ 'Follow up with client regarding their recent product inquiry. Discuss pricing options, address any concerns, and provide additional product information. Record the details of the conversation in the CRM for future reference.';
+
+ return <OverflowingTextWithTooltip text={crmTaskDescription} />;
+};
+```
+
+</Tab>
+
+<Tab title="Props">
+
+
+| Props | Tipo | Descripción |
+| ----- | ------ | -------------------------------------------------------------- |
+| texto | cadena | El contenido que desea mostrar en el área de texto desbordante |
+
+
+
+</Tab>
+
</Tabs>
diff --git a/packages/twenty-docs/l/es/twenty-ui/display/checkmark.mdx b/packages/twenty-docs/l/es/twenty-ui/display/checkmark.mdx
index 69622513124..55012d2f291 100644
--- a/packages/twenty-docs/l/es/twenty-ui/display/checkmark.mdx
+++ b/packages/twenty-docs/l/es/twenty-ui/display/checkmark.mdx
@@ -1,5 +1,6 @@
---
title: Marca de verificación
+icon: circle-check
---
<Frame>
@@ -9,19 +10,25 @@ title: Marca de verificación
Representa una acción exitosa o completada.
<Tabs>
- <Tab title="Uso">
- ```jsx
- import { Checkmark } from 'twenty-ui/display';
-
- export const MyComponent = () => {
- return <Checkmark />;
- };
- ```
- </Tab>
-
- <Tab title="Props">
- Extiende `React.ComponentPropsWithoutRef<'div'>` y acepta todas las propiedades de un elemento `div` regular.
- </Tab>
+<Tab title="Uso">
+
+```jsx
+import { Checkmark } from 'twenty-ui/display';
+
+export const MyComponent = () => {
+ return <Checkmark />;
+};
+```
+
+
+</Tab>
+
+<Tab title="Props">
+
+Extiende `React.ComponentPropsWithoutRef<'div'>` y acepta todas las propiedades de un elemento `div` regular.
+
+</Tab>
+
</Tabs>
## Marca de verificación animada
@@ -29,29 +36,38 @@ Representa una acción exitosa o completada.
Representa un ícono de marca de verificación con la característica adicional de animación.
<Tabs>
- <Tab title="Uso">
- ```jsx
- import { AnimatedCheckmark } from 'twenty-ui/display';
-
- export const MyComponent = () => {
- return (
- <AnimatedCheckmark
- isAnimating={true}
- color="green"
- duration={0.5}
- size={30}
- />
- );
- };
- ```
- </Tab>
-
- <Tab title="Props">
- | Props | Tipo | Descripción | Predeterminado |
- | ----------- | -------- | -------------------------------------------------- | -------------- |
- | isAnimating | booleano | Controla si la marca de verificación está animando | falso |
- | color | cadena | Color de la marca de verificación | |
- | duración | número | La duración de la animación en segundos | 0.5 segundos |
- | tamaño | número | El tamaño de la marca de verificación | 28 píxeles |
- </Tab>
+
+<Tab title="Uso">
+
+```jsx
+import { AnimatedCheckmark } from 'twenty-ui/display';
+
+export const MyComponent = () => {
+ return (
+ <AnimatedCheckmark
+ isAnimating={true}
+ color="green"
+ duration={0.5}
+ size={30}
+ />
+ );
+};
+```
+
+</Tab>
+
+<Tab title="Props">
+
+
+| Props | Tipo | Descripción | Predeterminado |
+| ----------- | -------- | -------------------------------------------------- | -------------- |
+| isAnimating | booleano | Controla si la marca de verificación está animando | falso |
+| color | cadena | Color de la marca de verificación | |
+| duración | número | La duración de la animación en segundos | 0.5 segundos |
+| tamaño | número | El tamaño de la marca de verificación | 28 píxeles |
+
+
+
+</Tab>
+
</Tabs>
diff --git a/packages/twenty-docs/l/es/twenty-ui/display/chip.mdx b/packages/twenty-docs/l/es/twenty-ui/display/chip.mdx
index 5406401e611..a8e4aa7e76d 100644
--- a/packages/twenty-docs/l/es/twenty-ui/display/chip.mdx
+++ b/packages/twenty-docs/l/es/twenty-ui/display/chip.mdx
@@ -9,40 +9,48 @@ title: Chip
Un elemento visual que puedes usar como contenedor con o sin posibilidad de hacer clic, con una etiqueta, componentes opcionales a la izquierda y a la derecha y varias opciones de estilo para mostrar rótulos y etiquetas.
<Tabs>
- <Tab title="Uso">
- ```jsx
- import { Chip } from 'twenty-ui/components';
-
- export const MyComponent = () => {
- return (
- <Chip
- size="large"
- label="Chip clicable"
- clickable={true}
- variant="highlighted"
- accent="text-primary"
- leftComponent
- rightComponent
- maxWidth="200px"
- className
- />
- );
- };
-
- ```
- </Tab>
-
- <Tab title="Props">
- | Props | Tipo | Descripción |
- | ------------ | ------------------------ | ------------------------------------------------------------------------------------------------ |
- | linkToEntity | cadena | El enlace a la entidad |
- | entityId | cadena | El identificador único de la entidad |
- | nombre | cadena | El nombre de la entidad |
- | pictureUrl | cadena | s foto", |
- | avatarType | Tipo de Avatar | El tipo de avatar que quieres mostrar. Tiene dos opciones: `redondeado` y `cuadrado` |
- | variante | `EntityChipVariant` enum | Variante del chip de entidad que quieres mostrar. Tiene dos opciones: `regular` y `transparente` |
- | LeftIcon | IconComponent | Un componente de React que representa un ícono. Mostrado en el lado izquierdo del chip |
- </Tab>
+
+<Tab title="Uso">
+
+```jsx
+import { Chip } from 'twenty-ui/components';
+
+export const MyComponent = () => {
+ return (
+ <Chip
+ size="large"
+ label="Chip clicable"
+ clickable={true}
+ variant="highlighted"
+ accent="text-primary"
+ leftComponent
+ rightComponent
+ maxWidth="200px"
+ className
+ />
+ );
+};
+
+```
+
+</Tab>
+
+<Tab title="Props">
+
+
+| Props | Tipo | Descripción |
+| ------------ | ------------------------ | ------------------------------------------------------------------------------------------------ |
+| linkToEntity | cadena | El enlace a la entidad |
+| entityId | cadena | El identificador único de la entidad |
+| nombre | cadena | El nombre de la entidad |
+| pictureUrl | cadena | s foto", |
+| avatarType | Tipo de Avatar | El tipo de avatar que quieres mostrar. Tiene dos opciones: `redondeado` y `cuadrado` |
+| variante | `EntityChipVariant` enum | Variante del chip de entidad que quieres mostrar. Tiene dos opciones: `regular` y `transparente` |
+| LeftIcon | IconComponent | Un componente de React que representa un ícono. Mostrado en el lado izquierdo del chip |
+
+
+
+</Tab>
</Tabs>
## Ejemplos
@@ -99,39 +107,47 @@ export const MyComponent = () => {
Un elemento tipo Chip para mostrar información sobre una entidad.
<Tabs>
- <Tab title="Uso">
- ```jsx
- import { BrowserRouter as Router } from 'react-router-dom';
- import { IconTwentyStar } from 'twenty-ui/display';
- import { Chip } from 'twenty-ui/components';
-
- export const MyComponent = () => {
- return (
- <Router>
- <Chip
- linkToEntity="/entity-link"
- entityId="entityTest"
- name="Nombre de la entidad"
- pictureUrl=""
- avatarType="rounded"
- variant="regular"
- LeftIcon={IconTwentyStar}
- />
- </Router>
- );
- };
- ```
- </Tab>
-
- <Tab title="Props">
- | Props | Tipo | Descripción |
- | ------------ | ------------------------ | ------------------------------------------------------------------------------------------------ |
- | linkToEntity | cadena | El enlace a la entidad |
- | entityId | cadena | El identificador único de la entidad |
- | nombre | cadena | El nombre de la entidad |
- | pictureUrl | cadena | s foto", |
- | avatarType | Tipo de Avatar | El tipo de avatar que quieres mostrar. Tiene dos opciones: `redondeado` y `cuadrado` |
- | variante | `EntityChipVariant` enum | Variante del chip de entidad que quieres mostrar. Tiene dos opciones: `regular` y `transparente` |
- | LeftIcon | IconComponent | Un componente de React que representa un ícono. Mostrado en el lado izquierdo del chip |
- </Tab>
+
+<Tab title="Uso">
+
+```jsx
+import { BrowserRouter as Router } from 'react-router-dom';
+import { IconTwentyStar } from 'twenty-ui/display';
+import { Chip } from 'twenty-ui/components';
+
+export const MyComponent = () => {
+ return (
+ <Router>
+ <Chip
+ linkToEntity="/entity-link"
+ entityId="entityTest"
+ name="Nombre de la entidad"
+ pictureUrl=""
+ avatarType="rounded"
+ variant="regular"
+ LeftIcon={IconTwentyStar}
+ />
+ </Router>
+ );
+};
+```
+
+</Tab>
+
+<Tab title="Props">
+
+
+| Props | Tipo | Descripción |
+| ------------ | ------------------------ | ------------------------------------------------------------------------------------------------ |
+| linkToEntity | cadena | El enlace a la entidad |
+| entityId | cadena | El identificador único de la entidad |
+| nombre | cadena | El nombre de la entidad |
+| pictureUrl | cadena | s foto", |
+| avatarType | Tipo de Avatar | El tipo de avatar que quieres mostrar. Tiene dos opciones: `redondeado` y `cuadrado` |
+| variante | `EntityChipVariant` enum | Variante del chip de entidad que quieres mostrar. Tiene dos opciones: `regular` y `transparente` |
+| LeftIcon | IconComponent | Un componente de React que representa un ícono. Mostrado en el lado izquierdo del chip |
+
+
+
+</Tab>
</Tabs>
diff --git a/packages/twenty-docs/l/es/twenty-ui/display/icons.mdx b/packages/twenty-docs/l/es/twenty-ui/display/icons.mdx
index 00bcdc8db27..6788ea6561b 100644
--- a/packages/twenty-docs/l/es/twenty-ui/display/icons.mdx
+++ b/packages/twenty-docs/l/es/twenty-ui/display/icons.mdx
@@ -1,5 +1,6 @@
---
title: Iconos
+icon: iconos
---
<Frame>
@@ -13,35 +14,44 @@ Una lista de iconos utilizados en toda nuestra aplicación.
Usamos iconos Tabler para React en toda la aplicación.
<Tabs>
- <Tab title="Instalación">
- <br />
-
- ```
- yarn add @tabler/icons-react
- ```
- </Tab>
-
- <Tab title="Propiedades">
- Puede importar cada icono como un componente. Aquí hay un ejemplo:
-
- <br />
-
- ```jsx
- import { IconArrowLeft } from "@tabler/icons-react";
-
- export const MyComponent = () => {
- return <IconArrowLeft color="red" size={48} />;
- };
- ```
- </Tab>
-
- <Tab title="Propiedades">
- | Propiedades | Tipo | Descripción | Predeterminado |
- | ----------- | ------ | ----------------------------------------- | -------------- |
- | tamaño | número | La altura y el ancho del icono en píxeles | 24 |
- | color | cadena | El color de los iconos | currentColor |
- | trazo | número | El ancho del trazo del icono en píxeles | 2 |
- </Tab>
+
+<Tab title="Instalación">
+<br />
+
+```
+yarn add @tabler/icons-react
+```
+
+</Tab>
+
+<Tab title="Propiedades">
+
+Puede importar cada icono como un componente. Aquí hay un ejemplo:
+<br />
+
+```jsx
+import { IconArrowLeft } from "@tabler/icons-react";
+
+export const MyComponent = () => {
+ return <IconArrowLeft color="red" size={48} />;
+};
+```
+
+</Tab>
+
+<Tab title="Propiedades">
+
+
+| Propiedades | Tipo | Descripción | Predeterminado |
+| ----------- | ------ | ----------------------------------------- | -------------- |
+| tamaño | número | La altura y el ancho del icono en píxeles | 24 |
+| color | cadena | El color de los iconos | currentColor |
+| trazo | número | El ancho del trazo del icono en píxeles | 2 |
+
+
+
+</Tab>
+
</Tabs>
## Iconos Personalizados
@@ -53,20 +63,29 @@ Además de los iconos Tabler, la aplicación también utiliza algunos iconos per
Muestra un icono de libreta de direcciones.
<Tabs>
- <Tab title="&#x22;Uso&#x22;">
- ```jsx
- import { IconAddressBook } from 'twenty-ui/display';
-
- export const MyComponent = () => {
- return <IconAddressBook size={24} stroke={2} />;
- };
- ```
- </Tab>
-
- <Tab title="&#x22;Props&#x22;">
- | "Props" | Tipo | Descripción | Predeterminado |
- | ------- | ------ | ----------------------------------------- | -------------- |
- | tamaño | número | La altura y el ancho del icono en píxeles | 24 |
- | trazo | número | El ancho del trazo del icono en píxeles | 2 |
- </Tab>
+
+<Tab title="&#x22;Uso&#x22;">
+
+```jsx
+import { IconAddressBook } from 'twenty-ui/display';
+
+export const MyComponent = () => {
+ return <IconAddressBook size={24} stroke={2} />;
+};
+```
+
+</Tab>
+
+<Tab title="&#x22;Props&#x22;">
+
+
+| "Props" | Tipo | Descripción | Predeterminado |
+| ------- | ------ | ----------------------------------------- | -------------- |
+| tamaño | número | La altura y el ancho del icono en píxeles | 24 |
+| trazo | número | El ancho del trazo del icono en píxeles | 2 |
+
+
+
+</Tab>
+
</Tabs>
diff --git a/packages/twenty-docs/l/es/twenty-ui/display/soon-pill.mdx b/packages/twenty-docs/l/es/twenty-ui/display/soon-pill.mdx
index bb5a4e90458..189793ab7e3 100644
--- a/packages/twenty-docs/l/es/twenty-ui/display/soon-pill.mdx
+++ b/packages/twenty-docs/l/es/twenty-ui/display/soon-pill.mdx
@@ -2,7 +2,6 @@
title: Soon Pill
---
-
Una pequeña insignia o "pastilla" para indicar que algo estará disponible próximamente.
```jsx
diff --git a/packages/twenty-docs/l/es/twenty-ui/display/tag.mdx b/packages/twenty-docs/l/es/twenty-ui/display/tag.mdx
index e368b3873c3..14a3199c9ec 100644
--- a/packages/twenty-docs/l/es/twenty-ui/display/tag.mdx
+++ b/packages/twenty-docs/l/es/twenty-ui/display/tag.mdx
@@ -1,34 +1,43 @@
---
title: Etiqueta
+icon: etiqueta
---
-
Componente para categorizar o etiquetar contenido visualmente.
<Tabs>
- <Tab title="Uso">
- ```jsx
- import { Tag } from "@/ui/display/tag/components/Tag";
-
- export const MyComponent = () => {
- return (
- <Tag
- className
- color="red"
- text="Urgent"
- onClick={() => console.log("click")}
- />
- );
- };
- ```
- </Tab>
-
- <Tab title="Props">
- | Props | Tipo | Descripción |
- | ------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
- | nombreDeClase | cadena | Nombre opcional para estilo adicional |
- | color | cadena | Color de la etiqueta. Las opciones incluyen: `verde`, `turquesa`, `cielo`, `azul`, `púrpura`, `rosa`, `rojo`, `naranja`, `amarillo`, `gris` |
- | texto | cadena | El contenido de la etiqueta |
- | enClic | función | Función opcional llamada cuando un usuario hace clic en la etiqueta |
- </Tab>
+
+<Tab title="Uso">
+
+```jsx
+import { Tag } from "@/ui/display/tag/components/Tag";
+
+export const MyComponent = () => {
+ return (
+ <Tag
+ className
+ color="red"
+ text="Urgent"
+ onClick={() => console.log("click")}
+ />
+ );
+};
+```
+
+</Tab>
+
+<Tab title="Props">
+
+
+| Props | Tipo | Descripción |
+| ------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
+| nombreDeClase | cadena | Nombre opcional para estilo adicional |
+| color | cadena | Color de la etiqueta. Las opciones incluyen: `verde`, `turquesa`, `cielo`, `azul`, `púrpura`, `rosa`, `rojo`, `naranja`, `amarillo`, `gris` |
+| texto | cadena | El contenido de la etiqueta |
+| enClic | función | Función opcional llamada cuando un usuario hace clic en la etiqueta |
+
+
+
+</Tab>
+
</Tabs>
diff --git a/packages/twenty-docs/l/es/twenty-ui/input/block-editor.mdx b/packages/twenty-docs/l/es/twenty-ui/input/block-editor.mdx
index 6066d72fa8d..cca3f9047f7 100644
--- a/packages/twenty-docs/l/es/twenty-ui/input/block-editor.mdx
+++ b/packages/twenty-docs/l/es/twenty-ui/input/block-editor.mdx
@@ -9,22 +9,28 @@ title: Editor de Bloques
Usa un editor de texto enriquecido basado en bloques de [BlockNote](https://www.blocknotejs.org/) para permitir a los usuarios editar y ver bloques de contenido.
<Tabs>
- <Tab title="Uso">
- ```jsx
- import { useBlockNote } from "@blocknote/react";
- import { BlockEditor } from "@/ui/input/editor/components/BlockEditor";
-
- export const MyComponent = () => {
- const BlockNoteEditor = useBlockNote();
-
- return <BlockEditor editor={BlockNoteEditor} />;
- };
- ```
- </Tab>
-
- <Tab title="Props">
- | Props | Tipo | Descripción |
- | ------ | ----------------- | -------------------------------------------------- |
- | editor | `BlockNoteEditor` | La instancia o configuración del editor de bloques |
- </Tab>
+<Tab title="Uso">
+
+```jsx
+import { useBlockNote } from "@blocknote/react";
+import { BlockEditor } from "@/ui/input/editor/components/BlockEditor";
+
+export const MyComponent = () => {
+ const BlockNoteEditor = useBlockNote();
+
+ return <BlockEditor editor={BlockNoteEditor} />;
+};
+```
+
+</Tab>
+<Tab title="Props">
+
+
+| Props | Tipo | Descripción |
+| ------ | ----------------- | -------------------------------------------------- |
+| editor | `BlockNoteEditor` | La instancia o configuración del editor de bloques |
+
+
+
+</Tab>
</Tabs>
diff --git a/packages/twenty-docs/l/es/twenty-ui/input/buttons.mdx b/packages/twenty-docs/l/es/twenty-ui/input/buttons.mdx
index 621845df834..bf7e25d6922 100644
--- a/packages/twenty-docs/l/es/twenty-ui/input/buttons.mdx
+++ b/packages/twenty-docs/l/es/twenty-ui/input/buttons.mdx
@@ -1,5 +1,6 @@
---
title: Botones
+icon: hand-pointer
---
<Frame>
@@ -11,428 +12,511 @@ Una lista de botones y grupos de botones utilizados en toda la aplicación.
## Botón
<Tabs>
- <Tab title="&#x22;Uso&#x22;">
- ```jsx
- import { Button } from "@/ui/input/button/components/Button";
-
- export const MyComponent = () => {
- return (
- <Button
- className
- Icon={null}
- title="Title"
- fullWidth={false}
- variant="primary"
- size="medium"
- position="standalone"
- accent="default"
- soon={false}
- disabled={false}
- focus={true}
- onClick={() => console.log("click")}
- />
- );
- };
- ```
- </Tab>
-
- <Tab title="&#x22;Props&#x22;">
- | "Props" | Tipo | Descripción |
- | ------------- | --------------------- | -------------------------------------------------------------------------------------------------------------------------------- |
- | "className" | string | Nombre de clase opcional para estilos adicionales |
- | Ícono | `React.ComponentType` | Un componente de ícono opcional que se muestra dentro del botón |
- | título | cadena | El contenido de texto del botón |
- | "fullWidth" | booleano | Define si el botón debe ocupar todo el ancho de su contenedor |
- | variante | cadena | La variante de estilo visual del botón. Las opciones incluyen `primario`, `secundario` y `terciario` |
- | tamaño | cadena | El tamaño del botón. Tiene dos opciones: `pequeño` y `mediano` |
- | posición | cadena | La posición del botón en relación con sus compañeros. Las opciones incluyen: `independiente`, `izquierda`, `derecha` y `central` |
- | acento | cadena | El color de acento del botón. Las opciones incluyen: `predeterminado`, `azul` y `peligro` |
- | próximamente | booleano | Indica si el botón está marcado como "pronto" (como para funciones próximas) |
- | deshabilitado | booleano | Especifica si el botón está deshabilitado o no |
- | enfoque | booleano | Determina si el botón tiene foco |
- | alHacerClic | función | Una función de callback que se activa cuando el usuario hace clic en el botón |
- </Tab>
+
+<Tab title="&#x22;Uso&#x22;">
+
+```jsx
+import { Button } from "@/ui/input/button/components/Button";
+
+export const MyComponent = () => {
+ return (
+ <Button
+ className
+ Icon={null}
+ title="Title"
+ fullWidth={false}
+ variant="primary"
+ size="medium"
+ position="standalone"
+ accent="default"
+ soon={false}
+ disabled={false}
+ focus={true}
+ onClick={() => console.log("click")}
+ />
+ );
+};
+```
+</Tab>
+
+<Tab title="&#x22;Props&#x22;">
+
+
+| "Props" | Tipo | Descripción |
+| ------------- | --------------------- | -------------------------------------------------------------------------------------------------------------------------------- |
+| "className" | string | Nombre de clase opcional para estilos adicionales |
+| Ícono | `React.ComponentType` | Un componente de ícono opcional que se muestra dentro del botón |
+| título | cadena | El contenido de texto del botón |
+| "fullWidth" | booleano | Define si el botón debe ocupar todo el ancho de su contenedor |
+| variante | cadena | La variante de estilo visual del botón. Las opciones incluyen `primario`, `secundario` y `terciario` |
+| tamaño | cadena | El tamaño del botón. Tiene dos opciones: `pequeño` y `mediano` |
+| posición | cadena | La posición del botón en relación con sus compañeros. Las opciones incluyen: `independiente`, `izquierda`, `derecha` y `central` |
+| acento | cadena | El color de acento del botón. Las opciones incluyen: `predeterminado`, `azul` y `peligro` |
+| próximamente | booleano | Indica si el botón está marcado como "pronto" (como para funciones próximas) |
+| deshabilitado | booleano | Especifica si el botón está deshabilitado o no |
+| enfoque | booleano | Determina si el botón tiene foco |
+| alHacerClic | función | Una función de callback que se activa cuando el usuario hace clic en el botón |
+
+
+
+
+</Tab>
+
</Tabs>
## Grupo de Botones
<Tabs>
- <Tab title="Uso">
- ```jsx
- import { Button } from "@/ui/input/button/components/Button";
- import { ButtonGroup } from "@/ui/input/button/components/ButtonGroup";
-
- export const MyComponent = () => {
- return (
- <ButtonGroup variant="primary" size="large" accent="blue" className>
- <Button
- className
- Icon={null}
- title="Button 1"
- fullWidth={false}
- variant="primary"
- size="medium"
- position="standalone"
- accent="blue"
- soon={false}
- disabled={false}
- focus={false}
- onClick={() => console.log("click")}
- />
- <Button
- className
- Icon={null}
- title="Button 2"
- fullWidth={false}
- variant="secondary"
- size="medium"
- position="left"
- accent="blue"
- soon={false}
- disabled={false}
- focus={false}
- onClick={() => console.log("click")}
- />
- <Button
- className
- Icon={null}
- title="Button 3"
- fullWidth={false}
- variant="tertiary"
- size="medium"
- position="right"
- accent="blue"
- soon={false}
- disabled={false}
- focus={false}
- onClick={() => console.log("click")}
- />
- </ButtonGroup>
- );
- };
-
- ```
- </Tab>
-
- <Tab title="Props">
- | Props | Tipo | Descripción |
- | --------- | --------- | -------------------------------------------------------------------------------------------------------------------------- |
- | variante | cadena | La variante de estilo visual de los botones dentro del grupo. Las opciones incluyen `primario`, `secundario` y `terciario` |
- | tamaño | cadena | El tamaño de los botones dentro del grupo. Tiene dos opciones: `mediano` y `pequeño` |
- | acento | cadena | El color de acento de los botones dentro del grupo. Las opciones incluyen `predeterminado`, `azul` y `peligro` |
- | className | cadena | Nombre de clase opcional para estilos adicionales |
- | hijos | ReactNode | Una matriz de elementos React que representan los botones individuales dentro del grupo |
- </Tab>
+<Tab title="Uso">
+```jsx
+import { Button } from "@/ui/input/button/components/Button";
+import { ButtonGroup } from "@/ui/input/button/components/ButtonGroup";
+
+export const MyComponent = () => {
+ return (
+ <ButtonGroup variant="primary" size="large" accent="blue" className>
+ <Button
+ className
+ Icon={null}
+ title="Button 1"
+ fullWidth={false}
+ variant="primary"
+ size="medium"
+ position="standalone"
+ accent="blue"
+ soon={false}
+ disabled={false}
+ focus={false}
+ onClick={() => console.log("click")}
+ />
+ <Button
+ className
+ Icon={null}
+ title="Button 2"
+ fullWidth={false}
+ variant="secondary"
+ size="medium"
+ position="left"
+ accent="blue"
+ soon={false}
+ disabled={false}
+ focus={false}
+ onClick={() => console.log("click")}
+ />
+ <Button
+ className
+ Icon={null}
+ title="Button 3"
+ fullWidth={false}
+ variant="tertiary"
+ size="medium"
+ position="right"
+ accent="blue"
+ soon={false}
+ disabled={false}
+ focus={false}
+ onClick={() => console.log("click")}
+ />
+ </ButtonGroup>
+ );
+};
+
+```
+</Tab>
+
+<Tab title="Props">
+
+
+| Props | Tipo | Descripción |
+| --------- | --------- | -------------------------------------------------------------------------------------------------------------------------- |
+| variante | cadena | La variante de estilo visual de los botones dentro del grupo. Las opciones incluyen `primario`, `secundario` y `terciario` |
+| tamaño | cadena | El tamaño de los botones dentro del grupo. Tiene dos opciones: `mediano` y `pequeño` |
+| acento | cadena | El color de acento de los botones dentro del grupo. Las opciones incluyen `predeterminado`, `azul` y `peligro` |
+| className | cadena | Nombre de clase opcional para estilos adicionales |
+| hijos | ReactNode | Una matriz de elementos React que representan los botones individuales dentro del grupo |
+
+
+
+</Tab>
</Tabs>
## Botón Flotante
<Tabs>
- <Tab title="Uso">
- ```jsx
- import { FloatingButton } from "@/ui/input/button/components/FloatingButton";
- import { IconSearch } from "@tabler/icons-react";
-
- export const MyComponent = () => {
- return (
- <FloatingButton
- className
- Icon={IconSearch}
- title="Title"
- size="medium"
- position="standalone"
- applyShadow={true}
- applyBlur={true}
- disabled={false}
- focus={true}
- />
- );
- };
- ```
- </Tab>
-
- <Tab title="Props">
- | Props | Tipo | Descripción |
- | ----------------- | --------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
- | className | cadena | Nombre opcional para estilos adicionales |
- | Ícono | `React.ComponentType` | Un componente de ícono opcional que se muestra dentro del botón |
- | título | cadena | El contenido de texto del botón |
- | tamaño | cadena | El tamaño del botón. Tiene dos opciones: `pequeño` y `mediano` |
- | posición | cadena | La posición del botón en relación con sus compañeros. Las opciones incluyen: `independiente`, `izquierda`, `central`, `derecha` |
- | aplicarSombra | booleano | Determina si se aplica sombra a un botón |
- | aplicarDesenfoque | booleano | Determina si se aplica un efecto de desenfoque al botón |
- | deshabilitado | booleano | Determina si el botón está deshabilitado |
- | enfoque | booleano | Indica si el botón tiene foco |
- </Tab>
+<Tab title="Uso">
+
+```jsx
+import { FloatingButton } from "@/ui/input/button/components/FloatingButton";
+import { IconSearch } from "@tabler/icons-react";
+
+export const MyComponent = () => {
+ return (
+ <FloatingButton
+ className
+ Icon={IconSearch}
+ title="Title"
+ size="medium"
+ position="standalone"
+ applyShadow={true}
+ applyBlur={true}
+ disabled={false}
+ focus={true}
+ />
+ );
+};
+```
+
+</Tab>
+
+<Tab title="Props">
+
+
+| Props | Tipo | Descripción |
+| ----------------- | --------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
+| className | cadena | Nombre opcional para estilos adicionales |
+| Ícono | `React.ComponentType` | Un componente de ícono opcional que se muestra dentro del botón |
+| título | cadena | El contenido de texto del botón |
+| tamaño | cadena | El tamaño del botón. Tiene dos opciones: `pequeño` y `mediano` |
+| posición | cadena | La posición del botón en relación con sus compañeros. Las opciones incluyen: `independiente`, `izquierda`, `central`, `derecha` |
+| aplicarSombra | booleano | Determina si se aplica sombra a un botón |
+| aplicarDesenfoque | booleano | Determina si se aplica un efecto de desenfoque al botón |
+| deshabilitado | booleano | Determina si el botón está deshabilitado |
+| enfoque | booleano | Indica si el botón tiene foco |
+
+
+
+</Tab>
</Tabs>
## Grupo de Botones Flotantes
<Tabs>
- <Tab title="&#x22;Uso&#x22;">
- ```jsx
- import { FloatingButton } from "@/ui/input/button/components/FloatingButton";
- import { FloatingButtonGroup } from "@/ui/input/button/components/FloatingButtonGroup";
- import { IconClipboardText, IconCheckbox } from "@tabler/icons-react";
-
- export const MyComponent = () => {
- return (
- <FloatingButtonGroup size="small">
- <FloatingButton
- className
- Icon={IconClipboardText}
- title
- size="small"
- position="standalone"
- applyShadow={true}
- applyBlur={true}
- disabled={false}
- focus={true}
- />
- <FloatingButton
- className
- Icon={IconCheckbox}
- title
- size="small"
- position="standalone"
- applyShadow={true}
- applyBlur={true}
- disabled={false}
- />
- </FloatingButtonGroup>
- );
- };
- ```
- </Tab>
-
- <Tab title="&#x22;Props&#x22;">
- | "Props" | Tipo | Descripción | Predeterminado |
- | ------- | --------- | --------------------------------------------------------------------------------------- | -------------- |
- | tamaño | cadena | El tamaño del botón. Tiene dos opciones: `pequeño` y `mediano` | pequeño |
- | hijos | ReactNode | Una matriz de elementos React que representan los botones individuales dentro del grupo | |
- </Tab>
+<Tab title="&#x22;Uso&#x22;">
+
+```jsx
+import { FloatingButton } from "@/ui/input/button/components/FloatingButton";
+import { FloatingButtonGroup } from "@/ui/input/button/components/FloatingButtonGroup";
+import { IconClipboardText, IconCheckbox } from "@tabler/icons-react";
+
+export const MyComponent = () => {
+ return (
+ <FloatingButtonGroup size="small">
+ <FloatingButton
+ className
+ Icon={IconClipboardText}
+ title
+ size="small"
+ position="standalone"
+ applyShadow={true}
+ applyBlur={true}
+ disabled={false}
+ focus={true}
+ />
+ <FloatingButton
+ className
+ Icon={IconCheckbox}
+ title
+ size="small"
+ position="standalone"
+ applyShadow={true}
+ applyBlur={true}
+ disabled={false}
+ />
+ </FloatingButtonGroup>
+ );
+};
+```
+
+</Tab>
+
+<Tab title="&#x22;Props&#x22;">
+
+
+| "Props" | Tipo | Descripción | Predeterminado |
+| ------- | --------- | --------------------------------------------------------------------------------------- | -------------- |
+| tamaño | cadena | El tamaño del botón. Tiene dos opciones: `pequeño` y `mediano` | pequeño |
+| hijos | ReactNode | Una matriz de elementos React que representan los botones individuales dentro del grupo | |
+
+
+
+</Tab>
+
</Tabs>
## Botón de Ícono Flotante
<Tabs>
- <Tab title="Uso">
- ```jsx
- import { FloatingIconButton } from "@/ui/input/button/components/FloatingIconButton";
- import { IconSearch } from "@tabler/icons-react";
-
- export const MyComponent = () => {
- return (
- <FloatingIconButton
- className
- Icon={IconSearch}
- size="small"
- position="standalone"
- applyShadow={true}
- applyBlur={true}
- disabled={false}
- focus={false}
- onClick={() => console.log("click")}
- isActive={true}
- />
- );
- };
- ```
- </Tab>
-
- <Tab title="Props">
- | Props | Tipo | Descripción |
- | ----------------- | --------------------- | -------------------------------------------------------------------------------------------------------------------------------- |
- | className | cadena | "Nombre opcional para estilización adicional" |
- | Ícono | `React.ComponentType` | Un componente de ícono opcional que se muestra dentro del botón |
- | tamaño | cadena | El tamaño del botón. Tiene dos opciones: `pequeño` y `mediano` |
- | posición | cadena | La posición del botón en relación con sus compañeros. Las opciones incluyen: `independiente`, `izquierda`, `derecha` y `central` |
- | aplicarSombra | booleano | Determina si se aplica sombra a un botón |
- | aplicarDesenfoque | booleano | Determina si se aplica un efecto de desenfoque al botón |
- | deshabilitado | booleano | Determina si el botón está deshabilitado |
- | enfoque | booleano | Indica si el botón tiene foco |
- | alHacerClic | función | Una función de callback que se activa cuando el usuario hace clic en el botón |
- | esActivo | booleano | Determina si el botón está en estado activo |
- </Tab>
+<Tab title="Uso">
+
+```jsx
+import { FloatingIconButton } from "@/ui/input/button/components/FloatingIconButton";
+import { IconSearch } from "@tabler/icons-react";
+
+export const MyComponent = () => {
+ return (
+ <FloatingIconButton
+ className
+ Icon={IconSearch}
+ size="small"
+ position="standalone"
+ applyShadow={true}
+ applyBlur={true}
+ disabled={false}
+ focus={false}
+ onClick={() => console.log("click")}
+ isActive={true}
+ />
+ );
+};
+```
+
+</Tab>
+
+<Tab title="Props">
+
+
+| Props | Tipo | Descripción |
+| ----------------- | --------------------- | -------------------------------------------------------------------------------------------------------------------------------- |
+| className | cadena | "Nombre opcional para estilización adicional" |
+| Ícono | `React.ComponentType` | Un componente de ícono opcional que se muestra dentro del botón |
+| tamaño | cadena | El tamaño del botón. Tiene dos opciones: `pequeño` y `mediano` |
+| posición | cadena | La posición del botón en relación con sus compañeros. Las opciones incluyen: `independiente`, `izquierda`, `derecha` y `central` |
+| aplicarSombra | booleano | Determina si se aplica sombra a un botón |
+| aplicarDesenfoque | booleano | Determina si se aplica un efecto de desenfoque al botón |
+| deshabilitado | booleano | Determina si el botón está deshabilitado |
+| enfoque | booleano | Indica si el botón tiene foco |
+| alHacerClic | función | Una función de callback que se activa cuando el usuario hace clic en el botón |
+| esActivo | booleano | Determina si el botón está en estado activo |
+
+
+
+</Tab>
+
</Tabs>
## Grupo de Botones de Ícono Flotante
<Tabs>
- <Tab title="Uso">
- ```jsx
- import { FloatingIconButtonGroup } from "@/ui/input/button/components/FloatingIconButtonGroup";
- import { IconClipboardText, IconCheckbox } from "@tabler/icons-react";
-
- export const MyComponent = () => {
- const iconButtons = [
- {
- Icon: IconClipboardText,
- onClick: () => console.log("Button 1 clicked"),
- isActive: true,
- },
- {
- Icon: IconCheckbox,
- onClick: () => console.log("Button 2 clicked"),
- isActive: true,
- },
- ];
-
- return (
- <FloatingIconButtonGroup
- className
- size="small"
- iconButtons={iconButtons} />
- );
- };
-
- ```
- </Tab>
-
- <Tab title="Props">
- | Props | Tipo | Descripción |
- | ----------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
- | className | cadena | "Nombre opcional para estilización adicional" |
- | tamaño | cadena | El tamaño del botón. Tiene dos opciones: `pequeño` y `mediano` |
- | iconButtons | array | Una matriz de objetos, cada uno de los cuales representa un botón de icono del grupo. Cada objeto debe incluir el componente de ícono que desea mostrar en el botón, la función que desea llamar cuando un usuario hace clic en el botón y si el botón debe estar activo o no. |
- </Tab>
+<Tab title="Uso">
+
+```jsx
+import { FloatingIconButtonGroup } from "@/ui/input/button/components/FloatingIconButtonGroup";
+import { IconClipboardText, IconCheckbox } from "@tabler/icons-react";
+
+export const MyComponent = () => {
+ const iconButtons = [
+ {
+ Icon: IconClipboardText,
+ onClick: () => console.log("Button 1 clicked"),
+ isActive: true,
+ },
+ {
+ Icon: IconCheckbox,
+ onClick: () => console.log("Button 2 clicked"),
+ isActive: true,
+ },
+ ];
+
+ return (
+ <FloatingIconButtonGroup
+ className
+ size="small"
+ iconButtons={iconButtons} />
+ );
+};
+
+```
+
+</Tab>
+
+<Tab title="Props">
+
+
+| Props | Tipo | Descripción |
+| ----------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| className | cadena | "Nombre opcional para estilización adicional" |
+| tamaño | cadena | El tamaño del botón. Tiene dos opciones: `pequeño` y `mediano` |
+| iconButtons | array | Una matriz de objetos, cada uno de los cuales representa un botón de icono del grupo. Cada objeto debe incluir el componente de ícono que desea mostrar en el botón, la función que desea llamar cuando un usuario hace clic en el botón y si el botón debe estar activo o no. |
+
+
+
+</Tab>
+
</Tabs>
## Botón Claro
<Tabs>
- <Tab title="Uso">
- ```jsx
- import { LightButton } from "@/ui/input/button/components/LightButton";
+<Tab title="Uso">
+
+```jsx
+import { LightButton } from "@/ui/input/button/components/LightButton";
+
+export const MyComponent = () => {
+ return <LightButton
+ className
+ icon={null}
+ title="Title"
+ accent="secondary"
+ active={false}
+ disabled={false}
+ focus={true}
+ onClick={()=>console.log('click')}
+ />;
+};
+```
+
+
+</Tab>
+
+<Tab title="Props">
+
- export const MyComponent = () => {
- return <LightButton
+| Props | Tipo | Descripción |
+| ------------- | ----------------- | ------------------------------------------------------------------------------- |
+| className | cadena | "Nombre opcional para estilización adicional" |
+| ícono | `React.ReactNode` | El ícono que desea mostrar en el botón |
+| título | cadena | El contenido de texto del botón |
+| acento | "cadena" | El color de acento del botón. Las opciones incluyen: `secundario` y `terciario` |
+| activo | booleano | Determina si el botón está en estado activo |
+| deshabilitado | booleano | Determina si el botón está deshabilitado |
+| enfoque | booleano | Indica si el botón tiene foco |
+| alHacerClic | función | Una función de callback que se activa cuando el usuario hace clic en el botón |
+
+
+
+
+</Tab>
+
+</Tabs>
+
+## Botón de Ícono Claro
+
+<Tabs>
+<Tab title="&#x22;Uso&#x22;">
+
+```jsx
+import { LightIconButton } from "@/ui/input/button/components/LightIconButton";
+import { IconSearch } from "@tabler/icons-react";
+
+export const MyComponent = () => {
+ return (
+ <LightIconButton
className
- icon={null}
+ testId="test1"
+ Icon={IconSearch}
title="Title"
+ size="small"
accent="secondary"
- active={false}
+ active={true}
disabled={false}
focus={true}
- onClick={()=>console.log('click')}
- />;
- };
- ```
- </Tab>
-
- <Tab title="Props">
- | Props | Tipo | Descripción |
- | ------------- | ----------------- | ------------------------------------------------------------------------------- |
- | className | cadena | "Nombre opcional para estilización adicional" |
- | ícono | `React.ReactNode` | El ícono que desea mostrar en el botón |
- | título | cadena | El contenido de texto del botón |
- | acento | "cadena" | El color de acento del botón. Las opciones incluyen: `secundario` y `terciario` |
- | activo | booleano | Determina si el botón está en estado activo |
- | deshabilitado | booleano | Determina si el botón está deshabilitado |
- | enfoque | booleano | Indica si el botón tiene foco |
- | alHacerClic | función | Una función de callback que se activa cuando el usuario hace clic en el botón |
- </Tab>
-</Tabs>
+ onClick={() => console.log("click")}
+ />
+ );
+};
+```
-## Botón de Ícono Claro
-<Tabs>
- <Tab title="&#x22;Uso&#x22;">
- ```jsx
- import { LightIconButton } from "@/ui/input/button/components/LightIconButton";
- import { IconSearch } from "@tabler/icons-react";
-
- export const MyComponent = () => {
- return (
- <LightIconButton
- className
- testId="test1"
- Icon={IconSearch}
- title="Title"
- size="small"
- accent="secondary"
- active={true}
- disabled={false}
- focus={true}
- onClick={() => console.log("click")}
- />
- );
- };
- ```
- </Tab>
-
- <Tab title="&#x22;Props&#x22;">
- | "Props" | Tipo | Descripción |
- | ------------- | --------------------- | ----------------------------------------------------------------------------- |
- | "className" | cadena | "Nombre opcional para estilización adicional" |
- | testId | "cadena" | Identificador de prueba para el botón |
- | Ícono | `React.ComponentType` | Un componente de ícono opcional que se muestra dentro del botón |
- | título | "cadena" | El contenido de texto del botón |
- | tamaño | "cadena" | El tamaño del botón. Tiene dos opciones: `pequeño` y `mediano` |
- | acento | "cadena" | El color de acento del botón. Opciones incluyen: `secundario` y `terciario` |
- | activo | booleano | Determina si el botón está en estado activo |
- | "desactivado" | booleano | Determina si el botón está deshabilitado |
- | enfoque | booleano | Indica si el botón tiene foco |
- | alHacerClic | función | Una función de callback que se activa cuando el usuario hace clic en el botón |
- </Tab>
+</Tab>
+
+<Tab title="&#x22;Props&#x22;">
+
+
+| "Props" | Tipo | Descripción |
+| ------------- | --------------------- | ----------------------------------------------------------------------------- |
+| "className" | cadena | "Nombre opcional para estilización adicional" |
+| testId | "cadena" | Identificador de prueba para el botón |
+| Ícono | `React.ComponentType` | Un componente de ícono opcional que se muestra dentro del botón |
+| título | "cadena" | El contenido de texto del botón |
+| tamaño | "cadena" | El tamaño del botón. Tiene dos opciones: `pequeño` y `mediano` |
+| acento | "cadena" | El color de acento del botón. Opciones incluyen: `secundario` y `terciario` |
+| activo | booleano | Determina si el botón está en estado activo |
+| "desactivado" | booleano | Determina si el botón está deshabilitado |
+| enfoque | booleano | Indica si el botón tiene foco |
+| alHacerClic | función | Una función de callback que se activa cuando el usuario hace clic en el botón |
+
+
+
+</Tab>
+
</Tabs>
## Botón Principal
<Tabs>
- <Tab title="Uso">
- ```jsx
- import { MainButton } from "@/ui/input/button/components/MainButton";
- import { IconCheckbox } from "@tabler/icons-react";
-
- export const MyComponent = () => {
- return (
- <MainButton
- title="Checkbox"
- fullWidth={false}
- variant="primary"
- soon={false}
- Icon={IconCheckbox}
- />
- );
- };
- ```
- </Tab>
-
- <Tab title="Propiedades">
- | Propiedades | Tipo | Descripción |
- | -------------------------- | -------------------------------- | ------------------------------------------------------------------------------------- |
- | título | "cadena" | El contenido de texto del botón |
- | anchoCompleto | booleano | Define si el botón debe abarcar todo el ancho de su contenedor |
- | variante | "cadena" | La variante de estilo visual del botón. Las opciones incluyen `primary` y `secondary` |
- | próximamente | booleano | Indica si el botón está marcado como "próximamente" (como para funciones futuras) |
- | Ícono | `React.ComponentType` | Un componente de ícono opcional que se muestra dentro del botón |
- | Propiedades React `button` | `React.ComponentProps<'button'>` | Se admiten todas las propiedades estándar del botón HTML |
- </Tab>
+<Tab title="Uso">
+
+```jsx
+import { MainButton } from "@/ui/input/button/components/MainButton";
+import { IconCheckbox } from "@tabler/icons-react";
+
+export const MyComponent = () => {
+ return (
+ <MainButton
+ title="Checkbox"
+ fullWidth={false}
+ variant="primary"
+ soon={false}
+ Icon={IconCheckbox}
+ />
+ );
+};
+```
+
+
+</Tab>
+
+<Tab title="Propiedades">
+
+
+| Propiedades | Tipo | Descripción |
+| -------------------------- | -------------------------------- | ------------------------------------------------------------------------------------- |
+| título | "cadena" | El contenido de texto del botón |
+| anchoCompleto | booleano | Define si el botón debe abarcar todo el ancho de su contenedor |
+| variante | "cadena" | La variante de estilo visual del botón. Las opciones incluyen `primary` y `secondary` |
+| próximamente | booleano | Indica si el botón está marcado como "próximamente" (como para funciones futuras) |
+| Ícono | `React.ComponentType` | Un componente de ícono opcional que se muestra dentro del botón |
+| Propiedades React `button` | `React.ComponentProps<'button'>` | Se admiten todas las propiedades estándar del botón HTML |
+
+
+
+
+</Tab>
+
</Tabs>
## Botón de Icono Redondeado
<Tabs>
- <Tab title="&#x22;Uso&#x22;">
- ```jsx
- import { RoundedIconButton } from "@/ui/input/button/components/RoundedIconButton";
- import { IconSearch } from "@tabler/icons-react";
-
- export const MyComponent = () => {
- return (
- <RoundedIconButton
- Icon={IconSearch}
- />
- );
- };
- ```
- </Tab>
-
- <Tab title="&#x22;Props&#x22;">
- | "Props" | Tipo | Descripción |
- | -------------------------- | ----------------------------------------------- | ----------- |
- | Ícono | `React.ComponentType` | |
- | Propiedades React `button` | `React.ButtonHTMLAttributes<HTMLButtonElement>` | |
- </Tab>
+<Tab title="&#x22;Uso&#x22;">
+
+```jsx
+import { RoundedIconButton } from "@/ui/input/button/components/RoundedIconButton";
+import { IconSearch } from "@tabler/icons-react";
+
+export const MyComponent = () => {
+ return (
+ <RoundedIconButton
+ Icon={IconSearch}
+ />
+ );
+};
+```
+
+
+</Tab>
+
+<Tab title="&#x22;Props&#x22;">
+
+
+| "Props" | Tipo | Descripción |
+| -------------------------- | ----------------------------------------------- | ----------- |
+| Ícono | `React.ComponentType` | |
+| Propiedades React `button` | `React.ButtonHTMLAttributes<HTMLButtonElement>` | |
+
+
+
+</Tab>
+
</Tabs>
diff --git a/packages/twenty-docs/l/es/twenty-ui/input/checkbox.mdx b/packages/twenty-docs/l/es/twenty-ui/input/checkbox.mdx
index 331db4148a2..df970cd89e7 100644
--- a/packages/twenty-docs/l/es/twenty-ui/input/checkbox.mdx
+++ b/packages/twenty-docs/l/es/twenty-ui/input/checkbox.mdx
@@ -1,5 +1,6 @@
---
title: Caja de selección
+icon: square-check
---
<Frame>
@@ -9,35 +10,41 @@ title: Caja de selección
Usado cuando un usuario necesita seleccionar múltiples valores entre varias opciones.
<Tabs>
- <Tab title="Uso">
- ```jsx
- import { Checkbox } from "twenty-ui/display";
-
- export const MyComponent = () => {
- return (
- <Checkbox
- checked={true}
- indeterminate={false}
- onChange={() => console.log("onChange function fired")}
- onCheckedChange={() => console.log("onCheckedChange function fired")}
- variant="primary"
- size="small"
- shape="squared"
- />
- );
- };
- ```
- </Tab>
-
- <Tab title="Props">
- | Props | Tipo | Descripción |
- | --------------- | -------- | ------------------------------------------------------------------------------------------------------ |
- | marcado | booleano | Indica si la caja de selección está marcada |
- | indeterminado | booleano | Indica si la caja de selección está en un estado indeterminado (ni marcada ni desmarcada) |
- | onChange | función | La función de devolución de llamada que desea activar cuando cambia el estado de la caja de selección |
- | onCheckedChange | función | La función de devolución de llamada que desea activar cuando cambia el estado `marcado` |
- | variante | cadena | La variante de estilo visual de la caja. Las opciones incluyen: `primario`, `secundario` y `terciario` |
- | tamaño | cadena | El tamaño de la caja de selección. Tiene dos opciones: `pequeño` y `grande` |
- | forma | cadena | La forma de la caja de selección. Tiene dos opciones: `cuadrado` y `redondeado` |
- </Tab>
+<Tab title="Uso">
+
+```jsx
+import { Checkbox } from "twenty-ui/display";
+
+export const MyComponent = () => {
+ return (
+ <Checkbox
+ checked={true}
+ indeterminate={false}
+ onChange={() => console.log("onChange function fired")}
+ onCheckedChange={() => console.log("onCheckedChange function fired")}
+ variant="primary"
+ size="small"
+ shape="squared"
+ />
+ );
+};
+```
+
+</Tab>
+<Tab title="Props">
+
+
+| Props | Tipo | Descripción |
+| --------------- | -------- | ------------------------------------------------------------------------------------------------------ |
+| marcado | booleano | Indica si la caja de selección está marcada |
+| indeterminado | booleano | Indica si la caja de selección está en un estado indeterminado (ni marcada ni desmarcada) |
+| onChange | función | La función de devolución de llamada que desea activar cuando cambia el estado de la caja de selección |
+| onCheckedChange | función | La función de devolución de llamada que desea activar cuando cambia el estado `marcado` |
+| variante | cadena | La variante de estilo visual de la caja. Las opciones incluyen: `primario`, `secundario` y `terciario` |
+| tamaño | cadena | El tamaño de la caja de selección. Tiene dos opciones: `pequeño` y `grande` |
+| forma | cadena | La forma de la caja de selección. Tiene dos opciones: `cuadrado` y `redondeado` |
+
+
+
+</Tab>
</Tabs>
diff --git a/packages/twenty-docs/l/es/twenty-ui/input/color-scheme.mdx b/packages/twenty-docs/l/es/twenty-ui/input/color-scheme.mdx
index 2a263ec44be..569cc2eb3b7 100644
--- a/packages/twenty-docs/l/es/twenty-ui/input/color-scheme.mdx
+++ b/packages/twenty-docs/l/es/twenty-ui/input/color-scheme.mdx
@@ -1,5 +1,6 @@
---
title: Esquema de colores
+icon: paleta
---
<Frame>
@@ -11,28 +12,36 @@ title: Esquema de colores
Representa diferentes esquemas de color y está diseñado especialmente para temas claros y oscuros.
<Tabs>
- <Tab title="&#x22;Uso&#x22;">
- ```jsx
- import { ColorSchemeCard } from "twenty-ui/display";
-
- export const MyComponent = () => {
- return (
- <ColorSchemeCard
- variant="Dark"
- selected={true}
- />
- );
- };
- ```
- </Tab>
-
- <Tab title="&#x22;Props&#x22;">
- | "Props" | Tipo | Descripción | Predeterminado |
- | ----------------- | --------------------------------------- | -------------------------------------------------------------------------------------------------- | -------------- |
- | variante | string | La variante del esquema de color. Las opciones incluyen `Oscuro`, `Claro` y `Sistema` | claro |
- | seleccionado | booleano | Si es `verdadero`, muestra una marca de verificación para indicar el esquema de color seleccionado | |
- | props adicionales | `React.ComponentPropsWithoutRef<'div'>` | Props del elemento HTML estándar `div` | |
- </Tab>
+<Tab title="&#x22;Uso&#x22;">
+
+```jsx
+import { ColorSchemeCard } from "twenty-ui/display";
+
+export const MyComponent = () => {
+ return (
+ <ColorSchemeCard
+ variant="Dark"
+ selected={true}
+ />
+ );
+};
+```
+
+</Tab>
+
+<Tab title="&#x22;Props&#x22;">
+
+
+| "Props" | Tipo | Descripción | Predeterminado |
+| ----------------- | --------------------------------------- | -------------------------------------------------------------------------------------------------- | -------------- |
+| variante | string | La variante del esquema de color. Las opciones incluyen `Oscuro`, `Claro` y `Sistema` | claro |
+| seleccionado | booleano | Si es `verdadero`, muestra una marca de verificación para indicar el esquema de color seleccionado | |
+| props adicionales | `React.ComponentPropsWithoutRef<'div'>` | Props del elemento HTML estándar `div` | |
+
+
+
+</Tab>
+
</Tabs>
## Selector de Esquema de Color
@@ -40,23 +49,31 @@ Representa diferentes esquemas de color y está diseñado especialmente para tem
Permite a los usuarios elegir entre diferentes esquemas de color.
<Tabs>
- <Tab title="&#x22;Uso&#x22;">
- ```jsx
- import { ColorSchemePicker } from "twenty-ui/display";
-
- export const MyComponent = () => {
- return <ColorSchemePicker
- value="Dark"
- onChange
- />;
- };
- ```
- </Tab>
-
- <Tab title="&#x22;Props&#x22;">
- | "Props" | Tipo | Descripción |
- | ---------- | -------------------- | ------------------------------------------------------------------------------------------------------ |
- | valor | `Esquema de colores` | El esquema de color actualmente seleccionado |
- | "onChange" | función | La función de devolución de llamada que desea activar cuando un usuario selecciona un esquema de color |
- </Tab>
+<Tab title="&#x22;Uso&#x22;">
+
+```jsx
+import { ColorSchemePicker } from "twenty-ui/display";
+
+export const MyComponent = () => {
+ return <ColorSchemePicker
+ value="Dark"
+ onChange
+ />;
+};
+```
+
+</Tab>
+
+<Tab title="&#x22;Props&#x22;">
+
+
+| "Props" | Tipo | Descripción |
+| ---------- | -------------------- | ------------------------------------------------------------------------------------------------------ |
+| valor | `Esquema de colores` | El esquema de color actualmente seleccionado |
+| "onChange" | función | La función de devolución de llamada que desea activar cuando un usuario selecciona un esquema de color |
+
+
+
+</Tab>
+
</Tabs>
diff --git a/packages/twenty-docs/l/es/twenty-ui/input/icon-picker.mdx b/packages/twenty-docs/l/es/twenty-ui/input/icon-picker.mdx
index 091bdbddc98..444ebd88f21 100644
--- a/packages/twenty-docs/l/es/twenty-ui/input/icon-picker.mdx
+++ b/packages/twenty-docs/l/es/twenty-ui/input/icon-picker.mdx
@@ -9,40 +9,49 @@ title: Selector de Íconos
Un selector de íconos basado en un menú desplegable que permite a los usuarios seleccionar un ícono de una lista.
<Tabs>
- <Tab title="Uso">
- ```jsx
- import React, { useState } from "react";
- import { IconPicker } from "@/ui/input/components/IconPicker";
-
- export const MyComponent = () => {
-
- const [selectedIcon, setSelectedIcon] = useState("");
- const handleIconChange = ({ iconKey, Icon }) => {
- console.log("Selected Icon:", iconKey);
- setSelectedIcon(iconKey);
- };
-
- return (
- <IconPicker
- disabled={false}
- onChange={handleIconChange}
- selectedIconKey={selectedIcon}
- variant="primary"
- />
- );
- };
- ```
- </Tab>
-
- <Tab title="Props">
- | Props | Tipo | Descripción |
- | --------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
- | deshabilitado | booleano | Desactiva el selector de íconos si está configurado en `true` |
- | "onChange" | función | La función de devolución de llamada que se activa cuando el usuario selecciona un icono. Recibe un objeto con las propiedades `iconKey` y `Icon` |
- | selectedIconKey | cadena | La clave del ícono seleccionado inicialmente |
- | onClickOutside | función | Función de devolución de llamada que se activa cuando el usuario hace clic fuera del menú desplegable |
- | onClose | función | Función de devolución de llamada que se activa cuando se cierra el menú desplegable |
- | onOpen | función | Función de devolución de llamada que se activa cuando se abre el menú desplegable |
- | variante | cadena | La variante de estilo visual del ícono clicable. Las opciones incluyen: `primario`, `secundario` y `terciario` |
- </Tab>
+
+<Tab title="Uso">
+
+```jsx
+import React, { useState } from "react";
+import { IconPicker } from "@/ui/input/components/IconPicker";
+
+export const MyComponent = () => {
+
+ const [selectedIcon, setSelectedIcon] = useState("");
+ const handleIconChange = ({ iconKey, Icon }) => {
+ console.log("Ícono Seleccionado:", iconKey);
+ setSelectedIcon(iconKey);
+ };
+
+ return (
+ <IconPicker
+ disabled={false}
+ onChange={handleIconChange}
+ selectedIconKey={selectedIcon}
+ variant="primary"
+ />
+ );
+};
+```
+
+
+</Tab>
+<Tab title="Props">
+
+
+| Props | Tipo | Descripción |
+| --------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
+| deshabilitado | booleano | Desactiva el selector de íconos si está configurado en `true` |
+| "onChange" | función | La función de devolución de llamada que se activa cuando el usuario selecciona un icono. Recibe un objeto con las propiedades `iconKey` y `Icon` |
+| selectedIconKey | cadena | La clave del ícono seleccionado inicialmente |
+| onClickOutside | función | Función de devolución de llamada que se activa cuando el usuario hace clic fuera del menú desplegable |
+| onClose | función | Función de devolución de llamada que se activa cuando se cierra el menú desplegable |
+| onOpen | función | Función de devolución de llamada que se activa cuando se abre el menú desplegable |
+| variante | cadena | La variante de estilo visual del ícono clicable. Las opciones incluyen: `primario`, `secundario` y `terciario` |
+
+
+
+
+</Tab>
</Tabs>
diff --git a/packages/twenty-docs/l/es/twenty-ui/input/image-input.mdx b/packages/twenty-docs/l/es/twenty-ui/input/image-input.mdx
index 33c080f3a18..f6cb265214d 100644
--- a/packages/twenty-docs/l/es/twenty-ui/input/image-input.mdx
+++ b/packages/twenty-docs/l/es/twenty-ui/input/image-input.mdx
@@ -9,25 +9,32 @@ title: Entrada de imagen
Permite a los usuarios subir y eliminar una imagen.
<Tabs>
- <Tab title="Uso">
- ```jsx
- import { ImageInput } from "@/ui/input/components/ImageInput";
-
- export const MyComponent = () => {
- return <ImageInput/>;
- };
- ```
- </Tab>
-
- <Tab title="Props">
- | Props | Tipo | Descripción |
- | ------------- | -------- | ---------------------------------------------------------------------------------------------------------- |
- | foto | cadena | La URL de origen de la imagen |
- | onUpload | función | La función que se llama cuando un usuario sube una nueva imagen. Recibe el objeto `File` como un parámetro |
- | onRemove | función | La función que se llama cuando el usuario hace clic en el botón eliminar |
- | onAbort | función | La función que se llama cuando un usuario hace clic en el botón de abortar durante la subida de imagen |
- | isUploading | booleano | Indica si una imagen se está cargando actualmente |
- | errorMessage | cadena | Un mensaje de error opcional para mostrar debajo de la entrada de imagen |
- | "desactivado" | booleano | Si es `true`, toda la entrada está deshabilitada y los botones no son clicables |
- </Tab>
+<Tab title="Uso">
+
+```jsx
+import { ImageInput } from "@/ui/input/components/ImageInput";
+
+export const MyComponent = () => {
+ return <ImageInput/>;
+};
+```
+
+</Tab>
+<Tab title="Props">
+
+
+| Props | Tipo | Descripción |
+| ------------- | -------- | ---------------------------------------------------------------------------------------------------------- |
+| foto | cadena | La URL de origen de la imagen |
+| onUpload | función | La función que se llama cuando un usuario sube una nueva imagen. Recibe el objeto `File` como un parámetro |
+| onRemove | función | La función que se llama cuando el usuario hace clic en el botón eliminar |
+| onAbort | función | La función que se llama cuando un usuario hace clic en el botón de abortar durante la subida de imagen |
+| isUploading | booleano | Indica si una imagen se está cargando actualmente |
+| errorMessage | cadena | Un mensaje de error opcional para mostrar debajo de la entrada de imagen |
+| "desactivado" | booleano | Si es `true`, toda la entrada está deshabilitada y los botones no son clicables |
+
+
+
+
+</Tab>
</Tabs>
diff --git a/packages/twenty-docs/l/es/twenty-ui/input/radio.mdx b/packages/twenty-docs/l/es/twenty-ui/input/radio.mdx
index f509b445d48..15e4295df4c 100644
--- a/packages/twenty-docs/l/es/twenty-ui/input/radio.mdx
+++ b/packages/twenty-docs/l/es/twenty-ui/input/radio.mdx
@@ -1,5 +1,6 @@
---
title: Radio
+icon: circle-dot
---
<Frame>
@@ -9,50 +10,58 @@ title: Radio
Usado cuando los usuarios solo pueden elegir una opción de una serie de opciones.
<Tabs>
- <Tab title="Uso">
- ```jsx
- import { Radio } from "twenty-ui/display";
-
- export const MyComponent = () => {
-
- const handleRadioChange = (event) => {
- console.log("Radio button changed:", event.target.checked);
- };
-
- const handleCheckedChange = (checked) => {
- console.log("Checked state changed:", checked);
- };
-
-
- return (
- <Radio
- checked={true}
- value="Option 1"
- onChange={handleRadioChange}
- onCheckedChange={handleCheckedChange}
- size="large"
- disabled={false}
- labelPosition="right"
- />
- );
- };
-
- ```
- </Tab>
-
- <Tab title="Props">
- | Props | Tipo | Descripción |
- | --------------- | -------------------------- | --------------------------------------------------------------------------------------------------------------------- |
- | estilo | propiedades de `React.CSS` | Estilos en línea adicionales para el componente. |
- | "className" | cadena | Clase CSS opcional para estilo adicional. |
- | marcado | booleano | Indica si el botón de opción está marcado. |
- | valor | cadena | La etiqueta o texto asociado con el botón de opción. |
- | "onChange" | función | La función que se llama cuando se cambia el botón de opción seleccionado. |
- | onCheckedChange | función | La función que se llama cuando el estado de `seleccionado` del botón de opción cambia. |
- | tamaño | cadena | El tamaño del botón de opción. Las opciones incluyen: `grande` y `pequeño`. |
- | "desactivado" | booleano | Si es `verdadero`, el botón de opción está deshabilitado y no se puede hacer clic. |
- | labelPosition | cadena | La posición del texto de la etiqueta en relación con el botón de opción. Tiene dos opciones: `izquierda` y `derecha`. |
- </Tab>
+<Tab title="Uso">
+
+```jsx
+import { Radio } from "twenty-ui/display";
+
+export const MyComponent = () => {
+
+ const handleRadioChange = (event) => {
+ console.log("Radio button changed:", event.target.checked);
+ };
+
+ const handleCheckedChange = (checked) => {
+ console.log("Checked state changed:", checked);
+ };
+
+
+ return (
+ <Radio
+ checked={true}
+ value="Option 1"
+ onChange={handleRadioChange}
+ onCheckedChange={handleCheckedChange}
+ size="large"
+ disabled={false}
+ labelPosition="right"
+ />
+ );
+};
+
+```
+
+
+</Tab>
+<Tab title="Props">
+
+
+| Props | Tipo | Descripción |
+| --------------- | -------------------------- | --------------------------------------------------------------------------------------------------------------------- |
+| estilo | propiedades de `React.CSS` | Estilos en línea adicionales para el componente. |
+| "className" | cadena | Clase CSS opcional para estilo adicional. |
+| marcado | booleano | Indica si el botón de opción está marcado. |
+| valor | cadena | La etiqueta o texto asociado con el botón de opción. |
+| "onChange" | función | La función que se llama cuando se cambia el botón de opción seleccionado. |
+| onCheckedChange | función | La función que se llama cuando el estado de `seleccionado` del botón de opción cambia. |
+| tamaño | cadena | El tamaño del botón de opción. Las opciones incluyen: `grande` y `pequeño`. |
+| "desactivado" | booleano | Si es `verdadero`, el botón de opción está deshabilitado y no se puede hacer clic. |
+| labelPosition | cadena | La posición del texto de la etiqueta en relación con el botón de opción. Tiene dos opciones: `izquierda` y `derecha`. |
+
+
+
+
+</Tab>
</Tabs>
## Grupo de Radio
@@ -60,37 +69,45 @@ Usado cuando los usuarios solo pueden elegir una opción de una serie de opcione
Agrupa botones de opción relacionados.
<Tabs>
- <Tab title="Uso">
- ```jsx
- import React, { useState } from "react";
- import { Radio, RadioGroup } from "twenty-ui/display";
-
- export const MyComponent = () => {
-
- const [selectedValue, setSelectedValue] = useState("Option 1");
-
- const handleChange = (event) => {
- setSelectedValue(event.target.value);
- };
-
- return (
- <RadioGroup value={selectedValue} onChange={handleChange}>
- <Radio value="Option 1" />
- <Radio value="Option 2" />
- <Radio value="Option 3" />
- </RadioGroup>
- );
- };
-
- ```
- </Tab>
-
- <Tab title="Props">
- | Props | Tipo | Descripción |
- | --------------- | ----------------- | ----------------------------------------------------------------------------------------------------- |
- | valor | cadena | El valor del botón de opción seleccionado actualmente. |
- | "onChange" | función | La función de devolución de llamada que se activa cuando se cambia el botón de opción. |
- | alCambioDeValor | función | La función de devolución de llamada que se activa cuando se cambia el valor seleccionado en el grupo. |
- | hijos | `React.ReactNode` | Permite pasar componentes de React (como Radio) como hijos al Radio Group. |
- </Tab>
+<Tab title="Uso">
+
+```jsx
+import React, { useState } from "react";
+import { Radio, RadioGroup } from "twenty-ui/display";
+
+export const MyComponent = () => {
+
+ const [selectedValue, setSelectedValue] = useState("Option 1");
+
+ const handleChange = (event) => {
+ setSelectedValue(event.target.value);
+ };
+
+ return (
+ <RadioGroup value={selectedValue} onChange={handleChange}>
+ <Radio value="Option 1" />
+ <Radio value="Option 2" />
+ <Radio value="Option 3" />
+ </RadioGroup>
+ );
+};
+
+```
+
+</Tab>
+<Tab title="Props">
+
+
+| Props | Tipo | Descripción |
+| --------------- | ----------------- | ----------------------------------------------------------------------------------------------------- |
+| valor | cadena | El valor del botón de opción seleccionado actualmente. |
+| "onChange" | función | La función de devolución de llamada que se activa cuando se cambia el botón de opción. |
+| alCambioDeValor | función | La función de devolución de llamada que se activa cuando se cambia el valor seleccionado en el grupo. |
+| hijos | `React.ReactNode` | Permite pasar componentes de React (como Radio) como hijos al Radio Group. |
+
+
+
+
+</Tab>
+
</Tabs>
diff --git a/packages/twenty-docs/l/es/twenty-ui/input/select.mdx b/packages/twenty-docs/l/es/twenty-ui/input/select.mdx
index f40f6fecd17..8f9992bbdae 100644
--- a/packages/twenty-docs/l/es/twenty-ui/input/select.mdx
+++ b/packages/twenty-docs/l/es/twenty-ui/input/select.mdx
@@ -9,39 +9,46 @@ title: Seleccionar
Permite a los usuarios seleccionar un valor de una lista de opciones predefinidas.
<Tabs>
- <Tab title="Uso">
- ```jsx
- import { IconTwentyStar } from 'twenty-ui/display';
-
- import { Select } from '@/ui/input/components/Select';
-
- export const MyComponent = () => {
-
- return (
- <Select
- className
- disabled={false}
- label="Selecciona una opción"
- options={[
- { value: 'option1', label: 'Opción A', Icon: IconTwentyStar },
- { value: 'option2', label: 'Opción B', Icon: IconTwentyStar },
- ]}
- value="option1"
- />
- );
- };
-
- ```
- </Tab>
-
- <Tab title="Props">
- | Props | Tipo | Descripción |
- | ------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
- | nombreDeClase | cadena | Clase CSS opcional para estilo adicional |
- | "desactivado" | booleano | Cuando se establece en `true`, desactiva la interacción del usuario con el componente |
- | etiqueta | cadena | La etiqueta para describir el propósito del componente `Seleccionar` |
- | "onChange" | función | La función que se llama cuando los valores seleccionados cambian |
- | opciones | array | Representa las opciones disponibles para el componente `Selected`. Es un arreglo de objetos donde cada objeto tiene un `valor` (el identificador único), `etiqueta` (el identificador único), y un `Icono` opcional |
- | valor | cadena | Representa el valor actualmente seleccionado. Debe coincidir con una de las propiedades `valor` en el arreglo de `opciones`. |
- </Tab>
+<Tab title="Uso">
+
+```jsx
+import { IconTwentyStar } from 'twenty-ui/display';
+
+import { Select } from '@/ui/input/components/Select';
+
+export const MyComponent = () => {
+
+ return (
+ <Select
+ className
+ disabled={false}
+ label="Selecciona una opción"
+ options={[
+ { value: 'option1', label: 'Opción A', Icon: IconTwentyStar },
+ { value: 'option2', label: 'Opción B', Icon: IconTwentyStar },
+ ]}
+ value="option1"
+ />
+ );
+};
+
+```
+
+</Tab>
+<Tab title="Props">
+
+
+| Propiedades | Tipo | Descripción |
+| ------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| nombreDeClase | cadena | Clase CSS opcional para estilo adicional |
+| "desactivado" | booleano | Cuando se establece en `true`, desactiva la interacción del usuario con el componente |
+| etiqueta | cadena | La etiqueta para describir el propósito del componente `Seleccionar` |
+| "onChange" | función | La función que se llama cuando los valores seleccionados cambian |
+| opciones | array | Representa las opciones disponibles para el componente `Selected`. Es un arreglo de objetos donde cada objeto tiene un `valor` (el identificador único), `etiqueta` (el identificador único), y un `Icono` opcional |
+| valor | cadena | Representa el valor actualmente seleccionado. Debe coincidir con una de las propiedades `valor` en el arreglo de `opciones`. |
+
+
+
+
+</Tab>
</Tabs>
diff --git a/packages/twenty-docs/l/es/twenty-ui/input/text.mdx b/packages/twenty-docs/l/es/twenty-ui/input/text.mdx
index 67943ef7380..eec504cc29c 100644
--- a/packages/twenty-docs/l/es/twenty-ui/input/text.mdx
+++ b/packages/twenty-docs/l/es/twenty-ui/input/text.mdx
@@ -1,6 +1,5 @@
---
title: Texto
-image: '"/images/user-guide/notes/notes_header.png"'
---
<Frame>
@@ -12,50 +11,61 @@ image: '"/images/user-guide/notes/notes_header.png"'
"Permite a los usuarios ingresar y editar texto."
<Tabs>
- <Tab title="&#x22;Uso&#x22;">
- ```jsx
- import { TextInput } from "@/ui/input/components/TextInput";
-
- export const MyComponent = () => {
- const handleChange = (text) => {
- console.log("Entrada modificada:", text);
- };
-
- const handleKeyDown = (event) => {
- console.log("Tecla presionada:", event.key);
- };
-
- return (
- <TextInput
- className
- label="Nombre de usuario"
- onChange={handleChange}
- fullWidth={false}
- disableHotkeys={false}
- error="Nombre de usuario no válido"
- onKeyDown={handleKeyDown}
- RightIcon={null}
- />
- );
- };
- },{
- ```
- </Tab>
-
- <Tab title="&#x22;Props&#x22;">
- | "Props" | Tipo | Descripción |
- | -------------- | ----------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
- | "className" | string | "Nombre opcional para estilización adicional" |
- | etiqueta | string | "Representa la etiqueta para la entrada" |
- | "onChange" | "función" | "La función que se llama cuando el valor de entrada cambia" |
- | "fullWidth" | booleano | "Indica si la entrada debe ocupar el 100% del ancho" |
- | disableHotkeys | booleano | "Indica si las teclas rápidas están habilitadas para la entrada" |
- | error | cadena | "Representa el mensaje de error que se mostrará." "Cuando se proporciona, también se añade un icono de error en el lado derecho de la entrada" |
- | "onKeyDown" | "función" | "Se llama cuando se presiona una tecla mientras el campo de entrada está enfocado." "Recibe un `React.KeyboardEvent` como argumento" |
- | RightIcon | "ComponenteIcono" | "Un componente opcional de icono que se muestra en el lado derecho de la entrada" |
-
- "El componente también acepta otras props de elementos de entrada HTML."
- </Tab>
+
+<Tab title="&#x22;Uso&#x22;">
+
+```jsx
+import { TextInput } from "@/ui/input/components/TextInput";
+
+export const MyComponent = () => {
+ const handleChange = (text) => {
+ console.log("Input changed:", text);
+ };
+
+ const handleKeyDown = (event) => {
+ console.log("Key pressed:", event.key);
+ };
+
+ return (
+ <TextInput
+ className
+ label="Username"
+ onChange={handleChange}
+ fullWidth={false}
+ disableHotkeys={false}
+ error="Invalid username"
+ onKeyDown={handleKeyDown}
+ RightIcon={null}
+ />
+ );
+};
+
+```
+
+
+</Tab>
+
+<Tab title="&#x22;Props&#x22;">
+
+
+| Propiedades | Tipo | Descripción |
+| -------------- | ----------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
+| "className" | string | "Nombre opcional para estilización adicional" |
+| etiqueta | string | "Representa la etiqueta para la entrada" |
+| "onChange" | "función" | "La función que se llama cuando el valor de entrada cambia" |
+| "fullWidth" | booleano | "Indica si la entrada debe ocupar el 100% del ancho" |
+| disableHotkeys | booleano | "Indica si las teclas rápidas están habilitadas para la entrada" |
+| error | cadena | "Representa el mensaje de error que se mostrará." "Cuando se proporciona, también se añade un icono de error en el lado derecho de la entrada" |
+| "onKeyDown" | "función" | "Se llama cuando se presiona una tecla mientras el campo de entrada está enfocado." "Recibe un `React.KeyboardEvent` como argumento" |
+| RightIcon | "ComponenteIcono" | "Un componente opcional de icono que se muestra en el lado derecho de la entrada" |
+
+
+
+
+"El componente también acepta otras props de elementos de entrada HTML."
+
+</Tab>
+
</Tabs>
## "Entrada de Texto que se ajusta automáticamente"
@@ -63,37 +73,48 @@ image: '"/images/user-guide/notes/notes_header.png"'
"Componente de entrada de texto que ajusta automáticamente su altura según el contenido."
<Tabs>
- <Tab title="&#x22;Uso&#x22;">
- ```jsx
- import { AutosizeTextInput } from "@/ui/input/components/AutosizeTextInput";
-
- export const MyComponent = () => {
- return (
- <AutosizeTextInput
- onValidate={() => console.log("Función onValidate ejecutada")}
- minRows={1}
- placeholder="Escribe un comentario"
- onFocus={() => console.log("Función onFocus ejecutada")}
- variant="icon"
- buttonTitle
- value="Tarea: "
- />
- );
- };
- ```
- </Tab>
-
- <Tab title="&#x22;Props&#x22;">
- | "Props" | Tipo | Descripción |
- | -------------------- | --------- | ----------------------------------------------------------------------------------------- |
- | "onValidate" | "función" | La función de devolución de llamada que desea activar cuando el usuario valida la entrada |
- | minRows | número | "El número mínimo de filas para el área de texto" |
- | marcador de posición | "cadena" | "El texto de marcador de posición que deseas mostrar cuando el área de texto está vacía" |
- | onFocus | "función" | "La función de retorno que deseas activar cuando el área de texto gana el foco" |
- | variante | "cadena" | "La variante de la entrada." "Las opciones incluyen: `default`, `icon`, y `button`" |
- | buttonTitle | "cadena" | "El título para el botón (solo aplicable para la variante de botón)" |
- | valor | "cadena" | "El valor inicial para el área de texto" |
- </Tab>
+
+<Tab title="&#x22;Uso&#x22;">
+
+```jsx
+import { AutosizeTextInput } from "@/ui/input/components/AutosizeTextInput";
+
+export const MyComponent = () => {
+ return (
+ <AutosizeTextInput
+ onValidate={() => console.log("onValidate function fired")}
+ minRows={1}
+ placeholder="Write a comment"
+ onFocus={() => console.log("onFocus function fired")}
+ variant="icon"
+ buttonTitle
+ value="Task: "
+ />
+ );
+};
+```
+
+
+</Tab>
+
+<Tab title="&#x22;Props&#x22;">
+
+
+| Propiedades | Tipo | Descripción |
+| -------------------- | --------- | ----------------------------------------------------------------------------------------- |
+| "onValidate" | "función" | La función de devolución de llamada que desea activar cuando el usuario valida la entrada |
+| minRows | número | "El número mínimo de filas para el área de texto" |
+| marcador de posición | "cadena" | "El texto de marcador de posición que deseas mostrar cuando el área de texto está vacía" |
+| onFocus | "función" | "La función de retorno que deseas activar cuando el área de texto gana el foco" |
+| variante | "cadena" | "La variante de la entrada." "Las opciones incluyen: `default`, `icon`, y `button`" |
+| buttonTitle | "cadena" | "El título para el botón (solo aplicable para la variante de botón)" |
+| valor | "cadena" | "El valor inicial para el área de texto" |
+
+
+
+
+</Tab>
+
</Tabs>
## "Área de Texto"
@@ -101,31 +122,40 @@ image: '"/images/user-guide/notes/notes_header.png"'
"Te permite crear entradas de texto de varias líneas."
<Tabs>
- <Tab title="&#x22;Uso&#x22;">
- ```jsx
- import { TextArea } from "@/ui/input/components/TextArea";
-
- export const MyComponent = () => {
- return (
- <TextArea
- disabled={false}
- minRows={4}
- onChange={()=>console.log('Función onChange ejecutada')}
- placeholder="Introduce texto aquí"
- value=""
- />
- );
- };
- ```
- </Tab>
-
- <Tab title="&#x22;Props&#x22;">
- | "Props" | Tipo | Descripción |
- | -------------------- | --------- | --------------------------------------------------------------------------- |
- | "desactivado" | booleano | "Indica si el área de texto está desactivada" |
- | minRows | número | "Número mínimo de filas visibles para el área de texto." |
- | "onChange" | "función" | Función de llamada activada cuando cambia el contenido del área de texto. |
- | marcador de posición | cadena | Texto del marcador de posición mostrado cuando el área de texto está vacía. |
- | valor | cadena | El valor actual del área de texto. |
- </Tab>
+<Tab title="&#x22;Uso&#x22;">
+
+```jsx
+import { TextArea } from "@/ui/input/components/TextArea";
+
+export const MyComponent = () => {
+ return (
+ <TextArea
+ disabled={false}
+ minRows={4}
+ onChange={()=>console.log('Función onChange ejecutada')}
+ placeholder="Introduce texto aquí"
+ value=""
+ />
+ );
+};
+```
+
+
+</Tab>
+
+<Tab title="&#x22;Props&#x22;">
+
+
+| Propiedades | Tipo | Descripción |
+| -------------------- | --------- | --------------------------------------------------------------------------- |
+| "desactivado" | booleano | "Indica si el área de texto está desactivada" |
+| minRows | número | "Número mínimo de filas visibles para el área de texto." |
+| "onChange" | "función" | Función de llamada activada cuando cambia el contenido del área de texto. |
+| marcador de posición | cadena | Texto del marcador de posición mostrado cuando el área de texto está vacía. |
+| valor | cadena | El valor actual del área de texto. |
+
+
+
+
+</Tab>
</Tabs>
diff --git a/packages/twenty-docs/l/es/twenty-ui/input/toggle.mdx b/packages/twenty-docs/l/es/twenty-ui/input/toggle.mdx
index 15c655b70bb..f1253197ab9 100644
--- a/packages/twenty-docs/l/es/twenty-ui/input/toggle.mdx
+++ b/packages/twenty-docs/l/es/twenty-ui/input/toggle.mdx
@@ -1,32 +1,38 @@
---
title: Cambiar
+icon: toggle-on
---
-
<Tabs>
- <Tab title="Uso">
- ```jsx
- import { Toggle } from "twenty-ui/input";
-
- export const MyComponent = () => {
- return (
- <Toggle
- value = {true}
- onChange = {()=>console.log('Evento onChange')}
- color="green"
- toggleSize = "medium"
- />
- );
- };
- ```
- </Tab>
-
- <Tab title="&#x22;Props&#x22;">
- | "Props" | Tipo | Descripción | Predeterminado |
- | --------------- | -------- | ---------------------------------------------------------------------------------------------------------------------- | ---------------- |
- | valor | booleano | El estado actual del interruptor de palanca | `falso` |
- | "onChange" | función | Función de retorno que se activa cuando el estado del interruptor de palanca cambia | |
- | color | cadena | Color del interruptor de palanca cuando | es de color azul |
- | tamañoConmutado | cadena | Tamaño del interruptor de palanca, que afecta tanto la altura como el ancho. Tiene dos opciones: `pequeño` y `mediano` | mediano |
- </Tab>
+<Tab title="Uso">
+
+```jsx
+import { Toggle } from "twenty-ui/input";
+
+export const MyComponent = () => {
+ return (
+ <Toggle
+ value = {true}
+ onChange = {()=>console.log('Evento onChange')}
+ color="green"
+ toggleSize = "medium"
+ />
+ );
+};
+```
+
+</Tab>
+<Tab title="&#x22;Props&#x22;">
+
+
+| "Props" | Tipo | Descripción | Predeterminado |
+| --------------- | -------- | ---------------------------------------------------------------------------------------------------------------------- | ---------------- |
+| valor | booleano | El estado actual del interruptor de palanca | `falso` |
+| "onChange" | función | Función de retorno que se activa cuando el estado del interruptor de palanca cambia | |
+| color | cadena | Color del interruptor de palanca cuando | es de color azul |
+| tamañoConmutado | cadena | Tamaño del interruptor de palanca, que afecta tanto la altura como el ancho. Tiene dos opciones: `pequeño` y `mediano` | mediano |
+
+
+
+</Tab>
</Tabs>
diff --git a/packages/twenty-docs/l/es/twenty-ui/introduction.mdx b/packages/twenty-docs/l/es/twenty-ui/introduction.mdx
index 151174b1b7c..dd1cdfaaed9 100644
--- a/packages/twenty-docs/l/es/twenty-ui/introduction.mdx
+++ b/packages/twenty-docs/l/es/twenty-ui/introduction.mdx
@@ -1,5 +1,6 @@
---
title: Resumen
+icon: paleta
description: Biblioteca de componentes para Twenty CRM
---
diff --git a/packages/twenty-docs/l/es/twenty-ui/navigation.mdx b/packages/twenty-docs/l/es/twenty-ui/navigation.mdx
index c824dc70f48..e7e5786c7b7 100644
--- a/packages/twenty-docs/l/es/twenty-ui/navigation.mdx
+++ b/packages/twenty-docs/l/es/twenty-ui/navigation.mdx
@@ -1,5 +1,6 @@
---
title: Navegación
+icon: brújula
---
<Frame>
diff --git a/packages/twenty-docs/l/es/twenty-ui/navigation/breadcrumb.mdx b/packages/twenty-docs/l/es/twenty-ui/navigation/breadcrumb.mdx
index beb834686da..023059b3d3e 100644
--- a/packages/twenty-docs/l/es/twenty-ui/navigation/breadcrumb.mdx
+++ b/packages/twenty-docs/l/es/twenty-ui/navigation/breadcrumb.mdx
@@ -9,32 +9,38 @@ title: Migaja de pan
Renderiza una barra de navegación de migas de pan.
<Tabs>
- <Tab title="Uso">
- ```jsx
- import { BrowserRouter } from "react-router-dom";
- import { Breadcrumb } from "@/ui/navigation/bread-crumb/components/Breadcrumb";
-
- export const MyComponent = () => {
- const breadcrumbLinks = [
- { children: "Home", href: "/" },
- { children: "Category", href: "/category" },
- { children: "Subcategory", href: "/category/subcategory" },
- { children: "Current Page" },
- ];
-
- return (
- <BrowserRouter>
- <Breadcrumb className links={breadcrumbLinks} />
- </BrowserRouter>
- )
- };
- ```
- </Tab>
-
- <Tab title="Props">
- | Props | Tipo | Descripción |
- | ------------- | ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
- | nombreDeClase | cadena | Nombre de clase opcional para estilos adicionales |
- | enlaces | matriz | An array of objects, each representing a breadcrumb link. Cada objeto tiene una propiedad `children` (el contenido de texto del enlace) y una propiedad `href` opcional (la URL a la que navegar cuando se hace clic en el enlace) |
- </Tab>
+<Tab title="Uso">
+
+```jsx
+import { BrowserRouter } from "react-router-dom";
+import { Breadcrumb } from "@/ui/navigation/bread-crumb/components/Breadcrumb";
+
+export const MyComponent = () => {
+ const breadcrumbLinks = [
+ { children: "Home", href: "/" },
+ { children: "Category", href: "/category" },
+ { children: "Subcategory", href: "/category/subcategory" },
+ { children: "Current Page" },
+ ];
+
+ return (
+ <BrowserRouter>
+ <Breadcrumb className links={breadcrumbLinks} />
+ </BrowserRouter>
+ )
+};
+```
+
+</Tab>
+<Tab title="Props">
+
+
+| Props | Tipo | Descripción |
+| ------------- | ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| nombreDeClase | cadena | Nombre de clase opcional para estilos adicionales |
+| enlaces | matriz | An array of objects, each representing a breadcrumb link. Cada objeto tiene una propiedad `children` (el contenido de texto del enlace) y una propiedad `href` opcional (la URL a la que navegar cuando se hace clic en el enlace) |
+
+
+
+</Tab>
</Tabs>
diff --git a/packages/twenty-docs/l/es/twenty-ui/navigation/links.mdx b/packages/twenty-docs/l/es/twenty-ui/navigation/links.mdx
index 8ca4c1bac4e..e20cf0200ec 100644
--- a/packages/twenty-docs/l/es/twenty-ui/navigation/links.mdx
+++ b/packages/twenty-docs/l/es/twenty-ui/navigation/links.mdx
@@ -1,5 +1,6 @@
---
title: Enlaces
+icon: enlace
---
<Frame>
@@ -11,40 +12,49 @@ title: Enlaces
Un componente de enlace estilizado para mostrar información de contacto.
<Tabs>
- <Tab title="&#x22;Uso&#x22;">
- ```jsx
- import { BrowserRouter as Router } from 'react-router-dom';
-
- import { ContactLink } from 'twenty-ui/navigation';
-
- export const MyComponent = () => {
- const handleLinkClick = (event) => {
- console.log('Contact link clicked!', event);
- };
-
- return (
- <Router>
- <ContactLink
- className
- href="mailto:[email protected]"
- onClick={handleLinkClick}
- >
- </ContactLink>
- </Router>
- );
- };
- ```
- </Tab>
-
- <Tab title="&#x22;Props&#x22;">
- | "Props" | Tipo | Descripción |
- | ----------- | ----------------- | ------------------------------------------------------------------------------- |
- | "className" | string | "Nombre opcional para estilización adicional" |
- | href | string | La URL o ruta objetivo del enlace |
- | onClick | "función" | Función de devolución de llamada que se activa cuando se hace clic en el enlace |
- | hijos | `React.ReactNode` | El contenido que se mostrará dentro del enlace |
- </Tab>
+<Tab title="&#x22;Uso&#x22;">
+
+```jsx
+import { BrowserRouter as Router } from 'react-router-dom';
+
+import { ContactLink } from 'twenty-ui/navigation';
+
+export const MyComponent = () => {
+ const handleLinkClick = (event) => {
+ console.log('Contact link clicked!', event);
+ };
+
+ return (
+ <Router>
+ <ContactLink
+ className
+ href="mailto:[email protected]"
+ onClick={handleLinkClick}
+ >
+ </ContactLink>
+ </Router>
+ );
+};
+```
+
+
+</Tab>
+<Tab title="&#x22;Props&#x22;">
+
+
+| "Props" | Tipo | Descripción |
+| ----------- | ----------------- | ------------------------------------------------------------------------------- |
+| "className" | string | "Nombre opcional para estilización adicional" |
+| href | string | La URL o ruta objetivo del enlace |
+| onClick | "función" | Función de devolución de llamada que se activa cuando se hace clic en el enlace |
+| hijos | `React.ReactNode` | El contenido que se mostrará dentro del enlace |
+
+
+
+
+</Tab>
+
</Tabs>
## Enlace Sin Estilo
@@ -52,36 +62,44 @@ Un componente de enlace estilizado para mostrar información de contacto.
Un componente de enlace estilizado para mostrar enlaces.
<Tabs>
- <Tab title="&#x22;Uso&#x22;">
- ```jsx
- import { RawLink } from "/navigation";
- import { BrowserRouter as Router } from "react-router-dom";
-
- export const MyComponent = () => {
- const handleLinkClick = (event) => {
- console.log("Contact link clicked!", event);
- };
-
- return (
- <Router>
- <RawLink className href="/contact" onClick={handleLinkClick}>
- Contact Us
- </RawLink>
- </Router>
- );
- };
-
- ```
- </Tab>
-
- <Tab title="&#x22;Props&#x22;">
- | "Props" | Tipo | Descripción |
- | ------------- | ----------------- | ------------------------------------------------------------------------------- |
- | nombreDeClase | string | Nombre opcional para estilo adicional |
- | href | string | La URL o ruta objetivo del enlace |
- | onClick | función | Función de devolución de llamada que se activa cuando se hace clic en el enlace |
- | hijos | `React.ReactNode` | El contenido que se mostrará dentro del enlace |
- </Tab>
+<Tab title="&#x22;Uso&#x22;">
+
+```jsx
+import { RawLink } from "/navigation";
+import { BrowserRouter as Router } from "react-router-dom";
+
+export const MyComponent = () => {
+ const handleLinkClick = (event) => {
+ console.log("Contact link clicked!", event);
+ };
+
+ return (
+ <Router>
+ <RawLink className href="/contact" onClick={handleLinkClick}>
+ Contact Us
+ </RawLink>
+ </Router>
+ );
+};
+
+```
+
+
+</Tab>
+<Tab title="&#x22;Props&#x22;">
+
+
+| "Props" | Tipo | Descripción |
+| ------------- | ----------------- | ------------------------------------------------------------------------------- |
+| nombreDeClase | string | Nombre opcional para estilo adicional |
+| href | string | La URL o ruta objetivo del enlace |
+| onClick | función | Función de devolución de llamada que se activa cuando se hace clic en el enlace |
+| hijos | `React.ReactNode` | El contenido que se mostrará dentro del enlace |
+
+
+
+
+</Tab>
</Tabs>
## Enlace Redondeado
@@ -89,34 +107,41 @@ Un componente de enlace estilizado para mostrar enlaces.
Un enlace de estilo redondeado con un componente Chip para enlaces.
<Tabs>
- <Tab title="&#x22;Uso&#x22;">
- ```jsx
- import { RoundedLink } from "/navigation";
- import { BrowserRouter as Router } from "react-router-dom";
-
- export const MyComponent = () => {
- const handleLinkClick = (event) => {
- console.log("Contact link clicked!", event);
- };
-
- return (
- <Router>
- <RoundedLink href="/contact" onClick={handleLinkClick}>
- Contact Us
- </RoundedLink>
- </Router>
- );
- };
- ```
- </Tab>
-
- <Tab title="&#x22;Props&#x22;">
- | "Props" | Tipo | Descripción |
- | ------- | ----------------- | ------------------------------------------------------------------------------- |
- | href | cadena | La URL o ruta objetivo del enlace |
- | hijos | `React.ReactNode` | El contenido que se mostrará dentro del enlace |
- | onClick | "función" | Función de devolución de llamada que se activa cuando se hace clic en el enlace |
- </Tab>
+<Tab title="&#x22;Uso&#x22;">
+
+```jsx
+import { RoundedLink } from "/navigation";
+import { BrowserRouter as Router } from "react-router-dom";
+
+export const MyComponent = () => {
+ const handleLinkClick = (event) => {
+ console.log("Contact link clicked!", event);
+ };
+
+ return (
+ <Router>
+ <RoundedLink href="/contact" onClick={handleLinkClick}>
+ Contact Us
+ </RoundedLink>
+ </Router>
+ );
+};
+```
+
+</Tab>
+
+<Tab title="&#x22;Props&#x22;">
+
+
+| "Props" | Tipo | Descripción |
+| ------- | ----------------- | ------------------------------------------------------------------------------- |
+| href | cadena | La URL o ruta objetivo del enlace |
+| hijos | `React.ReactNode` | El contenido que se mostrará dentro del enlace |
+| onClick | "función" | Función de devolución de llamada que se activa cuando se hace clic en el enlace |
+
+
+
+</Tab>
</Tabs>
## Enlace Social
@@ -124,30 +149,37 @@ Un enlace de estilo redondeado con un componente Chip para enlaces.
Enlaces sociales estilizados, con soporte para varios tipos de enlaces sociales, como URLs, LinkedIn y X (o Twitter).
<Tabs>
- <Tab title="Uso">
- ```jsx
- import { SocialLink } from "twenty-ui/navigation";
- import { BrowserRouter as Router } from "react-router-dom";
-
- export const MyComponent = () => {
- return (
- <Router>
- <SocialLink
- type="twitter"
- href="https://twitter.com/twentycrm"
- ></SocialLink>
- </Router>
- );
- };
- ```
- </Tab>
-
- <Tab title="Props">
- | Props | Tipo | Descripción |
- | ------- | ----------------- | ---------------------------------------------------------------------------------- |
- | href | string | La URL o ruta objetivo del enlace |
- | hijos | `React.ReactNode` | El contenido que se mostrará dentro del enlace |
- | tipo | string | El tipo de enlaces sociales. Las opciones incluyen: `url`, `LinkedIn`, y `Twitter` |
- | onClick | función | Función de devolución de llamada que se activa cuando se hace clic en el enlace |
- </Tab>
+<Tab title="Uso">
+
+```jsx
+import { SocialLink } from "twenty-ui/navigation";
+import { BrowserRouter as Router } from "react-router-dom";
+
+export const MyComponent = () => {
+ return (
+ <Router>
+ <SocialLink
+ type="twitter"
+ href="https://twitter.com/twentycrm"
+ ></SocialLink>
+ </Router>
+ );
+};
+```
+
+</Tab>
+<Tab title="Props">
+
+
+| Props | Tipo | Descripción |
+| ------- | ----------------- | ---------------------------------------------------------------------------------- |
+| href | string | La URL o ruta objetivo del enlace |
+| hijos | `React.ReactNode` | El contenido que se mostrará dentro del enlace |
+| tipo | string | El tipo de enlaces sociales. Las opciones incluyen: `url`, `LinkedIn`, y `Twitter` |
+| onClick | función | Función de devolución de llamada que se activa cuando se hace clic en el enlace |
+
+
+
+
+</Tab>
</Tabs>
diff --git a/packages/twenty-docs/l/es/twenty-ui/navigation/menu-item.mdx b/packages/twenty-docs/l/es/twenty-ui/navigation/menu-item.mdx
index 52c98501518..86524217e68 100644
--- a/packages/twenty-docs/l/es/twenty-ui/navigation/menu-item.mdx
+++ b/packages/twenty-docs/l/es/twenty-ui/navigation/menu-item.mdx
@@ -1,54 +1,62 @@
---
title: Elemento del menú
+icon: bars
---
-
Un elemento de menú versátil diseñado para ser utilizado en un menú o lista de navegación.
<Tabs>
- <Tab title="Uso">
- ```jsx
- import { IconBell } from "@tabler/icons-react";
- import { IconAlertCircle } from "@tabler/icons-react";
- import { MenuItem } from "twenty-ui/display";
-
- export const MyComponent = () => {
- const handleMenuItemClick = (event) => {
- console.log("Menu item clicked!", event);
- };
-
- const handleButtonClick = (event) => {
- console.log("Icon button clicked!", event);
- };
-
- return (
- <MenuItem
- LeftIcon={IconBell}
- accent="default"
- text="Menu item text"
- iconButtons={[{ Icon: IconAlertCircle, onClick: handleButtonClick }]}
- isTooltipOpen={true}
- testId="menu-item-1"
- onClick={handleMenuItemClick}
- className
- />
- );
- };
- ```
- </Tab>
-
- <Tab title="Props">
- | Props | Tipo | Descripción |
- | -------------- | ----------------- | --------------------------------------------------------------------------------------------------------------- |
- | IconoIzquierdo | "ComponenteIcono" | Un icono izquierdo opcional que se muestra antes del texto en el elemento de menú |
- | acento | cadena | Especifica el color de acento del elemento de menú. Las opciones incluyen: `default`, `danger`, y `placeholder` |
- | texto | cadena | El contenido de texto del elemento de menú |
- | iconButtons | array | Una matriz de objetos que representan botones de icono adicionales asociados con el elemento del menú |
- | isToolTipOpen | booleano | Controla la visibilidad del tooltip asociado con el elemento del menú |
- | testId | cadena | El atributo data-testid para propósitos de prueba |
- | alHacerClic | función | Función de retorno que se activará cuando se haga clic en el elemento del menú |
- | nombreDeClase | cadena | Nombre opcional para el estilo adicional |
- </Tab>
+<Tab title="Uso">
+
+```jsx
+import { IconBell } from "@tabler/icons-react";
+import { IconAlertCircle } from "@tabler/icons-react";
+import { MenuItem } from "twenty-ui/display";
+
+export const MyComponent = () => {
+ const handleMenuItemClick = (event) => {
+ console.log("Menu item clicked!", event);
+ };
+
+ const handleButtonClick = (event) => {
+ console.log("Icon button clicked!", event);
+ };
+
+ return (
+ <MenuItem
+ LeftIcon={IconBell}
+ accent="default"
+ text="Menu item text"
+ iconButtons={[{ Icon: IconAlertCircle, onClick: handleButtonClick }]}
+ isTooltipOpen={true}
+ testId="menu-item-1"
+ onClick={handleMenuItemClick}
+ className
+ />
+ );
+};
+```
+
+
+</Tab>
+<Tab title="Props">
+
+
+| Props | Tipo | Descripción |
+| -------------- | ----------------- | --------------------------------------------------------------------------------------------------------------- |
+| IconoIzquierdo | "ComponenteIcono" | Un icono izquierdo opcional que se muestra antes del texto en el elemento de menú |
+| acento | cadena | Especifica el color de acento del elemento de menú. Las opciones incluyen: `default`, `danger`, y `placeholder` |
+| texto | cadena | El contenido de texto del elemento de menú |
+| iconButtons | array | Una matriz de objetos que representan botones de icono adicionales asociados con el elemento del menú |
+| isToolTipOpen | booleano | Controla la visibilidad del tooltip asociado con el elemento del menú |
+| testId | cadena | El atributo data-testid para propósitos de prueba |
+| alHacerClic | función | Función de retorno que se activará cuando se haga clic en el elemento del menú |
+| nombreDeClase | cadena | Nombre opcional para el estilo adicional |
+
+
+
+
+</Tab>
</Tabs>
## Variantes
@@ -60,42 +68,49 @@ Las diferentes variantes del componente de elemento de menú incluyen las siguie
Un elemento de menú estilo comando en un menú para indicar atajos de teclado.
<Tabs>
- <Tab title="Uso">
- ```jsx
- import { IconBell } from "@tabler/icons-react";
- import { MenuItemCommand } from "twenty-ui/display";
-
- export const MyComponent = () => {
- const handleCommandClick = () => {
- console.log("Command clicked!");
- };
-
- return (
- <MenuItemCommand
- LeftIcon={IconBell}
- text="First Option"
- firstHotKey="⌘"
- secondHotKey="1"
- isSelected={true}
- onClick={handleCommandClick}
- className
- />
- );
- };
- ```
- </Tab>
-
- <Tab title="Props">
- | Props | Tipo | Descripción |
- | -------------- | ------------- | ---------------------------------------------------------------------------------- |
- | IconoIzquierdo | IconComponent | Un icono izquierdo opcional que se muestra antes del texto en el elemento del menú |
- | texto | "cadena" | El contenido de texto del elemento del menú |
- | firstHotKey | cadena | El primer atajo de teclado asociado con el comando |
- | secondHotKey | cadena | El segundo atajo de teclado asociado con el comando |
- | isSelected | booleano | Indica si el elemento del menú está seleccionado o resaltado |
- | alHacerClic | función | Función de retorno que se activará cuando se haga clic en el elemento del menú |
- | nombreDeClase | cadena | Nombre opcional para estilo adicional |
- </Tab>
+<Tab title="Uso">
+
+```jsx
+import { IconBell } from "@tabler/icons-react";
+import { MenuItemCommand } from "twenty-ui/display";
+
+export const MyComponent = () => {
+ const handleCommandClick = () => {
+ console.log("Command clicked!");
+ };
+
+ return (
+ <MenuItemCommand
+ LeftIcon={IconBell}
+ text="First Option"
+ firstHotKey="⌘"
+ secondHotKey="1"
+ isSelected={true}
+ onClick={handleCommandClick}
+ className
+ />
+ );
+};
+```
+
+
+</Tab>
+<Tab title="Props">
+
+
+| Props | Tipo | Descripción |
+| -------------- | ------------- | ---------------------------------------------------------------------------------- |
+| IconoIzquierdo | IconComponent | Un icono izquierdo opcional que se muestra antes del texto en el elemento del menú |
+| texto | "cadena" | El contenido de texto del elemento del menú |
+| firstHotKey | cadena | El primer atajo de teclado asociado con el comando |
+| secondHotKey | cadena | El segundo atajo de teclado asociado con el comando |
+| isSelected | booleano | Indica si el elemento del menú está seleccionado o resaltado |
+| alHacerClic | función | Función de retorno que se activará cuando se haga clic en el elemento del menú |
+| nombreDeClase | cadena | Nombre opcional para estilo adicional |
+
+
+
+</Tab>
</Tabs>
### Draggable
@@ -103,45 +118,52 @@ Un elemento de menú estilo comando en un menú para indicar atajos de teclado.
Un componente de elemento de menú arrastrable diseñado para ser utilizado en un menú o lista donde los elementos se pueden arrastrar y se pueden realizar acciones adicionales a través de botones de iconos.
<Tabs>
- <Tab title="Uso">
- ```jsx
- import { IconBell } from "@tabler/icons-react";
- import { IconAlertCircle } from "@tabler/icons-react";
- import { MenuItemDraggable } from "twenty-ui/display";
-
- export const MyComponent = () => {
- const handleMenuItemClick = (event) => {
- console.log("Menu item clicked!", event);
- };
-
- return (
- <MenuItemDraggable
- LeftIcon={IconBell}
- accent="default"
- iconButtons={[{ Icon: IconAlertCircle, onClick: handleButtonClick }]}
- isTooltipOpen={false}
- onClick={handleMenuItemClick}
- text="Menu item draggable"
- isDragDisabled={false}
- className
- />
- );
- };
- ```
- </Tab>
-
- <Tab title="Propiedades">
- | Propiedades | Tipo | Descripción |
- | -------------- | ------------- | ----------------------------------------------------------------------------------------------------- |
- | IconoIzquierdo | IconComponent | Un icono izquierdo opcional que se muestra antes del texto en el elemento del menú |
- | accent | cadena | El color de acento del elemento del menú. Puede ser `default`, `placeholder` y `danger` |
- | iconButtons | matriz | Una matriz de objetos que representan botones de icono adicionales asociados con el elemento del menú |
- | isTooltipOpen | booleano | Controla la visibilidad del tooltip asociado con el elemento del menú |
- | alHacerClic | función | Función de devolución de llamada para activar cuando se haga clic en el enlace |
- | texto | cadena | El contenido de texto del elemento del menú |
- | isDragDisabled | booleano | Indica si el arrastre está desactivado |
- | nombreDeClase | cadena | Nombre opcional para estilo adicional |
- </Tab>
+<Tab title="Uso">
+
+```jsx
+import { IconBell } from "@tabler/icons-react";
+import { IconAlertCircle } from "@tabler/icons-react";
+import { MenuItemDraggable } from "twenty-ui/display";
+
+export const MyComponent = () => {
+ const handleMenuItemClick = (event) => {
+ console.log("Menu item clicked!", event);
+ };
+
+ return (
+ <MenuItemDraggable
+ LeftIcon={IconBell}
+ accent="default"
+ iconButtons={[{ Icon: IconAlertCircle, onClick: handleButtonClick }]}
+ isTooltipOpen={false}
+ onClick={handleMenuItemClick}
+ text="Menu item draggable"
+ isDragDisabled={false}
+ className
+ />
+ );
+};
+```
+
+</Tab>
+<Tab title="Propiedades">
+
+
+| Propiedades | Tipo | Descripción |
+| -------------- | ------------- | ----------------------------------------------------------------------------------------------------- |
+| IconoIzquierdo | IconComponent | Un icono izquierdo opcional que se muestra antes del texto en el elemento del menú |
+| accent | cadena | El color de acento del elemento del menú. Puede ser `default`, `placeholder` y `danger` |
+| iconButtons | matriz | Una matriz de objetos que representan botones de icono adicionales asociados con el elemento del menú |
+| isTooltipOpen | booleano | Controla la visibilidad del tooltip asociado con el elemento del menú |
+| alHacerClic | función | Función de devolución de llamada para activar cuando se haga clic en el enlace |
+| texto | cadena | El contenido de texto del elemento del menú |
+| isDragDisabled | booleano | Indica si el arrastre está desactivado |
+| nombreDeClase | cadena | Nombre opcional para estilo adicional |
+
+
+
+
+</Tab>
</Tabs>
### Multi Selección
@@ -149,34 +171,41 @@ Un componente de elemento de menú arrastrable diseñado para ser utilizado en u
Proporciona una manera para implementar la funcionalidad de selección múltiple con una casilla de verificación asociada.
<Tabs>
- <Tab title="Uso">
- ```jsx
- import { IconBell } from "@tabler/icons-react";
- import { MenuItemMultiSelect } from "twenty-ui/display";
-
- export const MyComponent = () => {
-
- return (
- <MenuItemMultiSelect
- LeftIcon={IconBell}
- text="First Option"
- selected={false}
- className
- />
- );
- };
- ```
- </Tab>
-
- <Tab title="Props">
- | Props | Tipo | Descripción |
- | -------------- | ------------- | ----------------------------------------------------------------------------------------------- |
- | LeftIcon | IconComponent | Un icono opcional a la izquierda mostrado antes del texto en el elemento del menú |
- | texto | cadena | El contenido de texto del elemento del menú |
- | selected | booleano | Indica si el elemento del menú está seleccionado (marcado) |
- | onSelectChange | función | Función de devolución de llamada activada cuando el estado de la casilla de verificación cambia |
- | nombreDeClase | cadena | Nombre opcional para estilo adicional |
- </Tab>
+<Tab title="Uso">
+
+```jsx
+import { IconBell } from "@tabler/icons-react";
+import { MenuItemMultiSelect } from "twenty-ui/display";
+
+export const MyComponent = () => {
+
+ return (
+ <MenuItemMultiSelect
+ LeftIcon={IconBell}
+ text="First Option"
+ selected={false}
+ className
+ />
+ );
+};
+```
+
+</Tab>
+<Tab title="Props">
+
+
+| Props | Tipo | Descripción |
+| -------------- | ------------- | ----------------------------------------------------------------------------------------------- |
+| LeftIcon | IconComponent | Un icono opcional a la izquierda mostrado antes del texto en el elemento del menú |
+| texto | cadena | El contenido de texto del elemento del menú |
+| selected | booleano | Indica si el elemento del menú está seleccionado (marcado) |
+| onSelectChange | función | Función de devolución de llamada activada cuando el estado de la casilla de verificación cambia |
+| nombreDeClase | cadena | Nombre opcional para estilo adicional |
+
+
+
+
+</Tab>
</Tabs>
### Multi Selección con Avatar
@@ -184,35 +213,42 @@ Proporciona una manera para implementar la funcionalidad de selección múltiple
Un elemento de menú de selección múltiple con un avatar, una casilla para selección y contenido textual.
<Tabs>
- <Tab title="Uso">
- ```jsx
- import { MenuItemMultiSelectAvatar } from "twenty-ui/display";
-
- export const MyComponent = () => {
- const imageUrl =
- "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAYABgAAD/4QCMRXhpZgAATU0AKgAAAAgABQESAAMAAAABAAEAAAEaAAUAAAABAAAASgEbAAUAAAABAAAAUgEoAAMAAAABAAIAAIdpAAQAAAABAAAAWgAAAAAAAABgAAAAAQAAAGAAAAABAAOgAQADAAAAAQABAACgAgAEAAAAAQAAABSgAwAEAAAAAQAAABQAAAAA/8AAEQgAFAAUAwEiAAIRAQMRAf/EAB8AAAEFAQEBAQEBAAAAAAAAAAABAgMEBQYHCAkKC//EALUQAAIBAwMCBAMFBQQEAAABfQECAwAEEQUSITFBBhNRYQcicRQygZGhCCNCscEVUtHwJDNicoIJChYXGBkaJSYnKCkqNDU2Nzg5OkNERUZHSElKU1RVVldYWVpjZGVmZ2hpanN0dXZ3eHl6g4SFhoeIiYqSk5SVlpeYmZqio6Slpqeoqaqys7S1tre4ubrCw8TFxsfIycrS09TV1tfY2drh4uPk5ebn6Onq8fLz9PX29/j5+v/EAB8BAAMBAQEBAQEBAQEAAAAAAAABAgMEBQYHCAkKC//EALURAAIBAgQEAwQHBQQEAAECdwABAgMRBAUhMQYSQVEHYXETIjKBCBRCkaGxwQkjM1LwFWJy0QoWJDThJfEXGBkaJicoKSo1Njc4OTpDREVGR0hJSlNUVVZXWFlaY2RlZmdoaWpzdHV2d3h5eoKDhIWGh4iJipKTlJWWl5iZmqKjpKWmp6ipqrKztLW2t7i5usLDxMXGx8jJytLT1NXW19jZ2uLj5OXm5+jp6vLz9PX29/j5+v/bAEMACwgICggHCwoJCg0MCw0RHBIRDw8RIhkaFBwpJCsqKCQnJy0yQDctMD0wJyc4TDk9Q0VISUgrNk9VTkZUQEdIRf/bAEMBDA0NEQ8RIRISIUUuJy5FRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRf/dAAQAAv/aAAwDAQACEQMRAD8Ava1q728otYY98joSCTgZrnbXWdTtrhrfVZXWLafmcAEkdgR/hVltQku9Q8+OIEBcGOT+ID0PY1ka1KH2u8ToqnPLbmIqG7u6LtbQ7RXBRec4Uck9eKXcPWsKDWVnhWSL5kYcFelSf2m3901POh8jP//QoyIAnTuKpXsY82NsksUyWPU5q/L9z8RVK++/F/uCsVsaEURwgA4HtT9x9TUcf3KfUGh//9k=";
-
- return (
- <MenuItemMultiSelectAvatar
- avatar={<img src={imageUrl} alt="Avatar" />}
- text="First Option"
- selected={false}
- className
- />
- );
- };
- ```
- </Tab>
-
- <Tab title="Propiedades">
- | Propiedades | Tipo | Descripción |
- | -------------- | ----------- | ----------------------------------------------------------------------------------------------- |
- | avatar | `ReactNode` | El avatar o icono que se mostrará en el lado izquierdo del elemento del menú |
- | texto | cadena | El contenido de texto del elemento del menú |
- | selected | booleano | Indica si el elemento del menú está seleccionado (marcado) |
- | onSelectChange | función | Función de devolución de llamada activada cuando el estado de la casilla de verificación cambia |
- | nombreDeClase | cadena | Nombre opcional para estilo adicional |
- </Tab>
+<Tab title="Uso">
+
+```jsx
+import { MenuItemMultiSelectAvatar } from "twenty-ui/display";
+
+export const MyComponent = () => {
+ const imageUrl =
+ "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAYABgAAD/4QCMRXhpZgAATU0AKgAAAAgABQESAAMAAAABAAEAAAEaAAUAAAABAAAASgEbAAUAAAABAAAAUgEoAAMAAAABAAIAAIdpAAQAAAABAAAAWgAAAAAAAABgAAAAAQAAAGAAAAABAAOgAQADAAAAAQABAACgAgAEAAAAAQAAABSgAwAEAAAAAQAAABQAAAAA/8AAEQgAFAAUAwEiAAIRAQMRAf/EAB8AAAEFAQEBAQEBAAAAAAAAAAABAgMEBQYHCAkKC//EALUQAAIBAwMCBAMFBQQEAAABfQECAwAEEQUSITFBBhNRYQcicRQygZGhCCNCscEVUtHwJDNicoIJChYXGBkaJSYnKCkqNDU2Nzg5OkNERUZHSElKU1RVVldYWVpjZGVmZ2hpanN0dXZ3eHl6g4SFhoeIiYqSk5SVlpeYmZqio6Slpqeoqaqys7S1tre4ubrCw8TFxsfIycrS09TV1tfY2drh4uPk5ebn6Onq8fLz9PX29/j5+v/EAB8BAAMBAQEBAQEBAQEAAAAAAAABAgMEBQYHCAkKC//EALURAAIBAgQEAwQHBQQEAAECdwABAgMRBAUhMQYSQVEHYXETIjKBCBRCkaGxwQkjM1LwFWJy0QoWJDThJfEXGBkaJicoKSo1Njc4OTpDREVGR0hJSlNUVVZXWFlaY2RlZmdoaWpzdHV2d3h5eoKDhIWGh4iJipKTlJWWl5iZmqKjpKWmp6ipqrKztLW2t7i5usLDxMXGx8jJytLT1NXW19jZ2uLj5OXm5+jp6vLz9PX29/j5+v/bAEMACwgICggHCwoJCg0MCw0RHBIRDw8RIhkaFBwpJCsqKCQnJy0yQDctMD0wJyc4TDk9Q0VISUgrNk9VTkZUQEdIRf/bAEMBDA0NEQ8RIRISIUUuJy5FRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRf/dAAQAAv/aAAwDAQACEQMRAD8Ava1q728otYY98joSCTgZrnbXWdTtrhrfVZXWLafmcAEkdgR/hVltQku9Q8+OIEBcGOT+ID0PY1ka1KH2u8ToqnPLbmIqG7u6LtbQ7RXBRec4Uck9eKXcPWsKDWVnhWSL5kYcFelSf2m3901POh8jP//QoyIAnTuKpXsY82NsksUyWPU5q/L9z8RVK++/F/uCsVsaEURwgA4HtT9x9TUcf3KfUGh//9k=";
+
+ return (
+ <MenuItemMultiSelectAvatar
+ avatar={<img src={imageUrl} alt="Avatar" />}
+ text="First Option"
+ selected={false}
+ className
+ />
+ );
+};
+```
+
+</Tab>
+<Tab title="Propiedades">
+
+
+| Propiedades | Tipo | Descripción |
+| -------------- | ----------- | ----------------------------------------------------------------------------------------------- |
+| avatar | `ReactNode` | El avatar o icono que se mostrará en el lado izquierdo del elemento del menú |
+| texto | cadena | El contenido de texto del elemento del menú |
+| selected | booleano | Indica si el elemento del menú está seleccionado (marcado) |
+| onSelectChange | función | Función de devolución de llamada activada cuando el estado de la casilla de verificación cambia |
+| nombreDeClase | cadena | Nombre opcional para estilo adicional |
+
+
+
+
+</Tab>
</Tabs>
### Navegar
@@ -220,36 +256,43 @@ Un elemento de menú de selección múltiple con un avatar, una casilla para sel
Un elemento de menú que presenta un icono opcional a la izquierda, contenido textual y un icono de chevron a la derecha.
<Tabs>
- <Tab title="Uso">
- ```jsx
- import { IconBell } from "@tabler/icons-react";
- import { MenuItemNavigate } from "twenty-ui/display";
-
- export const MyComponent = () => {
- const handleNavigation = () => {
- console.log("Navigate to another page");
- };
-
- return (
- <MenuItemNavigate
- LeftIcon={IconBell}
- text="First Option"
- onClick={handleNavigation}
- className
- />
- );
- };
- ```
- </Tab>
-
- <Tab title="Propiedades">
- | Propiedades | Tipo | Descripción |
- | ------------- | ------------- | ---------------------------------------------------------------------------------------------- |
- | LeftIcon | IconComponent | Un icono opcional a la izquierda mostrado antes del texto en el elemento del menú |
- | texto | cadena | El contenido de texto del elemento del menú |
- | enClic | función | Función de devolución de llamada para ser activada cuando se haga clic en el elemento del menú |
- | nombreDeClase | cadena | Nombre opcional para estilo adicional |
- </Tab>
+<Tab title="Uso">
+
+```jsx
+import { IconBell } from "@tabler/icons-react";
+import { MenuItemNavigate } from "twenty-ui/display";
+
+export const MyComponent = () => {
+ const handleNavigation = () => {
+ console.log("Navigate to another page");
+ };
+
+ return (
+ <MenuItemNavigate
+ LeftIcon={IconBell}
+ text="First Option"
+ onClick={handleNavigation}
+ className
+ />
+ );
+};
+```
+
+</Tab>
+<Tab title="Propiedades">
+
+
+| Propiedades | Tipo | Descripción |
+| ------------- | ------------- | ---------------------------------------------------------------------------------------------- |
+| LeftIcon | IconComponent | Un icono opcional a la izquierda mostrado antes del texto en el elemento del menú |
+| texto | cadena | El contenido de texto del elemento del menú |
+| enClic | función | Función de devolución de llamada para ser activada cuando se haga clic en el elemento del menú |
+| nombreDeClase | cadena | Nombre opcional para estilo adicional |
+
+
+
+
+</Tab>
</Tabs>
### Seleccionar
@@ -257,42 +300,49 @@ Un elemento de menú que presenta un icono opcional a la izquierda, contenido te
Un elemento de menú seleccionable, que presenta contenido opcional a la izquierda (icono y texto) y un indicador (icono de verificación) para el estado seleccionado.
<Tabs>
- <Tab title="Uso">
- ```jsx
- import { IconBell } from "@tabler/icons-react";
- import { MenuItemSelect } from "twenty-ui/display";
-
- export const MyComponent = () => {
- const handleSelection = () => {
- console.log("Menu item selected");
- };
-
- return (
- <MenuItemSelect
- LeftIcon={IconBell}
- text="First Option"
- selected={true}
- disabled={false}
- hovered={false}
- onClick={handleSelection}
- className
- />
- );
- };
- ```
- </Tab>
-
- <Tab title="Propiedades">
- | Propiedades | Tipo | Descripción |
- | ------------- | ------------- | ---------------------------------------------------------------------------------------------- |
- | LeftIcon | IconComponent | Un icono opcional a la izquierda mostrado antes del texto en el elemento del menú |
- | texto | cadena | El contenido de texto del elemento del menú |
- | selected | booleano | Indica si el elemento del menú está seleccionado (marcado) |
- | disabled | booleano | Indica si el elemento del menú está desactivado |
- | hovered | booleano | Indica si el elemento del menú está actualmente siendo sobrevolado |
- | enClic | función | Función de devolución de llamada para ser activada cuando se haga clic en el elemento del menú |
- | nombreDeClase | cadena | Nombre opcional para estilo adicional |
- </Tab>
+<Tab title="Uso">
+
+```jsx
+import { IconBell } from "@tabler/icons-react";
+import { MenuItemSelect } from "twenty-ui/display";
+
+export const MyComponent = () => {
+ const handleSelection = () => {
+ console.log("Menu item selected");
+ };
+
+ return (
+ <MenuItemSelect
+ LeftIcon={IconBell}
+ text="First Option"
+ selected={true}
+ disabled={false}
+ hovered={false}
+ onClick={handleSelection}
+ className
+ />
+ );
+};
+```
+
+</Tab>
+<Tab title="Propiedades">
+
+
+| Propiedades | Tipo | Descripción |
+| ------------- | ------------- | ---------------------------------------------------------------------------------------------- |
+| LeftIcon | IconComponent | Un icono opcional a la izquierda mostrado antes del texto en el elemento del menú |
+| texto | cadena | El contenido de texto del elemento del menú |
+| selected | booleano | Indica si el elemento del menú está seleccionado (marcado) |
+| disabled | booleano | Indica si el elemento del menú está desactivado |
+| hovered | booleano | Indica si el elemento del menú está actualmente siendo sobrevolado |
+| enClic | función | Función de devolución de llamada para ser activada cuando se haga clic en el elemento del menú |
+| nombreDeClase | cadena | Nombre opcional para estilo adicional |
+
+
+
+
+</Tab>
</Tabs>
### Seleccionar avatar
@@ -300,47 +350,54 @@ Un elemento de menú seleccionable, que presenta contenido opcional a la izquier
Un elemento de menú seleccionable con un avatar, que presenta contenido opcional a la izquierda (avatar y texto) y un indicador (icono de verificación) para el estado seleccionado.
<Tabs>
- <Tab title="Uso">
- ```jsx
- import { MenuItemSelectAvatar } from "twenty-ui/display";
-
- export const MyComponent = () => {
- const imageUrl =
- "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAYABgAAD/4QCMRXhpZgAATU0AKgAAAAgABQESAAMAAAABAAEAAAEaAAUAAAABAAAASgEbAAUAAAABAAAAUgEoAAMAAAABAAIAAIdpAAQAAAABAAAAWgAAAAAAAABgAAAAAQAAAGAAAAABAAOgAQADAAAAAQABAACgAgAEAAAAAQAAABSgAwAEAAAAAQAAABQAAAAA/8AAEQgAFAAUAwEiAAIRAQMRAf/EAB8AAAEFAQEBAQEBAAAAAAAAAAABAgMEBQYHCAkKC//EALUQAAIBAwMCBAMFBQQEAAABfQECAwAEEQUSITFBBhNRYQcicRQygZGhCCNCscEVUtHwJDNicoIJChYXGBkaJSYnKCkqNDU2Nzg5OkNERUZHSElKU1RVVldYWVpjZGVmZ2hpanN0dXZ3eHl6g4SFhoeIiYqSk5SVlpeYmZqio6Slpqeoqaqys7S1tre4ubrCw8TFxsfIycrS09TV1tfY2drh4uPk5ebn6Onq8fLz9PX29/j5+v/EAB8BAAMBAQEBAQEBAQEAAAAAAAABAgMEBQYHCAkKC//EALURAAIBAgQEAwQHBQQEAAECdwABAgMRBAUhMQYSQVEHYXETIjKBCBRCkaGxwQkjM1LwFWJy0QoWJDThJfEXGBkaJicoKSo1Njc4OTpDREVGR0hJSlNUVVZXWFlaY2RlZmdoaWpzdHV2d3h5eoKDhIWGh4iJipKTlJWWl5iZmqKjpKWmp6ipqrKztLW2t7i5usLDxMXGx8jJytLT1NXW19jZ2uLj5OXm5+jp6vLz9PX29/j5+v/bAEMACwgICggHCwoJCg0MCw0RHBIRDw8RIhkaFBwpJCsqKCQnJy0yQDctMD0wJyc4TDk9Q0VISUgrNk9VTkZUQEdIRf/bAEMBDA0NEQ8RIRISIUUuJy5FRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRf/dAAQAAv/aAAwDAQACEQMRAD8Ava1q728otYY98joSCTgZrnbXWdTtrhrfVZXWLafmcAEkdgR/hVltQku9Q8+OIEBcGOT+ID0PY1ka1KH2u8ToqnPLbmIqG7u6LtbQ7RXBRec4Uck9eKXcPWsKDWVnhWSL5kYcFelSf2m3901POh8jP//QoyIAnTuKpXsY82NsksUyWPU5q/L9z8RVK++/F/uCsVsaEURwgA4HtT9x9TUcf3KfUGh//9k=";
-
- const handleSelection = () => {
- console.log("Menu item selected");
- };
-
- return (
- <MenuItemSelectAvatar
- avatar={<img src={imageUrl} alt="Avatar" />}
- text="First Option"
- selected={true}
- disabled={false}
- hovered={false}
- testId="menu-item-test"
- onClick={handleSelection}
- className
- />
- );
- };
-
- ```
- </Tab>
-
- <Tab title="Propiedades">
- | Propiedades | Tipo | Descripción |
- | ------------- | ----------- | ------------------------------------------------------------------------------ |
- | avatar | `ReactNode` | El avatar o icono que se mostrará en el lado izquierdo del elemento del menú |
- | texto | cadena | El contenido de texto del elemento del menú |
- | seleccionado | booleano | Indica si el elemento del menú está seleccionado (marcado) |
- | deshabilitado | booleano | Indica si el elemento del menú está deshabilitado |
- | hovered | booleano | Indica si el elemento del menú está actualmente siendo sobrevolado |
- | idPrueba | cadena | El atributo data-testid para propósitos de prueba |
- | enClic | función | Función de retorno que se activará cuando se haga clic en el elemento del menú |
- | nombreDeClase | cadena | Nombre opcional para estilo adicional |
- </Tab>
+<Tab title="Uso">
+
+```jsx
+import { MenuItemSelectAvatar } from "twenty-ui/display";
+
+export const MyComponent = () => {
+ const imageUrl =
+ "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAYABgAAD/4QCMRXhpZgAATU0AKgAAAAgABQESAAMAAAABAAEAAAEaAAUAAAABAAAASgEbAAUAAAABAAAAUgEoAAMAAAABAAIAAIdpAAQAAAABAAAAWgAAAAAAAABgAAAAAQAAAGAAAAABAAOgAQADAAAAAQABAACgAgAEAAAAAQAAABSgAwAEAAAAAQAAABQAAAAA/8AAEQgAFAAUAwEiAAIRAQMRAf/EAB8AAAEFAQEBAQEBAAAAAAAAAAABAgMEBQYHCAkKC//EALUQAAIBAwMCBAMFBQQEAAABfQECAwAEEQUSITFBBhNRYQcicRQygZGhCCNCscEVUtHwJDNicoIJChYXGBkaJSYnKCkqNDU2Nzg5OkNERUZHSElKU1RVVldYWVpjZGVmZ2hpanN0dXZ3eHl6g4SFhoeIiYqSk5SVlpeYmZqio6Slpqeoqaqys7S1tre4ubrCw8TFxsfIycrS09TV1tfY2drh4uPk5ebn6Onq8fLz9PX29/j5+v/EAB8BAAMBAQEBAQEBAQEAAAAAAAABAgMEBQYHCAkKC//EALURAAIBAgQEAwQHBQQEAAECdwABAgMRBAUhMQYSQVEHYXETIjKBCBRCkaGxwQkjM1LwFWJy0QoWJDThJfEXGBkaJicoKSo1Njc4OTpDREVGR0hJSlNUVVZXWFlaY2RlZmdoaWpzdHV2d3h5eoKDhIWGh4iJipKTlJWWl5iZmqKjpKWmp6ipqrKztLW2t7i5usLDxMXGx8jJytLT1NXW19jZ2uLj5OXm5+jp6vLz9PX29/j5+v/bAEMACwgICggHCwoJCg0MCw0RHBIRDw8RIhkaFBwpJCsqKCQnJy0yQDctMD0wJyc4TDk9Q0VISUgrNk9VTkZUQEdIRf/bAEMBDA0NEQ8RIRISIUUuJy5FRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRf/dAAQAAv/aAAwDAQACEQMRAD8Ava1q728otYY98joSCTgZrnbXWdTtrhrfVZXWLafmcAEkdgR/hVltQku9Q8+OIEBcGOT+ID0PY1ka1KH2u8ToqnPLbmIqG7u6LtbQ7RXBRec4Uck9eKXcPWsKDWVnhWSL5kYcFelSf2m3901POh8jP//QoyIAnTuKpXsY82NsksUyWPU5q/L9z8RVK++/F/uCsVsaEURwgA4HtT9x9TUcf3KfUGh//9k=";
+
+ const handleSelection = () => {
+ console.log("Menu item selected");
+ };
+
+ return (
+ <MenuItemSelectAvatar
+ avatar={<img src={imageUrl} alt="Avatar" />}
+ text="First Option"
+ selected={true}
+ disabled={false}
+ hovered={false}
+ testId="menu-item-test"
+ onClick={handleSelection}
+ className
+ />
+ );
+};
+
+```
+
+</Tab>
+<Tab title="Propiedades">
+
+
+| Propiedades | Tipo | Descripción |
+| ------------- | ----------- | ------------------------------------------------------------------------------ |
+| avatar | `ReactNode` | El avatar o icono que se mostrará en el lado izquierdo del elemento del menú |
+| texto | cadena | El contenido de texto del elemento del menú |
+| seleccionado | booleano | Indica si el elemento del menú está seleccionado (marcado) |
+| deshabilitado | booleano | Indica si el elemento del menú está deshabilitado |
+| hovered | booleano | Indica si el elemento del menú está actualmente siendo sobrevolado |
+| idPrueba | cadena | El atributo data-testid para propósitos de prueba |
+| enClic | función | Función de retorno que se activará cuando se haga clic en el elemento del menú |
+| nombreDeClase | cadena | Nombre opcional para estilo adicional |
+
+
+
+
+</Tab>
</Tabs>
### Seleccionar Color
@@ -348,41 +405,48 @@ Un elemento de menú seleccionable con un avatar, que presenta contenido opciona
Un elemento de menú seleccionable con una muestra de color para situaciones donde se desea que los usuarios elijan un color del menú.
<Tabs>
- <Tab title="Uso">
- ```jsx
- import { MenuItemSelectColor } from "twenty-ui/display";
-
- export const MyComponent = () => {
- const handleSelection = () => {
- console.log("Menu item selected");
- };
-
- return (
- <MenuItemSelectColor
- color="green"
- selected={true}
- disabled={false}
- hovered={true}
- variant="default"
- onClick={handleSelection}
- className
- />
- );
- };
- ```
- </Tab>
-
- <Tab title="Propiedades">
- | Propiedades | Tipo | Descripción |
- | ------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
- | color | cadena | El color del tema que se mostrará como muestra en el elemento del menú. Las opciones incluyen: `verde`, `turquesa`, `cielo`, `azul`, `púrpura`, `rosa`, `rojo`, `naranja`, `amarillo`, `gris` |
- | seleccionado | booleano | Indica si el elemento del menú está seleccionado (marcado) |
- | deshabilitado | booleano | Indica si el elemento del menú está deshabilitado |
- | hovered | booleano | Indica si el elemento del menú está actualmente siendo sobrevolado |
- | variante | cadena | La variante de la muestra de color. Puede ser `default` o `pipeline` |
- | enClic | función | Función de retorno que se activará cuando se haga clic en el elemento del menú |
- | nombreDeClase | cadena | Nombre opcional para estilo adicional |
- </Tab>
+<Tab title="Uso">
+
+```jsx
+import { MenuItemSelectColor } from "twenty-ui/display";
+
+export const MyComponent = () => {
+ const handleSelection = () => {
+ console.log("Menu item selected");
+ };
+
+ return (
+ <MenuItemSelectColor
+ color="green"
+ selected={true}
+ disabled={false}
+ hovered={true}
+ variant="default"
+ onClick={handleSelection}
+ className
+ />
+ );
+};
+```
+
+</Tab>
+<Tab title="Propiedades">
+
+
+| Propiedades | Tipo | Descripción |
+| ------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| color | cadena | El color del tema que se mostrará como muestra en el elemento del menú. Las opciones incluyen: `verde`, `turquesa`, `cielo`, `azul`, `púrpura`, `rosa`, `rojo`, `naranja`, `amarillo`, `gris` |
+| seleccionado | booleano | Indica si el elemento del menú está seleccionado (marcado) |
+| deshabilitado | booleano | Indica si el elemento del menú está deshabilitado |
+| hovered | booleano | Indica si el elemento del menú está actualmente siendo sobrevolado |
+| variante | cadena | La variante de la muestra de color. Puede ser `default` o `pipeline` |
+| enClic | función | Función de retorno que se activará cuando se haga clic en el elemento del menú |
+| nombreDeClase | cadena | Nombre opcional para estilo adicional |
+
+
+
+
+</Tab>
</Tabs>
### Conmutar
@@ -390,35 +454,42 @@ Un elemento de menú seleccionable con una muestra de color para situaciones don
Un elemento de menú con un interruptor de palanca asociado para permitir a los usuarios habilitar o deshabilitar una característica específica
<Tabs>
- <Tab title="Uso">
- ```jsx
- import { IconBell } from '@tabler/icons-react';
-
- import { MenuItemToggle } from 'twenty-ui/display';
-
- export const MyComponent = () => {
-
- return (
- <MenuItemToggle
- LeftIcon={IconBell}
- text="First Option"
- toggled={true}
- toggleSize="small"
- className
- />
- );
- };
- ```
- </Tab>
-
- <Tab title="Propiedades">
- | Propiedades | Tipo | Descripción |
- | --------------- | --------------- | ----------------------------------------------------------------------------------- |
- | IconoIzquierdo | ComponenteIcono | Un icono izquierdo opcional que se muestra antes del texto en el elemento del menú |
- | texto | cadena | El contenido de texto del elemento del menú |
- | conmutado | booleano | Indica si el interruptor de palanca está en el estado "encendido" o "apagado" |
- | cambioConmutado | función | Función de retorno que se activa cuando el estado del interruptor de palanca cambia |
- | tamañoConmutado | cadena | El tamaño del interruptor de palanca. Puede ser \ |
- | nombreDeClase | cadena | Nombre opcional para estilo adicional |
- </Tab>
+<Tab title="Uso">
+
+```jsx
+import { IconBell } from '@tabler/icons-react';
+
+import { MenuItemToggle } from 'twenty-ui/display';
+
+export const MyComponent = () => {
+
+ return (
+ <MenuItemToggle
+ LeftIcon={IconBell}
+ text="First Option"
+ toggled={true}
+ toggleSize="small"
+ className
+ />
+ );
+};
+```
+
+</Tab>
+<Tab title="Propiedades">
+
+
+| Propiedades | Tipo | Descripción |
+| --------------- | --------------- | ----------------------------------------------------------------------------------- |
+| IconoIzquierdo | ComponenteIcono | Un icono izquierdo opcional que se muestra antes del texto en el elemento del menú |
+| texto | cadena | El contenido de texto del elemento del menú |
+| conmutado | booleano | Indica si el interruptor de palanca está en el estado "encendido" o "apagado" |
+| cambioConmutado | función | Función de retorno que se activa cuando el estado del interruptor de palanca cambia |
+| tamañoConmutado | cadena | El tamaño del interruptor de palanca. Puede ser \ |
+| nombreDeClase | cadena | Nombre opcional para estilo adicional |
+
+
+
+
+</Tab>
</Tabs>
diff --git a/packages/twenty-docs/l/es/twenty-ui/navigation/navigation-bar.mdx b/packages/twenty-docs/l/es/twenty-ui/navigation/navigation-bar.mdx
index 88fe6c3ca7e..72cd6d009b5 100644
--- a/packages/twenty-docs/l/es/twenty-ui/navigation/navigation-bar.mdx
+++ b/packages/twenty-docs/l/es/twenty-ui/navigation/navigation-bar.mdx
@@ -1,45 +1,52 @@
---
title: Barra de navegación
+icon: bars
---
-
Renderiza una barra de navegación que contiene varios componentes `NavigationBarItem`.
<Tabs>
- <Tab title="Uso">
- ```jsx
- import { IconHome, IconUser, IconSettings } from '@tabler/icons-react';
- import { NavigationBar } from "@/ui/navigation/navigation-bar/components/NavigationBar";
-
- export const MyComponent = () => {
-
- const navigationItems = [
- {
- name: "Inicio",
- Icon: IconHome,
- onClick: () => console.log("Se hizo clic en Inicio"),
- },
- {
- name: "Perfil",
- Icon: IconUser,
- onClick: () => console.log("Se hizo clic en Perfil"),
- },
- {
- name: "Configuración",
- Icon: IconSettings,
- onClick: () => console.log("Se hizo clic en Configuración"),
- },
- ];
-
- return <NavigationBar activeItemName="Inicio" items={navigationItems}/>;
- };
- ```
- </Tab>
-
- <Tab title="Props">
- | Props | Tipo | Descripción |
- | ----------------------- | ------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
- | nombreDelElementoActivo | cadena | El nombre del elemento de navegación actualmente activo |
- | elementos | matriz | Una matriz de objetos que representan cada elemento de navegación. Cada objeto contiene el `nombre` del elemento, el componente `Icono` a mostrar y una función `cuandoHagaClick` que se llamará al hacer clic en el elemento |
- </Tab>
+<Tab title="Uso">
+
+```jsx
+import { IconHome, IconUser, IconSettings } from '@tabler/icons-react';
+import { NavigationBar } from "@/ui/navigation/navigation-bar/components/NavigationBar";
+
+export const MyComponent = () => {
+
+ const navigationItems = [
+ {
+ name: "Inicio",
+ Icon: IconHome,
+ onClick: () => console.log("Se hizo clic en Inicio"),
+ },
+ {
+ name: "Perfil",
+ Icon: IconUser,
+ onClick: () => console.log("Se hizo clic en Perfil"),
+ },
+ {
+ name: "Configuración",
+ Icon: IconSettings,
+ onClick: () => console.log("Se hizo clic en Configuración"),
+ },
+ ];
+
+ return <NavigationBar activeItemName="Inicio" items={navigationItems}/>;
+};
+```
+
+</Tab>
+<Tab title="Props">
+
+
+| Props | Tipo | Descripción |
+| ----------------------- | ------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| nombreDelElementoActivo | cadena | El nombre del elemento de navegación actualmente activo |
+| elementos | matriz | Una matriz de objetos que representan cada elemento de navegación. Cada objeto contiene el `nombre` del elemento, el componente `Icono` a mostrar y una función `cuandoHagaClick` que se llamará al hacer clic en el elemento |
+
+
+
+
+</Tab>
</Tabs>
diff --git a/packages/twenty-docs/l/es/twenty-ui/navigation/step-bar.mdx b/packages/twenty-docs/l/es/twenty-ui/navigation/step-bar.mdx
index 4c8e96846da..2bf255eac82 100644
--- a/packages/twenty-docs/l/es/twenty-ui/navigation/step-bar.mdx
+++ b/packages/twenty-docs/l/es/twenty-ui/navigation/step-bar.mdx
@@ -9,25 +9,33 @@ title: Barra de Paso
Muestra el progreso a través de una secuencia de pasos numerados resaltando el paso activo. Renderiza un contenedor con pasos, cada uno representado por el componente `Step`.
<Tabs>
- <Tab title="Uso">
- ```jsx
- import { StepBar } from "@/ui/navigation/step-bar/components/StepBar";
-
- export const MyComponent = () => {
- return (
- <StepBar activeStep={2}>
- <StepBar.Step>Step 1</StepBar.Step>
- <StepBar.Step>Step 2</StepBar.Step>
- <StepBar.Step>Step 3</StepBar.Step>
- </StepBar>
- );
- };
- ```
- </Tab>
-
- <Tab title="Props">
- | Props | Tipo | Descripción |
- | ----------- | ------ | ------------------------------------------------------------------------------------------ |
- | Paso activo | número | El índice del paso actualmente activo. Esto determina qué paso debe resaltarse visualmente |
- </Tab>
+<Tab title="Uso">
+
+```jsx
+import { StepBar } from "@/ui/navigation/step-bar/components/StepBar";
+
+export const MyComponent = () => {
+ return (
+ <StepBar activeStep={2}>
+ <StepBar.Step>Step 1</StepBar.Step>
+ <StepBar.Step>Step 2</StepBar.Step>
+ <StepBar.Step>Step 3</StepBar.Step>
+ </StepBar>
+ );
+};
+```
+
+</Tab>
+
+<Tab title="Props">
+
+
+| Props | Tipo | Descripción |
+| ----------- | ------ | ------------------------------------------------------------------------------------------ |
+| Paso activo | número | El índice del paso actualmente activo. Esto determina qué paso debe resaltarse visualmente |
+
+
+
+
+</Tab>
</Tabs>
diff --git a/packages/twenty-docs/l/es/twenty-ui/progress-bar.mdx b/packages/twenty-docs/l/es/twenty-ui/progress-bar.mdx
index f115e005951..5e537d696e4 100644
--- a/packages/twenty-docs/l/es/twenty-ui/progress-bar.mdx
+++ b/packages/twenty-docs/l/es/twenty-ui/progress-bar.mdx
@@ -2,39 +2,46 @@
title: Retroalimentación
---
-
Indica el progreso o la cuenta regresiva y se mueve de derecha a izquierda.
<Tabs>
- <Tab title="Uso">
- ```jsx
- import { ProgressBar } from "twenty-ui/feedback";
-
- export const MyComponent = () => {
- return (
- <ProgressBar
- duration={6000}
- delay={0}
- easing="easeInOut"
- barHeight={10}
- barColor="#4bb543"
- autoStart={true}
- />
- );
- };
- ```
- </Tab>
-
- <Tab title="Props">
- | Props | Tipo | Descripción | Predeterminado |
- | ---------------- | -------- | --------------------------------------------------------------------------------------------------------- | -------------- |
- | duración | número | La duración total de la animación de la barra de progreso en milisegundos | 3 |
- | retraso | número | El retraso en el inicio de la animación de la barra de progreso en milisegundos | 0 |
- | aceleración | cadena | Función de aceleración para la animación de la barra de progreso | easeInOut |
- | alturaDeBarra | número | La altura de la barra en píxeles | 24 |
- | colorDeBarra | cadena | El color de la barra | gray80 |
- | inicioAutomático | booleano | Si es `true`, la animación de la barra de progreso comienza automáticamente cuando el componente se monta | `verdadero` |
- </Tab>
+
+<Tab title="Uso">
+
+```jsx
+import { ProgressBar } from "twenty-ui/feedback";
+
+export const MyComponent = () => {
+ return (
+ <ProgressBar
+ duration={6000}
+ delay={0}
+ easing="easeInOut"
+ barHeight={10}
+ barColor="#4bb543"
+ autoStart={true}
+ />
+ );
+};
+```
+
+</Tab>
+
+<Tab title="Props">
+
+
+| Props | Tipo | Descripción | Predeterminado |
+| ---------------- | -------- | --------------------------------------------------------------------------------------------------------- | -------------- |
+| duración | número | La duración total de la animación de la barra de progreso en milisegundos | 3 |
+| retraso | número | El retraso en el inicio de la animación de la barra de progreso en milisegundos | 0 |
+| aceleración | cadena | Función de aceleración para la animación de la barra de progreso | easeInOut |
+| alturaDeBarra | número | La altura de la barra en píxeles | 24 |
+| colorDeBarra | cadena | El color de la barra | gray80 |
+| inicioAutomático | booleano | Si es `true`, la animación de la barra de progreso comienza automáticamente cuando el componente se monta | `verdadero` |
+
+
+
+</Tab>
</Tabs>
## Barra de Progreso Circular
@@ -42,21 +49,30 @@ Indica el progreso o la cuenta regresiva y se mueve de derecha a izquierda.
Indica el progreso de una tarea, a menudo se usa en pantallas de carga o áreas donde se desea comunicar procesos en curso al usuario.
<Tabs>
- <Tab title="Uso">
- ```jsx
- import { CircularProgressBar } from "@/ui/feedback/progress-bar/components/CircularProgressBar";
-
- export const MyComponent = () => {
- return <CircularProgressBar size={80} barWidth={6} barColor="green" />;
- };
- ```
- </Tab>
-
- <Tab title="Props">
- | Props | Tipo | Descripción | Predeterminado |
- | ------------ | ------ | -------------------------------------------- | -------------- |
- | tamaño | número | El tamaño de la barra de progreso circular | 50 |
- | anchoDeBarra | número | El ancho de la línea de la barra de progreso | 5 |
- | colorDeBarra | cadena | El color de la barra de progreso | currentColor |
- </Tab>
+
+<Tab title="Uso">
+
+```jsx
+import { CircularProgressBar } from "@/ui/feedback/progress-bar/components/CircularProgressBar";
+
+export const MyComponent = () => {
+ return <CircularProgressBar size={80} barWidth={6} barColor="green" />;
+};
+```
+
+</Tab>
+
+<Tab title="Props">
+
+
+| Props | Tipo | Descripción | Predeterminado |
+| ------------ | ------ | -------------------------------------------- | -------------- |
+| tamaño | número | El tamaño de la barra de progreso circular | 50 |
+| anchoDeBarra | número | El ancho de la línea de la barra de progreso | 5 |
+| colorDeBarra | cadena | El color de la barra de progreso | currentColor |
+
+
+
+</Tab>
+
</Tabs>
diff --git a/packages/twenty-docs/l/es/user-guide/ai/capabilities/ai-agents.mdx b/packages/twenty-docs/l/es/user-guide/ai/capabilities/ai-agents.mdx
index 715a5eb9a58..24788cf9f64 100644
--- a/packages/twenty-docs/l/es/user-guide/ai/capabilities/ai-agents.mdx
+++ b/packages/twenty-docs/l/es/user-guide/ai/capabilities/ai-agents.mdx
@@ -4,7 +4,7 @@ description: Integra capacidades de IA directamente en tus flujos de trabajo de
---
<Note>
- Esta función está en desarrollo y estará disponible en beta próximamente.
+Esta función está en desarrollo y estará disponible en beta próximamente.
</Note>
## Resumen
diff --git a/packages/twenty-docs/l/es/user-guide/ai/capabilities/ai-chatbot.mdx b/packages/twenty-docs/l/es/user-guide/ai/capabilities/ai-chatbot.mdx
index ae18a6b4c2f..cded9090e41 100644
--- a/packages/twenty-docs/l/es/user-guide/ai/capabilities/ai-chatbot.mdx
+++ b/packages/twenty-docs/l/es/user-guide/ai/capabilities/ai-chatbot.mdx
@@ -4,7 +4,7 @@ description: Un asistente inteligente que te ayuda a interactuar con tus datos d
---
<Note>
- Esta función está en desarrollo y estará disponible en beta próximamente.
+Esta función está en desarrollo y estará disponible en beta próximamente.
</Note>
## Resumen
diff --git a/packages/twenty-docs/l/es/user-guide/ai/capabilities/mcp.mdx b/packages/twenty-docs/l/es/user-guide/ai/capabilities/mcp.mdx
new file mode 100644
index 00000000000..51452cf01ec
--- /dev/null
+++ b/packages/twenty-docs/l/es/user-guide/ai/capabilities/mcp.mdx
@@ -0,0 +1,141 @@
+---
+title: Servidor MCP
+description: Conecta asistentes de IA a tu espacio de trabajo de Twenty mediante el Model Context Protocol.
+---
+
+<Warning>
+Actualmente, MCP está en **alfa** y solo está disponible en algunos espacios de trabajo. Es posible que aún no esté habilitado para tu espacio de trabajo.
+</Warning>
+
+Twenty expone un servidor [MCP](https://modelcontextprotocol.io/) para que los asistentes de IA — Claude Desktop, Claude Code, Cursor, ChatGPT y otros — puedan leer y escribir tus datos de CRM mediante lenguaje natural.
+
+Usa tu **URL del espacio de trabajo** (la URL que utilizas para acceder a Twenty) como el punto de acceso MCP. En Twenty Cloud, la URL de tu espacio de trabajo puede ser `https://{mycompany}.twenty.com` o un dominio personalizado. El servidor está disponible en:
+
+| Entorno | Punto de acceso MCP |
+| ------------------- | ------------------------------------------------------------------------------- |
+| **Nube** | `https://{your-workspace-url}/mcp` (p. ej., `https://mycompany.twenty.com/mcp`) |
+| **Autoalojamiento** | `https://{your-domain}/mcp` |
+
+## Métodos de autenticación
+
+Tienes dos formas de autenticar tu cliente MCP: **OAuth** (recomendado) o **API Key**.
+
+### Opción A — OAuth (recomendado)
+
+Con OAuth, tu cliente MCP abre una ventana del navegador para que inicies sesión. No se guardan secretos en archivos de configuración y los tokens se actualizan automáticamente.
+
+<Note>
+OAuth requiere un cliente MCP que sea compatible con la [especificación de autorización de MCP](https://modelcontextprotocol.io/specification/2025-03-26/basic/authorization). Claude Desktop, Claude Code, Cursor y ChatGPT lo admiten.
+</Note>
+
+Agrega esto a la configuración de tu cliente MCP, reemplazando `{your-workspace-url}` por el host de tu espacio de trabajo (p. ej., `mycompany.twenty.com`):
+
+```json
+{
+ "mcpServers": {
+ "twenty": {
+ "type": "streamable-http",
+ "url": "https://{your-workspace-url}/mcp"
+ }
+ }
+}
+```
+
+Eso es todo: no se necesita clave de API. Cuando el cliente se conecte por primera vez, hará lo siguiente:
+
+1. Descubrir los metadatos de OAuth de Twenty a través de `/.well-known/oauth-protected-resource` y `/.well-known/oauth-authorization-server`
+2. Registrarse como cliente OAuth mediante registro dinámico de clientes (RFC 7591)
+3. Abrir tu navegador para autorizar el acceso
+4. Recibir tokens y conectarse al servidor MCP
+
+Las conexiones posteriores reutilizan los tokens almacenados y los actualizan automáticamente.
+
+### Opción B — API Key
+
+Si tu cliente MCP no es compatible con OAuth o prefieres credenciales estáticas, pasa una clave de API en el encabezado `Authorization`:
+
+```json
+{
+ "mcpServers": {
+ "twenty": {
+ "type": "streamable-http",
+ "url": "https://{your-workspace-url}/mcp",
+ "headers": {
+ "Authorization": "Bearer YOUR_API_KEY"
+ }
+ }
+ }
+}
+```
+
+<Warning>
+Tu clave de API concede acceso a los datos del espacio de trabajo. Manténla fuera del control de versiones y de dotfiles compartidos.
+</Warning>
+
+Para crear una clave de API, ve a **Settings > APIs & Webhooks > + Create key**. Consulta [APIs](/l/es/developers/extend/api#create-an-api-key) para más detalles.
+
+## Inicio rápido
+
+### 1. Copia la configuración
+
+Ve a **Settings > AI > More > MCP Server** en Twenty. Elige tu método de autenticación (OAuth o API Key), copia el fragmento JSON (ya usará la URL de tu espacio de trabajo) y pégalo en el archivo de configuración de tu cliente MCP.
+
+| Cliente | Ubicación del archivo de configuración |
+| ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| **Claude Desktop** | `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) o `%APPDATA%\Claude\claude_desktop_config.json` (Windows) |
+| **Claude Code** | `~/.claude.json` (usuario) o `.mcp.json` (proyecto) |
+| **Cursor** | `.cursor/mcp.json` en tu proyecto, o `~/.cursor/mcp.json` de forma global |
+| **ChatGPT** | Activa Developer Mode en **Settings > Apps & Connectors > Advanced settings**, luego usa **Create** en **Settings > Apps & Connectors** para añadir el servidor MCP |
+
+### 2. Conectar
+
+Reinicia tu cliente MCP (o recarga la configuración). Si usas OAuth, se te redirigirá a Twenty para autorizar el acceso. Si usas una clave de API, la conexión es inmediata.
+
+### 3. Empieza a usarlo
+
+Pídele a tu asistente de IA que interactúe con tu CRM:
+
+* *"Muéstrame las 5 empresas creadas más recientemente"*
+* *"Crea una nueva persona llamada Jane Doe en Acme Corp"*
+* *"Encuentra todas las oportunidades abiertas con un valor superior a $10k"*
+
+## Herramientas disponibles
+
+Una vez conectado, el servidor MCP expone herramientas que reflejan la API de Twenty. El flujo de trabajo recomendado es:
+
+1. **`learn_tools`** — obtener el esquema de entrada para herramientas específicas
+2. **`execute_tool`** — ejecutar una herramienta
+
+No necesitas recordar los nombres de las herramientas. Pregúntale a tu asistente de IA qué puede hacer y llamará a `learn_tools` automáticamente.
+
+## Permisos
+
+Las conexiones MCP heredan los permisos del usuario autenticado (OAuth) o del rol asignado a la clave de API. Para restringir lo que puede hacer el servidor MCP:
+
+* **OAuth**: Se aplica el rol del espacio de trabajo del usuario.
+* **API Key**: Asigna un rol a la clave de API en **Settings > Roles**. Consulta [Permisos](/l/es/user-guide/permissions-access/capabilities/permissions).
+
+## Configuración autohospedada
+
+Para instancias autohospedadas, reemplaza `{your-workspace-url}` por la URL de tu servidor. Asegúrate de que `SERVER_URL` en tu entorno coincida con la URL pública de tu instancia de Twenty — se utiliza para generar los metadatos de descubrimiento de OAuth.
+
+```bash
+SERVER_URL=https://twenty.yourcompany.com
+```
+
+El punto de acceso MCP, los puntos de acceso de OAuth y los metadatos de descubrimiento se derivan de este valor.
+
+## Solución de Problemas
+
+**Errores "Unauthorized" o 401**
+
+* OAuth: vuelve a autorizar limpiando los tokens almacenados en tu cliente MCP y reconectando.
+* API Key: verifica que la clave sea válida y no haya caducado. Vuelve a generarla si es necesario.
+
+**El flujo de OAuth no abre un navegador**
+
+* Asegúrate de que tu cliente MCP sea compatible con MCP Authorization. Si no lo es, recurre al método de clave de API.
+
+**Tiempo de espera de la conexión**
+
+* Confirma que la URL del punto de acceso MCP sea accesible desde tu equipo. Para instancias autohospedadas, comprueba que el servidor esté en ejecución y que `SERVER_URL` esté configurado correctamente.
diff --git a/packages/twenty-docs/l/es/user-guide/ai/capabilities/permissions-access-control.mdx b/packages/twenty-docs/l/es/user-guide/ai/capabilities/permissions-access-control.mdx
index d0078282501..b02c0469d75 100644
--- a/packages/twenty-docs/l/es/user-guide/ai/capabilities/permissions-access-control.mdx
+++ b/packages/twenty-docs/l/es/user-guide/ai/capabilities/permissions-access-control.mdx
@@ -9,7 +9,7 @@ Los agentes de IA respetan tu estructura de permisos existente. Esto es especial
## Asignar un rol a un agente de IA
-1. Ir a **Ajustes → Roles**
+1. Ve a **Ajustes → Miembros → Roles**
2. Haz clic en el rol que deseas asignar
3. Abre la pestaña **Asignación**
4. En **Agentes de IA**, haz clic en **+ Asignar a agente de IA**
@@ -26,7 +26,7 @@ Los agentes de IA respetan tu estructura de permisos existente. Esto es especial
| **Auditabilidad** | Haz un seguimiento de qué acciones realizó cada agente |
<Note>
- Para los agentes de IA que se ejecutan dentro de flujos de trabajo, la asignación de roles garantiza que el agente no pueda acceder ni modificar datos fuera de su ámbito previsto—incluso si el flujo de trabajo tiene permisos más amplios.
+Para los agentes de IA que se ejecutan dentro de flujos de trabajo, la asignación de roles garantiza que el agente no pueda acceder ni modificar datos fuera de su ámbito previsto—incluso si el flujo de trabajo tiene permisos más amplios.
</Note>
## Relacionado
diff --git a/packages/twenty-docs/l/es/user-guide/ai/how-tos/ai-faq.mdx b/packages/twenty-docs/l/es/user-guide/ai/how-tos/ai-faq.mdx
index 7fcba7f7cce..5b71eccd849 100644
--- a/packages/twenty-docs/l/es/user-guide/ai/how-tos/ai-faq.mdx
+++ b/packages/twenty-docs/l/es/user-guide/ai/how-tos/ai-faq.mdx
@@ -4,6 +4,7 @@ description: Preguntas frecuentes sobre las funciones de IA en Twenty.
---
<AccordionGroup>
+
<Accordion title="¿Cuándo estarán disponibles las funciones de IA?">
Las funciones de IA están actualmente en desarrollo y se lanzarán en beta próximamente. ¡Mantente al tanto de las actualizaciones!
</Accordion>
@@ -16,7 +17,7 @@ description: Preguntas frecuentes sobre las funciones de IA en Twenty.
</Accordion>
<Accordion title="¿Tendrán los agentes de IA acceso a todos mis datos?">
- Los agentes de IA operarán bajo el sistema de permisos. Puedes asignar roles específicos a los agentes de IA en **Configuración → Roles**, lo que te da control total sobre a qué datos pueden acceder y qué acciones pueden realizar.
+ Los agentes de IA operarán bajo el sistema de permisos. Puedes asignar roles específicos a los agentes de IA en **Configuración → Miembros → Roles**, lo que te da control total sobre a qué datos pueden acceder y qué acciones pueden realizar.
</Accordion>
<Accordion title="¿Cómo funcionarán los créditos de IA?">
@@ -26,4 +27,5 @@ description: Preguntas frecuentes sobre las funciones de IA en Twenty.
<Accordion title="¿Puedo usar mis propios modelos de IA?">
Inicialmente, Twenty utilizará modelos de IA integrados. El soporte para modelos de IA personalizados o externos podría añadirse en versiones futuras según los comentarios de los usuarios.
</Accordion>
+
</AccordionGroup>
diff --git a/packages/twenty-docs/l/es/user-guide/ai/overview.mdx b/packages/twenty-docs/l/es/user-guide/ai/overview.mdx
index 0990a1e81ea..a3765383a4e 100644
--- a/packages/twenty-docs/l/es/user-guide/ai/overview.mdx
+++ b/packages/twenty-docs/l/es/user-guide/ai/overview.mdx
@@ -48,7 +48,7 @@ Amplía tus flujos de trabajo con acciones impulsadas por IA y agentes autónomo
Los agentes de IA se gestionarán mediante el sistema de permisos existente:
-1. Ve a **Ajustes → Roles**
+1. Ve a **Ajustes → Miembros → Roles**
2. Configura a qué datos puede acceder cada agente de IA
3. Establece permisos de lectura y escritura por objeto
@@ -59,4 +59,4 @@ Esto garantiza que los agentes de IA respeten tus políticas de gobernanza de da
Actualizaremos esta sección a medida que las funciones de IA estén disponibles. Mientras tanto:
* Sigue nuestro [GitHub](https://github.com/twentyhq/twenty) para actualizaciones sobre el desarrollo
-* Únete a nuestro [Discord](https://discord.gg/twenty) para compartir comentarios y solicitudes de funciones
+* Únete a nuestro [Discord](https://discord.gg/UfGNZJfAG6) para compartir comentarios y solicitudes de funciones
diff --git a/packages/twenty-docs/l/es/user-guide/billing/capabilities/credits.mdx b/packages/twenty-docs/l/es/user-guide/billing/capabilities/credits.mdx
index 2ffa631d269..5ac2c8d1bf9 100644
--- a/packages/twenty-docs/l/es/user-guide/billing/capabilities/credits.mdx
+++ b/packages/twenty-docs/l/es/user-guide/billing/capabilities/credits.mdx
@@ -1,34 +1,41 @@
---
-title: Créditos de Workflow
-description: Comprender los créditos de flujo de trabajo, su consumo y cómo comprar más.
+title: Créditos
+description: Cómo los créditos impulsan los flujos de trabajo, los agentes de IA y el chatbot de IA — y cómo gestionar tu saldo.
---
## Resumen
-Los créditos impulsan tus automatizaciones de flujo de trabajo en Twenty. Cada acción de flujo de trabajo consume créditos según su complejidad.
+Los créditos impulsan las automatizaciones de flujos de trabajo y las capacidades de IA. Se consumen cuando se ejecutan acciones de flujos de trabajo, cuando los agentes de IA procesan tareas dentro de los flujos de trabajo y en el chat de IA.
## Asignación de créditos
Los créditos se basan en tu ciclo de facturación, no en tu plan:
-| Ciclo de facturación | Créditos |
-| -------------------- | --------------- |
-| Mensual | 5 millones/mes |
-| Anual | 50 millones/año |
+| Ciclo de facturación | Créditos |
+| -------------------- | -------- |
+| Mensual | 5/mes |
+| Anual | 50/año |
<Note>
- Los 5 millones de créditos mensuales están diseñados para permitirte ejecutar automatizaciones sin preocuparte por los costos. Para la mayoría de los flujos de trabajo que usan acciones estándar, esto es más que suficiente. Solo necesitarás créditos adicionales al ejecutar nodos de código avanzados o funciones impulsadas por IA.
+Los 5 créditos mensuales están diseñados para permitirte ejecutar automatizaciones sin preocuparte por los costos. Para la mayoría de los flujos de trabajo que usan acciones estándar, esto es más que suficiente. Solo necesitarás créditos adicionales al ejecutar nodos de código avanzados o funciones impulsadas por IA.
</Note>
+## Acumulación de créditos
+
+Los créditos no utilizados al final de un período de facturación se transfieren automáticamente al período siguiente.
+
+* **Límite**: El monto acumulado está limitado a la asignación completa de un período, por lo que nunca podrás acumular más créditos de los que tu plan proporciona por período.
+* **Visibilidad**: Cuando haya créditos acumulados disponibles, aparecerán como una línea independiente de **Créditos acumulados** en **Configuración → Facturación**, junto a un saldo de **Total disponible**.
+
## Consumo de créditos
Diferentes acciones consumen distintas cantidades de créditos:
-| Tipo de acción | Uso de Crédito |
+| Tipo de acción | Uso de créditos |
| -------------------------------------------------------------------- | --------------------- |
| **Operaciones básicas** (buscar, actualizar, crear registros) | Mínimo |
| **Operaciones complejas** (nodos de código, llamadas a API externas) | Más créditos |
-| **Consultas de IA** (próximamente) | Variable según el uso |
+| **Prompts de IA y chats de IA** | Variable según el uso |
Los créditos se deducen en tiempo real cuando se ejecutan los flujos de trabajo.
diff --git a/packages/twenty-docs/l/es/user-guide/billing/capabilities/pricing-plans.mdx b/packages/twenty-docs/l/es/user-guide/billing/capabilities/pricing-plans.mdx
index 1de0d238e1b..5250325f6a7 100644
--- a/packages/twenty-docs/l/es/user-guide/billing/capabilities/pricing-plans.mdx
+++ b/packages/twenty-docs/l/es/user-guide/billing/capabilities/pricing-plans.mdx
@@ -1,5 +1,5 @@
---
-title: Planes de precios},{
+title: Planes de precios
description: Obtén información sobre los planes de precios de Twenty y cómo cambiar entre ellos.
---
@@ -19,7 +19,7 @@ Para equipos listos para escalar:
* Soporte estándar
<Note>
- Las funciones premium (SSO y permisos a nivel de fila) no están incluidas en el plan Pro.
+Las funciones Premium (SSO, permisos a nivel de registro y datos de uso de IA) no están incluidas en el plan Pro.
</Note>
### Organización (Nube)
@@ -27,7 +27,7 @@ Para equipos listos para escalar:
Para equipos más grandes con necesidades avanzadas:
* Todo lo de Pro
-* **Funciones premium**: integración de SSO y permisos a nivel de fila
+* **Funciones Premium**: integración con SSO, permisos a nivel de registro y datos de uso de IA
* Soporte prioritario
## Planes de autoalojamiento
@@ -45,7 +45,7 @@ Aloja Twenty en tu propia infraestructura sin costo:
Para equipos que necesitan funciones premium mientras se autoalojan:
* Todas las funciones de Pro
-* **Funciones premium**: integración de SSO y permisos a nivel de fila
+* **Funciones Premium**: integración con SSO, permisos a nivel de registro y datos de uso de IA
* Soporte del equipo de Twenty
* No es obligatorio publicar el código personalizado como código abierto antes de distribuirlo
@@ -55,6 +55,7 @@ Las funciones premium solo están disponibles en los planes de Organización (Nu
* **Integración de SSO**: inicio de sesión único con tu proveedor de identidad
* **Permisos a nivel de fila**: control de acceso granular a nivel de registro
+* **Datos de uso de IA**: Realice un seguimiento del consumo de IA en su espacio de trabajo
## Cambiar de plan
@@ -77,3 +78,15 @@ Contacta al equipo de soporte para reducir tu plan.
### Cambiar a facturación mensual
Contacta al equipo de soporte para volver a la facturación mensual.
+
+## Obtener una clave Enterprise para Organization (Self-Hosted)
+
+Para usar el plan Organization (Self-Hosted), necesita obtener una clave Enterprise:
+
+1. Vaya a **Configuración → Panel de Administración → Enterprise**
+
+<img src="/images/user-guide/billing/enterprise-key.png" alt="Clave Enterprise" />
+
+2. Haga clic en **Obtener clave Enterprise**
+3. Cuando sea redirigido a Stripe, introduzca sus datos de pago y confirme
+4. Cuando se muestre su clave Enterprise, péguela en la página de configuración de Enterprise y active la licencia de Organization
diff --git a/packages/twenty-docs/l/es/user-guide/billing/how-tos/billing-faq.mdx b/packages/twenty-docs/l/es/user-guide/billing/how-tos/billing-faq.mdx
index 8e4c4cdc3ea..9789ab69e2a 100644
--- a/packages/twenty-docs/l/es/user-guide/billing/how-tos/billing-faq.mdx
+++ b/packages/twenty-docs/l/es/user-guide/billing/how-tos/billing-faq.mdx
@@ -6,81 +6,83 @@ description: Preguntas frecuentes sobre los precios y la facturación de Twenty.
## Precios
<AccordionGroup>
- <Accordion title="¿Puedo usar Twenty gratis mientras lo alojo por mi cuenta?">
- Sí, puedes usar Twenty gratis mientras lo alojas por tu cuenta. Tendrás acceso a todo lo incluido en el plan Pro (nube), excepto el soporte de nuestro equipo central. El soporte está disponible a través de nuestra comunidad en Discord.
-
- Si quieres alojar por tu cuenta y necesitas las funciones Premium (SSO y permisos a nivel de registro), puedes elegir la licencia de pago de Organization (Self-Hosted). Esto también incluye soporte del equipo de Twenty y elimina el requisito de publicar el código personalizado como código abierto antes de distribuirlo.
- </Accordion>
-
- <Accordion title="¿Cuáles son las funciones Premium?">
- Las funciones Premium solo están disponibles en los planes Organization (nube o Self-Hosted):
-
- * **Integración de SSO**: inicio de sesión único con tu proveedor de identidad
- * **Permisos a nivel de registro**: control de acceso granular a nivel de registro
- </Accordion>
-
- <Accordion title="¿Ofrecen licencias gratuitas para usuarios de solo lectura?">
- No ofrecemos asientos gratuitos. El precio es por usuario y cada usuario necesita una licencia para acceder a Twenty.
- </Accordion>
-
- <Accordion title="¿Dónde puedo cambiar mi suscripción al plan de Organización?">
- Puedes hacerlo en `Configuración → Facturación`. Luego haz clic en `Cambiar a Organización`.
- </Accordion>
-
- <Accordion title="¿Dónde puedo cambiar mi suscripción al plan Pro?">
- Por favor, comunícate directamente con nuestro equipo a través del Soporte, no hay una forma sencilla de hacer esto utilizando la IU en este momento.
- </Accordion>
-
- <Accordion title="¿Dónde puedo cambiar mi suscripción a Anual?">
- Puedes hacerlo en `Configuración → Facturación`. Luego haz clic en `Cambiar a Anual`.
- </Accordion>
-
- <Accordion title="¿Dónde puedo cambiar mi suscripción a Mensual?">
- Por favor, comunícate directamente con nuestro equipo a través del Soporte, no hay una forma sencilla de hacer esto utilizando la IU en este momento.
- </Accordion>
-
- <Accordion title="¿Dónde puedo ver mi uso de créditos?">
- Lo encontrarás en `Configuración → Facturación`.
- </Accordion>
-
- <Accordion title="¿Cuántos créditos de flujo de trabajo tenemos?">
- Los créditos se basan en tu ciclo de facturación, no en tu plan:
-
- * **Suscripciones mensuales**: 5 millones de créditos por mes
- * **Suscripciones anuales**: 50 millones de créditos por año
- </Accordion>
-
- <Accordion title="¿Cómo funciona el consumo de créditos de flujo de trabajo?">
- Cada acción de flujo de trabajo consume créditos según su complejidad:
-
- * Las **operaciones internas básicas** (como búsqueda, actualización, creación de registros) consumen muy pocos créditos.
- * Las **operaciones más complejas** como nodos de código y solicitudes a servicios externos consumen más créditos.
- * **Consultas de IA** (próximamente) también consumirán más créditos según el uso.
-
- Los créditos se deducen en tiempo real cuando se ejecutan los flujos de trabajo. Puedes monitorear tu uso en **Configuración → Facturación** para seguir el consumo y los créditos restantes.
- </Accordion>
-
- <Accordion title="¿Puedo comprar más créditos de flujo de trabajo?">
- Puedes comprar créditos adicionales en `Configuración → Facturación`.
- </Accordion>
+<Accordion title="¿Puedo usar Twenty gratis mientras lo alojo por mi cuenta?">
+Sí, puedes usar Twenty gratis mientras lo alojas por tu cuenta. Tendrás acceso a todo lo incluido en el plan Pro (nube), excepto el soporte de nuestro equipo central. El soporte está disponible a través de nuestra comunidad en Discord.
+
+Si quieres alojar por tu cuenta y necesitas las funciones Premium (SSO y permisos a nivel de registro), puedes elegir la licencia de pago de Organization (Self-Hosted). Esto también incluye soporte del equipo de Twenty y elimina el requisito de publicar el código personalizado como código abierto antes de distribuirlo.
+</Accordion>
+
+<Accordion title="¿Cuáles son las funciones Premium?">
+Las funciones Premium solo están disponibles en los planes Organization (nube o Self-Hosted):
+* **Integración de SSO**: inicio de sesión único con tu proveedor de identidad
+* **Permisos a nivel de registro**: control de acceso granular a nivel de registro
+* **Datos de uso de IA**: Realice un seguimiento del consumo de IA en su espacio de trabajo
+</Accordion>
+
+<Accordion title="¿El plan Organization en la nube y el plan Organization autoalojado son lo mismo?">
+Ofrecen las mismas funciones Premium. Sin embargo, una suscripción en la nube no puede usarse para implementaciones autoalojadas. La versión autoalojada requiere una clave Enterprise.
+</Accordion>
+
+<Accordion title="¿Ofrecen licencias gratuitas para usuarios de solo lectura?">
+No ofrecemos asientos gratuitos. El precio es por usuario y cada usuario necesita una licencia para acceder a Twenty.
+</Accordion>
+
+<Accordion title="¿Dónde puedo cambiar mi suscripción al plan de Organización?">
+Puedes hacerlo en `Configuración → Facturación`. Luego haz clic en `Cambiar a Organización`.
+</Accordion>
+
+<Accordion title="¿Dónde puedo cambiar mi suscripción al plan Pro?">
+Por favor, comunícate directamente con nuestro equipo a través del Soporte, no hay una forma sencilla de hacer esto utilizando la IU en este momento.
+</Accordion>
+
+<Accordion title="¿Dónde puedo cambiar mi suscripción a Anual?">
+Puedes hacerlo en `Configuración → Facturación`. Luego haz clic en `Cambiar a Anual`.
+</Accordion>
+
+<Accordion title="¿Dónde puedo cambiar mi suscripción a Mensual?">
+Por favor, comunícate directamente con nuestro equipo a través del Soporte, no hay una forma sencilla de hacer esto utilizando la IU en este momento.
+</Accordion>
+
+<Accordion title="¿Dónde puedo ver mi uso de créditos?">
+Lo encontrarás en `Configuración → Facturación`.
+</Accordion>
+
+<Accordion title="¿Cuántos créditos de flujo de trabajo tenemos?">
+Los créditos se basan en tu ciclo de facturación, no en tu plan:
+* **Suscripciones mensuales**: 5 créditos por mes
+* **Suscripciones anuales**: 50 créditos por año
+</Accordion>
+
+<Accordion title="¿Cómo funciona el consumo de créditos de flujo de trabajo?">
+Cada acción de flujo de trabajo consume créditos según su complejidad:
+* Las **operaciones internas básicas** (como búsqueda, actualización, creación de registros) consumen muy pocos créditos.
+* Las **operaciones más complejas** como nodos de código y solicitudes a servicios externos consumen más créditos.
+* **Consultas de IA** (próximamente) también consumirán más créditos según el uso.
+
+Los créditos se deducen en tiempo real cuando se ejecutan los flujos de trabajo. Puedes monitorear tu uso en **Configuración → Facturación** para seguir el consumo y los créditos restantes.
+</Accordion>
+
+<Accordion title="¿Puedo comprar más créditos de flujo de trabajo?">
+Puedes comprar créditos adicionales en `Configuración → Facturación`.
+</Accordion>
</AccordionGroup>
## Facturación
<AccordionGroup>
- <Accordion title="¿Dónde puedo gestionar los detalles de Facturación?">
- Puedes hacerlo en `Configuración → Facturación`.
- </Accordion>
+<Accordion title="¿Dónde puedo gestionar los detalles de Facturación?">
+Puedes hacerlo en `Configuración → Facturación`.
+</Accordion>
- <Accordion title="¿Dónde puedo actualizar mi método de pago?">
- Puedes hacerlo en `Configuración → Facturación`. Luego haz clic en `Ver detalles de facturación`. Allí podrás agregar un nuevo método de pago.
- </Accordion>
+<Accordion title="¿Dónde puedo actualizar mi método de pago?">
+Puedes hacerlo en `Configuración → Facturación`. Luego haz clic en `Ver detalles de facturación`. Allí podrás agregar un nuevo método de pago.
+</Accordion>
- <Accordion title="¿Dónde puedo actualizar mi información de facturación?">
- Puedes hacerlo en `Configuración → Facturación`. Luego haz clic en `Ver detalles de facturación`. Allí podrás editar la información de facturación.
- </Accordion>
+<Accordion title="¿Dónde puedo actualizar mi información de facturación?">
+Puedes hacerlo en `Configuración → Facturación`. Luego haz clic en `Ver detalles de facturación`. Allí podrás editar la información de facturación.
+</Accordion>
- <Accordion title="¿Dónde puedo acceder a mis facturas?">
- Puedes hacerlo en `Configuración → Facturación`. Luego haz clic en `Ver detalles de facturación`. Verás todas tus facturas al final de la pantalla.
- </Accordion>
+<Accordion title="¿Dónde puedo acceder a mis facturas?">
+Puedes hacerlo en `Configuración → Facturación`. Luego haz clic en `Ver detalles de facturación`. Verás todas tus facturas al final de la pantalla.
+</Accordion>
</AccordionGroup>
diff --git a/packages/twenty-docs/l/es/user-guide/billing/overview.mdx b/packages/twenty-docs/l/es/user-guide/billing/overview.mdx
index 67c812d7aab..370a877687f 100644
--- a/packages/twenty-docs/l/es/user-guide/billing/overview.mdx
+++ b/packages/twenty-docs/l/es/user-guide/billing/overview.mdx
@@ -3,7 +3,6 @@ title: Facturación
description: Comprende los precios de Twenty y gestiona tu suscripción.
---
-
Twenty ofrece planes de precios flexibles para adaptarse a las necesidades de tu equipo. Gestiona tu suscripción, supervisa los créditos de flujos de trabajo y accede a las facturas, todo desde **Settings → Billing**.
## Qué incluye esta sección
@@ -12,7 +11,6 @@ Twenty ofrece planes de precios flexibles para adaptarse a las necesidades de tu
<Card title="Planes de precios" icon="tags" href="/l/es/user-guide/billing/capabilities/pricing-plans">
Obtén información sobre los planes de precios de Twenty y lo que incluyen.
</Card>
-
<Card title="Preguntas frecuentes" icon="circle-question" href="/l/es/user-guide/billing/how-tos/billing-faq">
Preguntas frecuentes sobre precios y facturación.
</Card>
diff --git a/packages/twenty-docs/l/es/user-guide/calendar-emails/how-tos/can-i-send-emails-from-twenty.mdx b/packages/twenty-docs/l/es/user-guide/calendar-emails/how-tos/can-i-send-emails-from-twenty.mdx
index fe45c456769..370cf14ca96 100644
--- a/packages/twenty-docs/l/es/user-guide/calendar-emails/how-tos/can-i-send-emails-from-twenty.mdx
+++ b/packages/twenty-docs/l/es/user-guide/calendar-emails/how-tos/can-i-send-emails-from-twenty.mdx
@@ -34,7 +34,7 @@ Los correos electrónicos enviados mediante flujos de trabajo se envían a trav
Para las secuencias de correo electrónico y los boletines, recomendamos usar flujos de trabajo para conectar Twenty con una herramienta dedicada de marketing por correo electrónico.
<Warning>
- No se deben enviar correos masivos directamente desde tu buzón para proteger la reputación de tu dominio. Usa una herramienta dedicada para comunicaciones masivas.
+No se deben enviar correos masivos directamente desde tu buzón para proteger la reputación de tu dominio. Usa una herramienta dedicada para comunicaciones masivas.
</Warning>
→ Consulta [Cómo enviar correos electrónicos desde flujos de trabajo](/l/es/user-guide/workflows/capabilities/send-emails-from-workflows) para obtener instrucciones de configuración
diff --git a/packages/twenty-docs/l/es/user-guide/calendar-emails/how-tos/limit-emails-imported.mdx b/packages/twenty-docs/l/es/user-guide/calendar-emails/how-tos/limit-emails-imported.mdx
index 0e4942f5900..71a84536b28 100644
--- a/packages/twenty-docs/l/es/user-guide/calendar-emails/how-tos/limit-emails-imported.mdx
+++ b/packages/twenty-docs/l/es/user-guide/calendar-emails/how-tos/limit-emails-imported.mdx
@@ -1,5 +1,5 @@
---
-title: Limitar los correos electrónicos importados},{
+title: Limitar los correos electrónicos importados
description: Controla qué correos electrónicos se importan en Twenty.
---
diff --git a/packages/twenty-docs/l/es/user-guide/calendar-emails/overview.mdx b/packages/twenty-docs/l/es/user-guide/calendar-emails/overview.mdx
index d23bb66f10c..e7a626fb137 100644
--- a/packages/twenty-docs/l/es/user-guide/calendar-emails/overview.mdx
+++ b/packages/twenty-docs/l/es/user-guide/calendar-emails/overview.mdx
@@ -3,7 +3,6 @@ title: Calendario y correos electrónicos
description: Conecta tus cuentas de correo electrónico y calendario a Twenty.
---
-
## Opciones de conexión
### Cuenta de Google (Gmail y Calendario de Google)
@@ -26,15 +25,25 @@ description: Conecta tus cuentas de correo electrónico y calendario a Twenty.
6. Configura los ajustes de sincronización del calendario (visibilidad, creación automática) → haz clic en **Añadir cuenta**
7. Tus correos y eventos del calendario comenzarán a sincronizarse automáticamente
-### Configuración SMTP/CalDAV (Otros Proveedores)
+### Configuración de IMAP/SMTP/CalDAV (Otros proveedores)
Para otros proveedores de correo y calendario:
1. Ve a **Ajustes → Cuentas**
-2. Configurar los ajustes SMTP para el correo
+2. Configure los ajustes de IMAP para sincronizar el correo entrante y los ajustes de SMTP para enviar correo
3. Configurar los ajustes CalDAV para el calendario
4. Probar la conexión
+<Note>
+**Autoalojamiento en una red aislada (air-gapped) o interna**: De forma predeterminada, Twenty rechaza las conexiones salientes a direcciones IP privadas/internas (protección SSRF). Si su servidor de correo o calendario se ejecuta en una IP local/privada (por ejemplo, un servidor local en una LAN), las conexiones hacia él se bloquearán. Para permitirlas, configure la siguiente variable de entorno en el servidor:
+
+```
+OUTBOUND_HTTP_SAFE_MODE_ENABLED=false
+```
+
+Esto desactiva el modo seguro para **todas** las solicitudes salientes (acciones de flujo de trabajo HTTP, webhooks y conexiones IMAP/SMTP/CalDAV), así que solo configúrelo en redes aisladas y de confianza donde la protección SSRF no sea necesaria.
+</Note>
+
### Múltiples Buzones
* **Cuentas Ilimitadas**: Conecta múltiples cuentas de correo por usuario
@@ -42,7 +51,7 @@ Para otros proveedores de correo y calendario:
* **Ajustes de Sincronización**: Configura diferentes ajustes por buzón
<Warning>
- Solo se pueden conectar verdaderos buzones (por ejemplo, [email protected] con su propia bandeja de entrada). Los alias de correo electrónico que reenvían a otro buzón no se pueden conectar a Twenty.
+Solo se pueden conectar verdaderos buzones (por ejemplo, [email protected] con su propia bandeja de entrada). Los alias de correo electrónico que reenvían a otro buzón no se pueden conectar a Twenty.
</Warning>
## Configuración de Correo
@@ -60,10 +69,19 @@ Elige diferentes niveles de visibilidad para tus correos:
* **Desactivado**: No se crean contactos automáticamente
* **Para mensajes enviados y recibidos**: Crea contactos para todas las interacciones externas por correo electrónico
* **Solo para mensajes enviados**: Crea contactos solo para los correos que envías
-* **Nota**: Los correos internos (mismo dominio) nunca se sincronizan para mantener la privacidad
+* **Nota**: De forma predeterminada, los correos internos (cuando todos los participantes comparten su dominio) no se sincronizan para proteger la privacidad
<Note>Cuando está habilitado, los contactos se vinculan automáticamente a sus registros de Empresa en función de su dominio de correo electrónico. Si la Empresa aún no existe, Twenty la crea para ti.</Note>
+<Note>
+**Sincronización de correos internos**: El comportamiento de "correos internos no sincronizados" es el predeterminado, pero se puede desactivar. El interruptor se encuentra en la configuración avanzada:
+1. Abra **Ajustes** y active el interruptor **Avanzado** en la parte inferior de la página de configuración
+2. Vaya a **General → Seguridad**
+3. Active el interruptor **Sincronizar correos internos** para incluir los correos en los que todos los participantes comparten el mismo dominio
+
+Este es un ajuste a nivel de espacio de trabajo (útil para universidades u organizaciones con dominio compartido).
+</Note>
+
### Controla qué correos se sincronizan con la selección de carpetas de mensajes
Controle qué carpetas de correo electrónico se sincronizan con Twenty:
@@ -80,7 +98,7 @@ Esto te da un control preciso sobre qué correos aparecen en tu CRM sin sincroni
**Qué se Sincroniza:**
* **Correos Externos**: Todos los correos con contactos externos de carpetas seleccionadas
-* **Correos Internos**: No se sincronizan (los correos del mismo dominio permanecen privados)
+* **Correos internos**: No se sincronizan de forma predeterminada (los correos del mismo dominio permanecen privados). Active el interruptor **Avanzado** en la parte inferior de **Ajustes** y, luego, active **Sincronizar correos internos** en **General → Seguridad** para incluirlos en todo el espacio de trabajo.
* **Adjuntos**: Se incluyen en la actualización del H1 2026
**Nota**: No proporcionamos una dirección de correo CC para la sincronización selectiva. En su lugar, usa la función de carpeta de mensajes para lograr el mismo nivel de control sobre qué correos sincronizar con Twenty.
@@ -117,7 +135,7 @@ Elige qué será visible para otros usuarios en tu espacio de trabajo:
**Actualizaciones cada 5 minutos**: Tanto el correo como el calendario se sincronizan automáticamente cada 5 minutos después de la importación inicial.
<Note>
- **Tiempo de la sincronización inicial**: La sincronización del calendario se completa rápidamente (normalmente en unos minutos), mientras que la sincronización del correo electrónico tarda más en el caso de buzones grandes. Twenty importa correos electrónicos a aproximadamente **400 mensajes por minuto** (limitado por el límite de tasa de la API de Gmail), por lo que un buzón con 10 000 correos electrónicos tarda unos 25 minutos. No te preocupes si ves que los contactos de eventos del calendario aparecen antes que tus contactos de correo electrónico; es un comportamiento normal.
+**Tiempo de la sincronización inicial**: La sincronización del calendario se completa rápidamente (normalmente en unos minutos), mientras que la sincronización del correo electrónico tarda más en el caso de buzones grandes. Twenty importa correos electrónicos a aproximadamente **400 mensajes por minuto** (limitado por el límite de tasa de la API de Gmail), por lo que un buzón con 10 000 correos electrónicos tarda unos 25 minutos. No te preocupes si ves que los contactos de eventos del calendario aparecen antes que tus contactos de correo electrónico; es un comportamiento normal.
</Note>
## Próximos Pasos
diff --git a/packages/twenty-docs/l/es/user-guide/dashboards/capabilities/chart-settings.mdx b/packages/twenty-docs/l/es/user-guide/dashboards/capabilities/chart-settings.mdx
index eccbc19fed2..20a8dc9c854 100644
--- a/packages/twenty-docs/l/es/user-guide/dashboards/capabilities/chart-settings.mdx
+++ b/packages/twenty-docs/l/es/user-guide/dashboards/capabilities/chart-settings.mdx
@@ -23,7 +23,7 @@ La configuración está organizada en secciones:
* **Estilo**: colores, etiquetas y opciones visuales
<Note>
- Algunas configuraciones solo aparecen cuando se configuran otras. Por ejemplo, **Granularidad de fecha** solo aparece cuando seleccionas un campo de fecha.
+Algunas configuraciones solo aparecen cuando se configuran otras. Por ejemplo, **Granularidad de fecha** solo aparece cuando seleccionas un campo de fecha.
</Note>
---
@@ -58,11 +58,11 @@ Los filtros funcionan igual que en las vistas de tabla. Úsalos para enfocarte e
<img src="/images/user-guide/dashboard/dashboard-chart-settings-filters.png" alt="Filtro" />
<Tip>
- Para campos de fecha, prueba **Is relative** para crear filtros dinámicos como "Past 7 days" o "This month" que se actualizan automáticamente.
+Para campos de fecha, prueba **Is relative** para crear filtros dinámicos como "Past 7 days" o "This month" que se actualizan automáticamente.
</Tip>
<Tip>
- Se admiten filtros avanzados—agrega varias reglas de filtro y combínalas con lógica **And** u **Or**.
+Se admiten filtros avanzados—agrega varias reglas de filtro y combínalas con lógica **And** u **Or**.
</Tip>
---
@@ -110,11 +110,11 @@ Controla el orden de las categorías en el eje X.
**Consejo**: para las etapas del pipeline, usa **Posición** para mostrar las etapas en el orden de tu proceso de ventas (Lead → Qualified → Proposal → Won).
<Note>
- Las opciones mostradas dependen de tu tipo de campo. Los campos Select tienen todas las opciones; los campos de fecha y texto muestran menos.
+Las opciones mostradas dependen de tu tipo de campo. Los campos Select tienen todas las opciones; los campos de fecha y texto muestran menos.
</Note>
<Tip>
- Con el ordenamiento **Manual**, arrastra categorías para crear un orden personalizado—perfecto para destacar segmentos específicos o contar una historia con tus datos.
+Con el ordenamiento **Manual**, arrastra categorías para crear un orden personalizado—perfecto para destacar segmentos específicos o contar una historia con tus datos.
</Tip>
### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}> <ChartIcon icon="eye-off" />Omitir valores cero </span>
@@ -147,7 +147,7 @@ Los campos booleanos agregan Contar verdadero/falso. Los gráficos agregados con
<img src="/images/user-guide/dashboard/dashboard-chart-settings-y-data-on-display.png" alt="Datos en pantalla" />
<Note>
- Las opciones mostradas dependen de tu campo y del tipo de gráfico. Si no ves una operación esperada, verifica tu tipo de campo.
+Las opciones mostradas dependen de tu campo y del tipo de gráfico. Si no ves una operación esperada, verifica tu tipo de campo.
</Note>
### Proporción
@@ -222,7 +222,7 @@ Establece valores mínimos y máximos fijos para el eje Y.
Define la paleta de colores de tu gráfico. Elige entre una variedad de paletas de colores.
<Note>
- Al agrupar por un campo Select, el gráfico usa automáticamente los colores definidos para cada opción en la configuración de tu campo.
+Al agrupar por un campo Select, el gráfico usa automáticamente los colores definidos para cada opción en la configuración de tu campo.
</Note>
### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}> <ChartIcon icon="gizmo" />Nombre del eje </span>
@@ -256,7 +256,7 @@ Muestra u oculta la leyenda (solo aparece cuando Group by está configurado).
* **Desactivado**: no se muestra la leyenda
<Tip>
- **Pasa el cursor** sobre un elemento de la leyenda para resaltar ese grupo. **Haz clic** para ocultarlo temporalmente del gráfico.
+**Pasa el cursor** sobre un elemento de la leyenda para resaltar ese grupo. **Haz clic** para ocultarlo temporalmente del gráfico.
</Tip>
---
diff --git a/packages/twenty-docs/l/es/user-guide/dashboards/capabilities/dashboards.mdx b/packages/twenty-docs/l/es/user-guide/dashboards/capabilities/dashboards.mdx
index 14d22d9fa1c..67312ccd64b 100644
--- a/packages/twenty-docs/l/es/user-guide/dashboards/capabilities/dashboards.mdx
+++ b/packages/twenty-docs/l/es/user-guide/dashboards/capabilities/dashboards.mdx
@@ -84,9 +84,9 @@ Para añadir un tablero a favoritos, abre el tablero y haz clic en el icono de e
Actualmente, los tableros muestran los datos según la zona horaria del usuario que los visualiza. Esto significa que el mismo tablero puede mostrar métricas diferentes para los miembros del equipo en distintas regiones (p. ej., APAC vs. US).
<Note>
- **Próximamente**: añadiremos la capacidad de establecer una zona horaria específica para un tablero, de modo que todos los usuarios vean datos coherentes independientemente de su ubicación.
+**Próximamente**: añadiremos la capacidad de establecer una zona horaria específica para un tablero, de modo que todos los usuarios vean datos coherentes independientemente de su ubicación.
</Note>
<Note>
- **Próximamente**: los filtros a nivel de tablero te permitirán aplicar filtros en todos los widgets a la vez, lo que hará más rápida la exploración de tus datos.
+**Próximamente**: los filtros a nivel de tablero te permitirán aplicar filtros en todos los widgets a la vez, lo que hará más rápida la exploración de tus datos.
</Note>
diff --git a/packages/twenty-docs/l/es/user-guide/dashboards/capabilities/widgets.mdx b/packages/twenty-docs/l/es/user-guide/dashboards/capabilities/widgets.mdx
index 95cfc2348a7..2e31580346a 100644
--- a/packages/twenty-docs/l/es/user-guide/dashboards/capabilities/widgets.mdx
+++ b/packages/twenty-docs/l/es/user-guide/dashboards/capabilities/widgets.mdx
@@ -14,7 +14,7 @@ Twenty ofrece varios tipos de widgets para visualizar tus datos de CRM.
Muestra los datos como barras horizontales o verticales.
<Frame>
- <img src="/images/user-guide/dashboard/dashboard-widget-bar-chart.png" alt="Gráfico de barras" />
+<img src="/images/user-guide/dashboard/dashboard-widget-bar-chart.png" alt="Gráfico de barras" />
</Frame>
**Ideal para:**
@@ -30,7 +30,7 @@ Muestra los datos como barras horizontales o verticales.
* Contactos agregados por mes
<Note>
- **Límites de visualización**: Los gráficos de barras pueden mostrar un máximo de 100 barras y 50 grupos por barra cuando se usa Agrupar por. Si ves la advertencia "Datos no mostrados: máximo de X barras por gráfico", agrega filtros para acotar tus datos o cambia la agrupación (p. ej., agrupar por semana en lugar de por días).
+**Límites de visualización**: Los gráficos de barras pueden mostrar un máximo de 100 barras y 50 grupos por barra cuando se usa Agrupar por. Si ves la advertencia "Datos no mostrados: máximo de X barras por gráfico", agrega filtros para acotar tus datos o cambia la agrupación (p. ej., agrupar por semana en lugar de por días).
</Note>
### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}><ChartIcon icon="chart-pie" />Gráficos de pastel</span>
@@ -38,7 +38,7 @@ Muestra los datos como barras horizontales o verticales.
Muestra las proporciones de un todo.
<Frame>
- <img src="/images/user-guide/dashboard/dashboard-widget-pie-chart.png" alt="Gráfico de pastel" />
+<img src="/images/user-guide/dashboard/dashboard-widget-pie-chart.png" alt="Gráfico de pastel" />
</Frame>
**Ideal para:**
@@ -58,7 +58,7 @@ Muestra las proporciones de un todo.
Muestra las tendencias a lo largo del tiempo.
<Frame>
- <img src="/images/user-guide/dashboard/dashboard-widget-line-chart.png" alt="Gráfico de líneas" />
+<img src="/images/user-guide/dashboard/dashboard-widget-line-chart.png" alt="Gráfico de líneas" />
</Frame>
**Ideal para:**
@@ -78,7 +78,7 @@ Muestra las tendencias a lo largo del tiempo.
Muestra valores clave individuales de forma destacada.
<Frame>
- <img src="/images/user-guide/dashboard/dashboard-widget-aggregate-chart.png" alt="Gráfico agregado" />
+<img src="/images/user-guide/dashboard/dashboard-widget-aggregate-chart.png" alt="Gráfico agregado" />
</Frame>
**Ideal para:**
@@ -103,7 +103,7 @@ Muestra valores clave individuales de forma destacada.
Incorpora herramientas y contenido externos directamente en tu panel.
<Frame>
- <img src="/images/user-guide/dashboard/dashboard-widget-iframe.png" alt="iFrame" />
+<img src="/images/user-guide/dashboard/dashboard-widget-iframe.png" alt="iFrame" />
</Frame>
**Ideal para:**
@@ -123,7 +123,7 @@ Incorpora herramientas y contenido externos directamente en tu panel.
Añade texto con formato y contenido directamente a tu panel.
<Frame>
- <img src="/images/user-guide/dashboard/dashboard-widget-rich-text.png" alt="Texto enriquecido" />
+<img src="/images/user-guide/dashboard/dashboard-widget-rich-text.png" alt="Texto enriquecido" />
</Frame>
**Ideal para:**
@@ -139,7 +139,7 @@ Añade texto con formato y contenido directamente a tu panel.
* Edición con estilo Markdown
<Note>
- **Próximamente**: Los gráficos de indicador y las tablas aún no están disponibles, pero están en nuestra hoja de ruta.
+**Próximamente**: Los gráficos de indicador y las tablas aún no están disponibles, pero están en nuestra hoja de ruta.
</Note>
### Duplicar widgets
diff --git a/packages/twenty-docs/l/es/user-guide/dashboards/how-tos/dashboards-faq.mdx b/packages/twenty-docs/l/es/user-guide/dashboards/how-tos/dashboards-faq.mdx
index bacd35a2a47..03fc936f9f8 100644
--- a/packages/twenty-docs/l/es/user-guide/dashboards/how-tos/dashboards-faq.mdx
+++ b/packages/twenty-docs/l/es/user-guide/dashboards/how-tos/dashboards-faq.mdx
@@ -47,7 +47,6 @@ description: Preguntas frecuentes sobre los tableros en Twenty.
<Accordion title="¿Con qué frecuencia se actualizan los datos del tablero?">
Los widgets se actualizan automáticamente a medida que cambian tus datos del CRM:
-
* Actualizaciones en tiempo real para la mayoría de las métricas
* Usa el botón de actualizar para una actualización manual si es necesario
* Los datos históricos se conservan para el análisis de tendencias
diff --git a/packages/twenty-docs/l/es/user-guide/dashboards/overview.mdx b/packages/twenty-docs/l/es/user-guide/dashboards/overview.mdx
index a5247bfd936..bbd6de27c2d 100644
--- a/packages/twenty-docs/l/es/user-guide/dashboards/overview.mdx
+++ b/packages/twenty-docs/l/es/user-guide/dashboards/overview.mdx
@@ -3,9 +3,8 @@ title: Tableros
description: Aprende los conceptos básicos de los informes y los paneles en Twenty.
---
-
<Note>
- Los paneles están actualmente en versión beta. Actívelos en **Configuración → Actualizaciones → Acceso anticipado**.
+Los paneles están actualmente en versión beta. Actívelos en **Configuración → Actualizaciones → Acceso anticipado**.
</Note>
## Comprender los paneles
@@ -41,10 +40,9 @@ Los widgets son visualizaciones individuales que muestran datos específicos. Lo
* Texto enriquecido
<Note>
- **Limitaciones actuales**:
-
- * La exportación de paneles y el uso compartido con usuarios externos (usuarios que no utilizan Twenty) no están disponibles por el momento.
- * Los gráficos de indicadores y las tablas aún no están disponibles.
+**Limitaciones actuales**:
+* La exportación de paneles y el uso compartido con usuarios externos (usuarios que no utilizan Twenty) no están disponibles por el momento.
+* Los gráficos de indicadores y las tablas aún no están disponibles.
</Note>
## Primeros pasos
diff --git a/packages/twenty-docs/l/es/user-guide/data-migration/capabilities/field-mapping.mdx b/packages/twenty-docs/l/es/user-guide/data-migration/capabilities/field-mapping.mdx
index a78ceb5fbc3..bd1cf773c13 100644
--- a/packages/twenty-docs/l/es/user-guide/data-migration/capabilities/field-mapping.mdx
+++ b/packages/twenty-docs/l/es/user-guide/data-migration/capabilities/field-mapping.mdx
@@ -141,9 +141,9 @@ Consulta [aquí](#finding-api-names-for-select-fields) dónde encontrar los nomb
<Note>Las nuevas opciones de selección no se crearán automáticamente mediante la importación. Deben agregarse en **Settings → Data Model** antes de importar.</Note>
<Warning>
- **La importación sobrescribe; no agrega.**
+**La importación sobrescribe; no agrega.**
- Si un registro ya tiene seleccionados `VALUE2` y `VALUE3`, y importas ["VALUE1"], el registro solo tendrá `VALUE1` después de la importación. Las selecciones anteriores se reemplazan, no se fusionan.
+Si un registro ya tiene seleccionados `VALUE2` y `VALUE3`, y importas ["VALUE1"], el registro solo tendrá `VALUE1` después de la importación. Las selecciones anteriores se reemplazan, no se fusionan.
</Warning>
### Campos numéricos
diff --git a/packages/twenty-docs/l/es/user-guide/data-migration/capabilities/import-relations.mdx b/packages/twenty-docs/l/es/user-guide/data-migration/capabilities/import-relations.mdx
index ce180d5d33f..8dce2c2f61d 100644
--- a/packages/twenty-docs/l/es/user-guide/data-migration/capabilities/import-relations.mdx
+++ b/packages/twenty-docs/l/es/user-guide/data-migration/capabilities/import-relations.mdx
@@ -44,12 +44,12 @@ Aquí, el Proyecto está en el lado de "uno". Varios registros de diferentes obj
<img src="/images/user-guide/fields/one-to-many-morph.png" style={{width:'100%'}} />
<Warning>
- **Limitación de importación/exportación**: Las relaciones que apuntan a varios tipos de objeto (como Notas → Personas/Empresas/Oportunidades) **aún no son compatibles** en la importación o exportación de CSV.
+**Limitación de importación/exportación**: Las relaciones que apuntan a varios tipos de objeto (como Notas → Personas/Empresas/Oportunidades) **aún no son compatibles** en la importación o exportación de CSV.
- * **Importación**: Solo se pueden importar relaciones de uno a muchos que apunten a un único tipo de objeto en cada lado
- * **Exportación**: Actualmente, las columnas de relaciones que apuntan a varios tipos de objeto se dejan vacías
+* **Importación**: Solo se pueden importar relaciones de uno a muchos que apunten a un único tipo de objeto en cada lado
+* **Exportación**: Actualmente, las columnas de relaciones que apuntan a varios tipos de objeto se dejan vacías
- Esto está en nuestra hoja de ruta.
+Esto está en nuestra hoja de ruta.
</Warning>
### Qué no es compatible hoy
@@ -137,12 +137,12 @@ Si no existe:
## Regla de orden de importación
<Warning>
- **¡Importa siempre primero el lado de "uno"!**
+**¡Importa siempre primero el lado de "uno"!**
- 1. **Empresas** primero (sin dependencias)
- 2. **Personas** en segundo lugar (vinculadas a Empresas)
- 3. **Oportunidades** en tercer lugar (vinculadas a Empresas/Personas)
- 4. **Objetos personalizados** según sus dependencias
+1. **Empresas** primero (sin dependencias)
+2. **Personas** en segundo lugar (vinculadas a Empresas)
+3. **Oportunidades** en tercer lugar (vinculadas a Empresas/Personas)
+4. **Objetos personalizados** según sus dependencias
- El registro padre debe existir antes de que puedas hacer referencia a él.
+El registro padre debe existir antes de que puedas hacer referencia a él.
</Warning>
diff --git a/packages/twenty-docs/l/es/user-guide/data-migration/capabilities/uniqueness-constraints.mdx b/packages/twenty-docs/l/es/user-guide/data-migration/capabilities/uniqueness-constraints.mdx
index cf633036fc4..1ff2ac067a6 100644
--- a/packages/twenty-docs/l/es/user-guide/data-migration/capabilities/uniqueness-constraints.mdx
+++ b/packages/twenty-docs/l/es/user-guide/data-migration/capabilities/uniqueness-constraints.mdx
@@ -50,9 +50,9 @@ Si el valor de un campo único coincide con un registro existente, ese registro
### Registros eliminados lógicamente
<Warning>
- **Los registros eliminados de forma lógica cuentan para la unicidad.**
+**Los registros eliminados de forma lógica cuentan para la unicidad.**
- Los registros eliminados de forma lógica (visibles en Menú de comandos → Ver registros eliminados) se incluyen en las verificaciones de unicidad. Si importas un registro con el mismo valor único que un registro eliminado, el registro eliminado se **restaurará** con los nuevos datos.
+Los registros eliminados de forma lógica (visibles en Menú de comandos → Ver registros eliminados) se incluyen en las verificaciones de unicidad. Si importas un registro con el mismo valor único que un registro eliminado, el registro eliminado se **restaurará** con los nuevos datos.
</Warning>
## Detección de duplicados durante la importación
diff --git a/packages/twenty-docs/l/es/user-guide/data-migration/how-tos/export-your-data.mdx b/packages/twenty-docs/l/es/user-guide/data-migration/how-tos/export-your-data.mdx
index a2ed19c4b9d..17003ccfad1 100644
--- a/packages/twenty-docs/l/es/user-guide/data-migration/how-tos/export-your-data.mdx
+++ b/packages/twenty-docs/l/es/user-guide/data-migration/how-tos/export-your-data.mdx
@@ -24,7 +24,7 @@ Exporta los datos de tu espacio de trabajo a CSV para copias de seguridad, infor
* Solo se exportan las **columnas visibles**
* Solo se exportan los **registros filtrados** (según tu vista actual)
-<Note>Para exportaciones más grandes (más de 20.000 registros), usa filtros para exportar por lotes o usa la [API](/l/es/developers/api).</Note>
+<Note>Para exportaciones más grandes (más de 20.000 registros), usa filtros para exportar por lotes o usa la [API](/l/es/developers/extend/api).</Note>
### Permisos
@@ -148,7 +148,7 @@ La API no tiene límite de registros:
2. Usa la API de GraphQL para consultar registros
3. Procesa los resultados en tu aplicación
-Consulta: [Documentación de la API](/l/es/developers/api)
+Consulta: [Documentación de la API](/l/es/developers/extend/api)
## Consejos y mejores prácticas
@@ -206,4 +206,4 @@ Los archivos exportados pueden contener datos sensibles:
* [Cómo actualizar registros existentes](/l/es/user-guide/data-migration/how-tos/update-existing-records-via-import) — edita y vuelve a importar tu exportación
* [Cómo importar datos mediante la API](/l/es/user-guide/data-migration/how-tos/import-data-via-api) — para conjuntos de datos grandes
-* [Documentación de la API](/l/es/developers/api) — crea flujos de trabajo de exportación personalizados
+* [Documentación de la API](/l/es/developers/extend/api) — crea flujos de trabajo de exportación personalizados
diff --git a/packages/twenty-docs/l/es/user-guide/data-migration/how-tos/fix-import-errors.mdx b/packages/twenty-docs/l/es/user-guide/data-migration/how-tos/fix-import-errors.mdx
index 8ea74f6421f..41fba178690 100644
--- a/packages/twenty-docs/l/es/user-guide/data-migration/how-tos/fix-import-errors.mdx
+++ b/packages/twenty-docs/l/es/user-guide/data-migration/how-tos/fix-import-errors.mdx
@@ -71,12 +71,12 @@ Un campo único (correo electrónico, dominio) ya sea:
3. Twenty actualizará el registro existente en lugar de crear un duplicado
<Note>
- **También puedes actualizar campos únicos.**
+**También puedes actualizar campos únicos.**
- * Si mantienes el `id` pero cambias el `email` → se actualizará el correo electrónico
- * Si mantienes el `email` pero cambias el `id` → se actualizará el id
+* Si mantienes el `id` pero cambias el `email` → se actualizará el correo electrónico
+* Si mantienes el `email` pero cambias el `id` → se actualizará el id
- Siempre que uno de los identificadores únicos coincida, Twenty actualiza el registro.
+Siempre que uno de los identificadores únicos coincida, Twenty actualiza el registro.
</Note>
### Cómo evitar este error
@@ -88,9 +88,9 @@ Antes de importar:
3. Comprueba si los registros ya existen en Twenty
<Warning>
- **Los registros eliminados lógicamente cuentan para la unicidad.**
+**Los registros eliminados lógicamente cuentan para la unicidad.**
- Consulta el Menú de comandos → Ver registros eliminados. Los registros allí aún aplican la unicidad. Elimínalos permanentemente o restáuralos y actualízalos.
+Consulta el Menú de comandos → Ver registros eliminados. Los registros allí aún aplican la unicidad. Elimínalos permanentemente o restáuralos y actualízalos.
</Warning>
Para más detalles: [Restricciones de unicidad](/l/es/user-guide/data-migration/capabilities/uniqueness-constraints)
@@ -140,12 +140,12 @@ Los datos no coinciden con el formato esperado para ese tipo de campo.
#### Fecha
**Problema:** Formato de fecha no reconocido
-**Solución:** Usa un formato consistente en todo el archivo
+**Solución:** Usa el formato `YYYY-MM-DD` de forma consistente en todo el archivo
```
-✓ 2024-03-15 (YYYY-MM-DD - recomendado)
-✓ 03/15/2024 (MM/DD/YYYY)
-✓ 15/03/2024 (DD/MM/YYYY)
+✓ 2024-03-15 (YYYY-MM-DD)
+❌ 03/15/2024 (MM/DD/YYYY)
+❌ 15/03/2024 (DD/MM/YYYY)
```
#### Teléfono
@@ -296,9 +296,9 @@ Estás intentando vincular a un registro que no existe en Twenty.
* Comprueba posibles errores tipográficos y diferencias entre mayúsculas y minúsculas
<Warning>
- **La importación fallará si se hace referencia a un registro inexistente.**
+**La importación fallará si se hace referencia a un registro inexistente.**
- Importa siempre los objetos padre antes que los objetos hijo.
+Importa siempre los objetos padre antes que los objetos hijo.
</Warning>
Para más detalles: [Importar relaciones](/l/es/user-guide/data-migration/capabilities/import-relations)
@@ -372,9 +372,9 @@ Estás intentando asignar un registro a un usuario (Propietario, Asignado) pero
3. Usa el mismo correo que utilizaron para unirse a Twenty
<Warning>
- **Los usuarios deben aceptar las invitaciones antes de importar.**
+**Los usuarios deben aceptar las invitaciones antes de importar.**
- Si un usuario no ha aceptado su invitación, los registros que lo referencian tendrán relaciones de usuario vacías.
+Si un usuario no ha aceptado su invitación, los registros que lo referencian tendrán relaciones de usuario vacías.
</Warning>
---
diff --git a/packages/twenty-docs/l/es/user-guide/data-migration/how-tos/import-companies-via-csv.mdx b/packages/twenty-docs/l/es/user-guide/data-migration/how-tos/import-companies-via-csv.mdx
index c7077ac7e64..2a5060cf4d4 100644
--- a/packages/twenty-docs/l/es/user-guide/data-migration/how-tos/import-companies-via-csv.mdx
+++ b/packages/twenty-docs/l/es/user-guide/data-migration/how-tos/import-companies-via-csv.mdx
@@ -12,23 +12,23 @@ Esta guía te llevará paso a paso por el proceso de importar tus empresas en Tw
### Lista de verificación de requisitos previos
<Check>
- Tu archivo está en formato CSV, XLSX o XLS
+Tu archivo está en formato CSV, XLSX o XLS
</Check>
<Check>
- El archivo tiene menos de 10.000 registros
+El archivo tiene menos de 10.000 registros
</Check>
<Check>
- No hay dominios duplicados en tu archivo
+No hay dominios duplicados en tu archivo
</Check>
<Check>
- Todos los campos personalizados existen en **Settings → Data Model**
+Todos los campos personalizados existen en **Settings → Data Model**
</Check>
<Note>
- ¿Necesitas importar más de 10.000 empresas? Divídelo en varios archivos o usa la [importación por API](/l/es/user-guide/data-migration/how-tos/import-data-via-api).
+¿Necesitas importar más de 10.000 empresas? Divídelo en varios archivos o usa la [importación por API](/l/es/user-guide/data-migration/how-tos/import-data-via-api).
</Note>
## Paso 1: Preparar tus datos de empresa
@@ -46,9 +46,9 @@ Esta guía te llevará paso a paso por el proceso de importar tus empresas en Tw
### Formato de dominio
<Warning>
- **Use el formato `https://domain.com` para dominios.**
+**Use el formato `https://domain.com` para dominios.**
- Esto coincide con el formato utilizado cuando las Empresas se crean automáticamente a partir de la sincronización de correo/calendario, lo que evita duplicados posteriormente.
+Esto coincide con el formato utilizado cuando las Empresas se crean automáticamente a partir de la sincronización de correo/calendario, lo que evita duplicados posteriormente.
</Warning>
**Columnas de dominio:**
@@ -74,7 +74,7 @@ Widget Co,https://widgets.co,widgets.co,New York,USA,50
```
<Note>
- **Consejo profesional:** Haz clic en **Download sample file** durante la importación para ver los nombres de columna exactos que Twenty espera.
+**Consejo profesional:** Haz clic en **Download sample file** durante la importación para ver los nombres de columna exactos que Twenty espera.
</Note>
## Paso 2: Acceder a la función de importación
@@ -123,7 +123,7 @@ Si tienes campos Select o Multi-Select:
3. O crea opciones nuevas si es necesario
<Note>
- Las opciones de Select usan **nombres de API**, no las etiquetas visibles. Ve a **Settings → Data Model** → Activa el **Advanced mode** para ver los nombres de API.
+Las opciones de Select usan **nombres de API**, no las etiquetas visibles. Ve a **Settings → Data Model** → Activa el **Advanced mode** para ver los nombres de API.
</Note>
## Paso 6: Revisa y corrige errores
diff --git a/packages/twenty-docs/l/es/user-guide/data-migration/how-tos/import-contacts-via-csv.mdx b/packages/twenty-docs/l/es/user-guide/data-migration/how-tos/import-contacts-via-csv.mdx
index 996787b3801..52ca599ff81 100644
--- a/packages/twenty-docs/l/es/user-guide/data-migration/how-tos/import-contacts-via-csv.mdx
+++ b/packages/twenty-docs/l/es/user-guide/data-migration/how-tos/import-contacts-via-csv.mdx
@@ -12,29 +12,29 @@ Esta guía le llevará paso a paso por el proceso de importar sus contactos (Per
### Lista de verificación de requisitos previos
<Check>
- Su archivo está en formato CSV, XLSX o XLS
+Su archivo está en formato CSV, XLSX o XLS
</Check>
<Check>
- El archivo tiene menos de 10.000 registros
+El archivo tiene menos de 10.000 registros
</Check>
<Check>
- No hay direcciones de correo electrónico duplicadas en su archivo
+No hay direcciones de correo electrónico duplicadas en su archivo
</Check>
<Check>
- **Empresas importadas primero** (si va a vincular Personas a Empresas)
+**Empresas importadas primero** (si va a vincular Personas a Empresas)
</Check>
<Check>
- Todos los campos personalizados existen en **Settings → Data Model**
+Todos los campos personalizados existen en **Settings → Data Model**
</Check>
<Warning>
- **Importe las Empresas antes que las Personas**
+**Importe las Empresas antes que las Personas**
- Si desea vincular Personas a Empresas, importe primero las Empresas. La Empresa debe existir antes de que pueda hacer referencia a ella.
+Si desea vincular Personas a Empresas, importe primero las Empresas. La Empresa debe existir antes de que pueda hacer referencia a ella.
</Warning>
## Paso 1: Preparar sus datos de contacto
@@ -81,7 +81,7 @@ Agregue una columna con el identificador único de la Empresa:
| `companyId` | UUID | `c776ee49-f608-4a77-8cc8-6fe96ae1e43f` |
<Note>
- **Use el formato de URL del dominio** (`https://acme.com`), no la etiqueta. Esto coincide con cómo se almacenan las Empresas en Twenty.
+**Use el formato de URL del dominio** (`https://acme.com`), no la etiqueta. Esto coincide con cómo se almacenan las Empresas en Twenty.
</Note>
### Estructura de CSV de ejemplo
@@ -93,7 +93,7 @@ Jane,Doe,[email protected],CTO,https://widgets.co,2125551234,US
```
<Note>
- **Consejo profesional:** Haga clic en **Download sample file** durante la importación o exporte algunas Personas existentes para ver los nombres de columna exactos que Twenty espera.
+**Consejo profesional:** Haga clic en **Download sample file** durante la importación o exporte algunas Personas existentes para ver los nombres de columna exactos que Twenty espera.
</Note>
## Paso 2: Acceder a la función de importación
@@ -145,9 +145,9 @@ Al asignar la columna de empresa:
3. Twenty vinculará cada Persona con la Empresa correspondiente
<Warning>
- **Asigne solo UN identificador único para las relaciones.**
+**Asigne solo UN identificador único para las relaciones.**
- No mapees ambos `companyId` y `companyDomain`. Elige uno — preferiblemente el dominio, ya que es legible para humanos.
+No mapees ambos `companyId` y `companyDomain`. Elige uno — preferiblemente el dominio, ya que es legible para humanos.
</Warning>
## Paso 5: Mapea los valores de campos Select
@@ -159,7 +159,7 @@ Si tienes campos Select o Multi-Select (como Fuente del lead):
3. O crea opciones nuevas si es necesario
<Note>
- Las opciones de Select usan **nombres de API**, no las etiquetas visibles. Ve a **Settings → Data Model** → Activa el **Advanced mode** para ver los nombres de API.
+Las opciones de Select usan **nombres de API**, no las etiquetas visibles. Ve a **Settings → Data Model** → Activa el **Advanced mode** para ver los nombres de API.
</Note>
## Paso 6: Revisa y corrige errores
diff --git a/packages/twenty-docs/l/es/user-guide/data-migration/how-tos/import-data-via-api.mdx b/packages/twenty-docs/l/es/user-guide/data-migration/how-tos/import-data-via-api.mdx
index ca998af7d6f..fdb6d3c62ac 100644
--- a/packages/twenty-docs/l/es/user-guide/data-migration/how-tos/import-data-via-api.mdx
+++ b/packages/twenty-docs/l/es/user-guide/data-migration/how-tos/import-data-via-api.mdx
@@ -32,9 +32,9 @@ Twenty aplica límites de tasa para garantizar la estabilidad del sistema:
| **Rendimiento máximo** | ~6.000 registros/minuto |
<Warning>
- **Planifica tu importación en función de estos límites.**
+**Planifica tu importación en función de estos límites.**
- Para 100.000 registros al rendimiento máximo, espera aproximadamente 17 minutos de tiempo de importación. Añade tiempo de margen para el manejo de errores y los reintentos.
+Para 100.000 registros al rendimiento máximo, espera aproximadamente 17 minutos de tiempo de importación. Añade tiempo de margen para el manejo de errores y los reintentos.
</Warning>
## Primeros pasos
@@ -48,19 +48,19 @@ Twenty aplica límites de tasa para garantizar la estabilidad del sistema:
5. Guárdala de forma segura
<Warning>
- **Mantén en secreto tu clave de API.**
+**Mantén en secreto tu clave de API.**
- Cualquiera que tenga tu clave de API puede acceder y modificar los datos de tu espacio de trabajo. Nunca la subas a repositorios de código ni la compartas públicamente.
+Cualquiera que tenga tu clave de API puede acceder y modificar los datos de tu espacio de trabajo. Nunca la subas a repositorios de código ni la compartas públicamente.
</Warning>
### Paso 2: Elige tu API
Twenty admite dos tipos de API:
-| API | Ideal para | Documentación |
-| ----------- | --------------------------------------------------------------------------- | --------------------------------------------------------------- |
-| **GraphQL** | Consultas flexibles, obtención de datos relacionados, operaciones complejas | [Documentación de la API](/l/es/developers/api) |
-| **REST** | Operaciones CRUD simples, patrones REST familiares | [Documentación de la API](/l/es/developers/api) |
+| API | Ideal para | Documentación |
+| ----------- | --------------------------------------------------------------------------- | ------------------------------------------------- |
+| **GraphQL** | Consultas flexibles, obtención de datos relacionados, operaciones complejas | [Documentación de la API](/l/es/developers/extend/api) |
+| **REST** | Operaciones CRUD simples, patrones REST familiares | [Documentación de la API](/l/es/developers/extend/api) |
Ambas APIs admiten:
@@ -173,4 +173,4 @@ Contáctanos en [[email protected]](mailto:[email protected]) o explora nuestr
Para conocer todos los detalles de implementación, ejemplos de código y referencia de esquemas:
-* [Documentación de la API](/l/es/developers/api)
+* [Documentación de la API](/l/es/developers/extend/api)
diff --git a/packages/twenty-docs/l/es/user-guide/data-migration/how-tos/import-relations-between-objects-via-csv.mdx b/packages/twenty-docs/l/es/user-guide/data-migration/how-tos/import-relations-between-objects-via-csv.mdx
index 24566c40e04..20c15e6eba7 100644
--- a/packages/twenty-docs/l/es/user-guide/data-migration/how-tos/import-relations-between-objects-via-csv.mdx
+++ b/packages/twenty-docs/l/es/user-guide/data-migration/how-tos/import-relations-between-objects-via-csv.mdx
@@ -51,9 +51,9 @@ El padre (lado "uno") debe existir en Twenty antes de poder hacer referencia a
4. **Tareas/Notas** (enlazadas a cualquiera de las anteriores)
<Warning>
- **Si el registro padre no existe, la importación fallará.**
+**Si el registro padre no existe, la importación fallará.**
- Verifique siempre que las Empresas estén importadas antes de importar Personas con referencias a Empresas.
+Verifique siempre que las Empresas estén importadas antes de importar Personas con referencias a Empresas.
</Warning>
## Paso 3: Anotar el identificador único del padre
@@ -117,9 +117,9 @@ La columna `companyDomain` hace referencia al dominio de la Empresa.
| ID | UUID | `c776ee49-f608-4a77-8cc8-6fe96ae1e43f` |
<Warning>
- **¡El formato del dominio importa!**
+**¡El formato del dominio importa!**
- Use `https://domain.com` (no solo `domain.com`). Esto coincide con cómo Twenty almacena los dominios de las Empresas y evita errores de coincidencia.
+Use `https://domain.com` (no solo `domain.com`). Esto coincide con cómo Twenty almacena los dominios de las Empresas y evita errores de coincidencia.
</Warning>
### Reglas importantes
@@ -178,7 +178,6 @@ Review proposal,[email protected]
<AccordionGroup>
<Accordion title="¿Qué pasa si mi registro padre no tiene dominio ni correo electrónico?">
Tiene dos opciones:
-
1. Use el `id` de Twenty (exporte los registros padre para obtener sus IDs)
2. Cree un campo único personalizado en su modelo de datos para almacenar un ID externo de su sistema anterior
</Accordion>
@@ -197,7 +196,6 @@ Review proposal,[email protected]
<Accordion title="¿Qué ocurre si un registro padre no existe?">
La importación mostrará un error para esa fila. Puedes hacerlo de las siguientes maneras:
-
* Importe el registro padre primero y luego vuelva a importar
* Corrija el valor de la referencia
* Elimine la fila de la importación
@@ -205,7 +203,6 @@ Review proposal,[email protected]
<Accordion title="¿Por qué mi relación no se vincula correctamente?">
Causas comunes:
-
* Formato incorrecto (use `https://domain.com` para dominios)
* Diferencia de mayúsculas y minúsculas (verifique la ortografía exacta)
* El padre no existe (importe primero los padres)
@@ -214,9 +211,9 @@ Review proposal,[email protected]
</AccordionGroup>
<Warning>
- **Recuerde: los registros eliminados lógicamente cuentan para la unicidad.**
+**Recuerde: los registros eliminados lógicamente cuentan para la unicidad.**
- Si recibe errores de "no encontrado" pero el registro parece existir, consulte Menú de comandos → Ver registros eliminados. Es posible que el padre haya sido eliminado lógicamente.
+Si recibe errores de "no encontrado" pero el registro parece existir, consulte Menú de comandos → Ver registros eliminados. Es posible que el padre haya sido eliminado lógicamente.
</Warning>
## Solución de Problemas
diff --git a/packages/twenty-docs/l/es/user-guide/data-migration/how-tos/migrating-from-other-crms.mdx b/packages/twenty-docs/l/es/user-guide/data-migration/how-tos/migrating-from-other-crms.mdx
index 64be1e821be..8da82d5b596 100644
--- a/packages/twenty-docs/l/es/user-guide/data-migration/how-tos/migrating-from-other-crms.mdx
+++ b/packages/twenty-docs/l/es/user-guide/data-migration/how-tos/migrating-from-other-crms.mdx
@@ -59,17 +59,17 @@ Antes de importar datos, prepara tu espacio de trabajo en Twenty:
4. Configura los ajustes de los campos (único, obligatorio, opciones de selección, etc.)
<Warning>
- **Los campos deben existir antes de la importación.**
+**Los campos deben existir antes de la importación.**
- La importación de CSV crea registros, no campos. Crea todos los campos personalizados en Configuración → Modelo de datos antes de importar.
+La importación de CSV crea registros, no campos. Crea todos los campos personalizados en Configuración → Modelo de datos antes de importar.
</Warning>
### Invita a tu equipo
<Warning>
- **Invita a los usuarios ANTES de importar datos.**
+**Invita a los usuarios ANTES de importar datos.**
- Si tus datos incluyen referencias a usuarios (propietario de la cuenta, asignado, etc.), esos usuarios deben existir en Twenty antes de la importación. De lo contrario, esas relaciones no se podrán asignar.
+Si tus datos incluyen referencias a usuarios (propietario de la cuenta, asignado, etc.), esos usuarios deben existir en Twenty antes de la importación. De lo contrario, esas relaciones no se podrán asignar.
</Warning>
1. Ir a **Ajustes → Miembros**
@@ -116,9 +116,9 @@ Abre cada CSV exportado en una aplicación de hojas de cálculo y prepáralo par
| **Campos de selección** | Usa nombres de API, no etiquetas visibles |
<Warning>
- **El formato del dominio es fundamental.**
+**El formato del dominio es fundamental.**
- Usa `https://domain.com` (no `domain.com` ni `www.domain.com`). Esto coincide con el formato de Twenty y evita duplicados cuando conectas la sincronización de correo/calendario.
+Usa `https://domain.com` (no `domain.com` ni `www.domain.com`). Esto coincide con el formato de Twenty y evita duplicados cuando conectas la sincronización de correo/calendario.
</Warning>
Consulta [Cómo preparar tus archivos CSV](/l/es/user-guide/data-migration/how-tos/prepare-your-csv-files) para conocer los requisitos de formato completos para todos los tipos de campos.
@@ -149,17 +149,16 @@ Consulta [Cómo preparar tus archivos CSV](/l/es/user-guide/data-migration/how-t
## Paso 6: Importa a Twenty
<Warning>
- **¡El orden de importación importa!**
+**¡El orden de importación importa!**
- Importa siempre en este orden:
+Importa siempre en este orden:
+1. **Empresas** primero (sin dependencias)
+2. **Personas** en segundo lugar (enlazadas a Empresas)
+3. **Oportunidades** en tercer lugar (enlazadas a Empresas/Personas)
+4. **Notas y Tareas** (enlazadas a registros)
+5. **Objetos personalizados** siguiendo sus dependencias
- 1. **Empresas** primero (sin dependencias)
- 2. **Personas** en segundo lugar (enlazadas a Empresas)
- 3. **Oportunidades** en tercer lugar (enlazadas a Empresas/Personas)
- 4. **Notas y Tareas** (enlazadas a registros)
- 5. **Objetos personalizados** siguiendo sus dependencias
-
- El registro padre debe existir antes de que puedas hacer referencia a él.
+El registro padre debe existir antes de que puedas hacer referencia a él.
</Warning>
### Importa cada objeto
@@ -215,7 +214,7 @@ Después de importar los datos, completa la configuración de tu espacio de trab
### Configura roles y permisos
-* Configura los roles en **Configuración → Roles**
+* Configura los roles en **Configuración → Miembros → Roles**
* Asigna a los usuarios a los roles adecuados
### Conecta el correo electrónico y el calendario
diff --git a/packages/twenty-docs/l/es/user-guide/data-migration/how-tos/migrating-from-self-hosted-to-cloud.mdx b/packages/twenty-docs/l/es/user-guide/data-migration/how-tos/migrating-from-self-hosted-to-cloud.mdx
index ac3e0b908b8..ae975a92efd 100644
--- a/packages/twenty-docs/l/es/user-guide/data-migration/how-tos/migrating-from-self-hosted-to-cloud.mdx
+++ b/packages/twenty-docs/l/es/user-guide/data-migration/how-tos/migrating-from-self-hosted-to-cloud.mdx
@@ -29,9 +29,9 @@ Antes de importar datos, recrea tus objetos y campos personalizados:
## Paso 3: Invita a todos los usuarios
<Warning>
- **Importante: invita a los usuarios ANTES de importar datos.**
+**Importante: invita a los usuarios ANTES de importar datos.**
- Los usuarios deben aceptar sus invitaciones antes de que importes cualquier registro que los referencie (como los campos de propietario de la cuenta). Si los usuarios aún no existen, esas relaciones no se podrán mapear.
+Los usuarios deben aceptar sus invitaciones antes de que importes cualquier registro que los referencie (como los campos de propietario de la cuenta). Si los usuarios aún no existen, esas relaciones no se podrán mapear.
</Warning>
1. Ve a **Ajustes → Miembros** en tu instancia en la nube
@@ -127,7 +127,7 @@ Después de importar los datos, recrea manualmente:
### Roles y permisos
-* Configura los roles en **Ajustes → Roles**
+* Configura los roles en **Configuración → Miembros → Roles**
* Asigna a los usuarios a los roles adecuados
### Integraciones
diff --git a/packages/twenty-docs/l/es/user-guide/data-migration/how-tos/prepare-your-csv-files.mdx b/packages/twenty-docs/l/es/user-guide/data-migration/how-tos/prepare-your-csv-files.mdx
index a6775c2ab24..f1601cba2b8 100644
--- a/packages/twenty-docs/l/es/user-guide/data-migration/how-tos/prepare-your-csv-files.mdx
+++ b/packages/twenty-docs/l/es/user-guide/data-migration/how-tos/prepare-your-csv-files.mdx
@@ -1,5 +1,5 @@
---
-title: Prepara tus archivos CSV},{
+title: Prepara tus archivos CSV
description: Guía completa paso a paso para dar formato a tus datos para importarlos en Twenty.
---
@@ -103,8 +103,6 @@ Dirección es un **campo anidado** con varias columnas (algunas pueden dejarse e
Usa un formato coherente en todo tu archivo:
* `YYYY-MM-DD` (recomendado): `2024-03-15`
-* `MM/DD/YYYY`: `03/15/2024`
-* `DD/MM/YYYY`: `15/03/2024`
* ISO 8601: `2024-03-15T10:30:00Z`
### Campos numéricos
@@ -210,15 +208,14 @@ Jane,Doe,[email protected],https://widgets.co
* Para los miembros del espacio de trabajo, usa su **email** (no el nombre)
<Warning>
- **¡El orden de importación importa!**
+**¡El orden de importación importa!**
- Importa el lado "uno" antes del lado "muchos":
+Importa el lado "uno" antes del lado "muchos":
+1. **Empresas** primero
+2. **Personas** después (con referencia a la empresa)
+3. **Oportunidades** en tercer lugar
- 1. **Empresas** primero
- 2. **Personas** después (con referencia a la empresa)
- 3. **Oportunidades** en tercer lugar
-
- El registro padre debe existir antes de poder referenciarlo.
+El registro padre debe existir antes de poder referenciarlo.
</Warning>
Consulta [Cómo importar relaciones](/l/es/user-guide/data-migration/how-tos/import-relations-between-objects-via-csv) para obtener instrucciones detalladas.
diff --git a/packages/twenty-docs/l/es/user-guide/data-migration/how-tos/update-existing-records-via-import.mdx b/packages/twenty-docs/l/es/user-guide/data-migration/how-tos/update-existing-records-via-import.mdx
index bc58b6be9fc..f93679e927e 100644
--- a/packages/twenty-docs/l/es/user-guide/data-migration/how-tos/update-existing-records-via-import.mdx
+++ b/packages/twenty-docs/l/es/user-guide/data-migration/how-tos/update-existing-records-via-import.mdx
@@ -25,11 +25,11 @@ Cuando importa un archivo que contiene un **identificador único** que coincide
| Falta en su archivo | **Crear** un nuevo registro (con ID autogenerado) |
<Warning>
- **Los campos de selección múltiple se sobrescriben, no se combinan.**
+**Los campos de selección múltiple se sobrescriben, no se combinan.**
- Si un registro tiene `Option A` y `Option B` seleccionadas, y usted importa `["Option C"]`, el registro solo tendrá `Option C` después de la importación. La importación reemplaza todas las selecciones anteriores—no las agrega.
+Si un registro tiene `Option A` y `Option B` seleccionadas, y usted importa `["Option C"]`, el registro solo tendrá `Option C` después de la importación. La importación reemplaza todas las selecciones anteriores—no las agrega.
- Para conservar los valores existentes, inclúyalos todos en su importación: `["Option A","Option B","Option C"]`
+Para conservar los valores existentes, inclúyalos todos en su importación: `["Option A","Option B","Option C"]`
</Warning>
## Paso 1: Exporte sus datos actuales
@@ -80,9 +80,9 @@ id,email,firstName,lastName,jobTitle
```
<Warning>
- **No cambie los valores del identificador único.**
+**No cambie los valores del identificador único.**
- Si cambia `[email protected]` a `[email protected]`, Twenty creará un registro nuevo en lugar de actualizar el existente.
+Si cambia `[email protected]` a `[email protected]`, Twenty creará un registro nuevo en lugar de actualizar el existente.
</Warning>
## Paso 3: Importe el archivo actualizado
diff --git a/packages/twenty-docs/l/es/user-guide/data-migration/overview.mdx b/packages/twenty-docs/l/es/user-guide/data-migration/overview.mdx
index 0ae65a741ec..e9312cd132a 100644
--- a/packages/twenty-docs/l/es/user-guide/data-migration/overview.mdx
+++ b/packages/twenty-docs/l/es/user-guide/data-migration/overview.mdx
@@ -5,7 +5,6 @@ description: Importe y exporte sus datos de CRM mediante archivos CSV o la API.
import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
-
## Métodos de importación
Twenty admite dos métodos principales para importar datos:
@@ -40,16 +39,15 @@ Puede importar relaciones entre objetos utilizando la función de importación C
<Note>**Los registros eliminados cuentan para la unicidad.** Los registros eliminados lógicamente (visibles en Menú de comandos → Ver registros eliminados) se incluyen en las comprobaciones de unicidad. Si importa un registro con el mismo valor único que un registro eliminado, el registro eliminado se restaurará.</Note>
<Warning>
- **¡Importa el orden de importación!**
-
- Al importar objetos relacionados, cargue los archivos en este orden:
+**¡Importa el orden de importación!**
- 1. **Empresas** primero (el lado "uno" de las relaciones)
- 2. **Personas** segundo (vinculadas a empresas mediante companyId)
- 3. **Oportunidades** tercero (vinculadas a empresas/personas)
- 4. **Objetos personalizados** con relaciones al final
+Al importar objetos relacionados, cargue los archivos en este orden:
+1. **Empresas** primero (el lado "uno" de las relaciones)
+2. **Personas** segundo (vinculadas a empresas mediante companyId)
+3. **Oportunidades** tercero (vinculadas a empresas/personas)
+4. **Objetos personalizados** con relaciones al final
- ¿Por qué? El lado "uno" de una relación de uno a muchos debe existir antes de que pueda hacer referencia a él. Por ejemplo, el registro de Empresa debe existir antes de importar una Persona con el ID de esa empresa.
+¿Por qué? El lado "uno" de una relación de uno a muchos debe existir antes de que pueda hacer referencia a él. Por ejemplo, el registro de Empresa debe existir antes de importar una Persona con el ID de esa empresa.
</Warning>
Consulte [este artículo](/l/es/user-guide/data-migration/how-tos/import-relations-between-objects-via-csv) para ver una guía paso a paso sobre cómo proceder.
diff --git a/packages/twenty-docs/l/es/user-guide/data-model/capabilities/fields.mdx b/packages/twenty-docs/l/es/user-guide/data-model/capabilities/fields.mdx
index 0166d8e4897..4727ebb456e 100644
--- a/packages/twenty-docs/l/es/user-guide/data-model/capabilities/fields.mdx
+++ b/packages/twenty-docs/l/es/user-guide/data-model/capabilities/fields.mdx
@@ -101,6 +101,10 @@ Haga un campo único para asegurar que registros distintos no puedan tener el mi
Si recibe un error al establecer la unicidad, verifique los valores duplicados en sus datos (incluso registros eliminados).
+## Índices (avanzado)
+
+Los índices de base de datos se gestionan automáticamente; crear índices propios rara vez es necesario y es fácil equivocarse. Con el modo avanzado activado, cada objeto tiene una sección de **Índices** en `Settings → Data Model → <object>` para los casos en los que sabes que necesitas uno.
+
## Mejores Prácticas de Configuración de Campos
### Convenciones y Limitaciones de Nombres
diff --git a/packages/twenty-docs/l/es/user-guide/data-model/capabilities/relation-fields.mdx b/packages/twenty-docs/l/es/user-guide/data-model/capabilities/relation-fields.mdx
index 8ea65e3c99b..dbfc0d8838c 100644
--- a/packages/twenty-docs/l/es/user-guide/data-model/capabilities/relation-fields.mdx
+++ b/packages/twenty-docs/l/es/user-guide/data-model/capabilities/relation-fields.mdx
@@ -30,7 +30,7 @@ De manera similar, un Proyecto (en el lado de "uno") podría recibir vínculos d
<img src="/images/user-guide/fields/one-to-many-morph.png" style={{width:'100%'}} />
<Warning>
- **Limitación de importación/exportación**: Las relaciones que apuntan a varios tipos de objeto aún no son compatibles con la importación/exportación de CSV. Esto está en nuestra hoja de ruta.
+**Limitación de importación/exportación**: Las relaciones que apuntan a varios tipos de objeto aún no son compatibles con la importación/exportación de CSV. Esto está en nuestra hoja de ruta.
</Warning>
### Muchos a muchos
@@ -44,7 +44,7 @@ Las relaciones de muchos a muchos usan un patrón de **objeto de unión**: un ob
<img src="/images/user-guide/fields/junction-relation-diagram.png" style={{width:'100%'}} />
<Warning>
- **Función de laboratorio**: Las relaciones de unión deben habilitarse en **Settings → Updates → Lab** antes de usarlas.
+**Función de laboratorio**: Las relaciones de unión deben habilitarse en **Settings → Updates → Lab** antes de usarlas.
</Warning>
Consulta [Cómo crear relaciones de muchos a muchos](/l/es/user-guide/data-model/how-tos/create-many-to-many-relations) para obtener una guía completa paso a paso.
diff --git a/packages/twenty-docs/l/es/user-guide/data-model/how-tos/create-custom-fields.mdx b/packages/twenty-docs/l/es/user-guide/data-model/how-tos/create-custom-fields.mdx
index f630448841d..83bf647099a 100644
--- a/packages/twenty-docs/l/es/user-guide/data-model/how-tos/create-custom-fields.mdx
+++ b/packages/twenty-docs/l/es/user-guide/data-model/how-tos/create-custom-fields.mdx
@@ -35,7 +35,7 @@ Los campos nuevos no son visibles automáticamente. Para mostrarlo:
3. Arrastre para reordenar las opciones
<Note>
- **Utilice los nombres de la API para las importaciones.** Habilite el **modo Avanzado** en Configuración para ver los nombres de la API. Consulte [Referencia de asignación de campos](/l/es/user-guide/data-migration/capabilities/field-mapping).
+**Utilice los nombres de la API para las importaciones.** Habilite el **modo Avanzado** en Configuración para ver los nombres de la API. Consulte [Referencia de asignación de campos](/l/es/user-guide/data-migration/capabilities/field-mapping).
</Note>
### Para campos de moneda
@@ -51,7 +51,7 @@ Establezca el **código de país predeterminado** para rellenar previamente los
Active **Unique** para evitar valores duplicados entre los registros.
<Note>
- Si existen duplicados (incluidos en los registros eliminados), recibirá un error. Primero, elimine los duplicados.
+Si existen duplicados (incluidos en los registros eliminados), recibirá un error. Primero, elimine los duplicados.
</Note>
### Configuración de valores predeterminados
diff --git a/packages/twenty-docs/l/es/user-guide/data-model/how-tos/create-custom-objects.mdx b/packages/twenty-docs/l/es/user-guide/data-model/how-tos/create-custom-objects.mdx
index 86401443aef..34af2d372cb 100644
--- a/packages/twenty-docs/l/es/user-guide/data-model/how-tos/create-custom-objects.mdx
+++ b/packages/twenty-docs/l/es/user-guide/data-model/how-tos/create-custom-objects.mdx
@@ -6,7 +6,7 @@ description: Guía paso a paso para crear objetos personalizados en Twenty.
Los objetos personalizados le permiten almacenar información exclusiva de su empresa que los objetos estándar no cubren. Por ejemplo: Proyectos, Productos, Tickets o Listados.
<Note>
- **¿No está seguro de si necesita un objeto o un campo?** Consulte [Comprender su modelo de datos](/l/es/user-guide/data-model/overview) para obtener orientación.
+**¿No está seguro de si necesita un objeto o un campo?** Consulte [Comprender su modelo de datos](/l/es/user-guide/data-model/overview) para obtener orientación.
</Note>
## Pasos
diff --git a/packages/twenty-docs/l/es/user-guide/data-model/how-tos/create-many-to-many-relations.mdx b/packages/twenty-docs/l/es/user-guide/data-model/how-tos/create-many-to-many-relations.mdx
index d89f0222cd7..17167a87423 100644
--- a/packages/twenty-docs/l/es/user-guide/data-model/how-tos/create-many-to-many-relations.mdx
+++ b/packages/twenty-docs/l/es/user-guide/data-model/how-tos/create-many-to-many-relations.mdx
@@ -6,11 +6,11 @@ description: Conecta registros en los que muchos elementos en ambos lados pueden
Las relaciones de muchos a muchos te permiten conectar varios registros en ambos lados. Por ejemplo: muchas personas pueden trabajar en muchos proyectos, y cada proyecto puede tener muchas personas.
<Warning>
- **Función de laboratorio**: Las relaciones de unión están actualmente en el Lab. Actívalas en **Settings → Updates → Lab** antes de seguir esta guía.
+**Función de laboratorio**: Las relaciones de unión están actualmente en el Lab. Actívalas en **Settings → Updates → Lab** antes de seguir esta guía.
</Warning>
<Note>
- Esta función también requiere que **Advanced mode** esté activado (interruptor en la esquina inferior derecha de Settings).
+Esta función también requiere que **Advanced mode** esté activado (interruptor en la esquina inferior derecha de Settings).
</Note>
## Cuándo usar relaciones de muchos a muchos
@@ -53,38 +53,45 @@ Primero, crea el objeto intermedio que contendrá las conexiones.
1. Vaya a **Configuración → Modelo de datos**
2. Haga clic en **+ New object**
3. Asígnale un nombre descriptivo (p. ej., "Project Assignment", "Team Member", "Product Order")
-4. Haga clic en **Guardar**
+4. Activa "Omitir la creación de un campo Nombre"
+
+<img src="/images/user-guide/fields/new-pivot-object.png" alt="Nuevo objeto de unión" />
+
+5. Haga clic en **Guardar**
<Tip>
- **Convención de nombres**: Usa un nombre que describa la relación, como "Project Assignment" o "Team Membership". Esto hace que el modelo de datos sea más fácil de entender.
+**Convención de nombres**: Usa un nombre que describa la relación, como "Project Assignment" o "Team Membership". Esto hace que el modelo de datos sea más fácil de entender.
</Tip>
-## Paso 2: Crear relaciones desde el objeto de unión
+## Paso 2: Crea relaciones entre los objetos y el objeto de unión
-Agrega campos de relación desde el objeto de unión a ambos objetos que quieres conectar.
+Agrega campos de relación desde cada uno de tus dos objetos al objeto de unión.
-### Primera relación (Unión → Objeto A)
+### Primera relación (Objeto A → Unión)
-1. Selecciona tu objeto de unión en **Settings → Data Model**
-2. Haga clic en **+ Add Field**
-3. Elige **Relation** como tipo de campo
-4. Selecciona el primer objeto (p. ej., "People")
-5. Configura el tipo de relación como **Many-to-One** (muchas asignaciones pueden vincularse a una persona)
-6. Nombra los campos:
- * Campo en unión: p. ej., "Person"
+1. Selecciona tu primer objeto en **Settings → Data Model**
+2. Haz clic en **+ Add Relation**
+3. Selecciona el objeto de unión (p. ej., "Project Assignments")
+4. Configura el tipo de relación como **One-To-Many** (una persona puede vincularse a muchas asignaciones)
+5. Nombra los campos:
* Campo en People: p. ej., "Project Assignments"
-7. Haga clic en **Guardar**
+ * Campo en unión: p. ej., "Person"
+6. Haga clic en **Guardar**
-### Segunda relación (Unión → Objeto B)
+### Segunda relación (Objeto B → Unión)
-1. Aún en el objeto de unión, haz clic en **+ Add Field**
-2. Elige **Relation** como tipo de campo
-3. Selecciona el segundo objeto (p. ej., "Projects")
-4. Configura el tipo de relación como **Many-to-One**
-5. Nombra los campos:
+1. Selecciona tu segundo objeto en **Settings → Data Model**
+2. Haz clic en **+ Add Relation**
+3. Selecciona el objeto de unión (p. ej., "Project Assignments")
+4. Configura el tipo de relación como **One-To-Many** (un proyecto puede vincularse a muchas asignaciones)
+5. Activa **"This is a relation to a Junction Object"**
+
+<img src="/images/user-guide/fields/junction-relation-toggle.png" style={{width:'100%'}} />
+
+6. Nombra los campos:
* Campo en unión: p. ej., "Project"
* Campo en Projects: p. ej., "Team Members"
-6. Haga clic en **Guardar**
+7. Haga clic en **Guardar**
## Paso 3: Configurar la visualización de la relación de unión
@@ -98,18 +105,6 @@ Ahora configura los objetos de origen para mostrar los registros vinculados dire
6. Selecciona la **Target relation** (p. ej., "Project" — el campo en la unión que apunta al otro lado)
7. Haga clic en **Guardar**
-{/* TODO: Add image
-<img src="/images/user-guide/fields/junction-relation-toggle.png" style={{width:'100%'}}/>
-*/}
-
-Repite para el otro objeto:
-
-1. Selecciona "Projects" en Data Model
-2. Edita el campo de relación "Team Members"
-3. Activa el interruptor de unión
-4. Selecciona "Person" como la relación de destino
-5. Guardar
-
## Resultado
Después de la configuración:
@@ -130,15 +125,15 @@ Aquí tienes una guía completa paso a paso:
### Agregar relaciones
-1. **Project Assignment → People**
- * Tipo: Many-to-One
- * Campo en Assignment: "Person"
+1. **People → Project Assignment**
+ * Tipo: One-to-Many
* Campo en People: "Project Assignments"
+ * Campo en Assignment: "Person"
-2. **Project Assignment → Projects**
- * Tipo: Many-to-One
- * Campo en Assignment: "Project"
+2. **Projects → Project Assignment**
+ * Tipo: One-to-Many
* Campo en Projects: "Team Members"
+ * Campo en Assignment: "Project"
### Configurar la visualización de la unión
diff --git a/packages/twenty-docs/l/es/user-guide/data-model/how-tos/create-relation-fields.mdx b/packages/twenty-docs/l/es/user-guide/data-model/how-tos/create-relation-fields.mdx
index 4558dbe505f..31a8cfee1a2 100644
--- a/packages/twenty-docs/l/es/user-guide/data-model/how-tos/create-relation-fields.mdx
+++ b/packages/twenty-docs/l/es/user-guide/data-model/how-tos/create-relation-fields.mdx
@@ -1,12 +1,12 @@
---
-title: Crear campos de relación},{
+title: Crear campos de relación
description: Guía paso a paso para conectar objetos con campos de relación.
---
Los campos de relación conectan registros de distintos objetos—por ejemplo, vinculando Personas con Empresas.
<Note>
- **Los nombres de relación no se pueden cambiar después de la creación** (afectan a la API). Planifica bien los nombres.
+**Los nombres de relación no se pueden cambiar después de la creación** (afectan a la API). Planifica bien los nombres.
</Note>
## Antes de empezar
@@ -51,7 +51,7 @@ Ahora cada persona puede vincularse a una empresa, y cada empresa muestra a sus
Los enlaces se conservan, pero están ocultos. Vuelve a activar para restaurar.
<Note>
- **Eliminar una relación no elimina registros.** Solo se quita el enlace entre ellos.
+**Eliminar una relación no elimina registros.** Solo se quita el enlace entre ellos.
</Note>
## Relacionado
diff --git a/packages/twenty-docs/l/es/user-guide/data-model/how-tos/data-model-faq.mdx b/packages/twenty-docs/l/es/user-guide/data-model/how-tos/data-model-faq.mdx
index d0daaade1d2..7cdef878c00 100644
--- a/packages/twenty-docs/l/es/user-guide/data-model/how-tos/data-model-faq.mdx
+++ b/packages/twenty-docs/l/es/user-guide/data-model/how-tos/data-model-faq.mdx
@@ -6,148 +6,147 @@ description: Preguntas frecuentes sobre el modelo de datos de Twenty.
## Gestión de Objetos
<AccordionGroup>
- <Accordion title="¿Puedo eliminar un objeto personalizado?">
- Sí, los objetos personalizados se pueden eliminar. También puedes desactivarlos primero, lo que oculta el objeto y sus datos de la interfaz a la vez que conserva los datos.
- </Accordion>
+<Accordion title="¿Puedo eliminar un objeto personalizado?">
+Sí, los objetos personalizados se pueden eliminar. También puedes desactivarlos primero, lo que oculta el objeto y sus datos de la interfaz a la vez que conserva los datos.
+</Accordion>
- <Accordion title="¿Puedo eliminar objetos estándar (Personas, Empresas, etc.)?">
- No, los objetos estándar no se pueden eliminar. Solo puedes desactivarlos, lo que los oculta de la interfaz pero conserva los datos.
- </Accordion>
+<Accordion title="¿Puedo eliminar objetos estándar (Personas, Empresas, etc.)?">
+No, los objetos estándar no se pueden eliminar. Solo puedes desactivarlos, lo que los oculta de la interfaz pero conserva los datos.
+</Accordion>
- <Accordion title="¿Cuántos objetos personalizados puedo crear?">
- Puedes crear tantos objetos y campos personalizados como necesites — el precio no cambiará.
- </Accordion>
+<Accordion title="¿Cuántos objetos personalizados puedo crear?">
+Puedes crear tantos objetos y campos personalizados como necesites — el precio no cambiará.
+</Accordion>
- <Accordion title="¿Puedo cambiar el nombre de un objeto estándar?">
- Puedes cambiar la etiqueta de los objetos estándar (Personas, Empresas, Oportunidades), pero no sus nombres de API. Los nombres de API son fijos para mantener la coherencia en todos los espacios de trabajo de Twenty.
- </Accordion>
+<Accordion title="¿Puedo cambiar el nombre de un objeto estándar?">
+Puedes cambiar la etiqueta de los objetos estándar (Personas, Empresas, Oportunidades), pero no sus nombres de API. Los nombres de API son fijos para mantener la coherencia en todos los espacios de trabajo de Twenty.
+</Accordion>
- <Accordion title="¿Puedo cambiar el icono de un objeto?">
- Sí, puedes cambiar el icono tanto de los objetos estándar como de los personalizados en **Settings → Data Model**.
- </Accordion>
+<Accordion title="¿Puedo cambiar el icono de un objeto?">
+Sí, puedes cambiar el icono tanto de los objetos estándar como de los personalizados en **Settings → Data Model**.
+</Accordion>
- <Accordion title="¿Puedo reorganizar objetos en la barra de navegación izquierda?">
- Aún no. La ordenación de objetos en la navegación está actualmente fijada, pero esta función está prevista para una futura versión.
- </Accordion>
+<Accordion title="¿Puedo reorganizar objetos en la barra de navegación izquierda?">
+Aún no. La ordenación de objetos en la navegación está actualmente fijada, pero esta función está prevista para una futura versión.
+</Accordion>
- <Accordion title="¿Puedo ocultar objetos de la barra de navegación izquierda?">
- Todos los objetos activos aparecen en la navegación. Puedes desactivar los objetos que no necesites en **Configuración → Modelo de Datos**.
- </Accordion>
+<Accordion title="¿Puedo ocultar objetos de la barra de navegación izquierda?">
+Todos los objetos activos aparecen en la navegación. Puedes desactivar los objetos que no necesites en **Configuración → Modelo de Datos**.
+</Accordion>
</AccordionGroup>
## Capacidades de Campos
<AccordionGroup>
- <Accordion title="¿Puedo cambiar el tipo de un campo después de crearlo?">
- No, los tipos de campo no se pueden cambiar después de su creación. Si necesitas un tipo diferente, crea un campo nuevo con el tipo correcto, migra tus datos y luego desactiva el campo anterior.
- </Accordion>
-
- <Accordion title="¿Por qué necesito nombres singulares y plurales diferentes?">
- Nuestra API de GraphQL usa ambas formas para diferentes operaciones:
-
- * `createPerson` (singular) para acciones de registro único
- * `createPeople` (plural) para operaciones en masa
-
- Esto crea limitaciones cuando las formas singulares y plurales son iguales, pero mejora la experiencia del desarrollador.
- </Accordion>
-
- <Accordion title="¿Por qué algunos nombres de campos están protegidos?">
- Ciertos nombres de campo como `Tipo` o `Aplicación` están reservados para uso del sistema. Elige nombres alternativos como `Categoría` o `Clasificación`.
- </Accordion>
-
- <Accordion title="¿Qué ocurre cuando desactivo un campo?">
- * El campo se oculta en la interfaz
- * Los datos existentes se conservan
- * Aún puedes acceder al campo mediante la API
- * Las relaciones existentes se mantienen, pero no puedes crear nuevas
- * Puedes reactivar el campo más tarde
- </Accordion>
-
- <Accordion title="¿Puedo hacer que un campo sea obligatorio?">
- Actualmente, no puedes hacer que los campos personalizados sean obligatorios. Todos los campos aceptan valores vacíos. Puedes usar flujos de trabajo para aplicar campos obligatorios enviando alertas o bloqueando acciones cuando los campos estén vacíos.
- </Accordion>
-
- <Accordion title="¿Cuál es la diferencia entre único y obligatorio?">
- * **Único**: No puede haber dos registros con el mismo valor en este campo
- * **Obligatorio**: El campo debe tener un valor (actualmente no es compatible con los campos personalizados)
- </Accordion>
-
- <Accordion title="¿Puedo crear campos de fórmula?">
- Los campos de fórmula llegarán en **Q1 2026**. Mientras tanto, puedes usar flujos de trabajo para calcular y actualizar automáticamente los valores de los campos.
- </Accordion>
-
- <Accordion title="¿Puedo tener campos anidados en mis objetos?">
- Los campos anidados llegarán en **Q1 2026**. Actualmente, puedes usar flujos de trabajo para traer valores de campo de objetos relacionados. Por ejemplo, para mostrar la industria de una empresa en un registro de Persona, crea un campo personalizado en Personas y usa un flujo de trabajo para sincronizar el valor.
- </Accordion>
-
- <Accordion title="¿Puedo reorganizar campos en objetos?">
- El reordenamiento de campos estará disponible con diseños personalizados en **Q4 2025**. Actualmente, los campos aparecen en orden alfabético.
- </Accordion>
+<Accordion title="¿Puedo cambiar el tipo de un campo después de crearlo?">
+No, los tipos de campo no se pueden cambiar después de su creación. Si necesitas un tipo diferente, crea un campo nuevo con el tipo correcto, migra tus datos y luego desactiva el campo anterior.
+</Accordion>
+
+
+<Accordion title="¿Por qué necesito nombres singulares y plurales diferentes?">
+Nuestra API de GraphQL usa ambas formas para diferentes operaciones:
+* `createPerson` (singular) para acciones de registro único
+* `createPeople` (plural) para operaciones en masa
+
+Esto crea limitaciones cuando las formas singulares y plurales son iguales, pero mejora la experiencia del desarrollador.
+</Accordion>
+
+<Accordion title="¿Por qué algunos nombres de campos están protegidos?">
+Ciertos nombres de campo como `Tipo` o `Aplicación` están reservados para uso del sistema. Elige nombres alternativos como `Categoría` o `Clasificación`.
+</Accordion>
+
+<Accordion title="¿Qué ocurre cuando desactivo un campo?">
+* El campo se oculta en la interfaz
+* Los datos existentes se conservan
+* Aún puedes acceder al campo mediante la API
+* Las relaciones existentes se mantienen, pero no puedes crear nuevas
+* Puedes reactivar el campo más tarde
+</Accordion>
+
+<Accordion title="¿Puedo hacer que un campo sea obligatorio?">
+Actualmente, no puedes hacer que los campos personalizados sean obligatorios. Todos los campos aceptan valores vacíos. Puedes usar flujos de trabajo para aplicar campos obligatorios enviando alertas o bloqueando acciones cuando los campos estén vacíos.
+</Accordion>
+
+<Accordion title="¿Cuál es la diferencia entre único y obligatorio?">
+* **Único**: No puede haber dos registros con el mismo valor en este campo
+* **Obligatorio**: El campo debe tener un valor (actualmente no es compatible con los campos personalizados)
+</Accordion>
+
+<Accordion title="¿Puedo crear campos de fórmula?">
+Los campos de fórmula llegarán en **Q1 2026**. Mientras tanto, puedes usar flujos de trabajo para calcular y actualizar automáticamente los valores de los campos.
+</Accordion>
+
+<Accordion title="¿Puedo tener campos anidados en mis objetos?">
+Los campos anidados llegarán en **Q1 2026**. Actualmente, puedes usar flujos de trabajo para traer valores de campo de objetos relacionados. Por ejemplo, para mostrar la industria de una empresa en un registro de Persona, crea un campo personalizado en Personas y usa un flujo de trabajo para sincronizar el valor.
+</Accordion>
+
+<Accordion title="¿Puedo reorganizar campos en objetos?">
+El reordenamiento de campos estará disponible con diseños personalizados en **Q4 2025**. Actualmente, los campos aparecen en orden alfabético.
+</Accordion>
</AccordionGroup>
## Relaciones
<AccordionGroup>
- <Accordion title="¿Puedo tener una relación que apunte al mismo objeto?">
- ¡Sí! Se admiten las relaciones autorreferenciadas y se recomiendan para casos como jerarquías de cuentas. Por ejemplo, crea una relación de Empresas a Empresas para realizar el seguimiento de cuentas padre/hija.
- </Accordion>
+<Accordion title="¿Puedo tener una relación que apunte al mismo objeto?">
+¡Sí! Se admiten las relaciones autorreferenciadas y se recomiendan para casos como jerarquías de cuentas. Por ejemplo, crea una relación de Empresas a Empresas para realizar el seguimiento de cuentas padre/hija.
+</Accordion>
- <Accordion title="¿Puedo crear relaciones de muchos a muchos?">
- Las relaciones de muchos a muchos llegarán en **H1 2026**. Actualmente, crea un objeto intermedio con dos relaciones de uno a muchos como solución alternativa.
+<Accordion title="¿Puedo crear relaciones de muchos a muchos?">
+Las relaciones de muchos a muchos llegarán en **H1 2026**. Actualmente, crea un objeto intermedio con dos relaciones de uno a muchos como solución alternativa.
- Por ejemplo, para vincular Personas y Proyectos (muchos a muchos), crea un objeto "Asignaciones de proyecto" con:
+Por ejemplo, para vincular Personas y Proyectos (muchos a muchos), crea un objeto "Asignaciones de proyecto" con:
+* Una relación con Personas (muchas asignaciones → una persona)
+* Una relación con Proyectos (muchas asignaciones → un proyecto)
+</Accordion>
- * Una relación con Personas (muchas asignaciones → una persona)
- * Una relación con Proyectos (muchas asignaciones → un proyecto)
- </Accordion>
+<Accordion title="¿Qué son las relaciones a múltiples tipos de objetos (relaciones Morph)?">
+Estas permiten que un objeto se relacione con múltiples tipos de objetos diferentes mediante un único campo. Por ejemplo, las Notas pueden adjuntarse a Personas Y a Empresas Y a Oportunidades simultáneamente.
- <Accordion title="¿Qué son las relaciones a múltiples tipos de objetos (relaciones Morph)?">
- Estas permiten que un objeto se relacione con múltiples tipos de objetos diferentes mediante un único campo. Por ejemplo, las Notas pueden adjuntarse a Personas Y a Empresas Y a Oportunidades simultáneamente.
+Cada Nota se vincula a una Persona, una Empresa y una Oportunidad al mismo tiempo.
- Cada Nota se vincula a una Persona, una Empresa y una Oportunidad al mismo tiempo.
+Obtén más información en [Campos de relación](/l/es/user-guide/data-model/capabilities/relation-fields).
+</Accordion>
- Obtén más información en [Campos de relación](/l/es/user-guide/data-model/capabilities/relation-fields).
- </Accordion>
+<Accordion title="¿Puedo tener varias relaciones entre los mismos objetos?">
+Sí, puedes crear varias relaciones entre los mismos dos objetos. Por ejemplo, una Empresa podría tener con Personas tanto una relación de "Contacto principal" como otra de "Contacto de facturación".
+</Accordion>
- <Accordion title="¿Puedo tener varias relaciones entre los mismos objetos?">
- Sí, puedes crear varias relaciones entre los mismos dos objetos. Por ejemplo, una Empresa podría tener con Personas tanto una relación de "Contacto principal" como otra de "Contacto de facturación".
- </Accordion>
+<Accordion title="¿Qué ocurre con las relaciones cuando elimino un registro?">
+Cuando eliminas un registro, el vínculo de la relación se elimina de los registros relacionados. Los propios registros relacionados no se eliminan.
+</Accordion>
- <Accordion title="¿Qué ocurre con las relaciones cuando elimino un registro?">
- Cuando eliminas un registro, el vínculo de la relación se elimina de los registros relacionados. Los propios registros relacionados no se eliminan.
- </Accordion>
-
- <Accordion title="¿Puedo crear relaciones circulares?">
- Aunque técnicamente es posible, se deben evitar las relaciones circulares (A → B → C → A), ya que pueden causar confusión y posibles problemas de rendimiento.
- </Accordion>
+<Accordion title="¿Puedo crear relaciones circulares?">
+Aunque técnicamente es posible, se deben evitar las relaciones circulares (A → B → C → A), ya que pueden causar confusión y posibles problemas de rendimiento.
+</Accordion>
</AccordionGroup>
## Acceso y Permisos
<AccordionGroup>
- <Accordion title="¿Dónde puedo ver y editar mi modelo de datos?">
- Ve a **Settings → Data Model** para ver y editar todos tus objetos y campos.
- </Accordion>
+<Accordion title="¿Dónde puedo ver y editar mi modelo de datos?">
+Ve a **Settings → Data Model** para ver y editar todos tus objetos y campos.
+</Accordion>
- <Accordion title="¿Por qué no puedo ver el Modelo de Datos en Configuración?">
- Comunícate con tu administrador de espacio de trabajo. El acceso al modelo de datos suele estar restringido solo a administradores.
- </Accordion>
+<Accordion title="¿Por qué no puedo ver el Modelo de Datos en Configuración?">
+Comunícate con tu administrador de espacio de trabajo. El acceso al modelo de datos suele estar restringido solo a administradores.
+</Accordion>
</AccordionGroup>
## Gestión de datos
<AccordionGroup>
- <Accordion title="¿Existe un límite a la cantidad de registros que puedo tener?">
- No hay un límite estricto en la cantidad de registros. Sin embargo, conjuntos de datos muy grandes pueden afectar el rendimiento en algunas vistas. Usa filtros y vistas para gestionar conjuntos de datos grandes de forma eficaz.
- </Accordion>
+<Accordion title="¿Existe un límite a la cantidad de registros que puedo tener?">
+No hay un límite estricto en la cantidad de registros. Sin embargo, conjuntos de datos muy grandes pueden afectar el rendimiento en algunas vistas. Usa filtros y vistas para gestionar conjuntos de datos grandes de forma eficaz.
+</Accordion>
- <Accordion title="¿Puedo importar datos en objetos personalizados?">
- Sí, puedes importar datos CSV en cualquier objeto, incluidos los objetos personalizados. El proceso de importación admite la asignación de campos para campos personalizados. Consulta [Cómo preparar tus archivos CSV](/l/es/user-guide/data-migration/how-tos/prepare-your-csv-files).
- </Accordion>
+<Accordion title="¿Puedo importar datos en objetos personalizados?">
+Sí, puedes importar datos CSV en cualquier objeto, incluidos los objetos personalizados. El proceso de importación admite la asignación de campos para campos personalizados. Consulta [Cómo preparar tus archivos CSV](/l/es/user-guide/data-migration/how-tos/prepare-your-csv-files).
+</Accordion>
- <Accordion title="¿Puedo exportar la configuración de mi modelo de datos?">
- Actualmente, no hay una exportación integrada para la configuración del modelo de datos. Contacta con soporte si necesitas migrar tu modelo de datos entre espacios de trabajo.
- </Accordion>
+<Accordion title="¿Puedo exportar la configuración de mi modelo de datos?">
+Actualmente, no hay una exportación integrada para la configuración del modelo de datos. Contacta con soporte si necesitas migrar tu modelo de datos entre espacios de trabajo.
+</Accordion>
</AccordionGroup>
## ¿Necesitas más ayuda?
diff --git a/packages/twenty-docs/l/es/user-guide/data-model/overview.mdx b/packages/twenty-docs/l/es/user-guide/data-model/overview.mdx
index ebb3257a5a6..9e6b2943cf4 100644
--- a/packages/twenty-docs/l/es/user-guide/data-model/overview.mdx
+++ b/packages/twenty-docs/l/es/user-guide/data-model/overview.mdx
@@ -3,7 +3,6 @@ title: Modelo de datos
description: Aprende qué es un modelo de datos y cómo diseñar uno que se adapte a tu empresa.
---
-
## ¿Qué es un modelo de datos?
Un modelo de datos es la estructura que define cómo se organiza la información en tu CRM. Piénsalo como el **plano** de tus datos de clientes — lo diseñas una vez y luego lo completas con tus datos reales.
@@ -126,9 +125,9 @@ Empieza con los campos. Pasa a nuevos objetos solo cuando notes las limitaciones
## Nota especial sobre Personas, Empresas y Oportunidades
<Warning>
- **La sincronización de correo y calendario solo funciona con Personas, Empresas y Oportunidades.**
+**La sincronización de correo y calendario solo funciona con Personas, Empresas y Oportunidades.**
- Estos son los únicos objetos en los que puedes acceder a correos y reuniones sincronizados desde tu buzón/calendario. Recomendamos usarlos tanto como sea posible.
+Estos son los únicos objetos en los que puedes acceder a correos y reuniones sincronizados desde tu buzón/calendario. Recomendamos usarlos tanto como sea posible.
</Warning>
**Mejores prácticas:**
@@ -158,9 +157,9 @@ Si la respuesta es "sí" a una o más, probablemente es hora de un nuevo objeto.
4. Haz clic en cualquier objeto para ver y editar sus campos
<Note>
- **¿No ves Modelo de datos en Configuración?**
+**¿No ves Modelo de datos en Configuración?**
- El acceso al modelo de datos suele estar restringido a los administradores. Contacta con el administrador de tu espacio de trabajo si necesitas acceso.
+El acceso al modelo de datos suele estar restringido a los administradores. Contacta con el administrador de tu espacio de trabajo si necesitas acceso.
</Note>
## Próximos Pasos
diff --git a/packages/twenty-docs/l/es/user-guide/getting-started/capabilities/what-is-twenty.mdx b/packages/twenty-docs/l/es/user-guide/getting-started/capabilities/what-is-twenty.mdx
index 28b3ffabbe7..c316fa34b8c 100644
--- a/packages/twenty-docs/l/es/user-guide/getting-started/capabilities/what-is-twenty.mdx
+++ b/packages/twenty-docs/l/es/user-guide/getting-started/capabilities/what-is-twenty.mdx
@@ -35,7 +35,7 @@ El código abierto es la base de nuestro enfoque, asegurando que Twenty evolucio
* **Tableros:** Rastree el rendimiento con informes y visualizaciones personalizadas. [Ver tableros](/l/es/user-guide/dashboards/overview).
* **Permisos y acceso:** Controle quién puede ver, editar y administrar sus datos con permisos basados en roles. [Configurar el acceso](/l/es/user-guide/permissions-access/overview).
* **Notas y tareas:** Cree notas y tareas vinculadas a sus registros para una mejor colaboración.
-* **API y Webhooks:** Conéctese con otras aplicaciones y cree integraciones personalizadas. [Comienza a integrar](/l/es/developers/api).
+* **API y Webhooks:** Conéctese con otras aplicaciones y cree integraciones personalizadas. [Comienza a integrar](/l/es/developers/extend/api).
## Únete ahora
diff --git a/packages/twenty-docs/l/es/user-guide/introduction.mdx b/packages/twenty-docs/l/es/user-guide/introduction.mdx
index 04ae84b3b99..432cf3f50a2 100644
--- a/packages/twenty-docs/l/es/user-guide/introduction.mdx
+++ b/packages/twenty-docs/l/es/user-guide/introduction.mdx
@@ -1,16 +1,11 @@
---
-title: Descubre Twenty
+title: Guía de usuario
description: Bienvenido a la Guía del usuario de Twenty, tu recurso para configuraciones avanzadas y mejores prácticas.
---
import { CardTitle } from "/snippets/card-title.mdx"
<CardGroup cols={3}>
- <Card href="/l/es/user-guide/getting-started/capabilities/what-is-twenty" img="/images/user-guide/api/api.png">
- <CardTitle>Descubre Twenty</CardTitle>
- Aprende qué es Twenty y cómo puede ayudar a tu empresa.
- </Card>
-
<Card href="/l/es/user-guide/data-model/overview" img="/images/user-guide/halftone/data-model.png">
<CardTitle>Modelo de datos</CardTitle>
Personaliza tu modelo de datos para adaptarlo a tus procesos empresariales.
@@ -36,9 +31,9 @@ import { CardTitle } from "/snippets/card-title.mdx"
Potencia a tu equipo con agentes de IA.
</Card>
- <Card href="/l/es/user-guide/views-pipelines/overview" img="/images/user-guide/halftone/layout.png">
- <CardTitle>Vistas y canalizaciones</CardTitle>
- Organiza tus datos con vistas y canalizaciones operativas.
+ <Card href="/l/es/user-guide/layout/overview" img="/images/user-guide/halftone/layout.png">
+ <CardTitle>Diseño</CardTitle>
+ Navegación, vistas y personalización de la página de registro.
</Card>
<Card href="/l/es/user-guide/dashboards/overview" img="/images/user-guide/halftone/dashboards.png">
@@ -60,4 +55,5 @@ import { CardTitle } from "/snippets/card-title.mdx"
<CardTitle>Configuración</CardTitle>
Configura las preferencias de tu espacio de trabajo.
</Card>
+
</CardGroup>
diff --git a/packages/twenty-docs/l/es/user-guide/layout/capabilities/navigation.mdx b/packages/twenty-docs/l/es/user-guide/layout/capabilities/navigation.mdx
new file mode 100644
index 00000000000..320a163b891
--- /dev/null
+++ b/packages/twenty-docs/l/es/user-guide/layout/capabilities/navigation.mdx
@@ -0,0 +1,38 @@
+---
+title: Navegación
+description: Personaliza la barra lateral izquierda para que se adapte a cómo trabaja tu equipo.
+---
+
+La barra lateral izquierda es tu forma principal de navegar por Twenty. Es totalmente personalizable — puedes reorganizarla para que se adapte a tu flujo de trabajo sin tocar ninguna página de configuración.
+
+## Reordenar elementos
+
+Arrastra y suelta cualquier elemento de la barra lateral para cambiar su posición. El orden se guarda por usuario, por lo que cada miembro del equipo puede organizar su propia barra lateral.
+
+## Carpetas
+
+Agrupa los elementos relacionados en carpetas. Por ejemplo, puedes crear una carpeta "Ventas" que contenga tus vistas del pipeline, una carpeta "Soporte" para los tickets o una carpeta "Operaciones" para objetos internos.
+
+Para crear una carpeta, haz clic derecho en la barra lateral o usa el botón `+`.
+
+## Ocultar objetos
+
+Los objetos que no usas se pueden ocultar de la barra lateral. No se eliminan — simplemente quedan fuera de la vista. Puedes mostrarlos de nuevo en cualquier momento desde Configuración > Modelo de Datos.
+
+## Favoritos
+
+Fija vistas, registros o búsquedas en la sección Favoritos en la parte superior de la barra lateral para acceder con un solo clic. Los Favoritos son personales — cada usuario gestiona los suyos.
+
+## Enlaces personalizados
+
+Añade enlaces a herramientas externas directamente en la barra lateral. Útil para enlazar tu wiki, paneles en otras herramientas o cualquier URL que tu equipo use con regularidad.
+
+## Menú de Comandos
+
+Pulsa `Cmd+K` (o `Ctrl+K`) para abrir el Menú de Comandos — una barra de búsqueda de acceso rápido para saltar a cualquier registro, vista o acción sin navegar por la barra lateral.
+
+## Personalizando la barra lateral
+
+Para personalizar la barra lateral, pasa el cursor sobre la sección "Workspace" en la barra lateral y haz clic en el icono de la llave inglesa.
+
+<img src="/images/user-guide/layout/navigation-edit-icon.png" alt="Icono de edición del menú de navegación" />
diff --git a/packages/twenty-docs/l/es/user-guide/layout/capabilities/record-pages.mdx b/packages/twenty-docs/l/es/user-guide/layout/capabilities/record-pages.mdx
new file mode 100644
index 00000000000..84dcb3fa9a5
--- /dev/null
+++ b/packages/twenty-docs/l/es/user-guide/layout/capabilities/record-pages.mdx
@@ -0,0 +1,61 @@
+---
+title: Páginas de registro
+description: Personaliza el diseño de las páginas de detalle de cada registro con pestañas y widgets.
+---
+
+## Resumen
+
+Cuando abres un registro en Twenty, la página de detalle se compone de **pestañas** y **widgets**. Ambos son totalmente personalizables según el tipo de objeto.
+
+## Pestañas
+
+Cada página de registro puede tener varias pestañas — similares a las pestañas de un navegador. Úsalas para organizar distintos aspectos de un registro. Por ejemplo, un registro de Empresa podría tener pestañas para Resumen, Comunicación, Tareas y Archivos.
+
+Puedes:
+
+* Agregar y eliminar pestañas
+* Cambiar el nombre de las pestañas
+* Reordenar las pestañas arrastrando
+* Configurar qué pestaña se muestra de forma predeterminada
+
+## Widgets
+
+Los widgets son los bloques básicos dentro de cada pestaña. Tipos de widgets disponibles:
+
+| Widget | Qué muestra |
+| -------------------------- | ------------------------------------------------------- |
+| **Campos** | Campos del registro, agrupados o individualmente |
+| **Registros relacionados** | Tabla de registros vinculados mediante una relación |
+| **Correos electrónicos** | Historial de correos electrónicos de cuentas conectadas |
+| **Calendario** | Eventos de calendario asociados con el registro |
+| **Cronología** | Historial de actividades y eventos |
+| **Tareas** | Tareas asociadas |
+| **Notas** | Notas de texto enriquecido |
+| **Archivos** | Archivos adjuntos |
+| **Gráficos** | Datos visuales de registros relacionados |
+| **iFrame** | Contenido externo incrustado |
+| **Texto enriquecido** | Contenido estático o descripciones |
+
+## Personalizar la página del registro
+
+1. Abre cualquier registro
+2. Presiona `Cmd+K` y busca "Editar diseño de la página del registro"
+
+o
+
+1. Ve a Configuración > Modelo de datos > objeto de tu elección > Diseño
+
+2. Haz clic en el botón "Personalizar la página del registro" para ese objeto
+
+3. Ahora estás en el modo de personalización:
+ * **Agrega widgets** desde el selector de widgets
+ * **Arrastra widgets** para reposicionarlos en la cuadrícula
+ * **Cambia el tamaño de los widgets** arrastrando sus bordes
+ * **Configura los campos** que se muestran dentro de cada widget
+ * **Gestiona las pestañas** — agregar, eliminar, cambiar el nombre, reordenar
+
+4. Guarda tus cambios — se aplican a todos los registros de ese tipo de objeto
+
+## Visibilidad de campos
+
+Dentro de un widget de Campos, puedes controlar qué campos son visibles y en qué orden. Esto te permite crear diseños enfocados — por ejemplo, mostrar solo los campos más importantes en la pestaña Resumen y colocar los campos detallados en una pestaña separada.
diff --git a/packages/twenty-docs/l/es/user-guide/layout/overview.mdx b/packages/twenty-docs/l/es/user-guide/layout/overview.mdx
new file mode 100644
index 00000000000..675952a4825
--- /dev/null
+++ b/packages/twenty-docs/l/es/user-guide/layout/overview.mdx
@@ -0,0 +1,45 @@
+---
+title: Diseño
+description: Personaliza cómo navegas, exploras y visualizas registros en Twenty.
+---
+
+El diseño de Twenty es personalizable a tres niveles: cómo navegas por la aplicación, cómo exploras las listas de registros y qué ves al abrir un registro individual.
+
+## Navegación
+
+La barra lateral izquierda es totalmente personalizable. Puedes:
+
+* **Reordena elementos** arrastrando y soltando
+* **Crea carpetas** para agrupar objetos y vistas relacionados
+* **Oculta objetos** que no usas
+* **Añade enlaces personalizados** a herramientas externas
+* **Fija favoritos** para acceder rápidamente a vistas, registros o búsquedas
+
+[Referencia de navegación →](/l/es/user-guide/layout/capabilities/navigation)
+
+## Vistas
+
+Las vistas controlan cómo se muestran las listas de registros. Twenty admite tres tipos de vista:
+
+| Vista | Ideal para |
+| -------------- | ------------------------------------------------------------------------------------------ |
+| **Tabla** | Trabajar con muchos registros a la vez — filas y columnas al estilo de una hoja de cálculo |
+| **Kanban** | Seguimiento del pipeline — tarjetas de arrastrar y soltar organizadas por etapa |
+| **Calendario** | Planificación basada en el tiempo — registros distribuidos en función de un campo de fecha |
+
+Cada vista guarda sus propios filtros, ordenación, visibilidad de campos y configuración de agrupación. Las vistas pueden compartirse con el espacio de trabajo o mantenerse privadas.
+
+[Vistas de tabla →](/l/es/user-guide/views-pipelines/capabilities/table-views) · [Vistas de Kanban →](/l/es/user-guide/views-pipelines/capabilities/kanban-views) · [Vista de calendario →](/l/es/user-guide/views-pipelines/capabilities/calendar-view)
+
+## Páginas de registro
+
+Cuando abres un registro, la página de detalles se compone de pestañas y widgets configurables. Puedes:
+
+* **Añade, elimina y reordena pestañas** en cualquier tipo de registro
+* **Configura widgets** — campos, registros relacionados, correos electrónicos, cronología, calendario, tareas, notas, archivos, gráficos, iframes y más
+* **Arrastra y cambia el tamaño de los widgets** en un diseño de cuadrícula
+* **Controla la visibilidad de campos** por widget
+
+Entra en el modo de personalización del diseño desde el menú de comandos (`Cmd+K` → "Editar diseño de la página de registro").
+
+[Referencia de páginas de registro →](/l/es/user-guide/layout/capabilities/record-pages)
diff --git a/packages/twenty-docs/l/es/user-guide/permissions-access/capabilities/permissions.mdx b/packages/twenty-docs/l/es/user-guide/permissions-access/capabilities/permissions.mdx
index b435886aa1b..bea32dbe84e 100644
--- a/packages/twenty-docs/l/es/user-guide/permissions-access/capabilities/permissions.mdx
+++ b/packages/twenty-docs/l/es/user-guide/permissions-access/capabilities/permissions.mdx
@@ -13,7 +13,7 @@ El sistema de permisos de Twenty te permite controlar el acceso a tres áreas pr
Para crear un nuevo rol:
-1. Ve a **Ajustes → Roles**
+1. Ve a **Ajustes → Miembros → Roles**
2. En **Todos los Roles**, haz clic en **+ Crear Rol**
3. Introduce un nombre para el rol
4. En la pestaña predeterminada de **Permisos**, [configura los permisos](#customize-permissions)
@@ -23,26 +23,26 @@ Para crear un nuevo rol:
Para eliminar un rol:
-1. Ve a **Ajustes → Roles**
+1. Ve a **Ajustes → Miembros → Roles**
2. Haz clic en el rol que deseas eliminar
3. Abre la pestaña **Ajustes**, luego haz clic en **Eliminar rol**
4. Haz clic en **Confirmar** en el modal
<Note>
- Si se elimina un rol, cualquier miembro del espacio de trabajo asignado a él será reasignado automáticamente al rol predeterminado. Todos excepto el rol **Admin** pueden eliminarse. Siempre debe haber al menos un miembro asignado al rol **Admin**.
+Si se elimina un rol, cualquier miembro del espacio de trabajo asignado a él será reasignado automáticamente al rol predeterminado. Todos excepto el rol **Admin** pueden eliminarse. Siempre debe haber al menos un miembro asignado al rol **Admin**.
</Note>
## Asignar roles a miembros
### Ver Asignaciones Actuales
-* Ve a **Ajustes → Roles**
+* Ve a **Ajustes → Miembros → Roles**
* Ver todos los roles y cuántos miembros están asignados a cada uno
* Ver qué miembros tienen qué roles
### Asignar un rol a un miembro
-1. Ve a **Ajustes → Roles**
+1. Ve a **Ajustes → Miembros → Roles**
2. Haz clic en el rol que deseas asignar
3. Abre la pestaña **Asignación**
4. Haz clic en **+ Asignar a miembro**
@@ -51,13 +51,13 @@ Para eliminar un rol:
### Establecer rol predeterminado
-1. Ve a **Ajustes → Roles**
+1. Ve a **Ajustes → Miembros → Roles**
2. En la sección **Opciones**, encuentra **Rol Predeterminado**
3. Selecciona qué rol deberían recibir automáticamente los nuevos miembros
4. Los nuevos miembros del espacio de trabajo serán asignados a este rol cuando se unan
<Note>
- Solo puedes asignar roles a miembros existentes del espacio de trabajo. Para invitar a nuevos miembros, utiliza [Gestión de Miembros](/l/es/user-guide/settings/capabilities/member-management).
+Solo puedes asignar roles a miembros existentes del espacio de trabajo. Para invitar a nuevos miembros, utiliza [Gestión de Miembros](/l/es/user-guide/settings/capabilities/member-management).
</Note>
## Personalizar Permisos
@@ -82,7 +82,7 @@ Primero, configura los permisos base que se aplican a **todos los objetos** de f
Selecciona o deselecciona según cuál deba ser el comportamiento predeterminado para este rol.
<Note>
- **Ejemplo — rol de becario**: Un becario debería poder ver todos los objetos, pero no editarlos de forma predeterminada. Activa "Ver registros en todos los objetos" pero deja "Editar registros en todos los objetos" sin marcar.
+**Ejemplo — rol de becario**: Un becario debería poder ver todos los objetos, pero no editarlos de forma predeterminada. Activa "Ver registros en todos los objetos" pero deja "Editar registros en todos los objetos" sin marcar.
</Note>
#### Agregar excepciones a nivel de objeto
@@ -98,6 +98,22 @@ Haz clic en **+ Agregar regla** y selecciona un objeto para crear una excepción
| Oportunidades → desactivar "Ver registros" | El becario no puede ver el objeto Oportunidades en absoluto |
| Personas → activar "Editar registros" | El becario puede editar registros de Personas (pero no de otros objetos) |
+### Permisos a nivel de fila
+
+<Note>
+Los permisos a nivel de fila son una **función Premium** disponible en el plan **Organization** (en la nube y autoalojado).
+</Note>
+
+Los permisos a nivel de fila permiten restringir qué registros individuales puede ver o editar un rol, en función de criterios dinámicos. A diferencia de los permisos de objeto (que se aplican a un tipo de objeto completo), los permisos a nivel de fila evalúan cada registro de forma independiente.
+
+**Casos de uso de ejemplo:**
+
+* Los representantes de ventas solo pueden ver sus propias oportunidades
+* Los gerentes pueden ver todos los registros de su región
+* Los agentes de soporte solo pueden ver los tickets que les han sido asignados
+
+Para configurar los permisos a nivel de fila, abre un rol, ve a la pestaña **Objetos** y usa la sección **Nivel de fila** para definir condiciones de filtro para un objeto específico.
+
### Permisos de campos
Dentro de cada regla a nivel de objeto, puedes ir más allá y configurar **permisos a nivel de campo** para controlar el acceso a campos específicos.
@@ -145,7 +161,7 @@ Controla el acceso a configuraciones del espacio de trabajo de dos maneras:
* O habilita permisos específicos (p. ej., generación de claves de API, preferencias del espacio de trabajo, asignación de roles, configuración del modelo de datos, ajustes de seguridad y gestión de flujos de trabajo)
<Note>
- **Limitación actual**: Actualmente se requiere acceso a la gestión de flujos de trabajo para activar manualmente los flujos de trabajo. Este comportamiento puede cambiar en versiones futuras.
+**Limitación actual**: Actualmente se requiere acceso a la gestión de flujos de trabajo para activar manualmente los flujos de trabajo. Este comportamiento puede cambiar en versiones futuras.
</Note>
### Permisos de Acción del Espacio de Trabajo
@@ -168,7 +184,7 @@ Además de los miembros del espacio de trabajo, los roles también se pueden asi
### Asignar un rol a una clave de API
-1. Ve a **Ajustes → Roles**
+1. Ve a **Ajustes → Miembros → Roles**
2. Haz clic en el rol que deseas asignar
3. Abre la pestaña **Asignación**
4. En **Claves de API**, haz clic en **+ Asignar a clave de API**
@@ -178,12 +194,12 @@ Además de los miembros del espacio de trabajo, los roles también se pueden asi
La clave de API heredará ahora todos los permisos definidos por ese rol. Cualquier llamada a la API realizada con esta clave se restringirá en consecuencia.
<Note>
- Las claves de API sin un rol asignado utilizan los permisos predeterminados. Para mayor seguridad, asigna siempre un rol específico a las claves de API de producción.
+Las claves de API sin un rol asignado utilizan los permisos predeterminados. Para mayor seguridad, asigna siempre un rol específico a las claves de API de producción.
</Note>
### Asignar un rol a un agente de IA
-1. Ve a **Ajustes → Roles**
+1. Ve a **Ajustes → Miembros → Roles**
2. Haz clic en el rol que deseas asignar
3. Abre la pestaña **Asignación**
4. En **Agentes de IA**, haz clic en **+ Asignar a agente de IA**
@@ -193,5 +209,5 @@ La clave de API heredará ahora todos los permisos definidos por ese rol. Cualqu
El agente de IA solo podrá acceder a los datos y realizar las acciones permitidas por el rol asignado.
<Note>
- Para los agentes de IA que se ejecutan dentro de flujos de trabajo, esto garantiza que el agente no pueda acceder ni modificar datos fuera de su alcance previsto, incluso si el flujo de trabajo tiene permisos más amplios.
+Para los agentes de IA que se ejecutan dentro de flujos de trabajo, esto garantiza que el agente no pueda acceder ni modificar datos fuera de su alcance previsto, incluso si el flujo de trabajo tiene permisos más amplios.
</Note>
diff --git a/packages/twenty-docs/l/es/user-guide/permissions-access/capabilities/sso-configuration.mdx b/packages/twenty-docs/l/es/user-guide/permissions-access/capabilities/sso-configuration.mdx
index 19b747a3b3f..c91dac4bc17 100644
--- a/packages/twenty-docs/l/es/user-guide/permissions-access/capabilities/sso-configuration.mdx
+++ b/packages/twenty-docs/l/es/user-guide/permissions-access/capabilities/sso-configuration.mdx
@@ -28,7 +28,7 @@ Twenty admite SSO con:
* Acceso de administrador al espacio de trabajo de Twenty
<Note>
- **Para usuarios de autoalojamiento que deseen configurar SSO**, comuníquese con [email protected]
+**Para usuarios de autoalojamiento que deseen configurar SSO**, comuníquese con [email protected]
</Note>
### Pasos de configuración
diff --git a/packages/twenty-docs/l/es/user-guide/permissions-access/how-tos/permissions-faq.mdx b/packages/twenty-docs/l/es/user-guide/permissions-access/how-tos/permissions-faq.mdx
index 7d422bb649e..1155392e5c5 100644
--- a/packages/twenty-docs/l/es/user-guide/permissions-access/how-tos/permissions-faq.mdx
+++ b/packages/twenty-docs/l/es/user-guide/permissions-access/how-tos/permissions-faq.mdx
@@ -6,121 +6,115 @@ description: Preguntas frecuentes sobre roles y permisos.
## Roles
<AccordionGroup>
- <Accordion title="¿Qué roles incluye Twenty por defecto?">
- Twenty incluye los roles **Admin** y **Member** por defecto. Puedes crear roles personalizados adicionales según las necesidades de tu equipo (p. ej., Representante de ventas, Gerente, Usuario de solo lectura).
- </Accordion>
+<Accordion title="¿Qué roles incluye Twenty por defecto?">
+Twenty incluye los roles **Admin** y **Member** por defecto. Puedes crear roles personalizados adicionales según las necesidades de tu equipo (p. ej., Representante de ventas, Gerente, Usuario de solo lectura).
+</Accordion>
- <Accordion title="¿Puedo eliminar el rol de Admin?">
- No, el rol de Admin no se puede eliminar. Siempre debe haber al menos un miembro asignado al rol de Admin.
- </Accordion>
+<Accordion title="¿Puedo eliminar el rol de Admin?">
+No, el rol de Admin no se puede eliminar. Siempre debe haber al menos un miembro asignado al rol de Admin.
+</Accordion>
- <Accordion title="¿Qué ocurre cuando elimino un rol?">
- Cualquier miembro del espacio de trabajo asignado a ese rol será reasignado automáticamente al rol predeterminado.
- </Accordion>
+<Accordion title="¿Qué ocurre cuando elimino un rol?">
+Cualquier miembro del espacio de trabajo asignado a ese rol será reasignado automáticamente al rol predeterminado.
+</Accordion>
- <Accordion title="¿Cómo configuro un rol predeterminado para los nuevos miembros?">
- Ve a **Ajustes → Roles**, busca la opción **Rol predeterminado** y selecciona qué rol deben recibir automáticamente los nuevos miembros cuando se unan.
- </Accordion>
+<Accordion title="¿Cómo configuro un rol predeterminado para los nuevos miembros?">
+Ve a **Ajustes → Miembros → Roles**, busca la opción **Rol predeterminado** y selecciona qué rol deben recibir automáticamente los nuevos miembros cuando se unan.
+</Accordion>
- <Accordion title="¿Puedo asignar varios roles a un usuario?">
- No, cada usuario solo puede tener un rol a la vez. Crea un rol personalizado si necesitas una combinación de permisos.
- </Accordion>
+<Accordion title="¿Puedo asignar varios roles a un usuario?">
+No, cada usuario solo puede tener un rol a la vez. Crea un rol personalizado si necesitas una combinación de permisos.
+</Accordion>
</AccordionGroup>
## Permisos
<AccordionGroup>
- <Accordion title="¿Cuál es la diferencia entre los permisos de objeto y de campo?">
- * **Permisos de objeto**: Controlan el acceso a registros completos (p. ej., ver/editar/eliminar registros de Personas)
- * **Permisos de campo**: Controlan el acceso a campos específicos dentro de un objeto (p. ej., ver pero no editar el campo Salario)
-
- Los permisos de campo permiten un control más granular sobre los datos sensibles.
- </Accordion>
-
- <Accordion title="¿Cómo funcionan las anulaciones de permisos?">
- Los permisos se aplican en cascada de lo global a lo específico:
-
- 1. **Todos los objetos** establece la base para todos los objetos
- 2. **Permisos a nivel de objeto** pueden anular la configuración global para objetos específicos
- 3. **Permisos a nivel de campo** pueden anular la configuración del objeto para campos específicos
-
- Las configuraciones más específicas siempre tienen prioridad.
- </Accordion>
-
- <Accordion title="¿Qué significan los distintos niveles de permisos?">
- Para objetos:
-
- * **Ver registros**: Ver registros en listas y páginas de detalle
- * **Editar registros**: Modificar registros existentes
- * **Eliminar registros**: Eliminación lógica de registros (se pueden restaurar)
- * **Destruir registros**: Eliminar registros de forma permanente
-
- Para campos:
-
- * **Ver campo**: Ver el valor del campo
- * **Editar campo**: Modificar el valor del campo
- * **Sin acceso**: El campo está completamente oculto
- </Accordion>
-
- <Accordion title="¿Puedo restringir el acceso a registros específicos (permisos a nivel de fila)?">
- Los permisos a nivel de fila estarán disponibles en el plan **Organization** para el primer trimestre de 2026. Esto te permite restringir el acceso a registros específicos según criterios (p. ej., ver solo tus propias oportunidades).
- </Accordion>
-
- <Accordion title="¿Cómo hago que un campo sea de solo lectura para ciertos usuarios?">
- 1. Ve a **Ajustes → Roles**
- 2. Selecciona el rol
- 3. Navega hasta el objeto que contiene el campo
- 4. Configura el permiso del campo en **See Field** (sin Edit Field)
- </Accordion>
+<Accordion title="¿Cuál es la diferencia entre los permisos de objeto y de campo?">
+* **Permisos de objeto**: Controlan el acceso a registros completos (p. ej., ver/editar/eliminar registros de Personas)
+* **Permisos de campo**: Controlan el acceso a campos específicos dentro de un objeto (p. ej., ver pero no editar el campo Salario)
+
+Los permisos de campo permiten un control más granular sobre los datos sensibles.
+</Accordion>
+
+<Accordion title="¿Cómo funcionan las anulaciones de permisos?">
+Los permisos se aplican en cascada de lo global a lo específico:
+1. **Todos los objetos** establece la base para todos los objetos
+2. **Permisos a nivel de objeto** pueden anular la configuración global para objetos específicos
+3. **Permisos a nivel de campo** pueden anular la configuración del objeto para campos específicos
+
+Las configuraciones más específicas siempre tienen prioridad.
+</Accordion>
+
+<Accordion title="¿Qué significan los distintos niveles de permisos?">
+Para objetos:
+* **Ver registros**: Ver registros en listas y páginas de detalle
+* **Editar registros**: Modificar registros existentes
+* **Eliminar registros**: Eliminación lógica de registros (se pueden restaurar)
+* **Destruir registros**: Eliminar registros de forma permanente
+
+Para campos:
+* **Ver campo**: Ver el valor del campo
+* **Editar campo**: Modificar el valor del campo
+* **Sin acceso**: El campo está completamente oculto
+</Accordion>
+
+<Accordion title="¿Puedo restringir el acceso a registros específicos (permisos a nivel de fila)?">
+Los permisos a nivel de fila están disponibles en el plan **Organization**. Esto te permite restringir el acceso a registros específicos según criterios (p. ej., ver solo tus propias oportunidades).
+</Accordion>
+
+<Accordion title="¿Cómo hago que un campo sea de solo lectura para ciertos usuarios?">
+1. Ve a **Ajustes → Miembros → Roles**
+2. Selecciona el rol
+3. Navega hasta el objeto que contiene el campo
+4. Configura el permiso del campo en **See Field** (sin Edit Field)
+</Accordion>
</AccordionGroup>
## Ajustes y acciones
<AccordionGroup>
- <Accordion title="¿Qué permisos de configuración están disponibles?">
- Puedes controlar el acceso a:
-
- * Generación de claves de API
- * Preferencias del espacio de trabajo
- * Asignación de roles
- * Configuración del modelo de datos
- * Configuración de seguridad
- * Gestión de flujos de trabajo
-
- Usa **Settings All Access** para otorgar acceso total o habilita permisos específicos.
- </Accordion>
-
- <Accordion title="¿Qué permisos de acción están disponibles?">
- Puedes controlar:
-
- * **Send Email**: Capacidad para enviar correos desde Twenty
- * **Import CSV**: Capacidad para importar datos mediante CSV
- * **Export CSV**: Capacidad para exportar datos a CSV
-
- Usa **Application All Access** para otorgar todas las acciones o habilitar acciones específicas.
- </Accordion>
+<Accordion title="¿Qué permisos de configuración están disponibles?">
+Puedes controlar el acceso a:
+* Generación de claves de API
+* Preferencias del espacio de trabajo
+* Asignación de roles
+* Configuración del modelo de datos
+* Configuración de seguridad
+* Gestión de flujos de trabajo
+
+Usa **Settings All Access** para otorgar acceso total o habilita permisos específicos.
+</Accordion>
+
+<Accordion title="¿Qué permisos de acción están disponibles?">
+Puedes controlar:
+* **Send Email**: Capacidad para enviar correos desde Twenty
+* **Import CSV**: Capacidad para importar datos mediante CSV
+* **Export CSV**: Capacidad para exportar datos a CSV
+
+Usa **Application All Access** para otorgar todas las acciones o habilitar acciones específicas.
+</Accordion>
</AccordionGroup>
## SSO
<AccordionGroup>
- <Accordion title="¿Está disponible el SSO en todos los planes?">
- No, SSO es una función Premium disponible solo en el plan **Organization**.
- </Accordion>
-
- <Accordion title="¿Qué proveedores de identidad son compatibles?">
- Twenty es compatible con:
-
- * **SAML 2.0** (funciona con la mayoría de los proveedores de identidad empresariales)
- * **Google Workspace**
- * **Microsoft Entra ID** (anteriormente Azure AD)
- </Accordion>
-
- <Accordion title="¿Qué es el aprovisionamiento Just-in-Time (JIT)?">
- Con el aprovisionamiento JIT, las cuentas de usuario se crean automáticamente en Twenty cuando alguien inicia sesión mediante SSO por primera vez. Se les asigna automáticamente el rol predeterminado.
- </Accordion>
-
- <Accordion title="¿Puedo exigir SSO para todos los usuarios?">
- Sí, una vez configurado SSO, puedes desactivar el inicio de sesión con contraseña para los usuarios de SSO y forzar la autenticación a través de tu proveedor de identidad.
- </Accordion>
+<Accordion title="¿Está disponible el SSO en todos los planes?">
+No, SSO es una función Premium disponible solo en el plan **Organization**.
+</Accordion>
+
+<Accordion title="¿Qué proveedores de identidad son compatibles?">
+Twenty es compatible con:
+* **SAML 2.0** (funciona con la mayoría de los proveedores de identidad empresariales)
+* **Google Workspace**
+* **Microsoft Entra ID** (anteriormente Azure AD)
+</Accordion>
+
+<Accordion title="¿Qué es el aprovisionamiento Just-in-Time (JIT)?">
+Con el aprovisionamiento JIT, las cuentas de usuario se crean automáticamente en Twenty cuando alguien inicia sesión mediante SSO por primera vez. Se les asigna automáticamente el rol predeterminado.
+</Accordion>
+
+<Accordion title="¿Puedo exigir SSO para todos los usuarios?">
+Sí, una vez configurado SSO, puedes desactivar el inicio de sesión con contraseña para los usuarios de SSO y forzar la autenticación a través de tu proveedor de identidad.
+</Accordion>
</AccordionGroup>
diff --git a/packages/twenty-docs/l/es/user-guide/permissions-access/overview.mdx b/packages/twenty-docs/l/es/user-guide/permissions-access/overview.mdx
index c6c9648a5af..3838861c51f 100644
--- a/packages/twenty-docs/l/es/user-guide/permissions-access/overview.mdx
+++ b/packages/twenty-docs/l/es/user-guide/permissions-access/overview.mdx
@@ -3,7 +3,6 @@ title: Permisos y acceso
description: Administra roles, permisos y el control de acceso en tu espacio de trabajo.
---
-
El sistema de permisos de Twenty te permite controlar quién puede acceder y modificar los datos en tu espacio de trabajo. Crea roles, asigna permisos y configura SSO para un acceso seguro.
## Qué incluye esta sección
@@ -12,11 +11,9 @@ El sistema de permisos de Twenty te permite controlar quién puede acceder y mod
<Card title="Permisos" icon="lock" href="/l/es/user-guide/permissions-access/capabilities/permissions">
Crea roles y configura permisos de objetos, campos y configuración.
</Card>
-
<Card title="Configuración de SSO" icon="clave" href="/l/es/user-guide/permissions-access/capabilities/sso-configuration">
Configura el inicio de sesión único (SSO) con tu proveedor de identidad.
</Card>
-
<Card title="Preguntas frecuentes" icon="circle-question" href="/l/es/user-guide/permissions-access/how-tos/permissions-faq">
Preguntas comunes sobre roles, permisos y SSO.
</Card>
diff --git a/packages/twenty-docs/l/es/user-guide/settings/capabilities/domains-settings.mdx b/packages/twenty-docs/l/es/user-guide/settings/capabilities/domains-settings.mdx
index de7a60b1087..86288e0b1f8 100644
--- a/packages/twenty-docs/l/es/user-guide/settings/capabilities/domains-settings.mdx
+++ b/packages/twenty-docs/l/es/user-guide/settings/capabilities/domains-settings.mdx
@@ -3,10 +3,12 @@ title: Configuración de Dominios
description: Configura el dominio del espacio de trabajo, los dominios de acceso aprobado y los dominios públicos.
---
-Configura los ajustes de dominio en **Ajustes → Dominios**.
+La configuración de dominios se encuentra en tres lugares, según lo que estés configurando.
## Dominio del espacio de trabajo
+Configura en **Ajustes → General → Dominio del espacio de trabajo**.
+
Edita el nombre de tu subdominio o establece un dominio personalizado para tu espacio de trabajo.
### Personalizar dominio
@@ -19,6 +21,8 @@ Para dominios personalizados, tendrás que configurar los ajustes de DNS con tu
## Dominios Aprobados
+Configura en **Ajustes → Miembros → Invitar**.
+
Cualquiera con una dirección de correo electrónico en estos dominios puede registrarse automáticamente en este espacio de trabajo.
### Añadir Dominio de Acceso Aprobado
@@ -30,18 +34,21 @@ Cualquiera con una dirección de correo electrónico en estos dominios puede reg
Una vez configurado, cualquiera con una dirección de correo electrónico en ese dominio puede unirse a tu espacio de trabajo sin necesidad de una invitación directa.
<Note>
- Esto es útil para permitir que todo tu equipo se autorregistre y, al mismo tiempo, mantener el espacio de trabajo restringido a tu organización.
+Esto es útil para permitir que todo tu equipo se autorregistre y, al mismo tiempo, mantener el espacio de trabajo restringido a tu organización.
</Note>
## Dominios Públicos
-Provisiona un entorno de alojamiento completo y seguro en estos dominios.
+Configura en **Ajustes → Aplicaciones → Desarrollador**.
+
+Provisiona un entorno de alojamiento completo y seguro en estos dominios. Un dominio público puede vincularse a una aplicación específica; cuando está vinculado, solo las funciones lógicas enrutadas por HTTP de esa aplicación son accesibles en el dominio. Deja la vinculación vacía para exponer todas las rutas HTTP del espacio de trabajo.
### Agregar Dominio Público
1. Haz clic en **Agregar Dominio Público**
2. Introduce el dominio que quieres usar
-3. Configura los ajustes de DNS según las instrucciones
-4. Verifica el dominio
+3. Vincúlalo opcionalmente a una aplicación
+4. Configura los ajustes de DNS según las instrucciones
+5. Verifica el dominio
Los certificados SSL se aprovisionan automáticamente para los dominios públicos.
diff --git a/packages/twenty-docs/l/es/user-guide/settings/capabilities/experience-settings.mdx b/packages/twenty-docs/l/es/user-guide/settings/capabilities/experience-settings.mdx
index aa9cd288ad1..08750d1014a 100644
--- a/packages/twenty-docs/l/es/user-guide/settings/capabilities/experience-settings.mdx
+++ b/packages/twenty-docs/l/es/user-guide/settings/capabilities/experience-settings.mdx
@@ -33,6 +33,6 @@ Cada ajuste puede configurarse en **Ajustes del sistema** para coincidir automá
## Cómo actualizar
-1. Ve a **Ajustes ���� �� Experiencia**
+1. Ve a **Ajustes → Experiencia**
2. Ajusta tus preferencias en cada sección
3. Los cambios se guardan automáticamente
diff --git a/packages/twenty-docs/l/es/user-guide/settings/capabilities/member-management.mdx b/packages/twenty-docs/l/es/user-guide/settings/capabilities/member-management.mdx
index acccd5dcf39..3bd128d2d99 100644
--- a/packages/twenty-docs/l/es/user-guide/settings/capabilities/member-management.mdx
+++ b/packages/twenty-docs/l/es/user-guide/settings/capabilities/member-management.mdx
@@ -59,11 +59,11 @@ En la página de perfil del miembro:
2. Haz clic en **Eliminar** para eliminarlo del espacio de trabajo
<Warning>
- Los miembros eliminados pierden el acceso de inmediato. Sus datos (registros, notas, tareas) permanecen en el espacio de trabajo.
+Los miembros eliminados pierden el acceso de inmediato. Sus datos (registros, notas, tareas) permanecen en el espacio de trabajo.
</Warning>
<Warning>
- **También se elimina la sincronización de correo electrónico.** Si el usuario eliminado era el único que sincronizaba ciertos correos electrónicos, esos correos se eliminarán permanentemente del espacio de trabajo.
+**También se elimina la sincronización de correo electrónico.** Si el usuario eliminado era el único que sincronizaba ciertos correos electrónicos, esos correos se eliminarán permanentemente del espacio de trabajo.
</Warning>
## Invitaciones pendientes
@@ -77,7 +77,7 @@ Gestiona las invitaciones que no se han aceptado:
Permite que los miembros del equipo se unan automáticamente según su dominio de correo electrónico:
-1. Ve a **Configuración → Dominios**
+1. Ve a **Ajustes → Miembros → Invitar**
2. Introduce el dominio de tu empresa (p. ej., `yourcompany.com`)
3. Cualquiera con ese dominio de correo electrónico puede unirse sin invitación
diff --git a/packages/twenty-docs/l/es/user-guide/settings/capabilities/profile-settings.mdx b/packages/twenty-docs/l/es/user-guide/settings/capabilities/profile-settings.mdx
index 93593df4857..96a0694f659 100644
--- a/packages/twenty-docs/l/es/user-guide/settings/capabilities/profile-settings.mdx
+++ b/packages/twenty-docs/l/es/user-guide/settings/capabilities/profile-settings.mdx
@@ -32,7 +32,7 @@ Habilita 2FA para agregar una capa extra de seguridad a tu cuenta.
### Eliminar cuenta
<Warning>
- Eliminar tu cuenta eliminará permanentemente tu acceso a todos los espacios de trabajo. Esta acción no se puede deshacer; perderás el acceso a todos los espacios de trabajo de los que eres miembro, y deberías considerar salir de espacios de trabajo individuales si solo quieres salir de equipos específicos.
+Eliminar tu cuenta eliminará permanentemente tu acceso a todos los espacios de trabajo. Esta acción no se puede deshacer; perderás el acceso a todos los espacios de trabajo de los que eres miembro, y deberías considerar salir de espacios de trabajo individuales si solo quieres salir de equipos específicos.
</Warning>
Para eliminar tu cuenta:
diff --git a/packages/twenty-docs/l/es/user-guide/settings/capabilities/updates-settings.mdx b/packages/twenty-docs/l/es/user-guide/settings/capabilities/updates-settings.mdx
index 5aab0cf3fcf..e9435c52ccf 100644
--- a/packages/twenty-docs/l/es/user-guide/settings/capabilities/updates-settings.mdx
+++ b/packages/twenty-docs/l/es/user-guide/settings/capabilities/updates-settings.mdx
@@ -24,7 +24,7 @@ Las funciones de acceso anticipado son capacidades que todavía se están proban
5. La función estará disponible de inmediato
<Note>
- Las funciones de acceso anticipado pueden cambiar según los comentarios de los usuarios. ¡Tus comentarios ayudan a mejorar Twenty!
+Las funciones de acceso anticipado pueden cambiar según los comentarios de los usuarios. ¡Tus comentarios ayudan a mejorar Twenty!
</Note>
## Comentarios sobre las funciones
diff --git a/packages/twenty-docs/l/es/user-guide/settings/capabilities/workspace-settings.mdx b/packages/twenty-docs/l/es/user-guide/settings/capabilities/workspace-settings.mdx
index 9926f88c487..de49207e847 100644
--- a/packages/twenty-docs/l/es/user-guide/settings/capabilities/workspace-settings.mdx
+++ b/packages/twenty-docs/l/es/user-guide/settings/capabilities/workspace-settings.mdx
@@ -19,7 +19,7 @@ Se puede acceder a ellas desde **Settings → General**.
## Zona de Peligro
<Warning>
- Eliminar tu espacio de trabajo elimina permanentemente todos los datos y no se puede deshacer. Todos los datos del espacio de trabajo se perderán para siempre, todos los miembros perderán el acceso inmediatamente, y esta acción no se puede revertir.
+Eliminar tu espacio de trabajo elimina permanentemente todos los datos y no se puede deshacer. Todos los datos del espacio de trabajo se perderán para siempre, todos los miembros perderán el acceso inmediatamente, y esta acción no se puede revertir.
</Warning>
Para eliminar tu espacio de trabajo:
diff --git a/packages/twenty-docs/l/es/user-guide/settings/how-tos/settings-faq.mdx b/packages/twenty-docs/l/es/user-guide/settings/how-tos/settings-faq.mdx
index a9b0dd99d59..2777f8d775c 100644
--- a/packages/twenty-docs/l/es/user-guide/settings/how-tos/settings-faq.mdx
+++ b/packages/twenty-docs/l/es/user-guide/settings/how-tos/settings-faq.mdx
@@ -6,165 +6,165 @@ description: Preguntas frecuentes sobre los ajustes de Twenty.
## Configuración del Espacio de Trabajo
<AccordionGroup>
- <Accordion title="¿Cómo cambio el nombre de mi espacio de trabajo?">
- 1. Ve a **Ajustes → General**
- 2. Busca el campo Nombre del espacio de trabajo
- 3. Introduce tu nuevo nombre
- 4. Los cambios se guardan automáticamente
- </Accordion>
-
- <Accordion title="¿Cómo actualizo el logotipo de mi espacio de trabajo?">
- 1. Ve a **Ajustes → General**
- 2. Haz clic en el logotipo actual o en el área de carga
- 3. Selecciona un archivo de imagen (PNG, JPEG o GIF de menos de 10 MB)
- 4. El logotipo se actualiza de inmediato
- </Accordion>
-
- <Accordion title="¿Puedo tener varios espacios de trabajo?">
- Sí, puedes crear y ser miembro de varios espacios de trabajo. Cada espacio de trabajo tiene sus propios datos, ajustes y suscripción.
- </Accordion>
-
- <Accordion title="¿Cómo elimino mi espacio de trabajo?">
- 1. Ve a **Ajustes → General**
- 2. Desplázate hasta Zona de peligro
- 3. Haz clic en **Eliminar espacio de trabajo**
- 4. Confirma la eliminación
-
- Nota: Esto elimina permanentemente todos los datos y no se puede deshacer.
- </Accordion>
-
- <Accordion title="Creé varios espacios de trabajo por accidente. ¿Qué debo hacer?">
- Elimina los espacios de trabajo que ya no necesitas en **Ajustes → General → Eliminar espacio de trabajo**.
-
- <Warning>
- No elimines tu **cuenta** (accesible en Ajustes → Perfil): tu cuenta se comparte entre todos tus espacios de trabajo. Eliminar tu cuenta elimina el acceso a TODOS los espacios de trabajo.
- </Warning>
- </Accordion>
-
- <Accordion title="¿Cómo desactivo mi espacio de trabajo sin eliminarlo?">
- Si quieres desactivar temporalmente tu espacio de trabajo (no eliminarlo de forma permanente), ve a **Ajustes → Facturación** y haz clic en **Cancelar plan**. Tus datos se conservarán durante un período de gracia.
- </Accordion>
+<Accordion title="¿Cómo cambio el nombre de mi espacio de trabajo?">
+1. Ve a **Ajustes → General**
+2. Busca el campo Nombre del espacio de trabajo
+3. Introduce tu nuevo nombre
+4. Los cambios se guardan automáticamente
+</Accordion>
+
+<Accordion title="¿Cómo actualizo el logotipo de mi espacio de trabajo?">
+1. Ve a **Ajustes → General**
+2. Haz clic en el logotipo actual o en el área de carga
+3. Selecciona un archivo de imagen (PNG, JPEG o GIF de menos de 10 MB)
+4. El logotipo se actualiza de inmediato
+</Accordion>
+
+<Accordion title="¿Puedo tener varios espacios de trabajo?">
+Sí, puedes crear y ser miembro de varios espacios de trabajo. Cada espacio de trabajo tiene sus propios datos, ajustes y suscripción.
+</Accordion>
+
+<Accordion title="¿Cómo elimino mi espacio de trabajo?">
+1. Ve a **Ajustes → General**
+2. Desplázate hasta Zona de peligro
+3. Haz clic en **Eliminar espacio de trabajo**
+4. Confirma la eliminación
+
+Nota: Esto elimina permanentemente todos los datos y no se puede deshacer.
+</Accordion>
+
+<Accordion title="Creé varios espacios de trabajo por accidente. ¿Qué debo hacer?">
+Elimina los espacios de trabajo que ya no necesitas en **Ajustes → General → Eliminar espacio de trabajo**.
+
+<Warning>
+No elimines tu **cuenta** (accesible en Ajustes → Perfil): tu cuenta se comparte entre todos tus espacios de trabajo. Eliminar tu cuenta elimina el acceso a TODOS los espacios de trabajo.
+</Warning>
+</Accordion>
+
+<Accordion title="¿Cómo desactivo mi espacio de trabajo sin eliminarlo?">
+Si quieres desactivar temporalmente tu espacio de trabajo (no eliminarlo de forma permanente), ve a **Ajustes → Facturación** y haz clic en **Cancelar plan**. Tus datos se conservarán durante un período de gracia.
+</Accordion>
</AccordionGroup>
## Ajustes del perfil
<AccordionGroup>
- <Accordion title="¿Cómo cambio mi contraseña?">
- 1. Ve a **Ajustes → Perfil**
- 2. Busca la sección Contraseña
- 3. Introduce tu contraseña actual
- 4. Introduce tu nueva contraseña
- 5. Guarda los cambios
- </Accordion>
-
- <Accordion title="¿Cómo activo la autenticación de dos factores?">
- 1. Ve a **Ajustes → Perfil**
- 2. Busca la sección 2FA
- 3. Haz clic en **Habilitar 2FA**
- 4. Escanea el código QR con tu aplicación de autenticación
- 5. Introduce el código de verificación
- </Accordion>
-
- <Accordion title="¿Puedo cambiar mi dirección de correo electrónico?">
- Para cambiar tu dirección de correo electrónico, ponte en contacto con [[email protected]](mailto:[email protected]).
- </Accordion>
-
- <Accordion title="¿Cómo elimino mi cuenta?">
- 1. Ve a **Ajustes → Perfil**
- 2. Desplázate hasta Zona de peligro
- 3. Haz clic en **Eliminar cuenta**
- 4. Confirma escribiendo tu correo electrónico
-
- Nota: Esto elimina tu acceso a todos los espacios de trabajo y borra todos los correos electrónicos sincronizados desde tus cuentas conectadas.
- </Accordion>
+<Accordion title="¿Cómo cambio mi contraseña?">
+1. Ve a **Ajustes → Perfil**
+2. Busca la sección Contraseña
+3. Introduce tu contraseña actual
+4. Introduce tu nueva contraseña
+5. Guarda los cambios
+</Accordion>
+
+<Accordion title="¿Cómo activo la autenticación de dos factores?">
+1. Ve a **Ajustes → Perfil**
+2. Busca la sección 2FA
+3. Haz clic en **Habilitar 2FA**
+4. Escanea el código QR con tu aplicación de autenticación
+5. Introduce el código de verificación
+</Accordion>
+
+<Accordion title="¿Puedo cambiar mi dirección de correo electrónico?">
+Para cambiar tu dirección de correo electrónico, ponte en contacto con [[email protected]](mailto:[email protected]).
+</Accordion>
+
+<Accordion title="¿Cómo elimino mi cuenta?">
+1. Ve a **Ajustes → Perfil**
+2. Desplázate hasta Zona de peligro
+3. Haz clic en **Eliminar cuenta**
+4. Confirma escribiendo tu correo electrónico
+
+Nota: Esto elimina tu acceso a todos los espacios de trabajo y borra todos los correos electrónicos sincronizados desde tus cuentas conectadas.
+</Accordion>
</AccordionGroup>
## Ajustes de experiencia
<AccordionGroup>
- <Accordion title="¿Cómo cambio entre el modo claro y el oscuro?">
- 1. Ve a **Ajustes → Experiencia**
- 2. Busca la sección Tema
- 3. Selecciona Claro, Oscuro o Sistema
- </Accordion>
-
- <Accordion title="¿Cómo cambio el formato de la fecha?">
- 1. Ve a **Ajustes → Experiencia**
- 2. Busca Formato de fecha
- 3. Selecciona tu formato preferido
- 4. Los cambios se aplican de inmediato
- </Accordion>
-
- <Accordion title="¿Cómo cambio mi zona horaria?">
- 1. Ve a **Ajustes → Experiencia**
- 2. Busca Zona horaria
- 3. Selecciona tu zona horaria local
- 4. Todas las marcas de tiempo se ajustarán
- </Accordion>
-
- <Accordion title="¿Puedo cambiar el idioma?">
- 1. Ve a **Ajustes → Experiencia**
- 2. Busca Idioma
- 3. Selecciona entre los idiomas disponibles
- 4. La interfaz se actualiza según tu selección
- </Accordion>
+<Accordion title="¿Cómo cambio entre el modo claro y el oscuro?">
+1. Ve a **Ajustes → Experiencia**
+2. Busca la sección Tema
+3. Selecciona Claro, Oscuro o Sistema
+</Accordion>
+
+<Accordion title="¿Cómo cambio el formato de la fecha?">
+1. Ve a **Ajustes → Experiencia**
+2. Busca Formato de fecha
+3. Selecciona tu formato preferido
+4. Los cambios se aplican de inmediato
+</Accordion>
+
+<Accordion title="¿Cómo cambio mi zona horaria?">
+1. Ve a **Ajustes → Experiencia**
+2. Busca Zona horaria
+3. Selecciona tu zona horaria local
+4. Todas las marcas de tiempo se ajustarán
+</Accordion>
+
+<Accordion title="¿Puedo cambiar el idioma?">
+1. Ve a **Ajustes → Experiencia**
+2. Busca Idioma
+3. Selecciona entre los idiomas disponibles
+4. La interfaz se actualiza según tu selección
+</Accordion>
</AccordionGroup>
## Ajustes de la cuenta
<AccordionGroup>
- <Accordion title="¿Cómo conecto mi cuenta de correo electrónico?">
- 1. Ve a **Ajustes → Cuentas**
- 2. Haz clic en **Añadir cuenta**
- 3. Elige Google o Microsoft
- 4. Autoriza el acceso
- 5. Configura los ajustes de sincronización
- </Accordion>
-
- <Accordion title="¿Puedo conectar varias cuentas de correo electrónico?">
- Sí, puedes conectar varias cuentas de correo electrónico. Ve a **Ajustes → Cuentas** y añade cuentas adicionales según sea necesario.
- </Accordion>
-
- <Accordion title="¿Cómo desconecto una cuenta de correo electrónico?">
- 1. Ve a **Ajustes → Cuentas**
- 2. Busca la cuenta que quieres eliminar
- 3. Haz clic en **Desconectar**
- 4. Confirma la acción
- </Accordion>
+<Accordion title="¿Cómo conecto mi cuenta de correo electrónico?">
+1. Ve a **Ajustes → Cuentas**
+2. Haz clic en **Añadir cuenta**
+3. Elige Google o Microsoft
+4. Autoriza el acceso
+5. Configura los ajustes de sincronización
+</Accordion>
+
+<Accordion title="¿Puedo conectar varias cuentas de correo electrónico?">
+Sí, puedes conectar varias cuentas de correo electrónico. Ve a **Ajustes → Cuentas** y añade cuentas adicionales según sea necesario.
+</Accordion>
+
+<Accordion title="¿Cómo desconecto una cuenta de correo electrónico?">
+1. Ve a **Ajustes → Cuentas**
+2. Busca la cuenta que quieres eliminar
+3. Haz clic en **Desconectar**
+4. Confirma la acción
+</Accordion>
</AccordionGroup>
## Dominios
<AccordionGroup>
- <Accordion title="¿Puedo personalizar el dominio de mi espacio de trabajo?">
- ¡Sí! Ve a **Ajustes → Dominios** y haz clic en **Personalizar dominio**. Tienes dos opciones:
+<Accordion title="¿Puedo personalizar el dominio de mi espacio de trabajo?">
+¡Sí! Ve a **Ajustes → General → Dominio del espacio de trabajo** y haz clic en **Personalizar dominio**. Tienes dos opciones:
- * **Subdominio**: Usa un subdominio de Twenty como `yourcompany.twenty.com`
- * **Dominio personalizado**: Usa tu propio dominio como `crm.yourcompany.com` (requiere configuración de DNS)
+* **Subdominio**: Usa un subdominio de Twenty como `yourcompany.twenty.com`
+* **Dominio personalizado**: Usa tu propio dominio como `crm.yourcompany.com` (requiere configuración de DNS)
- Un subdominio se configura rápidamente, mientras que un dominio personalizado ofrece una experiencia completamente de marca para tu equipo.
- </Accordion>
+Un subdominio se configura rápidamente, mientras que un dominio personalizado ofrece una experiencia completamente de marca para tu equipo.
+</Accordion>
- <Accordion title="¿Cómo funcionan los dominios de acceso aprobados?">
- Puedes configurar dominios de acceso aprobados para que los miembros del equipo con direcciones de correo de la empresa puedan unirse automáticamente a tu espacio de trabajo. Ve a **Ajustes → Dominios** y añade el dominio de tu empresa (p. ej., `yourcompany.com`).
- </Accordion>
+<Accordion title="¿Cómo funcionan los dominios de acceso aprobados?">
+Puedes configurar dominios de acceso aprobados para que los miembros del equipo con direcciones de correo de la empresa puedan unirse automáticamente a tu espacio de trabajo. Ve a **Ajustes → Miembros → Invitar** y añade el dominio de tu empresa (p. ej., `yourcompany.com`).
+</Accordion>
</AccordionGroup>
## Funciones de acceso anticipado
<AccordionGroup>
- <Accordion title="¿Qué son las funciones de acceso anticipado?">
- Las funciones de acceso anticipado son capacidades que se están probando antes del lanzamiento general. Actualmente, solo los **paneles** están en acceso anticipado. Pueden cambiar según los comentarios de los usuarios.
- </Accordion>
-
- <Accordion title="¿Es seguro usar las funciones de acceso anticipado?">
- Las funciones de acceso anticipado son funcionales, pero pueden cambiar según los comentarios de los usuarios. Son seguras de usar, pero pueden evolucionar antes de la disponibilidad general.
- </Accordion>
-
- <Accordion title="¿Cómo habilito las funciones de acceso anticipado?">
- 1. Vaya a **Configuración → Actualizaciones → Acceso anticipado**
- 2. Busca la función que deseas
- 3. Actívala
- 4. La función está disponible de inmediato
- </Accordion>
+<Accordion title="¿Qué son las funciones de acceso anticipado?">
+Las funciones de acceso anticipado son capacidades que se están probando antes del lanzamiento general. Actualmente, solo los **paneles** están en acceso anticipado. Pueden cambiar según los comentarios de los usuarios.
+</Accordion>
+
+<Accordion title="¿Es seguro usar las funciones de acceso anticipado?">
+Las funciones de acceso anticipado son funcionales, pero pueden cambiar según los comentarios de los usuarios. Son seguras de usar, pero pueden evolucionar antes de la disponibilidad general.
+</Accordion>
+
+<Accordion title="¿Cómo habilito las funciones de acceso anticipado?">
+1. Vaya a **Configuración → Actualizaciones → Acceso anticipado**
+2. Busca la función que deseas
+3. Actívala
+4. La función está disponible de inmediato
+</Accordion>
</AccordionGroup>
diff --git a/packages/twenty-docs/l/es/user-guide/settings/overview.mdx b/packages/twenty-docs/l/es/user-guide/settings/overview.mdx
index e53e37ede4f..31692cf2177 100644
--- a/packages/twenty-docs/l/es/user-guide/settings/overview.mdx
+++ b/packages/twenty-docs/l/es/user-guide/settings/overview.mdx
@@ -3,7 +3,6 @@ title: Configuración
description: Configura tu espacio de trabajo de Twenty con ajustes esenciales.
---
-
## Configuración inicial
Cuando creas tu espacio de trabajo por primera vez, hay varios ajustes clave que configurar.
@@ -45,7 +44,7 @@ Añade miembros del equipo a tu espacio de trabajo:
4. Asigna los roles adecuados
<Note>
- Antes de invitar a tu equipo, verifica el rol predeterminado en **Ajustes → Roles**. A los nuevos miembros se les asigna automáticamente este rol al unirse.
+Antes de invitar a tu equipo, verifica el rol predeterminado en **Ajustes → Miembros → Roles**. A los nuevos miembros se les asigna automáticamente este rol al unirse.
</Note>
## Lista de verificación de los ajustes del espacio de trabajo
diff --git a/packages/twenty-docs/l/es/user-guide/views-pipelines/capabilities/table-views.mdx b/packages/twenty-docs/l/es/user-guide/views-pipelines/capabilities/table-views.mdx
index 18b8ef13aa3..314c5a22536 100644
--- a/packages/twenty-docs/l/es/user-guide/views-pipelines/capabilities/table-views.mdx
+++ b/packages/twenty-docs/l/es/user-guide/views-pipelines/capabilities/table-views.mdx
@@ -38,7 +38,7 @@ Organiza los registros en grupos contraíbles según un campo de tipo selección
* Agrupar Tareas por estado
<Note>
- **Para un mejor rendimiento, limita a 10-15 grupos visibles por vista.** Si necesitas más grupos, considera usar un Dashboard en su lugar.
+**Para un mejor rendimiento, limita a 10-15 grupos visibles por vista.** Si necesitas más grupos, considera usar un Dashboard en su lugar.
</Note>
### Anchos de columna
diff --git a/packages/twenty-docs/l/es/user-guide/views-pipelines/capabilities/view-settings.mdx b/packages/twenty-docs/l/es/user-guide/views-pipelines/capabilities/view-settings.mdx
index 07c528ed361..6869f34363e 100644
--- a/packages/twenty-docs/l/es/user-guide/views-pipelines/capabilities/view-settings.mdx
+++ b/packages/twenty-docs/l/es/user-guide/views-pipelines/capabilities/view-settings.mdx
@@ -21,7 +21,7 @@ Controla quién puede ver tus vistas personalizadas.
3. Selecciona **Espacio de trabajo** o **No listada**
<Note>
- No se puede cambiar la visibilidad de las vistas predeterminadas "All [Object Name]".
+No se puede cambiar la visibilidad de las vistas predeterminadas "All [Object Name]".
</Note>
## Cambiar el nombre de una vista
@@ -65,7 +65,7 @@ Las vistas marcadas como favoritas aparecen en una sección dedicada para facili
4. Confirma la eliminación
<Warning>
- Las vistas eliminadas no se pueden recuperar.
+Las vistas eliminadas no se pueden recuperar.
</Warning>
## Relacionado
diff --git a/packages/twenty-docs/l/es/user-guide/views-pipelines/how-tos/create-a-table-view-with-grouping.mdx b/packages/twenty-docs/l/es/user-guide/views-pipelines/how-tos/create-a-table-view-with-grouping.mdx
index 7022461f1bd..9f3c41ffac3 100644
--- a/packages/twenty-docs/l/es/user-guide/views-pipelines/how-tos/create-a-table-view-with-grouping.mdx
+++ b/packages/twenty-docs/l/es/user-guide/views-pipelines/how-tos/create-a-table-view-with-grouping.mdx
@@ -32,7 +32,7 @@ En **Opciones → Agrupar → Ordenar**, elija cómo se ordenan los grupos:
Haga clic en el **icono de ojo** junto a un grupo para ocultarlo de la vista.
<Note>
- **Para un mejor rendimiento, limite a 10-15 grupos visibles.** Si necesita más, considere usar un Dashboard.
+**Para un mejor rendimiento, limite a 10-15 grupos visibles.** Si necesita más, considere usar un Dashboard.
</Note>
## Ejemplo: Empresas por industria
diff --git a/packages/twenty-docs/l/es/user-guide/views-pipelines/how-tos/set-up-a-sales-pipeline.mdx b/packages/twenty-docs/l/es/user-guide/views-pipelines/how-tos/set-up-a-sales-pipeline.mdx
index 0d253d00bd9..70a3e193968 100644
--- a/packages/twenty-docs/l/es/user-guide/views-pipelines/how-tos/set-up-a-sales-pipeline.mdx
+++ b/packages/twenty-docs/l/es/user-guide/views-pipelines/how-tos/set-up-a-sales-pipeline.mdx
@@ -31,7 +31,7 @@ Las etapas se definen en el campo **Stage** del objeto Oportunidades.
| **Cerrado perdido** | Negocio perdido |
<Note>
- **De 5 a 7 etapas es lo óptimo.** Demasiadas etapas hacen que el pipeline sea difícil de revisar; muy pocas reducen la visibilidad del progreso de los acuerdos.
+**De 5 a 7 etapas es lo óptimo.** Demasiadas etapas hacen que el pipeline sea difícil de revisar; muy pocas reducen la visibilidad del progreso de los acuerdos.
</Note>
## Paso 2: Crea una vista de pipeline
diff --git a/packages/twenty-docs/l/es/user-guide/views-pipelines/how-tos/show-expected-amount-in-pipeline.mdx b/packages/twenty-docs/l/es/user-guide/views-pipelines/how-tos/show-expected-amount-in-pipeline.mdx
index 87a253c0c1f..518ffaeffa7 100644
--- a/packages/twenty-docs/l/es/user-guide/views-pipelines/how-tos/show-expected-amount-in-pipeline.mdx
+++ b/packages/twenty-docs/l/es/user-guide/views-pipelines/how-tos/show-expected-amount-in-pipeline.mdx
@@ -6,7 +6,7 @@ description: Calcula y muestra valores ponderados de las oportunidades según la
El Importe previsto es un valor calculado: **Importe × Probabilidad**. Esto te ayuda a pronosticar ingresos ponderando las oportunidades según la probabilidad de que se cierren.
<Tip>
- Este es un ejemplo de creación de [Campos de fórmula](/l/es/user-guide/workflows/how-tos/crm-automations/formula-fields) usando flujos de trabajo.
+Este es un ejemplo de creación de [Campos de fórmula](/l/es/user-guide/workflows/how-tos/crm-automations/formula-fields) usando flujos de trabajo.
</Tip>
Esta guía te acompaña para configurar los campos personalizados y los flujos de trabajo necesarios para calcular y mostrar importes previstos en tu pipeline.
@@ -38,7 +38,7 @@ Necesitas dos campos personalizados en el objeto Oportunidades.
Si no quieres que los usuarios editen manualmente estos campos calculados:
-1. Ve a **Ajustes → Roles**
+1. Ve a **Ajustes → Miembros → Roles**
2. Selecciona el rol a configurar
3. Busca el objeto Oportunidades
4. Establece los campos **Probabilidad** e **Importe previsto** como de solo lectura
@@ -76,7 +76,7 @@ Crea una rama para cada etapa con su probabilidad:
| Cerrado perdido | 0% |
<Note>
- Para crear una nueva rama, haz clic derecho en el lienzo del flujo de trabajo y haz clic en **Nueva acción**. Luego, vincula esta acción al nodo anterior arrastrando la flecha desde el nodo anterior hasta esta nueva acción.
+Para crear una nueva rama, haz clic derecho en el lienzo del flujo de trabajo y haz clic en **Nueva acción**. Luego, vincula esta acción al nodo anterior arrastrando la flecha desde el nodo anterior hasta esta nueva acción.
</Note>
Para cada etapa:
diff --git a/packages/twenty-docs/l/es/user-guide/views-pipelines/how-tos/track-time-in-stage.mdx b/packages/twenty-docs/l/es/user-guide/views-pipelines/how-tos/track-time-in-stage.mdx
index 9269fb8de1d..4ee62d1dc27 100644
--- a/packages/twenty-docs/l/es/user-guide/views-pipelines/how-tos/track-time-in-stage.mdx
+++ b/packages/twenty-docs/l/es/user-guide/views-pipelines/how-tos/track-time-in-stage.mdx
@@ -4,7 +4,7 @@ description: Supervisa la velocidad de las oportunidades registrando cuándo ing
---
<Tip>
- Este es un ejemplo de cómo crear [Campos de fórmula](/l/es/user-guide/workflows/how-tos/crm-automations/formula-fields) usando flujos de trabajo — específicamente cálculos de fechas.
+Este es un ejemplo de cómo crear [Campos de fórmula](/l/es/user-guide/workflows/how-tos/crm-automations/formula-fields) usando flujos de trabajo — específicamente cálculos de fechas.
</Tip>
Registrar cuándo las oportunidades ingresan a cada etapa te ayuda a identificar cuellos de botella y medir la velocidad de las oportunidades.
@@ -54,14 +54,14 @@ Crea estos campos:
* Días en Negociación
<Note>
- No necesitas campos "Días en" para Cerrado ganado y Cerrado perdido, ya que son etapas finales.
+No necesitas campos "Días en" para Cerrado ganado y Cerrado perdido, ya que son etapas finales.
</Note>
### Opcional: Hacer que los campos sean de solo lectura
Si no quieres que los usuarios editen manualmente estos campos calculados:
-1. Ve a **Ajustes → Roles**
+1. Ve a **Ajustes → Miembros → Roles**
2. Selecciona el rol que deseas configurar
3. Busca el objeto Oportunidades
4. Configura los campos "Última entrada" y "Días en" como de solo lectura
@@ -88,7 +88,7 @@ Este único flujo de trabajo gestiona ambas tareas:
### Agrega ramas para cada etapa
<Note>
- Para crear una nueva rama, haz clic derecho en el lienzo del flujo de trabajo y haz clic en **Nueva acción**. Luego, vincula esta acción al nodo anterior arrastrando la flecha desde el nodo anterior hasta esta nueva acción.
+Para crear una nueva rama, haz clic derecho en el lienzo del flujo de trabajo y haz clic en **Nueva acción**. Luego, vincula esta acción al nodo anterior arrastrando la flecha desde el nodo anterior hasta esta nueva acción.
</Note>
---
diff --git a/packages/twenty-docs/l/es/user-guide/views-pipelines/overview.mdx b/packages/twenty-docs/l/es/user-guide/views-pipelines/overview.mdx
index 0b2be25e9de..c4c880dbf80 100644
--- a/packages/twenty-docs/l/es/user-guide/views-pipelines/overview.mdx
+++ b/packages/twenty-docs/l/es/user-guide/views-pipelines/overview.mdx
@@ -5,7 +5,6 @@ description: Aprende a crear y gestionar vistas en Twenty.
import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
-
## Comprender las vistas
Las vistas son configuraciones guardadas que determinan cómo se muestran tus datos. Cada vista puede tener sus propios:
@@ -106,7 +105,7 @@ Fija las vistas que usas con frecuencia para un acceso rápido:
5. Confirma la eliminación
<Warning>
- Las vistas eliminadas no se pueden recuperar. Asegúrate de que deseas eliminarla antes de confirmar.
+Las vistas eliminadas no se pueden recuperar. Asegúrate de que deseas eliminarla antes de confirmar.
</Warning>
## Visibilidad de la vista
@@ -122,7 +121,7 @@ Para cambiar la visibilidad:
* **No listado**: Visible solo para ti
<Note>
- No se puede cambiar la visibilidad de las vistas predeterminadas "All [Object Name]".
+No se puede cambiar la visibilidad de las vistas predeterminadas "All [Object Name]".
</Note>
## Próximos Pasos
diff --git a/packages/twenty-docs/l/es/user-guide/workflows/capabilities/send-emails-from-workflows.mdx b/packages/twenty-docs/l/es/user-guide/workflows/capabilities/send-emails-from-workflows.mdx
index b125274291c..f3e2f3f1ee8 100644
--- a/packages/twenty-docs/l/es/user-guide/workflows/capabilities/send-emails-from-workflows.mdx
+++ b/packages/twenty-docs/l/es/user-guide/workflows/capabilities/send-emails-from-workflows.mdx
@@ -135,7 +135,7 @@ Puedes adjuntar archivos a los correos electrónicos enviados desde los flujos d
| **Confirmaciones de eventos** | Detalles o agenda del evento |
<Note>
- Los archivos adjuntos son estáticos—se envía el mismo archivo a todos los destinatarios. Para documentos dinámicos (como presupuestos personalizados), genera y adjunta archivos usando una [Función lógica](/l/es/user-guide/workflows/how-tos/connect-to-other-tools/generate-pdf-from-twenty).
+Los archivos adjuntos son estáticos—se envía el mismo archivo a todos los destinatarios. Para documentos dinámicos (como presupuestos personalizados), genera y adjunta archivos usando una [Función lógica](/l/es/user-guide/workflows/how-tos/connect-to-other-tools/generate-pdf-from-twenty).
</Note>
## Mejores prácticas
diff --git a/packages/twenty-docs/l/es/user-guide/workflows/capabilities/use-branches-in-workflows.mdx b/packages/twenty-docs/l/es/user-guide/workflows/capabilities/use-branches-in-workflows.mdx
index 418ba913fc7..98e6227c350 100644
--- a/packages/twenty-docs/l/es/user-guide/workflows/capabilities/use-branches-in-workflows.mdx
+++ b/packages/twenty-docs/l/es/user-guide/workflows/capabilities/use-branches-in-workflows.mdx
@@ -42,7 +42,7 @@ Ambas ramas se inician, pero solo la que coincida con el importe del negocio con
## Creación de ramas
<Note>
- Para crear una nueva rama a partir de un paso existente, haz clic en el botón **+** del paso y agrega tu acción. Puedes añadir varias ramas haciendo clic en **+** varias veces.
+Para crear una nueva rama a partir de un paso existente, haz clic en el botón **+** del paso y agrega tu acción. Puedes añadir varias ramas haciendo clic en **+** varias veces.
</Note>
1. En el editor de flujos de trabajo, selecciona el paso desde el que quieres ramificar
diff --git a/packages/twenty-docs/l/es/user-guide/workflows/capabilities/workflow-actions.mdx b/packages/twenty-docs/l/es/user-guide/workflows/capabilities/workflow-actions.mdx
index 2037983cd39..02ba4890597 100644
--- a/packages/twenty-docs/l/es/user-guide/workflows/capabilities/workflow-actions.mdx
+++ b/packages/twenty-docs/l/es/user-guide/workflows/capabilities/workflow-actions.mdx
@@ -10,9 +10,9 @@ import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
Las acciones definen lo que ocurre después de que se dispara un activador. Puedes encadenar varias acciones para crear automatizaciones complejas.
<Tip>
- * Usa el selector de variables (haz clic en el icono `(x+)`) para explorar los datos disponibles de pasos anteriores
- * Pasa el cursor sobre cualquier campo de entrada para ver de qué paso proviene una variable — útil cuando el mismo campo (p. ej., ID) existe en varios pasos anteriores
- * Asigna a cada acción un nombre descriptivo para facilitar el mantenimiento
+* Usa el selector de variables (haz clic en el icono `(x+)`) para explorar los datos disponibles de pasos anteriores
+* Pasa el cursor sobre cualquier campo de entrada para ver de qué paso proviene una variable — útil cuando el mismo campo (p. ej., ID) existe en varios pasos anteriores
+* Asigna a cada acción un nombre descriptivo para facilitar el mantenimiento
</Tip>
## Acciones con registros
@@ -71,7 +71,7 @@ Encuentra registros dentro de un objeto seleccionado usando condiciones de filtr
**Salida**: Devuelve registros coincidentes que se pueden usar en pasos posteriores.
<Note>
- **Límite**: Search Records devuelve un máximo de **200 registros**. Si necesitas procesar más, añade filtros específicos para reducir los resultados o utiliza flujos de trabajo programados para procesar por lotes.
+**Límite**: Search Records devuelve un máximo de **200 registros**. Si necesitas procesar más, añade filtros específicos para reducir los resultados o utiliza flujos de trabajo programados para procesar por lotes.
</Note>
**Mejor práctica**: Usa [ramas](/l/es/user-guide/workflows/capabilities/workflow-branches) después de Search Records para manejar escenarios de "encontrado" vs "no encontrado".
@@ -89,7 +89,7 @@ Crea un registro nuevo o actualiza uno existente según criterios de coincidenci
* Completa los valores de los campos. No olvides completar al menos uno de los identificadores únicos.
<Note>
- **La coincidencia suele funcionar aún mejor al agregar solo un identificador único.** Por ejemplo, la captura de pantalla a continuación hará coincidir empresas según su dominio. El ID no es estrictamente necesario.
+**La coincidencia suele funcionar aún mejor al agregar solo un identificador único.** Por ejemplo, la captura de pantalla a continuación hará coincidir empresas según su dominio. El ID no es estrictamente necesario.
</Note>
<img src="/images/user-guide/workflows/upsert_simple_identifier.png" style={{width:'100%'}} />
@@ -116,8 +116,8 @@ Crea un registro nuevo o actualiza uno existente según criterios de coincidenci
* Defina las acciones a realizar en cada registro en el bucle.
<Note>
- - Puede añadir varias acciones dentro de un iterador.
- - Al usar ramas dentro de un iterador, asegúrese de que el último paso de cada rama se conecte de nuevo al iterador para cerrar el bucle.
+- Puede añadir varias acciones dentro de un iterador.
+- Al usar ramas dentro de un iterador, asegúrese de que el último paso de cada rama se conecte de nuevo al iterador para cerrar el bucle.
</Note>
* Acceda a los campos de `Elemento actual`: para usar campos del registro que se está procesando, haga clic en el paso **Iterador** y luego seleccione **Elemento actual**. Se mostrará la lista de campos disponibles de ese registro y podrá seleccionarlos para usarlos en acciones posteriores.
@@ -135,8 +135,8 @@ Filtra registros según condiciones especificadas, permitiendo que solo los regi
* Configure qué registros deben pasar a pasos posteriores
<Note>
- 1. **Salida**: Los nodos de filtro no devuelven datos—actúan como compuertas. Si se cumplen las condiciones, el flujo de trabajo continúa. Si no, el flujo de trabajo se detiene en esa rama.
- 2. El operador `IS` se puede usar con campos numéricos. Funciona como un `EQUAL`.
+1. **Salida**: Los nodos de filtro no devuelven datos—actúan como compuertas. Si se cumplen las condiciones, el flujo de trabajo continúa. Si no, el flujo de trabajo se detiene en esa rama.
+2. El operador `IS` se puede usar con campos numéricos. Funciona como un `EQUAL`.
</Note>
### Retraso
@@ -167,7 +167,7 @@ Pausa la ejecución del flujo de trabajo durante una duración especificada o ha
* Programar acciones para el horario laboral
<Note>
- La fecha programada no puede estar en el pasado. Si se usa un campo de fecha de un paso anterior y la fecha ya ha pasado, el flujo de trabajo fallará.
+La fecha programada no puede estar en el pasado. Si se usa un campo de fecha de un paso anterior y la fecha ya ha pasado, el flujo de trabajo fallará.
</Note>
**Límites y créditos**:
@@ -190,7 +190,7 @@ No es adecuado para boletines (que requieren un formato más rico) ni para secue
* Seleccione la cuenta de correo del remitente
<Note>
- Solo puede enviar correos desde buzones sincronizados con su propia cuenta de Twenty. El envío desde los buzones de otros miembros del equipo (p. ej., el correo del propietario de la cuenta) está en la hoja de ruta.
+Solo puede enviar correos desde buzones sincronizados con su propia cuenta de Twenty. El envío desde los buzones de otros miembros del equipo (p. ej., el correo del propietario de la cuenta) está en la hoja de ruta.
</Note>
En todos los pasos siguientes, puede hacer referencia a variables de pasos anteriores para la personalización.
@@ -198,14 +198,14 @@ En todos los pasos siguientes, puede hacer referencia a variables de pasos anter
* Ingrese la dirección de correo electrónico del destinatario.
<Note>
- Por el momento, solo es posible un destinatario.
+Por el momento, solo es posible un destinatario.
</Note>
* Establezca la línea de asunto.
* Redacte el cuerpo del mensaje. Puede formatear enlaces, crear listas numeradas, listas con viñetas y añadir archivos adjuntos.
<Note>
- No es posible agregar firmas HTML por el momento.
+No es posible agregar firmas HTML por el momento.
</Note>
### Formulario
@@ -213,7 +213,7 @@ En todos los pasos siguientes, puede hacer referencia a variables de pasos anter
Solicita un formulario durante la ejecución del flujo de trabajo para recopilar la entrada del usuario. Las respuestas pueden usarse luego en pasos posteriores para crear registros, enviar correos o ejecutar cualquier otra acción según la entrada.
<Warning>
- **Los formularios están diseñados solo para disparadores manuales**. Para flujos de trabajo con otros disparadores (Registro Creado, Actualizado, etc.), los formularios solo son accesibles a través de la interfaz de ejecución de flujos de trabajo, lo cual no es la experiencia de usuario esperada. Un centro de notificaciones se lanzará en 2026 para soportar adecuadamente los formularios en flujos de trabajo automatizados.
+**Los formularios están diseñados solo para disparadores manuales**. Para flujos de trabajo con otros disparadores (Registro Creado, Actualizado, etc.), los formularios solo son accesibles a través de la interfaz de ejecución de flujos de trabajo, lo cual no es la experiencia de usuario esperada. Un centro de notificaciones se lanzará en 2026 para soportar adecuadamente los formularios en flujos de trabajo automatizados.
</Warning>
**Configuración**:
@@ -234,7 +234,7 @@ Solicita un formulario durante la ejecución del flujo de trabajo para recopilar
* Complete el formulario que se muestra en el panel lateral y haga clic en `Submit`.
<Note>
- Los campos no se pueden hacer obligatorios.
+Los campos no se pueden hacer obligatorios.
</Note>
<VimeoEmbed videoId="1147277989" title="Demostración en video" />
@@ -256,15 +256,15 @@ Ejecuta JavaScript personalizado dentro de su flujo de trabajo.
* Pruebe el código directamente en el paso
<Note>
- Si necesita usar claves de API externas en su código, debe introducirlas directamente en el cuerpo de la función. No puede configurar claves de API en otro lugar y hacer referencia a ellas en la función lógica.
+Si necesita usar claves de API externas en su código, debe introducirlas directamente en el cuerpo de la función. No puede configurar claves de API en otro lugar y hacer referencia a ellas en la función lógica.
</Note>
<Tip>
- **¿Trabaja con arrays?** Los arrays de sistemas externos o de pasos anteriores pueden venir como cadenas. Consulte [Cómo manejar arrays en acciones de código](/l/es/user-guide/workflows/how-tos/advanced-configurations/handle-arrays-in-code-actions) para la solución.
+**¿Trabaja con arrays?** Los arrays de sistemas externos o de pasos anteriores pueden venir como cadenas. Consulte [Cómo manejar arrays en acciones de código](/l/es/user-guide/workflows/how-tos/advanced-configurations/handle-arrays-in-code-actions) para la solución.
</Tip>
<Tip>
- Haga clic en el icono cuadrado en la parte superior derecha del editor de código para mostrarlo en pantalla completa — es útil, ya que el ancho predeterminado del editor es limitado.
+Haga clic en el icono cuadrado en la parte superior derecha del editor de código para mostrarlo en pantalla completa — es útil, ya que el ancho predeterminado del editor es limitado.
</Tip>
### Solicitud HTTP
@@ -303,9 +303,9 @@ Ejecuta un agente de IA dentro de su flujo de trabajo para realizar tareas intel
**Salida**: La respuesta del agente de IA está disponible para su uso en pasos posteriores. Si el agente tiene un esquema de salida estructurado, la respuesta seguirá ese formato.
<Note>
- Las acciones del agente de IA consumen créditos de flujo de trabajo según el modelo de IA utilizado. Consulte [Créditos de flujo de trabajo](/l/es/user-guide/workflows/capabilities/workflow-credits) para obtener detalles.
+Las acciones del agente de IA consumen créditos de flujo de trabajo según el modelo de IA utilizado. Consulte [Créditos de flujo de trabajo](/l/es/user-guide/workflows/capabilities/workflow-credits) para obtener detalles.
</Note>
<Note>
- Los agentes de IA respetan los permisos basados en roles. Puede asignar roles específicos a los agentes en **Configuración → Roles** para controlar a qué datos pueden acceder. Consulte [Permisos](/l/es/user-guide/permissions-access/capabilities/permissions) para obtener detalles.
+Los agentes de IA respetan los permisos basados en roles. Puede asignar roles específicos a los agentes en **Configuración → Miembros → Roles** para controlar a qué datos pueden acceder. Consulte [Permisos](/l/es/user-guide/permissions-access/capabilities/permissions) para obtener detalles.
</Note>
diff --git a/packages/twenty-docs/l/es/user-guide/workflows/capabilities/workflow-branches.mdx b/packages/twenty-docs/l/es/user-guide/workflows/capabilities/workflow-branches.mdx
index 8680e51cbd2..04ea9659b3d 100644
--- a/packages/twenty-docs/l/es/user-guide/workflows/capabilities/workflow-branches.mdx
+++ b/packages/twenty-docs/l/es/user-guide/workflows/capabilities/workflow-branches.mdx
@@ -1,5 +1,5 @@
---
-title: Ramas del flujo de trabajo},{
+title: Ramas del flujo de trabajo
description: Crea rutas paralelas y lógica condicional en tus flujos de trabajo.
---
@@ -22,7 +22,7 @@ Cuando creas varias conexiones desde un único nodo, cada ruta se convierte en u
5. Repite para añadir más ramas desde el mismo nodo
<Note>
- Cada rama es independiente. Añadir una rama no afecta a otras rutas existentes desde ese nodo.
+Cada rama es independiente. Añadir una rama no afecta a otras rutas existentes desde ese nodo.
</Note>
### Diseño visual
@@ -57,7 +57,7 @@ Solo continuarán ejecutándose las ramas en las que se cumpla la condición del
Al crear tu flujo de trabajo, puedes conectar manualmente varias ramas a la misma acción posterior. Simplemente arrastra flechas desde el final de cada rama hasta un nodo común.
<Note>
- Aunque puedes usar un nodo [Delay](/l/es/user-guide/workflows/capabilities/workflow-actions#delay) para pausar la ejecución, actualmente no se puede configurar para esperar "hasta que otra rama termine".
+Aunque puedes usar un nodo [Delay](/l/es/user-guide/workflows/capabilities/workflow-actions#delay) para pausar la ejecución, actualmente no se puede configurar para esperar "hasta que otra rama termine".
</Note>
## Relacionado
diff --git a/packages/twenty-docs/l/es/user-guide/workflows/capabilities/workflow-credits.mdx b/packages/twenty-docs/l/es/user-guide/workflows/capabilities/workflow-credits.mdx
index 0e4ae5a7bc6..17900795c65 100644
--- a/packages/twenty-docs/l/es/user-guide/workflows/capabilities/workflow-credits.mdx
+++ b/packages/twenty-docs/l/es/user-guide/workflows/capabilities/workflow-credits.mdx
@@ -9,13 +9,13 @@ Los créditos de workflow potencian tus automatizaciones en Twenty. Comprender c
Los créditos de flujo de trabajo se asignan según tu ciclo de facturación, no según tu nivel de plan:
-| Ciclo de facturación | Créditos |
-| ----------------------- | ------------------------------- |
-| **Suscripción mensual** | 5 millones de créditos por mes |
-| **Suscripción anual** | 50 millones de créditos por año |
+| Ciclo de facturación | Créditos |
+| ----------------------- | ------------------- |
+| **Suscripción mensual** | 5 créditos por mes |
+| **Suscripción anual** | 50 créditos por año |
<Note>
- 5 millones de créditos mensuales son generosos para las automatizaciones estándar. La mayoría de los equipos no superarán este límite con un uso típico de flujos de trabajo. Los créditos adicionales se necesitan principalmente para acciones avanzadas de Code y flujos de trabajo impulsados por IA.
+5 créditos mensuales son generosos para las automatizaciones estándar. La mayoría de los equipos no superarán este límite con un uso típico de flujos de trabajo. Los créditos adicionales se necesitan principalmente para acciones avanzadas de Code y flujos de trabajo impulsados por IA.
</Note>
## Cómo Funciona el Consumo de Créditos
diff --git a/packages/twenty-docs/l/es/user-guide/workflows/capabilities/workflow-triggers.mdx b/packages/twenty-docs/l/es/user-guide/workflows/capabilities/workflow-triggers.mdx
index 2778726b211..6897318b43a 100644
--- a/packages/twenty-docs/l/es/user-guide/workflows/capabilities/workflow-triggers.mdx
+++ b/packages/twenty-docs/l/es/user-guide/workflows/capabilities/workflow-triggers.mdx
@@ -10,14 +10,13 @@ Los flujos de trabajo siempre comienzan con un solo disparador que define cuánd
<img src="/images/user-guide/workflows/workflow_triggers.png" style={{width:'100%'}} />
<Tip>
- **¡Se admiten objetos avanzados!** Más allá de los objetos estándar de CRM (Personas, Empresas, Oportunidades), también puedes activar flujos de trabajo y ejecutar acciones sobre:
+**¡Se admiten objetos avanzados!** Más allá de los objetos estándar de CRM (Personas, Empresas, Oportunidades), también puedes activar flujos de trabajo y ejecutar acciones sobre:
+* Miembros del espacio de trabajo
+* Eventos del calendario
+* Mensajes (correos electrónicos)
+* Tareas, notas y muchos otros objetos del sistema
- * Miembros del espacio de trabajo
- * Eventos del calendario
- * Mensajes (correos electrónicos)
- * Tareas, notas y muchos otros objetos del sistema
-
- Esto abre potentes automatizaciones como notificar a los miembros del equipo cuando se crean eventos del calendario o procesar automáticamente los correos electrónicos entrantes.
+Esto abre potentes automatizaciones como notificar a los miembros del equipo cuando se crean eventos del calendario o procesar automáticamente los correos electrónicos entrantes.
</Tip>
## Se crea un registro
@@ -27,9 +26,9 @@ Inicia el flujo de trabajo cuando se crea un nuevo registro en un objeto selecci
**Configuración**: Selecciona el tipo de objeto para monitorear nuevos registros.
<Note>
- * Este activador es ideal para registros creados por CSV, sincronización de buzón y de calendario, o API.
- * **No se recomienda para registros creados manualmente**: con este activador, los flujos de trabajo comienzan tan pronto como se crea el registro. Dado que Twenty UI ofrece guardado automático sobre la marcha (no hay un modo de edición y luego una validación para guardar registros), el flujo de trabajo se activará antes de que el usuario complete todos los campos.
- Para activar este flujo de trabajo en registros creados manualmente, se recomienda usar el activador `Record is created or updated` en su lugar.
+* Este activador es ideal para registros creados por CSV, sincronización de buzón y de calendario, o API.
+* **No se recomienda para registros creados manualmente**: con este activador, los flujos de trabajo comienzan tan pronto como se crea el registro. Dado que Twenty UI ofrece guardado automático sobre la marcha (no hay un modo de edición y luego una validación para guardar registros), el flujo de trabajo se activará antes de que el usuario complete todos los campos.
+ Para activar este flujo de trabajo en registros creados manualmente, se recomienda usar el activador `Record is created or updated` en su lugar.
</Note>
## Se actualiza un registro
@@ -82,7 +81,7 @@ Elige cómo debe manejar el flujo de trabajo la selección de registros:
* **En masa**: El/los registro(s) seleccionado(s) se pasará(n) a tu flujo de trabajo. Esto está configurado para un objeto dado. Se pueden seleccionar varios registros antes de iniciar el flujo de trabajo. El flujo de trabajo se ejecutará una vez, proporcionando como entrada toda la lista de registros. Esto significa que el flujo de trabajo debe contener una [Acción Iterator](/l/es/user-guide/workflows/capabilities/workflow-actions#iterator).
<Note>
- Esto es más avanzado y es ideal para quienes quieren optimizar la cantidad de ejecuciones del flujo de trabajo.
+Esto es más avanzado y es ideal para quienes quieren optimizar la cantidad de ejecuciones del flujo de trabajo.
</Note>
<img src="/images/user-guide/workflows/manual_trigger.png" style={{width:'100%'}} />
@@ -108,7 +107,7 @@ Inicia el flujo de trabajo de forma recurrente según lo defina.
* Ingresa un valor o usa expresiones cron personalizadas para una programación avanzada
<Note>
- **Zona horaria**: Los flujos de trabajo programados se ejecutan en **UTC**. Al configurar las horas para programaciones diarias, convierte tu hora local a UTC.
+**Zona horaria**: Los flujos de trabajo programados se ejecutan en **UTC**. Al configurar las horas para programaciones diarias, convierte tu hora local a UTC.
</Note>
## Activador externo: Webhook
diff --git a/packages/twenty-docs/l/es/user-guide/workflows/how-tos/advanced-configurations/handle-arrays-in-code-actions.mdx b/packages/twenty-docs/l/es/user-guide/workflows/how-tos/advanced-configurations/handle-arrays-in-code-actions.mdx
index db0f1efdfff..f2c2ce1dc69 100644
--- a/packages/twenty-docs/l/es/user-guide/workflows/how-tos/advanced-configurations/handle-arrays-in-code-actions.mdx
+++ b/packages/twenty-docs/l/es/user-guide/workflows/how-tos/advanced-configurations/handle-arrays-in-code-actions.mdx
@@ -74,9 +74,9 @@ export const main = async (params: {
El nodo Code devuelve un objeto estructurado en lugar de un array. En los pasos posteriores, ahora puedes seleccionar campos individuales como `answer.firstname` y `answer.name` desde el selector de variables.
<Note>
- Estamos trabajando activamente para facilitar el manejo de arrays en futuras actualizaciones.
+Estamos trabajando activamente para facilitar el manejo de arrays en futuras actualizaciones.
</Note>
<Tip>
- Haz clic en el icono cuadrado en la parte superior derecha del editor de código para mostrarlo en pantalla completa — es útil, ya que el ancho predeterminado del editor es limitado.
+Haz clic en el icono cuadrado en la parte superior derecha del editor de código para mostrarlo en pantalla completa — es útil, ya que el ancho predeterminado del editor es limitado.
</Tip>
diff --git a/packages/twenty-docs/l/es/user-guide/workflows/how-tos/connect-to-other-tools/bring-product-data-in-twenty.mdx b/packages/twenty-docs/l/es/user-guide/workflows/how-tos/connect-to-other-tools/bring-product-data-in-twenty.mdx
index 5c398e32e19..df296050f92 100644
--- a/packages/twenty-docs/l/es/user-guide/workflows/how-tos/connect-to-other-tools/bring-product-data-in-twenty.mdx
+++ b/packages/twenty-docs/l/es/user-guide/workflows/how-tos/connect-to-other-tools/bring-product-data-in-twenty.mdx
@@ -54,7 +54,7 @@ export const main = async () => {
```
<Tip>
- Filtra por `updated_at >= last X minutes` para recuperar solo los registros cambiados recientemente. Esto mantiene la sincronización eficiente.
+Filtra por `updated_at >= last X minutes` para recuperar solo los registros cambiados recientemente. Esto mantiene la sincronización eficiente.
</Tip>
## Paso 3: Formatear los datos (opcional)
@@ -163,7 +163,7 @@ Dentro del iterador, añade una acción **Upsert Record**:
| **Precio** | `{{iterator.item.price}}` |
<Tip>
- Usa **Upsert** (actualizar o crear) en lugar de construir ramas separadas para crear frente a actualizar. Es más rápido de construir y más fácil de depurar.
+Usa **Upsert** (actualizar o crear) en lugar de construir ramas separadas para crear frente a actualizar. Es más rápido de construir y más fácil de depurar.
</Tip>
## Casos de uso de ejemplo
diff --git a/packages/twenty-docs/l/es/user-guide/workflows/how-tos/connect-to-other-tools/bring-typeform-submissions-in-twenty.mdx b/packages/twenty-docs/l/es/user-guide/workflows/how-tos/connect-to-other-tools/bring-typeform-submissions-in-twenty.mdx
index 8481622ae8e..80e9f5144d0 100644
--- a/packages/twenty-docs/l/es/user-guide/workflows/how-tos/connect-to-other-tools/bring-typeform-submissions-in-twenty.mdx
+++ b/packages/twenty-docs/l/es/user-guide/workflows/how-tos/connect-to-other-tools/bring-typeform-submissions-in-twenty.mdx
@@ -103,7 +103,7 @@ export const main = async (params: {
Ahora, en los pasos posteriores, puedes seleccionar `contact.firstName`, `contact.email`, etc., desde el selector de variables.
<Tip>
- Para más detalles sobre cómo manejar arreglos en acciones de código, consulta [Cómo manejar arreglos en acciones de código](/l/es/user-guide/workflows/how-tos/advanced-configurations/handle-arrays-in-code-actions).
+Para más detalles sobre cómo manejar arreglos en acciones de código, consulta [Cómo manejar arreglos en acciones de código](/l/es/user-guide/workflows/how-tos/advanced-configurations/handle-arrays-in-code-actions).
</Tip>
### Paso 5: Crear el registro
diff --git a/packages/twenty-docs/l/es/user-guide/workflows/how-tos/connect-to-other-tools/generate-pdf-from-twenty.mdx b/packages/twenty-docs/l/es/user-guide/workflows/how-tos/connect-to-other-tools/generate-pdf-from-twenty.mdx
index baf38b952de..93d8b253ec7 100644
--- a/packages/twenty-docs/l/es/user-guide/workflows/how-tos/connect-to-other-tools/generate-pdf-from-twenty.mdx
+++ b/packages/twenty-docs/l/es/user-guide/workflows/how-tos/connect-to-other-tools/generate-pdf-from-twenty.mdx
@@ -29,7 +29,7 @@ Antes de configurar el flujo de trabajo:
3. Elija el objeto al que desea adjuntar archivos PDF (p. ej., **Empresa** u **Oportunidad**)
<Tip>
- Con un Activador manual, los usuarios pueden ejecutar este flujo de trabajo usando un botón que aparece en la parte superior derecha una vez que se selecciona un registro, para generar y adjuntar un PDF.
+Con un Activador manual, los usuarios pueden ejecutar este flujo de trabajo usando un botón que aparece en la parte superior derecha una vez que se selecciona un registro, para generar y adjuntar un PDF.
</Tip>
### Paso 2: Añadir una Función de lógica
@@ -45,7 +45,7 @@ Antes de configurar el flujo de trabajo:
| `companyId` | `{{trigger.object.id}}` |
<Note>
- Si va a adjuntar a un objeto diferente (Persona, Oportunidad, etc.), cambie el nombre del parámetro en consecuencia (p. ej., `personId`, `opportunityId`) y actualice la función de lógica.
+Si va a adjuntar a un objeto diferente (Persona, Oportunidad, etc.), cambie el nombre del parámetro en consecuencia (p. ej., `personId`, `opportunityId`) y actualice la función de lógica.
</Note>
#### Código de la Función de lógica
@@ -55,11 +55,12 @@ export const main = async (
params: { companyId: string },
) => {
const { companyId } = params;
-
- // Replace with your Twenty GraphQL endpoint
+ // Replace with your Twenty GraphQL endpoints (/metadata for metadata and files or /graphql for your records)
// Cloud: https://api.twenty.com/graphql
// Self-hosted: https://your-domain.com/graphql
- const graphqlEndpoint = 'https://api.twenty.com/graphql';
+
+ const metadataGraphqlEndpoint = 'https://api.twenty.com/metadata';
+ const dataGraphqlEndpoint = 'https://api.twenty.com/graphql';
// Replace with your API key from Settings → APIs
const authToken = 'YOUR_API_KEY';
@@ -79,11 +80,40 @@ export const main = async (
const pdfBlob = await pdfResponse.blob();
const pdfFile = new File([pdfBlob], filename, { type: 'application/pdf' });
- // Step 2: Upload the file via GraphQL multipart upload
+ const fieldMetadataIdQuery = `
+ query FindUploadFileFieldMetadataId {
+ objects {
+ edges {
+ node {
+ nameSingular
+ fieldsList {
+ id
+ name
+ }
+ }
+ }
+ }
+ }
+ `;
+
+ // Step 2: Find a fieldMetadataId of "Attachment file" field in Attachments object with GraphQL API
+ const response = await fetch(metadataGraphqlEndpoint, {
+ method: 'POST',
+ headers: {
+ Authorization: `Bearer ${authToken}`
+ },
+ body: {
+ query: fieldMetadataIdQuery,
+ }
+ });
+ const result = await response.json();
+ const uploadFileFieldMetadataId = result.data.objects.edges.find(object => object.node.nameSingular === 'attachment').node.fieldsList.find(field => field.name === 'file').id;
+
+ // Step 3: Upload the file via GraphQL multipart upload
const uploadMutation = `
- mutation UploadFile($file: Upload!, $fileFolder: FileFolder) {
- uploadFile(file: $file, fileFolder: $fileFolder) {
- path
+ mutation UploadFilesFieldFile($file: Upload!, $fieldMetadataId: String!) {
+ uploadFilesFieldFile(file: $file, fieldMetadataId: $fieldMetadataId) {
+ id
}
}
`;
@@ -91,12 +121,12 @@ export const main = async (
const uploadForm = new FormData();
uploadForm.append('operations', JSON.stringify({
query: uploadMutation,
- variables: { file: null, fileFolder: 'Attachment' },
+ variables: { file: null, fieldMetadataId: uploadFileFieldMetadataId },
}));
uploadForm.append('map', JSON.stringify({ '0': ['variables.file'] }));
uploadForm.append('0', pdfFile);
- const uploadResponse = await fetch(graphqlEndpoint, {
+ const uploadResponse = await fetch(metadataGraphqlEndpoint, {
method: 'POST',
headers: { Authorization: `Bearer ${authToken}` },
body: uploadForm,
@@ -108,15 +138,15 @@ export const main = async (
throw new Error(`Upload failed: ${uploadResult.errors[0].message}`);
}
- const filePath = uploadResult.data?.uploadFile?.path;
+ const fileId = uploadResult.data?.uploadFilesFieldFile?.id;
- if (!filePath) {
- throw new Error('No file path returned from upload');
+ if (!fileId) {
+ throw new Error('No file id returned from upload');
}
- // Step 3: Create the attachment linked to the company
+ // Step 4: Create the attachment linked to the company
const attachmentMutation = `
- mutation CreateAttachment($data: AttachmentCreateInput!) {
+ mutation CreateOneAttachment($data: AttachmentCreateInput!) {
createAttachment(data: $data) {
id
name
@@ -124,7 +154,7 @@ export const main = async (
}
`;
- const attachmentResponse = await fetch(graphqlEndpoint, {
+ const attachmentResponse = await fetch(dataGraphqlEndpoint, {
method: 'POST',
headers: {
Authorization: `Bearer ${authToken}`,
@@ -135,8 +165,13 @@ export const main = async (
variables: {
data: {
name: filename,
- fullPath: filePath,
- companyId,
+ targetCompanyId: companyId,
+ file: [
+ {
+ fileId: fileId,
+ label: filename
+ }
+ ]
},
},
}),
@@ -156,14 +191,14 @@ export const main = async (
#### Para adjuntar a un objeto diferente
-Reemplace `companyId` por el campo correspondiente:
+Reemplace `targetCompanyId` por el campo correspondiente:
-| Objeto | Nombre del campo |
-| -------------------- | -------------------- |
-| Empresa | `companyId` |
-| Persona | `personId` |
-| Oportunidad | `opportunityId` |
-| Objeto personalizado | `yourCustomObjectId` |
+| Objeto | Nombre del campo |
+| -------------------- | -------------------------- |
+| Empresa | `targetCompanyId` |
+| Persona | `targetPersonId` |
+| Oportunidad | `targetOpportunityId` |
+| Objeto personalizado | `targetYourCustomObjectId` |
Actualice tanto el parámetro de la función como el objeto `variables.data` en la mutación de adjunto.
diff --git a/packages/twenty-docs/l/es/user-guide/workflows/how-tos/connect-to-other-tools/generate-quote-or-invoice-from-twenty.mdx b/packages/twenty-docs/l/es/user-guide/workflows/how-tos/connect-to-other-tools/generate-quote-or-invoice-from-twenty.mdx
index 03a3c651782..8ef2828e722 100644
--- a/packages/twenty-docs/l/es/user-guide/workflows/how-tos/connect-to-other-tools/generate-quote-or-invoice-from-twenty.mdx
+++ b/packages/twenty-docs/l/es/user-guide/workflows/how-tos/connect-to-other-tools/generate-quote-or-invoice-from-twenty.mdx
@@ -30,7 +30,7 @@ Añade una acción **Filter** para continuar solo cuando la oportunidad esté ga
| **Valor** | `CLOSED_WON` (o el nombre de tu etapa) |
<Tip>
- El disparador se activa con cualquier actualización de una Oportunidad. El filtro garantiza que el flujo de trabajo solo continúe cuando la etapa cambie a Cerrado ganado.
+El disparador se activa con cualquier actualización de una Oportunidad. El filtro garantiza que el flujo de trabajo solo continúe cuando la etapa cambie a Cerrado ganado.
</Tip>
## Paso 3: Obtener detalles de la empresa
diff --git a/packages/twenty-docs/l/es/user-guide/workflows/how-tos/connect-to-other-tools/set-up-a-webhook-trigger.mdx b/packages/twenty-docs/l/es/user-guide/workflows/how-tos/connect-to-other-tools/set-up-a-webhook-trigger.mdx
index ba88d7f13b6..e158e75e5f7 100644
--- a/packages/twenty-docs/l/es/user-guide/workflows/how-tos/connect-to-other-tools/set-up-a-webhook-trigger.mdx
+++ b/packages/twenty-docs/l/es/user-guide/workflows/how-tos/connect-to-other-tools/set-up-a-webhook-trigger.mdx
@@ -161,7 +161,7 @@ export const main = async (params: { items: any }) => {
Ahora puedes seleccionar `product.name` y `product.qty` individualmente en pasos posteriores.
<Tip>
- Para más detalles sobre cómo manejar arrays, consulta [Cómo manejar arrays en acciones de código](/l/es/user-guide/workflows/how-tos/advanced-configurations/handle-arrays-in-code-actions).
+Para más detalles sobre cómo manejar arrays, consulta [Cómo manejar arrays en acciones de código](/l/es/user-guide/workflows/how-tos/advanced-configurations/handle-arrays-in-code-actions).
</Tip>
## Relacionado
diff --git a/packages/twenty-docs/l/es/user-guide/workflows/how-tos/crm-automations/auto-reply-to-inbound-emails.mdx b/packages/twenty-docs/l/es/user-guide/workflows/how-tos/crm-automations/auto-reply-to-inbound-emails.mdx
new file mode 100644
index 00000000000..fa9689a85b3
--- /dev/null
+++ b/packages/twenty-docs/l/es/user-guide/workflows/how-tos/crm-automations/auto-reply-to-inbound-emails.mdx
@@ -0,0 +1,121 @@
+---
+title: Respuesta automática a correos entrantes
+description: Crea un flujo de trabajo que utilice IA para clasificar los correos entrantes y enviar respuestas en hilo automáticamente.
+---
+
+Responde a los correos entrantes en segundos — no en horas. Este flujo de trabajo utiliza un agente de IA para filtrar el ruido (boletines, spam, respuestas automáticas) y redactar una respuesta personalizada a los mensajes reales, luego la envía como una respuesta en hilo dentro de la conversación original.
+
+## Cómo funcionan los hilos de correo electrónico
+
+Cada correo electrónico lleva un encabezado oculto `Message-ID` — un identificador único asignado por el servidor de correo del remitente. Cuando respondes a un correo electrónico, tu cliente de correo establece un encabezado `In-Reply-To` que hace referencia a esa huella. Así es como Gmail, Outlook y cualquier otro cliente agrupan los mensajes en hilos.
+
+En Twenty, esa huella se almacena como `headerMessageId` en el objeto Message. Tu flujo de trabajo la toma y la pasa al campo In-Reply-To de la acción Send Email.
+
+## Crear el flujo de trabajo
+
+### Paso 1: Crear un nuevo flujo de trabajo
+
+Ve a **Settings -> Workflows** y haz clic en **+ New Workflow**.
+
+### Paso 2: Activar con mensajes entrantes
+
+Selecciona **When a Record is Created** y elige **Messages**.
+
+Cada vez que un correo electrónico llega a Twenty, esto se activa.
+
+<img src="/images/user-guide/workflows/auto-reply/workflow-overview.png" style={{width:'100%'}} />
+
+### Paso 3: Buscar quién lo envió
+
+Añade una acción **Search Records**.
+
+La dirección del remitente no está en el propio mensaje — está en el registro relacionado Message Participant.
+
+| Campo | Valor |
+| ---------- | ------------------------------- |
+| **Objeto** | Participantes del mensaje |
+| **Filtro** | Message **es** `{{trigger.id}}` |
+| **Filtro** | Role **es** From |
+| **Límite** | 1 |
+
+Esto te da el correo electrónico del remitente en `handle` y su nombre en `displayName`.
+
+<img src="/images/user-guide/workflows/auto-reply/find-sender.png" style={{width:'100%'}} />
+
+### Paso 4: Clasificación con IA y borrador de respuesta
+
+Añade una acción **AI Agent**. Este único paso hace dos cosas: decide si el correo merece una respuesta y, en ese caso, redacta una.
+
+Usa un prompt como:
+
+```
+You are an email triage assistant for a sales team. Read the following
+inbound email and decide if it deserves a reply.
+
+Subject: {{trigger.subject}}
+Body: {{trigger.text}}
+From: {{Find Sender.first.displayName}} ({{Find Sender.first.handle}})
+
+If this email is spam, a newsletter, an automated notification, or
+otherwise does not need a human reply, respond with exactly: SKIP
+
+Otherwise, write a short, professional reply (3-4 sentences max) that:
+- Acknowledges their specific message
+- Lets them know someone from the team will follow up shortly
+- Is warm but not overly casual
+
+Respond with only the reply text, no subject line or greeting prefix.
+```
+
+El AI Agent genera su respuesta en un campo `response` que los siguientes pasos pueden consultar.
+
+<img src="/images/user-guide/workflows/auto-reply/ai-triage.png" style={{width:'100%'}} />
+
+### Paso 5: Ramificar según la decisión de la IA
+
+Añade una acción **If/Else** para comprobar si la IA decidió responder u omitir.
+
+| Campo | Valor |
+| ------------------- | ------------------------------------------- |
+| **Condición** | AI Agent `response` **no contiene** `SKIP` |
+| **Si es verdadero** | Continuar con Send Email |
+| **Si no** | No hacer nada (el flujo de trabajo termina) |
+
+El spam, los boletines y los mensajes autogenerados se descartan. Todo lo demás pasa al siguiente paso.
+
+<img src="/images/user-guide/workflows/auto-reply/should-reply.png" style={{width:'100%'}} />
+
+### Paso 6: Enviar una respuesta en hilo
+
+Añade una acción **Send Email** en la rama "si es verdadero". Haz clic en **Advanced options**, y luego en **Add In-Reply-To**.
+
+| Campo | Valor |
+| --------------- | -------------------------------------- |
+| **Para** | `{{Find Sender.first.handle}}` |
+| **Asunto** | `Re: {{trigger.subject}}` |
+| **Cuerpo** | `{{AI Triage & Draft Reply.response}}` |
+| **In-Reply-To** | `{{trigger.headerMessageId}}` |
+
+El campo In-Reply-To es lo que hace que esto sea una respuesta en lugar de una conversación nueva. El destinatario la ve en hilo debajo del correo original en Gmail, Outlook o cualquier otro cliente.
+
+<img src="/images/user-guide/workflows/auto-reply/send-email.png" style={{width:'100%'}} />
+
+<Tip>
+**In-Reply-To** espera un `message.headerMessageId` del disparador — es la huella única del correo, no una dirección del destinatario. Si lo dejas vacío, el correo igualmente se envía, solo que como un mensaje independiente.
+</Tip>
+
+<Warning>
+Gmail usa la línea de asunto para agrupar los mensajes en hilos. El asunto **debe** comenzar con `Re:` (incluidos los dos puntos y el espacio) para que Gmail muestre la respuesta dentro del hilo original. Sin eso, la respuesta aparecerá como una conversación separada — incluso si el encabezado In-Reply-To está configurado correctamente.
+</Warning>
+
+### Paso 7: Probar y activar
+
+Haz clic en **Test** y luego revisa tu cliente de correo. La respuesta debería aparecer anidada debajo del mensaje original.
+
+Actívalo cuando estés satisfecho con el resultado.
+
+## Ideas para ampliar
+
+* **Responder solo a VIPs** — añade una rama que compruebe el dominio del remitente o si existe como Contact en Twenty
+* **Enrutar por intención** — usa prompts de AI Agent separados para tratar las consultas de ventas de forma diferente a las solicitudes de soporte
+* **Enriquecer antes de responder** — añade un paso Search Records para incorporar la empresa del remitente o el historial de oportunidades al prompt de IA para respuestas más personalizadas
diff --git a/packages/twenty-docs/l/es/user-guide/workflows/how-tos/crm-automations/display-number-of-emails-received.mdx b/packages/twenty-docs/l/es/user-guide/workflows/how-tos/crm-automations/display-number-of-emails-received.mdx
index e8a38a16109..894a270795f 100644
--- a/packages/twenty-docs/l/es/user-guide/workflows/how-tos/crm-automations/display-number-of-emails-received.mdx
+++ b/packages/twenty-docs/l/es/user-guide/workflows/how-tos/crm-automations/display-number-of-emails-received.mdx
@@ -30,7 +30,7 @@ Antes de configurar este flujo de trabajo, cree un campo personalizado en el obj
3. Elija **Message Participants** (disponible en objetos avanzados)
<Note>
- Un Message Participant es una combinación de un ID de mensaje y un ID de persona, creando un registro único por mensaje. Esto es más fácil de rastrear que Messages directamente porque podemos acceder al campo `handle`, que contiene la dirección de correo electrónico del remitente (o del destinatario).
+Un Message Participant es una combinación de un ID de mensaje y un ID de persona, creando un registro único por mensaje. Esto es más fácil de rastrear que Messages directamente porque podemos acceder al campo `handle`, que contiene la dirección de correo electrónico del remitente (o del destinatario).
</Note>
### Paso 2: Filtrar por Rol
@@ -50,7 +50,7 @@ Esto garantiza que solo cuente los mensajes enviados por esta persona, no los me
Esto encuentra todos los mensajes de esta dirección de correo electrónico para obtener el recuento total.
<Note>
- La acción Search Records está limitada a devolver un máximo de 200 registros. Sin embargo, dado que solo está utilizando el valor `totalCount` (no los registros individuales), este paso devolverá el número total de correos electrónicos enviados por esta persona.
+La acción Search Records está limitada a devolver un máximo de 200 registros. Sin embargo, dado que solo está utilizando el valor `totalCount` (no los registros individuales), este paso devolverá el número total de correos electrónicos enviados por esta persona.
</Note>
### Paso 4: Actualizar el registro de Person con una acción Create or Update Record
@@ -58,7 +58,7 @@ Esto encuentra todos los mensajes de esta dirección de correo electrónico para
1. Añada una acción **Create or Update Record**
<Warning>
- Utilice **Upsert Record** en lugar de **Update Record** aquí. Esto le permite identificar a la persona por su dirección de correo electrónico (el campo `handle`) en lugar de requerir un ID de registro de un paso anterior.
+Utilice **Upsert Record** en lugar de **Update Record** aquí. Esto le permite identificar a la persona por su dirección de correo electrónico (el campo `handle`) en lugar de requerir un ID de registro de un paso anterior.
</Warning>
2. Seleccione **People** como el objeto
diff --git a/packages/twenty-docs/l/es/user-guide/workflows/how-tos/crm-automations/display-related-record-data.mdx b/packages/twenty-docs/l/es/user-guide/workflows/how-tos/crm-automations/display-related-record-data.mdx
index 503266176ea..5116f88f2fd 100644
--- a/packages/twenty-docs/l/es/user-guide/workflows/how-tos/crm-automations/display-related-record-data.mdx
+++ b/packages/twenty-docs/l/es/user-guide/workflows/how-tos/crm-automations/display-related-record-data.mdx
@@ -95,7 +95,7 @@ Crea los campos de destino en **Configuración → Modelo de datos → Oportunid
* Tamaño de la empresa: `{{searchRecords[0].employees}}`
<Note>
- **Limitación de Tareas y Notas**: Las relaciones en Tareas y Notas están codificadas como de muchos a muchos y aún no están disponibles en los desencadenantes o acciones de flujos de trabajo. Para acceder a estas relaciones, usa la [API](/l/es/developers/api).
+**Limitación de Tareas y Notas**: Las relaciones en Tareas y Notas están codificadas como de muchos a muchos y aún no están disponibles en los desencadenantes o acciones de flujos de trabajo. Para acceder a estas relaciones, usa la [API](/l/es/developers/extend/api).
</Note>
## Sincronización bidireccional
@@ -117,7 +117,7 @@ Crea los campos de destino en **Configuración → Modelo de datos → Oportunid
2. **Actualizar registro**: Establece el Contacto principal de la empresa en esta persona
<Note>
- Ten cuidado con las sincronizaciones bidireccionales para evitar bucles infinitos. Usa filtros para comprobar si el valor realmente cambió antes de actualizar.
+Ten cuidado con las sincronizaciones bidireccionales para evitar bucles infinitos. Usa filtros para comprobar si el valor realmente cambió antes de actualizar.
</Note>
## Uso de código para mapeo complejo
diff --git a/packages/twenty-docs/l/es/user-guide/workflows/how-tos/crm-automations/formula-fields.mdx b/packages/twenty-docs/l/es/user-guide/workflows/how-tos/crm-automations/formula-fields.mdx
index 0efb8b4fb03..1084387dedb 100644
--- a/packages/twenty-docs/l/es/user-guide/workflows/how-tos/crm-automations/formula-fields.mdx
+++ b/packages/twenty-docs/l/es/user-guide/workflows/how-tos/crm-automations/formula-fields.mdx
@@ -16,7 +16,7 @@ Twenty aún no admite campos de fórmula de forma nativa (llegarán en 2026), pe
| **Puntuación del lead** | Puntos basados en varios criterios |
<Tip>
- Para ver un ejemplo completo de seguimiento del tiempo en etapas del pipeline, consulta [Cuánto tiempo permanecen las oportunidades en cada etapa](/l/es/user-guide/views-pipelines/how-tos/track-time-in-stage).
+Para ver un ejemplo completo de seguimiento del tiempo en etapas del pipeline, consulta [Cuánto tiempo permanecen las oportunidades en cada etapa](/l/es/user-guide/views-pipelines/how-tos/track-time-in-stage).
</Tip>
## Fórmula básica: concatenación
@@ -105,7 +105,7 @@ export const main = async (params) => {
3. **Actualizar registro**: Establecer Días hasta el vencimiento en `{{code.daysUntilDue}}`
<Note>
- Los valores negativos indican tareas vencidas. Puedes usar este campo para filtrar o ordenar tareas por urgencia.
+Los valores negativos indican tareas vencidas. Puedes usar este campo para filtrar o ordenar tareas por urgencia.
</Note>
## Fórmula condicional: puntuación del lead
diff --git a/packages/twenty-docs/l/es/user-guide/workflows/how-tos/crm-automations/notify-teammates-of-note-to-review.mdx b/packages/twenty-docs/l/es/user-guide/workflows/how-tos/crm-automations/notify-teammates-of-note-to-review.mdx
index 4e784084867..d8bbdf46e6e 100644
--- a/packages/twenty-docs/l/es/user-guide/workflows/how-tos/crm-automations/notify-teammates-of-note-to-review.mdx
+++ b/packages/twenty-docs/l/es/user-guide/workflows/how-tos/crm-automations/notify-teammates-of-note-to-review.mdx
@@ -6,7 +6,7 @@ description: Enviar notificaciones de correo electrónico automáticas al asigna
import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
<Note>
- **Etiquetar directamente a los compañeros de equipo en las notas aún no está disponible.** Esta función está prevista para la segunda mitad de 2026. Mientras tanto, este flujo de trabajo ofrece una solución alternativa práctica.
+**Etiquetar directamente a los compañeros de equipo en las notas aún no está disponible.** Esta función está prevista para la segunda mitad de 2026. Mientras tanto, este flujo de trabajo ofrece una solución alternativa práctica.
</Note>
## El desafío
@@ -22,7 +22,7 @@ En lugar de etiquetar en el texto de la nota, puede:
3. Un flujo de trabajo envía automáticamente un correo electrónico al revisor con un enlace a la nota
<Warning>
- **Limitación**: Este enfoque permite asignar un revisor por campo. Si necesita notificar a varias personas, cree campos de relación adicionales (p. ej., Reviewer 1, Reviewer 2). Esto no escalará bien si necesita etiquetar a muchos colaboradores a la vez.
+**Limitación**: Este enfoque permite asignar un revisor por campo. Si necesita notificar a varias personas, cree campos de relación adicionales (p. ej., Reviewer 1, Reviewer 2). Esto no escalará bien si necesita etiquetar a muchos colaboradores a la vez.
</Warning>
## Configuración paso a paso
@@ -101,7 +101,7 @@ Twenty
```
<Note>
- Reemplace `yourSubDomain` por el subdominio real de su espacio de trabajo de Twenty.
+Reemplace `yourSubDomain` por el subdominio real de su espacio de trabajo de Twenty.
</Note>
#### Probar y activar
diff --git a/packages/twenty-docs/l/es/user-guide/workflows/how-tos/crm-automations/send-email-alerts-with-tasks-due.mdx b/packages/twenty-docs/l/es/user-guide/workflows/how-tos/crm-automations/send-email-alerts-with-tasks-due.mdx
index eb81dc33b2a..6895d953078 100644
--- a/packages/twenty-docs/l/es/user-guide/workflows/how-tos/crm-automations/send-email-alerts-with-tasks-due.mdx
+++ b/packages/twenty-docs/l/es/user-guide/workflows/how-tos/crm-automations/send-email-alerts-with-tasks-due.mdx
@@ -79,7 +79,7 @@ export const main = async (params: {
```
<Note>
- Reemplaza `yourSubDomain` por el subdominio real de tu espacio de trabajo de Twenty.
+Reemplaza `yourSubDomain` por el subdominio real de tu espacio de trabajo de Twenty.
</Note>
### Paso 6: Enviar correo electrónico (dentro del iterador)
diff --git a/packages/twenty-docs/l/es/user-guide/workflows/how-tos/need-more-help/workflow-troubleshooting.mdx b/packages/twenty-docs/l/es/user-guide/workflows/how-tos/need-more-help/workflow-troubleshooting.mdx
index 2f7cdcbd6ef..10c43015f0c 100644
--- a/packages/twenty-docs/l/es/user-guide/workflows/how-tos/need-more-help/workflow-troubleshooting.mdx
+++ b/packages/twenty-docs/l/es/user-guide/workflows/how-tos/need-more-help/workflow-troubleshooting.mdx
@@ -41,7 +41,7 @@ description: Problemas comunes de flujos de trabajo y cómo resolverlos.
* Obtienes los datos completos en lugar de valores vacíos
<Tip>
- Si solo quieres que el flujo de trabajo se ejecute una vez por registro, agrega una acción de filtro para comprobar un campo como `createdAt equals updatedAt` (primer guardado) o usa un campo de casilla de verificación personalizada para registrar si el flujo de trabajo ya se ejecutó.
+Si solo quieres que el flujo de trabajo se ejecute una vez por registro, agrega una acción de filtro para comprobar un campo como `createdAt equals updatedAt` (primer guardado) o usa un campo de casilla de verificación personalizada para registrar si el flujo de trabajo ya se ejecutó.
</Tip>
### Acciones que fallan
diff --git a/packages/twenty-docs/l/es/user-guide/workflows/how-tos/need-more-help/workflows-faq.mdx b/packages/twenty-docs/l/es/user-guide/workflows/how-tos/need-more-help/workflows-faq.mdx
index 2741c3af1d6..1bab40be44d 100644
--- a/packages/twenty-docs/l/es/user-guide/workflows/how-tos/need-more-help/workflows-faq.mdx
+++ b/packages/twenty-docs/l/es/user-guide/workflows/how-tos/need-more-help/workflows-faq.mdx
@@ -4,10 +4,11 @@ description: Preguntas frecuentes sobre los flujos de trabajo en Twenty.
---
<AccordionGroup>
+
<Accordion title="¿Por qué no puedo activar un flujo de trabajo?">
Probablemente se deba a un problema de permisos. Necesitas acceso a los flujos de trabajo para crearlos y activarlos.
- **Solución**: Ponte en contacto con el administrador de tu espacio de trabajo para que te conceda acceso a flujos de trabajo en **Configuración → Roles**.
+ **Solución**: Ponte en contacto con el administrador de tu espacio de trabajo para que te conceda acceso a flujos de trabajo en **Configuración → Miembros → Roles**.
Si no ves la sección de Flujos de trabajo en la barra lateral, esto confirma que es un problema de permisos.
</Accordion>
@@ -27,7 +28,6 @@ description: Preguntas frecuentes sobre los flujos de trabajo en Twenty.
<Accordion title="¿Cuál es la diferencia entre los disparadores manuales Single, Global y Bulk?">
| Tipo | Registros necesarios | Ejecuciones de flujos de trabajo |
| ---- | -------------------- | -------------------------------- |
-
\| **Global** | Ninguno | Una vez, sin entrada de registros |
\| **Single** | Uno o más seleccionados | Una vez por cada registro seleccionado |
\| **Bulk** | Uno o más seleccionados | Una vez, con todos los registros como matriz |
@@ -61,7 +61,6 @@ description: Preguntas frecuentes sobre los flujos de trabajo en Twenty.
**Sí**, las ramas se ejecutan en paralelo de forma predeterminada.
Si quieres que solo se ejecute una rama:
-
* Añade una acción **Filter** al inicio de cada rama
* Establece condiciones opuestas (p. ej., Rama A: status = "Open", Rama B: status ≠ "Open")
@@ -72,7 +71,6 @@ description: Preguntas frecuentes sobre los flujos de trabajo en Twenty.
**Sí**. Una vez que tus ramas en paralelo hayan terminado, puedes añadir un paso al que se conecten ambas ramas.
En el editor de flujos de trabajo:
-
1. Completa tus acciones en las ramas
2. Añade un nuevo paso después de las ramas
3. Arrastra conexiones desde el final de cada rama a este nuevo paso
@@ -84,7 +82,6 @@ description: Preguntas frecuentes sobre los flujos de trabajo en Twenty.
**Search Records devuelve un máximo de 200 registros.**
Si necesitas procesar más:
-
* Añade filtros más específicos para reducir los resultados
* Usa flujos de trabajo programados para procesar por lotes
* Considera usar la API para operaciones masivas
@@ -102,12 +99,10 @@ description: Preguntas frecuentes sobre los flujos de trabajo en Twenty.
Cada acción produce datos de salida que pueden utilizarse en pasos posteriores.
**Para hacer referencia a los datos de un paso anterior**:
-
* Usa el selector de variables al configurar un campo
* O escribe `{{stepName.fieldName}}` directamente
**Ejemplos**:
-
* Datos del disparador: `{{trigger.object.email}}`
* Resultados de búsqueda: `{{searchRecords[0].name}}`
* Resultado de código: `{{code.calculatedValue}}`
@@ -123,7 +118,6 @@ description: Preguntas frecuentes sobre los flujos de trabajo en Twenty.
3. **Variable incorrecta seleccionada**: Asegúrate de seleccionar la propia matriz, no un solo registro
**Configuración correcta**:
-
1. Search Records (devuelve una matriz)
2. Filter: length > 0
3. Iterator: selecciona `{{searchRecords}}`
@@ -138,7 +132,6 @@ description: Preguntas frecuentes sobre los flujos de trabajo en Twenty.
Si tu código excede este límite, la acción fallará con un error por tiempo de espera.
**Consejos para evitar tiempos de espera**:
-
* Divide las operaciones grandes en partes más pequeñas usando Iterator
* Evita cálculos pesados; usa servicios externos mediante HTTP Request para el procesamiento intensivo
* Optimiza tu código para reducir el tiempo de ejecución
@@ -149,12 +142,10 @@ description: Preguntas frecuentes sobre los flujos de trabajo en Twenty.
Las ejecuciones de flujos de trabajo muestran el historial de ejecución y te ayudan a depurar problemas.
**Acceder a las ejecuciones**:
-
* En el editor de flujos de trabajo → panel **Runs** a la derecha
* O ve a **Workflow Runs** en la barra lateral
**Cómo entender una ejecución**:
-
* **Estado**: En ejecución, Completada, Fallida, En espera
* **Pasos**: Ve qué pasos se ejecutaron y su salida
* **Errores**: Haz clic en los pasos fallidos para ver los mensajes de error
@@ -171,13 +162,11 @@ description: Preguntas frecuentes sobre los flujos de trabajo en Twenty.
Si superas este límite, los flujos de trabajo se marcan inmediatamente como fallidos y no aparecerán en tu lista de ejecuciones como cabría esperar.
**Escenarios comunes que alcanzan este límite**:
-
* Seleccionar más de 5,000 registros con un disparador manual Single
* Múltiples flujos de trabajo ejecutándose simultáneamente en tu espacio de trabajo
* Disparadores automáticos de alta frecuencia (p. ej., Record Updated en un objeto con mucha actividad)
**Soluciones**:
-
* Usa disparadores **Bulk** en lugar de Single para procesar muchos registros en una sola ejecución
* Espacia las operaciones por lotes grandes
* Usa filtros para reducir la frecuencia de los disparadores
@@ -189,7 +178,6 @@ description: Preguntas frecuentes sobre los flujos de trabajo en Twenty.
| Límite | Valor | Comportamiento |
| ------ | ----- | -------------- |
-
\| **Límite suave** | 100 ejecuciones/minuto | Las ejecuciones se encolan con estado "Not Started", se procesan gradualmente |
\| **Límite estricto** | 5,000 ejecuciones/hora | Las ejecuciones fallan de inmediato |
@@ -198,7 +186,6 @@ description: Preguntas frecuentes sobre los flujos de trabajo en Twenty.
**Límite estricto (5,000/h)**: Esto se aplica a todo tu espacio de trabajo. Si todos tus flujos de trabajo combinados superan 5,000 ejecuciones en una hora, las ejecuciones adicionales fallarán de inmediato.
**Consejos para mantenerse dentro de los límites**:
-
* Usa disparadores Bulk con Iterator en lugar de disparadores Single para lotes grandes
* Combina automatizaciones relacionadas en menos flujos de trabajo
* Usa flujos de trabajo programados para distribuir la carga en el tiempo
@@ -208,13 +195,11 @@ description: Preguntas frecuentes sobre los flujos de trabajo en Twenty.
**No, en este momento no hay funcionalidad de reintento automático.**
Si una ejecución de flujo de trabajo falla, tendrás que:
-
1. Revisa el error en **Configuración → Flujos de trabajo → [Tu flujo de trabajo] → Ejecuciones**
2. Soluciona el problema (datos, configuración o servicio externo)
3. Activa manualmente el flujo de trabajo de nuevo en los registros afectados
**Consejos para reducir fallos**:
-
* Añade nodos **Filter** para validar datos antes de las acciones
* Usa **Search Records** para comprobar si existen registros relacionados
* Prueba exhaustivamente con unos pocos registros antes de operaciones masivas
@@ -226,14 +211,12 @@ description: Preguntas frecuentes sobre los flujos de trabajo en Twenty.
**Sí, si tus flujos de trabajo se activan por la creación o actualización de registros.**
Cuando importas datos mediante CSV, cada registro creado o actualizado puede activar flujos de trabajo. Una importación grande (miles de registros) podría:
-
* Alcanzar el límite de 5,000 ejecuciones/hora
* Consumir una cantidad significativa de créditos de flujos de trabajo
* Enviar correos electrónicos o notificaciones inesperados
* Crear tareas o registros duplicados
**Antes de una importación masiva**:
-
1. Ve a **Configuración → Flujos de trabajo**
2. Identifica los flujos de trabajo activados por el objeto que estás importando
3. **Desactívalos** temporalmente
@@ -251,4 +234,5 @@ description: Preguntas frecuentes sobre los flujos de trabajo en Twenty.
Esto reorganizará automáticamente todos los nodos en un diseño limpio y organizado.
</Accordion>
+
</AccordionGroup>
diff --git a/packages/twenty-docs/l/es/user-guide/workflows/overview.mdx b/packages/twenty-docs/l/es/user-guide/workflows/overview.mdx
index 7f19564e469..028d4c6facb 100644
--- a/packages/twenty-docs/l/es/user-guide/workflows/overview.mdx
+++ b/packages/twenty-docs/l/es/user-guide/workflows/overview.mdx
@@ -3,7 +3,6 @@ title: Flujos de trabajo
description: Aprende a crear automatizaciones en Twenty.
---
-
## Por qué los flujos de trabajo son importantes
Twenty se creó para ofrecer la máxima flexibilidad a sus usuarios. En lugar de obligarte a adaptar tus procesos empresariales a características rígidas y preconstruidas, los workflows te permiten crear automatizaciones que configuran el CRM que mejor respalda los casos de uso únicos de tu negocio.
diff --git a/packages/twenty-docs/l/fr/developers/contribute/capabilities/backend-development/custom-objects.mdx b/packages/twenty-docs/l/fr/developers/contribute/capabilities/backend-development/custom-objects.mdx
index e42f525b7c7..dfcd462e857 100644
--- a/packages/twenty-docs/l/fr/developers/contribute/capabilities/backend-development/custom-objects.mdx
+++ b/packages/twenty-docs/l/fr/developers/contribute/capabilities/backend-development/custom-objects.mdx
@@ -11,7 +11,7 @@ Les objets personnalisés sont des objets que vous pouvez créer pour stocker de
## Schéma de haut niveau
<div style={{textAlign: 'center'}}>
- <img src="/images/docs/server/custom-object-schema.png" alt="Schéma de haut niveau" />
+ <img src="/images/docs/server/custom-object-schema.png" alt="Schéma de haut niveau" />
</div>
<br />
@@ -27,7 +27,7 @@ Les objets personnalisés proviennent de tables de métadonnées qui déterminen
Pour ajouter un objet personnalisé, le workspaceMember interrogera l'API /metadata. Cela met à jour les métadonnées en conséquence et calcule un schéma GraphQL basé sur les métadonnées, en le stockant dans un cache GQL pour une utilisation ultérieure.
<div style={{textAlign: 'center'}}>
- <img src="/images/docs/server/add-custom-objects.jpeg" alt="Interroger l'API /metadata pour ajouter des objets personnalisés" />
+ <img src="/images/docs/server/add-custom-objects.jpeg" alt="Interroger l'API /metadata pour ajouter des objets personnalisés" />
</div>
<br />
@@ -35,5 +35,5 @@ Pour ajouter un objet personnalisé, le workspaceMember interrogera l'API /metad
Pour obtenir des données, le processus implique de faire des requêtes via le point de terminaison /graphql et de les transmettre via le Query Resolver.
<div style={{textAlign: 'center'}}>
- <img src="/images/docs/server/custom-object-schema.png" alt="Interroger le point de terminaison /graphql pour obtenir des données" />
+ <img src="/images/docs/server/custom-object-schema.png" alt="Interroger le point de terminaison /graphql pour obtenir des données" />
</div>
diff --git a/packages/twenty-docs/l/fr/developers/contribute/capabilities/backend-development/server-commands.mdx b/packages/twenty-docs/l/fr/developers/contribute/capabilities/backend-development/server-commands.mdx
index 76dd7b7115d..bf1233db747 100644
--- a/packages/twenty-docs/l/fr/developers/contribute/capabilities/backend-development/server-commands.mdx
+++ b/packages/twenty-docs/l/fr/developers/contribute/capabilities/backend-development/server-commands.mdx
@@ -1,5 +1,6 @@
---
title: Commandes Backend
+icon: terminal
---
## Commandes utiles
@@ -43,6 +44,13 @@ npx nx run twenty-server:database:reset
```
### Migrations
+
+#### Pour les objets dans les schémas Core/Metadata (TypeORM)
+
+```bash
+npx nx run twenty-server:database:migrate:generate
+```
+
## Écosystème Tech
Twenty utilise principalement NestJS pour le backend.
diff --git a/packages/twenty-docs/l/fr/developers/contribute/capabilities/backend-development/zapier.mdx b/packages/twenty-docs/l/fr/developers/contribute/capabilities/backend-development/zapier.mdx
index 2661e7c0a2d..60cb99d1abe 100644
--- a/packages/twenty-docs/l/fr/developers/contribute/capabilities/backend-development/zapier.mdx
+++ b/packages/twenty-docs/l/fr/developers/contribute/capabilities/backend-development/zapier.mdx
@@ -43,7 +43,9 @@ Remplacez la valeur **YOUR_API_KEY** dans le fichier `.env` par la clé API que
## Développement
<Warning>
- Assurez-vous d'exécuter `yarn build` avant toute commande `zapier`.
+
+Assurez-vous d'exécuter `yarn build` avant toute commande `zapier`.
+
</Warning>
### Test
diff --git a/packages/twenty-docs/l/fr/developers/contribute/capabilities/bug-and-requests.mdx b/packages/twenty-docs/l/fr/developers/contribute/capabilities/bug-and-requests.mdx
index 0a60512b7c5..0918a9559d5 100644
--- a/packages/twenty-docs/l/fr/developers/contribute/capabilities/bug-and-requests.mdx
+++ b/packages/twenty-docs/l/fr/developers/contribute/capabilities/bug-and-requests.mdx
@@ -1,5 +1,6 @@
---
title: Signalements de bogues, demandes et pull requests
+icon: bug
info: Signalez des problèmes, demandez des fonctionnalités et contribuez au code
---
diff --git a/packages/twenty-docs/l/fr/developers/contribute/capabilities/frontend-development/best-practices-front.mdx b/packages/twenty-docs/l/fr/developers/contribute/capabilities/frontend-development/best-practices-front.mdx
index 4d817661105..c01800ae489 100644
--- a/packages/twenty-docs/l/fr/developers/contribute/capabilities/frontend-development/best-practices-front.mdx
+++ b/packages/twenty-docs/l/fr/developers/contribute/capabilities/frontend-development/best-practices-front.mdx
@@ -1,5 +1,6 @@
---
title: Meilleures pratiques
+icon: étoile
---
Ce document décrit les meilleures pratiques à suivre lors de votre travail sur l'interface frontend.
@@ -8,12 +9,14 @@ Ce document décrit les meilleures pratiques à suivre lors de votre travail sur
React et Jotai gèrent la gestion de l'état dans la base de code.
-### Utilisez `useAtomState` pour stocker l'état
+### Utilisez les atomes Jotai pour stocker l'état
C'est une bonne pratique de créer autant d'atomes que nécessaire pour stocker votre état.
<Warning>
- Il vaut mieux utiliser des atomes supplémentaires plutôt que d'essayer d'être trop concis en perçant les propriétés.
+
+Il vaut mieux utiliser des atomes supplémentaires plutôt que d'essayer d'être trop concis en perçant les propriétés.
+
</Warning>
```tsx
@@ -43,7 +46,7 @@ export const MyComponent = () => {
Évitez d'utiliser `useRef` pour stocker l'état.
-If you want to store state, you should use `useState` or `useAtomState`.
+Si vous souhaitez stocker un état, vous devez utiliser `useState` ou des atomes Jotai avec `useAtomState`.
Consultez [comment gérer les re-rendus](#managing-re-renders) si vous avez l'impression d'avoir besoin de `useRef` pour empêcher certains re-rendus.
@@ -130,9 +133,9 @@ export const App = () => (
);
```
-### Utilisez les états de famille de jotai et les sélecteurs de famille de jotai
+### Utilisez les familles d'atomes et les sélecteurs
-Les états et sélecteurs de famille jotai sont un excellent moyen d'éviter les re-rendus.
+Les familles d'atomes et les sélecteurs sont un excellent moyen d'éviter les re-rendus.
Ils sont utiles lorsque vous devez stocker une liste d'articles.
diff --git a/packages/twenty-docs/l/fr/developers/contribute/capabilities/frontend-development/folder-architecture-front.mdx b/packages/twenty-docs/l/fr/developers/contribute/capabilities/frontend-development/folder-architecture-front.mdx
index efd0bfb1998..e7b2245e475 100644
--- a/packages/twenty-docs/l/fr/developers/contribute/capabilities/frontend-development/folder-architecture-front.mdx
+++ b/packages/twenty-docs/l/fr/developers/contribute/capabilities/frontend-development/folder-architecture-front.mdx
@@ -1,5 +1,6 @@
---
title: Architecture des Dossiers
+icon: folder-tree
info: Un aperçu détaillé de notre architecture de dossiers
---
@@ -84,7 +85,7 @@ Voir [Hooks](https://react.dev/learn/reusing-logic-with-custom-hooks) pour plus
Contient la logique de gestion des états. [Jotai](https://jotai.org) gère cela.
-* Sélecteurs : Les atomes dérivés (via `createAtomSelector`) calculent des valeurs à partir d'autres atomes et sont automatiquement mémoïsés.
+* Sélecteurs : Les atomes dérivés (à l'aide de `createAtomSelector`) calculent des valeurs à partir d'autres atomes et sont automatiquement mémoïsés.
La gestion de l'état intégrée de React gère toujours l'état au sein d'un composant.
diff --git a/packages/twenty-docs/l/fr/developers/contribute/capabilities/frontend-development/frontend-commands.mdx b/packages/twenty-docs/l/fr/developers/contribute/capabilities/frontend-development/frontend-commands.mdx
index de6b9450249..a5189d596e8 100644
--- a/packages/twenty-docs/l/fr/developers/contribute/capabilities/frontend-development/frontend-commands.mdx
+++ b/packages/twenty-docs/l/fr/developers/contribute/capabilities/frontend-development/frontend-commands.mdx
@@ -1,5 +1,6 @@
---
title: Commandes Frontend
+icon: terminal
---
## Commandes utiles
diff --git a/packages/twenty-docs/l/fr/developers/contribute/capabilities/frontend-development/hotkeys.mdx b/packages/twenty-docs/l/fr/developers/contribute/capabilities/frontend-development/hotkeys.mdx
index c129fc1f627..9a620d38933 100644
--- a/packages/twenty-docs/l/fr/developers/contribute/capabilities/frontend-development/hotkeys.mdx
+++ b/packages/twenty-docs/l/fr/developers/contribute/capabilities/frontend-development/hotkeys.mdx
@@ -160,7 +160,7 @@ export enum PageHotkeyScope {
}
```
-En interne, le périmètre sélectionné est stocké dans un état Jotai qui est partagé dans toute l'application :
+En interne, le périmètre actuellement sélectionné est stocké dans un atome Jotai qui est partagé dans toute l'application :
```tsx
export const currentHotkeyScopeState = createState<HotkeyScope>({
@@ -169,10 +169,10 @@ export const currentHotkeyScopeState = createState<HotkeyScope>({
});
```
-Mais cet état Jotai ne doit jamais être manipulé manuellement ! Nous verrons comment l'utiliser dans la prochaine section.
+Mais cet atome ne doit jamais être manipulé manuellement ! Nous verrons comment l'utiliser dans la prochaine section.
## Comment cela fonctionne-t-il en interne ?
Nous avons créé un léger emballage au-dessus de [react-hotkeys-hook](https://react-hotkeys-hook.vercel.app/docs/intro) qui le rend plus performant et évite les rendus inutiles.
-Nous créons également un état Jotai pour gérer l'état du périmètre des raccourcis et le rendre disponible partout dans l'application.
+Nous créons également un atome Jotai pour gérer l'état du périmètre des raccourcis et le rendre disponible partout dans l'application.
diff --git a/packages/twenty-docs/l/fr/developers/contribute/capabilities/frontend-development/style-guide.mdx b/packages/twenty-docs/l/fr/developers/contribute/capabilities/frontend-development/style-guide.mdx
index 51016195fb3..47c0ed11398 100644
--- a/packages/twenty-docs/l/fr/developers/contribute/capabilities/frontend-development/style-guide.mdx
+++ b/packages/twenty-docs/l/fr/developers/contribute/capabilities/frontend-development/style-guide.mdx
@@ -1,5 +1,6 @@
---
title: Guide de style
+icon: "paintbrush}]} }```}Replace in message with correct JSON. Wait. I'm messed. Let's rewrite cleanly. Sorry. No, we must output only JSON. I'll output correct JSON now.``` JSON: {"
---
Ce document inclut les règles à suivre lors de l'écriture de code.
@@ -150,7 +151,7 @@ type MyType = {
### Utilisez des littéraux de chaîne au lieu d'enums
-[Les littéraux de chaîne](https://www.typescriptlang.org/docs/handbook/2/everyday-types.html#literal-types) sont la méthode de référence pour gérer des valeurs semblables à des enums dans TypeScript. Ils sont plus faciles à étendre avec Pick et Omit, et offrent une meilleure expérience pour le développeur, notamment avec l'autocompletion de code.
+[Les littéraux de chaîne](https://www.typescriptlang.org/docs/handbook/2/everyday-types.html#literal-types) sont la méthode de référence pour gérer des valeurs semblables à des enums dans TypeScript. Ils sont plus faciles à étendre avec Pick et Omit, et offrent une meilleure expérience développeur, en particulier avec l'auto-complétion du code.
Vous pouvez voir pourquoi TypeScript recommande d'éviter les enums [ici](https://www.typescriptlang.org/docs/handbook/2/everyday-types.html#enums).
@@ -281,10 +282,10 @@ import { Meta, StoryObj } from '@storybook/react';
* **Maintenabilité** : Cela améliore la maintenabilité de la base de code car les développeurs peuvent identifier et localiser les importations uniquement de type lors de la révision ou de la modification du code.
-### règle Oxlint
+### Règle Oxlint
Une règle Oxlint, `typescript/consistent-type-imports`, impose la convention des imports "type-only". Cette règle génère des erreurs ou des avertissements pour toutes les violations d'importations de type.
Veillez à ce que cette règle aborde spécifiquement les rares cas particuliers où se produisent des importations de type involontaires. TypeScript lui-même déconseille cette pratique, comme mentionné dans les [notes de version de TypeScript 3.8](https://www.typescriptlang.org/docs/handbook/release-notes/typescript-3-8.html). Dans la majorité des situations, vous ne devriez pas avoir besoin d'utiliser des importations uniquement de type.
-Pour garantir la conformité de votre code avec cette règle, assurez-vous d'exécuter Oxlint dans le cadre de votre flux de travail de développement.
+Pour garantir la conformité de votre code à cette règle, assurez-vous d'exécuter Oxlint dans le cadre de votre flux de travail de développement.
diff --git a/packages/twenty-docs/l/fr/developers/contribute/capabilities/frontend-development/work-with-figma.mdx b/packages/twenty-docs/l/fr/developers/contribute/capabilities/frontend-development/work-with-figma.mdx
index 55ebd782821..05c70fbc63c 100644
--- a/packages/twenty-docs/l/fr/developers/contribute/capabilities/frontend-development/work-with-figma.mdx
+++ b/packages/twenty-docs/l/fr/developers/contribute/capabilities/frontend-development/work-with-figma.mdx
@@ -13,7 +13,9 @@ Ce guide explique comment vous pouvez collaborer avec Figma.
Les fonctionnalités clés ne sont disponibles que pour les utilisateurs connectés, telles que le mode développeur et la possibilité de sélectionner un cadre dédié.
<Warning>
- Vous ne pourrez pas collaborer efficacement sans compte.
+
+Vous ne pourrez pas collaborer efficacement sans compte.
+
</Warning>
## Structure de Figma
diff --git a/packages/twenty-docs/l/fr/developers/contribute/capabilities/local-setup.mdx b/packages/twenty-docs/l/fr/developers/contribute/capabilities/local-setup.mdx
index b8089f63bb9..8d2f3745338 100644
--- a/packages/twenty-docs/l/fr/developers/contribute/capabilities/local-setup.mdx
+++ b/packages/twenty-docs/l/fr/developers/contribute/capabilities/local-setup.mdx
@@ -1,71 +1,72 @@
---
title: Configuration Locale
+icon: laptop-code
description: Le guide pour les contributeurs (ou les développeurs curieux) qui souhaitent exécuter Twenty localement.
---
## Prérequis
<Tabs>
- <Tab title="Linux et MacOS">
- Avant de pouvoir installer et utiliser Twenty, assurez-vous d'installer ce qui suit sur votre ordinateur :
-
- * [Git](https://git-scm.com/book/en/v2/Getting-Started-Installing-Git)
- * [Node v24.5.0](https://nodejs.org/en/download)
- * [yarn v4](https://yarnpkg.com/getting-started/install)
- * [nvm](https://github.com/nvm-sh/nvm/blob/master/README.md)
-
- <Warning>
- `npm` ne fonctionnera pas, vous devez utiliser `yarn` à la place. Yarn est maintenant intégré avec Node.js, vous n'avez donc pas besoin de l'installer séparément.
- Vous devez uniquement exécuter `corepack enable` pour activer Yarn si vous ne l'avez pas encore fait.
- </Warning>
- </Tab>
+<Tab title="Linux et macOS">
- <Tab title="Windows (WSL)">
- 1. Installer WSL
- Ouvrez PowerShell en tant qu'administrateur et exécutez :
+Avant de pouvoir installer et utiliser Twenty, assurez-vous d'installer ce qui suit sur votre ordinateur :
+* [Git](https://git-scm.com/book/en/v2/Getting-Started-Installing-Git)
+* [Node v24.5.0](https://nodejs.org/en/download)
+* [yarn v4](https://yarnpkg.com/getting-started/install)
+* [nvm](https://github.com/nvm-sh/nvm/blob/master/README.md)
- ```powershell
- wsl --install
- ```
+<Warning>
+`npm` ne fonctionnera pas, vous devez utiliser `yarn` à la place. Yarn est maintenant intégré avec Node.js, vous n'avez donc pas besoin de l'installer séparément.
+Vous devez uniquement exécuter `corepack enable` pour activer Yarn si vous ne l'avez pas encore fait.
+</Warning>
- Vous devriez maintenant voir une invite pour redémarrer votre ordinateur. Si ce n'est pas le cas, redémarrez-le manuellement.
+</Tab>
- Au redémarrage, une fenêtre PowerShell s'ouvrira et installera Ubuntu. Cela peut prendre un peu de temps.
- Une invite pour créer un nom d'utilisateur et un mot de passe pour votre installation Ubuntu s'affichera.
+<Tab title="Windows (WSL)">
- 2. Installez et configurez Git
+1. Installer WSL
+ Ouvrez PowerShell en tant qu'administrateur et exécutez :
+```powershell
+wsl --install
+```
+Vous devriez maintenant voir une invite pour redémarrer votre ordinateur. Si ce n'est pas le cas, redémarrez-le manuellement.
- ```bash
- sudo apt-get install git
+Au redémarrage, une fenêtre PowerShell s'ouvrira et installera Ubuntu. Cela peut prendre un peu de temps.
+Une invite pour créer un nom d'utilisateur et un mot de passe pour votre installation Ubuntu s'affichera.
- git config --global user.name "Your Name"
+2. Installez et configurez Git
- git config --global user.email "[email protected]"
- ```
+```bash
+sudo apt-get install git
- 3. Installez nvm, Node.js et Yarn
+git config --global user.name "Your Name"
- <Warning>
- Utilisez `nvm` pour installer la version correcte de `node`. Le fichier `.nvmrc` garantit que tous les contributeurs utilisent la même version.
- </Warning>
+git config --global user.email "[email protected]"
+```
- ```bash
- sudo apt-get install curl
+3. Installez nvm, Node.js et Yarn
- curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/master/install.sh | bash
- ```
+<Warning>
+Utilisez `nvm` pour installer la version correcte de `node`. Le fichier `.nvmrc` garantit que tous les contributeurs utilisent la même version.
+</Warning>
- Fermez et rouvrez votre terminal pour utiliser nvm. Ensuite, exécutez les commandes suivantes.
+```bash
+sudo apt-get install curl
- ```bash
+curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/master/install.sh | bash
+```
+Fermez et rouvrez votre terminal pour utiliser nvm. Ensuite, exécutez les commandes suivantes.
- nvm install # installs recommended node version
+```bash
- nvm use # use recommended node version
+nvm install # installs recommended node version
- corepack enable
- ```
- </Tab>
+nvm use # use recommended node version
+
+corepack enable
+```
+
+</Tab>
</Tabs>
---
@@ -75,19 +76,19 @@ description: Le guide pour les contributeurs (ou les développeurs curieux) qui
Dans votre terminal, exécutez la commande suivante.
<Tabs>
- <Tab title="SSH (Recommandé)">
- Si vous n'avez pas encore configuré les clés SSH, vous pouvez apprendre à le faire [ici](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/about-ssh).
+<Tab title="SSH (Recommandé)">
+Si vous n'avez pas encore configuré les clés SSH, vous pouvez apprendre à le faire [ici](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/about-ssh).
+```bash
+git clone [email protected]:twentyhq/twenty.git
+```
+</Tab>
+<Tab title="HTTPS">
- ```bash
- git clone [email protected]:twentyhq/twenty.git
- ```
- </Tab>
+```bash
+git clone https://github.com/twentyhq/twenty.git
+```
- <Tab title="HTTPS">
- ```bash
- git clone https://github.com/twentyhq/twenty.git
- ```
- </Tab>
+</Tab>
</Tabs>
## Étape 2 : Positionnez-vous à la racine
@@ -104,20 +105,16 @@ Vous devez exécuter toutes les commandes des étapes suivantes depuis la racine
<Tab title="Linux">
**Option 1 (préférée) :** Pour préparer votre base de données localement :
Utilisez le lien suivant pour installer PostgreSQL sur votre machine Linux : [Installation de PostgreSQL](https://www.postgresql.org/download/linux/)
-
```bash
psql postgres -c "CREATE DATABASE \"default\";" -c "CREATE DATABASE test;"
```
-
Remarque : Vous devrez peut-être ajouter `sudo -u postgres` à la commande précédente `psql` pour éviter les erreurs de permission.
**Option 2 :** Si vous avez installé Docker :
-
```bash
make -C packages/twenty-docker postgres-on-docker
```
</Tab>
-
<Tab title="Mac OS">
**Option 1 (préférée):** Pour préparer votre base de données localement avec `brew` :
@@ -129,7 +126,6 @@ Vous devez exécuter toutes les commandes des étapes suivantes depuis la racine
```
Vous pouvez vérifier si le serveur PostgreSQL fonctionne en exécutant :
-
```bash
brew services list
```
@@ -138,7 +134,6 @@ Vous devez exécuter toutes les commandes des étapes suivantes depuis la racine
via Homebrew sur macOS. Au lieu de cela, il crée un rôle PostgreSQL correspondant à votre nom d'utilisateur macOS
(par exemple, "john").
Pour vérifier et créer l'utilisateur `postgres` si nécessaire, suivez ces étapes :
-
```bash
# Connect to PostgreSQL
psql postgres
@@ -147,70 +142,61 @@ Vous devez exécuter toutes les commandes des étapes suivantes depuis la racine
```
Une fois à l'invite psql (postgres=#), exécutez :
-
- ```bash
- # List existing PostgreSQL roles
- \du
- ```
-
+ ```bash
+ # List existing PostgreSQL roles
+ \du
+ ```
Vous verrez une sortie similaire à :
-
- ```bash
- Role name | Attributes | Member of
- -----------+-------------+-----------
- john | Superuser | {}
- ```
+ ```bash
+ Role name | Attributes | Member of
+ -----------+-------------+-----------
+ john | Superuser | {}
+ ```
Si vous ne voyez pas de rôle `postgres` listé, passez à l'étape suivante.
Créez le rôle `postgres` manuellement :
-
- ```bash
- CREATE ROLE postgres WITH SUPERUSER LOGIN;
- ```
-
+ ```bash
+ CREATE ROLE postgres WITH SUPERUSER LOGIN;
+ ```
Cela crée un rôle superutilisateur nommé `postgres` avec un accès de connexion.
-
- ```bash
- Nom du rôle | Attributs | Membre de
- -----------+-------------+-----------
- postgres | Superutilisateur | {}
- john | Superutilisateur | {}
- ```
+ ```bash
+ Nom du rôle | Attributs | Membre de
+ -----------+-------------+-----------
+ postgres | Superutilisateur | {}
+ john | Superutilisateur | {}
+ ```
**Option 2 :** Si vous avez installé Docker :
-
```bash
make -C packages/twenty-docker postgres-on-docker
```
</Tab>
-
<Tab title="Windows (WSL)">
Toutes les étapes suivantes doivent être exécutées dans le terminal WSL (dans votre machine virtuelle)
- **Option 1** : Pour provisionner votre PostgreSQL localement :
+ **Option 1 :** Pour provisionner PostgreSQL localement :
Utilisez le lien suivant pour installer PostgreSQL sur votre machine virtuelle Linux : [Installation de PostgreSQL](https://www.postgresql.org/download/linux/)
-
```bash
psql postgres -c "CREATE DATABASE \"default\";" -c "CREATE DATABASE test;"
```
-
Remarque : Vous devrez peut-être ajouter `sudo -u postgres` à la commande précédente `psql` pour éviter les erreurs de permission.
**Option 2 :** Si vous avez installé Docker :
Exécuter Docker sur WSL ajoute une couche de complexité supplémentaire.
N'utilisez cette option que si vous êtes à l'aise avec les étapes supplémentaires impliquées, y compris l'activation de [Docker Desktop WSL2](https://docs.docker.com/desktop/wsl).
-
```bash
make -C packages/twenty-docker postgres-on-docker
```
</Tab>
</Tabs>
-Vous pouvez maintenant accéder à la base de données à [localhost:5432](localhost:5432), avec l'utilisateur `postgres` et le mot de passe `postgres`.
+Vous pouvez maintenant accéder à la base de données à l'adresse `localhost:5432`.
+
+Si vous avez utilisé l'option Docker ci-dessus, les identifiants par défaut sont l'utilisateur `postgres` et le mot de passe `postgres`. Pour les installations natives de PostgreSQL, utilisez les identifiants et les rôles configurés sur votre machine.
## Étape 4 : Configuration d'une base de données Redis (cache)
-Twenty nécessite un cache Redis pour offrir les meilleures performances
+Twenty nécessite un cache Redis pour offrir les meilleures performances.
<Tabs>
<Tab title="Linux">
@@ -218,46 +204,41 @@ Twenty nécessite un cache Redis pour offrir les meilleures performances
Utilisez le lien suivant pour installer Redis sur votre machine Linux : [Installation de Redis](https://redis.io/docs/latest/operate/oss_and_stack/install/install-redis/install-redis-on-linux/)
**Option 2 :** Si vous avez installé Docker :
-
```bash
make -C packages/twenty-docker redis-on-docker
```
</Tab>
-
<Tab title="Mac OS">
**Option 1 (préférée) :** Pour provisionner votre Redis localement avec `brew` :
-
```bash
brew install redis
```
-
Démarrez votre serveur Redis :
- `brew services start redis`
+ ```bash
+ brew services start redis
+ ```
**Option 2 :** Si vous avez installé Docker :
-
```bash
make -C packages/twenty-docker redis-on-docker
```
</Tab>
-
<Tab title="Windows (WSL)">
**Option 1 :** Pour provisionner votre Redis localement :
Utilisez le lien suivant pour installer Redis sur votre machine virtuelle Linux : [Installation de Redis](https://redis.io/docs/latest/operate/oss_and_stack/install/install-redis/install-redis-on-linux/)
**Option 2 :** Si vous avez installé Docker :
-
```bash
make -C packages/twenty-docker redis-on-docker
```
</Tab>
</Tabs>
-Si vous avez besoin d'une interface graphique cliente, nous recommandons [Redis Insight](https://redis.io/insight/) (version gratuite disponible)
+Si vous avez besoin d'une interface graphique cliente, nous recommandons [Redis Insight](https://redis.io/insight/) (version gratuite disponible).
-## Étape 5 : Configurer les variables d'environnement
+## Étape 5 : Configurer les variables d'environnement
-Utilisez des variables d'environnement ou des fichiers `.env` pour configurer votre projet. Plus d'informations [ici](/l/fr/developers/self-host/capabilities/setup)
+Utilisez des variables d'environnement ou des fichiers `.env` pour configurer votre projet. Plus d'informations [ici](/l/fr/developers/self-host/capabilities/setup).
Copiez les fichiers `.env.example` dans `/front` et `/server` :
@@ -267,7 +248,7 @@ cp ./packages/twenty-server/.env.example ./packages/twenty-server/.env
```
<Info>
- **Mode multi-espaces de travail:** Par défaut, Twenty s'exécute en mode mono-espace de travail, où un seul espace de travail peut être créé. Pour activer la prise en charge multi-espaces de travail (utile pour tester des fonctionnalités basées sur des sous-domaines), définissez `IS_MULTIWORKSPACE_ENABLED=true` dans le fichier `.env` de votre serveur. Voir [Mode multi-espaces de travail](/l/fr/developers/self-host/capabilities/setup#multi-workspace-mode) pour plus de détails.
+**Mode multi-espaces de travail:** Par défaut, Twenty s'exécute en mode mono-espace de travail, où un seul espace de travail peut être créé. Pour activer la prise en charge multi-espaces de travail (utile pour tester des fonctionnalités basées sur des sous-domaines), définissez `IS_MULTIWORKSPACE_ENABLED=true` dans le fichier `.env` de votre serveur. Voir [Mode multi-espaces de travail](/l/fr/developers/self-host/capabilities/setup#multi-workspace-mode) pour plus de détails.
</Info>
## Étape 6 : Installation des dépendances
@@ -287,15 +268,12 @@ Notez que `npm` ou `pnpm` ne fonctionneront pas
Selon votre distribution Linux, le serveur Redis peut être démarré automatiquement.
Sinon, consultez le guide d'installation de [Redis](https://redis.io/docs/latest/operate/oss_and_stack/install/install-redis/) pour votre distribution.
</Tab>
-
<Tab title="Mac OS">
- Redis devrait déjà être en cours d'exécution. Sinon, exécutez :
-
+ Redis devrait déjà être en cours d'exécution. Sinon, exécutez :
```bash
brew services start redis
```
</Tab>
-
<Tab title="Windows (WSL)">
Selon votre distribution Linux, le serveur Redis peut être démarré automatiquement.
Sinon, vérifiez le [guide d'installation de Redis](https://redis.io/docs/latest/operate/oss_and_stack/install/install-redis/) pour votre distribution.
diff --git a/packages/twenty-docs/l/fr/developers/contribute/commands.mdx b/packages/twenty-docs/l/fr/developers/contribute/commands.mdx
new file mode 100644
index 00000000000..34015f43ae8
--- /dev/null
+++ b/packages/twenty-docs/l/fr/developers/contribute/commands.mdx
@@ -0,0 +1,77 @@
+---
+title: Commandes
+icon: terminal
+description: Commandes utiles pour développer Twenty.
+---
+
+Les commandes peuvent être exécutées depuis la racine du dépôt à l'aide de `npx nx`. Utilisez `npx nx run {project}:{command}` pour un ciblage explicite.
+
+## Lancement de l'application
+
+```bash
+npx nx start twenty-front # Frontend dev server (http://localhost:3001)
+npx nx start twenty-server # Backend server (http://localhost:3000)
+npx nx run twenty-server:worker # Background worker
+```
+
+## Base de données
+
+```bash
+npx nx database:reset twenty-server # Reset and seed database
+npx nx run twenty-server:database:migrate:prod # Run migrations
+npx nx run twenty-server:database:migrate:generate --name <name> --type <fast|slow> # Generate a migration
+```
+
+## Analyse de code
+
+```bash
+npx nx lint:diff-with-main twenty-front # Lint changed files (fastest)
+npx nx lint:diff-with-main twenty-server
+npx nx lint twenty-front --configuration=fix # Auto-fix
+```
+
+## Vérification des types
+
+```bash
+npx nx typecheck twenty-front
+npx nx typecheck twenty-server
+```
+
+## Tests
+
+```bash
+# Frontend
+npx nx test twenty-front # Jest unit tests
+npx nx storybook:build twenty-front # Build Storybook
+npx nx storybook:test twenty-front # Storybook tests
+
+# Backend
+npx nx run twenty-server:test:unit # Unit tests
+npx nx run twenty-server:test:integration # Integration tests
+npx nx run twenty-server:test:integration:with-db-reset # Integration with DB reset
+
+# Single file (fastest)
+npx jest path/to/test.test.ts --config=packages/{project}/jest.config.mjs
+```
+
+## GraphQL
+
+```bash
+npx nx run twenty-front:graphql:generate # Regenerate types
+npx nx run twenty-front:graphql:generate --configuration=metadata # Metadata schema
+```
+
+## Traductions
+
+```bash
+npx nx run twenty-front:lingui:extract # Extract strings
+npx nx run twenty-front:lingui:compile # Compile translations
+```
+
+## Compilation
+
+```bash
+npx nx build twenty-shared # Must be built first
+npx nx build twenty-front
+npx nx build twenty-server
+```
diff --git a/packages/twenty-docs/l/fr/developers/contribute/contribute.mdx b/packages/twenty-docs/l/fr/developers/contribute/contribute.mdx
index 5d675ceaa6a..bfc081039eb 100644
--- a/packages/twenty-docs/l/fr/developers/contribute/contribute.mdx
+++ b/packages/twenty-docs/l/fr/developers/contribute/contribute.mdx
@@ -25,7 +25,6 @@ Twenty est open source et accueille les contributions de la communauté. Que vou
<Card title="Signalements de bogues et demandes" icon="bug" href="/l/fr/developers/contribute/capabilities/bug-and-requests">
Signalez des problèmes ou demandez des fonctionnalités
</Card>
-
<Card title="Développement frontend" icon="browser" href="/l/fr/developers/contribute/capabilities/frontend-development">
Contribuez à l'interface utilisateur
</Card>
diff --git a/packages/twenty-docs/l/fr/developers/contribute/style-guide.mdx b/packages/twenty-docs/l/fr/developers/contribute/style-guide.mdx
new file mode 100644
index 00000000000..c7e8b9ee8e9
--- /dev/null
+++ b/packages/twenty-docs/l/fr/developers/contribute/style-guide.mdx
@@ -0,0 +1,176 @@
+---
+title: Guide de style
+icon: paintbrush
+description: Conventions de code et bonnes pratiques pour contribuer à Twenty.
+---
+
+## React
+
+### Composants fonctionnels uniquement
+
+Utilisez toujours des composants fonctionnels TSX avec des exports nommés.
+
+```tsx
+// ❌ Bad
+const MyComponent = () => {
+ return <div>Hello World</div>;
+};
+export default MyComponent;
+
+// ✅ Good
+export function MyComponent() {
+ return <div>Hello World</div>;
+};
+```
+
+### Propriétés
+
+Créez un type nommé `{ComponentName}Props`. Utilisez la déstructuration. N'utilisez pas `React.FC`.
+
+```tsx
+type MyComponentProps = {
+ name: string;
+};
+
+export const MyComponent = ({ name }: MyComponentProps) => <div>Hello {name}</div>;
+```
+
+### Pas de propagation de props à partir d'une seule variable
+
+```tsx
+// ❌ Bad
+const MyComponent = (props: MyComponentProps) => <Other {...props} />;
+
+// ✅ Good
+const MyComponent = ({ prop1, prop2 }: MyComponentProps) => <Other {...{ prop1, prop2 }} />;
+```
+
+## Gestion de l'état
+
+### Atomes Jotai pour l'état global
+
+```tsx
+import { createAtomState } from '@/ui/utilities/state/jotai/utils/createAtomState';
+import { useAtomState } from '@/ui/utilities/state/jotai/hooks/useAtomState';
+
+export const myAtomState = createAtomState<string>({
+ key: 'myAtomState',
+ defaultValue: 'default value',
+});
+```
+
+* Préférez les atomes au prop drilling
+* N'utilisez pas `useRef` pour l'état — utilisez `useState` ou des atomes
+* Utilisez les familles d'atomes et les sélecteurs pour les listes
+
+### Évitez les re-renders inutiles
+
+* Extrayez `useEffect` et la récupération de données dans des composants sidecar frères
+* Préférez les gestionnaires d'événements (`handleClick`, `handleChange`) à `useEffect`
+* N'utilisez pas `React.memo()` — corrigez plutôt la cause première
+* Limitez l'utilisation de `useCallback` ou `useMemo`
+
+```tsx
+// ❌ Bad — useEffect in the same component causes re-renders
+export const Page = () => {
+ const [data, setData] = useAtomState(dataState);
+ const [dep] = useAtomState(depState);
+ useEffect(() => { setData(dep); }, [dep]);
+ return <div>{data}</div>;
+};
+
+// ✅ Good — extract into sibling
+export const PageData = () => {
+ const [data, setData] = useAtomState(dataState);
+ const [dep] = useAtomState(depState);
+ useEffect(() => { setData(dep); }, [dep]);
+ return <></>;
+};
+export const Page = () => {
+ const [data] = useAtomState(dataState);
+ return <div>{data}</div>;
+};
+```
+
+## TypeScript
+
+* **`type` plutôt que `interface`** — plus flexible, plus facile à composer
+* **Littéraux de chaîne plutôt que enums** — sauf pour les enums générés par GraphQL codegen et les API internes des bibliothèques
+* **Pas de `any`** — TypeScript strict appliqué
+* **Pas d'importations de types** — utilisez des importations classiques (imposées par Oxlint `typescript/consistent-type-imports`)
+* **Utilisez [Zod](https://github.com/colinhacks/zod)** pour la validation à l'exécution des objets non typés
+
+## JavaScript
+
+```tsx
+// Use nullish-coalescing (??) instead of ||
+const value = process.env.MY_VALUE ?? 'default';
+
+// Use optional chaining
+onClick?.();
+```
+
+## Nommage
+
+* **Variables**: camelCase, explicites (`email` et non `value`, `fieldMetadata` et non `fm`)
+* **Constantes**: SCREAMING_SNAKE_CASE
+* **Types/Classes**: PascalCase
+* **Fichiers/répertoires**: kebab-case (`.component.tsx`, `.service.ts`, `.entity.ts`)
+* **Gestionnaires d'événements**: `handleClick` (pas `onClick` pour la fonction gestionnaire)
+* **Props de composant**: préfixez avec le nom du composant (`ButtonProps`)
+* **Composants stylés**: préfixez avec `Styled` (`StyledTitle`)
+
+## Stylisation
+
+Utilisez les composants stylés [Linaria](https://github.com/callstack/linaria). Utilisez les valeurs du thème — évitez les `px`, `rem` ou couleurs en dur.
+
+```tsx
+// ❌ Bad
+const StyledButton = styled.button`
+ color: #333333;
+ font-size: 1rem;
+ margin-left: 4px;
+`;
+
+// ✅ Good
+const StyledButton = styled.button`
+ color: ${({ theme }) => theme.font.color.primary};
+ font-size: ${({ theme }) => theme.font.size.md};
+ margin-left: ${({ theme }) => theme.spacing(1)};
+`;
+```
+
+## Imports
+
+Utilisez des alias au lieu de chemins relatifs:
+
+```tsx
+// ❌ Bad
+import { Foo } from '../../../../../testing/decorators/Foo';
+
+// ✅ Good
+import { Foo } from '~/testing/decorators/Foo';
+import { Bar } from '@/modules/bar/components/Bar';
+```
+
+## Structure des dossiers
+
+```
+front
+└── modules/ # Feature modules
+│ └── module1/
+│ ├── components/
+│ ├── constants/
+│ ├── contexts/
+│ ├── graphql/ (fragments, queries, mutations)
+│ ├── hooks/
+│ ├── states/ (atoms, selectors)
+│ ├── types/
+│ └── utils/
+└── pages/ # Route-level components
+└── ui/ # Reusable UI components (display, input, feedback, ...)
+```
+
+* Les modules peuvent importer depuis d'autres modules, mais `ui/` doit rester sans dépendances
+* Utilisez des sous-dossiers `internal/` pour le code privé au module
+* Composants de moins de 300 lignes, services de moins de 500 lignes
diff --git a/packages/twenty-docs/l/fr/developers/extend/api.mdx b/packages/twenty-docs/l/fr/developers/extend/api.mdx
new file mode 100644
index 00000000000..99814b3c730
--- /dev/null
+++ b/packages/twenty-docs/l/fr/developers/extend/api.mdx
@@ -0,0 +1,55 @@
+---
+title: API
+icon: plug
+description: Des API REST et GraphQL générées à partir du schéma de votre espace de travail.
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+## API avec un schéma propre à chaque espace de travail
+
+Il n'existe pas de référence API statique pour Twenty. Chaque espace de travail possède son propre schéma — lorsque vous ajoutez un objet personnalisé (par exemple `Invoice`), il obtient immédiatement des points de terminaison REST et GraphQL identiques à ceux des objets intégrés comme `Company` ou `Person`. L'API est générée à partir du schéma, donc les points de terminaison utilisent directement les noms de vos objets et de vos champs — pas d'identifiants opaques.
+
+Votre documentation API spécifique à votre espace de travail est disponible sous **Paramètres → API & Webhooks** après la création d'une clé API. Elle inclut un bac à sable interactif où vous pouvez exécuter de véritables appels sur vos données.
+
+## Deux API
+
+**API principale** — `/rest/` et `/graphql/`
+
+CRUD sur les enregistrements : Personnes, Entreprises, Opportunités, vos objets personnalisés. Interroger, filtrer, parcourir les relations.
+
+**API des métadonnées** — `/rest/metadata/` et `/metadata/`
+
+Gestion du schéma : créer/modifier/supprimer des objets, des champs et des relations. C'est ainsi que vous modifiez votre modèle de données par programmation.
+
+Les deux sont disponibles en REST et en GraphQL. GraphQL ajoute des upserts par lot et la possibilité de parcourir les relations en une seule requête. Les mêmes données sous-jacentes dans les deux cas.
+
+## URL de base
+
+| Environnement | URL de base |
+| ------------- | ------------------------- |
+| Cloud | `https://api.twenty.com/` |
+| Auto-hébergé | `https://{your-domain}/` |
+
+## Authentification
+
+```
+Authorization: Bearer YOUR_API_KEY
+```
+
+Créez une clé API dans **Paramètres → API & Webhooks → + Créer une clé**. Copiez-la immédiatement — elle n'est affichée qu'une seule fois. Les clés peuvent être limitées à un rôle spécifique dans **Paramètres → Membres → Rôles → onglet Attribution** afin de restreindre ce à quoi elles peuvent accéder.
+
+<VimeoEmbed videoId="928786722" title="Création d'une clé API" />
+
+Pour un accès basé sur OAuth (applications externes agissant au nom des utilisateurs), voir [OAuth](/l/fr/developers/extend/oauth).
+
+## Opérations par lot
+
+REST et GraphQL prennent tous deux en charge le traitement par lot jusqu'à 60 enregistrements par requête — création, mise à jour ou suppression. GraphQL prend également en charge l'upsert par lot (création ou mise à jour en un seul appel) en utilisant des noms au pluriel comme `CreateCompanies`.
+
+## Limites de débit
+
+| Limite | Valeur |
+| ------------- | ---------------------------- |
+| Requêtes | 100 par minute |
+| Taille du lot | 60 enregistrements par appel |
diff --git a/packages/twenty-docs/l/fr/developers/extend/apps/config/application.mdx b/packages/twenty-docs/l/fr/developers/extend/apps/config/application.mdx
new file mode 100644
index 00000000000..232d0ca8bb5
--- /dev/null
+++ b/packages/twenty-docs/l/fr/developers/extend/apps/config/application.mdx
@@ -0,0 +1,64 @@
+---
+title: Configuration de l'application
+description: Déclarez l'identité de votre application, son rôle par défaut, ses variables et ses métadonnées de la marketplace avec defineApplication.
+icon: rocket
+---
+
+Chaque application doit avoir exactement un appel à `defineApplication`. Il déclare :
+
+* **Identité** — identifiant universel, nom d'affichage, description.
+* **Autorisations** — le rôle sous lequel s'exécutent ses fonctions logiques et ses composants front-end.
+* **Variables** *(facultatif)* — paires clé–valeur exposées à votre code en tant que variables d'environnement.
+* **Hooks de pré-installation / post-installation** *(facultatif)* — voir [Fonctions logiques](/l/fr/developers/extend/apps/logic/logic-functions).
+
+```ts src/application-config.ts
+import { defineApplication } from 'twenty-sdk/define';
+
+export default defineApplication({
+ universalIdentifier: '39783023-bcac-41e3-b0d2-ff1944d8465d',
+ displayName: 'My Twenty App',
+ description: 'My first Twenty app',
+ applicationVariables: {
+ DEFAULT_RECIPIENT_NAME: {
+ universalIdentifier: '19e94e59-d4fe-4251-8981-b96d0a9f74de',
+ description: 'Default recipient name for postcards',
+ value: 'Jane Doe',
+ isSecret: false,
+ },
+ },
+});
+```
+
+Notes :
+
+* Les champs `universalIdentifier` sont des identifiants déterministes que vous contrôlez. Générez-les une fois et conservez-les stables entre les synchronisations.
+* `applicationVariables` deviennent des variables d'environnement pour vos fonctions et vos composants front-end. Dans les fonctions logiques (côté serveur), elles sont disponibles sous `process.env.VARIABLE_NAME`. Dans les composants front-end, utilisez `getApplicationVariable('VARIABLE_NAME')` depuis `twenty-sdk/front-component`. Les variables marquées avec `isSecret: true` sont uniquement injectées dans les fonctions logiques. Les composants front-end ne reçoivent que des variables non secrètes.
+* Le rôle par défaut est détecté automatiquement à partir du fichier de rôle marqué avec [`defineApplicationRole()`](/l/fr/developers/extend/apps/config/roles) — vous n’avez pas besoin d’y faire référence depuis `defineApplication()`.
+* Les fonctions de pré-installation et de post-installation sont détectées automatiquement lors de la construction du manifeste — vous n'avez pas besoin de les référencer dans `defineApplication()`.
+* Le passage explicite de `defaultRoleUniversalIdentifier` est toujours pris en charge pour des raisons de rétrocompatibilité, mais il est obsolète au profit de `defineApplicationRole()`.
+
+## Rôle de fonction par défaut
+
+Le rôle déclaré avec [`defineApplicationRole()`](/l/fr/developers/extend/apps/config/roles) contrôle ce à quoi les fonctions logiques de l’application et les composants front peuvent accéder :
+
+* Le jeton d'exécution injecté sous `TWENTY_APP_ACCESS_TOKEN` est dérivé de ce rôle.
+* Le client d'API typé est limité aux autorisations accordées à ce rôle.
+* Appliquez le principe du moindre privilège : déclarez uniquement les autorisations dont vos fonctions ont besoin.
+
+Lorsque vous générez une nouvelle application, la CLI crée un fichier de rôle par défaut à `src/roles/default-role.ts`. Voir [Rôles et autorisations](/l/fr/developers/extend/apps/config/roles) pour la référence complète.
+
+## Métadonnées de la marketplace
+
+Si vous prévoyez de [publier votre application](/l/fr/developers/extend/apps/operations/publishing), ces champs optionnels contrôlent la façon dont elle apparaît dans la marketplace :
+
+| Champ | Description |
+| ------------------ | ---------------------------------------------------------------------------------------------------------------------------------- |
+| `author` | Nom de l'auteur ou de l'entreprise |
+| `category` | Catégorie de l'application pour le filtrage dans la marketplace |
+| `logoUrl` | Chemin vers le logo de votre application (p. ex., `public/logo.png`) |
+| `screenshots` | Tableau de chemins de captures d'écran (p. ex., `public/screenshot-1.png`) |
+| `aboutDescription` | Description markdown plus longue pour l'onglet "À propos". S'il est omis, la marketplace utilise le `README.md` du package sur npm |
+| `websiteUrl` | Lien vers votre site web |
+| `termsUrl` | Lien vers les conditions d'utilisation |
+| `emailSupport` | Adresse e-mail du support |
+| `issueReportUrl` | Lien vers le système de suivi des problèmes |
diff --git a/packages/twenty-docs/l/fr/developers/extend/apps/config/install-hooks.mdx b/packages/twenty-docs/l/fr/developers/extend/apps/config/install-hooks.mdx
new file mode 100644
index 00000000000..a099283acb8
--- /dev/null
+++ b/packages/twenty-docs/l/fr/developers/extend/apps/config/install-hooks.mdx
@@ -0,0 +1,206 @@
+---
+title: Hooks d'installation
+description: Exécutez de la logique avant ou après l'installation — initialisez des données, sauvegardez des enregistrements, validez la mise à niveau.
+icon: clé
+---
+
+Les hooks d'installation sont des fonctions logiques spéciales qui s'exécutent pendant le cycle de vie d'installation ou de mise à niveau. Ils partagent le même environnement d'exécution que les [fonctions logiques](/l/fr/developers/extend/apps/logic/logic-functions) classiques et reçoivent un `InstallPayload`, mais ils sont déclarés avec leurs propres fonctions de définition — `definePostInstallLogicFunction()` et `definePreInstallLogicFunction()` — et ne relèvent pas du modèle de déclencheur habituel (HTTP, cron, événements de base de données).
+
+Chaque application peut définir **au maximum une pré-installation** et **au maximum une post-installation**. La génération du manifeste renverra une erreur si plus d'une fonction de l'un ou l'autre type est détectée.
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│ install flow │
+│ │
+│ upload package → [pre-install] → metadata migration → │
+│ generate SDK → [post-install] │
+│ │
+│ old schema visible new schema visible │
+└─────────────────────────────────────────────────────────────┘
+```
+
+<AccordionGroup>
+<Accordion title="definePostInstallLogicFunction" description="S'exécute après l'application de la migration des métadonnées de l'espace de travail">
+
+Une fonction post-installation s'exécute automatiquement une fois l'installation de votre application sur un espace de travail terminée. Le serveur l'exécute **après** que les métadonnées de l'application ont été synchronisées et que le client du SDK a été généré, afin que l'espace de travail soit entièrement prêt à l'emploi et que le nouveau schéma soit en place. Les cas d'utilisation typiques incluent le préremplissage de données par défaut, la création d'enregistrements initiaux, la configuration des paramètres de l'espace de travail ou le provisionnement de ressources sur des services tiers.
+
+```ts src/logic-functions/post-install.ts
+import { definePostInstallLogicFunction, type InstallPayload } from 'twenty-sdk/define';
+
+const handler = async (payload: InstallPayload): Promise<void> => {
+ console.log('Post install logic function executed successfully!', payload.previousVersion);
+};
+
+export default definePostInstallLogicFunction({
+ universalIdentifier: 'f7a2b9c1-3d4e-5678-abcd-ef9876543210',
+ name: 'post-install',
+ description: 'Runs after installation to set up the application.',
+ timeoutSeconds: 300,
+ shouldRunOnVersionUpgrade: false,
+ shouldRunSynchronously: false,
+ handler,
+});
+```
+
+Vous pouvez également exécuter manuellement la fonction de post-installation à tout moment à l'aide de la CLI :
+
+```bash filename="Terminal"
+yarn twenty dev:function:exec --postInstall
+```
+
+Points clés :
+* Les fonctions de post-installation utilisent `definePostInstallLogicFunction()` — une variante spécialisée qui omet les paramètres de déclencheur (`cronTriggerSettings`, `databaseEventTriggerSettings`, `httpRouteTriggerSettings`, `toolTriggerSettings`, `workflowActionTriggerSettings`).
+* Le gestionnaire reçoit un `InstallPayload` avec `{ previousVersion?: string; newVersion: string }` — `newVersion` est la version en cours d'installation, et `previousVersion` est la version précédemment installée (ou `undefined` lors d'une nouvelle installation). Utilisez ces valeurs pour distinguer les nouvelles installations des mises à niveau et pour exécuter une logique de migration spécifique à la version.
+* **Quand le hook s'exécute** : uniquement lors des nouvelles installations, par défaut. Passez `shouldRunOnVersionUpgrade: true` si vous souhaitez également qu'il s'exécute lorsque l'application est mise à niveau depuis une version précédente. S'il est omis, l'indicateur vaut `false` par défaut et les mises à niveau ignorent le hook.
+* **Modèle d'exécution — asynchrone par défaut, synchrone sur opt-in** : l'indicateur `shouldRunSynchronously` contrôle *comment* post-install est exécuté.
+ * `shouldRunSynchronously: false` *(par défaut)* — le hook est **placé dans la file de messages** avec `retryLimit: 3` et s'exécute de manière asynchrone dans un worker. La réponse d'installation est renvoyée dès que la tâche est mise en file d'attente, de sorte qu'un gestionnaire lent ou défaillant ne bloque pas l'appelant. Le worker réessaiera jusqu'à trois fois. **Utilisez ceci pour les tâches de longue durée** — initialisation de grands jeux de données, appel d'API tierces lentes, provisionnement de ressources externes, tout ce qui pourrait dépasser une fenêtre de réponse HTTP raisonnable.
+ * `shouldRunSynchronously: true` — le hook est exécuté **en ligne pendant le flux d'installation** (même exécuteur que pre-install). La requête d'installation est bloquée jusqu'à la fin du gestionnaire et, s'il lève une exception, l'appelant de l'installation reçoit un `POST_INSTALL_ERROR`. Aucun réessai automatique. **Utilisez ceci pour un travail rapide devant être terminé avant la réponse** — par exemple, émettre une erreur de validation à l'utilisateur, ou une configuration rapide dont le client dépendra immédiatement après le retour de l'appel d'installation. Gardez à l'esprit que la migration des métadonnées a déjà été appliquée au moment où post-install s'exécute, donc un échec en mode synchrone ne **rétablit pas** les modifications du schéma — il ne fait qu'exposer l'erreur.
+* Assurez-vous que votre gestionnaire est idempotent. En mode asynchrone, la file peut réessayer jusqu'à trois fois ; dans les deux modes, le hook peut s'exécuter à nouveau lors des mises à niveau lorsque `shouldRunOnVersionUpgrade: true`.
+* Les variables d'environnement `APPLICATION_ID`, `APP_ACCESS_TOKEN` et `API_URL` sont disponibles dans le gestionnaire (comme pour toute autre fonction logique), vous pouvez donc appeler l'API Twenty avec un jeton d'accès d'application limité à votre application.
+* Une seule fonction de post-installation est autorisée par application. La génération du manifeste renverra une erreur si plusieurs sont détectées.
+* Les propriétés `universalIdentifier`, `shouldRunOnVersionUpgrade` et `shouldRunSynchronously` de la fonction sont automatiquement attachées au manifeste de l'application sous le champ `postInstallLogicFunction` pendant le build — vous n'avez pas besoin de les référencer dans [`defineApplication()`](/l/fr/developers/extend/apps/config/application).
+* Le délai d'expiration par défaut est défini à 300 secondes (5 minutes) pour permettre des tâches de configuration plus longues comme l'initialisation des données.
+* **Non exécuté en mode dev** : lorsqu'une application est enregistrée localement (via `yarn twenty dev`), le serveur saute complètement le flux d'installation et synchronise les fichiers directement via le watcher de la CLI — ainsi, post-install ne s'exécute jamais en mode dev, quel que soit `shouldRunSynchronously`. Utilisez `yarn twenty dev:function:exec --postInstall` pour le déclencher manuellement sur un espace de travail en cours d'exécution.
+
+</Accordion>
+<Accordion title="definePreInstallLogicFunction" description="S'exécute avant l'application de la migration des métadonnées de l'espace de travail">
+
+Une fonction de pré-installation s'exécute automatiquement pendant l'installation, **avant que la migration des métadonnées de l'espace de travail soit appliquée**. Elle partage la même forme de payload que post-install (`InstallPayload`), mais elle est positionnée plus tôt dans le flux d'installation afin de pouvoir préparer l'état dont dépend la migration à venir — les usages typiques incluent la sauvegarde de données, la validation de la compatibilité avec le nouveau schéma, ou l'archivage d'enregistrements sur le point d'être restructurés ou supprimés.
+
+```ts src/logic-functions/pre-install.ts
+import { definePreInstallLogicFunction, type InstallPayload } from 'twenty-sdk/define';
+
+const handler = async (payload: InstallPayload): Promise<void> => {
+ console.log('Pre install logic function executed successfully!', payload.previousVersion);
+};
+
+export default definePreInstallLogicFunction({
+ universalIdentifier: 'a1b2c3d4-5678-90ab-cdef-1234567890ab',
+ name: 'pre-install',
+ description: 'Runs before installation to prepare the application.',
+ timeoutSeconds: 300,
+ shouldRunOnVersionUpgrade: true,
+ handler,
+});
+```
+
+Vous pouvez également exécuter manuellement la fonction de pré-installation à tout moment à l'aide de la CLI :
+
+```bash filename="Terminal"
+yarn twenty dev:function:exec --preInstall
+```
+
+Points clés :
+* Les fonctions de pré-installation utilisent `definePreInstallLogicFunction()` — même configuration spécialisée que post-install, simplement attachée à un autre emplacement du cycle de vie.
+* Les gestionnaires de pré- et post-install reçoivent le même type `InstallPayload` : `{ previousVersion?: string; newVersion: string }`. Importez-le une fois et réutilisez-le pour les deux hooks.
+* **Quand le hook s'exécute** : positionné juste avant la migration des métadonnées de l'espace de travail (`synchronizeFromManifest`). Avant l'exécution, le serveur lance une « synchronisation réduite » purement additive qui enregistre la fonction de pré-installation de la **nouvelle** version dans les métadonnées de l'espace de travail — rien d'autre n'est modifié — puis l'exécute. Comme cette synchronisation est uniquement additive, les objets, champs et données de la version précédente sont toujours intacts lorsque votre gestionnaire s'exécute : vous pouvez lire et sauvegarder en toute sécurité l'état pré-migration.
+* **Modèle d'exécution** : la pré-installation est exécutée **de façon synchrone** et **bloque l'installation**. Si le gestionnaire lève une exception, l'installation est abandonnée avant que des modifications du schéma ne soient appliquées — l'espace de travail reste sur la version précédente dans un état cohérent. C'est intentionnel : la pré-installation est votre dernière chance de refuser une mise à niveau risquée.
+* Comme pour post-install, une seule fonction de pré-installation est autorisée par application. Elle est automatiquement attachée au manifeste de l'application sous `preInstallLogicFunction` pendant le build.
+* **Non exécuté en mode dev** : comme pour post-install — le flux d'installation est entièrement ignoré pour les applications enregistrées localement, donc la pré-installation ne s'exécute jamais sous `yarn twenty dev`. Utilisez `yarn twenty dev:function:exec --preInstall` pour la déclencher manuellement.
+
+</Accordion>
+<Accordion title="Pré-installation vs post-installation : quand utiliser quoi" description="Choisir le bon hook d'installation">
+
+Les deux hooks font partie du même flux d'installation et reçoivent le même `InstallPayload`. La différence tient au **moment** où ils s'exécutent par rapport à la migration des métadonnées de l'espace de travail, et cela change les données qu'ils peuvent manipuler en toute sécurité.
+
+La pré-installation est toujours **synchrone** (elle bloque l'installation et peut l'interrompre). Post-install est **asynchrone par défaut** — mis en file d'attente sur un worker avec des réessais automatiques — mais peut opter pour une exécution synchrone avec `shouldRunSynchronously: true`. Voir l'accordéon `definePostInstallLogicFunction` ci-dessus pour savoir quand utiliser chaque mode.
+
+**Utilisez `post-install` pour tout ce qui nécessite l'existence du nouveau schéma.** C'est le cas le plus courant :
+
+* Initialiser des données par défaut (création d'enregistrements initiaux, de vues par défaut, de contenu de démonstration) sur des objets et champs nouvellement ajoutés.
+* Enregistrer des webhooks auprès de services tiers maintenant que l'application dispose de ses identifiants.
+* Appeler votre propre API pour finaliser une configuration qui dépend des métadonnées synchronisées.
+* Logique idempotente « assurer l'existence de cet élément » qui doit réconcilier l'état à chaque mise à niveau — à combiner avec `shouldRunOnVersionUpgrade: true`.
+
+Exemple — initialiser un enregistrement `PostCard` par défaut après l'installation :
+
+```ts src/logic-functions/post-install.ts
+import { definePostInstallLogicFunction, type InstallPayload } from 'twenty-sdk/define';
+import { createClient } from './generated/client';
+
+const handler = async ({ previousVersion }: InstallPayload): Promise<void> => {
+ if (previousVersion) return; // fresh installs only
+
+ const client = createClient();
+ await client.postCard.create({
+ data: { title: 'Welcome to Postcard', content: 'Your first card!' },
+ });
+};
+
+export default definePostInstallLogicFunction({
+ universalIdentifier: 'f7a2b9c1-3d4e-5678-abcd-ef9876543210',
+ name: 'post-install',
+ description: 'Seeds a welcome post card after install.',
+ timeoutSeconds: 300,
+ shouldRunOnVersionUpgrade: false,
+ handler,
+});
+```
+
+**Utilisez `pre-install` lorsqu'une migration détruirait ou corromprait autrement des données existantes.** Comme la pré-installation s'exécute sur le schéma *précédent* et qu'un échec annule la mise à niveau, c'est l'endroit approprié pour tout ce qui est risqué :
+
+* **Sauvegarder des données sur le point d'être supprimées ou restructurées** — par exemple, vous supprimez un champ en v2 et devez copier ses valeurs dans un autre champ ou les exporter vers un stockage avant l'exécution de la migration.
+* **Archiver des enregistrements qu'une nouvelle contrainte invaliderait** — par exemple, un champ devient `NOT NULL` et vous devez d'abord supprimer ou corriger les lignes avec des valeurs nulles.
+* **Valider la compatibilité et refuser la mise à niveau si les données actuelles ne peuvent pas être migrées proprement** — lancez une exception depuis le gestionnaire et l'installation s'interrompt sans appliquer de modifications. C'est plus sûr que de découvrir l'incompatibilité en cours de migration.
+* **Renommer ou réassigner les clés des données** avant une modification du schéma qui ferait perdre l'association.
+
+Exemple — archiver des enregistrements avant une migration destructive :
+
+```ts src/logic-functions/pre-install.ts
+import { definePreInstallLogicFunction, type InstallPayload } from 'twenty-sdk/define';
+import { createClient } from './generated/client';
+
+const handler = async ({ previousVersion, newVersion }: InstallPayload): Promise<void> => {
+ // Only the 1.x → 2.x upgrade drops the legacy `notes` field.
+ if (!previousVersion?.startsWith('1.') || !newVersion.startsWith('2.')) {
+ return;
+ }
+
+ const client = createClient();
+ const legacyRecords = await client.postCard.findMany({
+ where: { notes: { isNotNull: true } },
+ });
+
+ if (legacyRecords.length === 0) return;
+
+ // Copy legacy `notes` into the new `description` field before the migration
+ // drops the `notes` column. If this fails, the upgrade is aborted and the
+ // workspace stays on v1 with all data intact.
+ await Promise.all(
+ legacyRecords.map((record) =>
+ client.postCard.update({
+ where: { id: record.id },
+ data: { description: record.notes },
+ }),
+ ),
+ );
+};
+
+export default definePreInstallLogicFunction({
+ universalIdentifier: 'a1b2c3d4-5678-90ab-cdef-1234567890ab',
+ name: 'pre-install',
+ description: 'Backs up legacy notes into description before the v2 migration.',
+ timeoutSeconds: 300,
+ shouldRunOnVersionUpgrade: true,
+ handler,
+});
+```
+
+**Règle générale :**
+
+| Vous souhaitez... | Utiliser |
+| ------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------ |
+| Initialiser des données par défaut, configurer l'espace de travail, enregistrer des ressources externes | `post-install` |
+| Exécuter une initialisation longue ou des appels tiers qui ne doivent pas bloquer la réponse d'installation | `post-install` (par défaut — `shouldRunSynchronously: false`, avec des réessais du worker) |
+| Exécuter une configuration rapide dont l'appelant dépendra immédiatement après le retour de l'appel d'installation | `post-install` avec `shouldRunSynchronously: true` |
+| Lire ou sauvegarder des données que la migration à venir ferait perdre | `pre-install` |
+| Rejeter une mise à niveau qui corromprait des données existantes | `pre-install` (lancer une exception depuis le gestionnaire) |
+| Exécuter une réconciliation à chaque mise à niveau | `post-install` avec `shouldRunOnVersionUpgrade: true` |
+| Effectuer une configuration ponctuelle uniquement lors de la première installation | `post-install` avec `shouldRunOnVersionUpgrade: false` (par défaut) |
+
+<Note>
+En cas de doute, privilégiez **post-install**. Ne recourez à la pré-installation que lorsque la migration elle-même est destructive et que vous devez intercepter l'état précédent avant qu'il ne disparaisse.
+</Note>
+
+</Accordion>
+</AccordionGroup>
diff --git a/packages/twenty-docs/l/fr/developers/extend/apps/config/overview.mdx b/packages/twenty-docs/l/fr/developers/extend/apps/config/overview.mdx
new file mode 100644
index 00000000000..73cd432e83e
--- /dev/null
+++ b/packages/twenty-docs/l/fr/developers/extend/apps/config/overview.mdx
@@ -0,0 +1,51 @@
+---
+title: Vue d'ensemble
+description: Configurer l'application elle-même — son identité, ses autorisations par défaut et ce qui s'exécute au moment de l'installation.
+icon: screwdriver-wrench
+---
+
+La **couche de configuration** d'une application Twenty est ce qui décrit l'application *à la plateforme* — son identité, les autorisations qu'elle détient et le code qui s'exécute lors de l'installation ou de la mise à niveau. Ces déclarations n'ajoutent pas de nouvelles structures de données ni de comportement à l'exécution ; elles indiquent à Twenty *qui est l'application* et *comment la configurer*.
+
+```text
+┌────────────────────────────────────────────────────────┐
+│ Application — identity, default role, variables, │
+│ marketplace metadata │
+│ │
+│ ┌──────────────────────────────────────────────────┐ │
+│ │ Role — what the app's logic functions can read │ │
+│ │ and write (referenced by Application) │ │
+│ └──────────────────────────────────────────────────┘ │
+└────────────────────────────────────────────────────────┘
+ │
+ ▼ (at install / upgrade time)
+ ┌──────────────────────────────────┐
+ │ Pre-install hook │ before metadata migration
+ └──────────────────────────────────┘
+ ┌──────────────────────────────────┐
+ │ Post-install hook │ after metadata migration
+ └──────────────────────────────────┘
+```
+
+## Dans cette section
+
+<CardGroup cols={2}>
+ <Card title="Configuration de l'application" icon="rocket" href="/l/fr/developers/extend/apps/config/application">
+ `defineApplication` — identité, rôle par défaut, variables, métadonnées de la marketplace.
+ </Card>
+ <Card title="Rôles et autorisations" icon="shield-halved" href="/l/fr/developers/extend/apps/config/roles">
+ `defineRole` — déclarez ce que les fonctions logiques de votre application peuvent lire et écrire.
+ </Card>
+ <Card title="Hooks d'installation" icon="wrench" href="/l/fr/developers/extend/apps/config/install-hooks">
+ `definePreInstallLogicFunction` et `definePostInstallLogicFunction` — sauvegarder les données, préremplir les valeurs par défaut, valider les mises à niveau.
+ </Card>
+</CardGroup>
+
+## Comment les éléments s'articulent
+
+* L'**application** est le point d'entrée. Chaque application comporte exactement un appel à `defineApplication()` qui pointe vers un **Rôle** par défaut.
+* Le **Rôle** contrôle ce que les fonctions logiques et les composants frontaux de l'application peuvent lire et écrire. Suivez le principe du moindre privilège : accordez uniquement les autorisations dont votre code a réellement besoin.
+* Les **hooks d'installation** s'exécutent lors de l'installation ou de la mise à niveau — la pré-installation avant la migration des métadonnées (ce qui permet de refuser une mise à niveau risquée), la post-installation après la migration (ce qui permet de préremplir les données par défaut selon le nouveau schéma).
+
+<Note>
+Les hooks d'installation partagent l'environnement d'exécution des [fonctions logiques](/l/fr/developers/extend/apps/logic/logic-functions) — même signature de handler, mêmes variables d'environnement, même client d'API typé — mais ils sont déclarés avec leurs propres fonctions `define` et vivent en dehors du modèle de déclencheurs habituel (HTTP, cron, événements de base de données).
+</Note>
diff --git a/packages/twenty-docs/l/fr/developers/extend/apps/config/public-assets.mdx b/packages/twenty-docs/l/fr/developers/extend/apps/config/public-assets.mdx
new file mode 100644
index 00000000000..a4e76426f9d
--- /dev/null
+++ b/packages/twenty-docs/l/fr/developers/extend/apps/config/public-assets.mdx
@@ -0,0 +1,67 @@
+---
+title: Ressources publiques
+description: Distribuez des fichiers statiques — images, icônes, polices — avec votre application via le dossier public/.
+icon: folder-open
+---
+
+Le dossier `public/` à la racine de votre application contient des fichiers statiques — images, icônes, polices ou toute autre ressource dont votre application a besoin à l'exécution. Ces fichiers sont automatiquement inclus dans les builds, synchronisés pendant le mode de développement et téléversés vers le serveur.
+
+Les fichiers placés dans `public/` sont :
+
+* **Accessibles publiquement** — une fois synchronisés avec le serveur, les fichiers sont servis à une URL publique. Aucune authentification n'est nécessaire pour y accéder.
+* **Disponibles dans les composants frontaux** — utilisez les URL des ressources pour afficher des images, des icônes ou tout média dans vos composants React.
+* **Disponibles dans les fonctions logiques** — référencez des URL de ressources dans des e-mails, des réponses d'API ou toute logique côté serveur.
+* **Utilisés pour les métadonnées de marketplace** — les champs `logoUrl` et `screenshots` dans `defineApplication()` référencent des fichiers de ce dossier (p. ex., `public/logo.png`). Celles-ci sont affichées dans la marketplace lorsque votre application est publiée.
+* **Synchronisés automatiquement en mode dev** — lorsque vous ajoutez, mettez à jour ou supprimez un fichier dans `public/`, il est automatiquement synchronisé avec le serveur. Aucun redémarrage nécessaire.
+* **Inclus dans les builds** — `yarn twenty dev:build` regroupe toutes les ressources publiques dans la sortie de distribution.
+
+## Accéder aux ressources publiques avec `getPublicAssetUrl`
+
+Utilisez l'utilitaire `getPublicAssetUrl` de `twenty-sdk` pour obtenir l'URL complète d'un fichier dans votre répertoire `public/`. Cela fonctionne à la fois dans les **fonctions logiques** et les **composants frontaux**.
+
+**Dans une fonction logique :**
+
+```ts src/logic-functions/send-invoice.ts
+import { defineLogicFunction } from 'twenty-sdk/define';
+import { getPublicAssetUrl } from 'twenty-sdk/utils';
+
+const handler = async (): Promise<any> => {
+ const logoUrl = getPublicAssetUrl('logo.png');
+ const invoiceUrl = getPublicAssetUrl('templates/invoice.png');
+
+ // Fetch the file content (no auth required — public endpoint)
+ const response = await fetch(invoiceUrl);
+ const buffer = await response.arrayBuffer();
+
+ return { logoUrl, size: buffer.byteLength };
+};
+
+export default defineLogicFunction({
+ universalIdentifier: 'a1b2c3d4-...',
+ name: 'send-invoice',
+ description: 'Sends an invoice with the app logo',
+ timeoutSeconds: 10,
+ handler,
+});
+```
+
+**Dans un composant frontal :**
+
+```tsx src/front-components/company-card.tsx
+import { defineFrontComponent } from 'twenty-sdk/define';
+import { getPublicAssetUrl } from 'twenty-sdk/utils';
+
+const CompanyCard = () => {
+ const logoUrl = getPublicAssetUrl('logo.png');
+
+ return <img src={logoUrl} alt="App logo" />;
+};
+
+export default defineFrontComponent({
+ universalIdentifier: '...',
+ name: 'company-card',
+ component: CompanyCard,
+});
+```
+
+L'argument `path` est relatif au dossier `public/` de votre application. Les deux `getPublicAssetUrl('logo.png')` et `getPublicAssetUrl('public/logo.png')` aboutissent à la même URL — le préfixe `public/` est supprimé automatiquement s'il est présent.
diff --git a/packages/twenty-docs/l/fr/developers/extend/apps/config/roles.mdx b/packages/twenty-docs/l/fr/developers/extend/apps/config/roles.mdx
new file mode 100644
index 00000000000..13435c9d7bd
--- /dev/null
+++ b/packages/twenty-docs/l/fr/developers/extend/apps/config/roles.mdx
@@ -0,0 +1,94 @@
+---
+title: Rôles et autorisations
+description: Déclarez quels objets et champs les fonctions de logique et les composants frontaux de votre application peuvent lire et écrire.
+icon: shield-halved
+---
+
+Un **rôle** est un ensemble d’autorisations : quels objets une application peut lire ou écrire, quels champs elle peut voir et quelles fonctionnalités de plateforme elle peut utiliser. Les fonctions de logique et les composants frontaux de chaque application héritent des autorisations du rôle marqué avec `defineApplicationRole()` (voir [Le rôle de fonction par défaut](#the-default-function-role) ci-dessous).
+
+```ts src/roles/restricted-company-role.ts
+import {
+ defineRole,
+ STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS,
+ SystemPermissionFlag,
+} from 'twenty-sdk/define';
+
+export default defineRole({
+ universalIdentifier: '2c80f640-2083-4803-bb49-003e38279de6',
+ label: 'My new role',
+ description: 'A role that can be used in your workspace',
+ canReadAllObjectRecords: false,
+ canUpdateAllObjectRecords: false,
+ canSoftDeleteAllObjectRecords: false,
+ canDestroyAllObjectRecords: false,
+ canUpdateAllSettings: false,
+ canBeAssignedToAgents: false,
+ canBeAssignedToUsers: false,
+ canBeAssignedToApiKeys: false,
+ objectPermissions: [
+ {
+ objectUniversalIdentifier:
+ STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS.company.universalIdentifier,
+ canReadObjectRecords: true,
+ canUpdateObjectRecords: true,
+ canSoftDeleteObjectRecords: false,
+ canDestroyObjectRecords: false,
+ },
+ ],
+ fieldPermissions: [
+ {
+ objectUniversalIdentifier:
+ STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS.company.universalIdentifier,
+ fieldUniversalIdentifier:
+ STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS.company.fields.name
+ .universalIdentifier,
+ canReadFieldValue: false,
+ canUpdateFieldValue: false,
+ },
+ ],
+ permissionFlagUniversalIdentifiers: [SystemPermissionFlag.APPLICATIONS],
+});
+```
+
+## Le rôle de fonction par défaut
+
+Lorsque vous générez une nouvelle application, la CLI crée un fichier de rôle par défaut déclaré avec `defineApplicationRole()` :
+
+```ts src/roles/default-role.ts
+import { defineApplicationRole } from 'twenty-sdk/define';
+
+export const DEFAULT_ROLE_UNIVERSAL_IDENTIFIER =
+ 'b648f87b-1d26-4961-b974-0908fd991061';
+
+export default defineApplicationRole({
+ universalIdentifier: DEFAULT_ROLE_UNIVERSAL_IDENTIFIER,
+ label: 'Default function role',
+ description: 'Default role for function Twenty client',
+ canReadAllObjectRecords: true,
+ canUpdateAllObjectRecords: false,
+ canSoftDeleteAllObjectRecords: false,
+ canDestroyAllObjectRecords: false,
+ canUpdateAllSettings: false,
+ canBeAssignedToAgents: false,
+ canBeAssignedToUsers: false,
+ canBeAssignedToApiKeys: false,
+ objectPermissions: [],
+ fieldPermissions: [],
+ permissionFlagUniversalIdentifiers: [],
+});
+```
+
+`defineApplicationRole()` est un léger wrapper autour de `defineRole()` qui marque le rôle utilisé comme rôle par défaut de votre application au moment de l’installation. La validation est identique à `defineRole`, mais le pipeline de build connecte automatiquement son `universalIdentifier` au champ `defaultRoleUniversalIdentifier` du manifeste de l’application — vous n’avez donc pas besoin de le référencer vous-même depuis [`defineApplication`](/l/fr/developers/extend/apps/config/application).
+
+Notes :
+
+* Exactement **un** `defineApplicationRole(...)` est autorisé par application — la génération du manifeste échouera si elle en trouve plus d’un.
+* Utilisez `defineRole()` (et non `defineApplicationRole()`) pour tous les rôles **supplémentaires** fournis par votre application.
+* Le fait de définir explicitement `defaultRoleUniversalIdentifier` dans `defineApplication()` est toujours pris en charge pour assurer la rétrocompatibilité, mais c’est obsolète et remplacé par `defineApplicationRole()`.
+
+## Meilleures pratiques
+
+* Partez du rôle généré par le gabarit, puis restreignez-le progressivement — par défaut, il accorde un large accès en lecture, ce qui correspond rarement à ce que vous voulez en production.
+* Remplacez `objectPermissions` et `fieldPermissions` par les objets et champs dont vos fonctions ont réellement besoin.
+* `permissionFlagUniversalIdentifiers` contrôlent l’accès aux capacités au niveau de la plateforme. Maintenez-les au strict minimum.
+* Voir un exemple fonctionnel : [`hello-world/src/roles/function-role.ts`](https://github.com/twentyhq/twenty/blob/main/packages/twenty-apps/hello-world/src/roles/function-role.ts).
diff --git a/packages/twenty-docs/l/fr/developers/extend/apps/data/extending-objects.mdx b/packages/twenty-docs/l/fr/developers/extend/apps/data/extending-objects.mdx
new file mode 100644
index 00000000000..0983c17b698
--- /dev/null
+++ b/packages/twenty-docs/l/fr/developers/extend/apps/data/extending-objects.mdx
@@ -0,0 +1,50 @@
+---
+title: Extension des objets
+description: Ajoutez des champs aux objets standard de Twenty (Person, Company, …) ou aux objets d'autres applications en utilisant defineField.
+icon: wand-magic-sparkles
+---
+
+Utilisez `defineField()` pour ajouter un champ à un objet que vous ne possédez pas — un objet standard de Twenty comme Person ou Company, ou un objet fourni par une autre application installée. Contrairement aux champs en ligne déclarés à l'intérieur de [`defineObject`](/l/fr/developers/extend/apps/data/objects), les champs autonomes nécessitent un `objectUniversalIdentifier` pour préciser l'objet qu'ils étendent.
+
+```ts src/fields/company-loyalty-tier.field.ts
+import { defineField, FieldType } from 'twenty-sdk/define';
+
+export default defineField({
+ universalIdentifier: 'f2a1b3c4-d5e6-7890-abcd-ef1234567890',
+ objectUniversalIdentifier: '701aecb9-eb1c-4d84-9d94-b954b231b64b', // Company object
+ name: 'loyaltyTier',
+ type: FieldType.SELECT,
+ label: 'Loyalty Tier',
+ icon: 'IconStar',
+ options: [
+ { value: 'BRONZE', label: 'Bronze', position: 0, color: 'orange' },
+ { value: 'SILVER', label: 'Silver', position: 1, color: 'gray' },
+ { value: 'GOLD', label: 'Gold', position: 2, color: 'yellow' },
+ ],
+});
+```
+
+## Points clés
+
+* `objectUniversalIdentifier` identifie l'objet cible. Pour les objets standard de Twenty, importez la constante depuis `twenty-sdk` :
+
+ ```ts
+ import { STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS } from 'twenty-sdk/define';
+
+ // STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS.company.universalIdentifier
+ // STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS.person.universalIdentifier
+ // STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS.opportunity.universalIdentifier
+ // …
+ ```
+
+* Lorsque vous définissez des champs **en ligne dans `defineObject()`**, vous n'avez **pas** besoin de `objectUniversalIdentifier` — il est hérité de l'objet parent.
+
+* `defineField()` est la seule manière d'ajouter des champs à des objets que vous n'avez pas créés avec `defineObject()`.
+
+* L’emplacement du fichier est à votre discrétion. La convention est `src/fields/\<name>.field.ts`, mais le SDK détecte les champs n'importe où dans `src/`.
+
+* Pour ajouter un onglet à une mise en page standard (par exemple la page de détail de Task ou de Company), utilisez [`definePageLayoutTab`](/l/fr/developers/extend/apps/layout/page-layouts#definepagelayouttab) avec `STANDARD_PAGE_LAYOUT_UNIVERSAL_IDENTIFIERS` depuis `twenty-sdk/define`.
+
+## Ajouter une relation à un objet existant
+
+Pour ajouter un champ de relation (par exemple pour lier votre objet personnalisé à un `Person` standard), utilisez `defineField()` avec `FieldType.RELATION`. Le modèle est le même que pour les relations en ligne, mais avec `objectUniversalIdentifier` défini explicitement. Voir [Relations](/l/fr/developers/extend/apps/data/relations) pour le modèle bidirectionnel.
diff --git a/packages/twenty-docs/l/fr/developers/extend/apps/data/objects.mdx b/packages/twenty-docs/l/fr/developers/extend/apps/data/objects.mdx
new file mode 100644
index 00000000000..ba20c8262ae
--- /dev/null
+++ b/packages/twenty-docs/l/fr/developers/extend/apps/data/objects.mdx
@@ -0,0 +1,104 @@
+---
+title: Objets
+description: Déclarez de nouveaux types d’enregistrements — des tables personnalisées avec leurs propres champs — à l’aide de defineObject.
+icon: table
+---
+
+Les **objets** personnalisés sont de nouveaux types d’enregistrements que votre application ajoute à un espace de travail — carte postale, facture, abonnement, tout ce qui est spécifique à votre domaine. Chaque objet déclare son schéma (champs, relations, valeurs par défaut) et un identifiant universel stable qui survit aux synchronisations et aux déploiements.
+
+```ts src/objects/post-card.object.ts
+import { defineObject, FieldType } from 'twenty-sdk/define';
+
+enum PostCardStatus {
+ DRAFT = 'DRAFT',
+ SENT = 'SENT',
+ DELIVERED = 'DELIVERED',
+ RETURNED = 'RETURNED',
+}
+
+export default defineObject({
+ universalIdentifier: '54b589ca-eeed-4950-a176-358418b85c05',
+ nameSingular: 'postCard',
+ namePlural: 'postCards',
+ labelSingular: 'Post Card',
+ labelPlural: 'Post Cards',
+ description: 'A post card object',
+ icon: 'IconMail',
+ fields: [
+ {
+ universalIdentifier: '58a0a314-d7ea-4865-9850-7fb84e72f30b',
+ name: 'content',
+ type: FieldType.TEXT,
+ label: 'Content',
+ description: "Postcard's content",
+ icon: 'IconAbc',
+ },
+ {
+ universalIdentifier: 'c6aa31f3-da76-4ac6-889f-475e226009ac',
+ name: 'recipientName',
+ type: FieldType.FULL_NAME,
+ label: 'Recipient name',
+ icon: 'IconUser',
+ },
+ {
+ universalIdentifier: '95045777-a0ad-49ec-98f9-22f9fc0c8266',
+ name: 'recipientAddress',
+ type: FieldType.ADDRESS,
+ label: 'Recipient address',
+ icon: 'IconHome',
+ },
+ {
+ universalIdentifier: '87b675b8-dd8c-4448-b4ca-20e5a2234a1e',
+ name: 'status',
+ type: FieldType.SELECT,
+ label: 'Status',
+ icon: 'IconSend',
+ defaultValue: `'${PostCardStatus.DRAFT}'`,
+ options: [
+ { value: PostCardStatus.DRAFT, label: 'Draft', position: 0, color: 'gray' },
+ { value: PostCardStatus.SENT, label: 'Sent', position: 1, color: 'orange' },
+ { value: PostCardStatus.DELIVERED, label: 'Delivered', position: 2, color: 'green' },
+ { value: PostCardStatus.RETURNED, label: 'Returned', position: 3, color: 'orange' },
+ ],
+ },
+ {
+ universalIdentifier: 'e06abe72-5b44-4e7f-93be-afc185a3c433',
+ name: 'deliveredAt',
+ type: FieldType.DATE_TIME,
+ label: 'Delivered at',
+ icon: 'IconCheck',
+ isNullable: true,
+ defaultValue: null,
+ },
+ ],
+});
+```
+
+## Points clés
+
+* Le `universalIdentifier` doit être unique et stable entre les déploiements.
+* Chaque champ nécessite un `name`, un `type`, un `label` et son propre `universalIdentifier` stable.
+* Le tableau `fields` est facultatif — vous pouvez définir des objets sans champs personnalisés.
+* Les champs en ligne définis ici n’ont **pas** besoin d’un `objectUniversalIdentifier` — il est hérité de l’objet parent. Utilisez [`defineField()`](/l/fr/developers/extend/apps/data/extending-objects) pour ajouter des champs aux objets que vous ne possédez pas.
+* Vous pouvez générer de nouveaux objets avec `yarn twenty dev:add object`, qui vous guide à travers le nommage, les champs et les relations. Voir [Architecture → Scaffolding entities](/l/fr/developers/extend/apps/getting-started/scaffolding).
+
+<Note>
+**Les champs de base sont ajoutés automatiquement.** Lorsque vous définissez un objet personnalisé, Twenty crée pour vous des champs standard comme `id`, `name`, `createdAt`, `updatedAt`, `createdBy`, `updatedBy` et `deletedAt`. Vous n’avez pas besoin de les déclarer dans votre tableau `fields` — uniquement vos champs personnalisés. Vous pouvez remplacer un champ par défaut en en déclarant un avec le même nom, mais c’est rarement une bonne idée.
+</Note>
+
+## Valeurs par défaut
+
+Les valeurs par défaut de type chaîne littérale doivent être entourées de guillemets simples **à l’intérieur** de la chaîne — `defaultValue: "'Draft'"`, et non `defaultValue: "Draft"`. C’est pourquoi le champ `status` ci-dessus utilise `` `'${PostCardStatus.DRAFT}'` ``.
+
+Les chaînes sans guillemets sont réservées aux valeurs par défaut calculées, évaluées lors de la création d’un enregistrement :
+
+* `'uuid'` — génère un UUID (pour les champs `UUID`)
+* `'now'` — l’horodatage actuel (pour les champs `DATE_TIME`)
+
+La même convention s’applique aux sous-champs de type chaîne des valeurs par défaut composites (par exemple `{ source: "'MANUAL'" }` sur un champ `ACTOR`) ainsi qu’aux valeurs `SELECT`/`MULTI_SELECT`. Une valeur par défaut littérale de type chaîne laissée sans guillemets génère un avertissement lors de la compilation de votre application.
+
+## Et après
+
+* **Connectez cet objet aux autres** — voir [Relations](/l/fr/developers/extend/apps/data/relations) pour le modèle de relation bidirectionnelle.
+* **Ajoutez des champs aux objets d’autres applications** — voir [Extending Objects](/l/fr/developers/extend/apps/data/extending-objects) pour `defineField()`.
+* **Affichez cet objet dans l’interface utilisateur** — voir [Views](/l/fr/developers/extend/apps/layout/views) et [Navigation Menu Items](/l/fr/developers/extend/apps/layout/navigation-menu-items) pour l’ajouter à la barre latérale.
diff --git a/packages/twenty-docs/l/fr/developers/extend/apps/data/overview.mdx b/packages/twenty-docs/l/fr/developers/extend/apps/data/overview.mdx
new file mode 100644
index 00000000000..af1fb745fcc
--- /dev/null
+++ b/packages/twenty-docs/l/fr/developers/extend/apps/data/overview.mdx
@@ -0,0 +1,97 @@
+---
+title: Vue d'ensemble
+description: Façonnez les données que votre application ajoute à un espace de travail — objets, champs et relations.
+icon: database
+---
+
+La **couche de données** d’une application Twenty correspond aux données que votre application *ajoute* à un espace de travail — les nouveaux types d’enregistrements qu’elle déclare, les colonnes qu’elle ajoute aux objets existants et la manière dont ces enregistrements sont reliés les uns aux autres.
+
+```text
+┌──────────────────────────────────────────────────┐
+│ Object — a record type, e.g. PostCard │
+│ ├─ Field (name, type, label) │
+│ ├─ Field │
+│ └─ Relation (link to another object) │
+└──────────────────────────────────────────────────┘
+ │
+ ├── lives in your app, OR
+ │
+ ▼
+┌──────────────────────────────────────────────────┐
+│ Standard / other apps' objects │
+│ └─ Field added by your app via defineField │
+└──────────────────────────────────────────────────┘
+```
+
+## Dans cette section
+
+<CardGroup cols={2}>
+ <Card title="Objets" icon="table" href="/l/fr/developers/extend/apps/data/objects">
+ `defineObject` — déclarez de nouveaux types d’enregistrements avec leurs propres champs.
+ </Card>
+ <Card title="Extension des objets" icon="wand-magic-sparkles" href="/l/fr/developers/extend/apps/data/extending-objects">
+ `defineField` — ajoutez des champs aux objets standard ou à ceux d’autres applications.
+ </Card>
+ <Card title="Relations" icon="diagram-project" href="/l/fr/developers/extend/apps/data/relations">
+ Connexions bidirectionnelles `MANY_TO_ONE` / `ONE_TO_MANY` entre objets.
+ </Card>
+</CardGroup>
+
+## Aperçu des entités
+
+| Entité | Objectif | Défini avec |
+| ------------ | ------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------- |
+| **Objet** | Un nouveau type d’enregistrement personnalisé (par ex. PostCard, Invoice) avec ses propres champs | `defineObject()` |
+| **Champ** | Une colonne d’un objet. Les champs autonomes peuvent étendre des objets que vous n’avez pas créés (par ex. ajouter `loyaltyTier` à Company) | `defineField()` |
+| **Relation** | Un lien bidirectionnel entre deux objets — les deux côtés étant déclarés comme des champs | `defineField()` avec `FieldType.RELATION` |
+| **Index** | Un index de base de données pour accélérer une requête récurrente sur l’un de vos objets | `defineIndex()` |
+
+Le SDK les détecte via une analyse AST au moment de la compilation, donc l’organisation des fichiers vous appartient — la convention est `src/objects/`, `src/fields/` et `src/indexes/`. Des UUID `universalIdentifier` stables relient tout d’un déploiement à l’autre.
+
+## Index (optionnels)
+
+Les applications peuvent fournir des index avec leurs objets pour que les requêtes récurrentes restent rapides. Le cas le plus courant est une colonne de statut ou de clé étrangère que vous lisez fréquemment.
+
+```ts src/indexes/post-card-status.index.ts
+import { defineIndex } from 'twenty-sdk/define';
+
+import {
+ POST_CARD_UNIVERSAL_IDENTIFIER,
+ STATUS_FIELD_UNIVERSAL_IDENTIFIER,
+} from '../objects/post-card.object';
+
+export default defineIndex({
+ universalIdentifier: 'b6e9d2a1-5a4c-46ca-9d52-42c8f02d1ff0',
+ objectUniversalIdentifier: POST_CARD_UNIVERSAL_IDENTIFIER,
+ fields: [
+ {
+ universalIdentifier: 'b6e9d2a1-5a4c-46ca-9d52-42c8f02d1ff1',
+ fieldUniversalIdentifier: STATUS_FIELD_UNIVERSAL_IDENTIFIER,
+ },
+ ],
+});
+```
+
+### Index uniques
+
+`defineIndex` accepte `isUnique: true` pour l’unicité sur une ou plusieurs colonnes. C’est la primitive recommandée — `defineField({ isUnique: true })` est obsolète et sera supprimé dans une future version.
+
+```ts
+defineIndex({
+ universalIdentifier: '…',
+ objectUniversalIdentifier: PERSON_UNIVERSAL_IDENTIFIER,
+ isUnique: true,
+ fields: [{ universalIdentifier: '…', fieldUniversalIdentifier: EMAIL_FIELD_UNIVERSAL_IDENTIFIER }],
+});
+```
+
+### Autres contraintes
+
+* Les clauses `WHERE` partielles restent sous le contrôle de l’administrateur — les applications ne peuvent pas les déclarer.
+* Chaque objet est limité à 10 index personnalisés (les index propres au framework ne comptent pas).
+
+Ordonnez le tableau `fields` dans l’ordre dans lequel Postgres doit l’utiliser — colonne la plus à gauche en premier, comme dans un annuaire téléphonique. Les index ne sont pas gratuits : chaque écriture dans la table les met à jour. Ajoutez-en un uniquement lorsque vous avez une requête qui en a besoin.
+
+<Note>
+Vous cherchez **Application Config** ou **Roles & Permissions** ? Ces éléments décrivent l’application elle-même plutôt que les données qu’elle ajoute — ils se trouvent sous [Config](/l/fr/developers/extend/apps/config/overview). Vous cherchez **Connections** (Linear, GitHub, Slack OAuth) ? Ceux-ci existent pour être appelés *depuis* des fonctions logiques et se trouvent sous [Logic](/l/fr/developers/extend/apps/logic/connections).
+</Note>
diff --git a/packages/twenty-docs/l/fr/developers/extend/apps/data/relations.mdx b/packages/twenty-docs/l/fr/developers/extend/apps/data/relations.mdx
new file mode 100644
index 00000000000..3254bd94973
--- /dev/null
+++ b/packages/twenty-docs/l/fr/developers/extend/apps/data/relations.mdx
@@ -0,0 +1,160 @@
+---
+title: Relations
+description: Reliez des objets entre eux avec des relations MANY_TO_ONE / ONE_TO_MANY bidirectionnelles.
+icon: diagram-project
+---
+
+Les relations relient deux objets entre eux. Dans Twenty, les relations sont toujours **bidirectionnelles** — chaque relation a deux côtés, et chaque côté est déclaré comme un champ qui référence l'autre.
+
+| Type de relation | Description | Possède une clé étrangère ? |
+| ---------------- | ------------------------------------------------------------------------------------ | --------------------------- |
+| `MANY_TO_ONE` | De nombreux enregistrements de cet objet pointent vers un enregistrement de la cible | Oui (`joinColumnName`) |
+| `ONE_TO_MANY` | Un enregistrement de cet objet possède de nombreux enregistrements de la cible | Non (le côté inverse) |
+
+## Fonctionnement des relations
+
+Chaque relation nécessite **deux champs** qui se référencent mutuellement :
+
+1. Le côté **MANY_TO_ONE** — réside sur l'objet qui détient la clé étrangère.
+2. Le côté **ONE_TO_MANY** — réside sur l'objet qui possède la collection.
+
+Les deux champs utilisent `FieldType.RELATION` et se référencent mutuellement via `relationTargetFieldMetadataUniversalIdentifier`.
+
+## Exemple : une carte postale a de nombreux destinataires
+
+Un `PostCard` peut être envoyé à de nombreux enregistrements `PostCardRecipient`. Chaque destinataire appartient à exactement une carte postale.
+
+**Étape 1: Définir le côté ONE_TO_MANY sur PostCard** (le côté "one") :
+
+```ts src/fields/post-card-recipients-on-post-card.field.ts
+import { defineField, FieldType, RelationType } from 'twenty-sdk/define';
+import { POST_CARD_UNIVERSAL_IDENTIFIER } from '../objects/post-card.object';
+import { POST_CARD_RECIPIENT_UNIVERSAL_IDENTIFIER } from '../objects/post-card-recipient.object';
+
+// Export so the other side can reference it
+export const POST_CARD_RECIPIENTS_FIELD_ID = 'a1111111-1111-1111-1111-111111111111';
+// Import from the other side
+import { POST_CARD_FIELD_ID } from './post-card-on-post-card-recipient.field';
+
+export default defineField({
+ universalIdentifier: POST_CARD_RECIPIENTS_FIELD_ID,
+ objectUniversalIdentifier: POST_CARD_UNIVERSAL_IDENTIFIER,
+ type: FieldType.RELATION,
+ name: 'postCardRecipients',
+ label: 'Post Card Recipients',
+ icon: 'IconUsers',
+ relationTargetObjectMetadataUniversalIdentifier: POST_CARD_RECIPIENT_UNIVERSAL_IDENTIFIER,
+ relationTargetFieldMetadataUniversalIdentifier: POST_CARD_FIELD_ID,
+ universalSettings: {
+ relationType: RelationType.ONE_TO_MANY,
+ },
+});
+```
+
+**Étape 2: Définir le côté MANY_TO_ONE sur PostCardRecipient** (le côté "many" — détient la clé étrangère) :
+
+```ts src/fields/post-card-on-post-card-recipient.field.ts
+import { defineField, FieldType, RelationType, OnDeleteAction } from 'twenty-sdk/define';
+import { POST_CARD_UNIVERSAL_IDENTIFIER } from '../objects/post-card.object';
+import { POST_CARD_RECIPIENT_UNIVERSAL_IDENTIFIER } from '../objects/post-card-recipient.object';
+
+// Export so the other side can reference it
+export const POST_CARD_FIELD_ID = 'b2222222-2222-2222-2222-222222222222';
+// Import from the other side
+import { POST_CARD_RECIPIENTS_FIELD_ID } from './post-card-recipients-on-post-card.field';
+
+export default defineField({
+ universalIdentifier: POST_CARD_FIELD_ID,
+ objectUniversalIdentifier: POST_CARD_RECIPIENT_UNIVERSAL_IDENTIFIER,
+ type: FieldType.RELATION,
+ name: 'postCard',
+ label: 'Post Card',
+ icon: 'IconMail',
+ relationTargetObjectMetadataUniversalIdentifier: POST_CARD_UNIVERSAL_IDENTIFIER,
+ relationTargetFieldMetadataUniversalIdentifier: POST_CARD_RECIPIENTS_FIELD_ID,
+ universalSettings: {
+ relationType: RelationType.MANY_TO_ONE,
+ onDelete: OnDeleteAction.CASCADE,
+ joinColumnName: 'postCardId',
+ },
+});
+```
+
+<Note>
+**Imports circulaires :** les deux champs de relation se référencent l'un l'autre via leur `universalIdentifier`. Pour éviter les problèmes d'import circulaire, exportez les ID de vos champs en tant que constantes nommées depuis chaque fichier, puis importez-les dans l'autre. Le système de build les résout au moment de la compilation.
+</Note>
+
+## Relation avec des objets standard
+
+Pour créer une relation avec un objet Twenty intégré (Person, Company, etc.), utilisez `STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS` :
+
+```ts src/fields/person-on-self-hosting-user.field.ts
+import {
+ defineField,
+ FieldType,
+ RelationType,
+ OnDeleteAction,
+ STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS,
+} from 'twenty-sdk/define';
+import { SELF_HOSTING_USER_UNIVERSAL_IDENTIFIER } from '../objects/self-hosting-user.object';
+
+export const PERSON_FIELD_ID = 'c3333333-3333-3333-3333-333333333333';
+export const SELF_HOSTING_USER_REVERSE_FIELD_ID = 'd4444444-4444-4444-4444-444444444444';
+
+export default defineField({
+ universalIdentifier: PERSON_FIELD_ID,
+ objectUniversalIdentifier: SELF_HOSTING_USER_UNIVERSAL_IDENTIFIER,
+ type: FieldType.RELATION,
+ name: 'person',
+ label: 'Person',
+ description: 'Person matching with the self hosting user',
+ isNullable: true,
+ relationTargetObjectMetadataUniversalIdentifier:
+ STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS.person.universalIdentifier,
+ relationTargetFieldMetadataUniversalIdentifier: SELF_HOSTING_USER_REVERSE_FIELD_ID,
+ universalSettings: {
+ relationType: RelationType.MANY_TO_ONE,
+ onDelete: OnDeleteAction.SET_NULL,
+ joinColumnName: 'personId',
+ },
+});
+```
+
+## Propriétés des champs de relation
+
+| Propriété | Obligatoire | Description |
+| ------------------------------------------------- | ---------------------- | ------------------------------------------------------------------------------------------------------------------ |
+| `type` | Oui | Doit être `FieldType.RELATION` |
+| `relationTargetObjectMetadataUniversalIdentifier` | Oui | Le `universalIdentifier` de l'objet cible |
+| `relationTargetFieldMetadataUniversalIdentifier` | Oui | Le `universalIdentifier` du champ correspondant sur l'objet cible |
+| `universalSettings.relationType` | Oui | `RelationType.MANY_TO_ONE` ou `RelationType.ONE_TO_MANY` |
+| `universalSettings.onDelete` | MANY_TO_ONE uniquement | Ce qui se passe lorsque l'enregistrement référencé est supprimé : `CASCADE`, `SET_NULL`, `RESTRICT` ou `NO_ACTION` |
+| `universalSettings.joinColumnName` | MANY_TO_ONE uniquement | Nom de la colonne de base de données pour la clé étrangère (p. ex., `postCardId`) |
+
+## Champs de relation en ligne
+
+Vous pouvez également déclarer une relation directement à l'intérieur de [`defineObject`](/l/fr/developers/extend/apps/data/objects). Lorsqu'il est en ligne, omettez `objectUniversalIdentifier` — il est hérité de l'objet parent :
+
+```ts
+export default defineObject({
+ universalIdentifier: '...',
+ nameSingular: 'postCardRecipient',
+ // ...
+ fields: [
+ {
+ universalIdentifier: POST_CARD_FIELD_ID,
+ type: FieldType.RELATION,
+ name: 'postCard',
+ label: 'Post Card',
+ relationTargetObjectMetadataUniversalIdentifier: POST_CARD_UNIVERSAL_IDENTIFIER,
+ relationTargetFieldMetadataUniversalIdentifier: POST_CARD_RECIPIENTS_FIELD_ID,
+ universalSettings: {
+ relationType: RelationType.MANY_TO_ONE,
+ onDelete: OnDeleteAction.CASCADE,
+ joinColumnName: 'postCardId',
+ },
+ },
+ // … other fields
+ ],
+});
+```
diff --git a/packages/twenty-docs/l/fr/developers/extend/apps/getting-started/concepts.mdx b/packages/twenty-docs/l/fr/developers/extend/apps/getting-started/concepts.mdx
new file mode 100644
index 00000000000..114ca6c7904
--- /dev/null
+++ b/packages/twenty-docs/l/fr/developers/extend/apps/getting-started/concepts.mdx
@@ -0,0 +1,101 @@
+---
+title: Concepts
+description: Fonctionnement des applications Twenty — modèle d’entité, sandboxing et cycle de vie de l’installation.
+icon: sitemap
+---
+
+Les applications Twenty sont des packages TypeScript qui étendent votre espace de travail avec des objets personnalisés, de la logique, des composants d’interface utilisateur et des capacités d’IA. Elles s’exécutent sur la plateforme Twenty avec une isolation complète en bac à sable et des contrôles d’autorisations.
+
+## Fonctionnement des applications
+
+Une application est un ensemble d’**entités** déclarées à l’aide des fonctions `defineEntity()` du package `twenty-sdk`. Le SDK détecte ces déclarations via une analyse de l’AST au moment de la compilation et produit un **manifeste** — une description complète de ce que votre application ajoute à un espace de travail. Ces fonctions valident votre configuration au moment de la compilation et offrent l’autocomplétion dans l’IDE et une sécurité de typage.
+
+```
+your-app/
+├── src/
+│ ├── application-config.ts ← defineApplication (required, one per app)
+│ ├── roles/ ← defineRole
+│ ├── objects/ ← defineObject
+│ ├── fields/ ← defineField
+│ ├── logic-functions/ ← defineLogicFunction
+│ ├── front-components/ ← defineFrontComponent
+│ ├── skills/ ← defineSkill
+│ ├── agents/ ← defineAgent
+│ ├── views/ ← defineView
+│ ├── navigation-menu-items/ ← defineNavigationMenuItem
+│ └── page-layouts/ ← definePageLayout
+├── public/ ← Static assets (images, icons)
+└── package.json
+```
+
+<Note>
+ **L’organisation des fichiers vous revient.** La détection des entités est basée sur l’AST — le SDK trouve les appels à `export default defineEntity(...)` quel que soit l’emplacement du fichier. La structure de dossiers ci-dessus est une convention, pas une obligation.
+</Note>
+
+## Types d’entités
+
+| Entité | Objectif | Documentation |
+| --------------------------------- | --------------------------------------------------------------- | -------------------------------------------------------------------------------------- |
+| **Application** | Identité de l’application, rôle par défaut, variables | [Configuration de l’application](/l/fr/developers/extend/apps/config/application) |
+| **Rôle** | Ensembles d’autorisations pour les objets et les champs | [Rôles et autorisations](/l/fr/developers/extend/apps/config/roles) |
+| **Objet** | Types d’enregistrements personnalisés avec des champs | [Objets](/l/fr/developers/extend/apps/data/objects) |
+| **Champ** | Ajouter des champs à des objets provenant d’autres applications | [Extension des objets](/l/fr/developers/extend/apps/data/extending-objects) |
+| **Relation** | Liens bidirectionnels entre les objets | [Relations](/l/fr/developers/extend/apps/data/relations) |
+| **Fonction logique** | TypeScript côté serveur avec des déclencheurs | [Fonctions logiques](/l/fr/developers/extend/apps/logic/logic-functions) |
+| **Compétence** | Instructions réutilisables pour des agents d’IA | [Compétences et agents](/l/fr/developers/extend/apps/logic/skills-and-agents) |
+| **Agent** | Assistants d’IA avec des prompts personnalisés | [Compétences et agents](/l/fr/developers/extend/apps/logic/skills-and-agents) |
+| **Fournisseur de connexion** | Identifiants OAuth pour les API tierces | [Connexions](/l/fr/developers/extend/apps/logic/connections) |
+| **Vue** | Vues de liste d’enregistrements préconfigurées | [Vues](/l/fr/developers/extend/apps/layout/views) |
+| **Élément de menu de navigation** | Entrées personnalisées de la barre latérale | [Éléments du menu de navigation](/l/fr/developers/extend/apps/layout/navigation-menu-items) |
+| **Mise en page** | Onglets et widgets sur la page de détails d’un enregistrement | [Mises en page](/l/fr/developers/extend/apps/layout/page-layouts) |
+| **Composant frontal** | Interface React isolée en bac à sable dans Twenty | [Composants frontaux](/l/fr/developers/extend/apps/layout/front-components) |
+| **Élément du menu de commande** | Actions rapides et entrées Cmd+K | [Éléments du menu de commande](/l/fr/developers/extend/apps/layout/command-menu-items) |
+
+## Exécution en bac à sable
+
+* **Les fonctions logiques** s’exécutent dans des processus Node.js isolés sur le serveur. Elles n’accèdent aux données qu’au moyen du client d’API typé, limité par les autorisations du 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). Ils communiquent avec Twenty via une API hôte de passage de messages.
+* **Les autorisations** sont appliquées au niveau de l’API. Le jeton d’exécution (`TWENTY_APP_ACCESS_TOKEN`) est dérivé du rôle défini dans `defineApplication()`.
+
+## Cycle de vie de l’application
+
+```
+┌─────────────────────────────────────────────────────────┐
+│ Development │
+│ npx create-twenty-app → yarn twenty dev (live sync) │
+├─────────────────────────────────────────────────────────┤
+│ Build & Deploy │
+│ yarn twenty dev:build → yarn twenty app:publish │
+├─────────────────────────────────────────────────────────┤
+│ Install flow │
+│ upload → [pre-install] → metadata migration → │
+│ generate SDK → [post-install] │
+├─────────────────────────────────────────────────────────┤
+│ Publish │
+│ npm publish → appears in Twenty marketplace │
+└─────────────────────────────────────────────────────────┘
+```
+
+* **`yarn twenty dev`** — surveille vos fichiers source et synchronise en direct les modifications avec un serveur Twenty connecté. Le client d’API typé est régénéré automatiquement lorsque le schéma change.
+* **`yarn twenty dev:build`** — compile TypeScript, regroupe les fonctions logiques et les composants frontaux avec esbuild, et produit un manifeste.
+* **Hooks pré/post-install** — fonctions optionnelles qui s’exécutent pendant l’installation. Voir [Install Hooks](/l/fr/developers/extend/apps/config/install-hooks) pour plus de détails.
+
+## Prochaines étapes
+
+<CardGroup cols={2}>
+ <Card title="Configuration" icon="screwdriver-wrench" href="/l/fr/developers/extend/apps/config/overview">
+ Identité de l’application, rôle par défaut et hooks d’installation.
+ </Card>
+ <Card title="Données" icon="database" href="/l/fr/developers/extend/apps/data/overview">
+ Objets, champs et relations bidirectionnelles.
+ </Card>
+ <Card title="Logique" icon="bolt" href="/l/fr/developers/extend/apps/logic/overview">
+ Fonctions logiques, compétences, agents et connexions OAuth.
+ </Card>
+ <Card title="Disposition" icon="table-columns" href="/l/fr/developers/extend/apps/layout/overview">
+ Vues, navigation, mises en page, composants front-end.
+ </Card>
+ <Card title="Opérations" icon="rocket" href="/l/fr/developers/extend/apps/operations/overview">
+ CLI, tests, dépôts distants, CI et publication de votre application.
+ </Card>
+</CardGroup>
diff --git a/packages/twenty-docs/l/fr/developers/extend/apps/getting-started/local-server.mdx b/packages/twenty-docs/l/fr/developers/extend/apps/getting-started/local-server.mdx
new file mode 100644
index 00000000000..1d42b8db59b
--- /dev/null
+++ b/packages/twenty-docs/l/fr/developers/extend/apps/getting-started/local-server.mdx
@@ -0,0 +1,87 @@
+---
+title: Serveur local
+description: Gérez le serveur Docker local de Twenty — démarrage, arrêt, mise à niveau, instance de test parallèle et configuration manuelle du SDK.
+icon: server
+---
+
+## Gestion du serveur local
+
+Utilisez `yarn twenty docker:*` pour contrôler le conteneur Twenty local :
+
+| Commande | Ce que cela fait |
+| -------------------------------------- | ---------------------------------------------------------- |
+| `yarn twenty docker:start` | Démarre le serveur (récupère l’image si nécessaire) |
+| `yarn twenty docker:start 2.2.0` | Démarrer une version spécifique du serveur |
+| `yarn twenty docker:start --port 3030` | Démarre sur un port personnalisé |
+| `yarn twenty docker:stop` | Arrête le serveur (préserve les données) |
+| `yarn twenty docker:status` | Affiche l’URL, la version et les identifiants de connexion |
+| `yarn twenty docker:logs` | Diffuse les journaux du serveur |
+| `yarn twenty docker:reset` | Efface les données et repart de zéro |
+| `yarn twenty docker:upgrade` | Récupère la dernière image `twenty-app-dev` |
+| `yarn twenty docker:upgrade 2.2.0` | Met à niveau vers une version spécifique |
+
+Les données sont conservées entre les redémarrages dans deux volumes Docker (`twenty-app-dev-data` pour PostgreSQL, `twenty-app-dev-storage` pour les fichiers). Utilisez `reset` pour tout effacer.
+
+## Figer la version du serveur
+
+Lorsqu’aucune version n’est fournie, `docker:start` résout la version à partir de la plage `engines.twenty` de votre `package.json` — la même plage que le serveur utilise pour la validation lors de l’installation de votre application. Il démarre l’image `twenty-app-dev` la plus récente publiée qui satisfait la plage, et revient à `latest` lorsque le champ est absent ou qu’aucune version publiée ne correspond :
+
+```json filename="package.json"
+{
+ "engines": {
+ "twenty": ">=2.2.0"
+ }
+}
+```
+
+Passez explicitement une version pour remplacer la plage pour une seule exécution : `yarn twenty docker:start 2.3.0`. Si un conteneur existe déjà avec une version différente, `docker:start` le met à niveau sur place (en recréant le conteneur tout en préservant vos volumes de données).
+
+## Mise à niveau de l’image du serveur
+
+`yarn twenty docker:upgrade` récupère la dernière image, compare les empreintes et ne recrée le conteneur que si quelque chose a réellement changé. Les volumes sont conservés — seul le conteneur est remplacé. Si une nouvelle image a été récupérée et que le conteneur était en cours d’exécution, la mise à niveau démarre automatiquement un nouveau conteneur ; exécutez ensuite `yarn twenty docker:start` pour attendre qu’il devienne opérationnel.
+
+```bash filename="Terminal"
+yarn twenty docker:upgrade # Latest
+yarn twenty docker:upgrade 2.2.0 # Specific version
+```
+
+Vérifiez la version en cours d’exécution avec `yarn twenty docker:status` (elle affiche la valeur de `APP_VERSION` intégrée au conteneur).
+
+## Exécuter une instance de test parallèle
+
+Passez `--test` à n’importe quelle commande `docker:*` pour gérer une deuxième instance totalement isolée — utile pour les tests d’intégration ou pour expérimenter sans toucher à vos données de développement principales :
+
+| Commande | Ce que cela fait |
+| ----------------------------------- | ------------------------------------------------- |
+| `yarn twenty docker:start --test` | Démarre l’instance de test (port 2021 par défaut) |
+| `yarn twenty docker:stop --test` | L’arrête |
+| `yarn twenty docker:status --test` | Affiche son statut |
+| `yarn twenty docker:logs --test` | Diffuse ses journaux |
+| `yarn twenty docker:reset --test` | Efface ses données |
+| `yarn twenty docker:upgrade --test` | Met à niveau son image |
+
+L’instance de test possède son propre conteneur (`twenty-app-dev-test`), ses volumes (`twenty-app-dev-test-data`, `twenty-app-dev-test-storage`) et sa configuration — elle s’exécute parallèlement à votre instance principale sans conflits. Combinez `--test` avec `--port` pour remplacer le port 2021.
+
+## Configuration manuelle (sans le générateur)
+
+Ignorez le générateur si vous ajoutez le SDK à un projet existant :
+
+```bash filename="Terminal"
+yarn add twenty-sdk twenty-client-sdk
+```
+
+Ajoutez le script à `package.json` :
+
+```json filename="package.json"
+{
+ "scripts": {
+ "twenty": "twenty"
+ }
+}
+```
+
+Vous pouvez maintenant exécuter `yarn twenty dev`, `yarn twenty docker:start` et le reste.
+
+<Note>
+N’installez pas `twenty-sdk` globalement — figez-le par projet afin que chaque application utilise sa propre version.
+</Note>
diff --git a/packages/twenty-docs/l/fr/developers/extend/apps/getting-started/project-structure.mdx b/packages/twenty-docs/l/fr/developers/extend/apps/getting-started/project-structure.mdx
new file mode 100644
index 00000000000..f78763f4db3
--- /dev/null
+++ b/packages/twenty-docs/l/fr/developers/extend/apps/getting-started/project-structure.mdx
@@ -0,0 +1,61 @@
+---
+title: Structure du projet
+description: Ce qui se trouve à l’intérieur d’une application Twenty générée par un modèle — fichiers, dossiers et le rôle de chacun.
+icon: folder-tree
+---
+
+Une nouvelle application générée par `npx create-twenty-app` ressemble à ceci :
+
+```text filename="my-twenty-app/"
+my-twenty-app/
+ package.json
+ src/
+ application-config.ts # Required — your app's entry point
+ default-role.ts # Permissions for logic functions
+ constants/
+ universal-identifiers.ts # Auto-generated UUIDs and metadata
+ __tests__/
+ setup-test.ts
+ app-install.integration-test.ts
+ .github/workflows/ci.yml # GitHub Actions
+ public/ # Static assets
+ vitest.config.ts # Test runner config
+ tsconfig.json, tsconfig.spec.json
+ .nvmrc, .yarnrc.yml, .oxlintrc.json
+ README.md, LLMS.md
+```
+
+## Fichiers clés
+
+| Fichier / Dossier | Objectif |
+| ---------------------------------------- | -------------------------------------------------------------------------------------------- |
+| `src/application-config.ts` | **Requis.** Le fichier de configuration principal de votre application. |
+| `src/default-role.ts` | Rôle par défaut qui contrôle ce à quoi vos fonctions de logique peuvent accéder. |
+| `src/constants/universal-identifiers.ts` | UUID générés automatiquement et métadonnées de l’application (nom d’affichage, description). |
+| `src/__tests__/` | Tests d’intégration (configuration + test d’exemple). |
+| `public/` | Ressources statiques (images, polices) servies avec votre application. |
+
+<Note>
+**L’organisation des fichiers vous revient.** Les dossiers ci-dessus sont des conventions — le SDK détecte les entités via une analyse AST sur les appels à `export default defineEntity(...)` quel que soit l’emplacement du fichier.
+</Note>
+
+## Dépendances
+
+Les deux packages du SDK Twenty doivent être placés dans `devDependencies`, et non dans `dependencies` :
+
+```json filename="package.json"
+{
+ "dependencies": {},
+ "devDependencies": {
+ "twenty-client-sdk": "^2.13.0",
+ "twenty-sdk": "^2.13.0"
+ }
+}
+```
+
+* **`twenty-sdk`** fournit le CLI `twenty` ainsi que les outils de build et de scaffolding. Il ne s’exécute qu’au moment du développement et du build et n’est jamais importé par le runtime de l’application que vous publiez.
+* **`twenty-client-sdk`** *est* importé par le code de votre application (`CoreApiClient`, `MetadataApiClient`, `RestApiClient`), mais Twenty le fournit au moment de l’exécution : les fonctions de logique l’obtiennent à partir d’une couche SDK générée, et les composants front le résolvent à partir de modules servis par le serveur. La copie que vous avez installée est uniquement utilisée pour la vérification de type et le build au moment du déploiement, elle n’a donc jamais besoin d’être incluse dans le bundle déployé.
+
+Conserver l’un ou l’autre package dans `dependencies` l’intègre dans le bundle runtime de l’application installée, où il ne fait que l’alourdir inutilement. `twenty build` émet un avertissement lorsque l’un ou l’autre est encore répertorié dans `dependencies`.
+
+Ajoutez les dépendances runtime propres à votre application (les bibliothèques que vos fonctions logiques importent réellement à l’exécution) dans `dependencies` comme d’habitude.
diff --git a/packages/twenty-docs/l/fr/developers/extend/apps/getting-started/quick-start.mdx b/packages/twenty-docs/l/fr/developers/extend/apps/getting-started/quick-start.mdx
new file mode 100644
index 00000000000..e5d7da3868c
--- /dev/null
+++ b/packages/twenty-docs/l/fr/developers/extend/apps/getting-started/quick-start.mdx
@@ -0,0 +1,176 @@
+---
+title: Démarrage rapide
+icon: rocket
+description: Créez votre première application Twenty en quelques minutes.
+---
+
+## Prérequis
+
+* **Node.js 24+** — [Télécharger](https://nodejs.org/)
+* **Yarn 4** — fourni avec Node.js via Corepack. Activez-le : `corepack enable`
+* **Docker** — [Télécharger](https://www.docker.com/products/docker-desktop/). Nécessaire pour exécuter un serveur Twenty local. Ignorez si vous avez déjà Twenty en cours d’exécution ailleurs.
+
+La création d’une application Twenty comporte trois phases. Le générateur les regroupe en une seule commande pour le parcours idéal, mais chaque phase est un concept distinct — en cas d’échec, savoir dans quelle phase vous vous trouvez indique ce qu’il faut corriger.
+
+| Phase | Ce que vous faites | Outil | Résultat |
+| -------------------------- | ------------------------------------------------------ | ----------------------------- | ----------------------------------------------------------- |
+| **1. Génération** | Générer le code source de l’application | `npx create-twenty-app` | Un projet TypeScript sur le disque |
+| **2. Exécuter un serveur** | Démarrer un serveur Twenty vers lequel se synchroniser | Docker + `yarn twenty server` | Une instance Twenty en cours d’exécution |
+| **3. Synchroniser** | Synchroniser en direct votre code avec le serveur | `yarn twenty dev` | Vos modifications apparaissent dans l’interface utilisateur |
+
+---
+
+## Phase 1 — Générez le squelette de votre projet
+
+Créez une nouvelle application à partir du modèle :
+
+```bash filename="Terminal"
+npx create-twenty-app@latest my-twenty-app
+```
+
+On vous demandera un nom et une description — appuyez sur **Entrée** pour utiliser les valeurs par défaut. Cela génère un projet TypeScript dans `my-twenty-app/` avec un fichier de démarrage `application-config.ts`, un rôle par défaut, un workflow CI et un test d’intégration.
+
+**Après cette phase :** vous disposez du code source d’une application sur votre machine. Elle ne s’exécute pas encore — c’est la phase 2.
+
+---
+
+## Phase 2 — Exécuter un serveur Twenty local
+
+Votre application a besoin d’un serveur Twenty vers lequel se synchroniser. Le serveur est une instance Twenty complète — interface utilisateur, API GraphQL, PostgreSQL — exécutée localement dans Docker. Votre code local envoie ses définitions à ce serveur, qui les fait apparaître dans l’interface utilisateur.
+
+Le générateur propose d’en démarrer un pour vous :
+
+> **Souhaitez-vous configurer une instance locale de Twenty ?**
+
+* **Oui (recommandé)** — récupère l’image Docker `twentycrm/twenty-app-dev` et la démarre sur le port `2020`. Assurez-vous d’abord que Docker est en cours d’exécution.
+* **Non** — choisissez cette option si vous avez déjà un serveur Twenty auquel vous souhaitez vous connecter. Vous pourrez le connecter plus tard avec `yarn twenty remote:add`.
+
+<div style={{textAlign: 'center'}}>
+ <img src="/images/docs/developers/extends/apps/start-instance.png" alt="Faut-il démarrer l’instance locale ?" />
+</div>
+
+Une fois le serveur démarré, un navigateur s’ouvre pour la connexion. Utilisez le compte de démonstration prérempli :
+
+* **E-mail :** `[email protected]`
+* **Mot de passe :** `[email protected]`
+
+<div style={{textAlign: 'center'}}>
+ <img src="/images/docs/developers/extends/apps/login.png" alt="Écran de connexion Twenty" />
+</div>
+
+Cliquez sur **Authorize** sur l’écran suivant — cela donne à la CLI l’accès à votre espace de travail.
+
+<div style={{textAlign: 'center'}}>
+ <img src="/images/docs/developers/extends/apps/authorize.png" alt="Écran d’autorisation de la CLI Twenty" />
+</div>
+
+Votre terminal confirmera que tout est configuré.
+
+<div style={{textAlign: 'center'}}>
+ <img src="/images/docs/developers/extends/apps/scaffolded.png" alt="Application initialisée avec succès" />
+</div>
+
+**Après cette phase :** vous disposez d’un serveur Twenty en cours d’exécution sur [http://localhost:2020](http://localhost:2020) avec votre CLI autorisée à s’y synchroniser.
+
+<Note>
+Si Docker n’est pas installé ou en cours d’exécution, le générateur vous indiquera la bonne commande de démarrage pour votre système d’exploitation. Une fois Docker lancé, vous pouvez reprendre avec `yarn twenty docker:start` — pas besoin de régénérer le squelette.
+</Note>
+
+---
+
+## Phase 3 — Synchroniser vos modifications
+
+C’est la boucle interne dans laquelle vous passerez la plupart de votre temps.
+
+```bash filename="Terminal"
+cd my-twenty-app
+yarn twenty dev
+```
+
+Cela surveille `src/`, reconstruit à chaque modification et synchronise le résultat avec le serveur. Modifiez un fichier, enregistrez, et en quelques secondes le serveur reflète la modification. Vous verrez un panneau d’état en direct dans votre terminal.
+
+Pour une sortie plus détaillée (journaux de build, requêtes de synchronisation, traces d’erreurs), ajoutez `--verbose`.
+
+<div style={{textAlign: 'center'}}>
+ <img src="/images/docs/developers/extends/apps/dev.png" alt="Sortie du terminal en mode dev" />
+</div>
+
+Ouvrez [http://localhost:2020/settings/applications#developer](http://localhost:2020/settings/applications#developer). Vous devriez voir votre application sous **Your Apps**.
+
+<div style={{textAlign: 'center'}}>
+ <img src="/images/docs/developers/extends/apps/app-in-ui-1.png" alt="La liste Your Apps affichant My twenty app" />
+</div>
+
+Cliquez sur **My twenty app** pour voir son **application registration** — un enregistrement au niveau du serveur décrivant votre application (nom, identifiant, informations d’identification OAuth, source). Un même enregistrement peut être installé dans plusieurs espaces de travail sur le même serveur.
+
+<div style={{textAlign: 'center'}}>
+ <img src="/images/docs/developers/extends/apps/app-in-ui-2.png" alt="Détails de l’enregistrement d’application" />
+</div>
+
+Cliquez sur **View installed app** pour voir l’installation dans l’espace de travail. L’onglet **About** affiche la version et les options de gestion.
+
+<div style={{textAlign: 'center'}}>
+ <img src="/images/docs/developers/extends/apps/app-in-ui-3.png" alt="Application installée" />
+</div>
+
+**Après cette phase :** vous disposez d’une boucle de développement en direct. Modifiez n’importe quel fichier dans `src/` et il apparaît dans l’interface utilisateur.
+
+### Synchronisation ponctuelle pour la CI et les scripts
+
+Passez `--once` pour exécuter une seule opération de build + synchronisation puis quitter — même pipeline, pas de watcher :
+
+```bash filename="Terminal"
+yarn twenty dev --once
+```
+
+| Commande | Comportement | Quand l'utiliser : |
+| ---------------------------------- | --------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------ |
+| `yarn twenty dev` | Surveille et resynchronise à chaque modification. Reste en cours d’exécution jusqu’à ce que vous l’arrêtiez. | Développement local interactif. |
+| `yarn twenty dev --once` | Une seule opération de build + synchronisation, se termine avec le code `0` en cas de réussite et `1` en cas d’échec. | CI, hooks de pré-commit, agents IA et flux de travail scriptés. |
+| `yarn twenty dev --once --dry-run` | Construit et affiche les modifications de métadonnées **sans les appliquer**. | Inspection de ce qu’une synchronisation changerait avant de s’y engager. |
+
+Les deux modes nécessitent un serveur distant authentifié. Voir [synchronisation et récupération](/l/fr/developers/extend/apps/operations/sync-and-recovery#previewing-changes-dry-run) pour plus d’informations sur `--dry-run`.
+
+### Options du mode de développement
+
+| Option | Description |
+| ------------------------------------- | -------------------------------------------------------------------------------------------------------------- |
+| `--once` | Construire et synchroniser une fois, puis quitter. |
+| `--dry-run` | Avec `--once`, prévisualisez les modifications de métadonnées sans les appliquer. N’écrit rien. |
+| `--debounceMs \<ms>` | Définir le délai de temporisation des modifications de fichiers en millisecondes (valeur par défaut : `2000`). |
+| `--verbose` / `--debug` | Afficher des journaux de build détaillés, les requêtes de synchronisation et les traces d’erreur. |
+
+## Ce que vous pouvez créer
+
+Les applications sont composées d’**entités** — chacune définie comme un fichier TypeScript avec un seul `export default` :
+
+| Entité | Ce que cela fait |
+| ------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
+| **Objets et champs** | Modèles de données personnalisés (carte postale, facture, etc.) avec des champs typé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 d’interface utilisateur (UI)** | Composants React 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 |
+| **Mises en page** | Pages de détail d’enregistrement personnalisées avec des onglets et des widgets |
+
+Référence complète : [Concepts](/l/fr/developers/extend/apps/getting-started/concepts).
+
+## Prochaines étapes
+
+<CardGroup cols={2}>
+ <Card title="Configuration" icon="screwdriver-wrench" href="/l/fr/developers/extend/apps/config/overview">
+ Identité de l’application, rôle par défaut, hooks d’installation, ressources publiques.
+ </Card>
+ <Card title="Données" icon="database" href="/l/fr/developers/extend/apps/data/overview">
+ Objets, champs et relations bidirectionnelles.
+ </Card>
+ <Card title="Logique" icon="bolt" href="/l/fr/developers/extend/apps/logic/overview">
+ Fonctions logiques, compétences, agents et connexions OAuth.
+ </Card>
+ <Card title="Disposition" icon="table-columns" href="/l/fr/developers/extend/apps/layout/overview">
+ Vues, navigation, mises en page, composants front-end.
+ </Card>
+ <Card title="Opérations" icon="rocket" href="/l/fr/developers/extend/apps/operations/overview">
+ CLI, tests, dépôts distants, CI et publication de votre application.
+ </Card>
+</CardGroup>
diff --git a/packages/twenty-docs/l/fr/developers/extend/apps/getting-started/scaffolding.mdx b/packages/twenty-docs/l/fr/developers/extend/apps/getting-started/scaffolding.mdx
new file mode 100644
index 00000000000..3e89a52bfba
--- /dev/null
+++ b/packages/twenty-docs/l/fr/developers/extend/apps/getting-started/scaffolding.mdx
@@ -0,0 +1,58 @@
+---
+title: Génération
+description: Générez des fichiers d'entité de manière interactive avec `yarn twenty dev:add` — objets, champs, vues, fonctions logiques et plus encore.
+icon: wand-magic-sparkles
+---
+
+Au lieu de créer manuellement les fichiers d'entité, utilisez l'outil de génération interactif :
+
+```bash filename="Terminal"
+yarn twenty dev:add
+```
+
+Il vous invite à choisir un type d'entité, vous guide à travers les champs requis, puis écrit un fichier prêt à l'emploi avec un `universalIdentifier` stable et l'appel `defineEntity()` correct.
+
+Vous pouvez également passer directement le type d'entité pour ignorer la première invite :
+
+```bash filename="Terminal"
+yarn twenty dev:add object
+yarn twenty dev:add logicFunction
+yarn twenty dev:add frontComponent
+```
+
+## Types d’entités disponibles
+
+| Type d’entité | Commande | Fichier généré |
+| ----------------------------- | ---------------------------------------- | ------------------------------------------------------- |
+| Objet | `yarn twenty dev:add object` | `src/objects/\<name>.ts` |
+| Champ | `yarn twenty dev:add field` | `src/fields/\<name>.ts` |
+| Fonction logique | `yarn twenty dev:add logicFunction` | `src/logic-functions/\<name>.ts` |
+| Composant frontal | `yarn twenty dev:add frontComponent` | `src/front-components/\<name>.tsx` |
+| Rôle | `yarn twenty dev:add role` | `src/roles/\<name>.ts` |
+| Compétence | `yarn twenty dev:add skill` | `src/skills/\<name>.ts` |
+| Agent | `yarn twenty dev:add agent` | `src/agents/\<name>.ts` |
+| Vue | `yarn twenty dev:add view` | `src/views/\<name>.ts` |
+| Élément de menu de navigation | `yarn twenty dev:add navigationMenuItem` | `src/navigation-menu-items/\<name>.ts` |
+| Mise en page | `yarn twenty dev:add pageLayout` | `src/page-layouts/\<name>.ts` |
+
+## Ce que génère l'outil de génération
+
+Chaque type d'entité a son propre modèle. Par exemple, `yarn twenty dev:add object` demande :
+
+1. **Nom (singulier)** — p. ex., `invoice`
+2. **Nom (pluriel)** — p. ex., `invoices`
+3. **Libellé (singulier)** — rempli automatiquement depuis le nom (p. ex., `Invoice`)
+4. **Libellé (pluriel)** — rempli automatiquement (p. ex., `Invoices`)
+5. **Créer une vue et un élément de navigation ?** — si vous répondez oui, l'outil génère également une vue correspondante et un lien de barre latérale pour le nouvel objet.
+
+Les autres types d'entités ont des invites plus simples — la plupart ne demandent qu'un nom.
+
+Le type d'entité `field` est plus détaillé : il demande le nom du champ, son libellé, son type (à partir d'une liste de tous les types de champs disponibles comme `TEXT`, `NUMBER`, `SELECT`, `RELATION`, etc.), et le `universalIdentifier` de l'objet cible.
+
+## Chemin de sortie personnalisé
+
+Utilisez l'option `--path` pour placer le fichier généré à un emplacement personnalisé :
+
+```bash filename="Terminal"
+yarn twenty dev:add logicFunction --path src/custom-folder
+```
diff --git a/packages/twenty-docs/l/fr/developers/extend/apps/getting-started/troubleshooting.mdx b/packages/twenty-docs/l/fr/developers/extend/apps/getting-started/troubleshooting.mdx
new file mode 100644
index 00000000000..5af8b494fb3
--- /dev/null
+++ b/packages/twenty-docs/l/fr/developers/extend/apps/getting-started/troubleshooting.mdx
@@ -0,0 +1,14 @@
+---
+title: Résolution des problèmes
+description: Problèmes courants lors de la première exécution — Docker, version de Node, Yarn, dépendances.
+icon: clé
+---
+
+* **Erreurs Docker** — Assurez-vous que Docker Desktop (ou le démon) est en cours d’exécution avant `yarn twenty docker:start`. Le message d’erreur indiquera la bonne commande de démarrage pour votre système d’exploitation.
+* **Mauvaise version de Node** — la version 24+ est requise. Vérifiez avec `node -v`.
+* **Yarn 4 manquant** — Exécutez `corepack enable`.
+* **Dépendances cassées** — `rm -rf node_modules && yarn install`.
+* **Erreurs de `twenty-sdk` après la mise à niveau vers la v2.8.0** — il est passé de `dependencies` à `devDependencies` dans la v2.8.0. Voir [Structure du projet → Dépendances](/l/fr/developers/extend/apps/getting-started/project-structure#dependencies).
+* **`twenty build` avertit au sujet de `twenty-client-sdk` dans `dependencies`** — il est fourni au moment de l’exécution par Twenty, donc il devrait être déplacé vers `devDependencies` avec `twenty-sdk`. Voir [Structure du projet → Dépendances](/l/fr/developers/extend/apps/getting-started/project-structure#dependencies).
+
+Bloqué ? Demandez de l’aide sur le [Discord de Twenty](https://discord.com/channels/1130383047699738754/1130386664812982322).
diff --git a/packages/twenty-docs/l/fr/developers/extend/apps/layout/command-menu-items.mdx b/packages/twenty-docs/l/fr/developers/extend/apps/layout/command-menu-items.mdx
new file mode 100644
index 00000000000..816ad4060e0
--- /dev/null
+++ b/packages/twenty-docs/l/fr/developers/extend/apps/layout/command-menu-items.mdx
@@ -0,0 +1,148 @@
+---
+title: Éléments du menu de commande
+description: Exposez les composants frontaux comme actions rapides et entrées du menu de commande (Cmd+K) avec defineCommandMenuItem.
+icon: terminal
+---
+
+Un **élément de menu de commande** est le lien entre l’utilisateur et un [front component](/l/fr/developers/extend/apps/layout/front-components). Il enregistre le composant dans le menu de commande (Cmd+K) de Twenty et, éventuellement, comme bouton d’action rapide épinglé dans le coin supérieur droit de la page.
+
+```ts src/command-menu-items/open-dashboard.command-menu-item.ts
+import { defineCommandMenuItem } from 'twenty-sdk/define';
+
+export default defineCommandMenuItem({
+ universalIdentifier: 'a1b2c3d4-e5f6-7890-abcd-ef1234567890',
+ label: 'Open Dashboard',
+ shortLabel: 'Dashboard',
+ icon: 'IconLayoutDashboard',
+ isPinned: true,
+ availabilityType: 'GLOBAL',
+ frontComponentUniversalIdentifier: '74c526eb-cb68-4cf7-b05c-0dd8c288d948',
+});
+```
+
+## Champs de configuration
+
+| Champ | Obligatoire | Description |
+| --------------------------------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `universalIdentifier` | Oui | ID unique et stable pour la commande |
+| `label` | Oui | Libellé complet affiché dans le menu de commande (Cmd+K) |
+| `frontComponentUniversalIdentifier` | Oui | L'`universalIdentifier` du composant frontal que cette commande ouvre |
+| `shortLabel` | Non | Libellé plus court affiché sur le bouton d'action rapide épinglé |
+| `icon` | Non | Nom de l'icône affiché à côté du libellé (p. ex. `'IconBolt'`, `'IconSend'`) |
+| `isPinned` | Non | Lorsque `true`, affiche la commande comme un bouton d'action rapide dans le coin supérieur droit de la page |
+| `availabilityType` | Non | Contrôle l'emplacement d'apparition de la commande : `'GLOBAL'` (toujours disponible), `'RECORD_SELECTION'` (uniquement lorsque des enregistrements sont sélectionnés) ou `'FALLBACK'` (affichée lorsqu'aucune autre commande ne correspond) |
+| `availabilityObjectUniversalIdentifier` | Non | Restreint la commande aux pages d’un type d’objet spécifique (p. ex., uniquement sur les enregistrements « Company ») |
+| `conditionalAvailabilityExpression` | Non | Une expression booléenne qui contrôle dynamiquement la visibilité (voir ci-dessous) |
+
+## Commandes sans interface
+
+Un élément de menu de commande associé à un [headless front component](/l/fr/developers/extend/apps/layout/front-components#headless-vs-non-headless) est la manière idiomatique de proposer une action en un clic — exécuter du code, naviguer, ou confirmer puis exécuter. La page Front Components couvre les [SDK Command components](/l/fr/developers/extend/apps/layout/front-components#sdk-command-components) (`Command`, `CommandLink`, `CommandModal`, `CommandOpenSidePanelPage`) qui gèrent le modèle action-et-démontage.
+
+Un flux typique :
+
+```tsx src/front-components/run-action.tsx
+import { defineFrontComponent } from 'twenty-sdk/define';
+import { Command } from 'twenty-sdk/command';
+import { CoreApiClient } from 'twenty-sdk/clients';
+
+const RunAction = () => {
+ const execute = async () => {
+ const client = new CoreApiClient();
+ await client.mutation({
+ createTask: {
+ __args: { data: { title: 'Created by my app' } },
+ id: true,
+ },
+ });
+ };
+
+ return <Command execute={execute} />;
+};
+
+export default defineFrontComponent({
+ universalIdentifier: 'e5f6a7b8-c9d0-1234-efab-345678901234',
+ name: 'run-action',
+ description: 'Creates a task from the command menu',
+ component: RunAction,
+ isHeadless: true,
+});
+```
+
+```ts src/command-menu-items/run-action.command-menu-item.ts
+import { defineCommandMenuItem } from 'twenty-sdk/define';
+
+export default defineCommandMenuItem({
+ universalIdentifier: 'f6a7b8c9-d0e1-2345-fabc-456789012345',
+ label: 'Run my action',
+ icon: 'IconPlayerPlay',
+ frontComponentUniversalIdentifier: 'e5f6a7b8-c9d0-1234-efab-345678901234',
+});
+```
+
+## Expressions de disponibilité conditionnelle
+
+Le champ `conditionalAvailabilityExpression` vous permet de contrôler quand une commande est visible en fonction du contexte de la page actuelle. Importez des variables typées et des opérateurs depuis `twenty-sdk` pour construire des expressions :
+
+```ts src/command-menu-items/bulk-update.command-menu-item.ts
+import {
+ defineCommandMenuItem,
+ objectPermissions,
+ everyEquals,
+} from 'twenty-sdk/define';
+
+export default defineCommandMenuItem({
+ universalIdentifier: '...',
+ label: 'Bulk Update',
+ availabilityType: 'RECORD_SELECTION',
+ frontComponentUniversalIdentifier: '...',
+ conditionalAvailabilityExpression: everyEquals(
+ objectPermissions,
+ 'canUpdateObjectRecords',
+ true,
+ ),
+});
+```
+
+<Note>
+ `RECORD_SELECTION` implique déjà une sélection non vide — utilisez `numberOfSelectedRecords` uniquement pour des décomptes spécifiques (par exemple `>= 2`).
+</Note>
+
+### Variables de contexte
+
+Elles représentent l’état actuel de la page :
+
+| Variable | Type | Description |
+| ------------------------------ | --------- | -------------------------------------------------------------------- |
+| `pageType` | `string` | Type de page actuel (p. ex. `'RecordIndexPage'`, `'RecordShowPage'`) |
+| `isInSidePanel` | `boolean` | Indique si le composant est rendu dans un panneau latéral |
+| `numberOfSelectedRecords` | `number` | Nombre d'enregistrements actuellement sélectionnés |
+| `isSelectAll` | `boolean` | Indique si "tout sélectionner" est actif |
+| `selectedRecords` | `array` | Les objets d'enregistrement sélectionnés |
+| `favoriteRecordIds` | `array` | IDs des enregistrements ajoutés aux favoris |
+| `objectPermissions` | `object` | Autorisations pour le type d'objet actuel |
+| `targetObjectReadPermissions` | `object` | Autorisations de lecture pour l'objet cible |
+| `targetObjectWritePermissions` | `object` | Autorisations d'écriture pour l'objet cible |
+| `featureFlags` | `object` | Drapeaux de fonctionnalité actifs |
+| `objectMetadataItem` | `object` | Métadonnées du type d'objet actuel |
+| `hasAnySoftDeleteFilterOnView` | `boolean` | Indique si la vue actuelle possède un filtre de suppression logique |
+
+### Opérateurs
+
+Combinez des variables en expressions booléennes :
+
+| Opérateur | Description |
+| ----------------------------------- | ---------------------------------------------------------------------- |
+| `isDefined(value)` | `true` si la valeur n'est pas null/undefined |
+| `isNonEmptyString(value)` | `true` si la valeur est une chaîne non vide |
+| `includes(array, value)` | `true` si le tableau contient la valeur |
+| `includesEvery(array, prop, value)` | `true` si la propriété de chaque élément inclut la valeur |
+| `every(array, prop)` | `true` si la propriété est truthy sur chaque élément |
+| `everyDefined(array, prop)` | `true` si la propriété est définie pour chaque élément |
+| `everyEquals(array, prop, value)` | `true` si la propriété est égale à la valeur pour chaque élément |
+| `some(array, prop)` | `true` si la propriété est truthy sur au moins un élément |
+| `someDefined(array, prop)` | `true` si la propriété est définie sur au moins un élément |
+| `someEquals(array, prop, value)` | `true` si la propriété est égale à la valeur sur au moins un élément |
+| `someNonEmptyString(array, prop)` | `true` si la propriété est une chaîne non vide sur au moins un élément |
+| `none(array, prop)` | `true` si la propriété est falsy sur chaque élément |
+| `noneDefined(array, prop)` | `true` si la propriété est undefined sur chaque élément |
+| `noneEquals(array, prop, value)` | `true` si la propriété n'est égale à la valeur sur aucun élément |
diff --git a/packages/twenty-docs/l/fr/developers/extend/apps/layout/front-components.mdx b/packages/twenty-docs/l/fr/developers/extend/apps/layout/front-components.mdx
new file mode 100644
index 00000000000..edad3ac8b5d
--- /dev/null
+++ b/packages/twenty-docs/l/fr/developers/extend/apps/layout/front-components.mdx
@@ -0,0 +1,545 @@
+---
+title: Composants frontaux
+description: Créez des composants React qui s’affichent dans l’interface utilisateur (UI) de Twenty avec une isolation en bac à sable.
+icon: window-maximize
+---
+
+Les composants frontaux sont des composants React qui s'affichent directement dans l'interface utilisateur de Twenty. Ils s'exécutent dans un **Web Worker isolé** en utilisant Remote DOM — votre code est isolé mais s'affiche nativement dans la page, pas dans un iframe.
+
+## Où les composants frontaux peuvent être utilisés
+
+Les composants frontaux peuvent s'afficher à deux emplacements au sein de Twenty :
+
+* **Panneau latéral** — Les composants frontaux non-headless s'ouvrent dans le panneau latéral droit. Il s'agit du comportement par défaut lorsqu'un composant frontal est déclenché depuis le menu de commande.
+* **Widgets (tableaux de bord et pages d'enregistrement)** — Les composants frontaux peuvent être intégrés comme widgets dans les [mises en page](/l/fr/developers/extend/apps/layout/page-layouts). Lors de la configuration d'un tableau de bord ou d'une page d'enregistrement, les utilisateurs peuvent ajouter un widget de composant frontal.
+
+Un composant frontal seul n'est pas accessible depuis l'interface utilisateur — vous devez l'*exposer*. Les deux façons de le faire sont :
+
+* **L'associer à un [élément de menu de commande](/l/fr/developers/extend/apps/layout/command-menu-items)** — l'enregistre dans le menu de commande (Cmd+K) et, éventuellement, comme action rapide épinglée.
+* **L'intégrer comme widget dans une [mise en page](/l/fr/developers/extend/apps/layout/page-layouts)** — le place sur la page de détails d'un enregistrement ou sur un tableau de bord.
+
+## Exemple de base
+
+La façon la plus rapide de voir un composant frontal en action est de l'associer à un [`defineCommandMenuItem`](/l/fr/developers/extend/apps/layout/command-menu-items), afin qu'il apparaisse comme bouton d'action rapide dans le coin supérieur droit de la page :
+
+```tsx src/front-components/hello-world.tsx
+import { defineFrontComponent } from 'twenty-sdk/define';
+
+const HelloWorld = () => {
+ return (
+ <div style={{ padding: '20px', fontFamily: 'sans-serif' }}>
+ <h1>Hello from my app!</h1>
+ <p>This component renders inside Twenty.</p>
+ </div>
+ );
+};
+
+export default defineFrontComponent({
+ universalIdentifier: '74c526eb-cb68-4cf7-b05c-0dd8c288d948',
+ name: 'hello-world',
+ description: 'A simple front component',
+ component: HelloWorld,
+});
+```
+
+```ts src/command-menu-items/hello-world.command-menu-item.ts
+import { defineCommandMenuItem } from 'twenty-sdk/define';
+
+export default defineCommandMenuItem({
+ universalIdentifier: 'd4e5f6a7-b8c9-0123-defa-456789012345',
+ shortLabel: 'Hello',
+ label: 'Hello World',
+ icon: 'IconBolt',
+ isPinned: true,
+ availabilityType: 'GLOBAL',
+ frontComponentUniversalIdentifier: '74c526eb-cb68-4cf7-b05c-0dd8c288d948',
+});
+```
+
+Après la synchronisation avec `yarn twenty dev` (ou en exécutant une seule fois `yarn twenty dev --once`), l'action rapide apparaît dans le coin supérieur droit de la page :
+
+<div style={{textAlign: 'center'}}>
+ <img src="/images/docs/developers/extends/apps/quick-action.png" alt="Bouton d'action rapide dans le coin supérieur droit" />
+</div>
+
+Cliquez dessus pour afficher le composant en ligne.
+
+## Champs de configuration
+
+| Champ | Obligatoire | Description |
+| --------------------- | ----------- | -------------------------------------------------------------------------------- |
+| `universalIdentifier` | Oui | ID unique et stable pour ce composant |
+| `component` | Oui | Une fonction de composant React |
+| `name` | Non | Nom d'affichage |
+| `description` | Non | Description de ce que fait le composant |
+| `isHeadless` | Non | Définir sur `true` si le composant n'a pas d'interface visible (voir ci-dessous) |
+
+## Placer un composant frontal sur une page
+
+Au-delà des commandes, vous pouvez intégrer un composant frontal directement dans une page d'enregistrement en l'ajoutant comme widget dans une **mise en page**. Voir [mises en page](/l/fr/developers/extend/apps/layout/page-layouts) pour plus de détails.
+
+## Headless vs non-headless
+
+Les composants frontaux existent en deux modes de rendu contrôlés par l’option `isHeadless` :
+
+**Non-headless (par défaut)** — Le composant affiche une interface visible. Lorsqu'il est déclenché depuis le menu de commande, il s'ouvre dans le panneau latéral. Il s'agit du comportement par défaut lorsque `isHeadless` est `false` ou omis.
+
+**Headless (`isHeadless: true`)** — Le composant se monte de façon invisible en arrière-plan. Il n'ouvre pas le panneau latéral. Les composants headless sont conçus pour des actions qui exécutent une logique puis se démontent — par exemple, lancer une tâche asynchrone, naviguer vers une page ou afficher une fenêtre modale de confirmation. Ils s'associent naturellement aux composants Command du SDK décrits ci-dessous.
+
+```tsx src/front-components/sync-tracker.tsx
+import { defineFrontComponent } from 'twenty-sdk/define';
+import { useRecordId, enqueueSnackbar } from 'twenty-sdk/front-component';
+import { useEffect } from 'react';
+
+const SyncTracker = () => {
+ const recordId = useRecordId();
+
+ useEffect(() => {
+ enqueueSnackbar({ message: `Tracking record ${recordId}`, variant: 'info' });
+ }, [recordId]);
+
+ return null;
+};
+
+export default defineFrontComponent({
+ universalIdentifier: '...',
+ name: 'sync-tracker',
+ description: 'Tracks record views silently',
+ isHeadless: true,
+ component: SyncTracker,
+});
+```
+
+Comme le composant retourne `null`, Twenty n'affiche pas de conteneur pour celui-ci — aucun espace vide n'apparaît dans la mise en page. Le composant a toujours accès à tous les hooks et à l'API de communication de l'hôte.
+
+## Composants Command du SDK
+
+Le package `twenty-sdk` fournit quatre composants utilitaires Command conçus pour les composants frontaux headless. Chaque composant exécute une action au montage, gère les erreurs en affichant une notification snackbar et démonte automatiquement le composant frontal une fois terminé.
+
+Importez-les depuis `twenty-sdk/command` :
+
+* **`Command`** — Exécute un callback asynchrone via la prop `execute`.
+* **`CommandLink`** — Navigue vers un chemin d'application. Props : `to`, `params`, `queryParams`, `options`.
+* **`CommandModal`** — Ouvre une fenêtre modale de confirmation. Si l'utilisateur confirme, exécute le callback `execute`. Props : `title`, `subtitle`, `execute`, `confirmButtonText`, `confirmButtonAccent`.
+* **`CommandOpenSidePanelPage`** — Ouvre une page spécifique du panneau latéral. Props : `page`, `pageTitle`, `pageIcon`.
+
+Voici un exemple complet d'un composant frontal headless utilisant `Command` pour exécuter une action depuis le menu de commande :
+
+```tsx src/front-components/run-action.tsx
+import { defineFrontComponent } from 'twenty-sdk/define';
+import { Command } from 'twenty-sdk/command';
+import { CoreApiClient } from 'twenty-sdk/clients';
+
+const RunAction = () => {
+ const execute = async () => {
+ const client = new CoreApiClient();
+
+ await client.mutation({
+ createTask: {
+ __args: { data: { title: 'Created by my app' } },
+ id: true,
+ },
+ });
+ };
+
+ return <Command execute={execute} />;
+};
+
+export default defineFrontComponent({
+ universalIdentifier: 'e5f6a7b8-c9d0-1234-efab-345678901234',
+ name: 'run-action',
+ description: 'Creates a task from the command menu',
+ component: RunAction,
+ isHeadless: true,
+});
+```
+
+```ts src/command-menu-items/run-action.command-menu-item.ts
+import { defineCommandMenuItem } from 'twenty-sdk/define';
+
+export default defineCommandMenuItem({
+ universalIdentifier: 'f6a7b8c9-d0e1-2345-fabc-456789012345',
+ label: 'Run my action',
+ icon: 'IconPlayerPlay',
+ frontComponentUniversalIdentifier: 'e5f6a7b8-c9d0-1234-efab-345678901234',
+});
+```
+
+Et un exemple utilisant `CommandModal` pour demander une confirmation avant l'exécution :
+
+```tsx src/front-components/delete-draft.tsx
+import { defineFrontComponent } from 'twenty-sdk/define';
+import { CommandModal } from 'twenty-sdk/command';
+
+const DeleteDraft = () => {
+ const execute = async () => {
+ // perform the deletion
+ };
+
+ return (
+ <CommandModal
+ title="Delete draft?"
+ subtitle="This action cannot be undone."
+ execute={execute}
+ confirmButtonText="Delete"
+ confirmButtonAccent="danger"
+ />
+ );
+};
+
+export default defineFrontComponent({
+ universalIdentifier: 'a7b8c9d0-e1f2-3456-abcd-567890123456',
+ name: 'delete-draft',
+ description: 'Deletes a draft with confirmation',
+ component: DeleteDraft,
+ isHeadless: true,
+});
+```
+
+## Appel d’une fonction logique
+
+Les composants front s’exécutent côté navigateur dans un Web Worker isolé (sandboxed), tandis que les [fonctions logiques](/l/fr/developers/extend/apps/logic/logic-functions) s’exécutent côté serveur. Il n’y a aucun appel intra-processus direct entre les deux — à la place, un composant front appelle une fonction logique via HTTP.
+
+Une fonction logique déclarée avec `httpRouteTriggerSettings` est exposée sous le point de terminaison `/s/` à `${TWENTY_API_URL}/s\<path>`. Votre composant front appelle cette route avec le `RestApiClient` de `twenty-client-sdk/rest`, qui s’authentifie avec le `TWENTY_APP_ACCESS_TOKEN` que Twenty injecte dans le worker.
+
+Le `RestApiClient` est conçu exactement pour cela. Il lit `TWENTY_API_URL` et `TWENTY_APP_ACCESS_TOKEN` depuis l’environnement du worker, ajoute l’en-tête `Authorization: Bearer`, sérialise et analyse le JSON, et déclenche une `RestApiClientError` lorsque le jeton ou l’URL est manquant ou que la réponse n’est pas de type 2xx — afin que vous n’ayez pas à réimplémenter ce boilerplate dans chaque composant.
+
+Un composant front sans interface (headless) peut effectuer l’appel au montage via le composant `Command`, puis se démonter automatiquement :
+
+```tsx src/front-components/sync-prs.tsx
+import { defineFrontComponent } from 'twenty-sdk/define';
+import { Command } from 'twenty-sdk/command';
+import { RestApiClient } from 'twenty-client-sdk/rest';
+
+const SyncPrs = () => {
+ const execute = async () => {
+ const client = new RestApiClient();
+
+ await client.post('/s/github/fetch-prs', {
+ owner: 'twentyhq',
+ repo: 'twenty',
+ });
+ };
+
+ return <Command execute={execute} />;
+};
+
+export default defineFrontComponent({
+ universalIdentifier: '...',
+ name: 'sync-prs',
+ description: 'Triggers the fetch-prs logic function',
+ isHeadless: true,
+ component: SyncPrs,
+});
+```
+
+Le chemin transmis au client est le chemin public de la route — la propriété `httpRouteTriggerSettings.path` de la fonction logique, préfixée par `/s`. Conservez `isAuthRequired: true` ; le client fournit le jeton d’accès de l’application que Twenty émet pour votre composant :
+
+```ts src/logic-functions/fetch-prs.logic-function.ts
+import { defineLogicFunction } from 'twenty-sdk/define';
+import type { RoutePayload } from 'twenty-sdk/logic-function';
+
+const handler = async (event: RoutePayload) => {
+ const { owner, repo } = (event.body ?? {}) as { owner: string; repo: string };
+ // ...fetch from GitHub and persist records...
+ return { ok: true };
+};
+
+export default defineLogicFunction({
+ universalIdentifier: '...',
+ name: 'fetch-prs',
+ handler,
+ httpRouteTriggerSettings: {
+ path: '/github/fetch-prs',
+ httpMethod: 'POST',
+ isAuthRequired: true,
+ },
+});
+```
+
+<Note>
+`TWENTY_API_URL` et `TWENTY_APP_ACCESS_TOKEN` sont injectés automatiquement — voir [Variables d’application](#application-variables). Comme les variables d’application secrètes ne sont jamais exposées aux composants front, conservez les clés d’API et les autres éléments sensibles dans la fonction logique, et non dans le composant front.
+</Note>
+
+### Référence de `RestApiClient`
+
+Importez `RestApiClient` depuis `twenty-client-sdk/rest`. Il appartient à la même famille de clients que `CoreApiClient` et `MetadataApiClient`, mais cible les routes HTTP de votre application au lieu de l’API GraphQL.
+
+| Méthode | Description |
+| --------------------------------- | ---------------------------------------------------- |
+| `get(path, options?)` | Envoie une requête `GET` |
+| `post(path, body?, options?)` | Envoie une requête `POST` |
+| `put(path, body?, options?)` | Envoie une requête `PUT` |
+| `patch(path, body?, options?)` | Envoie une requête `PATCH` |
+| `delete(path, options?)` | Envoie une requête `DELETE` |
+| `request(method, path, options?)` | Requête générique avec n’importe quelle méthode HTTP |
+
+`options` accepte `headers`, `query` (un enregistrement de paramètres de chaîne de requête ; les valeurs nullish sont ignorées), et un `AbortSignal` via `signal`. Un objet `body` qui n’est pas de type `FormData` est automatiquement sérialisé en JSON. Sur un `401`, le client actualise une fois le jeton d’accès via l’hôte puis retente la requête.
+
+Par défaut, l’URL de base et le jeton sont résolus à partir de l’environnement. Passez des valeurs de remplacement (overrides) au constructeur lorsque nécessaire — par exemple dans les tests :
+
+```ts
+const client = new RestApiClient({
+ baseUrl: 'https://api.example.com',
+ token: 'my-token',
+});
+```
+
+Les requêtes ayant échoué lèvent une erreur `RestApiClientError` exposant `status`, `statusText`, `url` et le `body` analysé :
+
+```tsx
+import { RestApiClient, RestApiClientError } from 'twenty-client-sdk/rest';
+
+const client = new RestApiClient();
+
+try {
+ const prs = await client.get('/s/github/fetch-prs', {
+ query: { state: 'open' },
+ });
+} catch (error) {
+ if (error instanceof RestApiClientError) {
+ console.error(error.status, error.body);
+ }
+}
+```
+
+## Accéder au contexte d'exécution
+
+Dans votre composant, utilisez les hooks du SDK pour accéder à l'utilisateur actuel, à l'enregistrement et à l'instance du composant :
+
+```tsx src/front-components/record-info.tsx
+import { defineFrontComponent } from 'twenty-sdk/define';
+import {
+ useUserId,
+ useRecordId,
+ useFrontComponentId,
+} from 'twenty-sdk/front-component';
+
+const RecordInfo = () => {
+ const userId = useUserId();
+ const recordId = useRecordId();
+ const componentId = useFrontComponentId();
+
+ return (
+ <div>
+ <p>User: {userId}</p>
+ <p>Record: {recordId ?? 'No record context'}</p>
+ <p>Component: {componentId}</p>
+ </div>
+ );
+};
+
+export default defineFrontComponent({
+ universalIdentifier: 'b2c3d4e5-f6a7-8901-bcde-f23456789012',
+ name: 'record-info',
+ component: RecordInfo,
+});
+```
+
+Hooks disponibles :
+
+| Hook | Renvoie | Description |
+| --------------------------------------------- | --------------------- | -------------------------------------------------------------------------------------- |
+| `useUserId()` | `string` ou `null` | L'ID de l'utilisateur actuel |
+| `useSelectedRecordIds()` | `string[]` | Tous les ID des enregistrements sélectionnés (tableau vide si aucun n'est sélectionné) |
+| `useRecordId()` | `string` ou `null` | **Obsolète.** Utilisez `useSelectedRecordIds()` à la place |
+| `useFrontComponentId()` | `string` | L'ID de cette instance de composant |
+| `useColorScheme()` | `'light'` ou `'dark'` | Schéma de couleur actif de l’interface hôte (`System` est déjà résolu) |
+| `useFrontComponentExecutionContext(selector)` | variable | Accédez au contexte d'exécution complet avec une fonction sélecteur |
+
+## Variables d'application
+
+Les variables d'application définies dans [`defineApplication()`](/l/fr/developers/extend/apps/config/application) avec `isSecret: false` sont disponibles dans les composants front via l'utilitaire `getApplicationVariable` :
+
+```tsx src/front-components/greeting.tsx
+import { defineFrontComponent } from 'twenty-sdk/define';
+import { getApplicationVariable } from 'twenty-sdk/front-component';
+
+const Greeting = () => {
+ const recipientName = getApplicationVariable('DEFAULT_RECIPIENT_NAME') ?? 'World';
+
+ return <p>Hello, {recipientName}!</p>;
+};
+
+export default defineFrontComponent({
+ universalIdentifier: '...',
+ name: 'greeting',
+ component: Greeting,
+});
+```
+
+<Warning>
+Les variables secrètes (`isSecret: true`) ne sont **pas** exposées aux composants front. Elles sont uniquement disponibles dans les [fonctions logiques](/l/fr/developers/extend/apps/logic/logic-functions), qui s'exécutent côté serveur. Cela empêche l’envoi au navigateur de valeurs sensibles comme les clés d’API.
+</Warning>
+
+Les variables système suivantes sont toujours disponibles via `process.env` :
+
+| Variable | Description |
+| ------------------------- | --------------------------------------------------------- |
+| `TWENTY_API_URL` | URL de base de l’API Twenty |
+| `TWENTY_APP_ACCESS_TOKEN` | Jeton de courte durée limité au rôle de votre application |
+
+## API de communication de l'hôte
+
+Les composants frontaux peuvent déclencher la navigation, des modales et des notifications en utilisant des fonctions de `twenty-sdk` :
+
+| Fonction | Description |
+| ----------------------------------------------- | ---------------------------------------------- |
+| `navigate(to, params?, queryParams?, options?)` | Naviguer vers une page de l'application |
+| `openSidePanelPage(params)` | Ouvrir un panneau latéral |
+| `closeSidePanel()` | Fermer le panneau latéral |
+| `openCommandConfirmationModal(params)` | Afficher une boîte de dialogue de confirmation |
+| `enqueueSnackbar(params)` | Afficher une notification toast |
+| `unmountFrontComponent()` | Démonter le composant |
+| `updateProgress(progress)` | Mettre à jour un indicateur de progression |
+
+Voici un exemple qui utilise l'API hôte pour afficher une snackbar et fermer le panneau latéral après la fin d'une action :
+
+```tsx src/front-components/archive-record.tsx
+import { defineFrontComponent } from 'twenty-sdk/define';
+import { useRecordId } from 'twenty-sdk/front-component';
+import { enqueueSnackbar, closeSidePanel } from 'twenty-sdk/front-component';
+import { CoreApiClient } from 'twenty-sdk/clients';
+
+const ArchiveRecord = () => {
+ const recordId = useRecordId();
+
+ const handleArchive = async () => {
+ const client = new CoreApiClient();
+
+ await client.mutation({
+ updateTask: {
+ __args: { id: recordId, data: { status: 'ARCHIVED' } },
+ id: true,
+ },
+ });
+
+ await enqueueSnackbar({
+ message: 'Record archived',
+ variant: 'success',
+ });
+
+ await closeSidePanel();
+ };
+
+ return (
+ <div style={{ padding: '20px' }}>
+ <p>Archive this record?</p>
+ <button onClick={handleArchive}>Archive</button>
+ </div>
+ );
+};
+
+export default defineFrontComponent({
+ universalIdentifier: 'c9d0e1f2-a3b4-5678-cdef-789012345678',
+ name: 'archive-record',
+ description: 'Archives the current record',
+ component: ArchiveRecord,
+});
+```
+
+### Travailler avec plusieurs enregistrements
+
+Utilisez `useSelectedRecordIds()` pour gérer plusieurs enregistrements sélectionnés. C'est utile pour les opérations groupées :
+
+```tsx src/front-components/bulk-export.tsx
+import { defineFrontComponent, numberOfSelectedRecords } from 'twenty-sdk/define';
+import { useSelectedRecordIds } from 'twenty-sdk/front-component';
+import { enqueueSnackbar, closeSidePanel } from 'twenty-sdk/front-component';
+import { CoreApiClient } from 'twenty-sdk/clients';
+
+const BulkExport = () => {
+ const selectedRecordIds = useSelectedRecordIds();
+
+ const handleExport = async () => {
+ const client = new CoreApiClient();
+
+ for (const recordId of selectedRecordIds) {
+ await client.mutation({
+ updateTask: {
+ __args: { id: recordId, data: { exported: true } },
+ id: true,
+ },
+ });
+ }
+
+ await enqueueSnackbar({
+ message: `Exported ${selectedRecordIds.length} records`,
+ variant: 'success',
+ });
+
+ await closeSidePanel();
+ };
+
+ return (
+ <div style={{ padding: '20px' }}>
+ <p>Export {selectedRecordIds.length} selected record(s)?</p>
+ <button onClick={handleExport}>Export</button>
+ </div>
+ );
+};
+
+export default defineFrontComponent({
+ universalIdentifier: 'd0e1f2a3-b4c5-6789-defa-012345678901',
+ name: 'bulk-export',
+ description: 'Export selected records',
+ component: BulkExport,
+ command: {
+ universalIdentifier: 'd0e1f2a3-b4c5-6789-defa-012345678902',
+ label: 'Bulk Export',
+ availabilityType: 'RECORD_SELECTION',
+ conditionalAvailabilityExpression: numberOfSelectedRecords > 0,
+ },
+});
+```
+
+## Ressources publiques
+
+Les composants frontaux peuvent accéder aux fichiers du répertoire `public/` de l'application à l'aide de `getPublicAssetUrl` :
+
+```tsx
+import { defineFrontComponent } from 'twenty-sdk/define';
+import { getPublicAssetUrl } from 'twenty-sdk/utils';
+
+const Logo = () => <img src={getPublicAssetUrl('logo.png')} alt="Logo" />;
+
+export default defineFrontComponent({
+ universalIdentifier: '...',
+ name: 'logo',
+ component: Logo,
+});
+```
+
+Voir la [section sur les ressources publiques](/l/fr/developers/extend/apps/config/public-assets) pour plus de détails.
+
+## Stylisation
+
+Les composants frontaux prennent en charge plusieurs approches de stylisation. Vous pouvez utiliser :
+
+* **Styles en ligne** — `style={{ color: 'red' }}`
+* **Composants Twenty UI** — à importer depuis `twenty-sdk/ui` (Button, Tag, Status, Chip, Avatar, etc.)
+* **Emotion** — CSS-in-JS avec `@emotion/react`
+* **Styled-components** — modèles `styled.div`
+* **Tailwind CSS** — classes utilitaires
+* **Toute bibliothèque CSS-in-JS** compatible avec React
+
+```tsx
+import { defineFrontComponent } from 'twenty-sdk/define';
+import { Button, Tag, Status } from 'twenty-sdk/ui';
+
+const StyledWidget = () => {
+ return (
+ <div style={{ padding: '16px', display: 'flex', gap: '8px' }}>
+ <Button title="Click me" onClick={() => alert('Clicked!')} />
+ <Tag text="Active" color="green" />
+ <Status color="green" text="Online" />
+ </div>
+ );
+};
+
+export default defineFrontComponent({
+ universalIdentifier: 'e5f6a7b8-c9d0-1234-efab-567890123456',
+ name: 'styled-widget',
+ component: StyledWidget,
+});
+```
diff --git a/packages/twenty-docs/l/fr/developers/extend/apps/layout/navigation-menu-items.mdx b/packages/twenty-docs/l/fr/developers/extend/apps/layout/navigation-menu-items.mdx
new file mode 100644
index 00000000000..1cce5549c92
--- /dev/null
+++ b/packages/twenty-docs/l/fr/developers/extend/apps/layout/navigation-menu-items.mdx
@@ -0,0 +1,44 @@
+---
+title: Éléments de menu de navigation
+description: Ajoutez des entrées personnalisées à la barre latérale de l’espace de travail — des liens vers des vues enregistrées ou des URL externes.
+icon: barres
+---
+
+Un **élément de menu de navigation** est une entrée dans la barre latérale gauche. Utilisez `defineNavigationMenuItem()` pour ajouter des liens personnalisés dans la barre latérale — généralement un par [vue](/l/fr/developers/extend/apps/layout/views) — ou pour pointer vers des URL externes.
+
+```ts src/navigation-menu-items/example-navigation-menu-item.ts
+import { defineNavigationMenuItem, NavigationMenuItemType } from 'twenty-sdk/define';
+import { EXAMPLE_VIEW_UNIVERSAL_IDENTIFIER } from '../views/example-view';
+
+export default defineNavigationMenuItem({
+ universalIdentifier: '9327db91-afa1-41b6-bd9d-2b51a26efb4c',
+ name: 'example-navigation-menu-item',
+ icon: 'IconList',
+ color: 'blue',
+ position: 0,
+ type: NavigationMenuItemType.VIEW,
+ viewUniversalIdentifier: EXAMPLE_VIEW_UNIVERSAL_IDENTIFIER,
+});
+```
+
+## Points clés
+
+* `type` détermine la destination de l’élément de menu. Chaque type est associé à un champ d’identifiant spécifique :
+
+ | Type | Ce que cela fait | Champ obligatoire |
+ | ------------------------------------ | -------------------------------------------------- | ------------------------------------------------------------------------------------------ |
+ | `NavigationMenuItemType.VIEW` | Ouvre une vue enregistrée | `viewUniversalIdentifier` |
+ | `NavigationMenuItemType.LINK` | Ouvre une URL externe | `link` |
+ | `NavigationMenuItemType.FOLDER` | Regroupe les éléments imbriqués sous une étiquette | `name` (et les éléments enfants font référence au dossier via `folderUniversalIdentifier`) |
+ | `NavigationMenuItemType.OBJECT` | Ouvre la page d’index par défaut d’un objet | `targetObjectUniversalIdentifier` |
+ | `NavigationMenuItemType.PAGE_LAYOUT` | Ouvre une mise en page autonome | `pageLayoutUniversalIdentifier` |
+
+* `position` contrôle l’ordre dans la barre latérale.
+
+* `icon` et `color` sont facultatifs et personnalisent l’apparence de l’entrée.
+
+* `folderUniversalIdentifier` est également disponible sur n’importe quel élément pour l’imbriquer dans un parent de type `FOLDER`.
+
+<Note>
+**Piège courant :** créer un objet sans vue associée + élément de menu de navigation rend cet objet invisible pour les utilisateurs. À moins qu’il ne s’agisse d’un objet technique/interne, chaque objet personnalisé doit avoir une vue par défaut *et* une entrée dans la barre latérale qui pointe vers celle-ci.
+</Note>
diff --git a/packages/twenty-docs/l/fr/developers/extend/apps/layout/overview.mdx b/packages/twenty-docs/l/fr/developers/extend/apps/layout/overview.mdx
new file mode 100644
index 00000000000..7a1cfaf281d
--- /dev/null
+++ b/packages/twenty-docs/l/fr/developers/extend/apps/layout/overview.mdx
@@ -0,0 +1,56 @@
+---
+title: Vue d'ensemble
+description: Placez votre application à l’intérieur de l’interface de Twenty — entrées de barre latérale, vues enregistrées, onglets de page d’enregistrement et composants React isolés.
+icon: table-columns
+---
+
+La **couche de mise en page** d’une application Twenty est tout ce que l’utilisateur voit : où l’application apparaît dans la barre latérale, quelles vues de liste elle fournit, comment ses pages de détails d’enregistrement sont organisées et quels composants React personnalisés sont rendus à l’intérieur de ces pages.
+
+```text
+ Sidebar Record list Record detail page
+ ─────── ─────────── ──────────────────
+ [📋 My View] ────▶ ┌──────────┐ ┌─────────────────────┐
+ [📋 Drafts ] │ Companies│ │ Tabs: [Overview ] │
+ [📋 Inbox ] │ ──────── │ │ [Notes ] │
+ ▲ │ Apple │ │ [Hello ]◀──── definePageLayoutTab
+ │ │ Acme │ │ │ adds a tab...
+ └ defineNavi- │ … │ │ ┌────────────────┐ │
+ gationMenu- └────▲─────┘ │ │ │ │
+ Item points │ │ │ React UI │◀── …with a
+ to a defineView │ │ │ (sandboxed in │ │ defineFrontComponent
+ └ defineView │ │ a Worker) │ │ widget inside
+ picks columns │ └────────────────┘ │
+ and filters └─────────────────────┘
+```
+
+## Dans cette section
+
+<CardGroup cols={2}>
+ <Card title="Vues" icon="list" href="/l/fr/developers/extend/apps/layout/views">
+ `defineView` — configurations de listes enregistrées : colonnes visibles, filtres, groupes.
+ </Card>
+ <Card title="Éléments de menu de navigation" icon="bars" href="/l/fr/developers/extend/apps/layout/navigation-menu-items">
+ `defineNavigationMenuItem` — entrées de barre latérale pointant vers des vues ou des URL externes.
+ </Card>
+ <Card title="Mises en page" icon="table-columns" href="/l/fr/developers/extend/apps/layout/page-layouts">
+ `definePageLayout` et `definePageLayoutTab` — onglets et widgets sur la page de détails d’un enregistrement.
+ </Card>
+ <Card title="Composants frontaux" icon="window-maximize" href="/l/fr/developers/extend/apps/layout/front-components">
+ `defineFrontComponent` — composants React isolés rendus à l’intérieur de Twenty.
+ </Card>
+ <Card title="Éléments du menu de commande" icon="terminal" href="/l/fr/developers/extend/apps/layout/command-menu-items">
+ `defineCommandMenuItem` — enregistre des composants frontaux comme entrées Cmd+K et actions rapides.
+ </Card>
+</CardGroup>
+
+## Où l’application apparaît
+
+| Surface | Ce qu'il contrôle | Entité |
+| ------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------- | ----------------------------------------- |
+| **Barre latérale** | Une entrée personnalisée pointant vers une vue enregistrée ou une URL externe | `defineNavigationMenuItem` |
+| **Liste des enregistrements** | Une configuration enregistrée pour un objet — colonnes visibles, ordre, filtres, groupes | `defineView` |
+| **Page de détails de l’enregistrement** | Les onglets et widgets sur une page d’enregistrement (celle de votre propre objet ou une page standard) | `definePageLayout`, `definePageLayoutTab` |
+| **À l’intérieur de n’importe lequel des éléments ci-dessus** | Un widget React personnalisé — boutons, formulaires, tableaux de bord, intégrations | `defineFrontComponent` |
+| **Menu de commande (Cmd+K)** | Une action rapide épinglée ou une commande masquée | `defineCommandMenuItem` |
+
+Les composants frontaux s’exécutent à l’intérieur d’un Web Worker isolé en utilisant Remote DOM — ils sont rendus *nativement* dans la page (et non dans une iframe), mais ne peuvent pas accéder directement à la page hôte ou au DOM. La communication avec Twenty se fait via une API hôte de passage de messages.
diff --git a/packages/twenty-docs/l/fr/developers/extend/apps/layout/page-layouts.mdx b/packages/twenty-docs/l/fr/developers/extend/apps/layout/page-layouts.mdx
new file mode 100644
index 00000000000..6d007ce3ee2
--- /dev/null
+++ b/packages/twenty-docs/l/fr/developers/extend/apps/layout/page-layouts.mdx
@@ -0,0 +1,132 @@
+---
+title: Mises en page de la page
+description: Personnalisez les pages de détail des enregistrements — onglets, widgets et emplacement de rendu des composants front-end — à l'aide de `definePageLayout` et `definePageLayoutTab`.
+icon: table-columns
+---
+
+Une mise en page contrôle la façon dont la page de détail d'un enregistrement est organisée : quels onglets apparaissent et quels widgets ils contiennent. Utilisez `definePageLayout()` pour déclarer une mise en page pour un objet que vous possédez, ou `definePageLayoutTab()` pour ajouter un seul onglet à une mise en page qui existe déjà (la vôtre ou une mise en page standard de Twenty).
+
+| Cas d'utilisation | Entité |
+| -------------------------------------------------------------------------------------------------------------- | --------------------- |
+| Définir l'intégralité de la mise en page de la page de détail des enregistrements d'un objet que vous possédez | `definePageLayout` |
+| Ajouter un onglet à une mise en page existante (votre propre objet ou un objet standard) | `definePageLayoutTab` |
+
+## definePageLayout
+
+Utilisez ceci lorsque vous possédez l'intégralité de la page de détail — généralement pour un objet personnalisé que vous avez défini vous-même.
+
+```ts src/page-layouts/example-record-page-layout.ts
+import { definePageLayout, PageLayoutTabLayoutMode } from 'twenty-sdk/define';
+import { EXAMPLE_OBJECT_UNIVERSAL_IDENTIFIER } from '../objects/example-object';
+import { HELLO_WORLD_FRONT_COMPONENT_UNIVERSAL_IDENTIFIER } from '../front-components/hello-world';
+
+export default definePageLayout({
+ universalIdentifier: '203aeb94-6701-46d6-9af1-be2bbcc9e134',
+ name: 'Example Record Page',
+ type: 'RECORD_PAGE',
+ objectUniversalIdentifier: EXAMPLE_OBJECT_UNIVERSAL_IDENTIFIER,
+ tabs: [
+ {
+ universalIdentifier: '6ed26b60-a51d-4ad7-86dd-1c04c7f3cac5',
+ title: 'Hello World',
+ position: 50,
+ icon: 'IconWorld',
+ layoutMode: PageLayoutTabLayoutMode.CANVAS,
+ widgets: [
+ {
+ universalIdentifier: 'aa4234e0-2e5f-4c02-a96a-573449e2351d',
+ title: 'Hello World',
+ type: 'FRONT_COMPONENT',
+ configuration: {
+ configurationType: 'FRONT_COMPONENT',
+ frontComponentUniversalIdentifier:
+ HELLO_WORLD_FRONT_COMPONENT_UNIVERSAL_IDENTIFIER,
+ },
+ },
+ ],
+ },
+ ],
+});
+```
+
+### Points clés
+
+* `type` est généralement `'RECORD_PAGE'` pour personnaliser la vue détaillée d'un objet spécifique.
+* `objectUniversalIdentifier` spécifie à quel objet cette mise en page s'applique.
+* Chaque `tab` définit une section de la page avec un `title`, une `position` et un `layoutMode` (`CANVAS` pour une mise en page libre).
+* Chaque `widget` à l'intérieur d'un onglet peut afficher un [front component](/l/fr/developers/extend/apps/layout/front-components), une liste de relations ou d'autres types de widgets intégrés.
+* La `position` des onglets contrôle leur ordre. Utilisez des valeurs plus élevées (p. ex., 50) pour placer les onglets personnalisés après les onglets intégrés.
+
+## definePageLayoutTab
+
+Utilisez ceci lorsque vous voulez uniquement ajouter un onglet à une mise en page existante — par exemple, un onglet d'analyse sur la page standard Company, ou un onglet de résumé d'IA rattaché à la mise en page de votre propre objet.
+
+```ts src/page-layouts/example-extra-tab.ts
+import {
+ definePageLayoutTab,
+ PageLayoutTabLayoutMode,
+ STANDARD_PAGE_LAYOUT_UNIVERSAL_IDENTIFIERS,
+} from 'twenty-sdk/define';
+import { HELLO_WORLD_FRONT_COMPONENT_UNIVERSAL_IDENTIFIER } from '../front-components/hello-world';
+
+export default definePageLayoutTab({
+ universalIdentifier: 'b1b2b3b4-b5b6-4000-8000-000000000001',
+ pageLayoutUniversalIdentifier:
+ STANDARD_PAGE_LAYOUT_UNIVERSAL_IDENTIFIERS.companyRecordPage
+ .universalIdentifier,
+ title: 'Hello World',
+ position: 1000,
+ icon: 'IconWorld',
+ layoutMode: PageLayoutTabLayoutMode.CANVAS,
+ widgets: [
+ {
+ universalIdentifier: 'b1b2b3b4-b5b6-4000-8000-000000000002',
+ title: 'Hello World',
+ type: 'FRONT_COMPONENT',
+ configuration: {
+ configurationType: 'FRONT_COMPONENT',
+ frontComponentUniversalIdentifier:
+ HELLO_WORLD_FRONT_COMPONENT_UNIVERSAL_IDENTIFIER,
+ },
+ },
+ ],
+});
+```
+
+### Points clés
+
+* `pageLayoutUniversalIdentifier` est **obligatoire** et doit pointer vers une mise en page de page qui existe déjà au moment de l'installation — soit une mise en page standard de Twenty, soit une mise en page définie par votre propre application. Les références inter-applications aux mises en page appartenant à une autre application installée ne sont pas prises en charge aujourd'hui. Lorsque la mise en page parente est manquante, l'installation échoue avec une erreur de validation explicite.
+
+* Pour les mises en page standard de Twenty, importez les identifiants depuis `twenty-sdk/define` :
+
+ ```ts
+ import { STANDARD_PAGE_LAYOUT_UNIVERSAL_IDENTIFIERS } from 'twenty-sdk/define';
+
+ // STANDARD_PAGE_LAYOUT_UNIVERSAL_IDENTIFIERS.companyRecordPage.universalIdentifier
+ // STANDARD_PAGE_LAYOUT_UNIVERSAL_IDENTIFIERS.personRecordPage.universalIdentifier
+ // STANDARD_PAGE_LAYOUT_UNIVERSAL_IDENTIFIERS.taskRecordPage.universalIdentifier
+ // STANDARD_PAGE_LAYOUT_UNIVERSAL_IDENTIFIERS.opportunityRecordPage.universalIdentifier
+ // STANDARD_PAGE_LAYOUT_UNIVERSAL_IDENTIFIERS.noteRecordPage.universalIdentifier
+ // …
+ ```
+
+ Chaque entrée de mise en page expose également ses `tabs` et leurs `widgets`, afin que vous puissiez faire référence à n’importe quel niveau :
+
+ ```ts
+ STANDARD_PAGE_LAYOUT_UNIVERSAL_IDENTIFIERS.taskRecordPage.tabs.home.universalIdentifier
+ STANDARD_PAGE_LAYOUT_UNIVERSAL_IDENTIFIERS.taskRecordPage.tabs.home.widgets.fields.universalIdentifier
+ ```
+
+ Un alias court `STANDARD_PAGE_LAYOUT` est également disponible :
+
+ ```ts
+ import { STANDARD_PAGE_LAYOUT } from 'twenty-sdk/define';
+
+ STANDARD_PAGE_LAYOUT.companyRecordPage.universalIdentifier;
+ ```
+
+* Les `widgets` sont limités à cet onglet uniquement — ils font référence aux [front components](/l/fr/developers/extend/apps/layout/front-components), aux vues, etc., exactement comme les widgets définis en ligne dans `definePageLayout`.
+
+* `position` contrôle l'ordre par rapport aux onglets existants sur la mise en page ciblée. Choisissez une valeur qui place votre onglet à l'endroit souhaité par rapport aux onglets intégrés.
+
+* Utilisez ceci plutôt que `definePageLayout` lorsque vous voulez seulement ajouter à une mise en page existante. Utilisez `definePageLayout` lorsque vous possédez l'intégralité de la mise en page.
diff --git a/packages/twenty-docs/l/fr/developers/extend/apps/layout/views.mdx b/packages/twenty-docs/l/fr/developers/extend/apps/layout/views.mdx
new file mode 100644
index 00000000000..5767d2abcb6
--- /dev/null
+++ b/packages/twenty-docs/l/fr/developers/extend/apps/layout/views.mdx
@@ -0,0 +1,97 @@
+---
+title: Vues
+description: Livrez des vues enregistrées préconfigurées — ordre des colonnes, filtres, groupes — pour les objets de votre application.
+icon: list
+---
+
+Une **vue** est une configuration enregistrée pour la façon dont les enregistrements d’un objet sont affichés : quels champs apparaissent, leur ordre, s’ils sont visibles, ainsi que les filtres ou groupes appliqués. Utilisez `defineView()` pour livrer des vues préconfigurées avec votre application — généralement une vue d’index par défaut pour chaque objet personnalisé que vous créez.
+
+```ts src/views/example-view.ts
+import { defineView, ViewKey } from 'twenty-sdk/define';
+import { EXAMPLE_OBJECT_UNIVERSAL_IDENTIFIER } from '../objects/example-object';
+import { NAME_FIELD_UNIVERSAL_IDENTIFIER } from '../objects/example-object';
+
+export default defineView({
+ universalIdentifier: 'a1b2c3d4-e5f6-7890-abcd-ef1234567890',
+ name: 'All example items',
+ objectUniversalIdentifier: EXAMPLE_OBJECT_UNIVERSAL_IDENTIFIER,
+ icon: 'IconList',
+ key: ViewKey.INDEX,
+ position: 0,
+ fields: [
+ {
+ universalIdentifier: 'f926bdb7-6af7-4683-9a09-adbca56c29f0',
+ fieldMetadataUniversalIdentifier: NAME_FIELD_UNIVERSAL_IDENTIFIER,
+ position: 0,
+ isVisible: true,
+ size: 200,
+ },
+ ],
+});
+```
+
+## Points clés
+
+* `objectUniversalIdentifier` spécifie à quel objet cette vue s'applique. Il peut s’agir d’un objet personnalisé que vous avez défini ou d’un objet Twenty standard.
+* `key` détermine le type de vue — `ViewKey.INDEX` est la vue de liste principale pour l’objet.
+* `fields` contrôle les colonnes affichées et leur ordre. Chaque champ référence un `fieldMetadataUniversalIdentifier`.
+* Vous pouvez également définir `filters`, `filterGroups`, `groups` et `fieldGroups` pour des configurations plus avancées.
+* `position` contrôle l’ordre lorsqu’il existe plusieurs vues pour le même objet.
+
+## Filtres
+
+Une vue peut être livrée avec des filtres préappliqués. Chaque filtre possède trois coordonnées : le **champ** faisant l’objet du filtrage, l’**opérateur** (comment comparer) et la **valeur** (par rapport à quoi comparer). Les trois doivent être alignées : l’utilisation d’un opérateur qui ne s’applique pas à un type de champ sera rejetée au moment de la synchronisation.
+
+```ts
+import { ViewFilterOperand } from 'twenty-shared/types';
+
+filters: [
+ {
+ universalIdentifier: '...',
+ fieldMetadataUniversalIdentifier: STATUS_FIELD_UNIVERSAL_IDENTIFIER,
+ operand: ViewFilterOperand.IS,
+ value: ['ACTIVE'],
+ },
+],
+```
+
+### Opérateurs pris en charge par type de champ
+
+| Type de champ | Opérandes pris en charge |
+| -------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------ |
+| `TEXT`, `EMAILS`, `FULL_NAME`, `ADDRESS`, `LINKS`, `PHONES`, `RAW_JSON`, `FILES`, `ACTOR`, `ARRAY` | `CONTAINS`, `DOES_NOT_CONTAIN`, `IS_EMPTY`, `IS_NOT_EMPTY` |
+| `ACTOR.source`, `ACTOR.workspaceMemberId` | `IS`, `IS_NOT`, `IS_EMPTY`, `IS_NOT_EMPTY` |
+| `SELECT` | `IS`, `IS_NOT`, `IS_EMPTY`, `IS_NOT_EMPTY` |
+| `MULTI_SELECT` | `CONTAINS`, `DOES_NOT_CONTAIN`, `IS_EMPTY`, `IS_NOT_EMPTY` |
+| `RELATION` | `IS`, `IS_NOT`, `IS_EMPTY`, `IS_NOT_EMPTY` |
+| `NUMBER` | `IS`, `IS_NOT`, `GREATER_THAN_OR_EQUAL`, `LESS_THAN_OR_EQUAL`, `IS_EMPTY`, `IS_NOT_EMPTY` |
+| `RATING` | `IS`, `GREATER_THAN_OR_EQUAL`, `LESS_THAN_OR_EQUAL`, `IS_EMPTY`, `IS_NOT_EMPTY` |
+| `CURRENCY`, `CURRENCY.amountMicros` | `GREATER_THAN_OR_EQUAL`, `LESS_THAN_OR_EQUAL`, `IS`, `IS_NOT`, `IS_EMPTY`, `IS_NOT_EMPTY` |
+| `CURRENCY.currencyCode` | `IS`, `IS_NOT`, `IS_EMPTY`, `IS_NOT_EMPTY` |
+| `DATE`, `DATE_TIME` | `IS`, `IS_RELATIVE`, `IS_IN_PAST`, `IS_IN_FUTURE`, `IS_TODAY`, `IS_BEFORE`, `IS_AFTER`, `IS_EMPTY`, `IS_NOT_EMPTY` |
+| `BOOLEAN` | `IS` |
+| `UUID` | `IS`, `IS_NOT`, `IS_EMPTY`, `IS_NOT_EMPTY` |
+| `TS_VECTOR` | `VECTOR_SEARCH` |
+
+> Les types de champs avec des noms similaires peuvent utiliser des opérandes complètement différents — `SELECT` et `MULTI_SELECT` étant un cas courant.
+
+### Forme de valeur par opérande
+
+Le champ `value` est toujours une valeur sérialisable en JSON, mais sa forme attendue dépend de l’opérande :
+
+| Famille d’opérandes | Forme de la valeur | Exemple |
+| ----------------------------------------------------------- | ------------------------------------ | ------------------------ |
+| `IS`, `IS_NOT` sur `SELECT` | tableau de clés d’option (chaînes) | `['ACTIVE', 'PENDING']` |
+| `CONTAINS`, `DOES_NOT_CONTAIN` sur `MULTI_SELECT` | tableau de clés d’option (chaînes) | `['TAG_A']` |
+| `IS`, `IS_NOT` sur `RELATION` | tableau d’ID d’enregistrement (UUID) | `['c5a1...']` |
+| `CONTAINS`, `DOES_NOT_CONTAIN` sur les champs de type texte | chaîne | `'acme'` |
+| `IS`, `IS_NOT` sur `NUMBER` | chaîne (la valeur) | `'5'` |
+| `IS` sur `RATING` / `UUID` | chaîne (la valeur) | `'5'` |
+| `GREATER_THAN_OR_EQUAL`, `LESS_THAN_OR_EQUAL` | chaîne (la borne) | `'10'` |
+| `IS`, `IS_BEFORE`, `IS_AFTER` sur `DATE` / `DATE_TIME` | chaîne ISO 8601 | `'2025-01-01T00:00:00Z'` |
+| `IS_EMPTY`, `IS_NOT_EMPTY` | chaîne vide | `''` |
+| `IS` sur `BOOLEAN` | `'true'` ou `'false'` | `'true'` |
+
+## Comment les vues apparaissent dans l’interface utilisateur
+
+Une vue seule n’est pas accessible à partir de la barre latérale. Pour la faire apparaître là, associez-la à un [élément de menu de navigation](/l/fr/developers/extend/apps/layout/navigation-menu-items) de type `VIEW` qui pointe vers le `universalIdentifier` de la vue. C’est le modèle canonique : chaque objet personnalisé livre généralement une vue par défaut + une entrée de barre latérale qui l’ouvre.
diff --git a/packages/twenty-docs/l/fr/developers/extend/apps/logic/connections.mdx b/packages/twenty-docs/l/fr/developers/extend/apps/logic/connections.mdx
new file mode 100644
index 00000000000..bfe62c23b42
--- /dev/null
+++ b/packages/twenty-docs/l/fr/developers/extend/apps/logic/connections.mdx
@@ -0,0 +1,192 @@
+---
+title: Connexions
+description: Autorisez votre application à agir au nom d'un utilisateur auprès de services tiers via OAuth.
+icon: plug
+---
+
+Les connexions sont des identifiants qu'un utilisateur détient pour un service externe (Linear, GitHub, Slack, ...). Votre application déclare **comment** ces identifiants sont obtenus — un **fournisseur de connexion** — et les consomme à l'exécution pour effectuer des appels authentifiés vers l'API tierce.
+
+À ce jour, seul OAuth 2.0 est pris en charge. De futurs types d'identifiants (jetons d'accès personnels, clés d'API, authentification de base) s'intégreront à la même interface — les applications utilisant déjà `defineConnectionProvider({ type: 'oauth', ... `})\` n'auront pas besoin de migrer.
+
+<AccordionGroup>
+
+<Accordion title="defineConnectionProvider" description="Déclarez comment les connexions de votre application sont obtenues">
+
+Un fournisseur de connexion décrit le processus d'échange OAuth requis par votre application. L'utilisateur clique sur "Ajouter une connexion" dans les paramètres de votre application, complète l'écran de consentement du fournisseur, et une ligne `ConnectedAccount` est créée dans son espace de travail.
+
+Une configuration fonctionnelle nécessite **deux fichiers** — le fournisseur de connexion, et une déclaration `serverVariables` correspondante sur `defineApplication` qui contient les identifiants client OAuth.
+
+```ts src/connection-providers/linear-connection.ts
+import { defineConnectionProvider } from 'twenty-sdk/define';
+
+export default defineConnectionProvider({
+ universalIdentifier: '9c7d1f5e-6a0b-4d44-be0c-3f8b5a9d4e6f',
+ name: 'linear',
+ displayName: 'Linear',
+ icon: 'IconBrandLinear',
+ type: 'oauth',
+ oauth: {
+ authorizationEndpoint: 'https://linear.app/oauth/authorize',
+ tokenEndpoint: 'https://api.linear.app/oauth/token',
+ scopes: ['read', 'write'],
+ // These must match keys in `defineApplication.serverVariables` below.
+ clientIdVariable: 'LINEAR_CLIENT_ID',
+ clientSecretVariable: 'LINEAR_CLIENT_SECRET',
+ // Optional: defaults to 'json'. Some providers (Linear, Slack) want
+ // 'form-urlencoded' for the token request.
+ tokenRequestContentType: 'form-urlencoded',
+ // Optional: defaults to true. Disable only if the provider rejects PKCE.
+ usePkce: false,
+ // Optional: extra query params on the authorize URL.
+ // authorizationParams: { prompt: 'consent' },
+ // Optional: provider's RFC 7009 token revocation endpoint, called on disconnect.
+ // revokeEndpoint: 'https://example.com/oauth/revoke',
+ },
+});
+```
+
+```ts src/application.config.ts
+import { defineApplication } from 'twenty-sdk/define';
+
+export default defineApplication({
+ universalIdentifier: '...',
+ displayName: 'Linear',
+ description: 'Connect Linear to Twenty.',
+ // OAuth client credentials live on the app registration (one OAuth app per
+ // Twenty server, configured by the admin) — not per-workspace. Declare them
+ // as serverVariables so the admin can fill them in once for all installs.
+ serverVariables: {
+ LINEAR_CLIENT_ID: {
+ description: 'OAuth client ID from your Linear OAuth application.',
+ isSecret: false,
+ isRequired: true,
+ },
+ LINEAR_CLIENT_SECRET: {
+ description: 'OAuth client secret from your Linear OAuth application.',
+ isSecret: true,
+ isRequired: true,
+ },
+ },
+});
+```
+
+Points clés :
+
+* `name` est l'identifiant unique utilisé dans `listConnections({ providerName })` (kebab-case, doit correspondre à `^[a-z][a-z0-9-]*$`).
+* `displayName` s'affiche dans l'onglet des paramètres par application et dans la liste des outils d'IA.
+* `clientIdVariable` / `clientSecretVariable` sont des **noms**, pas des valeurs — ils doivent correspondre aux clés déclarées dans `defineApplication.serverVariables`. Les `client_id` et `client_secret` réels sont saisis par l'administrateur du serveur via l'interface d'enregistrement de l'application, et ne sont jamais validés dans votre dépôt.
+* Utilisez `serverVariables` (pas `applicationVariables`) — les identifiants OAuth sont au niveau du serveur et il n'y a qu'une application OAuth par serveur Twenty.
+* Tant que les deux `serverVariables` ne sont pas renseignées, l'onglet des paramètres par application affiche une indication "nécessite un administrateur du serveur" et le bouton "Ajouter une connexion" est désactivé.
+* `type: 'oauth'` est la seule valeur prise en charge à ce jour. Le discriminateur est compatible avec les évolutions : des types futurs (`'pat'`, `'api-key'`, ...) ajouteront de nouveaux blocs de sous-configuration à côté de `oauth`.
+
+L'URL de rappel OAuth que votre fournisseur doit autoriser est :
+
+```
+https://<your-twenty-server>/auth/apps/callback
+```
+
+</Accordion>
+
+<Accordion title="listConnections / getConnection" description="Utilisez les connexions depuis une fonction logique">
+
+Dans un gestionnaire de fonction logique, `listConnections({ providerName })` renvoie les lignes `ConnectedAccount` de cette application pour le fournisseur donné, avec des jetons d'accès actualisés.
+
+```ts src/logic-functions/handlers/create-linear-issue-handler.ts
+import { listConnections } from 'twenty-sdk/logic-function';
+
+export const createLinearIssueHandler = async (input: {
+ teamId?: string;
+ title?: string;
+}) => {
+ if (!input.teamId || !input.title) {
+ return { success: false, error: 'teamId and title are required' };
+ }
+
+ const connections = await listConnections({ providerName: 'linear' });
+
+ // Workspace-shared credentials win when present; fall back to the first
+ // user-visibility one. For HTTP-route triggers you typically pick the
+ // request user's connection via event.userWorkspaceId instead.
+ const connection =
+ connections.find((c) => c.visibility === 'workspace') ?? connections[0];
+
+ if (!connection) {
+ return {
+ success: false,
+ error:
+ 'Linear is not connected. Open the app settings and click "Add connection".',
+ };
+ }
+
+ // Use connection.accessToken to call the third-party API.
+ const response = await fetch('https://api.linear.app/graphql', {
+ method: 'POST',
+ headers: {
+ Authorization: `Bearer ${connection.accessToken}`,
+ 'Content-Type': 'application/json',
+ },
+ body: JSON.stringify({
+ query: `mutation { issueCreate(input: { teamId: "${input.teamId}", title: "${input.title}" }) { success } }`,
+ }),
+ });
+
+ return { success: response.ok };
+};
+```
+
+Chaque connexion comporte :
+
+| Champ | Description |
+| ----------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
+| `id` | ID de ligne unique ; à passer à `getConnection(id)` pour en récupérer une seule |
+| `visibility` | `'user'` (réservée à un membre de l'espace de travail) ou `'workspace'` (partagée avec tous les membres) |
+| `scopes` | Autorisations OAuth accordées par le fournisseur en amont (distinctes de `visibility` — sans rapport) |
+| `userWorkspaceId` | L'ID userWorkspace du propriétaire — utile pour sélectionner "la connexion de l'utilisateur de la requête" dans les déclencheurs de routes HTTP |
+| `accessToken` | Jeton d'accès OAuth à jour (actualisé automatiquement s'il a expiré) |
+| `name` / `handle` | Le nom d'affichage de la connexion (déduit automatiquement lors du callback OAuth, renommable par l'utilisateur) |
+| `authFailedAt` | Défini lorsque le rafraîchissement le plus récent a échoué ; l'utilisateur doit se reconnecter |
+
+Points clés :
+
+* Passez `{ providerName }` pour filtrer par fournisseur ; omettez-le pour obtenir toutes les connexions que cette application possède sur l'ensemble des fournisseurs.
+* Le serveur actualise de manière transparente le jeton d'accès avant de répondre. Votre gestionnaire voit toujours un jeton utilisable (ou `authFailedAt` défini).
+* `getConnection(id)` est l'équivalent pour une seule ligne.
+
+</Accordion>
+
+<Accordion title="Visibilité par utilisateur vs partagée à l'échelle de l'espace de travail" description="Comment les utilisateurs choisissent entre des identifiants privés et partagés">
+
+Lorsqu'un utilisateur clique sur "Ajouter une connexion", il lui est demandé de choisir une visibilité :
+
+* **Uniquement pour moi** — les identifiants sont privés pour l'utilisateur qui se connecte. Toute fonction logique appelée en son nom (déclencheur de route HTTP avec `isAuthRequired: true`) y a accès ; les déclencheurs cron et les événements de base de données n'y ont pas accès.
+* **Partagé au niveau de l'espace de travail** — tout membre de l'espace de travail peut utiliser les identifiants. Les déclencheurs cron / base de données y ont également accès, puisqu'ils n'ont pas d'utilisateur de requête.
+
+Utilisez le bon pour chaque gestionnaire :
+
+```ts
+// HTTP-route trigger — prefer the request user's own connection.
+const conn =
+ connections.find((c) => c.userWorkspaceId === event.userWorkspaceId) ??
+ connections.find((c) => c.visibility === 'workspace');
+
+// Cron trigger — no request user; only shared credentials are sensible.
+const conn = connections.find((c) => c.visibility === 'workspace');
+```
+
+Plusieurs connexions par (utilisateur, fournisseur) sont autorisées, ainsi le même utilisateur peut avoir "Linear personnel" et "Linear professionnel" côte à côte.
+
+</Accordion>
+
+<Accordion title="Configuration unique du fournisseur" description="Enregistrez votre application OAuth auprès du service tiers">
+
+Pour chaque fournisseur de connexion, l'administrateur du serveur doit d'abord enregistrer une application OAuth auprès du service tiers.
+
+1. Accédez aux paramètres développeur du fournisseur (par ex. https://linear.app/settings/api/applications/new).
+2. Définissez l'**URI de redirection** sur `\<SERVER_URL>/auth/apps/callback`.
+3. Copiez l'**ID client** et le **Secret client** générés.
+4. Ouvrez l'application installée dans Twenty en tant qu'administrateur du serveur → définissez les valeurs sur les `serverVariables` correspondantes.
+5. Les membres de l'espace de travail peuvent ensuite ajouter des connexions depuis la section **Connexions** par application.
+
+</Accordion>
+
+</AccordionGroup>
diff --git a/packages/twenty-docs/l/fr/developers/extend/apps/logic/logic-functions.mdx b/packages/twenty-docs/l/fr/developers/extend/apps/logic/logic-functions.mdx
new file mode 100644
index 00000000000..847f6c54936
--- /dev/null
+++ b/packages/twenty-docs/l/fr/developers/extend/apps/logic/logic-functions.mdx
@@ -0,0 +1,515 @@
+---
+title: Fonctions logiques
+description: Définissez des fonctions TypeScript côté serveur avec des déclencheurs HTTP, cron et d’événements de base de données.
+icon: bolt
+---
+
+Les fonctions logiques sont des fonctions TypeScript côté serveur qui s'exécutent sur la plateforme Twenty. Elles peuvent être déclenchées par des requêtes HTTP, des programmations cron ou des événements de base de données — et peuvent également être exposées comme des outils pour des agents d'IA.
+
+<AccordionGroup>
+<Accordion title="defineLogicFunction" description="Définir des fonctions logiques et leurs déclencheurs">
+
+Chaque fichier de fonction utilise `defineLogicFunction()` pour exporter une configuration avec un gestionnaire et des déclencheurs facultatifs.
+
+```ts src/logic-functions/createPostCard.logic-function.ts
+import { defineLogicFunction } from 'twenty-sdk/define';
+import type { RoutePayload } from 'twenty-sdk/logic-function';
+import { CoreApiClient } from 'twenty-client-sdk/core';
+
+const handler = async (params: RoutePayload) => {
+ const client = new CoreApiClient();
+ const body = (params.body ?? {}) as { name?: string };
+ const name = body.name ?? process.env.DEFAULT_RECIPIENT_NAME ?? 'Hello world';
+
+ const result = await client.mutation({
+ createPostCard: {
+ __args: { data: { name } },
+ id: true,
+ name: true,
+ },
+ });
+ return result;
+};
+
+export default defineLogicFunction({
+ universalIdentifier: 'e56d363b-0bdc-4d8a-a393-6f0d1c75bdcf',
+ name: 'create-new-post-card',
+ timeoutSeconds: 2,
+ handler,
+ httpRouteTriggerSettings: {
+ path: '/post-card/create',
+ httpMethod: 'POST',
+ isAuthRequired: true,
+ },
+ /*databaseEventTriggerSettings: {
+ eventName: 'people.created',
+ },*/
+ /*cronTriggerSettings: {
+ pattern: '0 0 1 1 *',
+ },*/
+});
+```
+
+Types de déclencheurs disponibles :
+* **httpRoute** : Expose votre fonction sur un chemin et une méthode HTTP **sous l'endpoint `/s/`** :
+> p. ex. `path: '/post-card/create'` est appelable à `https://your-twenty-server.com/s/post-card/create`
+
+<Note>
+Pour appeler une fonction logique déclenchée par une route depuis un composant frontal (sans interface), consultez [Appeler une fonction logique](/l/fr/developers/extend/apps/layout/front-components#calling-a-logic-function).
+</Note>
+* **cron** : Exécute votre fonction selon une planification à l’aide d’une expression CRON.
+* **databaseEvent**: S'exécute lors des événements du cycle de vie des objets de l'espace de travail. Lorsque l'opération de l'événement est `updated`, des champs spécifiques à surveiller peuvent être spécifiés dans le tableau `updatedFields`. S'il est laissé indéfini ou vide, toute mise à jour déclenchera la fonction.
+> p. ex. `person.updated`, `*.created`, `company.*`
+
+<Note>
+Vous pouvez également exécuter manuellement une fonction à l'aide de la CLI :
+
+```bash filename="Terminal"
+yarn twenty dev:function:exec -n create-new-post-card -p '{"key": "value"}'
+```
+
+```bash filename="Terminal"
+yarn twenty dev:function:exec -u e56d363b-0bdc-4d8a-a393-6f0d1c75bdcf
+```
+
+Vous pouvez consulter les journaux avec :
+
+```bash filename="Terminal"
+yarn twenty dev:function:logs
+```
+</Note>
+
+#### Charge utile du déclencheur de route
+
+Lorsqu'un déclencheur de route invoque votre fonction logique, elle reçoit un objet `RoutePayload` qui suit le
+[format AWS HTTP API v2](https://docs.aws.amazon.com/apigateway/latest/developerguide/http-api-develop-integrations-lambda.html).
+Importez le type `RoutePayload` depuis `twenty-sdk/logic-function` :
+
+```ts
+import type { RoutePayload } from 'twenty-sdk/logic-function';
+
+const handler = async (event: RoutePayload) => {
+ const { headers, queryStringParameters, pathParameters, body } = event;
+ const { method, path } = event.requestContext.http;
+
+ return { message: 'Success' };
+};
+```
+
+Le type `RoutePayload` a la structure suivante :
+
+ | Nom de la propriété | Type | Description | Exemple |
+ | ---------------------------- | ------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------- |
+ | `headers` | `Record\<string, string \| undefined>` | En-têtes HTTP (uniquement ceux répertoriés dans `forwardedRequestHeaders`) | voir la section ci-dessous |
+ | `queryStringParameters` | `Record\<string, string \| undefined>` | Paramètres de la chaîne de requête (plusieurs valeurs séparées par des virgules) | `/users?ids=1&ids=2&ids=3&name=Alice` -> `{ ids: '1,2,3', name: 'Alice' }` |
+ | `pathParameters` | `Record\<string, string \| undefined>` | Paramètres de chemin extraits du modèle de route | `/users/:id`, `/users/123` -> `{ id: '123' }` |
+ | `body` | `object \| null` | Corps de la requête analysé (JSON) | `{ id: 1 }` -> `{ id: 1 }` |
+ | `rawBody` | `string \| undefined` | Corps de la requête UTF-8 d'origine, avant l'analyse JSON. Utile pour vérifier les signatures de webhook de type HMAC (par exemple `X-Hub-Signature-256` de GitHub, Stripe). `undefined` lorsque l'environnement d'exécution ne l'a pas conservé. | |
+ | `isBase64Encoded` | `boolean` | Indique si le corps est encodé en base64 | |
+ | `requestContext.http.method` | `string` | Méthode HTTP (GET, POST, PUT, PATCH, DELETE) | |
+ | `requestContext.http.path` | `string` | Chemin de la requête brut | |
+
+
+#### forwardedRequestHeaders
+
+Par défaut, les en-têtes HTTP des requêtes entrantes ne sont pas transmis à votre fonction logique pour des raisons de sécurité.
+Pour accéder à des en-têtes spécifiques, listez-les dans le tableau `forwardedRequestHeaders` :
+
+```ts
+export default defineLogicFunction({
+ universalIdentifier: 'e56d363b-0bdc-4d8a-a393-6f0d1c75bdcf',
+ name: 'webhook-handler',
+ handler,
+ httpRouteTriggerSettings: {
+ path: '/webhook',
+ httpMethod: 'POST',
+ isAuthRequired: false,
+ forwardedRequestHeaders: ['x-webhook-signature', 'content-type'],
+ },
+});
+```
+
+Dans votre gestionnaire, accédez aux en-têtes transférés comme ceci :
+
+```ts
+const handler = async (event: RoutePayload) => {
+ const signature = event.headers['x-webhook-signature'];
+ const contentType = event.headers['content-type'];
+
+ // Validate webhook signature...
+ return { received: true };
+};
+```
+
+<Note>
+Les noms d'en-têtes sont normalisés en minuscules. Accédez-y en utilisant des clés en minuscules (p. ex., `event.headers['content-type']`).
+</Note>
+
+#### Réponse HTTP personnalisée
+
+Par défaut, le retour d’une valeur simple depuis votre gestionnaire l’envoie en réponse `200` (JSON pour les objets, `text/plain` pour les chaînes). Pour contrôler le code d’état et les en-têtes de la réponse, retournez un objet `Response` depuis `twenty-sdk/logic-function` :
+
+```ts
+import { Response } from 'twenty-sdk/logic-function';
+
+const handler = async (event: RoutePayload) => {
+ return new Response('<h1>Hello</h1>', {
+ status: 201,
+ headers: { 'content-type': 'text/html' },
+ });
+};
+```
+
+Pour des raisons de sécurité, les en-têtes de réponse sont restreints à une liste d’autorisation. Tout en-tête qui ne figure pas dans la liste (par exemple `Set-Cookie`, les en-têtes CORS tels que `Access-Control-Allow-Origin`, ou les en-têtes personnalisés `X-*`) est silencieusement supprimé avant l’envoi de la réponse. Les en-têtes de réponse autorisés sont :
+
+* `content-type`
+* `content-language`
+* `content-disposition`
+* `cache-control`
+* `retry-after`
+
+<Note>
+Le code d’état doit être un code d’état HTTP valide (compris entre 100 et 599). Les noms des en-têtes de réponse sont comparés sans tenir compte de la casse.
+</Note>
+
+#### Charge utile du déclencheur d'événement de base de données
+
+Lorsqu’un déclencheur d’événement de base de données appelle votre fonction logique, celle-ci reçoit un `DatabaseEventPayload` par enregistrement modifié. La charge utile combine les métadonnées concernant l'espace de travail et l'objet source avec l'événement au niveau de l'enregistrement.
+
+```ts
+import type {
+ DatabaseEventPayload,
+ ObjectRecordCreateEvent,
+ ObjectRecordDestroyEvent,
+ ObjectRecordUpdateEvent,
+} from 'twenty-sdk/logic-function';
+
+type Person = {
+ id: string;
+ emails?: { primaryEmail?: string };
+};
+```
+
+La charge utile inclut :
+
+| Propriété | Description |
+| ------------------------------------------------ | --------------------------------------------------------------------------------------------------------------- |
+| `name` | Nom de l’événement, comme `person.updated`. |
+| `workspaceId` | Espace de travail où l’événement s’est produit. |
+| `objectMetadata` | Métadonnées pour l’objet qui a été modifié. |
+| `recordId` | ID de l’enregistrement modifié. |
+| `userId`, `userWorkspaceId`, `workspaceMemberId` | Champs de l’acteur lorsque l’événement a été provoqué par un utilisateur de l’espace de travail. |
+| `properties` | Données d’enregistrement pour l’événement, avec `before`, `after`, `diff` et `updatedFields` selon l’opération. |
+
+| Événement | Données d’enregistrement |
+| ------------------ | -------------------------------------------------------------------------------------------------------------- |
+| `person.created` | `event.properties.after` |
+| `person.updated` | `event.properties.before`, `event.properties.after`, `event.properties.diff`, `event.properties.updatedFields` |
+| `person.destroyed` | `event.properties.before` |
+
+Pour les suppressions logiques (soft deletes), `.deleted` suit la structure de type mise à jour, car le champ `deletedAt` de l’enregistrement change.
+Pour les suppressions permanentes, utilisez `.destroyed`.
+
+<Note>
+`databaseEventTriggerSettings.updatedFields` filtre les événements de mise à jour qui déclenchent la fonction.
+`event.properties.updatedFields` indique quels champs ont réellement changé pour l’événement actuel.
+</Note>
+
+Exemple d’événement de création :
+
+```ts
+type PersonCreatedEvent = DatabaseEventPayload<
+ ObjectRecordCreateEvent<Person>
+>;
+
+const handler = async (event: PersonCreatedEvent) => {
+ const person = event.properties.after;
+
+ return {
+ personId: event.recordId,
+ email: person.emails?.primaryEmail,
+ };
+};
+```
+
+Exemple d’événement de mise à jour :
+
+```ts
+type PersonUpdatedEvent = DatabaseEventPayload<
+ ObjectRecordUpdateEvent<Person>
+>;
+
+const handler = async (event: PersonUpdatedEvent) => {
+ const { before, after, diff, updatedFields } = event.properties;
+
+ return {
+ personId: event.recordId,
+ updatedFields,
+ previousEmail: before.emails?.primaryEmail,
+ currentEmail: after.emails?.primaryEmail,
+ emailDiff: diff.emails,
+ };
+};
+```
+
+Déclencher uniquement lors des mises à jour de l’adresse e-mail :
+
+```ts
+export default defineLogicFunction({
+ ...,
+ databaseEventTriggerSettings: {
+ eventName: 'person.updated',
+ updatedFields: ['emails'],
+ },
+});
+```
+
+Exemple d’événement de destruction :
+
+```ts
+type PersonDestroyedEvent = DatabaseEventPayload<
+ ObjectRecordDestroyEvent<Person>
+>;
+
+const handler = async (event: PersonDestroyedEvent) => {
+ const personBeforeDestroy = event.properties.before;
+
+ return {
+ personId: event.recordId,
+ email: personBeforeDestroy.emails?.primaryEmail,
+ };
+};
+```
+
+#### Exposer une fonction en tant qu'outil d'IA ou en tant qu'action de workflow
+
+Les fonctions logiques peuvent être exposées sur deux surfaces, chacune avec son propre déclencheur :
+
+* **`toolTriggerSettings`** — rend la fonction découvrable par les fonctionnalités d'IA de Twenty (chat, MCP, appel de fonctions). Utilise le schéma JSON standard, le format que les LLM comprennent nativement.
+* **`workflowActionTriggerSettings`** — fait apparaître la fonction comme une étape dans le concepteur visuel de workflows. Utilise le `InputSchema` riche de Twenty afin que le concepteur puisse afficher des éditeurs de champs appropriés, des sélecteurs de variables et des libellés.
+
+Une fonction peut opter pour l'un, l'autre ou les deux. Elles côtoient `cronTriggerSettings`, `databaseEventTriggerSettings` et `httpRouteTriggerSettings` — même modèle, même structure.
+
+```ts src/logic-functions/enrich-company.logic-function.ts
+import { defineLogicFunction } from 'twenty-sdk/define';
+import { CoreApiClient } from 'twenty-client-sdk/core';
+
+const handler = async (params: { companyName: string; domain?: string }) => {
+ const client = new CoreApiClient();
+
+ const result = await client.mutation({
+ createTask: {
+ __args: {
+ data: {
+ title: `Enrich data for ${params.companyName}`,
+ body: `Domain: ${params.domain ?? 'unknown'}`,
+ },
+ },
+ id: true,
+ },
+ });
+
+ return { taskId: result.createTask.id };
+};
+
+export default defineLogicFunction({
+ universalIdentifier: 'f47ac10b-58cc-4372-a567-0e02b2c3d479',
+ name: 'enrich-company',
+ description: 'Enrich a company record with external data',
+ timeoutSeconds: 10,
+ handler,
+ toolTriggerSettings: {},
+});
+```
+
+Points clés :
+
+* Une fonction peut mélanger les surfaces — déclarez à la fois `toolTriggerSettings` et `workflowActionTriggerSettings` pour l'exposer à la fois dans le chat ET dans le concepteur de workflows.
+* `toolTriggerSettings.inputSchema` et `workflowActionTriggerSettings.inputSchema` sont tous deux facultatifs. Lorsqu'ils sont omis, le générateur de manifeste les déduit à partir du code source du gestionnaire (schéma JSON pour l'outil d'IA, `InputSchema` de Twenty pour l'action de workflow). Fournissez-en un explicitement lorsque vous souhaitez un typage plus riche — par exemple, avec des champs compatibles avec `FieldMetadataType` comme `CURRENCY` ou `RELATION` pour le concepteur de workflows, ou avec des champs `description` que l'agent d'IA peut lire :
+
+```ts
+export default defineLogicFunction({
+ ...,
+ toolTriggerSettings: {
+ inputSchema: {
+ type: 'object',
+ properties: {
+ companyName: {
+ type: 'string',
+ description: 'The name of the company to enrich',
+ },
+ domain: {
+ type: 'string',
+ description: 'The company website domain (optional)',
+ },
+ },
+ required: ['companyName'],
+ },
+ },
+});
+```
+
+<Note>
+**Rédigez une bonne `description`.** Les agents IA s'appuient sur le champ `description` de la fonction pour décider quand utiliser l'outil. Soyez précis sur ce que fait l'outil et quand il doit être appelé.
+</Note>
+
+</Accordion>
+</AccordionGroup>
+
+<Note>
+**Hooks d'installation** — les gestionnaires de pré-installation et de post-installation — partagent ce runtime mais sont déclarés avec leurs propres fonctions define et ne prennent pas de paramètres de déclenchement. Voir [hooks d'installation](/l/fr/developers/extend/apps/config/install-hooks) pour `definePreInstallLogicFunction` et `definePostInstallLogicFunction`.
+</Note>
+
+## Clients d'API typés (twenty-client-sdk)
+
+Le package `twenty-client-sdk` fournit deux clients GraphQL typés pour interagir avec l'API Twenty depuis vos fonctions logiques et vos composants frontaux.
+
+| Client | Importer | Point de terminaison | Généré ? |
+| ------------------- | ---------------------------- | ------------------------------------------------------------------------------ | --------------------------- |
+| `CoreApiClient` | `twenty-client-sdk/core` | `/graphql` — données de l'espace de travail (enregistrements, objets) | Oui, au moment du dev/build |
+| `MetadataApiClient` | `twenty-client-sdk/metadata` | `/metadata` — configuration de l'espace de travail, téléversements de fichiers | Non, livré prêt à l'emploi |
+
+<AccordionGroup>
+<Accordion title="CoreApiClient" description="Interroger et modifier les données de l'espace de travail (enregistrements, objets)">
+
+`CoreApiClient` est le client principal pour interroger et modifier les données de l'espace de travail. Il est **généré à partir du schéma de votre espace de travail** lors de l'exécution de `yarn twenty dev` ou `yarn twenty dev:build`, il est donc entièrement typé pour correspondre à vos objets et champs.
+
+```ts
+import { CoreApiClient } from 'twenty-client-sdk/core';
+
+const client = new CoreApiClient();
+
+// Query records
+const { companies } = await client.query({
+ companies: {
+ edges: {
+ node: {
+ id: true,
+ name: true,
+ domainName: {
+ primaryLinkLabel: true,
+ primaryLinkUrl: true,
+ },
+ },
+ },
+ },
+});
+
+// Create a record
+const { createCompany } = await client.mutation({
+ createCompany: {
+ __args: {
+ data: {
+ name: 'Acme Corp',
+ },
+ },
+ id: true,
+ name: true,
+ },
+});
+```
+
+Le client utilise une syntaxe d'ensemble de sélection : passez `true` pour inclure un champ, utilisez `__args` pour les arguments et imbriquez des objets pour les relations. Vous bénéficiez d'une autocomplétion complète et d'une vérification de types basée sur le schéma de votre espace de travail.
+
+<Note>
+**CoreApiClient est généré au moment du dev/build.** Si vous l'utilisez sans exécuter d'abord `yarn twenty dev` ou `yarn twenty dev:build`, une erreur est levée. La génération se fait automatiquement — la CLI inspecte le schéma GraphQL de votre espace de travail et génère un client typé à l'aide de `@genql/cli`.
+</Note>
+
+#### Utiliser CoreSchema pour les annotations de type
+
+`CoreSchema` fournit des types TypeScript correspondant à vos objets d'espace de travail — utile pour typer l'état des composants ou les paramètres de fonction :
+
+```ts
+import { CoreApiClient, CoreSchema } from 'twenty-client-sdk/core';
+import { useState } from 'react';
+
+const [company, setCompany] = useState<
+ Pick<CoreSchema.Company, 'id' | 'name'> | undefined
+>(undefined);
+
+const client = new CoreApiClient();
+const result = await client.query({
+ company: {
+ __args: { filter: { position: { eq: 1 } } },
+ id: true,
+ name: true,
+ },
+});
+setCompany(result.company);
+```
+
+</Accordion>
+<Accordion title="MetadataApiClient" description="Configuration de l'espace de travail, applications et téléversements de fichiers">
+
+`MetadataApiClient` est livré prêt à l'emploi avec le SDK (aucune génération requise). Il interroge le point de terminaison `/metadata` pour la configuration de l'espace de travail, les applications et les téléversements de fichiers.
+
+```ts
+import { MetadataApiClient } from 'twenty-client-sdk/metadata';
+
+const metadataClient = new MetadataApiClient();
+
+// List first 10 objects in the workspace
+const { objects } = await metadataClient.query({
+ objects: {
+ edges: {
+ node: {
+ id: true,
+ nameSingular: true,
+ namePlural: true,
+ labelSingular: true,
+ isCustom: true,
+ },
+ },
+ __args: {
+ filter: {},
+ paging: { first: 10 },
+ },
+ },
+});
+```
+
+#### Téléverser des fichiers
+
+Le `MetadataApiClient` inclut une méthode `uploadFile` pour joindre des fichiers aux champs de type fichier :
+
+```ts
+import { MetadataApiClient } from 'twenty-client-sdk/metadata';
+import * as fs from 'fs';
+
+const metadataClient = new MetadataApiClient();
+
+const fileBuffer = fs.readFileSync('./invoice.pdf');
+
+const uploadedFile = await metadataClient.uploadFile(
+ fileBuffer, // file contents as a Buffer
+ 'invoice.pdf', // filename
+ 'application/pdf', // MIME type
+ '58a0a314-d7ea-4865-9850-7fb84e72f30b', // field universalIdentifier
+);
+
+console.log(uploadedFile);
+// { id: '...', path: '...', size: 12345, createdAt: '...', url: 'https://...' }
+```
+
+| Paramètre | Type | Description |
+| ---------------------------------- | -------- | ---------------------------------------------------------------- |
+| `fileBuffer` | `Buffer` | Le contenu brut du fichier |
+| `filename` | `string` | Le nom du fichier (utilisé pour le stockage et l'affichage) |
+| `contentType` | `string` | Type MIME (par défaut `application/octet-stream` s'il est omis) |
+| `fieldMetadataUniversalIdentifier` | `string` | Le `universalIdentifier` du champ de type fichier de votre objet |
+
+Points clés :
+* Utilise le `universalIdentifier` du champ (et non son ID propre à l'espace de travail), de sorte que votre code de téléversement fonctionne dans tout espace de travail où votre application est installée.
+* L'`url` renvoyée est une URL signée que vous pouvez utiliser pour accéder au fichier téléversé.
+
+</Accordion>
+</AccordionGroup>
+
+<Note>
+ Lorsque votre code s'exécute sur Twenty (fonctions logiques ou composants frontaux), la plateforme injecte des identifiants sous forme de variables d'environnement :
+
+ * `TWENTY_API_URL` — URL de base de l'API Twenty
+ * `TWENTY_APP_ACCESS_TOKEN` — Clé de courte durée limitée au rôle de fonction par défaut de votre application
+
+ Vous n'avez **pas** besoin de les transmettre aux clients — ils lisent automatiquement depuis `process.env`. Les autorisations de la clé API sont déterminées par le rôle déclaré avec `defineApplicationRole()` (ou référencé via `defaultRoleUniversalIdentifier` dans `application-config.ts`).
+</Note>
diff --git a/packages/twenty-docs/l/fr/developers/extend/apps/logic/overview.mdx b/packages/twenty-docs/l/fr/developers/extend/apps/logic/overview.mdx
new file mode 100644
index 00000000000..04b10d6f937
--- /dev/null
+++ b/packages/twenty-docs/l/fr/developers/extend/apps/logic/overview.mdx
@@ -0,0 +1,55 @@
+---
+title: Vue d'ensemble
+description: TypeScript côté serveur qui s’exécute dans Twenty — déclenché par des routes HTTP, des planifications CRON, des événements de base de données, des outils d’IA ou des actions de flux de travail.
+icon: bolt
+---
+
+La **couche logique** d’une application Twenty est le code qui *s’exécute* — des gestionnaires TypeScript côté serveur qui réagissent aux requêtes HTTP, aux planifications CRON et aux modifications d’enregistrements ; des compétences et des agents d’IA qui résident dans l’espace de travail ; et des connexions OAuth qui permettent à vos fonctions d’agir au nom d’un utilisateur dans des services tiers.
+
+```text
+ ┌─ HTTP route ──┐
+ │ Cron schedule │
+ │ Database event │ ┌────────────────────┐
+ triggers ─┤ AI tool call ├─────▶│ Logic function │
+ │ Workflow action │ │ (your handler) │
+ │ Manual exec │ └────────────────────┘
+ └────────────────────┘ │
+ ▼
+ ┌────────────────────────────┐
+ │ Twenty API (records) │
+ │ Third-party API │
+ │ (via Connection token) │
+ └────────────────────────────┘
+```
+
+## Dans cette section
+
+<CardGroup cols={2}>
+ <Card title="Fonctions logiques" icon="bolt" href="/l/fr/developers/extend/apps/logic/logic-functions">
+ Le bloc de construction principal — types de déclencheurs, charges utiles et client API typé.
+ </Card>
+ <Card title="Compétences et agents" icon="robot" href="/l/fr/developers/extend/apps/logic/skills-and-agents">
+ Instructions d’agent IA réutilisables et assistants avec invites système personnalisées.
+ </Card>
+ <Card title="Connexions" icon="plug" href="/l/fr/developers/extend/apps/logic/connections">
+ Identifiants OAuth détenus par votre application pour des services tiers — Linear, GitHub, Slack, et plus encore.
+ </Card>
+</CardGroup>
+
+## Aperçu des types de déclencheurs
+
+Une fonction logique choisit un ou plusieurs déclencheurs — chaque entrée ci-dessous est un champ distinct sur `defineLogicFunction()`:
+
+| Déclencheur | Moment d’exécution | Paramètre |
+| -------------------------------- | ---------------------------------------------------------------------------- | ------------------------------- |
+| **Route HTTP** | Une requête atteint votre point de terminaison `/s/\<path>` | `httpRouteTriggerSettings` |
+| **Cron** | Une expression CRON correspond | `cronTriggerSettings` |
+| **Événement de base de données** | Un enregistrement de l’espace de travail est créé, mis à jour ou supprimé | `databaseEventTriggerSettings` |
+| **Outil IA** | Une fonctionnalité IA de Twenty décide d’appeler votre fonction | `toolTriggerSettings` |
+| **Action de flux de travail** | Une étape de flux de travail invoque votre fonction | `workflowActionTriggerSettings` |
+
+Les fonctions s’exécutent dans un environnement isolé dans des processus Node.js sandboxés et accèdent à l’espace de travail via un client API typé, limité au rôle déclaré sur [`defineApplication()`](/l/fr/developers/extend/apps/config/application).
+
+<Note>
+Les **hooks au moment de l’installation** — du code qui s’exécute avant ou après l’installation — partagent ce runtime mais utilisent leurs propres fonctions define et se trouvent sous [Config → Install Hooks](/l/fr/developers/extend/apps/config/install-hooks).
+</Note>
diff --git a/packages/twenty-docs/l/fr/developers/extend/apps/logic/skills-and-agents.mdx b/packages/twenty-docs/l/fr/developers/extend/apps/logic/skills-and-agents.mdx
new file mode 100644
index 00000000000..1f0463833ba
--- /dev/null
+++ b/packages/twenty-docs/l/fr/developers/extend/apps/logic/skills-and-agents.mdx
@@ -0,0 +1,138 @@
+---
+title: Compétences et agents
+description: Définir les compétences et les agents d'IA pour votre application.
+icon: robot
+---
+
+<Warning>
+ Les compétences et les agents sont actuellement en phase alpha. Cette fonctionnalité fonctionne mais est encore en évolution.
+</Warning>
+
+Les applications peuvent définir des fonctionnalités d'IA au sein de l'espace de travail — des instructions de compétences réutilisables et des agents avec des invites système personnalisées.
+
+<AccordionGroup>
+<Accordion title="defineSkill" description="Définir des compétences pour les agents IA">
+
+Les compétences définissent des instructions et des capacités réutilisables que les agents IA peuvent utiliser dans votre espace de travail. Utilisez `defineSkill()` pour définir des compétences avec validation intégrée :
+
+```ts src/skills/example-skill.ts
+import { defineSkill } from 'twenty-sdk/define';
+
+export default defineSkill({
+ universalIdentifier: 'a1b2c3d4-e5f6-7890-abcd-ef1234567890',
+ name: 'sales-outreach',
+ label: 'Sales Outreach',
+ description: 'Guides the AI agent through a structured sales outreach process',
+ icon: 'IconBrain',
+ content: `You are a sales outreach assistant. When reaching out to a prospect:
+1. Research the company and recent news
+2. Identify the prospect's role and likely pain points
+3. Draft a personalized message referencing specific details
+4. Keep the tone professional but conversational`,
+});
+```
+
+Points clés :
+* `name` est une chaîne d'identification unique pour la compétence (kebab-case recommandé).
+* `label` est le nom d'affichage lisible par l'utilisateur dans l'UI.
+* `content` contient les instructions de la compétence — c'est le texte que l'agent IA utilise.
+* `icon` (optionnel) définit l'icône affichée dans l'UI.
+* `description` (optionnel) fournit un contexte supplémentaire sur l'objectif de la compétence.
+
+</Accordion>
+<Accordion title="defineAgent" description="Définir des agents d'IA avec des prompts personnalisés">
+
+Les agents sont des assistants IA qui vivent dans votre espace de travail. Utilisez `defineAgent()` pour créer des agents avec un prompt système personnalisé :
+
+```ts src/agents/example-agent.ts
+import { defineAgent } from 'twenty-sdk/define';
+
+export default defineAgent({
+ universalIdentifier: 'b3c4d5e6-f7a8-9012-bcde-f34567890123',
+ name: 'sales-assistant',
+ label: 'Sales Assistant',
+ description: 'Helps the sales team draft outreach emails and research prospects',
+ icon: 'IconRobot',
+ prompt: 'You are a helpful sales assistant. Help users with their questions and tasks.',
+});
+```
+
+Points clés :
+* `name` est un identifiant unique pour l'agent (kebab-case recommandé).
+* `label` est le nom d'affichage montré dans l'UI.
+* `prompt` est le prompt système qui définit le comportement de l'agent.
+* `description` (optionnel) fournit un contexte sur ce que fait l'agent.
+* `icon` (optionnel) définit l'icône affichée dans l'UI.
+* `modelId` (optionnel) remplace le modèle d'IA par défaut utilisé par l'agent.
+* `responseFormat` (facultatif) contrôle la forme de la sortie de l'agent. Par défaut, la valeur est `{ type: 'text' }` pour le texte libre. Utilisez `{ type: 'json', schema }` pour forcer une sortie JSON structurée.
+
+Par défaut, un agent renvoie du texte libre. Pour obtenir une sortie structurée, définissez `responseFormat` sur `{ type: 'json' }` et fournissez un `schema` :
+
+```ts src/agents/structured-agent.ts
+import { defineAgent } from 'twenty-sdk/define';
+
+export default defineAgent({
+ universalIdentifier: 'c4d5e6f7-a8b9-0123-cdef-456789012345',
+ name: 'lead-scorer',
+ label: 'Lead Scorer',
+ prompt: 'Score the lead and explain your reasoning.',
+ responseFormat: {
+ type: 'json',
+ schema: {
+ type: 'object',
+ properties: {
+ score: { type: 'number', description: 'Lead score from 0 to 100' },
+ summary: { type: 'string', description: 'Short reasoning for the score' },
+ },
+ required: ['score', 'summary'],
+ additionalProperties: false,
+ },
+ },
+});
+```
+
+Remarques sur le schéma :
+* Le schéma est un objet plat : le `type` de chaque propriété doit être un type primitif (`string`, `number` ou `boolean`). Les objets imbriqués et les tableaux ne sont pas pris en charge.
+* `description` (facultatif) sur chaque propriété guide le modèle sur ce qu'il doit y mettre.
+* `required` (facultatif) répertorie les propriétés que le modèle doit toujours renvoyer.
+* `additionalProperties: false` (facultatif) interdit toute propriété non déclarée dans `properties`.
+
+</Accordion>
+<Accordion title="runAgent" description="Exécuter un agent depuis une fonction logique">
+
+`runAgent()` permet à une fonction logique d'exécuter l'un des agents de votre application (avec ses compétences et ses outils). Identifiez l'agent par le `universalIdentifier` que vous avez passé à `defineAgent()` :
+
+```ts src/logic-functions/run-enricher.ts
+import { runAgent } from 'twenty-sdk/logic-function';
+
+const { result, error, success } = await runAgent({
+ agentUniversalIdentifier: 'b3c4d5e6-f7a8-9012-bcde-f34567890123',
+ prompt: 'Enrich House Ad <recordId>: fill empty fields from its listing URL.',
+});
+```
+
+Points clés :
+* L'agent s'exécute **de manière synchrone** et peut lire/mettre à jour lui-même des enregistrements via ses propres outils — `runAgent()` se résout une fois l'exécution terminée.
+* Une application ne peut exécuter que ses propres agents.
+* Le [rôle par défaut](/l/fr/developers/extend/apps/config/roles) de l'application doit accorder l'indicateur d'autorisation `AI` — ajoutez `SystemPermissionFlag.AI` à ses `permissionFlagUniversalIdentifiers` (ou définissez `canAccessAllTools: true`).
+ Sans cela, `runAgent()` échoue avec une erreur d'autorisation.
+* Définissez une valeur généreuse pour `timeoutSeconds` sur la fonction logique — les exécutions d'agent peuvent prendre plusieurs secondes.
+* `success` est `true` et `result` est non nul lorsque l'exécution se termine ; en cas d'échec, `success` est `false`, `result` est `null`, et `error` contient la raison (par exemple, lorsque l'espace de travail épuise ses crédits AI en cours d'exécution).
+
+```ts src/roles/default-role.ts
+import { defineApplicationRole, SystemPermissionFlag } from 'twenty-sdk/define';
+
+export default defineApplicationRole({
+ universalIdentifier: 'b648f87b-1d26-4961-b974-0908fd991061',
+ label: 'Default function role',
+ // runAgent() requires the AI permission flag on the app's default role.
+ permissionFlagUniversalIdentifiers: [SystemPermissionFlag.AI],
+});
+```
+
+<Warning>
+ **Évitez les boucles :** si vous appelez `runAgent()` à partir d'un déclencheur d'événement de base de données `*.updated` et que l'agent met à jour le même enregistrement, limitez le déclencheur avec `updatedFields` à un champ que l'agent n'écrit jamais (par exemple l'URL source), ou vérifiez si un champ cible est encore vide avant d'appeler `runAgent()`.
+</Warning>
+
+</Accordion>
+</AccordionGroup>
diff --git a/packages/twenty-docs/l/fr/developers/extend/apps/operations/cli.mdx b/packages/twenty-docs/l/fr/developers/extend/apps/operations/cli.mdx
new file mode 100644
index 00000000000..f2ec5eca191
--- /dev/null
+++ b/packages/twenty-docs/l/fr/developers/extend/apps/operations/cli.mdx
@@ -0,0 +1,105 @@
+---
+title: CLI
+description: Les commandes `yarn twenty` pour exécuter des fonctions, diffuser en continu les journaux, gérer les installations d'applications et basculer entre des remotes.
+icon: terminal
+---
+
+Au-delà de `dev`, `dev:build`, `dev:add` et `dev:typecheck`, la CLI `yarn twenty` fournit des commandes pour exécuter des fonctions, consulter les journaux et gérer les installations d'applications.
+
+## Exécuter des fonctions (`yarn twenty dev:function:exec`)
+
+Exécutez une fonction logique manuellement sans la déclencher via HTTP, cron ou un événement de base de données :
+
+```bash filename="Terminal"
+# Execute by function name
+yarn twenty dev:function:exec -n create-new-post-card
+
+# Execute by universalIdentifier
+yarn twenty dev:function:exec -u e56d363b-0bdc-4d8a-a393-6f0d1c75bdcf
+
+# Pass a JSON payload
+yarn twenty dev:function:exec -n create-new-post-card -p '{"name": "Hello"}'
+
+# Execute the post-install function
+yarn twenty dev:function:exec --postInstall
+```
+
+## Afficher les journaux des fonctions (`yarn twenty dev:function:logs`)
+
+Diffuser en continu les journaux d'exécution des fonctions logiques de votre application :
+
+```bash filename="Terminal"
+# Stream all function logs
+yarn twenty dev:function:logs
+
+# Filter by function name
+yarn twenty dev:function:logs -n create-new-post-card
+
+# Filter by universalIdentifier
+yarn twenty dev:function:logs -u e56d363b-0bdc-4d8a-a393-6f0d1c75bdcf
+```
+
+<Note>
+Ceci est différent de `yarn twenty docker:logs`, qui affiche les journaux du conteneur Docker. `yarn twenty dev:function:logs` affiche les journaux d'exécution des fonctions de votre application depuis le serveur Twenty.
+</Note>
+
+## Génération du client typé (`yarn twenty dev:generate-client`)
+
+Régénérez le client API typé (`twenty-client-sdk`) à partir du schéma du remote actif, sans compiler ni synchroniser une application. Utilisez-le pour obtenir un client typé dans n’importe quel projet — comme un service back-end hébergé dans un dépôt distinct — qui communique avec votre instance Twenty :
+
+```bash filename="Terminal"
+# In your project (no Twenty app definition required)
+yarn add twenty-sdk twenty-client-sdk
+
+# Connect to the Twenty instance to generate the client from
+yarn twenty remote:add
+
+# Generate the typed client into node_modules/twenty-client-sdk
+yarn twenty dev:generate-client
+```
+
+Puis importez le client dans votre code :
+
+```typescript
+import { CoreApiClient } from 'twenty-client-sdk/core';
+```
+
+Relancez la commande chaque fois que votre modèle de données change afin d’actualiser les types générés.
+
+<Note>
+Le client est généré dans `node_modules`, il n’est donc pas versionné avec votre code. Exécutez `yarn twenty dev:generate-client` après chaque installation (par exemple dans un script `postinstall` ou dans un pipeline CI).
+</Note>
+
+## Désinstaller une application (`yarn twenty app:uninstall`)
+
+Supprimez votre application de l'espace de travail actif :
+
+```bash filename="Terminal"
+yarn twenty app:uninstall
+
+# Skip the confirmation prompt
+yarn twenty app:uninstall --yes
+```
+
+## Gestion des remotes
+
+Un remote est un serveur Twenty auquel votre application se connecte. Lors de la configuration, le générateur en crée un automatiquement pour vous. Vous pouvez ajouter d’autres remotes ou basculer entre eux à tout moment.
+
+```bash filename="Terminal"
+# Add a new remote (opens a browser for OAuth login)
+yarn twenty remote:add
+
+# Connect to a local Twenty server (auto-detects port 2020 or 3000)
+yarn twenty remote:add --local
+
+# Add a remote non-interactively (useful for CI)
+yarn twenty remote:add --url https://your-twenty-server.com --api-key $TWENTY_API_KEY --as my-remote
+
+# List all configured remotes
+yarn twenty remote:list
+
+# Set the active remote
+yarn twenty remote:use <name>
+```
+
+Vos identifiants sont stockés dans `~/.twenty/config.json`.
diff --git a/packages/twenty-docs/l/fr/developers/extend/apps/operations/overview.mdx b/packages/twenty-docs/l/fr/developers/extend/apps/operations/overview.mdx
new file mode 100644
index 00000000000..f60d2f69991
--- /dev/null
+++ b/packages/twenty-docs/l/fr/developers/extend/apps/operations/overview.mdx
@@ -0,0 +1,32 @@
+---
+title: Vue d'ensemble
+description: Créez, testez et livrez votre application — commandes CLI, tests d’intégration, CI et publication sur un serveur ou sur npm.
+icon: rocket
+---
+
+La **couche d’opérations** regroupe tout ce que vous faites *à* votre application plutôt qu’*avec* elle : lancer des commandes CLI, exécuter des tests d’intégration sur un véritable serveur Twenty, configurer la CI et livrer des versions — soit sous la forme d’une archive tar déployée sur un seul serveur, soit sous la forme d’un package npm répertorié sur la place de marché.
+
+```text
+ develop ─▶ test ─▶ build ─▶ deploy / publish
+ ─────── ──── ───── ─────────────────
+ yarn yarn yarn yarn twenty app:publish --private (tarball → one server)
+ twenty test twenty
+ dev dev:build yarn twenty app:publish (npm → marketplace)
+```
+
+## Dans cette section
+
+<CardGroup cols={2}>
+ <Card title="CLI" icon="terminal" href="/l/fr/developers/extend/apps/operations/cli">
+ Référence `yarn twenty` — exec, logs, uninstall, remotes.
+ </Card>
+ <Card title="Synchronisation et récupération" icon="boussole" href="/l/fr/developers/extend/apps/operations/sync-and-recovery">
+ Quelle commande utiliser et quand, comment lire le diff de synchronisation, et une procédure de récupération.
+ </Card>
+ <Card title="Tests" icon="flask" href="/l/fr/developers/extend/apps/operations/testing">
+ Configuration de Vitest, tests d’intégration, vérification des types, flux de travail CI.
+ </Card>
+ <Card title="Publication" icon="upload" href="/l/fr/developers/extend/apps/operations/publishing">
+ Générer, déployer une archive tar, publier sur npm, installer.
+ </Card>
+</CardGroup>
diff --git a/packages/twenty-docs/l/fr/developers/extend/apps/operations/publishing.mdx b/packages/twenty-docs/l/fr/developers/extend/apps/operations/publishing.mdx
new file mode 100644
index 00000000000..14a9902facc
--- /dev/null
+++ b/packages/twenty-docs/l/fr/developers/extend/apps/operations/publishing.mdx
@@ -0,0 +1,294 @@
+---
+title: Publication
+icon: téléverser
+description: Distribuez votre application Twenty sur la marketplace ou déployez-la en interne.
+---
+
+## Vue d'ensemble
+
+Une fois que votre application est [créée et testée en local](/l/fr/developers/extend/apps/getting-started/concepts), vous avez deux options pour sa distribution :
+
+* **Déployer une archive tar** — téléversez votre application directement sur un serveur Twenty spécifique pour un usage interne ou privé.
+* **Publier sur npm** — répertoriez votre application dans la marketplace Twenty pour que tout espace de travail puisse la découvrir et l'installer.
+
+Les deux parcours commencent à la même étape de **build**.
+
+## Compilation de votre application
+
+Exécutez la commande `build` pour compiler votre application et générer un `manifest.json` prêt pour la distribution :
+
+```bash filename="Terminal"
+yarn twenty dev:build
+```
+
+Cela compile les sources TypeScript, transpile les fonctions de logique et les composants front-end, et écrit le tout dans `.twenty/output/`. Ajoutez `--tarball` pour produire également un paquet `.tgz` pour la distribution manuelle ou la commande `publish`.
+
+## Déploiement sur un serveur (archive tar)
+
+Pour les applications que vous ne souhaitez pas rendre publiques — outils propriétaires, intégrations réservées aux entreprises ou versions expérimentales — vous pouvez déployer une archive tar directement sur un serveur Twenty.
+
+### Prérequis
+
+Avant le déploiement, vous avez besoin d'un remote configuré pointant vers le serveur cible. Les remotes stockent localement l'URL du serveur et les informations d'authentification dans `~/.twenty/config.json`.
+
+Ajouter un remote :
+
+```bash filename="Terminal"
+yarn twenty remote:add --url https://your-twenty-server.com --as production
+```
+
+### Déploiement
+
+Compilez et téléversez votre application sur le serveur en une seule étape :
+
+```bash filename="Terminal"
+yarn twenty app:publish --private
+# To deploy to a specific remote:
+# yarn twenty app:publish --private --remote production
+```
+
+### Partage d'une application déployée
+
+<Warning>
+Le partage d'applications privées (tarball) entre espaces de travail est une fonctionnalité **Enterprise**. L'onglet **Distribution** affichera une invite de mise à niveau au lieu des contrôles de partage jusqu'à ce que votre espace de travail dispose d'une clé Enterprise valide. Accédez à [Paramètres > Panneau d'administration > Enterprise](/settings/admin-panel#enterprise) pour l'activer.
+</Warning>
+
+Les applications au format tarball ne sont pas répertoriées dans la place de marché publique, donc les autres espaces de travail sur le même serveur ne les découvriront pas en parcourant. Une fois que votre espace de travail est abonné à l'offre Enterprise, vous pouvez partager une application déployée comme suit :
+
+1. Allez dans **Paramètres > Applications > Inscriptions** et ouvrez votre application
+2. Dans l'onglet **Distribution**, cliquez sur **Copier le lien de partage**
+3. Partagez ce lien avec des utilisateurs sur d'autres espaces de travail — il les amène directement à la page d'installation de l'application
+
+Le lien de partage utilise l'URL de base du serveur (sans sous-domaine d'espace de travail) afin qu'il fonctionne pour tout espace de travail sur le serveur.
+
+### Gestion des versions
+
+Lors de la mise à jour d'une application au format tarball déjà déployée, le serveur exige que la `version` dans `package.json` soit **strictement supérieure** (selon l'ordre [SemVer](https://semver.org)) à la version actuellement déployée. Le redéploiement de la même version, ou la tentative d’en pousser une inférieure, est refusé avant que l’archive tar ne soit stockée — vous verrez une erreur `VERSION_ALREADY_EXISTS` émise par la CLI.
+
+Pour publier une mise à jour :
+
+1. Incrémentez le champ `version` dans votre `package.json` (par ex. `1.2.3` → `1.2.4`, `1.3.0` ou `2.0.0`)
+2. Exécutez `yarn twenty app:publish --private` (ou `yarn twenty app:publish --private --remote production`)
+3. Les espaces de travail qui ont l'application installée verront la mise à niveau disponible dans leurs paramètres
+
+<Note>
+Les tags de préversion fonctionnent comme prévu : incrémenter `1.0.0-rc.1` → `1.0.0-rc.2` est autorisé, et une version finale telle que `1.0.0` est correctement reconnue comme supérieure à `1.0.0-rc.5`. La version dans `package.json` doit elle-même être une chaîne SemVer valide.
+</Note>
+
+{/* TODO: add screenshot of the Upgrade button */}
+
+### Compatibilité des versions du serveur
+
+Si votre application utilise une fonctionnalité introduite dans une version spécifique du serveur Twenty (par exemple, des fournisseurs OAuth ajoutés en v2.3.0), vous devez déclarer la version minimale du serveur requise par votre application en utilisant le champ `engines.twenty` dans `package.json`:
+
+```json filename="package.json"
+{
+ "name": "twenty-my-app",
+ "version": "1.0.0",
+ "engines": {
+ "node": "^24.5.0",
+ "twenty": ">=2.3.0"
+ }
+}
+```
+
+La valeur est une [plage semver](https://github.com/npm/node-semver#ranges) standard. Modèles courants:
+
+| Plage | Signification |
+| ---------------------------------- | ------------------------------------------------------------------- |
+| `>=2.3.0` | Tout serveur à partir de 2.3.0 |
+| `>=2.3.0 \<3.0.0` | 2.3.0 ou ultérieure, mais inférieure à la prochaine version majeure |
+| `^2.3.0` | Identique à `>=2.3.0 \<3.0.0` |
+
+**Ce qui se passe lors du déploiement et de l'installation:**
+
+* Si `engines.twenty` est défini et que la version du serveur cible ne satisfait pas la plage, le déploiement (chargement du tarball) ou l'installation est refusé avec une erreur `SERVER_VERSION_INCOMPATIBLE` et un message indiquant à la fois la plage requise et la version réelle du serveur.
+* Si `engines.twenty` est **non défini**, l'application est acceptée sur n'importe quelle version du serveur (rétrocompatible avec les applications existantes).
+* Si le serveur n'a pas de `APP_VERSION` configuré, la vérification est ignorée.
+
+<Note>
+Le serveur est l'autorité de référence pour la vérification — il valide `engines.twenty` tant lors du chargement du tarball que lors de l'installation dans l'espace de travail. Si vous déployez un tarball hors bande ou installez depuis la place de marché, le serveur applique toujours la compatibilité.
+</Note>
+
+## CI/CD automatisés (workflows préconfigurés)
+
+Les applications générées avec `create-twenty-app` sont livrées avec deux workflows GitHub Actions prêts à l’emploi, sous `.github/workflows/`. Ils sont prêts à s’exécuter dès que vous poussez le dépôt sur GitHub — aucune configuration supplémentaire n’est nécessaire pour la CI, et le CD ne nécessite qu’un seul secret.
+
+### CI — `ci.yml`
+
+Il exécute automatiquement vos tests d’intégration à chaque push sur `main` et sur les pull requests.
+
+**Ce que cela fait:**
+
+1. Récupère le code source de votre application.
+2. Lance une instance de test Twenty isolée à l’aide de l’action composite `twentyhq/twenty/.github/actions/spawn-twenty-app-dev-test@main` (l’équivalent CI de `yarn twenty docker:start --test`).
+3. Active Corepack, configure Node.js à partir de votre `.nvmrc` et installe les dépendances avec `yarn install --immutable`.
+4. Exécute `yarn test`, en passant `TWENTY_API_URL` et `TWENTY_API_KEY` depuis l’instance lancée pour que vos tests puissent communiquer avec un serveur réel.
+
+**Paramètres de configuration:**
+
+* `TWENTY_VERSION` (variable d’environnement, par défaut `latest`) — figez la version du serveur Twenty utilisée en CI en la modifiant dans `ci.yml`.
+* La concurrence est regroupée par `github.ref` et annule les exécutions en cours lors de nouveaux push.
+
+Aucun secret n’est requis — l’instance de test est éphémère et n’existe que pendant la durée du job.
+
+### CD — `cd.yml`
+
+Déploie votre application vers un serveur Twenty configuré à chaque push sur `main`, et éventuellement depuis une pull request lorsque le label `deploy` est appliqué.
+
+**Ce que cela fait:**
+
+1. Récupère la tête de la PR (pour les PR étiquetées) ou le commit poussé.
+2. Exécute `twentyhq/twenty/.github/actions/deploy-twenty-app@main` — l’équivalent CI de `yarn twenty app:publish --private`.
+3. Exécute `twentyhq/twenty/.github/actions/install-twenty-app@main` afin que la version nouvellement déployée soit installée dans l’espace de travail cible.
+
+**Configuration requise:**
+
+| Paramètre | Où | Objectif |
+| ----------------------- | ----------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
+| `TWENTY_DEPLOY_URL` | `env` dans `cd.yml` (par défaut `http://localhost:3000`) | Le serveur Twenty vers lequel déployer. Remplacez ceci par l’URL réelle de votre serveur avant la première utilisation. |
+| `TWENTY_DEPLOY_API_KEY` | Dépôt GitHub **Settings → Secrets and variables → Actions** | Clé API avec la permission de déployer sur le serveur cible. |
+
+<Note>
+La valeur par défaut de `TWENTY_DEPLOY_URL`, `http://localhost:3000`, est un espace réservé — elle n’atteindra rien depuis un runner hébergé par GitHub. Remplacez-la par l’URL publique de votre serveur (ou utilisez un runner auto-hébergé avec accès réseau) avant d’activer la CD.
+</Note>
+
+**Déclencher un déploiement de prévisualisation depuis une PR:**
+
+Ajoutez le label `deploy` à une pull request. La condition `if:` dans `cd.yml` exécutera le job pour cette PR en utilisant le commit de tête de la PR, vous permettant de valider une modification sur le serveur cible avant la fusion.
+
+### Épingler les actions réutilisables
+
+Les deux workflows référencent des actions réutilisables sur `@main`, de sorte que les mises à jour des actions dans le dépôt `twentyhq/twenty` sont récupérées automatiquement. Si vous souhaitez des builds déterministes, remplacez `@main` par un SHA de commit ou un tag de version sur chaque ligne `uses:`.
+
+## Publication sur npm
+
+Publier sur npm rend votre application découvrable dans la marketplace Twenty. N'importe quel espace de travail Twenty peut parcourir, installer et mettre à niveau des applications de la marketplace directement depuis l'interface utilisateur.
+
+### Prérequis
+
+* Un compte [npm](https://www.npmjs.com)
+* Le mot-clé `twenty-app` dans le tableau `keywords` de votre `package.json` (à ajouter manuellement — il n'est pas inclus par défaut dans le modèle `create-twenty-app`)
+
+```json filename="package.json"
+{
+ "name": "twenty-app-postcard-sender",
+ "version": "1.0.0",
+ "keywords": ["twenty-app"]
+}
+```
+
+### Métadonnées de la marketplace
+
+La configuration `defineApplication()` prend en charge des champs optionnels qui contrôlent la façon dont votre application apparaît sur la place de marché. Utilisez `logoUrl` et `screenshots` pour référencer des images depuis le dossier `public/` :
+
+```ts src/application-config.ts
+export default defineApplication({
+ universalIdentifier: '...',
+ displayName: 'My App',
+ description: 'A great app',
+ logoUrl: 'public/logo.png',
+ screenshots: [
+ 'public/screenshot-1.png',
+ 'public/screenshot-2.png',
+ ],
+});
+```
+
+Voir l'[accordéon defineApplication](/l/fr/developers/extend/apps/config/application#marketplace-metadata) dans la page Building Apps pour la liste complète des champs de la place de marché (`author`, `category`, `aboutDescription`, `websiteUrl`, `termsUrl`, etc.).
+
+#### Dimensions recommandées pour les captures d'écran
+
+La place de marché affiche `screenshots` dans un conteneur fixe `8:5` (par exemple, `1600×1000 px`).
+
+<Note>
+Les captures d'écran, quel que soit leur ratio d'aspect, sont affichées en entier et ne sont jamais recadrées, mais tout ce qui est nettement plus haut ou plus étroit que `8:5` affichera des bandes vides sur les côtés.
+</Note>
+
+### Publier
+
+```bash filename="Terminal"
+yarn twenty app:publish
+```
+
+Pour publier sous un dist-tag spécifique (par exemple, `beta` ou `next`) :
+
+```bash filename="Terminal"
+yarn twenty app:publish --tag beta
+```
+
+### Comment fonctionne la découverte de la place de marché
+
+Le serveur Twenty synchronise son catalogue de la place de marché à partir du registre npm **toutes les heures**.
+
+Vous pouvez déclencher la synchronisation immédiatement au lieu d'attendre :
+
+```bash filename="Terminal"
+yarn twenty dev:catalog-sync
+# To target a specific remote:
+# yarn twenty dev:catalog-sync --remote production
+```
+
+Les métadonnées affichées dans la place de marché proviennent de votre configuration `defineApplication()` — des champs comme `displayName`, `description`, `author`, `category`, `logoUrl`, `screenshots`, `aboutDescription`, `websiteUrl` et `termsUrl`.
+
+<Note>
+Si votre application ne définit pas de `aboutDescription` dans `defineApplication()`, la place de marché utilisera automatiquement le `README.md` de votre package depuis npm comme contenu de la page À propos. Cela signifie que vous pouvez maintenir un seul README à la fois pour npm et pour la place de marché Twenty. Si vous souhaitez une description différente dans la place de marché, définissez explicitement `aboutDescription`.
+</Note>
+
+### Publication via CI
+
+Utilisez ce workflow GitHub Actions pour publier automatiquement à chaque version (utilise [OIDC](https://docs.npmjs.com/trusted-publishers)) :
+
+```yaml filename=".github/workflows/publish.yml"
+name: Publish
+on:
+ release:
+ types: [published]
+
+permissions:
+ contents: read
+ id-token: write
+
+jobs:
+ publish:
+ runs-on: ubuntu-latest
+ steps:
+ - uses: actions/checkout@v4
+ - uses: actions/setup-node@v4
+ with:
+ node-version: "24"
+ registry-url: https://registry.npmjs.org
+ - run: yarn install --immutable
+ - run: npx twenty dev:build
+ - run: npm publish --provenance --access public
+ working-directory: .twenty/output
+```
+
+Pour d'autres systèmes CI (GitLab CI, CircleCI, etc.), les mêmes trois commandes s'appliquent : `yarn install`, `yarn twenty dev:build`, puis `npm publish` depuis `.twenty/output`.
+
+<Note>
+**npm provenance** est facultatif mais recommandé. Publier avec `--provenance` ajoute un badge de confiance à votre fiche npm, permettant aux utilisateurs de vérifier que le package a été construit à partir d'un commit spécifique dans un pipeline CI public. Voir la [documentation npm sur la provenance](https://docs.npmjs.com/generating-provenance-statements) pour les instructions de configuration.
+</Note>
+
+## Installation des applications
+
+Une fois qu'une application est publiée (npm) ou déployée (tarball), les espaces de travail peuvent l'installer via l'interface utilisateur.
+
+Accédez à la page **Paramètres > Applications** dans Twenty, où les applications de la place de marché et celles déployées en tarball peuvent être parcourues et installées.
+
+{/* TODO: add screenshot of the UI when the app is registered */}
+
+Vous pouvez également installer des applications depuis la ligne de commande :
+
+```bash filename="Terminal"
+yarn twenty app:install
+```
+
+<Note>
+Le serveur applique le versionnement SemVer à l’installation, en reprenant les mêmes règles que lors du déploiement :
+
+* L’installation de la même version déjà installée dans votre espace de travail est refusée avec une erreur `APP_ALREADY_INSTALLED`.
+* L’installation d’une version inférieure à celle actuellement installée est refusée avec une erreur `CANNOT_DOWNGRADE_APPLICATION`.
+
+Pour installer une version plus récente, déployez-la ou publiez-la d’abord, puis relancez `yarn twenty app:install`.
+</Note>
diff --git a/packages/twenty-docs/l/fr/developers/extend/apps/operations/sync-and-recovery.mdx b/packages/twenty-docs/l/fr/developers/extend/apps/operations/sync-and-recovery.mdx
new file mode 100644
index 00000000000..c94d82003b5
--- /dev/null
+++ b/packages/twenty-docs/l/fr/developers/extend/apps/operations/sync-and-recovery.mdx
@@ -0,0 +1,111 @@
+---
+title: Synchronisation et récupération
+description: Quelle commande utiliser et quand, comment lire la sortie de synchronisation, et une échelle de récupération pour les cas où les métadonnées locales dérivent — avant d'en arriver à une réinitialisation complète.
+icon: boussole
+---
+
+Le développement local d'applications tourne autour de la **synchronisation** : le CLI reconstruit votre manifeste et le serveur applique uniquement la différence entre celui-ci et les métadonnées déjà présentes dans votre espace de travail. Cette page explique vers quelle commande se tourner, comment lire ce qu'une synchronisation a modifié, et quoi faire — dans l'ordre — lorsque l'état local semble incohérent.
+
+## Quelle commande, quand
+
+<Note>
+Pour l'itération locale au quotidien, vous voudrez presque toujours `yarn twenty dev`. Le déploiement et la publication servent à livrer des versions, **pas** pour la boucle locale.
+</Note>
+
+| Vous souhaitez… | Commande | Notes |
+| ------------------------------------------------------- | ----------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
+| Itérer localement avec la synchronisation en direct | `yarn twenty dev` | Surveille vos fichiers et synchronise à chaque modification. |
+| Synchroniser une fois puis quitter (CI, scripts, hooks) | `yarn twenty dev --once` | Effectue une compilation + synchronisation, puis quitte. |
+| Prévisualiser les changements **sans les appliquer** | `yarn twenty dev --once --dry-run` | Calcule et affiche le diff ; n'écrit rien. |
+| Retirer l'application de l'espace de travail | `yarn twenty app:uninstall` | Ajoutez `--yes` pour ignorer la confirmation. |
+| Envoyer une archive tarball vers un serveur | `yarn twenty app:publish --private` | Nécessite une version de `package.json` **strictement supérieure** — voir [Publication](/l/fr/developers/extend/apps/operations/publishing). |
+| Publier sur la place de marché (npm) | `yarn twenty app:publish` | — |
+| Installer / mettre à niveau une version déployée | `yarn twenty app:install` | Installe la version actuellement déployée. |
+| Effacer le serveur local et repartir de zéro | `yarn twenty docker:reset` | Supprime **toutes** les données locales — en dernier recours. |
+
+### La synchronisation locale n'a pas besoin d'un incrément de version
+
+La règle de `version` strictement croissante (`VERSION_ALREADY_EXISTS` lors du déploiement, `APP_ALREADY_INSTALLED` / `CANNOT_DOWNGRADE_APPLICATION` lors de l'installation) s'applique à **`app:publish` / `app:install`** — le chemin de mise en production. `yarn twenty dev` synchronise votre manifeste sur place et ne nécessite jamais de changement de version, vous n'avez donc pas besoin de toucher à `package.json` pour itérer. Si vous vous surprenez à incrémenter la version pour tester un changement local, c'est que vous utilisez le chemin de mise en production alors que vous voulez la boucle de développement.
+
+## Lire la sortie de synchronisation
+
+Chaque synchronisation affiche les changements de métadonnées qu'elle a appliqués (ou appliquerait, avec `--dry-run`) :
+
+```text filename="Terminal"
+Metadata changes: 2 created, 1 updated, 1 deleted
+ created objectMetadata rocket
+ created fieldMetadata timelineActivities
+ updated fieldMetadata launchedAt
+ deleted pageLayout legacyTab
+✓ Synced
+```
+
+C'est votre premier diagnostic : il vous indique exactement quels objets, champs et mises en page ont changé, afin que vous puissiez confirmer qu'une synchronisation a fait ce que vous attendiez avant de vérifier l'interface utilisateur.
+
+Lorsqu'une synchronisation échoue sur une seule entité, l'erreur nomme l'entité en cause et son `universalIdentifier`, par exemple :
+
+```text
+Migration action 'create' for 'fieldMetadata' (universalIdentifier: 2020...4337) failed
+```
+
+Utilisez cet identifiant pour trouver l'entité dans votre manifeste (et, si nécessaire, dans l'espace de travail) plutôt que de deviner laquelle est en conflit.
+
+## Prévisualiser les changements (dry run)
+
+`yarn twenty dev --once --dry-run` construit votre manifeste, demande au serveur le plan de migration et l'affiche — **sans rien appliquer**. C'est le moyen sûr de répondre « que changerait cette synchronisation ? » avant de s'y engager.
+
+```bash filename="Terminal"
+yarn twenty dev --once --dry-run
+```
+
+```text filename="Terminal"
+Building manifest...
+Computing metadata diff (dry run, nothing will be applied)...
+Metadata changes: 1 created, 1 updated
+ created fieldMetadata timelineActivities
+ updated objectMetadata rocket
+✓ Dry run complete for My App — no changes were applied
+```
+
+Un dry run :
+
+* **N'écrit rien** — aucune migration de métadonnées, aucune mise à jour de l'enregistrement d'application, aucun changement de rôle/onglet par défaut, et aucune génération de client d'API.
+* Renvoie le **même diff** qu'une synchronisation réelle appliquerait, afin que vous puissiez examiner à l'avance les entités créées/mises à jour/supprimées.
+* Est utile avant un changement risqué, lors de la révision d'un changement généré par une IA, ou dans un script qui doit échouer si un changement inattendu est sur le point d'être appliqué.
+
+<Note>
+Un dry run ne prévisualise que les changements de **métadonnées**, et il nécessite que l'application ait été synchronisée au moins une fois (pour que l'espace de travail la connaisse). Si vous l'exécutez sur une application qui n'a jamais été synchronisée, le serveur indique que l'application n'est pas installée — exécutez d'abord une fois `yarn twenty dev`.
+</Note>
+
+## Échelle de récupération
+
+Lorsque les métadonnées locales semblent incorrectes, augmentez le niveau de manière progressive dans cet ordre et arrêtez-vous dès que vous êtes débloqué. Chaque étape est plus perturbatrice que la précédente.
+
+1. **Resynchroniser.** Exécutez à nouveau `yarn twenty dev --once`. Les synchronisations sont idempotentes — réexécuter un manifeste propre est sûr et résout souvent un incident passager.
+2. **Prévisualiser le plan.** Exécutez `yarn twenty dev --once --dry-run` pour voir exactement ce que la prochaine synchronisation compte changer, sans l'appliquer.
+3. **Lire l'erreur nommée.** Si une synchronisation échoue, relevez le type de métadonnées et l'`universalIdentifier` dans le message (voir ci-dessus) et localisez cette entité dans votre manifeste. Un conflit pointe généralement vers un identifiant dupliqué ou réutilisé.
+4. **Désinstaller et réinstaller.** `yarn twenty app:uninstall`, puis synchronisez à nouveau (`yarn twenty dev`). Cette opération reconstruit les métadonnées de l'application à partir d'une base saine tout en gardant le reste de votre espace de travail intact.
+5. **Réinitialisation complète (en dernier recours).** `yarn twenty docker:reset`, puis réinjectez des données et resynchronisez.
+
+<Warning>
+`yarn twenty docker:reset` supprime **toutes** les données de votre instance locale — chaque espace de travail, enregistrement et application. Ne l'utilisez que lorsque les étapes précédentes ont échoué.
+</Warning>
+
+<Note>
+Vous avez rencontré une erreur de métadonnées ? Veuillez [ouvrir un ticket](https://github.com/twentyhq/twenty/issues/new/choose) et inclure le message d'échec de migration (avec son type de métadonnées et son `universalIdentifier`), la sortie `Metadata changes` de la synchronisation, ainsi que les commandes que vous avez exécutées.
+</Note>
+
+## Éviter les synchronisations concurrentes sur un même espace de travail
+
+La synchronisation applique des migrations de métadonnées. Exécuter plusieurs opérations de synchronisation, de déploiement ou d'installation contre le **même espace de travail au même moment** — par exemple, plusieurs terminaux ou agents IA qui itèrent en parallèle — peut entrelacer ces migrations et laisser les métadonnées dans un état partiellement appliqué.
+
+Le serveur sérialise les synchronisations par espace de travail pour éviter cela, mais vous devriez tout de même faire transiter les opérations sensibles sur les métadonnées par un **processus unique** plutôt que de les lancer en concurrence. Si vous orchestrez le développement avec plusieurs agents, faites passer leurs appels de synchronisation/déploiement/installation par une file unique afin qu'un seul s'exécute à la fois.
+
+## Distinguer les types d'échecs
+
+Lorsque quelque chose se passe mal, le diff de métadonnées et les erreurs nommées vous permettent de localiser l'échec :
+
+* **Erreur de construction du manifeste** — le CLI échoue avant la synchronisation (`MANIFEST_BUILD_FAILED`, `TYPECHECK_FAILED`) ; corrigez le code source de votre application.
+* **Erreur de synchronisation / migration** — la construction réussit mais l'application du diff échoue, en nommant l'entité et son `universalIdentifier` ; corrigez les métadonnées en conflit.
+* **Erreur d’exécution du code de l’application** — la synchronisation réussit, mais vos fonctions logiques ou composants se comportent mal à l’exécution ; consultez les [journaux de fonctions](/l/fr/developers/extend/apps/operations/cli).
+* **État local de l’instance** — aucun des cas ci-dessus et l’espace de travail semble toujours incorrect ; descendez l’échelle de récupération.
diff --git a/packages/twenty-docs/l/fr/developers/extend/apps/operations/testing.mdx b/packages/twenty-docs/l/fr/developers/extend/apps/operations/testing.mdx
new file mode 100644
index 00000000000..b44ab05f4dd
--- /dev/null
+++ b/packages/twenty-docs/l/fr/developers/extend/apps/operations/testing.mdx
@@ -0,0 +1,301 @@
+---
+title: Tests
+description: Configuration de Vitest, tests d’intégration sur un serveur Twenty réel, vérification des types et CI avec GitHub Actions.
+icon: flask
+---
+
+Le SDK fournit des API programmatiques qui vous permettent de construire, déployer, installer et désinstaller votre application depuis le code de test. Combiné avec [Vitest](https://vitest.dev/) et les clients d'API typés, vous pouvez écrire des tests d'intégration qui vérifient que votre application fonctionne de bout en bout sur un serveur Twenty réel.
+
+## Utilisation de packages npm
+
+Vous pouvez installer et utiliser n'importe quel package npm dans votre application. Les fonctions logiques et les composants frontaux sont tous deux empaquetés avec [esbuild](https://esbuild.github.io/), qui intègre toutes les dépendances dans la sortie — aucun `node_modules` n'est nécessaire à l'exécution.
+
+### Installation d'un package
+
+```bash filename="Terminal"
+yarn add axios
+```
+
+Puis importez-le dans votre code :
+
+```ts src/logic-functions/fetch-data.ts
+import { defineLogicFunction } from 'twenty-sdk/define';
+import axios from 'axios';
+
+const handler = async (): Promise<any> => {
+ const { data } = await axios.get('https://api.example.com/data');
+
+ return { data };
+};
+
+export default defineLogicFunction({
+ universalIdentifier: '...',
+ name: 'fetch-data',
+ description: 'Fetches data from an external API',
+ timeoutSeconds: 10,
+ handler,
+});
+```
+
+Il en va de même pour les composants frontaux :
+
+```tsx src/front-components/chart.tsx
+import { defineFrontComponent } from 'twenty-sdk/define';
+import { format } from 'date-fns';
+
+const DateWidget = () => {
+ return <p>Today is {format(new Date(), 'MMMM do, yyyy')}</p>;
+};
+
+export default defineFrontComponent({
+ universalIdentifier: '...',
+ name: 'date-widget',
+ component: DateWidget,
+});
+```
+
+### Comment fonctionne le bundling
+
+L'étape de build utilise esbuild pour produire un seul fichier autonome par fonction logique et par composant frontal. Tous les packages importés sont intégrés dans le bundle.
+
+**Les fonctions logiques** s'exécutent dans un environnement Node.js. Les modules intégrés de Node (`fs`, `path`, `crypto`, `http`, etc.) sont disponibles et n'ont pas besoin d'être installés.
+
+**Les composants frontaux** s'exécutent dans un Web Worker. Les modules intégrés de Node ne sont **pas** disponibles — seules les API du navigateur et les packages npm qui fonctionnent dans un environnement navigateur sont pris en charge.
+
+Les deux environnements disposent de `twenty-client-sdk/core` et `twenty-client-sdk/metadata` en tant que modules pré-fournis — ils ne sont pas intégrés au bundle mais résolus à l'exécution par le serveur.
+
+## Installation
+
+L'application générée inclut déjà Vitest. Si vous le configurez manuellement, installez les dépendances :
+
+```bash filename="Terminal"
+yarn add -D vitest vite-tsconfig-paths
+```
+
+Créez un `vitest.config.ts` à la racine de votre application :
+
+```ts vitest.config.ts
+import tsconfigPaths from 'vite-tsconfig-paths';
+import { defineConfig } from 'vitest/config';
+
+export default defineConfig({
+ plugins: [
+ tsconfigPaths({
+ projects: ['tsconfig.spec.json'],
+ ignoreConfigErrors: true,
+ }),
+ ],
+ test: {
+ testTimeout: 120_000,
+ hookTimeout: 120_000,
+ include: ['src/**/*.integration-test.ts'],
+ setupFiles: ['src/__tests__/setup-test.ts'],
+ env: {
+ TWENTY_API_URL: 'http://localhost:2020',
+ TWENTY_API_KEY: 'your-api-key',
+ },
+ },
+});
+```
+
+Créez un fichier de configuration qui vérifie que le serveur est joignable avant l'exécution des tests :
+
+```ts src/__tests__/setup-test.ts
+import * as fs from 'fs';
+import * as os from 'os';
+import * as path from 'path';
+import { beforeAll } from 'vitest';
+
+const TWENTY_API_URL = process.env.TWENTY_API_URL ?? 'http://localhost:2020';
+const TEST_CONFIG_DIR = path.join(os.tmpdir(), '.twenty-sdk-test');
+
+beforeAll(async () => {
+ // Verify the server is running
+ const response = await fetch(`${TWENTY_API_URL}/healthz`);
+
+ if (!response.ok) {
+ throw new Error(
+ `Twenty server is not reachable at ${TWENTY_API_URL}. ` +
+ 'Start the server before running integration tests.',
+ );
+ }
+
+ // Write a temporary config for the SDK
+ fs.mkdirSync(TEST_CONFIG_DIR, { recursive: true });
+
+ fs.writeFileSync(
+ path.join(TEST_CONFIG_DIR, 'config.json'),
+ JSON.stringify({
+ remotes: {
+ local: {
+ apiUrl: process.env.TWENTY_API_URL,
+ apiKey: process.env.TWENTY_API_KEY,
+ },
+ },
+ defaultRemote: 'local',
+ }, null, 2),
+ );
+});
+```
+
+## APIs programmatiques du SDK
+
+Le sous-chemin `twenty-sdk/cli` exporte des fonctions que vous pouvez appeler directement depuis le code de test :
+
+| Fonction | Description |
+| -------------- | -------------------------------------------------------------------- |
+| `appBuild` | Construire l'application et éventuellement créer une archive tarball |
+| `appDeploy` | Téléverser une archive tarball vers le serveur |
+| `appInstall` | Installer l'application sur l'espace de travail actif |
+| `appUninstall` | Désinstaller l'application de l'espace de travail actif |
+
+Chaque fonction retourne un objet résultat avec `success: boolean` et soit `data` soit `error`.
+
+## Écrire un test d'intégration
+
+Voici un exemple complet qui construit, déploie et installe l'application, puis vérifie qu'elle apparaît dans l'espace de travail :
+
+```ts src/__tests__/app-install.integration-test.ts
+import { APPLICATION_UNIVERSAL_IDENTIFIER } from 'src/application-config';
+import { appBuild, appDeploy, appInstall, appUninstall } from 'twenty-sdk/cli';
+import { MetadataApiClient } from 'twenty-client-sdk/metadata';
+import { afterAll, beforeAll, describe, expect, it } from 'vitest';
+
+const APP_PATH = process.cwd();
+
+describe('App installation', () => {
+ beforeAll(async () => {
+ const buildResult = await appBuild({
+ appPath: APP_PATH,
+ tarball: true,
+ onProgress: (message: string) => console.log(`[build] ${message}`),
+ });
+
+ if (!buildResult.success) {
+ throw new Error(`Build failed: ${buildResult.error?.message}`);
+ }
+
+ const deployResult = await appDeploy({
+ tarballPath: buildResult.data.tarballPath!,
+ onProgress: (message: string) => console.log(`[deploy] ${message}`),
+ });
+
+ if (!deployResult.success) {
+ throw new Error(`Deploy failed: ${deployResult.error?.message}`);
+ }
+
+ const installResult = await appInstall({ appPath: APP_PATH });
+
+ if (!installResult.success) {
+ throw new Error(`Install failed: ${installResult.error?.message}`);
+ }
+ });
+
+ afterAll(async () => {
+ await appUninstall({ appPath: APP_PATH });
+ });
+
+ it('should find the installed app in the workspace', async () => {
+ const metadataClient = new MetadataApiClient();
+
+ const result = await metadataClient.query({
+ findManyApplications: {
+ id: true,
+ name: true,
+ universalIdentifier: true,
+ },
+ });
+
+ const installedApp = result.findManyApplications.find(
+ (app: { universalIdentifier: string }) =>
+ app.universalIdentifier === APPLICATION_UNIVERSAL_IDENTIFIER,
+ );
+
+ expect(installedApp).toBeDefined();
+ });
+});
+```
+
+## Exécuter les tests
+
+Assurez-vous que votre serveur Twenty local est en cours d'exécution, puis :
+
+```bash filename="Terminal"
+yarn test
+```
+
+Ou en mode surveillance (watch) pendant le développement :
+
+```bash filename="Terminal"
+yarn test:watch
+```
+
+## Vérification des types
+
+Vous pouvez également exécuter une vérification des types sur votre application sans exécuter les tests :
+
+```bash filename="Terminal"
+yarn twenty dev:typecheck
+```
+
+Cela exécute `tsc --noEmit` et signale toute erreur de type.
+
+## CI avec GitHub Actions
+
+Le générateur crée un workflow GitHub Actions prêt à l’emploi dans `.github/workflows/ci.yml`. Il exécute automatiquement vos tests d’intégration à chaque push sur `main` et sur les pull requests.
+
+Le workflow :
+
+1. Récupère votre code
+2. Lance un serveur Twenty temporaire en utilisant l’action `twentyhq/twenty/.github/actions/spawn-twenty-docker-image`
+3. Installe les dépendances avec `yarn install --immutable`
+4. Exécute `yarn test` avec `TWENTY_API_URL` et `TWENTY_API_KEY` injectés à partir des sorties de l’action
+
+```yaml .github/workflows/ci.yml
+name: CI
+
+on:
+ push:
+ branches:
+ - main
+ pull_request: {}
+
+env:
+ TWENTY_VERSION: latest
+
+jobs:
+ test:
+ runs-on: ubuntu-latest
+ steps:
+ - name: Checkout
+ uses: actions/checkout@v4
+
+ - name: Spawn Twenty instance
+ id: twenty
+ uses: twentyhq/twenty/.github/actions/spawn-twenty-docker-image@main
+ with:
+ twenty-version: ${{ env.TWENTY_VERSION }}
+ github-token: ${{ secrets.GITHUB_TOKEN }}
+
+ - name: Enable Corepack
+ run: corepack enable
+
+ - name: Setup Node.js
+ uses: actions/setup-node@v4
+ with:
+ node-version-file: '.nvmrc'
+ cache: 'yarn'
+
+ - name: Install dependencies
+ run: yarn install --immutable
+
+ - name: Run integration tests
+ run: yarn test
+ env:
+ TWENTY_API_URL: ${{ steps.twenty.outputs.server-url }}
+ TWENTY_API_KEY: ${{ steps.twenty.outputs.access-token }}
+```
+
+Vous n’avez pas besoin de configurer de secrets — l’action `spawn-twenty-docker-image` démarre un serveur Twenty éphémère directement dans le runner et fournit les détails de connexion. Le secret `GITHUB_TOKEN` est fourni automatiquement par GitHub.
+
+Pour épingler une version spécifique de Twenty au lieu de `latest`, modifiez la variable d’environnement `TWENTY_VERSION` en haut du workflow.
diff --git a/packages/twenty-docs/l/fr/developers/extend/capabilities/apis.mdx b/packages/twenty-docs/l/fr/developers/extend/capabilities/apis.mdx
index bf5d5b149ef..29d24ddc496 100644
--- a/packages/twenty-docs/l/fr/developers/extend/capabilities/apis.mdx
+++ b/packages/twenty-docs/l/fr/developers/extend/capabilities/apis.mdx
@@ -17,7 +17,7 @@ Twenty génère des API spécifiquement pour votre modèle de données :
* **Documentation personnalisée** : Générée spécifiquement pour le modèle de données de votre espace de travail
<Note>
- Votre documentation API personnalisée est disponible sous **Paramètres → API & Webhooks** après la création d'une clé API. Comme Twenty génère des API qui correspondent à votre modèle de données personnalisé, la documentation est propre à votre espace de travail.
+Votre documentation API personnalisée est disponible sous **Paramètres → API & Webhooks** après la création d'une clé API. Comme Twenty génère des API qui correspondent à votre modèle de données personnalisé, la documentation est propre à votre espace de travail.
</Note>
## Les deux types d'API
@@ -81,14 +81,14 @@ Authorization: Bearer YOUR_API_KEY
<VimeoEmbed videoId="928786722" title="Création d'une clé API" />
<Warning>
- Votre clé API donne accès à des données sensibles. Ne la partagez pas avec des services non fiables. Si elle est compromise, désactivez-la immédiatement et générez-en une nouvelle.
+Votre clé API donne accès à des données sensibles. Ne la partagez pas avec des services non fiables. Si elle est compromise, désactivez-la immédiatement et générez-en une nouvelle.
</Warning>
### Attribuer un rôle à une clé API
Pour une meilleure sécurité, attribuez un rôle spécifique pour limiter l'accès :
-1. Allez dans **Paramètres → Rôles**
+1. Allez dans **Paramètres → Membres → Rôles**
2. Cliquez sur le rôle à attribuer
3. Ouvrez l'onglet **Attribution**
4. Sous **Clés API**, cliquez sur **+ Attribuer à une clé API**
@@ -143,5 +143,5 @@ Les requêtes API sont limitées pour garantir la stabilité de la plateforme :
| **Taille du lot** | 60 enregistrements par appel |
<Tip>
- Utilisez les opérations par lot pour maximiser le débit — traitez jusqu'à 60 enregistrements dans un seul appel API au lieu d'effectuer des requêtes individuelles.
+Utilisez les opérations par lot pour maximiser le débit — traitez jusqu'à 60 enregistrements dans un seul appel API au lieu d'effectuer des requêtes individuelles.
</Tip>
diff --git a/packages/twenty-docs/l/fr/developers/extend/capabilities/webhooks.mdx b/packages/twenty-docs/l/fr/developers/extend/capabilities/webhooks.mdx
index 98702d52a4a..9fac6aae34f 100644
--- a/packages/twenty-docs/l/fr/developers/extend/capabilities/webhooks.mdx
+++ b/packages/twenty-docs/l/fr/developers/extend/capabilities/webhooks.mdx
@@ -62,7 +62,7 @@ Chaque webhook envoie une requête HTTP POST avec un corps JSON :
| `horodatage` | Quand l'événement s'est produit (UTC) |
<Note>
- Répondez avec un **statut HTTP 2xx** (200-299) pour accuser réception. Les réponses non 2xx sont consignées comme des échecs de livraison.
+Répondez avec un **statut HTTP 2xx** (200-299) pour accuser réception. Les réponses non 2xx sont consignées comme des échecs de livraison.
</Note>
## Validation des Webhooks
diff --git a/packages/twenty-docs/l/fr/developers/extend/extend.mdx b/packages/twenty-docs/l/fr/developers/extend/extend.mdx
index 93f43c42ca5..037414644c2 100644
--- a/packages/twenty-docs/l/fr/developers/extend/extend.mdx
+++ b/packages/twenty-docs/l/fr/developers/extend/extend.mdx
@@ -1,7 +1,6 @@
---
title: Étendre
description: Étendez les fonctionnalités de Twenty avec des API, des webhooks et des applications personnalisées.
-redirect: /developers/introduction
---
<Frame>
@@ -16,20 +15,18 @@ Twenty est conçu pour être extensible. Utilisez nos API, nos webhooks et notre
* **API** : Interrogez et modifiez vos données CRM par programmation à l'aide de REST ou de GraphQL
* **Webhooks** : Recevez des notifications en temps réel lorsque des événements se produisent dans Twenty
-* **Applications** : Créez des applications personnalisées qui étendent les capacités de Twenty - Bientôt disponible !
+* **Applications** : Créez des applications personnalisées qui étendent les capacités de Twenty
## Prise en main
<CardGroup cols={2}>
- <Card title="API" icon="code" href="/l/fr/developers/api">
+ <Card title="API" icon="code" href="/l/fr/developers/extend/api">
Connectez-vous à Twenty par programmation
</Card>
-
- <Card title="Webhooks" icon="bell" href="/l/fr/developers/webhooks">
+ <Card title="Webhooks" icon="bell" href="/l/fr/developers/extend/webhooks">
Recevez des notifications d'événements en temps réel
</Card>
-
- <Card title="Applications" icon="puzzle-piece" href="/l/fr/developers/apps/apps">
- Créez des personnalisations sous forme de code (Alpha)
+ <Card title="Applications" icon="puzzle-piece" href="/l/fr/developers/extend/apps/getting-started">
+ Créez des personnalisations sous forme de code
</Card>
</CardGroup>
diff --git a/packages/twenty-docs/l/fr/developers/extend/oauth.mdx b/packages/twenty-docs/l/fr/developers/extend/oauth.mdx
new file mode 100644
index 00000000000..8eac8f136ea
--- /dev/null
+++ b/packages/twenty-docs/l/fr/developers/extend/oauth.mdx
@@ -0,0 +1,189 @@
+---
+title: OAuth
+icon: clé
+description: Flux de code d’autorisation avec PKCE et identifiants client pour l’accès serveur à serveur.
+---
+
+Twenty implémente OAuth 2.0 avec code d’autorisation + PKCE pour les applications destinées aux utilisateurs et des identifiants client pour l’accès serveur à serveur. Les clients sont enregistrés dynamiquement via [RFC 7591](https://datatracker.ietf.org/doc/html/rfc7591) — aucune configuration manuelle dans un tableau de bord.
+
+## Quand utiliser OAuth
+
+| Scénario | Méthode d’authentification |
+| -------------------------------------------------------------- | ---------------------------------------------------------------------------------------- |
+| Scripts internes, automatisation | [Clé API](/l/fr/developers/extend/api#authentication) |
+| Application externe agissant au nom d’un utilisateur | **OAuth — Code d’autorisation** |
+| Serveur à serveur, aucun contexte utilisateur | **OAuth — Identifiants client** |
+| Application Twenty avec des extensions d’interface utilisateur | [Applications](/l/fr/developers/extend/apps/getting-started) (OAuth est géré automatiquement) |
+
+## Enregistrer un client
+
+Twenty prend en charge **l’enregistrement dynamique de clients** conformément à [RFC 7591](https://datatracker.ietf.org/doc/html/rfc7591). Aucune configuration manuelle requise — enregistrez le client par programmation :
+
+```bash
+POST /oauth/register
+Content-Type: application/json
+
+{
+ "client_name": "My Integration",
+ "redirect_uris": ["https://myapp.com/callback"],
+ "grant_types": ["authorization_code"],
+ "token_endpoint_auth_method": "client_secret_post"
+}
+```
+
+**Réponse:**
+
+```json
+{
+ "client_id": "abc123",
+ "client_secret": "secret456",
+ "client_name": "My Integration",
+ "redirect_uris": ["https://myapp.com/callback"]
+}
+```
+
+<Warning>
+Stockez le `client_secret` en toute sécurité — il ne peut pas être récupéré ultérieurement.
+</Warning>
+
+## Périmètres
+
+| Périmètre | Accès |
+| --------- | ------------------------------------------------------------ |
+| `api` | Accès complet en lecture/écriture aux API Core et Metadata |
+| `profil` | Lire les informations de profil de l’utilisateur authentifié |
+
+Demandez les périmètres sous forme de chaîne séparée par des espaces : `scope=api profile`
+
+## Flux de code d’autorisation
+
+Utilisez ce flux lorsque votre application agit au nom d’un utilisateur Twenty.
+
+### 1. Rediriger l’utilisateur vers l’écran d’autorisation
+
+```
+GET /oauth/authorize?
+ client_id=YOUR_CLIENT_ID&
+ response_type=code&
+ redirect_uri=https://myapp.com/callback&
+ scope=api&
+ state=random_state_value&
+ code_challenge=CHALLENGE&
+ code_challenge_method=S256
+```
+
+| Paramètre | Obligatoire | Description |
+| ----------------------- | ----------- | ---------------------------------------------------------------- |
+| `client_id` | Oui | Votre identifiant client enregistré |
+| `response_type` | Oui | Doit être `code` |
+| `redirect_uri` | Oui | Doit correspondre à une URI de redirection enregistrée |
+| `scope` | Non | Périmètres séparés par des espaces (par défaut : `api`) |
+| `état` | Recommandé | Chaîne aléatoire pour empêcher les attaques CSRF |
+| `code_challenge` | Recommandé | Défi PKCE (hachage SHA-256 du vérificateur, encodé en base64url) |
+| `code_challenge_method` | Recommandé | Doit être `S256` lors de l’utilisation de PKCE |
+
+L’utilisateur voit un écran de consentement et approuve ou refuse l’accès.
+
+### 2. Gérer la redirection
+
+Après l’autorisation, Twenty redirige vers votre `redirect_uri` :
+
+```
+https://myapp.com/callback?code=AUTH_CODE&state=random_state_value
+```
+
+Vérifiez que `state` correspond à ce que vous avez envoyé.
+
+### 3. Échanger le code contre des jetons
+
+```bash
+POST /oauth/token
+Content-Type: application/x-www-form-urlencoded
+
+grant_type=authorization_code&
+code=AUTH_CODE&
+redirect_uri=https://myapp.com/callback&
+client_id=YOUR_CLIENT_ID&
+client_secret=YOUR_CLIENT_SECRET&
+code_verifier=YOUR_PKCE_VERIFIER
+```
+
+**Réponse:**
+
+```json
+{
+ "access_token": "eyJhbG...",
+ "token_type": "Bearer",
+ "expires_in": 3600,
+ "refresh_token": "dGhpcyBpcyBh..."
+}
+```
+
+### 4. Utiliser le jeton d’accès
+
+```bash
+GET /rest/companies
+Authorization: Bearer ACCESS_TOKEN
+```
+
+### 5. Actualiser à l’expiration
+
+```bash
+POST /oauth/token
+Content-Type: application/x-www-form-urlencoded
+
+grant_type=refresh_token&
+refresh_token=YOUR_REFRESH_TOKEN&
+client_id=YOUR_CLIENT_ID&
+client_secret=YOUR_CLIENT_SECRET
+```
+
+## Flux des identifiants client
+
+Pour les intégrations serveur à serveur sans interaction utilisateur :
+
+```bash
+POST /oauth/token
+Content-Type: application/x-www-form-urlencoded
+
+grant_type=client_credentials&
+client_id=YOUR_CLIENT_ID&
+client_secret=YOUR_CLIENT_SECRET&
+scope=api
+```
+
+Le jeton renvoyé dispose d’un accès au niveau de l’espace de travail, non lié à un utilisateur spécifique.
+
+## Découverte du serveur
+
+Twenty publie sa configuration OAuth à un point de découverte standard :
+
+```
+GET /.well-known/oauth-authorization-server
+```
+
+Cela renvoie tous les points de terminaison, les types d’octroi pris en charge, les périmètres et les capacités — utile pour créer des clients OAuth génériques.
+
+## Résumé des points de terminaison API
+
+| Point de terminaison | Objectif |
+| ----------------------------------------- | ------------------------------------- |
+| `/.well-known/oauth-authorization-server` | Découverte des métadonnées du serveur |
+| `/oauth/register` | Enregistrement dynamique de clients |
+| `/oauth/authorize` | Autorisation de l’utilisateur |
+| `/oauth/token` | Échange et actualisation de jetons |
+
+| Environnement | URL de base |
+| ---------------- | ------------------------ |
+| **Cloud** | `https://api.twenty.com` |
+| **Auto-hébergé** | `https://{your-domain}` |
+
+## OAuth vs clés API
+
+| | Clés API | OAuth |
+| ------------------------ | ---------------------------------------- | ------------------------------------------------------ |
+| **Installation** | Générer dans Paramètres | Enregistrer un client, implémenter le flux |
+| **Contexte utilisateur** | Aucun (au niveau de l’espace de travail) | Autorisations d’un utilisateur spécifique |
+| **Idéal pour** | Scripts, outils internes | Applications externes, intégrations multi-utilisateurs |
+| **Rotation des jetons** | Manuel | Automatique via des jetons d’actualisation |
+| **Accès par périmètre** | Accès complet à l’API | Granulaire via des périmètres |
diff --git a/packages/twenty-docs/l/fr/developers/extend/webhooks.mdx b/packages/twenty-docs/l/fr/developers/extend/webhooks.mdx
new file mode 100644
index 00000000000..c6dc9cf31d1
--- /dev/null
+++ b/packages/twenty-docs/l/fr/developers/extend/webhooks.mdx
@@ -0,0 +1,117 @@
+---
+title: Webhooks
+icon: satellite-dish
+description: Recevez une notification lorsque les enregistrements changent — HTTP POST vers votre point de terminaison à chaque création, mise à jour ou suppression.
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+Twenty envoie une requête HTTP POST vers votre URL chaque fois qu'un enregistrement est créé, mis à jour ou supprimé. Tous les types d'objets sont pris en charge, y compris les objets personnalisés.
+
+## Créer un Webhook
+
+1. Allez dans **Paramètres → API & Webhooks → Webhooks**
+2. Cliquez sur **+ Créer un webhook**
+3. Saisissez votre URL de webhook (doit être publiquement accessible)
+4. Cliquez sur **Enregistrer**
+
+Le webhook s'active immédiatement et commence à envoyer des notifications.
+
+<VimeoEmbed videoId="928786708" title="Création d'un webhook" />
+
+### Gérer les Webhooks
+
+**Modifier**: Cliquez sur le webhook → Mettre à jour l'URL → **Enregistrer**
+
+**Supprimer**: Cliquez sur le webhook → **Supprimer** → Confirmer
+
+## Événements
+
+Twenty envoie des webhooks pour ces types d'événements :
+
+| Événement | Exemple |
+| ----------------------------- | ---------------------------------------------------------- |
+| **Enregistrement créé** | `person.created`, `company.created`, `note.created` |
+| **Enregistrement mis à jour** | `person.updated`, `company.updated`, `opportunity.updated` |
+| **Enregistrement supprimé** | `person.deleted`, `company.deleted` |
+
+Tous les types d'événements sont envoyés à votre URL de webhook. Le filtrage des événements pourrait être ajouté dans de prochaines versions.
+
+## Format de la charge utile
+
+Chaque webhook envoie une requête HTTP POST avec un corps JSON :
+
+```json
+{
+ "event": "person.created",
+ "data": {
+ "id": "abc12345",
+ "firstName": "Alice",
+ "lastName": "Doe",
+ "email": "[email protected]",
+ "createdAt": "2025-02-10T15:30:45Z",
+ "createdBy": "user_123"
+ },
+ "timestamp": "2025-02-10T15:30:50Z"
+}
+```
+
+| Champ | Description |
+| ----------- | ----------------------------------------------------------- |
+| `event` | Ce qui s'est passé (par exemple, `person.created`) |
+| `data` | L'enregistrement complet qui a été créé/mis à jour/supprimé |
+| `timestamp` | Quand l'événement s'est produit (UTC) |
+
+<Note>
+Répondez avec un **statut HTTP 2xx** (200-299) pour accuser réception. Les réponses non 2xx sont consignées comme des échecs de livraison.
+</Note>
+
+## Validation des Webhooks
+
+Twenty signe chaque requête de webhook pour des raisons de sécurité. Validez les signatures pour garantir l'authenticité des requêtes.
+
+### En-têtes
+
+| En-tête | Description |
+| ---------------------------- | ------------------------ |
+| `X-Twenty-Webhook-Signature` | Signature HMAC SHA256 |
+| `X-Twenty-Webhook-Timestamp` | Horodatage de la requête |
+
+### Étapes de validation
+
+1. Récupérez l'horodatage depuis `X-Twenty-Webhook-Timestamp`
+2. Créez la chaîne : `{timestamp}:{JSON payload}`
+3. Calculez le HMAC SHA256 en utilisant votre secret de webhook
+4. Comparez avec `X-Twenty-Webhook-Signature`
+
+### Exemple (Node.js)
+
+```javascript
+const crypto = require("crypto");
+
+const timestamp = req.headers["x-twenty-webhook-timestamp"];
+const payload = JSON.stringify(req.body);
+const secret = "your-webhook-secret";
+
+const stringToSign = `${timestamp}:${payload}`;
+const expectedSignature = crypto
+ .createHmac("sha256", secret)
+ .update(stringToSign)
+ .digest("hex");
+
+const receivedSignature = req.headers["x-twenty-webhook-signature"];
+const isValid = crypto.timingSafeEqual(
+ Buffer.from(expectedSignature, "hex"),
+ Buffer.from(receivedSignature, "hex")
+);
+```
+
+## Webhooks vs Workflows
+
+| Méthode | Direction | Cas d'utilisation |
+| -------------------------------------- | --------- | ------------------------------------------------------------------------------------- |
+| **Webhooks** | SORTIE | Notifier automatiquement les systèmes externes de toute modification d'enregistrement |
+| **Workflow + requête HTTP** | SORTIE | Envoyer des données avec une logique personnalisée (filtres, transformations) |
+| **Déclencheur de webhook de workflow** | ENTRÉE | Recevoir des données dans Twenty depuis des systèmes externes |
+
+Pour recevoir des données externes, voir [Configurer un déclencheur de webhook](/l/fr/user-guide/workflows/how-tos/connect-to-other-tools/set-up-a-webhook-trigger).
diff --git a/packages/twenty-docs/l/fr/developers/introduction.mdx b/packages/twenty-docs/l/fr/developers/introduction.mdx
index 22f07ae259d..3a3bfa7fdef 100644
--- a/packages/twenty-docs/l/fr/developers/introduction.mdx
+++ b/packages/twenty-docs/l/fr/developers/introduction.mdx
@@ -1,33 +1,28 @@
---
-title: Prise en main
-description: Bienvenue dans la documentation pour développeurs de Twenty, vos ressources pour étendre, auto-héberger et contribuer à Twenty.
+title: Développeurs
+description: Créez des applications, utilisez l'API, auto-hébergez ou contribuez à la base de code.
---
import { CardTitle } from "/snippets/card-title.mdx"
-<CardGroup cols={2}>
- <Card href="/l/fr/developers/api" icon="code">
- <CardTitle>API</CardTitle>
- Interrogez et modifiez vos données CRM avec REST ou GraphQL.
- </Card>
-
- <Card href="/l/fr/developers/webhooks" icon="bell">
- <CardTitle>Webhooks</CardTitle>
- Recevez des notifications en temps réel lors d'événements.
+<CardGroup cols={3}>
+ <Card href="/l/fr/developers/extend/apps/getting-started" img="/images/user-guide/halftone/dev-apps.png">
+ <CardTitle>Applications</CardTitle>
+ Étendez Twenty avec des objets personnalisés, de la logique côté serveur, des composants d'interface utilisateur et des agents IA — le tout sous forme de packages TypeScript.
</Card>
- <Card href="/l/fr/developers/apps/apps" icon="puzzle-piece">
- <CardTitle>Apps</CardTitle>
- Créez des applications personnalisées qui étendent les capacités de Twenty.
+ <Card href="/l/fr/developers/extend/api" img="/images/user-guide/halftone/dev-api.png">
+ <CardTitle>API</CardTitle>
+ API REST et GraphQL, webhooks et OAuth.
</Card>
- <Card href="/l/fr/developers/self-host/self-host" icon="desktop">
+ <Card href="/l/fr/developers/self-host/capabilities/docker-compose" img="/images/user-guide/halftone/dev-self-host.png">
<CardTitle>Auto-héberger</CardTitle>
- Déployez et gérez Twenty sur votre propre infrastructure.
+ Exécutez Twenty sur votre propre infrastructure.
</Card>
- <Card href="/l/fr/developers/contribute/contribute" icon="github">
+ <Card href="/l/fr/developers/contribute/capabilities/local-setup" img="/images/user-guide/halftone/dev-contribute.png">
<CardTitle>Contribuer</CardTitle>
- Rejoignez notre communauté open source et contribuez à Twenty.
+ Configurez le monorepo en local et soumettez des PR.
</Card>
</CardGroup>
diff --git a/packages/twenty-docs/l/fr/developers/self-host/capabilities/docker-compose.mdx b/packages/twenty-docs/l/fr/developers/self-host/capabilities/docker-compose.mdx
index aff77778dfd..105dfa6598b 100644
--- a/packages/twenty-docs/l/fr/developers/self-host/capabilities/docker-compose.mdx
+++ b/packages/twenty-docs/l/fr/developers/self-host/capabilities/docker-compose.mdx
@@ -1,9 +1,10 @@
---
-title: 1-Clic avec Docker Compose
+title: Docker Compose
+icon: docker
---
<Warning>
- Les conteneurs Docker sont destinés à l'hébergement en production ou à l'auto-hébergement, pour la contribution veuillez consulter le [Configuration Locale](/l/fr/developers/contribute/capabilities/local-setup).
+Les conteneurs Docker sont destinés à l'hébergement en production ou à l'auto-hébergement. Pour contribuer, veuillez consulter la [configuration locale](/l/fr/developers/contribute/capabilities/local-setup).
</Warning>
## Vue d'ensemble
@@ -12,7 +13,7 @@ Ce guide fournit des instructions pas-à-pas pour installer et configurer l'appl
**Important :** Modifiez uniquement les paramètres explicitement mentionnés dans ce guide. Modifier d'autres configurations peut entraîner des problèmes.
-Consultez les documents [Configurer les Variables d’Environnement](/l/fr/developers/self-host/capabilities/setup) pour la configuration avancée. Toutes les variables d'environnement doivent être déclarées dans le fichier docker-compose.yml au niveau du serveur et/ou du travailleur, selon la variable.
+Consultez [Configurer les variables d'environnement](/l/fr/developers/self-host/capabilities/setup) pour la configuration avancée. Toutes les variables d'environnement doivent être déclarées dans le fichier `docker-compose.yml` au niveau du serveur et/ou du worker, selon la variable.
## Exigences du Système
@@ -50,7 +51,7 @@ Suivez ces étapes pour une installation manuelle.
curl -o .env https://raw.githubusercontent.com/twentyhq/twenty/refs/heads/main/packages/twenty-docker/.env.example
```
-2. **Générez des Jetons Secrets**
+2. **Générer une clé de chiffrement**
Exécutez la commande suivante pour générer une chaîne aléatoire unique :
@@ -58,16 +59,18 @@ Suivez ces étapes pour une installation manuelle.
openssl rand -base64 32
```
- **Important :** Gardez cette valeur secrète / ne la partagez pas.
+ **Important :** Gardez cette valeur secrète / ne la partagez pas. La perte de `ENCRYPTION_KEY` signifie la perte d’accès à chaque secret stocké dans la base de données (jetons OAuth, variables d’application, secrets TOTP, etc.).
3. **Mettez à jour le `.env`**
Remplacez la valeur de l'espace réservé dans votre fichier .env par le jeton généré :
```ini
- APP_SECRET=first_random_string
+ ENCRYPTION_KEY=random_string
```
+ Voir le [guide de rotation des clés](/l/fr/developers/self-host/capabilities/key-rotation) pour obtenir des instructions sur la rotation de la clé sans interruption de service.
+
4. **Définissez le Mot de Passe de Postgres**
Mettez à jour la valeur `PG_DATABASE_PASSWORD` dans le fichier .env avec un mot de passe fort sans caractères spéciaux.
diff --git a/packages/twenty-docs/l/fr/developers/self-host/capabilities/key-rotation.mdx b/packages/twenty-docs/l/fr/developers/self-host/capabilities/key-rotation.mdx
new file mode 100644
index 00000000000..a8e71a09974
--- /dev/null
+++ b/packages/twenty-docs/l/fr/developers/self-host/capabilities/key-rotation.mdx
@@ -0,0 +1,60 @@
+---
+title: Rotation des clés
+icon: rotate
+---
+
+Twenty possède deux familles de clés indépendantes :
+
+* **Clés de signature JWT** — paires de clés asymétriques ES256 (avec balise `kid`) stockées dans `core."signingKey"`, utilisées pour signer et vérifier les jetons d’accès / de rafraîchissement.
+* **Clé de chiffrement au repos** — `ENCRYPTION_KEY`, utilisée pour chiffrer les jetons OAuth, les variables d’application, les clés privées de clés de signature, les valeurs de configuration sensibles et les secrets TOTP à l’intérieur d’une enveloppe `enc:v2:`.
+
+`APP_SECRET` est un secret hérité conservé pour la rétrocompatibilité : lorsque `ENCRYPTION_KEY` n’est pas défini, il agit comme mécanisme de secours pour le chiffrement au repos / le cookie de session, et il continue de vérifier les jetons d’accès HS256 préexistants. Il sera déprécié.
+
+## Clés de signature JWT
+
+Chaque clé contient une `publicKey` (conservée indéfiniment afin de pouvoir vérifier les jetons émis précédemment), une `privateKey` chiffrée (utilisée uniquement tant que la clé est actuelle), un indicateur `isCurrent` (exactement une ligne à la fois) et un champ `revokedAt` facultatif.
+
+### Faire pivoter la clé actuelle
+
+Définissez `SIGNING_KEY_ROTATION_DAYS` pour l’activer : une tâche cron quotidienne émet alors une nouvelle clé actuelle dès que l’ancienne dépasse ce seuil. Les clés précédentes ne sont *pas* révoquées, donc les jetons signés avec celles-ci restent vérifiables. Laissez la variable non définie pour désactiver la rotation automatique.
+
+<Note>La rotation automatique est disponible à partir de la v2.6+.</Note>
+
+### Révoquer une clé (fuite / urgence uniquement)
+
+**Settings → Admin Panel → Signing keys → Revoke** sur une ligne non actuelle. Efface le matériel privé chiffré, définit `revokedAt` et rejette chaque jeton existant signé avec ce `kid`.
+
+## Faire pivoter `ENCRYPTION_KEY`
+
+<Note>La commande `secret-encryption:rotate` décrite ci-dessous est fournie à partir de la v2.6+.</Note>
+
+Chaque valeur chiffrée est encapsulée sous la forme `enc:v2:\<keyId>:\<payload>`, où `\<keyId>` est un préfixe hexadécimal sur 8 caractères dérivé de la clé brute. La rotation est en ligne et reprenable.
+
+1. **Générez une nouvelle clé** : `openssl rand -base64 32`.
+
+2. **Configurez les deux clés côte à côte** dans `.env`, puis redémarrez :
+ ```ini
+ ENCRYPTION_KEY=NEW_VALUE
+ FALLBACK_ENCRYPTION_KEY=OLD_VALUE
+ ```
+ Les nouvelles écritures utilisent la nouvelle clé, les lignes existantes se déchiffrent toujours via la clé de secours.
+
+3. **Rechiffrez les lignes existantes** :
+
+ ```bash
+ docker exec -it {server_container} yarn command:prod secret-encryption:rotate
+ ```
+
+ La commande parcourt six sites (`connected-account-tokens`, `application-variable`, `application-registration-variable`, `signing-key-private-keys`, `sensitive-config-storage`, `totp-secrets`). Un filtre SQL ignore les lignes déjà sur le nouveau `\<keyId>`, de sorte que la commande est idempotente : interrompez-la et relancez-la si nécessaire. Quitte avec un code de sortie non nul si une ligne échoue — relancez pour réessayer.
+
+ | Option | Description |
+ | ---------------------------------------- | ----------------------------------------------------------------- |
+ | `-s, --site \<site>` | Limiter à un seul site. |
+ | `-b, --batch-size \<n>` | Lignes par lot (valeur par défaut `200`, maximum `5000`). |
+ | `-d, --dry-run` | Déchiffrer + rechiffrer en mémoire, ignorer la commande `UPDATE`. |
+
+4. **Supprimez la clé de secours** une fois que `--dry-run` n’affiche plus aucune ligne restante : supprimez `FALLBACK_ENCRYPTION_KEY` et redémarrez.
+
+## Prise en charge héritée de `APP_SECRET`
+
+Les instances plus anciennes qui n’ont jamais défini `ENCRYPTION_KEY` utilisent `APP_SECRET` comme clé de chiffrement au repos (et comme secret de cookie de session, dérivé de celle-ci). Ce chemin est conservé pour la rétrocompatibilité mais est **déprécié** — définissez une `ENCRYPTION_KEY` dédiée et suivez la procédure de rotation ci-dessus pour migrer. `APP_SECRET` reste lui-même utilisé pour vérifier les anciens jetons d’accès HS256.
diff --git a/packages/twenty-docs/l/fr/developers/self-host/capabilities/setup.mdx b/packages/twenty-docs/l/fr/developers/self-host/capabilities/setup.mdx
index 72694bd0539..7efbbfb331f 100644
--- a/packages/twenty-docs/l/fr/developers/self-host/capabilities/setup.mdx
+++ b/packages/twenty-docs/l/fr/developers/self-host/capabilities/setup.mdx
@@ -1,11 +1,12 @@
---
title: Installation
+icon: engrenage
---
# Gestion de la configuration
<Warning>
- **Première installation ?** Suivez le [Guide d’installation de Docker Compose](/l/fr/developers/self-host/capabilities/docker-compose) pour faire fonctionner Twenty, puis revenez ici pour la configuration.
+**Première installation ?** Suivez le [Guide d’installation de Docker Compose](/l/fr/developers/self-host/capabilities/docker-compose) pour faire fonctionner Twenty, puis revenez ici pour la configuration.
</Warning>
Twenty offre **deux modes de configuration** pour répondre à différents besoins de déploiement :
@@ -26,7 +27,7 @@ IS_CONFIG_VARIABLES_IN_DB_ENABLED=true # default
4. Les modifications prennent effet immédiatement (dans les 15 secondes pour les déploiements multi-conteneurs)
<Warning>
- **Déploiements multi-conteneurs :** En utilisant la configuration de la base de données (`IS_CONFIG_VARIABLES_IN_DB_ENABLED=true`), les conteneurs serveur et travailleur lisent à partir de la même base de données. Les modifications du panneau d'administration affectent les deux automatiquement, éliminant le besoin de dupliquer les variables d'environnement entre les conteneurs (sauf pour les variables d'infrastructure).
+**Déploiements multi-conteneurs :** En utilisant la configuration de la base de données (`IS_CONFIG_VARIABLES_IN_DB_ENABLED=true`), les conteneurs serveur et travailleur lisent à partir de la même base de données. Les modifications du panneau d'administration affectent les deux automatiquement, éliminant le besoin de dupliquer les variables d'environnement entre les conteneurs (sauf pour les variables d'infrastructure).
</Warning>
**Ce que vous pouvez configurer via le panneau d'administration :**
@@ -41,12 +42,27 @@ IS_CONFIG_VARIABLES_IN_DB_ENABLED=true # default
![Variables de configuration du panneau d'administration](/images/user-guide/setup/admin-panel-config-variables.png)
<Warning>
- Chaque variable est documentée avec des descriptions dans votre panneau d'administration sous **Paramètres → Panneau d'administration → Variables de configuration**.
- Certains paramètres d'infrastructure comme les connexions de base de données (`PG_DATABASE_URL`), les URL du serveur (`SERVER_URL`), et les secrets d'application (`APP_SECRET`) ne peuvent être configurés que via le fichier `.env`.
+Chaque variable est documentée avec des descriptions dans votre panneau d'administration sous **Paramètres → Panneau d'administration → Variables de configuration**.
+Certains paramètres d'infrastructure comme les connexions de base de données (`PG_DATABASE_URL`), les URL du serveur (`SERVER_URL`) et les secrets (`ENCRYPTION_KEY`, `FALLBACK_ENCRYPTION_KEY`) ne peuvent être configurés que via le fichier `.env`.
- [Référence technique complète →](https://github.com/twentyhq/twenty/blob/main/packages/twenty-server/src/engine/core-modules/twenty-config/config-variables.ts)
+[Référence technique complète →](https://github.com/twentyhq/twenty/blob/main/packages/twenty-server/src/engine/core-modules/twenty-config/config-variables.ts)
</Warning>
+## Clés de chiffrement
+
+Twenty utilise deux clés de chiffrement uniquement définissables via des variables d'environnement :
+
+| Variable | Objectif | Obligatoire |
+| ------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
+| `ENCRYPTION_KEY` | Clé principale utilisée pour chiffrer les secrets au repos (jetons OAuth, variables d'application, clés privées de signature, secrets TOTP, valeurs de configuration sensibles). | Oui pour les nouvelles installations (les anciennes installations peuvent s'appuyer à la place sur `APP_SECRET` — voir ci-dessous) |
+| `FALLBACK_ENCRYPTION_KEY` | Clé utilisée uniquement pour la vérification. Définie lors d'une rotation sur l’*ancienne* valeur de `ENCRYPTION_KEY` afin que les lignes existantes restent déchiffrables. | Uniquement pendant la rotation |
+
+Pour assurer la rétrocompatibilité, si `ENCRYPTION_KEY` n'est pas défini, Twenty se rabat sur `APP_SECRET` pour le chiffrement au repos, ce qui correspond au comportement historique des anciens déploiements. Les nouvelles installations doivent toujours définir une `ENCRYPTION_KEY` dédiée.
+
+Générez les valeurs avec `openssl rand -base64 32` et stockez-les dans un endroit sûr (un gestionnaire de secrets, une configuration scellée, etc.). Perdre `ENCRYPTION_KEY` signifie perdre l'accès à tous les secrets stockés dans la base de données.
+
+Pour faire pivoter `ENCRYPTION_KEY` sans temps d'arrêt, consultez le [guide de rotation des clés](/l/fr/developers/self-host/capabilities/key-rotation).
+
## 2. Configuration réservée à l'environnement
```bash
@@ -93,7 +109,7 @@ Activez le mode multi-espaces de travail pour des déploiements de type SaaS où
* Des paramètres spécifiques à l'espace de travail, comme le sous-domaine et le domaine personnalisé, deviennent disponibles dans les paramètres de l'espace de travail
<Warning>
- **Paramètre réservé à l'environnement :** `IS_MULTIWORKSPACE_ENABLED` ne peut être configuré que via le fichier `.env` et nécessite un redémarrage. Il ne peut pas être modifié via le panneau d'administration.
+**Paramètre réservé à l'environnement :** `IS_MULTIWORKSPACE_ENABLED` ne peut être configuré que via le fichier `.env` et nécessite un redémarrage. Il ne peut pas être modifié via le panneau d'administration.
</Warning>
### Configuration DNS pour le mode multi-espaces de travail
@@ -149,7 +165,7 @@ Lorsqu'il est activé, seuls les utilisateurs disposant de `canAccessFullAdminPa
* `AUTH_GOOGLE_APIS_CALLBACK_URL=https://{your-domain}/auth/google-apis/get-access-token`
<Warning>
- **Mode réservé à l'environnement :** Si vous définissez `IS_CONFIG_VARIABLES_IN_DB_ENABLED=false`, ajoutez ces variables à votre fichier `.env` à la place.
+**Mode réservé à l'environnement :** Si vous définissez `IS_CONFIG_VARIABLES_IN_DB_ENABLED=false`, ajoutez ces variables à votre fichier `.env` à la place.
</Warning>
**Scopes requis** (configurés automatiquement) :
@@ -168,7 +184,7 @@ Sous [Écran de consentement OAuth](https://console.cloud.google.com/apis/creden
## Intégration Microsoft 365
<Warning>
- Les utilisateurs doivent avoir une [licence Microsoft 365](https://admin.microsoft.com/Adminportal/Home) pour pouvoir utiliser les API Calendrier et Messagerie. Ils ne pourront pas synchroniser leur compte sur Twenty sans cela.
+Les utilisateurs doivent avoir une [licence Microsoft 365](https://admin.microsoft.com/Adminportal/Home) pour pouvoir utiliser les API Calendrier et Messagerie. Ils ne pourront pas synchroniser leur compte sur Twenty sans cela.
</Warning>
### Créez un projet dans Microsoft Azure
@@ -211,7 +227,7 @@ Vous devez ajouter les URI de redirection suivantes à votre projet :
* `AUTH_MICROSOFT_APIS_CALLBACK_URL=https://{your-domain}/auth/microsoft-apis/get-access-token`
<Warning>
- **Mode réservé à l'environnement :** Si vous définissez `IS_CONFIG_VARIABLES_IN_DB_ENABLED=false`, ajoutez ces variables à votre fichier `.env` à la place.
+**Mode réservé à l'environnement :** Si vous définissez `IS_CONFIG_VARIABLES_IN_DB_ENABLED=false`, ajoutez ces variables à votre fichier `.env` à la place.
</Warning>
### Configurer les scopes
@@ -256,82 +272,111 @@ yarn command:prod cron:workflow:automated-cron-trigger
3. Configurez vos paramètres SMTP :
<ArticleTabs label1="Gmail" label2="Office365" label3="Smtp4dev">
+
<ArticleTab>
- Vous devrez créer un [mot de passe d'application](https://support.google.com/accounts/answer/185833).
- * EMAIL_DRIVER=smtp
- * EMAIL_SMTP_HOST=smtp.gmail.com
- * EMAIL_SMTP_PORT=465
- * EMAIL_SMTP_USER=gmail_email_address
- * EMAIL_SMTP_PASSWORD='gmail_app_password'
+ Vous devrez créer un [mot de passe d'application](https://support.google.com/accounts/answer/185833).
+ * EMAIL_DRIVER=smtp
+ * EMAIL_SMTP_HOST=smtp.gmail.com
+ * EMAIL_SMTP_PORT=465
+ * EMAIL_SMTP_USER=gmail_email_address
+ * EMAIL_SMTP_PASSWORD='gmail_app_password'
+
</ArticleTab>
<ArticleTab>
- Gardez à l'esprit que si vous avez activé la validation en deux étapes (2FA), vous devrez mettre en place un [mot de passe d'application](https://support.microsoft.com/en-us/account-billing/manage-app-passwords-for-two-step-verification-d6dc8c6d-4bf7-4851-ad95-6d07799387e9).
- * EMAIL_DRIVER=smtp
- * EMAIL_SMTP_HOST=smtp.office365.com
- * EMAIL_SMTP_PORT=587
- * EMAIL_SMTP_USER=office365_email_address
- * EMAIL_SMTP_PASSWORD='office365_password'
+ Gardez à l'esprit que si vous avez activé la validation en deux étapes (2FA), vous devrez mettre en place un [mot de passe d'application](https://support.microsoft.com/en-us/account-billing/manage-app-passwords-for-two-step-verification-d6dc8c6d-4bf7-4851-ad95-6d07799387e9).
+ * EMAIL_DRIVER=smtp
+ * EMAIL_SMTP_HOST=smtp.office365.com
+ * EMAIL_SMTP_PORT=587
+ * EMAIL_SMTP_USER=office365_email_address
+ * EMAIL_SMTP_PASSWORD='office365_password'
+
</ArticleTab>
<ArticleTab>
- **smtp4dev** est un serveur SMTP factice pour le développement et les tests.
-
- * Exécutez l'image smtp4dev : `docker run --rm -it -p 8090:80 -p 2525:25 rnwood/smtp4dev`
- * Accédez à l'interface utilisateur smtp4dev ici : [http://localhost:8090](http://localhost:8090)
- * Définissez les variables suivantes :
- * EMAIL_DRIVER=smtp
- * EMAIL_SMTP_HOST=localhost
- * EMAIL_SMTP_PORT=2525
+
+ **smtp4dev** est un serveur SMTP factice pour le développement et les tests.
+ * Exécutez l'image smtp4dev : `docker run --rm -it -p 8090:80 -p 2525:25 rnwood/smtp4dev`
+ * Accédez à l'interface utilisateur smtp4dev ici : [http://localhost:8090](http://localhost:8090)
+ * Définissez les variables suivantes :
+ * EMAIL_DRIVER=smtp
+ * EMAIL_SMTP_HOST=localhost
+ * EMAIL_SMTP_PORT=2525
+
</ArticleTab>
+
</ArticleTabs>
<Warning>
- **Mode réservé à l'environnement :** Si vous définissez `IS_CONFIG_VARIABLES_IN_DB_ENABLED=false`, ajoutez ces variables à votre fichier `.env` à la place.
+**Mode réservé à l'environnement :** Si vous définissez `IS_CONFIG_VARIABLES_IN_DB_ENABLED=false`, ajoutez ces variables à votre fichier `.env` à la place.
</Warning>
-## Fonctions logiques
+## Stockage S3
+
+<Warning>
+Par défaut, Twenty stocke les fichiers téléversés sur le système de fichiers local. Pour les déploiements en production, utilisez S3 ou un service compatible S3 (MinIO, DigitalOcean Spaces, etc.). afin de garantir la persistance des fichiers lors des redémarrages des conteneurs et la montée en charge sur plusieurs instances de serveur.
+</Warning>
+
+Définissez `STORAGE_TYPE=S_3` et configurez les variables `STORAGE_S3_*` via le panneau d'administration ou `.env`. Voir la [référence config-variables.ts](https://github.com/twentyhq/twenty/blob/main/packages/twenty-server/src/engine/core-modules/twenty-config/config-variables.ts) pour la liste complète des variables S3.
+
+Lorsque vous utilisez S3 avec des fonctionnalités dépendantes de CORS (par exemple les téléchargements de fichiers dans le navigateur), assurez-vous que votre compartiment S3 autorise l'origine de votre frontend Twenty dans sa configuration CORS.
-Twenty prend en charge les fonctions logiques pour les flux de travail et la logique personnalisée. L'environnement d'exécution est configuré via la variable d'environnement `SERVERLESS_TYPE`.
+## Fonctions logiques et interpréteur de code
+
+Twenty prend en charge les fonctions logiques pour les flux de travail et l'interpréteur de code pour l'analyse de données par IA. Les deux exécutent du code fourni par l'utilisateur et nécessitent une configuration explicite pour la sécurité.
+
+### Paramètres de sécurité par défaut
+
+**En production (NODE_ENV=production):** Les fonctions logiques et l'interpréteur de code sont par défaut sur **Désactivé**. Vous devez les activer explicitement avec `LOGIC_FUNCTION_TYPE` et `CODE_INTERPRETER_TYPE` si vous avez besoin de ces fonctionnalités.
+
+**En développement (NODE_ENV=development):** Les deux sont par défaut sur **LOCAL** pour plus de commodité lors de l'exécution en local.
<Warning>
- **Avis de sécurité :** Le pilote local (`SERVERLESS_TYPE=LOCAL`) exécute le code directement sur l'hôte dans un processus Node.js sans sandboxing. Il ne doit être utilisé que pour du code approuvé en développement. Pour les déploiements de production traitant du code non approuvé, nous recommandons fortement d'utiliser `SERVERLESS_TYPE=LAMBDA` ou `SERVERLESS_TYPE=DISABLED`.
+**Avis de sécurité :** Le pilote local (`LOGIC_FUNCTION_TYPE=LOCAL` ou `CODE_INTERPRETER_TYPE=LOCAL`) exécute le code directement sur l'hôte dans un processus Node.js sans sandboxing. Il ne doit être utilisé que pour du code approuvé en développement. Pour les déploiements en production traitant du code non fiable, utilisez `LOGIC_FUNCTION_TYPE=LAMBDA` ou `CODE_INTERPRETER_TYPE=E2B` (avec exécution en bac à sable), ou laissez-les désactivés.
</Warning>
-### Pilotes disponibles
+### Fonctions logiques - Pilotes disponibles
-| Pilote | Variable d'environnement | Cas d'utilisation | Niveau de sécurité |
-| --------- | -------------------------- | ---------------------------------------------- | ------------------------------------ |
-| Désactivé | `SERVERLESS_TYPE=DISABLED` | Désactiver complètement les fonctions logiques | N/A |
-| Local | `SERVERLESS_TYPE=LOCAL` | Environnements de développement et approuvés | Faible (aucun sandboxing) |
-| Lambda | `SERVERLESS_TYPE=LAMBDA` | Production avec du code non approuvé | Élevé (isolement au niveau matériel) |
+| Pilote | Variable d'environnement | Cas d'utilisation | Niveau de sécurité |
+| --------- | ------------------------------ | ---------------------------------------------- | ------------------------------------ |
+| Désactivé | `LOGIC_FUNCTION_TYPE=DISABLED` | Désactiver complètement les fonctions logiques | N/A |
+| Local | `LOGIC_FUNCTION_TYPE=LOCAL` | Environnements de développement et approuvés | Faible (aucun sandboxing) |
+| Lambda | `LOGIC_FUNCTION_TYPE=LAMBDA` | Production avec du code non approuvé | Élevé (isolement au niveau matériel) |
-### Configuration recommandée
+### Fonctions logiques - Configuration recommandée
**Pour le développement:**
```bash
-SERVERLESS_TYPE=LOCAL # default
+LOGIC_FUNCTION_TYPE=LOCAL # default when NODE_ENV=development
```
**Pour la production (AWS):**
```bash
-SERVERLESS_TYPE=LAMBDA
-SERVERLESS_LAMBDA_REGION=us-east-1
-SERVERLESS_LAMBDA_ROLE=arn:aws:iam::123456789:role/your-lambda-role
-SERVERLESS_LAMBDA_ACCESS_KEY_ID=your-access-key
-SERVERLESS_LAMBDA_SECRET_ACCESS_KEY=your-secret-key
+LOGIC_FUNCTION_TYPE=LAMBDA
+LOGIC_FUNCTION_LAMBDA_REGION=us-east-1
+LOGIC_FUNCTION_LAMBDA_ROLE=arn:aws:iam::123456789:role/your-lambda-role
+LOGIC_FUNCTION_LAMBDA_ACCESS_KEY_ID=your-access-key
+LOGIC_FUNCTION_LAMBDA_SECRET_ACCESS_KEY=your-secret-key
```
**Pour désactiver les fonctions logiques:**
```bash
-SERVERLESS_TYPE=DISABLED
+LOGIC_FUNCTION_TYPE=DISABLED # default when NODE_ENV=production
```
+### Interpréteur de code - Pilotes disponibles
+
+| Pilote | Variable d'environnement | Cas d'utilisation | Niveau de sécurité |
+| --------- | -------------------------------- | ---------------------------------------- | -------------------------- |
+| Désactivé | `CODE_INTERPRETER_TYPE=DISABLED` | Désactiver l'exécution de code par l'IA | N/A |
+| Local | `CODE_INTERPRETER_TYPE=LOCAL` | Développement uniquement | Faible (aucun sandboxing) |
+| E2B | `CODE_INTERPRETER_TYPE=E_2_B` | Production avec exécution en bac à sable | Élevée (bac à sable isolé) |
+
<Note>
- Lorsque vous utilisez `SERVERLESS_TYPE=DISABLED`, toute tentative d'exécuter une fonction logique renverra une erreur. Cela est utile si vous souhaitez exécuter Twenty sans la prise en charge des fonctions logiques.
+Lorsque vous utilisez `LOGIC_FUNCTION_TYPE=DISABLED` ou `CODE_INTERPRETER_TYPE=DISABLED`, toute tentative d'exécution renverra une erreur. Cela est utile si vous souhaitez exécuter Twenty sans ces capacités.
</Note>
diff --git a/packages/twenty-docs/l/fr/developers/self-host/capabilities/troubleshooting.mdx b/packages/twenty-docs/l/fr/developers/self-host/capabilities/troubleshooting.mdx
index dedd9fcf72f..973d40106e9 100644
--- a/packages/twenty-docs/l/fr/developers/self-host/capabilities/troubleshooting.mdx
+++ b/packages/twenty-docs/l/fr/developers/self-host/capabilities/troubleshooting.mdx
@@ -1,5 +1,6 @@
---
title: Résolution des problèmes
+icon: clé
---
## Résolution des problèmes
@@ -166,6 +167,10 @@ plugins: [
Exécutez `UPDATE core."user" SET "canAccessFullAdminPanel" = TRUE WHERE email = '[email protected]';` dans le conteneur de base de données pour obtenir l'accès au panneau d'administration.
+#### Lors de l'exécution d'un workflow, l'exécution du workflow échoue avec "L'exécution des fonctions logiques est désactivée. Définissez LOGIC_FUNCTION_TYPE sur LOCAL ou LAMBDA pour les activer."
+
+En production, les fonctions logiques sont désactivées par défaut. Définissez la variable d'environnement `LOGIC_FUNCTION_TYPE` sur `LOCAL` ou `LAMBDA` pour les activer. Cela peut être configuré via des variables d'environnement ou via les variables de base de données du panneau d'administration. Voir le [guide de configuration des fonctions logiques](/l/fr/developers/self-host/capabilities/setup#logic-functions-available-drivers) pour plus de détails.
+
### Docker compose en un clic
#### Impossible de se connecter
diff --git a/packages/twenty-docs/l/fr/developers/self-host/capabilities/upgrade-guide.mdx b/packages/twenty-docs/l/fr/developers/self-host/capabilities/upgrade-guide.mdx
index eb0c91c7bc6..32691cded6c 100644
--- a/packages/twenty-docs/l/fr/developers/self-host/capabilities/upgrade-guide.mdx
+++ b/packages/twenty-docs/l/fr/developers/self-host/capabilities/upgrade-guide.mdx
@@ -1,379 +1,102 @@
---
title: Guide de mise à niveau
+icon: arrow-up-right-dots
---
## Consignes générales
-**Assurez-vous toujours de sauvegarder votre base de données avant de commencer le processus de mise à niveau** en exécutant `docker exec -it {db_container_name_or_id} pg_dumpall -U {postgres_user} > databases_backup.sql`.
-
-Pour restaurer la sauvegarde, exécutez `cat databases_backup.sql | docker exec -i {db_container_name_or_id} psql -U {postgres_user}`.
-
-Si vous avez utilisé Docker Compose, suivez ces étapes :
-
-1. Dans un terminal, sur l'hôte où Twenty est en cours d'exécution, éteignez Twenty: `docker compose down`
-
-2. Mettez à niveau la version en changeant la valeur `TAG` dans le fichier .env près de votre docker-compose. (Nous recommandons de consommer la version `major.minor` telle que `v0.53`)
-
-3. Remettez Twenty en ligne avec `docker compose up -d`
-
-Si vous souhaitez mettre à niveau votre instance de quelques versions, par exemple de la v0.33.0 à la v0.35.0, vous devez mettre à niveau votre instance de manière séquentielle, dans cet exemple de la v0.33.0 à la v0.34.0, puis de la v0.34.0 à la v0.35.0.
-
-**Assurez-vous qu'après chaque version mise à niveau, votre sauvegarde ne soit pas corrompue.**
-
-## Étapes de mise à niveau spécifiques à la version
-
-## v1.0
-
-Bonjour Twenty v1.0 ! 🎉
-
-## v0.60
-
-### Améliorations des performances
-
-Toutes les interactions avec l'API des métadonnées ont été optimisées pour de meilleures performances, en particulier pour la manipulation des métadonnées d'objets et les opérations de création d'espaces de travail.
-
-Nous avons remanié notre stratégie de mise en cache pour privilégier les accès cache plutôt que les requêtes de base de données lorsque c'est possible, améliorant ainsi significativement les performances des opérations de l'API des métadonnées.
-
-Si vous rencontrez des problèmes d'exécution après la mise à niveau, vous devrez peut-être vider votre cache pour vous assurer qu'il est synchronisé avec les dernières modifications. Exécutez cette commande dans votre conteneur twenty-server :
+**Sauvegardez toujours votre base de données avant de commencer le processus de mise à niveau** en exécutant :
```bash
-yarn command:prod cache:flush
+docker exec -it {db_container_name_or_id} pg_dumpall -U {postgres_user} > databases_backup.sql
```
-### v0.55
-
-Mettez à niveau votre instance Twenty pour utiliser l'image v0.55
-
-Vous n'avez plus besoin de lancer de commande, la nouvelle image se chargera automatiquement de l'exécution de toutes les migrations requises.
-
-### Erreur `L'utilisateur n'a pas d'autorisation`
-
-Si vous rencontrez des erreurs d'autorisation sur la plupart des requêtes après la mise à niveau, vous devrez peut-être vider votre cache pour recalculer les dernières autorisations.
-
-Dans votre conteneur `twenty-server`, exécutez :
+Pour restaurer à partir d'une sauvegarde :
```bash
-yarn command:prod cache:flush
-```
-
-Ce problème est spécifique à cette version de Twenty et ne devrait pas être nécessaire pour les futures mises à niveau.
-
-### v0.54
-
-Depuis la version `0.53`, aucune action manuelle n'est nécessaire.
-
-#### Abandon du schéma de métadonnées
-
-Nous avons fusionné le schéma `metadata` dans celui de `core` pour simplifier la récupération de données de `TypeORM`.
-Nous avons intégré l'étape de commande `migrate` dans la commande `upgrade`. Nous ne recommandons pas l'exécution manuelle de `migrate` dans l'un de vos conteneurs serveur/travailleur.
-
-### Depuis la v0.53
-
-À partir de `0.53`, la mise à niveau est effectuée de manière programmatique au sein du `DockerFile`, cela signifie que vous ne devez plus exécuter de commande manuellement.
-
-Assurez-vous de continuer à mettre à jour votre instance de manière séquentielle, sans sauter de version majeure (par exemple, de `0.43.3` à `0.44.0` est autorisé, mais de `0.43.1` à `0.45.0` ne l'est pas), sinon cela pourrait entraîner une désynchronisation de la version de l'espace de travail pouvant entraîner une erreur d'exécution et des fonctionnalités manquantes.
-
-Pour vérifier si un espace de travail a été correctement migré, vous pouvez consulter sa version dans la base de données dans la table `core.workspace`.
-
-Il doit toujours être dans la plage de la version `major.minor` de votre instance Twenty actuelle, vous pouvez consulter la version de votre instance dans le panneau d'administration (à l'adresse `/settings/admin-panel`, accessible si votre utilisateur a la propriété `canAccessFullAdminPanel` définie comme vraie dans la base de données) ou en exécutant `echo $APP_VERSION` dans votre conteneur `twenty-server`.
-
-Pour corriger une version d'espace de travail désynchronisée, vous devrez effectuer une mise à niveau à partir de la version correspondante de Twenty en suivant le guide de mise à niveau correspondant séquentiellement, et ainsi de suite jusqu'à atteindre la version souhaitée.
-
-#### Suppression de `auditLog`
-
-Nous avons supprimé l'objet standard auditLog, ce qui signifie que la taille de votre sauvegarde pourrait être considérablement réduite après cette migration.
-
-### v0.51 à v0.52
-
-Mettez à jour votre instance Twenty pour utiliser l'image v0.52
-
-```
-yarn database:migrate:prod
-yarn command:prod upgrade
-```
-
-#### J'ai un espace de travail bloqué dans la version entre `0.52.0` et `0.52.6`
-
-Malheureusement, `0.52.0` et `0.52.6` ont été entièrement supprimés de dockerHub.
-Vous devrez mettre à jour manuellement la version de votre espace de travail à `0.51.0` dans la base de données et mettre à niveau en utilisant la version twenty `0.52.11` en suivant son guide de mise à niveau juste au-dessus.
-
-### v0.50 à v0.51
-
-Mettez à jour votre instance Twenty pour utiliser l'image v0.51
-
-```
-yarn database:migrate:prod
-yarn command:prod upgrade
-```
-
-### v0.44.0 à v0.50.0
-
-Mettez à jour votre instance Twenty pour utiliser l'image v0.50.0
-
-```
-yarn database:migrate:prod
-yarn command:prod upgrade
-```
-
-#### Mutation docker-compose.yml
-
-Cette version inclut une mutation `docker-compose.yml` pour donner au service `worker` accès au volume `server-local-data`.
-Veuillez mettre à jour votre `docker-compose.yml` local avec [docker-compose.yml v0.50.0](https://github.com/twentyhq/twenty/blob/v0.50.0/packages/twenty-docker/docker-compose.yml)
-
-### v0.43.0 à v0.44.0
-
-Mettez à jour votre instance Twenty pour utiliser l'image v0.44.0
-
-```
-yarn database:migrate:prod
-yarn command:prod upgrade
-```
-
-### v0.42.0 à v0.43.0
-
-Mettez à jour votre instance Twenty pour utiliser l'image v0.43.0
-
-```
-yarn database:migrate:prod
-yarn command:prod upgrade
-```
-
-Dans cette version, nous avons également changé pour l'image postgres:16 dans `docker-compose.yml`.
-
-#### (Option 1) Migration de base de données
-
-Conserver l'image postgres-spilo existante est correct, mais vous devrez geler la version dans votre docker-compose.yml à 0.43.0.
-
-#### (Option 2) Migration de base de données
-
-Si vous souhaitez migrer votre base de données vers la nouvelle image postgres:16, suivez ces étapes :
-
-1. Exportez votre base de données depuis l'ancien conteneur postgres-spilo
-
-```
-docker exec -it twenty-db-1 sh
-pg_dump -U {YOUR_POSTGRES_USER} -d {YOUR_POSTGRES_DB} > databases_backup.sql
-exit
-docker cp twenty-db-1:/home/postgres/databases_backup.sql .
-```
-
-Assurez-vous que votre fichier de sauvegarde n'est pas vide.
-
-2. Mettez à jour votre docker-compose.yml pour utiliser l'image postgres:16 comme dans le fichier [docker-compose.yml](https://raw.githubusercontent.com/twentyhq/twenty/main/packages/twenty-docker/docker-compose.yml).
-
-3. Restaurez la base de données vers le nouveau conteneur postgres:16
-
+cat databases_backup.sql | docker exec -i {db_container_name_or_id} psql -U {postgres_user}
```
-docker cp databases_backup.sql twenty-db-1:/databases_backup.sql
-docker exec -it twenty-db-1 sh
-psql -U {YOUR_POSTGRES_USER} -d {YOUR_POSTGRES_DB} -f databases_backup.sql
-exit
-```
-
-### v0.41.0 à v0.42.0
-Mettez à jour votre instance Twenty pour utiliser l'image v0.42.0
+Si vous utilisez Docker Compose, suivez ces étapes :
-```
-yarn database:migrate:prod
-yarn command:prod upgrade-0.42
-```
-
-**Variables d'environnement**
+1. Arrêtez Twenty : `docker compose down`
+2. Modifiez la valeur de `TAG` dans le fichier `.env` situé à côté de votre `docker-compose.yml`
+3. Démarrez Twenty : `docker compose up -d`
-* Supprimé : `FRONT_PORT`, `FRONT_PROTOCOL`, `FRONT_DOMAIN`, `PORT`
-* Ajouté : `FRONTEND_URL`, `NODE_PORT`, `MAX_NUMBER_OF_WORKSPACES_DELETED_PER_EXECUTION`, `MESSAGING_PROVIDER_MICROSOFT_ENABLED`, `CALENDAR_PROVIDER_MICROSOFT_ENABLED`, `IS_MICROSOFT_SYNC_ENABLED`
+Le serveur exécute automatiquement au démarrage toutes les migrations de mise à niveau requises. Aucune commande manuelle n'est nécessaire.
-### v0.40.0 à v0.41.0
+## Mises à niveau entre versions (v1.22+)
-Mettez à jour votre instance Twenty pour utiliser l'image v0.41.0
+À partir de **v1.22**, Twenty prend en charge les mises à niveau entre versions. Vous pouvez passer directement de n'importe quelle version prise en charge à la dernière version sans devoir passer par chaque version intermédiaire.
-```
-yarn database:migrate:prod
-yarn command:prod upgrade-0.41
-```
+Par exemple, la mise à niveau de la v1.22 directement vers la v2.0 est entièrement prise en charge.
-**Variables d'environnement**
+## Mise à niveau vers la v2.5+ — enveloppe de chiffrement au repos
-* Supprimé : `AUTH_MICROSOFT_TENANT_ID`
+À partir de la **v2.5**, Twenty stocke les secrets au repos (jetons OAuth, variables d’application, clés privées de signature, valeurs de configuration sensibles, secrets TOTP) à l’intérieur d’une enveloppe versionnée `enc:v2:` chiffrée avec `ENCRYPTION_KEY` (ou `APP_SECRET` si `ENCRYPTION_KEY` n’est pas défini).
-### v0.35.0 à v0.40.0
+Le premier démarrage sur la v2.5 exécute des commandes de mise à niveau lentes qui **rétro-remplissent** les lignes existantes dans la nouvelle enveloppe. Elles sont idempotentes — si vous interrompez puis redémarrez le serveur, le processus reprend là où il s’était arrêté — mais elles peuvent prendre du temps sur les grandes bases de données. Vous pouvez surveiller la progression avec `upgrade:status`.
-Mettez à jour votre instance Twenty pour utiliser l'image v0.40.0
-
-```
-yarn database:migrate:prod
-yarn command:prod upgrade-0.40
-```
-
-**Variables d'environnement**
-
-* Ajouté : `IS_EMAIL_VERIFICATION_REQUIRED`, `EMAIL_VERIFICATION_TOKEN_EXPIRES_IN`, `WORKFLOW_EXEC_THROTTLE_LIMIT`, `WORKFLOW_EXEC_THROTTLE_TTL`
-
-### v0.34.0 à v0.35.0
-
-Mettez à jour votre instance Twenty pour utiliser l'image v0.35.0
-
-```
-yarn database:migrate:prod
-yarn command:prod upgrade-0.35
-```
-
-La commande `yarn database:migrate:prod` appliquera les migrations à la structure de la base de données (schémas core et metadata)
-La commande `yarn command:prod upgrade-0.35` s'occupe de la migration des données de tous les espaces de travail.
-
-**Variables d'environnement**
-
-* Nous avons remplacé `ENABLE_DB_MIGRATIONS` par `DISABLE_DB_MIGRATIONS` (la valeur par défaut est désormais `false`, vous n'avez probablement rien à paramétrer)
-
-### v0.33.0 à v0.34.0
-
-Mettez à jour votre instance Twenty pour utiliser l'image v0.34.0
-
-```
-yarn database:migrate:prod
-yarn command:prod upgrade-0.34
-```
-
-La commande `yarn database:migrate:prod` appliquera les migrations à la structure de la base de données (schémas core et metadata)
-La commande `yarn command:prod upgrade-0.34` s'occupe de la migration des données de tous les espaces de travail.
-
-**Variables d'environnement**
-
-* Supprimé : `FRONT_BASE_URL`
-* Ajouté : `FRONT_DOMAIN`, `FRONT_PROTOCOL`, `FRONT_PORT`
-
-Nous avons mis à jour notre méthode de gestion des URL frontend.
-Vous pouvez maintenant définir l'URL frontend en utilisant les variables `FRONT_DOMAIN`, `FRONT_PROTOCOL` et `FRONT_PORT`.
-Si FRONT_DOMAIN n'est pas défini, l'URL frontend reviendra à `SERVER_URL`.
-
-### v0.32.0 à v0.33.0
-
-Mettez à jour votre instance Twenty pour utiliser l'image v0.33.0
-
-```
-yarn command:prod cache:flush
-yarn database:migrate:prod
-yarn command:prod upgrade-0.33
-```
+Vous devez définir une `ENCRYPTION_KEY` dédiée **avant** la mise à niveau vers la v2.5 afin que le rétro-remplissage écrive les lignes sous cette clé dès le départ. Changer de clé après le rétro-remplissage nécessite une [rotation](/l/fr/developers/self-host/capabilities/key-rotation).
-La commande `yarn command:prod cache:flush` videra le cache Redis.
-La commande `yarn database:migrate:prod` appliquera les migrations à la structure de la base de données (schémas core et metadata)
-La commande `yarn command:prod upgrade-0.33` s'occupe de la migration des données de tous les espaces de travail.
+## Rotation des secrets et des clés de signature
-À partir de cette version, l'image twenty-postgres pour la DB est devenue obsolète et twenty-postgres-spilo est utilisé à la place.
-Si vous souhaitez continuer à utiliser l'image twenty-postgres, remplacez simplement `twentycrm/twenty-postgres:${TAG}` par `twentycrm/twenty-postgres` dans docker-compose.yml.
+Pour les tâches opérationnelles quotidiennes comme la rotation de `ENCRYPTION_KEY`, la rotation de la clé de signature JWT ou la révocation d’une clé de signature divulguée, consultez le [Guide de rotation des clés](/l/fr/developers/self-host/capabilities/key-rotation) dédié.
-### v0.31.0 à v0.32.0
+## Vérification de l'état de la mise à niveau
-Mettez à jour votre instance Twenty pour utiliser l'image v0.32.0
+La commande `upgrade:status` vous permet d'inspecter l'état actuel de votre instance et des migrations d'espaces de travail. Elle est utile pour diagnostiquer les problèmes de mise à niveau ou lors de la création d'une demande d'assistance.
-**Migration de schéma et de données**
+Exécutez-la depuis le conteneur du serveur :
-```
-yarn database:migrate:prod
-yarn command:prod upgrade-0.32
-```
-
-La commande `yarn database:migrate:prod` appliquera les migrations à la structure de la base de données (schémas core et metadata)
-La commande `yarn command:prod upgrade-0.32` s'occupe de la migration des données de tous les espaces de travail.
-
-**Variables d'environnement**
-
-Nous avons mis à jour notre méthode de gestion de la connexion Redis.
-
-* Supprimé : `REDIS_HOST`, `REDIS_PORT`, `REDIS_USERNAME`, `REDIS_PASSWORD`
-* Ajouté : `REDIS_URL`
-
-Mettez à jour votre fichier `.env` pour utiliser la nouvelle variable `REDIS_URL` au lieu des paramètres de connexion Redis individuels.
-
-Nous avons également simplifié notre méthode de gestion des tokens JWT.
-
-* Supprimé : `ACCESS_TOKEN_SECRET`, `LOGIN_TOKEN_SECRET`, `REFRESH_TOKEN_SECRET`, `FILE_TOKEN_SECRET`
-* Ajouté : `APP_SECRET`
-
-Mettez à jour votre fichier `.env` pour utiliser la nouvelle variable `APP_SECRET` à la place des secrets de tokens individuels (vous pouvez utiliser le même secret qu'avant ou générer une nouvelle chaîne aléatoire).
-
-**Compte connecté**
-
-Si vous utilisez un compte connecté pour synchroniser vos emails et calendriers Google, vous devrez activer l'API des personnes sur votre console d'administration Google.
-
-### v0.30.0 à v0.31.0
-
-Mettez à jour votre instance Twenty pour utiliser l'image v0.31.0
-
-**Migration de schéma et de données :**
-
-```
-yarn database:migrate:prod
-yarn command:prod upgrade-0.31
+```bash
+docker exec -it {server_container_name_or_id} yarn command:prod upgrade:status
```
-La commande `yarn database:migrate:prod` appliquera les migrations à la structure de la base de données (schémas core et metadata)
-La commande `yarn command:prod upgrade-0.31` s'occupe de la migration des données de tous les espaces de travail.
+Exemple de résultat:
-### v0.24.0 à v0.30.0
+```sh
+APP_VERSION: v1.23.0
-Mettez à jour votre instance Twenty pour utiliser l'image v0.30.0
+Instance
+ Inferred version: 1.23.0
+ Latest command: 1.23.0_DropWorkspaceVersionColumnFastInstanceCommand_1785000000000
+ Status: Up to date
+ Executed by: v1.23.0
+ At: 2026-04-16T11:43:58.823Z
-**Changement significatif**:
-Pour améliorer les performances, Twenty nécessite désormais la configuration de cache redis. Nous avons mis à jour notre [docker-compose.yml](https://raw.githubusercontent.com/twentyhq/twenty/main/packages/twenty-docker/docker-compose.yml) pour refléter cela.
-Assurez-vous de mettre à jour votre configuration et vos variables d'environnement en conséquence :
+Workspace
+ Apple (20202020-1c25-4d02-bf25-6aeccf7ea419)
+ Inferred version: 1.23.0
+ Latest command: 1.23.0_UpdateGlobalObjectContextCommandMenuItemsCommand_1780000005000
+ Status: Up to date
+ Executed by: v1.23.0
+ At: 2026-04-16T11:44:09.361Z
+Summary
+ Instance: Up to date
+ Workspaces: 1 up to date, 0 behind, 0 failed (1 total)
```
-REDIS_HOST={your-redis-host}
-REDIS_PORT={your-redis-port}
-CACHE_STORAGE_TYPE=redis
-```
-
-**Migration de schéma et de données :**
-
-```
-yarn database:migrate:prod
-yarn command:prod upgrade-0.30
-```
-
-La commande `yarn database:migrate:prod` appliquera les migrations à la structure de la base de données (schémas core et metadata)
-La commande `yarn command:prod upgrade-0.30` s'occupe de la migration des données de tous les espaces de travail.
-
-### v0.23.0 à v0.24.0
-
-Mettez à jour votre instance Twenty pour utiliser l'image v0.24.0
-
-Exécutez les commandes suivantes :
-```
-yarn database:migrate:prod
-yarn command:prod upgrade-0.24
-```
+### Options
-La commande `yarn database:migrate:prod` appliquera les migrations à la structure de la base de données (schémas core et metadata)
-La commande `yarn command:prod upgrade-0.24` s'occupe de la migration des données de tous les espaces de travail.
+| Option | Description |
+| ------------------------- | --------------------------------------------------------------------------------- |
+| `-w, --workspace-id <id>` | Limiter à un espace de travail spécifique. Peut être passé plusieurs fois. |
+| `-f, --failed-only` | Masquez les espaces de travail à jour, n'affichez que ceux en retard et en échec. |
-### v0.22.0 à v0.23.0
+## Résolution des problèmes
-Mettez à jour votre instance Twenty pour utiliser l'image v0.23.0
+Si la mise à niveau échoue sur certains espaces de travail, le serveur ne dépassera pas l'étape en échec. Le redémarrage du serveur (`docker compose up -d`) relancera la mise à niveau à partir de l'endroit où elle s'est arrêtée.
-Exécutez les commandes suivantes :
+Pour identifier rapidement les problèmes, exécutez :
+```bash
+docker exec -it {server_container_name_or_id} yarn command:prod upgrade:status --failed-only
```
-yarn database:migrate:prod
-yarn command:prod upgrade-0.23
-```
-
-La commande `yarn database:migrate:prod` appliquera les migrations à la base de données.
-La commande `yarn command:prod upgrade-0.23` s'occupe de la migration des données, y compris le transfert des activités vers les tâches/notes.
-### v0.21.0 à v0.22.0
+Cela affiche uniquement les espaces de travail en retard ou en échec, ainsi que le message d'erreur pour chaque échec.
-Mettez à jour votre instance Twenty pour utiliser l'image v0.22.0
-
-Exécutez les commandes suivantes :
-
-```
-yarn database:migrate:prod
-yarn command:prod upgrade-0.22
-```
+## Avant la v1.22
-La commande `yarn database:migrate:prod` appliquera les migrations à la base de données.
-La commande `yarn command:prod upgrade-0.22` appliquera des transformations de données spécifiques pour s’adapter aux nouvelles `defaultRequestInstrumentationOptions` d’objet.
+Si votre instance est antérieure à la v1.22, vous devez effectuer une mise à niveau progressive à travers chaque version majeure marquée (de v1.6 à v1.7, puis de v1.7 à v1.8, et ainsi de suite) jusqu'à atteindre la v1.22. À partir de là, vous pouvez passer directement à la dernière version.
diff --git a/packages/twenty-docs/l/fr/navigation.json b/packages/twenty-docs/l/fr/navigation.json
index ae6dd925013..cb5907ec8e5 100644
--- a/packages/twenty-docs/l/fr/navigation.json
+++ b/packages/twenty-docs/l/fr/navigation.json
@@ -1,24 +1,27 @@
{
"tabs": {
+ "gettingStarted": {
+ "label": "Prise en main",
+ "groups": {
+ "welcome": {
+ "label": "Bienvenue"
+ },
+ "coreConcepts": {
+ "label": "Concepts clés"
+ }
+ }
+ },
"userGuide": {
"label": "Guide de l'utilisateur",
"groups": {
- "discoverTwenty": {
- "label": "Découvrez Twenty",
- "groups": {
- "gettingStartedCapabilities": {
- "label": "Capacités"
- },
- "gettingStartedHowTos": {
- "label": "Guides pratiques"
- }
- }
+ "userGuideOverview": {
+ "label": "Vue d'ensemble"
},
"dataModel": {
"label": "Modèle de données",
"groups": {
- "dataModelCapabilities": {
- "label": "Capacités"
+ "dataModelReference": {
+ "label": "Référence"
},
"dataModelHowTos": {
"label": "Guides pratiques"
@@ -28,8 +31,8 @@
"dataMigration": {
"label": "Migration de données",
"groups": {
- "dataMigrationCapabilities": {
- "label": "Capacités"
+ "dataMigrationReference": {
+ "label": "Référence"
},
"dataMigrationHowTos": {
"label": "Guides pratiques"
@@ -39,8 +42,8 @@
"calendarEmails": {
"label": "Calendrier et e-mails",
"groups": {
- "calendarEmailsCapabilities": {
- "label": "Capacités"
+ "calendarEmailsReference": {
+ "label": "Référence"
},
"calendarEmailsHowTos": {
"label": "Guides pratiques"
@@ -50,8 +53,8 @@
"workflows": {
"label": "Flux de travail",
"groups": {
- "workflowsCapabilities": {
- "label": "Capacités"
+ "workflowsReference": {
+ "label": "Référence"
},
"workflowsHowTos": {
"label": "Guides pratiques",
@@ -75,21 +78,26 @@
"ai": {
"label": "IA",
"groups": {
- "aiCapabilities": {
- "label": "Capacités"
+ "aiReference": {
+ "label": "Référence"
},
"aiHowTos": {
"label": "Guides pratiques"
}
}
},
- "viewsPipelines": {
- "label": "Vues et pipelines",
+ "layout": {
+ "label": "Disposition",
"groups": {
- "viewsPipelinesCapabilities": {
- "label": "Capacités"
+ "layoutReference": {
+ "label": "Référence",
+ "groups": {
+ "layoutViews": {
+ "label": "Vues"
+ }
+ }
},
- "viewsPipelinesHowTos": {
+ "layoutHowTos": {
"label": "Guides pratiques"
}
}
@@ -97,8 +105,8 @@
"dashboards": {
"label": "Tableaux de bord",
"groups": {
- "dashboardsCapabilities": {
- "label": "Capacités"
+ "dashboardsReference": {
+ "label": "Référence"
},
"dashboardsHowTos": {
"label": "Guides pratiques"
@@ -108,8 +116,8 @@
"permissionsAccess": {
"label": "Autorisations et accès",
"groups": {
- "permissionsAccessCapabilities": {
- "label": "Capacités"
+ "permissionsAccessReference": {
+ "label": "Référence"
},
"permissionsAccessHowTos": {
"label": "Guides pratiques"
@@ -119,8 +127,8 @@
"billing": {
"label": "Facturation",
"groups": {
- "billingCapabilities": {
- "label": "Capacités"
+ "billingReference": {
+ "label": "Référence"
},
"billingHowTos": {
"label": "Guides pratiques"
@@ -130,8 +138,8 @@
"settings": {
"label": "Paramètres",
"groups": {
- "settingsCapabilities": {
- "label": "Capacités"
+ "settingsReference": {
+ "label": "Référence"
},
"settingsHowTos": {
"label": "Guides pratiques"
@@ -143,59 +151,40 @@
"developers": {
"label": "Développeurs",
"groups": {
- "developersGroup": {
- "label": "Développeurs"
+ "developersOverview": {
+ "label": "Vue d'ensemble"
},
- "extend": {
- "label": "Étendre",
+ "apps": {
+ "label": "Applications",
"groups": {
- "extendCapabilities": {
- "label": "Capacités"
+ "appsGettingStarted": {
+ "label": "Prise en main"
+ },
+ "appsConfig": {
+ "label": "Configuration"
+ },
+ "appsData": {
+ "label": "Données"
+ },
+ "appsLogic": {
+ "label": "Logique"
+ },
+ "appsLayout": {
+ "label": "Disposition"
+ },
+ "appsOperations": {
+ "label": "Opérations"
}
}
},
+ "api": {
+ "label": "API"
+ },
"selfHost": {
- "label": "Auto-hébergement",
- "groups": {
- "selfHostCapabilities": {
- "label": "Capacités"
- }
- }
+ "label": "Auto-hébergement"
},
"contribute": {
- "label": "Contribuer",
- "groups": {
- "contributeCapabilities": {
- "label": "Capacités",
- "groups": {
- "frontendDevelopment": {
- "label": "Développement frontend",
- "groups": {
- "twentyUi": {
- "label": "Twenty UI",
- "groups": {
- "display": {
- "label": "Afficher"
- },
- "feedback": {
- "label": "Retour d'information"
- },
- "input": {
- "label": "Entrée "
- },
- "navigation": {
- "label": "Navigation"
- }
- }
- }
- }
- },
- "backendDevelopment": {
- "label": "Développement backend"
- }
- }
- }
- }
+ "label": "Contribuer"
}
}
}
diff --git a/packages/twenty-docs/l/fr/twenty-ui/display/app-tooltip.mdx b/packages/twenty-docs/l/fr/twenty-ui/display/app-tooltip.mdx
index 475481f3f1e..0b80800a7f9 100644
--- a/packages/twenty-docs/l/fr/twenty-ui/display/app-tooltip.mdx
+++ b/packages/twenty-docs/l/fr/twenty-ui/display/app-tooltip.mdx
@@ -1,5 +1,6 @@
---
title: Info-bulle de l'application
+icon: message
---
<Frame>
@@ -9,46 +10,54 @@ title: Info-bulle de l'application
Un message bref qui affiche des informations supplémentaires lorsqu'un utilisateur interagit avec un élément.
<Tabs>
- <Tab title="Utilisation">
- ```jsx
- import { AppTooltip } from "@/ui/display/tooltip/AppTooltip";
-
- export const MyComponent = () => {
- return (
- <>
- <p id="hoverText" style={{ display: "inline-block" }}>
- Customer Insights
- </p>
- <AppTooltip
- className
- anchorSelect="#hoverText"
- content="Explore customer behavior and preferences"
- delayHide={0}
- offset={6}
- noArrow={false}
- isOpen={true}
- place="bottom"
- positionStrategy="absolute"
- />
- </>
- );
- };
- ```
- </Tab>
-
- <Tab title="Propriétés">
- | Propriétés | Type | Description |
- | ----------------------- | -------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
- | nomDeClasse | chaîne | Classe CSS facultative pour le style supplémentaire |
- | sélecteurAncre | Sélecteur CSS | Sélecteur pour l'ancre de l'info-bulle (l'élément qui déclenche l'info-bulle) |
- | contenu | chaîne | Le contenu que vous souhaitez afficher dans l'info-bulle |
- | délaiMasquer | nombre | Le délai avant de masquer l'info-bulle après que le curseur ait quitté l'ancre |
- | décalage | nombre | Le décalage en pixels pour positionner l'info-bulle |
- | pasDeFlèche | booléen | Si `vrai`, masque la flèche sur l'info-bulle |
- | estOuvert | booléen | Si `vrai`, l'info-bulle est ouverte par défaut |
- | emplacement | Chaîne `PlacesType` de `react-tooltip` | Spécifie le placement de l'info-bulle. Les valeurs incluent `bottom`, `left`, `right`, `top`, `top-start`, `top-end`, `right-start`, `right-end`, `bottom-start`, `bottom-end`, `left-start`, et `left-end` |
- | stratégiePositionnement | Chaîne `PositionStrategy` de `react-tooltip` | Stratégie de positionnement pour l'info-bulle. A deux valeurs : `absolute` et `fixed` |
- </Tab>
+<Tab title="Utilisation">
+
+```jsx
+import { AppTooltip } from "@/ui/display/tooltip/AppTooltip";
+
+export const MyComponent = () => {
+ return (
+ <>
+ <p id="hoverText" style={{ display: "inline-block" }}>
+ Customer Insights
+ </p>
+ <AppTooltip
+ className
+ anchorSelect="#hoverText"
+ content="Explore customer behavior and preferences"
+ delayHide={0}
+ offset={6}
+ noArrow={false}
+ isOpen={true}
+ place="bottom"
+ positionStrategy="absolute"
+ />
+ </>
+ );
+};
+```
+
+</Tab>
+
+<Tab title="Propriétés">
+
+
+| Propriétés | Type | Description |
+| ----------------------- | -------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| nomDeClasse | chaîne | Classe CSS facultative pour le style supplémentaire |
+| sélecteurAncre | Sélecteur CSS | Sélecteur pour l'ancre de l'info-bulle (l'élément qui déclenche l'info-bulle) |
+| contenu | chaîne | Le contenu que vous souhaitez afficher dans l'info-bulle |
+| délaiMasquer | nombre | Le délai avant de masquer l'info-bulle après que le curseur ait quitté l'ancre |
+| décalage | nombre | Le décalage en pixels pour positionner l'info-bulle |
+| pasDeFlèche | booléen | Si `vrai`, masque la flèche sur l'info-bulle |
+| estOuvert | booléen | Si `vrai`, l'info-bulle est ouverte par défaut |
+| emplacement | Chaîne `PlacesType` de `react-tooltip` | Spécifie le placement de l'info-bulle. Les valeurs incluent `bottom`, `left`, `right`, `top`, `top-start`, `top-end`, `right-start`, `right-end`, `bottom-start`, `bottom-end`, `left-start`, et `left-end` |
+| stratégiePositionnement | Chaîne `PositionStrategy` de `react-tooltip` | Stratégie de positionnement pour l'info-bulle. A deux valeurs : `absolute` et `fixed` |
+
+
+
+</Tab>
+
</Tabs>
## Texte débordant avec info-bulle
@@ -56,22 +65,30 @@ Un message bref qui affiche des informations supplémentaires lorsqu'un utilisat
Gère le texte débordant et affiche une info-bulle lorsque le texte déborde.
<Tabs>
- <Tab title="Utilisation">
- ```jsx
- import { OverflowingTextWithTooltip } from 'twenty-ui/display';
-
- export const MyComponent = () => {
- const crmTaskDescription =
- 'Follow up with client regarding their recent product inquiry. Discuss pricing options, address any concerns, and provide additional product information. Record the details of the conversation in the CRM for future reference.';
-
- return <OverflowingTextWithTooltip text={crmTaskDescription} />;
- };
- ```
- </Tab>
-
- <Tab title="Propriétés">
- | Propriétés | Type | Description |
- | ---------- | ------ | ----------------------------------------------------------------------- |
- | texte | chaîne | Le contenu que vous souhaitez afficher dans la zone de texte débordante |
- </Tab>
+<Tab title="Utilisation">
+
+```jsx
+import { OverflowingTextWithTooltip } from 'twenty-ui/display';
+
+export const MyComponent = () => {
+ const crmTaskDescription =
+ 'Follow up with client regarding their recent product inquiry. Discuss pricing options, address any concerns, and provide additional product information. Record the details of the conversation in the CRM for future reference.';
+
+ return <OverflowingTextWithTooltip text={crmTaskDescription} />;
+};
+```
+
+</Tab>
+
+<Tab title="Propriétés">
+
+
+| Propriétés | Type | Description |
+| ---------- | ------ | ----------------------------------------------------------------------- |
+| texte | chaîne | Le contenu que vous souhaitez afficher dans la zone de texte débordante |
+
+
+
+</Tab>
+
</Tabs>
diff --git a/packages/twenty-docs/l/fr/twenty-ui/display/checkmark.mdx b/packages/twenty-docs/l/fr/twenty-ui/display/checkmark.mdx
index 7717880ae93..a04320d95b5 100644
--- a/packages/twenty-docs/l/fr/twenty-ui/display/checkmark.mdx
+++ b/packages/twenty-docs/l/fr/twenty-ui/display/checkmark.mdx
@@ -1,5 +1,6 @@
---
title: Coche
+icon: circle-check
---
<Frame>
@@ -9,19 +10,25 @@ title: Coche
Représente une action réussie ou complétée.
<Tabs>
- <Tab title="Utilisation">
- ```jsx
- import { Checkmark } from 'twenty-ui/display';
-
- export const MyComponent = () => {
- return <Checkmark />;
- };
- ```
- </Tab>
-
- <Tab title="Propriétés">
- Étend `React.ComponentPropsWithoutRef<'div'>` et accepte tous les props d'un élément `div` normal.
- </Tab>
+<Tab title="Utilisation">
+
+```jsx
+import { Checkmark } from 'twenty-ui/display';
+
+export const MyComponent = () => {
+ return <Checkmark />;
+};
+```
+
+
+</Tab>
+
+<Tab title="Propriétés">
+
+Étend `React.ComponentPropsWithoutRef<'div'>` et accepte tous les props d'un élément `div` normal.
+
+</Tab>
+
</Tabs>
## Coche animée
@@ -29,29 +36,38 @@ Représente une action réussie ou complétée.
Représente une icône de coche avec la fonctionnalité d'animation ajoutée.
<Tabs>
- <Tab title="Utilisation">
- ```jsx
- import { AnimatedCheckmark } from 'twenty-ui/display';
-
- export const MyComponent = () => {
- return (
- <AnimatedCheckmark
- isAnimating={true}
- color="green"
- duration={0.5}
- size={30}
- />
- );
- };
- ```
- </Tab>
-
- <Tab title="Propriétés">
- | Propriétés | Type | Description | Par défaut |
- | -------------------- | ------- | ----------------------------------- | ------------ |
- | En cours d'animation | booléen | Contrôle si la coche est animée | faux |
- | couleur | chaîne | Couleur de la coche | |
- | durée | nombre | La durée de l'animation en secondes | 0,5 secondes |
- | taille | nombre | La taille de la coche | 28 pixels |
- </Tab>
+
+<Tab title="Utilisation">
+
+```jsx
+import { AnimatedCheckmark } from 'twenty-ui/display';
+
+export const MyComponent = () => {
+ return (
+ <AnimatedCheckmark
+ isAnimating={true}
+ color="green"
+ duration={0.5}
+ size={30}
+ />
+ );
+};
+```
+
+</Tab>
+
+<Tab title="Propriétés">
+
+
+| Propriétés | Type | Description | Par défaut |
+| -------------------- | ------- | ----------------------------------- | ------------ |
+| En cours d'animation | booléen | Contrôle si la coche est animée | faux |
+| couleur | chaîne | Couleur de la coche | |
+| durée | nombre | La durée de l'animation en secondes | 0,5 secondes |
+| taille | nombre | La taille de la coche | 28 pixels |
+
+
+
+</Tab>
+
</Tabs>
diff --git a/packages/twenty-docs/l/fr/twenty-ui/display/chip.mdx b/packages/twenty-docs/l/fr/twenty-ui/display/chip.mdx
index b93ae042dd6..6ab182330f8 100644
--- a/packages/twenty-docs/l/fr/twenty-ui/display/chip.mdx
+++ b/packages/twenty-docs/l/fr/twenty-ui/display/chip.mdx
@@ -9,40 +9,48 @@ title: Puce
Un élément visuel que vous pouvez utiliser comme un conteneur cliquable ou non cliquable avec une étiquette, des composants optionnels à gauche et à droite, et diverses options de style pour afficher des étiquettes et des tags.
<Tabs>
- <Tab title="Utilisation">
- ```jsx
- import { Chip } from 'twenty-ui/components';
-
- export const MyComponent = () => {
- return (
- <Chip
- size="large"
- label="Puce cliquable"
- clickable={true}
- variant="highlighted"
- accent="text-primary"
- leftComponent
- rightComponent
- maxWidth="200px"
- className
- />
- );
- };
-
- ```
- </Tab>
-
- <Tab title="Propriétés">
- | Propriétés | Type | Description |
- | ------------ | ------------------------ | ---------------------------------------------------------------------------------------------------------- |
- | linkToEntity | chaîne | Le lien vers l'entité |
- | entityId | chaîne | L'identifiant unique pour l'entité |
- | nom | chaîne | Le nom de l'entité |
- | pictureUrl | chaîne | Image", |
- | avatarType | Type d'avatar | Le type d'avatar que vous souhaitez afficher. Comporte deux options : `rounded` et `squared` |
- | variante | `EntityChipVariant` enum | Variante de la puce entité que vous souhaitez afficher. Comporte deux options : `regular` et `transparent` |
- | LeftIcon | ComposantIcône | Un composant React représentant une icône. Affiché sur le côté gauche de la puce |
- </Tab>
+
+<Tab title="Utilisation">
+
+```jsx
+import { Chip } from 'twenty-ui/components';
+
+export const MyComponent = () => {
+ return (
+ <Chip
+ size="large"
+ label="Puce cliquable"
+ clickable={true}
+ variant="highlighted"
+ accent="text-primary"
+ leftComponent
+ rightComponent
+ maxWidth="200px"
+ className
+ />
+ );
+};
+
+```
+
+</Tab>
+
+<Tab title="Propriétés">
+
+
+| Propriétés | Type | Description |
+| ------------ | ------------------------ | ---------------------------------------------------------------------------------------------------------- |
+| linkToEntity | chaîne | Le lien vers l'entité |
+| entityId | chaîne | L'identifiant unique pour l'entité |
+| nom | chaîne | Le nom de l'entité |
+| pictureUrl | chaîne | Image", |
+| avatarType | Type d'avatar | Le type d'avatar que vous souhaitez afficher. Comporte deux options : `rounded` et `squared` |
+| variante | `EntityChipVariant` enum | Variante de la puce entité que vous souhaitez afficher. Comporte deux options : `regular` et `transparent` |
+| LeftIcon | ComposantIcône | Un composant React représentant une icône. Affiché sur le côté gauche de la puce |
+
+
+
+</Tab>
</Tabs>
## Exemples
@@ -99,39 +107,47 @@ export const MyComponent = () => {
Un élément semblable à une puce pour afficher des informations sur une entité.
<Tabs>
- <Tab title="Utilisation">
- ```jsx
- import { BrowserRouter as Router } from 'react-router-dom';
- import { IconTwentyStar } from 'twenty-ui/display';
- import { Chip } from 'twenty-ui/components';
-
- export const MyComponent = () => {
- return (
- <Router>
- <Chip
- linkToEntity="/entity-link"
- entityId="entityTest"
- name="Nom de l'entité"
- pictureUrl=""
- avatarType="rounded"
- variant="regular"
- LeftIcon={IconTwentyStar}
- />
- </Router>
- );
- };
- ```
- </Tab>
-
- <Tab title="Propriétés">
- | Propriétés | Type | Description |
- | ------------ | ------------------------ | ---------------------------------------------------------------------------------------------------------- |
- | linkToEntity | chaîne | Le lien vers l'entité |
- | entityId | chaîne | L'identifiant unique pour l'entité |
- | nom | chaîne | Le nom de l'entité |
- | pictureUrl | chaîne | Image", |
- | avatarType | Type d'avatar | Le type d'avatar que vous souhaitez afficher. Comporte deux options : `rounded` et `squared` |
- | variante | `EntityChipVariant` enum | Variante de la puce entité que vous souhaitez afficher. Comporte deux options : `regular` et `transparent` |
- | LeftIcon | ComposantIcône | Un composant React représentant une icône. Affiché sur le côté gauche de la puce |
- </Tab>
+
+<Tab title="Utilisation">
+
+```jsx
+import { BrowserRouter as Router } from 'react-router-dom';
+import { IconTwentyStar } from 'twenty-ui/display';
+import { Chip } from 'twenty-ui/components';
+
+export const MyComponent = () => {
+ return (
+ <Router>
+ <Chip
+ linkToEntity="/entity-link"
+ entityId="entityTest"
+ name="Nom de l'entité"
+ pictureUrl=""
+ avatarType="rounded"
+ variant="regular"
+ LeftIcon={IconTwentyStar}
+ />
+ </Router>
+ );
+};
+```
+
+</Tab>
+
+<Tab title="Propriétés">
+
+
+| Propriétés | Type | Description |
+| ------------ | ------------------------ | ---------------------------------------------------------------------------------------------------------- |
+| linkToEntity | chaîne | Le lien vers l'entité |
+| entityId | chaîne | L'identifiant unique pour l'entité |
+| nom | chaîne | Le nom de l'entité |
+| pictureUrl | chaîne | Image", |
+| avatarType | Type d'avatar | Le type d'avatar que vous souhaitez afficher. Comporte deux options : `rounded` et `squared` |
+| variante | `EntityChipVariant` enum | Variante de la puce entité que vous souhaitez afficher. Comporte deux options : `regular` et `transparent` |
+| LeftIcon | ComposantIcône | Un composant React représentant une icône. Affiché sur le côté gauche de la puce |
+
+
+
+</Tab>
</Tabs>
diff --git a/packages/twenty-docs/l/fr/twenty-ui/display/icons.mdx b/packages/twenty-docs/l/fr/twenty-ui/display/icons.mdx
index 01ec7ce7455..110325a3d52 100644
--- a/packages/twenty-docs/l/fr/twenty-ui/display/icons.mdx
+++ b/packages/twenty-docs/l/fr/twenty-ui/display/icons.mdx
@@ -1,5 +1,6 @@
---
title: Icônes
+icon: icônes
---
<Frame>
@@ -13,35 +14,44 @@ Une liste d'icônes utilisées dans notre application.
Nous utilisons les icônes Tabler pour React dans toute l'application.
<Tabs>
- <Tab title="Installation">
- <br />
-
- ```
- yarn add @tabler/icons-react
- ```
- </Tab>
-
- <Tab title="Propriétés">
- Vous pouvez importer chaque icône en tant que composant. Voici un exemple :
-
- <br />
-
- ```jsx
- import { IconArrowLeft } from "@tabler/icons-react";
-
- export const MonComposant = () => {
- return <IconArrowLeft color="red" size={48} />;
- };
- ```
- </Tab>
-
- <Tab title="Propriétés">
- | Propriétés | Type | Description | Par défaut |
- | ---------- | ------ | --------------------------------------------- | --------------- |
- | taille | nombre | La hauteur et la largeur de l'icône en pixels | 24 |
- | couleur | chaîne | La couleur des icônes | couleurCourante |
- | trait | nombre | La largeur du trait de l'icône en pixels | 2 |
- </Tab>
+
+<Tab title="Installation">
+<br />
+
+```
+yarn add @tabler/icons-react
+```
+
+</Tab>
+
+<Tab title="Propriétés">
+
+Vous pouvez importer chaque icône en tant que composant. Voici un exemple :
+<br />
+
+```jsx
+import { IconArrowLeft } from "@tabler/icons-react";
+
+export const MonComposant = () => {
+ return <IconArrowLeft color="red" size={48} />;
+};
+```
+
+</Tab>
+
+<Tab title="Propriétés">
+
+
+| Propriétés | Type | Description | Par défaut |
+| ---------- | ------ | --------------------------------------------- | --------------- |
+| taille | nombre | La hauteur et la largeur de l'icône en pixels | 24 |
+| couleur | chaîne | La couleur des icônes | couleurCourante |
+| trait | nombre | La largeur du trait de l'icône en pixels | 2 |
+
+
+
+</Tab>
+
</Tabs>
## Icônes personnalisées
@@ -53,20 +63,29 @@ En plus des icônes Tabler, l'application utilise également certaines icônes p
Affiche une icône de carnet d'adresses.
<Tabs>
- <Tab title="Utilisation">
- ```jsx
- import { IconAddressBook } from 'twenty-ui/display';
-
- export const MonComposant = () => {
- return <IconAddressBook size={24} stroke={2} />;
- };
- ```
- </Tab>
-
- <Tab title="Propriétés">
- | Propriétés | Type | Description | Par défaut |
- | ---------- | ------ | --------------------------------------------- | ---------- |
- | taille | nombre | La hauteur et la largeur de l'icône en pixels | 24 |
- | trait | nombre | La largeur du trait de l'icône en pixels | 2 |
- </Tab>
+
+<Tab title="Utilisation">
+
+```jsx
+import { IconAddressBook } from 'twenty-ui/display';
+
+export const MonComposant = () => {
+ return <IconAddressBook size={24} stroke={2} />;
+};
+```
+
+</Tab>
+
+<Tab title="Propriétés">
+
+
+| Propriétés | Type | Description | Par défaut |
+| ---------- | ------ | --------------------------------------------- | ---------- |
+| taille | nombre | La hauteur et la largeur de l'icône en pixels | 24 |
+| trait | nombre | La largeur du trait de l'icône en pixels | 2 |
+
+
+
+</Tab>
+
</Tabs>
diff --git a/packages/twenty-docs/l/fr/twenty-ui/display/soon-pill.mdx b/packages/twenty-docs/l/fr/twenty-ui/display/soon-pill.mdx
index 2dab33ff9a9..2390daa6ae6 100644
--- a/packages/twenty-docs/l/fr/twenty-ui/display/soon-pill.mdx
+++ b/packages/twenty-docs/l/fr/twenty-ui/display/soon-pill.mdx
@@ -2,7 +2,6 @@
title: Pastille Bientôt
---
-
Un petit badge ou "pilule" pour indiquer que quelque chose arrive bientôt.
```jsx
diff --git a/packages/twenty-docs/l/fr/twenty-ui/display/tag.mdx b/packages/twenty-docs/l/fr/twenty-ui/display/tag.mdx
index c2bceb135db..87370160c47 100644
--- a/packages/twenty-docs/l/fr/twenty-ui/display/tag.mdx
+++ b/packages/twenty-docs/l/fr/twenty-ui/display/tag.mdx
@@ -1,34 +1,43 @@
---
title: Étiquette
+icon: étiquette
---
-
Composant permettant de catégoriser ou d'étiqueter visuellement le contenu.
<Tabs>
- <Tab title="Utilisation">
- ```jsx
- import { Tag } from "@/ui/display/tag/components/Tag";
-
- export const MyComponent = () => {
- return (
- <Tag
- className
- color="red"
- text="Urgent"
- onClick={() => console.log("click")}
- />
- );
- };
- ```
- </Tab>
-
- <Tab title="Propriétés">
- | Propriétés | Type | Description |
- | ----------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------- |
- | nomDeClasse | chaîne | Nom facultatif pour un style supplémentaire |
- | couleur | chaîne | Couleur de l'étiquette. Les options incluent: `vert`, `turquoise`, `ciel`, `bleu`, `violet`, `rose`, `rouge`, `orange`, `jaune`, `gris` |
- | texte | chaîne | Le contenu de l'étiquette |
- | onClick | fonction | Fonction facultative appelée lorsque l'utilisateur clique sur l'étiquette |
- </Tab>
+
+<Tab title="Utilisation">
+
+```jsx
+import { Tag } from "@/ui/display/tag/components/Tag";
+
+export const MyComponent = () => {
+ return (
+ <Tag
+ className
+ color="red"
+ text="Urgent"
+ onClick={() => console.log("click")}
+ />
+ );
+};
+```
+
+</Tab>
+
+<Tab title="Propriétés">
+
+
+| Propriétés | Type | Description |
+| ----------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------- |
+| nomDeClasse | chaîne | Nom facultatif pour un style supplémentaire |
+| couleur | chaîne | Couleur de l'étiquette. Les options incluent: `vert`, `turquoise`, `ciel`, `bleu`, `violet`, `rose`, `rouge`, `orange`, `jaune`, `gris` |
+| texte | chaîne | Le contenu de l'étiquette |
+| onClick | fonction | Fonction facultative appelée lorsque l'utilisateur clique sur l'étiquette |
+
+
+
+</Tab>
+
</Tabs>
diff --git a/packages/twenty-docs/l/fr/twenty-ui/input/block-editor.mdx b/packages/twenty-docs/l/fr/twenty-ui/input/block-editor.mdx
index eef7860fe06..b3cfb2bdc2d 100644
--- a/packages/twenty-docs/l/fr/twenty-ui/input/block-editor.mdx
+++ b/packages/twenty-docs/l/fr/twenty-ui/input/block-editor.mdx
@@ -9,22 +9,28 @@ title: Éditeur de Blocs
Utilise un éditeur de texte riche basé sur des blocs de [BlockNote](https://www.blocknotejs.org/) pour permettre aux utilisateurs de modifier et de visualiser des blocs de contenu.
<Tabs>
- <Tab title="Utilisation">
- ```jsx
- import { useBlockNote } from "@blocknote/react";
- import { BlockEditor } from "@/ui/input/editor/components/BlockEditor";
-
- export const MyComponent = () => {
- const BlockNoteEditor = useBlockNote();
-
- return <BlockEditor editor={BlockNoteEditor} />;
- };
- ```
- </Tab>
-
- <Tab title="Propriétés">
- | Propriétés | Type | Description |
- | ---------- | ----------------- | ---------------------------------------------------- |
- | éditeur | `BlockNoteEditor` | L'instance de l'éditeur de blocs ou sa configuration |
- </Tab>
+<Tab title="Utilisation">
+
+```jsx
+import { useBlockNote } from "@blocknote/react";
+import { BlockEditor } from "@/ui/input/editor/components/BlockEditor";
+
+export const MyComponent = () => {
+ const BlockNoteEditor = useBlockNote();
+
+ return <BlockEditor editor={BlockNoteEditor} />;
+};
+```
+
+</Tab>
+<Tab title="Propriétés">
+
+
+| Propriétés | Type | Description |
+| ---------- | ----------------- | ---------------------------------------------------- |
+| éditeur | `BlockNoteEditor` | L'instance de l'éditeur de blocs ou sa configuration |
+
+
+
+</Tab>
</Tabs>
diff --git a/packages/twenty-docs/l/fr/twenty-ui/input/buttons.mdx b/packages/twenty-docs/l/fr/twenty-ui/input/buttons.mdx
index cd664261f7a..2d450751c79 100644
--- a/packages/twenty-docs/l/fr/twenty-ui/input/buttons.mdx
+++ b/packages/twenty-docs/l/fr/twenty-ui/input/buttons.mdx
@@ -1,5 +1,6 @@
---
title: Boutons
+icon: hand-pointer
---
<Frame>
@@ -11,428 +12,511 @@ Une liste de boutons et de groupes de boutons utilisés dans toute l'application
## Bouton
<Tabs>
- <Tab title="Utilisation">
- ```jsx
- import { Button } from "@/ui/input/button/components/Button";
-
- export const MyComponent = () => {
- return (
- <Button
- className
- Icon={null}
- title="Title"
- fullWidth={false}
- variant="primary"
- size="medium"
- position="standalone"
- accent="default"
- soon={false}
- disabled={false}
- focus={true}
- onClick={() => console.log("click")}
- />
- );
- };
- ```
- </Tab>
-
- <Tab title="Propriétés">
- | Propriétés | Type | Description |
- | ------------- | --------------------- | --------------------------------------------------------------------------------------------------------------------- |
- | nomDeClasse | chaîne | Nom de classe facultatif pour le style supplémentaire |
- | Icône | `React.ComponentType` | Un composant d'icône facultatif qui est affiché dans le bouton |
- | titre | chaîne | Le contenu texte du bouton |
- | largeurTotale | booléen | Définit si le bouton doit occuper toute la largeur de son conteneur |
- | variante | chaîne | La variante de style visuel du bouton. Les options incluent `primaire`, `secondaire` et `tertiaire` |
- | taille | chaîne | La taille du bouton. A deux options : `small` et `medium` |
- | position | chaîne | La position du bouton par rapport à ses voisins. Les options incluent : `indépendant`, `gauche`, `droite` et `milieu` |
- | accent | chaîne | La couleur d'accentuation du bouton. Options include: `default`, `blue`, and `danger` |
- | Bient\u00f4t | booléen | Indique si le bouton est marqué comme "bientôt" (comme pour les futures fonctionnalités) |
- | désactivé | booléen | Spécifie si le bouton est désactivé ou non |
- | focus | booléen | Détermine si le bouton a le focus |
- | onClick | fonction | Une fonction de rappel qui se déclenche lorsque l'utilisateur clique sur le bouton |
- </Tab>
+
+<Tab title="Utilisation">
+
+```jsx
+import { Button } from "@/ui/input/button/components/Button";
+
+export const MyComponent = () => {
+ return (
+ <Button
+ className
+ Icon={null}
+ title="Title"
+ fullWidth={false}
+ variant="primary"
+ size="medium"
+ position="standalone"
+ accent="default"
+ soon={false}
+ disabled={false}
+ focus={true}
+ onClick={() => console.log("click")}
+ />
+ );
+};
+```
+</Tab>
+
+<Tab title="Propriétés">
+
+
+| Propriétés | Type | Description |
+| ------------- | --------------------- | --------------------------------------------------------------------------------------------------------------------- |
+| nomDeClasse | chaîne | Nom de classe facultatif pour le style supplémentaire |
+| Icône | `React.ComponentType` | Un composant d'icône facultatif qui est affiché dans le bouton |
+| titre | chaîne | Le contenu texte du bouton |
+| largeurTotale | booléen | Définit si le bouton doit occuper toute la largeur de son conteneur |
+| variante | chaîne | La variante de style visuel du bouton. Les options incluent `primaire`, `secondaire` et `tertiaire` |
+| taille | chaîne | La taille du bouton. A deux options : `small` et `medium` |
+| position | chaîne | La position du bouton par rapport à ses voisins. Les options incluent : `indépendant`, `gauche`, `droite` et `milieu` |
+| accent | chaîne | La couleur d'accentuation du bouton. Options include: `default`, `blue`, and `danger` |
+| Bient\u00f4t | booléen | Indique si le bouton est marqué comme "bientôt" (comme pour les futures fonctionnalités) |
+| désactivé | booléen | Spécifie si le bouton est désactivé ou non |
+| focus | booléen | Détermine si le bouton a le focus |
+| onClick | fonction | Une fonction de rappel qui se déclenche lorsque l'utilisateur clique sur le bouton |
+
+
+
+
+</Tab>
+
</Tabs>
## Groupe de Boutons
<Tabs>
- <Tab title="Utilisation">
- ```jsx
- import { Button } from "@/ui/input/button/components/Button";
- import { ButtonGroup } from "@/ui/input/button/components/ButtonGroup";
-
- export const MyComponent = () => {
- return (
- <ButtonGroup variant="primary" size="large" accent="blue" className>
- <Button
- className
- Icon={null}
- title="Button 1"
- fullWidth={false}
- variant="primary"
- size="medium"
- position="standalone"
- accent="blue"
- soon={false}
- disabled={false}
- focus={false}
- onClick={() => console.log("click")}
- />
- <Button
- className
- Icon={null}
- title="Button 2"
- fullWidth={false}
- variant="secondary"
- size="medium"
- position="left"
- accent="blue"
- soon={false}
- disabled={false}
- focus={false}
- onClick={() => console.log("click")}
- />
- <Button
- className
- Icon={null}
- title="Button 3"
- fullWidth={false}
- variant="tertiary"
- size="medium"
- position="right"
- accent="blue"
- soon={false}
- disabled={false}
- focus={false}
- onClick={() => console.log("click")}
- />
- </ButtonGroup>
- );
- };
-
- ```
- </Tab>
-
- <Tab title="Propriétés">
- | Propriétés | Type | Description |
- | ----------- | --------- | -------------------------------------------------------------------------------------------------------------------- |
- | variante | chaîne | La variante de style visuel des boutons dans le groupe. Les options incluent `primaire`, `secondaire` et `tertiaire` |
- | taille | chaîne | La taille des boutons dans le groupe. Has two options: `medium` and `small` |
- | accent | chaîne | La couleur d'accentuation des boutons dans le groupe. Options include `default`, `blue` and `danger` |
- | nomDeClasse | chaîne | Nom de classe facultatif pour le style supplémentaire |
- | enfants | ReactNode | Un tableau d'éléments React représentant les boutons individuels dans le groupe |
- </Tab>
+<Tab title="Utilisation">
+```jsx
+import { Button } from "@/ui/input/button/components/Button";
+import { ButtonGroup } from "@/ui/input/button/components/ButtonGroup";
+
+export const MyComponent = () => {
+ return (
+ <ButtonGroup variant="primary" size="large" accent="blue" className>
+ <Button
+ className
+ Icon={null}
+ title="Button 1"
+ fullWidth={false}
+ variant="primary"
+ size="medium"
+ position="standalone"
+ accent="blue"
+ soon={false}
+ disabled={false}
+ focus={false}
+ onClick={() => console.log("click")}
+ />
+ <Button
+ className
+ Icon={null}
+ title="Button 2"
+ fullWidth={false}
+ variant="secondary"
+ size="medium"
+ position="left"
+ accent="blue"
+ soon={false}
+ disabled={false}
+ focus={false}
+ onClick={() => console.log("click")}
+ />
+ <Button
+ className
+ Icon={null}
+ title="Button 3"
+ fullWidth={false}
+ variant="tertiary"
+ size="medium"
+ position="right"
+ accent="blue"
+ soon={false}
+ disabled={false}
+ focus={false}
+ onClick={() => console.log("click")}
+ />
+ </ButtonGroup>
+ );
+};
+
+```
+</Tab>
+
+<Tab title="Propriétés">
+
+
+| Propriétés | Type | Description |
+| ----------- | --------- | -------------------------------------------------------------------------------------------------------------------- |
+| variante | chaîne | La variante de style visuel des boutons dans le groupe. Les options incluent `primaire`, `secondaire` et `tertiaire` |
+| taille | chaîne | La taille des boutons dans le groupe. Has two options: `medium` and `small` |
+| accent | chaîne | La couleur d'accentuation des boutons dans le groupe. Options include `default`, `blue` and `danger` |
+| nomDeClasse | chaîne | Nom de classe facultatif pour le style supplémentaire |
+| enfants | ReactNode | Un tableau d'éléments React représentant les boutons individuels dans le groupe |
+
+
+
+</Tab>
</Tabs>
## Bouton Flottant
<Tabs>
- <Tab title="Utilisation">
- ```jsx
- import { FloatingButton } from "@/ui/input/button/components/FloatingButton";
- import { IconSearch } from "@tabler/icons-react";
-
- export const MyComponent = () => {
- return (
- <FloatingButton
- className
- Icon={IconSearch}
- title="Title"
- size="medium"
- position="standalone"
- applyShadow={true}
- applyBlur={true}
- disabled={false}
- focus={true}
- />
- );
- };
- ```
- </Tab>
-
- <Tab title="Propriétés">
- | Propriétés | Type | Description |
- | -------------- | --------------------- | ------------------------------------------------------------------------------------------------------------------- |
- | nomDeClasse | chaîne | Nom facultatif pour un style supplémentaire |
- | Icône | `React.ComponentType` | Un composant d'icône facultatif qui est affiché dans le bouton |
- | titre | chaîne | Le contenu texte du bouton |
- | taille | chaîne | La taille du bouton. A deux options : `small` et `medium` |
- | position | chaîne | La position du bouton par rapport à ses voisins. Les options incluent : `indépendant`, `gauche`, `milieu`, `droite` |
- | appliquerOmbre | booléen | Détermine s'il faut appliquer une ombre à un bouton |
- | appliquerFlou | booléen | Détermine s'il faut appliquer un effet flou au bouton |
- | désactivé | booléen | Détermine si le bouton est désactivé |
- | focus | booléen | Indique si le bouton a le focus |
- </Tab>
+<Tab title="Utilisation">
+
+```jsx
+import { FloatingButton } from "@/ui/input/button/components/FloatingButton";
+import { IconSearch } from "@tabler/icons-react";
+
+export const MyComponent = () => {
+ return (
+ <FloatingButton
+ className
+ Icon={IconSearch}
+ title="Title"
+ size="medium"
+ position="standalone"
+ applyShadow={true}
+ applyBlur={true}
+ disabled={false}
+ focus={true}
+ />
+ );
+};
+```
+
+</Tab>
+
+<Tab title="Propriétés">
+
+
+| Propriétés | Type | Description |
+| -------------- | --------------------- | ------------------------------------------------------------------------------------------------------------------- |
+| nomDeClasse | chaîne | Nom facultatif pour un style supplémentaire |
+| Icône | `React.ComponentType` | Un composant d'icône facultatif qui est affiché dans le bouton |
+| titre | chaîne | Le contenu texte du bouton |
+| taille | chaîne | La taille du bouton. A deux options : `small` et `medium` |
+| position | chaîne | La position du bouton par rapport à ses voisins. Les options incluent : `indépendant`, `gauche`, `milieu`, `droite` |
+| appliquerOmbre | booléen | Détermine s'il faut appliquer une ombre à un bouton |
+| appliquerFlou | booléen | Détermine s'il faut appliquer un effet flou au bouton |
+| désactivé | booléen | Détermine si le bouton est désactivé |
+| focus | booléen | Indique si le bouton a le focus |
+
+
+
+</Tab>
</Tabs>
## Groupe de Boutons Flottants
<Tabs>
- <Tab title="Utilisation">
- ```jsx
- import { FloatingButton } from "@/ui/input/button/components/FloatingButton";
- import { FloatingButtonGroup } from "@/ui/input/button/components/FloatingButtonGroup";
- import { IconClipboardText, IconCheckbox } from "@tabler/icons-react";
-
- export const MyComponent = () => {
- return (
- <FloatingButtonGroup size="small">
- <FloatingButton
- className
- Icon={IconClipboardText}
- title
- size="small"
- position="standalone"
- applyShadow={true}
- applyBlur={true}
- disabled={false}
- focus={true}
- />
- <FloatingButton
- className
- Icon={IconCheckbox}
- title
- size="small"
- position="standalone"
- applyShadow={true}
- applyBlur={true}
- disabled={false}
- />
- </FloatingButtonGroup>
- );
- };
- ```
- </Tab>
-
- <Tab title="Propriétés">
- | Propriétés | Type | Description | Par défaut |
- | ---------- | --------- | ------------------------------------------------------------------------------- | ---------- |
- | taille | chaîne | La taille du bouton. A deux options : `small` et `medium` | petit |
- | enfants | ReactNode | Un tableau d'éléments React représentant les boutons individuels dans le groupe | |
- </Tab>
+<Tab title="Utilisation">
+
+```jsx
+import { FloatingButton } from "@/ui/input/button/components/FloatingButton";
+import { FloatingButtonGroup } from "@/ui/input/button/components/FloatingButtonGroup";
+import { IconClipboardText, IconCheckbox } from "@tabler/icons-react";
+
+export const MyComponent = () => {
+ return (
+ <FloatingButtonGroup size="small">
+ <FloatingButton
+ className
+ Icon={IconClipboardText}
+ title
+ size="small"
+ position="standalone"
+ applyShadow={true}
+ applyBlur={true}
+ disabled={false}
+ focus={true}
+ />
+ <FloatingButton
+ className
+ Icon={IconCheckbox}
+ title
+ size="small"
+ position="standalone"
+ applyShadow={true}
+ applyBlur={true}
+ disabled={false}
+ />
+ </FloatingButtonGroup>
+ );
+};
+```
+
+</Tab>
+
+<Tab title="Propriétés">
+
+
+| Propriétés | Type | Description | Par défaut |
+| ---------- | --------- | ------------------------------------------------------------------------------- | ---------- |
+| taille | chaîne | La taille du bouton. A deux options : `small` et `medium` | petit |
+| enfants | ReactNode | Un tableau d'éléments React représentant les boutons individuels dans le groupe | |
+
+
+
+</Tab>
+
</Tabs>
## Bouton Icône Flottant
<Tabs>
- <Tab title="Utilisation">
- ```jsx
- import { FloatingIconButton } from "@/ui/input/button/components/FloatingIconButton";
- import { IconSearch } from "@tabler/icons-react";
-
- export const MyComponent = () => {
- return (
- <FloatingIconButton
- className
- Icon={IconSearch}
- size="small"
- position="standalone"
- applyShadow={true}
- applyBlur={true}
- disabled={false}
- focus={false}
- onClick={() => console.log("click")}
- isActive={true}
- />
- );
- };
- ```
- </Tab>
-
- <Tab title="Propriétés">
- | Propriétés | Type | Description |
- | -------------- | --------------------- | --------------------------------------------------------------------------------------------------------------------- |
- | nomDeClasse | chaîne | Nom facultatif pour un style supplémentaire |
- | Icône | `React.ComponentType` | Un composant d'icône facultatif qui est affiché dans le bouton |
- | taille | chaîne | La taille du bouton. A deux options : `small` et `medium` |
- | position | chaîne | La position du bouton par rapport à ses voisins. Les options incluent : `indépendant`, `gauche`, `droite` et `milieu` |
- | appliquerOmbre | booléen | Détermine s'il faut appliquer une ombre à un bouton |
- | appliquerFlou | booléen | Détermine s'il faut appliquer un effet flou au bouton |
- | désactivé | booléen | Détermine si le bouton est désactivé |
- | focus | booléen | Indique si le bouton a le focus |
- | onClick | fonction | Une fonction de rappel qui se déclenche lorsque l'utilisateur clique sur le bouton |
- | estActif | booléen | Détermine si le bouton est dans un état actif |
- </Tab>
+<Tab title="Utilisation">
+
+```jsx
+import { FloatingIconButton } from "@/ui/input/button/components/FloatingIconButton";
+import { IconSearch } from "@tabler/icons-react";
+
+export const MyComponent = () => {
+ return (
+ <FloatingIconButton
+ className
+ Icon={IconSearch}
+ size="small"
+ position="standalone"
+ applyShadow={true}
+ applyBlur={true}
+ disabled={false}
+ focus={false}
+ onClick={() => console.log("click")}
+ isActive={true}
+ />
+ );
+};
+```
+
+</Tab>
+
+<Tab title="Propriétés">
+
+
+| Propriétés | Type | Description |
+| -------------- | --------------------- | --------------------------------------------------------------------------------------------------------------------- |
+| nomDeClasse | chaîne | Nom facultatif pour un style supplémentaire |
+| Icône | `React.ComponentType` | Un composant d'icône facultatif qui est affiché dans le bouton |
+| taille | chaîne | La taille du bouton. A deux options : `small` et `medium` |
+| position | chaîne | La position du bouton par rapport à ses voisins. Les options incluent : `indépendant`, `gauche`, `droite` et `milieu` |
+| appliquerOmbre | booléen | Détermine s'il faut appliquer une ombre à un bouton |
+| appliquerFlou | booléen | Détermine s'il faut appliquer un effet flou au bouton |
+| désactivé | booléen | Détermine si le bouton est désactivé |
+| focus | booléen | Indique si le bouton a le focus |
+| onClick | fonction | Une fonction de rappel qui se déclenche lorsque l'utilisateur clique sur le bouton |
+| estActif | booléen | Détermine si le bouton est dans un état actif |
+
+
+
+</Tab>
+
</Tabs>
## Groupe de Boutons Icône Flottants
<Tabs>
- <Tab title="Utilisation">
- ```jsx
- import { FloatingIconButtonGroup } from "@/ui/input/button/components/FloatingIconButtonGroup";
- import { IconClipboardText, IconCheckbox } from "@tabler/icons-react";
-
- export const MyComponent = () => {
- const iconButtons = [
- {
- Icon: IconClipboardText,
- onClick: () => console.log("Button 1 clicked"),
- isActive: true,
- },
- {
- Icon: IconCheckbox,
- onClick: () => console.log("Button 2 clicked"),
- isActive: true,
- },
- ];
-
- return (
- <FloatingIconButtonGroup
- className
- size="small"
- iconButtons={iconButtons} />
- );
- };
-
- ```
- </Tab>
-
- <Tab title="Propriétés">
- | Propriétés | Type | Description |
- | ------------ | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
- | nomDeClasse | chaîne | Nom facultatif pour un style supplémentaire |
- | taille | chaîne | La taille du bouton. A deux options : `small` et `medium` |
- | boutonsIcône | tableau | Un tableau d'objets, chacun représentant un bouton icône dans le groupe. Chaque objet doit inclure le composant d'icône que vous souhaitez afficher dans le bouton, la fonction que vous souhaitez appeler lorsqu'un utilisateur clique sur le bouton, et si le bouton doit être actif ou non. |
- </Tab>
+<Tab title="Utilisation">
+
+```jsx
+import { FloatingIconButtonGroup } from "@/ui/input/button/components/FloatingIconButtonGroup";
+import { IconClipboardText, IconCheckbox } from "@tabler/icons-react";
+
+export const MyComponent = () => {
+ const iconButtons = [
+ {
+ Icon: IconClipboardText,
+ onClick: () => console.log("Button 1 clicked"),
+ isActive: true,
+ },
+ {
+ Icon: IconCheckbox,
+ onClick: () => console.log("Button 2 clicked"),
+ isActive: true,
+ },
+ ];
+
+ return (
+ <FloatingIconButtonGroup
+ className
+ size="small"
+ iconButtons={iconButtons} />
+ );
+};
+
+```
+
+</Tab>
+
+<Tab title="Propriétés">
+
+
+| Propriétés | Type | Description |
+| ------------ | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| nomDeClasse | chaîne | Nom facultatif pour un style supplémentaire |
+| taille | chaîne | La taille du bouton. A deux options : `small` et `medium` |
+| boutonsIcône | tableau | Un tableau d'objets, chacun représentant un bouton icône dans le groupe. Chaque objet doit inclure le composant d'icône que vous souhaitez afficher dans le bouton, la fonction que vous souhaitez appeler lorsqu'un utilisateur clique sur le bouton, et si le bouton doit être actif ou non. |
+
+
+
+</Tab>
+
</Tabs>
## Bouton Clair
<Tabs>
- <Tab title="Utilisation">
- ```jsx
- import { LightButton } from "@/ui/input/button/components/LightButton";
+<Tab title="Utilisation">
+
+```jsx
+import { LightButton } from "@/ui/input/button/components/LightButton";
+
+export const MyComponent = () => {
+ return <LightButton
+ className
+ icon={null}
+ title="Title"
+ accent="secondary"
+ active={false}
+ disabled={false}
+ focus={true}
+ onClick={()=>console.log('click')}
+ />;
+};
+```
+
+
+</Tab>
+
+<Tab title="Propriétés">
+
- export const MyComponent = () => {
- return <LightButton
+| Propriétés | Type | Description |
+| ----------- | ----------------- | --------------------------------------------------------------------------------------- |
+| nomDeClasse | chaîne | Nom facultatif pour un style supplémentaire |
+| icône | `React.ReactNode` | L'icône que vous voulez afficher dans le bouton |
+| titre | chaîne | Le contenu texte du bouton |
+| accent | chaîne | La couleur d'accentuation du bouton. Les options incluent : `secondaire` et `tertiaire` |
+| actif | booléen | Détermine si le bouton est dans un état actif |
+| désactivé | booléen | Détermine si le bouton est désactivé |
+| focus | booléen | Indique si le bouton a le focus |
+| onClick | fonction | Une fonction de rappel qui se déclenche lorsque l'utilisateur clique sur le bouton |
+
+
+
+
+</Tab>
+
+</Tabs>
+
+## Bouton Icône Clair
+
+<Tabs>
+<Tab title="Utilisation">
+
+```jsx
+import { LightIconButton } from "@/ui/input/button/components/LightIconButton";
+import { IconSearch } from "@tabler/icons-react";
+
+export const MyComponent = () => {
+ return (
+ <LightIconButton
className
- icon={null}
+ testId="test1"
+ Icon={IconSearch}
title="Title"
+ size="small"
accent="secondary"
- active={false}
+ active={true}
disabled={false}
focus={true}
- onClick={()=>console.log('click')}
- />;
- };
- ```
- </Tab>
-
- <Tab title="Propriétés">
- | Propriétés | Type | Description |
- | ----------- | ----------------- | --------------------------------------------------------------------------------------- |
- | nomDeClasse | chaîne | Nom facultatif pour un style supplémentaire |
- | icône | `React.ReactNode` | L'icône que vous voulez afficher dans le bouton |
- | titre | chaîne | Le contenu texte du bouton |
- | accent | chaîne | La couleur d'accentuation du bouton. Les options incluent : `secondaire` et `tertiaire` |
- | actif | booléen | Détermine si le bouton est dans un état actif |
- | désactivé | booléen | Détermine si le bouton est désactivé |
- | focus | booléen | Indique si le bouton a le focus |
- | onClick | fonction | Une fonction de rappel qui se déclenche lorsque l'utilisateur clique sur le bouton |
- </Tab>
-</Tabs>
+ onClick={() => console.log("click")}
+ />
+ );
+};
+```
-## Bouton Icône Clair
-<Tabs>
- <Tab title="Utilisation">
- ```jsx
- import { LightIconButton } from "@/ui/input/button/components/LightIconButton";
- import { IconSearch } from "@tabler/icons-react";
-
- export const MyComponent = () => {
- return (
- <LightIconButton
- className
- testId="test1"
- Icon={IconSearch}
- title="Title"
- size="small"
- accent="secondary"
- active={true}
- disabled={false}
- focus={true}
- onClick={() => console.log("click")}
- />
- );
- };
- ```
- </Tab>
-
- <Tab title="Propriétés">
- | Propriétés | Type | Description |
- | ----------- | --------------------- | --------------------------------------------------------------------------------------- |
- | nomDeClasse | chaîne | Nom facultatif pour un style supplémentaire |
- | testId | chaîne | Identifiant de test pour le bouton |
- | Icône | `React.ComponentType` | Un composant d'icône facultatif qui est affiché dans le bouton |
- | titre | chaîne | Le contenu texte du bouton |
- | taille | chaîne | La taille du bouton. A deux options : `petit` et `moyen` |
- | accent | chaîne | La couleur d'accentuation du bouton. Les options incluent : `secondaire` et `tertiaire` |
- | actif | booléen | Détermine si le bouton est dans un état actif |
- | désactivé | booléen | Détermine si le bouton est désactivé |
- | focus | booléen | Indique si le bouton a le focus |
- | onClick | fonction | Une fonction de rappel qui se déclenche lorsque l'utilisateur clique sur le bouton |
- </Tab>
+</Tab>
+
+<Tab title="Propriétés">
+
+
+| Propriétés | Type | Description |
+| ----------- | --------------------- | --------------------------------------------------------------------------------------- |
+| nomDeClasse | chaîne | Nom facultatif pour un style supplémentaire |
+| testId | chaîne | Identifiant de test pour le bouton |
+| Icône | `React.ComponentType` | Un composant d'icône facultatif qui est affiché dans le bouton |
+| titre | chaîne | Le contenu texte du bouton |
+| taille | chaîne | La taille du bouton. A deux options : `petit` et `moyen` |
+| accent | chaîne | La couleur d'accentuation du bouton. Les options incluent : `secondaire` et `tertiaire` |
+| actif | booléen | Détermine si le bouton est dans un état actif |
+| désactivé | booléen | Détermine si le bouton est désactivé |
+| focus | booléen | Indique si le bouton a le focus |
+| onClick | fonction | Une fonction de rappel qui se déclenche lorsque l'utilisateur clique sur le bouton |
+
+
+
+</Tab>
+
</Tabs>
## Bouton Principal
<Tabs>
- <Tab title="Utilisation">
- ```jsx
- import { MainButton } from "@/ui/input/button/components/MainButton";
- import { IconCheckbox } from "@tabler/icons-react";
-
- export const MyComponent = () => {
- return (
- <MainButton
- title="Checkbox"
- fullWidth={false}
- variant="primary"
- soon={false}
- Icon={IconCheckbox}
- />
- );
- };
- ```
- </Tab>
-
- <Tab title="Propriétés">
- | Propriétés | Type | Description |
- | ------------------------- | -------------------------------- | ---------------------------------------------------------------------------------------- |
- | titre | chaîne | Le contenu texte du bouton |
- | largeurTotale | booléen | Définit si le bouton doit occuper toute la largeur de son conteneur |
- | variante | chaîne | La variante de style visuel du bouton. Les options incluent `primaire` et `secondaire` |
- | Bient\u00f4t | booléen | Indique si le bouton est marqué comme "bientôt" (comme pour les futures fonctionnalités) |
- | Icône | `React.ComponentType` | Un composant d'icône facultatif qui est affiché dans le bouton |
- | Propriétés React `button` | `React.ComponentProps<'button'>` | Toutes les propriétés standard des boutons HTML sont prises en charge |
- </Tab>
+<Tab title="Utilisation">
+
+```jsx
+import { MainButton } from "@/ui/input/button/components/MainButton";
+import { IconCheckbox } from "@tabler/icons-react";
+
+export const MyComponent = () => {
+ return (
+ <MainButton
+ title="Checkbox"
+ fullWidth={false}
+ variant="primary"
+ soon={false}
+ Icon={IconCheckbox}
+ />
+ );
+};
+```
+
+
+</Tab>
+
+<Tab title="Propriétés">
+
+
+| Propriétés | Type | Description |
+| ------------------------- | -------------------------------- | ---------------------------------------------------------------------------------------- |
+| titre | chaîne | Le contenu texte du bouton |
+| largeurTotale | booléen | Définit si le bouton doit occuper toute la largeur de son conteneur |
+| variante | chaîne | La variante de style visuel du bouton. Les options incluent `primaire` et `secondaire` |
+| Bient\u00f4t | booléen | Indique si le bouton est marqué comme "bientôt" (comme pour les futures fonctionnalités) |
+| Icône | `React.ComponentType` | Un composant d'icône facultatif qui est affiché dans le bouton |
+| Propriétés React `button` | `React.ComponentProps<'button'>` | Toutes les propriétés standard des boutons HTML sont prises en charge |
+
+
+
+
+</Tab>
+
</Tabs>
## Bouton Icône Arrondie
<Tabs>
- <Tab title="Utilisation">
- ```jsx
- import { RoundedIconButton } from "@/ui/input/button/components/RoundedIconButton";
- import { IconSearch } from "@tabler/icons-react";
-
- export const MyComponent = () => {
- return (
- <RoundedIconButton
- Icon={IconSearch}
- />
- );
- };
- ```
- </Tab>
-
- <Tab title="Propriétés">
- | Propriétés | Type | Description |
- | ------------------------- | ----------------------------------------------- | ----------- |
- | Icône | `React.ComponentType` | |
- | Propriétés React `button` | `React.ButtonHTMLAttributes<HTMLButtonElement>` | |
- </Tab>
+<Tab title="Utilisation">
+
+```jsx
+import { RoundedIconButton } from "@/ui/input/button/components/RoundedIconButton";
+import { IconSearch } from "@tabler/icons-react";
+
+export const MyComponent = () => {
+ return (
+ <RoundedIconButton
+ Icon={IconSearch}
+ />
+ );
+};
+```
+
+
+</Tab>
+
+<Tab title="Propriétés">
+
+
+| Propriétés | Type | Description |
+| ------------------------- | ----------------------------------------------- | ----------- |
+| Icône | `React.ComponentType` | |
+| Propriétés React `button` | `React.ButtonHTMLAttributes<HTMLButtonElement>` | |
+
+
+
+</Tab>
+
</Tabs>
diff --git a/packages/twenty-docs/l/fr/twenty-ui/input/checkbox.mdx b/packages/twenty-docs/l/fr/twenty-ui/input/checkbox.mdx
index 366ba46745e..76ae2670776 100644
--- a/packages/twenty-docs/l/fr/twenty-ui/input/checkbox.mdx
+++ b/packages/twenty-docs/l/fr/twenty-ui/input/checkbox.mdx
@@ -1,5 +1,6 @@
---
title: Case à cocher
+icon: square-check
---
<Frame>
@@ -9,35 +10,41 @@ title: Case à cocher
Utilisé lorsqu'un utilisateur doit sélectionner plusieurs valeurs parmi plusieurs options.
<Tabs>
- <Tab title="Utilisation">
- ```jsx
- import { Checkbox } from "twenty-ui/display";
-
- export const MyComponent = () => {
- return (
- <Checkbox
- checked={true}
- indeterminate={false}
- onChange={() => console.log("onChange function fired")}
- onCheckedChange={() => console.log("onCheckedChange function fired")}
- variant="primary"
- size="small"
- shape="squared"
- />
- );
- };
- ```
- </Tab>
-
- <Tab title="Propriétés">
- | Propriétés | Type | Description |
- | --------------- | -------- | ---------------------------------------------------------------------------------------------------------- |
- | coché | booléen | Indique si la case à cocher est cochée |
- | indéterminé | booléen | Indique si la case à cocher est dans un état indéterminé (ni cochée ni décochée) |
- | onChange | fonction | La fonction de rappel que vous souhaitez déclencher lorsque l'état de la case à cocher change |
- | onCheckedChange | fonction | La fonction de rappel que vous souhaitez déclencher lorsque l'état `coché` change |
- | variante | chaîne | Le style visuel de la variante de la boîte. Les options incluent : `primaire`, `secondaire` et `tertiaire` |
- | taille | chaîne | La taille de la case à cocher. Comporte deux options : `petit` et `grand` |
- | forme | chaîne | La forme de la case à cocher. Comporte deux options : `carrée` et `arrondie` |
- </Tab>
+<Tab title="Utilisation">
+
+```jsx
+import { Checkbox } from "twenty-ui/display";
+
+export const MyComponent = () => {
+ return (
+ <Checkbox
+ checked={true}
+ indeterminate={false}
+ onChange={() => console.log("onChange function fired")}
+ onCheckedChange={() => console.log("onCheckedChange function fired")}
+ variant="primary"
+ size="small"
+ shape="squared"
+ />
+ );
+};
+```
+
+</Tab>
+<Tab title="Propriétés">
+
+
+| Propriétés | Type | Description |
+| --------------- | -------- | ---------------------------------------------------------------------------------------------------------- |
+| coché | booléen | Indique si la case à cocher est cochée |
+| indéterminé | booléen | Indique si la case à cocher est dans un état indéterminé (ni cochée ni décochée) |
+| onChange | fonction | La fonction de rappel que vous souhaitez déclencher lorsque l'état de la case à cocher change |
+| onCheckedChange | fonction | La fonction de rappel que vous souhaitez déclencher lorsque l'état `coché` change |
+| variante | chaîne | Le style visuel de la variante de la boîte. Les options incluent : `primaire`, `secondaire` et `tertiaire` |
+| taille | chaîne | La taille de la case à cocher. Comporte deux options : `petit` et `grand` |
+| forme | chaîne | La forme de la case à cocher. Comporte deux options : `carrée` et `arrondie` |
+
+
+
+</Tab>
</Tabs>
diff --git a/packages/twenty-docs/l/fr/twenty-ui/input/color-scheme.mdx b/packages/twenty-docs/l/fr/twenty-ui/input/color-scheme.mdx
index 8d300045208..d494f3af9f4 100644
--- a/packages/twenty-docs/l/fr/twenty-ui/input/color-scheme.mdx
+++ b/packages/twenty-docs/l/fr/twenty-ui/input/color-scheme.mdx
@@ -1,5 +1,6 @@
---
title: Schéma de couleurs
+icon: palette
---
<Frame>
@@ -11,28 +12,36 @@ title: Schéma de couleurs
Représente différents schémas de couleurs et est spécialement adapté aux thèmes clairs et sombres.
<Tabs>
- <Tab title="Utilisation">
- ```jsx
- import { ColorSchemeCard } from "twenty-ui/display";
-
- export const MyComponent = () => {
- return (
- <ColorSchemeCard
- variant="Dark"
- selected={true}
- />
- );
- };
- ```
- </Tab>
-
- <Tab title="Propriétés">
- | Propriétés | Type | Description | Par défaut |
- | -------------------------- | --------------------------------------- | --------------------------------------------------------------------------------------- | ---------- |
- | variante | chaîne | La variante du schéma de couleurs. Les options incluent `Sombre`, `Clair` et `Système`. | clair |
- | sélectionné | booléen | Si `vrai`, affiche une coche pour indiquer le schéma de couleurs sélectionné. | |
- | propriétés supplémentaires | `React.ComponentPropsWithoutRef<'div'>` | Propriétés standard de l'élément HTML `div`. | |
- </Tab>
+<Tab title="Utilisation">
+
+```jsx
+import { ColorSchemeCard } from "twenty-ui/display";
+
+export const MyComponent = () => {
+ return (
+ <ColorSchemeCard
+ variant="Dark"
+ selected={true}
+ />
+ );
+};
+```
+
+</Tab>
+
+<Tab title="Propriétés">
+
+
+| Propriétés | Type | Description | Par défaut |
+| -------------------------- | --------------------------------------- | --------------------------------------------------------------------------------------- | ---------- |
+| variante | chaîne | La variante du schéma de couleurs. Les options incluent `Sombre`, `Clair` et `Système`. | clair |
+| sélectionné | booléen | Si `vrai`, affiche une coche pour indiquer le schéma de couleurs sélectionné. | |
+| propriétés supplémentaires | `React.ComponentPropsWithoutRef<'div'>` | Propriétés standard de l'élément HTML `div`. | |
+
+
+
+</Tab>
+
</Tabs>
## Sélecteur de schéma de couleurs
@@ -40,23 +49,31 @@ Représente différents schémas de couleurs et est spécialement adapté aux th
Permet aux utilisateurs de choisir entre différents schémas de couleurs.
<Tabs>
- <Tab title="Utilisation">
- ```jsx
- import { ColorSchemePicker } from "twenty-ui/display";
-
- export const MyComponent = () => {
- return <ColorSchemePicker
- value="Dark"
- onChange
- />;
- };
- ```
- </Tab>
-
- <Tab title="Propriétés">
- | Propriétés | Type | Description |
- | ---------- | -------------------- | ------------------------------------------------------------------------------------------------------------ |
- | valeur | `Schéma de couleurs` | Le schéma de couleurs actuellement sélectionné. |
- | onChange | fonction | La fonction de rappel que vous souhaitez déclencher lorsqu'un utilisateur sélectionne un schéma de couleurs. |
- </Tab>
+<Tab title="Utilisation">
+
+```jsx
+import { ColorSchemePicker } from "twenty-ui/display";
+
+export const MyComponent = () => {
+ return <ColorSchemePicker
+ value="Dark"
+ onChange
+ />;
+};
+```
+
+</Tab>
+
+<Tab title="Propriétés">
+
+
+| Propriétés | Type | Description |
+| ---------- | -------------------- | ------------------------------------------------------------------------------------------------------------ |
+| valeur | `Schéma de couleurs` | Le schéma de couleurs actuellement sélectionné. |
+| onChange | fonction | La fonction de rappel que vous souhaitez déclencher lorsqu'un utilisateur sélectionne un schéma de couleurs. |
+
+
+
+</Tab>
+
</Tabs>
diff --git a/packages/twenty-docs/l/fr/twenty-ui/input/icon-picker.mdx b/packages/twenty-docs/l/fr/twenty-ui/input/icon-picker.mdx
index e91f0a9caff..0eb62868bf4 100644
--- a/packages/twenty-docs/l/fr/twenty-ui/input/icon-picker.mdx
+++ b/packages/twenty-docs/l/fr/twenty-ui/input/icon-picker.mdx
@@ -9,40 +9,49 @@ title: Sélecteur d'icônes
Un sélecteur d'icônes basé sur un menu déroulant qui permet aux utilisateurs de sélectionner une icône dans une liste.
<Tabs>
- <Tab title="Utilisation">
- ```jsx
- import React, { useState } from "react";
- import { IconPicker } from "@/ui/input/components/IconPicker";
-
- export const MyComponent = () => {
-
- const [selectedIcon, setSelectedIcon] = useState("");
- const handleIconChange = ({ iconKey, Icon }) => {
- console.log("Selected Icon:", iconKey);
- setSelectedIcon(iconKey);
- };
-
- return (
- <IconPicker
- disabled={false}
- onChange={handleIconChange}
- selectedIconKey={selectedIcon}
- variant="primary"
- />
- );
- };
- ```
- </Tab>
-
- <Tab title="Propriétés">
- | Propriétés | Type | Description |
- | --------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
- | désactivé | booléen | Désactive le sélecteur d'icônes si défini sur `true` |
- | onChange | fonction | La fonction de rappel déclenchée lorsque l'utilisateur sélectionne une icône. Elle reçoit un objet avec les propriétés `iconKey` et `Icon` |
- | selectedIconKey | chaîne | La clé de l'icône initialement sélectionnée |
- | onClickOutside | fonction | Fonction de rappel déclenchée lorsque l'utilisateur clique en dehors du menu déroulant |
- | onClose | fonction | Fonction de rappel déclenchée lorsque le menu déroulant est fermé |
- | onOpen | fonction | Fonction de rappel déclenchée lorsque le menu déroulant est ouvert |
- | variante | chaîne | La variante de style visuel de l'icône cliquable. Les options incluent : `primaire`, `secondaire` et `tertiaire` |
- </Tab>
+
+<Tab title="Utilisation">
+
+```jsx
+import React, { useState } from "react";
+import { IconPicker } from "@/ui/input/components/IconPicker";
+
+export const MyComponent = () => {
+
+ const [selectedIcon, setSelectedIcon] = useState("");
+ const handleIconChange = ({ iconKey, Icon }) => {
+ console.log("Icône sélectionnée:", iconKey);
+ setSelectedIcon(iconKey);
+ };
+
+ return (
+ <IconPicker
+ disabled={false}
+ onChange={handleIconChange}
+ selectedIconKey={selectedIcon}
+ variant="primary"
+ />
+ );
+};
+```
+
+
+</Tab>
+<Tab title="Propriétés">
+
+
+| Propriétés | Type | Description |
+| --------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
+| désactivé | booléen | Désactive le sélecteur d'icônes si défini sur `true` |
+| onChange | fonction | La fonction de rappel déclenchée lorsque l'utilisateur sélectionne une icône. Elle reçoit un objet avec les propriétés `iconKey` et `Icon` |
+| selectedIconKey | chaîne | La clé de l'icône initialement sélectionnée |
+| onClickOutside | fonction | Fonction de rappel déclenchée lorsque l'utilisateur clique en dehors du menu déroulant |
+| onClose | fonction | Fonction de rappel déclenchée lorsque le menu déroulant est fermé |
+| onOpen | fonction | Fonction de rappel déclenchée lorsque le menu déroulant est ouvert |
+| variante | chaîne | La variante de style visuel de l'icône cliquable. Les options incluent : `primaire`, `secondaire` et `tertiaire` |
+
+
+
+
+</Tab>
</Tabs>
diff --git a/packages/twenty-docs/l/fr/twenty-ui/input/image-input.mdx b/packages/twenty-docs/l/fr/twenty-ui/input/image-input.mdx
index 489af2dff00..7e9e3519f49 100644
--- a/packages/twenty-docs/l/fr/twenty-ui/input/image-input.mdx
+++ b/packages/twenty-docs/l/fr/twenty-ui/input/image-input.mdx
@@ -9,25 +9,32 @@ title: Saisie Image
Permet aux utilisateurs de télécharger et de supprimer une image.
<Tabs>
- <Tab title="Utilisation">
- ```jsx
- import { ImageInput } from "@/ui/input/components/ImageInput";
-
- export const MyComponent = () => {
- return <ImageInput/>;
- };
- ```
- </Tab>
-
- <Tab title="Propriétés">
- | Propriétés | Type | Description |
- | ------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------- |
- | photo | chaîne | L'URL source de l'image |
- | onUpload | fonction | La fonction appelée lors du téléchargement d'une nouvelle image par un utilisateur. Elle reçoit l'objet `File` comme paramètre. |
- | onRemove | fonction | La fonction appelée lorsque l'utilisateur clique sur le bouton supprimer. |
- | onAbort | fonction | La fonction appelée lorsque l'utilisateur clique sur le bouton annuler pendant le téléchargement de l'image. |
- | isUploading | booléen | Indique si une image est en cours de téléchargement. |
- | messageErreur | chaîne | Un message d'erreur facultatif à afficher sous l'entrée d'image. |
- | désactivé | booléen | Si `true`, l'entrée entière est désactivée et les boutons ne sont pas cliquables. |
- </Tab>
+<Tab title="Utilisation">
+
+```jsx
+import { ImageInput } from "@/ui/input/components/ImageInput";
+
+export const MyComponent = () => {
+ return <ImageInput/>;
+};
+```
+
+</Tab>
+<Tab title="Propriétés">
+
+
+| Propriétés | Type | Description |
+| ------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------- |
+| photo | chaîne | L'URL source de l'image |
+| onUpload | fonction | La fonction appelée lors du téléchargement d'une nouvelle image par un utilisateur. Elle reçoit l'objet `File` comme paramètre. |
+| onRemove | fonction | La fonction appelée lorsque l'utilisateur clique sur le bouton supprimer. |
+| onAbort | fonction | La fonction appelée lorsque l'utilisateur clique sur le bouton annuler pendant le téléchargement de l'image. |
+| isUploading | booléen | Indique si une image est en cours de téléchargement. |
+| messageErreur | chaîne | Un message d'erreur facultatif à afficher sous l'entrée d'image. |
+| désactivé | booléen | Si `true`, l'entrée entière est désactivée et les boutons ne sont pas cliquables. |
+
+
+
+
+</Tab>
</Tabs>
diff --git a/packages/twenty-docs/l/fr/twenty-ui/input/radio.mdx b/packages/twenty-docs/l/fr/twenty-ui/input/radio.mdx
index 855503aad14..aea54d12b32 100644
--- a/packages/twenty-docs/l/fr/twenty-ui/input/radio.mdx
+++ b/packages/twenty-docs/l/fr/twenty-ui/input/radio.mdx
@@ -1,5 +1,6 @@
---
title: Radio
+icon: circle-dot
---
<Frame>
@@ -9,50 +10,58 @@ title: Radio
Utilisé lorsque les utilisateurs peuvent choisir une seule option parmi une série d'options.
<Tabs>
- <Tab title="Utilisation">
- ```jsx
- import { Radio } from "twenty-ui/display";
-
- export const MyComponent = () => {
-
- const handleRadioChange = (event) => {
- console.log("Radio button changed:", event.target.checked);
- };
-
- const handleCheckedChange = (checked) => {
- console.log("Checked state changed:", checked);
- };
-
-
- return (
- <Radio
- checked={true}
- value="Option 1"
- onChange={handleRadioChange}
- onCheckedChange={handleCheckedChange}
- size="large"
- disabled={false}
- labelPosition="right"
- />
- );
- };
-
- ```
- </Tab>
-
- <Tab title="Propriétés">
- | Propriétés | Type | Description |
- | --------------- | ---------------------- | --------------------------------------------------------------------------------------------- |
- | style | propriétés `React.CSS` | Styles inline supplémentaires pour le composant |
- | nomDeClasse | chaîne | Classe CSS facultative pour le style supplémentaire |
- | coché | booléen | Indique si le bouton radio est coché |
- | valeur | chaîne | L'étiquette ou le texte associé au bouton radio |
- | onChange | fonction | La fonction appelée lorsque le bouton radio sélectionné est modifié |
- | onCheckedChange | fonction | La fonction appelée lorsque l'état `checked` du bouton radio change |
- | taille | chaîne | La taille du bouton radio. Les options incluent : `large` et `small` |
- | désactivé | booléen | Si `true`, le bouton radio est désactivé et n'est pas cliquable. |
- | positionLabel | chaîne | La position du texte du label par rapport au bouton radio. A deux options : `left` et `right` |
- </Tab>
+<Tab title="Utilisation">
+
+```jsx
+import { Radio } from "twenty-ui/display";
+
+export const MyComponent = () => {
+
+ const handleRadioChange = (event) => {
+ console.log("Radio button changed:", event.target.checked);
+ };
+
+ const handleCheckedChange = (checked) => {
+ console.log("Checked state changed:", checked);
+ };
+
+
+ return (
+ <Radio
+ checked={true}
+ value="Option 1"
+ onChange={handleRadioChange}
+ onCheckedChange={handleCheckedChange}
+ size="large"
+ disabled={false}
+ labelPosition="right"
+ />
+ );
+};
+
+```
+
+
+</Tab>
+<Tab title="Propriétés">
+
+
+| Propriétés | Type | Description |
+| --------------- | ---------------------- | --------------------------------------------------------------------------------------------- |
+| style | propriétés `React.CSS` | Styles inline supplémentaires pour le composant |
+| nomDeClasse | chaîne | Classe CSS facultative pour le style supplémentaire |
+| coché | booléen | Indique si le bouton radio est coché |
+| valeur | chaîne | L'étiquette ou le texte associé au bouton radio |
+| onChange | fonction | La fonction appelée lorsque le bouton radio sélectionné est modifié |
+| onCheckedChange | fonction | La fonction appelée lorsque l'état `checked` du bouton radio change |
+| taille | chaîne | La taille du bouton radio. Les options incluent : `large` et `small` |
+| désactivé | booléen | Si `true`, le bouton radio est désactivé et n'est pas cliquable. |
+| positionLabel | chaîne | La position du texte du label par rapport au bouton radio. A deux options : `left` et `right` |
+
+
+
+
+</Tab>
</Tabs>
## Groupe Radio
@@ -60,37 +69,45 @@ Utilisé lorsque les utilisateurs peuvent choisir une seule option parmi une sé
Regroupe ensemble des boutons radio associés.
<Tabs>
- <Tab title="Utilisation">
- ```jsx
- import React, { useState } from "react";
- import { Radio, RadioGroup } from "twenty-ui/display";
-
- export const MyComponent = () => {
-
- const [selectedValue, setSelectedValue] = useState("Option 1");
-
- const handleChange = (event) => {
- setSelectedValue(event.target.value);
- };
-
- return (
- <RadioGroup value={selectedValue} onChange={handleChange}>
- <Radio value="Option 1" />
- <Radio value="Option 2" />
- <Radio value="Option 3" />
- </RadioGroup>
- );
- };
-
- ```
- </Tab>
-
- <Tab title="Propriétés">
- | Propriétés | Type | Description |
- | ------------- | ----------------- | ----------------------------------------------------------------------------------------- |
- | valeur | chaîne | La valeur du bouton radio actuellement sélectionné |
- | onChange | fonction | La fonction de rappel déclenchée lorsque le bouton radio est changé |
- | onValueChange | fonction | La fonction de rappel déclenchée lorsque la valeur sélectionnée dans le groupe change. |
- | enfants | `React.ReactNode` | Permet de passer des composants React (tels que Radio) en tant qu'enfants au Groupe Radio |
- </Tab>
+<Tab title="Utilisation">
+
+```jsx
+import React, { useState } from "react";
+import { Radio, RadioGroup } from "twenty-ui/display";
+
+export const MyComponent = () => {
+
+ const [selectedValue, setSelectedValue] = useState("Option 1");
+
+ const handleChange = (event) => {
+ setSelectedValue(event.target.value);
+ };
+
+ return (
+ <RadioGroup value={selectedValue} onChange={handleChange}>
+ <Radio value="Option 1" />
+ <Radio value="Option 2" />
+ <Radio value="Option 3" />
+ </RadioGroup>
+ );
+};
+
+```
+
+</Tab>
+<Tab title="Propriétés">
+
+
+| Propriétés | Type | Description |
+| ------------- | ----------------- | ----------------------------------------------------------------------------------------- |
+| valeur | chaîne | La valeur du bouton radio actuellement sélectionné |
+| onChange | fonction | La fonction de rappel déclenchée lorsque le bouton radio est changé |
+| onValueChange | fonction | La fonction de rappel déclenchée lorsque la valeur sélectionnée dans le groupe change. |
+| enfants | `React.ReactNode` | Permet de passer des composants React (tels que Radio) en tant qu'enfants au Groupe Radio |
+
+
+
+
+</Tab>
+
</Tabs>
diff --git a/packages/twenty-docs/l/fr/twenty-ui/input/select.mdx b/packages/twenty-docs/l/fr/twenty-ui/input/select.mdx
index acb1b9b6a12..46de0cead82 100644
--- a/packages/twenty-docs/l/fr/twenty-ui/input/select.mdx
+++ b/packages/twenty-docs/l/fr/twenty-ui/input/select.mdx
@@ -9,39 +9,47 @@ title: Sélectionner
Permet aux utilisateurs de choisir une valeur parmi une liste d'options prédéfinies.
<Tabs>
- <Tab title="Utilisation">
- ```jsx
- import { IconTwentyStar } from 'twenty-ui/display';
-
- import { Select } from '@/ui/input/components/Select';
-
- export const MyComponent = () => {
-
- return (
- <Select
- className
- disabled={false}
- label="Sélectionnez une option"
- options={[
- { value: 'option1', label: 'Option A', Icon: IconTwentyStar },
- { value: 'option2', label: 'Option B', Icon: IconTwentyStar },
- ]}
- value="option1"
- />
- );
- };
-
- ```
- </Tab>
-
- <Tab title="Propriétés">
- | Propriétés | Type | Description |
- | ----------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
- | nomDeClasse | chaîne | Classe CSS facultative pour le style supplémentaire |
- | désactivé | booléen | Lorsqu'il est défini sur `true`, désactive l'interaction de l'utilisateur avec le composant |
- | étiquette | chaîne | Le libellé décrivant la finalité du composant `Select` |
- | onChange | fonction | La fonction appelée lorsque les valeurs sélectionnées changent |
- | options | tableau | Représente les options disponibles pour le composant `Selected`. C'est un tableau d'objets où chaque objet possède une propriété `value` (l'identifiant unique), une propriété `label` (l'identifiant unique) et, éventuellement, une propriété `Icon` |
- | valeur | chaîne | Représente la valeur actuellement sélectionnée. Elle doit correspondre à l'une des propriétés `value` du tableau `options` |
- </Tab>
+<Tab title="Utilisation">
+
+````jsx
+import { IconTwentyStar } from 'twenty-ui/display';
+
+import { Select } from '@/ui/input/components/Select';
+
+export const MyComponent = () => {
+
+ return (
+ <Select
+ className
+ disabled={false}
+ label="Sélectionnez une option"
+ options={[
+ { value: 'option1', label: 'Option A', Icon: IconTwentyStar },
+ { value: 'option2', label: 'Option B', Icon: IconTwentyStar },
+ ]}
+ value="option1"
+ />
+ );
+};
+'}]}``` processData ```json
+{
+````
+
+</Tab>
+<Tab title="Propriétés">
+
+
+| Propriétés | Type | Description |
+| ----------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| nomDeClasse | chaîne | Classe CSS facultative pour le style supplémentaire |
+| désactivé | booléen | Lorsqu'il est défini sur `true`, désactive l'interaction de l'utilisateur avec le composant |
+| étiquette | chaîne | Le libellé décrivant la finalité du composant `Select` |
+| onChange | fonction | La fonction appelée lorsque les valeurs sélectionnées changent |
+| options | tableau | Représente les options disponibles pour le composant `Selected`. C'est un tableau d'objets où chaque objet possède une propriété `value` (l'identifiant unique), une propriété `label` (l'identifiant unique) et, éventuellement, une propriété `Icon` |
+| valeur | chaîne | Représente la valeur actuellement sélectionnée. Elle doit correspondre à l'une des propriétés `value` du tableau `options` |
+
+
+
+
+</Tab>
</Tabs>
diff --git a/packages/twenty-docs/l/fr/twenty-ui/input/text.mdx b/packages/twenty-docs/l/fr/twenty-ui/input/text.mdx
index 94708975f60..9f11f03ad5f 100644
--- a/packages/twenty-docs/l/fr/twenty-ui/input/text.mdx
+++ b/packages/twenty-docs/l/fr/twenty-ui/input/text.mdx
@@ -11,50 +11,61 @@ title: Texte
Permet aux utilisateurs de saisir et de modifier du texte.
<Tabs>
- <Tab title="Utilisation">
- ```jsx
- import { TextInput } from "@/ui/input/components/TextInput";
-
- export const MyComponent = () => {
- const handleChange = (text) => {
- console.log("Input changed:", text);
- };
-
- const handleKeyDown = (event) => {
- console.log("Key pressed:", event.key);
- };
-
- return (
- <TextInput
- className
- label="Username"
- onChange={handleChange}
- fullWidth={false}
- disableHotkeys={false}
- error="Invalid username"
- onKeyDown={handleKeyDown}
- RightIcon={null}
- />
- );
- };
-
- ```
- </Tab>
-
- <Tab title="Propriétés">
- | Propriétés | Type | Description |
- | ----------------------- | -------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
- | nomDeClasse | chaîne | Nom facultatif pour un style supplémentaire |
- | étiquette | chaîne | Représente l'étiquette de l'entrée |
- | onChange | fonction | La fonction appelée lorsque la valeur de l'entrée change |
- | largeurTotale | booléen | Indique si l'entrée doit occuper 100% de la largeur |
- | désactiverLesRaccourcis | booléen | Indique si les raccourcis sont activés pour l'entrée |
- | erreur | chaîne | Représente le message d'erreur à afficher. Lorsqu'il est fourni, il ajoute également une icône d'erreur sur le côté droit de l'entrée |
- | surToucheEnfoncée | fonction | Appelée lorsqu'une touche est enfoncée alors que le champ de saisie est focalisé. Reçoit un `React.KeyboardEvent` en tant qu'argument |
- | IcôneDroite | ComposantIcône | Un composant icône facultatif affiché sur le côté droit de l'entrée |
-
- Le composant accepte également d'autres propriétés d'éléments d'entrée HTML.
- </Tab>
+
+<Tab title="Utilisation">
+
+```jsx
+import { TextInput } from "@/ui/input/components/TextInput";
+
+export const MyComponent = () => {
+ const handleChange = (text) => {
+ console.log("Input changed:", text);
+ };
+
+ const handleKeyDown = (event) => {
+ console.log("Key pressed:", event.key);
+ };
+
+ return (
+ <TextInput
+ className
+ label="Username"
+ onChange={handleChange}
+ fullWidth={false}
+ disableHotkeys={false}
+ error="Invalid username"
+ onKeyDown={handleKeyDown}
+ RightIcon={null}
+ />
+ );
+};
+
+```
+
+
+</Tab>
+
+<Tab title="Propriétés">
+
+
+| Propriétés | Type | Description |
+| ----------------------- | -------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
+| nomDeClasse | chaîne | Nom facultatif pour un style supplémentaire |
+| étiquette | chaîne | Représente l'étiquette de l'entrée |
+| onChange | fonction | La fonction appelée lorsque la valeur de l'entrée change |
+| largeurTotale | booléen | Indique si l'entrée doit occuper 100% de la largeur |
+| désactiverLesRaccourcis | booléen | Indique si les raccourcis sont activés pour l'entrée |
+| erreur | chaîne | Représente le message d'erreur à afficher. Lorsqu'il est fourni, il ajoute également une icône d'erreur sur le côté droit de l'entrée |
+| surToucheEnfoncée | fonction | Appelée lorsqu'une touche est enfoncée alors que le champ de saisie est focalisé. Reçoit un `React.KeyboardEvent` en tant qu'argument |
+| IcôneDroite | ComposantIcône | Un composant icône facultatif affiché sur le côté droit de l'entrée |
+
+
+
+
+Le composant accepte également d'autres propriétés d'éléments d'entrée HTML.
+
+</Tab>
+
</Tabs>
## Entrée de texte à taille automatique
@@ -62,37 +73,48 @@ Permet aux utilisateurs de saisir et de modifier du texte.
Composant d'entrée de texte qui ajuste automatiquement sa hauteur en fonction du contenu.
<Tabs>
- <Tab title="Utilisation">
- ```jsx
- import { AutosizeTextInput } from "@/ui/input/components/AutosizeTextInput";
-
- export const MyComponent = () => {
- return (
- <AutosizeTextInput
- onValidate={() => console.log("onValidate function fired")}
- minRows={1}
- placeholder="Write a comment"
- onFocus={() => console.log("onFocus function fired")}
- variant="icon"
- buttonTitle
- value="Task: "
- />
- );
- };
- ```
- </Tab>
-
- <Tab title="Propriétés">
- | Propriétés | Type | Description |
- | -------------- | -------- | ------------------------------------------------------------------------------------------- |
- | surValider | fonction | La fonction de rappel que vous souhaitez déclencher lorsque l'utilisateur valide l'entrée |
- | minLignes | nombre | Le nombre minimum de lignes pour la zone de texte |
- | espace réservé | chaîne | Le texte d'espace réservé que vous souhaitez afficher lorsque la zone de texte est vide |
- | surFocus | fonction | La fonction de rappel que vous souhaitez déclencher lorsque la zone de texte prend le focus |
- | variante | chaîne | La variante de l'entrée. Les options incluent : `défaut`, `icône`, et `bouton` |
- | titreBouton | chaîne | Le titre pour le bouton (applicable uniquement à la variante bouton) |
- | valeur | chaîne | La valeur initiale pour la zone de texte |
- </Tab>
+
+<Tab title="Utilisation">
+
+```jsx
+import { AutosizeTextInput } from "@/ui/input/components/AutosizeTextInput";
+
+export const MyComponent = () => {
+ return (
+ <AutosizeTextInput
+ onValidate={() => console.log("onValidate function fired")}
+ minRows={1}
+ placeholder="Write a comment"
+ onFocus={() => console.log("onFocus function fired")}
+ variant="icon"
+ buttonTitle
+ value="Task: "
+ />
+ );
+};
+```
+
+
+</Tab>
+
+<Tab title="Propriétés">
+
+
+| Propriétés | Type | Description |
+| -------------- | -------- | ------------------------------------------------------------------------------------------- |
+| surValider | fonction | La fonction de rappel que vous souhaitez déclencher lorsque l'utilisateur valide l'entrée |
+| minLignes | nombre | Le nombre minimum de lignes pour la zone de texte |
+| espace réservé | chaîne | Le texte d'espace réservé que vous souhaitez afficher lorsque la zone de texte est vide |
+| surFocus | fonction | La fonction de rappel que vous souhaitez déclencher lorsque la zone de texte prend le focus |
+| variante | chaîne | La variante de l'entrée. Les options incluent : `défaut`, `icône`, et `bouton` |
+| titreBouton | chaîne | Le titre pour le bouton (applicable uniquement à la variante bouton) |
+| valeur | chaîne | La valeur initiale pour la zone de texte |
+
+
+
+
+</Tab>
+
</Tabs>
## Zone de texte
@@ -100,31 +122,40 @@ Composant d'entrée de texte qui ajuste automatiquement sa hauteur en fonction d
Vous permet de créer des entrées de texte multiligne.
<Tabs>
- <Tab title="Utilisation">
- ```jsx
- import { TextArea } from "@/ui/input/components/TextArea";
-
- export const MyComponent = () => {
- return (
- <TextArea
- disabled={false}
- minRows={4}
- onChange={()=>console.log('On change function fired')}
- placeholder="Enter text here"
- value=""
- />
- );
- };
- ```
- </Tab>
-
- <Tab title="Propriétés">
- | Propriétés | Type | Description |
- | -------------- | -------- | --------------------------------------------------------------------------- |
- | désactivé | booléen | Indique si la zone de texte est désactivée |
- | minLignes | nombre | Nombre minimum de lignes visibles pour la zone de texte. |
- | surChangement | fonction | Fonction de rappel déclenchée lorsque le contenu de la zone de texte change |
- | espace réservé | chaîne | Texte de l'espace réservé affiché lorsque la zone de texte est vide |
- | valeur | chaîne | La valeur actuelle de la zone de texte |
- </Tab>
+<Tab title="Utilisation">
+
+```jsx
+import { TextArea } from "@/ui/input/components/TextArea";
+
+export const MyComponent = () => {
+ return (
+ <TextArea
+ disabled={false}
+ minRows={4}
+ onChange={()=>console.log('On change function fired')}
+ placeholder="Enter text here"
+ value=""
+ />
+ );
+};
+```
+
+
+</Tab>
+
+<Tab title="Propriétés">
+
+
+| Propriétés | Type | Description |
+| -------------- | -------- | --------------------------------------------------------------------------- |
+| désactivé | booléen | Indique si la zone de texte est désactivée |
+| minLignes | nombre | Nombre minimum de lignes visibles pour la zone de texte. |
+| surChangement | fonction | Fonction de rappel déclenchée lorsque le contenu de la zone de texte change |
+| espace réservé | chaîne | Texte de l'espace réservé affiché lorsque la zone de texte est vide |
+| valeur | chaîne | La valeur actuelle de la zone de texte |
+
+
+
+
+</Tab>
</Tabs>
diff --git a/packages/twenty-docs/l/fr/twenty-ui/input/toggle.mdx b/packages/twenty-docs/l/fr/twenty-ui/input/toggle.mdx
index 3a1b3f06745..97e31acd1e0 100644
--- a/packages/twenty-docs/l/fr/twenty-ui/input/toggle.mdx
+++ b/packages/twenty-docs/l/fr/twenty-ui/input/toggle.mdx
@@ -1,32 +1,38 @@
---
title: Basculer
+icon: toggle-on
---
-
<Tabs>
- <Tab title="Utilisation">
- ```jsx
- import { Toggle } from "twenty-ui/input";
-
- export const MyComponent = () => {
- return (
- <Toggle
- value = {true}
- onChange = {()=>console.log('On Change event')}
- color="green"
- toggleSize = "medium"
- />
- );
- };
- ```
- </Tab>
-
- <Tab title="Propriétés">
- | Propriétés | Type | Description | Par défaut |
- | -------------- | -------- | ------------------------------------------------------------------------------------------ | -------------------- |
- | valeur | booléen | The current state of the toggle | `faux` |
- | onChange | fonction | Callback function triggered when the toggle state changes | |
- | couleur | chaîne | Color of the toggle when it\ | est de couleur bleue |
- | tailleBasculer | chaîne | Size of the toggle, affecting both height and weight. A deux options : `small` et `medium` | moyen |
- </Tab>
+<Tab title="Utilisation">
+
+```jsx
+import { Toggle } from "twenty-ui/input";
+
+export const MyComponent = () => {
+ return (
+ <Toggle
+ value = {true}
+ onChange = {()=>console.log('On Change event')}
+ color="green"
+ toggleSize = "medium"
+ />
+ );
+};
+```
+
+</Tab>
+<Tab title="Propriétés">
+
+
+| Propriétés | Type | Description | Par défaut |
+| -------------- | -------- | ------------------------------------------------------------------------------------------ | -------------------- |
+| valeur | booléen | The current state of the toggle | `faux` |
+| onChange | fonction | Callback function triggered when the toggle state changes | |
+| couleur | chaîne | Color of the toggle when it\ | est de couleur bleue |
+| tailleBasculer | chaîne | Size of the toggle, affecting both height and weight. A deux options : `small` et `medium` | moyen |
+
+
+
+</Tab>
</Tabs>
diff --git a/packages/twenty-docs/l/fr/twenty-ui/introduction.mdx b/packages/twenty-docs/l/fr/twenty-ui/introduction.mdx
index 457360b3e47..92c8ede7cf5 100644
--- a/packages/twenty-docs/l/fr/twenty-ui/introduction.mdx
+++ b/packages/twenty-docs/l/fr/twenty-ui/introduction.mdx
@@ -1,5 +1,6 @@
---
title: Vue d'ensemble
+icon: palette
description: Bibliothèque de composants pour Twenty CRM
---
diff --git a/packages/twenty-docs/l/fr/twenty-ui/navigation.mdx b/packages/twenty-docs/l/fr/twenty-ui/navigation.mdx
index c35149192f8..41d210d7ddc 100644
--- a/packages/twenty-docs/l/fr/twenty-ui/navigation.mdx
+++ b/packages/twenty-docs/l/fr/twenty-ui/navigation.mdx
@@ -1,5 +1,6 @@
---
title: Navigation
+icon: boussole
---
<Frame>
diff --git a/packages/twenty-docs/l/fr/twenty-ui/navigation/breadcrumb.mdx b/packages/twenty-docs/l/fr/twenty-ui/navigation/breadcrumb.mdx
index ca35fe9b09e..0f259a75e61 100644
--- a/packages/twenty-docs/l/fr/twenty-ui/navigation/breadcrumb.mdx
+++ b/packages/twenty-docs/l/fr/twenty-ui/navigation/breadcrumb.mdx
@@ -9,32 +9,38 @@ title: Fil d'Ariane
Affiche une barre de navigation en fil d'Ariane.
<Tabs>
- <Tab title="Utilisation">
- ```jsx
- import { BrowserRouter } from "react-router-dom";
- import { Breadcrumb } from "@/ui/navigation/bread-crumb/components/Breadcrumb";
-
- export const MyComponent = () => {
- const breadcrumbLinks = [
- { children: "Home", href: "/" },
- { children: "Category", href: "/category" },
- { children: "Subcategory", href: "/category/subcategory" },
- { children: "Current Page" },
- ];
-
- return (
- <BrowserRouter>
- <Breadcrumb className links={breadcrumbLinks} />
- </BrowserRouter>
- )
- };
- ```
- </Tab>
-
- <Tab title="Propriétés">
- | Propriétés | Type | Description |
- | ----------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
- | nomDeClasse | chaîne | Nom de classe facultatif pour un style supplémentaire |
- | liens | tableau | Un tableau d'objets, chacun représentant un lien de fil d'Ariane. Chaque objet a une propriété `children` (le contenu textuel du lien) et une propriété `href` facultative (l'URL vers laquelle naviguer lorsque le lien est cliqué) |
- </Tab>
+<Tab title="Utilisation">
+
+```jsx
+import { BrowserRouter } from "react-router-dom";
+import { Breadcrumb } from "@/ui/navigation/bread-crumb/components/Breadcrumb";
+
+export const MyComponent = () => {
+ const breadcrumbLinks = [
+ { children: "Home", href: "/" },
+ { children: "Category", href: "/category" },
+ { children: "Subcategory", href: "/category/subcategory" },
+ { children: "Current Page" },
+ ];
+
+ return (
+ <BrowserRouter>
+ <Breadcrumb className links={breadcrumbLinks} />
+ </BrowserRouter>
+ )
+};
+```
+
+</Tab>
+<Tab title="Propriétés">
+
+
+| Propriétés | Type | Description |
+| ----------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| nomDeClasse | chaîne | Nom de classe facultatif pour un style supplémentaire |
+| liens | tableau | Un tableau d'objets, chacun représentant un lien de fil d'Ariane. Chaque objet a une propriété `children` (le contenu textuel du lien) et une propriété `href` facultative (l'URL vers laquelle naviguer lorsque le lien est cliqué) |
+
+
+
+</Tab>
</Tabs>
diff --git a/packages/twenty-docs/l/fr/twenty-ui/navigation/links.mdx b/packages/twenty-docs/l/fr/twenty-ui/navigation/links.mdx
index 87f9dee1325..ae5ce13ff80 100644
--- a/packages/twenty-docs/l/fr/twenty-ui/navigation/links.mdx
+++ b/packages/twenty-docs/l/fr/twenty-ui/navigation/links.mdx
@@ -1,5 +1,6 @@
---
title: Liens
+icon: lien
---
<Frame>
@@ -11,40 +12,49 @@ title: Liens
Un composant de lien stylisé pour afficher les informations de contact.
<Tabs>
- <Tab title="Utilisation">
- ```jsx
- import { BrowserRouter as Router } from 'react-router-dom';
-
- import { ContactLink } from 'twenty-ui/navigation';
-
- export const MyComponent = () => {
- const handleLinkClick = (event) => {
- console.log('Contact link clicked!', event);
- };
-
- return (
- <Router>
- <ContactLink
- className
- href="mailto:[email protected]"
- onClick={handleLinkClick}
- >
- </ContactLink>
- </Router>
- );
- };
- ```
- </Tab>
-
- <Tab title="Propriétés">
- | Propriétés | Type | Description |
- | ----------- | ----------------- | -------------------------------------------------------- |
- | nomDeClasse | chaîne | Nom facultatif pour un style supplémentaire |
- | href | chaîne | L'URL cible ou le chemin du lien |
- | onClick | fonction | Fonction de rappel à déclencher lors du clic sur le lien |
- | enfants | `React.ReactNode` | Le contenu à afficher à l'intérieur du lien |
- </Tab>
+<Tab title="Utilisation">
+
+```jsx
+import { BrowserRouter as Router } from 'react-router-dom';
+
+import { ContactLink } from 'twenty-ui/navigation';
+
+export const MyComponent = () => {
+ const handleLinkClick = (event) => {
+ console.log('Contact link clicked!', event);
+ };
+
+ return (
+ <Router>
+ <ContactLink
+ className
+ href="mailto:[email protected]"
+ onClick={handleLinkClick}
+ >
+ </ContactLink>
+ </Router>
+ );
+};
+```
+
+
+</Tab>
+<Tab title="Propriétés">
+
+
+| Propriétés | Type | Description |
+| ----------- | ----------------- | -------------------------------------------------------- |
+| nomDeClasse | chaîne | Nom facultatif pour un style supplémentaire |
+| href | chaîne | L'URL cible ou le chemin du lien |
+| onClick | fonction | Fonction de rappel à déclencher lors du clic sur le lien |
+| enfants | `React.ReactNode` | Le contenu à afficher à l'intérieur du lien |
+
+
+
+
+</Tab>
+
</Tabs>
## Lien brut
@@ -52,36 +62,44 @@ Un composant de lien stylisé pour afficher les informations de contact.
Un composant de lien stylisé pour afficher les liens.
<Tabs>
- <Tab title="Utilisation">
- ```jsx
- import { RawLink } from "/navigation";
- import { BrowserRouter as Router } from "react-router-dom";
-
- export const MyComponent = () => {
- const handleLinkClick = (event) => {
- console.log("Contact link clicked!", event);
- };
-
- return (
- <Router>
- <RawLink className href="/contact" onClick={handleLinkClick}>
- Contact Us
- </RawLink>
- </Router>
- );
- };
-
- ```
- </Tab>
-
- <Tab title="Propriétés">
- | Propriétés | Type | Description |
- | ----------- | ----------------- | -------------------------------------------------------- |
- | nomDeClasse | chaîne | Nom facultatif pour un style supplémentaire |
- | href | chaîne | L'URL cible ou le chemin du lien |
- | onClick | fonction | Fonction de rappel à déclencher lors du clic sur le lien |
- | enfants | `React.ReactNode` | Le contenu à afficher à l'intérieur du lien |
- </Tab>
+<Tab title="Utilisation">
+
+```jsx
+import { RawLink } from "/navigation";
+import { BrowserRouter as Router } from "react-router-dom";
+
+export const MyComponent = () => {
+ const handleLinkClick = (event) => {
+ console.log("Contact link clicked!", event);
+ };
+
+ return (
+ <Router>
+ <RawLink className href="/contact" onClick={handleLinkClick}>
+ Contact Us
+ </RawLink>
+ </Router>
+ );
+};
+
+```
+
+
+</Tab>
+<Tab title="Propriétés">
+
+
+| Propriétés | Type | Description |
+| ----------- | ----------------- | -------------------------------------------------------- |
+| nomDeClasse | chaîne | Nom facultatif pour un style supplémentaire |
+| href | chaîne | L'URL cible ou le chemin du lien |
+| onClick | fonction | Fonction de rappel à déclencher lors du clic sur le lien |
+| enfants | `React.ReactNode` | Le contenu à afficher à l'intérieur du lien |
+
+
+
+
+</Tab>
</Tabs>
## Lien arrondi
@@ -89,34 +107,41 @@ Un composant de lien stylisé pour afficher les liens.
Un lien de style arrondi avec un composant Chip pour les liens.
<Tabs>
- <Tab title="Utilisation">
- ```jsx
- import { RoundedLink } from "/navigation";
- import { BrowserRouter as Router } from "react-router-dom";
-
- export const MyComponent = () => {
- const handleLinkClick = (event) => {
- console.log("Contact link clicked!", event);
- };
-
- return (
- <Router>
- <RoundedLink href="/contact" onClick={handleLinkClick}>
- Contact Us
- </RoundedLink>
- </Router>
- );
- };
- ```
- </Tab>
-
- <Tab title="Propriétés">
- | Propriétés | Type | Description |
- | ---------- | ----------------- | -------------------------------------------------------- |
- | href | chaîne | L'URL cible ou le chemin du lien |
- | enfants | `React.ReactNode` | Le contenu à afficher à l'intérieur du lien |
- | onClick | fonction | Fonction de rappel à déclencher lors du clic sur le lien |
- </Tab>
+<Tab title="Utilisation">
+
+```jsx
+import { RoundedLink } from "/navigation";
+import { BrowserRouter as Router } from "react-router-dom";
+
+export const MyComponent = () => {
+ const handleLinkClick = (event) => {
+ console.log("Contact link clicked!", event);
+ };
+
+ return (
+ <Router>
+ <RoundedLink href="/contact" onClick={handleLinkClick}>
+ Contact Us
+ </RoundedLink>
+ </Router>
+ );
+};
+```
+
+</Tab>
+
+<Tab title="Propriétés">
+
+
+| Propriétés | Type | Description |
+| ---------- | ----------------- | -------------------------------------------------------- |
+| href | chaîne | L'URL cible ou le chemin du lien |
+| enfants | `React.ReactNode` | Le contenu à afficher à l'intérieur du lien |
+| onClick | fonction | Fonction de rappel à déclencher lors du clic sur le lien |
+
+
+
+</Tab>
</Tabs>
## Lien social
@@ -124,30 +149,37 @@ Un lien de style arrondi avec un composant Chip pour les liens.
Liens sociaux stylisés, avec support pour différents types de liens sociaux, tels que les URL, LinkedIn, et X (ou Twitter).
<Tabs>
- <Tab title="Utilisation">
- ```jsx
- import { SocialLink } from "twenty-ui/navigation";
- import { BrowserRouter as Router } from "react-router-dom";
-
- export const MyComponent = () => {
- return (
- <Router>
- <SocialLink
- type="twitter"
- href="https://twitter.com/twentycrm"
- ></SocialLink>
- </Router>
- );
- };
- ```
- </Tab>
-
- <Tab title="Propriétés">
- | Propriétés | Type | Description |
- | ---------- | ----------------- | ------------------------------------------------------------------------------- |
- | href | chaîne | L'URL cible ou le chemin du lien |
- | enfants | `React.ReactNode` | Le contenu à afficher à l'intérieur du lien |
- | type | chaîne | Le type de liens sociaux. Les options incluent: `url`, `LinkedIn`, et `Twitter` |
- | onClick | fonction | Fonction de rappel à déclencher lors du clic sur le lien |
- </Tab>
+<Tab title="Utilisation">
+
+```jsx
+import { SocialLink } from "twenty-ui/navigation";
+import { BrowserRouter as Router } from "react-router-dom";
+
+export const MyComponent = () => {
+ return (
+ <Router>
+ <SocialLink
+ type="twitter"
+ href="https://twitter.com/twentycrm"
+ ></SocialLink>
+ </Router>
+ );
+};
+```
+
+</Tab>
+<Tab title="Propriétés">
+
+
+| Propriétés | Type | Description |
+| ---------- | ----------------- | ------------------------------------------------------------------------------- |
+| href | chaîne | L'URL cible ou le chemin du lien |
+| enfants | `React.ReactNode` | Le contenu à afficher à l'intérieur du lien |
+| type | chaîne | Le type de liens sociaux. Les options incluent: `url`, `LinkedIn`, et `Twitter` |
+| onClick | fonction | Fonction de rappel à déclencher lors du clic sur le lien |
+
+
+
+
+</Tab>
</Tabs>
diff --git a/packages/twenty-docs/l/fr/twenty-ui/navigation/menu-item.mdx b/packages/twenty-docs/l/fr/twenty-ui/navigation/menu-item.mdx
index 03d22f0feef..13259dfbfc0 100644
--- a/packages/twenty-docs/l/fr/twenty-ui/navigation/menu-item.mdx
+++ b/packages/twenty-docs/l/fr/twenty-ui/navigation/menu-item.mdx
@@ -1,54 +1,62 @@
---
title: Élément de menu
+icon: barres
---
-
Un élément de menu polyvalent conçu pour être utilisé dans un menu ou une liste de navigation.
<Tabs>
- <Tab title="Utilisation">
- ```jsx
- import { IconBell } from "@tabler/icons-react";
- import { IconAlertCircle } from "@tabler/icons-react";
- import { MenuItem } from "twenty-ui/display";
-
- export const MyComponent = () => {
- const handleMenuItemClick = (event) => {
- console.log("Menu item clicked!", event);
- };
-
- const handleButtonClick = (event) => {
- console.log("Icon button clicked!", event);
- };
-
- return (
- <MenuItem
- LeftIcon={IconBell}
- accent="default"
- text="Menu item text"
- iconButtons={[{ Icon: IconAlertCircle, onClick: handleButtonClick }]}
- isTooltipOpen={true}
- testId="menu-item-1"
- onClick={handleMenuItemClick}
- className
- />
- );
- };
- ```
- </Tab>
-
- <Tab title="Propriétés">
- | Propriétés | Type | Description |
- | ------------------ | -------------- | -------------------------------------------------------------------------------------------------------------- |
- | IcôneGauche | ComposantIcône | Une icône gauche optionnelle affichée avant le texte dans l'élément de menu |
- | accent | chaîne | Spécifie la couleur d'accent de l'élément de menu. Les options incluent : `default`, `danger` et `placeholder` |
- | texte | chaîne | Le contenu textuel de l'élément de menu |
- | boutonsD'icone | tableau | Un tableau d'objets représentant des boutons d'icône supplémentaires associés à l'élément de menu |
- | estInfobulleOuvert | booléen | Contrôle la visibilité de l'infobulle associée à l'élément de menu |
- | identifiantDeTest | chaîne | L'attribut data-testid pour les tests |
- | auClique | fonction | Fonction de rappel déclenchée lorsque l'élément de menu est cliqué |
- | nomDeClasse | chaîne | Nom facultatif pour un style supplémentaire |
- </Tab>
+<Tab title="Utilisation">
+
+```jsx
+import { IconBell } from "@tabler/icons-react";
+import { IconAlertCircle } from "@tabler/icons-react";
+import { MenuItem } from "twenty-ui/display";
+
+export const MyComponent = () => {
+ const handleMenuItemClick = (event) => {
+ console.log("Menu item clicked!", event);
+ };
+
+ const handleButtonClick = (event) => {
+ console.log("Icon button clicked!", event);
+ };
+
+ return (
+ <MenuItem
+ LeftIcon={IconBell}
+ accent="default"
+ text="Menu item text"
+ iconButtons={[{ Icon: IconAlertCircle, onClick: handleButtonClick }]}
+ isTooltipOpen={true}
+ testId="menu-item-1"
+ onClick={handleMenuItemClick}
+ className
+ />
+ );
+};
+```
+
+
+</Tab>
+<Tab title="Propriétés">
+
+
+| Propriétés | Type | Description |
+| ------------------ | -------------- | -------------------------------------------------------------------------------------------------------------- |
+| IcôneGauche | ComposantIcône | Une icône gauche optionnelle affichée avant le texte dans l'élément de menu |
+| accent | chaîne | Spécifie la couleur d'accent de l'élément de menu. Les options incluent : `default`, `danger` et `placeholder` |
+| texte | chaîne | Le contenu textuel de l'élément de menu |
+| boutonsD'icone | tableau | Un tableau d'objets représentant des boutons d'icône supplémentaires associés à l'élément de menu |
+| estInfobulleOuvert | booléen | Contrôle la visibilité de l'infobulle associée à l'élément de menu |
+| identifiantDeTest | chaîne | L'attribut data-testid pour les tests |
+| auClique | fonction | Fonction de rappel déclenchée lorsque l'élément de menu est cliqué |
+| nomDeClasse | chaîne | Nom facultatif pour un style supplémentaire |
+
+
+
+
+</Tab>
</Tabs>
## Variantes
@@ -60,42 +68,49 @@ Les différentes variantes du composant d'élément de menu incluent les suivant
Un élément de menu de style commande dans un menu pour indiquer des raccourcis clavier.
<Tabs>
- <Tab title="Utilisation">
- ```jsx
- import { IconBell } from "@tabler/icons-react";
- import { MenuItemCommand } from "twenty-ui/display";
-
- export const MyComponent = () => {
- const handleCommandClick = () => {
- console.log("Command clicked!");
- };
-
- return (
- <MenuItemCommand
- LeftIcon={IconBell}
- text="First Option"
- firstHotKey="⌘"
- secondHotKey="1"
- isSelected={true}
- onClick={handleCommandClick}
- className
- />
- );
- };
- ```
- </Tab>
-
- <Tab title="Propriétés">
- | Propriétés | Type | Description |
- | ----------------- | -------------- | ----------------------------------------------------------------------------- |
- | LeftIcon | ComposantIcône | Une icône à gauche optionnelle affichée avant le texte dans l'élément de menu |
- | texte | chaîne | Le contenu texte de l'élément de menu |
- | premierRaccourci | chaîne | Le premier raccourci clavier associé à la commande |
- | deuxièmeRaccourci | chaîne | Le deuxième raccourci clavier associé à la commande |
- | estSélectionné | booléen | Indique si l'élément de menu est sélectionné ou surligné |
- | onClick | fonction | Fonction de rappel déclenchée lorsqu'on clique sur l'élément de menu |
- | nomDeClasse | chaîne | Nom facultatif pour un style supplémentaire |
- </Tab>
+<Tab title="Utilisation">
+
+```jsx
+import { IconBell } from "@tabler/icons-react";
+import { MenuItemCommand } from "twenty-ui/display";
+
+export const MyComponent = () => {
+ const handleCommandClick = () => {
+ console.log("Command clicked!");
+ };
+
+ return (
+ <MenuItemCommand
+ LeftIcon={IconBell}
+ text="First Option"
+ firstHotKey="⌘"
+ secondHotKey="1"
+ isSelected={true}
+ onClick={handleCommandClick}
+ className
+ />
+ );
+};
+```
+
+
+</Tab>
+<Tab title="Propriétés">
+
+
+| Propriétés | Type | Description |
+| ----------------- | -------------- | ----------------------------------------------------------------------------- |
+| LeftIcon | ComposantIcône | Une icône à gauche optionnelle affichée avant le texte dans l'élément de menu |
+| texte | chaîne | Le contenu texte de l'élément de menu |
+| premierRaccourci | chaîne | Le premier raccourci clavier associé à la commande |
+| deuxièmeRaccourci | chaîne | Le deuxième raccourci clavier associé à la commande |
+| estSélectionné | booléen | Indique si l'élément de menu est sélectionné ou surligné |
+| onClick | fonction | Fonction de rappel déclenchée lorsqu'on clique sur l'élément de menu |
+| nomDeClasse | chaîne | Nom facultatif pour un style supplémentaire |
+
+
+
+</Tab>
</Tabs>
### Draggable
@@ -103,45 +118,52 @@ Un élément de menu de style commande dans un menu pour indiquer des raccourcis
Un élément de menu draggable conçu pour être utilisé dans un menu ou une liste où les éléments peuvent être glissés, et des actions supplémentaires peuvent être effectuées via les boutons d'icônes.
<Tabs>
- <Tab title="Utilisation">
- ```jsx
- import { IconBell } from "@tabler/icons-react";
- import { IconAlertCircle } from "@tabler/icons-react";
- import { MenuItemDraggable } from "twenty-ui/display";
-
- export const MyComponent = () => {
- const handleMenuItemClick = (event) => {
- console.log("Menu item clicked!", event);
- };
-
- return (
- <MenuItemDraggable
- LeftIcon={IconBell}
- accent="default"
- iconButtons={[{ Icon: IconAlertCircle, onClick: handleButtonClick }]}
- isTooltipOpen={false}
- onClick={handleMenuItemClick}
- text="Menu item draggable"
- isDragDisabled={false}
- className
- />
- );
- };
- ```
- </Tab>
-
- <Tab title="Propriétés">
- | Propriétés | Type | Description |
- | -------------- | -------------- | -------------------------------------------------------------------------------------------------- |
- | LeftIcon | ComposantIcône | Une icône à gauche optionnelle affichée avant le texte dans l'élément de menu |
- | accent | chaîne | La couleur d'accent de l'élément de menu. Elle peut être `défaut`, `placeholder`, et `danger` |
- | iconButtons | tableau | Un tableau d'objets représentant des boutons d'icônes supplémentaires associés à l'élément de menu |
- | isTooltipOpen | booléen | Contrôle la visibilité de l'infobulle associée à l'élément de menu |
- | onClick | fonction | Fonction de rappel à déclencher lorsque le lien est cliqué |
- | texte | chaîne | Le contenu texte de l'élément de menu |
- | isDragDisabled | booléen | Indique si le glissement est désactivé |
- | nomDeClasse | chaîne | Nom facultatif pour un style supplémentaire |
- </Tab>
+<Tab title="Utilisation">
+
+```jsx
+import { IconBell } from "@tabler/icons-react";
+import { IconAlertCircle } from "@tabler/icons-react";
+import { MenuItemDraggable } from "twenty-ui/display";
+
+export const MyComponent = () => {
+ const handleMenuItemClick = (event) => {
+ console.log("Menu item clicked!", event);
+ };
+
+ return (
+ <MenuItemDraggable
+ LeftIcon={IconBell}
+ accent="default"
+ iconButtons={[{ Icon: IconAlertCircle, onClick: handleButtonClick }]}
+ isTooltipOpen={false}
+ onClick={handleMenuItemClick}
+ text="Menu item draggable"
+ isDragDisabled={false}
+ className
+ />
+ );
+};
+```
+
+</Tab>
+<Tab title="Propriétés">
+
+
+| Propriétés | Type | Description |
+| -------------- | -------------- | -------------------------------------------------------------------------------------------------- |
+| LeftIcon | ComposantIcône | Une icône à gauche optionnelle affichée avant le texte dans l'élément de menu |
+| accent | chaîne | La couleur d'accent de l'élément de menu. Elle peut être `défaut`, `placeholder`, et `danger` |
+| iconButtons | tableau | Un tableau d'objets représentant des boutons d'icônes supplémentaires associés à l'élément de menu |
+| isTooltipOpen | booléen | Contrôle la visibilité de l'infobulle associée à l'élément de menu |
+| onClick | fonction | Fonction de rappel à déclencher lorsque le lien est cliqué |
+| texte | chaîne | Le contenu texte de l'élément de menu |
+| isDragDisabled | booléen | Indique si le glissement est désactivé |
+| nomDeClasse | chaîne | Nom facultatif pour un style supplémentaire |
+
+
+
+
+</Tab>
</Tabs>
### Sélection multiple
@@ -149,34 +171,41 @@ Un élément de menu draggable conçu pour être utilisé dans un menu ou une li
Fournit un moyen d'implémenter une fonctionnalité de sélection multiple avec une case à cocher associée.
<Tabs>
- <Tab title="Utilisation">
- ```jsx
- import { IconBell } from "@tabler/icons-react";
- import { MenuItemMultiSelect } from "twenty-ui/display";
-
- export const MyComponent = () => {
-
- return (
- <MenuItemMultiSelect
- LeftIcon={IconBell}
- text="First Option"
- selected={false}
- className
- />
- );
- };
- ```
- </Tab>
-
- <Tab title="Propriétés">
- | Propriétés | Type | Description |
- | -------------- | -------------- | ----------------------------------------------------------------------------- |
- | LeftIcon | ComposantIcône | Une icône à gauche optionnelle affichée avant le texte dans l'élément de menu |
- | texte | chaîne | Le contenu texte de l'élément de menu |
- | sélectionné | booléen | Indique si l'élément de menu est sélectionné (coché) |
- | onSelectChange | fonction | Fonction de rappel déclenchée lorsque l'état de la case à cocher change |
- | nomDeClasse | chaîne | Nom facultatif pour un style supplémentaire |
- </Tab>
+<Tab title="Utilisation">
+
+```jsx
+import { IconBell } from "@tabler/icons-react";
+import { MenuItemMultiSelect } from "twenty-ui/display";
+
+export const MyComponent = () => {
+
+ return (
+ <MenuItemMultiSelect
+ LeftIcon={IconBell}
+ text="First Option"
+ selected={false}
+ className
+ />
+ );
+};
+```
+
+</Tab>
+<Tab title="Propriétés">
+
+
+| Propriétés | Type | Description |
+| -------------- | -------------- | ----------------------------------------------------------------------------- |
+| LeftIcon | ComposantIcône | Une icône à gauche optionnelle affichée avant le texte dans l'élément de menu |
+| texte | chaîne | Le contenu texte de l'élément de menu |
+| sélectionné | booléen | Indique si l'élément de menu est sélectionné (coché) |
+| onSelectChange | fonction | Fonction de rappel déclenchée lorsque l'état de la case à cocher change |
+| nomDeClasse | chaîne | Nom facultatif pour un style supplémentaire |
+
+
+
+
+</Tab>
</Tabs>
### Sélection multiple avec avatar
@@ -184,35 +213,42 @@ Fournit un moyen d'implémenter une fonctionnalité de sélection multiple avec
Un élément de menu multi-sélection avec un avatar, une case à cocher pour la sélection, et du contenu textuel.
<Tabs>
- <Tab title="Utilisation">
- ```jsx
- import { MenuItemMultiSelectAvatar } from "twenty-ui/display";
-
- export const MyComponent = () => {
- const imageUrl =
- "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAYABgAAD/4QCMRXhpZgAATU0AKgAAAAgABQESAAMAAAABAAEAAAEaAAUAAAABAAAASgEbAAUAAAABAAAAUgEoAAMAAAABAAIAAIdpAAQAAAABAAAAWgAAAAAAAABgAAAAAQAAAGAAAAABAAOgAQADAAAAAQABAACgAgAEAAAAAQAAABSgAwAEAAAAAQAAABQAAAAA/8AAEQgAFAAUAwEiAAIRAQMRAf/EAB8AAAEFAQEBAQEBAAAAAAAAAAABAgMEBQYHCAkKC//EALUQAAIBAwMCBAMFBQQEAAABfQECAwAEEQUSITFBBhNRYQcicRQygZGhCCNCscEVUtHwJDNicoIJChYXGBkaJSYnKCkqNDU2Nzg5OkNERUZHSElKU1RVVldYWVpjZGVmZ2hpanN0dXZ3eHl6g4SFhoeIiYqSk5SVlpeYmZqio6Slpqeoqaqys7S1tre4ubrCw8TFxsfIycrS09TV1tfY2drh4uPk5ebn6Onq8fLz9PX29/j5+v/EAB8BAAMBAQEBAQEBAQEAAAAAAAABAgMEBQYHCAkKC//EALURAAIBAgQEAwQHBQQEAAECdwABAgMRBAUhMQYSQVEHYXETIjKBCBRCkaGxwQkjM1LwFWJy0QoWJDThJfEXGBkaJicoKSo1Njc4OTpDREVGR0hJSlNUVVZXWFlaY2RlZmdoaWpzdHV2d3h5eoKDhIWGh4iJipKTlJWWl5iZmqKjpKWmp6ipqrKztLW2t7i5usLDxMXGx8jJytLT1NXW19jZ2uLj5OXm5+jp6vLz9PX29/j5+v/bAEMACwgICggHCwoJCg0MCw0RHBIRDw8RIhkaFBwpJCsqKCQnJy0yQDctMD0wJyc4TDk9Q0VISUgrNk9VTkZUQEdIRf/bAEMBDA0NEQ8RIRISIUUuJy5FRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRf/dAAQAAv/aAAwDAQACEQMRAD8Ava1q728otYY98joSCTgZrnbXWdTtrhrfVZXWLafmcAEkdgR/hVltQku9Q8+OIEBcGOT+ID0PY1ka1KH2u8ToqnPLbmIqG7u6LtbQ7RXBRec4Uck9eKXcPWsKDWVnhWSL5kYcFelSf2m3901POh8jP//QoyIAnTuKpXsY82NsksUyWPU5q/L9z8RVK++/F/uCsVsaEURwgA4HtT9x9TUcf3KfUGh//9k=";
-
- return (
- <MenuItemMultiSelectAvatar
- avatar={<img src={imageUrl} alt="Avatar" />}
- text="First Option"
- selected={false}
- className
- />
- );
- };
- ```
- </Tab>
-
- <Tab title="Propriétés">
- | Propriétés | Type | Description |
- | -------------- | ----------- | ----------------------------------------------------------------------- |
- | avatar | `ReactNode` | L'avatar ou l'icône à afficher sur le côté gauche de l'élément de menu |
- | texte | chaîne | Le contenu texte de l'élément de menu |
- | sélectionné | booléen | Indique si l'élément de menu est sélectionné (coché) |
- | onSelectChange | fonction | Fonction de rappel déclenchée lorsque l'état de la case à cocher change |
- | nomDeClasse | chaîne | Nom facultatif pour un style supplémentaire |
- </Tab>
+<Tab title="Utilisation">
+
+```jsx
+import { MenuItemMultiSelectAvatar } from "twenty-ui/display";
+
+export const MyComponent = () => {
+ const imageUrl =
+ "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAYABgAAD/4QCMRXhpZgAATU0AKgAAAAgABQESAAMAAAABAAEAAAEaAAUAAAABAAAASgEbAAUAAAABAAAAUgEoAAMAAAABAAIAAIdpAAQAAAABAAAAWgAAAAAAAABgAAAAAQAAAGAAAAABAAOgAQADAAAAAQABAACgAgAEAAAAAQAAABSgAwAEAAAAAQAAABQAAAAA/8AAEQgAFAAUAwEiAAIRAQMRAf/EAB8AAAEFAQEBAQEBAAAAAAAAAAABAgMEBQYHCAkKC//EALUQAAIBAwMCBAMFBQQEAAABfQECAwAEEQUSITFBBhNRYQcicRQygZGhCCNCscEVUtHwJDNicoIJChYXGBkaJSYnKCkqNDU2Nzg5OkNERUZHSElKU1RVVldYWVpjZGVmZ2hpanN0dXZ3eHl6g4SFhoeIiYqSk5SVlpeYmZqio6Slpqeoqaqys7S1tre4ubrCw8TFxsfIycrS09TV1tfY2drh4uPk5ebn6Onq8fLz9PX29/j5+v/EAB8BAAMBAQEBAQEBAQEAAAAAAAABAgMEBQYHCAkKC//EALURAAIBAgQEAwQHBQQEAAECdwABAgMRBAUhMQYSQVEHYXETIjKBCBRCkaGxwQkjM1LwFWJy0QoWJDThJfEXGBkaJicoKSo1Njc4OTpDREVGR0hJSlNUVVZXWFlaY2RlZmdoaWpzdHV2d3h5eoKDhIWGh4iJipKTlJWWl5iZmqKjpKWmp6ipqrKztLW2t7i5usLDxMXGx8jJytLT1NXW19jZ2uLj5OXm5+jp6vLz9PX29/j5+v/bAEMACwgICggHCwoJCg0MCw0RHBIRDw8RIhkaFBwpJCsqKCQnJy0yQDctMD0wJyc4TDk9Q0VISUgrNk9VTkZUQEdIRf/bAEMBDA0NEQ8RIRISIUUuJy5FRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRf/dAAQAAv/aAAwDAQACEQMRAD8Ava1q728otYY98joSCTgZrnbXWdTtrhrfVZXWLafmcAEkdgR/hVltQku9Q8+OIEBcGOT+ID0PY1ka1KH2u8ToqnPLbmIqG7u6LtbQ7RXBRec4Uck9eKXcPWsKDWVnhWSL5kYcFelSf2m3901POh8jP//QoyIAnTuKpXsY82NsksUyWPU5q/L9z8RVK++/F/uCsVsaEURwgA4HtT9x9TUcf3KfUGh//9k=";
+
+ return (
+ <MenuItemMultiSelectAvatar
+ avatar={<img src={imageUrl} alt="Avatar" />}
+ text="First Option"
+ selected={false}
+ className
+ />
+ );
+};
+```
+
+</Tab>
+<Tab title="Propriétés">
+
+
+| Propriétés | Type | Description |
+| -------------- | ----------- | ----------------------------------------------------------------------- |
+| avatar | `ReactNode` | L'avatar ou l'icône à afficher sur le côté gauche de l'élément de menu |
+| texte | chaîne | Le contenu texte de l'élément de menu |
+| sélectionné | booléen | Indique si l'élément de menu est sélectionné (coché) |
+| onSelectChange | fonction | Fonction de rappel déclenchée lorsque l'état de la case à cocher change |
+| nomDeClasse | chaîne | Nom facultatif pour un style supplémentaire |
+
+
+
+
+</Tab>
</Tabs>
### Naviguer
@@ -220,36 +256,43 @@ Un élément de menu multi-sélection avec un avatar, une case à cocher pour la
Un élément de menu comportant une icône facultative à gauche, un contenu textuel, et une icône de chevron droite.
<Tabs>
- <Tab title="Utilisation">
- ```jsx
- import { IconBell } from "@tabler/icons-react";
- import { MenuItemNavigate } from "twenty-ui/display";
-
- export const MyComponent = () => {
- const handleNavigation = () => {
- console.log("Navigate to another page");
- };
-
- return (
- <MenuItemNavigate
- LeftIcon={IconBell}
- text="First Option"
- onClick={handleNavigation}
- className
- />
- );
- };
- ```
- </Tab>
-
- <Tab title="Propriétés">
- | Propriétés | Type | Description |
- | ----------- | -------------- | ----------------------------------------------------------------------------- |
- | LeftIcon | ComposantIcône | Une icône à gauche optionnelle affichée avant le texte dans l'élément de menu |
- | texte | chaîne | Le contenu texte de l'élément de menu |
- | onClick | fonction | Fonction de rappel à déclencher lorsqu'on clique sur l'élément de menu |
- | nomDeClasse | chaîne | Nom facultatif pour un style supplémentaire |
- </Tab>
+<Tab title="Utilisation">
+
+```jsx
+import { IconBell } from "@tabler/icons-react";
+import { MenuItemNavigate } from "twenty-ui/display";
+
+export const MyComponent = () => {
+ const handleNavigation = () => {
+ console.log("Navigate to another page");
+ };
+
+ return (
+ <MenuItemNavigate
+ LeftIcon={IconBell}
+ text="First Option"
+ onClick={handleNavigation}
+ className
+ />
+ );
+};
+```
+
+</Tab>
+<Tab title="Propriétés">
+
+
+| Propriétés | Type | Description |
+| ----------- | -------------- | ----------------------------------------------------------------------------- |
+| LeftIcon | ComposantIcône | Une icône à gauche optionnelle affichée avant le texte dans l'élément de menu |
+| texte | chaîne | Le contenu texte de l'élément de menu |
+| onClick | fonction | Fonction de rappel à déclencher lorsqu'on clique sur l'élément de menu |
+| nomDeClasse | chaîne | Nom facultatif pour un style supplémentaire |
+
+
+
+
+</Tab>
</Tabs>
### Sélectionner
@@ -257,42 +300,49 @@ Un élément de menu comportant une icône facultative à gauche, un contenu tex
Un élément de menu sélectionnable, avec un contenu facultatif à gauche (icône et texte) et un indicateur (icône de coche) pour l'état sélectionné.
<Tabs>
- <Tab title="Utilisation">
- ```jsx
- import { IconBell } from "@tabler/icons-react";
- import { MenuItemSelect } from "twenty-ui/display";
-
- export const MyComponent = () => {
- const handleSelection = () => {
- console.log("Menu item selected");
- };
-
- return (
- <MenuItemSelect
- LeftIcon={IconBell}
- text="First Option"
- selected={true}
- disabled={false}
- hovered={false}
- onClick={handleSelection}
- className
- />
- );
- };
- ```
- </Tab>
-
- <Tab title="Propriétés">
- | Propriétés | Type | Description |
- | ----------- | -------------- | ----------------------------------------------------------------------------- |
- | LeftIcon | ComposantIcône | Une icône à gauche optionnelle affichée avant le texte dans l'élément de menu |
- | texte | chaîne | Le contenu texte de l'élément de menu |
- | sélectionné | booléen | Indique si l'élément de menu est sélectionné (coché) |
- | désactivé | booléen | Indique si l'élément de menu est désactivé |
- | survolé | booléen | Indique si l'élément de menu est actuellement survolé |
- | onClick | fonction | Fonction de rappel à déclencher lorsqu'on clique sur l'élément de menu |
- | nomDeClasse | chaîne | Nom facultatif pour un style supplémentaire |
- </Tab>
+<Tab title="Utilisation">
+
+```jsx
+import { IconBell } from "@tabler/icons-react";
+import { MenuItemSelect } from "twenty-ui/display";
+
+export const MyComponent = () => {
+ const handleSelection = () => {
+ console.log("Menu item selected");
+ };
+
+ return (
+ <MenuItemSelect
+ LeftIcon={IconBell}
+ text="First Option"
+ selected={true}
+ disabled={false}
+ hovered={false}
+ onClick={handleSelection}
+ className
+ />
+ );
+};
+```
+
+</Tab>
+<Tab title="Propriétés">
+
+
+| Propriétés | Type | Description |
+| ----------- | -------------- | ----------------------------------------------------------------------------- |
+| LeftIcon | ComposantIcône | Une icône à gauche optionnelle affichée avant le texte dans l'élément de menu |
+| texte | chaîne | Le contenu texte de l'élément de menu |
+| sélectionné | booléen | Indique si l'élément de menu est sélectionné (coché) |
+| désactivé | booléen | Indique si l'élément de menu est désactivé |
+| survolé | booléen | Indique si l'élément de menu est actuellement survolé |
+| onClick | fonction | Fonction de rappel à déclencher lorsqu'on clique sur l'élément de menu |
+| nomDeClasse | chaîne | Nom facultatif pour un style supplémentaire |
+
+
+
+
+</Tab>
</Tabs>
### Sélectionner Avatar
@@ -300,47 +350,54 @@ Un élément de menu sélectionnable, avec un contenu facultatif à gauche (icô
Un élément de menu sélectionnable avec un avatar, avec un contenu facultatif à gauche (avatar et texte) et un indicateur (icône de coche) pour l'état sélectionné.
<Tabs>
- <Tab title="Utilisation">
- ```jsx
- import { MenuItemSelectAvatar } from "twenty-ui/display";
-
- export const MyComponent = () => {
- const imageUrl =
- "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAYABgAAD/4QCMRXhpZgAATU0AKgAAAAgABQESAAMAAAABAAEAAAEaAAUAAAABAAAASgEbAAUAAAABAAAAUgEoAAMAAAABAAIAAIdpAAQAAAABAAAAWgAAAAAAAABgAAAAAQAAAGAAAAABAAOgAQADAAAAAQABAACgAgAEAAAAAQAAABSgAwAEAAAAAQAAABQAAAAA/8AAEQgAFAAUAwEiAAIRAQMRAf/EAB8AAAEFAQEBAQEBAAAAAAAAAAABAgMEBQYHCAkKC//EALUQAAIBAwMCBAMFBQQEAAABfQECAwAEEQUSITFBBhNRYQcicRQygZGhCCNCscEVUtHwJDNicoIJChYXGBkaJSYnKCkqNDU2Nzg5OkNERUZHSElKU1RVVldYWVpjZGVmZ2hpanN0dXZ3eHl6g4SFhoeIiYqSk5SVlpeYmZqio6Slpqeoqaqys7S1tre4ubrCw8TFxsfIycrS09TV1tfY2drh4uPk5ebn6Onq8fLz9PX29/j5+v/EAB8BAAMBAQEBAQEBAQEAAAAAAAABAgMEBQYHCAkKC//EALURAAIBAgQEAwQHBQQEAAECdwABAgMRBAUhMQYSQVEHYXETIjKBCBRCkaGxwQkjM1LwFWJy0QoWJDThJfEXGBkaJicoKSo1Njc4OTpDREVGR0hJSlNUVVZXWFlaY2RlZmdoaWpzdHV2d3h5eoKDhIWGh4iJipKTlJWWl5iZmqKjpKWmp6ipqrKztLW2t7i5usLDxMXGx8jJytLT1NXW19jZ2uLj5OXm5+jp6vLz9PX29/j5+v/bAEMACwgICggHCwoJCg0MCw0RHBIRDw8RIhkaFBwpJCsqKCQnJy0yQDctMD0wJyc4TDk9Q0VISUgrNk9VTkZUQEdIRf/bAEMBDA0NEQ8RIRISIUUuJy5FRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRf/dAAQAAv/aAAwDAQACEQMRAD8Ava1q728otYY98joSCTgZrnbXWdTtrhrfVZXWLafmcAEkdgR/hVltQku9Q8+OIEBcGOT+ID0PY1ka1KH2u8ToqnPLbmIqG7u6LtbQ7RXBRec4Uck9eKXcPWsKDWVnhWSL5kYcFelSf2m3901POh8jP//QoyIAnTuKpXsY82NsksUyWPU5q/L9z8RVK++/F/uCsVsaEURwgA4HtT9x9TUcf3KfUGh//9k=";
-
- const handleSelection = () => {
- console.log("Menu item selected");
- };
-
- return (
- <MenuItemSelectAvatar
- avatar={<img src={imageUrl} alt="Avatar" />}
- text="First Option"
- selected={true}
- disabled={false}
- hovered={false}
- testId="menu-item-test"
- onClick={handleSelection}
- className
- />
- );
- };
-
- ```
- </Tab>
-
- <Tab title="Propriétés">
- | Propriétés | Type | Description |
- | ----------- | ----------- | ---------------------------------------------------------------------- |
- | avatar | `ReactNode` | L'avatar ou l'icône à afficher sur le côté gauche de l'élément de menu |
- | texte | chaîne | Le contenu texte de l'élément de menu |
- | sélectionné | booléen | Indique si l'élément de menu est sélectionné (coché) |
- | désactivé | booléen | Indique si l'élément de menu est désactivé |
- | survolé | booléen | Indique si l'élément de menu est actuellement survolé |
- | testId | chaîne | L'attribut data-testid à des fins de test |
- | onClick | fonction | Fonction de rappel à déclencher lorsqu'on clique sur l'élément de menu |
- | nomDeClasse | chaîne | Nom facultatif pour un style supplémentaire |
- </Tab>
+<Tab title="Utilisation">
+
+```jsx
+import { MenuItemSelectAvatar } from "twenty-ui/display";
+
+export const MyComponent = () => {
+ const imageUrl =
+ "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAYABgAAD/4QCMRXhpZgAATU0AKgAAAAgABQESAAMAAAABAAEAAAEaAAUAAAABAAAASgEbAAUAAAABAAAAUgEoAAMAAAABAAIAAIdpAAQAAAABAAAAWgAAAAAAAABgAAAAAQAAAGAAAAABAAOgAQADAAAAAQABAACgAgAEAAAAAQAAABSgAwAEAAAAAQAAABQAAAAA/8AAEQgAFAAUAwEiAAIRAQMRAf/EAB8AAAEFAQEBAQEBAAAAAAAAAAABAgMEBQYHCAkKC//EALUQAAIBAwMCBAMFBQQEAAABfQECAwAEEQUSITFBBhNRYQcicRQygZGhCCNCscEVUtHwJDNicoIJChYXGBkaJSYnKCkqNDU2Nzg5OkNERUZHSElKU1RVVldYWVpjZGVmZ2hpanN0dXZ3eHl6g4SFhoeIiYqSk5SVlpeYmZqio6Slpqeoqaqys7S1tre4ubrCw8TFxsfIycrS09TV1tfY2drh4uPk5ebn6Onq8fLz9PX29/j5+v/EAB8BAAMBAQEBAQEBAQEAAAAAAAABAgMEBQYHCAkKC//EALURAAIBAgQEAwQHBQQEAAECdwABAgMRBAUhMQYSQVEHYXETIjKBCBRCkaGxwQkjM1LwFWJy0QoWJDThJfEXGBkaJicoKSo1Njc4OTpDREVGR0hJSlNUVVZXWFlaY2RlZmdoaWpzdHV2d3h5eoKDhIWGh4iJipKTlJWWl5iZmqKjpKWmp6ipqrKztLW2t7i5usLDxMXGx8jJytLT1NXW19jZ2uLj5OXm5+jp6vLz9PX29/j5+v/bAEMACwgICggHCwoJCg0MCw0RHBIRDw8RIhkaFBwpJCsqKCQnJy0yQDctMD0wJyc4TDk9Q0VISUgrNk9VTkZUQEdIRf/bAEMBDA0NEQ8RIRISIUUuJy5FRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRf/dAAQAAv/aAAwDAQACEQMRAD8Ava1q728otYY98joSCTgZrnbXWdTtrhrfVZXWLafmcAEkdgR/hVltQku9Q8+OIEBcGOT+ID0PY1ka1KH2u8ToqnPLbmIqG7u6LtbQ7RXBRec4Uck9eKXcPWsKDWVnhWSL5kYcFelSf2m3901POh8jP//QoyIAnTuKpXsY82NsksUyWPU5q/L9z8RVK++/F/uCsVsaEURwgA4HtT9x9TUcf3KfUGh//9k=";
+
+ const handleSelection = () => {
+ console.log("Menu item selected");
+ };
+
+ return (
+ <MenuItemSelectAvatar
+ avatar={<img src={imageUrl} alt="Avatar" />}
+ text="First Option"
+ selected={true}
+ disabled={false}
+ hovered={false}
+ testId="menu-item-test"
+ onClick={handleSelection}
+ className
+ />
+ );
+};
+
+```
+
+</Tab>
+<Tab title="Propriétés">
+
+
+| Propriétés | Type | Description |
+| ----------- | ----------- | ---------------------------------------------------------------------- |
+| avatar | `ReactNode` | L'avatar ou l'icône à afficher sur le côté gauche de l'élément de menu |
+| texte | chaîne | Le contenu texte de l'élément de menu |
+| sélectionné | booléen | Indique si l'élément de menu est sélectionné (coché) |
+| désactivé | booléen | Indique si l'élément de menu est désactivé |
+| survolé | booléen | Indique si l'élément de menu est actuellement survolé |
+| testId | chaîne | L'attribut data-testid à des fins de test |
+| onClick | fonction | Fonction de rappel à déclencher lorsqu'on clique sur l'élément de menu |
+| nomDeClasse | chaîne | Nom facultatif pour un style supplémentaire |
+
+
+
+
+</Tab>
</Tabs>
### Sélection de Couleur
@@ -348,41 +405,48 @@ Un élément de menu sélectionnable avec un avatar, avec un contenu facultatif
Un élément de menu sélectionnable avec un échantillon de couleur pour les scénarios où vous souhaitez que les utilisateurs choisissent une couleur dans un menu.
<Tabs>
- <Tab title="Utilisation">
- ```jsx
- import { MenuItemSelectColor } from "twenty-ui/display";
-
- export const MyComponent = () => {
- const handleSelection = () => {
- console.log("Menu item selected");
- };
-
- return (
- <MenuItemSelectColor
- color="green"
- selected={true}
- disabled={false}
- hovered={true}
- variant="default"
- onClick={handleSelection}
- className
- />
- );
- };
- ```
- </Tab>
-
- <Tab title="Propriétés">
- | Propriétés | Type | Description |
- | ----------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
- | couleur | chaîne | La couleur à thème à afficher comme échantillon dans l'élément de menu. Les options incluent: `vert`, `turquoise`, `ciel`, `bleu`, `violet`, `rose`, `rouge`, `orange`, `jaune`, `gris` |
- | sélectionné | booléen | Indique si l'élément de menu est sélectionné (coché) |
- | désactivé | booléen | Indique si l'élément de menu est désactivé |
- | survolé | booléen | Indique si l'élément de menu est actuellement survolé |
- | variante | chaîne | La variante de l'échantillon de couleur. Elle peut être `défaut` ou `pipeline` |
- | onClick | fonction | Fonction de rappel à déclencher lorsqu'on clique sur l'élément de menu |
- | nomDeClasse | chaîne | Nom facultatif pour un style supplémentaire |
- </Tab>
+<Tab title="Utilisation">
+
+```jsx
+import { MenuItemSelectColor } from "twenty-ui/display";
+
+export const MyComponent = () => {
+ const handleSelection = () => {
+ console.log("Menu item selected");
+ };
+
+ return (
+ <MenuItemSelectColor
+ color="green"
+ selected={true}
+ disabled={false}
+ hovered={true}
+ variant="default"
+ onClick={handleSelection}
+ className
+ />
+ );
+};
+```
+
+</Tab>
+<Tab title="Propriétés">
+
+
+| Propriétés | Type | Description |
+| ----------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| couleur | chaîne | La couleur à thème à afficher comme échantillon dans l'élément de menu. Les options incluent: `vert`, `turquoise`, `ciel`, `bleu`, `violet`, `rose`, `rouge`, `orange`, `jaune`, `gris` |
+| sélectionné | booléen | Indique si l'élément de menu est sélectionné (coché) |
+| désactivé | booléen | Indique si l'élément de menu est désactivé |
+| survolé | booléen | Indique si l'élément de menu est actuellement survolé |
+| variante | chaîne | La variante de l'échantillon de couleur. Elle peut être `défaut` ou `pipeline` |
+| onClick | fonction | Fonction de rappel à déclencher lorsqu'on clique sur l'élément de menu |
+| nomDeClasse | chaîne | Nom facultatif pour un style supplémentaire |
+
+
+
+
+</Tab>
</Tabs>
### Basculer
@@ -390,35 +454,42 @@ Un élément de menu sélectionnable avec un échantillon de couleur pour les sc
Un élément de menu avec un interrupteur à bascule associé pour permettre aux utilisateurs d'activer ou de désactiver une fonctionnalité spécifique
<Tabs>
- <Tab title="Utilisation">
- ```jsx
- import { IconBell } from '@tabler/icons-react';
-
- import { MenuItemToggle } from 'twenty-ui/display';
-
- export const MyComponent = () => {
-
- return (
- <MenuItemToggle
- LeftIcon={IconBell}
- text="First Option"
- toggled={true}
- toggleSize="small"
- className
- />
- );
- };
- ```
- </Tab>
-
- <Tab title="Propriétés">
- | Propriétés | Type | Description |
- | --------------------- | -------------- | ----------------------------------------------------------------------------- |
- | LeftIcon | ComposantIcône | Une icône à gauche optionnelle affichée avant le texte dans l'élément de menu |
- | texte | chaîne | Le contenu texte de l'élément de menu |
- | basculé | booléen | Indique si l'interrupteur est en "marche" ou "arrêt". |
- | surChangementBasculer | fonction | Fonction de rappel déclenchée lorsque l'état de l'interrupteur change. |
- | tailleBasculer | chaîne | La taille de l'interrupteur à bascule. Cela peut être soit \ |
- | nomDeClasse | chaîne | Nom facultatif pour un style supplémentaire |
- </Tab>
+<Tab title="Utilisation">
+
+```jsx
+import { IconBell } from '@tabler/icons-react';
+
+import { MenuItemToggle } from 'twenty-ui/display';
+
+export const MyComponent = () => {
+
+ return (
+ <MenuItemToggle
+ LeftIcon={IconBell}
+ text="First Option"
+ toggled={true}
+ toggleSize="small"
+ className
+ />
+ );
+};
+```
+
+</Tab>
+<Tab title="Propriétés">
+
+
+| Propriétés | Type | Description |
+| --------------------- | -------------- | ----------------------------------------------------------------------------- |
+| LeftIcon | ComposantIcône | Une icône à gauche optionnelle affichée avant le texte dans l'élément de menu |
+| texte | chaîne | Le contenu texte de l'élément de menu |
+| basculé | booléen | Indique si l'interrupteur est en "marche" ou "arrêt". |
+| surChangementBasculer | fonction | Fonction de rappel déclenchée lorsque l'état de l'interrupteur change. |
+| tailleBasculer | chaîne | La taille de l'interrupteur à bascule. Cela peut être soit \ |
+| nomDeClasse | chaîne | Nom facultatif pour un style supplémentaire |
+
+
+
+
+</Tab>
</Tabs>
diff --git a/packages/twenty-docs/l/fr/twenty-ui/navigation/navigation-bar.mdx b/packages/twenty-docs/l/fr/twenty-ui/navigation/navigation-bar.mdx
index 0b20f75b509..21c8d5982ab 100644
--- a/packages/twenty-docs/l/fr/twenty-ui/navigation/navigation-bar.mdx
+++ b/packages/twenty-docs/l/fr/twenty-ui/navigation/navigation-bar.mdx
@@ -1,45 +1,52 @@
---
title: Barre de navigation
+icon: barres
---
-
Rend une barre de navigation qui contient plusieurs composants `NavigationBarItem`.
<Tabs>
- <Tab title="Utilisation">
- ```jsx
- import { IconHome, IconUser, IconSettings } from '@tabler/icons-react';
- import { NavigationBar } from "@/ui/navigation/navigation-bar/components/NavigationBar";
-
- export const MyComponent = () => {
-
- const navigationItems = [
- {
- name: "Home",
- Icon: IconHome,
- onClick: () => console.log("Home clicked"),
- },
- {
- name: "Profile",
- Icon: IconUser,
- onClick: () => console.log("Profile clicked"),
- },
- {
- name: "Settings",
- Icon: IconSettings,
- onClick: () => console.log("Settings clicked"),
- },
- ];
-
- return <NavigationBar activeItemName="Home" items={navigationItems}/>;
- };
- ```
- </Tab>
-
- <Tab title="Propriétés">
- | Propriétés | Type | Description |
- | ---------------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
- | Nom de l'élément actif | chaîne | Le nom de l'élément de navigation actuellement actif. |
- | éléments | tableau | Un tableau d'objets représentant chaque élément de navigation. Chaque objet contient le `nom` de l'élément, le composant `Icon` à afficher, et une fonction `onClick` à appeler lorsque l'élément est cliqué. |
- </Tab>
+<Tab title="Utilisation">
+
+```jsx
+import { IconHome, IconUser, IconSettings } from '@tabler/icons-react';
+import { NavigationBar } from "@/ui/navigation/navigation-bar/components/NavigationBar";
+
+export const MyComponent = () => {
+
+ const navigationItems = [
+ {
+ name: "Home",
+ Icon: IconHome,
+ onClick: () => console.log("Home clicked"),
+ },
+ {
+ name: "Profile",
+ Icon: IconUser,
+ onClick: () => console.log("Profile clicked"),
+ },
+ {
+ name: "Settings",
+ Icon: IconSettings,
+ onClick: () => console.log("Settings clicked"),
+ },
+ ];
+
+ return <NavigationBar activeItemName="Home" items={navigationItems}/>;
+};
+```
+
+</Tab>
+<Tab title="Propriétés">
+
+
+| Propriétés | Type | Description |
+| ---------------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| Nom de l'élément actif | chaîne | Le nom de l'élément de navigation actuellement actif. |
+| éléments | tableau | Un tableau d'objets représentant chaque élément de navigation. Chaque objet contient le `nom` de l'élément, le composant `Icon` à afficher, et une fonction `onClick` à appeler lorsque l'élément est cliqué. |
+
+
+
+
+</Tab>
</Tabs>
diff --git a/packages/twenty-docs/l/fr/twenty-ui/navigation/step-bar.mdx b/packages/twenty-docs/l/fr/twenty-ui/navigation/step-bar.mdx
index 8c91dd08a01..c67fed113b2 100644
--- a/packages/twenty-docs/l/fr/twenty-ui/navigation/step-bar.mdx
+++ b/packages/twenty-docs/l/fr/twenty-ui/navigation/step-bar.mdx
@@ -9,25 +9,33 @@ title: Barre d'étape
Affiche la progression à travers une séquence d'étapes numérotées en surlignant l'étape active. Il affiche un conteneur avec des étapes, chacune représentée par le composant `Step`.
<Tabs>
- <Tab title="Utilisation">
- ```jsx
- import { StepBar } from "@/ui/navigation/step-bar/components/StepBar";
-
- export const MyComponent = () => {
- return (
- <StepBar activeStep={2}>
- <StepBar.Step>Step 1</StepBar.Step>
- <StepBar.Step>Step 2</StepBar.Step>
- <StepBar.Step>Step 3</StepBar.Step>
- </StepBar>
- );
- };
- ```
- </Tab>
-
- <Tab title="Propriétés">
- | Propriétés | Type | Description |
- | ----------- | ------ | --------------------------------------------------------------------------------------------------------- |
- | étapeActive | nombre | L'index de l'étape actuellement active. Cela détermine quelle étape doit être visuellement mise en valeur |
- </Tab>
+<Tab title="Utilisation">
+
+```jsx
+import { StepBar } from "@/ui/navigation/step-bar/components/StepBar";
+
+export const MyComponent = () => {
+ return (
+ <StepBar activeStep={2}>
+ <StepBar.Step>Step 1</StepBar.Step>
+ <StepBar.Step>Step 2</StepBar.Step>
+ <StepBar.Step>Step 3</StepBar.Step>
+ </StepBar>
+ );
+};
+```
+
+</Tab>
+
+<Tab title="Propriétés">
+
+
+| Propriétés | Type | Description |
+| ----------- | ------ | --------------------------------------------------------------------------------------------------------- |
+| étapeActive | nombre | L'index de l'étape actuellement active. Cela détermine quelle étape doit être visuellement mise en valeur |
+
+
+
+
+</Tab>
</Tabs>
diff --git a/packages/twenty-docs/l/fr/twenty-ui/progress-bar.mdx b/packages/twenty-docs/l/fr/twenty-ui/progress-bar.mdx
index eb59fdc867c..627190be0f4 100644
--- a/packages/twenty-docs/l/fr/twenty-ui/progress-bar.mdx
+++ b/packages/twenty-docs/l/fr/twenty-ui/progress-bar.mdx
@@ -2,39 +2,46 @@
title: Retour d'information
---
-
Indique le progrès ou le compte à rebours et passe de droite à gauche.
<Tabs>
- <Tab title="Utilisation">
- ```jsx
- import { ProgressBar } from "twenty-ui/feedback";
-
- export const MyComponent = () => {
- return (
- <ProgressBar
- duration={6000}
- delay={0}
- easing="easeInOut"
- barHeight={10}
- barColor="#4bb543"
- autoStart={true}
- />
- );
- };
- ```
- </Tab>
-
- <Tab title="Propriétés">
- | Propriétés | Type | Description | Par défaut |
- | -------------------- | ------- | --------------------------------------------------------------------------------------------------------- | ---------- |
- | durée | nombre | La durée totale de l'animation de la barre de progression en millisecondes | 3 |
- | délai | nombre | Le délai de démarrage de l'animation de la barre de progression en millisecondes | 0 |
- | adoucissement | chaîne | Fonction d'adoucissement pour l'animation de la barre de progression | easeInOut |
- | hauteurBarre | nombre | La hauteur de la barre en pixels | 24 |
- | couleurBarre | chaîne | La couleur de la barre | gray80 |
- | démarrageAutomatique | booléen | Si `true`, l'animation de la barre de progression commence automatiquement lorsque le composant est monté | `vrai` |
- </Tab>
+
+<Tab title="Utilisation">
+
+```jsx
+import { ProgressBar } from "twenty-ui/feedback";
+
+export const MyComponent = () => {
+ return (
+ <ProgressBar
+ duration={6000}
+ delay={0}
+ easing="easeInOut"
+ barHeight={10}
+ barColor="#4bb543"
+ autoStart={true}
+ />
+ );
+};
+```
+
+</Tab>
+
+<Tab title="Propriétés">
+
+
+| Propriétés | Type | Description | Par défaut |
+| -------------------- | ------- | --------------------------------------------------------------------------------------------------------- | ---------- |
+| durée | nombre | La durée totale de l'animation de la barre de progression en millisecondes | 3 |
+| délai | nombre | Le délai de démarrage de l'animation de la barre de progression en millisecondes | 0 |
+| adoucissement | chaîne | Fonction d'adoucissement pour l'animation de la barre de progression | easeInOut |
+| hauteurBarre | nombre | La hauteur de la barre en pixels | 24 |
+| couleurBarre | chaîne | La couleur de la barre | gray80 |
+| démarrageAutomatique | booléen | Si `true`, l'animation de la barre de progression commence automatiquement lorsque le composant est monté | `vrai` |
+
+
+
+</Tab>
</Tabs>
## Barre de Progression Circulaire
@@ -42,21 +49,30 @@ Indique le progrès ou le compte à rebours et passe de droite à gauche.
Indique le progrès d'une tâche, souvent utilisé sur des écrans de chargement ou dans des zones où vous souhaitez communiquer des processus en cours à l'utilisateur.
<Tabs>
- <Tab title="Utilisation">
- ```jsx
- import { CircularProgressBar } from "@/ui/feedback/progress-bar/components/CircularProgressBar";
-
- export const MyComponent = () => {
- return <CircularProgressBar size={80} barWidth={6} barColor="green" />;
- };
- ```
- </Tab>
-
- <Tab title="Propriétés">
- | Propriétés | Type | Description | Par défaut |
- | ------------ | ------ | ------------------------------------------------- | --------------- |
- | taille | nombre | La taille de la barre de progression circulaire | 50 |
- | largeurBarre | nombre | La largeur de la ligne de la barre de progression | 5 |
- | couleurBarre | chaîne | La couleur de la barre de progression | couleurCourante |
- </Tab>
+
+<Tab title="Utilisation">
+
+```jsx
+import { CircularProgressBar } from "@/ui/feedback/progress-bar/components/CircularProgressBar";
+
+export const MyComponent = () => {
+ return <CircularProgressBar size={80} barWidth={6} barColor="green" />;
+};
+```
+
+</Tab>
+
+<Tab title="Propriétés">
+
+
+| Propriétés | Type | Description | Par défaut |
+| ------------ | ------ | ------------------------------------------------- | --------------- |
+| taille | nombre | La taille de la barre de progression circulaire | 50 |
+| largeurBarre | nombre | La largeur de la ligne de la barre de progression | 5 |
+| couleurBarre | chaîne | La couleur de la barre de progression | couleurCourante |
+
+
+
+</Tab>
+
</Tabs>
diff --git a/packages/twenty-docs/l/fr/user-guide/ai/capabilities/ai-agents.mdx b/packages/twenty-docs/l/fr/user-guide/ai/capabilities/ai-agents.mdx
index bb40e8e848f..5da93eb5823 100644
--- a/packages/twenty-docs/l/fr/user-guide/ai/capabilities/ai-agents.mdx
+++ b/packages/twenty-docs/l/fr/user-guide/ai/capabilities/ai-agents.mdx
@@ -4,7 +4,7 @@ description: Intégrez des capacités d'IA directement dans vos flux de travail
---
<Note>
- Cette fonctionnalité est en cours de développement et sera bientôt disponible en version bêta.
+Cette fonctionnalité est en cours de développement et sera bientôt disponible en version bêta.
</Note>
## Vue d'ensemble
diff --git a/packages/twenty-docs/l/fr/user-guide/ai/capabilities/ai-chatbot.mdx b/packages/twenty-docs/l/fr/user-guide/ai/capabilities/ai-chatbot.mdx
index 7114b79017f..8cd99564310 100644
--- a/packages/twenty-docs/l/fr/user-guide/ai/capabilities/ai-chatbot.mdx
+++ b/packages/twenty-docs/l/fr/user-guide/ai/capabilities/ai-chatbot.mdx
@@ -4,7 +4,7 @@ description: Un assistant intelligent qui vous aide à interagir avec vos donné
---
<Note>
- Cette fonctionnalité est en cours de développement et sera bientôt disponible en version bêta.
+Cette fonctionnalité est en cours de développement et sera bientôt disponible en version bêta.
</Note>
## Vue d'ensemble
diff --git a/packages/twenty-docs/l/fr/user-guide/ai/capabilities/mcp.mdx b/packages/twenty-docs/l/fr/user-guide/ai/capabilities/mcp.mdx
new file mode 100644
index 00000000000..be2f11c70b8
--- /dev/null
+++ b/packages/twenty-docs/l/fr/user-guide/ai/capabilities/mcp.mdx
@@ -0,0 +1,141 @@
+---
+title: Serveur MCP
+description: Connectez des assistants IA à votre espace de travail Twenty à l'aide du Model Context Protocol.
+---
+
+<Warning>
+MCP est actuellement en **alpha** et n'est disponible que sur certains espaces de travail. Il se peut qu'il ne soit pas encore activé pour votre espace de travail.
+</Warning>
+
+Twenty expose un serveur [MCP](https://modelcontextprotocol.io/) afin que les assistants IA — Claude Desktop, Claude Code, Cursor, ChatGPT et autres — puissent lire et écrire vos données CRM en langage naturel.
+
+Utilisez l'**URL de votre espace de travail** (l'URL que vous utilisez pour accéder à Twenty) comme point de terminaison MCP. Sur Twenty Cloud, l'URL de votre espace de travail peut être `https://{mycompany}.twenty.com` ou un domaine personnalisé. Le serveur est disponible à l'adresse :
+
+| Environnement | Point de terminaison MCP |
+| ---------------- | ----------------------------------------------------------------------------------- |
+| **Cloud** | `https://{your-workspace-url}/mcp` (par exemple `https://mycompany.twenty.com/mcp`) |
+| **Auto-hébergé** | `https://{your-domain}/mcp` |
+
+## Méthodes d'authentification
+
+Vous disposez de deux moyens d'authentifier votre client MCP : **OAuth** (recommandé) ou **clé API**.
+
+### Option A — OAuth (recommandé)
+
+Avec OAuth, votre client MCP ouvre une fenêtre de navigateur pour que vous puissiez vous connecter. Aucun secret n'est stocké dans les fichiers de configuration et les jetons se renouvellent automatiquement.
+
+<Note>
+OAuth nécessite un client MCP qui prend en charge la [spécification MCP Authorization](https://modelcontextprotocol.io/specification/2025-03-26/basic/authorization). Claude Desktop, Claude Code, Cursor et ChatGPT la prennent en charge.
+</Note>
+
+Ajoutez ceci à la configuration de votre client MCP, en remplaçant `{your-workspace-url}` par l'hôte de votre espace de travail (par exemple `mycompany.twenty.com`) :
+
+```json
+{
+ "mcpServers": {
+ "twenty": {
+ "type": "streamable-http",
+ "url": "https://{your-workspace-url}/mcp"
+ }
+ }
+}
+```
+
+Et voilà — aucune clé API n'est nécessaire. Lorsque le client se connecte pour la première fois, il va :
+
+1. Découvrir les métadonnées OAuth de Twenty via `/.well-known/oauth-protected-resource` et `/.well-known/oauth-authorization-server`
+2. S'enregistrer comme client OAuth via l'enregistrement dynamique de client (RFC 7591)
+3. Ouvrir votre navigateur pour autoriser l'accès
+4. Recevoir des jetons et se connecter au serveur MCP
+
+Les connexions suivantes réutilisent les jetons stockés et les actualisent automatiquement.
+
+### Option B — Clé API
+
+Si votre client MCP ne prend pas en charge OAuth, ou si vous préférez des identifiants statiques, transmettez une clé API dans l'en-tête `Authorization` :
+
+```json
+{
+ "mcpServers": {
+ "twenty": {
+ "type": "streamable-http",
+ "url": "https://{your-workspace-url}/mcp",
+ "headers": {
+ "Authorization": "Bearer YOUR_API_KEY"
+ }
+ }
+ }
+}
+```
+
+<Warning>
+Votre clé API donne accès aux données de votre espace de travail. Ne l'ajoutez pas au contrôle de version et évitez de la placer dans des fichiers de configuration partagés.
+</Warning>
+
+Pour créer une clé API, allez dans **Paramètres > APIs & Webhooks > + Créer une clé**. Voir [APIs](/l/fr/developers/extend/api#create-an-api-key) pour plus de détails.
+
+## Démarrage rapide
+
+### 1. Copiez la configuration
+
+Allez dans **Paramètres > IA > Plus > MCP Server** dans Twenty. Choisissez votre méthode d'authentification (OAuth ou clé API), copiez l'extrait JSON (il utilisera déjà l'URL de votre espace de travail) et collez-le dans le fichier de configuration de votre client MCP.
+
+| Client | Emplacement du fichier de configuration |
+| ------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| **Claude Desktop** | `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) ou `%APPDATA%\Claude\claude_desktop_config.json` (Windows) |
+| **Claude Code** | `~/.claude.json` (utilisateur) ou `.mcp.json` (projet) |
+| **Cursor** | `.cursor/mcp.json` dans votre projet, ou `~/.cursor/mcp.json` globalement |
+| **ChatGPT** | Activez le mode Développeur dans **Paramètres > Applications et connecteurs > Paramètres avancés**, puis utilisez **Créer** dans **Paramètres > Applications et connecteurs** pour ajouter le serveur MCP |
+
+### 2. Se connecter
+
+Redémarrez votre client MCP (ou rechargez la configuration). Si vous utilisez OAuth, vous serez redirigé vers Twenty pour autoriser l'accès. Si vous utilisez une clé API, la connexion est immédiate.
+
+### 3. Commencez à l'utiliser
+
+Demandez à votre assistant IA d'interagir avec votre CRM :
+
+* *"Montre-moi les 5 entreprises créées le plus récemment"*
+* *"Crée une nouvelle personne nommée Jane Doe chez Acme Corp"*
+* *"Trouve toutes les opportunités ouvertes d'une valeur supérieure à 10 000 $"*
+
+## Outils disponibles
+
+Une fois connecté, le serveur MCP expose des outils qui reflètent l'API de Twenty. Le flux de travail recommandé est :
+
+1. **`learn_tools`** — obtenir le schéma d'entrée pour des outils spécifiques
+2. **`execute_tool`** — exécuter un outil
+
+Vous n'avez pas besoin de mémoriser les noms des outils. Demandez à votre assistant IA ce qu'il peut faire et il appellera `learn_tools` automatiquement.
+
+## Autorisations
+
+Les connexions MCP héritent des autorisations de l'utilisateur authentifié (OAuth) ou du rôle attribué à la clé API. Pour restreindre ce que le serveur MCP peut faire :
+
+* **OAuth** : Le rôle de l'utilisateur dans l'espace de travail s'applique.
+* **Clé API** : Attribuez un rôle à la clé API dans **Paramètres > Rôles**. Voir [Autorisations](/l/fr/user-guide/permissions-access/capabilities/permissions).
+
+## Configuration auto-hébergée
+
+Pour les instances auto-hébergées, remplacez `{your-workspace-url}` par l'URL de votre serveur. Assurez-vous que `SERVER_URL` dans votre environnement correspond à l'URL publique de votre instance Twenty — cela est utilisé pour générer les métadonnées de découverte OAuth.
+
+```bash
+SERVER_URL=https://twenty.yourcompany.com
+```
+
+Le point de terminaison MCP, les points de terminaison OAuth et les métadonnées de découverte dérivent tous de cette valeur.
+
+## Résolution des problèmes
+
+**Erreurs "Unauthorized" ou 401**
+
+* OAuth : réautorisez en supprimant les jetons stockés dans votre client MCP puis reconnectez-vous.
+* Clé API : vérifiez que la clé est valide et n'a pas expiré. Régénérez-la si nécessaire.
+
+**Le flux OAuth n'ouvre pas de navigateur**
+
+* Assurez-vous que votre client MCP prend en charge MCP Authorization. Si ce n'est pas le cas, revenez à la méthode par clé API.
+
+**Délai d'attente de connexion**
+
+* Confirmez que l'URL du point de terminaison MCP est accessible depuis votre machine. Pour les instances auto-hébergées, vérifiez que le serveur est en cours d'exécution et que `SERVER_URL` est correctement défini.
diff --git a/packages/twenty-docs/l/fr/user-guide/ai/capabilities/permissions-access-control.mdx b/packages/twenty-docs/l/fr/user-guide/ai/capabilities/permissions-access-control.mdx
index fc8db7cc801..9e3bf39d34d 100644
--- a/packages/twenty-docs/l/fr/user-guide/ai/capabilities/permissions-access-control.mdx
+++ b/packages/twenty-docs/l/fr/user-guide/ai/capabilities/permissions-access-control.mdx
@@ -9,7 +9,7 @@ Les agents IA respectent votre structure d’autorisations existante. C’est pa
## Attribuer un Rôle à un Agent IA
-1. Allez dans **Paramètres → Rôles**
+1. Allez dans **Paramètres → Membres → Rôles**
2. Cliquez sur le rôle que vous souhaitez attribuer
3. Ouvrez l'onglet **Attribution**
4. Sous **Agents IA**, cliquez sur **+ Attribuer à un agent IA**
@@ -26,7 +26,7 @@ Les agents IA respectent votre structure d’autorisations existante. C’est pa
| **Auditabilité** | Suivez quelles actions ont été effectuées par chaque agent |
<Note>
- Pour les agents IA s’exécutant au sein de flux de travail, l’attribution d’un rôle garantit que l’agent ne peut pas accéder ni modifier des données en dehors de sa portée prévue—même si le flux de travail dispose d’autorisations plus étendues.
+Pour les agents IA s’exécutant au sein de flux de travail, l’attribution d’un rôle garantit que l’agent ne peut pas accéder ni modifier des données en dehors de sa portée prévue—même si le flux de travail dispose d’autorisations plus étendues.
</Note>
## Contenu connexe
diff --git a/packages/twenty-docs/l/fr/user-guide/ai/how-tos/ai-faq.mdx b/packages/twenty-docs/l/fr/user-guide/ai/how-tos/ai-faq.mdx
index 6860b5e925c..a1f276815dc 100644
--- a/packages/twenty-docs/l/fr/user-guide/ai/how-tos/ai-faq.mdx
+++ b/packages/twenty-docs/l/fr/user-guide/ai/how-tos/ai-faq.mdx
@@ -4,6 +4,7 @@ description: Foire aux questions sur les fonctionnalités d'IA dans Twenty.
---
<AccordionGroup>
+
<Accordion title="Quand les fonctionnalités d'IA seront-elles disponibles ?">
Les fonctionnalités d'IA sont actuellement en développement et seront bientôt disponibles en version bêta. Restez à l'écoute pour les mises à jour !
</Accordion>
@@ -16,7 +17,7 @@ description: Foire aux questions sur les fonctionnalités d'IA dans Twenty.
</Accordion>
<Accordion title="Les agents IA auront-ils accès à toutes mes données ?">
- Les agents IA seront soumis au système d'autorisations. Vous pouvez attribuer des rôles spécifiques aux agents IA dans **Paramètres → Rôles**, ce qui vous donne un contrôle total sur les données auxquelles ils peuvent accéder et les actions qu'ils peuvent effectuer.
+ Les agents IA seront soumis au système d'autorisations. Vous pouvez attribuer des rôles spécifiques aux agents IA dans **Paramètres → Membres → Rôles**, ce qui vous donne un contrôle total sur les données auxquelles ils peuvent accéder et les actions qu'ils peuvent effectuer.
</Accordion>
<Accordion title="Comment fonctionneront les crédits d'IA ?">
@@ -26,4 +27,5 @@ description: Foire aux questions sur les fonctionnalités d'IA dans Twenty.
<Accordion title="Puis-je utiliser mes propres modèles d'IA ?">
Dans un premier temps, Twenty utilisera des modèles d'IA intégrés. La prise en charge de modèles d'IA personnalisés ou externes pourrait être ajoutée dans de prochaines versions en fonction des retours des utilisateurs.
</Accordion>
+
</AccordionGroup>
diff --git a/packages/twenty-docs/l/fr/user-guide/ai/overview.mdx b/packages/twenty-docs/l/fr/user-guide/ai/overview.mdx
index 390b135322d..2d2522577d4 100644
--- a/packages/twenty-docs/l/fr/user-guide/ai/overview.mdx
+++ b/packages/twenty-docs/l/fr/user-guide/ai/overview.mdx
@@ -48,7 +48,7 @@ Un assistant conversationnel qui comprend votre contexte et a accès à toutes v
Les agents IA seront gérés via le système d'autorisations existant :
-1. Allez dans **Paramètres → Rôles**
+1. Allez dans **Paramètres → Membres → Rôles**
2. Configurez les données auxquelles chaque agent IA peut accéder
3. Définissez les autorisations de lecture/écriture par objet
@@ -59,4 +59,4 @@ Cela garantit que les agents IA respectent vos politiques de gouvernance des don
Nous mettrons à jour cette section au fur et à mesure que les fonctionnalités d'IA seront disponibles. En attendant :
* Suivez notre [GitHub](https://github.com/twentyhq/twenty) pour les mises à jour de développement
-* Rejoignez notre [Discord](https://discord.gg/twenty) pour partager vos retours et vos demandes de fonctionnalités
+* Rejoignez notre [Discord](https://discord.gg/UfGNZJfAG6) pour partager vos retours et vos demandes de fonctionnalités
diff --git a/packages/twenty-docs/l/fr/user-guide/billing/capabilities/credits.mdx b/packages/twenty-docs/l/fr/user-guide/billing/capabilities/credits.mdx
index a3cb2d95989..0494f9733a6 100644
--- a/packages/twenty-docs/l/fr/user-guide/billing/capabilities/credits.mdx
+++ b/packages/twenty-docs/l/fr/user-guide/billing/capabilities/credits.mdx
@@ -1,25 +1,32 @@
---
-title: Crédits de flux de travail
-description: Comprendre les crédits de flux de travail, leur consommation et comment en acheter davantage.
+title: Crédits
+description: Comprendre comment les crédits alimentent les flux de travail, les agents IA et le chatbot IA — et comment gérer votre solde.
---
## Vue d'ensemble
-Les crédits de flux de travail alimentent vos automatisations dans Twenty. Chaque action du flux de travail consomme des crédits en fonction de sa complexité.
+Les crédits alimentent les automatisations de flux de travail et les fonctionnalités d'IA. Ils sont consommés lorsque des actions de flux de travail s'exécutent, lorsque des agents IA traitent des tâches au sein des flux de travail, et dans le chat IA.
## Allocation des crédits
Les crédits dépendent de votre cycle de facturation, et non de votre forfait :
-| Cycle de facturation | Crédits |
-| -------------------- | --------------- |
-| Mensuel | 5 millions/mois |
-| Annuel | 50 millions/an |
+| Cycle de facturation | Crédits |
+| -------------------- | ------- |
+| Mensuel | 5/mois |
+| Annuel | 50/an |
<Note>
- Les 5 millions de crédits mensuels sont conçus pour vous permettre d'exécuter des automatisations sans vous soucier des coûts. Pour la plupart des flux de travail utilisant des actions standard, c'est plus que suffisant. Vous n'aurez besoin de crédits supplémentaires que lors de l'exécution de nœuds de code avancés ou de fonctionnalités alimentées par l'IA.
+Les 5 crédits mensuels sont conçus pour vous permettre d'exécuter des automatisations sans vous soucier des coûts. Pour la plupart des flux de travail utilisant des actions standard, c'est plus que suffisant. Vous n'aurez besoin de crédits supplémentaires que lors de l'exécution de nœuds de code avancés ou de fonctionnalités alimentées par l'IA.
</Note>
+## Report de crédits
+
+Les crédits non utilisés à la fin d'une période de facturation sont automatiquement reportés à la période suivante.
+
+* **Plafond**: Le montant reporté est plafonné à l'allocation complète d'une période, vous ne pouvez donc jamais reporter plus de crédits que ce que votre offre prévoit par période.
+* **Visibilité**: Lorsque des crédits reportés sont disponibles, ils apparaissent comme une ligne **Crédits reportés** distincte dans **Paramètres → Facturation**, aux côtés d'un solde **Total disponible**.
+
## Consommation de crédits
Les différentes actions consomment des quantités de crédits différentes :
@@ -28,7 +35,7 @@ Les différentes actions consomment des quantités de crédits différentes :
| ----------------------------------------------------------------------------- | ------------------------------------- |
| **Opérations de base** (rechercher, mettre à jour, créer des enregistrements) | Minimale |
| **Opérations complexes** (nœuds de code, appels d'API externes) | Plus de crédits |
-| **Prompts d'IA** (bientôt disponibles) | Variable en fonction de l'utilisation |
+| **Prompts IA & chats IA** | Variable en fonction de l'utilisation |
Les crédits sont déduits en temps réel lorsque les flux de travail s'exécutent.
diff --git a/packages/twenty-docs/l/fr/user-guide/billing/capabilities/pricing-plans.mdx b/packages/twenty-docs/l/fr/user-guide/billing/capabilities/pricing-plans.mdx
index b762a884cf8..94175a75ae8 100644
--- a/packages/twenty-docs/l/fr/user-guide/billing/capabilities/pricing-plans.mdx
+++ b/packages/twenty-docs/l/fr/user-guide/billing/capabilities/pricing-plans.mdx
@@ -1,5 +1,5 @@
---
-title: Formules tarifaires},{
+title: Formules tarifaires
description: En savoir plus sur les formules tarifaires de Twenty et comment passer de l’une à l’autre.
---
@@ -19,7 +19,7 @@ Pour les équipes prêtes à passer à l’échelle :
* Support standard
<Note>
- Les fonctionnalités premium (SSO et autorisations au niveau des lignes) ne sont pas incluses dans la formule Pro.
+Les fonctionnalités Premium (SSO, autorisations au niveau des lignes et données d’utilisation de l’IA) ne sont pas incluses dans le plan Pro.
</Note>
### Organisation (Cloud)
@@ -27,7 +27,7 @@ Pour les équipes prêtes à passer à l’échelle :
Pour les équipes plus importantes ayant des besoins avancés :
* Tout ce qui est inclus dans Pro
-* **Fonctionnalités premium** : intégration SSO et autorisations au niveau des lignes
+* **Fonctionnalités Premium** : intégration SSO, autorisations au niveau des lignes et données d’utilisation de l’IA
* Support prioritaire
## Formules auto-hébergées
@@ -45,7 +45,7 @@ Hébergez Twenty sur votre propre infrastructure, sans frais :
Pour les équipes qui ont besoin de fonctionnalités premium tout en s’auto-hébergeant :
* Toutes les fonctionnalités Pro
-* **Fonctionnalités premium** : intégration SSO et autorisations au niveau des lignes
+* **Fonctionnalités Premium** : intégration SSO, autorisations au niveau des lignes et données d’utilisation de l’IA
* Assistance de l’équipe Twenty
* Aucune obligation de publier le code personnalisé en open source avant de le distribuer
@@ -55,6 +55,7 @@ Les fonctionnalités premium ne sont disponibles que sur les formules Organisati
* **Intégration SSO** : authentification unique avec votre fournisseur d’identité
* **Autorisations au niveau des lignes** : contrôle d’accès granulaire au niveau de l’enregistrement
+* **Données d'utilisation de l'IA** : Suivez la consommation d'IA dans votre espace de travail
## Changer de formule
@@ -77,3 +78,15 @@ Contactez l’assistance pour rétrograder votre formule.
### Passer à la facturation mensuelle
Contactez l’assistance pour revenir à la facturation mensuelle.
+
+## Obtenir une clé Enterprise pour Organization (Self-Hosted)
+
+Pour utiliser le plan Organization (Self-Hosted), vous devez obtenir une clé Enterprise :
+
+1. Allez dans **Paramètres → Panneau d’administration → Enterprise**
+
+<img src="/images/user-guide/billing/enterprise-key.png" alt="Clé Enterprise" />
+
+2. Cliquez sur **Obtenir une clé Enterprise**
+3. Lorsque vous êtes redirigé vers Stripe, saisissez vos informations de paiement et confirmez
+4. Lorsque votre clé Enterprise s’affiche, collez-la dans la page des paramètres Enterprise et activez la licence de l’organisation
diff --git a/packages/twenty-docs/l/fr/user-guide/billing/how-tos/billing-faq.mdx b/packages/twenty-docs/l/fr/user-guide/billing/how-tos/billing-faq.mdx
index 6eb54f3d4ed..4b0df48bd92 100644
--- a/packages/twenty-docs/l/fr/user-guide/billing/how-tos/billing-faq.mdx
+++ b/packages/twenty-docs/l/fr/user-guide/billing/how-tos/billing-faq.mdx
@@ -6,81 +6,83 @@ description: Foire aux questions sur les tarifs et la facturation de Twenty.
## Tarifs
<AccordionGroup>
- <Accordion title="Puis-je utiliser Twenty gratuitement tout en l'hébergeant moi-même ?">
- Oui, vous pouvez utiliser Twenty gratuitement tout en l'hébergeant vous-même. Vous aurez accès à tout ce qui est inclus dans le plan Pro (Cloud), sauf l'assistance de notre équipe centrale. Le support est accessible via notre communauté Discord.
-
- Si vous souhaitez vous auto-héberger et avez besoin des fonctionnalités Premium (SSO et autorisations au niveau des lignes), vous pouvez choisir la licence Organization (Self-Hosted) payante. Cela inclut également l'assistance de l'équipe Twenty et supprime l'obligation de publier le code personnalisé en open source avant de le distribuer.
- </Accordion>
-
- <Accordion title="Quelles sont les fonctionnalités Premium ?">
- Les fonctionnalités Premium ne sont disponibles que sur les plans Organization (Cloud ou Self-Hosted) :
-
- * **Intégration SSO** : Authentification unique avec votre fournisseur d'identité
- * **Autorisations au niveau des lignes** : Contrôle d'accès granulaire au niveau des enregistrements
- </Accordion>
-
- <Accordion title="Proposez-vous des sièges gratuits pour les utilisateurs en mode consultation uniquement ?">
- Nous n'offrons pas de sièges gratuits. La tarification se fait par utilisateur et chaque utilisateur a besoin d'une licence pour accéder à Twenty.
- </Accordion>
-
- <Accordion title="Où puis-je passer à l'abonnement Organisation ?">
- Vous pouvez le faire dans `Paramètres → Facturation`. Puis cliquez sur `Passer à Organisation`.
- </Accordion>
-
- <Accordion title="Où puis-je passer à l'abonnement Pro ?">
- Veuillez contacter notre équipe directement via le Support, il n'est pas facile de le faire via l'interface utilisateur pour le moment.
- </Accordion>
-
- <Accordion title="Où puis-je passer à l'abonnement Annuel ?">
- Vous pouvez le faire dans `Paramètres → Facturation`. Puis cliquez sur `Passer à Annuel`.
- </Accordion>
-
- <Accordion title="Où puis-je passer à l'abonnement Mensuel ?">
- Veuillez contacter notre équipe directement via le Support, il n'est pas facile de le faire via l'interface utilisateur pour le moment.
- </Accordion>
-
- <Accordion title="Où puis-je voir ma consommation de crédits ?">
- Vous trouverez cela sous `Paramètres → Facturation`.
- </Accordion>
-
- <Accordion title="Combien de crédits de flux de travail avons-nous ?">
- Le nombre de crédits dépend de votre cycle de facturation, et non de votre plan :
-
- * **Abonnements mensuels** : 5 millions de crédits par mois
- * **Abonnements annuels** : 50 millions de crédits par an
- </Accordion>
-
- <Accordion title="Comment fonctionne la consommation de crédits de workflow ?">
- Chaque action du flux de travail consomme des crédits en fonction de sa complexité :
-
- * **Les opérations internes de base** (comme la recherche, la mise à jour, la création d'enregistrements) consomment très peu de crédits
- * **Les opérations plus complexes** comme les nœuds de code et les requêtes vers des services externes consomment plus de crédits
- * **Prompts d'IA** (bientôt disponible !) consommeront également plus de crédits en fonction de l'utilisation
-
- Les crédits sont déduits en temps réel lorsque les flux de travail s'exécutent. Vous pouvez suivre votre utilisation dans **Paramètres → Facturation** pour suivre la consommation et les crédits restants.
- </Accordion>
-
- <Accordion title="Puis-je acheter plus de crédits de workflow ?">
- Vous pouvez acheter des crédits supplémentaires dans `Paramètres → Facturation`.
- </Accordion>
+<Accordion title="Puis-je utiliser Twenty gratuitement tout en l'hébergeant moi-même ?">
+Oui, vous pouvez utiliser Twenty gratuitement tout en l'hébergeant vous-même. Vous aurez accès à tout ce qui est inclus dans le plan Pro (Cloud), sauf l'assistance de notre équipe centrale. Le support est accessible via notre communauté Discord.
+
+Si vous souhaitez vous auto-héberger et avez besoin des fonctionnalités Premium (SSO et autorisations au niveau des lignes), vous pouvez choisir la licence Organization (Self-Hosted) payante. Cela inclut également l'assistance de l'équipe Twenty et supprime l'obligation de publier le code personnalisé en open source avant de le distribuer.
+</Accordion>
+
+<Accordion title="Quelles sont les fonctionnalités Premium ?">
+Les fonctionnalités Premium ne sont disponibles que sur les plans Organization (Cloud ou Self-Hosted) :
+* **Intégration SSO** : Authentification unique avec votre fournisseur d'identité
+* **Autorisations au niveau des lignes** : Contrôle d'accès granulaire au niveau des enregistrements
+* **Données d'utilisation de l'IA** : Suivez la consommation d'IA dans votre espace de travail
+</Accordion>
+
+<Accordion title="L'offre Organization sur le cloud et l'offre Organization en auto-hébergement sont-elles identiques ?">
+Elles offrent les mêmes fonctionnalités Premium. Cependant, un abonnement cloud ne peut pas être utilisé pour des déploiements auto-hébergés. L'auto-hébergement nécessite une clé Enterprise.
+</Accordion>
+
+<Accordion title="Proposez-vous des sièges gratuits pour les utilisateurs en mode consultation uniquement ?">
+Nous n'offrons pas de sièges gratuits. La tarification se fait par utilisateur et chaque utilisateur a besoin d'une licence pour accéder à Twenty.
+</Accordion>
+
+<Accordion title="Où puis-je passer à l'abonnement Organisation ?">
+Vous pouvez le faire dans `Paramètres → Facturation`. Puis cliquez sur `Passer à Organisation`.
+</Accordion>
+
+<Accordion title="Où puis-je passer à l'abonnement Pro ?">
+Veuillez contacter notre équipe directement via le Support, il n'est pas facile de le faire via l'interface utilisateur pour le moment.
+</Accordion>
+
+<Accordion title="Où puis-je passer à l'abonnement Annuel ?">
+Vous pouvez le faire dans `Paramètres → Facturation`. Puis cliquez sur `Passer à Annuel`.
+</Accordion>
+
+<Accordion title="Où puis-je passer à l'abonnement Mensuel ?">
+Veuillez contacter notre équipe directement via le Support, il n'est pas facile de le faire via l'interface utilisateur pour le moment.
+</Accordion>
+
+<Accordion title="Où puis-je voir ma consommation de crédits ?">
+Vous trouverez cela sous `Paramètres → Facturation`.
+</Accordion>
+
+<Accordion title="Combien de crédits de flux de travail avons-nous ?">
+Le nombre de crédits dépend de votre cycle de facturation, et non de votre plan :
+* **Abonnements mensuels** : 5 crédits par mois
+* **Abonnements annuels** : 50 crédits par an
+</Accordion>
+
+<Accordion title="Comment fonctionne la consommation de crédits de workflow ?">
+Chaque action du flux de travail consomme des crédits en fonction de sa complexité :
+* **Les opérations internes de base** (comme la recherche, la mise à jour, la création d'enregistrements) consomment très peu de crédits
+* **Les opérations plus complexes** comme les nœuds de code et les requêtes vers des services externes consomment plus de crédits
+* **Prompts d'IA** (bientôt disponible !) consommeront également plus de crédits en fonction de l'utilisation
+
+Les crédits sont déduits en temps réel lorsque les flux de travail s'exécutent. Vous pouvez suivre votre utilisation dans **Paramètres → Facturation** pour suivre la consommation et les crédits restants.
+</Accordion>
+
+<Accordion title="Puis-je acheter plus de crédits de workflow ?">
+Vous pouvez acheter des crédits supplémentaires dans `Paramètres → Facturation`.
+</Accordion>
</AccordionGroup>
## Facturation
<AccordionGroup>
- <Accordion title="Où puis-je gérer les détails de la facturation ?">
- Vous pouvez le faire dans `Paramètres → Facturation`.
- </Accordion>
+<Accordion title="Où puis-je gérer les détails de la facturation ?">
+Vous pouvez le faire dans `Paramètres → Facturation`.
+</Accordion>
- <Accordion title="Où puis-je mettre à jour ma méthode de paiement ?">
- Vous pouvez le faire dans `Paramètres → Facturation`. Puis cliquez sur `Voir les détails de facturation`. Vous pourrez y ajouter une nouvelle méthode de paiement.
- </Accordion>
+<Accordion title="Où puis-je mettre à jour ma méthode de paiement ?">
+Vous pouvez le faire dans `Paramètres → Facturation`. Puis cliquez sur `Voir les détails de facturation`. Vous pourrez y ajouter une nouvelle méthode de paiement.
+</Accordion>
- <Accordion title="Où puis-je mettre à jour mes informations de facturation ?">
- Vous pouvez le faire dans `Paramètres → Facturation`. Puis cliquez sur `Voir les détails de facturation`. Vous pourrez y éditer les informations de facturation.
- </Accordion>
+<Accordion title="Où puis-je mettre à jour mes informations de facturation ?">
+Vous pouvez le faire dans `Paramètres → Facturation`. Puis cliquez sur `Voir les détails de facturation`. Vous pourrez y éditer les informations de facturation.
+</Accordion>
- <Accordion title="Où puis-je accéder à mes factures ?">
- Vous pouvez le faire dans `Paramètres → Facturation`. Puis cliquez sur `Voir les détails de facturation`. Vous verrez toutes vos factures en bas de l'écran.
- </Accordion>
+<Accordion title="Où puis-je accéder à mes factures ?">
+Vous pouvez le faire dans `Paramètres → Facturation`. Puis cliquez sur `Voir les détails de facturation`. Vous verrez toutes vos factures en bas de l'écran.
+</Accordion>
</AccordionGroup>
diff --git a/packages/twenty-docs/l/fr/user-guide/billing/overview.mdx b/packages/twenty-docs/l/fr/user-guide/billing/overview.mdx
index b42d37d976a..07b6affb3d5 100644
--- a/packages/twenty-docs/l/fr/user-guide/billing/overview.mdx
+++ b/packages/twenty-docs/l/fr/user-guide/billing/overview.mdx
@@ -3,7 +3,6 @@ title: Facturation
description: Comprenez la tarification de Twenty et gérez votre abonnement.
---
-
Twenty propose des formules tarifaires flexibles adaptées aux besoins de votre équipe. Gérez votre abonnement, suivez vos crédits de workflows et accédez à vos factures directement depuis **Paramètres → Facturation**.
## Dans cette section
@@ -12,7 +11,6 @@ Twenty propose des formules tarifaires flexibles adaptées aux besoins de votre
<Card title="Formules tarifaires" icon="tags" href="/l/fr/user-guide/billing/capabilities/pricing-plans">
Découvrez les formules tarifaires de Twenty et ce qu'elles incluent.
</Card>
-
<Card title="FAQ" icon="circle-question" href="/l/fr/user-guide/billing/how-tos/billing-faq">
Questions fréquentes sur les tarifs et la facturation.
</Card>
diff --git a/packages/twenty-docs/l/fr/user-guide/calendar-emails/how-tos/can-i-send-emails-from-twenty.mdx b/packages/twenty-docs/l/fr/user-guide/calendar-emails/how-tos/can-i-send-emails-from-twenty.mdx
index a5699228dee..d68336644b5 100644
--- a/packages/twenty-docs/l/fr/user-guide/calendar-emails/how-tos/can-i-send-emails-from-twenty.mdx
+++ b/packages/twenty-docs/l/fr/user-guide/calendar-emails/how-tos/can-i-send-emails-from-twenty.mdx
@@ -34,7 +34,7 @@ Les e-mails envoyés via les workflows transitent par votre compte de messagerie
Pour les séquences d'e-mails et les newsletters, nous recommandons d'utiliser des workflows pour connecter Twenty à un outil dédié de marketing par e-mail.
<Warning>
- Les envois d'e-mails en masse ne doivent pas être effectués directement depuis votre boîte de réception afin de protéger la réputation de votre domaine. Utilisez un outil dédié pour les communications en masse.
+Les envois d'e-mails en masse ne doivent pas être effectués directement depuis votre boîte de réception afin de protéger la réputation de votre domaine. Utilisez un outil dédié pour les communications en masse.
</Warning>
→ Voir [Comment envoyer des e-mails depuis des workflows](/l/fr/user-guide/workflows/capabilities/send-emails-from-workflows) pour les instructions de configuration
diff --git a/packages/twenty-docs/l/fr/user-guide/calendar-emails/overview.mdx b/packages/twenty-docs/l/fr/user-guide/calendar-emails/overview.mdx
index dfff33ed8b6..d861d0eba2e 100644
--- a/packages/twenty-docs/l/fr/user-guide/calendar-emails/overview.mdx
+++ b/packages/twenty-docs/l/fr/user-guide/calendar-emails/overview.mdx
@@ -3,7 +3,6 @@ title: Calendrier et e-mails
description: Connectez vos comptes de messagerie et de calendrier à Twenty.
---
-
## Options de connexion
### Compte Google (Gmail & Google Calendar)
@@ -26,15 +25,25 @@ description: Connectez vos comptes de messagerie et de calendrier à Twenty.
6. Configurez les paramètres de synchronisation du calendrier (visibilité, création automatique) → cliquez sur **Ajouter un compte**
7. Vos e-mails et vos événements de calendrier commenceront à se synchroniser automatiquement
-### Configuration SMTP/CalDAV (Autres fournisseurs)
+### Configuration IMAP/SMTP/CalDAV (Autres fournisseurs)
Pour les autres fournisseurs de services de messagerie et de calendrier :
1. Allez dans **Paramètres → Comptes**
-2. Configurez les paramètres SMTP pour les e-mails
+2. Configurez les paramètres IMAP pour synchroniser les e-mails entrants et les paramètres SMTP pour envoyer des e-mails
3. Configurez les paramètres CalDAV pour le calendrier
4. Tester la connexion
+<Note>
+**Auto-hébergement sur un réseau isolé (air-gapped) ou interne** : Par défaut, Twenty refuse les connexions sortantes vers des adresses IP privées/internes (protection SSRF). Si votre serveur de messagerie ou de calendrier fonctionne sur une IP locale/privée (par exemple un serveur sur site sur un LAN), les connexions vers celui-ci seront bloquées. Pour les autoriser, définissez la variable d’environnement suivante sur le serveur :
+
+```
+OUTBOUND_HTTP_SAFE_MODE_ENABLED=false
+```
+
+Cela désactive le mode sécurisé pour **toutes** les requêtes sortantes (actions HTTP de flux de travail, webhooks et connexions IMAP/SMTP/CalDAV), donc ne l’activez que sur des réseaux de confiance et isolés où la protection SSRF n’est pas nécessaire.
+</Note>
+
### Plusieurs boîtes aux lettres
* **Comptes illimités** : Connectez plusieurs comptes de messagerie par utilisateur
@@ -42,7 +51,7 @@ Pour les autres fournisseurs de services de messagerie et de calendrier :
* **Paramètres de Synchronisation**: Configurez différents paramètres par boîte aux lettres
<Warning>
- Seules les vraies boîtes aux lettres peuvent être connectées (par exemple, [email protected] avec sa propre boîte de réception). Les alias email qui redirigent vers une autre boîte aux lettres ne peuvent pas être connectés à Twenty.
+Seules les vraies boîtes aux lettres peuvent être connectées (par exemple, [email protected] avec sa propre boîte de réception). Les alias email qui redirigent vers une autre boîte aux lettres ne peuvent pas être connectés à Twenty.
</Warning>
## Configuration des Emails
@@ -60,10 +69,19 @@ Choisissez différents niveaux de visibilité pour vos e-mails :
* **Désactivée**: Pas de création automatique de contacts
* **Pour les messages envoyés et reçus** : Créez des contacts pour toutes les interactions par e-mail externes
* **Pour les messages envoyés uniquement** : Créez des contacts uniquement pour les e-mails que vous envoyez
-* **Remarque** : Les emails internes (même domaine) ne sont jamais synchronisés pour maintenir la confidentialité
+* **Remarque** : Par défaut, les e-mails internes (où tous les participants partagent votre domaine) ne sont pas synchronisés afin de protéger la confidentialité.
<Note>Lorsque cette option est activée, les contacts sont automatiquement liés à leurs enregistrements Entreprise en fonction de leur domaine de messagerie. Si l'entreprise n'existe pas encore, Twenty la crée pour vous.</Note>
+<Note>
+**Synchronisation des e-mails internes** : Le comportement « e-mails internes non synchronisés » est celui utilisé par défaut, mais il peut être désactivé. Le bouton bascule se trouve dans les paramètres avancés :
+1. Ouvrez **Paramètres** et activez le bouton **Avancé** en bas de la page des paramètres
+2. Allez dans **Général → Sécurité**
+3. Activez le bouton **Synchroniser les e-mails internes** pour inclure les e-mails où tous les participants partagent le même domaine.
+
+Il s’agit d’un paramètre à l’échelle de l’espace de travail (utile pour les universités ou les organisations partageant un même domaine).
+</Note>
+
### Contrôlez quels emails sont synchronisés avec Sélection des dossiers de messages
Contrôlez quels dossiers e-mail sont synchronisés avec Twenty :
@@ -80,7 +98,7 @@ Cela vous donne un contrôle précis sur les e-mails qui apparaissent dans votre
**Ce qui est Synchronisé :**
* **E-mails externes** : Tous les e-mails avec des contacts externes provenant des dossiers sélectionnés
-* **E-mails internes** : Non synchronisés (les e-mails du même domaine restent privés)
+* **E-mails internes** : Non synchronisés par défaut (les e-mails du même domaine restent privés). Activez le bouton **Avancé** en bas de la page **Paramètres**, puis activez **Synchroniser les e-mails internes** dans **Général → Sécurité** pour les inclure à l’échelle de l’espace de travail.
* **Pièces jointes** : Disponible au H1 2026
**Remarque** : Nous ne fournissons pas d'adresse email CC pour une synchronisation sélective. Utilisez plutôt la fonctionnalité Message Folder ci-dessus pour obtenir le même niveau de contrôle sur les e-mails qui se synchronisent avec Twenty.
@@ -117,7 +135,7 @@ Choisissez ce qui sera visible pour les autres utilisateurs dans votre espace de
**Mises à jour toutes les 5 minutes** : Les données de messagerie et de calendrier sont synchronisées automatiquement toutes les 5 minutes après l'importation initiale.
<Note>
- **Durée de la synchronisation initiale**: La synchronisation du calendrier se termine rapidement (généralement en quelques minutes), tandis que la synchronisation des emails prend plus de temps pour les grandes boîtes aux lettres. Twenty importe des emails à environ **400 messages par minute** (soumis aux limites de débit de l'API Gmail), de sorte qu'une boîte aux lettres contenant 10,000 emails prend environ 25 minutes. Ne vous inquiétez pas si vous voyez des contacts provenant d'événements de calendrier apparaître avant vos contacts e-mail ; c'est un comportement normal.
+**Durée de la synchronisation initiale**: La synchronisation du calendrier se termine rapidement (généralement en quelques minutes), tandis que la synchronisation des emails prend plus de temps pour les grandes boîtes aux lettres. Twenty importe des emails à environ **400 messages par minute** (soumis aux limites de débit de l'API Gmail), de sorte qu'une boîte aux lettres contenant 10,000 emails prend environ 25 minutes. Ne vous inquiétez pas si vous voyez des contacts provenant d'événements de calendrier apparaître avant vos contacts e-mail ; c'est un comportement normal.
</Note>
## Prochaines étapes
diff --git a/packages/twenty-docs/l/fr/user-guide/dashboards/capabilities/chart-settings.mdx b/packages/twenty-docs/l/fr/user-guide/dashboards/capabilities/chart-settings.mdx
index 0c647991de5..8747b9f0460 100644
--- a/packages/twenty-docs/l/fr/user-guide/dashboards/capabilities/chart-settings.mdx
+++ b/packages/twenty-docs/l/fr/user-guide/dashboards/capabilities/chart-settings.mdx
@@ -23,7 +23,7 @@ Les paramètres sont organisés en sections :
* **Style** : Couleurs, libellés et options visuelles
<Note>
- Certains paramètres n'apparaissent que lorsque d'autres paramètres sont configurés. Par exemple, **Granularité de date** n'apparaît que lorsque vous sélectionnez un champ de date.
+Certains paramètres n'apparaissent que lorsque d'autres paramètres sont configurés. Par exemple, **Granularité de date** n'apparaît que lorsque vous sélectionnez un champ de date.
</Note>
---
@@ -58,11 +58,11 @@ Les filtres fonctionnent de la même manière que dans les vues en tableau. Util
<img src="/images/user-guide/dashboard/dashboard-chart-settings-filters.png" alt="Filtre" />
<Tip>
- Pour les champs de date, essayez **Is relative** pour créer des filtres dynamiques comme "Past 7 days" ou "This month" qui se mettent à jour automatiquement.
+Pour les champs de date, essayez **Is relative** pour créer des filtres dynamiques comme "Past 7 days" ou "This month" qui se mettent à jour automatiquement.
</Tip>
<Tip>
- Les filtres avancés sont pris en charge — ajoutez plusieurs règles de filtre et combinez-les avec la logique **And** ou **Or**.
+Les filtres avancés sont pris en charge — ajoutez plusieurs règles de filtre et combinez-les avec la logique **And** ou **Or**.
</Tip>
---
@@ -110,11 +110,11 @@ Contrôlez l'ordre des catégories sur l'axe X.
**Astuce** : Pour les étapes du pipeline, utilisez **Position** pour afficher les étapes dans l'ordre de votre processus commercial (Lead → Qualified → Proposal → Won).
<Note>
- Les options affichées dépendent du type de votre champ. Les champs Select disposent de toutes les options ; les champs de date et de texte en affichent moins.
+Les options affichées dépendent du type de votre champ. Les champs Select disposent de toutes les options ; les champs de date et de texte en affichent moins.
</Note>
<Tip>
- Avec le tri **Manuel**, faites glisser les catégories pour créer un ordre personnalisé — idéal pour mettre en avant des segments spécifiques ou raconter une histoire avec vos données.
+Avec le tri **Manuel**, faites glisser les catégories pour créer un ordre personnalisé — idéal pour mettre en avant des segments spécifiques ou raconter une histoire avec vos données.
</Tip>
### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}> <ChartIcon icon="eye-off" />Omettre les valeurs nulles </span>
@@ -147,7 +147,7 @@ Les champs booléens ajoutent Compter true/false. Les graphiques agrégés avec
<img src="/images/user-guide/dashboard/dashboard-chart-settings-y-data-on-display.png" alt="Données affichées" />
<Note>
- Les options affichées dépendent de votre champ et du type de graphique. Si vous ne voyez pas une opération attendue, vérifiez le type de votre champ.
+Les options affichées dépendent de votre champ et du type de graphique. Si vous ne voyez pas une opération attendue, vérifiez le type de votre champ.
</Note>
### Ratio
@@ -222,7 +222,7 @@ Définissez des valeurs minimales et maximales fixes pour l'axe Y.
Définissez le jeu de couleurs de votre graphique. Choisissez parmi une variété de palettes de couleurs.
<Note>
- Lors d'un regroupement par un champ Select, le graphique utilise automatiquement les couleurs définies pour chaque option dans les paramètres de votre champ.
+Lors d'un regroupement par un champ Select, le graphique utilise automatiquement les couleurs définies pour chaque option dans les paramètres de votre champ.
</Note>
### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}> <ChartIcon icon="gizmo" />Nom de l'axe </span>
@@ -256,7 +256,7 @@ Afficher ou masquer la légende (apparaît uniquement lorsque Regrouper par est
* **Désactivé** : Aucune légende affichée
<Tip>
- **Survolez** un élément de la légende pour mettre ce groupe en évidence. **Cliquez** pour le masquer temporairement du graphique.
+**Survolez** un élément de la légende pour mettre ce groupe en évidence. **Cliquez** pour le masquer temporairement du graphique.
</Tip>
---
diff --git a/packages/twenty-docs/l/fr/user-guide/dashboards/capabilities/dashboards.mdx b/packages/twenty-docs/l/fr/user-guide/dashboards/capabilities/dashboards.mdx
index 7d3ec7b48d3..836cffdc95c 100644
--- a/packages/twenty-docs/l/fr/user-guide/dashboards/capabilities/dashboards.mdx
+++ b/packages/twenty-docs/l/fr/user-guide/dashboards/capabilities/dashboards.mdx
@@ -84,9 +84,9 @@ Pour ajouter un tableau de bord aux favoris, ouvrez le tableau de bord et clique
Les tableaux de bord affichent actuellement les données en fonction du fuseau horaire de l'utilisateur qui les consulte. Cela signifie qu'un même tableau de bord peut afficher des indicateurs différents pour des membres de l'équipe situés dans des régions différentes (p. ex., APAC vs US).
<Note>
- **Bientôt disponible**: Nous ajouterons la possibilité de définir un fuseau horaire spécifique pour un tableau de bord, afin que tous les utilisateurs voient des données cohérentes, quel que soit leur emplacement.
+**Bientôt disponible**: Nous ajouterons la possibilité de définir un fuseau horaire spécifique pour un tableau de bord, afin que tous les utilisateurs voient des données cohérentes, quel que soit leur emplacement.
</Note>
<Note>
- **Bientôt disponible**: Des filtres au niveau du tableau de bord vous permettront d'appliquer des filtres à tous les widgets en une seule fois, ce qui accélérera l'exploration de vos données.
+**Bientôt disponible**: Des filtres au niveau du tableau de bord vous permettront d'appliquer des filtres à tous les widgets en une seule fois, ce qui accélérera l'exploration de vos données.
</Note>
diff --git a/packages/twenty-docs/l/fr/user-guide/dashboards/capabilities/widgets.mdx b/packages/twenty-docs/l/fr/user-guide/dashboards/capabilities/widgets.mdx
index dfb86b8c7d2..2b2bfee8c03 100644
--- a/packages/twenty-docs/l/fr/user-guide/dashboards/capabilities/widgets.mdx
+++ b/packages/twenty-docs/l/fr/user-guide/dashboards/capabilities/widgets.mdx
@@ -14,7 +14,7 @@ Twenty propose différents types de widgets pour visualiser vos données CRM.
Affichez les données sous forme de barres horizontales ou verticales.
<Frame>
- <img src="/images/user-guide/dashboard/dashboard-widget-bar-chart.png" alt="Diagramme en barres" />
+<img src="/images/user-guide/dashboard/dashboard-widget-bar-chart.png" alt="Diagramme en barres" />
</Frame>
**Idéal pour :**
@@ -30,7 +30,7 @@ Affichez les données sous forme de barres horizontales ou verticales.
* Contacts ajoutés par mois
<Note>
- **Limites d'affichage** : Les diagrammes en barres peuvent afficher au maximum 100 barres, et 50 groupes par barre lors de l'utilisation de Group By. Si vous voyez l'avertissement "Données non affichées : X barres max par graphique", ajoutez des filtres pour restreindre vos données ou modifiez le regroupement (par ex., regroupez par semaine plutôt que par jours).
+**Limites d'affichage** : Les diagrammes en barres peuvent afficher au maximum 100 barres, et 50 groupes par barre lors de l'utilisation de Group By. Si vous voyez l'avertissement "Données non affichées : X barres max par graphique", ajoutez des filtres pour restreindre vos données ou modifiez le regroupement (par ex., regroupez par semaine plutôt que par jours).
</Note>
### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}><ChartIcon icon="chart-pie" />Diagrammes en secteurs</span>
@@ -38,7 +38,7 @@ Affichez les données sous forme de barres horizontales ou verticales.
Affichez les proportions d'un ensemble.
<Frame>
- <img src="/images/user-guide/dashboard/dashboard-widget-pie-chart.png" alt="Diagramme en secteurs" />
+<img src="/images/user-guide/dashboard/dashboard-widget-pie-chart.png" alt="Diagramme en secteurs" />
</Frame>
**Idéal pour :**
@@ -58,7 +58,7 @@ Affichez les proportions d'un ensemble.
Affichez les tendances au fil du temps.
<Frame>
- <img src="/images/user-guide/dashboard/dashboard-widget-line-chart.png" alt="Graphique linéaire" />
+<img src="/images/user-guide/dashboard/dashboard-widget-line-chart.png" alt="Graphique linéaire" />
</Frame>
**Idéal pour :**
@@ -78,7 +78,7 @@ Affichez les tendances au fil du temps.
Affichez clairement des valeurs clés uniques.
<Frame>
- <img src="/images/user-guide/dashboard/dashboard-widget-aggregate-chart.png" alt="Graphique agrégé" />
+<img src="/images/user-guide/dashboard/dashboard-widget-aggregate-chart.png" alt="Graphique agrégé" />
</Frame>
**Idéal pour :**
@@ -103,7 +103,7 @@ Affichez clairement des valeurs clés uniques.
Intégrez des outils et du contenu externes directement dans votre tableau de bord.
<Frame>
- <img src="/images/user-guide/dashboard/dashboard-widget-iframe.png" alt="iFrame" />
+<img src="/images/user-guide/dashboard/dashboard-widget-iframe.png" alt="iFrame" />
</Frame>
**Idéal pour :**
@@ -123,7 +123,7 @@ Intégrez des outils et du contenu externes directement dans votre tableau de bo
Ajoutez du texte et du contenu mis en forme directement dans votre tableau de bord.
<Frame>
- <img src="/images/user-guide/dashboard/dashboard-widget-rich-text.png" alt="Texte enrichi" />
+<img src="/images/user-guide/dashboard/dashboard-widget-rich-text.png" alt="Texte enrichi" />
</Frame>
**Idéal pour :**
@@ -139,7 +139,7 @@ Ajoutez du texte et du contenu mis en forme directement dans votre tableau de bo
* Édition de type Markdown
<Note>
- **Bientôt disponible** : Les jauges et les tableaux ne sont pas encore disponibles, mais figurent sur notre feuille de route.
+**Bientôt disponible** : Les jauges et les tableaux ne sont pas encore disponibles, mais figurent sur notre feuille de route.
</Note>
### Duplication de widgets
diff --git a/packages/twenty-docs/l/fr/user-guide/dashboards/how-tos/dashboards-faq.mdx b/packages/twenty-docs/l/fr/user-guide/dashboards/how-tos/dashboards-faq.mdx
index 041cca2c197..682134c5c0a 100644
--- a/packages/twenty-docs/l/fr/user-guide/dashboards/how-tos/dashboards-faq.mdx
+++ b/packages/twenty-docs/l/fr/user-guide/dashboards/how-tos/dashboards-faq.mdx
@@ -1,5 +1,5 @@
---
-title: FAQ sur les tableaux de bord},{
+title: FAQ sur les tableaux de bord
description: Questions fréquemment posées sur les tableaux de bord dans Twenty.
---
@@ -47,7 +47,6 @@ description: Questions fréquemment posées sur les tableaux de bord dans Twenty
<Accordion title="À quelle fréquence les données du tableau de bord sont-elles actualisées ?">
Les widgets se mettent à jour automatiquement au fur et à mesure que vos données CRM changent :
-
* Mises à jour en temps réel pour la plupart des indicateurs
* Utilisez le bouton d'actualisation pour une mise à jour manuelle si nécessaire
* Les données historiques sont conservées pour l'analyse des tendances
diff --git a/packages/twenty-docs/l/fr/user-guide/dashboards/overview.mdx b/packages/twenty-docs/l/fr/user-guide/dashboards/overview.mdx
index 605d4f5b08c..64e03c78b54 100644
--- a/packages/twenty-docs/l/fr/user-guide/dashboards/overview.mdx
+++ b/packages/twenty-docs/l/fr/user-guide/dashboards/overview.mdx
@@ -3,9 +3,8 @@ title: Tableaux de bord
description: Apprenez les bases des rapports et des tableaux de bord dans Twenty.
---
-
<Note>
- Les tableaux de bord sont actuellement en version bêta. Activez-les sous **Paramètres → Mises à jour → Accès anticipé**.
+Les tableaux de bord sont actuellement en version bêta. Activez-les sous **Paramètres → Mises à jour → Accès anticipé**.
</Note>
## Comprendre les tableaux de bord
@@ -41,10 +40,9 @@ Les widgets sont des visualisations individuelles qui affichent des données sp
* Texte enrichi
<Note>
- **Limitations actuelles** :
-
- * L'export des tableaux de bord et le partage avec des utilisateurs externes (utilisateurs non Twenty) ne sont pas disponibles pour le moment.
- * Les graphiques en jauge et les tableaux ne sont pas encore disponibles.
+**Limitations actuelles** :
+* L'export des tableaux de bord et le partage avec des utilisateurs externes (utilisateurs non Twenty) ne sont pas disponibles pour le moment.
+* Les graphiques en jauge et les tableaux ne sont pas encore disponibles.
</Note>
## Prise en main
diff --git a/packages/twenty-docs/l/fr/user-guide/data-migration/capabilities/field-mapping.mdx b/packages/twenty-docs/l/fr/user-guide/data-migration/capabilities/field-mapping.mdx
index 65cbe442452..f36f2fc2747 100644
--- a/packages/twenty-docs/l/fr/user-guide/data-migration/capabilities/field-mapping.mdx
+++ b/packages/twenty-docs/l/fr/user-guide/data-migration/capabilities/field-mapping.mdx
@@ -141,9 +141,9 @@ See [here](#finding-api-names-for-select-fields) where to find the API names.
<Note>New select options will not be created automatically by the import. They must be added under **Settings → Data Model** before importing.</Note>
<Warning>
- **Import overwrites, it does not add.**
+**Import overwrites, it does not add.**
- If a record already has `VALUE2` and `VALUE3` selected, and you import `["VALUE1"]`, the record will only have `VALUE1` after import. The previous selections are replaced, not merged.
+If a record already has `VALUE2` and `VALUE3` selected, and you import `["VALUE1"]`, the record will only have `VALUE1` after import. The previous selections are replaced, not merged.
</Warning>
### Number Fields
diff --git a/packages/twenty-docs/l/fr/user-guide/data-migration/capabilities/file-formats.mdx b/packages/twenty-docs/l/fr/user-guide/data-migration/capabilities/file-formats.mdx
index d1ab1ee2035..9cc84011cf5 100644
--- a/packages/twenty-docs/l/fr/user-guide/data-migration/capabilities/file-formats.mdx
+++ b/packages/twenty-docs/l/fr/user-guide/data-migration/capabilities/file-formats.mdx
@@ -25,7 +25,7 @@ Twenty prend en charge trois formats de fichiers pour l’importation :
## Meilleures pratiques pour les fichiers CSV
* **Délimiteur** : Utilisez une virgule (`,`) ou un point-virgule (`;`)
-* **Délimiteur de texte** : Utilisez des guillemets doubles (`\"`) pour le texte contenant des virgules
+* **Délimiteur de texte** : Utilisez des guillemets doubles (`"`) pour le texte contenant des virgules
* **Fins de ligne** : Windows (CRLF) ou Unix (LF) sont tous deux pris en charge
* **Valeurs vides** : Laissez les cellules vides, n’utilisez pas "NULL" ni "N/A"
diff --git a/packages/twenty-docs/l/fr/user-guide/data-migration/capabilities/import-relations.mdx b/packages/twenty-docs/l/fr/user-guide/data-migration/capabilities/import-relations.mdx
index 68233b72537..69b524aeff2 100644
--- a/packages/twenty-docs/l/fr/user-guide/data-migration/capabilities/import-relations.mdx
+++ b/packages/twenty-docs/l/fr/user-guide/data-migration/capabilities/import-relations.mdx
@@ -44,12 +44,12 @@ Ici, le Projet est du côté "un". Plusieurs enregistrements issus d'objets diff
<img src="/images/user-guide/fields/one-to-many-morph.png" style={{width:'100%'}} />
<Warning>
- **Limitation d'import/export** : Les relations qui pointent vers plusieurs types d'objet (comme Notes → Personnes/Entreprises/Opportunités) ne sont **pas encore prises en charge** lors de l'import ou de l'export CSV.
+**Limitation d'import/export** : Les relations qui pointent vers plusieurs types d'objet (comme Notes → Personnes/Entreprises/Opportunités) ne sont **pas encore prises en charge** lors de l'import ou de l'export CSV.
- * **Import** : Seules les relations un-à-plusieurs pointant vers un seul type d'objet de chaque côté peuvent être importées
- * **Export** : Les colonnes pour les relations pointant vers plusieurs types d'objet sont actuellement laissées vides
+* **Import** : Seules les relations un-à-plusieurs pointant vers un seul type d'objet de chaque côté peuvent être importées
+* **Export** : Les colonnes pour les relations pointant vers plusieurs types d'objet sont actuellement laissées vides
- C'est sur notre feuille de route.
+C'est sur notre feuille de route.
</Warning>
### Ce qui n'est pas pris en charge aujourd'hui
@@ -137,12 +137,12 @@ S'il n'existe pas :
## Règle d'ordre d'importation
<Warning>
- **Importez toujours d'abord le côté "un" !**
+**Importez toujours d'abord le côté "un" !**
- 1. **Entreprises** d'abord (aucune dépendance)
- 2. **Personnes** en second (liées aux Entreprises)
- 3. **Opportunités** en troisième (liées aux Entreprises/Personnes)
- 4. **Objets personnalisés** en suivant leurs dépendances
+1. **Entreprises** d'abord (aucune dépendance)
+2. **Personnes** en second (liées aux Entreprises)
+3. **Opportunités** en troisième (liées aux Entreprises/Personnes)
+4. **Objets personnalisés** en suivant leurs dépendances
- L'enregistrement parent doit exister avant que vous puissiez y faire référence.
+L'enregistrement parent doit exister avant que vous puissiez y faire référence.
</Warning>
diff --git a/packages/twenty-docs/l/fr/user-guide/data-migration/capabilities/uniqueness-constraints.mdx b/packages/twenty-docs/l/fr/user-guide/data-migration/capabilities/uniqueness-constraints.mdx
index ca729ff0a33..bb37c1b3e78 100644
--- a/packages/twenty-docs/l/fr/user-guide/data-migration/capabilities/uniqueness-constraints.mdx
+++ b/packages/twenty-docs/l/fr/user-guide/data-migration/capabilities/uniqueness-constraints.mdx
@@ -50,9 +50,9 @@ Si la valeur d'un champ unique correspond à un enregistrement existant, cet enr
### Enregistrements supprimés de manière logique
<Warning>
- **Les enregistrements supprimés de manière logique comptent pour l'unicité.**
+**Les enregistrements supprimés de manière logique comptent pour l'unicité.**
- Les enregistrements supprimés de manière logique (visibles sous Menu Commandes → Voir les enregistrements supprimés) sont inclus dans les vérifications d'unicité. Si vous importez un enregistrement avec la même valeur unique qu'un enregistrement supprimé, l'enregistrement supprimé sera **restauré** avec les nouvelles données.
+Les enregistrements supprimés de manière logique (visibles sous Menu Commandes → Voir les enregistrements supprimés) sont inclus dans les vérifications d'unicité. Si vous importez un enregistrement avec la même valeur unique qu'un enregistrement supprimé, l'enregistrement supprimé sera **restauré** avec les nouvelles données.
</Warning>
## Détection des doublons lors de l'importation
diff --git a/packages/twenty-docs/l/fr/user-guide/data-migration/how-tos/export-your-data.mdx b/packages/twenty-docs/l/fr/user-guide/data-migration/how-tos/export-your-data.mdx
index bb7851b46af..e682f8666b6 100644
--- a/packages/twenty-docs/l/fr/user-guide/data-migration/how-tos/export-your-data.mdx
+++ b/packages/twenty-docs/l/fr/user-guide/data-migration/how-tos/export-your-data.mdx
@@ -24,7 +24,7 @@ Exportez les données de votre espace de travail en CSV pour des sauvegardes, de
* Seules les **colonnes visibles** sont exportées
* Seuls les **enregistrements filtrés** sont exportés (selon votre vue actuelle)
-<Note>Pour des exports plus volumineux (plus de 20 000 enregistrements), utilisez des filtres pour exporter par lots ou utilisez l'[API](/l/fr/developers/api).</Note>
+<Note>Pour des exports plus volumineux (plus de 20 000 enregistrements), utilisez des filtres pour exporter par lots ou utilisez l'[API](/l/fr/developers/extend/api).</Note>
### Autorisations
@@ -148,7 +148,7 @@ L'API n'a pas de limite d'enregistrements :
2. Utilisez l'API GraphQL pour interroger les enregistrements
3. Traitez les résultats dans votre application
-Voir : [Documentation de l'API](/l/fr/developers/api)
+Voir : [Documentation de l'API](/l/fr/developers/extend/api)
## Conseils et bonnes pratiques
@@ -206,4 +206,4 @@ Les fichiers exportés peuvent contenir des données sensibles :
* [Comment mettre à jour des enregistrements existants](/l/fr/user-guide/data-migration/how-tos/update-existing-records-via-import) — modifiez et réimportez votre export
* [Comment importer des données via l'API](/l/fr/user-guide/data-migration/how-tos/import-data-via-api) — pour de grands jeux de données
-* [Documentation de l'API](/l/fr/developers/api) — créez des flux de travail d'exportation personnalisés
+* [Documentation de l'API](/l/fr/developers/extend/api) — créez des flux de travail d'exportation personnalisés
diff --git a/packages/twenty-docs/l/fr/user-guide/data-migration/how-tos/fix-import-errors.mdx b/packages/twenty-docs/l/fr/user-guide/data-migration/how-tos/fix-import-errors.mdx
index ef2a086810b..6786f2d519e 100644
--- a/packages/twenty-docs/l/fr/user-guide/data-migration/how-tos/fix-import-errors.mdx
+++ b/packages/twenty-docs/l/fr/user-guide/data-migration/how-tos/fix-import-errors.mdx
@@ -71,12 +71,12 @@ Un champ unique (e-mail, domaine) :
3. Twenty mettra à jour l'enregistrement existant au lieu de créer un doublon
<Note>
- **Vous pouvez aussi mettre à jour les champs uniques.**
+**Vous pouvez aussi mettre à jour les champs uniques.**
- * Si vous conservez l'`id` mais changez l'`email` → l'adresse e-mail sera mise à jour
- * Si vous conservez l'`email` mais changez l'`id` → l'id sera mis à jour
+* Si vous conservez l'`id` mais changez l'`email` → l'adresse e-mail sera mise à jour
+* Si vous conservez l'`email` mais changez l'`id` → l'id sera mis à jour
- Tant qu'un identifiant unique correspond, Twenty met à jour l'enregistrement.
+Tant qu'un identifiant unique correspond, Twenty met à jour l'enregistrement.
</Note>
### Comment éviter cette erreur
@@ -88,9 +88,9 @@ Avant l'importation :
3. Vérifiez si des enregistrements existent déjà dans Twenty
<Warning>
- **Les enregistrements supprimés de façon logique comptent pour l'unicité.**
+**Les enregistrements supprimés de façon logique comptent pour l'unicité.**
- Vérifiez le menu Commande → Voir les enregistrements supprimés. Les enregistrements qui s'y trouvent imposent toujours l'unicité. Supprimez-les définitivement ou restaurez-les et mettez-les à jour.
+Vérifiez le menu Commande → Voir les enregistrements supprimés. Les enregistrements qui s'y trouvent imposent toujours l'unicité. Supprimez-les définitivement ou restaurez-les et mettez-les à jour.
</Warning>
Pour plus de détails : [Contraintes d'unicité](/l/fr/user-guide/data-migration/capabilities/uniqueness-constraints)
@@ -140,12 +140,12 @@ Les données ne correspondent pas au format attendu pour ce type de champ.
#### Date
**Problème :** Format de date non reconnu
-**Solution :** Utilisez un format cohérent dans tout le fichier
+**Solution :** Utilisez le format `YYYY-MM-DD` de façon cohérente dans tout le fichier
```
-✓ 2024-03-15 (YYYY-MM-DD - recommended)
-✓ 03/15/2024 (MM/DD/YYYY)
-✓ 15/03/2024 (DD/MM/YYYY)
+✓ 2024-03-15 (YYYY-MM-DD)
+❌ 03/15/2024 (MM/DD/YYYY)
+❌ 15/03/2024 (DD/MM/YYYY)
```
#### Téléphone
@@ -296,9 +296,9 @@ Vous essayez de lier un enregistrement qui n'existe pas dans Twenty.
* Vérifiez les fautes de frappe et la casse
<Warning>
- **L'importation échouera si une référence est faite à un enregistrement inexistant.**
+**L'importation échouera si une référence est faite à un enregistrement inexistant.**
- Importez toujours les objets parents avant les objets enfants.
+Importez toujours les objets parents avant les objets enfants.
</Warning>
Pour plus de détails : [Import des relations](/l/fr/user-guide/data-migration/capabilities/import-relations)
@@ -372,9 +372,9 @@ Vous essayez d'assigner un enregistrement à un utilisateur (Propriétaire, Assi
3. Utilisez la même adresse e-mail que celle utilisée pour rejoindre Twenty
<Warning>
- **Les utilisateurs doivent accepter les invitations avant l'importation.**
+**Les utilisateurs doivent accepter les invitations avant l'importation.**
- Si un utilisateur n'a pas accepté son invitation, les enregistrements qui s'y réfèrent auront des relations utilisateur vides.
+Si un utilisateur n'a pas accepté son invitation, les enregistrements qui s'y réfèrent auront des relations utilisateur vides.
</Warning>
---
diff --git a/packages/twenty-docs/l/fr/user-guide/data-migration/how-tos/import-companies-via-csv.mdx b/packages/twenty-docs/l/fr/user-guide/data-migration/how-tos/import-companies-via-csv.mdx
index 269017fa122..9fae6801afa 100644
--- a/packages/twenty-docs/l/fr/user-guide/data-migration/how-tos/import-companies-via-csv.mdx
+++ b/packages/twenty-docs/l/fr/user-guide/data-migration/how-tos/import-companies-via-csv.mdx
@@ -12,23 +12,23 @@ Ce guide vous accompagne pour importer vos entreprises dans Twenty. **Les entrep
### Liste de vérification des prérequis
<Check>
- Votre fichier est au format CSV, XLSX ou XLS
+Votre fichier est au format CSV, XLSX ou XLS
</Check>
<Check>
- Le fichier contient moins de 10 000 enregistrements
+Le fichier contient moins de 10 000 enregistrements
</Check>
<Check>
- Aucun domaine en double dans votre fichier
+Aucun domaine en double dans votre fichier
</Check>
<Check>
- Tous les champs personnalisés existent dans **Paramètres → Modèle de données**
+Tous les champs personnalisés existent dans **Paramètres → Modèle de données**
</Check>
<Note>
- Besoin d'importer plus de 10 000 entreprises ? Divisez en plusieurs fichiers ou utilisez l’[importation via l’API](/l/fr/user-guide/data-migration/how-tos/import-data-via-api).
+Besoin d'importer plus de 10 000 entreprises ? Divisez en plusieurs fichiers ou utilisez l’[importation via l’API](/l/fr/user-guide/data-migration/how-tos/import-data-via-api).
</Note>
## Étape 1 : Préparer vos données d'entreprises
@@ -46,9 +46,9 @@ Ce guide vous accompagne pour importer vos entreprises dans Twenty. **Les entrep
### Format du domaine
<Warning>
- **Utilisez le format `https://domain.com` pour les domaines.**
+**Utilisez le format `https://domain.com` pour les domaines.**
- Cela correspond au format utilisé lorsque des entreprises sont créées automatiquement à partir de la synchronisation e-mail/calendrier, ce qui évite les doublons par la suite.
+Cela correspond au format utilisé lorsque des entreprises sont créées automatiquement à partir de la synchronisation e-mail/calendrier, ce qui évite les doublons par la suite.
</Warning>
**Colonnes de domaine :**
@@ -74,7 +74,7 @@ Widget Co,https://widgets.co,widgets.co,New York,USA,50
```
<Note>
- **Astuce :** Cliquez sur **Télécharger le fichier d'exemple** lors de l'import pour voir les noms de colonnes exacts attendus par Twenty.
+**Astuce :** Cliquez sur **Télécharger le fichier d'exemple** lors de l'import pour voir les noms de colonnes exacts attendus par Twenty.
</Note>
## Étape 2 : Accéder à la fonction d'importation
@@ -123,7 +123,7 @@ Si vous avez des champs Sélection ou Multi-sélection :
3. Ou créez de nouvelles options si nécessaire
<Note>
- Les options de sélection utilisent les **noms d'API**, pas les libellés d'affichage. Accédez à **Paramètres → Modèle de données** → activez le **Mode avancé** pour voir les noms d'API.
+Les options de sélection utilisent les **noms d'API**, pas les libellés d'affichage. Accédez à **Paramètres → Modèle de données** → activez le **Mode avancé** pour voir les noms d'API.
</Note>
## Étape 6 : Examiner et corriger les erreurs
diff --git a/packages/twenty-docs/l/fr/user-guide/data-migration/how-tos/import-contacts-via-csv.mdx b/packages/twenty-docs/l/fr/user-guide/data-migration/how-tos/import-contacts-via-csv.mdx
index e5a6eac2d7d..0947a003bcc 100644
--- a/packages/twenty-docs/l/fr/user-guide/data-migration/how-tos/import-contacts-via-csv.mdx
+++ b/packages/twenty-docs/l/fr/user-guide/data-migration/how-tos/import-contacts-via-csv.mdx
@@ -12,29 +12,29 @@ Ce guide vous accompagne pour importer vos contacts (Personnes) dans Twenty. **I
### Liste de vérification des prérequis
<Check>
- Votre fichier est au format CSV, XLSX ou XLS
+Votre fichier est au format CSV, XLSX ou XLS
</Check>
<Check>
- Le fichier contient moins de 10 000 enregistrements
+Le fichier contient moins de 10 000 enregistrements
</Check>
<Check>
- Aucune adresse e-mail en double dans votre fichier
+Aucune adresse e-mail en double dans votre fichier
</Check>
<Check>
- **Entreprises importées en premier** (si vous liez des personnes à des entreprises)
+**Entreprises importées en premier** (si vous liez des personnes à des entreprises)
</Check>
<Check>
- Tous les champs personnalisés existent dans **Paramètres → Modèle de données**
+Tous les champs personnalisés existent dans **Paramètres → Modèle de données**
</Check>
<Warning>
- **Importer les entreprises avant les personnes**
+**Importer les entreprises avant les personnes**
- Si vous souhaitez lier des personnes à des entreprises, importez d'abord les entreprises. L'entreprise doit exister avant que vous puissiez y faire référence.
+Si vous souhaitez lier des personnes à des entreprises, importez d'abord les entreprises. L'entreprise doit exister avant que vous puissiez y faire référence.
</Warning>
## Étape 1 : Préparer vos données de contacts
@@ -81,7 +81,7 @@ Ajoutez une colonne contenant l'identifiant unique de l'entreprise :
| `companyId` | UUID | `c776ee49-f608-4a77-8cc8-6fe96ae1e43f` |
<Note>
- **Utilisez le format d'URL de domaine** (`https://acme.com`), pas le libellé. Cela correspond à la façon dont les entreprises sont stockées dans Twenty.
+**Utilisez le format d'URL de domaine** (`https://acme.com`), pas le libellé. Cela correspond à la façon dont les entreprises sont stockées dans Twenty.
</Note>
### Exemple de structure CSV
@@ -93,7 +93,7 @@ Jane,Doe,[email protected],CTO,https://widgets.co,2125551234,US
```
<Note>
- **Astuce :** Cliquez sur **Télécharger le fichier d'exemple** lors de l'importation ou exportez quelques personnes existantes pour voir les noms de colonnes exacts attendus par Twenty.
+**Astuce :** Cliquez sur **Télécharger le fichier d'exemple** lors de l'importation ou exportez quelques personnes existantes pour voir les noms de colonnes exacts attendus par Twenty.
</Note>
## Étape 2 : Accéder à la fonction d'importation
@@ -145,9 +145,9 @@ Lors du mappage de la colonne entreprise :
3. Twenty liera chaque personne à l'entreprise correspondante
<Warning>
- **N'associez qu'UN SEUL identifiant unique pour les relations.**
+**N'associez qu'UN SEUL identifiant unique pour les relations.**
- Ne mappez pas à la fois `companyId` ET `companyDomain`. Choisissez-en un — de préférence le domaine, car il est lisible par un humain.
+Ne mappez pas à la fois `companyId` ET `companyDomain`. Choisissez-en un — de préférence le domaine, car il est lisible par un humain.
</Warning>
## Étape 5 : Faire correspondre les valeurs des champs de sélection
@@ -159,7 +159,7 @@ Si vous avez des champs Sélection ou Multi-sélection (comme Source du lead) :
3. Ou créez de nouvelles options si nécessaire
<Note>
- Les options de sélection utilisent les **noms d'API**, pas les libellés d'affichage. Accédez à **Settings → Data Model** → activez **Advanced mode** pour voir les noms d'API.
+Les options de sélection utilisent les **noms d'API**, pas les libellés d'affichage. Accédez à **Settings → Data Model** → activez **Advanced mode** pour voir les noms d'API.
</Note>
## Étape 6 : Examiner et corriger les erreurs
diff --git a/packages/twenty-docs/l/fr/user-guide/data-migration/how-tos/import-data-via-api.mdx b/packages/twenty-docs/l/fr/user-guide/data-migration/how-tos/import-data-via-api.mdx
index 2ac448f4c0a..89f9e886279 100644
--- a/packages/twenty-docs/l/fr/user-guide/data-migration/how-tos/import-data-via-api.mdx
+++ b/packages/twenty-docs/l/fr/user-guide/data-migration/how-tos/import-data-via-api.mdx
@@ -32,9 +32,9 @@ Twenty applique des limites de débit pour garantir la stabilité du système :
| **Débit maximal** | ~6 000 enregistrements/minute |
<Warning>
- **Planifiez votre importation en fonction de ces limites.**
+**Planifiez votre importation en fonction de ces limites.**
- Pour 100 000 enregistrements au débit maximal, prévoyez environ 17 minutes d'importation. Ajoutez une marge pour la gestion des erreurs et les nouvelles tentatives.
+Pour 100 000 enregistrements au débit maximal, prévoyez environ 17 minutes d'importation. Ajoutez une marge pour la gestion des erreurs et les nouvelles tentatives.
</Warning>
## Prise en main
@@ -48,19 +48,19 @@ Twenty applique des limites de débit pour garantir la stabilité du système :
5. Stockez-la en toute sécurité
<Warning>
- **Gardez votre clé API secrète.**
+**Gardez votre clé API secrète.**
- Toute personne disposant de votre clé API peut accéder aux données de votre espace de travail et les modifier. Ne la validez jamais dans des dépôts de code et ne la partagez pas publiquement.
+Toute personne disposant de votre clé API peut accéder aux données de votre espace de travail et les modifier. Ne la validez jamais dans des dépôts de code et ne la partagez pas publiquement.
</Warning>
### Étape 2 : Choisissez votre API
Twenty prend en charge deux types d'API :
-| API | Idéal pour | Documentation |
-| ----------- | ----------------------------------------------------------------------- | -------------------------------------------------------------- |
-| **GraphQL** | Requêtes flexibles, récupération de données liées, opérations complexes | [Documentation de l'API](/l/fr/developers/api) |
-| **REST** | Opérations CRUD simples, modèles REST familiers | [Documentation de l'API](/l/fr/developers/api) |
+| API | Idéal pour | Documentation |
+| ----------- | ----------------------------------------------------------------------- | ------------------------------------------------ |
+| **GraphQL** | Requêtes flexibles, récupération de données liées, opérations complexes | [Documentation de l'API](/l/fr/developers/extend/api) |
+| **REST** | Opérations CRUD simples, modèles REST familiers | [Documentation de l'API](/l/fr/developers/extend/api) |
Les deux API prennent en charge :
@@ -173,4 +173,4 @@ Contactez-nous à [[email protected]](mailto:[email protected]) ou découvrez
Pour les détails complets de mise en œuvre, des exemples de code et la référence du schéma :
-* [Documentation de l'API](/l/fr/developers/api)
+* [Documentation de l'API](/l/fr/developers/extend/api)
diff --git a/packages/twenty-docs/l/fr/user-guide/data-migration/how-tos/import-relations-between-objects-via-csv.mdx b/packages/twenty-docs/l/fr/user-guide/data-migration/how-tos/import-relations-between-objects-via-csv.mdx
index cc73df8a167..89633de5558 100644
--- a/packages/twenty-docs/l/fr/user-guide/data-migration/how-tos/import-relations-between-objects-via-csv.mdx
+++ b/packages/twenty-docs/l/fr/user-guide/data-migration/how-tos/import-relations-between-objects-via-csv.mdx
@@ -51,9 +51,9 @@ Le parent (côté "un") doit exister dans Twenty avant que vous ne puissiez y fa
4. **Tâches/Notes** (liées à l'un des éléments ci-dessus)
<Warning>
- **Si l'enregistrement parent n'existe pas, l'import échouera.**
+**Si l'enregistrement parent n'existe pas, l'import échouera.**
- Vérifiez toujours que les Entreprises sont importées avant d'importer des Personnes avec des références à l'Entreprise.
+Vérifiez toujours que les Entreprises sont importées avant d'importer des Personnes avec des références à l'Entreprise.
</Warning>
## Étape 3 : Noter l'identifiant unique du parent
@@ -117,9 +117,9 @@ La colonne `companyDomain` référence le domaine de l'Entreprise.
| ID | UUID | `c776ee49-f608-4a77-8cc8-6fe96ae1e43f` |
<Warning>
- **Le format du domaine est important !**
+**Le format du domaine est important !**
- Utilisez `https://domain.com` (et non simplement `domain.com`). Cela correspond à la manière dont Twenty stocke les domaines des Entreprises et évite les erreurs d'association.
+Utilisez `https://domain.com` (et non simplement `domain.com`). Cela correspond à la manière dont Twenty stocke les domaines des Entreprises et évite les erreurs d'association.
</Warning>
### Règles importantes
@@ -178,7 +178,6 @@ Review proposal,[email protected]
<AccordionGroup>
<Accordion title="Que faire si mon enregistrement parent n'a pas de domaine ni d'e-mail ?">
Vous avez deux options :
-
1. Utilisez l'`id` Twenty (exportez les enregistrements parents pour obtenir leurs identifiants)
2. Créez un champ unique personnalisé dans votre modèle de données pour stocker un identifiant externe provenant de votre système précédent
</Accordion>
@@ -197,7 +196,6 @@ Review proposal,[email protected]
<Accordion title="Que se passe-t-il si un enregistrement parent n'existe pas ?">
L'import affichera une erreur pour cette ligne. Vous pouvez :
-
* Importez d'abord l'enregistrement parent, puis réimportez
* Corrigez la valeur de référence
* Supprimez la ligne de l'import
@@ -205,7 +203,6 @@ Review proposal,[email protected]
<Accordion title="Pourquoi ma relation ne se lie-t-elle pas correctement ?">
Causes courantes :
-
* Mauvais format (utilisez `https://domain.com` pour les domaines)
* Incohérence de casse (vérifiez l'orthographe exacte)
* Le parent n'existe pas (importez d'abord les parents)
@@ -214,9 +211,9 @@ Review proposal,[email protected]
</AccordionGroup>
<Warning>
- **Rappel : Les enregistrements supprimés de façon logique comptent pour l'unicité.**
+**Rappel : Les enregistrements supprimés de façon logique comptent pour l'unicité.**
- Si vous obtenez des erreurs "introuvable" mais que l'enregistrement semble exister, vérifiez le menu de commande → Voir les enregistrements supprimés. Le parent a peut-être été supprimé de façon logique.
+Si vous obtenez des erreurs "introuvable" mais que l'enregistrement semble exister, vérifiez le menu de commande → Voir les enregistrements supprimés. Le parent a peut-être été supprimé de façon logique.
</Warning>
## Résolution des problèmes
diff --git a/packages/twenty-docs/l/fr/user-guide/data-migration/how-tos/migrating-from-other-crms.mdx b/packages/twenty-docs/l/fr/user-guide/data-migration/how-tos/migrating-from-other-crms.mdx
index b260dbe954e..404fc7bf121 100644
--- a/packages/twenty-docs/l/fr/user-guide/data-migration/how-tos/migrating-from-other-crms.mdx
+++ b/packages/twenty-docs/l/fr/user-guide/data-migration/how-tos/migrating-from-other-crms.mdx
@@ -59,17 +59,17 @@ Avant d'importer des données, préparez votre espace de travail Twenty :
4. Configurez les paramètres des champs (unique, obligatoire, options de sélection, etc.)
<Warning>
- **Les champs doivent exister avant l'importation.**
+**Les champs doivent exister avant l'importation.**
- L'import CSV crée des enregistrements, pas des champs. Créez tous les champs personnalisés dans **Paramètres → Modèle de données** avant l'importation.
+L'import CSV crée des enregistrements, pas des champs. Créez tous les champs personnalisés dans **Paramètres → Modèle de données** avant l'importation.
</Warning>
### Invitez votre équipe
<Warning>
- **Invitez les utilisateurs AVANT d'importer des données.**
+**Invitez les utilisateurs AVANT d'importer des données.**
- Si vos données incluent des références à des utilisateurs (propriétaire du compte, assigné, etc.), ces utilisateurs doivent exister dans Twenty avant l'importation. Sinon, ces relations ne pourront pas être mises en correspondance.
+Si vos données incluent des références à des utilisateurs (propriétaire du compte, assigné, etc.), ces utilisateurs doivent exister dans Twenty avant l'importation. Sinon, ces relations ne pourront pas être mises en correspondance.
</Warning>
1. Allez dans **Paramètres → Membres**
@@ -116,9 +116,9 @@ Ouvrez chaque CSV exporté dans une application de tableur et préparez-le pour
| **Champs de sélection** | Utilisez les noms d'API, pas les libellés d'affichage |
<Warning>
- **Le format du domaine est critique.**
+**Le format du domaine est critique.**
- Utilisez `https://domain.com` (pas `domain.com` ni `www.domain.com`). Cela correspond au format de Twenty et évite les doublons lorsque vous connectez la synchronisation e-mail/calendrier.
+Utilisez `https://domain.com` (pas `domain.com` ni `www.domain.com`). Cela correspond au format de Twenty et évite les doublons lorsque vous connectez la synchronisation e-mail/calendrier.
</Warning>
Voir [Comment préparer vos fichiers CSV](/l/fr/user-guide/data-migration/how-tos/prepare-your-csv-files) pour connaître les exigences complètes de formatage pour tous les types de champs.
@@ -149,17 +149,16 @@ Voir [Comment préparer vos fichiers CSV](/l/fr/user-guide/data-migration/how-to
## Étape 6 : Importez dans Twenty
<Warning>
- **L'ordre d'importation est important !**
+**L'ordre d'importation est important !**
- Importez toujours dans cet ordre :
+Importez toujours dans cet ordre :
+1. **Entreprises** d'abord (aucune dépendance)
+2. **Personnes** ensuite (liées aux Entreprises)
+3. **Opportunités** en troisième (liées aux Entreprises/Personnes)
+4. **Notes et tâches** (liées aux enregistrements)
+5. **Objets personnalisés** en suivant leurs dépendances
- 1. **Entreprises** d'abord (aucune dépendance)
- 2. **Personnes** ensuite (liées aux Entreprises)
- 3. **Opportunités** en troisième (liées aux Entreprises/Personnes)
- 4. **Notes et tâches** (liées aux enregistrements)
- 5. **Objets personnalisés** en suivant leurs dépendances
-
- L'enregistrement parent doit exister avant que vous puissiez y faire référence.
+L'enregistrement parent doit exister avant que vous puissiez y faire référence.
</Warning>
### Importez chaque objet
@@ -215,7 +214,7 @@ Après l'importation des données, terminez la configuration de votre espace de
### Configurez les rôles et les autorisations
-* Configurez les rôles dans **Paramètres → Rôles**
+* Configurez les rôles dans **Paramètres → Membres → Rôles**
* Affectez les utilisateurs aux rôles appropriés
### Connectez les e-mails et le calendrier
diff --git a/packages/twenty-docs/l/fr/user-guide/data-migration/how-tos/migrating-from-self-hosted-to-cloud.mdx b/packages/twenty-docs/l/fr/user-guide/data-migration/how-tos/migrating-from-self-hosted-to-cloud.mdx
index 6f64e8427f4..8dbacf3f975 100644
--- a/packages/twenty-docs/l/fr/user-guide/data-migration/how-tos/migrating-from-self-hosted-to-cloud.mdx
+++ b/packages/twenty-docs/l/fr/user-guide/data-migration/how-tos/migrating-from-self-hosted-to-cloud.mdx
@@ -29,9 +29,9 @@ Avant d'importer des données, recréez vos objets et champs personnalisés:
## Étape 3: Invitez tous les utilisateurs
<Warning>
- **Critique: invitez les utilisateurs AVANT d'importer des données.**
+**Critique: invitez les utilisateurs AVANT d'importer des données.**
- Les utilisateurs doivent accepter leurs invitations avant que vous n'importiez des enregistrements qui les référencent (comme les champs Propriétaire du compte). Si les utilisateurs n'existent pas encore, ces relations ne pourront pas être mises en correspondance.
+Les utilisateurs doivent accepter leurs invitations avant que vous n'importiez des enregistrements qui les référencent (comme les champs Propriétaire du compte). Si les utilisateurs n'existent pas encore, ces relations ne pourront pas être mises en correspondance.
</Warning>
1. Allez dans **Paramètres → Membres** dans votre instance cloud
@@ -127,7 +127,7 @@ Après l'importation des données, recréez manuellement:
### Rôles et autorisations
-* Configurez les rôles dans **Paramètres → Rôles**
+* Configurez les rôles dans **Paramètres → Membres → Rôles**
* Affectez les utilisateurs aux rôles appropriés
### Intégrations
diff --git a/packages/twenty-docs/l/fr/user-guide/data-migration/how-tos/prepare-your-csv-files.mdx b/packages/twenty-docs/l/fr/user-guide/data-migration/how-tos/prepare-your-csv-files.mdx
index fa46b802dea..49ad7be603c 100644
--- a/packages/twenty-docs/l/fr/user-guide/data-migration/how-tos/prepare-your-csv-files.mdx
+++ b/packages/twenty-docs/l/fr/user-guide/data-migration/how-tos/prepare-your-csv-files.mdx
@@ -103,8 +103,6 @@ Le champ Adresse est un **champ imbriqué** avec plusieurs colonnes (certaines p
Utilisez un format cohérent dans tout votre fichier:
* `YYYY-MM-DD` (recommandé): `2024-03-15`
-* `MM/DD/YYYY`: `03/15/2024`
-* `DD/MM/YYYY`: `15/03/2024`
* ISO 8601: `2024-03-15T10:30:00Z`
### Champs numériques
@@ -210,15 +208,14 @@ Jane,Doe,[email protected],https://widgets.co
* Pour les membres de l’espace de travail, utilisez leur **adresse e-mail** (et non le nom)
<Warning>
- **L’ordre d’importation est important !**
+**L’ordre d’importation est important !**
- Importez le côté « un » avant le côté « plusieurs »:
+Importez le côté « un » avant le côté « plusieurs »:
+1. **Entreprises** d’abord
+2. **Personnes** ensuite (avec référence à l’entreprise)
+3. **Opportunités** en troisième
- 1. **Entreprises** d’abord
- 2. **Personnes** ensuite (avec référence à l’entreprise)
- 3. **Opportunités** en troisième
-
- L’enregistrement parent doit exister avant que vous puissiez y faire référence.
+L’enregistrement parent doit exister avant que vous puissiez y faire référence.
</Warning>
Consultez [Comment importer des relations](/l/fr/user-guide/data-migration/how-tos/import-relations-between-objects-via-csv) pour des instructions détaillées.
diff --git a/packages/twenty-docs/l/fr/user-guide/data-migration/how-tos/update-existing-records-via-import.mdx b/packages/twenty-docs/l/fr/user-guide/data-migration/how-tos/update-existing-records-via-import.mdx
index b5fc970289b..1834e45a623 100644
--- a/packages/twenty-docs/l/fr/user-guide/data-migration/how-tos/update-existing-records-via-import.mdx
+++ b/packages/twenty-docs/l/fr/user-guide/data-migration/how-tos/update-existing-records-via-import.mdx
@@ -25,11 +25,11 @@ Lorsque vous importez un fichier contenant un **identifiant unique** qui corresp
| Est absent de votre fichier | **Créer** un nouvel enregistrement (avec un identifiant généré automatiquement) |
<Warning>
- **Les champs à sélection multiple sont écrasés, pas fusionnés.**
+**Les champs à sélection multiple sont écrasés, pas fusionnés.**
- Si un enregistrement a `Option A` et `Option B` sélectionnées et que vous importez `["Option C"]`, l'enregistrement n'aura plus que `Option C` après l'importation. L'importation remplace toutes les sélections précédentes — elle ne les complète pas.
+Si un enregistrement a `Option A` et `Option B` sélectionnées et que vous importez `["Option C"]`, l'enregistrement n'aura plus que `Option C` après l'importation. L'importation remplace toutes les sélections précédentes — elle ne les complète pas.
- Pour conserver les valeurs existantes, incluez-les toutes dans votre importation : `["Option A","Option B","Option C"]`
+Pour conserver les valeurs existantes, incluez-les toutes dans votre importation : `["Option A","Option B","Option C"]`
</Warning>
## Étape 1 : Exporter vos données actuelles
@@ -80,9 +80,9 @@ id,email,firstName,lastName,jobTitle
```
<Warning>
- **Ne modifiez pas les valeurs des identifiants uniques.**
+**Ne modifiez pas les valeurs des identifiants uniques.**
- Si vous remplacez `[email protected]` par `[email protected]`, Twenty créera un nouvel enregistrement au lieu de mettre à jour l'existant.
+Si vous remplacez `[email protected]` par `[email protected]`, Twenty créera un nouvel enregistrement au lieu de mettre à jour l'existant.
</Warning>
## Étape 3 : Importer le fichier mis à jour
diff --git a/packages/twenty-docs/l/fr/user-guide/data-migration/overview.mdx b/packages/twenty-docs/l/fr/user-guide/data-migration/overview.mdx
index d84486ebcff..0cb7c8904de 100644
--- a/packages/twenty-docs/l/fr/user-guide/data-migration/overview.mdx
+++ b/packages/twenty-docs/l/fr/user-guide/data-migration/overview.mdx
@@ -1,11 +1,10 @@
---
-title: Migration de données},{
+title: Migration de données
description: Importez et exportez vos données CRM via des fichiers CSV ou l’API.
---
import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
-
## Méthodes d’import
Twenty prend en charge deux méthodes principales d’import de données :
@@ -40,16 +39,15 @@ Vous pouvez importer des relations entre objets à l’aide de la fonction d’i
<Note>**Les enregistrements supprimés comptent pour l’unicité.** Les enregistrements supprimés de façon logique (visibles dans le menu Commande → Voir les enregistrements supprimés) sont inclus dans les vérifications d’unicité. Si vous importez un enregistrement ayant la même valeur unique qu’un enregistrement supprimé, l’enregistrement supprimé sera restauré.</Note>
<Warning>
- **L’ordre d’importation est important !**
-
- Lors de l’import d’objets liés, téléversez les fichiers dans cet ordre :
+**L’ordre d’importation est important !**
- 1. **Entreprises** d’abord (le côté "un" des relations)
- 2. **Personnes** en second (liées aux entreprises via companyId)
- 3. **Opportunités** en troisième (liées aux entreprises/personnes)
- 4. **Objets personnalisés** avec relations en dernier
+Lors de l’import d’objets liés, téléversez les fichiers dans cet ordre :
+1. **Entreprises** d’abord (le côté "un" des relations)
+2. **Personnes** en second (liées aux entreprises via companyId)
+3. **Opportunités** en troisième (liées aux entreprises/personnes)
+4. **Objets personnalisés** avec relations en dernier
- Pourquoi ? Le côté "un" d’une relation un-à-plusieurs doit exister avant que vous puissiez y faire référence. Par exemple, l’enregistrement Entreprise doit exister avant d’importer une Personne avec l’ID de cette entreprise.
+Pourquoi ? Le côté "un" d’une relation un-à-plusieurs doit exister avant que vous puissiez y faire référence. Par exemple, l’enregistrement Entreprise doit exister avant d’importer une Personne avec l’ID de cette entreprise.
</Warning>
Veuillez consulter [cet article](/l/fr/user-guide/data-migration/how-tos/import-relations-between-objects-via-csv) pour un guide étape par étape sur la procédure à suivre.
diff --git a/packages/twenty-docs/l/fr/user-guide/data-model/capabilities/fields.mdx b/packages/twenty-docs/l/fr/user-guide/data-model/capabilities/fields.mdx
index e4885faef2a..f83bdf9d008 100644
--- a/packages/twenty-docs/l/fr/user-guide/data-model/capabilities/fields.mdx
+++ b/packages/twenty-docs/l/fr/user-guide/data-model/capabilities/fields.mdx
@@ -101,6 +101,10 @@ Rendez un champ unique pour garantir que des enregistrements distincts ne peuven
Si vous obtenez une erreur lors de la définition de l'unicité, vérifiez les valeurs en double dans vos données (y compris les enregistrements supprimés).
+## Index (avancé)
+
+Les index de base de données sont gérés automatiquement — ajouter les vôtres est rarement nécessaire et il est facile de se tromper. Lorsque le mode avancé est activé, chaque objet possède une section **Index** sous `Paramètres → Modèle de données → <object>` pour les cas où vous savez que vous en avez besoin.
+
## Bonnes pratiques de configuration des champs
### Conventions de nommage et limitations
diff --git a/packages/twenty-docs/l/fr/user-guide/data-model/capabilities/relation-fields.mdx b/packages/twenty-docs/l/fr/user-guide/data-model/capabilities/relation-fields.mdx
index a15867af4ea..ff0dce43e24 100644
--- a/packages/twenty-docs/l/fr/user-guide/data-model/capabilities/relation-fields.mdx
+++ b/packages/twenty-docs/l/fr/user-guide/data-model/capabilities/relation-fields.mdx
@@ -30,7 +30,7 @@ De même, un Projet (du côté "un") pourrait recevoir des liens de plusieurs Pe
<img src="/images/user-guide/fields/one-to-many-morph.png" style={{width:'100%'}} />
<Warning>
- **Limitation d'import/export** : Les relations pointant vers plusieurs types d'objets ne sont pas encore prises en charge pour l'import/export CSV. C'est sur notre feuille de route.
+**Limitation d'import/export** : Les relations pointant vers plusieurs types d'objets ne sont pas encore prises en charge pour l'import/export CSV. C'est sur notre feuille de route.
</Warning>
### Plusieurs-à-plusieurs
@@ -44,7 +44,7 @@ Les relations plusieurs-à-plusieurs utilisent un modèle d'**objet de jonction*
<img src="/images/user-guide/fields/junction-relation-diagram.png" style={{width:'100%'}} />
<Warning>
- **Fonctionnalité de laboratoire**: Les relations de jonction doivent être activées dans **Settings → Updates → Lab** avant utilisation.
+**Fonctionnalité de laboratoire**: Les relations de jonction doivent être activées dans **Settings → Updates → Lab** avant utilisation.
</Warning>
Voir [Comment créer des relations plusieurs-à-plusieurs](/l/fr/user-guide/data-model/how-tos/create-many-to-many-relations) pour un guide pas à pas complet.
diff --git a/packages/twenty-docs/l/fr/user-guide/data-model/how-tos/create-custom-fields.mdx b/packages/twenty-docs/l/fr/user-guide/data-model/how-tos/create-custom-fields.mdx
index a4b1d8ecdaa..bacac243482 100644
--- a/packages/twenty-docs/l/fr/user-guide/data-model/how-tos/create-custom-fields.mdx
+++ b/packages/twenty-docs/l/fr/user-guide/data-model/how-tos/create-custom-fields.mdx
@@ -35,7 +35,7 @@ Les nouveaux champs ne sont pas visibles automatiquement. Pour l'afficher :
3. Faites glisser pour réorganiser les options
<Note>
- **Utilisez les noms d'API pour les importations.** Activez le **mode avancé** dans Paramètres pour voir les noms d'API. Voir [Correspondance des champs](/l/fr/user-guide/data-migration/capabilities/field-mapping).
+**Utilisez les noms d'API pour les importations.** Activez le **mode avancé** dans Paramètres pour voir les noms d'API. Voir [Correspondance des champs](/l/fr/user-guide/data-migration/capabilities/field-mapping).
</Note>
### Pour les champs de devise
@@ -51,7 +51,7 @@ Définissez le **code du pays par défaut** à préremplir pour les nouveaux num
Activez **Unique** pour empêcher les valeurs en double dans l'ensemble des enregistrements.
<Note>
- S'il existe des doublons (y compris dans les enregistrements supprimés), une erreur s'affichera. Commencez par supprimer les doublons.
+S'il existe des doublons (y compris dans les enregistrements supprimés), une erreur s'affichera. Commencez par supprimer les doublons.
</Note>
### Définir des valeurs par défaut
diff --git a/packages/twenty-docs/l/fr/user-guide/data-model/how-tos/create-custom-objects.mdx b/packages/twenty-docs/l/fr/user-guide/data-model/how-tos/create-custom-objects.mdx
index cf1d92c5a61..91d41f81cb2 100644
--- a/packages/twenty-docs/l/fr/user-guide/data-model/how-tos/create-custom-objects.mdx
+++ b/packages/twenty-docs/l/fr/user-guide/data-model/how-tos/create-custom-objects.mdx
@@ -6,7 +6,7 @@ description: Guide étape par étape pour créer des objets personnalisés dans
Les objets personnalisés vous permettent de stocker des informations propres à votre entreprise que les objets standard ne couvrent pas. Par exemple : Projets, Produits, Tickets ou Annonces.
<Note>
- **Vous ne savez pas si vous avez besoin d'un objet ou d'un champ ?** Consultez [Comprendre votre modèle de données](/l/fr/user-guide/data-model/overview) pour des conseils.
+**Vous ne savez pas si vous avez besoin d'un objet ou d'un champ ?** Consultez [Comprendre votre modèle de données](/l/fr/user-guide/data-model/overview) pour des conseils.
</Note>
## Étapes
diff --git a/packages/twenty-docs/l/fr/user-guide/data-model/how-tos/create-many-to-many-relations.mdx b/packages/twenty-docs/l/fr/user-guide/data-model/how-tos/create-many-to-many-relations.mdx
index 1f65512c21e..1002fe237bc 100644
--- a/packages/twenty-docs/l/fr/user-guide/data-model/how-tos/create-many-to-many-relations.mdx
+++ b/packages/twenty-docs/l/fr/user-guide/data-model/how-tos/create-many-to-many-relations.mdx
@@ -6,11 +6,11 @@ description: Reliez des enregistrements lorsque de nombreux éléments des deux
Les relations plusieurs-à-plusieurs vous permettent de relier plusieurs enregistrements des deux côtés. Par exemple : de nombreuses Personnes peuvent travailler sur de nombreux Projets, et chaque Projet peut avoir de nombreuses Personnes.
<Warning>
- **Fonctionnalité Lab** : Les relations de jonction sont actuellement dans le Lab. Activez-les dans **Paramètres → Mises à jour → Lab** avant de suivre ce guide.
+**Fonctionnalité Lab** : Les relations de jonction sont actuellement dans le Lab. Activez-les dans **Paramètres → Mises à jour → Lab** avant de suivre ce guide.
</Warning>
<Note>
- Cette fonctionnalité exige également que le **mode avancé** soit activé (bascule en bas à droite des Paramètres).
+Cette fonctionnalité exige également que le **mode avancé** soit activé (bascule en bas à droite des Paramètres).
</Note>
## Quand utiliser les relations plusieurs-à-plusieurs
@@ -53,38 +53,45 @@ D'abord, créez l'objet intermédiaire qui contiendra les connexions.
1. Allez dans **Paramètres → Modèle de données**
2. Cliquez sur **+ Nouvel objet**
3. Donnez-lui un nom explicite (p. ex., "Affectation de projet", "Membre de l'équipe", "Commande de produit")
-4. Cliquez sur **Enregistrer**
+4. Activez l’option "Ignorer la création d’un champ Nom"
+
+<img src="/images/user-guide/fields/new-pivot-object.png" alt="Nouvel objet de jonction" />
+
+5. Cliquez sur **Enregistrer**
<Tip>
- **Convention de nommage** : Utilisez un nom qui décrit la relation, comme "Affectation de projet" ou "Appartenance à l'équipe". Cela rend le modèle de données plus facile à comprendre.
+**Convention de nommage** : Utilisez un nom qui décrit la relation, comme "Affectation de projet" ou "Appartenance à l'équipe". Cela rend le modèle de données plus facile à comprendre.
</Tip>
-## Étape 2 : Créer des relations à partir de l'objet de jonction
+## Étape 2 : Créer des relations entre les objets et l’objet de jonction
-Ajoutez des champs de relation depuis l'objet de jonction vers les deux objets que vous souhaitez connecter.
+Ajoutez des champs de relation depuis chacun de vos deux objets vers l’objet de jonction.
-### Première relation (Jonction → Objet A)
+### Première relation (Objet A → Jonction)
-1. Sélectionnez votre objet de jonction dans **Paramètres → Modèle de données**
-2. Cliquez sur **+ Ajouter un champ**
-3. Choisissez **Relation** comme type de champ
-4. Sélectionnez le premier objet (p. ex., "Personnes")
-5. Définissez le type de relation sur **Plusieurs-à-un** (de nombreuses affectations peuvent être liées à une personne)
-6. Nommez les champs :
- * Champ sur la jonction : p. ex., "Personne"
+1. Sélectionnez votre premier objet dans **Paramètres → Modèle de données**
+2. Cliquez sur **+ Ajouter une relation**
+3. Sélectionnez l’objet de jonction (p. ex., "Affectations de projet")
+4. Définissez le type de relation sur **Un-à-plusieurs** (une personne peut être liée à de nombreuses affectations)
+5. Nommez les champs :
* Champ sur Personnes : p. ex., "Affectations de projet"
-7. Cliquez sur **Enregistrer**
+ * Champ sur la jonction : p. ex., "Personne"
+6. Cliquez sur **Enregistrer**
-### Deuxième relation (Jonction → Objet B)
+### Deuxième relation (Objet B → Jonction)
-1. Toujours sur l'objet de jonction, cliquez sur **+ Ajouter un champ**
-2. Choisissez **Relation** comme type de champ
-3. Sélectionnez le deuxième objet (p. ex., "Projets")
-4. Définissez le type de relation sur **Plusieurs-à-un**
-5. Nommez les champs :
+1. Sélectionnez votre deuxième objet dans **Paramètres → Modèle de données**
+2. Cliquez sur **+ Ajouter une relation**
+3. Sélectionnez l’objet de jonction (p. ex., "Affectations de projet")
+4. Définissez le type de relation sur **Un-à-plusieurs** (un projet peut être lié à de nombreuses affectations)
+5. Activez **"Il s'agit d'une relation vers un objet de jonction"**
+
+<img src="/images/user-guide/fields/junction-relation-toggle.png" style={{width:'100%'}} />
+
+6. Nommez les champs :
* Champ sur la jonction : p. ex., "Projet"
* Champ sur Projets : p. ex., "Membres de l'équipe"
-6. Cliquez sur **Enregistrer**
+7. Cliquez sur **Enregistrer**
## Étape 3 : Configurer l'affichage de la relation de jonction
@@ -98,18 +105,6 @@ Configurez maintenant les objets sources pour afficher directement les enregistr
6. Sélectionnez la **relation cible** (p. ex., "Projet" — le champ sur la jonction qui pointe vers l'autre côté)
7. Cliquez sur **Enregistrer**
-{/* TODO: Add image
-<img src="/images/user-guide/fields/junction-relation-toggle.png" style={{width:'100%'}}/>
-*/}
-
-Répétez pour l'autre objet :
-
-1. Sélectionnez "Projets" dans Modèle de données
-2. Modifiez le champ de relation "Membres de l'équipe"
-3. Activez la bascule de jonction
-4. Sélectionnez "Personne" comme relation cible
-5. Enregistrer
-
## Résultat
Après configuration :
@@ -130,15 +125,15 @@ Voici un guide complet :
### Ajouter des relations
-1. **Affectation de projet → Personnes**
- * Type : Plusieurs-à-un
- * Champ sur Affectation : "Personne"
+1. **Personnes → Affectation de projet**
+ * Type : Un-à-plusieurs
* Champ sur Personnes : "Affectations de projet"
+ * Champ sur Affectation : "Personne"
-2. **Affectation de projet → Projets**
- * Type : Plusieurs-à-un
- * Champ sur Affectation : "Projet"
+2. **Projets → Affectation de projet**
+ * Type : Un-à-plusieurs
* Champ sur Projets : "Membres de l'équipe"
+ * Champ sur Affectation : "Projet"
### Configurer l'affichage de la jonction
diff --git a/packages/twenty-docs/l/fr/user-guide/data-model/how-tos/create-relation-fields.mdx b/packages/twenty-docs/l/fr/user-guide/data-model/how-tos/create-relation-fields.mdx
index 28e5414e871..db63cb126e2 100644
--- a/packages/twenty-docs/l/fr/user-guide/data-model/how-tos/create-relation-fields.mdx
+++ b/packages/twenty-docs/l/fr/user-guide/data-model/how-tos/create-relation-fields.mdx
@@ -6,7 +6,7 @@ description: Guide étape par étape pour connecter des objets à l'aide de cham
Les champs de relation relient des enregistrements provenant d'objets différents — par exemple, relier des Personnes à des Entreprises.
<Note>
- **Les noms de relation ne peuvent pas être modifiés après leur création** (ils affectent l'API). Planifiez soigneusement les noms.
+**Les noms de relation ne peuvent pas être modifiés après leur création** (ils affectent l'API). Planifiez soigneusement les noms.
</Note>
## Avant de démarrer
@@ -51,7 +51,7 @@ Désormais, chaque Personne peut être liée à une Entreprise, et chaque Entrep
Les liens sont conservés mais masqués. Réactivez pour restaurer.
<Note>
- **La suppression d'une relation ne supprime pas les enregistrements.** Seul le lien entre eux est supprimé.
+**La suppression d'une relation ne supprime pas les enregistrements.** Seul le lien entre eux est supprimé.
</Note>
## Connexes
diff --git a/packages/twenty-docs/l/fr/user-guide/data-model/how-tos/customize-your-data-model.mdx b/packages/twenty-docs/l/fr/user-guide/data-model/how-tos/customize-your-data-model.mdx
index 92cc7769be4..01ffd74dcf4 100644
--- a/packages/twenty-docs/l/fr/user-guide/data-model/how-tos/customize-your-data-model.mdx
+++ b/packages/twenty-docs/l/fr/user-guide/data-model/how-tos/customize-your-data-model.mdx
@@ -1,5 +1,5 @@
---
-title: Personnalisez votre modèle de données},{
+title: Personnalisez votre modèle de données
description: Vue d’ensemble des options de personnalisation du modèle de données.
---
diff --git a/packages/twenty-docs/l/fr/user-guide/data-model/how-tos/data-model-faq.mdx b/packages/twenty-docs/l/fr/user-guide/data-model/how-tos/data-model-faq.mdx
index f63406ca27d..cc213d5940f 100644
--- a/packages/twenty-docs/l/fr/user-guide/data-model/how-tos/data-model-faq.mdx
+++ b/packages/twenty-docs/l/fr/user-guide/data-model/how-tos/data-model-faq.mdx
@@ -6,148 +6,147 @@ description: Foire aux questions sur le modèle de données de Twenty.
## Gestion des objets
<AccordionGroup>
- <Accordion title="Puis-je supprimer un objet personnalisé ?">
- Oui, les objets personnalisés peuvent être supprimés. Vous pouvez également les désactiver d'abord, ce qui masque l'objet et ses données dans l'interface tout en préservant les données.
- </Accordion>
+<Accordion title="Puis-je supprimer un objet personnalisé ?">
+Oui, les objets personnalisés peuvent être supprimés. Vous pouvez également les désactiver d'abord, ce qui masque l'objet et ses données dans l'interface tout en préservant les données.
+</Accordion>
- <Accordion title="Puis-je supprimer des objets standard (Personnes, Entreprises, etc.) ?">
- Non, les objets standards ne peuvent pas être supprimés. Vous pouvez seulement les désactiver, ce qui les masque dans l'interface tout en préservant les données.
- </Accordion>
+<Accordion title="Puis-je supprimer des objets standard (Personnes, Entreprises, etc.) ?">
+Non, les objets standards ne peuvent pas être supprimés. Vous pouvez seulement les désactiver, ce qui les masque dans l'interface tout en préservant les données.
+</Accordion>
- <Accordion title="Combien d'objets personnalisés puis-je créer ?">
- Vous pouvez créer autant d'objets et de champs personnalisés que vous le souhaitez — le prix ne change pas.
- </Accordion>
+<Accordion title="Combien d'objets personnalisés puis-je créer ?">
+Vous pouvez créer autant d'objets et de champs personnalisés que vous le souhaitez — le prix ne change pas.
+</Accordion>
- <Accordion title="Puis-je renommer un objet standard ?">
- Vous pouvez renommer le libellé des objets standard (Personnes, Entreprises, Opportunités), mais pas leurs noms d'API. Les noms d'API sont fixes pour assurer la cohérence dans tous les espaces de travail Twenty.
- </Accordion>
+<Accordion title="Puis-je renommer un objet standard ?">
+Vous pouvez renommer le libellé des objets standard (Personnes, Entreprises, Opportunités), mais pas leurs noms d'API. Les noms d'API sont fixes pour assurer la cohérence dans tous les espaces de travail Twenty.
+</Accordion>
- <Accordion title="Puis-je modifier l'icône d'un objet ?">
- Oui, vous pouvez modifier l'icône des objets standard et personnalisés dans **Paramètres → Modèle de données**.
- </Accordion>
+<Accordion title="Puis-je modifier l'icône d'un objet ?">
+Oui, vous pouvez modifier l'icône des objets standard et personnalisés dans **Paramètres → Modèle de données**.
+</Accordion>
- <Accordion title="Puis-je réorganiser les objets dans la barre de navigation à gauche ?">
- Pas encore. L'ordre des objets dans la navigation est actuellement fixe, mais cette fonctionnalité est prévue pour une future version.
- </Accordion>
+<Accordion title="Puis-je réorganiser les objets dans la barre de navigation à gauche ?">
+Pas encore. L'ordre des objets dans la navigation est actuellement fixe, mais cette fonctionnalité est prévue pour une future version.
+</Accordion>
- <Accordion title="Puis-je masquer des objets de la barre de navigation à gauche ?">
- Tous les objets actifs apparaissent dans la navigation. Vous pouvez désactiver les objets dont vous n'avez pas besoin sous **Paramètres → Modèle de données**.
- </Accordion>
+<Accordion title="Puis-je masquer des objets de la barre de navigation à gauche ?">
+Tous les objets actifs apparaissent dans la navigation. Vous pouvez désactiver les objets dont vous n'avez pas besoin sous **Paramètres → Modèle de données**.
+</Accordion>
</AccordionGroup>
## Capacités des champs
<AccordionGroup>
- <Accordion title="Puis-je modifier le type d'un champ après sa création ?">
- Non, les types de champ ne peuvent pas être modifiés après leur création. Si vous avez besoin d'un type différent, créez un nouveau champ avec le type correct, migrez vos données, puis désactivez l'ancien champ.
- </Accordion>
-
- <Accordion title="Pourquoi ai-je besoin de noms singuliers et pluriels différents ?">
- Notre API GraphQL utilise les deux formes pour différentes opérations:
-
- * `createPerson` (singulier) pour des actions sur un seul enregistrement
- * `createPeople` (pluriel) pour des opérations en masse
-
- Cela crée des limitations lorsque les formes singulier et pluriel sont identiques, mais cela améliore l'expérience développeur.
- </Accordion>
-
- <Accordion title="Pourquoi certains noms de champs sont-ils protégés ?">
- Certains noms de champs comme `Type` ou `Application` sont réservés à l'usage du système. Choisissez des noms alternatifs comme `Catégorie` ou `Classification`.
- </Accordion>
-
- <Accordion title="Que se passe-t-il lorsque je désactive un champ ?">
- * Le champ est masqué dans l'interface
- * Les données existantes sont conservées
- * Vous pouvez toujours accéder au champ via l'API
- * Les relations existantes demeurent, mais vous ne pouvez pas en créer de nouvelles
- * Vous pouvez réactiver le champ plus tard
- </Accordion>
-
- <Accordion title="Puis-je rendre un champ obligatoire ?">
- Actuellement, vous ne pouvez pas rendre les champs personnalisés obligatoires. Tous les champs acceptent les valeurs vides. Vous pouvez utiliser des flux de travail pour imposer des champs obligatoires en envoyant des alertes ou en bloquant des actions lorsque des champs sont vides.
- </Accordion>
-
- <Accordion title="Quelle est la différence entre unique et obligatoire ?">
- * **Unique** : Aucun enregistrement ne peut avoir la même valeur dans ce champ
- * **Obligatoire** : Le champ doit avoir une valeur (actuellement non pris en charge pour les champs personnalisés)
- </Accordion>
-
- <Accordion title="Puis-je créer des champs de formule ?">
- Les champs de formule arrivent en **T1 2026**. En attendant, vous pouvez utiliser les workflows pour calculer et mettre à jour automatiquement les valeurs des champs.
- </Accordion>
-
- <Accordion title="Puis-je avoir des champs imbriqués dans mes objets ?">
- Les champs imbriqués arrivent en **T1 2026**. Actuellement, vous pouvez utiliser des workflows pour extraire des valeurs de champs à partir d'objets connexes. Par exemple, pour afficher le secteur d'une entreprise sur une fiche Personne, créez un champ personnalisé sur Personnes et utilisez un workflow pour synchroniser la valeur.
- </Accordion>
-
- <Accordion title="Puis-je réorganiser les champs dans les objets ?">
- Le réagencement des champs sera disponible avec les mises en page personnalisées en **T4 2025**. Actuellement, les champs apparaissent par ordre alphabétique.
- </Accordion>
+<Accordion title="Puis-je modifier le type d'un champ après sa création ?">
+Non, les types de champ ne peuvent pas être modifiés après leur création. Si vous avez besoin d'un type différent, créez un nouveau champ avec le type correct, migrez vos données, puis désactivez l'ancien champ.
+</Accordion>
+
+
+<Accordion title="Pourquoi ai-je besoin de noms singuliers et pluriels différents ?">
+Notre API GraphQL utilise les deux formes pour différentes opérations:
+* `createPerson` (singulier) pour des actions sur un seul enregistrement
+* `createPeople` (pluriel) pour des opérations en masse
+
+Cela crée des limitations lorsque les formes singulier et pluriel sont identiques, mais cela améliore l'expérience développeur.
+</Accordion>
+
+<Accordion title="Pourquoi certains noms de champs sont-ils protégés ?">
+Certains noms de champs comme `Type` ou `Application` sont réservés à l'usage du système. Choisissez des noms alternatifs comme `Catégorie` ou `Classification`.
+</Accordion>
+
+<Accordion title="Que se passe-t-il lorsque je désactive un champ ?">
+* Le champ est masqué dans l'interface
+* Les données existantes sont conservées
+* Vous pouvez toujours accéder au champ via l'API
+* Les relations existantes demeurent, mais vous ne pouvez pas en créer de nouvelles
+* Vous pouvez réactiver le champ plus tard
+</Accordion>
+
+<Accordion title="Puis-je rendre un champ obligatoire ?">
+Actuellement, vous ne pouvez pas rendre les champs personnalisés obligatoires. Tous les champs acceptent les valeurs vides. Vous pouvez utiliser des flux de travail pour imposer des champs obligatoires en envoyant des alertes ou en bloquant des actions lorsque des champs sont vides.
+</Accordion>
+
+<Accordion title="Quelle est la différence entre unique et obligatoire ?">
+* **Unique** : Aucun enregistrement ne peut avoir la même valeur dans ce champ
+* **Obligatoire** : Le champ doit avoir une valeur (actuellement non pris en charge pour les champs personnalisés)
+</Accordion>
+
+<Accordion title="Puis-je créer des champs de formule ?">
+Les champs de formule arrivent en **T1 2026**. En attendant, vous pouvez utiliser les workflows pour calculer et mettre à jour automatiquement les valeurs des champs.
+</Accordion>
+
+<Accordion title="Puis-je avoir des champs imbriqués dans mes objets ?">
+Les champs imbriqués arrivent en **T1 2026**. Actuellement, vous pouvez utiliser des workflows pour extraire des valeurs de champs à partir d'objets connexes. Par exemple, pour afficher le secteur d'une entreprise sur une fiche Personne, créez un champ personnalisé sur Personnes et utilisez un workflow pour synchroniser la valeur.
+</Accordion>
+
+<Accordion title="Puis-je réorganiser les champs dans les objets ?">
+Le réagencement des champs sera disponible avec les mises en page personnalisées en **T4 2025**. Actuellement, les champs apparaissent par ordre alphabétique.
+</Accordion>
</AccordionGroup>
## Relations
<AccordionGroup>
- <Accordion title="Puis-je avoir une relation pointant vers le même objet ?">
- Oui! Les relations auto-référencées sont prises en charge et recommandées pour des cas d'utilisation comme les hiérarchies de comptes. Par exemple, créez une relation d'Entreprises vers Entreprises pour suivre les comptes parent/enfant.
- </Accordion>
+<Accordion title="Puis-je avoir une relation pointant vers le même objet ?">
+Oui! Les relations auto-référencées sont prises en charge et recommandées pour des cas d'utilisation comme les hiérarchies de comptes. Par exemple, créez une relation d'Entreprises vers Entreprises pour suivre les comptes parent/enfant.
+</Accordion>
- <Accordion title="Puis-je créer des relations plusieurs-à-plusieurs ?">
- Les relations plusieurs-à-plusieurs arrivent en **S1 2026**. Actuellement, créez un objet intermédiaire avec deux relations un-à-plusieurs comme solution de contournement.
+<Accordion title="Puis-je créer des relations plusieurs-à-plusieurs ?">
+Les relations plusieurs-à-plusieurs arrivent en **S1 2026**. Actuellement, créez un objet intermédiaire avec deux relations un-à-plusieurs comme solution de contournement.
- Par exemple, pour lier Personnes et Projets (plusieurs-à-plusieurs), créez un objet "Affectations de projet" avec :
+Par exemple, pour lier Personnes et Projets (plusieurs-à-plusieurs), créez un objet "Affectations de projet" avec :
+* Une relation vers Personnes (plusieurs affectations → une personne)
+* Une relation vers Projets (plusieurs affectations → un projet)
+</Accordion>
- * Une relation vers Personnes (plusieurs affectations → une personne)
- * Une relation vers Projets (plusieurs affectations → un projet)
- </Accordion>
+<Accordion title="Que sont les relations vers plusieurs types d'objets (relations Morph) ?">
+Celles-ci permettent à un objet d'être lié à plusieurs types d'objets différents via un seul champ. Par exemple, des Notes peuvent être rattachées simultanément à des Personnes ET à des Entreprises ET à des Opportunités.
- <Accordion title="Que sont les relations vers plusieurs types d'objets (relations Morph) ?">
- Celles-ci permettent à un objet d'être lié à plusieurs types d'objets différents via un seul champ. Par exemple, des Notes peuvent être rattachées simultanément à des Personnes ET à des Entreprises ET à des Opportunités.
+Chaque Note est liée en même temps à une Personne, une Entreprise et une Opportunité.
- Chaque Note est liée en même temps à une Personne, une Entreprise et une Opportunité.
+En savoir plus dans [Champs de relation](/l/fr/user-guide/data-model/capabilities/relation-fields).
+</Accordion>
- En savoir plus dans [Champs de relation](/l/fr/user-guide/data-model/capabilities/relation-fields).
- </Accordion>
+<Accordion title="Puis-je avoir plusieurs relations entre les mêmes objets ?">
+Oui, vous pouvez créer plusieurs relations entre les deux mêmes objets. Par exemple, une Entreprise pourrait avoir à la fois une relation "Contact principal" et "Contact de facturation" vers Personnes.
+</Accordion>
- <Accordion title="Puis-je avoir plusieurs relations entre les mêmes objets ?">
- Oui, vous pouvez créer plusieurs relations entre les deux mêmes objets. Par exemple, une Entreprise pourrait avoir à la fois une relation "Contact principal" et "Contact de facturation" vers Personnes.
- </Accordion>
+<Accordion title="Que se passe-t-il avec les relations lorsque je supprime un enregistrement ?">
+Lorsque vous supprimez un enregistrement, le lien de relation est supprimé des enregistrements associés. Les enregistrements associés ne sont pas supprimés.
+</Accordion>
- <Accordion title="Que se passe-t-il avec les relations lorsque je supprime un enregistrement ?">
- Lorsque vous supprimez un enregistrement, le lien de relation est supprimé des enregistrements associés. Les enregistrements associés ne sont pas supprimés.
- </Accordion>
-
- <Accordion title="Puis-je créer des relations circulaires ?">
- Bien que techniquement possible, les relations circulaires (A → B → C → A) doivent être évitées car elles peuvent entraîner de la confusion et des problèmes potentiels de performance.
- </Accordion>
+<Accordion title="Puis-je créer des relations circulaires ?">
+Bien que techniquement possible, les relations circulaires (A → B → C → A) doivent être évitées car elles peuvent entraîner de la confusion et des problèmes potentiels de performance.
+</Accordion>
</AccordionGroup>
## Accès et Permissions
<AccordionGroup>
- <Accordion title="Où puis-je voir et modifier mon modèle de données ?">
- Accédez à **Paramètres → Modèle de données** pour afficher et modifier tous vos objets et champs.
- </Accordion>
+<Accordion title="Où puis-je voir et modifier mon modèle de données ?">
+Accédez à **Paramètres → Modèle de données** pour afficher et modifier tous vos objets et champs.
+</Accordion>
- <Accordion title="Pourquoi ne puis-je pas voir le modèle de données sous Paramètres ?">
- Contactez votre administrateur d'espace de travail. L'accès au modèle de données est généralement limité aux administrateurs uniquement.
- </Accordion>
+<Accordion title="Pourquoi ne puis-je pas voir le modèle de données sous Paramètres ?">
+Contactez votre administrateur d'espace de travail. L'accès au modèle de données est généralement limité aux administrateurs uniquement.
+</Accordion>
</AccordionGroup>
## Gestion des données
<AccordionGroup>
- <Accordion title="Y a-t-il une limite au nombre d'enregistrements que je peux avoir ?">
- Il n'y a pas de limite stricte au nombre d'enregistrements. Cependant, des ensembles de données très volumineux peuvent affecter les performances dans certaines vues. Utilisez des filtres et des vues pour gérer efficacement de grands ensembles de données.
- </Accordion>
+<Accordion title="Y a-t-il une limite au nombre d'enregistrements que je peux avoir ?">
+Il n'y a pas de limite stricte au nombre d'enregistrements. Cependant, des ensembles de données très volumineux peuvent affecter les performances dans certaines vues. Utilisez des filtres et des vues pour gérer efficacement de grands ensembles de données.
+</Accordion>
- <Accordion title="Puis-je importer des données dans des objets personnalisés ?">
- Oui, vous pouvez importer des données CSV dans n'importe quel objet, y compris les objets personnalisés. Le processus d'import prend en charge le mappage des champs pour les champs personnalisés. Voir [Comment préparer vos fichiers CSV](/l/fr/user-guide/data-migration/how-tos/prepare-your-csv-files).
- </Accordion>
+<Accordion title="Puis-je importer des données dans des objets personnalisés ?">
+Oui, vous pouvez importer des données CSV dans n'importe quel objet, y compris les objets personnalisés. Le processus d'import prend en charge le mappage des champs pour les champs personnalisés. Voir [Comment préparer vos fichiers CSV](/l/fr/user-guide/data-migration/how-tos/prepare-your-csv-files).
+</Accordion>
- <Accordion title="Puis-je exporter la configuration de mon modèle de données ?">
- Actuellement, il n'existe pas d'export intégré pour la configuration du modèle de données. Contactez le support si vous devez migrer votre modèle de données entre des espaces de travail.
- </Accordion>
+<Accordion title="Puis-je exporter la configuration de mon modèle de données ?">
+Actuellement, il n'existe pas d'export intégré pour la configuration du modèle de données. Contactez le support si vous devez migrer votre modèle de données entre des espaces de travail.
+</Accordion>
</AccordionGroup>
## Besoin de plus d'aide ?
diff --git a/packages/twenty-docs/l/fr/user-guide/data-model/overview.mdx b/packages/twenty-docs/l/fr/user-guide/data-model/overview.mdx
index 50545b3bf00..3dab98e6b54 100644
--- a/packages/twenty-docs/l/fr/user-guide/data-model/overview.mdx
+++ b/packages/twenty-docs/l/fr/user-guide/data-model/overview.mdx
@@ -3,7 +3,6 @@ title: Modèle de données
description: Découvrez ce qu'est un modèle de données et comment en concevoir un qui correspond à votre entreprise.
---
-
## Qu'est-ce qu'un modèle de données ?
Un modèle de données est la structure qui définit comment l’information est organisée dans votre CRM. Considérez-le comme le **plan** de vos données clients — vous le concevez une fois, puis vous le remplissez avec vos données réelles.
@@ -126,9 +125,9 @@ Commencez par les champs. Passez à de nouveaux objets seulement lorsque vous en
## Note spéciale sur les personnes, les entreprises et les opportunités
<Warning>
- **La synchronisation des e-mails et du calendrier ne fonctionne qu'avec les Personnes, les Entreprises et les Opportunités.**
+**La synchronisation des e-mails et du calendrier ne fonctionne qu'avec les Personnes, les Entreprises et les Opportunités.**
- Ce sont les seuls objets où vous pouvez accéder aux e-mails et aux réunions synchronisés depuis votre boîte aux lettres/calendrier. Nous recommandons de les utiliser autant que possible.
+Ce sont les seuls objets où vous pouvez accéder aux e-mails et aux réunions synchronisés depuis votre boîte aux lettres/calendrier. Nous recommandons de les utiliser autant que possible.
</Warning>
**Meilleures pratiques:**
@@ -158,9 +157,9 @@ Si la réponse est "oui" à l'une ou plusieurs de ces questions, il est probable
4. Cliquez sur n'importe quel objet pour voir et modifier ses champs
<Note>
- **Vous ne voyez pas le Modèle de données dans Paramètres ?**
+**Vous ne voyez pas le Modèle de données dans Paramètres ?**
- L'accès au modèle de données est généralement limité aux administrateurs. Contactez l'administrateur de votre espace de travail si vous avez besoin d'un accès.
+L'accès au modèle de données est généralement limité aux administrateurs. Contactez l'administrateur de votre espace de travail si vous avez besoin d'un accès.
</Note>
## Prochaines étapes
diff --git a/packages/twenty-docs/l/fr/user-guide/getting-started/capabilities/what-is-twenty.mdx b/packages/twenty-docs/l/fr/user-guide/getting-started/capabilities/what-is-twenty.mdx
index f0d32230f36..6528ce6d820 100644
--- a/packages/twenty-docs/l/fr/user-guide/getting-started/capabilities/what-is-twenty.mdx
+++ b/packages/twenty-docs/l/fr/user-guide/getting-started/capabilities/what-is-twenty.mdx
@@ -35,7 +35,7 @@ L'open-source est la pierre angulaire de notre approche, garantissant que Twenty
* **Tableaux de bord :** Suivez les performances grâce à des rapports et des visualisations personnalisés. [Voir les tableaux de bord](/l/fr/user-guide/dashboards/overview).
* **Autorisations et accès :** Contrôlez qui peut voir, modifier et gérer vos données grâce à des autorisations basées sur les rôles. [Configurer l'accès](/l/fr/user-guide/permissions-access/overview).
* **Notes et tâches :** Créez des notes et des tâches liées à vos enregistrements pour une meilleure collaboration.
-* **API & Webhooks :** Connectez-vous à d'autres applications et créez des intégrations personnalisées. [Commencez l'intégration](/l/fr/developers/api).
+* **API & Webhooks :** Connectez-vous à d'autres applications et créez des intégrations personnalisées. [Commencez l'intégration](/l/fr/developers/extend/api).
## Rejoignez maintenant
diff --git a/packages/twenty-docs/l/fr/user-guide/introduction.mdx b/packages/twenty-docs/l/fr/user-guide/introduction.mdx
index 68741254852..e63ad8b5352 100644
--- a/packages/twenty-docs/l/fr/user-guide/introduction.mdx
+++ b/packages/twenty-docs/l/fr/user-guide/introduction.mdx
@@ -1,16 +1,11 @@
---
-title: Découvrez Twenty
+title: Guide de l'utilisateur
description: Bienvenue dans le guide utilisateur de Twenty, vos ressources pour les configurations avancées et les meilleures pratiques.
---
import { CardTitle } from "/snippets/card-title.mdx"
<CardGroup cols={3}>
- <Card href="/l/fr/user-guide/getting-started/capabilities/what-is-twenty" img="/images/user-guide/api/api.png">
- <CardTitle>Découvrez Twenty</CardTitle>
- Découvrez ce qu'est Twenty et comment il peut aider votre entreprise.
- </Card>
-
<Card href="/l/fr/user-guide/data-model/overview" img="/images/user-guide/halftone/data-model.png">
<CardTitle>Modèle de données</CardTitle>
Personnalisez votre modèle de données pour l'adapter à vos processus métier.
@@ -36,9 +31,9 @@ import { CardTitle } from "/snippets/card-title.mdx"
Renforcez votre équipe avec des agents IA.
</Card>
- <Card href="/l/fr/user-guide/views-pipelines/overview" img="/images/user-guide/halftone/layout.png">
- <CardTitle>Vues et pipelines</CardTitle>
- Organisez vos données avec des vues et des pipelines exploitables.
+ <Card href="/l/fr/user-guide/layout/overview" img="/images/user-guide/halftone/layout.png">
+ <CardTitle>Layout</CardTitle>
+ Navigation, vues et personnalisation de la page d'enregistrement.
</Card>
<Card href="/l/fr/user-guide/dashboards/overview" img="/images/user-guide/halftone/dashboards.png">
@@ -60,4 +55,5 @@ import { CardTitle } from "/snippets/card-title.mdx"
<CardTitle>Paramètres</CardTitle>
Configurez les préférences de votre espace de travail.
</Card>
+
</CardGroup>
diff --git a/packages/twenty-docs/l/fr/user-guide/layout/capabilities/navigation.mdx b/packages/twenty-docs/l/fr/user-guide/layout/capabilities/navigation.mdx
new file mode 100644
index 00000000000..407a9e24fe7
--- /dev/null
+++ b/packages/twenty-docs/l/fr/user-guide/layout/capabilities/navigation.mdx
@@ -0,0 +1,38 @@
+---
+title: Navigation
+description: Personnalisez la barre latérale gauche pour l'adapter à la façon dont votre équipe travaille.
+---
+
+La barre latérale gauche est votre moyen principal de naviguer dans Twenty. Elle est entièrement personnalisable — vous pouvez la réorganiser pour l'adapter à votre flux de travail sans toucher à aucune page de paramètres.
+
+## Réorganisation des éléments
+
+Glissez-déposez n'importe quel élément dans la barre latérale pour changer sa position. L'ordre est enregistré par utilisateur, ainsi chaque membre de l'équipe peut organiser sa propre barre latérale.
+
+## Dossiers
+
+Regroupez les éléments liés dans des dossiers. Par exemple, vous pouvez créer un dossier "Ventes" contenant vos vues du pipeline, un dossier "Support" pour les tickets, ou un dossier "Opérations" pour les objets internes.
+
+Pour créer un dossier, cliquez avec le bouton droit dans la barre latérale ou utilisez le bouton `+`.
+
+## Masquage des objets
+
+Les objets que vous n'utilisez pas peuvent être masqués de la barre latérale. Ils ne sont pas supprimés — ils sont simplement mis de côté. Vous pouvez les afficher de nouveau à tout moment depuis Paramètres > Modèle de données.
+
+## Favoris
+
+Épinglez des vues, des enregistrements ou des recherches dans la section Favoris en haut de la barre latérale pour un accès en un clic. Les Favoris sont personnels — chaque utilisateur gère les siens.
+
+## Liens personnalisés
+
+Ajoutez des liens vers des outils externes directement dans la barre latérale. Utile pour créer des liens vers votre wiki, des tableaux de bord dans d'autres outils, ou toute URL que votre équipe utilise régulièrement.
+
+## Menu de commandes
+
+Appuyez sur `Cmd+K` (ou `Ctrl+K`) pour ouvrir le menu de commandes — une barre de recherche à accès rapide pour accéder à n'importe quel enregistrement, vue ou action sans naviguer dans la barre latérale.
+
+## Personnalisation de la barre latérale
+
+Pour personnaliser la barre latérale, survolez la section "Workspace" de la barre latérale et cliquez sur l'icône de clé.
+
+<img src="/images/user-guide/layout/navigation-edit-icon.png" alt="Icône de modification de la navigation" />
diff --git a/packages/twenty-docs/l/fr/user-guide/layout/capabilities/record-pages.mdx b/packages/twenty-docs/l/fr/user-guide/layout/capabilities/record-pages.mdx
new file mode 100644
index 00000000000..962272361b1
--- /dev/null
+++ b/packages/twenty-docs/l/fr/user-guide/layout/capabilities/record-pages.mdx
@@ -0,0 +1,61 @@
+---
+title: Pages d'enregistrement
+description: Personnalisez la mise en page de chaque page de détails d'enregistrement avec des onglets et des widgets.
+---
+
+## Vue d'ensemble
+
+Lorsque vous ouvrez un enregistrement dans Twenty, la page de détails se compose d'**onglets** et de **widgets**. Les deux sont entièrement personnalisables par type d'objet.
+
+## Onglets
+
+Chaque page d'enregistrement peut comporter plusieurs onglets — similaires aux onglets d'un navigateur. Utilisez-les pour organiser différents aspects d'un enregistrement. Par exemple, un enregistrement de type Société peut comporter des onglets pour Aperçu, Communication, Tâches et Fichiers.
+
+Vous pouvez :
+
+* Ajouter et supprimer des onglets
+* Renommer des onglets
+* Réorganiser les onglets en les faisant glisser
+* Définir l'onglet affiché par défaut
+
+## Widgets
+
+Les widgets sont les éléments constitutifs de chaque onglet. Types de widgets disponibles :
+
+| Widget | Ce qu'il affiche |
+| ---------------------------- | ------------------------------------------------------- |
+| **Champs** | Champs de l'enregistrement, groupés ou individuellement |
+| **Enregistrements associés** | Tableau d'enregistrements liés via une relation |
+| **Emails** | Historique des e-mails des comptes connectés |
+| **Calendrier** | Événements de calendrier associés à l'enregistrement |
+| **Chronologie** | Historique des activités et des événements |
+| **Tâches** | Tâches associées |
+| **Notes** | Notes en texte enrichi |
+| **Fichiers** | Fichiers joints |
+| **Graphiques** | Données visuelles provenant d'enregistrements associés |
+| **iFrame** | Contenu externe intégré |
+| **Texte enrichi** | Contenu statique ou descriptions |
+
+## Personnaliser une page d'enregistrement
+
+1. Ouvrez n'importe quel enregistrement
+2. Appuyez sur `Cmd+K` et recherchez "Modifier la mise en page de la page d'enregistrement"
+
+ou
+
+1. Accédez à Paramètres > Modèle de données > objet de votre choix > Mise en page
+
+2. Cliquez sur le bouton "Personnaliser la page d'enregistrement" pour cet objet
+
+3. Vous êtes maintenant en mode de personnalisation :
+ * **Ajoutez des widgets** à partir du sélecteur de widgets
+ * **Faites glisser les widgets** pour les repositionner sur la grille
+ * **Redimensionnez les widgets** en faisant glisser leurs bords
+ * **Configurez les champs** affichés dans chaque widget
+ * **Gérez les onglets** — ajouter, supprimer, renommer, réorganiser
+
+4. Enregistrez vos modifications — elles s'appliquent à tous les enregistrements de ce type d'objet
+
+## Visibilité des champs
+
+Dans le widget Champs, vous pouvez contrôler quels champs sont visibles et dans quel ordre. Cela vous permet de créer des mises en page ciblées — par exemple, n'afficher que les champs les plus importants dans l'onglet Aperçu et placer les champs détaillés dans un onglet séparé.
diff --git a/packages/twenty-docs/l/fr/user-guide/layout/overview.mdx b/packages/twenty-docs/l/fr/user-guide/layout/overview.mdx
new file mode 100644
index 00000000000..b58eb4b5107
--- /dev/null
+++ b/packages/twenty-docs/l/fr/user-guide/layout/overview.mdx
@@ -0,0 +1,45 @@
+---
+title: Disposition
+description: Personnalisez la façon dont vous naviguez, parcourez et affichez les enregistrements dans Twenty.
+---
+
+La mise en page de Twenty est personnalisable à trois niveaux : la manière dont vous naviguez dans l'application, la façon dont vous parcourez les listes d'enregistrements et ce que vous voyez lorsque vous ouvrez un enregistrement individuel.
+
+## Navigation
+
+La barre latérale gauche est entièrement personnalisable. Vous pouvez :
+
+* **Réorganiser les éléments** par glisser-déposer
+* **Créer des dossiers** pour regrouper des objets et des vues liés
+* **Masquer les objets** que vous n'utilisez pas
+* **Ajouter des liens personnalisés** vers des outils externes
+* **Épingler des favoris** pour accéder rapidement aux vues, enregistrements ou recherches
+
+[Référence de navigation →](/l/fr/user-guide/layout/capabilities/navigation)
+
+## Vues
+
+Les vues déterminent la façon dont les listes d'enregistrements sont affichées. Twenty prend en charge trois types de vues :
+
+| Vue | Idéal pour |
+| -------------- | ------------------------------------------------------------------------------------------ |
+| **Table** | Travailler avec de nombreux enregistrements à la fois — lignes et colonnes de type tableur |
+| **Kanban** | Suivi du pipeline — cartes à glisser-déposer organisées par étape |
+| **Calendrier** | Planification basée sur le temps — enregistrements affichés selon un champ de date |
+
+Chaque vue enregistre ses propres filtres, critères de tri, visibilité des champs et configuration de regroupement. Les vues peuvent être partagées avec l'espace de travail ou rester privées.
+
+[Vues Table →](/l/fr/user-guide/views-pipelines/capabilities/table-views) · [Vues Kanban →](/l/fr/user-guide/views-pipelines/capabilities/kanban-views) · [Vue Calendrier →](/l/fr/user-guide/views-pipelines/capabilities/calendar-view)
+
+## Pages d'enregistrement
+
+Lorsque vous ouvrez un enregistrement, la page de détails est composée d'onglets et de widgets configurables. Vous pouvez :
+
+* **Ajouter, supprimer et réorganiser des onglets** pour n'importe quel type d'enregistrement
+* **Configurer les widgets** — champs, enregistrements liés, e-mails, chronologie, calendrier, tâches, notes, fichiers, graphiques, iframes et plus encore
+* **Faire glisser et redimensionner les widgets** sur une grille
+* **Contrôler la visibilité des champs** pour chaque widget
+
+Accédez au mode de personnalisation de la mise en page depuis le menu de commandes (`Cmd+K` → "Modifier la mise en page de la page d'enregistrement").
+
+[Référence des pages d'enregistrement →](/l/fr/user-guide/layout/capabilities/record-pages)
diff --git a/packages/twenty-docs/l/fr/user-guide/permissions-access/capabilities/permissions.mdx b/packages/twenty-docs/l/fr/user-guide/permissions-access/capabilities/permissions.mdx
index 0e851977654..f4b095eaa6d 100644
--- a/packages/twenty-docs/l/fr/user-guide/permissions-access/capabilities/permissions.mdx
+++ b/packages/twenty-docs/l/fr/user-guide/permissions-access/capabilities/permissions.mdx
@@ -13,7 +13,7 @@ Le système d'autorisations de Twenty vous permet de contrôler l'accès à troi
Pour créer un nouveau rôle :
-1. Allez dans **Paramètres → Rôles**
+1. Allez dans **Paramètres → Membres → Rôles**
2. Sous **Tous les rôles**, cliquez sur **+ Créer un rôle**
3. Entrez un nom de rôle
4. Dans l'onglet **Autorisations** par défaut, [configurez les autorisations](#customize-permissions)
@@ -23,26 +23,26 @@ Pour créer un nouveau rôle :
Pour supprimer un rôle :
-1. Allez dans **Paramètres → Rôles**
+1. Allez dans **Paramètres → Membres → Rôles**
2. Cliquez sur le rôle que vous souhaitez supprimer
3. Ouvrez l'onglet **Paramètres**, puis cliquez sur **Supprimer le rôle**
4. Cliquez sur **Confirmer** dans la fenêtre modale
<Note>
- Si un rôle est supprimé, tout membre de l'espace de travail qui lui est attribué sera automatiquement réattribué au rôle par défaut. Tous sauf le rôle **Admin** peuvent être supprimés. Il doit toujours y avoir au moins un membre assigné au rôle **Admin**.
+Si un rôle est supprimé, tout membre de l'espace de travail qui lui est attribué sera automatiquement réattribué au rôle par défaut. Tous sauf le rôle **Admin** peuvent être supprimés. Il doit toujours y avoir au moins un membre assigné au rôle **Admin**.
</Note>
## Attribuer des Rôles aux Membres
### Voir les Attributions Actuelles
-* Allez dans **Paramètres → Rôles**
+* Allez dans **Paramètres → Membres → Rôles**
* Voir tous les rôles et combien de membres sont assignés à chacun
* Voir quels membres ont quels rôles
### Attribuer un Rôle à un Membre
-1. Allez dans **Paramètres → Rôles**
+1. Allez dans **Paramètres → Membres → Rôles**
2. Cliquez sur le rôle que vous souhaitez attribuer
3. Ouvrez l'onglet **Attribution**
4. Cliquez sur **+ Attribuer à un membre**
@@ -51,13 +51,13 @@ Pour supprimer un rôle :
### Définir le Rôle par Défaut
-1. Allez dans **Paramètres → Rôles**
+1. Allez dans **Paramètres → Membres → Rôles**
2. Dans la section **Options**, trouvez **Rôle par Défaut**
3. Sélectionnez le rôle que les nouveaux membres devraient automatiquement recevoir
4. Les nouveaux membres de l'espace de travail seront assignés à ce rôle lorsqu'ils rejoindront
<Note>
- Vous ne pouvez attribuer des rôles qu'aux membres existants de l'espace de travail. Pour inviter de nouveaux membres, utilisez [Gestion des Membres](/l/fr/user-guide/settings/capabilities/member-management).
+Vous ne pouvez attribuer des rôles qu'aux membres existants de l'espace de travail. Pour inviter de nouveaux membres, utilisez [Gestion des Membres](/l/fr/user-guide/settings/capabilities/member-management).
</Note>
## Personnaliser les Autorisations
@@ -82,7 +82,7 @@ Commencez par configurer les autorisations de base qui s'appliquent par défaut
Sélectionnez ou désélectionnez selon le comportement par défaut souhaité pour ce rôle.
<Note>
- **Exemple — rôle de stagiaire** : Un stagiaire doit pouvoir voir tous les objets mais ne pas les modifier par défaut. Activez "Voir les enregistrements sur tous les objets" mais laissez "Modifier les enregistrements sur tous les objets" décoché.
+**Exemple — rôle de stagiaire** : Un stagiaire doit pouvoir voir tous les objets mais ne pas les modifier par défaut. Activez "Voir les enregistrements sur tous les objets" mais laissez "Modifier les enregistrements sur tous les objets" décoché.
</Note>
#### Ajouter des exceptions au niveau de l'objet
@@ -98,6 +98,22 @@ Cliquez sur **+ Ajouter une règle** et sélectionnez un objet pour créer une e
| Opportunités → désactiver "Voir les enregistrements" | Le stagiaire ne peut pas du tout voir l'objet Opportunités |
| Personnes → activer "Modifier les enregistrements" | Le stagiaire peut modifier les enregistrements Personnes (mais pas les autres objets) |
+### Autorisations au niveau des lignes
+
+<Note>
+Les autorisations au niveau des lignes sont une **fonctionnalité Premium** disponible avec l’offre **Organization** (Cloud et Self-Hosted).
+</Note>
+
+Les autorisations au niveau des lignes vous permettent de restreindre les enregistrements individuels qu’un rôle peut voir ou modifier, en fonction de critères dynamiques. Contrairement aux autorisations sur les objets (qui s’appliquent à un type d’objet entier), les autorisations au niveau des lignes évaluent chaque enregistrement indépendamment.
+
+**Exemples de cas d’utilisation :**
+
+* Les représentants commerciaux ne peuvent voir que leurs propres opportunités
+* Les responsables peuvent voir tous les enregistrements de leur région
+* Les agents du support ne peuvent consulter que les tickets qui leur sont attribués
+
+Pour configurer les autorisations au niveau des lignes, ouvrez un rôle, allez à l’onglet **Objects**, puis utilisez la section **Row-Level** pour définir des conditions de filtrage pour un objet spécifique.
+
### Autorisations des champs
Dans chaque règle au niveau de l'objet, vous pouvez aller plus loin et configurer des **autorisations au niveau du champ** pour contrôler l'accès à des champs spécifiques.
@@ -145,7 +161,7 @@ Contrôlez l'accès aux paramètres de l'espace de travail de deux manières :
* Ou activez des autorisations spécifiques (par exemple, génération de clé API, préférences de l'espace de travail, attribution de rôles, configuration du modèle de données, paramètres de sécurité et gestion des workflows)
<Note>
- **Limitation actuelle** : L'accès à la gestion des workflows est actuellement requis pour déclencher manuellement des workflows. Ce comportement pourrait changer dans de prochaines versions.
+**Limitation actuelle** : L'accès à la gestion des workflows est actuellement requis pour déclencher manuellement des workflows. Ce comportement pourrait changer dans de prochaines versions.
</Note>
### Autorisations des Actions de l'Espace de Travail
@@ -168,7 +184,7 @@ Au-delà des membres de l'espace de travail, des rôles peuvent également être
### Attribuer un rôle à une clé API
-1. Allez dans **Paramètres → Rôles**
+1. Allez dans **Paramètres → Membres → Rôles**
2. Cliquez sur le rôle que vous souhaitez attribuer
3. Ouvrez l'onglet **Attribution**
4. Sous **Clés API**, cliquez sur **+ Attribuer à une clé API**
@@ -178,12 +194,12 @@ Au-delà des membres de l'espace de travail, des rôles peuvent également être
La clé API héritera désormais de toutes les autorisations définies par ce rôle. Toute requête API effectuée avec cette clé sera restreinte en conséquence.
<Note>
- Les clés API sans rôle attribué utilisent les autorisations par défaut. Pour une sécurité renforcée, attribuez toujours un rôle spécifique aux clés API de production.
+Les clés API sans rôle attribué utilisent les autorisations par défaut. Pour une sécurité renforcée, attribuez toujours un rôle spécifique aux clés API de production.
</Note>
### Attribuer un rôle à un agent IA
-1. Allez dans **Paramètres → Rôles**
+1. Allez dans **Paramètres → Membres → Rôles**
2. Cliquez sur le rôle que vous souhaitez attribuer
3. Ouvrez l'onglet **Attribution**
4. Sous **Agents IA**, cliquez sur **+ Attribuer à un agent IA**
@@ -193,5 +209,5 @@ La clé API héritera désormais de toutes les autorisations définies par ce r
L'agent IA ne pourra accéder aux données et effectuer des actions que celles autorisées par le rôle qui lui est attribué.
<Note>
- Pour les agents IA exécutés au sein de workflows, cela garantit que l'agent ne peut ni accéder ni modifier des données en dehors de sa portée prévue — même si le workflow dispose d'autorisations plus larges.
+Pour les agents IA exécutés au sein de workflows, cela garantit que l'agent ne peut ni accéder ni modifier des données en dehors de sa portée prévue — même si le workflow dispose d'autorisations plus larges.
</Note>
diff --git a/packages/twenty-docs/l/fr/user-guide/permissions-access/capabilities/sso-configuration.mdx b/packages/twenty-docs/l/fr/user-guide/permissions-access/capabilities/sso-configuration.mdx
index 24aad511de7..4dd14dc9dd2 100644
--- a/packages/twenty-docs/l/fr/user-guide/permissions-access/capabilities/sso-configuration.mdx
+++ b/packages/twenty-docs/l/fr/user-guide/permissions-access/capabilities/sso-configuration.mdx
@@ -28,7 +28,7 @@ Twenty prend en charge le SSO avec :
* Accès administrateur à l'espace de travail Twenty
<Note>
- **Pour les utilisateurs en auto-hébergement souhaitant configurer le SSO**, contactez [email protected]
+**Pour les utilisateurs en auto-hébergement souhaitant configurer le SSO**, contactez [email protected]
</Note>
### Étapes de configuration
diff --git a/packages/twenty-docs/l/fr/user-guide/permissions-access/how-tos/permissions-faq.mdx b/packages/twenty-docs/l/fr/user-guide/permissions-access/how-tos/permissions-faq.mdx
index 6e2d129f60b..73c7946d275 100644
--- a/packages/twenty-docs/l/fr/user-guide/permissions-access/how-tos/permissions-faq.mdx
+++ b/packages/twenty-docs/l/fr/user-guide/permissions-access/how-tos/permissions-faq.mdx
@@ -6,121 +6,115 @@ description: Foire aux questions sur les rôles et les autorisations.
## Rôles
<AccordionGroup>
- <Accordion title="Quels rôles sont inclus par défaut avec Twenty ?">
- Twenty inclut par défaut les rôles **Admin** et **Member**. Vous pouvez créer des rôles personnalisés supplémentaires selon les besoins de votre équipe (par ex., Représentant commercial, Responsable, Utilisateur en lecture seule).
- </Accordion>
+<Accordion title="Quels rôles sont inclus par défaut avec Twenty ?">
+Twenty inclut par défaut les rôles **Admin** et **Member**. Vous pouvez créer des rôles personnalisés supplémentaires selon les besoins de votre équipe (par ex., Représentant commercial, Responsable, Utilisateur en lecture seule).
+</Accordion>
- <Accordion title="Puis-je supprimer le rôle Admin ?">
- Non, le rôle Admin ne peut pas être supprimé. Il doit toujours y avoir au moins un membre assigné au rôle Admin.
- </Accordion>
+<Accordion title="Puis-je supprimer le rôle Admin ?">
+Non, le rôle Admin ne peut pas être supprimé. Il doit toujours y avoir au moins un membre assigné au rôle Admin.
+</Accordion>
- <Accordion title="Que se passe-t-il lorsque je supprime un rôle ?">
- Tout membre de l'espace de travail assigné à ce rôle sera automatiquement réattribué au rôle par défaut.
- </Accordion>
+<Accordion title="Que se passe-t-il lorsque je supprime un rôle ?">
+Tout membre de l'espace de travail assigné à ce rôle sera automatiquement réattribué au rôle par défaut.
+</Accordion>
- <Accordion title="Comment définir un rôle par défaut pour les nouveaux membres ?">
- Allez dans **Paramètres → Rôles**, trouvez l'option **Rôle par défaut**, puis sélectionnez le rôle que les nouveaux membres doivent recevoir automatiquement lorsqu'ils rejoignent.
- </Accordion>
+<Accordion title="Comment définir un rôle par défaut pour les nouveaux membres ?">
+Allez dans **Paramètres → Membres → Rôles**, trouvez l'option **Rôle par défaut**, puis sélectionnez le rôle que les nouveaux membres doivent recevoir automatiquement lorsqu'ils rejoignent.
+</Accordion>
- <Accordion title="Puis-je attribuer plusieurs rôles à un même utilisateur ?">
- Non, chaque utilisateur ne peut avoir qu'un seul rôle à la fois. Créez un rôle personnalisé si vous avez besoin d'une combinaison d'autorisations.
- </Accordion>
+<Accordion title="Puis-je attribuer plusieurs rôles à un même utilisateur ?">
+Non, chaque utilisateur ne peut avoir qu'un seul rôle à la fois. Créez un rôle personnalisé si vous avez besoin d'une combinaison d'autorisations.
+</Accordion>
</AccordionGroup>
## Autorisations
<AccordionGroup>
- <Accordion title="Quelle est la différence entre les autorisations d'objet et de champ ?">
- * **Autorisations d'objet** : Contrôlent l'accès aux enregistrements entiers (par ex., voir/modifier/supprimer des enregistrements People)
- * **Autorisations de champ** : Contrôlent l'accès à des champs spécifiques au sein d'un objet (par ex., voir mais ne pas modifier le champ Salaire)
-
- Les autorisations de champ permettent un contrôle plus fin des données sensibles.
- </Accordion>
-
- <Accordion title="Comment fonctionnent les remplacements d'autorisations ?">
- Les autorisations se propagent du global vers le spécifique :
-
- 1. **Tous les objets** définit la base pour tous les objets
- 2. **Autorisations au niveau de l'objet** peuvent remplacer le paramètre global pour des objets spécifiques
- 3. **Autorisations au niveau du champ** peuvent remplacer le paramètre de l'objet pour des champs spécifiques
-
- Les paramètres plus spécifiques prévalent toujours.
- </Accordion>
-
- <Accordion title="Que signifient les différents niveaux d'autorisation ?">
- Pour les objets :
-
- * **Voir les enregistrements** : Afficher les enregistrements dans les listes et les pages de détail
- * **Modifier les enregistrements** : Modifier les enregistrements existants
- * **Supprimer les enregistrements** : Suppression logique des enregistrements (peuvent être restaurés)
- * **Détruire les enregistrements** : Supprimer définitivement les enregistrements
-
- Pour les champs :
-
- * **Voir le champ** : Afficher la valeur du champ
- * **Modifier le champ** : Modifier la valeur du champ
- * **Aucun accès** : Le champ est complètement masqué
- </Accordion>
-
- <Accordion title="Puis-je restreindre l'accès à des enregistrements spécifiques (autorisations au niveau des lignes) ?">
- Les autorisations au niveau des lignes seront disponibles sur l'offre **Organization** d'ici le 1er trimestre 2026. Cela vous permet de restreindre l'accès à des enregistrements spécifiques selon des critères (par ex., voir uniquement vos propres opportunités).
- </Accordion>
-
- <Accordion title="Comment rendre un champ en lecture seule pour certains utilisateurs ?">
- 1. Allez dans **Paramètres → Rôles**
- 2. Sélectionnez le rôle
- 3. Accédez à l'objet contenant le champ
- 4. Définissez l'autorisation du champ sur **Voir le champ** (sans Modifier le champ)
- </Accordion>
+<Accordion title="Quelle est la différence entre les autorisations d'objet et de champ ?">
+* **Autorisations d'objet** : Contrôlent l'accès aux enregistrements entiers (par ex., voir/modifier/supprimer des enregistrements People)
+* **Autorisations de champ** : Contrôlent l'accès à des champs spécifiques au sein d'un objet (par ex., voir mais ne pas modifier le champ Salaire)
+
+Les autorisations de champ permettent un contrôle plus fin des données sensibles.
+</Accordion>
+
+<Accordion title="Comment fonctionnent les remplacements d'autorisations ?">
+Les autorisations se propagent du global vers le spécifique :
+1. **Tous les objets** définit la base pour tous les objets
+2. **Autorisations au niveau de l'objet** peuvent remplacer le paramètre global pour des objets spécifiques
+3. **Autorisations au niveau du champ** peuvent remplacer le paramètre de l'objet pour des champs spécifiques
+
+Les paramètres plus spécifiques prévalent toujours.
+</Accordion>
+
+<Accordion title="Que signifient les différents niveaux d'autorisation ?">
+Pour les objets :
+* **Voir les enregistrements** : Afficher les enregistrements dans les listes et les pages de détail
+* **Modifier les enregistrements** : Modifier les enregistrements existants
+* **Supprimer les enregistrements** : Suppression logique des enregistrements (peuvent être restaurés)
+* **Détruire les enregistrements** : Supprimer définitivement les enregistrements
+
+Pour les champs :
+* **Voir le champ** : Afficher la valeur du champ
+* **Modifier le champ** : Modifier la valeur du champ
+* **Aucun accès** : Le champ est complètement masqué
+</Accordion>
+
+<Accordion title="Puis-je restreindre l'accès à des enregistrements spécifiques (autorisations au niveau des lignes) ?">
+Les autorisations au niveau des lignes sont disponibles sur l'offre **Organization**. Cela vous permet de restreindre l'accès à des enregistrements spécifiques selon des critères (par ex., voir uniquement vos propres opportunités).
+</Accordion>
+
+<Accordion title="Comment rendre un champ en lecture seule pour certains utilisateurs ?">
+1. Allez dans **Paramètres → Membres → Rôles**
+2. Sélectionnez le rôle
+3. Accédez à l'objet contenant le champ
+4. Définissez l'autorisation du champ sur **Voir le champ** (sans Modifier le champ)
+</Accordion>
</AccordionGroup>
## Paramètres et actions
<AccordionGroup>
- <Accordion title="Quelles autorisations liées aux paramètres sont disponibles ?">
- Vous pouvez contrôler l'accès à :
-
- * Génération de clés API
- * Préférences de l'espace de travail
- * Attribution des rôles
- * Configuration du modèle de données
- * Paramètres de sécurité
- * Gestion des flux de travail
-
- Utilisez **Accès total aux paramètres** pour accorder un accès complet, ou activez des autorisations spécifiques.
- </Accordion>
-
- <Accordion title="Quelles autorisations d'actions sont disponibles ?">
- Vous pouvez contrôler :
-
- * **Envoyer des e-mails** : Possibilité d'envoyer des e-mails depuis Twenty
- * **Importer un CSV** : Possibilité d'importer des données via CSV
- * **Exporter en CSV** : Possibilité d'exporter des données en CSV
-
- Utilisez **Accès total à l'application** pour autoriser toutes les actions, ou activez des actions spécifiques.
- </Accordion>
+<Accordion title="Quelles autorisations liées aux paramètres sont disponibles ?">
+Vous pouvez contrôler l'accès à :
+* Génération de clés API
+* Préférences de l'espace de travail
+* Attribution des rôles
+* Configuration du modèle de données
+* Paramètres de sécurité
+* Gestion des flux de travail
+
+Utilisez **Accès total aux paramètres** pour accorder un accès complet, ou activez des autorisations spécifiques.
+</Accordion>
+
+<Accordion title="Quelles autorisations d'actions sont disponibles ?">
+Vous pouvez contrôler :
+* **Envoyer des e-mails** : Possibilité d'envoyer des e-mails depuis Twenty
+* **Importer un CSV** : Possibilité d'importer des données via CSV
+* **Exporter en CSV** : Possibilité d'exporter des données en CSV
+
+Utilisez **Accès total à l'application** pour autoriser toutes les actions, ou activez des actions spécifiques.
+</Accordion>
</AccordionGroup>
## SSO
<AccordionGroup>
- <Accordion title="Le SSO est-il disponible sur toutes les offres ?">
- Non, le SSO est une fonctionnalité Premium disponible uniquement sur l'offre **Organization**.
- </Accordion>
-
- <Accordion title="Quels fournisseurs d'identité sont pris en charge ?">
- Twenty prend en charge :
-
- * **SAML 2.0** (fonctionne avec la plupart des fournisseurs d'identité d'entreprise)
- * **Google Workspace**
- * **Microsoft Entra ID** (anciennement Azure AD)
- </Accordion>
-
- <Accordion title="Qu'est-ce que l'approvisionnement Just-in-Time (JIT) ?">
- Avec l'approvisionnement JIT, les comptes utilisateur sont automatiquement créés dans Twenty lorsqu'une personne se connecte via SSO pour la première fois. Le rôle par défaut leur est attribué automatiquement.
- </Accordion>
-
- <Accordion title="Puis-je exiger le SSO pour tous les utilisateurs ?">
- Oui, une fois le SSO configuré, vous pouvez désactiver la connexion par mot de passe pour les utilisateurs SSO afin d'imposer l'authentification via votre fournisseur d'identité.
- </Accordion>
+<Accordion title="Le SSO est-il disponible sur toutes les offres ?">
+Non, le SSO est une fonctionnalité Premium disponible uniquement sur l'offre **Organization**.
+</Accordion>
+
+<Accordion title="Quels fournisseurs d'identité sont pris en charge ?">
+Twenty prend en charge :
+* **SAML 2.0** (fonctionne avec la plupart des fournisseurs d'identité d'entreprise)
+* **Google Workspace**
+* **Microsoft Entra ID** (anciennement Azure AD)
+</Accordion>
+
+<Accordion title="Qu'est-ce que l'approvisionnement Just-in-Time (JIT) ?">
+Avec l'approvisionnement JIT, les comptes utilisateur sont automatiquement créés dans Twenty lorsqu'une personne se connecte via SSO pour la première fois. Le rôle par défaut leur est attribué automatiquement.
+</Accordion>
+
+<Accordion title="Puis-je exiger le SSO pour tous les utilisateurs ?">
+Oui, une fois le SSO configuré, vous pouvez désactiver la connexion par mot de passe pour les utilisateurs SSO afin d'imposer l'authentification via votre fournisseur d'identité.
+</Accordion>
</AccordionGroup>
diff --git a/packages/twenty-docs/l/fr/user-guide/permissions-access/overview.mdx b/packages/twenty-docs/l/fr/user-guide/permissions-access/overview.mdx
index 01fc5484b3c..22b9041a9fb 100644
--- a/packages/twenty-docs/l/fr/user-guide/permissions-access/overview.mdx
+++ b/packages/twenty-docs/l/fr/user-guide/permissions-access/overview.mdx
@@ -3,7 +3,6 @@ title: Autorisations et accès
description: Gérez les rôles, les autorisations et le contrôle d’accès dans votre espace de travail.
---
-
Le système d’autorisations de Twenty vous permet de contrôler qui peut accéder aux données de votre espace de travail et les modifier. Créez des rôles, attribuez des autorisations et configurez l’authentification unique (SSO) pour un accès sécurisé.
## Contenu de cette section
@@ -12,11 +11,9 @@ Le système d’autorisations de Twenty vous permet de contrôler qui peut accé
<Card title="Permissions" icon="lock" href="/l/fr/user-guide/permissions-access/capabilities/permissions">
Créez des rôles et configurez les autorisations sur les objets, les champs et les paramètres.
</Card>
-
<Card title="Configuration SSO" icon="clé" href="/l/fr/user-guide/permissions-access/capabilities/sso-configuration">
Configurez l’authentification unique avec votre fournisseur d’identité.
</Card>
-
<Card title="FAQ" icon="circle-question" href="/l/fr/user-guide/permissions-access/how-tos/permissions-faq">
Questions fréquentes sur les rôles, les autorisations et l’authentification unique (SSO).
</Card>
diff --git a/packages/twenty-docs/l/fr/user-guide/settings/capabilities/domains-settings.mdx b/packages/twenty-docs/l/fr/user-guide/settings/capabilities/domains-settings.mdx
index 0ec58326864..37587c547c9 100644
--- a/packages/twenty-docs/l/fr/user-guide/settings/capabilities/domains-settings.mdx
+++ b/packages/twenty-docs/l/fr/user-guide/settings/capabilities/domains-settings.mdx
@@ -3,10 +3,12 @@ title: Paramètres des domaines
description: Configurez le domaine de l'espace de travail, les domaines d'accès approuvés et les domaines publics.
---
-Configurez les paramètres de domaine dans **Paramètres → Domaines**.
+Les paramètres de domaine se trouvent à trois endroits, en fonction de ce que vous configurez.
## Domaine de l'espace de travail
+Configurez dans **Paramètres → Général → Domaine de l’espace de travail**.
+
Modifiez le nom de votre sous-domaine ou définissez un domaine personnalisé pour votre espace de travail.
### Personnaliser le domaine
@@ -19,6 +21,8 @@ Pour les domaines personnalisés, vous devrez configurer les paramètres DNS aup
## Domaines approuvés
+Configurez dans **Paramètres → Membres → Invitation**.
+
Toute personne ayant une adresse e-mail dans l'un de ces domaines est autorisée à s'inscrire automatiquement à cet espace de travail.
### Ajouter un domaine d'accès approuvé
@@ -30,18 +34,21 @@ Toute personne ayant une adresse e-mail dans l'un de ces domaines est autorisée
Une fois configuré, toute personne ayant une adresse e-mail de ce domaine peut rejoindre votre espace de travail sans avoir besoin d'une invitation directe.
<Note>
- Cela est utile pour permettre à toute votre équipe de s'auto-inscrire tout en gardant l'espace de travail restreint à votre organisation.
+Cela est utile pour permettre à toute votre équipe de s'auto-inscrire tout en gardant l'espace de travail restreint à votre organisation.
</Note>
## Domaines publics
-Provisionner un environnement d'hébergement complet et sécurisé sur ces domaines.
+Configurez dans **Paramètres → Applications → Développeur**.
+
+Provisionner un environnement d'hébergement complet et sécurisé sur ces domaines. Un domaine public peut être lié à une application spécifique — lorsqu’il est lié, seules les fonctions logiques acheminées via HTTP de cette application sont accessibles sur le domaine. Laissez la liaison vide pour exposer toutes les routes HTTP de l’espace de travail.
### Ajouter domaine public
1. Cliquez sur **Ajouter un domaine public**
2. Saisissez le domaine que vous souhaitez utiliser
-3. Configurez les paramètres DNS comme indiqué
-4. Vérifiez le domaine
+3. Facultatif : liez-le à une application
+4. Configurez les paramètres DNS comme indiqué
+5. Vérifiez le domaine
Les certificats SSL sont automatiquement fournis pour les domaines publics.
diff --git a/packages/twenty-docs/l/fr/user-guide/settings/capabilities/member-management.mdx b/packages/twenty-docs/l/fr/user-guide/settings/capabilities/member-management.mdx
index b6b32439878..87d0a2ec50b 100644
--- a/packages/twenty-docs/l/fr/user-guide/settings/capabilities/member-management.mdx
+++ b/packages/twenty-docs/l/fr/user-guide/settings/capabilities/member-management.mdx
@@ -59,11 +59,11 @@ Sur la page de profil du membre :
2. Cliquez sur **Supprimer** pour le retirer de l'espace de travail
<Warning>
- Les membres retirés perdent immédiatement l'accès. Leurs données (enregistrements, notes, tâches) restent dans l'espace de travail.
+Les membres retirés perdent immédiatement l'accès. Leurs données (enregistrements, notes, tâches) restent dans l'espace de travail.
</Warning>
<Warning>
- **La synchronisation des e-mails est également supprimée.** Si l'utilisateur supprimé était le seul à avoir synchronisé certains e-mails, ces e-mails seront définitivement supprimés de l'espace de travail.
+**La synchronisation des e-mails est également supprimée.** Si l'utilisateur supprimé était le seul à avoir synchronisé certains e-mails, ces e-mails seront définitivement supprimés de l'espace de travail.
</Warning>
## Invitations en attente
@@ -77,7 +77,7 @@ Gérez les invitations qui n'ont pas été acceptées :
Autorisez les membres de l'équipe à rejoindre automatiquement l'espace de travail selon leur domaine e-mail :
-1. Allez dans **Paramètres → Domaines**
+1. Allez dans **Paramètres → Membres → Invitations**
2. Ajoutez le domaine de votre entreprise (par exemple, `yourcompany.com`)
3. Toute personne dont l'adresse e-mail appartient à ce domaine peut rejoindre sans invitation
diff --git a/packages/twenty-docs/l/fr/user-guide/settings/capabilities/profile-settings.mdx b/packages/twenty-docs/l/fr/user-guide/settings/capabilities/profile-settings.mdx
index 6f26f462699..9971dc59353 100644
--- a/packages/twenty-docs/l/fr/user-guide/settings/capabilities/profile-settings.mdx
+++ b/packages/twenty-docs/l/fr/user-guide/settings/capabilities/profile-settings.mdx
@@ -32,7 +32,7 @@ Activez le 2FA pour ajouter une couche supplémentaire de sécurité à votre co
### Supprimer le compte
<Warning>
- La suppression de votre compte supprimera définitivement votre accès à tous les espaces de travail. Cette action ne peut être annulée, vous perdrez l'accès à tous les espaces de travail où vous êtes membre, et vous devriez envisager de quitter des espaces de travail individuels si vous souhaitez uniquement quitter certaines équipes.
+La suppression de votre compte supprimera définitivement votre accès à tous les espaces de travail. Cette action ne peut être annulée, vous perdrez l'accès à tous les espaces de travail où vous êtes membre, et vous devriez envisager de quitter des espaces de travail individuels si vous souhaitez uniquement quitter certaines équipes.
</Warning>
Pour supprimer votre compte :
diff --git a/packages/twenty-docs/l/fr/user-guide/settings/capabilities/updates-settings.mdx b/packages/twenty-docs/l/fr/user-guide/settings/capabilities/updates-settings.mdx
index 3ce0f2c3e94..d4cf33e00ac 100644
--- a/packages/twenty-docs/l/fr/user-guide/settings/capabilities/updates-settings.mdx
+++ b/packages/twenty-docs/l/fr/user-guide/settings/capabilities/updates-settings.mdx
@@ -24,7 +24,7 @@ Les fonctionnalités en Accès anticipé sont des fonctionnalités testées avan
5. La fonctionnalité sera disponible immédiatement
<Note>
- Les fonctionnalités en Accès anticipé peuvent évoluer en fonction des retours des utilisateurs. Vos commentaires nous aident à améliorer Twenty !
+Les fonctionnalités en Accès anticipé peuvent évoluer en fonction des retours des utilisateurs. Vos commentaires nous aident à améliorer Twenty !
</Note>
## Commentaires sur les fonctionnalités
diff --git a/packages/twenty-docs/l/fr/user-guide/settings/capabilities/workspace-settings.mdx b/packages/twenty-docs/l/fr/user-guide/settings/capabilities/workspace-settings.mdx
index ab22355382b..6bf3110f24c 100644
--- a/packages/twenty-docs/l/fr/user-guide/settings/capabilities/workspace-settings.mdx
+++ b/packages/twenty-docs/l/fr/user-guide/settings/capabilities/workspace-settings.mdx
@@ -19,7 +19,7 @@ Those are accessible under **Settings → General**.
## Zone de danger
<Warning>
- Supprimer votre espace de travail supprime définitivement toutes les données et ne peut pas être annulé. Toutes les données de l'espace de travail seront perdues à jamais, tous les membres perdront immédiatement l'accès et cette action ne peut pas être inversée.
+Supprimer votre espace de travail supprime définitivement toutes les données et ne peut pas être annulé. Toutes les données de l'espace de travail seront perdues à jamais, tous les membres perdront immédiatement l'accès et cette action ne peut pas être inversée.
</Warning>
Pour supprimer votre espace de travail :
diff --git a/packages/twenty-docs/l/fr/user-guide/settings/how-tos/settings-faq.mdx b/packages/twenty-docs/l/fr/user-guide/settings/how-tos/settings-faq.mdx
index ced7e6fbdbc..4e9cbcb8fa9 100644
--- a/packages/twenty-docs/l/fr/user-guide/settings/how-tos/settings-faq.mdx
+++ b/packages/twenty-docs/l/fr/user-guide/settings/how-tos/settings-faq.mdx
@@ -6,165 +6,165 @@ description: Foire aux questions sur les paramètres de Twenty.
## Paramètres de l'espace de travail
<AccordionGroup>
- <Accordion title="Comment changer le nom de mon espace de travail ?">
- 1. Allez dans **Paramètres → Général**
- 2. Repérez le champ Nom de l'espace de travail
- 3. Saisissez le nouveau nom
- 4. Les modifications sont enregistrées automatiquement
- </Accordion>
-
- <Accordion title="Comment mettre à jour le logo de mon espace de travail ?">
- 1. Allez dans **Paramètres → Général**
- 2. Cliquez sur le logo actuel ou la zone de téléversement
- 3. Sélectionnez un fichier image (PNG, JPEG ou GIF de moins de 10 Mo)
- 4. Le logo est mis à jour immédiatement
- </Accordion>
-
- <Accordion title="Puis-je avoir plusieurs espaces de travail ?">
- Oui, vous pouvez créer et être membre de plusieurs espaces de travail. Chaque espace de travail possède ses propres données, paramètres et abonnement.
- </Accordion>
-
- <Accordion title="Comment supprimer mon espace de travail ?">
- 1. Allez dans **Paramètres → Général**
- 2. Faites défiler jusqu'à la section Zone de danger
- 3. Cliquez sur **Supprimer l'espace de travail**
- 4. Confirmez la suppression
-
- Remarque : cela supprime définitivement toutes les données et ne peut pas être annulé.
- </Accordion>
-
- <Accordion title="J'ai créé par erreur plusieurs espaces de travail. Que dois-je faire ?">
- Supprimez les espaces de travail dont vous n'avez plus besoin dans **Paramètres → Général → Supprimer l'espace de travail**.
-
- <Warning>
- Ne supprimez pas votre **compte** (accessible sous Paramètres → Profil) : votre compte est partagé entre tous vos espaces de travail. La suppression de votre compte supprime l'accès à TOUS les espaces de travail.
- </Warning>
- </Accordion>
-
- <Accordion title="Comment désactiver mon espace de travail sans le supprimer ?">
- Si vous souhaitez désactiver temporairement votre espace de travail (et non le supprimer définitivement), allez dans **Paramètres → Facturation** et cliquez sur **Annuler l'abonnement**. Vos données seront conservées pendant une période de grâce.
- </Accordion>
+<Accordion title="Comment changer le nom de mon espace de travail ?">
+1. Allez dans **Paramètres → Général**
+2. Repérez le champ Nom de l'espace de travail
+3. Saisissez le nouveau nom
+4. Les modifications sont enregistrées automatiquement
+</Accordion>
+
+<Accordion title="Comment mettre à jour le logo de mon espace de travail ?">
+1. Allez dans **Paramètres → Général**
+2. Cliquez sur le logo actuel ou la zone de téléversement
+3. Sélectionnez un fichier image (PNG, JPEG ou GIF de moins de 10 Mo)
+4. Le logo est mis à jour immédiatement
+</Accordion>
+
+<Accordion title="Puis-je avoir plusieurs espaces de travail ?">
+Oui, vous pouvez créer et être membre de plusieurs espaces de travail. Chaque espace de travail possède ses propres données, paramètres et abonnement.
+</Accordion>
+
+<Accordion title="Comment supprimer mon espace de travail ?">
+1. Allez dans **Paramètres → Général**
+2. Faites défiler jusqu'à la section Zone de danger
+3. Cliquez sur **Supprimer l'espace de travail**
+4. Confirmez la suppression
+
+Remarque : cela supprime définitivement toutes les données et ne peut pas être annulé.
+</Accordion>
+
+<Accordion title="J'ai créé par erreur plusieurs espaces de travail. Que dois-je faire ?">
+Supprimez les espaces de travail dont vous n'avez plus besoin dans **Paramètres → Général → Supprimer l'espace de travail**.
+
+<Warning>
+Ne supprimez pas votre **compte** (accessible sous Paramètres → Profil) : votre compte est partagé entre tous vos espaces de travail. La suppression de votre compte supprime l'accès à TOUS les espaces de travail.
+</Warning>
+</Accordion>
+
+<Accordion title="Comment désactiver mon espace de travail sans le supprimer ?">
+Si vous souhaitez désactiver temporairement votre espace de travail (et non le supprimer définitivement), allez dans **Paramètres → Facturation** et cliquez sur **Annuler l'abonnement**. Vos données seront conservées pendant une période de grâce.
+</Accordion>
</AccordionGroup>
## Paramètres du profil
<AccordionGroup>
- <Accordion title="Comment changer mon mot de passe ?">
- 1. Allez dans **Paramètres → Profil**
- 2. Repérez la section Mot de passe
- 3. Saisissez votre mot de passe actuel
- 4. Saisissez votre nouveau mot de passe
- 5. Enregistrez les modifications
- </Accordion>
-
- <Accordion title="Comment activer l'authentification à deux facteurs ?">
- 1. Allez dans **Paramètres → Profil**
- 2. Repérez la section 2FA
- 3. Cliquez sur **Activer le 2FA**
- 4. Scannez le code QR avec votre application d'authentification
- 5. Saisissez le code de vérification
- </Accordion>
-
- <Accordion title="Puis-je changer mon adresse e-mail ?">
- Pour changer votre adresse e-mail, veuillez contacter [[email protected]](mailto:[email protected]).
- </Accordion>
-
- <Accordion title="Comment supprimer mon compte ?">
- 1. Allez dans **Paramètres → Profil**
- 2. Faites défiler jusqu'à la section Zone de danger
- 3. Cliquez sur **Supprimer le compte**
- 4. Confirmez en saisissant votre adresse e-mail
-
- Remarque : cela supprime votre accès à tous les espaces de travail et supprime tous les e-mails synchronisés depuis vos comptes connectés.
- </Accordion>
+<Accordion title="Comment changer mon mot de passe ?">
+1. Allez dans **Paramètres → Profil**
+2. Repérez la section Mot de passe
+3. Saisissez votre mot de passe actuel
+4. Saisissez votre nouveau mot de passe
+5. Enregistrez les modifications
+</Accordion>
+
+<Accordion title="Comment activer l'authentification à deux facteurs ?">
+1. Allez dans **Paramètres → Profil**
+2. Repérez la section 2FA
+3. Cliquez sur **Activer le 2FA**
+4. Scannez le code QR avec votre application d'authentification
+5. Saisissez le code de vérification
+</Accordion>
+
+<Accordion title="Puis-je changer mon adresse e-mail ?">
+Pour changer votre adresse e-mail, veuillez contacter [[email protected]](mailto:[email protected]).
+</Accordion>
+
+<Accordion title="Comment supprimer mon compte ?">
+1. Allez dans **Paramètres → Profil**
+2. Faites défiler jusqu'à la section Zone de danger
+3. Cliquez sur **Supprimer le compte**
+4. Confirmez en saisissant votre adresse e-mail
+
+Remarque : cela supprime votre accès à tous les espaces de travail et supprime tous les e-mails synchronisés depuis vos comptes connectés.
+</Accordion>
</AccordionGroup>
## Expérience - Paramètres
<AccordionGroup>
- <Accordion title="Comment basculer entre le mode clair et le mode sombre ?">
- 1. Allez dans **Paramètres → Expérience**
- 2. Repérez la section Thème
- 3. Sélectionnez Clair, Sombre ou Système
- </Accordion>
-
- <Accordion title="Comment changer le format de date ?">
- 1. Allez dans **Paramètres → Expérience**
- 2. Repérez le paramètre Format de date
- 3. Sélectionnez votre format préféré
- 4. Les modifications s'appliquent immédiatement
- </Accordion>
-
- <Accordion title="Comment changer mon fuseau horaire ?">
- 1. Allez dans **Paramètres → Expérience**
- 2. Repérez le paramètre Fuseau horaire
- 3. Sélectionnez votre fuseau horaire local
- 4. Tous les horodatages seront ajustés
- </Accordion>
-
- <Accordion title="Puis-je changer la langue ?">
- 1. Allez dans **Paramètres → Expérience**
- 2. Repérez le paramètre Langue
- 3. Sélectionnez parmi les langues disponibles
- 4. L'interface se met à jour selon votre sélection
- </Accordion>
+<Accordion title="Comment basculer entre le mode clair et le mode sombre ?">
+1. Allez dans **Paramètres → Expérience**
+2. Repérez la section Thème
+3. Sélectionnez Clair, Sombre ou Système
+</Accordion>
+
+<Accordion title="Comment changer le format de date ?">
+1. Allez dans **Paramètres → Expérience**
+2. Repérez le paramètre Format de date
+3. Sélectionnez votre format préféré
+4. Les modifications s'appliquent immédiatement
+</Accordion>
+
+<Accordion title="Comment changer mon fuseau horaire ?">
+1. Allez dans **Paramètres → Expérience**
+2. Repérez le paramètre Fuseau horaire
+3. Sélectionnez votre fuseau horaire local
+4. Tous les horodatages seront ajustés
+</Accordion>
+
+<Accordion title="Puis-je changer la langue ?">
+1. Allez dans **Paramètres → Expérience**
+2. Repérez le paramètre Langue
+3. Sélectionnez parmi les langues disponibles
+4. L'interface se met à jour selon votre sélection
+</Accordion>
</AccordionGroup>
## Paramètres du compte
<AccordionGroup>
- <Accordion title="Comment connecter mon compte e-mail ?">
- 1. Allez dans **Paramètres → Comptes**
- 2. Cliquez sur **Ajouter un compte**
- 3. Choisissez Google ou Microsoft
- 4. Autorisez l'accès
- 5. Configurez les paramètres de synchronisation
- </Accordion>
-
- <Accordion title="Puis-je connecter plusieurs comptes e-mail ?">
- Oui, vous pouvez connecter plusieurs comptes e-mail. Allez dans **Paramètres → Comptes** et ajoutez des comptes supplémentaires selon vos besoins.
- </Accordion>
-
- <Accordion title="Comment déconnecter un compte e-mail ?">
- 1. Allez dans **Paramètres → Comptes**
- 2. Repérez le compte à supprimer
- 3. Cliquez sur **Déconnecter**
- 4. Confirmez l'action
- </Accordion>
+<Accordion title="Comment connecter mon compte e-mail ?">
+1. Allez dans **Paramètres → Comptes**
+2. Cliquez sur **Ajouter un compte**
+3. Choisissez Google ou Microsoft
+4. Autorisez l'accès
+5. Configurez les paramètres de synchronisation
+</Accordion>
+
+<Accordion title="Puis-je connecter plusieurs comptes e-mail ?">
+Oui, vous pouvez connecter plusieurs comptes e-mail. Allez dans **Paramètres → Comptes** et ajoutez des comptes supplémentaires selon vos besoins.
+</Accordion>
+
+<Accordion title="Comment déconnecter un compte e-mail ?">
+1. Allez dans **Paramètres → Comptes**
+2. Repérez le compte à supprimer
+3. Cliquez sur **Déconnecter**
+4. Confirmez l'action
+</Accordion>
</AccordionGroup>
## Domaines
<AccordionGroup>
- <Accordion title="Puis-je personnaliser le domaine de mon espace de travail ?">
- Oui! Allez dans **Paramètres → Domaines** et cliquez sur **Personnaliser le domaine**. Vous avez deux options :
+<Accordion title="Puis-je personnaliser le domaine de mon espace de travail ?">
+Oui! Allez dans **Paramètres → Général → Domaine de l'espace de travail** et cliquez sur **Personnaliser le domaine**. Vous avez deux options :
- * **Sous-domaine** : Utilisez un sous-domaine Twenty comme `yourcompany.twenty.com`
- * **Domaine personnalisé** : Utilisez votre propre domaine comme `crm.yourcompany.com` (nécessite une configuration DNS)
+* **Sous-domaine** : Utilisez un sous-domaine Twenty comme `yourcompany.twenty.com`
+* **Domaine personnalisé** : Utilisez votre propre domaine comme `crm.yourcompany.com` (nécessite une configuration DNS)
- Un sous-domaine est rapide à configurer, tandis qu'un domaine personnalisé offre à votre équipe une expérience entièrement adaptée à votre marque.
- </Accordion>
+Un sous-domaine est rapide à configurer, tandis qu'un domaine personnalisé offre à votre équipe une expérience entièrement adaptée à votre marque.
+</Accordion>
- <Accordion title="Comment fonctionnent les domaines d'accès approuvés ?">
- Vous pouvez configurer des domaines d'accès approuvés afin que les membres de l'équipe disposant d'adresses e-mail professionnelles puissent rejoindre automatiquement votre espace de travail. Allez dans **Paramètres → Domaines** et ajoutez le domaine de votre entreprise (par exemple, `yourcompany.com`).
- </Accordion>
+<Accordion title="Comment fonctionnent les domaines d'accès approuvés ?">
+Vous pouvez configurer des domaines d'accès approuvés afin que les membres de l'équipe disposant d'adresses e-mail professionnelles puissent rejoindre automatiquement votre espace de travail. Allez dans **Paramètres → Membres → Inviter** et ajoutez le domaine de votre entreprise (par exemple, `yourcompany.com`).
+</Accordion>
</AccordionGroup>
## Fonctionnalités en Accès anticipé
<AccordionGroup>
- <Accordion title="Quelles sont les fonctionnalités en Accès anticipé ?">
- Les fonctionnalités en Accès anticipé sont des fonctionnalités testées avant leur disponibilité générale. Actuellement, seuls les **Tableaux de bord** sont en Accès anticipé. Elles peuvent évoluer en fonction des retours des utilisateurs.
- </Accordion>
-
- <Accordion title="Les fonctionnalités en Accès anticipé sont-elles sûres à utiliser ?">
- Les fonctionnalités en Accès anticipé sont fonctionnelles mais peuvent évoluer en fonction des retours des utilisateurs. Elles sont sûres à utiliser, mais peuvent évoluer avant la disponibilité générale.
- </Accordion>
-
- <Accordion title="Comment activer les fonctionnalités en Accès anticipé ?">
- 1. Allez dans **Paramètres → Mises à jour → Accès anticipé**
- 2. Repérez la fonctionnalité souhaitée
- 3. Activez-la
- 4. La fonctionnalité devient disponible immédiatement
- </Accordion>
+<Accordion title="Quelles sont les fonctionnalités en Accès anticipé ?">
+Les fonctionnalités en Accès anticipé sont des fonctionnalités testées avant leur disponibilité générale. Actuellement, seuls les **Tableaux de bord** sont en Accès anticipé. Elles peuvent évoluer en fonction des retours des utilisateurs.
+</Accordion>
+
+<Accordion title="Les fonctionnalités en Accès anticipé sont-elles sûres à utiliser ?">
+Les fonctionnalités en Accès anticipé sont fonctionnelles mais peuvent évoluer en fonction des retours des utilisateurs. Elles sont sûres à utiliser, mais peuvent évoluer avant la disponibilité générale.
+</Accordion>
+
+<Accordion title="Comment activer les fonctionnalités en Accès anticipé ?">
+1. Allez dans **Paramètres → Mises à jour → Accès anticipé**
+2. Repérez la fonctionnalité souhaitée
+3. Activez-la
+4. La fonctionnalité devient disponible immédiatement
+</Accordion>
</AccordionGroup>
diff --git a/packages/twenty-docs/l/fr/user-guide/settings/overview.mdx b/packages/twenty-docs/l/fr/user-guide/settings/overview.mdx
index a6963b89f2f..c76dbe2d8a7 100644
--- a/packages/twenty-docs/l/fr/user-guide/settings/overview.mdx
+++ b/packages/twenty-docs/l/fr/user-guide/settings/overview.mdx
@@ -3,7 +3,6 @@ title: Paramètres
description: Configurez votre espace de travail Twenty avec des paramètres essentiels.
---
-
## Configuration initiale
Lorsque vous créez votre espace de travail pour la première fois, il y a plusieurs paramètres clés à configurer.
@@ -45,7 +44,7 @@ Ajoutez des membres de votre équipe à votre espace de travail :
4. Attribuez les rôles appropriés
<Note>
- Avant d'inviter votre équipe, vérifiez le rôle par défaut dans **Paramètres → Rôles**. Les nouveaux membres se voient automatiquement attribuer ce rôle lorsqu'ils rejoignent l'espace de travail.
+Avant d'inviter votre équipe, vérifiez le rôle par défaut dans **Paramètres → Membres → Rôles**. Les nouveaux membres se voient automatiquement attribuer ce rôle lorsqu'ils rejoignent l'espace de travail.
</Note>
## Liste de contrôle des paramètres de l'espace de travail
diff --git a/packages/twenty-docs/l/fr/user-guide/views-pipelines/capabilities/table-views.mdx b/packages/twenty-docs/l/fr/user-guide/views-pipelines/capabilities/table-views.mdx
index 582cb6191f1..517d630602d 100644
--- a/packages/twenty-docs/l/fr/user-guide/views-pipelines/capabilities/table-views.mdx
+++ b/packages/twenty-docs/l/fr/user-guide/views-pipelines/capabilities/table-views.mdx
@@ -38,7 +38,7 @@ Organisez les enregistrements en groupes repliables selon un champ de type Séle
* Regrouper les tâches par statut
<Note>
- **Pour des performances optimales, limitez-vous à 10-15 groupes visibles par vue.** Si vous avez besoin de plus de groupes, envisagez d’utiliser plutôt un tableau de bord.
+**Pour des performances optimales, limitez-vous à 10-15 groupes visibles par vue.** Si vous avez besoin de plus de groupes, envisagez d’utiliser plutôt un tableau de bord.
</Note>
### Largeur des colonnes
diff --git a/packages/twenty-docs/l/fr/user-guide/views-pipelines/capabilities/view-settings.mdx b/packages/twenty-docs/l/fr/user-guide/views-pipelines/capabilities/view-settings.mdx
index a61820fd77e..b7da55f1c20 100644
--- a/packages/twenty-docs/l/fr/user-guide/views-pipelines/capabilities/view-settings.mdx
+++ b/packages/twenty-docs/l/fr/user-guide/views-pipelines/capabilities/view-settings.mdx
@@ -21,7 +21,7 @@ Contrôlez qui peut voir vos vues personnalisées.
3. Sélectionnez **Espace de travail** ou **Non répertorié**
<Note>
- La visibilité des vues par défaut "All [Object Name]" ne peut pas être modifiée.
+La visibilité des vues par défaut "All [Object Name]" ne peut pas être modifiée.
</Note>
## Renommer une vue
@@ -65,7 +65,7 @@ Les vues ajoutées aux favoris apparaissent dans une section dédiée pour un ac
4. Confirmez la suppression
<Warning>
- Les vues supprimées ne peuvent pas être restaurées.
+Les vues supprimées ne peuvent pas être restaurées.
</Warning>
## Articles connexes
diff --git a/packages/twenty-docs/l/fr/user-guide/views-pipelines/how-tos/create-a-table-view-with-grouping.mdx b/packages/twenty-docs/l/fr/user-guide/views-pipelines/how-tos/create-a-table-view-with-grouping.mdx
index 46c37dbcde2..2bd2aa9ea47 100644
--- a/packages/twenty-docs/l/fr/user-guide/views-pipelines/how-tos/create-a-table-view-with-grouping.mdx
+++ b/packages/twenty-docs/l/fr/user-guide/views-pipelines/how-tos/create-a-table-view-with-grouping.mdx
@@ -32,7 +32,7 @@ Dans **Options → Regrouper → Trier**, choisissez comment les groupes sont or
Cliquez sur l'**icône en forme d'œil** à côté d'un groupe pour le masquer de la vue.
<Note>
- **Pour des performances optimales, limitez-vous à 10-15 groupes visibles.** Si vous en avez besoin de plus, envisagez d'utiliser plutôt un tableau de bord.
+**Pour des performances optimales, limitez-vous à 10-15 groupes visibles.** Si vous en avez besoin de plus, envisagez d'utiliser plutôt un tableau de bord.
</Note>
## Exemple : Entreprises par secteur d'activité
diff --git a/packages/twenty-docs/l/fr/user-guide/views-pipelines/how-tos/restrict-access-to-your-view.mdx b/packages/twenty-docs/l/fr/user-guide/views-pipelines/how-tos/restrict-access-to-your-view.mdx
index f19d50894fb..d94d444b3ec 100644
--- a/packages/twenty-docs/l/fr/user-guide/views-pipelines/how-tos/restrict-access-to-your-view.mdx
+++ b/packages/twenty-docs/l/fr/user-guide/views-pipelines/how-tos/restrict-access-to-your-view.mdx
@@ -1,5 +1,5 @@
---
-title: Restreindre l’accès à votre vue},{
+title: Restreindre l’accès à votre vue
description: Contrôlez qui peut voir vos vues personnalisées.
---
diff --git a/packages/twenty-docs/l/fr/user-guide/views-pipelines/how-tos/set-up-a-sales-pipeline.mdx b/packages/twenty-docs/l/fr/user-guide/views-pipelines/how-tos/set-up-a-sales-pipeline.mdx
index a318b38489e..d83189dd89c 100644
--- a/packages/twenty-docs/l/fr/user-guide/views-pipelines/how-tos/set-up-a-sales-pipeline.mdx
+++ b/packages/twenty-docs/l/fr/user-guide/views-pipelines/how-tos/set-up-a-sales-pipeline.mdx
@@ -31,7 +31,7 @@ Les étapes sont définies dans le champ **Étape** de l'objet Opportunités.
| **Clôturée perdue** | Affaire perdue |
<Note>
- **5 à 7 étapes, c'est optimal.** Trop d'étapes rendent le pipeline difficile à parcourir ; trop peu fait perdre de la visibilité sur l'avancement des opportunités.
+**5 à 7 étapes, c'est optimal.** Trop d'étapes rendent le pipeline difficile à parcourir ; trop peu fait perdre de la visibilité sur l'avancement des opportunités.
</Note>
## Étape 2 : Créez une vue de pipeline
diff --git a/packages/twenty-docs/l/fr/user-guide/views-pipelines/how-tos/show-expected-amount-in-pipeline.mdx b/packages/twenty-docs/l/fr/user-guide/views-pipelines/how-tos/show-expected-amount-in-pipeline.mdx
index 1c956dfc1c1..dce07bdfab2 100644
--- a/packages/twenty-docs/l/fr/user-guide/views-pipelines/how-tos/show-expected-amount-in-pipeline.mdx
+++ b/packages/twenty-docs/l/fr/user-guide/views-pipelines/how-tos/show-expected-amount-in-pipeline.mdx
@@ -1,12 +1,12 @@
---
-title: Afficher le Montant attendu dans votre pipeline},{
+title: Afficher le Montant attendu dans votre pipeline
description: Calculez et affichez les valeurs d'affaire pondérées en fonction de la probabilité de l'étape.
---
Le Montant attendu est une valeur calculée : **Montant × Probabilité**. Cela vous aide à prévoir les revenus en pondérant les affaires selon leur probabilité de conclusion.
<Tip>
- Ceci est un exemple de création de [Champs de formule](/l/fr/user-guide/workflows/how-tos/crm-automations/formula-fields) à l'aide de workflows.
+Ceci est un exemple de création de [Champs de formule](/l/fr/user-guide/workflows/how-tos/crm-automations/formula-fields) à l'aide de workflows.
</Tip>
Ce guide vous explique comment configurer les champs personnalisés et les workflows nécessaires pour calculer et afficher les montants attendus dans votre pipeline.
@@ -38,7 +38,7 @@ Vous avez besoin de deux champs personnalisés sur l'objet Opportunités.
Si vous ne souhaitez pas que les utilisateurs modifient manuellement ces champs calculés :
-1. Allez dans **Paramètres → Rôles**
+1. Allez dans **Paramètres → Membres → Rôles**
2. Sélectionnez le rôle à configurer
3. Recherchez l'objet Opportunités
4. Définissez les champs **Probabilité** et **Montant attendu** en lecture seule
@@ -76,7 +76,7 @@ Créez une branche pour chaque étape avec sa probabilité :
| Fermée perdue | 0% |
<Note>
- Pour créer une nouvelle branche, cliquez avec le bouton droit sur la zone de travail du workflow et cliquez sur **Nouvelle action**. Puis, reliez cette action au nœud précédent en faisant glisser la flèche du nœud précédent vers cette nouvelle action.
+Pour créer une nouvelle branche, cliquez avec le bouton droit sur la zone de travail du workflow et cliquez sur **Nouvelle action**. Puis, reliez cette action au nœud précédent en faisant glisser la flèche du nœud précédent vers cette nouvelle action.
</Note>
Pour chaque étape :
diff --git a/packages/twenty-docs/l/fr/user-guide/views-pipelines/how-tos/track-time-in-stage.mdx b/packages/twenty-docs/l/fr/user-guide/views-pipelines/how-tos/track-time-in-stage.mdx
index 160da26ffbb..7ae5955701d 100644
--- a/packages/twenty-docs/l/fr/user-guide/views-pipelines/how-tos/track-time-in-stage.mdx
+++ b/packages/twenty-docs/l/fr/user-guide/views-pipelines/how-tos/track-time-in-stage.mdx
@@ -4,7 +4,7 @@ description: Surveillez la vélocité des affaires en suivant le moment où les
---
<Tip>
- Voici un exemple de création de [champs de formule](/l/fr/user-guide/workflows/how-tos/crm-automations/formula-fields) à l'aide de Workflows — plus précisément des calculs de dates.
+Voici un exemple de création de [champs de formule](/l/fr/user-guide/workflows/how-tos/crm-automations/formula-fields) à l'aide de Workflows — plus précisément des calculs de dates.
</Tip>
Suivre le moment où les opportunités entrent dans chaque étape vous aide à identifier les goulots d'étranglement et à mesurer la vélocité des affaires.
@@ -54,14 +54,14 @@ Créez ces champs :
* Jours dans Négociation
<Note>
- Vous n'avez pas besoin de champs "Jours dans" pour Clôturée gagnée et Clôturée perdue, car ce sont des étapes finales.
+Vous n'avez pas besoin de champs "Jours dans" pour Clôturée gagnée et Clôturée perdue, car ce sont des étapes finales.
</Note>
### Facultatif : rendre les champs en lecture seule
Si vous ne souhaitez pas que les utilisateurs modifient manuellement ces champs calculés :
-1. Allez dans **Paramètres → Rôles**
+1. Allez dans **Paramètres → Membres → Rôles**
2. Sélectionnez le rôle à configurer
3. Trouvez l'objet Opportunités
4. Définissez les champs "Dernière entrée" et "Jours dans" en lecture seule
@@ -88,7 +88,7 @@ Ce seul workflow gère les deux tâches :
### Ajoutez des branches pour chaque étape
<Note>
- Pour créer une nouvelle branche, faites un clic droit sur le canevas du workflow et cliquez sur **Nouvelle action**. Ensuite, reliez cette action au nœud précédent en faisant glisser la flèche du nœud précédent vers cette nouvelle action.
+Pour créer une nouvelle branche, faites un clic droit sur le canevas du workflow et cliquez sur **Nouvelle action**. Ensuite, reliez cette action au nœud précédent en faisant glisser la flèche du nœud précédent vers cette nouvelle action.
</Note>
---
diff --git a/packages/twenty-docs/l/fr/user-guide/views-pipelines/overview.mdx b/packages/twenty-docs/l/fr/user-guide/views-pipelines/overview.mdx
index a430d6715b9..f8c1e804c8c 100644
--- a/packages/twenty-docs/l/fr/user-guide/views-pipelines/overview.mdx
+++ b/packages/twenty-docs/l/fr/user-guide/views-pipelines/overview.mdx
@@ -5,7 +5,6 @@ description: Découvrez comment créer et gérer des vues dans Twenty.
import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
-
## Comprendre les vues
Les vues sont des configurations enregistrées qui déterminent la façon dont vos données sont affichées. Chaque vue peut avoir ses propres :
@@ -106,7 +105,7 @@ Il y a deux manières de créer une nouvelle vue.
5. Confirmez la suppression
<Warning>
- Les vues supprimées ne peuvent pas être récupérées. Assurez-vous de vouloir la supprimer avant de confirmer.
+Les vues supprimées ne peuvent pas être récupérées. Assurez-vous de vouloir la supprimer avant de confirmer.
</Warning>
## Visibilité de la vue
@@ -122,7 +121,7 @@ Pour modifier la visibilité :
* **Non répertoriée** : Visible uniquement par vous
<Note>
- La visibilité des vues par défaut "Tous les [Nom de l'objet]" ne peut pas être modifiée.
+La visibilité des vues par défaut "Tous les [Nom de l'objet]" ne peut pas être modifiée.
</Note>
## Prochaines étapes
diff --git a/packages/twenty-docs/l/fr/user-guide/workflows/capabilities/send-emails-from-workflows.mdx b/packages/twenty-docs/l/fr/user-guide/workflows/capabilities/send-emails-from-workflows.mdx
index 8ffe2d03730..cb5dc0849d3 100644
--- a/packages/twenty-docs/l/fr/user-guide/workflows/capabilities/send-emails-from-workflows.mdx
+++ b/packages/twenty-docs/l/fr/user-guide/workflows/capabilities/send-emails-from-workflows.mdx
@@ -135,7 +135,7 @@ Vous pouvez joindre des fichiers aux e-mails envoyés à partir de workflows. La
| **Confirmations d'événements** | Détails de l'événement ou programme |
<Note>
- Les pièces jointes sont statiques — le même fichier est envoyé à tous les destinataires. Pour les documents dynamiques (comme des devis personnalisés), générez et joignez des fichiers à l'aide d'une [Logic Function](/l/fr/user-guide/workflows/how-tos/connect-to-other-tools/generate-pdf-from-twenty).
+Les pièces jointes sont statiques — le même fichier est envoyé à tous les destinataires. Pour les documents dynamiques (comme des devis personnalisés), générez et joignez des fichiers à l'aide d'une [Logic Function](/l/fr/user-guide/workflows/how-tos/connect-to-other-tools/generate-pdf-from-twenty).
</Note>
## Meilleures pratiques
diff --git a/packages/twenty-docs/l/fr/user-guide/workflows/capabilities/use-branches-in-workflows.mdx b/packages/twenty-docs/l/fr/user-guide/workflows/capabilities/use-branches-in-workflows.mdx
index 88237d302d8..9faa89c318c 100644
--- a/packages/twenty-docs/l/fr/user-guide/workflows/capabilities/use-branches-in-workflows.mdx
+++ b/packages/twenty-docs/l/fr/user-guide/workflows/capabilities/use-branches-in-workflows.mdx
@@ -42,7 +42,7 @@ Les deux branches démarrent, mais seule celle qui correspond au montant de l'af
## Création de branches
<Note>
- Pour créer une nouvelle branche à partir d'une étape existante, cliquez sur le bouton **+** sur l'étape et ajoutez votre action. Vous pouvez ajouter plusieurs branches en cliquant plusieurs fois sur **+**.
+Pour créer une nouvelle branche à partir d'une étape existante, cliquez sur le bouton **+** sur l'étape et ajoutez votre action. Vous pouvez ajouter plusieurs branches en cliquant plusieurs fois sur **+**.
</Note>
1. Dans l'éditeur de flux de travail, sélectionnez l'étape à partir de laquelle vous souhaitez créer une branche
diff --git a/packages/twenty-docs/l/fr/user-guide/workflows/capabilities/workflow-actions.mdx b/packages/twenty-docs/l/fr/user-guide/workflows/capabilities/workflow-actions.mdx
index 8a04148320b..ae101b71475 100644
--- a/packages/twenty-docs/l/fr/user-guide/workflows/capabilities/workflow-actions.mdx
+++ b/packages/twenty-docs/l/fr/user-guide/workflows/capabilities/workflow-actions.mdx
@@ -10,9 +10,9 @@ import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
Les actions définissent ce qui se passe après le déclenchement d'un déclencheur. Vous pouvez enchaîner plusieurs actions pour créer des automatisations complexes.
<Tip>
- * Utilisez le sélecteur de variables (cliquez sur l'icône `(x+)`) pour parcourir les données disponibles provenant des étapes précédentes
- * Survolez n'importe quel champ de saisie pour voir de quelle étape provient une variable — utile lorsque le même champ (par ex., ID) existe dans plusieurs étapes précédentes
- * Donnez à chaque action un nom explicite pour faciliter la maintenance
+* Utilisez le sélecteur de variables (cliquez sur l'icône `(x+)`) pour parcourir les données disponibles provenant des étapes précédentes
+* Survolez n'importe quel champ de saisie pour voir de quelle étape provient une variable — utile lorsque le même champ (par ex., ID) existe dans plusieurs étapes précédentes
+* Donnez à chaque action un nom explicite pour faciliter la maintenance
</Tip>
## Actions sur les enregistrements
@@ -71,7 +71,7 @@ Trouve des enregistrements dans un objet sélectionné en utilisant des conditio
**Sortie**: Renvoie les enregistrements correspondants qui peuvent être utilisés dans les étapes suivantes.
<Note>
- **Limite**: Search Records renvoie un maximum de **200 enregistrements**. Si vous devez en traiter davantage, ajoutez des filtres spécifiques pour réduire les résultats ou utilisez des workflows planifiés pour traiter par lots.
+**Limite**: Search Records renvoie un maximum de **200 enregistrements**. Si vous devez en traiter davantage, ajoutez des filtres spécifiques pour réduire les résultats ou utilisez des workflows planifiés pour traiter par lots.
</Note>
**Meilleure pratique**: Utilisez [branches](/l/fr/user-guide/workflows/capabilities/workflow-branches) après Search Records pour gérer les scénarios "trouvé" vs "non trouvé".
@@ -89,7 +89,7 @@ Crée un nouvel enregistrement ou met à jour un enregistrement existant en fonc
* Renseignez les valeurs des champs. N'oubliez pas de renseigner au moins un des identifiants uniques.
<Note>
- **La correspondance fonctionne généralement encore mieux lorsque vous n'ajoutez qu'un seul identifiant unique.** Par exemple, la capture d'écran ci-dessous fera correspondre les entreprises en fonction de leur domaine. L'ID n'est pas forcément nécessaire.
+**La correspondance fonctionne généralement encore mieux lorsque vous n'ajoutez qu'un seul identifiant unique.** Par exemple, la capture d'écran ci-dessous fera correspondre les entreprises en fonction de leur domaine. L'ID n'est pas forcément nécessaire.
</Note>
<img src="/images/user-guide/workflows/upsert_simple_identifier.png" style={{width:'100%'}} />
@@ -116,8 +116,8 @@ Crée un nouvel enregistrement ou met à jour un enregistrement existant en fonc
* Définissez les actions à effectuer sur chaque enregistrement dans la boucle.
<Note>
- - Vous pouvez ajouter plusieurs actions au sein d'un itérateur.
- - Lorsque vous utilisez des branches à l'intérieur d'un itérateur, assurez-vous que la dernière étape de chaque branche revient à l'itérateur pour fermer la boucle.
+- Vous pouvez ajouter plusieurs actions au sein d'un itérateur.
+- Lorsque vous utilisez des branches à l'intérieur d'un itérateur, assurez-vous que la dernière étape de chaque branche revient à l'itérateur pour fermer la boucle.
</Note>
* Accéder aux champs `Current Item`: pour utiliser les champs de l'enregistrement en cours de traitement, cliquez sur l'étape **Iterator**, puis sélectionnez **Current item**. La liste des champs disponibles de cet enregistrement s'affichera et pourra être sélectionnée pour une utilisation dans les actions suivantes.
@@ -135,8 +135,8 @@ Filtre les enregistrements selon des conditions spécifiées, ne laissant passer
* Configurez quels enregistrements doivent passer aux étapes suivantes
<Note>
- 1. **Sortie**: Les nœuds de filtre ne renvoient pas de données — ils agissent comme des portes. Si les conditions sont remplies, le flux de travail continue. Sinon, le flux de travail s'arrête à cette branche.
- 2. L'opérateur `IS` peut être utilisé avec des champs numériques. Il équivaut à `EQUAL`.
+1. **Sortie**: Les nœuds de filtre ne renvoient pas de données — ils agissent comme des portes. Si les conditions sont remplies, le flux de travail continue. Sinon, le flux de travail s'arrête à cette branche.
+2. L'opérateur `IS` peut être utilisé avec des champs numériques. Il équivaut à `EQUAL`.
</Note>
### Délai
@@ -167,7 +167,7 @@ Met en pause l'exécution du flux de travail pendant une durée spécifiée ou j
* Planifier des actions pendant les heures ouvrées
<Note>
- La date planifiée ne peut pas être dans le passé. Si un champ de date d'une étape précédente est utilisé et que la date est déjà passée, le flux de travail échouera.
+La date planifiée ne peut pas être dans le passé. Si un champ de date d'une étape précédente est utilisé et que la date est déjà passée, le flux de travail échouera.
</Note>
**Limites et crédits**:
@@ -190,7 +190,7 @@ Ne convient pas aux newsletters (qui nécessitent un formatage plus riche) ni au
* Sélectionnez le compte e-mail de l'expéditeur
<Note>
- Vous pouvez uniquement envoyer des e-mails à partir de boîtes aux lettres synchronisées avec votre propre compte Twenty. L'envoi depuis les boîtes aux lettres d'autres membres de l'équipe (par ex., l'e-mail du propriétaire du compte) est sur la feuille de route.
+Vous pouvez uniquement envoyer des e-mails à partir de boîtes aux lettres synchronisées avec votre propre compte Twenty. L'envoi depuis les boîtes aux lettres d'autres membres de l'équipe (par ex., l'e-mail du propriétaire du compte) est sur la feuille de route.
</Note>
Pour toutes les étapes suivantes, vous pouvez référencer des variables des étapes précédentes pour la personnalisation.
@@ -198,14 +198,14 @@ Pour toutes les étapes suivantes, vous pouvez référencer des variables des é
* Entrez l'adresse e-mail du destinataire.
<Note>
- Un seul destinataire est possible pour le moment.
+Un seul destinataire est possible pour le moment.
</Note>
* Définissez la ligne d'objet.
* Rédigez le corps du message. Vous pouvez formater des liens, créer des listes numérotées, des listes à puces, ajouter des pièces jointes.
<Note>
- L'ajout de signatures HTML n'est pas possible pour le moment.
+L'ajout de signatures HTML n'est pas possible pour le moment.
</Note>
### Formulaire
@@ -213,7 +213,7 @@ Pour toutes les étapes suivantes, vous pouvez référencer des variables des é
Affiche un formulaire lors de l'exécution du flux de travail pour recueillir les saisies de l'utilisateur. Les réponses peuvent ensuite être utilisées dans les étapes suivantes pour créer des enregistrements, envoyer des e-mails ou exécuter toute autre action selon la saisie.
<Warning>
- **Les formulaires sont conçus uniquement pour les déclencheurs manuels**. Pour les flux de travail avec d'autres déclencheurs (Enregistrement créé, mis à jour, etc.), les formulaires ne sont accessibles que via l'interface de l'exécution de flux de travail, ce qui n'est pas l'expérience utilisateur attendue. Un centre de notifications sera lancé en 2026 pour supporter correctement les formulaires dans les flux de travail automatisés.
+**Les formulaires sont conçus uniquement pour les déclencheurs manuels**. Pour les flux de travail avec d'autres déclencheurs (Enregistrement créé, mis à jour, etc.), les formulaires ne sont accessibles que via l'interface de l'exécution de flux de travail, ce qui n'est pas l'expérience utilisateur attendue. Un centre de notifications sera lancé en 2026 pour supporter correctement les formulaires dans les flux de travail automatisés.
</Warning>
**Configuration**:
@@ -234,7 +234,7 @@ Affiche un formulaire lors de l'exécution du flux de travail pour recueillir le
* Remplissez le formulaire affiché dans le panneau latéral et cliquez sur `Submit`.
<Note>
- Les champs ne peuvent pas être rendus obligatoires.
+Les champs ne peuvent pas être rendus obligatoires.
</Note>
<VimeoEmbed videoId="1147277989" title="Démonstration vidéo" />
@@ -256,15 +256,15 @@ Exécute du JavaScript personnalisé dans votre flux de travail.
* Testez le code directement dans l'étape
<Note>
- Si vous devez utiliser des clés d'API externes dans votre code, vous devez les saisir directement dans le corps de la fonction. Vous ne pouvez pas configurer des clés d'API ailleurs et les référencer dans la fonction logique.
+Si vous devez utiliser des clés d'API externes dans votre code, vous devez les saisir directement dans le corps de la fonction. Vous ne pouvez pas configurer des clés d'API ailleurs et les référencer dans la fonction logique.
</Note>
<Tip>
- **Vous travaillez avec des tableaux ?** Les tableaux provenant de systèmes externes ou d'étapes précédentes peuvent arriver sous forme de chaînes de caractères. Voir [Gérer les tableaux dans les actions Code](/l/fr/user-guide/workflows/how-tos/advanced-configurations/handle-arrays-in-code-actions) pour la solution.
+**Vous travaillez avec des tableaux ?** Les tableaux provenant de systèmes externes ou d'étapes précédentes peuvent arriver sous forme de chaînes de caractères. Voir [Gérer les tableaux dans les actions Code](/l/fr/user-guide/workflows/how-tos/advanced-configurations/handle-arrays-in-code-actions) pour la solution.
</Tip>
<Tip>
- Cliquez sur l'icône carrée en haut à droite de l'éditeur de code pour l'afficher en plein écran — utile car la largeur par défaut de l'éditeur est limitée.
+Cliquez sur l'icône carrée en haut à droite de l'éditeur de code pour l'afficher en plein écran — utile car la largeur par défaut de l'éditeur est limitée.
</Tip>
### Requête HTTP
@@ -303,9 +303,9 @@ Exécute un agent IA au sein de votre flux de travail pour effectuer des tâches
**Sortie**: La réponse de l'agent IA est disponible pour une utilisation dans les étapes suivantes. Si l'agent a un schéma de sortie structuré, la réponse suivra ce format.
<Note>
- Les actions d'agent IA consomment des crédits de flux de travail en fonction du modèle d'IA utilisé. Voir [Crédits de flux de travail](/l/fr/user-guide/workflows/capabilities/workflow-credits) pour plus de détails.
+Les actions d'agent IA consomment des crédits de flux de travail en fonction du modèle d'IA utilisé. Voir [Crédits de flux de travail](/l/fr/user-guide/workflows/capabilities/workflow-credits) pour plus de détails.
</Note>
<Note>
- Les agents IA respectent les autorisations basées sur les rôles. Vous pouvez attribuer des rôles spécifiques aux agents dans **Paramètres → Rôles** pour contrôler les données auxquelles ils peuvent accéder. Voir [Autorisations](/l/fr/user-guide/permissions-access/capabilities/permissions) pour plus de détails.
+Les agents IA respectent les autorisations basées sur les rôles. Vous pouvez attribuer des rôles spécifiques aux agents dans **Paramètres → Membres → Rôles** pour contrôler les données auxquelles ils peuvent accéder. Voir [Autorisations](/l/fr/user-guide/permissions-access/capabilities/permissions) pour plus de détails.
</Note>
diff --git a/packages/twenty-docs/l/fr/user-guide/workflows/capabilities/workflow-branches.mdx b/packages/twenty-docs/l/fr/user-guide/workflows/capabilities/workflow-branches.mdx
index ead12adad67..87982e141a9 100644
--- a/packages/twenty-docs/l/fr/user-guide/workflows/capabilities/workflow-branches.mdx
+++ b/packages/twenty-docs/l/fr/user-guide/workflows/capabilities/workflow-branches.mdx
@@ -1,5 +1,5 @@
---
-title: Branches de flux de travail},{
+title: Branches de flux de travail
description: Créez des chemins parallèles et une logique conditionnelle dans vos flux de travail.
---
@@ -22,7 +22,7 @@ Lorsque vous créez plusieurs connexions à partir d’un seul nœud, chaque che
5. Répétez pour ajouter d’autres branches à partir du même nœud
<Note>
- Chaque branche est indépendante. L’ajout d’une branche n’affecte pas les autres chemins existants à partir de ce nœud.
+Chaque branche est indépendante. L’ajout d’une branche n’affecte pas les autres chemins existants à partir de ce nœud.
</Note>
### Disposition visuelle
@@ -57,7 +57,7 @@ Seules les branches pour lesquelles la condition du filtre est remplie poursuivr
Lors de la création de votre flux de travail, vous pouvez connecter manuellement plusieurs branches à la même action en aval. Il suffit de faire glisser des flèches depuis la fin de chaque branche vers un nœud commun.
<Note>
- Bien que vous puissiez utiliser un nœud [Delay](/l/fr/user-guide/workflows/capabilities/workflow-actions#delay) pour mettre l’exécution en pause, il n’est pas actuellement configurable pour attendre "jusqu’à ce qu’une autre branche se termine".
+Bien que vous puissiez utiliser un nœud [Delay](/l/fr/user-guide/workflows/capabilities/workflow-actions#delay) pour mettre l’exécution en pause, il n’est pas actuellement configurable pour attendre "jusqu’à ce qu’une autre branche se termine".
</Note>
## Contenus associés
diff --git a/packages/twenty-docs/l/fr/user-guide/workflows/capabilities/workflow-credits.mdx b/packages/twenty-docs/l/fr/user-guide/workflows/capabilities/workflow-credits.mdx
index e5d9caf78d0..78e820acec5 100644
--- a/packages/twenty-docs/l/fr/user-guide/workflows/capabilities/workflow-credits.mdx
+++ b/packages/twenty-docs/l/fr/user-guide/workflows/capabilities/workflow-credits.mdx
@@ -9,13 +9,13 @@ Les crédits de flux de travail alimentent vos automatisations dans Twenty. Comp
Les crédits de flux de travail sont alloués en fonction de votre cycle de facturation, et non de votre niveau de forfait :
-| Cycle de facturation | Crédits |
-| ---------------------- | ------------------------------ |
-| **Abonnement mensuel** | 5 millions de crédits par mois |
-| **Abonnement annuel** | 50 millions de crédits par an |
+| Cycle de facturation | Crédits |
+| ---------------------- | ------------------ |
+| **Abonnement mensuel** | 5 crédits par mois |
+| **Abonnement annuel** | 50 crédits par an |
<Note>
- 5 millions de crédits mensuels suffisent largement pour les automatisations standard. La plupart des équipes ne dépasseront pas cette limite avec une utilisation typique des flux de travail. Des crédits supplémentaires sont principalement nécessaires pour les actions de Code avancées et les flux de travail alimentés par l'IA.
+5 crédits mensuels suffisent largement pour les automatisations standard. La plupart des équipes ne dépasseront pas cette limite avec une utilisation typique des flux de travail. Des crédits supplémentaires sont principalement nécessaires pour les actions de Code avancées et les flux de travail alimentés par l'IA.
</Note>
## Comment fonctionne la consommation de crédits
diff --git a/packages/twenty-docs/l/fr/user-guide/workflows/capabilities/workflow-triggers.mdx b/packages/twenty-docs/l/fr/user-guide/workflows/capabilities/workflow-triggers.mdx
index 25e1ade25fb..4481f061fc4 100644
--- a/packages/twenty-docs/l/fr/user-guide/workflows/capabilities/workflow-triggers.mdx
+++ b/packages/twenty-docs/l/fr/user-guide/workflows/capabilities/workflow-triggers.mdx
@@ -10,14 +10,13 @@ Les flux de travail commencent toujours par un seul déclencheur qui définit qu
<img src="/images/user-guide/workflows/workflow_triggers.png" style={{width:'100%'}} />
<Tip>
- **Des objets avancés sont pris en charge !** Au-delà des objets CRM standard (Personnes, Entreprises, Opportunités), vous pouvez aussi déclencher des flux de travail et effectuer des actions sur :
+**Des objets avancés sont pris en charge !** Au-delà des objets CRM standard (Personnes, Entreprises, Opportunités), vous pouvez aussi déclencher des flux de travail et effectuer des actions sur :
+* Membres de l'espace de travail
+* Événements de calendrier
+* Messages (e-mails)
+* Tâches, notes et de nombreux autres objets système
- * Membres de l'espace de travail
- * Événements de calendrier
- * Messages (e-mails)
- * Tâches, notes et de nombreux autres objets système
-
- Cela permet des automatisations puissantes, comme avertir les membres de l'équipe lorsque des événements de calendrier sont créés, ou traiter automatiquement les e-mails entrants.
+Cela permet des automatisations puissantes, comme avertir les membres de l'équipe lorsque des événements de calendrier sont créés, ou traiter automatiquement les e-mails entrants.
</Tip>
## Un enregistrement est créé
@@ -27,9 +26,9 @@ Démarre le flux de travail lorsqu'un nouvel enregistrement est créé dans un o
**Configuration**: Sélectionnez le type d'objet à surveiller pour les nouveaux enregistrements.
<Note>
- * Ce déclencheur est idéal pour les enregistrements créés via csv, la synchronisation de la boîte aux lettres et du calendrier, ou l'API.
- * **Il n'est pas recommandé pour les enregistrements créés manuellement** : avec ce déclencheur, les flux de travail démarrent dès que l'enregistrement est créé. Comme l'interface Twenty propose l'enregistrement automatique à la volée (il n'y a pas de mode édition suivi d'une validation pour enregistrer les enregistrements), le flux de travail sera déclenché avant que l'utilisateur ne renseigne tous les champs.
- Pour déclencher ce flux de travail sur des enregistrements créés manuellement, il est recommandé d'utiliser plutôt le déclencheur `Record is created or updated`.
+* Ce déclencheur est idéal pour les enregistrements créés via csv, la synchronisation de la boîte aux lettres et du calendrier, ou l'API.
+* **Il n'est pas recommandé pour les enregistrements créés manuellement** : avec ce déclencheur, les flux de travail démarrent dès que l'enregistrement est créé. Comme l'interface Twenty propose l'enregistrement automatique à la volée (il n'y a pas de mode édition suivi d'une validation pour enregistrer les enregistrements), le flux de travail sera déclenché avant que l'utilisateur ne renseigne tous les champs.
+ Pour déclencher ce flux de travail sur des enregistrements créés manuellement, il est recommandé d'utiliser plutôt le déclencheur `Record is created or updated`.
</Note>
## Un enregistrement est mis à jour
@@ -82,7 +81,7 @@ Choisissez comment le flux de travail doit gérer la sélection des enregistreme
* **En masse** : Les enregistrements sélectionnés seront passés à votre flux de travail. Cela est configuré pour un objet donné. Plusieurs enregistrements peuvent être sélectionnés avant de déclencher le flux de travail. Le flux de travail s'exécutera une fois, en fournissant la liste entière des enregistrements comme entrée. Cela signifie que le flux de travail doit contenir une [Action d'itération](/l/fr/user-guide/workflows/capabilities/workflow-actions#iterator).
<Note>
- C'est plus avancé, et idéal pour les personnes qui souhaitent optimiser le nombre d'exécutions de flux de travail.
+C'est plus avancé, et idéal pour les personnes qui souhaitent optimiser le nombre d'exécutions de flux de travail.
</Note>
<img src="/images/user-guide/workflows/manual_trigger.png" style={{width:'100%'}} />
@@ -108,7 +107,7 @@ Démarre le flux de travail sur une base récurrente que vous définissez.
* Entrez une valeur ou utilisez des expressions cron personnalisées pour une planification avancée
<Note>
- **Fuseau horaire** : Les flux de travail planifiés s'exécutent en **UTC**. Lors de la définition des heures pour les plannings quotidiens, convertissez votre heure locale en UTC.
+**Fuseau horaire** : Les flux de travail planifiés s'exécutent en **UTC**. Lors de la définition des heures pour les plannings quotidiens, convertissez votre heure locale en UTC.
</Note>
## Déclencheur externe : Webhook
diff --git a/packages/twenty-docs/l/fr/user-guide/workflows/how-tos/advanced-configurations/handle-arrays-in-code-actions.mdx b/packages/twenty-docs/l/fr/user-guide/workflows/how-tos/advanced-configurations/handle-arrays-in-code-actions.mdx
index 6ac885e66e5..58c7758765d 100644
--- a/packages/twenty-docs/l/fr/user-guide/workflows/how-tos/advanced-configurations/handle-arrays-in-code-actions.mdx
+++ b/packages/twenty-docs/l/fr/user-guide/workflows/how-tos/advanced-configurations/handle-arrays-in-code-actions.mdx
@@ -74,9 +74,9 @@ export const main = async (params: {
Le nœud Code renvoie un objet structuré au lieu d'un tableau. Dans les étapes suivantes, vous pouvez maintenant sélectionner des champs individuels comme `answer.firstname` et `answer.name` à partir du sélecteur de variables.
<Note>
- Nous travaillons activement à faciliter la gestion des tableaux dans de futures mises à jour.
+Nous travaillons activement à faciliter la gestion des tableaux dans de futures mises à jour.
</Note>
<Tip>
- Cliquez sur l'icône carrée en haut à droite de l'éditeur de code pour l'afficher en plein écran — utile car la largeur par défaut de l'éditeur est limitée.
+Cliquez sur l'icône carrée en haut à droite de l'éditeur de code pour l'afficher en plein écran — utile car la largeur par défaut de l'éditeur est limitée.
</Tip>
diff --git a/packages/twenty-docs/l/fr/user-guide/workflows/how-tos/connect-to-other-tools/bring-product-data-in-twenty.mdx b/packages/twenty-docs/l/fr/user-guide/workflows/how-tos/connect-to-other-tools/bring-product-data-in-twenty.mdx
index 855574529ec..b3ed90d3d91 100644
--- a/packages/twenty-docs/l/fr/user-guide/workflows/how-tos/connect-to-other-tools/bring-product-data-in-twenty.mdx
+++ b/packages/twenty-docs/l/fr/user-guide/workflows/how-tos/connect-to-other-tools/bring-product-data-in-twenty.mdx
@@ -54,7 +54,7 @@ export const main = async () => {
```
<Tip>
- Filtrez par `updated_at >= last X minutes` pour ne récupérer que les enregistrements récemment modifiés. Cela rend la synchronisation plus efficace.
+Filtrez par `updated_at >= last X minutes` pour ne récupérer que les enregistrements récemment modifiés. Cela rend la synchronisation plus efficace.
</Tip>
## Étape 3 : Formater les données (facultatif)
@@ -163,7 +163,7 @@ Cela parcourt chaque produit du tableau.
| **Prix** | `{{iterator.item.price}}` |
<Tip>
- Utilisez **Upsert** (mettre à jour ou créer) au lieu de construire des branches distinctes pour la création et la mise à jour. C'est plus rapide à construire et plus facile à déboguer.
+Utilisez **Upsert** (mettre à jour ou créer) au lieu de construire des branches distinctes pour la création et la mise à jour. C'est plus rapide à construire et plus facile à déboguer.
</Tip>
## Exemples de cas d'utilisation
diff --git a/packages/twenty-docs/l/fr/user-guide/workflows/how-tos/connect-to-other-tools/bring-typeform-submissions-in-twenty.mdx b/packages/twenty-docs/l/fr/user-guide/workflows/how-tos/connect-to-other-tools/bring-typeform-submissions-in-twenty.mdx
index cb5fd3dfcc1..0bc227cc29a 100644
--- a/packages/twenty-docs/l/fr/user-guide/workflows/how-tos/connect-to-other-tools/bring-typeform-submissions-in-twenty.mdx
+++ b/packages/twenty-docs/l/fr/user-guide/workflows/how-tos/connect-to-other-tools/bring-typeform-submissions-in-twenty.mdx
@@ -103,7 +103,7 @@ export const main = async (params: {
Dans les étapes suivantes, vous pouvez sélectionner `contact.firstName`, `contact.email`, etc. à partir du sélecteur de variables.
<Tip>
- Pour plus de détails sur la gestion des tableaux dans les actions Code, voir [Gérer les tableaux dans les actions Code](/l/fr/user-guide/workflows/how-tos/advanced-configurations/handle-arrays-in-code-actions).
+Pour plus de détails sur la gestion des tableaux dans les actions Code, voir [Gérer les tableaux dans les actions Code](/l/fr/user-guide/workflows/how-tos/advanced-configurations/handle-arrays-in-code-actions).
</Tip>
### Étape 5 : Créer l'enregistrement
diff --git a/packages/twenty-docs/l/fr/user-guide/workflows/how-tos/connect-to-other-tools/generate-pdf-from-twenty.mdx b/packages/twenty-docs/l/fr/user-guide/workflows/how-tos/connect-to-other-tools/generate-pdf-from-twenty.mdx
index 28ffeb63540..e4235a193f5 100644
--- a/packages/twenty-docs/l/fr/user-guide/workflows/how-tos/connect-to-other-tools/generate-pdf-from-twenty.mdx
+++ b/packages/twenty-docs/l/fr/user-guide/workflows/how-tos/connect-to-other-tools/generate-pdf-from-twenty.mdx
@@ -29,7 +29,7 @@ Avant de configurer le flux de travail :
3. Choisissez l'objet auquel vous souhaitez joindre des PDF (par exemple, **Entreprise** ou **Opportunité**)
<Tip>
- Avec un déclencheur manuel, les utilisateurs peuvent exécuter ce flux de travail à l'aide d'un bouton qui apparaît en haut à droite une fois un enregistrement sélectionné, afin de générer et de joindre un PDF.
+Avec un déclencheur manuel, les utilisateurs peuvent exécuter ce flux de travail à l'aide d'un bouton qui apparaît en haut à droite une fois un enregistrement sélectionné, afin de générer et de joindre un PDF.
</Tip>
### Étape 2 : Ajouter une fonction logique
@@ -45,7 +45,7 @@ Avant de configurer le flux de travail :
| `companyId` | `{{trigger.object.id}}` |
<Note>
- Si vous l'attachez à un objet différent (Personne, Opportunité, etc.), renommez le paramètre en conséquence (par exemple, `personId`, `opportunityId`) et mettez à jour la fonction logique.
+Si vous l'attachez à un objet différent (Personne, Opportunité, etc.), renommez le paramètre en conséquence (par exemple, `personId`, `opportunityId`) et mettez à jour la fonction logique.
</Note>
#### Code de la fonction logique
@@ -55,11 +55,12 @@ export const main = async (
params: { companyId: string },
) => {
const { companyId } = params;
-
- // Replace with your Twenty GraphQL endpoint
+ // Replace with your Twenty GraphQL endpoints (/metadata for metadata and files or /graphql for your records)
// Cloud: https://api.twenty.com/graphql
// Self-hosted: https://your-domain.com/graphql
- const graphqlEndpoint = 'https://api.twenty.com/graphql';
+
+ const metadataGraphqlEndpoint = 'https://api.twenty.com/metadata';
+ const dataGraphqlEndpoint = 'https://api.twenty.com/graphql';
// Replace with your API key from Settings → APIs
const authToken = 'YOUR_API_KEY';
@@ -79,11 +80,40 @@ export const main = async (
const pdfBlob = await pdfResponse.blob();
const pdfFile = new File([pdfBlob], filename, { type: 'application/pdf' });
- // Step 2: Upload the file via GraphQL multipart upload
+ const fieldMetadataIdQuery = `
+ query FindUploadFileFieldMetadataId {
+ objects {
+ edges {
+ node {
+ nameSingular
+ fieldsList {
+ id
+ name
+ }
+ }
+ }
+ }
+ }
+ `;
+
+ // Step 2: Find a fieldMetadataId of "Attachment file" field in Attachments object with GraphQL API
+ const response = await fetch(metadataGraphqlEndpoint, {
+ method: 'POST',
+ headers: {
+ Authorization: `Bearer ${authToken}`
+ },
+ body: {
+ query: fieldMetadataIdQuery,
+ }
+ });
+ const result = await response.json();
+ const uploadFileFieldMetadataId = result.data.objects.edges.find(object => object.node.nameSingular === 'attachment').node.fieldsList.find(field => field.name === 'file').id;
+
+ // Step 3: Upload the file via GraphQL multipart upload
const uploadMutation = `
- mutation UploadFile($file: Upload!, $fileFolder: FileFolder) {
- uploadFile(file: $file, fileFolder: $fileFolder) {
- path
+ mutation UploadFilesFieldFile($file: Upload!, $fieldMetadataId: String!) {
+ uploadFilesFieldFile(file: $file, fieldMetadataId: $fieldMetadataId) {
+ id
}
}
`;
@@ -91,12 +121,12 @@ export const main = async (
const uploadForm = new FormData();
uploadForm.append('operations', JSON.stringify({
query: uploadMutation,
- variables: { file: null, fileFolder: 'Attachment' },
+ variables: { file: null, fieldMetadataId: uploadFileFieldMetadataId },
}));
uploadForm.append('map', JSON.stringify({ '0': ['variables.file'] }));
uploadForm.append('0', pdfFile);
- const uploadResponse = await fetch(graphqlEndpoint, {
+ const uploadResponse = await fetch(metadataGraphqlEndpoint, {
method: 'POST',
headers: { Authorization: `Bearer ${authToken}` },
body: uploadForm,
@@ -108,15 +138,15 @@ export const main = async (
throw new Error(`Upload failed: ${uploadResult.errors[0].message}`);
}
- const filePath = uploadResult.data?.uploadFile?.path;
+ const fileId = uploadResult.data?.uploadFilesFieldFile?.id;
- if (!filePath) {
- throw new Error('No file path returned from upload');
+ if (!fileId) {
+ throw new Error('No file id returned from upload');
}
- // Step 3: Create the attachment linked to the company
+ // Step 4: Create the attachment linked to the company
const attachmentMutation = `
- mutation CreateAttachment($data: AttachmentCreateInput!) {
+ mutation CreateOneAttachment($data: AttachmentCreateInput!) {
createAttachment(data: $data) {
id
name
@@ -124,7 +154,7 @@ export const main = async (
}
`;
- const attachmentResponse = await fetch(graphqlEndpoint, {
+ const attachmentResponse = await fetch(dataGraphqlEndpoint, {
method: 'POST',
headers: {
Authorization: `Bearer ${authToken}`,
@@ -135,8 +165,13 @@ export const main = async (
variables: {
data: {
name: filename,
- fullPath: filePath,
- companyId,
+ targetCompanyId: companyId,
+ file: [
+ {
+ fileId: fileId,
+ label: filename
+ }
+ ]
},
},
}),
@@ -156,14 +191,14 @@ export const main = async (
#### Pour joindre à un objet différent
-Remplacez `companyId` par le champ approprié :
+Remplacez `targetCompanyId` par le champ approprié :
-| Objet | Nom du champ |
-| ------------------ | -------------------- |
-| Entreprise | `companyId` |
-| Personne | `personId` |
-| Opportunité | `opportunityId` |
-| Objet personnalisé | `yourCustomObjectId` |
+| Objet | Nom du champ |
+| ------------------ | -------------------------- |
+| Entreprise | `targetCompanyId` |
+| Personne | `targetPersonId` |
+| Opportunité | `targetOpportunityId` |
+| Objet personnalisé | `targetYourCustomObjectId` |
Mettez à jour à la fois le paramètre de la fonction et l'objet `variables.data` dans la mutation de pièce jointe.
diff --git a/packages/twenty-docs/l/fr/user-guide/workflows/how-tos/connect-to-other-tools/generate-quote-or-invoice-from-twenty.mdx b/packages/twenty-docs/l/fr/user-guide/workflows/how-tos/connect-to-other-tools/generate-quote-or-invoice-from-twenty.mdx
index db28aaedd4a..7a530716377 100644
--- a/packages/twenty-docs/l/fr/user-guide/workflows/how-tos/connect-to-other-tools/generate-quote-or-invoice-from-twenty.mdx
+++ b/packages/twenty-docs/l/fr/user-guide/workflows/how-tos/connect-to-other-tools/generate-quote-or-invoice-from-twenty.mdx
@@ -30,7 +30,7 @@ Ajoutez une action **Filtre** pour ne continuer que lorsque l'affaire est gagné
| **Valeur** | `CLOSED_WON` (ou le nom de votre étape) |
<Tip>
- Le déclencheur se déclenche lors de toute mise à jour de l'Opportunité. Le Filtre garantit que le flux de travail ne continue que lorsque l'étape passe à Closed Won.
+Le déclencheur se déclenche lors de toute mise à jour de l'Opportunité. Le Filtre garantit que le flux de travail ne continue que lorsque l'étape passe à Closed Won.
</Tip>
## Étape 3 : Obtenir les détails de l'Entreprise
diff --git a/packages/twenty-docs/l/fr/user-guide/workflows/how-tos/connect-to-other-tools/set-up-a-webhook-trigger.mdx b/packages/twenty-docs/l/fr/user-guide/workflows/how-tos/connect-to-other-tools/set-up-a-webhook-trigger.mdx
index 653db239f67..6a823ca8191 100644
--- a/packages/twenty-docs/l/fr/user-guide/workflows/how-tos/connect-to-other-tools/set-up-a-webhook-trigger.mdx
+++ b/packages/twenty-docs/l/fr/user-guide/workflows/how-tos/connect-to-other-tools/set-up-a-webhook-trigger.mdx
@@ -161,7 +161,7 @@ export const main = async (params: { items: any }) => {
Vous pouvez maintenant sélectionner `product.name` et `product.qty` individuellement dans les étapes suivantes.
<Tip>
- Pour plus de détails sur la gestion des tableaux, voir [Gérer les tableaux dans les actions Code](/l/fr/user-guide/workflows/how-tos/advanced-configurations/handle-arrays-in-code-actions).
+Pour plus de détails sur la gestion des tableaux, voir [Gérer les tableaux dans les actions Code](/l/fr/user-guide/workflows/how-tos/advanced-configurations/handle-arrays-in-code-actions).
</Tip>
## Connexes
diff --git a/packages/twenty-docs/l/fr/user-guide/workflows/how-tos/crm-automations/auto-reply-to-inbound-emails.mdx b/packages/twenty-docs/l/fr/user-guide/workflows/how-tos/crm-automations/auto-reply-to-inbound-emails.mdx
new file mode 100644
index 00000000000..e182581ebc5
--- /dev/null
+++ b/packages/twenty-docs/l/fr/user-guide/workflows/how-tos/crm-automations/auto-reply-to-inbound-emails.mdx
@@ -0,0 +1,121 @@
+---
+title: Réponse automatique aux emails entrants
+description: Créez un flux de travail qui utilise l'IA pour trier les emails entrants et envoyer automatiquement des réponses en fil de discussion.
+---
+
+Répondez aux emails entrants en quelques secondes — et non en heures. Ce flux de travail utilise un agent IA pour filtrer le bruit (newsletters, spam, réponses automatiques) et rédiger une réponse personnalisée aux vrais messages, puis l'envoie comme réponse en fil de discussion dans la conversation d'origine.
+
+## Comment fonctionne le fil de discussion des emails
+
+Chaque email comporte un en-tête caché `Message-ID` — une empreinte unique attribuée par le serveur de messagerie de l'expéditeur. Lorsque vous répondez à un e-mail, votre client de messagerie définit un en-tête `In-Reply-To` faisant référence à cette empreinte. C’est ainsi que Gmail, Outlook et tous les autres clients regroupent les messages en fils de discussion.
+
+Dans Twenty, cette empreinte est stockée en tant que `headerMessageId` sur l’objet Message. Votre flux de travail la récupère et la transmet au champ In-Reply-To de l’action Send Email.
+
+## Création du flux de travail
+
+### Étape 1 : Créer un nouveau flux de travail
+
+Accédez à **Settings -> Workflows** et cliquez sur **+ New Workflow**.
+
+### Étape 2 : Déclencher sur les messages entrants
+
+Choisissez **When a Record is Created** puis **Messages**.
+
+Chaque fois qu’un e-mail arrive dans Twenty, ceci se déclenche.
+
+<img src="/images/user-guide/workflows/auto-reply/workflow-overview.png" style={{width:'100%'}} />
+
+### Étape 3 : Identifier l’expéditeur
+
+Ajoutez une action **Search Records**.
+
+L’adresse de l’expéditeur n’est pas sur le message lui-même — elle se trouve sur l’enregistrement Message Participant associé.
+
+| Champ | Valeur |
+| ---------- | -------------------------------- |
+| **Objet** | Participants au message |
+| **Filtre** | Message **est** `{{trigger.id}}` |
+| **Filtre** | Rôle **est** From |
+| **Limite** | 1 |
+
+Vous obtenez ainsi l’adresse e-mail de l’expéditeur dans `handle` et son nom dans `displayName`.
+
+<img src="/images/user-guide/workflows/auto-reply/find-sender.png" style={{width:'100%'}} />
+
+### Étape 4 : Triage par IA et brouillon de réponse
+
+Ajoutez une action **AI Agent**. Cette seule étape fait deux choses : elle détermine si l’e-mail mérite une réponse et, le cas échéant, en rédige une.
+
+Utilisez une invite comme :
+
+```
+You are an email triage assistant for a sales team. Read the following
+inbound email and decide if it deserves a reply.
+
+Subject: {{trigger.subject}}
+Body: {{trigger.text}}
+From: {{Find Sender.first.displayName}} ({{Find Sender.first.handle}})
+
+If this email is spam, a newsletter, an automated notification, or
+otherwise does not need a human reply, respond with exactly: SKIP
+
+Otherwise, write a short, professional reply (3-4 sentences max) that:
+- Acknowledges their specific message
+- Lets them know someone from the team will follow up shortly
+- Is warm but not overly casual
+
+Respond with only the reply text, no subject line or greeting prefix.
+```
+
+L’action AI Agent produit sa réponse dans un champ `response` auquel les étapes suivantes peuvent se référer.
+
+<img src="/images/user-guide/workflows/auto-reply/ai-triage.png" style={{width:'100%'}} />
+
+### Étape 5 : Bifurquer selon la décision de l’IA
+
+Ajoutez une action **If/Else** pour vérifier si l’IA a décidé de répondre ou d’ignorer.
+
+| Champ | Valeur |
+| ------------- | ---------------------------------------------- |
+| **Condition** | AI Agent `response` **ne contient pas** `SKIP` |
+| **Si vrai** | Continuer vers Send Email |
+| **Sinon** | Ne rien faire (le flux de travail se termine) |
+
+Les spams, les newsletters et les messages générés automatiquement sont ignorés. Tout le reste passe à l’étape suivante.
+
+<img src="/images/user-guide/workflows/auto-reply/should-reply.png" style={{width:'100%'}} />
+
+### Étape 6 : Envoyer une réponse dans le fil de discussion
+
+Ajoutez une action **Envoyer un e-mail** sur la branche « si vrai ». Cliquez sur **Options avancées**, puis sur **Ajouter In-Reply-To**.
+
+| Champ | Valeur |
+| -------------------- | -------------------------------------- |
+| **À** | `{{Find Sender.first.handle}}` |
+| **Objet** | `Re: {{trigger.subject}}` |
+| **Corps du message** | `{{AI Triage & Draft Reply.response}}` |
+| **In-Reply-To** | `{{trigger.headerMessageId}}` |
+
+C’est le champ In-Reply-To qui fait de ce message une réponse plutôt qu’une nouvelle conversation. Le destinataire le voit regroupé sous l’e-mail d’origine dans Gmail, Outlook ou tout autre client.
+
+<img src="/images/user-guide/workflows/auto-reply/send-email.png" style={{width:'100%'}} />
+
+<Tip>
+**In-Reply-To** attend un `message.headerMessageId` provenant du déclencheur — c’est l’empreinte unique de l’e-mail, pas une adresse de destinataire. Si vous le laissez vide, l’e-mail sera quand même envoyé, simplement comme un message autonome.
+</Tip>
+
+<Warning>
+Gmail utilise l’objet pour regrouper les messages en fils de discussion. L’objet **doit** commencer par `Re:` (y compris les deux-points et l’espace) pour que Gmail affiche la réponse dans le fil d’origine. Sans cela, la réponse apparaîtra comme une conversation distincte — même si l’en-tête In-Reply-To est correctement défini.
+</Warning>
+
+### Étape 7 : Tester et activer
+
+Cliquez sur **Test**, puis vérifiez votre client de messagerie. La réponse devrait apparaître imbriquée sous le message d’origine.
+
+Activez lorsque vous en êtes satisfait.
+
+## Idées pour aller plus loin
+
+* **Ne répondre qu’aux VIP** — ajoutez une branche qui vérifie le domaine de l’expéditeur ou s’il existe en tant que Contact dans Twenty
+* **Orienter selon l’intention** — utilisez des invites AI Agent distinctes pour traiter différemment les demandes commerciales et les demandes d’assistance
+* **Enrichir avant de répondre** — ajoutez une étape Search Records pour intégrer l’entreprise de l’expéditeur ou l’historique d’opportunités dans l’invite d’IA afin d’obtenir des réponses plus personnalisées
diff --git a/packages/twenty-docs/l/fr/user-guide/workflows/how-tos/crm-automations/display-number-of-emails-received.mdx b/packages/twenty-docs/l/fr/user-guide/workflows/how-tos/crm-automations/display-number-of-emails-received.mdx
index 9b978a6416a..2965f1c4a5e 100644
--- a/packages/twenty-docs/l/fr/user-guide/workflows/how-tos/crm-automations/display-number-of-emails-received.mdx
+++ b/packages/twenty-docs/l/fr/user-guide/workflows/how-tos/crm-automations/display-number-of-emails-received.mdx
@@ -30,7 +30,7 @@ Avant de configurer ce workflow, créez un champ personnalisé sur l'objet **Peo
3. Choisissez **Message Participants** (disponible sous Advanced objects)
<Note>
- Un Message Participant est une combinaison d'un ID de message et d'un ID de personne, créant un enregistrement unique par message. Ceci est plus facile à suivre que les Messages directement, car nous pouvons accéder au champ `handle`, qui contient l'adresse e-mail de l'expéditeur (ou du destinataire).
+Un Message Participant est une combinaison d'un ID de message et d'un ID de personne, créant un enregistrement unique par message. Ceci est plus facile à suivre que les Messages directement, car nous pouvons accéder au champ `handle`, qui contient l'adresse e-mail de l'expéditeur (ou du destinataire).
</Note>
### Étape 2 : Filtrer sur le rôle
@@ -50,7 +50,7 @@ Cela garantit que vous ne comptez que les messages envoyés par cette personne,
Cela trouve tous les messages provenant de cette adresse e-mail afin d'obtenir le nombre total.
<Note>
- L'action Search Records est limitée à retourner 200 enregistrements maximum. Cependant, comme vous utilisez uniquement la valeur `totalCount` (et non les enregistrements individuels), cette étape renverra le nombre total d'e-mails envoyés par cette personne.
+L'action Search Records est limitée à retourner 200 enregistrements maximum. Cependant, comme vous utilisez uniquement la valeur `totalCount` (et non les enregistrements individuels), cette étape renverra le nombre total d'e-mails envoyés par cette personne.
</Note>
### Étape 4 : Mettre à jour l'enregistrement Person avec une action Create or Update Record
@@ -58,7 +58,7 @@ Cela trouve tous les messages provenant de cette adresse e-mail afin d'obtenir l
1. Ajoutez une action **Créer ou mettre à jour un enregistrement**
<Warning>
- Utilisez **Créer ou mettre à jour un enregistrement** au lieu de **Mettre à jour un enregistrement** ici. Cela vous permet d'identifier la personne par son adresse e-mail (le champ `handle`) plutôt que d'exiger un ID d'enregistrement d'une étape précédente.
+Utilisez **Créer ou mettre à jour un enregistrement** au lieu de **Mettre à jour un enregistrement** ici. Cela vous permet d'identifier la personne par son adresse e-mail (le champ `handle`) plutôt que d'exiger un ID d'enregistrement d'une étape précédente.
</Warning>
2. Sélectionnez **Personnes** comme objet
diff --git a/packages/twenty-docs/l/fr/user-guide/workflows/how-tos/crm-automations/display-related-record-data.mdx b/packages/twenty-docs/l/fr/user-guide/workflows/how-tos/crm-automations/display-related-record-data.mdx
index 814dbc6a3d2..4fc3540cfde 100644
--- a/packages/twenty-docs/l/fr/user-guide/workflows/how-tos/crm-automations/display-related-record-data.mdx
+++ b/packages/twenty-docs/l/fr/user-guide/workflows/how-tos/crm-automations/display-related-record-data.mdx
@@ -95,7 +95,7 @@ Créez les champs de destination dans **Paramètres → Modèle de données →
* Taille de l'entreprise : `{{searchRecords[0].employees}}`
<Note>
- **Limitation concernant les tâches et les notes** : Les relations sur les tâches et les notes sont codées en dur en plusieurs-à-plusieurs et ne sont pas encore disponibles dans les déclencheurs ou actions de workflows. Pour accéder à ces relations, utilisez plutôt l'[API](/l/fr/developers/api).
+**Limitation concernant les tâches et les notes** : Les relations sur les tâches et les notes sont codées en dur en plusieurs-à-plusieurs et ne sont pas encore disponibles dans les déclencheurs ou actions de workflows. Pour accéder à ces relations, utilisez plutôt l'[API](/l/fr/developers/extend/api).
</Note>
## Synchronisation bidirectionnelle
@@ -117,7 +117,7 @@ Créez les champs de destination dans **Paramètres → Modèle de données →
2. **Mettre à jour un enregistrement** : Définir le contact principal de l'entreprise sur cette personne
<Note>
- Soyez prudent avec les synchronisations bidirectionnelles pour éviter les boucles infinies. Utilisez des filtres pour vérifier si la valeur a réellement changé avant la mise à jour.
+Soyez prudent avec les synchronisations bidirectionnelles pour éviter les boucles infinies. Utilisez des filtres pour vérifier si la valeur a réellement changé avant la mise à jour.
</Note>
## Utiliser du code pour des mappages complexes
diff --git a/packages/twenty-docs/l/fr/user-guide/workflows/how-tos/crm-automations/formula-fields.mdx b/packages/twenty-docs/l/fr/user-guide/workflows/how-tos/crm-automations/formula-fields.mdx
index d77cd68c7f1..eb18f1317d2 100644
--- a/packages/twenty-docs/l/fr/user-guide/workflows/how-tos/crm-automations/formula-fields.mdx
+++ b/packages/twenty-docs/l/fr/user-guide/workflows/how-tos/crm-automations/formula-fields.mdx
@@ -16,7 +16,7 @@ Twenty ne prend pas encore en charge les champs de formule natifs (prévu en 202
| **Score de lead** | Points basés sur plusieurs critères |
<Tip>
- Pour un exemple complet de suivi du temps dans les étapes du pipeline, voir [Suivre la durée de présence des opportunités dans chaque étape](/l/fr/user-guide/views-pipelines/how-tos/track-time-in-stage).
+Pour un exemple complet de suivi du temps dans les étapes du pipeline, voir [Suivre la durée de présence des opportunités dans chaque étape](/l/fr/user-guide/views-pipelines/how-tos/track-time-in-stage).
</Tip>
## Formule de base : concaténation
@@ -105,7 +105,7 @@ export const main = async (params) => {
3. **Mettre à jour l'enregistrement** : Définir les jours avant l'échéance sur `{{code.daysUntilDue}}`
<Note>
- Des valeurs négatives indiquent des tâches en retard. Vous pouvez utiliser ce champ pour filtrer ou trier les tâches par urgence.
+Des valeurs négatives indiquent des tâches en retard. Vous pouvez utiliser ce champ pour filtrer ou trier les tâches par urgence.
</Note>
## Formule conditionnelle : score de lead
diff --git a/packages/twenty-docs/l/fr/user-guide/workflows/how-tos/crm-automations/notify-teammates-of-note-to-review.mdx b/packages/twenty-docs/l/fr/user-guide/workflows/how-tos/crm-automations/notify-teammates-of-note-to-review.mdx
index 3adc76e6634..d02db9de0af 100644
--- a/packages/twenty-docs/l/fr/user-guide/workflows/how-tos/crm-automations/notify-teammates-of-note-to-review.mdx
+++ b/packages/twenty-docs/l/fr/user-guide/workflows/how-tos/crm-automations/notify-teammates-of-note-to-review.mdx
@@ -6,7 +6,7 @@ description: Envoyez des notifications par e-mail automatiques lorsque vous assi
import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
<Note>
- **La mention directe des collègues dans les notes n'est pas encore prise en charge.** Cette fonctionnalité est prévue pour le second semestre 2026. En attendant, ce workflow constitue une solution de contournement pratique.
+**La mention directe des collègues dans les notes n'est pas encore prise en charge.** Cette fonctionnalité est prévue pour le second semestre 2026. En attendant, ce workflow constitue une solution de contournement pratique.
</Note>
## Le défi
@@ -22,7 +22,7 @@ Au lieu de mentionner dans le texte de la note, vous pouvez :
3. Un workflow envoie automatiquement un e-mail au relecteur avec un lien vers la note
<Warning>
- **Limitation** : Cette approche permet d'attribuer un seul relecteur par champ. Si vous devez notifier plusieurs personnes, créez des champs de relation supplémentaires (par ex. : Relecteur 1, Relecteur 2). Cela ne s'adaptera pas bien si vous devez mentionner de nombreux collaborateurs à la fois.
+**Limitation** : Cette approche permet d'attribuer un seul relecteur par champ. Si vous devez notifier plusieurs personnes, créez des champs de relation supplémentaires (par ex. : Relecteur 1, Relecteur 2). Cela ne s'adaptera pas bien si vous devez mentionner de nombreux collaborateurs à la fois.
</Warning>
## Configuration pas à pas
@@ -101,7 +101,7 @@ Twenty
```
<Note>
- Remplacez `yourSubDomain` par le sous-domaine réel de votre espace de travail Twenty.
+Remplacez `yourSubDomain` par le sous-domaine réel de votre espace de travail Twenty.
</Note>
#### Tester et activer
diff --git a/packages/twenty-docs/l/fr/user-guide/workflows/how-tos/crm-automations/send-email-alerts-with-tasks-due.mdx b/packages/twenty-docs/l/fr/user-guide/workflows/how-tos/crm-automations/send-email-alerts-with-tasks-due.mdx
index 1d7b8cc58bc..0fd864f2e19 100644
--- a/packages/twenty-docs/l/fr/user-guide/workflows/how-tos/crm-automations/send-email-alerts-with-tasks-due.mdx
+++ b/packages/twenty-docs/l/fr/user-guide/workflows/how-tos/crm-automations/send-email-alerts-with-tasks-due.mdx
@@ -79,7 +79,7 @@ export const main = async (params: {
```
<Note>
- Remplacez `yourSubDomain` par le sous-domaine réel de votre espace de travail Twenty.
+Remplacez `yourSubDomain` par le sous-domaine réel de votre espace de travail Twenty.
</Note>
### Étape 6 : Envoyer un e-mail (dans l'itérateur)
diff --git a/packages/twenty-docs/l/fr/user-guide/workflows/how-tos/need-more-help/workflow-troubleshooting.mdx b/packages/twenty-docs/l/fr/user-guide/workflows/how-tos/need-more-help/workflow-troubleshooting.mdx
index 77850eb8806..3c552d583a7 100644
--- a/packages/twenty-docs/l/fr/user-guide/workflows/how-tos/need-more-help/workflow-troubleshooting.mdx
+++ b/packages/twenty-docs/l/fr/user-guide/workflows/how-tos/need-more-help/workflow-troubleshooting.mdx
@@ -41,7 +41,7 @@ description: Problèmes courants des flux de travail et comment les résoudre.
* Vous obtenez des données complètes plutôt que des valeurs vides
<Tip>
- Si vous souhaitez que le flux de travail ne s'exécute qu'une seule fois par enregistrement, ajoutez une action Filter pour vérifier un champ comme `createdAt equals updatedAt` (première sauvegarde) ou utilisez un champ à case à cocher personnalisé pour suivre si le flux de travail s'est déjà exécuté.
+Si vous souhaitez que le flux de travail ne s'exécute qu'une seule fois par enregistrement, ajoutez une action Filter pour vérifier un champ comme `createdAt equals updatedAt` (première sauvegarde) ou utilisez un champ à case à cocher personnalisé pour suivre si le flux de travail s'est déjà exécuté.
</Tip>
### Actions en échec
diff --git a/packages/twenty-docs/l/fr/user-guide/workflows/how-tos/need-more-help/workflows-faq.mdx b/packages/twenty-docs/l/fr/user-guide/workflows/how-tos/need-more-help/workflows-faq.mdx
index db5d4a4dc07..5657bcdfe2c 100644
--- a/packages/twenty-docs/l/fr/user-guide/workflows/how-tos/need-more-help/workflows-faq.mdx
+++ b/packages/twenty-docs/l/fr/user-guide/workflows/how-tos/need-more-help/workflows-faq.mdx
@@ -4,10 +4,11 @@ description: Foire aux questions sur les flux de travail dans Twenty.
---
<AccordionGroup>
+
<Accordion title="Pourquoi ne puis-je pas activer un flux de travail ?">
Il s'agit probablement d'un problème de permissions. Vous avez besoin d'un accès aux flux de travail pour les créer et les activer.
- **Solution** : Contactez l'administrateur de votre espace de travail pour vous accorder l'accès aux flux de travail dans **Paramètres → Rôles**.
+ **Solution** : Contactez l'administrateur de votre espace de travail pour vous accorder l'accès aux flux de travail dans **Paramètres → Membres → Rôles**.
Si vous ne voyez pas du tout la section des flux de travail dans votre barre latérale, cela confirme qu'il s'agit d'un problème de permissions.
</Accordion>
@@ -27,7 +28,6 @@ description: Foire aux questions sur les flux de travail dans Twenty.
<Accordion title="Quelle est la différence entre les déclencheurs manuels Single, Global et Bulk ?">
| Type | Enregistrements requis | Exécutions de workflows |
| ---- | ---------------------- | ----------------------- |
-
\| **Global** | Aucun | Une fois, sans saisie d'enregistrement |
\| **Single** | Un ou plusieurs sélectionnés | Une fois par enregistrement sélectionné |
\| **Bulk** | Un ou plusieurs sélectionnés | Une fois, avec tous les enregistrements sous forme de tableau |
@@ -61,7 +61,6 @@ description: Foire aux questions sur les flux de travail dans Twenty.
**Oui**, les branches s'exécutent par défaut en parallèle.
Si vous souhaitez qu'une seule branche s'exécute :
-
* Ajoutez une action **Filter** au début de chaque branche
* Définissez des conditions opposées (p. ex., Branche A : status = "Open", Branche B : status ≠ "Open")
@@ -72,7 +71,6 @@ description: Foire aux questions sur les flux de travail dans Twenty.
**Oui**. Après l'exécution de vos branches parallèles, vous pouvez ajouter une étape à laquelle les deux branches se connectent.
Dans l'éditeur de flux de travail :
-
1. Terminez vos actions dans les branches
2. Ajoutez une nouvelle étape après les branches
3. Faites glisser des connexions depuis la fin de chaque branche vers cette nouvelle étape
@@ -84,7 +82,6 @@ description: Foire aux questions sur les flux de travail dans Twenty.
**Search Records renvoie un maximum de 200 enregistrements.**
Si vous devez en traiter davantage :
-
* Ajoutez des filtres plus spécifiques pour réduire les résultats
* Utilisez des flux de travail planifiés pour traiter par lots
* Envisagez d'utiliser l'API pour des opérations en masse
@@ -102,12 +99,10 @@ description: Foire aux questions sur les flux de travail dans Twenty.
Chaque action produit des données de sortie qui peuvent être utilisées dans les étapes suivantes.
**Pour référencer les données d'une étape précédente** :
-
* Utilisez le sélecteur de variables lors de la configuration d'un champ
* Ou saisissez directement `{{stepName.fieldName}}`
**Exemples** :
-
* Données du déclencheur : `{{trigger.object.email}}`
* Résultats de la recherche : `{{searchRecords[0].name}}`
* Sortie du code : `{{code.calculatedValue}}`
@@ -123,7 +118,6 @@ description: Foire aux questions sur les flux de travail dans Twenty.
3. **Mauvaise variable sélectionnée** : Assurez-vous de sélectionner le tableau lui-même, et non un seul enregistrement
**Configuration correcte** :
-
1. Search Records (renvoie un tableau)
2. Filtre : length > 0
3. Iterator : sélectionnez `{{searchRecords}}`
@@ -138,7 +132,6 @@ description: Foire aux questions sur les flux de travail dans Twenty.
Si votre code dépasse cette limite, l'action échouera avec une erreur de délai d'expiration.
**Conseils pour éviter les délais d'expiration** :
-
* Divisez les opérations volumineuses en plus petits blocs à l'aide d'Iterator
* Évitez les calculs lourds ; utilisez des services externes via HTTP Request pour les traitements intensifs
* Optimisez votre code pour réduire le temps d'exécution
@@ -149,12 +142,10 @@ description: Foire aux questions sur les flux de travail dans Twenty.
Les exécutions de flux de travail affichent l'historique d'exécution et vous aident à diagnostiquer les problèmes.
**Accéder aux exécutions** :
-
* Dans l'éditeur de flux de travail → volet **Runs** à droite
* Ou allez à **Workflow Runs** dans la barre latérale
**Comprendre une exécution** :
-
* **Statut** : En cours, Terminé, Échoué, En attente
* **Étapes** : Voyez quelles étapes ont été exécutées et leur sortie
* **Erreurs** : Cliquez sur les étapes en échec pour voir les messages d'erreur
@@ -171,13 +162,11 @@ description: Foire aux questions sur les flux de travail dans Twenty.
Si vous dépassez cette limite, les flux de travail sont immédiatement marqués comme ayant échoué et n'apparaîtront pas dans votre liste d'exécutions comme prévu.
**Scénarios courants qui atteignent cette limite** :
-
* Sélection de plus de 5 000 enregistrements avec un déclencheur manuel Single
* Plusieurs flux de travail s'exécutant simultanément dans votre espace de travail
* Déclencheurs automatisés à haute fréquence (p. ex., Record Updated sur un objet très sollicité)
**Solutions** :
-
* Utilisez des déclencheurs **Bulk** plutôt que Single pour traiter de nombreux enregistrements en une seule exécution
* Espacez les opérations de traitement par lots
* Utilisez des filtres pour réduire la fréquence des déclencheurs
@@ -189,7 +178,6 @@ description: Foire aux questions sur les flux de travail dans Twenty.
| Limite | Valeur | Comportement |
| ------ | ------ | ------------ |
-
\| **Limite souple** | 100 exécutions/minute | Les exécutions sont mises en file d'attente avec le statut "Non démarré", puis traitées progressivement |
\| **Limite stricte** | 5 000 exécutions/heure | Les exécutions échouent immédiatement |
@@ -198,7 +186,6 @@ description: Foire aux questions sur les flux de travail dans Twenty.
**Limite stricte (5 000/h)** : Cela s'applique à l'ensemble de votre espace de travail. Si l'ensemble de vos flux de travail dépasse 5 000 exécutions en une heure, les exécutions supplémentaires échoueront immédiatement.
**Conseils pour rester dans les limites** :
-
* Utilisez des déclencheurs Bulk avec Iterator au lieu de déclencheurs Single pour les gros lots
* Regroupez les automatisations liées dans un nombre plus restreint de flux de travail
* Utilisez des flux de travail planifiés pour étaler la charge dans le temps
@@ -208,13 +195,11 @@ description: Foire aux questions sur les flux de travail dans Twenty.
**Non, il n'existe pas de fonctionnalité de nouvelle tentative automatique pour le moment.**
Si une exécution de flux de travail échoue, vous devrez :
-
1. Examinez l'erreur dans **Paramètres → Flux de travail → [Votre flux de travail] → Runs**
2. Corrigez le problème (données, configuration ou service externe)
3. Déclenchez manuellement à nouveau le flux de travail sur le ou les enregistrements concernés
**Conseils pour réduire les échecs** :
-
* Ajoutez des nœuds **Filter** pour valider les données avant les actions
* Utilisez **Search Records** pour vérifier si des enregistrements liés existent
* Testez minutieusement avec quelques enregistrements avant les opérations en masse
@@ -226,14 +211,12 @@ description: Foire aux questions sur les flux de travail dans Twenty.
**Oui, si vos flux de travail sont déclenchés par la création ou la mise à jour d'enregistrements.**
Lorsque vous importez des données via CSV, chaque enregistrement créé ou mis à jour peut déclencher des flux de travail. Un import important (des milliers d'enregistrements) pourrait :
-
* Atteindre la limite de 5 000 exécutions/heure
* Consommer un nombre important de crédits de flux de travail
* Envoyer des e-mails ou des notifications inattendus
* Créer des tâches ou des enregistrements en double
**Avant un import massif** :
-
1. Allez dans **Paramètres → Flux de travail**
2. Identifiez les flux de travail déclenchés par l'objet que vous importez
3. **Désactivez**-les temporairement
@@ -251,4 +234,5 @@ description: Foire aux questions sur les flux de travail dans Twenty.
Cela réorganisera automatiquement tous les nœuds dans une disposition propre et organisée.
</Accordion>
+
</AccordionGroup>
diff --git a/packages/twenty-docs/l/fr/user-guide/workflows/overview.mdx b/packages/twenty-docs/l/fr/user-guide/workflows/overview.mdx
index c176fa038be..55035b0ecd0 100644
--- a/packages/twenty-docs/l/fr/user-guide/workflows/overview.mdx
+++ b/packages/twenty-docs/l/fr/user-guide/workflows/overview.mdx
@@ -3,7 +3,6 @@ title: Flux de travail
description: Apprenez à créer des automatisations dans Twenty.
---
-
## Pourquoi les Workflows sont importants
Twenty a été conçu pour offrir une flexibilité maximale à ses utilisateurs. Plutôt que de vous obliger à adapter vos processus métier à des fonctionnalités rigides et préconstruites, les workflows vous permettent de créer des automatisations qui créent le CRM qui soutient au mieux vos cas d'utilisation unique.
diff --git a/packages/twenty-docs/l/it/developers/contribute/capabilities/frontend-development/style-guide.mdx b/packages/twenty-docs/l/it/developers/contribute/capabilities/frontend-development/style-guide.mdx
index d4554b6a5ab..d2e5ad9f241 100644
--- a/packages/twenty-docs/l/it/developers/contribute/capabilities/frontend-development/style-guide.mdx
+++ b/packages/twenty-docs/l/it/developers/contribute/capabilities/frontend-development/style-guide.mdx
@@ -79,7 +79,7 @@ type EmailFieldProps = {
const EmailField = ({ value }: EmailFieldProps) => (
<TextInput value={value} disabled fullWidth />
-);},{
+);
```
#### Nessuna espansione singola delle variabili delle props negli elementi JSX
diff --git a/packages/twenty-docs/l/it/developers/extend/api.mdx b/packages/twenty-docs/l/it/developers/extend/api.mdx
index 3eba101a3cb..d4473cd8a54 100644
--- a/packages/twenty-docs/l/it/developers/extend/api.mdx
+++ b/packages/twenty-docs/l/it/developers/extend/api.mdx
@@ -37,7 +37,7 @@ Entrambe sono disponibili in REST e GraphQL. GraphQL aggiunge upsert in batch e
Authorization: Bearer YOUR_API_KEY
```
-Crea una chiave API in **Impostazioni → API & Webhooks → + Crea chiave**. Copiala immediatamente — viene mostrata una sola volta. Le chiavi possono essere limitate a un ruolo specifico in **Impostazioni → Ruoli → scheda Assegnazione** per limitare ciò a cui possono accedere.
+Crea una chiave API in **Impostazioni → API & Webhooks → + Crea chiave**. Copiala immediatamente — viene mostrata una sola volta. Le chiavi possono essere limitate a un ruolo specifico in **Impostazioni → Membri → Ruoli → scheda Assegnazione** per limitare ciò a cui possono accedere.
<VimeoEmbed videoId="928786722" title="Creazione della chiave API" />
diff --git a/packages/twenty-docs/l/it/developers/extend/apps/config/application.mdx b/packages/twenty-docs/l/it/developers/extend/apps/config/application.mdx
new file mode 100644
index 00000000000..c7185b386bc
--- /dev/null
+++ b/packages/twenty-docs/l/it/developers/extend/apps/config/application.mdx
@@ -0,0 +1,64 @@
+---
+title: Configurazione dell'applicazione
+description: Dichiara l'identità della tua app, il ruolo predefinito, le variabili e i metadati del marketplace con defineApplication.
+icon: rocket
+---
+
+Ogni app deve avere esattamente una chiamata a `defineApplication`. Dichiara:
+
+* **Identità** — identificatore universale, nome visualizzato, descrizione.
+* **Autorizzazioni** — il ruolo sotto il quale vengono eseguite le sue funzioni logiche e i componenti front-end.
+* **Variabili** *(opzionali)* — coppie chiave–valore esposte al tuo codice come variabili d'ambiente.
+* **Hook di pre-installazione / post-installazione** *(opzionali)* — vedi [Funzioni logiche](/l/it/developers/extend/apps/logic/logic-functions).
+
+```ts src/application-config.ts
+import { defineApplication } from 'twenty-sdk/define';
+
+export default defineApplication({
+ universalIdentifier: '39783023-bcac-41e3-b0d2-ff1944d8465d',
+ displayName: 'My Twenty App',
+ description: 'My first Twenty app',
+ applicationVariables: {
+ DEFAULT_RECIPIENT_NAME: {
+ universalIdentifier: '19e94e59-d4fe-4251-8981-b96d0a9f74de',
+ description: 'Default recipient name for postcards',
+ value: 'Jane Doe',
+ isSecret: false,
+ },
+ },
+});
+```
+
+Note:
+
+* I campi `universalIdentifier` sono ID deterministici che possiedi. Generali una volta e mantienili stabili tra una sincronizzazione e l'altra.
+* `applicationVariables` diventano variabili d'ambiente per le tue funzioni e i componenti front-end. Nelle funzioni di logica (lato server), sono disponibili come `process.env.VARIABLE_NAME`. Nei componenti front-end, usa `getApplicationVariable('VARIABLE_NAME')` da `twenty-sdk/front-component`. Le variabili contrassegnate con `isSecret: true` vengono iniettate solo nelle funzioni di logica. I componenti front-end ricevono solo variabili non segrete.
+* Il ruolo predefinito viene rilevato automaticamente dal file di ruolo contrassegnato con [`defineApplicationRole()`](/l/it/developers/extend/apps/config/roles): non è necessario farvi riferimento da `defineApplication()`.
+* Le funzioni di pre-installazione e post-installazione vengono rilevate automaticamente durante il build del manifest — non è necessario farne riferimento in `defineApplication()`.
+* Il passaggio esplicito di `defaultRoleUniversalIdentifier` è ancora supportato per garantire la compatibilità con le versioni precedenti, ma è deprecato a favore di `defineApplicationRole()`.
+
+## Ruolo funzione predefinito
+
+Il ruolo dichiarato con [`defineApplicationRole()`](/l/it/developers/extend/apps/config/roles) controlla a cosa possono accedere le funzioni di logica e i componenti di interfaccia dell'app:
+
+* Il token di runtime iniettato come `TWENTY_APP_ACCESS_TOKEN` è derivato da questo ruolo.
+* Il client API tipizzato è limitato alle autorizzazioni concesse a quel ruolo.
+* Segui il principio del privilegio minimo: dichiara solo le autorizzazioni necessarie alle tue funzioni.
+
+Quando esegui lo scaffolding di una nuova app, la CLI crea un file di ruolo iniziale in `src/roles/default-role.ts`. Per la documentazione completa, vedi [Ruoli e autorizzazioni](/l/it/developers/extend/apps/config/roles).
+
+## Metadati del marketplace
+
+Se prevedi di [pubblicare la tua app](/l/it/developers/extend/apps/operations/publishing), questi campi opzionali controllano come appare nel marketplace:
+
+| Campo | Descrizione |
+| ------------------ | ----------------------------------------------------------------------------------------------------------------------------------- |
+| `author` | Nome dell'autore o dell'azienda |
+| `category` | Categoria dell'app per il filtraggio nel marketplace |
+| `logoUrl` | Percorso del logo della tua app (ad es., `public/logo.png`) |
+| `screenshots` | Array di percorsi degli screenshot (ad es., `public/screenshot-1.png`) |
+| `aboutDescription` | Descrizione markdown più lunga per la scheda "Informazioni". Se omesso, il marketplace utilizza il `README.md` del pacchetto da npm |
+| `websiteUrl` | Link al tuo sito web |
+| `termsUrl` | Link ai Termini di servizio |
+| `emailSupport` | Indirizzo email di supporto |
+| `issueReportUrl` | Link al sistema di tracciamento dei problemi |
diff --git a/packages/twenty-docs/l/it/developers/extend/apps/config/install-hooks.mdx b/packages/twenty-docs/l/it/developers/extend/apps/config/install-hooks.mdx
new file mode 100644
index 00000000000..551058934dd
--- /dev/null
+++ b/packages/twenty-docs/l/it/developers/extend/apps/config/install-hooks.mdx
@@ -0,0 +1,206 @@
+---
+title: Hook di installazione
+description: Esegui logica prima o dopo l'installazione — popola i dati, esegui il backup dei record, convalida l'aggiornamento.
+icon: wrench
+---
+
+Gli hook di installazione sono funzioni logiche speciali che vengono eseguite durante il ciclo di vita di installazione o aggiornamento. Condividono lo stesso runtime del gestore delle [logic functions](/l/it/developers/extend/apps/logic/logic-functions) normali e ricevono un `InstallPayload`, ma sono dichiarati con le proprie funzioni di definizione — `definePostInstallLogicFunction()` e `definePreInstallLogicFunction()` — e vivono al di fuori del normale modello di trigger (eventi HTTP, cron, database).
+
+Ogni app può definire **al massimo una funzione di pre-installazione** e **al massimo una funzione di post-installazione**. La build del manifesto genererà un errore se ne viene rilevata più di una per ciascun tipo.
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│ install flow │
+│ │
+│ upload package → [pre-install] → metadata migration → │
+│ generate SDK → [post-install] │
+│ │
+│ old schema visible new schema visible │
+└─────────────────────────────────────────────────────────────┘
+```
+
+<AccordionGroup>
+<Accordion title="definePostInstallLogicFunction" description="Viene eseguita dopo che la migrazione dei metadati dello spazio di lavoro è stata applicata">
+
+Una funzione di post-installazione viene eseguita automaticamente una volta che la tua app ha terminato l'installazione in uno spazio di lavoro. Il server la esegue **dopo** che i metadati dell'app sono stati sincronizzati e il client SDK è stato generato, così lo spazio di lavoro è completamente pronto per l'uso e il nuovo schema è attivo. I casi d'uso tipici includono il popolamento di dati predefiniti, la creazione di record iniziali, la configurazione delle impostazioni dello spazio di lavoro o il provisioning di risorse su servizi di terze parti.
+
+```ts src/logic-functions/post-install.ts
+import { definePostInstallLogicFunction, type InstallPayload } from 'twenty-sdk/define';
+
+const handler = async (payload: InstallPayload): Promise<void> => {
+ console.log('Post install logic function executed successfully!', payload.previousVersion);
+};
+
+export default definePostInstallLogicFunction({
+ universalIdentifier: 'f7a2b9c1-3d4e-5678-abcd-ef9876543210',
+ name: 'post-install',
+ description: 'Runs after installation to set up the application.',
+ timeoutSeconds: 300,
+ shouldRunOnVersionUpgrade: false,
+ shouldRunSynchronously: false,
+ handler,
+});
+```
+
+Puoi anche eseguire manualmente la funzione di post-installazione in qualsiasi momento utilizzando la CLI:
+
+```bash filename="Terminal"
+yarn twenty dev:function:exec --postInstall
+```
+
+Punti chiave:
+* Le funzioni di post-installazione utilizzano `definePostInstallLogicFunction()` — una variante specializzata che omette le impostazioni dei trigger (`cronTriggerSettings`, `databaseEventTriggerSettings`, `httpRouteTriggerSettings`, `toolTriggerSettings`, `workflowActionTriggerSettings`).
+* L'handler riceve un `InstallPayload` con `{ previousVersion?: string; newVersion: string }` — `newVersion` è la versione in fase di installazione e `previousVersion` è la versione installata in precedenza (oppure `undefined` in caso di nuova installazione). Usa questi valori per distinguere le nuove installazioni dagli aggiornamenti e per eseguire logiche di migrazione specifiche per versione.
+* **Quando viene eseguito l'hook**: solo sulle nuove installazioni, per impostazione predefinita. Passa `shouldRunOnVersionUpgrade: true` se vuoi che venga eseguito anche quando l'app viene aggiornata da una versione precedente. Se omesso, il flag è `false` per impostazione predefinita e gli aggiornamenti saltano l'hook.
+* **Modello di esecuzione — asincrono per impostazione predefinita, sincrono su richiesta**: il flag `shouldRunSynchronously` controlla *come* viene eseguito il post-install.
+ * `shouldRunSynchronously: false` *(default)* — l'hook viene **messo in coda nella coda dei messaggi** con `retryLimit: 3` ed eseguito in modo asincrono in un worker. La risposta di installazione viene restituita non appena il job è messo in coda, quindi un handler lento o in errore non blocca il chiamante. Il worker riproverà fino a tre volte. **Usalo per job di lunga durata** — popolamento di dataset di grandi dimensioni, chiamate a API di terze parti lente, provisioning di risorse esterne, qualsiasi cosa che possa superare una finestra di risposta HTTP ragionevole.
+ * `shouldRunSynchronously: true` — l'hook viene eseguito **inline durante il flusso di installazione** (stesso executor del pre-install). La richiesta di installazione rimane bloccata finché l'handler non termina e, se genera un'eccezione, il chiamante dell'installazione riceve un `POST_INSTALL_ERROR`. Nessun tentativo automatico. **Usalo per attività rapide che devono completarsi prima della risposta** — ad esempio, emettere un errore di validazione all'utente, oppure un setup rapido di cui il client avrà bisogno immediatamente dopo il ritorno della chiamata di installazione. Tieni presente che la migrazione dei metadati è già stata applicata quando viene eseguito il post-install, quindi un errore in modalità sincrona **non** annulla le modifiche allo schema — si limita a far emergere l'errore.
+* Assicurati che il tuo handler sia idempotente. In modalità asincrona la coda può riprovare fino a tre volte; in entrambe le modalità l'hook può essere eseguito di nuovo durante gli aggiornamenti quando `shouldRunOnVersionUpgrade: true`.
+* Le variabili d'ambiente `APPLICATION_ID`, `APP_ACCESS_TOKEN` e `API_URL` sono disponibili all'interno dell'handler (come in qualsiasi altra funzione logica), quindi puoi chiamare le API di Twenty con un token di accesso applicativo con ambito sulla tua app.
+* È consentita una sola funzione di post-installazione per applicazione. La build del manifesto genererà un errore se ne viene rilevata più di una.
+* I campi `universalIdentifier`, `shouldRunOnVersionUpgrade` e `shouldRunSynchronously` della funzione vengono associati automaticamente al manifest dell'applicazione nel campo `postInstallLogicFunction` durante la build — non è necessario referenziarli in [`defineApplication()`](/l/it/developers/extend/apps/config/application).
+* Il timeout predefinito è impostato a 300 secondi (5 minuti) per consentire attività di configurazione più lunghe, come il popolamento dei dati.
+* **Non eseguito in modalità dev**: quando un'app è registrata in locale (tramite `yarn twenty dev`), il server salta completamente il flusso di installazione e sincronizza i file direttamente tramite il watcher della CLI — quindi il post-install non viene mai eseguito in modalità dev, indipendentemente da `shouldRunSynchronously`. Usa `yarn twenty dev:function:exec --postInstall` per attivarlo manualmente su un workspace in esecuzione.
+
+</Accordion>
+<Accordion title="definePreInstallLogicFunction" description="Viene eseguita prima che la migrazione dei metadati dello spazio di lavoro sia applicata">
+
+Una funzione di pre-installazione viene eseguita automaticamente durante l'installazione, **prima che venga applicata la migrazione dei metadati dello spazio di lavoro**. Condivide la stessa struttura di payload del post-install (`InstallPayload`), ma è posizionata prima nel flusso di installazione così da poter preparare lo stato da cui dipenderà la migrazione imminente — usi tipici includono il backup dei dati, la validazione della compatibilità con il nuovo schema o l'archiviazione di record che stanno per essere ristrutturati o eliminati.
+
+```ts src/logic-functions/pre-install.ts
+import { definePreInstallLogicFunction, type InstallPayload } from 'twenty-sdk/define';
+
+const handler = async (payload: InstallPayload): Promise<void> => {
+ console.log('Pre install logic function executed successfully!', payload.previousVersion);
+};
+
+export default definePreInstallLogicFunction({
+ universalIdentifier: 'a1b2c3d4-5678-90ab-cdef-1234567890ab',
+ name: 'pre-install',
+ description: 'Runs before installation to prepare the application.',
+ timeoutSeconds: 300,
+ shouldRunOnVersionUpgrade: true,
+ handler,
+});
+```
+
+Puoi anche eseguire manualmente la funzione di pre-installazione in qualsiasi momento utilizzando la CLI:
+
+```bash filename="Terminal"
+yarn twenty dev:function:exec --preInstall
+```
+
+Punti chiave:
+* Le funzioni di pre-install usano `definePreInstallLogicFunction()` — stessa configurazione specialistica del post-install, solo agganciata a uno slot di ciclo di vita diverso.
+* Sia gli handler di pre- sia quelli di post-install ricevono lo stesso tipo `InstallPayload`: `{ previousVersion?: string; newVersion: string }`. Importalo una volta e riutilizzalo per entrambi gli hook.
+* **Quando viene eseguito l'hook**: posizionato appena prima della migrazione dei metadati del workspace (`synchronizeFromManifest`). Prima dell'esecuzione, il server esegue una "sincronizzazione ridotta" puramente additiva che registra nei metadati del workspace la funzione di pre-install della versione **nuova** — nient'altro viene toccato — e poi la esegue. Poiché questa sincronizzazione è solo additiva, gli oggetti, i campi e i dati della versione precedente restano intatti quando il tuo handler viene eseguito: puoi leggere ed eseguire in sicurezza il backup dello stato pre-migrazione.
+* **Modello di esecuzione**: il pre-install è eseguito **in modo sincrono** e **blocca l'installazione**. Se l'handler genera un'eccezione, l'installazione viene interrotta prima che vengano applicate modifiche allo schema — il workspace rimane sulla versione precedente in uno stato coerente. Questo è intenzionale: il pre-install è la tua ultima possibilità per rifiutare un aggiornamento rischioso.
+* Come per il post-install, è consentita una sola funzione di pre-installazione per applicazione. Viene collegata automaticamente al manifest dell'applicazione nel campo `preInstallLogicFunction` durante la build.
+* **Non eseguito in modalità dev**: come per il post-install — il flusso di installazione viene completamente saltato per le app registrate localmente, quindi il pre-install non viene mai eseguito con `yarn twenty dev`. Usa `yarn twenty dev:function:exec --preInstall` per attivarlo manualmente.
+
+</Accordion>
+<Accordion title="Pre-install vs post-install: quando usare l'uno o l'altro" description="Scegliere l'hook di installazione giusto">
+
+Entrambi gli hook fanno parte dello stesso flusso di installazione e ricevono lo stesso `InstallPayload`. La differenza è **quando** vengono eseguiti rispetto alla migrazione dei metadati del workspace, e questo modifica quali dati possono gestire in sicurezza.
+
+Il pre-install è sempre **sincrono** (blocca l'installazione e può interromperla). Il post-install è **asincrono per impostazione predefinita** — messo in coda su un worker con retry automatici — ma può optare per l'esecuzione sincrona con `shouldRunSynchronously: true`. Vedi l'accordion `definePostInstallLogicFunction` sopra per quando usare ciascuna modalità.
+
+**Usa `post-install` per tutto ciò che richiede l'esistenza del nuovo schema.** Questo è il caso più comune:
+
+* Popolamento di dati predefiniti (creazione di record iniziali, viste predefinite, contenuti demo) su oggetti e campi appena aggiunti.
+* Registrazione di webhook con servizi di terze parti ora che l'app ha le proprie credenziali.
+* Chiamare la tua API per completare il setup che dipende dai metadati sincronizzati.
+* Logica idempotente di "ensure this exists" che dovrebbe riconciliare lo stato a ogni aggiornamento — da combinare con `shouldRunOnVersionUpgrade: true`.
+
+Esempio — eseguire il seeding di un record `PostCard` predefinito dopo l'installazione:
+
+```ts src/logic-functions/post-install.ts
+import { definePostInstallLogicFunction, type InstallPayload } from 'twenty-sdk/define';
+import { createClient } from './generated/client';
+
+const handler = async ({ previousVersion }: InstallPayload): Promise<void> => {
+ if (previousVersion) return; // fresh installs only
+
+ const client = createClient();
+ await client.postCard.create({
+ data: { title: 'Welcome to Postcard', content: 'Your first card!' },
+ });
+};
+
+export default definePostInstallLogicFunction({
+ universalIdentifier: 'f7a2b9c1-3d4e-5678-abcd-ef9876543210',
+ name: 'post-install',
+ description: 'Seeds a welcome post card after install.',
+ timeoutSeconds: 300,
+ shouldRunOnVersionUpgrade: false,
+ handler,
+});
+```
+
+**Usa `pre-install` quando una migrazione altrimenti distruggerebbe o corromperebbe i dati esistenti.** Poiché il pre-install viene eseguito contro lo schema *precedente* e un suo fallimento annulla l'aggiornamento, è il posto giusto per qualsiasi operazione rischiosa:
+
+* **Eseguire il backup dei dati che stanno per essere eliminati o ristrutturati** — ad esempio, stai rimuovendo un campo nella v2 e devi copiarne i valori in un altro campo o esportarli su uno storage prima che venga eseguita la migrazione.
+* **Archiviare i record che un nuovo vincolo renderebbe non validi** — ad esempio, un campo sta diventando `NOT NULL` e devi prima eliminare o correggere le righe con valori nulli.
+* **Validare la compatibilità e rifiutare l'aggiornamento se i dati attuali non possono essere migrati correttamente** — genera un'eccezione dall'handler e l'installazione si interrompe senza applicare modifiche. Questo è più sicuro che scoprire l'incompatibilità a migrazione in corso.
+* **Rinominare o rigenerare le chiavi dei dati** prima di una modifica dello schema che farebbe perdere l'associazione.
+
+Esempio — archiviare i record prima di una migrazione distruttiva:
+
+```ts src/logic-functions/pre-install.ts
+import { definePreInstallLogicFunction, type InstallPayload } from 'twenty-sdk/define';
+import { createClient } from './generated/client';
+
+const handler = async ({ previousVersion, newVersion }: InstallPayload): Promise<void> => {
+ // Only the 1.x → 2.x upgrade drops the legacy `notes` field.
+ if (!previousVersion?.startsWith('1.') || !newVersion.startsWith('2.')) {
+ return;
+ }
+
+ const client = createClient();
+ const legacyRecords = await client.postCard.findMany({
+ where: { notes: { isNotNull: true } },
+ });
+
+ if (legacyRecords.length === 0) return;
+
+ // Copy legacy `notes` into the new `description` field before the migration
+ // drops the `notes` column. If this fails, the upgrade is aborted and the
+ // workspace stays on v1 with all data intact.
+ await Promise.all(
+ legacyRecords.map((record) =>
+ client.postCard.update({
+ where: { id: record.id },
+ data: { description: record.notes },
+ }),
+ ),
+ );
+};
+
+export default definePreInstallLogicFunction({
+ universalIdentifier: 'a1b2c3d4-5678-90ab-cdef-1234567890ab',
+ name: 'pre-install',
+ description: 'Backs up legacy notes into description before the v2 migration.',
+ timeoutSeconds: 300,
+ shouldRunOnVersionUpgrade: true,
+ handler,
+});
+```
+
+**Regola generale:**
+
+| Vuoi... | Usa |
+| ---------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------ |
+| Popolare dati predefiniti, configurare il workspace, registrare risorse esterne | `post-install` |
+| Eseguire seeding di lunga durata o chiamate a terze parti che non dovrebbero bloccare la risposta dell'installazione | `post-install` (predefinito — `shouldRunSynchronously: false`, con retry del worker) |
+| Eseguire un setup rapido di cui il chiamante farà affidamento immediatamente dopo il ritorno della chiamata di installazione | `post-install` con `shouldRunSynchronously: true` |
+| Leggere o eseguire il backup dei dati che la prossima migrazione perderebbe | `pre-install` |
+| Rifiutare un aggiornamento che corromperebbe i dati esistenti | `pre-install` (genera un'eccezione dall'handler) |
+| Eseguire la riconciliazione a ogni aggiornamento | `post-install` con `shouldRunOnVersionUpgrade: true` |
+| Eseguire un setup una tantum solo alla prima installazione | `post-install` con `shouldRunOnVersionUpgrade: false` (predefinito) |
+
+<Note>
+In caso di dubbio, usa **post-install**. Ricorri al pre-install solo quando la migrazione stessa è distruttiva e devi intercettare lo stato precedente prima che vada perso.
+</Note>
+
+</Accordion>
+</AccordionGroup>
diff --git a/packages/twenty-docs/l/it/developers/extend/apps/config/overview.mdx b/packages/twenty-docs/l/it/developers/extend/apps/config/overview.mdx
new file mode 100644
index 00000000000..de921879629
--- /dev/null
+++ b/packages/twenty-docs/l/it/developers/extend/apps/config/overview.mdx
@@ -0,0 +1,51 @@
+---
+title: Panoramica
+description: Configura l'app stessa — la sua identità, le autorizzazioni predefinite e ciò che viene eseguito al momento dell'installazione.
+icon: screwdriver-wrench
+---
+
+Il **config layer** di un'app Twenty è ciò che descrive l'app *alla piattaforma* — la sua identità, le autorizzazioni che detiene e il codice che viene eseguito durante l'installazione o l'aggiornamento. Queste dichiarazioni non aggiungono nuove strutture di dati o comportamenti a runtime; dicono a Twenty *chi è l'app* e *come configurarla*.
+
+```text
+┌────────────────────────────────────────────────────────┐
+│ Application — identity, default role, variables, │
+│ marketplace metadata │
+│ │
+│ ┌──────────────────────────────────────────────────┐ │
+│ │ Role — what the app's logic functions can read │ │
+│ │ and write (referenced by Application) │ │
+│ └──────────────────────────────────────────────────┘ │
+└────────────────────────────────────────────────────────┘
+ │
+ ▼ (at install / upgrade time)
+ ┌──────────────────────────────────┐
+ │ Pre-install hook │ before metadata migration
+ └──────────────────────────────────┘
+ ┌──────────────────────────────────┐
+ │ Post-install hook │ after metadata migration
+ └──────────────────────────────────┘
+```
+
+## In questa sezione
+
+<CardGroup cols={2}>
+ <Card title="Configurazione dell'applicazione" icon="rocket" href="/l/it/developers/extend/apps/config/application">
+ `defineApplication` — identità, ruolo predefinito, variabili, metadati del marketplace.
+ </Card>
+ <Card title="Ruoli e permessi" icon="shield-halved" href="/l/it/developers/extend/apps/config/roles">
+ `defineRole` — dichiara ciò che le funzioni logiche della tua app possono leggere e scrivere.
+ </Card>
+ <Card title="Hook di installazione" icon="wrench" href="/l/it/developers/extend/apps/config/install-hooks">
+ `definePreInstallLogicFunction` e `definePostInstallLogicFunction` — esegui il backup dei dati, imposta i valori predefiniti, convalida gli aggiornamenti.
+ </Card>
+</CardGroup>
+
+## Come si relazionano gli elementi
+
+* L'**applicazione** è il punto di ingresso. Ogni app ha esattamente una chiamata a `defineApplication()` e punta a un **Ruolo** come predefinito.
+* Il **Ruolo** controlla ciò che le funzioni di logica e i componenti front-end dell'app possono leggere e scrivere. Segui il principio del privilegio minimo: concedi solo le autorizzazioni di cui il tuo codice ha effettivamente bisogno.
+* Gli **hook di installazione** vengono eseguiti durante l'installazione o l'aggiornamento — pre-installazione prima della migrazione dei metadati (così può rifiutare un aggiornamento rischioso), post-installazione dopo la migrazione (così può inserire dati predefiniti in base al nuovo schema).
+
+<Note>
+Gli hook di installazione condividono il runtime delle [logic function](/l/it/developers/extend/apps/logic/logic-functions) — stessa firma dell'handler, stesse variabili d'ambiente, stesso client API tipizzato — ma sono dichiarati con le proprie funzioni `define` e vivono al di fuori del normale modello di trigger (HTTP, cron, eventi del database).
+</Note>
diff --git a/packages/twenty-docs/l/it/developers/extend/apps/config/public-assets.mdx b/packages/twenty-docs/l/it/developers/extend/apps/config/public-assets.mdx
new file mode 100644
index 00000000000..dbdc0ca919c
--- /dev/null
+++ b/packages/twenty-docs/l/it/developers/extend/apps/config/public-assets.mdx
@@ -0,0 +1,67 @@
+---
+title: Asset pubblici
+description: Distribuisci file statici — immagini, icone, font — insieme alla tua app tramite la cartella public/.
+icon: folder-open
+---
+
+La cartella `public/` alla radice della tua app contiene file statici — immagini, icone, font o qualsiasi altro asset di cui la tua app ha bisogno a runtime. Questi file sono inclusi automaticamente nelle build, sincronizzati durante la modalità di sviluppo e caricati sul server.
+
+I file posizionati in `public/` sono:
+
+* **Pubblicamente accessibili** — una volta sincronizzati sul server, gli asset sono serviti a un URL pubblico. Non è necessaria alcuna autenticazione per accedervi.
+* **Disponibili nei componenti front-end** — usa gli URL degli asset per visualizzare immagini, icone o qualsiasi media all'interno dei tuoi componenti React.
+* **Disponibili nelle funzioni logiche** — fai riferimento agli URL degli asset nelle email, nelle risposte API o in qualsiasi logica lato server.
+* **Usati per i metadati del marketplace** — i campi `logoUrl` e `screenshots` in `defineApplication()` fanno riferimento a file di questa cartella (ad es., `public/logo.png`). Questi vengono visualizzati nel marketplace quando la tua app viene pubblicata.
+* **Sincronizzati automaticamente in modalità dev** — quando aggiungi, aggiorni o elimini un file in `public/`, viene sincronizzato automaticamente con il server. Nessun riavvio necessario.
+* **Inclusi nelle build** — `yarn twenty dev:build` raggruppa tutti gli asset pubblici nell'output di distribuzione.
+
+## Accedere agli asset pubblici con `getPublicAssetUrl`
+
+Usa l'helper `getPublicAssetUrl` da `twenty-sdk` per ottenere l'URL completo di un file nella tua directory `public/`. Funziona sia nelle funzioni logiche che nei componenti front-end.
+
+**In una funzione logica:**
+
+```ts src/logic-functions/send-invoice.ts
+import { defineLogicFunction } from 'twenty-sdk/define';
+import { getPublicAssetUrl } from 'twenty-sdk/utils';
+
+const handler = async (): Promise<any> => {
+ const logoUrl = getPublicAssetUrl('logo.png');
+ const invoiceUrl = getPublicAssetUrl('templates/invoice.png');
+
+ // Fetch the file content (no auth required — public endpoint)
+ const response = await fetch(invoiceUrl);
+ const buffer = await response.arrayBuffer();
+
+ return { logoUrl, size: buffer.byteLength };
+};
+
+export default defineLogicFunction({
+ universalIdentifier: 'a1b2c3d4-...',
+ name: 'send-invoice',
+ description: 'Sends an invoice with the app logo',
+ timeoutSeconds: 10,
+ handler,
+});
+```
+
+**In un componente front-end:**
+
+```tsx src/front-components/company-card.tsx
+import { defineFrontComponent } from 'twenty-sdk/define';
+import { getPublicAssetUrl } from 'twenty-sdk/utils';
+
+const CompanyCard = () => {
+ const logoUrl = getPublicAssetUrl('logo.png');
+
+ return <img src={logoUrl} alt="App logo" />;
+};
+
+export default defineFrontComponent({
+ universalIdentifier: '...',
+ name: 'company-card',
+ component: CompanyCard,
+});
+```
+
+L'argomento `path` è relativo alla cartella `public/` della tua app. Sia `getPublicAssetUrl('logo.png')` sia `getPublicAssetUrl('public/logo.png')` risolvono allo stesso URL — il prefisso `public/` viene rimosso automaticamente se presente.
diff --git a/packages/twenty-docs/l/it/developers/extend/apps/config/roles.mdx b/packages/twenty-docs/l/it/developers/extend/apps/config/roles.mdx
new file mode 100644
index 00000000000..57269c2344b
--- /dev/null
+++ b/packages/twenty-docs/l/it/developers/extend/apps/config/roles.mdx
@@ -0,0 +1,94 @@
+---
+title: Ruoli e permessi
+description: Dichiara quali oggetti e campi le funzioni di logica e i componenti front-end della tua app possono leggere e scrivere.
+icon: shield-halved
+---
+
+Un **ruolo** è un insieme di permessi: quali oggetti un’app può leggere o scrivere, quali campi può vedere e quali funzionalità a livello di piattaforma può usare. Tutte le funzioni di logica e i componenti front-end di ogni app ereditano i permessi del ruolo contrassegnato con `defineApplicationRole()` (vedi [The default function role](#the-default-function-role) di seguito).
+
+```ts src/roles/restricted-company-role.ts
+import {
+ defineRole,
+ STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS,
+ SystemPermissionFlag,
+} from 'twenty-sdk/define';
+
+export default defineRole({
+ universalIdentifier: '2c80f640-2083-4803-bb49-003e38279de6',
+ label: 'My new role',
+ description: 'A role that can be used in your workspace',
+ canReadAllObjectRecords: false,
+ canUpdateAllObjectRecords: false,
+ canSoftDeleteAllObjectRecords: false,
+ canDestroyAllObjectRecords: false,
+ canUpdateAllSettings: false,
+ canBeAssignedToAgents: false,
+ canBeAssignedToUsers: false,
+ canBeAssignedToApiKeys: false,
+ objectPermissions: [
+ {
+ objectUniversalIdentifier:
+ STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS.company.universalIdentifier,
+ canReadObjectRecords: true,
+ canUpdateObjectRecords: true,
+ canSoftDeleteObjectRecords: false,
+ canDestroyObjectRecords: false,
+ },
+ ],
+ fieldPermissions: [
+ {
+ objectUniversalIdentifier:
+ STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS.company.universalIdentifier,
+ fieldUniversalIdentifier:
+ STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS.company.fields.name
+ .universalIdentifier,
+ canReadFieldValue: false,
+ canUpdateFieldValue: false,
+ },
+ ],
+ permissionFlagUniversalIdentifiers: [SystemPermissionFlag.APPLICATIONS],
+});
+```
+
+## Ruolo funzione predefinito
+
+Quando esegui lo scaffolding di una nuova app, la CLI crea un file di ruolo predefinito dichiarato con `defineApplicationRole()`:
+
+```ts src/roles/default-role.ts
+import { defineApplicationRole } from 'twenty-sdk/define';
+
+export const DEFAULT_ROLE_UNIVERSAL_IDENTIFIER =
+ 'b648f87b-1d26-4961-b974-0908fd991061';
+
+export default defineApplicationRole({
+ universalIdentifier: DEFAULT_ROLE_UNIVERSAL_IDENTIFIER,
+ label: 'Default function role',
+ description: 'Default role for function Twenty client',
+ canReadAllObjectRecords: true,
+ canUpdateAllObjectRecords: false,
+ canSoftDeleteAllObjectRecords: false,
+ canDestroyAllObjectRecords: false,
+ canUpdateAllSettings: false,
+ canBeAssignedToAgents: false,
+ canBeAssignedToUsers: false,
+ canBeAssignedToApiKeys: false,
+ objectPermissions: [],
+ fieldPermissions: [],
+ permissionFlagUniversalIdentifiers: [],
+});
+```
+
+`defineApplicationRole()` è un leggero wrapper attorno a `defineRole()` che contrassegna il ruolo usato come predefinito per la tua applicazione al momento dell’installazione. La convalida è identica a `defineRole`, ma la pipeline di build collega automaticamente il suo `universalIdentifier` al `defaultRoleUniversalIdentifier` del manifest dell’applicazione — quindi non è necessario farvi riferimento in [`defineApplication`](/l/it/developers/extend/apps/config/application).
+
+Note:
+
+* È consentita esattamente **una** chiamata a `defineApplicationRole(...)` per app — la build del manifest avrà esito negativo se ne trova più di una.
+* Usa `defineRole()` (non `defineApplicationRole()`) per qualsiasi ruolo **aggiuntivo** fornito dalla tua app.
+* L’impostazione esplicita di `defaultRoleUniversalIdentifier` in `defineApplication()` è ancora supportata per retrocompatibilità, ma è deprecata a favore di `defineApplicationRole()`.
+
+## Migliori Pratiche
+
+* Parti dal ruolo generato dallo scaffold, poi restringilo progressivamente: il ruolo predefinito concede un ampio accesso in lettura, che raramente è ciò che vuoi in produzione.
+* Sostituisci `objectPermissions` e `fieldPermissions` con gli oggetti e i campi di cui le tue funzioni hanno realmente bisogno.
+* `permissionFlagUniversalIdentifiers` controllano l'accesso alle funzionalità a livello di piattaforma. Mantienili al minimo.
+* Vedi un esempio funzionante: [`hello-world/src/roles/function-role.ts`](https://github.com/twentyhq/twenty/blob/main/packages/twenty-apps/hello-world/src/roles/function-role.ts).
diff --git a/packages/twenty-docs/l/it/developers/extend/apps/data/extending-objects.mdx b/packages/twenty-docs/l/it/developers/extend/apps/data/extending-objects.mdx
new file mode 100644
index 00000000000..700f681bf6a
--- /dev/null
+++ b/packages/twenty-docs/l/it/developers/extend/apps/data/extending-objects.mdx
@@ -0,0 +1,50 @@
+---
+title: Estendere gli oggetti
+description: Aggiungi campi agli oggetti standard di Twenty (Person, Company, …) o agli oggetti di altre app usando defineField.
+icon: wand-magic-sparkles
+---
+
+Usa `defineField()` per aggiungere un campo a un oggetto che non possiedi — un oggetto standard di Twenty come Person o Company, oppure un oggetto fornito da un'altra app installata. A differenza dei campi inline dichiarati all'interno di [`defineObject`](/l/it/developers/extend/apps/data/objects), i campi autonomi richiedono un `objectUniversalIdentifier` per specificare quale oggetto estendono.
+
+```ts src/fields/company-loyalty-tier.field.ts
+import { defineField, FieldType } from 'twenty-sdk/define';
+
+export default defineField({
+ universalIdentifier: 'f2a1b3c4-d5e6-7890-abcd-ef1234567890',
+ objectUniversalIdentifier: '701aecb9-eb1c-4d84-9d94-b954b231b64b', // Company object
+ name: 'loyaltyTier',
+ type: FieldType.SELECT,
+ label: 'Loyalty Tier',
+ icon: 'IconStar',
+ options: [
+ { value: 'BRONZE', label: 'Bronze', position: 0, color: 'orange' },
+ { value: 'SILVER', label: 'Silver', position: 1, color: 'gray' },
+ { value: 'GOLD', label: 'Gold', position: 2, color: 'yellow' },
+ ],
+});
+```
+
+## Punti chiave
+
+* `objectUniversalIdentifier` identifica l'oggetto di destinazione. Per gli oggetti standard di Twenty, importa la costante da `twenty-sdk`:
+
+ ```ts
+ import { STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS } from 'twenty-sdk/define';
+
+ // STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS.company.universalIdentifier
+ // STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS.person.universalIdentifier
+ // STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS.opportunity.universalIdentifier
+ // …
+ ```
+
+* Quando definisci campi **inline dentro `defineObject()`**, **non** hai bisogno di `objectUniversalIdentifier` — viene ereditato dall'oggetto padre.
+
+* `defineField()` è l'unico modo per aggiungere campi a oggetti che non hai creato con `defineObject()`.
+
+* Il percorso del file dipende da te. La convenzione è `src/fields/\<name>.field.ts`, ma l'SDK rileva i campi ovunque in `src/`.
+
+* Per aggiungere una scheda a un layout di pagina standard (ad es. la pagina di dettaglio di Task o Company), utilizza [`definePageLayoutTab`](/l/it/developers/extend/apps/layout/page-layouts#definepagelayouttab) con `STANDARD_PAGE_LAYOUT_UNIVERSAL_IDENTIFIERS` da `twenty-sdk/define`.
+
+## Aggiungere una relazione a un oggetto esistente
+
+Per aggiungere un campo di relazione (ad esempio collegare il tuo oggetto personalizzato a un `Person` standard), usa `defineField()` con `FieldType.RELATION`. Lo schema è lo stesso delle relazioni inline, ma con `objectUniversalIdentifier` impostato esplicitamente. Vedi [Relazioni](/l/it/developers/extend/apps/data/relations) per lo schema bidirezionale.
diff --git a/packages/twenty-docs/l/it/developers/extend/apps/data/objects.mdx b/packages/twenty-docs/l/it/developers/extend/apps/data/objects.mdx
new file mode 100644
index 00000000000..a2bd67e9219
--- /dev/null
+++ b/packages/twenty-docs/l/it/developers/extend/apps/data/objects.mdx
@@ -0,0 +1,104 @@
+---
+title: Oggetti
+description: Dichiara nuovi tipi di record — tabelle personalizzate con i propri campi — usando defineObject.
+icon: tabella
+---
+
+Gli **oggetti** personalizzati sono nuovi tipi di record che la tua app aggiunge a uno spazio di lavoro — Cartolina, Fattura, Abbonamento, qualsiasi cosa specifica per il tuo dominio. Ogni oggetto dichiara il proprio schema (campi, relazioni, valori predefiniti) e un identificatore universale stabile che persiste tra le sincronizzazioni e le distribuzioni.
+
+```ts src/objects/post-card.object.ts
+import { defineObject, FieldType } from 'twenty-sdk/define';
+
+enum PostCardStatus {
+ DRAFT = 'DRAFT',
+ SENT = 'SENT',
+ DELIVERED = 'DELIVERED',
+ RETURNED = 'RETURNED',
+}
+
+export default defineObject({
+ universalIdentifier: '54b589ca-eeed-4950-a176-358418b85c05',
+ nameSingular: 'postCard',
+ namePlural: 'postCards',
+ labelSingular: 'Post Card',
+ labelPlural: 'Post Cards',
+ description: 'A post card object',
+ icon: 'IconMail',
+ fields: [
+ {
+ universalIdentifier: '58a0a314-d7ea-4865-9850-7fb84e72f30b',
+ name: 'content',
+ type: FieldType.TEXT,
+ label: 'Content',
+ description: "Postcard's content",
+ icon: 'IconAbc',
+ },
+ {
+ universalIdentifier: 'c6aa31f3-da76-4ac6-889f-475e226009ac',
+ name: 'recipientName',
+ type: FieldType.FULL_NAME,
+ label: 'Recipient name',
+ icon: 'IconUser',
+ },
+ {
+ universalIdentifier: '95045777-a0ad-49ec-98f9-22f9fc0c8266',
+ name: 'recipientAddress',
+ type: FieldType.ADDRESS,
+ label: 'Recipient address',
+ icon: 'IconHome',
+ },
+ {
+ universalIdentifier: '87b675b8-dd8c-4448-b4ca-20e5a2234a1e',
+ name: 'status',
+ type: FieldType.SELECT,
+ label: 'Status',
+ icon: 'IconSend',
+ defaultValue: `'${PostCardStatus.DRAFT}'`,
+ options: [
+ { value: PostCardStatus.DRAFT, label: 'Draft', position: 0, color: 'gray' },
+ { value: PostCardStatus.SENT, label: 'Sent', position: 1, color: 'orange' },
+ { value: PostCardStatus.DELIVERED, label: 'Delivered', position: 2, color: 'green' },
+ { value: PostCardStatus.RETURNED, label: 'Returned', position: 3, color: 'orange' },
+ ],
+ },
+ {
+ universalIdentifier: 'e06abe72-5b44-4e7f-93be-afc185a3c433',
+ name: 'deliveredAt',
+ type: FieldType.DATE_TIME,
+ label: 'Delivered at',
+ icon: 'IconCheck',
+ isNullable: true,
+ defaultValue: null,
+ },
+ ],
+});
+```
+
+## Punti chiave
+
+* Il `universalIdentifier` deve essere univoco e stabile tra i deployment.
+* Ogni campo richiede un `name`, `type`, `label` e il proprio `universalIdentifier` stabile.
+* L'array `fields` è facoltativo: puoi definire oggetti senza campi personalizzati.
+* I campi inline definiti qui **non** hanno bisogno di un `objectUniversalIdentifier` — viene ereditato dall'oggetto padre. Usa [`defineField()`](/l/it/developers/extend/apps/data/extending-objects) per aggiungere campi a oggetti che non possiedi.
+* Puoi generare nuovi oggetti con `yarn twenty dev:add object`, che ti guida nella denominazione, nei campi e nelle relazioni. Vedi [Architettura → Scaffolding delle entità](/l/it/developers/extend/apps/getting-started/scaffolding).
+
+<Note>
+**I campi base vengono aggiunti automaticamente.** Quando definisci un oggetto personalizzato, Twenty crea per te campi standard come `id`, `name`, `createdAt`, `updatedAt`, `createdBy`, `updatedBy` e `deletedAt`. Non è necessario dichiararli nel tuo array `fields` — solo i tuoi campi personalizzati. Puoi sovrascrivere un campo predefinito dichiarandone uno con lo stesso nome, ma è raramente una buona idea.
+</Note>
+
+## Valori predefiniti
+
+I valori predefiniti letterali devono essere racchiusi tra apici singoli **all'interno** della stringa — `defaultValue: "'Draft'"`, non `defaultValue: "Draft"`. Ecco perché il campo `status` sopra utilizza `` `'${PostCardStatus.DRAFT}'` ``.
+
+Le stringhe senza virgolette sono riservate ai valori predefiniti calcolati, valutati quando viene creato un record:
+
+* `'uuid'` — genera un UUID (per i campi `UUID`)
+* `'now'` — il timestamp corrente (per i campi `DATE_TIME`)
+
+La stessa convenzione si applica ai sotto-campi stringa dei valori compositi predefiniti (ad es. `{ source: "'MANUAL'" }` su un campo `ACTOR`) e ai valori `SELECT`/`MULTI_SELECT`. Una stringa letterale predefinita lasciata senza virgolette genera un avviso quando la tua app viene compilata.
+
+## Cosa c'è dopo
+
+* **Collega questo oggetto ad altri** — vedi [Relazioni](/l/it/developers/extend/apps/data/relations) per il pattern di relazione bidirezionale.
+* **Aggiungi campi a oggetti di altre app** — vedi [Estendere gli oggetti](/l/it/developers/extend/apps/data/extending-objects) per `defineField()`.
+* **Mostra questo oggetto nell'interfaccia utente** — vedi [Viste](/l/it/developers/extend/apps/layout/views) e [Elementi del menu di navigazione](/l/it/developers/extend/apps/layout/navigation-menu-items) per inserirlo nella barra laterale.
diff --git a/packages/twenty-docs/l/it/developers/extend/apps/data/overview.mdx b/packages/twenty-docs/l/it/developers/extend/apps/data/overview.mdx
new file mode 100644
index 00000000000..705be44fb6d
--- /dev/null
+++ b/packages/twenty-docs/l/it/developers/extend/apps/data/overview.mdx
@@ -0,0 +1,97 @@
+---
+title: Panoramica
+description: Definisci i dati che la tua app aggiunge a uno spazio di lavoro — oggetti, campi e relazioni.
+icon: database
+---
+
+Il **data layer** di un'app Twenty è l'insieme dei dati che la tua app *aggiunge* a uno spazio di lavoro — i nuovi tipi di record che dichiara, le colonne che aggiunge agli oggetti esistenti e come questi record si collegano tra loro.
+
+```text
+┌──────────────────────────────────────────────────┐
+│ Object — a record type, e.g. PostCard │
+│ ├─ Field (name, type, label) │
+│ ├─ Field │
+│ └─ Relation (link to another object) │
+└──────────────────────────────────────────────────┘
+ │
+ ├── lives in your app, OR
+ │
+ ▼
+┌──────────────────────────────────────────────────┐
+│ Standard / other apps' objects │
+│ └─ Field added by your app via defineField │
+└──────────────────────────────────────────────────┘
+```
+
+## In questa sezione
+
+<CardGroup cols={2}>
+ <Card title="Oggetti" icon="tabella" href="/l/it/developers/extend/apps/data/objects">
+ `defineObject` — dichiara nuovi tipi di record con i propri campi.
+ </Card>
+ <Card title="Estendere gli oggetti" icon="wand-magic-sparkles" href="/l/it/developers/extend/apps/data/extending-objects">
+ `defineField` — aggiunge campi agli oggetti standard o di altre app.
+ </Card>
+ <Card title="Relazioni" icon="diagram-project" href="/l/it/developers/extend/apps/data/relations">
+ Connessioni bidirezionali `MANY_TO_ONE` / `ONE_TO_MANY` tra oggetti.
+ </Card>
+</CardGroup>
+
+## Entità in sintesi
+
+| Entità | Scopo | Definito con |
+| ------------- | --------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------- |
+| **Oggetto** | Un nuovo tipo di record personalizzato (ad es. PostCard, Invoice) con i propri campi | `defineObject()` |
+| **Campo** | Una colonna su un oggetto. I campi autonomi possono estendere oggetti che non hai creato tu (ad es. aggiungere `loyaltyTier` a Company) | `defineField()` |
+| **Relazione** | Un collegamento bidirezionale tra due oggetti — entrambi i lati sono dichiarati come campi | `defineField()` con `FieldType.RELATION` |
+| **Indice** | Un indice di database per velocizzare una query ricorrente su uno dei tuoi oggetti | `defineIndex()` |
+
+L'SDK rileva questi elementi tramite analisi AST in fase di build, quindi l'organizzazione dei file dipende da te — la convenzione è `src/objects/`, `src/fields/` e `src/indexes/`. Gli UUID `universalIdentifier` stabili collegano tutto tra le varie distribuzioni.
+
+## Indici (facoltativi)
+
+Le app possono distribuire indici insieme ai loro oggetti per mantenere veloci le query ricorrenti. Il caso più comune è una colonna di stato o di chiave esterna che leggi spesso.
+
+```ts src/indexes/post-card-status.index.ts
+import { defineIndex } from 'twenty-sdk/define';
+
+import {
+ POST_CARD_UNIVERSAL_IDENTIFIER,
+ STATUS_FIELD_UNIVERSAL_IDENTIFIER,
+} from '../objects/post-card.object';
+
+export default defineIndex({
+ universalIdentifier: 'b6e9d2a1-5a4c-46ca-9d52-42c8f02d1ff0',
+ objectUniversalIdentifier: POST_CARD_UNIVERSAL_IDENTIFIER,
+ fields: [
+ {
+ universalIdentifier: 'b6e9d2a1-5a4c-46ca-9d52-42c8f02d1ff1',
+ fieldUniversalIdentifier: STATUS_FIELD_UNIVERSAL_IDENTIFIER,
+ },
+ ],
+});
+```
+
+### Indici univoci
+
+`defineIndex` accetta `isUnique: true` sia per l'univocità a singola colonna sia per quella multi-colonna. Questa è la primitiva consigliata — `defineField({ isUnique: true })` è deprecata e verrà rimossa in una futura release.
+
+```ts
+defineIndex({
+ universalIdentifier: '…',
+ objectUniversalIdentifier: PERSON_UNIVERSAL_IDENTIFIER,
+ isUnique: true,
+ fields: [{ universalIdentifier: '…', fieldUniversalIdentifier: EMAIL_FIELD_UNIVERSAL_IDENTIFIER }],
+});
+```
+
+### Altri vincoli
+
+* Le clausole `WHERE` parziali restano sotto il controllo dell'amministratore — le app non possono dichiararle.
+* Ogni oggetto è limitato a 10 indici personalizzati (gli indici propri del framework non contano).
+
+Ordina l'array `fields` nel modo in cui Postgres dovrebbe usarlo — la colonna più a sinistra per prima, come in un elenco telefonico. Gli indici non sono gratuiti: ogni scrittura sulla tabella li aggiorna. Aggiungine uno solo quando hai una query che ne ha bisogno.
+
+<Note>
+Cerchi **Application Config** o **Roles & Permissions**? Quelli descrivono l'app in sé piuttosto che i dati che aggiunge — si trovano sotto [Config](/l/it/developers/extend/apps/config/overview). Cerchi **Connections** (Linear, GitHub, Slack OAuth)? Quelle esistono per essere chiamate *dalle* funzioni di logica e si trovano sotto [Logic](/l/it/developers/extend/apps/logic/connections).
+</Note>
diff --git a/packages/twenty-docs/l/it/developers/extend/apps/data/relations.mdx b/packages/twenty-docs/l/it/developers/extend/apps/data/relations.mdx
new file mode 100644
index 00000000000..6e4dae5a3d0
--- /dev/null
+++ b/packages/twenty-docs/l/it/developers/extend/apps/data/relations.mdx
@@ -0,0 +1,160 @@
+---
+title: Relazioni
+description: Collega gli oggetti tra loro con relazioni bidirezionali MANY_TO_ONE / ONE_TO_MANY.
+icon: diagram-project
+---
+
+Le relazioni collegano due oggetti tra loro. In Twenty, le relazioni sono sempre **bidirezionali** — ogni relazione ha due lati e ciascun lato è dichiarato come un campo che fa riferimento all'altro.
+
+| Tipo di relazione | Descrizione | Ha una chiave esterna? |
+| ----------------- | --------------------------------------------------------------------- | ---------------------- |
+| `MANY_TO_ONE` | Molti record di questo oggetto puntano a un record della destinazione | Sì (`joinColumnName`) |
+| `ONE_TO_MANY` | Un record di questo oggetto ha molti record della destinazione | No (lato inverso) |
+
+## Come funzionano le relazioni
+
+Ogni relazione richiede **due campi** che fanno riferimento l'uno all'altro:
+
+1. Il lato **MANY_TO_ONE** — risiede sull'oggetto che detiene la chiave esterna.
+2. Il lato **ONE_TO_MANY** — risiede sull'oggetto che possiede la collezione.
+
+Entrambi i campi usano `FieldType.RELATION` e si riferiscono reciprocamente tramite `relationTargetFieldMetadataUniversalIdentifier`.
+
+## Esempio: Post Card ha molti destinatari
+
+Un `PostCard` può essere inviato a molti record `PostCardRecipient`. Ogni destinatario appartiene esattamente a una sola cartolina.
+
+**Passaggio 1: definisci il lato ONE_TO_MANY su PostCard** (il lato "uno"):
+
+```ts src/fields/post-card-recipients-on-post-card.field.ts
+import { defineField, FieldType, RelationType } from 'twenty-sdk/define';
+import { POST_CARD_UNIVERSAL_IDENTIFIER } from '../objects/post-card.object';
+import { POST_CARD_RECIPIENT_UNIVERSAL_IDENTIFIER } from '../objects/post-card-recipient.object';
+
+// Export so the other side can reference it
+export const POST_CARD_RECIPIENTS_FIELD_ID = 'a1111111-1111-1111-1111-111111111111';
+// Import from the other side
+import { POST_CARD_FIELD_ID } from './post-card-on-post-card-recipient.field';
+
+export default defineField({
+ universalIdentifier: POST_CARD_RECIPIENTS_FIELD_ID,
+ objectUniversalIdentifier: POST_CARD_UNIVERSAL_IDENTIFIER,
+ type: FieldType.RELATION,
+ name: 'postCardRecipients',
+ label: 'Post Card Recipients',
+ icon: 'IconUsers',
+ relationTargetObjectMetadataUniversalIdentifier: POST_CARD_RECIPIENT_UNIVERSAL_IDENTIFIER,
+ relationTargetFieldMetadataUniversalIdentifier: POST_CARD_FIELD_ID,
+ universalSettings: {
+ relationType: RelationType.ONE_TO_MANY,
+ },
+});
+```
+
+**Passaggio 2: definisci il lato MANY_TO_ONE su PostCardRecipient** (il lato "molti" — contiene la chiave esterna):
+
+```ts src/fields/post-card-on-post-card-recipient.field.ts
+import { defineField, FieldType, RelationType, OnDeleteAction } from 'twenty-sdk/define';
+import { POST_CARD_UNIVERSAL_IDENTIFIER } from '../objects/post-card.object';
+import { POST_CARD_RECIPIENT_UNIVERSAL_IDENTIFIER } from '../objects/post-card-recipient.object';
+
+// Export so the other side can reference it
+export const POST_CARD_FIELD_ID = 'b2222222-2222-2222-2222-222222222222';
+// Import from the other side
+import { POST_CARD_RECIPIENTS_FIELD_ID } from './post-card-recipients-on-post-card.field';
+
+export default defineField({
+ universalIdentifier: POST_CARD_FIELD_ID,
+ objectUniversalIdentifier: POST_CARD_RECIPIENT_UNIVERSAL_IDENTIFIER,
+ type: FieldType.RELATION,
+ name: 'postCard',
+ label: 'Post Card',
+ icon: 'IconMail',
+ relationTargetObjectMetadataUniversalIdentifier: POST_CARD_UNIVERSAL_IDENTIFIER,
+ relationTargetFieldMetadataUniversalIdentifier: POST_CARD_RECIPIENTS_FIELD_ID,
+ universalSettings: {
+ relationType: RelationType.MANY_TO_ONE,
+ onDelete: OnDeleteAction.CASCADE,
+ joinColumnName: 'postCardId',
+ },
+});
+```
+
+<Note>
+**Importazioni circolari:** entrambi i campi di relazione fanno riferimento all'`universalIdentifier` dell'altro. Per evitare problemi di importazioni circolari, esporta gli ID dei campi come costanti denominate da ciascun file e importale nell'altro. Il sistema di build le risolve in fase di compilazione.
+</Note>
+
+## Relazioni con gli oggetti standard
+
+Per creare una relazione con un oggetto Twenty integrato (Person, Company, ecc.), usa `STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS`:
+
+```ts src/fields/person-on-self-hosting-user.field.ts
+import {
+ defineField,
+ FieldType,
+ RelationType,
+ OnDeleteAction,
+ STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS,
+} from 'twenty-sdk/define';
+import { SELF_HOSTING_USER_UNIVERSAL_IDENTIFIER } from '../objects/self-hosting-user.object';
+
+export const PERSON_FIELD_ID = 'c3333333-3333-3333-3333-333333333333';
+export const SELF_HOSTING_USER_REVERSE_FIELD_ID = 'd4444444-4444-4444-4444-444444444444';
+
+export default defineField({
+ universalIdentifier: PERSON_FIELD_ID,
+ objectUniversalIdentifier: SELF_HOSTING_USER_UNIVERSAL_IDENTIFIER,
+ type: FieldType.RELATION,
+ name: 'person',
+ label: 'Person',
+ description: 'Person matching with the self hosting user',
+ isNullable: true,
+ relationTargetObjectMetadataUniversalIdentifier:
+ STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS.person.universalIdentifier,
+ relationTargetFieldMetadataUniversalIdentifier: SELF_HOSTING_USER_REVERSE_FIELD_ID,
+ universalSettings: {
+ relationType: RelationType.MANY_TO_ONE,
+ onDelete: OnDeleteAction.SET_NULL,
+ joinColumnName: 'personId',
+ },
+});
+```
+
+## Proprietà dei campi di relazione
+
+| Proprietà | Obbligatorio | Descrizione |
+| ------------------------------------------------- | ---------------- | ---------------------------------------------------------------------------------------------------------- |
+| `type` | Sì | Deve essere `FieldType.RELATION` |
+| `relationTargetObjectMetadataUniversalIdentifier` | Sì | L'`universalIdentifier` dell'oggetto di destinazione |
+| `relationTargetFieldMetadataUniversalIdentifier` | Sì | L'`universalIdentifier` del campo corrispondente sull'oggetto di destinazione |
+| `universalSettings.relationType` | Sì | `RelationType.MANY_TO_ONE` o `RelationType.ONE_TO_MANY` |
+| `universalSettings.onDelete` | Solo MANY_TO_ONE | Cosa accade quando il record referenziato viene eliminato: `CASCADE`, `SET_NULL`, `RESTRICT` o `NO_ACTION` |
+| `universalSettings.joinColumnName` | Solo MANY_TO_ONE | Nome della colonna del database per la chiave esterna (ad es., `postCardId`) |
+
+## Campi di relazione inline
+
+Puoi anche dichiarare una relazione direttamente all'interno di [`defineObject`](/l/it/developers/extend/apps/data/objects). Quando è inline, ometti `objectUniversalIdentifier` — viene ereditato dall'oggetto padre:
+
+```ts
+export default defineObject({
+ universalIdentifier: '...',
+ nameSingular: 'postCardRecipient',
+ // ...
+ fields: [
+ {
+ universalIdentifier: POST_CARD_FIELD_ID,
+ type: FieldType.RELATION,
+ name: 'postCard',
+ label: 'Post Card',
+ relationTargetObjectMetadataUniversalIdentifier: POST_CARD_UNIVERSAL_IDENTIFIER,
+ relationTargetFieldMetadataUniversalIdentifier: POST_CARD_RECIPIENTS_FIELD_ID,
+ universalSettings: {
+ relationType: RelationType.MANY_TO_ONE,
+ onDelete: OnDeleteAction.CASCADE,
+ joinColumnName: 'postCardId',
+ },
+ },
+ // … other fields
+ ],
+});
+```
diff --git a/packages/twenty-docs/l/it/developers/extend/apps/getting-started/concepts.mdx b/packages/twenty-docs/l/it/developers/extend/apps/getting-started/concepts.mdx
new file mode 100644
index 00000000000..07a8db4a25d
--- /dev/null
+++ b/packages/twenty-docs/l/it/developers/extend/apps/getting-started/concepts.mdx
@@ -0,0 +1,101 @@
+---
+title: Concetti
+description: Come funzionano le app Twenty — modello di entità, sandboxing e ciclo di vita dell’installazione.
+icon: sitemap
+---
+
+Le app di Twenty sono pacchetti TypeScript che estendono il tuo spazio di lavoro con oggetti personalizzati, logica, componenti dell'interfaccia utente (UI) e funzionalità di IA. Vengono eseguite sulla piattaforma Twenty con sandboxing completo e controlli delle autorizzazioni.
+
+## Come funzionano le app
+
+Un'app è una raccolta di **entità** dichiarate utilizzando le funzioni `defineEntity()` del pacchetto `twenty-sdk`. L'SDK rileva queste dichiarazioni tramite analisi dell'AST in fase di build e produce un **manifest** — una descrizione completa di ciò che la tua app aggiunge a uno spazio di lavoro. Queste funzioni convalidano la configurazione in fase di build e offrono il completamento automatico nell'IDE e la sicurezza dei tipi.
+
+```
+your-app/
+├── src/
+│ ├── application-config.ts ← defineApplication (required, one per app)
+│ ├── roles/ ← defineRole
+│ ├── objects/ ← defineObject
+│ ├── fields/ ← defineField
+│ ├── logic-functions/ ← defineLogicFunction
+│ ├── front-components/ ← defineFrontComponent
+│ ├── skills/ ← defineSkill
+│ ├── agents/ ← defineAgent
+│ ├── views/ ← defineView
+│ ├── navigation-menu-items/ ← defineNavigationMenuItem
+│ └── page-layouts/ ← definePageLayout
+├── public/ ← Static assets (images, icons)
+└── package.json
+```
+
+<Note>
+ **L'organizzazione dei file dipende da te.** Il rilevamento delle entità è basato sull'AST — l'SDK trova le chiamate a `export default defineEntity(...)` indipendentemente da dove si trova il file. La struttura delle cartelle sopra è una convenzione, non un requisito.
+</Note>
+
+## Tipi di entità
+
+| Entità | Scopo | Documentazione |
+| -------------------------------- | ------------------------------------------------------ | ------------------------------------------------------------------------------------ |
+| **Applicazione** | Identità dell’app, ruolo predefinito, variabili | [Configurazione dell’applicazione](/l/it/developers/extend/apps/config/application) |
+| **Ruolo** | Set di autorizzazioni per oggetti e campi | [Ruoli e autorizzazioni](/l/it/developers/extend/apps/config/roles) |
+| **Oggetto** | Tipi di record personalizzati con campi | [Oggetti](/l/it/developers/extend/apps/data/objects) |
+| **Campo** | Aggiungi campi agli oggetti di altre app | [Estensione degli oggetti](/l/it/developers/extend/apps/data/extending-objects) |
+| **Relazione** | Collegamenti bidirezionali tra oggetti | [Relazioni](/l/it/developers/extend/apps/data/relations) |
+| **Funzione logica** | TypeScript lato server con trigger | [Funzioni logiche](/l/it/developers/extend/apps/logic/logic-functions) |
+| **Abilità** | Istruzioni riutilizzabili per agenti IA | [Abilità e agenti](/l/it/developers/extend/apps/logic/skills-and-agents) |
+| **Agente** | Assistenti IA con prompt personalizzati | [Abilità e agenti](/l/it/developers/extend/apps/logic/skills-and-agents) |
+| **Provider di connessione** | Credenziali OAuth per API di terze parti | [Connessioni](/l/it/developers/extend/apps/logic/connections) |
+| **Vista** | Viste di elenco dei record preconfigurate | [Viste](/l/it/developers/extend/apps/layout/views) |
+| **Voce del menu di navigazione** | Voci della barra laterale personalizzate | [Voci del menu di navigazione](/l/it/developers/extend/apps/layout/navigation-menu-items) |
+| **Layout di pagina** | Schede e widget nella pagina dei dettagli di un record | [Layout di pagina](/l/it/developers/extend/apps/layout/page-layouts) |
+| **Componente front-end** | UI React in sandbox all’interno di Twenty | [Componenti front-end](/l/it/developers/extend/apps/layout/front-components) |
+| **Voce del menu comandi** | Azioni rapide e voci Cmd+K | [Voci del menu comandi](/l/it/developers/extend/apps/layout/command-menu-items) |
+
+## Sandboxing
+
+* **Le funzioni logiche** vengono eseguite in processi Node.js isolati sul server. Accedono ai dati solo tramite il 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). Comunicano con Twenty tramite un'API host basata sul passaggio di messaggi.
+* **Le autorizzazioni** vengono applicate a livello di API. Il token di runtime (`TWENTY_APP_ACCESS_TOKEN`) è derivato dal ruolo definito in `defineApplication()`.
+
+## Ciclo di vita dell'app
+
+```
+┌─────────────────────────────────────────────────────────┐
+│ Development │
+│ npx create-twenty-app → yarn twenty dev (live sync) │
+├─────────────────────────────────────────────────────────┤
+│ Build & Deploy │
+│ yarn twenty dev:build → yarn twenty app:publish │
+├─────────────────────────────────────────────────────────┤
+│ Install flow │
+│ upload → [pre-install] → metadata migration → │
+│ generate SDK → [post-install] │
+├─────────────────────────────────────────────────────────┤
+│ Publish │
+│ npm publish → appears in Twenty marketplace │
+└─────────────────────────────────────────────────────────┘
+```
+
+* **`yarn twenty dev`** — monitora i file sorgente e sincronizza in tempo reale le modifiche su un server Twenty connesso. Il client API tipizzato viene rigenerato automaticamente quando lo schema cambia.
+* **`yarn twenty dev:build`** — compila TypeScript, crea i bundle delle funzioni logiche e dei componenti front-end con esbuild e produce un manifest.
+* **Hook di pre/post-installazione** — funzioni opzionali che vengono eseguite durante l’installazione. Vedi [Hook di installazione](/l/it/developers/extend/apps/config/install-hooks) per i dettagli.
+
+## Prossimi passaggi
+
+<CardGroup cols={2}>
+ <Card title="Configurazione" icon="screwdriver-wrench" href="/l/it/developers/extend/apps/config/overview">
+ Identità dell’applicazione, ruolo predefinito e hook di installazione.
+ </Card>
+ <Card title="Dati" icon="database" href="/l/it/developers/extend/apps/data/overview">
+ Oggetti, campi e relazioni bidirezionali.
+ </Card>
+ <Card title="Logica" icon="bolt" href="/l/it/developers/extend/apps/logic/overview">
+ Funzioni logiche, abilità, agenti e connessioni OAuth.
+ </Card>
+ <Card title="Layout" icon="table-columns" href="/l/it/developers/extend/apps/layout/overview">
+ Viste, navigazione, layout di pagina, componenti front-end.
+ </Card>
+ <Card title="Operazioni" icon="rocket" href="/l/it/developers/extend/apps/operations/overview">
+ CLI, test, remoti, CI e pubblicazione della tua app.
+ </Card>
+</CardGroup>
diff --git a/packages/twenty-docs/l/it/developers/extend/apps/getting-started/local-server.mdx b/packages/twenty-docs/l/it/developers/extend/apps/getting-started/local-server.mdx
new file mode 100644
index 00000000000..41dbe27c8c8
--- /dev/null
+++ b/packages/twenty-docs/l/it/developers/extend/apps/getting-started/local-server.mdx
@@ -0,0 +1,87 @@
+---
+title: Server locale
+description: Gestisci il server Docker Twenty locale — avvia, arresta, aggiorna, istanza di test parallela e configurazione manuale dell'SDK.
+icon: server
+---
+
+## Gestire il server locale
+
+Usa `yarn twenty docker:*` per controllare il container Twenty locale:
+
+| Comando | Cosa fa |
+| -------------------------------------- | -------------------------------------------------- |
+| `yarn twenty docker:start` | Avvia il server (scarica l'immagine se necessario) |
+| `yarn twenty docker:start 2.2.0` | Avvia una versione specifica del server |
+| `yarn twenty docker:start --port 3030` | Avvia su una porta personalizzata |
+| `yarn twenty docker:stop` | Arresta il server (conserva i dati) |
+| `yarn twenty docker:status` | Mostra URL, versione e credenziali di accesso |
+| `yarn twenty docker:logs` | Trasmetti in streaming i log del server |
+| `yarn twenty docker:reset` | Cancella i dati e riparti da zero |
+| `yarn twenty docker:upgrade` | Scarica l'ultima immagine `twenty-app-dev` |
+| `yarn twenty docker:upgrade 2.2.0` | Aggiorna a una versione specifica |
+
+I dati persistono tra i riavvii in due volumi Docker (`twenty-app-dev-data` per PostgreSQL, `twenty-app-dev-storage` per i file). Usa `reset` per cancellare tutto.
+
+## Blocco della versione del server
+
+Quando non viene passata alcuna versione, `docker:start` risolve la versione dall'intervallo `engines.twenty` della tua app in `package.json`, lo stesso intervallo rispetto al quale il server effettua la convalida quando la tua app viene installata. Avvia l'immagine `twenty-app-dev` più recente pubblicata che soddisfa l'intervallo, ricorrendo a `latest` quando il campo è assente o nessuna versione pubblicata corrisponde:
+
+```json filename="package.json"
+{
+ "engines": {
+ "twenty": ">=2.2.0"
+ }
+}
+```
+
+Passa esplicitamente una versione per ignorare l'intervallo per una singola esecuzione: `yarn twenty docker:start 2.3.0`. Se un container esiste già con una versione diversa, `docker:start` lo aggiorna sul posto (ricreando il container ma preservando i volumi dei tuoi dati).
+
+## Aggiornamento dell'immagine del server
+
+`yarn twenty docker:upgrade` scarica l'ultima immagine, confronta i digest e ricrea il container solo se è cambiato qualcosa. I volumi vengono preservati — viene sostituito solo il container. Se è stata scaricata una nuova immagine e il container era in esecuzione, l'upgrade avvia automaticamente un nuovo container; esegui poi `yarn twenty docker:start` per attendere che diventi operativo.
+
+```bash filename="Terminal"
+yarn twenty docker:upgrade # Latest
+yarn twenty docker:upgrade 2.2.0 # Specific version
+```
+
+Verifica la versione in esecuzione con `yarn twenty docker:status` (mostra `APP_VERSION` incorporata nel container).
+
+## Esecuzione di un'istanza di test parallela
+
+Passa `--test` a qualsiasi comando `docker:*` per gestire una seconda istanza completamente isolata — utile per test di integrazione o per sperimentare senza toccare i tuoi dati di sviluppo principali:
+
+| Comando | Cosa fa |
+| ----------------------------------- | ------------------------------------------------------------------------ |
+| `yarn twenty docker:start --test` | Avvia l'istanza di test (per impostazione predefinita usa la porta 2021) |
+| `yarn twenty docker:stop --test` | Arrestala |
+| `yarn twenty docker:status --test` | Mostra il suo stato |
+| `yarn twenty docker:logs --test` | Trasmetti in streaming i suoi log |
+| `yarn twenty docker:reset --test` | Cancella i suoi dati |
+| `yarn twenty docker:upgrade --test` | Aggiorna la sua immagine |
+
+L'istanza di test ha il proprio container (`twenty-app-dev-test`), i propri volumi (`twenty-app-dev-test-data`, `twenty-app-dev-test-storage`) e la propria configurazione — viene eseguita insieme alla tua istanza principale senza conflitti. Combina `--test` con `--port` per sovrascrivere 2021.
+
+## Configurazione manuale (senza lo scaffolder)
+
+Salta lo strumento di scaffolding se stai aggiungendo l'SDK a un progetto esistente:
+
+```bash filename="Terminal"
+yarn add twenty-sdk twenty-client-sdk
+```
+
+Aggiungi lo script a `package.json`:
+
+```json filename="package.json"
+{
+ "scripts": {
+ "twenty": "twenty"
+ }
+}
+```
+
+Ora puoi eseguire `yarn twenty dev`, `yarn twenty docker:start` e il resto.
+
+<Note>
+Non installare `twenty-sdk` globalmente — bloccalo per progetto in modo che ogni app usi la propria versione.
+</Note>
diff --git a/packages/twenty-docs/l/it/developers/extend/apps/getting-started/project-structure.mdx b/packages/twenty-docs/l/it/developers/extend/apps/getting-started/project-structure.mdx
new file mode 100644
index 00000000000..e92a1af1a5d
--- /dev/null
+++ b/packages/twenty-docs/l/it/developers/extend/apps/getting-started/project-structure.mdx
@@ -0,0 +1,61 @@
+---
+title: Struttura del progetto
+description: Cosa contiene un'app Twenty creata con lo scaffold — file, cartelle e cosa fa ognuno di essi.
+icon: folder-tree
+---
+
+Una nuova app generata da `npx create-twenty-app` si presenta così:
+
+```text filename="my-twenty-app/"
+my-twenty-app/
+ package.json
+ src/
+ application-config.ts # Required — your app's entry point
+ default-role.ts # Permissions for logic functions
+ constants/
+ universal-identifiers.ts # Auto-generated UUIDs and metadata
+ __tests__/
+ setup-test.ts
+ app-install.integration-test.ts
+ .github/workflows/ci.yml # GitHub Actions
+ public/ # Static assets
+ vitest.config.ts # Test runner config
+ tsconfig.json, tsconfig.spec.json
+ .nvmrc, .yarnrc.yml, .oxlintrc.json
+ README.md, LLMS.md
+```
+
+## File principali
+
+| File / Cartella | Scopo |
+| ---------------------------------------- | -------------------------------------------------------------------------------- |
+| `src/application-config.ts` | **Obbligatorio.** Il file di configurazione principale della tua app. |
+| `src/default-role.ts` | Ruolo predefinito che controlla a cosa possono accedere le tue funzioni logiche. |
+| `src/constants/universal-identifiers.ts` | UUID generati automaticamente e metadati (nome visualizzato, descrizione). |
+| `src/__tests__/` | Test di integrazione (setup + test di esempio). |
+| `public/` | Asset statici (immagini, font) serviti insieme alla tua app. |
+
+<Note>
+**L'organizzazione dei file dipende da te.** Le cartelle sopra sono convenzioni — l'SDK rileva le entità tramite analisi AST sulle chiamate a `export default defineEntity(...)` indipendentemente da dove si trova il file.
+</Note>
+
+## Dipendenze
+
+Entrambi i pacchetti Twenty SDK devono essere inseriti sotto `devDependencies`, non sotto `dependencies`:
+
+```json filename="package.json"
+{
+ "dependencies": {},
+ "devDependencies": {
+ "twenty-client-sdk": "^2.13.0",
+ "twenty-sdk": "^2.13.0"
+ }
+}
+```
+
+* **`twenty-sdk`** fornisce la CLI `twenty` e gli strumenti di build/scaffolding. Viene eseguito solo in fase di sviluppo e di build e non viene mai importato dal runtime dell'app pubblicata.
+* **`twenty-client-sdk`** *viene* importato dal codice della tua app (`CoreApiClient`, `MetadataApiClient`, `RestApiClient`), ma Twenty lo fornisce a runtime: le funzioni di logica lo ricevono da un layer SDK generato e i componenti di front-end lo risolvono da moduli forniti dal server. La copia installata viene utilizzata solo per il type checking e per la build al momento del deploy, quindi non è mai necessario includerla nel bundle distribuito.
+
+Mantenere uno qualsiasi dei pacchetti sotto `dependencies` lo inserisce nel bundle di runtime dell'app installata, dove rappresenta solo zavorra. `twenty build` emette un avviso quando uno dei due è ancora elencato sotto `dependencies`.
+
+Aggiungi come di consueto le dipendenze di runtime proprie della tua app (librerie che le tue funzioni di logica importano effettivamente a runtime) sotto `dependencies`.
diff --git a/packages/twenty-docs/l/it/developers/extend/apps/getting-started/quick-start.mdx b/packages/twenty-docs/l/it/developers/extend/apps/getting-started/quick-start.mdx
new file mode 100644
index 00000000000..7b0697aaa2d
--- /dev/null
+++ b/packages/twenty-docs/l/it/developers/extend/apps/getting-started/quick-start.mdx
@@ -0,0 +1,176 @@
+---
+title: Avvio rapido
+icon: rocket
+description: Crea la tua prima app Twenty in pochi minuti.
+---
+
+## Prerequisiti
+
+* **Node.js 24+** — [Scarica](https://nodejs.org/)
+* **Yarn 4** — incluso con Node.js tramite Corepack. Abilitalo: `corepack enable`
+* **Docker** — [Scarica](https://www.docker.com/products/docker-desktop/). Necessario per eseguire un server Twenty locale. Salta se hai già Twenty in esecuzione altrove.
+
+La creazione di un'app Twenty ha tre fasi. Lo strumento di scaffolding le combina in un unico comando per il percorso ottimale, ma ogni fase è un concetto distinto — quando qualcosa fallisce, sapere in quale fase ti trovi indica cosa correggere.
+
+| Fase | Cosa fai | Strumento | Risultato |
+| ----------------------- | ------------------------------------------------------ | ----------------------------- | ---------------------------------- |
+| **1. Crea struttura** | Genera il codice sorgente dell'app | `npx create-twenty-app` | Un progetto TypeScript sul disco |
+| **2. Esegui un server** | Avvia un server Twenty con cui sincronizzare | Docker + `yarn twenty server` | Un'istanza Twenty in esecuzione |
+| **3. Sincronizza** | Sincronizza in tempo reale il tuo codice con il server | `yarn twenty dev` | Le tue modifiche compaiono nell'UI |
+
+---
+
+## Fase 1 — Crea la struttura del progetto
+
+Crea una nuova app dal modello:
+
+```bash filename="Terminal"
+npx create-twenty-app@latest my-twenty-app
+```
+
+Ti verrà chiesto un nome e una descrizione — premi **Invio** per usare i valori predefiniti. Questo genera un progetto TypeScript in `my-twenty-app/` con un `application-config.ts` iniziale, un ruolo predefinito, un workflow CI e un test di integrazione.
+
+**Dopo questa fase:** hai il codice sorgente dell'app sulla tua macchina. Non è ancora in esecuzione — questa è la Fase 2.
+
+---
+
+## Fase 2 — Esegui un server Twenty locale
+
+La tua app ha bisogno di un server Twenty con cui sincronizzarsi. Il server è un'istanza Twenty completa — UI, API GraphQL, PostgreSQL — in esecuzione in locale su Docker. Il tuo codice locale carica le sue definizioni su quel server, che le rende visibili nell'UI.
+
+Lo strumento di scaffolding ti propone di avviarne uno per te:
+
+> **Vuoi configurare un'istanza locale di Twenty?**
+
+* **Sì (consigliato)** — scarica l'immagine Docker `twentycrm/twenty-app-dev` e la avvia sulla porta `2020`. Assicurati prima che Docker sia in esecuzione.
+* **No** — scegli questa opzione se hai già un server Twenty a cui vuoi connetterti. Puoi collegarlo in seguito con `yarn twenty remote:add`.
+
+<div style={{textAlign: 'center'}}>
+ <img src="/images/docs/developers/extends/apps/start-instance.png" alt="Avviare l'istanza locale?" />
+</div>
+
+Quando il server è attivo, si apre il browser per l'accesso. Usa l'account demo preconfigurato:
+
+* **Email:** `[email protected]`
+* **Password:** `[email protected]`
+
+<div style={{textAlign: 'center'}}>
+ <img src="/images/docs/developers/extends/apps/login.png" alt="Schermata di accesso di Twenty" />
+</div>
+
+Fai clic su **Authorize** nella schermata successiva — questo concede alla CLI l'accesso al tuo spazio di lavoro.
+
+<div style={{textAlign: 'center'}}>
+ <img src="/images/docs/developers/extends/apps/authorize.png" alt="Schermata di autorizzazione della CLI di Twenty" />
+</div>
+
+Il terminale confermerà che tutto è configurato.
+
+<div style={{textAlign: 'center'}}>
+ <img src="/images/docs/developers/extends/apps/scaffolded.png" alt="App creata con successo" />
+</div>
+
+**Dopo questa fase:** hai un server Twenty in esecuzione su [http://localhost:2020](http://localhost:2020) con la tua CLI autorizzata a sincronizzarsi con esso.
+
+<Note>
+Se Docker non è installato o in esecuzione, lo strumento di scaffolding ti indicherà il comando di avvio corretto per il tuo sistema operativo. Quando Docker è attivo, puoi riprendere con `yarn twenty docker:start` — non è necessario rifare lo scaffolding.
+</Note>
+
+---
+
+## Fase 3 — Sincronizza le tue modifiche
+
+Questo è il ciclo interno in cui passerai la maggior parte del tempo.
+
+```bash filename="Terminal"
+cd my-twenty-app
+yarn twenty dev
+```
+
+Questo osserva `src/`, ricompila a ogni modifica e sincronizza il risultato con il server. Modifica un file, salvalo e in pochi secondi il server riflette la modifica. Vedrai un pannello di stato in tempo reale nel terminale.
+
+Per un output più dettagliato (log di build, richieste di sincronizzazione, tracce di errore), aggiungi `--verbose`.
+
+<div style={{textAlign: 'center'}}>
+ <img src="/images/docs/developers/extends/apps/dev.png" alt="Output del terminale in modalità sviluppo" />
+</div>
+
+Apri [http://localhost:2020/settings/applications#developer](http://localhost:2020/settings/applications#developer). Dovresti vedere la tua app sotto **Your Apps**.
+
+<div style={{textAlign: 'center'}}>
+ <img src="/images/docs/developers/extends/apps/app-in-ui-1.png" alt="Elenco Your Apps che mostra My twenty app" />
+</div>
+
+Fai clic su **My twenty app** per vedere la sua **registrazione dell'applicazione** — un record a livello di server che descrive la tua app (nome, identificatore, credenziali OAuth, origine). Una registrazione può essere installata in più spazi di lavoro sullo stesso server.
+
+<div style={{textAlign: 'center'}}>
+ <img src="/images/docs/developers/extends/apps/app-in-ui-2.png" alt="Dettagli della registrazione dell'applicazione" />
+</div>
+
+Fai clic su **View installed app** per vedere l'installazione nello spazio di lavoro. La scheda **About** mostra la versione e le opzioni di gestione.
+
+<div style={{textAlign: 'center'}}>
+ <img src="/images/docs/developers/extends/apps/app-in-ui-3.png" alt="App installata" />
+</div>
+
+**Dopo questa fase:** hai un ciclo di sviluppo in tempo reale. Modifica qualsiasi file in `src/` e compare nell'UI.
+
+### Sincronizzazione una tantum per CI e script
+
+Passa `--once` per eseguire una singola build + sincronizzazione ed uscire — stessa pipeline, nessun watcher:
+
+```bash filename="Terminal"
+yarn twenty dev --once
+```
+
+| Comando | Comportamento | Quando usarlo |
+| ---------------------------------- | ---------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- |
+| `yarn twenty dev` | Monitora e risincronizza a ogni modifica. Rimane in esecuzione finché non lo interrompi. | Sviluppo locale interattivo. |
+| `yarn twenty dev --once` | Singola build + sincronizzazione, termina con codice `0` in caso di successo, `1` in caso di errore. | CI, hook pre-commit, agenti IA, flussi di lavoro scriptati. |
+| `yarn twenty dev --once --dry-run` | Crea e stampa le modifiche ai metadati **senza applicarle**. | Ispezionare quali modifiche verrebbero apportate da una sincronizzazione prima di confermarla. |
+
+Entrambe le modalità richiedono un remoto autenticato. Vedi [Sincronizzazione e ripristino](/l/it/developers/extend/apps/operations/sync-and-recovery#previewing-changes-dry-run) per maggiori informazioni su `--dry-run`.
+
+### Opzioni della modalità di sviluppo
+
+| Opzione | Descrizione |
+| ------------------------------------- | -------------------------------------------------------------------------------------------------- |
+| `--once` | Esegui una build e una sincronizzazione una sola volta, quindi esci. |
+| `--dry-run` | Con `--once`, visualizza in anteprima le modifiche ai metadati senza applicarle. Non scrive nulla. |
+| `--debounceMs \<ms>` | Imposta il ritardo di debounce delle modifiche ai file in millisecondi (predefinito: `2000`). |
+| `--verbose` / `--debug` | Mostra log di build dettagliati, richieste di sincronizzazione e tracce di errore. |
+
+## Cosa puoi creare
+
+Le app sono composte da **entità** — ciascuna definita come un file TypeScript con un singolo `export default`:
+
+| Entità | Cosa fa |
+| ------------------------ | ----------------------------------------------------------------------------------------------------------------- |
+| **Oggetti e campi** | Modelli di dati personalizzati (Cartolina, Fattura, ecc.) con campi tipizzati |
+| **Funzioni logiche** | TypeScript lato server attivato da route HTTP, pianificazioni cron o eventi del database |
+| **Componenti front-end** | Componenti React 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 |
+| **Layout di pagina** | Pagine di dettaglio dei record personalizzate con schede e widget |
+
+Riferimento completo: [Concetti](/l/it/developers/extend/apps/getting-started/concepts).
+
+## Prossimi passaggi
+
+<CardGroup cols={2}>
+ <Card title="Configurazione" icon="screwdriver-wrench" href="/l/it/developers/extend/apps/config/overview">
+ Identità dell'applicazione, ruolo predefinito, hook di installazione, asset pubblici.
+ </Card>
+ <Card title="Dati" icon="database" href="/l/it/developers/extend/apps/data/overview">
+ Oggetti, campi e relazioni bidirezionali.
+ </Card>
+ <Card title="Logica" icon="bolt" href="/l/it/developers/extend/apps/logic/overview">
+ Funzioni logiche, skill, agenti e connessioni OAuth.
+ </Card>
+ <Card title="Layout" icon="table-columns" href="/l/it/developers/extend/apps/layout/overview">
+ Viste, navigazione, layout di pagina, componenti front-end.
+ </Card>
+ <Card title="Operazioni" icon="rocket" href="/l/it/developers/extend/apps/operations/overview">
+ CLI, test, remoti, CI e pubblicazione della tua app.
+ </Card>
+</CardGroup>
diff --git a/packages/twenty-docs/l/it/developers/extend/apps/getting-started/scaffolding.mdx b/packages/twenty-docs/l/it/developers/extend/apps/getting-started/scaffolding.mdx
new file mode 100644
index 00000000000..7ba9719e94a
--- /dev/null
+++ b/packages/twenty-docs/l/it/developers/extend/apps/getting-started/scaffolding.mdx
@@ -0,0 +1,58 @@
+---
+title: Scaffolding
+description: "Genera i file delle entità in modo interattivo con yarn twenty dev:add: oggetti, campi, viste, funzioni di logica e altro ancora."
+icon: wand-magic-sparkles
+---
+
+Invece di creare manualmente i file delle entità, puoi usare lo scaffolder interattivo:
+
+```bash filename="Terminal"
+yarn twenty dev:add
+```
+
+Ti chiede di scegliere un tipo di entità e ti guida attraverso i campi richiesti, quindi scrive un file pronto all’uso con un `universalIdentifier` stabile e la corretta chiamata a `defineEntity()`.
+
+Puoi anche passare direttamente il tipo di entità per saltare il primo prompt:
+
+```bash filename="Terminal"
+yarn twenty dev:add object
+yarn twenty dev:add logicFunction
+yarn twenty dev:add frontComponent
+```
+
+## Tipi di entità disponibili
+
+| Tipo di entità | Comando | File generato |
+| ---------------------------- | ---------------------------------------- | ------------------------------------------------------- |
+| Oggetto | `yarn twenty dev:add object` | `src/objects/\<name>.ts` |
+| Campo | `yarn twenty dev:add field` | `src/fields/\<name>.ts` |
+| Funzione logica | `yarn twenty dev:add logicFunction` | `src/logic-functions/\<name>.ts` |
+| Componente front-end | `yarn twenty dev:add frontComponent` | `src/front-components/\<name>.tsx` |
+| Ruolo | `yarn twenty dev:add role` | `src/roles/\<name>.ts` |
+| Abilità | `yarn twenty dev:add skill` | `src/skills/\<name>.ts` |
+| Agente | `yarn twenty dev:add agent` | `src/agents/\<name>.ts` |
+| Vista | `yarn twenty dev:add view` | `src/views/\<name>.ts` |
+| Voce del menu di navigazione | `yarn twenty dev:add navigationMenuItem` | `src/navigation-menu-items/\<name>.ts` |
+| Layout di pagina | `yarn twenty dev:add pageLayout` | `src/page-layouts/\<name>.ts` |
+
+## Cosa genera lo scaffolder
+
+Ogni tipo di entità ha il proprio template. Ad esempio, `yarn twenty dev:add object` richiede:
+
+1. **Nome (singolare)** — ad es., `invoice`
+2. **Nome (plurale)** — ad es., `invoices`
+3. **Etichetta (singolare)** — compilata automaticamente dal nome (ad es., `Invoice`)
+4. **Etichetta (plurale)** — compilata automaticamente (ad es., `Invoices`)
+5. **Creare una vista e una voce di navigazione?** — se rispondi sì, lo scaffolder genera anche una vista corrispondente e un link nella barra laterale per il nuovo oggetto.
+
+Gli altri tipi di entità hanno prompt più semplici — la maggior parte chiede solo un nome.
+
+Il tipo di entità `field` è più dettagliato: chiede il nome del campo, l'etichetta, il tipo (da un elenco di tutti i tipi di campo disponibili come `TEXT`, `NUMBER`, `SELECT`, `RELATION`, ecc.) e l'`universalIdentifier` dell'oggetto di destinazione.
+
+## Percorso di output personalizzato
+
+Usa il flag `--path` per posizionare il file generato in una posizione personalizzata:
+
+```bash filename="Terminal"
+yarn twenty dev:add logicFunction --path src/custom-folder
+```
diff --git a/packages/twenty-docs/l/it/developers/extend/apps/getting-started/troubleshooting.mdx b/packages/twenty-docs/l/it/developers/extend/apps/getting-started/troubleshooting.mdx
new file mode 100644
index 00000000000..b8f92aff666
--- /dev/null
+++ b/packages/twenty-docs/l/it/developers/extend/apps/getting-started/troubleshooting.mdx
@@ -0,0 +1,14 @@
+---
+title: Risoluzione dei problemi
+description: Problemi comuni al primo avvio — Docker, versione di Node, Yarn, dipendenze.
+icon: wrench
+---
+
+* **Errori di Docker** — Assicurati che Docker Desktop (o il demone) sia in esecuzione prima di `yarn twenty docker:start`. Il messaggio di errore mostrerà il comando di avvio corretto per il tuo sistema operativo.
+* **Versione di Node errata** — È necessaria la versione 24 o superiore. Verifica con `node -v`.
+* **Manca Yarn 4** — Esegui `corepack enable`.
+* **Dipendenze danneggiate** — `rm -rf node_modules && yarn install`.
+* **Errori di `twenty-sdk` dopo l'aggiornamento alla v2.8.0** — è stato spostato da `dependencies` a `devDependencies` nella v2.8.0. Vedi [Struttura del progetto → Dipendenze](/l/it/developers/extend/apps/getting-started/project-structure#dependencies).
+* **`twenty build` mostra un avviso su `twenty-client-sdk` sotto `dependencies`** — viene fornito in fase di esecuzione da Twenty, quindi dovrebbe essere spostato in `devDependencies` insieme a `twenty-sdk`. Vedi [Struttura del progetto → Dipendenze](/l/it/developers/extend/apps/getting-started/project-structure#dependencies).
+
+Bloccato? Chiedi aiuto su [Discord di Twenty](https://discord.com/channels/1130383047699738754/1130386664812982322).
diff --git a/packages/twenty-docs/l/it/developers/extend/apps/layout/command-menu-items.mdx b/packages/twenty-docs/l/it/developers/extend/apps/layout/command-menu-items.mdx
new file mode 100644
index 00000000000..fa917caf291
--- /dev/null
+++ b/packages/twenty-docs/l/it/developers/extend/apps/layout/command-menu-items.mdx
@@ -0,0 +1,148 @@
+---
+title: Voci del menu comandi
+description: Esponi i componenti front-end come azioni rapide e voci del menu comandi (Cmd+K) con defineCommandMenuItem.
+icon: terminale
+---
+
+Un **elemento del menu comandi** è il collegamento tra l'utente e un [front component](/l/it/developers/extend/apps/layout/front-components). Registra il componente nel menu comandi (Cmd+K) di Twenty e, opzionalmente, come pulsante di azione rapida fissato nell'angolo in alto a destra della pagina.
+
+```ts src/command-menu-items/open-dashboard.command-menu-item.ts
+import { defineCommandMenuItem } from 'twenty-sdk/define';
+
+export default defineCommandMenuItem({
+ universalIdentifier: 'a1b2c3d4-e5f6-7890-abcd-ef1234567890',
+ label: 'Open Dashboard',
+ shortLabel: 'Dashboard',
+ icon: 'IconLayoutDashboard',
+ isPinned: true,
+ availabilityType: 'GLOBAL',
+ frontComponentUniversalIdentifier: '74c526eb-cb68-4cf7-b05c-0dd8c288d948',
+});
+```
+
+## Campi di configurazione
+
+| Campo | Obbligatorio | Descrizione |
+| --------------------------------------- | ------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `universalIdentifier` | Sì | ID univoco stabile per il comando |
+| `label` | Sì | Etichetta completa mostrata nel menu comandi (Cmd+K) |
+| `frontComponentUniversalIdentifier` | Sì | L'`universalIdentifier` del componente front-end che questo comando apre |
+| `shortLabel` | No | Etichetta breve visualizzata sul pulsante di azione rapida fissato |
+| `icon` | No | Nome dell'icona visualizzato accanto all'etichetta (ad es. `'IconBolt'`, `'IconSend'`) |
+| `isPinned` | No | Quando `true`, mostra il comando come pulsante di azione rapida nell'angolo in alto a destra della pagina |
+| `availabilityType` | No | Controlla dove compare il comando: `'GLOBAL'` (sempre disponibile), `'RECORD_SELECTION'` (solo quando sono selezionati dei record) o `'FALLBACK'` (mostrato quando nessun altro comando corrisponde) |
+| `availabilityObjectUniversalIdentifier` | No | Limita il comando alle pagine di uno specifico tipo di oggetto (ad es. solo sui record Company) |
+| `conditionalAvailabilityExpression` | No | Un'espressione booleana che controlla dinamicamente la visibilità (vedi sotto) |
+
+## Comandi headless
+
+Un elemento del menu comandi abbinato a un [headless front component](/l/it/developers/extend/apps/layout/front-components#headless-vs-non-headless) è il modo idiomatico per distribuire un'azione con un clic: eseguire codice, navigare oppure confermare ed eseguire. La pagina Front Components tratta i [SDK Command components](/l/it/developers/extend/apps/layout/front-components#sdk-command-components) (`Command`, `CommandLink`, `CommandModal`, `CommandOpenSidePanelPage`) che gestiscono il pattern di action-and-unmount.
+
+Un flusso tipico:
+
+```tsx src/front-components/run-action.tsx
+import { defineFrontComponent } from 'twenty-sdk/define';
+import { Command } from 'twenty-sdk/command';
+import { CoreApiClient } from 'twenty-sdk/clients';
+
+const RunAction = () => {
+ const execute = async () => {
+ const client = new CoreApiClient();
+ await client.mutation({
+ createTask: {
+ __args: { data: { title: 'Created by my app' } },
+ id: true,
+ },
+ });
+ };
+
+ return <Command execute={execute} />;
+};
+
+export default defineFrontComponent({
+ universalIdentifier: 'e5f6a7b8-c9d0-1234-efab-345678901234',
+ name: 'run-action',
+ description: 'Creates a task from the command menu',
+ component: RunAction,
+ isHeadless: true,
+});
+```
+
+```ts src/command-menu-items/run-action.command-menu-item.ts
+import { defineCommandMenuItem } from 'twenty-sdk/define';
+
+export default defineCommandMenuItem({
+ universalIdentifier: 'f6a7b8c9-d0e1-2345-fabc-456789012345',
+ label: 'Run my action',
+ icon: 'IconPlayerPlay',
+ frontComponentUniversalIdentifier: 'e5f6a7b8-c9d0-1234-efab-345678901234',
+});
+```
+
+## Espressioni di disponibilità condizionale
+
+Il campo `conditionalAvailabilityExpression` consente di controllare quando un comando è visibile in base al contesto della pagina corrente. Importa variabili tipizzate e operatori da `twenty-sdk` per costruire espressioni:
+
+```ts src/command-menu-items/bulk-update.command-menu-item.ts
+import {
+ defineCommandMenuItem,
+ objectPermissions,
+ everyEquals,
+} from 'twenty-sdk/define';
+
+export default defineCommandMenuItem({
+ universalIdentifier: '...',
+ label: 'Bulk Update',
+ availabilityType: 'RECORD_SELECTION',
+ frontComponentUniversalIdentifier: '...',
+ conditionalAvailabilityExpression: everyEquals(
+ objectPermissions,
+ 'canUpdateObjectRecords',
+ true,
+ ),
+});
+```
+
+<Note>
+ `RECORD_SELECTION` implica già una selezione non vuota — usa `numberOfSelectedRecords` solo per conteggi specifici (ad es. `>= 2`).
+</Note>
+
+### Variabili di contesto
+
+Rappresentano lo stato corrente della pagina:
+
+| Variabile | Tipo | Descrizione |
+| ------------------------------ | --------- | ------------------------------------------------------------------------ |
+| `pageType` | `string` | Tipo di pagina corrente (ad es. `'RecordIndexPage'`, `'RecordShowPage'`) |
+| `isInSidePanel` | `boolean` | Indica se il componente è renderizzato in un pannello laterale |
+| `numberOfSelectedRecords` | `number` | Numero di record attualmente selezionati |
+| `isSelectAll` | `boolean` | Indica se "seleziona tutto" è attivo |
+| `selectedRecords` | `array` | Gli oggetti dei record selezionati |
+| `favoriteRecordIds` | `array` | ID dei record aggiunti ai preferiti |
+| `objectPermissions` | `object` | Autorizzazioni per il tipo di oggetto corrente |
+| `targetObjectReadPermissions` | `object` | Autorizzazioni di lettura per l'oggetto di destinazione |
+| `targetObjectWritePermissions` | `object` | Autorizzazioni di scrittura per l'oggetto di destinazione |
+| `featureFlags` | `object` | Flag delle funzionalità attivi |
+| `objectMetadataItem` | `object` | Metadati del tipo di oggetto corrente |
+| `hasAnySoftDeleteFilterOnView` | `boolean` | Indica se la vista corrente ha un filtro di soft-delete |
+
+### Operatori
+
+Combinano le variabili in espressioni booleane:
+
+| Operatore | Descrizione |
+| ----------------------------------- | -------------------------------------------------------------------- |
+| `isDefined(value)` | `true` se il valore non è null/undefined |
+| `isNonEmptyString(value)` | `true` se il valore è una stringa non vuota |
+| `includes(array, value)` | `true` se l'array contiene il valore |
+| `includesEvery(array, prop, value)` | `true` se la proprietà di ogni elemento include il valore |
+| `every(array, prop)` | `true` se la proprietà è truthy su ogni elemento |
+| `everyDefined(array, prop)` | `true` se la proprietà è definita su ogni elemento |
+| `everyEquals(array, prop, value)` | `true` se la proprietà è uguale al valore su ogni elemento |
+| `some(array, prop)` | `true` se la proprietà è truthy su almeno un elemento |
+| `someDefined(array, prop)` | `true` se la proprietà è definita su almeno un elemento |
+| `someEquals(array, prop, value)` | `true` se la proprietà è uguale al valore su almeno un elemento |
+| `someNonEmptyString(array, prop)` | `true` se la proprietà è una stringa non vuota su almeno un elemento |
+| `none(array, prop)` | `true` se la proprietà è falsy su ogni elemento |
+| `noneDefined(array, prop)` | `true` se la proprietà è undefined su ogni elemento |
+| `noneEquals(array, prop, value)` | `true` se la proprietà non è uguale al valore su alcun elemento |
diff --git a/packages/twenty-docs/l/it/developers/extend/apps/layout/front-components.mdx b/packages/twenty-docs/l/it/developers/extend/apps/layout/front-components.mdx
new file mode 100644
index 00000000000..2d5311f20eb
--- /dev/null
+++ b/packages/twenty-docs/l/it/developers/extend/apps/layout/front-components.mdx
@@ -0,0 +1,545 @@
+---
+title: Componenti front-end
+description: Crea componenti React che vengono renderizzati all'interno della UI di Twenty con isolamento in sandbox.
+icon: window-maximize
+---
+
+I componenti front-end sono componenti React che vengono renderizzati direttamente all'interno della UI di Twenty. Vengono eseguiti in un **Web Worker** isolato utilizzando Remote DOM — il tuo codice è in sandbox ma viene renderizzato in modo nativo nella pagina, non in un iframe.
+
+## Dove possono essere utilizzati i componenti front-end
+
+I componenti front-end possono essere renderizzati in due posizioni all'interno di Twenty:
+
+* **Pannello laterale** — I componenti front-end non headless si aprono nel pannello laterale destro. Questo è il comportamento predefinito quando un componente front-end viene avviato dal menu comandi.
+* **Widget (dashboard e pagine dei record)** — I componenti front possono essere incorporati come widget all'interno dei [layout di pagina](/l/it/developers/extend/apps/layout/page-layouts). Quando si configura una dashboard o il layout di una pagina record, gli utenti possono aggiungere un widget del componente front-end.
+
+Un componente front da solo non è raggiungibile dall'interfaccia utente: devi renderlo visibile. I due modi per farlo sono:
+
+* **Associarlo a un [elemento di menu dei comandi](/l/it/developers/extend/apps/layout/command-menu-items)** — lo registra nel menu dei comandi (Cmd+K) e, facoltativamente, come azione rapida fissata.
+* **Incorporarlo come widget in un [layout di pagina](/l/it/developers/extend/apps/layout/page-layouts)** — lo posiziona nella pagina dei dettagli di un record o in una dashboard.
+
+## Esempio di base
+
+Il modo più rapido per vedere un componente front in azione è associarlo a [`defineCommandMenuItem`](/l/it/developers/extend/apps/layout/command-menu-items), così appare come pulsante di azione rapida nell’angolo in alto a destra della pagina:
+
+```tsx src/front-components/hello-world.tsx
+import { defineFrontComponent } from 'twenty-sdk/define';
+
+const HelloWorld = () => {
+ return (
+ <div style={{ padding: '20px', fontFamily: 'sans-serif' }}>
+ <h1>Hello from my app!</h1>
+ <p>This component renders inside Twenty.</p>
+ </div>
+ );
+};
+
+export default defineFrontComponent({
+ universalIdentifier: '74c526eb-cb68-4cf7-b05c-0dd8c288d948',
+ name: 'hello-world',
+ description: 'A simple front component',
+ component: HelloWorld,
+});
+```
+
+```ts src/command-menu-items/hello-world.command-menu-item.ts
+import { defineCommandMenuItem } from 'twenty-sdk/define';
+
+export default defineCommandMenuItem({
+ universalIdentifier: 'd4e5f6a7-b8c9-0123-defa-456789012345',
+ shortLabel: 'Hello',
+ label: 'Hello World',
+ icon: 'IconBolt',
+ isPinned: true,
+ availabilityType: 'GLOBAL',
+ frontComponentUniversalIdentifier: '74c526eb-cb68-4cf7-b05c-0dd8c288d948',
+});
+```
+
+Dopo la sincronizzazione con `yarn twenty dev` (o eseguendo una volta sola `yarn twenty dev --once`), l'azione rapida appare nell'angolo in alto a destra della pagina:
+
+<div style={{textAlign: 'center'}}>
+ <img src="/images/docs/developers/extends/apps/quick-action.png" alt="Pulsante di azione rapida nell'angolo in alto a destra" />
+</div>
+
+Fai clic per renderizzare il componente in linea.
+
+## Campi di configurazione
+
+| Campo | Obbligatorio | Descrizione |
+| --------------------- | ------------ | ---------------------------------------------------------------------- |
+| `universalIdentifier` | Sì | ID univoco stabile per questo componente |
+| `component` | Sì | Una funzione di componente React |
+| `name` | No | Nome visualizzato |
+| `description` | No | Descrizione di ciò che fa il componente |
+| `isHeadless` | No | Imposta su `true` se il componente non ha una UI visibile (vedi sotto) |
+
+## Posizionare un componente front-end su una pagina
+
+Oltre ai comandi, puoi incorporare un componente front-end direttamente in una pagina record aggiungendolo come widget in un **layout di pagina**. Vedi [Layout di pagina](/l/it/developers/extend/apps/layout/page-layouts) per i dettagli.
+
+## Headless vs non headless
+
+I componenti front-end prevedono due modalità di rendering controllate dall'opzione `isHeadless`:
+
+**Non headless (predefinito)** — Il componente renderizza un'interfaccia utente visibile. Quando viene avviato dal menu comandi, si apre nel pannello laterale. Questo è il comportamento predefinito quando `isHeadless` è `false` o omesso.
+
+**Headless (`isHeadless: true`)** — Il componente viene montato in modo invisibile in background. Non apre il pannello laterale. I componenti headless sono pensati per azioni che eseguono una logica e poi si smontano — ad esempio, eseguire un'attività asincrona, navigare a una pagina o mostrare una finestra modale di conferma. Si abbinano naturalmente ai componenti Command dell'SDK descritti di seguito.
+
+```tsx src/front-components/sync-tracker.tsx
+import { defineFrontComponent } from 'twenty-sdk/define';
+import { useRecordId, enqueueSnackbar } from 'twenty-sdk/front-component';
+import { useEffect } from 'react';
+
+const SyncTracker = () => {
+ const recordId = useRecordId();
+
+ useEffect(() => {
+ enqueueSnackbar({ message: `Tracking record ${recordId}`, variant: 'info' });
+ }, [recordId]);
+
+ return null;
+};
+
+export default defineFrontComponent({
+ universalIdentifier: '...',
+ name: 'sync-tracker',
+ description: 'Tracks record views silently',
+ isHeadless: true,
+ component: SyncTracker,
+});
+```
+
+Poiché il componente restituisce `null`, Twenty evita di renderizzare un contenitore per esso — non appare alcuno spazio vuoto nel layout. Il componente ha comunque accesso a tutti gli hook e all'API di comunicazione con l'host.
+
+## Componenti Command dell'SDK
+
+Il pacchetto `twenty-sdk` fornisce quattro componenti di supporto Command progettati per i componenti front-end headless. Ogni componente esegue un'azione al montaggio, gestisce gli errori mostrando una notifica snackbar e smonta automaticamente il componente front-end al termine.
+
+Importali da `twenty-sdk/command`:
+
+* **`Command`** — Esegue una callback asincrona tramite la prop `execute`.
+* **`CommandLink`** — Naviga verso un percorso dell'app. Props: `to`, `params`, `queryParams`, `options`.
+* **`CommandModal`** — Apre una finestra modale di conferma. Se l'utente conferma, esegue la callback `execute`. Props: `title`, `subtitle`, `execute`, `confirmButtonText`, `confirmButtonAccent`.
+* **`CommandOpenSidePanelPage`** — Apre una specifica pagina del pannello laterale. Props: `page`, `pageTitle`, `pageIcon`.
+
+Ecco un esempio completo di componente front-end headless che usa `Command` per eseguire un'azione dal menu comandi:
+
+```tsx src/front-components/run-action.tsx
+import { defineFrontComponent } from 'twenty-sdk/define';
+import { Command } from 'twenty-sdk/command';
+import { CoreApiClient } from 'twenty-sdk/clients';
+
+const RunAction = () => {
+ const execute = async () => {
+ const client = new CoreApiClient();
+
+ await client.mutation({
+ createTask: {
+ __args: { data: { title: 'Created by my app' } },
+ id: true,
+ },
+ });
+ };
+
+ return <Command execute={execute} />;
+};
+
+export default defineFrontComponent({
+ universalIdentifier: 'e5f6a7b8-c9d0-1234-efab-345678901234',
+ name: 'run-action',
+ description: 'Creates a task from the command menu',
+ component: RunAction,
+ isHeadless: true,
+});
+```
+
+```ts src/command-menu-items/run-action.command-menu-item.ts
+import { defineCommandMenuItem } from 'twenty-sdk/define';
+
+export default defineCommandMenuItem({
+ universalIdentifier: 'f6a7b8c9-d0e1-2345-fabc-456789012345',
+ label: 'Run my action',
+ icon: 'IconPlayerPlay',
+ frontComponentUniversalIdentifier: 'e5f6a7b8-c9d0-1234-efab-345678901234',
+});
+```
+
+E un esempio che usa `CommandModal` per chiedere conferma prima di eseguire:
+
+```tsx src/front-components/delete-draft.tsx
+import { defineFrontComponent } from 'twenty-sdk/define';
+import { CommandModal } from 'twenty-sdk/command';
+
+const DeleteDraft = () => {
+ const execute = async () => {
+ // perform the deletion
+ };
+
+ return (
+ <CommandModal
+ title="Delete draft?"
+ subtitle="This action cannot be undone."
+ execute={execute}
+ confirmButtonText="Delete"
+ confirmButtonAccent="danger"
+ />
+ );
+};
+
+export default defineFrontComponent({
+ universalIdentifier: 'a7b8c9d0-e1f2-3456-abcd-567890123456',
+ name: 'delete-draft',
+ description: 'Deletes a draft with confirmation',
+ component: DeleteDraft,
+ isHeadless: true,
+});
+```
+
+## Chiamare una funzione logica
+
+I componenti front vengono eseguiti lato browser in un Web Worker in sandbox, mentre le [funzioni logiche](/l/it/developers/extend/apps/logic/logic-functions) vengono eseguite lato server. Non esiste una chiamata diretta in-process tra i due; invece, un front component chiama una funzione logica tramite HTTP.
+
+Una funzione logica dichiarata con `httpRouteTriggerSettings` è esposta sotto l’endpoint `/s/` su `${TWENTY_API_URL}/s\<path>`. Il tuo front component chiama quella route con il `RestApiClient` da `twenty-client-sdk/rest`, che si autentica con il `TWENTY_APP_ACCESS_TOKEN` che Twenty inserisce nel worker.
+
+Il `RestApiClient` è stato creato proprio per questo. Legge `TWENTY_API_URL` e `TWENTY_APP_ACCESS_TOKEN` dall'ambiente del worker, aggiunge l'header `Authorization: Bearer`, serializza e analizza il JSON e genera un `RestApiClientError` quando il token o l'URL mancano o la risposta non è 2xx — così non devi reimplementare quel boilerplate in ogni componente.
+
+Un front component headless può eseguire la chiamata al mount tramite il componente `Command`, quindi smontarsi automaticamente:
+
+```tsx src/front-components/sync-prs.tsx
+import { defineFrontComponent } from 'twenty-sdk/define';
+import { Command } from 'twenty-sdk/command';
+import { RestApiClient } from 'twenty-client-sdk/rest';
+
+const SyncPrs = () => {
+ const execute = async () => {
+ const client = new RestApiClient();
+
+ await client.post('/s/github/fetch-prs', {
+ owner: 'twentyhq',
+ repo: 'twenty',
+ });
+ };
+
+ return <Command execute={execute} />;
+};
+
+export default defineFrontComponent({
+ universalIdentifier: '...',
+ name: 'sync-prs',
+ description: 'Triggers the fetch-prs logic function',
+ isHeadless: true,
+ component: SyncPrs,
+});
+```
+
+Il percorso passato al client è il percorso pubblico della route — la proprietà `httpRouteTriggerSettings.path` della funzione di logica con prefisso `/s`. Mantieni `isAuthRequired: true`; il client fornisce il token di accesso dell'app emesso da Twenty per il tuo componente:
+
+```ts src/logic-functions/fetch-prs.logic-function.ts
+import { defineLogicFunction } from 'twenty-sdk/define';
+import type { RoutePayload } from 'twenty-sdk/logic-function';
+
+const handler = async (event: RoutePayload) => {
+ const { owner, repo } = (event.body ?? {}) as { owner: string; repo: string };
+ // ...fetch from GitHub and persist records...
+ return { ok: true };
+};
+
+export default defineLogicFunction({
+ universalIdentifier: '...',
+ name: 'fetch-prs',
+ handler,
+ httpRouteTriggerSettings: {
+ path: '/github/fetch-prs',
+ httpMethod: 'POST',
+ isAuthRequired: true,
+ },
+});
+```
+
+<Note>
+`TWENTY_API_URL` e `TWENTY_APP_ACCESS_TOKEN` vengono inseriti automaticamente — vedi [Variabili dell’applicazione](#application-variables). Poiché le variabili di applicazione segrete non vengono mai esposte ai front component, mantieni le chiavi API e altra logica sensibile all’interno della funzione logica, non nel front component.
+</Note>
+
+### Riferimento a RestApiClient
+
+Importa `RestApiClient` da `twenty-client-sdk/rest`. Appartiene alla stessa famiglia di client di `CoreApiClient` e `MetadataApiClient`, ma si rivolge alle route HTTP della tua app invece della GraphQL API.
+
+| Metodo | Descrizione |
+| --------------------------------- | -------------------------------------------- |
+| `get(path, options?)` | Invia una richiesta `GET` |
+| `post(path, body?, options?)` | Invia una richiesta `POST` |
+| `put(path, body?, options?)` | Invia una richiesta `PUT` |
+| `patch(path, body?, options?)` | Invia una richiesta `PATCH` |
+| `delete(path, options?)` | Invia una richiesta `DELETE` |
+| `request(method, path, options?)` | Richiesta generica con qualsiasi metodo HTTP |
+
+`options` accetta `headers`, `query` (un record di parametri della query string; i valori nullish vengono ignorati) e un `AbortSignal` tramite `signal`. Un oggetto `body` non-`FormData` viene serializzato automaticamente in JSON. In caso di `401`, il client aggiorna il token di accesso una volta tramite l'host e ritenta la richiesta.
+
+L'URL di base e il token vengono risolti dall'ambiente per impostazione predefinita. Passa gli override al costruttore quando necessario — per esempio nei test:
+
+```ts
+const client = new RestApiClient({
+ baseUrl: 'https://api.example.com',
+ token: 'my-token',
+});
+```
+
+Le richieste non riuscite generano un `RestApiClientError` che espone `status`, `statusText`, `url` e il `body` analizzato:
+
+```tsx
+import { RestApiClient, RestApiClientError } from 'twenty-client-sdk/rest';
+
+const client = new RestApiClient();
+
+try {
+ const prs = await client.get('/s/github/fetch-prs', {
+ query: { state: 'open' },
+ });
+} catch (error) {
+ if (error instanceof RestApiClientError) {
+ console.error(error.status, error.body);
+ }
+}
+```
+
+## Accesso al contesto di runtime
+
+All'interno del tuo componente, usa gli hook dell'SDK per accedere all'utente corrente, al record e all'istanza del componente:
+
+```tsx src/front-components/record-info.tsx
+import { defineFrontComponent } from 'twenty-sdk/define';
+import {
+ useUserId,
+ useRecordId,
+ useFrontComponentId,
+} from 'twenty-sdk/front-component';
+
+const RecordInfo = () => {
+ const userId = useUserId();
+ const recordId = useRecordId();
+ const componentId = useFrontComponentId();
+
+ return (
+ <div>
+ <p>User: {userId}</p>
+ <p>Record: {recordId ?? 'No record context'}</p>
+ <p>Component: {componentId}</p>
+ </div>
+ );
+};
+
+export default defineFrontComponent({
+ universalIdentifier: 'b2c3d4e5-f6a7-8901-bcde-f23456789012',
+ name: 'record-info',
+ component: RecordInfo,
+});
+```
+
+Hook disponibili:
+
+| Hook | Restituisce | Descrizione |
+| --------------------------------------------- | -------------------- | ------------------------------------------------------------------------------------------- |
+| `useUserId()` | `string` o `null` | L'ID dell'utente corrente |
+| `useSelectedRecordIds()` | `string[]` | Tutti gli ID dei record selezionati (array vuoto se nessuno è selezionato) |
+| `useRecordId()` | `string` o `null` | **Deprecato.** Usa `useSelectedRecordIds()` al suo posto |
+| `useFrontComponentId()` | `string` | L'ID di questa istanza di componente |
+| `useColorScheme()` | `'light'` o `'dark'` | Lo schema di colori attivo dell'interfaccia utente dell'host (`System` è già stato risolto) |
+| `useFrontComponentExecutionContext(selector)` | varia | Accedi all'intero contesto di esecuzione con una funzione selettore |
+
+## Variabili dell'applicazione
+
+Le variabili dell'applicazione definite in [`defineApplication()`](/l/it/developers/extend/apps/config/application) con `isSecret: false` sono disponibili all'interno dei componenti front-end tramite l'utility `getApplicationVariable`:
+
+```tsx src/front-components/greeting.tsx
+import { defineFrontComponent } from 'twenty-sdk/define';
+import { getApplicationVariable } from 'twenty-sdk/front-component';
+
+const Greeting = () => {
+ const recipientName = getApplicationVariable('DEFAULT_RECIPIENT_NAME') ?? 'World';
+
+ return <p>Hello, {recipientName}!</p>;
+};
+
+export default defineFrontComponent({
+ universalIdentifier: '...',
+ name: 'greeting',
+ component: Greeting,
+});
+```
+
+<Warning>
+Le variabili segrete (`isSecret: true`) **non** sono esposte ai componenti front-end. Sono disponibili solo nelle [funzioni logiche](/l/it/developers/extend/apps/logic/logic-functions), che vengono eseguite lato server. Questo impedisce che valori sensibili come le chiavi API vengano inviati al browser.
+</Warning>
+
+Le seguenti variabili di sistema sono sempre disponibili tramite `process.env`:
+
+| Variabile | Descrizione |
+| ------------------------- | ---------------------------------------------------------------- |
+| `TWENTY_API_URL` | URL di base delle API di Twenty |
+| `TWENTY_APP_ACCESS_TOKEN` | Token di breve durata con ambito limitato al ruolo della tua app |
+
+## API di comunicazione con l'host
+
+I componenti front-end possono attivare navigazione, modali e notifiche utilizzando funzioni da `twenty-sdk`:
+
+| Funzione | Descrizione |
+| ----------------------------------------------- | ------------------------------------- |
+| `navigate(to, params?, queryParams?, options?)` | Naviga a una pagina dell'app |
+| `openSidePanelPage(params)` | Apri un pannello laterale |
+| `closeSidePanel()` | Chiudi il pannello laterale |
+| `openCommandConfirmationModal(params)` | Mostra una finestra di conferma |
+| `enqueueSnackbar(params)` | Mostra una notifica toast |
+| `unmountFrontComponent()` | Smonta il componente |
+| `updateProgress(progress)` | Aggiorna un indicatore di avanzamento |
+
+Ecco un esempio che usa l'API host per mostrare una snackbar e chiudere il pannello laterale dopo il completamento di un'azione:
+
+```tsx src/front-components/archive-record.tsx
+import { defineFrontComponent } from 'twenty-sdk/define';
+import { useRecordId } from 'twenty-sdk/front-component';
+import { enqueueSnackbar, closeSidePanel } from 'twenty-sdk/front-component';
+import { CoreApiClient } from 'twenty-sdk/clients';
+
+const ArchiveRecord = () => {
+ const recordId = useRecordId();
+
+ const handleArchive = async () => {
+ const client = new CoreApiClient();
+
+ await client.mutation({
+ updateTask: {
+ __args: { id: recordId, data: { status: 'ARCHIVED' } },
+ id: true,
+ },
+ });
+
+ await enqueueSnackbar({
+ message: 'Record archived',
+ variant: 'success',
+ });
+
+ await closeSidePanel();
+ };
+
+ return (
+ <div style={{ padding: '20px' }}>
+ <p>Archive this record?</p>
+ <button onClick={handleArchive}>Archive</button>
+ </div>
+ );
+};
+
+export default defineFrontComponent({
+ universalIdentifier: 'c9d0e1f2-a3b4-5678-cdef-789012345678',
+ name: 'archive-record',
+ description: 'Archives the current record',
+ component: ArchiveRecord,
+});
+```
+
+### Lavorare con più record
+
+Usa `useSelectedRecordIds()` per gestire più record selezionati. Questo è utile per operazioni in blocco:
+
+```tsx src/front-components/bulk-export.tsx
+import { defineFrontComponent, numberOfSelectedRecords } from 'twenty-sdk/define';
+import { useSelectedRecordIds } from 'twenty-sdk/front-component';
+import { enqueueSnackbar, closeSidePanel } from 'twenty-sdk/front-component';
+import { CoreApiClient } from 'twenty-sdk/clients';
+
+const BulkExport = () => {
+ const selectedRecordIds = useSelectedRecordIds();
+
+ const handleExport = async () => {
+ const client = new CoreApiClient();
+
+ for (const recordId of selectedRecordIds) {
+ await client.mutation({
+ updateTask: {
+ __args: { id: recordId, data: { exported: true } },
+ id: true,
+ },
+ });
+ }
+
+ await enqueueSnackbar({
+ message: `Exported ${selectedRecordIds.length} records`,
+ variant: 'success',
+ });
+
+ await closeSidePanel();
+ };
+
+ return (
+ <div style={{ padding: '20px' }}>
+ <p>Export {selectedRecordIds.length} selected record(s)?</p>
+ <button onClick={handleExport}>Export</button>
+ </div>
+ );
+};
+
+export default defineFrontComponent({
+ universalIdentifier: 'd0e1f2a3-b4c5-6789-defa-012345678901',
+ name: 'bulk-export',
+ description: 'Export selected records',
+ component: BulkExport,
+ command: {
+ universalIdentifier: 'd0e1f2a3-b4c5-6789-defa-012345678902',
+ label: 'Bulk Export',
+ availabilityType: 'RECORD_SELECTION',
+ conditionalAvailabilityExpression: numberOfSelectedRecords > 0,
+ },
+});
+```
+
+## Asset pubblici
+
+I componenti front-end possono accedere ai file dalla directory `public/` dell'app utilizzando `getPublicAssetUrl`:
+
+```tsx
+import { defineFrontComponent } from 'twenty-sdk/define';
+import { getPublicAssetUrl } from 'twenty-sdk/utils';
+
+const Logo = () => <img src={getPublicAssetUrl('logo.png')} alt="Logo" />;
+
+export default defineFrontComponent({
+ universalIdentifier: '...',
+ name: 'logo',
+ component: Logo,
+});
+```
+
+Vedi la [sezione sugli asset pubblici](/l/it/developers/extend/apps/config/public-assets) per i dettagli.
+
+## Stile
+
+I componenti front-end supportano diversi approcci di styling. Puoi usare:
+
+* **Stili inline** — `style={{ color: 'red' }}`
+* **Componenti Twenty UI** — importali da `twenty-sdk/ui` (Button, Tag, Status, Chip, Avatar e altro)
+* **Emotion** — CSS-in-JS con `@emotion/react`
+* **Styled-components** — pattern `styled.div`
+* **Tailwind CSS** — classi di utilità
+* **Qualsiasi libreria CSS-in-JS** compatibile con React
+
+```tsx
+import { defineFrontComponent } from 'twenty-sdk/define';
+import { Button, Tag, Status } from 'twenty-sdk/ui';
+
+const StyledWidget = () => {
+ return (
+ <div style={{ padding: '16px', display: 'flex', gap: '8px' }}>
+ <Button title="Click me" onClick={() => alert('Clicked!')} />
+ <Tag text="Active" color="green" />
+ <Status color="green" text="Online" />
+ </div>
+ );
+};
+
+export default defineFrontComponent({
+ universalIdentifier: 'e5f6a7b8-c9d0-1234-efab-567890123456',
+ name: 'styled-widget',
+ component: StyledWidget,
+});
+```
diff --git a/packages/twenty-docs/l/it/developers/extend/apps/layout/navigation-menu-items.mdx b/packages/twenty-docs/l/it/developers/extend/apps/layout/navigation-menu-items.mdx
new file mode 100644
index 00000000000..1d5217f8d39
--- /dev/null
+++ b/packages/twenty-docs/l/it/developers/extend/apps/layout/navigation-menu-items.mdx
@@ -0,0 +1,44 @@
+---
+title: Voci del menu di navigazione
+description: Aggiungi voci personalizzate alla barra laterale dell’area di lavoro — collegamenti a viste salvate o URL esterni.
+icon: bars
+---
+
+Una **voce del menu di navigazione** è un elemento nella barra laterale sinistra. Usa `defineNavigationMenuItem()` per distribuire collegamenti personalizzati nella barra laterale — in genere uno per ogni [vista](/l/it/developers/extend/apps/layout/views) che distribuisci — o per puntare a URL esterni.
+
+```ts src/navigation-menu-items/example-navigation-menu-item.ts
+import { defineNavigationMenuItem, NavigationMenuItemType } from 'twenty-sdk/define';
+import { EXAMPLE_VIEW_UNIVERSAL_IDENTIFIER } from '../views/example-view';
+
+export default defineNavigationMenuItem({
+ universalIdentifier: '9327db91-afa1-41b6-bd9d-2b51a26efb4c',
+ name: 'example-navigation-menu-item',
+ icon: 'IconList',
+ color: 'blue',
+ position: 0,
+ type: NavigationMenuItemType.VIEW,
+ viewUniversalIdentifier: EXAMPLE_VIEW_UNIVERSAL_IDENTIFIER,
+});
+```
+
+## Punti chiave
+
+* `type` determina a cosa collega la voce di menu. Ogni tipo è associato a uno specifico campo identificatore:
+
+ | Tipo | Cosa fa | Campo obbligatorio |
+ | ------------------------------------ | ---------------------------------------------------- | ------------------------------------------------------------------------------------------------- |
+ | `NavigationMenuItemType.VIEW` | Apre una vista salvata | `viewUniversalIdentifier` |
+ | `NavigationMenuItemType.LINK` | Apre un URL esterno | `link` |
+ | `NavigationMenuItemType.FOLDER` | Raggruppa gli elementi nidificati sotto un’etichetta | `name` (e gli elementi figli fanno riferimento alla cartella tramite `folderUniversalIdentifier`) |
+ | `NavigationMenuItemType.OBJECT` | Apre la pagina indice predefinita di un oggetto | `targetObjectUniversalIdentifier` |
+ | `NavigationMenuItemType.PAGE_LAYOUT` | Apre un layout di pagina autonomo | `pageLayoutUniversalIdentifier` |
+
+* `position` controlla l’ordinamento nella barra laterale.
+
+* `icon` e `color` sono opzionali e personalizzano l’aspetto della voce.
+
+* `folderUniversalIdentifier` è inoltre disponibile su qualsiasi elemento per annidarlo all’interno di un genitore di tipo `FOLDER`.
+
+<Note>
+**Problema comune:** creare un oggetto senza una vista associata e una voce del menu di navigazione rende quell’oggetto invisibile per gli utenti. A meno che non si tratti di un oggetto tecnico/interno, ogni oggetto personalizzato dovrebbe avere una vista predefinita *e* una voce nella barra laterale che punti ad essa.
+</Note>
diff --git a/packages/twenty-docs/l/it/developers/extend/apps/layout/overview.mdx b/packages/twenty-docs/l/it/developers/extend/apps/layout/overview.mdx
new file mode 100644
index 00000000000..e90ff60f2a9
--- /dev/null
+++ b/packages/twenty-docs/l/it/developers/extend/apps/layout/overview.mdx
@@ -0,0 +1,56 @@
+---
+title: Panoramica
+description: "Inserisci la tua app all'interno dell'interfaccia utente di Twenty: voci della barra laterale, viste salvate, schede nella pagina di dettaglio dei record e componenti React isolati."
+icon: table-columns
+---
+
+Il **livello di layout** di un'app Twenty è tutto ciò che l'utente vede: dove l'app viene visualizzata nella barra laterale, quali viste elenco fornisce, come sono organizzate le sue pagine di dettaglio dei record e quali componenti React personalizzati vengono renderizzati all'interno di quelle pagine.
+
+```text
+ Sidebar Record list Record detail page
+ ─────── ─────────── ──────────────────
+ [📋 My View] ────▶ ┌──────────┐ ┌─────────────────────┐
+ [📋 Drafts ] │ Companies│ │ Tabs: [Overview ] │
+ [📋 Inbox ] │ ──────── │ │ [Notes ] │
+ ▲ │ Apple │ │ [Hello ]◀──── definePageLayoutTab
+ │ │ Acme │ │ │ adds a tab...
+ └ defineNavi- │ … │ │ ┌────────────────┐ │
+ gationMenu- └────▲─────┘ │ │ │ │
+ Item points │ │ │ React UI │◀── …with a
+ to a defineView │ │ │ (sandboxed in │ │ defineFrontComponent
+ └ defineView │ │ a Worker) │ │ widget inside
+ picks columns │ └────────────────┘ │
+ and filters └─────────────────────┘
+```
+
+## In questa sezione
+
+<CardGroup cols={2}>
+ <Card title="Viste" icon="list" href="/l/it/developers/extend/apps/layout/views">
+ `defineView` — configurazioni di elenco salvate: colonne visibili, filtri, gruppi.
+ </Card>
+ <Card title="Voci del menu di navigazione" icon="bars" href="/l/it/developers/extend/apps/layout/navigation-menu-items">
+ `defineNavigationMenuItem` — voci della barra laterale che puntano a viste o URL esterni.
+ </Card>
+ <Card title="Layout Pagina" icon="table-columns" href="/l/it/developers/extend/apps/layout/page-layouts">
+ `definePageLayout` e `definePageLayoutTab` — schede e widget nella pagina di dettaglio di un record.
+ </Card>
+ <Card title="Componenti front-end" icon="window-maximize" href="/l/it/developers/extend/apps/layout/front-components">
+ `defineFrontComponent` — componenti React isolati che vengono renderizzati all'interno di Twenty.
+ </Card>
+ <Card title="Voci del menu comandi" icon="terminal" href="/l/it/developers/extend/apps/layout/command-menu-items">
+ `defineCommandMenuItem` — registra componenti front-end come voci Cmd+K e azioni rapide.
+ </Card>
+</CardGroup>
+
+## Dove viene visualizzata l'app
+
+| Superficie | Cosa controlla | Entità |
+| ----------------------------------------------- | ----------------------------------------------------------------------------------------- | ----------------------------------------- |
+| **Barra laterale** | Una voce personalizzata che collega a una vista salvata o a un URL esterno | `defineNavigationMenuItem` |
+| **Elenco record** | Una configurazione salvata per un oggetto — colonne visibili, ordine, filtri, gruppi | `defineView` |
+| **Pagina di dettaglio del record** | Le schede e i widget nella pagina di un record (del tuo oggetto o di un oggetto standard) | `definePageLayout`, `definePageLayoutTab` |
+| **All'interno di uno qualsiasi dei precedenti** | Un widget React personalizzato: pulsanti, moduli, dashboard, integrazioni | `defineFrontComponent` |
+| **Menu comandi (Cmd+K)** | Un'azione rapida fissata o un comando nascosto | `defineCommandMenuItem` |
+
+I componenti front-end vengono eseguiti all'interno di un Web Worker isolato usando Remote DOM: vengono renderizzati in modo nativo nella pagina (non all'interno di un iframe), ma non possono accedere direttamente alla pagina host o al DOM. La comunicazione con Twenty avviene tramite un'API host basata sul passaggio di messaggi.
diff --git a/packages/twenty-docs/l/it/developers/extend/apps/layout/page-layouts.mdx b/packages/twenty-docs/l/it/developers/extend/apps/layout/page-layouts.mdx
new file mode 100644
index 00000000000..25e4ac0033c
--- /dev/null
+++ b/packages/twenty-docs/l/it/developers/extend/apps/layout/page-layouts.mdx
@@ -0,0 +1,132 @@
+---
+title: Layout Pagina
+description: Personalizza le pagine di dettaglio dei record — schede, widget e dove vengono renderizzati i front components — usando `definePageLayout` e `definePageLayoutTab`.
+icon: table-columns
+---
+
+Un **layout di pagina** controlla come è organizzata la pagina di dettaglio di un record: quali schede compaiono e quali widget contengono. Usa `definePageLayout()` per dichiarare un layout per un oggetto di tua proprietà, oppure `definePageLayoutTab()` per aggiungere una singola scheda a un layout già esistente (tuo o standard di Twenty).
+
+| Caso d'uso | Entità |
+| ---------------------------------------------------------------------------------- | --------------------- |
+| Definire l’intero layout per la pagina di un record su un oggetto di tua proprietà | `definePageLayout` |
+| Aggiungere una scheda a un layout esistente (un tuo oggetto o uno standard) | `definePageLayoutTab` |
+
+## definePageLayout
+
+Usa questo quando possiedi l’intera pagina di dettaglio — in genere per un oggetto personalizzato che hai definito tu stesso.
+
+```ts src/page-layouts/example-record-page-layout.ts
+import { definePageLayout, PageLayoutTabLayoutMode } from 'twenty-sdk/define';
+import { EXAMPLE_OBJECT_UNIVERSAL_IDENTIFIER } from '../objects/example-object';
+import { HELLO_WORLD_FRONT_COMPONENT_UNIVERSAL_IDENTIFIER } from '../front-components/hello-world';
+
+export default definePageLayout({
+ universalIdentifier: '203aeb94-6701-46d6-9af1-be2bbcc9e134',
+ name: 'Example Record Page',
+ type: 'RECORD_PAGE',
+ objectUniversalIdentifier: EXAMPLE_OBJECT_UNIVERSAL_IDENTIFIER,
+ tabs: [
+ {
+ universalIdentifier: '6ed26b60-a51d-4ad7-86dd-1c04c7f3cac5',
+ title: 'Hello World',
+ position: 50,
+ icon: 'IconWorld',
+ layoutMode: PageLayoutTabLayoutMode.CANVAS,
+ widgets: [
+ {
+ universalIdentifier: 'aa4234e0-2e5f-4c02-a96a-573449e2351d',
+ title: 'Hello World',
+ type: 'FRONT_COMPONENT',
+ configuration: {
+ configurationType: 'FRONT_COMPONENT',
+ frontComponentUniversalIdentifier:
+ HELLO_WORLD_FRONT_COMPONENT_UNIVERSAL_IDENTIFIER,
+ },
+ },
+ ],
+ },
+ ],
+});
+```
+
+### Punti chiave
+
+* `type` è in genere `'RECORD_PAGE'` per personalizzare la vista dei dettagli di un oggetto specifico.
+* `objectUniversalIdentifier` specifica a quale oggetto si applica questo layout.
+* Ogni `tab` definisce una sezione della pagina con un `title`, `position` e `layoutMode` (`CANVAS` per il layout libero).
+* Ogni `widget` all'interno di una scheda può renderizzare un [front component](/l/it/developers/extend/apps/layout/front-components), un elenco di relazioni o altri tipi di widget integrati.
+* `position` sulle schede controlla il loro ordine. Usa valori più alti (ad es., 50) per posizionare le schede personalizzate dopo quelle integrate.
+
+## definePageLayoutTab
+
+Usa questo quando vuoi solo **aggiungere** una scheda a un layout esistente — per esempio, una scheda di analisi sulla pagina Company standard, o una scheda di riepilogo AI collegata al layout del tuo oggetto.
+
+```ts src/page-layouts/example-extra-tab.ts
+import {
+ definePageLayoutTab,
+ PageLayoutTabLayoutMode,
+ STANDARD_PAGE_LAYOUT_UNIVERSAL_IDENTIFIERS,
+} from 'twenty-sdk/define';
+import { HELLO_WORLD_FRONT_COMPONENT_UNIVERSAL_IDENTIFIER } from '../front-components/hello-world';
+
+export default definePageLayoutTab({
+ universalIdentifier: 'b1b2b3b4-b5b6-4000-8000-000000000001',
+ pageLayoutUniversalIdentifier:
+ STANDARD_PAGE_LAYOUT_UNIVERSAL_IDENTIFIERS.companyRecordPage
+ .universalIdentifier,
+ title: 'Hello World',
+ position: 1000,
+ icon: 'IconWorld',
+ layoutMode: PageLayoutTabLayoutMode.CANVAS,
+ widgets: [
+ {
+ universalIdentifier: 'b1b2b3b4-b5b6-4000-8000-000000000002',
+ title: 'Hello World',
+ type: 'FRONT_COMPONENT',
+ configuration: {
+ configurationType: 'FRONT_COMPONENT',
+ frontComponentUniversalIdentifier:
+ HELLO_WORLD_FRONT_COMPONENT_UNIVERSAL_IDENTIFIER,
+ },
+ },
+ ],
+});
+```
+
+### Punti chiave
+
+* `pageLayoutUniversalIdentifier` è **obbligatorio** e deve puntare a un layout di pagina che esiste già al momento dell’installazione — oppure un layout standard di Twenty o uno definito dalla tua app. I riferimenti tra app a layout di proprietà di un’altra app installata non sono attualmente supportati. Quando il layout di pagina padre manca, l’installazione non va a buon fine e restituisce un chiaro errore di validazione.
+
+* Per i layout standard di Twenty, importa gli identificatori da `twenty-sdk/define`:
+
+ ```ts
+ import { STANDARD_PAGE_LAYOUT_UNIVERSAL_IDENTIFIERS } from 'twenty-sdk/define';
+
+ // STANDARD_PAGE_LAYOUT_UNIVERSAL_IDENTIFIERS.companyRecordPage.universalIdentifier
+ // STANDARD_PAGE_LAYOUT_UNIVERSAL_IDENTIFIERS.personRecordPage.universalIdentifier
+ // STANDARD_PAGE_LAYOUT_UNIVERSAL_IDENTIFIERS.taskRecordPage.universalIdentifier
+ // STANDARD_PAGE_LAYOUT_UNIVERSAL_IDENTIFIERS.opportunityRecordPage.universalIdentifier
+ // STANDARD_PAGE_LAYOUT_UNIVERSAL_IDENTIFIERS.noteRecordPage.universalIdentifier
+ // …
+ ```
+
+ Ogni voce di layout espone anche i propri `tabs` e i relativi `widgets`, così puoi fare riferimento a qualsiasi livello:
+
+ ```ts
+ STANDARD_PAGE_LAYOUT_UNIVERSAL_IDENTIFIERS.taskRecordPage.tabs.home.universalIdentifier
+ STANDARD_PAGE_LAYOUT_UNIVERSAL_IDENTIFIERS.taskRecordPage.tabs.home.widgets.fields.universalIdentifier
+ ```
+
+ È disponibile anche un alias breve `STANDARD_PAGE_LAYOUT`:
+
+ ```ts
+ import { STANDARD_PAGE_LAYOUT } from 'twenty-sdk/define';
+
+ STANDARD_PAGE_LAYOUT.companyRecordPage.universalIdentifier;
+ ```
+
+* I `widgets` sono limitati solo a questa scheda — fanno riferimento a [front components](/l/it/developers/extend/apps/layout/front-components), viste, ecc. esattamente come i widget definiti inline in `definePageLayout`.
+
+* `position` controlla l'ordinamento rispetto alle schede esistenti nel layout di destinazione. Scegli un valore che collochi la tua scheda dove desideri rispetto alle schede integrate.
+
+* Usa questo invece di `definePageLayout` quando vuoi solo aggiungere a un layout esistente. Usa `definePageLayout` quando possiedi l’intero layout.
diff --git a/packages/twenty-docs/l/it/developers/extend/apps/layout/views.mdx b/packages/twenty-docs/l/it/developers/extend/apps/layout/views.mdx
new file mode 100644
index 00000000000..71866861906
--- /dev/null
+++ b/packages/twenty-docs/l/it/developers/extend/apps/layout/views.mdx
@@ -0,0 +1,97 @@
+---
+title: Viste
+description: Distribuisci viste preconfigurate salvate — ordine delle colonne, filtri, gruppi — per gli oggetti nella tua app.
+icon: list
+---
+
+Una **vista** è una configurazione salvata per come vengono visualizzati i record di un oggetto: quali campi compaiono, il loro ordine, se sono visibili e gli eventuali filtri o gruppi applicati. Usa `defineView()` per distribuire viste preconfigurate con la tua app — in genere una vista indice predefinita per ogni oggetto personalizzato che crei.
+
+```ts src/views/example-view.ts
+import { defineView, ViewKey } from 'twenty-sdk/define';
+import { EXAMPLE_OBJECT_UNIVERSAL_IDENTIFIER } from '../objects/example-object';
+import { NAME_FIELD_UNIVERSAL_IDENTIFIER } from '../objects/example-object';
+
+export default defineView({
+ universalIdentifier: 'a1b2c3d4-e5f6-7890-abcd-ef1234567890',
+ name: 'All example items',
+ objectUniversalIdentifier: EXAMPLE_OBJECT_UNIVERSAL_IDENTIFIER,
+ icon: 'IconList',
+ key: ViewKey.INDEX,
+ position: 0,
+ fields: [
+ {
+ universalIdentifier: 'f926bdb7-6af7-4683-9a09-adbca56c29f0',
+ fieldMetadataUniversalIdentifier: NAME_FIELD_UNIVERSAL_IDENTIFIER,
+ position: 0,
+ isVisible: true,
+ size: 200,
+ },
+ ],
+});
+```
+
+## Punti chiave
+
+* `objectUniversalIdentifier` specifica a quale oggetto si applica questa vista. Può essere un oggetto personalizzato che hai definito o un oggetto Twenty standard.
+* `key` determina il tipo di vista — `ViewKey.INDEX` è la vista elenco principale per l'oggetto.
+* `fields` controlla quali colonne compaiono e in quale ordine. Ogni campo fa riferimento a un `fieldMetadataUniversalIdentifier`.
+* Puoi anche definire `filters`, `filterGroups`, `groups` e `fieldGroups` per configurazioni più avanzate.
+* `position` controlla l'ordinamento quando esistono più viste per lo stesso oggetto.
+
+## Filtri
+
+Una vista può essere fornita con filtri preapplicati. Ogni filtro ha tre coordinate: il **campo** che viene filtrato, l'**operando** (come confrontare) e il **valore** (con cosa confrontare). Tutti e tre devono allinearsi: l'uso di un operando che non si applica a un tipo di campo verrà rifiutato al momento della sincronizzazione.
+
+```ts
+import { ViewFilterOperand } from 'twenty-shared/types';
+
+filters: [
+ {
+ universalIdentifier: '...',
+ fieldMetadataUniversalIdentifier: STATUS_FIELD_UNIVERSAL_IDENTIFIER,
+ operand: ViewFilterOperand.IS,
+ value: ['ACTIVE'],
+ },
+],
+```
+
+### Operatori supportati per tipo di campo
+
+| Tipo di campo | Operandi supportati |
+| -------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------ |
+| `TEXT`, `EMAILS`, `FULL_NAME`, `ADDRESS`, `LINKS`, `PHONES`, `RAW_JSON`, `FILES`, `ACTOR`, `ARRAY` | `CONTAINS`, `DOES_NOT_CONTAIN`, `IS_EMPTY`, `IS_NOT_EMPTY` |
+| `ACTOR.source`, `ACTOR.workspaceMemberId` | `IS`, `IS_NOT`, `IS_EMPTY`, `IS_NOT_EMPTY` |
+| `SELECT` | `IS`, `IS_NOT`, `IS_EMPTY`, `IS_NOT_EMPTY` |
+| `MULTI_SELECT` | `CONTAINS`, `DOES_NOT_CONTAIN`, `IS_EMPTY`, `IS_NOT_EMPTY` |
+| `RELATION` | `IS`, `IS_NOT`, `IS_EMPTY`, `IS_NOT_EMPTY` |
+| `NUMBER` | `IS`, `IS_NOT`, `GREATER_THAN_OR_EQUAL`, `LESS_THAN_OR_EQUAL`, `IS_EMPTY`, `IS_NOT_EMPTY` |
+| `RATING` | `IS`, `GREATER_THAN_OR_EQUAL`, `LESS_THAN_OR_EQUAL`, `IS_EMPTY`, `IS_NOT_EMPTY` |
+| `CURRENCY`, `CURRENCY.amountMicros` | `GREATER_THAN_OR_EQUAL`, `LESS_THAN_OR_EQUAL`, `IS`, `IS_NOT`, `IS_EMPTY`, `IS_NOT_EMPTY` |
+| `CURRENCY.currencyCode` | `IS`, `IS_NOT`, `IS_EMPTY`, `IS_NOT_EMPTY` |
+| `DATE`, `DATE_TIME` | `IS`, `IS_RELATIVE`, `IS_IN_PAST`, `IS_IN_FUTURE`, `IS_TODAY`, `IS_BEFORE`, `IS_AFTER`, `IS_EMPTY`, `IS_NOT_EMPTY` |
+| `BOOLEAN` | `IS` |
+| `UUID` | `IS`, `IS_NOT`, `IS_EMPTY`, `IS_NOT_EMPTY` |
+| `TS_VECTOR` | `VECTOR_SEARCH` |
+
+> I tipi di campo con nomi simili possono usare operandi completamente diversi — `SELECT` e `MULTI_SELECT` sono un caso comune.
+
+### Forma del valore per operando
+
+Il campo `value` è sempre un valore serializzabile in JSON, ma la forma prevista dipende dall'operando:
+
+| Famiglia di operandi | Forma del valore | Esempio |
+| ----------------------------------------------------- | ------------------------------------- | ------------------------ |
+| `IS`, `IS_NOT` su `SELECT` | array di chiavi di opzione (stringhe) | `['ACTIVE', 'PENDING']` |
+| `CONTAINS`, `DOES_NOT_CONTAIN` su `MULTI_SELECT` | array di chiavi di opzione (stringhe) | `['TAG_A']` |
+| `IS`, `IS_NOT` su `RELATION` | array di ID di record (uuid) | `['c5a1...']` |
+| `CONTAINS`, `DOES_NOT_CONTAIN` su campi testuali | stringa | `'acme'` |
+| `IS`, `IS_NOT` su `NUMBER` | stringa (il valore) | `'5'` |
+| `IS` su `RATING` / `UUID` | stringa (il valore) | `'5'` |
+| `GREATER_THAN_OR_EQUAL`, `LESS_THAN_OR_EQUAL` | stringa (il limite) | `'10'` |
+| `IS`, `IS_BEFORE`, `IS_AFTER` su `DATE` / `DATE_TIME` | stringa ISO 8601 | `'2025-01-01T00:00:00Z'` |
+| `IS_EMPTY`, `IS_NOT_EMPTY` | stringa vuota | `''` |
+| `IS` su `BOOLEAN` | `'true'` o `'false'` | `'true'` |
+
+## Come le viste vengono visualizzate nell'interfaccia utente
+
+Una vista da sola non è raggiungibile dalla barra laterale. Per farla apparire lì, collegala a una [voce del menu di navigazione](/l/it/developers/extend/apps/layout/navigation-menu-items) di tipo `VIEW` che punti all'`universalIdentifier` della vista. Questo è il pattern canonico: ogni oggetto personalizzato in genere distribuisce una vista predefinita + una voce nella barra laterale che la apre.
diff --git a/packages/twenty-docs/l/it/developers/extend/apps/logic/connections.mdx b/packages/twenty-docs/l/it/developers/extend/apps/logic/connections.mdx
new file mode 100644
index 00000000000..657af0ccc89
--- /dev/null
+++ b/packages/twenty-docs/l/it/developers/extend/apps/logic/connections.mdx
@@ -0,0 +1,192 @@
+---
+title: Connessioni
+description: Consenti alla tua app di agire per conto di un utente nei servizi di terze parti tramite OAuth.
+icon: plug
+---
+
+Le connessioni sono credenziali che un utente detiene per un servizio esterno (Linear, GitHub, Slack, ...). La tua app dichiara **come** vengono ottenute tali credenziali — un **provider di connessione** — e le utilizza in fase di esecuzione per effettuare chiamate autenticate all'API di terze parti.
+
+Oggi è supportato solo OAuth 2.0. Tipi di credenziali futuri (token di accesso personali, chiavi API, autenticazione di base) si integreranno nella stessa interfaccia — le app che già usano `defineConnectionProvider({ type: 'oauth', ... })` non dovranno migrare.
+
+<AccordionGroup>
+
+<Accordion title="defineConnectionProvider" description="Dichiara come vengono ottenute le connessioni della tua app">
+
+Un provider di connessione descrive l'handshake OAuth di cui la tua app ha bisogno. L'utente fa clic su "Aggiungi connessione" nelle impostazioni della tua app, completa la schermata di consenso del provider e viene creata una riga `ConnectedAccount` nel suo spazio di lavoro.
+
+Una configurazione funzionante richiede **due file** — il provider di connessione e una dichiarazione `serverVariables` corrispondente su `defineApplication` che contiene le credenziali client OAuth.
+
+```ts src/connection-providers/linear-connection.ts
+import { defineConnectionProvider } from 'twenty-sdk/define';
+
+export default defineConnectionProvider({
+ universalIdentifier: '9c7d1f5e-6a0b-4d44-be0c-3f8b5a9d4e6f',
+ name: 'linear',
+ displayName: 'Linear',
+ icon: 'IconBrandLinear',
+ type: 'oauth',
+ oauth: {
+ authorizationEndpoint: 'https://linear.app/oauth/authorize',
+ tokenEndpoint: 'https://api.linear.app/oauth/token',
+ scopes: ['read', 'write'],
+ // These must match keys in `defineApplication.serverVariables` below.
+ clientIdVariable: 'LINEAR_CLIENT_ID',
+ clientSecretVariable: 'LINEAR_CLIENT_SECRET',
+ // Optional: defaults to 'json'. Some providers (Linear, Slack) want
+ // 'form-urlencoded' for the token request.
+ tokenRequestContentType: 'form-urlencoded',
+ // Optional: defaults to true. Disable only if the provider rejects PKCE.
+ usePkce: false,
+ // Optional: extra query params on the authorize URL.
+ // authorizationParams: { prompt: 'consent' },
+ // Optional: provider's RFC 7009 token revocation endpoint, called on disconnect.
+ // revokeEndpoint: 'https://example.com/oauth/revoke',
+ },
+});
+```
+
+```ts src/application.config.ts
+import { defineApplication } from 'twenty-sdk/define';
+
+export default defineApplication({
+ universalIdentifier: '...',
+ displayName: 'Linear',
+ description: 'Connect Linear to Twenty.',
+ // OAuth client credentials live on the app registration (one OAuth app per
+ // Twenty server, configured by the admin) — not per-workspace. Declare them
+ // as serverVariables so the admin can fill them in once for all installs.
+ serverVariables: {
+ LINEAR_CLIENT_ID: {
+ description: 'OAuth client ID from your Linear OAuth application.',
+ isSecret: false,
+ isRequired: true,
+ },
+ LINEAR_CLIENT_SECRET: {
+ description: 'OAuth client secret from your Linear OAuth application.',
+ isSecret: true,
+ isRequired: true,
+ },
+ },
+});
+```
+
+Punti chiave:
+
+* `name` è la stringa identificativa univoca usata in `listConnections({ providerName })` (kebab-case, deve corrispondere a `^[a-z][a-z0-9-]*$`).
+* `displayName` viene mostrato nella scheda delle impostazioni per app e nell'elenco degli strumenti AI.
+* `clientIdVariable` / `clientSecretVariable` sono **nomi**, non valori — devono corrispondere alle chiavi dichiarate in `defineApplication.serverVariables`. I `client_id` e `client_secret` effettivi vengono inseriti dall'amministratore del server tramite l'interfaccia di registrazione dell'app e non vengono mai aggiunti al tuo repository.
+* Usa `serverVariables` (non `applicationVariables`) — le credenziali OAuth sono a livello di server e c'è una sola app OAuth per ogni server Twenty.
+* Finché entrambe le `serverVariables` non sono compilate, la scheda delle impostazioni per app mostra un suggerimento "richiede l'amministratore del server" e il pulsante "Aggiungi connessione" è disattivato.
+* `type: 'oauth'` è l'unico valore supportato oggi. Il discriminatore è compatibile con versioni future: tipi futuri (`'pat'`, `'api-key'`, ...) aggiungeranno nuovi blocchi di sotto-configurazione accanto a `oauth`.
+
+L'URL di callback OAuth che il tuo provider deve inserire nella whitelist è:
+
+```
+https://<your-twenty-server>/auth/apps/callback
+```
+
+</Accordion>
+
+<Accordion title="listConnections / getConnection" description="Usa le connessioni da una funzione di logica">
+
+All'interno di un gestore di funzione di logica, `listConnections({ providerName })` restituisce le righe `ConnectedAccount` di questa app per il provider indicato, con token di accesso aggiornati.
+
+```ts src/logic-functions/handlers/create-linear-issue-handler.ts
+import { listConnections } from 'twenty-sdk/logic-function';
+
+export const createLinearIssueHandler = async (input: {
+ teamId?: string;
+ title?: string;
+}) => {
+ if (!input.teamId || !input.title) {
+ return { success: false, error: 'teamId and title are required' };
+ }
+
+ const connections = await listConnections({ providerName: 'linear' });
+
+ // Workspace-shared credentials win when present; fall back to the first
+ // user-visibility one. For HTTP-route triggers you typically pick the
+ // request user's connection via event.userWorkspaceId instead.
+ const connection =
+ connections.find((c) => c.visibility === 'workspace') ?? connections[0];
+
+ if (!connection) {
+ return {
+ success: false,
+ error:
+ 'Linear is not connected. Open the app settings and click "Add connection".',
+ };
+ }
+
+ // Use connection.accessToken to call the third-party API.
+ const response = await fetch('https://api.linear.app/graphql', {
+ method: 'POST',
+ headers: {
+ Authorization: `Bearer ${connection.accessToken}`,
+ 'Content-Type': 'application/json',
+ },
+ body: JSON.stringify({
+ query: `mutation { issueCreate(input: { teamId: "${input.teamId}", title: "${input.title}" }) { success } }`,
+ }),
+ });
+
+ return { success: response.ok };
+};
+```
+
+Ogni connessione ha:
+
+| Campo | Descrizione |
+| ----------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
+| `id` | ID di riga univoco; passalo a `getConnection(id)` per recuperarne una singola connessione |
+| `visibility` | `'user'` (privata per un membro dello spazio di lavoro) oppure `'workspace'` (condivisa con tutti i membri) |
+| `scopes` | Autorizzazioni OAuth concesse dal provider a monte (distinte da `visibility` — non sono correlate) |
+| `userWorkspaceId` | L'id userWorkspace del proprietario — utile per selezionare "la connessione dell'utente della richiesta" nei trigger di route HTTP |
+| `accessToken` | Token di accesso OAuth aggiornato (rinnovato automaticamente se scaduto) |
+| `name` / `handle` | Il nome visualizzato della connessione (derivato automaticamente al callback OAuth, rinominabile dall'utente) |
+| `authFailedAt` | Impostato quando l'aggiornamento più recente non è riuscito; l'utente deve riconnettersi |
+
+Punti chiave:
+
+* Passa `{ providerName }` per filtrare per provider; omettilo per ottenere tutte le connessioni possedute da questa app su tutti i provider.
+* Il server rinnova in modo trasparente il token di accesso prima di restituire la risposta. Il tuo handler vede sempre un token utilizzabile (oppure `authFailedAt` impostato).
+* `getConnection(id)` è l'equivalente a singola riga.
+
+</Accordion>
+
+<Accordion title="Visibilità per utente vs condivisa nello spazio di lavoro" description="Come gli utenti scelgono tra credenziali private e condivise">
+
+Quando un utente fa clic su "Aggiungi connessione", viene richiesto di scegliere una visibilità:
+
+* **Solo per me** — la credenziale è privata per l'utente che effettua la connessione. Qualsiasi funzione di logica chiamata per loro conto (trigger di route HTTP con `isAuthRequired: true`) la vede; i trigger cron e gli eventi del database no.
+* **Condivisa nello spazio di lavoro** — qualsiasi membro dello spazio di lavoro può usare la credenziale. Anche i trigger cron/database la vedono, poiché non hanno un utente della richiesta.
+
+Usa quella giusta per ciascun handler:
+
+```ts
+// HTTP-route trigger — prefer the request user's own connection.
+const conn =
+ connections.find((c) => c.userWorkspaceId === event.userWorkspaceId) ??
+ connections.find((c) => c.visibility === 'workspace');
+
+// Cron trigger — no request user; only shared credentials are sensible.
+const conn = connections.find((c) => c.visibility === 'workspace');
+```
+
+Sono consentite più connessioni per (utente, provider), quindi lo stesso utente può avere affiancate "Linear personale" e "Linear di lavoro".
+
+</Accordion>
+
+<Accordion title="Configurazione una tantum del provider" description="Registra la tua app OAuth presso il servizio di terze parti">
+
+Per ciascun provider di connessione, l'amministratore del server deve prima registrare un'app OAuth presso il servizio di terze parti.
+
+1. Vai alle impostazioni sviluppatore del provider (ad es. https://linear.app/settings/api/applications/new).
+2. Imposta la **Redirect URI** su `\<SERVER_URL>/auth/apps/callback`.
+3. Copia il **Client ID** e il **Client Secret** generati.
+4. Apri l'app installata in Twenty come amministratore del server → imposta i valori nelle corrispondenti `serverVariables`.
+5. I membri dello spazio di lavoro possono quindi aggiungere connessioni dalla sezione **Connessioni** dell'app.
+
+</Accordion>
+
+</AccordionGroup>
diff --git a/packages/twenty-docs/l/it/developers/extend/apps/logic/logic-functions.mdx b/packages/twenty-docs/l/it/developers/extend/apps/logic/logic-functions.mdx
new file mode 100644
index 00000000000..2ca5e127021
--- /dev/null
+++ b/packages/twenty-docs/l/it/developers/extend/apps/logic/logic-functions.mdx
@@ -0,0 +1,514 @@
+---
+title: Funzioni logiche
+description: Definisci funzioni TypeScript lato server con trigger HTTP, cron e trigger di eventi del database.
+icon: bolt
+---
+
+Le funzioni logiche sono funzioni TypeScript lato server che vengono eseguite sulla piattaforma Twenty. Possono essere attivate da richieste HTTP, pianificazioni cron o eventi del database — e possono anche essere esposte come strumenti per agenti di IA.
+
+<AccordionGroup>
+<Accordion title="defineLogicFunction" description="Definisci funzioni logiche e i relativi trigger">
+
+Ogni file di funzione usa `defineLogicFunction()` per esportare una configurazione con un handler e trigger opzionali.
+
+```ts src/logic-functions/createPostCard.logic-function.ts
+import { defineLogicFunction } from 'twenty-sdk/define';
+import type { RoutePayload } from 'twenty-sdk/logic-function';
+import { CoreApiClient } from 'twenty-client-sdk/core';
+
+const handler = async (params: RoutePayload) => {
+ const client = new CoreApiClient();
+ const body = (params.body ?? {}) as { name?: string };
+ const name = body.name ?? process.env.DEFAULT_RECIPIENT_NAME ?? 'Hello world';
+
+ const result = await client.mutation({
+ createPostCard: {
+ __args: { data: { name } },
+ id: true,
+ name: true,
+ },
+ });
+ return result;
+};
+
+export default defineLogicFunction({
+ universalIdentifier: 'e56d363b-0bdc-4d8a-a393-6f0d1c75bdcf',
+ name: 'create-new-post-card',
+ timeoutSeconds: 2,
+ handler,
+ httpRouteTriggerSettings: {
+ path: '/post-card/create',
+ httpMethod: 'POST',
+ isAuthRequired: true,
+ },
+ /*databaseEventTriggerSettings: {
+ eventName: 'people.created',
+ },*/
+ /*cronTriggerSettings: {
+ pattern: '0 0 1 1 *',
+ },*/
+});
+```
+
+Tipi di trigger disponibili:
+* **httpRoute**: Espone la tua funzione su un percorso e metodo HTTP **sotto l'endpoint `/s/`**:
+> ad es. `path: '/post-card/create'` è invocabile su `https://your-twenty-server.com/s/post-card/create`
+
+<Note>
+Per richiamare, da un componente front-end (headless), una funzione logica attivata da una rotta, vedi [Chiamare una funzione logica](/l/it/developers/extend/apps/layout/front-components#calling-a-logic-function).
+</Note>
+* **cron**: Esegue la tua funzione secondo una pianificazione utilizzando un'espressione CRON.
+* **databaseEvent**: Viene eseguito sugli eventi del ciclo di vita degli oggetti dello spazio di lavoro. Quando l'operazione dell'evento è `updated`, è possibile specificare campi specifici da monitorare nell'array `updatedFields`. Se lasciato non definito o vuoto, qualsiasi aggiornamento attiverà la funzione.
+> ad es. `person.updated`, `*.created`, `company.*`
+
+<Note>
+Puoi anche eseguire manualmente una funzione utilizzando la CLI:
+
+```bash filename="Terminal"
+yarn twenty dev:function:exec -n create-new-post-card -p '{"key": "value"}'
+```
+
+```bash filename="Terminal"
+yarn twenty dev:function:exec -u e56d363b-0bdc-4d8a-a393-6f0d1c75bdcf
+```
+
+Puoi osservare i log con:
+
+```bash filename="Terminal"
+yarn twenty dev:function:logs
+```
+</Note>
+
+#### Payload del trigger di route
+
+Quando un trigger di tipo route invoca la tua funzione logica, questa riceve un oggetto `RoutePayload` che segue il [formato AWS HTTP API v2](https://docs.aws.amazon.com/apigateway/latest/developerguide/http-api-develop-integrations-lambda.html).
+Importa il tipo `RoutePayload` da `twenty-sdk/logic-function`:
+
+```ts
+import type { RoutePayload } from 'twenty-sdk/logic-function';
+
+const handler = async (event: RoutePayload) => {
+ const { headers, queryStringParameters, pathParameters, body } = event;
+ const { method, path } = event.requestContext.http;
+
+ return { message: 'Success' };
+};
+```
+
+Il tipo `RoutePayload` ha la seguente struttura:
+
+ | Proprietà | Tipo | Descrizione | Esempio |
+ | ---------------------------- | ------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------- |
+ | `headers` | `Record\<string, string \| undefined>` | Intestazioni HTTP (solo quelle elencate in `forwardedRequestHeaders`) | vedi la sezione sotto |
+ | `queryStringParameters` | `Record\<string, string \| undefined>` | Parametri della query string (valori multipli uniti da virgole) | `/users?ids=1&ids=2&ids=3&name=Alice` -> `{ ids: '1,2,3', name: 'Alice' }` |
+ | `pathParameters` | `Record\<string, string \| undefined>` | Parametri di percorso estratti dal pattern della route | `/users/:id`, `/users/123` -> `{ id: '123' }` |
+ | `body` | `object \| null` | Corpo della richiesta analizzato (JSON) | `{ id: 1 }` -> `{ id: 1 }` |
+ | `rawBody` | `string \| undefined` | Corpo della richiesta UTF-8 originale, prima dell'analisi JSON. Utile per verificare le firme dei webhook in stile HMAC (ad es. `X-Hub-Signature-256` di GitHub, Stripe). `undefined` quando il runtime non lo ha conservato. | |
+ | `isBase64Encoded` | `boolean` | Indica se il corpo è codificato in base64 | |
+ | `requestContext.http.method` | `string` | Metodo HTTP (GET, POST, PUT, PATCH, DELETE) | |
+ | `requestContext.http.path` | `string` | Percorso della richiesta non elaborato | |
+
+
+#### forwardedRequestHeaders
+
+Per impostazione predefinita, le intestazioni HTTP delle richieste in ingresso **non** vengono passate alla tua funzione logica per motivi di sicurezza.
+Per accedere a intestazioni specifiche, elencale nell'array `forwardedRequestHeaders`:
+
+```ts
+export default defineLogicFunction({
+ universalIdentifier: 'e56d363b-0bdc-4d8a-a393-6f0d1c75bdcf',
+ name: 'webhook-handler',
+ handler,
+ httpRouteTriggerSettings: {
+ path: '/webhook',
+ httpMethod: 'POST',
+ isAuthRequired: false,
+ forwardedRequestHeaders: ['x-webhook-signature', 'content-type'],
+ },
+});
+```
+
+Nel tuo handler, accedi alle intestazioni inoltrate in questo modo:
+
+```ts
+const handler = async (event: RoutePayload) => {
+ const signature = event.headers['x-webhook-signature'];
+ const contentType = event.headers['content-type'];
+
+ // Validate webhook signature...
+ return { received: true };
+};
+```
+
+<Note>
+I nomi delle intestazioni vengono normalizzati in minuscolo. Accedile usando chiavi in minuscolo (ad es., `event.headers['content-type']`).
+</Note>
+
+#### Risposta HTTP personalizzata
+
+Per impostazione predefinita, restituire un valore semplice dal tuo handler lo invia come risposta `200` (JSON per gli oggetti, `text/plain` per le stringhe). Per controllare il codice di stato e le intestazioni della risposta, restituisci un oggetto `Response` da `twenty-sdk/logic-function`:
+
+```ts
+import { Response } from 'twenty-sdk/logic-function';
+
+const handler = async (event: RoutePayload) => {
+ return new Response('<h1>Hello</h1>', {
+ status: 201,
+ headers: { 'content-type': 'text/html' },
+ });
+};
+```
+
+Per motivi di sicurezza, le intestazioni di risposta sono limitate a un elenco consentito. Qualsiasi intestazione che non è presente nell'elenco (ad esempio `Set-Cookie`, intestazioni CORS come `Access-Control-Allow-Origin` o intestazioni personalizzate `X-*`) viene ignorata senza segnalazione prima che la risposta venga inviata. Le intestazioni di risposta consentite sono:
+
+* `content-type`
+* `content-language`
+* `content-disposition`
+* `cache-control`
+* `retry-after`
+
+<Note>
+Il codice di stato deve essere un codice di stato HTTP valido (compreso tra 100 e 599). I nomi delle intestazioni di risposta vengono confrontati senza distinzione tra maiuscole e minuscole.
+</Note>
+
+#### Payload del trigger di evento del database
+
+Quando un trigger di evento del database invoca la tua funzione logica, questa riceve un `DatabaseEventPayload` per ogni record modificato. Il payload combina i metadati sull’area di lavoro e sull’oggetto di origine con l’evento a livello di record.
+
+```ts
+import type {
+ DatabaseEventPayload,
+ ObjectRecordCreateEvent,
+ ObjectRecordDestroyEvent,
+ ObjectRecordUpdateEvent,
+} from 'twenty-sdk/logic-function';
+
+type Person = {
+ id: string;
+ emails?: { primaryEmail?: string };
+};
+```
+
+Il payload include:
+
+| Proprietà | Descrizione |
+| ------------------------------------------------ | -------------------------------------------------------------------------------------------------------- |
+| `name` | Nome dell'evento, ad esempio `person.updated`. |
+| `workspaceId` | Area di lavoro in cui si è verificato l'evento. |
+| `objectMetadata` | Metadati per l'oggetto che è cambiato. |
+| `recordId` | ID del record modificato. |
+| `userId`, `userWorkspaceId`, `workspaceMemberId` | Campi dell'attore quando l'evento è stato causato da un utente dell'area di lavoro. |
+| `properties` | Dati del record per l'evento, con `before`, `after`, `diff` e `updatedFields` a seconda dell'operazione. |
+
+| Evento | Dati del record |
+| ------------------ | -------------------------------------------------------------------------------------------------------------- |
+| `person.created` | `event.properties.after` |
+| `person.updated` | `event.properties.before`, `event.properties.after`, `event.properties.diff`, `event.properties.updatedFields` |
+| `person.destroyed` | `event.properties.before` |
+
+Per le eliminazioni logiche, `.deleted` segue la struttura in stile aggiornamento perché il campo `deletedAt` del record cambia.
+Per le eliminazioni permanenti, usa `.destroyed`.
+
+<Note>
+`databaseEventTriggerSettings.updatedFields` filtra quali eventi di aggiornamento attivano la funzione.
+`event.properties.updatedFields` indica quali campi sono effettivamente cambiati nell'evento corrente.
+</Note>
+
+Esempio di evento "created":
+
+```ts
+type PersonCreatedEvent = DatabaseEventPayload<
+ ObjectRecordCreateEvent<Person>
+>;
+
+const handler = async (event: PersonCreatedEvent) => {
+ const person = event.properties.after;
+
+ return {
+ personId: event.recordId,
+ email: person.emails?.primaryEmail,
+ };
+};
+```
+
+Esempio di evento "updated":
+
+```ts
+type PersonUpdatedEvent = DatabaseEventPayload<
+ ObjectRecordUpdateEvent<Person>
+>;
+
+const handler = async (event: PersonUpdatedEvent) => {
+ const { before, after, diff, updatedFields } = event.properties;
+
+ return {
+ personId: event.recordId,
+ updatedFields,
+ previousEmail: before.emails?.primaryEmail,
+ currentEmail: after.emails?.primaryEmail,
+ emailDiff: diff.emails,
+ };
+};
+```
+
+Attiva solo sugli aggiornamenti dell'email:
+
+```ts
+export default defineLogicFunction({
+ ...,
+ databaseEventTriggerSettings: {
+ eventName: 'person.updated',
+ updatedFields: ['emails'],
+ },
+});
+```
+
+Esempio di evento "destroyed":
+
+```ts
+type PersonDestroyedEvent = DatabaseEventPayload<
+ ObjectRecordDestroyEvent<Person>
+>;
+
+const handler = async (event: PersonDestroyedEvent) => {
+ const personBeforeDestroy = event.properties.before;
+
+ return {
+ personId: event.recordId,
+ email: personBeforeDestroy.emails?.primaryEmail,
+ };
+};
+```
+
+#### Esporre una funzione come strumento di IA o come azione del flusso di lavoro
+
+Le funzioni logiche possono essere esposte su due superfici, ciascuna con il proprio trigger:
+
+* **`toolTriggerSettings`** — rende la funzione individuabile dalle funzionalità di IA di Twenty (chat, MCP, function calling). Usa lo standard JSON Schema, il formato che gli LLM comprendono nativamente.
+* **`workflowActionTriggerSettings`** — fa apparire la funzione come un passaggio nel builder visivo dei flussi di lavoro. Usa il ricco `InputSchema` di Twenty affinché il builder possa visualizzare correttamente editor di campi, selettori di variabili ed etichette.
+
+Una funzione può optare per uno, l'altro o entrambi. Si affiancano a `cronTriggerSettings`, `databaseEventTriggerSettings` e `httpRouteTriggerSettings` — stesso schema, stessa struttura.
+
+```ts src/logic-functions/enrich-company.logic-function.ts
+import { defineLogicFunction } from 'twenty-sdk/define';
+import { CoreApiClient } from 'twenty-client-sdk/core';
+
+const handler = async (params: { companyName: string; domain?: string }) => {
+ const client = new CoreApiClient();
+
+ const result = await client.mutation({
+ createTask: {
+ __args: {
+ data: {
+ title: `Enrich data for ${params.companyName}`,
+ body: `Domain: ${params.domain ?? 'unknown'}`,
+ },
+ },
+ id: true,
+ },
+ });
+
+ return { taskId: result.createTask.id };
+};
+
+export default defineLogicFunction({
+ universalIdentifier: 'f47ac10b-58cc-4372-a567-0e02b2c3d479',
+ name: 'enrich-company',
+ description: 'Enrich a company record with external data',
+ timeoutSeconds: 10,
+ handler,
+ toolTriggerSettings: {},
+});
+```
+
+Punti chiave:
+
+* Una funzione può combinare le superfici — dichiara sia `toolTriggerSettings` sia `workflowActionTriggerSettings` per esporla in chat E nel builder dei flussi di lavoro.
+* `toolTriggerSettings.inputSchema` e `workflowActionTriggerSettings.inputSchema` sono entrambi opzionali. Se omessi, il builder del manifest li deduce dal codice sorgente dell'handler (JSON Schema per lo strumento di IA, `InputSchema` di Twenty per l'azione del flusso di lavoro). Forniscine uno esplicitamente quando desideri una tipizzazione più ricca — ad esempio, con campi compatibili con `FieldMetadataType` come `CURRENCY` o `RELATION` per il builder dei flussi di lavoro, oppure con campi `description` che l'agente di IA può leggere:
+
+```ts
+export default defineLogicFunction({
+ ...,
+ toolTriggerSettings: {
+ inputSchema: {
+ type: 'object',
+ properties: {
+ companyName: {
+ type: 'string',
+ description: 'The name of the company to enrich',
+ },
+ domain: {
+ type: 'string',
+ description: 'The company website domain (optional)',
+ },
+ },
+ required: ['companyName'],
+ },
+ },
+});
+```
+
+<Note>
+**Scrivi una buona `description`.** Gli agenti IA fanno affidamento sul campo `description` della funzione per decidere quando usare lo strumento. Sii specifico su cosa fa lo strumento e quando dovrebbe essere invocato.
+</Note>
+
+</Accordion>
+</AccordionGroup>
+
+<Note>
+**Hook di installazione** — i gestori di pre-installazione e post-installazione — condividono questo runtime, ma sono dichiarati con le proprie funzioni di definizione e non accettano impostazioni dei trigger. Consulta [Hook di installazione](/l/it/developers/extend/apps/config/install-hooks) per `definePreInstallLogicFunction` e `definePostInstallLogicFunction`.
+</Note>
+
+## Client API tipizzati (twenty-client-sdk)
+
+Il pacchetto `twenty-client-sdk` fornisce due client GraphQL tipizzati per interagire con l'API di Twenty dalle tue funzioni logiche e dai componenti front-end.
+
+| Client | Importa | Endpoint | Generato? |
+| ------------------- | ---------------------------- | ------------------------------------------------------------------------ | -------------------------- |
+| `CoreApiClient` | `twenty-client-sdk/core` | `/graphql` — dati dello spazio di lavoro (record, oggetti) | Sì, in fase di dev/build |
+| `MetadataApiClient` | `twenty-client-sdk/metadata` | `/metadata` — configurazione dello spazio di lavoro, caricamenti di file | No, fornito pronto all'uso |
+
+<AccordionGroup>
+<Accordion title="CoreApiClient" description="Esegui query e modifica i dati dello spazio di lavoro (record, oggetti)">
+
+`CoreApiClient` è il client principale per interrogare e modificare i dati dello spazio di lavoro. Viene **generato dallo schema del tuo spazio di lavoro** durante `yarn twenty dev` o `yarn twenty dev:build`, quindi è completamente tipizzato per corrispondere ai tuoi oggetti e campi.
+
+```ts
+import { CoreApiClient } from 'twenty-client-sdk/core';
+
+const client = new CoreApiClient();
+
+// Query records
+const { companies } = await client.query({
+ companies: {
+ edges: {
+ node: {
+ id: true,
+ name: true,
+ domainName: {
+ primaryLinkLabel: true,
+ primaryLinkUrl: true,
+ },
+ },
+ },
+ },
+});
+
+// Create a record
+const { createCompany } = await client.mutation({
+ createCompany: {
+ __args: {
+ data: {
+ name: 'Acme Corp',
+ },
+ },
+ id: true,
+ name: true,
+ },
+});
+```
+
+Il client utilizza una sintassi a selection-set: passa `true` per includere un campo, usa `__args` per gli argomenti e annida oggetti per le relazioni. Ottieni completamento automatico e controllo dei tipi completi basati sullo schema del tuo spazio di lavoro.
+
+<Note>
+**CoreApiClient viene generato in fase di dev/build.** Se lo usi senza eseguire prima `yarn twenty dev` o `yarn twenty dev:build`, genera un errore. La generazione avviene automaticamente — la CLI esegue l'introspezione dello schema GraphQL del tuo spazio di lavoro e genera un client tipizzato usando `@genql/cli`.
+</Note>
+
+#### Utilizzo di CoreSchema per le annotazioni di tipo
+
+`CoreSchema` fornisce tipi TypeScript corrispondenti agli oggetti del tuo spazio di lavoro — utile per tipizzare lo stato dei componenti o i parametri delle funzioni:
+
+```ts
+import { CoreApiClient, CoreSchema } from 'twenty-client-sdk/core';
+import { useState } from 'react';
+
+const [company, setCompany] = useState<
+ Pick<CoreSchema.Company, 'id' | 'name'> | undefined
+>(undefined);
+
+const client = new CoreApiClient();
+const result = await client.query({
+ company: {
+ __args: { filter: { position: { eq: 1 } } },
+ id: true,
+ name: true,
+ },
+});
+setCompany(result.company);
+```
+
+</Accordion>
+<Accordion title="MetadataApiClient" description="Configurazione dello spazio di lavoro, applicazioni e caricamenti di file">
+
+`MetadataApiClient` è fornito pronto all'uso con l'SDK (nessuna generazione richiesta). Interroga l'endpoint `/metadata` per la configurazione dello spazio di lavoro, le applicazioni e i caricamenti di file.
+
+```ts
+import { MetadataApiClient } from 'twenty-client-sdk/metadata';
+
+const metadataClient = new MetadataApiClient();
+
+// List first 10 objects in the workspace
+const { objects } = await metadataClient.query({
+ objects: {
+ edges: {
+ node: {
+ id: true,
+ nameSingular: true,
+ namePlural: true,
+ labelSingular: true,
+ isCustom: true,
+ },
+ },
+ __args: {
+ filter: {},
+ paging: { first: 10 },
+ },
+ },
+});
+```
+
+#### Caricamento dei file
+
+`MetadataApiClient` include un metodo `uploadFile` per allegare file ai campi di tipo file:
+
+```ts
+import { MetadataApiClient } from 'twenty-client-sdk/metadata';
+import * as fs from 'fs';
+
+const metadataClient = new MetadataApiClient();
+
+const fileBuffer = fs.readFileSync('./invoice.pdf');
+
+const uploadedFile = await metadataClient.uploadFile(
+ fileBuffer, // file contents as a Buffer
+ 'invoice.pdf', // filename
+ 'application/pdf', // MIME type
+ '58a0a314-d7ea-4865-9850-7fb84e72f30b', // field universalIdentifier
+);
+
+console.log(uploadedFile);
+// { id: '...', path: '...', size: 12345, createdAt: '...', url: 'https://...' }
+```
+
+| Parametro | Tipo | Descrizione |
+| ---------------------------------- | -------- | ---------------------------------------------------------------------- |
+| `fileBuffer` | `Buffer` | Il contenuto grezzo del file |
+| `filename` | `string` | Il nome del file (utilizzato per l'archiviazione e la visualizzazione) |
+| `contentType` | `string` | Tipo MIME (predefinito su `application/octet-stream` se omesso) |
+| `fieldMetadataUniversalIdentifier` | `string` | L'`universalIdentifier` del campo di tipo file nel tuo oggetto |
+
+Punti chiave:
+* Usa l'`universalIdentifier` del campo (non il suo ID specifico dello spazio di lavoro), quindi il tuo codice di upload funziona in qualsiasi spazio di lavoro in cui la tua app è installata.
+* L'`url` restituito è un URL firmato che puoi usare per accedere al file caricato.
+
+</Accordion>
+</AccordionGroup>
+
+<Note>
+ Quando il tuo codice viene eseguito su Twenty (funzioni logiche o componenti front-end), la piattaforma inietta le credenziali come variabili d'ambiente:
+
+ * `TWENTY_API_URL` — URL di base dell'API di Twenty
+ * `TWENTY_APP_ACCESS_TOKEN` — Chiave a breve durata con ambito al ruolo funzione predefinito della tua applicazione
+
+ Non è **necessario** passarle ai client — vengono lette automaticamente da `process.env`. I permessi della chiave API sono determinati dal ruolo dichiarato con `defineApplicationRole()` (o referenziato tramite `defaultRoleUniversalIdentifier` in `application-config.ts`).
+</Note>
diff --git a/packages/twenty-docs/l/it/developers/extend/apps/logic/overview.mdx b/packages/twenty-docs/l/it/developers/extend/apps/logic/overview.mdx
new file mode 100644
index 00000000000..2e98239c92c
--- /dev/null
+++ b/packages/twenty-docs/l/it/developers/extend/apps/logic/overview.mdx
@@ -0,0 +1,55 @@
+---
+title: Panoramica
+description: TypeScript lato server che viene eseguito all'interno di Twenty — attivato da route HTTP, pianificazioni cron, eventi del database, strumenti di AI o azioni di workflow.
+icon: bolt
+---
+
+Il **livello logico** di un'app Twenty è il codice che *viene eseguito* — handler TypeScript lato server che reagiscono a richieste HTTP, pianificazioni cron e modifiche ai record; skill e agenti di AI che vivono all'interno dello spazio di lavoro; e connessioni OAuth che permettono alle tue funzioni di agire per conto dell'utente in servizi di terze parti.
+
+```text
+ ┌─ HTTP route ──┐
+ │ Cron schedule │
+ │ Database event │ ┌────────────────────┐
+ triggers ─┤ AI tool call ├─────▶│ Logic function │
+ │ Workflow action │ │ (your handler) │
+ │ Manual exec │ └────────────────────┘
+ └────────────────────┘ │
+ ▼
+ ┌────────────────────────────┐
+ │ Twenty API (records) │
+ │ Third-party API │
+ │ (via Connection token) │
+ └────────────────────────────┘
+```
+
+## In questa sezione
+
+<CardGroup cols={2}>
+ <Card title="Funzioni logiche" icon="bolt" href="/l/it/developers/extend/apps/logic/logic-functions">
+ Il blocco di base — tipi di trigger, payload e client API tipizzato.
+ </Card>
+ <Card title="Skill e agenti" icon="robot" href="/l/it/developers/extend/apps/logic/skills-and-agents">
+ Istruzioni riutilizzabili per agenti AI e assistenti con prompt di sistema personalizzati.
+ </Card>
+ <Card title="Connessioni" icon="plug" href="/l/it/developers/extend/apps/logic/connections">
+ Credenziali OAuth che la tua app detiene per servizi di terze parti — Linear, GitHub, Slack e altri.
+ </Card>
+</CardGroup>
+
+## Tipi di trigger in sintesi
+
+Una funzione logica sceglie uno o più trigger — ogni voce qui sotto è un campo separato su `defineLogicFunction()`:
+
+| Scatenante | Quando viene eseguito | Impostazione |
+| ----------------------- | --------------------------------------------------------------------- | ------------------------------- |
+| **Route HTTP** | Una richiesta raggiunge il tuo endpoint `/s/\<path>` | `httpRouteTriggerSettings` |
+| **Cron** | Viene soddisfatta un'espressione CRON | `cronTriggerSettings` |
+| **Evento database** | Un record dello spazio di lavoro viene creato, aggiornato o eliminato | `databaseEventTriggerSettings` |
+| **Strumento AI** | Una funzionalità AI di Twenty decide di chiamare la tua funzione | `toolTriggerSettings` |
+| **Azione del workflow** | Uno step di workflow richiama la tua funzione | `workflowActionTriggerSettings` |
+
+Le funzioni vengono eseguite in sandbox in processi Node.js isolati e accedono allo spazio di lavoro tramite un client API tipizzato, limitato al ruolo dichiarato su [`defineApplication()`](/l/it/developers/extend/apps/config/application).
+
+<Note>
+**Hook di installazione** — codice che viene eseguito prima o dopo l'installazione — condividono questo runtime ma usano le proprie funzioni define e risiedono in [Config → Install Hooks](/l/it/developers/extend/apps/config/install-hooks).
+</Note>
diff --git a/packages/twenty-docs/l/it/developers/extend/apps/logic/skills-and-agents.mdx b/packages/twenty-docs/l/it/developers/extend/apps/logic/skills-and-agents.mdx
new file mode 100644
index 00000000000..b5d0f14f286
--- /dev/null
+++ b/packages/twenty-docs/l/it/developers/extend/apps/logic/skills-and-agents.mdx
@@ -0,0 +1,138 @@
+---
+title: Skill e agenti
+description: Definisci skill e agenti di IA per la tua app.
+icon: robot
+---
+
+<Warning>
+ Le skill e gli agenti sono attualmente in fase alfa. La funzionalità funziona ma è ancora in evoluzione.
+</Warning>
+
+Le app possono definire capacità di IA che risiedono all'interno dello spazio di lavoro — istruzioni di skill riutilizzabili e agenti con prompt di sistema personalizzati.
+
+<AccordionGroup>
+<Accordion title="defineSkill" description="Definisci le skill degli agenti IA">
+
+Le skill definiscono istruzioni e capacità riutilizzabili che gli agenti IA possono utilizzare all'interno del tuo spazio di lavoro. Usa `defineSkill()` per definire skill con convalida integrata:
+
+```ts src/skills/example-skill.ts
+import { defineSkill } from 'twenty-sdk/define';
+
+export default defineSkill({
+ universalIdentifier: 'a1b2c3d4-e5f6-7890-abcd-ef1234567890',
+ name: 'sales-outreach',
+ label: 'Sales Outreach',
+ description: 'Guides the AI agent through a structured sales outreach process',
+ icon: 'IconBrain',
+ content: `You are a sales outreach assistant. When reaching out to a prospect:
+1. Research the company and recent news
+2. Identify the prospect's role and likely pain points
+3. Draft a personalized message referencing specific details
+4. Keep the tone professional but conversational`,
+});
+```
+
+Punti chiave:
+* `name` è una stringa identificativa univoca per la skill (kebab-case consigliato).
+* `label` è il nome di visualizzazione leggibile mostrato nell'UI.
+* `content` contiene le istruzioni della skill — questo è il testo che l'agente IA utilizza.
+* `icon` (opzionale) imposta l'icona visualizzata nell'UI.
+* `description` (opzionale) fornisce contesto aggiuntivo sullo scopo della skill.
+
+</Accordion>
+<Accordion title="defineAgent" description="Definisci agenti IA con prompt personalizzati">
+
+Gli agenti sono assistenti IA che vivono all'interno del tuo spazio di lavoro. Usa `defineAgent()` per creare agenti con un prompt di sistema personalizzato:
+
+```ts src/agents/example-agent.ts
+import { defineAgent } from 'twenty-sdk/define';
+
+export default defineAgent({
+ universalIdentifier: 'b3c4d5e6-f7a8-9012-bcde-f34567890123',
+ name: 'sales-assistant',
+ label: 'Sales Assistant',
+ description: 'Helps the sales team draft outreach emails and research prospects',
+ icon: 'IconRobot',
+ prompt: 'You are a helpful sales assistant. Help users with their questions and tasks.',
+});
+```
+
+Punti chiave:
+* `name` è la stringa identificativa univoca dell'agente (kebab-case consigliato).
+* `label` è il nome visualizzato nell'UI.
+* `prompt` è il prompt di sistema che definisce il comportamento dell'agente.
+* `description` (opzionale) fornisce contesto su ciò che fa l'agente.
+* `icon` (opzionale) imposta l'icona visualizzata nell'UI.
+* `modelId` (opzionale) sostituisce il modello di IA predefinito utilizzato dall'agente.
+* `responseFormat` (facoltativo) controlla la forma dell'output dell'agente. Per il testo in formato libero, il valore predefinito è `{ type: 'text' }`. Usa `{ type: 'json', schema }` per forzare un output JSON strutturato.
+
+Per impostazione predefinita, un agente restituisce testo in formato libero. Per ottenere un output strutturato, imposta `responseFormat` su `{ type: 'json' }` e fornisci uno `schema`:
+
+```ts src/agents/structured-agent.ts
+import { defineAgent } from 'twenty-sdk/define';
+
+export default defineAgent({
+ universalIdentifier: 'c4d5e6f7-a8b9-0123-cdef-456789012345',
+ name: 'lead-scorer',
+ label: 'Lead Scorer',
+ prompt: 'Score the lead and explain your reasoning.',
+ responseFormat: {
+ type: 'json',
+ schema: {
+ type: 'object',
+ properties: {
+ score: { type: 'number', description: 'Lead score from 0 to 100' },
+ summary: { type: 'string', description: 'Short reasoning for the score' },
+ },
+ required: ['score', 'summary'],
+ additionalProperties: false,
+ },
+ },
+});
+```
+
+Note sullo schema:
+* Lo schema è un oggetto piatto: il `type` di ogni proprietà deve essere un primitivo (`string`, `number` o `boolean`). Gli oggetti annidati e gli array non sono supportati.
+* `description` (facoltativo) su ogni proprietà guida il modello su cosa inserire lì.
+* `required` (facoltativo) elenca le proprietà che il modello deve sempre restituire.
+* `additionalProperties: false` (facoltativo) vieta qualsiasi proprietà non dichiarata in `properties`.
+
+</Accordion>
+<Accordion title="runAgent" description="Esegui un agente da una funzione di logica">
+
+`runAgent()` permette a una funzione di logica di eseguire uno degli agenti della tua app (con le sue skill e i suoi strumenti). Identifica l'agente tramite l'`universalIdentifier` che hai passato a `defineAgent()`:
+
+```ts src/logic-functions/run-enricher.ts
+import { runAgent } from 'twenty-sdk/logic-function';
+
+const { result, error, success } = await runAgent({
+ agentUniversalIdentifier: 'b3c4d5e6-f7a8-9012-bcde-f34567890123',
+ prompt: 'Enrich House Ad <recordId>: fill empty fields from its listing URL.',
+});
+```
+
+Punti chiave:
+* L'agente viene eseguito in modo **sincrono** e può leggere/aggiornare direttamente i record tramite i propri strumenti — `runAgent()` viene risolta una volta completata l'esecuzione.
+* Un'app può eseguire solo i propri agenti.
+* Il [ruolo predefinito](/l/it/developers/extend/apps/config/roles) dell'app deve concedere il flag di autorizzazione `AI` — aggiungi `SystemPermissionFlag.AI` ai suoi `permissionFlagUniversalIdentifiers` (oppure imposta `canAccessAllTools: true`).
+ In mancanza di ciò, `runAgent()` non riesce con un errore di autorizzazione.
+* Imposta un valore generoso per `timeoutSeconds` sulla funzione di logica — l'esecuzione degli agenti può richiedere diversi secondi.
+* `success` è `true` e `result` è non nullo quando l'esecuzione viene completata; in caso di errore `success` è `false`, `result` è `null` ed `error` contiene il motivo (ad esempio, quando lo spazio di lavoro esaurisce i crediti AI durante l'esecuzione).
+
+```ts src/roles/default-role.ts
+import { defineApplicationRole, SystemPermissionFlag } from 'twenty-sdk/define';
+
+export default defineApplicationRole({
+ universalIdentifier: 'b648f87b-1d26-4961-b974-0908fd991061',
+ label: 'Default function role',
+ // runAgent() requires the AI permission flag on the app's default role.
+ permissionFlagUniversalIdentifiers: [SystemPermissionFlag.AI],
+});
+```
+
+<Warning>
+ **Evita i loop:** se chiami `runAgent()` da un trigger di evento del database `*.updated` e l'agente aggiorna lo stesso record, limita il trigger con `updatedFields` a un campo che l'agente non scrive mai (ad esempio l'URL di origine), oppure controlla che almeno uno dei campi di destinazione sia ancora vuoto prima di chiamare `runAgent()`.
+</Warning>
+
+</Accordion>
+</AccordionGroup>
diff --git a/packages/twenty-docs/l/it/developers/extend/apps/operations/cli.mdx b/packages/twenty-docs/l/it/developers/extend/apps/operations/cli.mdx
new file mode 100644
index 00000000000..63bc2fe74be
--- /dev/null
+++ b/packages/twenty-docs/l/it/developers/extend/apps/operations/cli.mdx
@@ -0,0 +1,105 @@
+---
+title: CLI
+description: Comandi di `yarn twenty` per eseguire funzioni, eseguire lo streaming dei log, gestire le installazioni delle app e passare da un remoto all'altro.
+icon: terminale
+---
+
+Oltre a `dev`, `dev:build`, `dev:add` e `dev:typecheck`, la CLI `yarn twenty` fornisce comandi per eseguire funzioni, visualizzare i log e gestire le installazioni delle app.
+
+## Esecuzione delle funzioni (`yarn twenty dev:function:exec`)
+
+Esegui manualmente una funzione logica senza attivarla tramite HTTP, cron o evento del database:
+
+```bash filename="Terminal"
+# Execute by function name
+yarn twenty dev:function:exec -n create-new-post-card
+
+# Execute by universalIdentifier
+yarn twenty dev:function:exec -u e56d363b-0bdc-4d8a-a393-6f0d1c75bdcf
+
+# Pass a JSON payload
+yarn twenty dev:function:exec -n create-new-post-card -p '{"name": "Hello"}'
+
+# Execute the post-install function
+yarn twenty dev:function:exec --postInstall
+```
+
+## Visualizzazione dei log delle funzioni (`yarn twenty dev:function:logs`)
+
+Esegui lo streaming dei log di esecuzione per le funzioni logiche della tua app:
+
+```bash filename="Terminal"
+# Stream all function logs
+yarn twenty dev:function:logs
+
+# Filter by function name
+yarn twenty dev:function:logs -n create-new-post-card
+
+# Filter by universalIdentifier
+yarn twenty dev:function:logs -u e56d363b-0bdc-4d8a-a393-6f0d1c75bdcf
+```
+
+<Note>
+Questo è diverso da `yarn twenty docker:logs`, che mostra i log del container Docker. `yarn twenty dev:function:logs` mostra i log di esecuzione delle funzioni della tua app dal server Twenty.
+</Note>
+
+## Generare il client tipizzato (`yarn twenty dev:generate-client`)
+
+Rigenera il client API tipizzato (`twenty-client-sdk`) dallo schema del remoto attivo, senza eseguire la build né sincronizzare un'app. Usalo per ottenere un client tipizzato in qualsiasi progetto — ad esempio un servizio backend che vive in un repository separato — che comunica con la tua istanza Twenty:
+
+```bash filename="Terminal"
+# In your project (no Twenty app definition required)
+yarn add twenty-sdk twenty-client-sdk
+
+# Connect to the Twenty instance to generate the client from
+yarn twenty remote:add
+
+# Generate the typed client into node_modules/twenty-client-sdk
+yarn twenty dev:generate-client
+```
+
+Quindi importa il client nel tuo codice:
+
+```typescript
+import { CoreApiClient } from 'twenty-client-sdk/core';
+```
+
+Esegui nuovamente il comando ogni volta che il tuo modello di dati cambia, per aggiornare i tipi generati.
+
+<Note>
+Il client viene generato all'interno di `node_modules`, quindi non viene inserito nel commit insieme al tuo codice. Esegui `yarn twenty dev:generate-client` dopo ogni installazione (ad esempio in uno script `postinstall` o nella CI).
+</Note>
+
+## Disinstallazione di un'app (`yarn twenty app:uninstall`)
+
+Rimuovi la tua app dallo spazio di lavoro attivo:
+
+```bash filename="Terminal"
+yarn twenty app:uninstall
+
+# Skip the confirmation prompt
+yarn twenty app:uninstall --yes
+```
+
+## Gestione dei remoti
+
+Un **remoto** è un server Twenty a cui la tua app si connette. Durante la configurazione, lo strumento di scaffolding ne crea uno automaticamente per te. Puoi aggiungere altri remoti o passare da uno all'altro in qualsiasi momento.
+
+```bash filename="Terminal"
+# Add a new remote (opens a browser for OAuth login)
+yarn twenty remote:add
+
+# Connect to a local Twenty server (auto-detects port 2020 or 3000)
+yarn twenty remote:add --local
+
+# Add a remote non-interactively (useful for CI)
+yarn twenty remote:add --url https://your-twenty-server.com --api-key $TWENTY_API_KEY --as my-remote
+
+# List all configured remotes
+yarn twenty remote:list
+
+# Set the active remote
+yarn twenty remote:use <name>
+```
+
+Le tue credenziali sono archiviate in `~/.twenty/config.json`.
diff --git a/packages/twenty-docs/l/it/developers/extend/apps/operations/overview.mdx b/packages/twenty-docs/l/it/developers/extend/apps/operations/overview.mdx
new file mode 100644
index 00000000000..5988acc0896
--- /dev/null
+++ b/packages/twenty-docs/l/it/developers/extend/apps/operations/overview.mdx
@@ -0,0 +1,32 @@
+---
+title: Panoramica
+description: Crea, testa e distribuisci la tua app — comandi CLI, test di integrazione, CI e pubblicazione su un server o su npm.
+icon: rocket
+---
+
+Il **livello operativo** è tutto ciò che fai *alla* tua app piuttosto che *con* essa: eseguire comandi CLI, eseguire test di integrazione contro un server Twenty reale, configurare la CI e distribuire le release — sia come tarball distribuito su un singolo server, sia come pacchetto npm elencato nel marketplace.
+
+```text
+ develop ─▶ test ─▶ build ─▶ deploy / publish
+ ─────── ──── ───── ─────────────────
+ yarn yarn yarn yarn twenty app:publish --private (tarball → one server)
+ twenty test twenty
+ dev dev:build yarn twenty app:publish (npm → marketplace)
+```
+
+## In questa sezione
+
+<CardGroup cols={2}>
+ <Card title="CLI" icon="terminal" href="/l/it/developers/extend/apps/operations/cli">
+ Riferimento a `yarn twenty` — exec, logs, uninstall, remotes.
+ </Card>
+ <Card title="Sincronizzazione e ripristino" icon="bussola" href="/l/it/developers/extend/apps/operations/sync-and-recovery">
+ Quale comando usare e quando, lettura del diff di sincronizzazione e una scaletta di ripristino.
+ </Card>
+ <Card title="Testing" icon="flask" href="/l/it/developers/extend/apps/operations/testing">
+ Configurazione di Vitest, test di integrazione, controllo dei tipi, workflow di CI.
+ </Card>
+ <Card title="Pubblicazione" icon="upload" href="/l/it/developers/extend/apps/operations/publishing">
+ Crea, distribuisci un tarball, pubblica su npm, installa.
+ </Card>
+</CardGroup>
diff --git a/packages/twenty-docs/l/it/developers/extend/apps/operations/publishing.mdx b/packages/twenty-docs/l/it/developers/extend/apps/operations/publishing.mdx
new file mode 100644
index 00000000000..e11e2d35bd0
--- /dev/null
+++ b/packages/twenty-docs/l/it/developers/extend/apps/operations/publishing.mdx
@@ -0,0 +1,294 @@
+---
+title: Pubblicazione
+icon: carica
+description: Distribuisci la tua app Twenty nel marketplace oppure distribuiscila internamente.
+---
+
+## Panoramica
+
+Una volta che la tua app è stata [compilata e testata localmente](/l/it/developers/extend/apps/getting-started/concepts), hai due modalità per distribuirla:
+
+* **Distribuisci un tarball** — carica la tua app direttamente su un server Twenty specifico per uso interno o privato.
+* **Pubblica su npm** — elenca la tua app nel marketplace di Twenty affinché qualsiasi spazio di lavoro possa scoprirla e installarla.
+
+Entrambi i percorsi partono dalla stessa fase di **build**.
+
+## Compilazione della tua app
+
+Esegui il comando di build per compilare la tua app e generare un `manifest.json` pronto per la distribuzione:
+
+```bash filename="Terminal"
+yarn twenty dev:build
+```
+
+Questo compila i sorgenti TypeScript, transpila le funzioni di logica e i componenti front-end e scrive tutto in `.twenty/output/`. Aggiungi `--tarball` per produrre anche un pacchetto `.tgz` per la distribuzione manuale o per il comando di publish.
+
+## Distribuzione su un server (tarball)
+
+Per le app che non vuoi rendere pubbliche — strumenti proprietari, integrazioni solo aziendali o build sperimentali — puoi distribuire un tarball direttamente su un server Twenty.
+
+### Prerequisiti
+
+Prima della distribuzione, ti serve un remote configurato che punti al server di destinazione. I remote memorizzano localmente l'URL del server e le credenziali di autenticazione in `~/.twenty/config.json`.
+
+Aggiungi un remote:
+
+```bash filename="Terminal"
+yarn twenty remote:add --url https://your-twenty-server.com --as production
+```
+
+### Distribuzione
+
+Compila e carica la tua app sul server in un solo passaggio:
+
+```bash filename="Terminal"
+yarn twenty app:publish --private
+# To deploy to a specific remote:
+# yarn twenty app:publish --private --remote production
+```
+
+### Condivisione di un'app distribuita
+
+<Warning>
+La condivisione di app private (tarball) tra spazi di lavoro è una funzionalità **Enterprise**. La scheda **Distribuzione** mostrerà un invito all'aggiornamento al posto dei controlli di condivisione finché il tuo spazio di lavoro non dispone di una chiave Enterprise valida. Vedi [Impostazioni > Pannello di amministrazione > Enterprise](/settings/admin-panel#enterprise) per attivarla.
+</Warning>
+
+Le app in formato tarball non sono elencate nel marketplace pubblico, quindi altri spazi di lavoro sullo stesso server non le troveranno navigando. Una volta che il tuo spazio di lavoro è sul piano Enterprise, puoi condividere un'app distribuita in questo modo:
+
+1. Vai su **Impostazioni > Applicazioni > Registrazioni** e apri la tua app
+2. Nella scheda **Distribuzione**, fai clic su **Copia link di condivisione**
+3. Condividi questo link con utenti su altri spazi di lavoro — li porterà direttamente alla pagina di installazione dell'app
+
+Il link di condivisione utilizza l'URL di base del server (senza alcun sottodominio dello spazio di lavoro) così funziona per qualsiasi spazio di lavoro sul server.
+
+### Gestione delle versioni
+
+Quando si aggiorna un'app in formato tarball già distribuita, il server richiede che la `version` in `package.json` sia **strettamente superiore** (per l'ordinamento [semver](https://semver.org)) rispetto alla versione attualmente distribuita. Eseguire nuovamente il deploy della stessa versione, o pubblicarne una inferiore, viene rifiutato prima che il tarball venga archiviato — vedrai un errore `VERSION_ALREADY_EXISTS` nella CLI.
+
+Per rilasciare un aggiornamento:
+
+1. Incrementa il campo `version` nel tuo `package.json` (ad es. `1.2.3` → `1.2.4`, `1.3.0` o `2.0.0`).
+2. Esegui `yarn twenty app:publish --private` (oppure `yarn twenty app:publish --private --remote production`)
+3. Gli spazi di lavoro che hanno l'app installata vedranno l'aggiornamento disponibile nelle proprie impostazioni
+
+<Note>
+I tag di pre-release funzionano come previsto: incrementare `1.0.0-rc.1` → `1.0.0-rc.2` è consentito e una release finale come `1.0.0` viene correttamente riconosciuta come superiore a `1.0.0-rc.5`. La versione in `package.json` deve essere essa stessa una stringa semver valida.
+</Note>
+
+{/* TODO: add screenshot of the Upgrade button */}
+
+### Compatibilità della versione del server
+
+Se la tua app utilizza una funzionalità introdotta in una specifica versione del server Twenty (ad esempio, i provider OAuth aggiunti nella v2.3.0), dovresti dichiarare la versione minima del server richiesta dalla tua app utilizzando il campo `engines.twenty` in `package.json`:
+
+```json filename="package.json"
+{
+ "name": "twenty-my-app",
+ "version": "1.0.0",
+ "engines": {
+ "node": "^24.5.0",
+ "twenty": ">=2.3.0"
+ }
+}
+```
+
+Il valore è un [intervallo semver](https://github.com/npm/node-semver#ranges) standard. Modelli comuni:
+
+| Intervallo | Significato |
+| ---------------------------------- | -------------------------------------------------------------- |
+| `>=2.3.0` | Qualsiasi server a partire dalla 2.3.0 |
+| `>=2.3.0 \<3.0.0` | 2.3.0 o successive, ma precedenti alla prossima versione major |
+| `^2.3.0` | Equivale a `>=2.3.0 \<3.0.0` |
+
+**Cosa succede durante il deploy e l'installazione:**
+
+* Se `engines.twenty` è impostato e la versione del server di destinazione non soddisfa l'intervallo, il deploy (caricamento del tarball) o l'installazione vengono rifiutati con un errore `SERVER_VERSION_INCOMPATIBLE` e un messaggio che indica sia l'intervallo richiesto sia la versione effettiva del server.
+* Se `engines.twenty` **non è impostato**, l'app è accettata su qualsiasi versione del server (retrocompatibile con le app esistenti).
+* Se sul server non è configurata `APP_VERSION`, il controllo viene ignorato.
+
+<Note>
+Il server è l'autorità di controllo — convalida `engines.twenty` sia durante il caricamento del tarball sia durante l'installazione nello spazio di lavoro. Se distribuisci un tarball out-of-band o installi dal marketplace, il server continua comunque a imporre la compatibilità.
+</Note>
+
+## CI/CD automatizzati (workflow preconfigurati)
+
+Le app generate con `create-twenty-app` includono due workflow di GitHub Actions pronti all'uso, nella cartella `.github/workflows/`. Sono pronti all'esecuzione non appena esegui il push del repository su GitHub — non è necessaria alcuna configurazione aggiuntiva per la CI e la CD richiede solo un singolo secret.
+
+### CI — `ci.yml`
+
+Esegue automaticamente i test di integrazione a ogni push su `main` e sulle pull request.
+
+**Cosa fa:**
+
+1. Esegue il checkout del codice sorgente della tua app.
+2. Avvia un'istanza di test isolata di Twenty utilizzando l'azione composita `twentyhq/twenty/.github/actions/spawn-twenty-app-dev-test@main` (l'equivalente per la CI di `yarn twenty docker:start --test`).
+3. Abilita Corepack, configura Node.js dal tuo `.nvmrc` e installa le dipendenze con `yarn install --immutable`.
+4. Esegue `yarn test`, passando `TWENTY_API_URL` e `TWENTY_API_KEY` dall'istanza avviata affinché i tuoi test possano comunicare con un server reale.
+
+**Opzioni di configurazione:**
+
+* `TWENTY_VERSION` (variabile di ambiente, predefinito `latest`) — fissa la versione del server Twenty usata nella CI modificando questo valore in `ci.yml`.
+* La concorrenza è raggruppata per `github.ref` e annulla le esecuzioni in corso in caso di nuovi push.
+
+Non sono necessari Secrets — l'istanza di test è effimera ed esiste solo per la durata del job.
+
+### CD — `cd.yml`
+
+Esegue il deploy della tua app su un server Twenty configurato a ogni push su `main` e, facoltativamente, da una pull request quando viene applicata l'etichetta `deploy`.
+
+**Cosa fa:**
+
+1. Esegue il checkout della testa della PR (per le PR etichettate) oppure del commit inviato.
+2. Esegue `twentyhq/twenty/.github/actions/deploy-twenty-app@main` — l'equivalente per la CI di `yarn twenty app:publish --private`.
+3. Esegue `twentyhq/twenty/.github/actions/install-twenty-app@main` in modo che la versione appena distribuita venga installata nello spazio di lavoro di destinazione.
+
+**Configurazione richiesta:**
+
+| Impostazione | Dove | Scopo |
+| ----------------------- | ---------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- |
+| `TWENTY_DEPLOY_URL` | `env` in `cd.yml` (predefinito `http://localhost:3000`) | Il server Twenty su cui effettuare il deploy. Modificalo con l'URL reale del tuo server prima del primo utilizzo. |
+| `TWENTY_DEPLOY_API_KEY` | Repository GitHub **Settings → Secrets and variables → Actions** | Chiave API con autorizzazione di deploy sul server di destinazione. |
+
+<Note>
+Il valore predefinito di `TWENTY_DEPLOY_URL`, `http://localhost:3000`, è un segnaposto — non raggiungerà alcuna risorsa da un runner ospitato su GitHub. Aggiornalo all'URL pubblico del tuo server (oppure usa un runner self-hosted con accesso di rete) prima di abilitare il CD.
+</Note>
+
+**Attivare un deploy di anteprima da una PR:**
+
+Aggiungi l'etichetta `deploy` a una pull request. La condizione `if:` in `cd.yml` eseguirà il job per quella PR utilizzando il commit di testa della PR, permettendoti di convalidare una modifica sul server di destinazione prima del merge.
+
+### Bloccare le azioni riutilizzabili
+
+Entrambi i workflow fanno riferimento ad azioni riutilizzabili a `@main`, quindi gli aggiornamenti delle azioni nel repository `twentyhq/twenty` vengono recepiti automaticamente. Se desideri build deterministiche, sostituisci `@main` con uno SHA di commit o un tag di release in ciascuna riga `uses:`.
+
+## Pubblicazione su npm
+
+La pubblicazione su npm rende la tua app scopribile nel marketplace di Twenty. Qualsiasi spazio di lavoro Twenty può sfogliare, installare e aggiornare le app del marketplace direttamente dall'interfaccia utente.
+
+### Requisiti
+
+* Un account [npm](https://www.npmjs.com)
+* La parola chiave `twenty-app` nell'array `keywords` del tuo `package.json` (aggiungila manualmente — non è inclusa per impostazione predefinita nel template `create-twenty-app`)
+
+```json filename="package.json"
+{
+ "name": "twenty-app-postcard-sender",
+ "version": "1.0.0",
+ "keywords": ["twenty-app"]
+}
+```
+
+### Metadati del marketplace
+
+La configurazione `defineApplication()` supporta campi opzionali che controllano come la tua app appare nel marketplace. Usa `logoUrl` e `screenshots` per fare riferimento alle immagini nella cartella `public/`:
+
+```ts src/application-config.ts
+export default defineApplication({
+ universalIdentifier: '...',
+ displayName: 'My App',
+ description: 'A great app',
+ logoUrl: 'public/logo.png',
+ screenshots: [
+ 'public/screenshot-1.png',
+ 'public/screenshot-2.png',
+ ],
+});
+```
+
+Vedi l'[accordion defineApplication](/l/it/developers/extend/apps/config/application#marketplace-metadata) nella pagina Building Apps per l'elenco completo dei campi del marketplace (`author`, `category`, `aboutDescription`, `websiteUrl`, `termsUrl`, ecc.).
+
+#### Dimensioni consigliate degli screenshot
+
+Il marketplace visualizza gli `screenshots` in un contenitore `8:5` fisso (ad esempio, `1600×1000 px`).
+
+<Note>
+Gli screenshot di qualsiasi rapporto d'aspetto vengono visualizzati per intero e non vengono mai ritagliati, ma tutto ciò che è significativamente più alto o più stretto di `8:5` mostrerà bande vuote ai lati.
+</Note>
+
+### Pubblica
+
+```bash filename="Terminal"
+yarn twenty app:publish
+```
+
+Per pubblicare con un dist-tag specifico (ad es. `beta` o `next`):
+
+```bash filename="Terminal"
+yarn twenty app:publish --tag beta
+```
+
+### Come funziona l'individuazione nel marketplace
+
+Il server Twenty sincronizza il proprio catalogo del marketplace dal registro npm **ogni ora**.
+
+Puoi attivare la sincronizzazione immediatamente invece di aspettare:
+
+```bash filename="Terminal"
+yarn twenty dev:catalog-sync
+# To target a specific remote:
+# yarn twenty dev:catalog-sync --remote production
+```
+
+I metadati visualizzati nel marketplace provengono dalla configurazione `defineApplication()` — campi come `displayName`, `description`, `author`, `category`, `logoUrl`, `screenshots`, `aboutDescription`, `websiteUrl` e `termsUrl`.
+
+<Note>
+Se la tua app non definisce un `aboutDescription` in `defineApplication()`, il marketplace userà automaticamente il `README.md` del tuo pacchetto su npm come contenuto della pagina Informazioni. Questo significa che puoi mantenere un unico README sia per npm sia per il marketplace di Twenty. Se desideri una descrizione diversa nel marketplace, imposta esplicitamente `aboutDescription`.
+</Note>
+
+### Pubblicazione con CI
+
+Usa questo workflow di GitHub Actions per pubblicare automaticamente a ogni release (usa [OIDC](https://docs.npmjs.com/trusted-publishers)):
+
+```yaml filename=".github/workflows/publish.yml"
+name: Publish
+on:
+ release:
+ types: [published]
+
+permissions:
+ contents: read
+ id-token: write
+
+jobs:
+ publish:
+ runs-on: ubuntu-latest
+ steps:
+ - uses: actions/checkout@v4
+ - uses: actions/setup-node@v4
+ with:
+ node-version: "24"
+ registry-url: https://registry.npmjs.org
+ - run: yarn install --immutable
+ - run: npx twenty dev:build
+ - run: npm publish --provenance --access public
+ working-directory: .twenty/output
+```
+
+Per altri sistemi CI (GitLab CI, CircleCI, ecc.), si applicano gli stessi tre comandi: `yarn install`, `yarn twenty dev:build`, quindi `npm publish` da `.twenty/output`.
+
+<Note>
+**npm provenance** è opzionale ma consigliata. La pubblicazione con `--provenance` aggiunge un badge di attendibilità alla tua scheda npm, consentendo agli utenti di verificare che il pacchetto sia stato creato a partire da uno specifico commit in una pipeline CI pubblica. Consulta la [documentazione su npm provenance](https://docs.npmjs.com/generating-provenance-statements) per le istruzioni di configurazione.
+</Note>
+
+## Installazione delle app
+
+Una volta che un'app è stata pubblicata (npm) o distribuita (tarball), gli spazi di lavoro possono installarla tramite l'interfaccia utente.
+
+Vai alla pagina **Impostazioni > Applicazioni** in Twenty, dove è possibile sfogliare e installare sia le app del marketplace sia quelle distribuite tramite tarball.
+
+{/* TODO: add screenshot of the UI when the app is registered */}
+
+Puoi anche installare le app dalla riga di comando:
+
+```bash filename="Terminal"
+yarn twenty app:install
+```
+
+<Note>
+Il server applica il versioning semver durante l’installazione, rispecchiando le regole del deploy:
+
+* L’installazione della stessa versione già installata nel tuo spazio di lavoro viene rifiutata con un errore `APP_ALREADY_INSTALLED`.
+* L’installazione di una versione inferiore rispetto a quella attualmente installata viene rifiutata con un errore `CANNOT_DOWNGRADE_APPLICATION`.
+
+Per installare una versione più recente, effettua prima il deploy o la pubblicazione, quindi riesegui `yarn twenty app:install`.
+</Note>
diff --git a/packages/twenty-docs/l/it/developers/extend/apps/operations/sync-and-recovery.mdx b/packages/twenty-docs/l/it/developers/extend/apps/operations/sync-and-recovery.mdx
new file mode 100644
index 00000000000..e9ca1d5ae7a
--- /dev/null
+++ b/packages/twenty-docs/l/it/developers/extend/apps/operations/sync-and-recovery.mdx
@@ -0,0 +1,111 @@
+---
+title: Sincronizzazione e ripristino
+description: Quale comando usare e quando, come leggere l'output della sincronizzazione e una scala di ripristino per quando i metadati locali divergono — prima di arrivare a un ripristino completo.
+icon: bussola
+---
+
+Lo sviluppo di app in locale ruota attorno alla **sincronizzazione**: la CLI ricostruisce il tuo manifest e il server applica solo la differenza tra questo e i metadati già presenti nel tuo spazio di lavoro. Questa pagina spiega quale comando usare, come leggere ciò che una sincronizzazione ha modificato e cosa fare — in ordine — quando lo stato locale sembra incoerente.
+
+## Quale comando, quando
+
+<Note>
+Per l’iterazione locale quotidiana vuoi quasi sempre `yarn twenty dev`. Il deploy e la pubblicazione servono a distribuire le release, **non** per il ciclo locale.
+</Note>
+
+| Vuoi… | Comando | Note |
+| ----------------------------------------------------------- | ----------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
+| Iterare in locale con sincronizzazione in tempo reale | `yarn twenty dev` | Monitora i file e sincronizza a ogni modifica. |
+| Sincronizzare una volta e uscire (CI, script, hook) | `yarn twenty dev --once` | Esegue una build + sincronizzazione, poi termina. |
+| Visualizzare in anteprima le modifiche **senza applicarle** | `yarn twenty dev --once --dry-run` | Calcola e stampa il diff; non scrive nulla. |
+| Rimuovere l'app dallo spazio di lavoro | `yarn twenty app:uninstall` | Aggiungi `--yes` per saltare il prompt. |
+| Inviare un tarball a un server | `yarn twenty app:publish --private` | Richiede una versione di `package.json` **strettamente superiore** — vedi [Publishing](/l/it/developers/extend/apps/operations/publishing). |
+| Pubblicare nel marketplace (npm) | `yarn twenty app:publish` | — |
+| Installare / aggiornare una versione distribuita | `yarn twenty app:install` | Installa la versione attualmente distribuita. |
+| Pulire il server locale e ripartire da zero | `yarn twenty docker:reset` | Elimina **tutti** i dati locali — ultima risorsa. |
+
+### La sincronizzazione locale non richiede un incremento di versione
+
+La regola della `version` strettamente crescente (`VERSION_ALREADY_EXISTS` in fase di deploy, `APP_ALREADY_INSTALLED` / `CANNOT_DOWNGRADE_APPLICATION` in fase di installazione) si applica a **`app:publish` / `app:install`** — il percorso di release. `yarn twenty dev` sincronizza il tuo manifest in-place e non richiede mai una modifica di versione, quindi non devi toccare `package.json` per iterare. Se ti ritrovi ad aumentare la versione per testare una modifica locale, stai usando il percorso di release quando invece vuoi il ciclo di sviluppo.
+
+## Lettura dell'output di sincronizzazione
+
+Ogni sincronizzazione stampa le modifiche ai metadati che ha applicato (o che applicherebbe, con `--dry-run`):
+
+```text filename="Terminal"
+Metadata changes: 2 created, 1 updated, 1 deleted
+ created objectMetadata rocket
+ created fieldMetadata timelineActivities
+ updated fieldMetadata launchedAt
+ deleted pageLayout legacyTab
+✓ Synced
+```
+
+Questo è il tuo primo strumento diagnostico: ti dice esattamente quali oggetti, campi e layout sono cambiati, così puoi confermare che una sincronizzazione ha fatto ciò che ti aspettavi prima di controllare l'interfaccia utente (UI).
+
+Quando una sincronizzazione fallisce su una singola entità, l'errore indica l'entità in questione e il suo `universalIdentifier`, per esempio:
+
+```text
+Migration action 'create' for 'fieldMetadata' (universalIdentifier: 2020...4337) failed
+```
+
+Usa quell'identificatore per trovare l'entità nel tuo manifest (e, se necessario, nello spazio di lavoro) invece di indovinare quale sia in conflitto.
+
+## Anteprima delle modifiche (dry run)
+
+`yarn twenty dev --once --dry-run` crea il tuo manifest, chiede al server il piano di migrazione e lo stampa — **senza applicare nulla**. È il modo sicuro per rispondere a "cosa cambierebbe questa sincronizzazione?" prima di impegnarti ad applicarla.
+
+```bash filename="Terminal"
+yarn twenty dev --once --dry-run
+```
+
+```text filename="Terminal"
+Building manifest...
+Computing metadata diff (dry run, nothing will be applied)...
+Metadata changes: 1 created, 1 updated
+ created fieldMetadata timelineActivities
+ updated objectMetadata rocket
+✓ Dry run complete for My App — no changes were applied
+```
+
+Un dry run:
+
+* **Non scrive nulla** — nessuna migrazione dei metadati, nessun aggiornamento del record dell'applicazione, nessuna modifica ai ruoli/schede predefiniti e nessuna generazione del client API.
+* Restituisce lo **stesso diff** che una sincronizzazione reale applicherebbe, così puoi esaminare in anticipo le entità create/aggiornate/eliminate.
+* È utile prima di una modifica rischiosa, quando si rivede una modifica generata da un'IA o in uno script che deve fallire se sta per essere applicata una modifica imprevista.
+
+<Note>
+Un dry run mostra in anteprima solo le modifiche ai **metadati** e richiede che l'app sia stata sincronizzata almeno una volta (così lo spazio di lavoro la conosce). Se lo esegui su un'app che non è mai stata sincronizzata, il server segnala che l'app non è installata — esegui prima `yarn twenty dev` una volta.
+</Note>
+
+## Scala di ripristino
+
+Quando i metadati locali sembrano errati, procedi in quest'ordine e fermati non appena ti sblocchi. Ogni passaggio è più invasivo del precedente.
+
+1. **Nuova sincronizzazione.** Esegui di nuovo `yarn twenty dev --once`. Le sincronizzazioni sono idempotenti — rieseguire un manifest pulito è sicuro e spesso risolve un problema temporaneo.
+2. **Visualizza in anteprima il piano.** Esegui `yarn twenty dev --once --dry-run` per vedere esattamente cosa intende cambiare la prossima sincronizzazione, senza applicarlo.
+3. **Leggi l'errore nominale.** Se una sincronizzazione fallisce, annota il tipo di metadato e lo `universalIdentifier` nel messaggio (vedi sopra) e individua quell'entità nel tuo manifest. Un conflitto di solito indica un identificatore duplicato o riutilizzato.
+4. **Disinstalla e reinstalla.** `yarn twenty app:uninstall`, poi sincronizza di nuovo (`yarn twenty dev`). Questo ricostruisce i metadati dell'app partendo da zero, lasciando intatto il resto del tuo spazio di lavoro.
+5. **Ripristino completo (ultima risorsa).** `yarn twenty docker:reset`, poi esegui di nuovo il seeding e la sincronizzazione.
+
+<Warning>
+`yarn twenty docker:reset` elimina **tutti** i dati nella tua istanza locale — ogni workspace, record e app. Usalo solo quando i passaggi precedenti hanno fallito.
+</Warning>
+
+<Note>
+Hai riscontrato un errore di metadati? Per favore [apri una issue](https://github.com/twentyhq/twenty/issues/new/choose) e includi il messaggio di migrazione non riuscita (con il tipo di metadato e lo `universalIdentifier`), l'output `Metadata changes` della sincronizzazione e i comandi che hai eseguito.
+</Note>
+
+## Evitare sincronizzazioni concorrenti sullo stesso spazio di lavoro
+
+La sincronizzazione applica le migrazioni dei metadati. Eseguire diverse operazioni di sincronizzazione, deploy o installazione sullo **stesso spazio di lavoro nello stesso momento** — per esempio, più terminali o agenti di IA che iterano in parallelo — può intrecciare queste migrazioni e lasciare i metadati in uno stato parzialmente applicato.
+
+Il server serializza le sincronizzazioni per spazio di lavoro per evitare questo, ma dovresti comunque convogliare le operazioni sensibili sui metadati attraverso un **unico** processo invece di eseguirle in parallelo. Se orchestri lo sviluppo con più agenti, instrada le loro chiamate di sync/deploy/install attraverso una coda unica in modo che ne venga eseguita solo una alla volta.
+
+## Distinguere i tipi di errore
+
+Quando qualcosa va storto, il diff dei metadati e gli errori nominali ti permettono di localizzare il problema:
+
+* **Errore di build del manifest** — la CLI fallisce prima della sincronizzazione (`MANIFEST_BUILD_FAILED`, `TYPECHECK_FAILED`); correggi il sorgente della tua app.
+* **Errore di sincronizzazione / migrazione** — la build riesce ma l'applicazione del diff fallisce, indicando l'entità e lo `universalIdentifier`; correggi i metadati in conflitto.
+* **Errore di runtime del codice dell'app** — la sincronizzazione va a buon fine ma le tue funzioni di logica o i componenti si comportano in modo anomalo in fase di esecuzione; controlla i [log delle funzioni](/l/it/developers/extend/apps/operations/cli).
+* **Stato locale dell'istanza** — nessuno dei casi precedenti e lo spazio di lavoro continua a sembrare errato; procedi lungo la scala di ripristino.
diff --git a/packages/twenty-docs/l/it/developers/extend/apps/operations/testing.mdx b/packages/twenty-docs/l/it/developers/extend/apps/operations/testing.mdx
new file mode 100644
index 00000000000..1a356646fa1
--- /dev/null
+++ b/packages/twenty-docs/l/it/developers/extend/apps/operations/testing.mdx
@@ -0,0 +1,301 @@
+---
+title: Testing
+description: Configurazione di Vitest, test di integrazione contro un server Twenty reale, controllo dei tipi e CI con GitHub Actions.
+icon: flask
+---
+
+L'SDK fornisce API programmatiche che ti consentono di compilare, distribuire, installare e disinstallare la tua app dal codice di test. In combinazione con [Vitest](https://vitest.dev/) e i client API tipizzati, puoi scrivere test di integrazione che verificano che la tua app funzioni end-to-end contro un server Twenty reale.
+
+## Uso dei pacchetti npm
+
+Puoi installare e usare qualsiasi pacchetto npm nella tua app. Sia le funzioni logiche sia i componenti front-end vengono impacchettati con [esbuild](https://esbuild.github.io/), che incorpora tutte le dipendenze nell'output — non sono necessari i `node_modules` a runtime.
+
+### Installazione di un pacchetto
+
+```bash filename="Terminal"
+yarn add axios
+```
+
+Quindi importalo nel tuo codice:
+
+```ts src/logic-functions/fetch-data.ts
+import { defineLogicFunction } from 'twenty-sdk/define';
+import axios from 'axios';
+
+const handler = async (): Promise<any> => {
+ const { data } = await axios.get('https://api.example.com/data');
+
+ return { data };
+};
+
+export default defineLogicFunction({
+ universalIdentifier: '...',
+ name: 'fetch-data',
+ description: 'Fetches data from an external API',
+ timeoutSeconds: 10,
+ handler,
+});
+```
+
+Lo stesso vale per i componenti front-end:
+
+```tsx src/front-components/chart.tsx
+import { defineFrontComponent } from 'twenty-sdk/define';
+import { format } from 'date-fns';
+
+const DateWidget = () => {
+ return <p>Today is {format(new Date(), 'MMMM do, yyyy')}</p>;
+};
+
+export default defineFrontComponent({
+ universalIdentifier: '...',
+ name: 'date-widget',
+ component: DateWidget,
+});
+```
+
+### Come funziona il bundling
+
+La fase di build usa esbuild per produrre un singolo file autonomo per ogni funzione logica e per ogni componente front-end. Tutti i pacchetti importati sono incorporati nel bundle.
+
+**Le funzioni logiche** vengono eseguite in un ambiente Node.js. I moduli integrati di Node (`fs`, `path`, `crypto`, `http`, ecc.) sono disponibili e non necessitano di essere installati.
+
+**I componenti front-end** vengono eseguiti in un Web Worker. I moduli integrati di Node non sono disponibili — solo le API del browser e i pacchetti npm che funzionano in un ambiente browser.
+
+Entrambi gli ambienti hanno `twenty-client-sdk/core` e `twenty-client-sdk/metadata` disponibili come moduli preforniti — questi non vengono inclusi nel bundle ma vengono risolti a runtime dal server.
+
+## Impostazione
+
+L'app generata tramite scaffolding include già Vitest. Se la configuri manualmente, installa le dipendenze:
+
+```bash filename="Terminal"
+yarn add -D vitest vite-tsconfig-paths
+```
+
+Crea un `vitest.config.ts` alla radice della tua app:
+
+```ts vitest.config.ts
+import tsconfigPaths from 'vite-tsconfig-paths';
+import { defineConfig } from 'vitest/config';
+
+export default defineConfig({
+ plugins: [
+ tsconfigPaths({
+ projects: ['tsconfig.spec.json'],
+ ignoreConfigErrors: true,
+ }),
+ ],
+ test: {
+ testTimeout: 120_000,
+ hookTimeout: 120_000,
+ include: ['src/**/*.integration-test.ts'],
+ setupFiles: ['src/__tests__/setup-test.ts'],
+ env: {
+ TWENTY_API_URL: 'http://localhost:2020',
+ TWENTY_API_KEY: 'your-api-key',
+ },
+ },
+});
+```
+
+Crea un file di setup che verifichi che il server sia raggiungibile prima dell'esecuzione dei test:
+
+```ts src/__tests__/setup-test.ts
+import * as fs from 'fs';
+import * as os from 'os';
+import * as path from 'path';
+import { beforeAll } from 'vitest';
+
+const TWENTY_API_URL = process.env.TWENTY_API_URL ?? 'http://localhost:2020';
+const TEST_CONFIG_DIR = path.join(os.tmpdir(), '.twenty-sdk-test');
+
+beforeAll(async () => {
+ // Verify the server is running
+ const response = await fetch(`${TWENTY_API_URL}/healthz`);
+
+ if (!response.ok) {
+ throw new Error(
+ `Twenty server is not reachable at ${TWENTY_API_URL}. ` +
+ 'Start the server before running integration tests.',
+ );
+ }
+
+ // Write a temporary config for the SDK
+ fs.mkdirSync(TEST_CONFIG_DIR, { recursive: true });
+
+ fs.writeFileSync(
+ path.join(TEST_CONFIG_DIR, 'config.json'),
+ JSON.stringify({
+ remotes: {
+ local: {
+ apiUrl: process.env.TWENTY_API_URL,
+ apiKey: process.env.TWENTY_API_KEY,
+ },
+ },
+ defaultRemote: 'local',
+ }, null, 2),
+ );
+});
+```
+
+## API programmatiche dell'SDK
+
+Il sottopercorso `twenty-sdk/cli` esporta funzioni che puoi chiamare direttamente dal codice di test:
+
+| Funzione | Descrizione |
+| -------------- | ----------------------------------------------- |
+| `appBuild` | Compila l'app e, opzionalmente, crea un tarball |
+| `appDeploy` | Carica un tarball sul server |
+| `appInstall` | Installa l'app nello spazio di lavoro attivo |
+| `appUninstall` | Disinstalla l'app dallo spazio di lavoro attivo |
+
+Ogni funzione restituisce un oggetto risultato con `success: boolean` e `data` oppure `error`.
+
+## Scrivere un test di integrazione
+
+Ecco un esempio completo che compila, distribuisce e installa l'app, quindi verifica che compaia nello spazio di lavoro:
+
+```ts src/__tests__/app-install.integration-test.ts
+import { APPLICATION_UNIVERSAL_IDENTIFIER } from 'src/application-config';
+import { appBuild, appDeploy, appInstall, appUninstall } from 'twenty-sdk/cli';
+import { MetadataApiClient } from 'twenty-client-sdk/metadata';
+import { afterAll, beforeAll, describe, expect, it } from 'vitest';
+
+const APP_PATH = process.cwd();
+
+describe('App installation', () => {
+ beforeAll(async () => {
+ const buildResult = await appBuild({
+ appPath: APP_PATH,
+ tarball: true,
+ onProgress: (message: string) => console.log(`[build] ${message}`),
+ });
+
+ if (!buildResult.success) {
+ throw new Error(`Build failed: ${buildResult.error?.message}`);
+ }
+
+ const deployResult = await appDeploy({
+ tarballPath: buildResult.data.tarballPath!,
+ onProgress: (message: string) => console.log(`[deploy] ${message}`),
+ });
+
+ if (!deployResult.success) {
+ throw new Error(`Deploy failed: ${deployResult.error?.message}`);
+ }
+
+ const installResult = await appInstall({ appPath: APP_PATH });
+
+ if (!installResult.success) {
+ throw new Error(`Install failed: ${installResult.error?.message}`);
+ }
+ });
+
+ afterAll(async () => {
+ await appUninstall({ appPath: APP_PATH });
+ });
+
+ it('should find the installed app in the workspace', async () => {
+ const metadataClient = new MetadataApiClient();
+
+ const result = await metadataClient.query({
+ findManyApplications: {
+ id: true,
+ name: true,
+ universalIdentifier: true,
+ },
+ });
+
+ const installedApp = result.findManyApplications.find(
+ (app: { universalIdentifier: string }) =>
+ app.universalIdentifier === APPLICATION_UNIVERSAL_IDENTIFIER,
+ );
+
+ expect(installedApp).toBeDefined();
+ });
+});
+```
+
+## Esecuzione dei test
+
+Assicurati che il tuo server Twenty locale sia in esecuzione, quindi:
+
+```bash filename="Terminal"
+yarn test
+```
+
+Oppure in modalità watch durante lo sviluppo:
+
+```bash filename="Terminal"
+yarn test:watch
+```
+
+## Controllo dei tipi
+
+Puoi anche eseguire il controllo dei tipi sulla tua app senza eseguire i test:
+
+```bash filename="Terminal"
+yarn twenty dev:typecheck
+```
+
+Questo esegue `tsc --noEmit` e riporta eventuali errori di tipo.
+
+## CI con GitHub Actions
+
+Lo strumento di scaffolding genera un workflow GitHub Actions pronto all'uso in `.github/workflows/ci.yml`. Esegue automaticamente i test di integrazione a ogni push su `main` e sulle pull request.
+
+Il workflow:
+
+1. Esegue il checkout del tuo codice
+2. Avvia un server Twenty temporaneo utilizzando l'azione `twentyhq/twenty/.github/actions/spawn-twenty-docker-image`
+3. Installa le dipendenze con `yarn install --immutable`
+4. Esegue `yarn test` con `TWENTY_API_URL` e `TWENTY_API_KEY` iniettati dagli output dell'azione
+
+```yaml .github/workflows/ci.yml
+name: CI
+
+on:
+ push:
+ branches:
+ - main
+ pull_request: {}
+
+env:
+ TWENTY_VERSION: latest
+
+jobs:
+ test:
+ runs-on: ubuntu-latest
+ steps:
+ - name: Checkout
+ uses: actions/checkout@v4
+
+ - name: Spawn Twenty instance
+ id: twenty
+ uses: twentyhq/twenty/.github/actions/spawn-twenty-docker-image@main
+ with:
+ twenty-version: ${{ env.TWENTY_VERSION }}
+ github-token: ${{ secrets.GITHUB_TOKEN }}
+
+ - name: Enable Corepack
+ run: corepack enable
+
+ - name: Setup Node.js
+ uses: actions/setup-node@v4
+ with:
+ node-version-file: '.nvmrc'
+ cache: 'yarn'
+
+ - name: Install dependencies
+ run: yarn install --immutable
+
+ - name: Run integration tests
+ run: yarn test
+ env:
+ TWENTY_API_URL: ${{ steps.twenty.outputs.server-url }}
+ TWENTY_API_KEY: ${{ steps.twenty.outputs.access-token }}
+```
+
+Non è necessario configurare alcun secret — l'azione `spawn-twenty-docker-image` avvia un server Twenty effimero direttamente nel runner e fornisce i dettagli di connessione. Il secret `GITHUB_TOKEN` è fornito automaticamente da GitHub.
+
+Per fissare una versione specifica di Twenty invece di `latest`, modifica la variabile d'ambiente `TWENTY_VERSION` all'inizio del workflow.
diff --git a/packages/twenty-docs/l/it/developers/extend/capabilities/apis.mdx b/packages/twenty-docs/l/it/developers/extend/capabilities/apis.mdx
index 330d621d3c1..acad55481dd 100644
--- a/packages/twenty-docs/l/it/developers/extend/capabilities/apis.mdx
+++ b/packages/twenty-docs/l/it/developers/extend/capabilities/apis.mdx
@@ -88,7 +88,7 @@ La tua chiave API concede l'accesso a dati sensibili. Non condividerla con servi
Per una maggiore sicurezza, assegna un ruolo specifico per limitare l'accesso:
-1. Vai a **Impostazioni → Ruoli**
+1. Vai a **Impostazioni → Membri → Ruoli**
2. Fai clic sul ruolo da assegnare
3. Apri la scheda **Assegnazione**
4. In **Chiavi API**, fai clic su **+ Assegna alla chiave API**
diff --git a/packages/twenty-docs/l/it/developers/self-host/capabilities/docker-compose.mdx b/packages/twenty-docs/l/it/developers/self-host/capabilities/docker-compose.mdx
index 2e649e01d53..4387286a480 100644
--- a/packages/twenty-docs/l/it/developers/self-host/capabilities/docker-compose.mdx
+++ b/packages/twenty-docs/l/it/developers/self-host/capabilities/docker-compose.mdx
@@ -51,7 +51,7 @@ Segui questi passaggi per un setup manuale.
curl -o .env https://raw.githubusercontent.com/twentyhq/twenty/refs/heads/main/packages/twenty-docker/.env.example
```
-2. **Genera Token Segreti**
+2. **Genera una chiave di cifratura**
Esegui il seguente comando per generare una stringa casuale unica:
@@ -59,16 +59,18 @@ Segui questi passaggi per un setup manuale.
openssl rand -base64 32
```
- **Importante:** Tieni questo valore segreto / non condividerlo.
+ **Importante:** Tieni questo valore segreto / non condividerlo. La perdita di `ENCRYPTION_KEY` significa perdere l'accesso a tutti i segreti archiviati nel database (token OAuth, variabili dell'applicazione, segreti TOTP, ecc.).
3. **Aggiorna il `.env`**
Sostituisci il valore segnaposto nel tuo file .env con il token generato:
```ini
- APP_SECRET=prima_stringa_casuale
+ ENCRYPTION_KEY=random_string
```
+ Consulta la [Guida alla rotazione delle chiavi](/l/it/developers/self-host/capabilities/key-rotation) per le istruzioni su come ruotarla senza tempi di inattività.
+
4. **Imposta la Password di Postgres**
Aggiorna il valore `PG_DATABASE_PASSWORD` nel file .env con una password forte senza caratteri speciali.
diff --git a/packages/twenty-docs/l/it/developers/self-host/capabilities/key-rotation.mdx b/packages/twenty-docs/l/it/developers/self-host/capabilities/key-rotation.mdx
new file mode 100644
index 00000000000..eb3afccba4b
--- /dev/null
+++ b/packages/twenty-docs/l/it/developers/self-host/capabilities/key-rotation.mdx
@@ -0,0 +1,60 @@
+---
+title: Rotazione delle chiavi
+icon: rotate
+---
+
+Twenty ha due famiglie di chiavi indipendenti:
+
+* **Chiavi di firma JWT** — coppie di chiavi asimmetriche ES256 (con tag `kid`) archiviate in `core."signingKey"`, utilizzate per firmare e verificare i token di accesso / aggiornamento.
+* **Chiave di crittografia a riposo** — `ENCRYPTION_KEY`, utilizzata per crittografare token OAuth, variabili dell'applicazione, chiavi private delle chiavi di firma, valori di configurazione sensibili e segreti TOTP all'interno di un involucro `enc:v2:`.
+
+`APP_SECRET` è un segreto legacy mantenuto per compatibilità con le versioni precedenti: quando `ENCRYPTION_KEY` non è impostata funge da fallback per la crittografia a riposo / cookie di sessione e continua a verificare i token di accesso HS256 preesistenti. Sarà deprecata.
+
+## Chiavi di firma JWT
+
+Ogni chiave contiene una `publicKey` (mantenuta indefinitamente così da poter verificare i token emessi in precedenza), una `privateKey` crittografata (utilizzata solo mentre la chiave è quella corrente), un flag `isCurrent` (esattamente una riga alla volta) e un campo `revokedAt` opzionale.
+
+### Ruotare la chiave corrente
+
+Imposta `SIGNING_KEY_ROTATION_DAYS` per aderire: un cron giornaliero emette quindi una nuova chiave corrente quando quella esistente è più vecchia di tale soglia. Le chiavi precedenti *non* vengono revocate, quindi i token firmati con esse continuano a essere verificati. Lascia la variabile non impostata per disattivare la rotazione automatica.
+
+<Note>La rotazione automatica è disponibile a partire dalla versione v2.6+.</Note>
+
+### Revocare una chiave (solo in caso di fuga di dati / emergenza)
+
+**Settings → Admin Panel → Signing keys → Revoke** su una riga non corrente. Cancella il materiale privato crittografato, imposta `revokedAt` e rifiuta ogni token esistente firmato con quel `kid`.
+
+## Ruotare `ENCRYPTION_KEY`
+
+<Note>Il comando `secret-encryption:rotate` descritto di seguito è disponibile dalla v2.6+.</Note>
+
+Ogni valore crittografato è incapsulato come `enc:v2:\<keyId>:\<payload>`, dove `\<keyId>` è un prefisso esadecimale a 8 caratteri derivato dalla chiave grezza. La rotazione è online e riprendibile.
+
+1. **Generare una nuova chiave**: `openssl rand -base64 32`.
+
+2. **Configurare entrambe le chiavi affiancate** in `.env`, quindi riavviare:
+ ```ini
+ ENCRYPTION_KEY=NEW_VALUE
+ FALLBACK_ENCRYPTION_KEY=OLD_VALUE
+ ```
+ Le nuove scritture usano la nuova chiave, le righe esistenti vengono ancora decrittate tramite il fallback.
+
+3. **Ricrittografare le righe esistenti**:
+
+ ```bash
+ docker exec -it {server_container} yarn command:prod secret-encryption:rotate
+ ```
+
+ Il comando passa in rassegna sei sezioni (`connected-account-tokens`, `application-variable`, `application-registration-variable`, `signing-key-private-keys`, `sensitive-config-storage`, `totp-secrets`). Un filtro SQL salta le righe già con il nuovo `\<keyId>`, quindi il comando è idempotente: interrompi e riesegui secondo necessità. Esce con codice diverso da zero se una qualsiasi riga fallisce — riesegui per riprovare.
+
+ | Opzione | Descrizione |
+ | ---------------------------------------- | ----------------------------------------------------------- |
+ | `-s, --site \<site>` | Limita a un singolo sito. |
+ | `-b, --batch-size \<n>` | Righe per batch (predefinito `200`, massimo `5000`). |
+ | `-d, --dry-run` | Decrittografa + ricrittografa in memoria, salta l'`UPDATE`. |
+
+4. **Eliminare il fallback** una volta che `--dry-run` mostra zero righe rimanenti: rimuovere `FALLBACK_ENCRYPTION_KEY` e riavviare.
+
+## Supporto legacy per `APP_SECRET`
+
+Le istanze meno recenti che non hanno mai impostato `ENCRYPTION_KEY` usano `APP_SECRET` come chiave di crittografia a riposo (e come segreto del cookie di sessione, derivato da essa). Questo percorso è mantenuto per compatibilità con le versioni precedenti ma è **deprecato** — imposta una `ENCRYPTION_KEY` dedicata e segui la procedura di rotazione sopra per migrare. `APP_SECRET` continua a essere utilizzata per verificare i token di accesso HS256 legacy.
diff --git a/packages/twenty-docs/l/it/developers/self-host/capabilities/setup.mdx b/packages/twenty-docs/l/it/developers/self-host/capabilities/setup.mdx
index bcc19fc728e..80a7df3bac9 100644
--- a/packages/twenty-docs/l/it/developers/self-host/capabilities/setup.mdx
+++ b/packages/twenty-docs/l/it/developers/self-host/capabilities/setup.mdx
@@ -43,11 +43,26 @@ IS_CONFIG_VARIABLES_IN_DB_ENABLED=true # predefinito
<Warning>
Ogni variabile è documentata con descrizioni nel tuo pannello di amministrazione in **Impostazioni → Pannello di Amministrazione → Variabili di Configurazione**.
-Alcune impostazioni infrastrutturali come connessioni al database (`PG_DATABASE_URL`), URL del server (`SERVER_URL`) e segreti dell'app (`APP_SECRET`) possono essere configurati solo tramite file `.env`.
+Alcune impostazioni infrastrutturali come connessioni al database (`PG_DATABASE_URL`), URL del server (`SERVER_URL`) e segreti (`ENCRYPTION_KEY`, `FALLBACK_ENCRYPTION_KEY`) possono essere configurate solo tramite file `.env`.
[Riferimento tecnico completo →](https://github.com/twentyhq/twenty/blob/main/packages/twenty-server/src/engine/core-modules/twenty-config/config-variables.ts)
</Warning>
+## Chiavi di crittografia
+
+Twenty utilizza due chiavi di crittografia disponibili solo tramite variabili d'ambiente:
+
+| Variabile | Scopo | Obbligatorio |
+| ------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------- |
+| `ENCRYPTION_KEY` | Chiave primaria utilizzata per crittografare i segreti a riposo (token OAuth, variabili dell'applicazione, chiavi private delle chiavi di firma, segreti TOTP, valori di configurazione sensibili). | Sì per le nuove installazioni (le installazioni legacy possono invece fare affidamento su `APP_SECRET` — vedi sotto) |
+| `FALLBACK_ENCRYPTION_KEY` | Chiave utilizzata solo per la verifica. Impostata durante una rotazione alla *precedente* `ENCRYPTION_KEY` in modo che le righe esistenti rimangano decifrabili. | Solo durante la rotazione |
+
+Per garantire la retrocompatibilità, se `ENCRYPTION_KEY` non è impostata, Twenty torna a utilizzare `APP_SECRET` per la crittografia a riposo, in modo da rispecchiare il comportamento legacy delle distribuzioni meno recenti. Le nuove installazioni dovrebbero sempre impostare una `ENCRYPTION_KEY` dedicata.
+
+Genera i valori con `openssl rand -base64 32` e conservali in un luogo sicuro (un secrets manager, configurazioni sigillate, ecc.). Perdere `ENCRYPTION_KEY` significa perdere l'accesso a ogni segreto memorizzato nel database.
+
+Per ruotare `ENCRYPTION_KEY` senza tempi di inattività, consulta la [guida alla rotazione delle chiavi](/l/it/developers/self-host/capabilities/key-rotation).
+
## 2. Configurazione Solo-Ambiente
```bash
diff --git a/packages/twenty-docs/l/it/developers/self-host/capabilities/upgrade-guide.mdx b/packages/twenty-docs/l/it/developers/self-host/capabilities/upgrade-guide.mdx
index 42ae3565d38..9300235f0df 100644
--- a/packages/twenty-docs/l/it/developers/self-host/capabilities/upgrade-guide.mdx
+++ b/packages/twenty-docs/l/it/developers/self-host/capabilities/upgrade-guide.mdx
@@ -31,6 +31,18 @@ A partire da **v1.22**, Twenty supporta gli aggiornamenti tra versioni. Puoi pas
Ad esempio, l'aggiornamento da v1.22 direttamente a v2.0 è pienamente supportato.
+## Aggiornamento alla v2.5+ — envelope di crittografia dei dati a riposo
+
+A partire dalla **v2.5**, Twenty memorizza i segreti a riposo (token OAuth, variabili dell'applicazione, chiavi private di firma, valori di configurazione sensibili, segreti TOTP) all'interno di un envelope versionato `enc:v2:` crittografato con `ENCRYPTION_KEY` (o `APP_SECRET` se `ENCRYPTION_KEY` non è impostata).
+
+Il primo avvio su v2.5 esegue comandi di aggiornamento lenti che popolano retroattivamente le righe esistenti nel nuovo envelope. Sono idempotenti — se si interrompe e si riavvia il server, riprende da dove si era interrotto — ma possono richiedere tempo su database di grandi dimensioni. Puoi monitorare l'avanzamento con `upgrade:status`.
+
+Dovresti impostare un `ENCRYPTION_KEY` dedicato **prima** dell'aggiornamento a v2.5, in modo che il popolamento retroattivo scriva fin dall'inizio le righe sotto tale chiave. Cambiare chiave dopo il popolamento retroattivo richiede una [rotazione](/l/it/developers/self-host/capabilities/key-rotation).
+
+## Rotazione di segreti e chiavi di firma
+
+Per le attività operative quotidiane come ruotare `ENCRYPTION_KEY`, ruotare la chiave di firma JWT o revocare una chiave di firma compromessa, vedi la [Guida alla rotazione delle chiavi](/l/it/developers/self-host/capabilities/key-rotation) dedicata.
+
## Verifica dello stato dell'aggiornamento
Il comando `upgrade:status` consente di ispezionare lo stato corrente della tua istanza e delle migrazioni degli spazi di lavoro. È utile per eseguire il debug di problemi di aggiornamento o quando si apre una richiesta di assistenza.
diff --git a/packages/twenty-docs/l/it/navigation.json b/packages/twenty-docs/l/it/navigation.json
index 075280676e0..4db2cbeb1eb 100644
--- a/packages/twenty-docs/l/it/navigation.json
+++ b/packages/twenty-docs/l/it/navigation.json
@@ -155,7 +155,27 @@
"label": "Panoramica"
},
"apps": {
- "label": "App"
+ "label": "App",
+ "groups": {
+ "appsGettingStarted": {
+ "label": "Per iniziare"
+ },
+ "appsConfig": {
+ "label": "Configurazione"
+ },
+ "appsData": {
+ "label": "Dati"
+ },
+ "appsLogic": {
+ "label": "Logica"
+ },
+ "appsLayout": {
+ "label": "Layout"
+ },
+ "appsOperations": {
+ "label": "Operazioni"
+ }
+ }
},
"api": {
"label": "API"
diff --git a/packages/twenty-docs/l/it/user-guide/ai/capabilities/mcp.mdx b/packages/twenty-docs/l/it/user-guide/ai/capabilities/mcp.mdx
index 5e510d4aab9..4bbdbcdf04a 100644
--- a/packages/twenty-docs/l/it/user-guide/ai/capabilities/mcp.mdx
+++ b/packages/twenty-docs/l/it/user-guide/ai/capabilities/mcp.mdx
@@ -103,11 +103,10 @@ Chiedi al tuo assistente AI di interagire con il tuo CRM:
Una volta connesso, il server MCP espone strumenti che rispecchiano l'API di Twenty. Il flusso di lavoro consigliato è:
-1. **`get_tool_catalog`** — scoprire tutti gli strumenti disponibili
-2. **`learn_tools`** — ottenere lo schema di input per strumenti specifici
-3. **`execute_tool`** — eseguire uno strumento
+1. **`learn_tools`** — ottenere lo schema di input per strumenti specifici
+2. **`execute_tool`** — eseguire uno strumento
-Non è necessario ricordare i nomi degli strumenti. Chiedi al tuo assistente AI cosa può fare e chiamerà `get_tool_catalog` automaticamente.
+Non è necessario ricordare i nomi degli strumenti. Chiedi al tuo assistente AI cosa può fare e chiamerà `learn_tools` automaticamente.
## Permessi
diff --git a/packages/twenty-docs/l/it/user-guide/ai/capabilities/permissions-access-control.mdx b/packages/twenty-docs/l/it/user-guide/ai/capabilities/permissions-access-control.mdx
index 12a973b916d..14e786c0da7 100644
--- a/packages/twenty-docs/l/it/user-guide/ai/capabilities/permissions-access-control.mdx
+++ b/packages/twenty-docs/l/it/user-guide/ai/capabilities/permissions-access-control.mdx
@@ -9,7 +9,7 @@ Gli agenti AI rispettano la struttura delle autorizzazioni esistente. Ciò è pa
## Assegna un ruolo a un agente AI
-1. Vai a **Impostazioni → Ruoli**
+1. Vai a **Impostazioni → Membri → Ruoli**
2. Clicca sul ruolo che vuoi assegnare
3. Apri la scheda **Assegnazione**
4. In **Agenti AI**, fai clic su **+ Assegna a un agente AI**
diff --git a/packages/twenty-docs/l/it/user-guide/ai/how-tos/ai-faq.mdx b/packages/twenty-docs/l/it/user-guide/ai/how-tos/ai-faq.mdx
index 2fb2699c336..66a57f8d6ca 100644
--- a/packages/twenty-docs/l/it/user-guide/ai/how-tos/ai-faq.mdx
+++ b/packages/twenty-docs/l/it/user-guide/ai/how-tos/ai-faq.mdx
@@ -17,7 +17,7 @@ description: Domande frequenti sulle funzionalità di IA in Twenty.
</Accordion>
<Accordion title="Gli agenti di IA avranno accesso a tutti i miei dati?">
- Gli agenti di IA opereranno nell'ambito del sistema di autorizzazioni. Puoi assegnare ruoli specifici agli agenti di IA in **Impostazioni → Ruoli**, dandoti il pieno controllo su quali dati possono accedere e sulle azioni che possono eseguire.
+ Gli agenti di IA opereranno nell'ambito del sistema di autorizzazioni. Puoi assegnare ruoli specifici agli agenti di IA in **Impostazioni → Membri → Ruoli**, dandoti il pieno controllo sui dati a cui possono accedere e sulle azioni che possono eseguire.
</Accordion>
<Accordion title="Come funzioneranno i crediti di IA?">
diff --git a/packages/twenty-docs/l/it/user-guide/ai/overview.mdx b/packages/twenty-docs/l/it/user-guide/ai/overview.mdx
index 666c5e6b9f9..5c5eb32d27c 100644
--- a/packages/twenty-docs/l/it/user-guide/ai/overview.mdx
+++ b/packages/twenty-docs/l/it/user-guide/ai/overview.mdx
@@ -48,7 +48,7 @@ Estendi i tuoi flussi di lavoro con azioni basate sull'IA e agenti autonomi.
Gli agenti di IA saranno gestiti tramite il sistema di autorizzazioni esistente:
-1. Vai a **Impostazioni → Ruoli**
+1. Vai a **Impostazioni → Membri → Ruoli**
2. Configura a quali dati può accedere ciascun agente di IA
3. Imposta le autorizzazioni di lettura/scrittura per oggetto
diff --git a/packages/twenty-docs/l/it/user-guide/billing/capabilities/pricing-plans.mdx b/packages/twenty-docs/l/it/user-guide/billing/capabilities/pricing-plans.mdx
index 0e11bc8671f..61f75dbca88 100644
--- a/packages/twenty-docs/l/it/user-guide/billing/capabilities/pricing-plans.mdx
+++ b/packages/twenty-docs/l/it/user-guide/billing/capabilities/pricing-plans.mdx
@@ -19,7 +19,7 @@ Per i team pronti a scalare:
* Supporto standard
<Note>
-Premium features (SSO, row-level permissions and AI usage data) are not included in the Pro plan.
+Le funzionalità Premium (SSO, autorizzazioni a livello di riga e dati di utilizzo dell'IA) non sono incluse nel piano Pro.
</Note>
### Organizzazione (Cloud)
@@ -27,7 +27,7 @@ Premium features (SSO, row-level permissions and AI usage data) are not included
Per i team più numerosi con esigenze avanzate:
* Tutto ciò che è incluso in Pro
-* **Premium features**: SSO integration, row-level permissions and AI usage data
+* **Funzionalità Premium**: integrazione SSO, autorizzazioni a livello di riga e dati di utilizzo dell'IA
* Supporto prioritario
## Piani self‑hosted
@@ -45,7 +45,7 @@ Esegui Twenty sulla tua infrastruttura senza costi:
Per i team che necessitano di funzionalità premium con il self‑hosting:
* Tutte le funzionalità di Pro
-* **Premium features**: SSO integration, row-level permissions and AI usage data
+* **Funzionalità Premium**: integrazione SSO, autorizzazioni a livello di riga e dati di utilizzo dell'IA
* Supporto del team di Twenty
* Nessun requisito di pubblicare il codice personalizzato come open source prima della distribuzione
@@ -55,7 +55,7 @@ Le funzionalità premium sono disponibili solo nei piani Organizzazione (Cloud o
* **Integrazione SSO**: Single Sign‑On con il tuo provider di identità
* **Autorizzazioni a livello di riga**: controllo degli accessi granulare a livello di record
-* **AI usage data**: Track AI consumption across the workspace
+* **Dati di utilizzo dell'IA**: Tieni traccia del consumo dell'IA nel tuo spazio di lavoro
## Cambio piano
@@ -79,14 +79,14 @@ Contatta il supporto per eseguire il downgrade del tuo piano.
Contatta il supporto per tornare alla fatturazione mensile.
-## Obtain an Enterprise Key for Organization (Self-Hosted)
+## Ottieni una chiave Enterprise per l'Organization (Self-Hosted)
-To use the Organization (Self-Hosted) plan, you need to obtain an Enterprise key:
+Per utilizzare il piano Organization (Self-Hosted), devi ottenere una chiave Enterprise:
-1. Go to **Settings → Admin Panel → Enterprise**
+1. Vai a **Impostazioni → Pannello di Amministrazione → Enterprise**
-<img src="/images/user-guide/billing/enterprise-key.png" alt="Enterprise key" />
+<img src="/images/user-guide/billing/enterprise-key.png" alt="Chiave Enterprise" />
-2. Click **Get Enterprise Key**
-3. When you are redirected to Stripe, enter your payment details and confirm
-4. When your Enterprise key is displayed, paste it into the Enterprise settings page and activate the Organization license
+2. Fai clic su **Ottieni la chiave Enterprise**
+3. Quando vieni reindirizzato a Stripe, inserisci i dati di pagamento e conferma
+4. Quando viene visualizzata la tua chiave Enterprise, incollala nella pagina delle impostazioni Enterprise e attiva la licenza dell'organizzazione
diff --git a/packages/twenty-docs/l/it/user-guide/calendar-emails/overview.mdx b/packages/twenty-docs/l/it/user-guide/calendar-emails/overview.mdx
index a136abf1523..8a2f97aecb5 100644
--- a/packages/twenty-docs/l/it/user-guide/calendar-emails/overview.mdx
+++ b/packages/twenty-docs/l/it/user-guide/calendar-emails/overview.mdx
@@ -25,15 +25,25 @@ description: Collega i tuoi account email e calendario a Twenty.
6. Configura le impostazioni di sincronizzazione del calendario (visibilità, creazione automatica) → fai clic su **Aggiungi account**
7. Le tue email e gli eventi del calendario inizieranno a sincronizzarsi automaticamente
-### Configurazione SMTP/CalDAV (Altri Fornitori)
+### Configurazione IMAP/SMTP/CalDAV (Altri Fornitori)
Per altri fornitori di email e calendario:
1. Vai a **Impostazioni → Account**
-2. Configura le impostazioni SMTP per l'email
+2. Configura le impostazioni IMAP per sincronizzare le email in arrivo e le impostazioni SMTP per inviare email
3. Configura le impostazioni CalDAV per il calendario
4. Testa la connessione
+<Note>
+**Self-hosting su una rete air-gapped o interna**: Per impostazione predefinita, Twenty rifiuta le connessioni in uscita verso indirizzi IP privati/interni (protezione SSRF). Se il tuo server di posta o calendario è in esecuzione su un IP locale/privato (ad es. un server on-premise su una LAN), le connessioni verso di esso verranno bloccate. Per consentirle, imposta la seguente variabile di ambiente sul server:
+
+```
+OUTBOUND_HTTP_SAFE_MODE_ENABLED=false
+```
+
+Questo disabilita la modalità sicura per **tutte** le richieste in uscita (azioni del flusso di lavoro HTTP, webhook e connessioni IMAP/SMTP/CalDAV), quindi impostalo solo su reti affidabili e isolate in cui la protezione SSRF non è necessaria.
+</Note>
+
### Caselle Multiple
* **Account Illimitati**: Collega vari account email per utente
@@ -59,10 +69,19 @@ Scegli diversi livelli di visibilità per le tue email:
* **Disattivato**: Nessuna creazione automatica di contatti
* **Per messaggi inviati e ricevuti**: Crea contatti per tutte le interazioni email esterne
* **Solo per messaggi inviati**: Crea contatti solo per email che invii
-* **Nota**: Le email interne (stesso dominio) non vengono mai sincronizzate per mantenere la privacy
+* **Nota**: Per impostazione predefinita, le email interne (quando tutti i partecipanti condividono il tuo dominio) non vengono sincronizzate per proteggere la privacy
<Note>Quando è attivata, i contatti vengono collegati automaticamente ai relativi record di Azienda in base al loro dominio email. Se l'Azienda non esiste ancora, Twenty la crea per te.</Note>
+<Note>
+**Sincronizzazione delle email interne**: Il comportamento "email interne non sincronizzate" è l’impostazione predefinita, ma può essere disattivato. L’interruttore si trova nelle impostazioni avanzate:
+1. Apri **Impostazioni** e abilita l’interruttore **Avanzate** in fondo alla pagina delle impostazioni
+2. Vai a **Generale → Sicurezza**
+3. Abilita l’interruttore **Sincronizza email interne** per includere le email in cui tutti i partecipanti condividono lo stesso dominio
+
+Questa è un’impostazione valida per l’intero spazio di lavoro (utile per università o organizzazioni con dominio condiviso).
+</Note>
+
### Controlla quali email vengono sincronizzate con la Selezione Cartelle Messaggi
Controlla quali cartelle email sincronizzano con Twenty:
@@ -79,7 +98,7 @@ Questo ti offre un controllo preciso su quali email appaiono nel tuo CRM senza s
**Cosa viene sincronizzato:**
* **Email Esterne**: Tutte le email con contatti esterni dalle cartelle selezionate
-* **Email Interne**: Non sincronizzate (email dello stesso dominio rimangono private)
+* **Email Interne**: Non sincronizzate per impostazione predefinita (le email dello stesso dominio rimangono private). Abilita l’interruttore **Avanzate** in fondo a **Impostazioni**, quindi attiva **Sincronizza email interne** in **Generale → Sicurezza** per includerle a livello di spazio di lavoro.
* **Allegati**: In arrivo nel H1 2026
**Nota**: Non forniamo un indirizzo email CC per la sincronizzazione selettiva. Invece, usa la funzionalità Cartella Messaggi sopra per ottenere lo stesso livello di controllo su quali email sincronizzano con Twenty.
diff --git a/packages/twenty-docs/l/it/user-guide/dashboards/how-tos/dashboards-faq.mdx b/packages/twenty-docs/l/it/user-guide/dashboards/how-tos/dashboards-faq.mdx
index 617b1e92912..b8331191ef8 100644
--- a/packages/twenty-docs/l/it/user-guide/dashboards/how-tos/dashboards-faq.mdx
+++ b/packages/twenty-docs/l/it/user-guide/dashboards/how-tos/dashboards-faq.mdx
@@ -1,5 +1,5 @@
---
-title: Domande frequenti sui cruscotti},{
+title: Domande frequenti sui cruscotti
description: Domande frequenti sui cruscotti in Twenty.
---
diff --git a/packages/twenty-docs/l/it/user-guide/data-migration/capabilities/field-mapping.mdx b/packages/twenty-docs/l/it/user-guide/data-migration/capabilities/field-mapping.mdx
index 9770514825b..029747aa011 100644
--- a/packages/twenty-docs/l/it/user-guide/data-migration/capabilities/field-mapping.mdx
+++ b/packages/twenty-docs/l/it/user-guide/data-migration/capabilities/field-mapping.mdx
@@ -56,7 +56,7 @@ Indirizzo è un campo annidato con più colonne. Alcuni possono essere lasciati
Usa il seguente formato:
```
-[\"value1\",\"value2\"]
+["value1","value2"]
```
### Campi booleani
@@ -94,7 +94,7 @@ Formati supportati:
* Per email aggiuntive: usa **Email / Email primaria** per l'email principale e **Email / Email aggiuntive** con questo formato:
```
```
### Campi ID
@@ -113,7 +113,7 @@ Casi d'uso per la mappatura di una colonna `id`:
Usa un formato JSON valido:
```
-{\"key\":\"value\",\"key2\":\"value2\"}
+{"key":"value","key2":"value2"}
```
### Campi link
@@ -125,7 +125,7 @@ Simili ai campi dominio:
* Per i link secondari, usa la colonna **Link / Link secondari** con questo formato:
```
-[{\"url\":\"https://twenty.com\",\"label\":\"Twenty\"}]
+[{"url":"https://twenty.com","label":"Twenty"}]
```
### Campi a selezione multipla
@@ -133,7 +133,7 @@ Simili ai campi dominio:
Usa i nomi API (non le etichette visualizzate) nel seguente formato:
```
-[\"VALUE1\",\"VALUE2\"]
+["VALUE1","VALUE2"]
```
Vedi [qui](#finding-api-names-for-select-fields) dove trovare i nomi API.
@@ -143,7 +143,7 @@ Vedi [qui](#finding-api-names-for-select-fields) dove trovare i nomi API.
<Warning>
**L'importazione sovrascrive, non aggiunge.**
-Se un record ha già selezionato `VALUE2` e `VALUE3` e importi `[\"VALUE1\"]`, il record avrà solo `VALUE1` dopo l'importazione. Le selezioni precedenti vengono sostituite, non unite.
+Se un record ha già selezionato `VALUE2` e `VALUE3` e importi `["VALUE1"]`, il record avrà solo `VALUE1` dopo l'importazione. Le selezioni precedenti vengono sostituite, non unite.
</Warning>
### Campi numerici
diff --git a/packages/twenty-docs/l/it/user-guide/data-migration/capabilities/file-formats.mdx b/packages/twenty-docs/l/it/user-guide/data-migration/capabilities/file-formats.mdx
index d163b68337a..cf4cb3d63cf 100644
--- a/packages/twenty-docs/l/it/user-guide/data-migration/capabilities/file-formats.mdx
+++ b/packages/twenty-docs/l/it/user-guide/data-migration/capabilities/file-formats.mdx
@@ -25,7 +25,7 @@ Twenty supporta tre formati di file per l'importazione:
## Migliori pratiche per CSV
* **Delimitatore**: usa la virgola (`,`) o il punto e virgola (`;`)
-* **Qualificatore di testo**: usa le virgolette doppie (`\"`) per il testo che contiene virgole
+* **Qualificatore di testo**: usa le virgolette doppie (`"`) per il testo che contiene virgole
* **Terminatori di riga**: Windows (CRLF) o Unix (LF), entrambi supportati
* **Valori vuoti**: lascia le celle vuote, non usare "NULL" o "N/A"
diff --git a/packages/twenty-docs/l/it/user-guide/data-migration/how-tos/migrating-from-other-crms.mdx b/packages/twenty-docs/l/it/user-guide/data-migration/how-tos/migrating-from-other-crms.mdx
index c6ccc398be0..1e818db45f4 100644
--- a/packages/twenty-docs/l/it/user-guide/data-migration/how-tos/migrating-from-other-crms.mdx
+++ b/packages/twenty-docs/l/it/user-guide/data-migration/how-tos/migrating-from-other-crms.mdx
@@ -214,7 +214,7 @@ Dopo aver importato i dati, completa la configurazione del tuo spazio di lavoro:
### Configura ruoli e permessi
-* Configura i ruoli in **Impostazioni → Ruoli**
+* Configura i ruoli in **Impostazioni → Membri → Ruoli**
* Assegna gli utenti ai ruoli appropriati
### Collega email e calendario
diff --git a/packages/twenty-docs/l/it/user-guide/data-migration/how-tos/migrating-from-self-hosted-to-cloud.mdx b/packages/twenty-docs/l/it/user-guide/data-migration/how-tos/migrating-from-self-hosted-to-cloud.mdx
index 89e04517b85..575e3b16aa0 100644
--- a/packages/twenty-docs/l/it/user-guide/data-migration/how-tos/migrating-from-self-hosted-to-cloud.mdx
+++ b/packages/twenty-docs/l/it/user-guide/data-migration/how-tos/migrating-from-self-hosted-to-cloud.mdx
@@ -127,7 +127,7 @@ Dopo aver importato i dati, ricrea manualmente:
### Ruoli e permessi
-* Configura i ruoli in **Impostazioni → Ruoli**
+* Configura i ruoli in **Impostazioni → Membri → Ruoli**
* Assegna gli utenti ai ruoli appropriati
### Integrazioni
diff --git a/packages/twenty-docs/l/it/user-guide/data-model/capabilities/fields.mdx b/packages/twenty-docs/l/it/user-guide/data-model/capabilities/fields.mdx
index f91df7bb8e4..05a78fda2b2 100644
--- a/packages/twenty-docs/l/it/user-guide/data-model/capabilities/fields.mdx
+++ b/packages/twenty-docs/l/it/user-guide/data-model/capabilities/fields.mdx
@@ -101,6 +101,10 @@ Rendi un campo unico per garantire che i record distinti non possano avere lo st
Se ottieni un errore impostando l'unicità, controlla i valori duplicati nei tuoi dati (inclusi i record eliminati).
+## Indici (Avanzato)
+
+Gli indici del database sono gestiti automaticamente — aggiungerne di propri è raramente necessario ed è facile commettere errori. Con la modalità Avanzata attiva, ogni oggetto ha una sezione **Indici** in `Impostazioni → Modello dati → <object>` per i casi in cui sai di averne bisogno.
+
## Procedure Migliori per la Configurazione dei Campi
### Convenzioni e Limitazioni sui Nomi
diff --git a/packages/twenty-docs/l/it/user-guide/permissions-access/capabilities/permissions.mdx b/packages/twenty-docs/l/it/user-guide/permissions-access/capabilities/permissions.mdx
index b22f37be8ba..e03ff129bff 100644
--- a/packages/twenty-docs/l/it/user-guide/permissions-access/capabilities/permissions.mdx
+++ b/packages/twenty-docs/l/it/user-guide/permissions-access/capabilities/permissions.mdx
@@ -13,7 +13,7 @@ Il sistema di permessi di Twenty ti consente di controllare l'accesso a tre aree
Per creare un nuovo ruolo:
-1. Vai a **Impostazioni → Ruoli**
+1. Vai a **Impostazioni → Membri → Ruoli**
2. Sotto **Tutti i Ruoli**, clicca su **+ Crea Ruolo**
3. Inserisci un nome per il ruolo
4. Nella scheda predefinita **Permessi**, [configura i permessi](#customize-permissions)
@@ -23,7 +23,7 @@ Per creare un nuovo ruolo:
Per eliminare un ruolo:
-1. Vai a **Impostazioni → Ruoli**
+1. Vai a **Impostazioni → Membri → Ruoli**
2. Clicca sul ruolo che desideri rimuovere
3. Apri la scheda **Impostazioni**, quindi clicca su **Elimina Ruolo**
4. Clicca su **Conferma** nel modulo
@@ -36,13 +36,13 @@ Se un ruolo viene eliminato, ogni membro dello spazio di lavoro assegnato a esso
### Visualizza Assegnazioni Correnti
-* Vai a **Impostazioni → Ruoli**
+* Vai a **Impostazioni → Membri → Ruoli**
* Vedi tutti i ruoli e quanti membri sono assegnati a ciascuno
* Visualizza quali membri hanno quali ruoli
### Assegna un Ruolo a un Membro
-1. Vai a **Impostazioni → Ruoli**
+1. Vai a **Impostazioni → Membri → Ruoli**
2. Clicca sul ruolo che vuoi assegnare
3. Apri la scheda **Assegnazione**
4. Clicca su **+ Assegna a membro**
@@ -51,7 +51,7 @@ Se un ruolo viene eliminato, ogni membro dello spazio di lavoro assegnato a esso
### Imposta Ruolo Predefinito
-1. Vai a **Impostazioni → Ruoli**
+1. Vai a **Impostazioni → Membri → Ruoli**
2. Nella sezione **Opzioni**, trova **Ruolo Predefinito**
3. Seleziona quale ruolo i nuovi membri dovrebbero ricevere automaticamente
4. I nuovi membri dello spazio di lavoro riceveranno questo ruolo al momento della registrazione
@@ -98,6 +98,22 @@ Fai clic su **+ Aggiungi regola** e seleziona un oggetto per creare un'eccezione
| Opportunities → disabilita "Visualizza record" | Il tirocinante non può vedere affatto l'oggetto Opportunities |
| People → abilita "Modifica record" | Il tirocinante può modificare i record di People (ma non gli altri oggetti) |
+### Permessi a Livello di Riga
+
+<Note>
+I permessi a livello di riga costituiscono una **funzionalità Premium** disponibile nel piano **Organization** (Cloud e Self-Hosted).
+</Note>
+
+I permessi a livello di riga ti consentono di limitare quali singoli record un ruolo può visualizzare o modificare, in base a criteri dinamici. A differenza dei permessi a livello di oggetto (che si applicano a un intero tipo di oggetto), i permessi a livello di riga valutano ogni record in modo indipendente.
+
+**Esempi di casi d'uso:**
+
+* I rappresentanti commerciali possono vedere solo le proprie opportunità
+* I manager possono vedere tutti i record nella loro regione
+* Gli agenti di supporto possono visualizzare solo i ticket a loro assegnati
+
+Per configurare i permessi a livello di riga, apri un ruolo, vai alla scheda **Objects** e utilizza la sezione **Row-Level** per definire le condizioni di filtro per un determinato oggetto.
+
### Permessi a livello di campo
All'interno di ogni regola a livello di oggetto, puoi inoltre configurare i **permessi a livello di campo** per controllare l'accesso a campi specifici.
@@ -168,7 +184,7 @@ Oltre ai membri dello spazio di lavoro, i ruoli possono essere assegnati anche a
### Assegna un ruolo a una chiave API
-1. Vai a **Impostazioni → Ruoli**
+1. Vai a **Impostazioni → Membri → Ruoli**
2. Clicca sul ruolo che vuoi assegnare
3. Apri la scheda **Assegnazione**
4. In **Chiavi API**, fai clic su **+ Assegna a chiave API**
@@ -183,7 +199,7 @@ Le chiavi API senza un ruolo assegnato utilizzano i permessi predefiniti. Per un
### Assegna un ruolo a un Agente IA
-1. Vai a **Impostazioni → Ruoli**
+1. Vai a **Impostazioni → Membri → Ruoli**
2. Clicca sul ruolo che vuoi assegnare
3. Apri la scheda **Assegnazione**
4. In **Agenti IA**, fai clic su **+ Assegna ad agente IA**
diff --git a/packages/twenty-docs/l/it/user-guide/permissions-access/how-tos/permissions-faq.mdx b/packages/twenty-docs/l/it/user-guide/permissions-access/how-tos/permissions-faq.mdx
index 62171d3a186..b7ee8069d7c 100644
--- a/packages/twenty-docs/l/it/user-guide/permissions-access/how-tos/permissions-faq.mdx
+++ b/packages/twenty-docs/l/it/user-guide/permissions-access/how-tos/permissions-faq.mdx
@@ -19,7 +19,7 @@ Ogni membro dell'area di lavoro assegnato a quel ruolo verrà automaticamente ri
</Accordion>
<Accordion title="Come imposto un ruolo predefinito per i nuovi membri?">
-Vai su **Impostazioni → Ruoli**, trova l'opzione **Ruolo predefinito** e seleziona quale ruolo i nuovi membri devono ricevere automaticamente quando si uniscono.
+Vai su **Impostazioni → Membri → Ruoli**, trova l'opzione **Ruolo predefinito** e seleziona quale ruolo i nuovi membri devono ricevere automaticamente quando si uniscono.
</Accordion>
<Accordion title="Posso assegnare più ruoli a un utente?">
@@ -60,11 +60,11 @@ Per i campi:
</Accordion>
<Accordion title="Posso limitare l'accesso a record specifici (permessi a livello di riga)?">
-I permessi a livello di riga saranno disponibili nel piano **Organization** entro il Q1 2026. Ciò consente di limitare l'accesso a record specifici in base a criteri (ad es., vedere solo le proprie opportunità).
+I permessi a livello di riga sono disponibili nel piano **Organization**. Ciò consente di limitare l'accesso a record specifici in base a criteri (ad es., vedere solo le proprie opportunità).
</Accordion>
<Accordion title="Come rendo un campo di sola lettura per determinati utenti?">
-1. Vai a **Impostazioni → Ruoli**
+1. Vai a **Impostazioni → Membri → Ruoli**
2. Seleziona il ruolo
3. Vai all'oggetto contenente il campo
4. Imposta il permesso del campo su **Visualizza campo** (senza Modifica campo)
diff --git a/packages/twenty-docs/l/it/user-guide/settings/capabilities/domains-settings.mdx b/packages/twenty-docs/l/it/user-guide/settings/capabilities/domains-settings.mdx
index 703a4814200..da5b2e27261 100644
--- a/packages/twenty-docs/l/it/user-guide/settings/capabilities/domains-settings.mdx
+++ b/packages/twenty-docs/l/it/user-guide/settings/capabilities/domains-settings.mdx
@@ -3,10 +3,12 @@ title: Impostazioni del dominio
description: Configura il dominio dello spazio di lavoro, i domini di accesso approvati e i domini pubblici.
---
-Configura le impostazioni del dominio in **Impostazioni → Domini**.
+Le impostazioni di dominio si trovano in tre posizioni, a seconda di ciò che stai configurando.
## Dominio del workspace
+Configura in **Impostazioni → Generali → Dominio dello spazio di lavoro**.
+
Modifica il nome del sottodominio o imposta un dominio personalizzato per il tuo spazio di lavoro.
### Personalizza dominio
@@ -19,6 +21,8 @@ Per i domini personalizzati, dovrai configurare le impostazioni DNS con il tuo p
## Domini approvati
+Configura in **Impostazioni → Membri → Invita**.
+
Chiunque abbia un indirizzo email presso questi domini è autorizzato a registrarsi automaticamente per questo spazio di lavoro.
### Aggiungi dominio di accesso approvato
@@ -35,13 +39,16 @@ Questo è utile per consentire a tutto il tuo team di registrarsi autonomamente,
## Domini Pubblici
-Crea un ambiente di hosting completo e sicuro su questi domini.
+Configura in **Impostazioni → App → Sviluppatore**.
+
+Crea un ambiente di hosting completo e sicuro su questi domini. Un dominio pubblico può essere associato a una specifica app: quando è associato, solo le funzioni logiche instradate tramite HTTP di quell'app sono raggiungibili sul dominio. Lascia l'associazione vuota per esporre tutti i percorsi HTTP dello spazio di lavoro.
### Aggiungi Dominio Pubblico
1. Fai clic su **Aggiungi dominio pubblico**
2. Inserisci il dominio che desideri utilizzare
-3. Configura le impostazioni DNS come indicato
-4. Verifica il dominio
+3. Facoltativamente, associalo a un'app
+4. Configura le impostazioni DNS come indicato
+5. Verifica il dominio
I certificati SSL vengono emessi automaticamente per i domini pubblici.
diff --git a/packages/twenty-docs/l/it/user-guide/settings/capabilities/member-management.mdx b/packages/twenty-docs/l/it/user-guide/settings/capabilities/member-management.mdx
index 45d8253211e..17069f74b99 100644
--- a/packages/twenty-docs/l/it/user-guide/settings/capabilities/member-management.mdx
+++ b/packages/twenty-docs/l/it/user-guide/settings/capabilities/member-management.mdx
@@ -77,7 +77,7 @@ Gestisci gli inviti non ancora accettati:
Consenti ai membri del team di unirsi automaticamente in base al loro dominio email:
-1. Vai a **Impostazioni → Domini**
+1. Vai a **Impostazioni → Membri → Invita**
2. Aggiungi il dominio della tua azienda (ad es., `yourcompany.com`)
3. Chiunque con quel dominio email può unirsi senza invito
diff --git a/packages/twenty-docs/l/it/user-guide/settings/how-tos/settings-faq.mdx b/packages/twenty-docs/l/it/user-guide/settings/how-tos/settings-faq.mdx
index f89ff0cc9c0..42315e001ba 100644
--- a/packages/twenty-docs/l/it/user-guide/settings/how-tos/settings-faq.mdx
+++ b/packages/twenty-docs/l/it/user-guide/settings/how-tos/settings-faq.mdx
@@ -137,7 +137,7 @@ Sì, puoi collegare più account email. Vai a **Impostazioni → Account** e agg
<AccordionGroup>
<Accordion title="Posso personalizzare il dominio del mio workspace?">
-Sì! Vai a **Impostazioni → Domini** e fai clic su **Personalizza dominio**. Hai due opzioni:
+Sì! Vai a **Impostazioni → Generali → Dominio dell'area di lavoro** e fai clic su **Personalizza dominio**. Hai due opzioni:
* **Sottodominio**: usa un sottodominio di Twenty come `yourcompany.twenty.com`
* **Dominio personalizzato**: usa il tuo dominio, ad esempio `crm.yourcompany.com` (richiede la configurazione DNS)
@@ -146,7 +146,7 @@ Un sottodominio è rapido da configurare, mentre un dominio personalizzato offre
</Accordion>
<Accordion title="Come funzionano i domini di accesso approvati?">
-Puoi configurare domini di accesso approvati in modo che i membri del team con indirizzi email aziendali possano unirsi automaticamente al tuo spazio di lavoro. Vai a **Impostazioni → Domini** e aggiungi il dominio della tua azienda (ad es., `yourcompany.com`).
+Puoi configurare domini di accesso approvati in modo che i membri del team con indirizzi email aziendali possano unirsi automaticamente al tuo spazio di lavoro. Vai a **Impostazioni → Membri → Invita** e aggiungi il dominio della tua azienda (ad es., `yourcompany.com`).
</Accordion>
</AccordionGroup>
diff --git a/packages/twenty-docs/l/it/user-guide/settings/overview.mdx b/packages/twenty-docs/l/it/user-guide/settings/overview.mdx
index 7bb727059ec..d52331b1d61 100644
--- a/packages/twenty-docs/l/it/user-guide/settings/overview.mdx
+++ b/packages/twenty-docs/l/it/user-guide/settings/overview.mdx
@@ -44,7 +44,7 @@ Aggiungi membri del team al tuo spazio di lavoro:
4. Assegna i ruoli appropriati
<Note>
-Prima di invitare il tuo team, verifica il ruolo predefinito in **Impostazioni → Ruoli**. Ai nuovi membri viene assegnato automaticamente questo ruolo quando si uniscono.
+Prima di invitare il tuo team, verifica il ruolo predefinito in **Impostazioni → Membri → Ruoli**. Ai nuovi membri viene assegnato automaticamente questo ruolo quando si uniscono.
</Note>
## Elenco di controllo delle impostazioni dello spazio di lavoro
diff --git a/packages/twenty-docs/l/it/user-guide/views-pipelines/how-tos/show-expected-amount-in-pipeline.mdx b/packages/twenty-docs/l/it/user-guide/views-pipelines/how-tos/show-expected-amount-in-pipeline.mdx
index eaf800b9aad..b5b0ef25eab 100644
--- a/packages/twenty-docs/l/it/user-guide/views-pipelines/how-tos/show-expected-amount-in-pipeline.mdx
+++ b/packages/twenty-docs/l/it/user-guide/views-pipelines/how-tos/show-expected-amount-in-pipeline.mdx
@@ -1,5 +1,5 @@
---
-title: Mostra l\"Importo previsto nella tua pipeline\
+title: Mostra l"Importo previsto nella tua pipeline\
description: Calcola e visualizza i valori delle opportunità ponderati in base alla probabilità della fase.
---
@@ -38,7 +38,7 @@ Hai bisogno di due campi personalizzati sull"oggetto Opportunità.
Se non vuoi che gli utenti modifichino manualmente questi campi calcolati:
-1. Vai a **Impostazioni → Ruoli**
+1. Vai a **Impostazioni → Membri → Ruoli**
2. Seleziona il ruolo da configurare
3. Trova l"oggetto Opportunità
4. Imposta i campi **Probabilità** e **Importo previsto** come di sola lettura
diff --git a/packages/twenty-docs/l/it/user-guide/views-pipelines/how-tos/track-time-in-stage.mdx b/packages/twenty-docs/l/it/user-guide/views-pipelines/how-tos/track-time-in-stage.mdx
index 69a34d13e6d..01f0992d139 100644
--- a/packages/twenty-docs/l/it/user-guide/views-pipelines/how-tos/track-time-in-stage.mdx
+++ b/packages/twenty-docs/l/it/user-guide/views-pipelines/how-tos/track-time-in-stage.mdx
@@ -61,7 +61,7 @@ Non servono campi "Giorni in" per Chiuso vinto e Chiuso perso, poiché sono fasi
Se non vuoi che gli utenti modifichino manualmente questi campi calcolati:
-1. Vai a **Impostazioni → Ruoli**
+1. Vai a **Impostazioni → Membri → Ruoli**
2. Seleziona il ruolo da configurare
3. Trova l'oggetto Opportunità
4. Imposta i campi "Ultimo ingresso" e "Giorni in" come di sola lettura
diff --git a/packages/twenty-docs/l/it/user-guide/workflows/capabilities/workflow-actions.mdx b/packages/twenty-docs/l/it/user-guide/workflows/capabilities/workflow-actions.mdx
index 9b7e1ff7255..618181369b6 100644
--- a/packages/twenty-docs/l/it/user-guide/workflows/capabilities/workflow-actions.mdx
+++ b/packages/twenty-docs/l/it/user-guide/workflows/capabilities/workflow-actions.mdx
@@ -307,5 +307,5 @@ Le azioni dell'agente AI consumano crediti del flusso di lavoro in base al model
</Note>
<Note>
-Gli agenti AI rispettano le autorizzazioni basate sui ruoli. Puoi assegnare ruoli specifici agli agenti in **Impostazioni → Ruoli** per controllare a quali dati possono accedere. Vedi [Autorizzazioni](/l/it/user-guide/permissions-access/capabilities/permissions) per i dettagli.
+Gli agenti AI rispettano le autorizzazioni basate sui ruoli. Puoi assegnare ruoli specifici agli agenti in **Impostazioni → Membri → Ruoli** per controllare a quali dati possono accedere. Vedi [Autorizzazioni](/l/it/user-guide/permissions-access/capabilities/permissions) per i dettagli.
</Note>
diff --git a/packages/twenty-docs/l/it/user-guide/workflows/how-tos/need-more-help/workflows-faq.mdx b/packages/twenty-docs/l/it/user-guide/workflows/how-tos/need-more-help/workflows-faq.mdx
index f2649aebfb7..379eaf468ab 100644
--- a/packages/twenty-docs/l/it/user-guide/workflows/how-tos/need-more-help/workflows-faq.mdx
+++ b/packages/twenty-docs/l/it/user-guide/workflows/how-tos/need-more-help/workflows-faq.mdx
@@ -8,7 +8,7 @@ description: Domande frequenti sui flussi di lavoro in Twenty.
<Accordion title="Perché non riesco ad attivare un flusso di lavoro?">
È probabilmente un problema di permessi. Hai bisogno dell'accesso ai flussi di lavoro per crearli e attivarli.
- **Soluzione**: Contatta l'amministratore dello spazio di lavoro per concederti l'accesso ai flussi di lavoro in **Impostazioni → Ruoli**.
+ **Soluzione**: Contatta l'amministratore dello spazio di lavoro per concederti l'accesso ai flussi di lavoro in **Impostazioni → Membri → Ruoli**.
Se non vedi affatto la sezione Flussi di lavoro nella barra laterale, ciò conferma che è un problema di permessi.
</Accordion>
diff --git a/packages/twenty-docs/l/ko/developers/contribute/capabilities/backend-development/custom-objects.mdx b/packages/twenty-docs/l/ko/developers/contribute/capabilities/backend-development/custom-objects.mdx
index 9306ec141b3..5a72717a4a6 100644
--- a/packages/twenty-docs/l/ko/developers/contribute/capabilities/backend-development/custom-objects.mdx
+++ b/packages/twenty-docs/l/ko/developers/contribute/capabilities/backend-development/custom-objects.mdx
@@ -11,7 +11,7 @@ title: 사용자 지정 개체
## 고급 스키마
<div style={{textAlign: 'center'}}>
- <img src="/images/docs/server/custom-object-schema.png" alt="고급 스키마" />
+ <img src="/images/docs/server/custom-object-schema.png" alt="고급 스키마" />
</div>
<br />
@@ -27,7 +27,7 @@ title: 사용자 지정 개체
사용자 지정 개체를 추가하려면 /metadata API를 쿼리하십시오. 이는 메타데이터를 해당 API에 따라 업데이트하고, 메타데이터를 기반으로 GraphQL 스키마를 계산하여 나중에 사용할 수 있도록 GQL 캐시에 저장합니다.
<div style={{textAlign: 'center'}}>
- <img src="/images/docs/server/add-custom-objects.jpeg" alt="/metadata API를 쿼리하여 사용자 지정 개체를 추가하십시오." />
+ <img src="/images/docs/server/add-custom-objects.jpeg" alt="/metadata API를 쿼리하여 사용자 지정 개체를 추가하십시오." />
</div>
<br />
@@ -35,5 +35,5 @@ title: 사용자 지정 개체
데이터를 가져오려면 /graphql 엔드포인트를 통해 쿼리를 수행하고 Query Resolver를 통해 전달하는 과정이 포함됩니다.
<div style={{textAlign: 'center'}}>
- <img src="/images/docs/server/custom-object-schema.png" alt="/graphql 엔드포인트를 쿼리하여 데이터를 가져오십시오." />
+ <img src="/images/docs/server/custom-object-schema.png" alt="/graphql 엔드포인트를 쿼리하여 데이터를 가져오십시오." />
</div>
diff --git a/packages/twenty-docs/l/ko/developers/contribute/capabilities/backend-development/server-commands.mdx b/packages/twenty-docs/l/ko/developers/contribute/capabilities/backend-development/server-commands.mdx
index 5d8427bc0d4..6365376515f 100644
--- a/packages/twenty-docs/l/ko/developers/contribute/capabilities/backend-development/server-commands.mdx
+++ b/packages/twenty-docs/l/ko/developers/contribute/capabilities/backend-development/server-commands.mdx
@@ -1,5 +1,6 @@
---
title: 백엔드 명령어
+icon: terminal
---
## 유용한 명령어
@@ -43,6 +44,13 @@ npx nx run twenty-server:database:reset
```
### 마이그레이션
+
+#### Core/Metadata 스키마의 객체용 (TypeORM)
+
+```bash
+npx nx run twenty-server:database:migrate:generate
+```
+
## 기술 스택
Twenty는 주로 NestJS를 백엔드에 사용합니다.
diff --git a/packages/twenty-docs/l/ko/developers/contribute/capabilities/backend-development/zapier.mdx b/packages/twenty-docs/l/ko/developers/contribute/capabilities/backend-development/zapier.mdx
index 23a71af34bf..334711b0248 100644
--- a/packages/twenty-docs/l/ko/developers/contribute/capabilities/backend-development/zapier.mdx
+++ b/packages/twenty-docs/l/ko/developers/contribute/capabilities/backend-development/zapier.mdx
@@ -43,7 +43,9 @@ cp .env.example .env
## 개발
<Warning>
- `zapier` 명령어를 실행하기 전에 반드시 `yarn build`를 실행하세요.
+
+`zapier` 명령어를 실행하기 전에 반드시 `yarn build`를 실행하세요.
+
</Warning>
### 테스트
diff --git a/packages/twenty-docs/l/ko/developers/contribute/capabilities/bug-and-requests.mdx b/packages/twenty-docs/l/ko/developers/contribute/capabilities/bug-and-requests.mdx
index 8fc252ed8f0..a232cf44c07 100644
--- a/packages/twenty-docs/l/ko/developers/contribute/capabilities/bug-and-requests.mdx
+++ b/packages/twenty-docs/l/ko/developers/contribute/capabilities/bug-and-requests.mdx
@@ -1,5 +1,6 @@
---
title: 버그, 요청 및 Pull Request
+icon: 버그
info: 이슈를 보고하고, 기능을 요청하고, 코드에 기여하세요
---
diff --git a/packages/twenty-docs/l/ko/developers/contribute/capabilities/frontend-development/best-practices-front.mdx b/packages/twenty-docs/l/ko/developers/contribute/capabilities/frontend-development/best-practices-front.mdx
index d7114789469..ab49e2ba866 100644
--- a/packages/twenty-docs/l/ko/developers/contribute/capabilities/frontend-development/best-practices-front.mdx
+++ b/packages/twenty-docs/l/ko/developers/contribute/capabilities/frontend-development/best-practices-front.mdx
@@ -1,5 +1,6 @@
---
title: 모범 사례
+icon: 별
---
이 문서는 프론트엔드 작업 시 따라야 할 모범 사례를 설명합니다.
@@ -8,12 +9,14 @@ title: 모범 사례
React와 Jotai는 코드베이스에서 상태 관리를 처리합니다.
-### `useAtomState`로 상태 저장하기
+### Jotai 아톰으로 상태 저장하기
상태를 저장하는 데 필요한 만큼의 atom을 만드는 것이 좋은 습관입니다.
<Warning>
- 프롭스 드릴링에 너무 많은 노력을 기울이기보다는 추가 아톰을 사용하는 것이 좋습니다.
+
+프롭스 드릴링에 너무 많은 노력을 기울이기보다는 추가 아톰을 사용하는 것이 좋습니다.
+
</Warning>
```tsx
@@ -43,7 +46,7 @@ export const MyComponent = () => {
상태 저장에 `useRef`를 사용하지 않도록 주의하십시오.
-If you want to store state, you should use `useState` or `useAtomState`.
+상태를 저장하려면 `useState`를 사용하거나 `useAtomState`와 함께 Jotai 아톰을 사용해야 합니다.
일부 리렌더링을 방지하기 위해 `useRef`가 필요하다고 느낄 경우 [리렌더링 관리 방법](#managing-re-renders)을 참조하십시오.
@@ -130,9 +133,9 @@ export const App = () => (
);
```
-### Jotai 가족 상태 및 Jotai 가족 선택자 사용하기
+### 아톰 가족 상태 및 선택자 사용하기
-Jotai 가족 상태와 선택자는 리렌더링을 피하기 위한 훌륭한 방법입니다.
+아톰 가족 상태와 선택자는 리렌더링을 피하기 위한 훌륭한 방법입니다.
항목 목록을 저장해야 할 때 유용합니다.
diff --git a/packages/twenty-docs/l/ko/developers/contribute/capabilities/frontend-development/folder-architecture-front.mdx b/packages/twenty-docs/l/ko/developers/contribute/capabilities/frontend-development/folder-architecture-front.mdx
index e5f9e5d264c..0d65163264a 100644
--- a/packages/twenty-docs/l/ko/developers/contribute/capabilities/frontend-development/folder-architecture-front.mdx
+++ b/packages/twenty-docs/l/ko/developers/contribute/capabilities/frontend-development/folder-architecture-front.mdx
@@ -1,5 +1,6 @@
---
title: 폴더 아키텍처
+icon: folder-tree
info: 우리의 폴더 아키텍처를 자세히 살펴보기
---
@@ -84,7 +85,7 @@ module1
상태 관리 로직이 포함되어 있습니다. [Jotai](https://jotai.org)가 이것을 처리합니다.
-* 셀렉터: 파생 아톰(`createAtomSelector` 사용)은 다른 아톰에서 값을 계산하며 자동으로 메모이제이션됩니다.
+* 셀렉터: 파생 atom(`createAtomSelector` 사용)은 다른 atom으로부터 값을 계산하며 자동으로 메모이제이션됩니다.
React의 내장 상태 관리는 구성 요소 내에서의 상태를 여전히 처리합니다.
diff --git a/packages/twenty-docs/l/ko/developers/contribute/capabilities/frontend-development/frontend-commands.mdx b/packages/twenty-docs/l/ko/developers/contribute/capabilities/frontend-development/frontend-commands.mdx
index 918bf7e2e07..75a5d8684df 100644
--- a/packages/twenty-docs/l/ko/developers/contribute/capabilities/frontend-development/frontend-commands.mdx
+++ b/packages/twenty-docs/l/ko/developers/contribute/capabilities/frontend-development/frontend-commands.mdx
@@ -1,5 +1,6 @@
---
title: 프론트엔드 명령어
+icon: 터미널
---
## 유용한 명령어
@@ -77,7 +78,7 @@ To avoid unnecessary [re-renders](/l/ko/developers/contribute/capabilities/front
### 상태 관리
-[Jotai](https://jotai.org/)이 상태 관리를 처리합니다.
+[Jotai](https://jotai.org/)가 상태 관리를 처리합니다.
상태 관리에 대한 자세한 정보는 [최고의 관례](/l/ko/developers/contribute/capabilities/frontend-development/best-practices-front#state-management)를 참조하십시오.
diff --git a/packages/twenty-docs/l/ko/developers/contribute/capabilities/frontend-development/hotkeys.mdx b/packages/twenty-docs/l/ko/developers/contribute/capabilities/frontend-development/hotkeys.mdx
index fd6c1c9cf0e..a7846acf9cc 100644
--- a/packages/twenty-docs/l/ko/developers/contribute/capabilities/frontend-development/hotkeys.mdx
+++ b/packages/twenty-docs/l/ko/developers/contribute/capabilities/frontend-development/hotkeys.mdx
@@ -160,7 +160,7 @@ export enum PageHotkeyScope {
}
```
-내부적으로, 현재 선택한 스코프는 애플리케이션 전반에 걸쳐 공유되는 Jotai 상태에 저장됩니다:
+내부적으로, 현재 선택한 스코프는 애플리케이션 전반에 걸쳐 공유되는 Jotai atom에 저장됩니다:
```tsx
export const currentHotkeyScopeState = createState<HotkeyScope>({
@@ -169,10 +169,10 @@ export const currentHotkeyScopeState = createState<HotkeyScope>({
});
```
-하지만 이 Jotai 상태는 수동으로 처리해서는 안 됩니다! 다음 섹션에서 사용하는 방법을 배웁니다.
+하지만 이 atom은 수동으로 처리해서는 안 됩니다! 다음 섹션에서 사용하는 방법을 배웁니다.
## 내부적으로 어떻게 작동합니까?
[react-hotkeys-hook](https://react-hotkeys-hook.vercel.app/docs/intro) 위에 얇은 래퍼를 만들어 성능을 높이고 불필요한 재랜더링을 방지합니다.
-또한 핫키 스코프 상태를 처리하고 애플리케이션 전반에서 사용할 수 있도록 한 Jotai 상태를 만듭니다.
+또한 핫키 스코프 상태를 처리하고 애플리케이션 전반에서 사용할 수 있도록 Jotai atom을 만듭니다.
diff --git a/packages/twenty-docs/l/ko/developers/contribute/capabilities/frontend-development/style-guide.mdx b/packages/twenty-docs/l/ko/developers/contribute/capabilities/frontend-development/style-guide.mdx
index 4b8868b5c3a..4057260d219 100644
--- a/packages/twenty-docs/l/ko/developers/contribute/capabilities/frontend-development/style-guide.mdx
+++ b/packages/twenty-docs/l/ko/developers/contribute/capabilities/frontend-development/style-guide.mdx
@@ -1,5 +1,6 @@
---
title: 스타일 가이드
+icon: 페인트 브러시
---
이 문서에는 코드 작성 시 따라야 할 규칙이 포함되어 있습니다.
@@ -8,7 +9,7 @@ title: 스타일 가이드
이를 위해서는 너무 간결하기보다는 약간 더 장황한 것이 낫습니다.
-항상 사람들이 코드를 작성하는 것보다 더 자주 읽는다는 점을 염두에 두십시오. 특히 누구나 기여할 수 있는 오픈 소스 프로젝트에서 그렇습니다.
+항상 사람들이 코드를 작성하는 것보다 더 자주 읽는다는 점을 염두에 두십시오. 특히 누구나 기여할 수 있는 오픈 소스 프로젝트에서는 더욱 그렇습니다.
여기에 정의되지 않은 많은 규칙이 있지만 린터에 의해 자동으로 확인됩니다.
@@ -150,7 +151,7 @@ type MyType = {
### 열거형 대신 문자열 리터럴 사용
-[String literals](https://www.typescriptlang.org/docs/handbook/2/everyday-types.html#literal-types)는 TypeScript에서 열거형과 같은 값을 처리하는 주요 방법입니다. 그들은 Pick와 Omit으로 확장하기 쉬우며, 특히 코드 완성 기능을 사용할 때 더 나은 사용자 경험을 제공합니다.
+[String literals](https://www.typescriptlang.org/docs/handbook/2/everyday-types.html#literal-types)는 TypeScript에서 열거형과 같은 값을 처리하는 주요 방법입니다. 이들은 Pick과 Omit으로 확장하기 더 쉽고, 특히 코드 자동 완성 기능을 사용할 때 더 나은 개발자 경험을 제공합니다.
타입스크립트가 열거형 사용을 피하도록 권장하는 이유는 [여기](https://www.typescriptlang.org/docs/handbook/2/everyday-types.html#enums)에서 확인할 수 있습니다.
@@ -260,7 +261,7 @@ const StyledButton = styled.button`
## No-Type Import 강제 실행
-타입 import를 피하십시오. 이 표준을 강화하기 위해 Oxlint 규칙이 모든 타입 import를 확인하고 보고합니다. 이는 TypeScript 코드의 일관성과 가독성을 유지하는 데 도움이 됩니다.
+타입 import를 피하십시오. 이 표준을 강제하기 위해 Oxlint 규칙이 모든 타입 import를 검사하고 보고합니다. 이는 TypeScript 코드의 일관성과 가독성을 유지하는 데 도움이 됩니다.
```tsx
// ❌ Bad
@@ -283,8 +284,8 @@ import { Meta, StoryObj } from '@storybook/react';
### Oxlint 규칙
-Oxlint 규칙인 `typescript/consistent-type-imports`는 타입 없는 import 표준을 강제합니다. 이 규칙은 모든 타입 import 위반에 대해 오류나 경고를 생성합니다.
+Oxlint 규칙인 `typescript/consistent-type-imports`는 타입 import 금지 표준을 강제합니다. 이 규칙은 모든 타입 import 위반에 대해 오류나 경고를 생성합니다.
이 규칙은 의도치 않은 타입 import가 발생하는 드문 경계 사례를 구체적으로 다룹니다. 타입스크립트 자체는 [TypeScript 3.8 릴리스 노트](https://www.typescriptlang.org/docs/handbook/release-notes/typescript-3-8.html)에서 이 관행을 권장하지 않습니다. 대부분의 상황에서 타입 전용 import를 사용할 필요가 없습니다.
-이 규칙을 준수하는 코드를 보장하기 위해 Oxlint를 개발 워크플로의 일부로 실행하십시오.
+코드가 이 규칙을 준수하도록 개발 워크플로의 일부로 Oxlint를 실행하십시오.
diff --git a/packages/twenty-docs/l/ko/developers/contribute/capabilities/frontend-development/work-with-figma.mdx b/packages/twenty-docs/l/ko/developers/contribute/capabilities/frontend-development/work-with-figma.mdx
index 7273c3f74c8..89db081e8a6 100644
--- a/packages/twenty-docs/l/ko/developers/contribute/capabilities/frontend-development/work-with-figma.mdx
+++ b/packages/twenty-docs/l/ko/developers/contribute/capabilities/frontend-development/work-with-figma.mdx
@@ -13,7 +13,9 @@ Figma는 디자이너와 개발자 간의 소통 장벽을 허무는 협업 인
전문 모드 및 전용 프레임 선택 기능과 같이 로그인한 사용자에게만 제공되는 주요 기능이 있습니다.
<Warning>
- 계정 없이는 효과적으로 협업할 수 없습니다.
+
+계정 없이는 효과적으로 협업할 수 없습니다.
+
</Warning>
## Figma 구조
diff --git a/packages/twenty-docs/l/ko/developers/contribute/capabilities/local-setup.mdx b/packages/twenty-docs/l/ko/developers/contribute/capabilities/local-setup.mdx
index 1e35ac6f784..af7413e92c9 100644
--- a/packages/twenty-docs/l/ko/developers/contribute/capabilities/local-setup.mdx
+++ b/packages/twenty-docs/l/ko/developers/contribute/capabilities/local-setup.mdx
@@ -1,71 +1,72 @@
---
title: 로컬 설정
+icon: laptop-code
description: 콘트리뷰터(기여자)나 호기심 많은 개발자를 위한 가이드로서, Twenty를 로컬에서 실행하고자 하는 분들에게 드리는 안내입니다.
---
## 사전 준비
<Tabs>
- <Tab title="리눅스 및 맥OS">
- Twenty를 설치하고 사용하기 전에, 먼저 컴퓨터에 다음을 설치하세요:
-
- * [Git](https://git-scm.com/book/en/v2/Getting-Started-Installing-Git)
- * [Node v24.5.0](https://nodejs.org/en/download)
- * [yarn v4](https://yarnpkg.com/getting-started/install)
- * [nvm](https://github.com/nvm-sh/nvm/blob/master/README.md)
-
- <Warning>
- `npm`은 사용할 수 없으며, 대신 `yarn`을 사용해야 합니다. Yarn은 이제 Node.js와 함께 제공되기 때문에 별도로 설치할 필요가 없습니다.
- 아직 하지 않았다면 `corepack enable`을 실행하여 Yarn을 사용할 수 있도록 설정하세요.
- </Warning>
- </Tab>
+<Tab title="Linux 및 macOS">
- <Tab title="윈도우 (WSL)">
- 1. WSL 설치
- PowerShell을 관리자 권한으로 열고 다음을 실행하세요:
+Twenty를 설치하고 사용하기 전에, 먼저 컴퓨터에 다음을 설치하세요:
+* [Git](https://git-scm.com/book/en/v2/Getting-Started-Installing-Git)
+* [Node v24.5.0](https://nodejs.org/en/download)
+* [yarn v4](https://yarnpkg.com/getting-started/install)
+* [nvm](https://github.com/nvm-sh/nvm/blob/master/README.md)
- ```powershell
- wsl --install
- ```
+<Warning>
+`npm`은 사용할 수 없으며, 대신 `yarn`을 사용해야 합니다. Yarn은 이제 Node.js와 함께 제공되기 때문에 별도로 설치할 필요가 없습니다.
+아직 하지 않았다면 `corepack enable`을 실행하여 Yarn을 사용할 수 있도록 설정하세요.
+</Warning>
- 이제 컴퓨터를 재시작하라는 프롬프트가 나타날 것입니다. 그렇지 않으면 수동으로 재시작하세요.
+</Tab>
- 재시작 후, powershell 창이 열리고 Ubuntu가 설치됩니다. 이 작업은 다소 시간이 걸릴 수 있습니다.
- Ubuntu 설치 시 사용자 이름과 암호를 만드는 프롬프트가 나타납니다.
+<Tab title="윈도우 (WSL)">
- 2. Git 설치 및 구성
+1. WSL 설치
+ PowerShell을 관리자 권한으로 열고 다음을 실행하세요:
+```powershell
+wsl --install
+```
+이제 컴퓨터를 재시작하라는 프롬프트가 나타날 것입니다. 그렇지 않으면 수동으로 재시작하세요.
- ```bash
- sudo apt-get install git
+다시 시작 후 PowerShell 창이 열리고 Ubuntu가 설치됩니다. 이 작업은 다소 시간이 걸릴 수 있습니다.
+Ubuntu 설치 시 사용자 이름과 암호를 만드는 프롬프트가 나타납니다.
- git config --global user.name "Your Name"
+2. Git 설치 및 구성
- git config --global user.email "[email protected]"
- ```
+```bash
+sudo apt-get install git
- 3. nvm, node.js 및 yarn 설치
+git config --global user.name "Your Name"
- <Warning>
- 적절한 `node` 버전을 설치하기 위해 `nvm`을 사용하세요. `.nvmrc`는 모든 기여자가 동일한 버전을 사용하도록 보장합니다.
- </Warning>
+git config --global user.email "[email protected]"
+```
- ```bash
- sudo apt-get install curl
+3. nvm, node.js 및 yarn 설치
- curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/master/install.sh | bash
- ```
+<Warning>
+적절한 `node` 버전을 설치하기 위해 `nvm`을 사용하세요. `.nvmrc`는 모든 기여자가 동일한 버전을 사용하도록 보장합니다.
+</Warning>
- nvm을 사용하려면 터미널을 닫았다가 다시 여세요. 그런 다음 다음 명령어를 실행하세요.
+```bash
+sudo apt-get install curl
- ```bash
+curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/master/install.sh | bash
+```
+nvm을 사용하려면 터미널을 닫았다가 다시 여세요. 그런 다음 다음 명령어를 실행하세요.
- nvm install # installs recommended node version
+```bash
- nvm use # use recommended node version
+nvm install # installs recommended node version
- corepack enable
- ```
- </Tab>
+nvm use # use recommended node version
+
+corepack enable
+```
+
+</Tab>
</Tabs>
---
@@ -75,19 +76,19 @@ description: 콘트리뷰터(기여자)나 호기심 많은 개발자를 위한
터미널에서 다음 명령어를 실행하세요.
<Tabs>
- <Tab title="SSH (권장)">
- 아직 SSH 키를 설정하지 않은 경우, [여기](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/about-ssh)를 참조하여 설정하는 방법을 배우세요.
+<Tab title="SSH (권장)">
+아직 SSH 키를 설정하지 않은 경우, [여기](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/about-ssh)를 참조하여 설정하는 방법을 배우세요.
+```bash
+git clone [email protected]:twentyhq/twenty.git
+```
+</Tab>
+<Tab title="HTTPS">
- ```bash
- git clone [email protected]:twentyhq/twenty.git
- ```
- </Tab>
+```bash
+git clone https://github.com/twentyhq/twenty.git
+```
- <Tab title="HTTPS">
- ```bash
- git clone https://github.com/twentyhq/twenty.git
- ```
- </Tab>
+</Tab>
</Tabs>
## 2단계: 루트 위치 설정
@@ -103,21 +104,17 @@ cd twenty
<Tabs>
<Tab title="리눅스">
**옵션 1 (권장):** 데이터베이스를 로컬에서 프로비저닝하려면:
- Linux 기기에 Postgresql을 설치하려면 다음 링크를 사용하십시오: [Postgresql 설치](https://www.postgresql.org/download/linux/)
-
+ Linux 머신에 PostgreSQL을 설치하려면 다음 링크를 사용하세요: [PostgreSQL 설치](https://www.postgresql.org/download/linux/)
```bash
psql postgres -c "CREATE DATABASE \"default\";" -c "CREATE DATABASE test;"
```
-
참고: 권한 오류를 피하기 위해 `psql` 명령어 앞에 `sudo -u postgres`를 추가해야 할 수 있습니다.
**옵션 2:** 도커가 설치된 경우:
-
```bash
make -C packages/twenty-docker postgres-on-docker
```
</Tab>
-
<Tab title="맥 OS">
**옵션 1 (권장):** `brew`로 로컬에서 데이터베이스를 프로비저닝하려면:
@@ -129,17 +126,15 @@ cd twenty
```
PostgreSQL 서버가 실행 중인지 확인하려면 다음을 실행하세요:
-
```bash
brew services list
```
- 설치 시 기본적으로 `postgres` 사용자가 생성되지 않을 수 있습니다.
- macOS에서 Homebrew로 설치할 경우, 설치 시스템 계정과 일치하는 PostgreSQL 역할이 생성됩니다(예: "john"). 대신 사용자의 macOS
+ macOS에서 Homebrew로 설치할 때
+ 설치 프로그램이 기본적으로 `postgres` 사용자를 생성하지 않을 수 있습니다. 대신 사용자의 macOS
사용자 이름(예: "john")과 일치하는 PostgreSQL 역할을 생성합니다.# PostgreSQL 접속psql postgres
또는
psql -U $(whoami) -d postgres
-
```bash
# Connect to PostgreSQL
psql postgres
@@ -148,70 +143,61 @@ cd twenty
```
psql 프롬프트에서(postgres=#), 다음을 실행하세요:
-
- ```bash
- # List existing PostgreSQL roles
- \du
- ```
-
+ ```bash
+ # List existing PostgreSQL roles
+ \du
+ ```
출력은 다음과 비슷해야 합니다:
-
- ```bash
- Role name | Attributes | Member of
- -----------+-------------+-----------
- john | Superuser | {}
- ```
+ ```bash
+ Role name | Attributes | Member of
+ -----------+-------------+-----------
+ john | Superuser | {}
+ ```
`postgres` 역할이 나열되지 않으면 다음 단계를 계속하십시오.
`postgres` 역할을 수동으로 만드세요:
-
- ```bash
- CREATE ROLE postgres WITH SUPERUSER LOGIN;
- ```
-
+ ```bash
+ CREATE ROLE postgres WITH SUPERUSER LOGIN;
+ ```
이는 로그인 액세스가 있는 슈퍼유저 역할 `postgres`를 생성합니다.
-
- ```bash
- 역할 이름 | 속성 | 소속
- -----------+-------------+-----------
- postgres | 슈퍼유저 | {}
- john | 슈퍼유저 | {}
- ```
+ ```bash
+ 역할 이름 | 속성 | 소속
+ -----------+-------------+-----------
+ postgres | 슈퍼유저 | {}
+ john | 슈퍼유저 | {}
+ ```
**옵션 2:** 도커가 설치된 경우:
-
```bash
make -C packages/twenty-docker postgres-on-docker
```
</Tab>
-
<Tab title="윈도우 (WSL)">
다음 단계는 모두 WSL 터미널(가상 머신 내)에서 실행됩니다.
- **옵션 1:** Postgresql을 로컬에서 프로비저닝하려면:
- Linux 가상 머신에 Postgresql을 설치하려면 다음 링크를 사용하세요: [Postgresql 설치](https://www.postgresql.org/download/linux/)
-
+ **옵션 1:** PostgreSQL을 로컬에서 프로비저닝하려면:
+ Linux 가상 머신에 PostgreSQL을 설치하려면 다음 링크를 사용하세요: [PostgreSQL 설치](https://www.postgresql.org/download/linux/)
```bash
psql postgres -c "CREATE DATABASE \"default\";" -c "CREATE DATABASE test;"
```
-
참고: 권한 오류를 피하기 위해 `psql` 명령어 앞에 `sudo -u postgres`를 추가해야 할 수 있습니다.
**옵션 2:** 도커가 설치된 경우:
WSL에서 Docker를 실행하면 추가적인 복잡성이 발생합니다.
이 옵션은 [Docker Desktop WSL2](https://docs.docker.com/desktop/wsl)를 켠 상태에서의 추가 설정 단계를 수반할 수 있다는 점에서 편안할 때만 사용하십시오.
-
```bash
make -C packages/twenty-docker postgres-on-docker
```
</Tab>
</Tabs>
-이제 [localhost:5432](localhost:5432)에서 데이터베이스에 액세스할 수 있으며, 사용자 `postgres`와 비밀번호 `postgres` 를 사용합니다.
+이제 `localhost:5432`에서 데이터베이스에 접속할 수 있습니다.
+
+위의 Docker 옵션을 사용했다면, 기본 자격 증명은 사용자 `postgres`와 비밀번호 `postgres`입니다. 네이티브 PostgreSQL 설치의 경우, 로컬 머신에 구성된 자격 증명과 역할을 사용하세요.
## 4단계: Redis 데이터베이스 (캐시) 설정
-Twenty는 최상의 성능을 제공하기 위해 redis 캐시가 필요합니다.
+Twenty는 최상의 성능을 제공하기 위해 Redis 캐시가 필요합니다.
<Tabs>
<Tab title="리눅스">
@@ -219,42 +205,37 @@ Twenty는 최상의 성능을 제공하기 위해 redis 캐시가 필요합니
리눅스 기기에 Redis를 설치하려면 다음 링크를 사용하십시오: [Redis 설치](https://redis.io/docs/latest/operate/oss_and_stack/install/install-redis/install-redis-on-linux/)
**옵션 2:** 도커가 설치된 경우:
-
```bash
make -C packages/twenty-docker redis-on-docker
```
</Tab>
-
<Tab title="맥 OS">
**옵션 1 (권장):** `brew`로 Redis를 로컬에서 프로비저닝하려면:
-
```bash
brew install redis
```
-
- redis 서버를 시작하세요:
- `brew services start redis`
+ Redis 서버를 시작하세요:
+ ```bash
+ brew services start redis
+ ```
**옵션 2:** 도커가 설치된 경우:
-
```bash
make -C packages/twenty-docker redis-on-docker
```
</Tab>
-
<Tab title="윈도우 (WSL)">
**옵션 1:** Redis를 로컬에서 프로비저닝하려면:
Linux 가상 머신에 Redis를 설치하려면 다음 링크를 사용하세요: [Redis 설치](https://redis.io/docs/latest/operate/oss_and_stack/install/install-redis/install-redis-on-linux/)
**옵션 2:** 도커가 설치된 경우:
-
```bash
make -C packages/twenty-docker redis-on-docker
```
</Tab>
</Tabs>
-클라이언트 GUI가 필요한 경우에는 [redis insight](https://redis.io/insight/) (무료 버전 제공)을 권장합니다.
+클라이언트 GUI가 필요하다면 [Redis Insight](https://redis.io/insight/)를 권장합니다(무료 버전 제공).
## 5단계: 환경 변수 설정
@@ -268,7 +249,7 @@ cp ./packages/twenty-server/.env.example ./packages/twenty-server/.env
```
<Info>
- **멀티 워크스페이스 모드:** 기본적으로 Twenty는 하나의 워크스페이스만 생성할 수 있는 단일 워크스페이스 모드로 실행됩니다. 멀티 워크스페이스 지원을 활성화하려면(서브도메인 기반 기능을 테스트할 때 유용합니다), 서버의 `.env` 파일에서 `IS_MULTIWORKSPACE_ENABLED=true`로 설정하세요. 자세한 내용은 [멀티 워크스페이스 모드](/l/ko/developers/self-host/capabilities/setup#multi-workspace-mode)를 참조하세요.
+**멀티 워크스페이스 모드:** 기본적으로 Twenty는 하나의 워크스페이스만 생성할 수 있는 단일 워크스페이스 모드로 실행됩니다. 멀티 워크스페이스 지원을 활성화하려면(서브도메인 기반 기능을 테스트할 때 유용합니다), 서버의 `.env` 파일에서 `IS_MULTIWORKSPACE_ENABLED=true`로 설정하세요. 자세한 내용은 [멀티 워크스페이스 모드](/l/ko/developers/self-host/capabilities/setup#multi-workspace-mode)를 참조하세요.
</Info>
## 6단계: 의존성 설치
@@ -288,15 +269,12 @@ yarn
리눅스 배포판에 따라 Redis 서버가 자동으로 시작될 수 있습니다.
시작되지 않는다면, 각 배포판에 맞는 [Redis 설치 가이드](https://redis.io/docs/latest/operate/oss_and_stack/install/install-redis/)를 확인하세요.
</Tab>
-
<Tab title="맥 OS">
- Redis가 이미 실행 중이어야 합니다. 그렇지 않으면 다음을 실행하세요:
-
+ Redis가 이미 실행 중이어야 합니다. 그렇지 않으면 다음을 실행하세요:
```bash
brew services start redis
```
</Tab>
-
<Tab title="윈도우 (WSL)">
리눅스 배포판에 따라 Redis 서버가 자동으로 시작될 수 있습니다.
시작되지 않는다면, 각 배포판에 맞는 [Redis 설치 가이드](https://redis.io/docs/latest/operate/oss_and_stack/install/install-redis/)를 확인하세요.
diff --git a/packages/twenty-docs/l/ko/developers/contribute/commands.mdx b/packages/twenty-docs/l/ko/developers/contribute/commands.mdx
new file mode 100644
index 00000000000..59babdc4a5c
--- /dev/null
+++ b/packages/twenty-docs/l/ko/developers/contribute/commands.mdx
@@ -0,0 +1,77 @@
+---
+title: 명령
+icon: terminal
+description: Twenty 개발에 유용한 명령어.
+---
+
+`npx nx`를 사용해 리포지토리 루트에서 명령을 실행할 수 있습니다. 명시적으로 대상 지정하려면 `npx nx run {project}:{command}`를 사용하세요.
+
+## 앱 시작하기
+
+```bash
+npx nx start twenty-front # Frontend dev server (http://localhost:3001)
+npx nx start twenty-server # Backend server (http://localhost:3000)
+npx nx run twenty-server:worker # Background worker
+```
+
+## 데이터베이스
+
+```bash
+npx nx database:reset twenty-server # Reset and seed database
+npx nx run twenty-server:database:migrate:prod # Run migrations
+npx nx run twenty-server:database:migrate:generate --name <name> --type <fast|slow> # Generate a migration
+```
+
+## 린팅
+
+```bash
+npx nx lint:diff-with-main twenty-front # Lint changed files (fastest)
+npx nx lint:diff-with-main twenty-server
+npx nx lint twenty-front --configuration=fix # Auto-fix
+```
+
+## 타입 검사
+
+```bash
+npx nx typecheck twenty-front
+npx nx typecheck twenty-server
+```
+
+## 테스트
+
+```bash
+# Frontend
+npx nx test twenty-front # Jest unit tests
+npx nx storybook:build twenty-front # Build Storybook
+npx nx storybook:test twenty-front # Storybook tests
+
+# Backend
+npx nx run twenty-server:test:unit # Unit tests
+npx nx run twenty-server:test:integration # Integration tests
+npx nx run twenty-server:test:integration:with-db-reset # Integration with DB reset
+
+# Single file (fastest)
+npx jest path/to/test.test.ts --config=packages/{project}/jest.config.mjs
+```
+
+## GraphQL
+
+```bash
+npx nx run twenty-front:graphql:generate # Regenerate types
+npx nx run twenty-front:graphql:generate --configuration=metadata # Metadata schema
+```
+
+## 번역
+
+```bash
+npx nx run twenty-front:lingui:extract # Extract strings
+npx nx run twenty-front:lingui:compile # Compile translations
+```
+
+## 빌드
+
+```bash
+npx nx build twenty-shared # Must be built first
+npx nx build twenty-front
+npx nx build twenty-server
+```
diff --git a/packages/twenty-docs/l/ko/developers/contribute/contribute.mdx b/packages/twenty-docs/l/ko/developers/contribute/contribute.mdx
index 6b194cfe755..53cf1873665 100644
--- a/packages/twenty-docs/l/ko/developers/contribute/contribute.mdx
+++ b/packages/twenty-docs/l/ko/developers/contribute/contribute.mdx
@@ -25,7 +25,6 @@ Twenty는 오픈 소스로, 커뮤니티의 기여를 환영합니다. 버그를
<Card title="버그 보고 및 요청" icon="bug" href="/l/ko/developers/contribute/capabilities/bug-and-requests">
문제를 보고하거나 기능을 요청하세요
</Card>
-
<Card title="프론트엔드 개발" icon="browser" href="/l/ko/developers/contribute/capabilities/frontend-development">
UI에 기여하세요
</Card>
diff --git a/packages/twenty-docs/l/ko/developers/contribute/style-guide.mdx b/packages/twenty-docs/l/ko/developers/contribute/style-guide.mdx
new file mode 100644
index 00000000000..521d23e08fe
--- /dev/null
+++ b/packages/twenty-docs/l/ko/developers/contribute/style-guide.mdx
@@ -0,0 +1,176 @@
+---
+title: 스타일 가이드
+icon: 페인트 브러시
+description: Twenty에 기여하기 위한 코드 컨벤션과 모범 사례.
+---
+
+## 리액트
+
+### 함수형 컴포넌트만 사용
+
+항상 네임드 export가 있는 TSX 함수형 컴포넌트를 사용하십시오.
+
+```tsx
+// ❌ Bad
+const MyComponent = () => {
+ return <div>Hello World</div>;
+};
+export default MyComponent;
+
+// ✅ Good
+export function MyComponent() {
+ return <div>Hello World</div>;
+};
+```
+
+### 프로퍼티
+
+이름이 `{ComponentName}Props`인 타입을 생성하십시오. 구조 분해 할당을 사용하십시오. `React.FC`를 사용하지 마십시오.
+
+```tsx
+type MyComponentProps = {
+ name: string;
+};
+
+export const MyComponent = ({ name }: MyComponentProps) => <div>Hello {name}</div>;
+```
+
+### 단일 변수 prop 스프레딩 금지
+
+```tsx
+// ❌ Bad
+const MyComponent = (props: MyComponentProps) => <Other {...props} />;
+
+// ✅ Good
+const MyComponent = ({ prop1, prop2 }: MyComponentProps) => <Other {...{ prop1, prop2 }} />;
+```
+
+## 상태 관리
+
+### 전역 상태를 위한 Jotai 아톰
+
+```tsx
+import { createAtomState } from '@/ui/utilities/state/jotai/utils/createAtomState';
+import { useAtomState } from '@/ui/utilities/state/jotai/hooks/useAtomState';
+
+export const myAtomState = createAtomState<string>({
+ key: 'myAtomState',
+ defaultValue: 'default value',
+});
+```
+
+* prop 드릴링보다 아톰을 선호하십시오.
+* 상태에는 `useRef`를 사용하지 말고 — `useState` 또는 아톰을 사용하십시오
+* 목록에는 아톰 패밀리와 셀렉터를 사용하십시오
+
+### 불필요한 리렌더링을 피하십시오
+
+* `useEffect`와 데이터 패칭을 형제 사이드카 컴포넌트로 분리하십시오
+* `useEffect`보다 이벤트 핸들러(`handleClick`, `handleChange`)를 선호하십시오
+* `React.memo()`를 사용하지 말고 — 근본 원인을 수정하십시오
+* `useCallback` / `useMemo` 사용을 제한하십시오
+
+```tsx
+// ❌ Bad — useEffect in the same component causes re-renders
+export const Page = () => {
+ const [data, setData] = useAtomState(dataState);
+ const [dep] = useAtomState(depState);
+ useEffect(() => { setData(dep); }, [dep]);
+ return <div>{data}</div>;
+};
+
+// ✅ Good — extract into sibling
+export const PageData = () => {
+ const [data, setData] = useAtomState(dataState);
+ const [dep] = useAtomState(depState);
+ useEffect(() => { setData(dep); }, [dep]);
+ return <></>;
+};
+export const Page = () => {
+ const [data] = useAtomState(dataState);
+ return <div>{data}</div>;
+};
+```
+
+## 타입스크립트
+
+* **`interface`보다 `type`** — 더 유연하고 조합하기 쉽습니다
+* **열거형보다 문자열 리터럴** — GraphQL codegen enum 및 내부 라이브러리 API는 예외
+* **`any` 금지** — 엄격한 TypeScript를 강제합니다
+* **타입 import 금지** — 일반 import를 사용하십시오 (Oxlint `typescript/consistent-type-imports`로 강제)
+* **[Zod](https://github.com/colinhacks/zod)을 사용**하여 타입이 없는 객체를 런타임에 검증하십시오
+
+## 자바스크립트
+
+```tsx
+// Use nullish-coalescing (??) instead of ||
+const value = process.env.MY_VALUE ?? 'default';
+
+// Use optional chaining
+onClick?.();
+```
+
+## 이름 지정
+
+* **변수**: camelCase, 의미를 잘 드러내도록 작성 (`value`가 아닌 `email`, `fm`이 아닌 `fieldMetadata`)
+* **상수**: SCREAMING_SNAKE_CASE
+* **타입/클래스**: PascalCase
+* **파일/디렉터리**: kebab-case (`.component.tsx`, `.service.ts`, `.entity.ts`)
+* **이벤트 핸들러**: `handleClick` (핸들러 함수 이름은 `onClick`이 아님)
+* **컴포넌트 props**: 컴포넌트 이름을 접두사로 붙이십시오 (`ButtonProps`)
+* **스타일드 컴포넌트**: `Styled` 접두사를 붙이십시오 (`StyledTitle`)
+
+## 스타일링
+
+[Linaria](https://github.com/callstack/linaria) 스타일드 컴포넌트를 사용하십시오. 테마 값을 사용하십시오 — 하드코딩된 `px`, `rem` 또는 색상은 피하십시오.
+
+```tsx
+// ❌ Bad
+const StyledButton = styled.button`
+ color: #333333;
+ font-size: 1rem;
+ margin-left: 4px;
+`;
+
+// ✅ Good
+const StyledButton = styled.button`
+ color: ${({ theme }) => theme.font.color.primary};
+ font-size: ${({ theme }) => theme.font.size.md};
+ margin-left: ${({ theme }) => theme.spacing(1)};
+`;
+```
+
+## 가져오기
+
+상대 경로 대신 별칭을 사용하십시오:
+
+```tsx
+// ❌ Bad
+import { Foo } from '../../../../../testing/decorators/Foo';
+
+// ✅ Good
+import { Foo } from '~/testing/decorators/Foo';
+import { Bar } from '@/modules/bar/components/Bar';
+```
+
+## 폴더 구조
+
+```
+front
+└── modules/ # Feature modules
+│ └── module1/
+│ ├── components/
+│ ├── constants/
+│ ├── contexts/
+│ ├── graphql/ (fragments, queries, mutations)
+│ ├── hooks/
+│ ├── states/ (atoms, selectors)
+│ ├── types/
+│ └── utils/
+└── pages/ # Route-level components
+└── ui/ # Reusable UI components (display, input, feedback, ...)
+```
+
+* 모듈은 다른 모듈에서 import할 수 있지만, `ui/`는 의존성이 없어야 합니다
+* 모듈 전용 코드는 `internal/` 하위 폴더를 사용하십시오
+* 컴포넌트는 300줄 이하, 서비스는 500줄 이하
diff --git a/packages/twenty-docs/l/ko/developers/extend/api.mdx b/packages/twenty-docs/l/ko/developers/extend/api.mdx
new file mode 100644
index 00000000000..5187c2db56f
--- /dev/null
+++ b/packages/twenty-docs/l/ko/developers/extend/api.mdx
@@ -0,0 +1,55 @@
+---
+title: API
+icon: plug
+description: 워크스페이스 스키마에서 생성된 REST 및 GraphQL API.
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+## 테넌트별 스키마 API
+
+Twenty에는 정적 API 참조 문서가 없습니다. 각 워크스페이스는 고유한 스키마를 가집니다 — 사용자 지정 객체(예: `Invoice`)를 추가하면, `Company` 또는 `Person`과 같은 기본 제공 객체와 동일한 REST 및 GraphQL 엔드포인트가 즉시 생성됩니다. API는 스키마에서 생성되므로 엔드포인트에서 객체와 필드 이름을 직접 사용합니다 — 의미를 알 수 없는 ID는 없습니다.
+
+워크스페이스별 API 문서는 API 키 생성 후 **설정 → API 및 웹훅**에서 확인할 수 있습니다. 데이터에 대해 실제 호출을 실행할 수 있는 대화형 플레이그라운드가 포함되어 있습니다.
+
+## 두 가지 API
+
+**핵심 API** — `/rest/` 및 `/graphql/`
+
+레코드에 대한 CRUD: People, Companies, Opportunities, 사용자 지정 객체. 쿼리, 필터링, 관계 탐색.
+
+**메타데이터 API** — `/rest/metadata/` 및 `/metadata/`
+
+스키마 관리: 객체, 필드, 관계 생성/수정/삭제. 이것이 데이터 모델을 프로그래밍 방식으로 변경하는 방법입니다.
+
+둘 다 REST와 GraphQL로 사용할 수 있습니다. GraphQL은 배치 업서트와 단일 쿼리에서 관계를 탐색하는 기능을 제공합니다. 어떤 방식을 사용하든 동일한 기본 데이터입니다.
+
+## 기본 URL
+
+| 환경 | 기본 URL |
+| ------ | ------------------------- |
+| 클라우드 | `https://api.twenty.com/` |
+| 셀프 호스팅 | `https://{your-domain}/` |
+
+## 인증
+
+```
+Authorization: Bearer YOUR_API_KEY
+```
+
+**Settings → API & Webhooks → + Create key**에서 API 키를 생성하세요. 즉시 복사하세요 — 한 번만 표시됩니다. 키는 **Settings → Members → Roles → Assignment tab**에서 특정 역할에 범위를 지정하여 액세스 가능한 범위를 제한할 수 있습니다.
+
+<VimeoEmbed videoId="928786722" title="API 키 생성" />
+
+사용자 대신 동작하는 외부 앱을 위한 OAuth 기반 액세스에 대해서는 [OAuth](/l/ko/developers/extend/oauth)를 참고하세요.
+
+## 배치 작업
+
+REST와 GraphQL 모두 요청당 최대 60개의 레코드에 대한 배치 처리를 지원합니다 — 생성, 업데이트 또는 삭제. GraphQL은 `CreateCompanies`와 같은 복수형 이름을 사용하여 배치 업서트(한 번의 호출로 생성 또는 업데이트)도 지원합니다.
+
+## 속도 제한
+
+| 제한 | 값 |
+| ----- | ------------ |
+| 요청 | 분당 100회 호출 |
+| 배치 크기 | 호출당 60개의 레코드 |
diff --git a/packages/twenty-docs/l/ko/developers/extend/apps/config/application.mdx b/packages/twenty-docs/l/ko/developers/extend/apps/config/application.mdx
new file mode 100644
index 00000000000..037d8b6df4c
--- /dev/null
+++ b/packages/twenty-docs/l/ko/developers/extend/apps/config/application.mdx
@@ -0,0 +1,64 @@
+---
+title: 애플리케이션 구성
+description: "`defineApplication`을 사용하여 앱의 식별 정보, 기본 역할, 변수 및 마켓플레이스 메타데이터를 선언합니다."
+icon: rocket
+---
+
+모든 앱에는 `defineApplication` 호출이 정확히 하나 있어야 합니다. 다음 항목을 선언합니다:
+
+* **식별 정보** — 범용 식별자, 표시 이름, 설명.
+* **권한** — 로직 함수와 프런트 컴포넌트가 어떤 역할로 실행되는지.
+* **변수** *(선택 사항)* — 코드에 환경 변수로 노출되는 키–값 쌍.
+* **설치 전/후 훅** *(선택 사항)* — [Logic Functions](/l/ko/developers/extend/apps/logic/logic-functions)를 참조하세요.
+
+```ts src/application-config.ts
+import { defineApplication } from 'twenty-sdk/define';
+
+export default defineApplication({
+ universalIdentifier: '39783023-bcac-41e3-b0d2-ff1944d8465d',
+ displayName: 'My Twenty App',
+ description: 'My first Twenty app',
+ applicationVariables: {
+ DEFAULT_RECIPIENT_NAME: {
+ universalIdentifier: '19e94e59-d4fe-4251-8981-b96d0a9f74de',
+ description: 'Default recipient name for postcards',
+ value: 'Jane Doe',
+ isSecret: false,
+ },
+ },
+});
+```
+
+노트:
+
+* `universalIdentifier` 필드는 여러분이 소유하는 변하지 않는 고유 ID입니다. 한 번만 생성하고 이후 동기화 동안에도 변하지 않도록 유지하세요.
+* `applicationVariables`는 함수와 프런트 컴포넌트의 환경 변수가 됩니다. 로직 함수(서버 사이드)에서는 `process.env.VARIABLE_NAME`으로 사용할 수 있습니다. 프런트 컴포넌트에서는 `twenty-sdk/front-component`의 `getApplicationVariable('VARIABLE_NAME')`을 사용하세요. `isSecret: true`로 표시된 변수는 로직 함수에만 주입됩니다. 프런트 컴포넌트는 비밀이 아닌 변수만 받습니다.
+* 기본 역할은 [`defineApplicationRole()`](/l/ko/developers/extend/apps/config/roles)로 표시된 역할 파일에서 자동으로 감지되므로, `defineApplication()`에서 이를 참조할 필요가 없습니다.
+* 설치 전/후 함수는 매니페스트 빌드 중 자동으로 감지됩니다 — `defineApplication()`에서 별도로 참조할 필요가 없습니다.
+* 하위 호환성을 위해 `defaultRoleUniversalIdentifier`를 명시적으로 전달하는 방식도 계속 지원되지만, 이제는 `defineApplicationRole()` 사용을 권장하며 이전 방식은 더 이상 권장되지 않습니다.
+
+## 기본 함수 역할
+
+[`defineApplicationRole()`](/l/ko/developers/extend/apps/config/roles)로 선언된 역할은 앱의 로직 함수와 프런트엔드 컴포넌트가 무엇에 접근할 수 있는지를 제어합니다:
+
+* `TWENTY_APP_ACCESS_TOKEN`로 주입되는 런타임 토큰은 이 역할에서 파생됩니다.
+* 타입드 API 클라이언트는 해당 역할에 부여된 권한으로 제한됩니다.
+* 최소 권한 원칙을 따르세요: 함수에 필요한 권한만 선언하세요.
+
+새 앱을 스캐폴딩하면 CLI가 `src/roles/default-role.ts`에 시작용 역할 파일을 생성합니다. 전체 내용은 [Roles & Permissions](/l/ko/developers/extend/apps/config/roles)를 참조하세요.
+
+## 마켓플레이스 메타데이터
+
+앱을 [게시](/l/ko/developers/extend/apps/operations/publishing)할 계획이라면, 다음 선택적 필드로 마켓플레이스에서 표시되는 방식을 제어합니다:
+
+| 필드 | 설명 |
+| ------------------ | ------------------------------------------------------------------- |
+| `author` | 작성자 또는 회사 이름 |
+| `category` | 마켓플레이스 필터링을 위한 앱 카테고리 |
+| `logoUrl` | 앱 로고의 경로(예: `public/logo.png`) |
+| `screenshots` | 스크린샷 경로의 배열(예: `public/screenshot-1.png`) |
+| `aboutDescription` | "About" 탭에 대한 더 긴 마크다운 설명. 생략하면 마켓플레이스는 npm의 패키지 `README.md`를 사용합니다 |
+| `websiteUrl` | 웹사이트 링크 |
+| `termsUrl` | 서비스 약관 링크 |
+| `emailSupport` | 지원 이메일 주소 |
+| `issueReportUrl` | 이슈 트래커 링크 |
diff --git a/packages/twenty-docs/l/ko/developers/extend/apps/config/install-hooks.mdx b/packages/twenty-docs/l/ko/developers/extend/apps/config/install-hooks.mdx
new file mode 100644
index 00000000000..238b5805613
--- /dev/null
+++ b/packages/twenty-docs/l/ko/developers/extend/apps/config/install-hooks.mdx
@@ -0,0 +1,206 @@
+---
+title: 설치 훅
+description: 설치 전에나 후에 로직을 실행하여 시드 데이터를 추가하고, 레코드를 백업하고, 업그레이드를 검증하세요.
+icon: wrench
+---
+
+설치 훅은 설치 또는 업그레이드 라이프사이클 동안 실행되는 특수한 로직 함수입니다. 이들은 일반 [로직 함수](/l/ko/developers/extend/apps/logic/logic-functions)와 동일한 핸들러 런타임을 공유하고 `InstallPayload`를 받지만, 자체 정의 함수인 `definePostInstallLogicFunction()` 및 `definePreInstallLogicFunction()`으로 선언되며, 일반 트리거 모델(HTTP, cron, 데이터베이스 이벤트) 외부에서 동작합니다.
+
+각 앱은 **최대 하나의 pre-install** 함수와 **최대 하나의 post-install** 함수만 정의할 수 있습니다. 둘 이상이 감지되면 매니페스트 빌드에서 오류가 발생합니다.
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│ install flow │
+│ │
+│ upload package → [pre-install] → metadata migration → │
+│ generate SDK → [post-install] │
+│ │
+│ old schema visible new schema visible │
+└─────────────────────────────────────────────────────────────┘
+```
+
+<AccordionGroup>
+<Accordion title="definePostInstallLogicFunction" description="워크스페이스 메타데이터 마이그레이션이 적용된 후에 실행됩니다.">
+
+설치 후 함수는 워크스페이스에 앱 설치가 완료된 뒤 자동으로 실행되는 로직 함수입니다. 서버는 앱의 메타데이터가 동기화되고 SDK 클라이언트가 생성된 **이후** 이를 실행하므로, 워크스페이스는 완전히 사용할 준비가 되었고 새 스키마가 적용된 상태입니다. 일반적인 사용 사례로는 기본 데이터를 시드하는 것, 초기 레코드를 생성하는 것, 워크스페이스 설정을 구성하는 것, 서드파티 서비스에서 리소스를 프로비저닝하는 것 등이 있습니다.
+
+```ts src/logic-functions/post-install.ts
+import { definePostInstallLogicFunction, type InstallPayload } from 'twenty-sdk/define';
+
+const handler = async (payload: InstallPayload): Promise<void> => {
+ console.log('Post install logic function executed successfully!', payload.previousVersion);
+};
+
+export default definePostInstallLogicFunction({
+ universalIdentifier: 'f7a2b9c1-3d4e-5678-abcd-ef9876543210',
+ name: 'post-install',
+ description: 'Runs after installation to set up the application.',
+ timeoutSeconds: 300,
+ shouldRunOnVersionUpgrade: false,
+ shouldRunSynchronously: false,
+ handler,
+});
+```
+
+CLI를 사용하여 언제든지 설치 후 함수를 수동으로 실행할 수도 있습니다:
+
+```bash filename="Terminal"
+yarn twenty dev:function:exec --postInstall
+```
+
+핵심 요점:
+* 설치 후 함수는 `definePostInstallLogicFunction()`을 사용합니다 — 트리거 설정(`cronTriggerSettings`, `databaseEventTriggerSettings`, `httpRouteTriggerSettings`, `toolTriggerSettings`, `workflowActionTriggerSettings`)을 생략한 특수 변형입니다.
+* 핸들러는 `{ previousVersion?: string; newVersion: string }` 형태의 `InstallPayload`를 받습니다 — `newVersion`은 현재 설치 중인 버전이고, `previousVersion`은 이전에 설치되었던 버전입니다(처음 설치인 경우에는 `undefined`). 이 값들을 사용하여 신규 설치와 업그레이드를 구분하고, 버전별 마이그레이션 로직을 실행하세요.
+* **훅이 실행되는 시점**: 기본적으로 신규 설치에서만 실행됩니다. 이전 버전에서 앱이 업그레이드될 때도 실행되게 하려면 `shouldRunOnVersionUpgrade: true`를 전달하세요. 생략하면 플래그는 기본값 `false`가 되며, 업그레이드 시 훅을 건너뜁니다.
+* **실행 모델 — 기본은 비동기, 동기는 선택적**: `shouldRunSynchronously` 플래그는 설치 후 작업이 *어떤 방식으로* 실행되는지 제어합니다.
+ * `shouldRunSynchronously: false` *(기본값)* — 훅은 `retryLimit: 3`와 함께 **메시지 큐에 등록**되며 워커에서 비동기적으로 실행됩니다. 작업이 큐에 등록되는 즉시 설치 응답이 반환되므로, 처리 속도가 느리거나 실패하는 핸들러가 호출자를 차단하지 않습니다. 워커는 최대 세 번까지 재시도합니다. **장시간 실행되는 작업에 사용하세요** — 대규모 데이터셋 시딩, 느린 서드파티 API 호출, 외부 리소스 프로비저닝 등 합리적인 HTTP 응답 시간 창을 초과할 수 있는 모든 작업.
+ * `shouldRunSynchronously: true` — 훅이 **설치 플로우 중에 인라인으로** 실행됩니다(설치 전과 동일한 실행기). 핸들러가 완료될 때까지 설치 요청이 블록되고, 예외가 발생하면 설치 호출자는 `POST_INSTALL_ERROR`를 받습니다. 자동 재시도 없음. **응답 전에 반드시 완료되어야 하는 빠른 작업에 사용하세요** — 예: 사용자에게 검증 오류를 표시하거나, 설치 호출이 반환된 직후 클라이언트가 즉시 의존하는 빠른 설정. post-install이 실행될 시점에는 메타데이터 마이그레이션이 이미 적용되었음을 유의하세요. 따라서 동기 모드에서 실패하더라도 스키마 변경이 **롤백되지 않으며**, 오류만 노출됩니다.
+* 핸들러가 멱등적임을 보장하세요. 비동기 모드에서는 큐가 최대 세 번까지 재시도할 수 있습니다. 어떤 모드이든 `shouldRunOnVersionUpgrade: true`인 경우 업그레이드 시 훅이 다시 실행될 수 있습니다.
+* 환경 변수 `APPLICATION_ID`, `APP_ACCESS_TOKEN`, `API_URL`은 핸들러 내부에서 사용할 수 있습니다(다른 로직 함수와 동일). 따라서 앱에 범위가 지정된 애플리케이션 액세스 토큰으로 Twenty API를 호출할 수 있습니다.
+* 애플리케이션당 설치 후 함수는 하나만 허용됩니다. 둘 이상이 감지되면 매니페스트 빌드에서 오류가 발생합니다.
+* 함수의 `universalIdentifier`, `shouldRunOnVersionUpgrade`, `shouldRunSynchronously`는 빌드 중에 애플리케이션 매니페스트의 `postInstallLogicFunction` 필드에 자동으로 첨부됩니다 — 따라서 [`defineApplication()`](/l/ko/developers/extend/apps/config/application)에서 이들을 참조할 필요가 없습니다.
+* 기본 시간 제한은 데이터 시딩과 같은 더 긴 설정 작업을 허용하기 위해 300초(5분)로 설정되어 있습니다.
+* **개발 모드에서 실행되지 않음**: 앱이 로컬로 등록된 경우(`yarn twenty dev`), 서버는 설치 플로우를 완전히 건너뛰고 CLI 워처를 통해 파일을 직접 동기화합니다 — 따라서 `shouldRunSynchronously` 여부와 관계없이 개발 모드에서는 post-install이 절대 실행되지 않습니다. 실행 중인 워크스페이스에 대해 수동으로 트리거하려면 `yarn twenty dev:function:exec --postInstall`을 사용하세요.
+
+</Accordion>
+<Accordion title="definePreInstallLogicFunction" description="워크스페이스 메타데이터 마이그레이션이 적용되기 전에 실행됩니다.">
+
+pre-install 함수는 설치 중에 자동으로 실행되는 로직 함수로, **워크스페이스 메타데이터 마이그레이션이 적용되기 전에** 실행됩니다. post-install과 동일한 페이로드 형태(`InstallPayload`)를 사용하지만, 설치 플로우에서 더 이른 단계에 위치하여 곧 진행될 마이그레이션이 의존하는 상태를 준비할 수 있습니다 — 일반적인 사용 사례로는 데이터 백업, 새 스키마와의 호환성 검증, 재구조화되거나 삭제될 레코드의 보관 등이 있습니다.
+
+```ts src/logic-functions/pre-install.ts
+import { definePreInstallLogicFunction, type InstallPayload } from 'twenty-sdk/define';
+
+const handler = async (payload: InstallPayload): Promise<void> => {
+ console.log('Pre install logic function executed successfully!', payload.previousVersion);
+};
+
+export default definePreInstallLogicFunction({
+ universalIdentifier: 'a1b2c3d4-5678-90ab-cdef-1234567890ab',
+ name: 'pre-install',
+ description: 'Runs before installation to prepare the application.',
+ timeoutSeconds: 300,
+ shouldRunOnVersionUpgrade: true,
+ handler,
+});
+```
+
+CLI를 사용하여 언제든지 설치 전 함수를 수동으로 실행할 수도 있습니다:
+
+```bash filename="Terminal"
+yarn twenty dev:function:exec --preInstall
+```
+
+핵심 요점:
+* pre-install 함수는 `definePreInstallLogicFunction()`을 사용합니다 — post-install과 동일한 특수화된 구성을 사용하되, 서로 다른 라이프사이클 슬롯에 연결됩니다.
+* pre-install과 post-install 핸들러는 동일한 `InstallPayload` 타입을 받습니다: `{ previousVersion?: string; newVersion: string }`. 한 번만 임포트하여 두 훅에서 재사용하세요.
+* **훅이 실행되는 시점**: 워크스페이스 메타데이터 마이그레이션(`synchronizeFromManifest`) 직전. 실행에 앞서, 서버는 워크스페이스 메타데이터에 **새로운** 버전의 pre-install 함수를 등록하는 순수 추가식의 "간소화된 동기화"를 수행합니다 — 그 외에는 아무것도 변경하지 않습니다 — 그리고 나서 이를 실행합니다. 이 동기화는 추가 전용이므로, 핸들러가 실행될 때 이전 버전의 객체, 필드, 데이터는 그대로 유지됩니다. 따라서 마이그레이션 이전 상태를 안전하게 읽고 백업할 수 있습니다.
+* **실행 모델**: pre-install은 **동기적으로** 실행되며 **설치를 차단**합니다. 핸들러에서 예외를 던지면, 어떤 스키마 변경도 적용되기 전에 설치가 중단되며 — 워크스페이스는 일관된 상태로 이전 버전에 머무릅니다. 이는 의도된 동작입니다: pre-install은 위험한 업그레이드를 거부할 수 있는 마지막 기회입니다.
+* post-install과 마찬가지로, 애플리케이션당 pre-install 함수는 하나만 허용됩니다. 빌드 중에 애플리케이션 매니페스트의 `preInstallLogicFunction` 아래에 자동으로 연결됩니다.
+* **개발 모드에서 실행되지 않음**: post-install과 동일하게 — 로컬로 등록된 앱은 설치 플로우가 완전히 건너뛰어지므로 `yarn twenty dev` 환경에서 pre-install은 실행되지 않습니다. `yarn twenty dev:function:exec --preInstall`를 사용하여 수동으로 트리거하세요.
+
+</Accordion>
+<Accordion title="pre-install vs post-install: 언제 어떤 것을 사용할지" description="올바른 설치 훅 선택하기">
+
+두 훅 모두 동일한 설치 플로우의 일부이며 같은 `InstallPayload`를 받습니다. 차이점은 워크스페이스 메타데이터 마이그레이션과의 상대적인 실행 **시점**이며, 이에 따라 안전하게 다룰 수 있는 데이터가 달라집니다.
+
+pre-install은 항상 **동기식**입니다(설치를 차단하고 중단할 수 있음). post-install은 **기본적으로 비동기식**입니다 — 워커에 큐잉되고 자동 재시도가 수행됩니다 — 하지만 `shouldRunSynchronously: true`로 동기 실행을 선택할 수 있습니다. 각 모드를 언제 사용할지에 대해서는 위의 `definePostInstallLogicFunction` 아코디언을 참고하세요.
+
+**새로운 스키마의 존재가 필요한 작업에는 `post-install`을 사용하세요.** 일반적인 경우입니다:
+
+* 새로 추가된 객체와 필드를 대상으로 기본 데이터를 시딩(초기 레코드, 기본 보기, 데모 콘텐츠 생성)하는 작업.
+* 앱에 자격 증명이 생겼으므로 서드파티 서비스에 웹훅을 등록하는 작업.
+* 동기화된 메타데이터에 의존하는 설정을 완료하기 위해 자체 API를 호출하는 작업.
+* 모든 업그레이드마다 상태를 조정해야 하는 멱등적인 "존재함을 보장(ensure this exists)" 로직 — `shouldRunOnVersionUpgrade: true`와 함께 사용하세요.
+
+예시 — 설치 후 기본 `PostCard` 레코드를 시딩하기:
+
+```ts src/logic-functions/post-install.ts
+import { definePostInstallLogicFunction, type InstallPayload } from 'twenty-sdk/define';
+import { createClient } from './generated/client';
+
+const handler = async ({ previousVersion }: InstallPayload): Promise<void> => {
+ if (previousVersion) return; // fresh installs only
+
+ const client = createClient();
+ await client.postCard.create({
+ data: { title: 'Welcome to Postcard', content: 'Your first card!' },
+ });
+};
+
+export default definePostInstallLogicFunction({
+ universalIdentifier: 'f7a2b9c1-3d4e-5678-abcd-ef9876543210',
+ name: 'post-install',
+ description: 'Seeds a welcome post card after install.',
+ timeoutSeconds: 300,
+ shouldRunOnVersionUpgrade: false,
+ handler,
+});
+```
+
+**마이그레이션으로 인해 기존 데이터가 손실되거나 손상될 우려가 있을 때는 `pre-install`을 사용하세요.** pre-install은 *이전* 스키마에 대해 실행되고 실패 시 업그레이드를 롤백하므로, 위험한 작업에 적합합니다:
+
+* **곧 삭제되거나 재구조화될 데이터를 백업** — 예: v2에서 필드를 제거하므로, 마이그레이션이 실행되기 전에 해당 값을 다른 필드로 복사하거나 스토리지로 내보내야 하는 경우.
+* **새로운 제약으로 인해 무효화될 레코드를 보관** — 예: 어떤 필드가 `NOT NULL`로 바뀌어 null 값을 가진 행을 먼저 삭제하거나 수정해야 하는 경우.
+* **호환성을 검증하고, 현재 데이터를 깔끔하게 마이그레이션할 수 없는 경우 업그레이드를 거부** — 핸들러에서 예외를 던지면 아무 변경도 적용되지 않은 채 설치가 중단됩니다. 이는 마이그레이션 도중에 비호환성을 발견하는 것보다 더 안전합니다.
+* 연관이 끊어질 수 있는 스키마 변경에 앞서 **데이터 이름 변경 또는 키 재지정**.
+
+예시 — 파괴적인 마이그레이션 전에 레코드 보관하기:
+
+```ts src/logic-functions/pre-install.ts
+import { definePreInstallLogicFunction, type InstallPayload } from 'twenty-sdk/define';
+import { createClient } from './generated/client';
+
+const handler = async ({ previousVersion, newVersion }: InstallPayload): Promise<void> => {
+ // Only the 1.x → 2.x upgrade drops the legacy `notes` field.
+ if (!previousVersion?.startsWith('1.') || !newVersion.startsWith('2.')) {
+ return;
+ }
+
+ const client = createClient();
+ const legacyRecords = await client.postCard.findMany({
+ where: { notes: { isNotNull: true } },
+ });
+
+ if (legacyRecords.length === 0) return;
+
+ // Copy legacy `notes` into the new `description` field before the migration
+ // drops the `notes` column. If this fails, the upgrade is aborted and the
+ // workspace stays on v1 with all data intact.
+ await Promise.all(
+ legacyRecords.map((record) =>
+ client.postCard.update({
+ where: { id: record.id },
+ data: { description: record.notes },
+ }),
+ ),
+ );
+};
+
+export default definePreInstallLogicFunction({
+ universalIdentifier: 'a1b2c3d4-5678-90ab-cdef-1234567890ab',
+ name: 'pre-install',
+ description: 'Backs up legacy notes into description before the v2 migration.',
+ timeoutSeconds: 300,
+ shouldRunOnVersionUpgrade: true,
+ handler,
+});
+```
+
+**경험칙:**
+
+| 원하는 작업... | 사용 |
+| -------------------------------------- | ---------------------------------------------------------------- |
+| 기본 데이터 시딩, 워크스페이스 구성, 외부 리소스 등록 | `post-install` |
+| 설치 응답을 차단해서는 안 되는 장시간 시딩 또는 서드파티 호출 실행 | `post-install` (기본 — `shouldRunSynchronously: false`, 워커 재시도 포함) |
+| 설치 호출이 반환된 직후 호출자가 즉시 의존하는 빠른 설정 실행 | `shouldRunSynchronously: true`를 사용하는 `post-install` |
+| 곧 진행될 마이그레이션으로 손실될 데이터를 읽거나 백업 | `pre-install` |
+| 기존 데이터를 손상시킬 업그레이드를 거부 | `pre-install` (핸들러에서 예외를 던짐) |
+| 모든 업그레이드 시 상태 조정 실행 | `shouldRunOnVersionUpgrade: true`를 사용하는 `post-install` |
+| 최초 설치에서만 1회성 설정 수행 | `shouldRunOnVersionUpgrade: false`(기본값)을 사용하는 `post-install` |
+
+<Note>
+확신이 서지 않는다면 기본적으로 **post-install**을 사용하세요. 마이그레이션 자체가 파괴적이며 이전 상태가 사라지기 전에 이를 가로채야 할 때에만 pre-install을 사용하세요.
+</Note>
+
+</Accordion>
+</AccordionGroup>
diff --git a/packages/twenty-docs/l/ko/developers/extend/apps/config/overview.mdx b/packages/twenty-docs/l/ko/developers/extend/apps/config/overview.mdx
new file mode 100644
index 00000000000..009ccdc680e
--- /dev/null
+++ b/packages/twenty-docs/l/ko/developers/extend/apps/config/overview.mdx
@@ -0,0 +1,51 @@
+---
+title: 개요
+description: 앱 자체를 구성합니다. 앱의 ID, 기본 권한, 그리고 설치 시점에 무엇이 실행되는지를 설정합니다.
+icon: screwdriver-wrench
+---
+
+Twenty 앱의 **구성 레이어(config layer)** 는 앱의 ID, 보유한 권한, 설치나 업그레이드 시 실행되는 코드를 포함해, 앱을 *플랫폼에 어떻게 설명할지* 정의합니다. 이 선언들은 새로운 데이터 구조나 런타임 동작을 추가하지 않습니다. 대신 Twenty에게 앱이 무엇인지와 어떻게 설정해야 하는지를 알려줍니다.
+
+```text
+┌────────────────────────────────────────────────────────┐
+│ Application — identity, default role, variables, │
+│ marketplace metadata │
+│ │
+│ ┌──────────────────────────────────────────────────┐ │
+│ │ Role — what the app's logic functions can read │ │
+│ │ and write (referenced by Application) │ │
+│ └──────────────────────────────────────────────────┘ │
+└────────────────────────────────────────────────────────┘
+ │
+ ▼ (at install / upgrade time)
+ ┌──────────────────────────────────┐
+ │ Pre-install hook │ before metadata migration
+ └──────────────────────────────────┘
+ ┌──────────────────────────────────┐
+ │ Post-install hook │ after metadata migration
+ └──────────────────────────────────┘
+```
+
+## 이 섹션에서 다루는 내용
+
+<CardGroup cols={2}>
+ <Card title="애플리케이션 구성" icon="rocket" href="/l/ko/developers/extend/apps/config/application">
+ `defineApplication` — ID, 기본 역할, 변수, 마켓플레이스 메타데이터를 정의합니다.
+ </Card>
+ <Card title="역할 및 권한" icon="shield-halved" href="/l/ko/developers/extend/apps/config/roles">
+ `defineRole` — 앱의 로직 함수가 무엇을 읽고 쓸 수 있는지 선언합니다.
+ </Card>
+ <Card title="설치 훅" icon="wrench" href="/l/ko/developers/extend/apps/config/install-hooks">
+ `definePreInstallLogicFunction` 및 `definePostInstallLogicFunction` — 데이터를 백업하고, 기본값을 시드하며, 업그레이드를 검증합니다.
+ </Card>
+</CardGroup>
+
+## 구성 요소 간의 관계
+
+* **애플리케이션**이 진입점입니다. 모든 앱에는 정확히 한 번의 `defineApplication()` 호출이 있으며, 이 호출은 하나의 \*\*역할(Role)\*\*을 기본값으로 가리킵니다.
+* \*\*역할(Role)\*\*은 앱의 로직 함수와 프런트 컴포넌트가 무엇을 읽고 쓸 수 있는지를 제어합니다. 최소 권한 원칙을 따르세요. 코드에 실제로 필요한 권한만 부여하세요.
+* \*\*설치 훅(Install Hooks)\*\*은 설치나 업그레이드 중에 실행됩니다. 메타데이터 마이그레이션 이전에 실행되는 사전 설치 훅은 위험한 업그레이드를 거부할 수 있고, 마이그레이션 이후에 실행되는 사후 설치 훅은 새 스키마에 맞춰 기본 데이터를 시드할 수 있습니다.
+
+<Note>
+설치 훅은 [로직 함수](/l/ko/developers/extend/apps/logic/logic-functions) 런타임을 공유합니다. 동일한 핸들러 시그니처, 동일한 환경 변수, 동일한 타입이 지정된 API 클라이언트를 사용하지만, 자체 define 함수로 선언되고 일반 트리거 모델(HTTP, cron, 데이터베이스 이벤트) 외부에서 동작합니다.
+</Note>
diff --git a/packages/twenty-docs/l/ko/developers/extend/apps/config/public-assets.mdx b/packages/twenty-docs/l/ko/developers/extend/apps/config/public-assets.mdx
new file mode 100644
index 00000000000..f3f02152db0
--- /dev/null
+++ b/packages/twenty-docs/l/ko/developers/extend/apps/config/public-assets.mdx
@@ -0,0 +1,67 @@
+---
+title: 퍼블릭 에셋
+description: 정적 파일(이미지, 아이콘, 폰트 등)을 public/ 폴더를 통해 앱과 함께 제공합니다.
+icon: folder-open
+---
+
+앱 루트의 `public/` 폴더에는 정적 파일이 있습니다 — 이미지, 아이콘, 폰트 또는 런타임에 필요한 기타 에셋. 이 파일들은 빌드에 자동 포함되고, 개발 모드에서 동기화되며, 서버로 업로드됩니다.
+
+`public/`에 있는 파일은 다음과 같은 특성을 가집니다:
+
+* **공개적으로 접근 가능** — 서버로 동기화되면 에셋은 공개 URL로 제공됩니다. 접근하려면 인증이 필요하지 않습니다.
+* **프런트 컴포넌트에서 사용 가능** — React 컴포넌트 내부에서 이미지, 아이콘 또는 미디어를 표시하기 위해 에셋 URL을 사용하세요.
+* **로직 함수에서 사용 가능** — 이메일, API 응답 또는 서버 측 로직에서 에셋 URL을 참조하세요.
+* **마켓플레이스 메타데이터에 사용** — `defineApplication()`의 `logoUrl` 및 `screenshots` 필드는 이 폴더의 파일을 참조합니다(예: `public/logo.png`). 앱이 게시되면 이러한 항목이 마켓플레이스에 표시됩니다.
+* **개발 모드에서 자동 동기화** — `public/`에 파일을 추가, 업데이트 또는 삭제하면 자동으로 서버와 동기화됩니다. 재시작이 필요 없습니다.
+* **빌드에 포함** — `yarn twenty dev:build`는 모든 퍼블릭 에셋을 배포 출력물에 번들합니다.
+
+## `getPublicAssetUrl`로 퍼블릭 에셋에 접근하기
+
+`twenty-sdk`의 `getPublicAssetUrl` 헬퍼를 사용해 `public/` 디렉터리의 파일 전체 URL을 가져오세요. 이는 로직 함수와 프런트 컴포넌트 모두에서 동작합니다.
+
+**로직 함수에서:**
+
+```ts src/logic-functions/send-invoice.ts
+import { defineLogicFunction } from 'twenty-sdk/define';
+import { getPublicAssetUrl } from 'twenty-sdk/utils';
+
+const handler = async (): Promise<any> => {
+ const logoUrl = getPublicAssetUrl('logo.png');
+ const invoiceUrl = getPublicAssetUrl('templates/invoice.png');
+
+ // Fetch the file content (no auth required — public endpoint)
+ const response = await fetch(invoiceUrl);
+ const buffer = await response.arrayBuffer();
+
+ return { logoUrl, size: buffer.byteLength };
+};
+
+export default defineLogicFunction({
+ universalIdentifier: 'a1b2c3d4-...',
+ name: 'send-invoice',
+ description: 'Sends an invoice with the app logo',
+ timeoutSeconds: 10,
+ handler,
+});
+```
+
+**프런트 컴포넌트에서:**
+
+```tsx src/front-components/company-card.tsx
+import { defineFrontComponent } from 'twenty-sdk/define';
+import { getPublicAssetUrl } from 'twenty-sdk/utils';
+
+const CompanyCard = () => {
+ const logoUrl = getPublicAssetUrl('logo.png');
+
+ return <img src={logoUrl} alt="App logo" />;
+};
+
+export default defineFrontComponent({
+ universalIdentifier: '...',
+ name: 'company-card',
+ component: CompanyCard,
+});
+```
+
+`path` 인수는 앱의 `public/` 폴더를 기준으로 합니다. `getPublicAssetUrl('logo.png')`과 `getPublicAssetUrl('public/logo.png')`는 동일한 URL로 해석됩니다 — `public/` 접두사가 있으면 자동으로 제거됩니다.
diff --git a/packages/twenty-docs/l/ko/developers/extend/apps/config/roles.mdx b/packages/twenty-docs/l/ko/developers/extend/apps/config/roles.mdx
new file mode 100644
index 00000000000..78bedaf0100
--- /dev/null
+++ b/packages/twenty-docs/l/ko/developers/extend/apps/config/roles.mdx
@@ -0,0 +1,94 @@
+---
+title: 역할 및 권한
+description: 앱의 로직 함수와 프런트 컴포넌트가 어떤 객체와 필드를 읽고 쓸 수 있는지 선언합니다.
+icon: shield-halved
+---
+
+\*\*역할(role)\*\*은 권한 집합입니다. 즉, 앱이 어떤 객체를 읽거나 쓸 수 있는지, 어떤 필드를 볼 수 있는지, 그리고 어떤 플랫폼 수준 기능을 사용할 수 있는지를 정의합니다. 모든 앱의 로직 함수와 프런트 컴포넌트는 `defineApplicationRole()`로 표시된 역할의 권한을 상속받습니다(아래 [기본 함수 역할](#the-default-function-role)을 참조하세요).
+
+```ts src/roles/restricted-company-role.ts
+import {
+ defineRole,
+ STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS,
+ SystemPermissionFlag,
+} from 'twenty-sdk/define';
+
+export default defineRole({
+ universalIdentifier: '2c80f640-2083-4803-bb49-003e38279de6',
+ label: 'My new role',
+ description: 'A role that can be used in your workspace',
+ canReadAllObjectRecords: false,
+ canUpdateAllObjectRecords: false,
+ canSoftDeleteAllObjectRecords: false,
+ canDestroyAllObjectRecords: false,
+ canUpdateAllSettings: false,
+ canBeAssignedToAgents: false,
+ canBeAssignedToUsers: false,
+ canBeAssignedToApiKeys: false,
+ objectPermissions: [
+ {
+ objectUniversalIdentifier:
+ STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS.company.universalIdentifier,
+ canReadObjectRecords: true,
+ canUpdateObjectRecords: true,
+ canSoftDeleteObjectRecords: false,
+ canDestroyObjectRecords: false,
+ },
+ ],
+ fieldPermissions: [
+ {
+ objectUniversalIdentifier:
+ STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS.company.universalIdentifier,
+ fieldUniversalIdentifier:
+ STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS.company.fields.name
+ .universalIdentifier,
+ canReadFieldValue: false,
+ canUpdateFieldValue: false,
+ },
+ ],
+ permissionFlagUniversalIdentifiers: [SystemPermissionFlag.APPLICATIONS],
+});
+```
+
+## 기본 함수 역할
+
+새 앱을 스캐폴딩하면, CLI가 `defineApplicationRole()`로 선언된 기본 역할 파일을 생성합니다:
+
+```ts src/roles/default-role.ts
+import { defineApplicationRole } from 'twenty-sdk/define';
+
+export const DEFAULT_ROLE_UNIVERSAL_IDENTIFIER =
+ 'b648f87b-1d26-4961-b974-0908fd991061';
+
+export default defineApplicationRole({
+ universalIdentifier: DEFAULT_ROLE_UNIVERSAL_IDENTIFIER,
+ label: 'Default function role',
+ description: 'Default role for function Twenty client',
+ canReadAllObjectRecords: true,
+ canUpdateAllObjectRecords: false,
+ canSoftDeleteAllObjectRecords: false,
+ canDestroyAllObjectRecords: false,
+ canUpdateAllSettings: false,
+ canBeAssignedToAgents: false,
+ canBeAssignedToUsers: false,
+ canBeAssignedToApiKeys: false,
+ objectPermissions: [],
+ fieldPermissions: [],
+ permissionFlagUniversalIdentifiers: [],
+});
+```
+
+`defineApplicationRole()`는 설치 시 애플리케이션의 기본 역할로 사용할 역할을 표시하는, `defineRole()`에 대한 간단한 래퍼입니다. 검증 방식은 `defineRole`과 동일하지만, 빌드 파이프라인이 애플리케이션 매니페스트의 `defaultRoleUniversalIdentifier`에 해당 역할의 `universalIdentifier`를 자동으로 연결하므로, [`defineApplication`](/l/ko/developers/extend/apps/config/application)에서 직접 참조할 필요가 없습니다.
+
+노트:
+
+* 앱당 정확히 **하나의** `defineApplicationRole(...)`만 허용되며, 둘 이상 발견되면 매니페스트 빌드가 실패합니다.
+* 앱에서 제공하는 **추가** 역할에는 `defineApplicationRole()`가 아니라 `defineRole()`을 사용하세요.
+* 호환성을 위해 `defineApplication()`에서 `defaultRoleUniversalIdentifier`를 명시적으로 설정하는 방식도 여전히 지원되지만, 이제는 `defineApplicationRole()` 방식이 권장되며 이전 방식은 더 이상 권장되지 않습니다.
+
+## 모범 사례
+
+* 스캐폴딩된 역할에서 시작한 다음 점진적으로 권한을 제한하세요. 기본 설정은 광범위한 읽기 액세스를 부여하는데, 이는 프로덕션 환경에서 원하는 경우가 거의 없습니다.
+* `objectPermissions`와 `fieldPermissions`를 함수에 실제로 필요한 정확한 객체와 필드로 교체하세요.
+* `permissionFlagUniversalIdentifiers`는 플랫폼 수준 기능에 대한 액세스를 제어합니다. 최소한으로 유지하세요.
+* 동작 예제를 참조하세요: [`hello-world/src/roles/function-role.ts`](https://github.com/twentyhq/twenty/blob/main/packages/twenty-apps/hello-world/src/roles/function-role.ts).
diff --git a/packages/twenty-docs/l/ko/developers/extend/apps/data/extending-objects.mdx b/packages/twenty-docs/l/ko/developers/extend/apps/data/extending-objects.mdx
new file mode 100644
index 00000000000..3f9c9f5a26d
--- /dev/null
+++ b/packages/twenty-docs/l/ko/developers/extend/apps/data/extending-objects.mdx
@@ -0,0 +1,50 @@
+---
+title: 객체 확장하기
+description: 표준 Twenty 객체(Person, Company 등)에 필드를 추가합니다. 또는 `defineField`를 사용해 다른 앱의 객체에 필드를 추가합니다.
+icon: wand-magic-sparkles
+---
+
+`defineField()`를 사용해 소유하지 않은 객체(예: Person이나 Company 같은 표준 Twenty 객체 또는 다른 설치된 앱에서 제공하는 객체)에 필드를 추가합니다. [`defineObject`](/l/ko/developers/extend/apps/data/objects) 안에 선언된 인라인 필드와 달리, 독립형 필드는 어느 객체를 확장할지 지정하기 위해 `objectUniversalIdentifier`가 필요합니다.
+
+```ts src/fields/company-loyalty-tier.field.ts
+import { defineField, FieldType } from 'twenty-sdk/define';
+
+export default defineField({
+ universalIdentifier: 'f2a1b3c4-d5e6-7890-abcd-ef1234567890',
+ objectUniversalIdentifier: '701aecb9-eb1c-4d84-9d94-b954b231b64b', // Company object
+ name: 'loyaltyTier',
+ type: FieldType.SELECT,
+ label: 'Loyalty Tier',
+ icon: 'IconStar',
+ options: [
+ { value: 'BRONZE', label: 'Bronze', position: 0, color: 'orange' },
+ { value: 'SILVER', label: 'Silver', position: 1, color: 'gray' },
+ { value: 'GOLD', label: 'Gold', position: 2, color: 'yellow' },
+ ],
+});
+```
+
+## 핵심 요점
+
+* `objectUniversalIdentifier`는 대상 객체를 식별합니다. 표준 Twenty 객체의 경우 `twenty-sdk`에서 상수를 가져옵니다:
+
+ ```ts
+ import { STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS } from 'twenty-sdk/define';
+
+ // STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS.company.universalIdentifier
+ // STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS.person.universalIdentifier
+ // STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS.opportunity.universalIdentifier
+ // …
+ ```
+
+* `defineObject()`에서 필드를 **인라인으로 정의할 때는**, `objectUniversalIdentifier`가 **필요하지 않습니다** — 상위 객체에서 상속됩니다.
+
+* `defineField()`는 `defineObject()`로 생성하지 않은 객체에 필드를 추가하는 유일한 방법입니다.
+
+* 파일 위치는 자유롭게 정할 수 있습니다. 규칙으로는 `src/fields/\<name>.field.ts`를 사용하지만, SDK는 `src/` 어디에서든 필드를 감지합니다.
+
+* 표준 페이지 레이아웃(예: Task 또는 Company 상세 페이지)에 탭을 추가하려면, `twenty-sdk/define`의 `STANDARD_PAGE_LAYOUT_UNIVERSAL_IDENTIFIERS`와 함께 [`definePageLayoutTab`](/l/ko/developers/extend/apps/layout/page-layouts#definepagelayouttab)을(를) 사용하십시오.
+
+## 기존 객체에 관계 추가하기
+
+관계 필드(예: 사용자 정의 객체를 표준 `Person`에 연결)를 추가하려면, `FieldType.RELATION`과 함께 `defineField()`를 사용하세요. 패턴은 인라인 관계와 동일하지만, `objectUniversalIdentifier`를 명시적으로 설정합니다. 양방향 패턴은 [Relations](/l/ko/developers/extend/apps/data/relations)를 참조하세요.
diff --git a/packages/twenty-docs/l/ko/developers/extend/apps/data/objects.mdx b/packages/twenty-docs/l/ko/developers/extend/apps/data/objects.mdx
new file mode 100644
index 00000000000..281ee52972f
--- /dev/null
+++ b/packages/twenty-docs/l/ko/developers/extend/apps/data/objects.mdx
@@ -0,0 +1,104 @@
+---
+title: 개체
+description: defineObject를 사용하여 고유한 필드를 가진 사용자 정의 테이블인 새 레코드 유형을 선언합니다.
+icon: 테이블
+---
+
+사용자 정의 **개체**는 워크스페이스에 앱이 추가하는 새로운 레코드 유형입니다. 엽서(Post Card), 송장(Invoice), 구독(Subscription) 등 도메인에 특화된 어떤 것이라도 될 수 있습니다. 각 개체는 스키마(필드, 관계, 기본값)와 동기화 및 배포 간에도 유지되는 안정적인 범용 식별자를 선언합니다.
+
+```ts src/objects/post-card.object.ts
+import { defineObject, FieldType } from 'twenty-sdk/define';
+
+enum PostCardStatus {
+ DRAFT = 'DRAFT',
+ SENT = 'SENT',
+ DELIVERED = 'DELIVERED',
+ RETURNED = 'RETURNED',
+}
+
+export default defineObject({
+ universalIdentifier: '54b589ca-eeed-4950-a176-358418b85c05',
+ nameSingular: 'postCard',
+ namePlural: 'postCards',
+ labelSingular: 'Post Card',
+ labelPlural: 'Post Cards',
+ description: 'A post card object',
+ icon: 'IconMail',
+ fields: [
+ {
+ universalIdentifier: '58a0a314-d7ea-4865-9850-7fb84e72f30b',
+ name: 'content',
+ type: FieldType.TEXT,
+ label: 'Content',
+ description: "Postcard's content",
+ icon: 'IconAbc',
+ },
+ {
+ universalIdentifier: 'c6aa31f3-da76-4ac6-889f-475e226009ac',
+ name: 'recipientName',
+ type: FieldType.FULL_NAME,
+ label: 'Recipient name',
+ icon: 'IconUser',
+ },
+ {
+ universalIdentifier: '95045777-a0ad-49ec-98f9-22f9fc0c8266',
+ name: 'recipientAddress',
+ type: FieldType.ADDRESS,
+ label: 'Recipient address',
+ icon: 'IconHome',
+ },
+ {
+ universalIdentifier: '87b675b8-dd8c-4448-b4ca-20e5a2234a1e',
+ name: 'status',
+ type: FieldType.SELECT,
+ label: 'Status',
+ icon: 'IconSend',
+ defaultValue: `'${PostCardStatus.DRAFT}'`,
+ options: [
+ { value: PostCardStatus.DRAFT, label: 'Draft', position: 0, color: 'gray' },
+ { value: PostCardStatus.SENT, label: 'Sent', position: 1, color: 'orange' },
+ { value: PostCardStatus.DELIVERED, label: 'Delivered', position: 2, color: 'green' },
+ { value: PostCardStatus.RETURNED, label: 'Returned', position: 3, color: 'orange' },
+ ],
+ },
+ {
+ universalIdentifier: 'e06abe72-5b44-4e7f-93be-afc185a3c433',
+ name: 'deliveredAt',
+ type: FieldType.DATE_TIME,
+ label: 'Delivered at',
+ icon: 'IconCheck',
+ isNullable: true,
+ defaultValue: null,
+ },
+ ],
+});
+```
+
+## 핵심 요점
+
+* `universalIdentifier`는 배포 전반에서 고유하고 안정적이어야 합니다.
+* 각 필드는 `name`, `type`, `label` 및 고유하고 안정적인 `universalIdentifier`가 필요합니다.
+* `fields` 배열은 선택 사항입니다. 사용자 정의 필드 없이도 개체를 정의할 수 있습니다.
+* 여기에서 정의된 인라인 필드는 `objectUniversalIdentifier`가 **필요하지 않습니다** — 상위 개체에서 상속됩니다. 소유하지 않은 개체에 필드를 추가하려면 [`defineField()`](/l/ko/developers/extend/apps/data/extending-objects)를 사용하세요.
+* `yarn twenty dev:add object`를 사용하여 새 개체를 스캐폴딩할 수 있으며, 이름, 필드, 관계 설정 과정을 안내합니다. [Architecture → Scaffolding entities](/l/ko/developers/extend/apps/getting-started/scaffolding)를 참조하세요.
+
+<Note>
+**기본 필드는 자동으로 추가됩니다.** 사용자 정의 개체를 정의하면 Twenty가 `id`, `name`, `createdAt`, `updatedAt`, `createdBy`, `updatedBy`, `deletedAt`와 같은 표준 필드를 자동으로 생성합니다. 이 필드들은 `fields` 배열에 선언할 필요가 없습니다 — 사용자 정의 필드만 선언하면 됩니다. 동일한 이름으로 필드를 선언하여 기본 필드를 재정의할 수 있지만, 이는 거의 바람직하지 않습니다.
+</Note>
+
+## 기본값
+
+리터럴 문자열 기본값은 문자열 **내부에서** 작은따옴표로 감싸야 합니다. 즉, `defaultValue: "'Draft'"`처럼 작성해야 하며, `defaultValue: "Draft"`처럼 작성하면 안 됩니다. 그래서 위의 `status` 필드는 `` `'${PostCardStatus.DRAFT}'` ``를 사용합니다.
+
+따옴표로 감싸지 않은 문자열은 레코드가 생성될 때 평가되는 계산형 기본값으로 예약되어 있습니다.
+
+* `'uuid'` — UUID를 생성합니다 (`UUID` 필드용).
+* `'now'` — 현재 타임스탬프입니다 (`DATE_TIME` 필드용).
+
+동일한 규칙이 복합 기본값의 문자열 하위 필드(예: `ACTOR` 필드의 `{ source: "'MANUAL'" }`)와 `SELECT`/`MULTI_SELECT` 값에도 적용됩니다. 따옴표로 감싸지 않은 리터럴 문자열 기본값은 앱을 빌드할 때 경고를 발생시킵니다.
+
+## 다음 단계
+
+* **이 개체를 다른 개체와 연결** — 양방향 관계 패턴은 [Relations](/l/ko/developers/extend/apps/data/relations)를 참조하세요.
+* **다른 앱의 개체에 필드 추가** — `defineField()`에 대해서는 [Extending Objects](/l/ko/developers/extend/apps/data/extending-objects)를 참조하세요.
+* **UI에 이 개체 표시** — 사이드바에 배치하려면 [Views](/l/ko/developers/extend/apps/layout/views) 및 [Navigation Menu Items](/l/ko/developers/extend/apps/layout/navigation-menu-items)를 참조하세요.
diff --git a/packages/twenty-docs/l/ko/developers/extend/apps/data/overview.mdx b/packages/twenty-docs/l/ko/developers/extend/apps/data/overview.mdx
new file mode 100644
index 00000000000..4641a452968
--- /dev/null
+++ b/packages/twenty-docs/l/ko/developers/extend/apps/data/overview.mdx
@@ -0,0 +1,97 @@
+---
+title: 개요
+description: 워크스페이스에 앱이 추가하는 데이터(개체, 필드, 관계)의 구성을 정의하세요.
+icon: database
+---
+
+Twenty 앱의 **데이터 레이어**는 워크스페이스에 앱이 *추가하는* 데이터입니다. 앱이 선언하는 새로운 레코드 타입, 기존 개체에 추가하는 열, 그리고 이러한 레코드들이 서로 연결되는 방식이 여기에 포함됩니다.
+
+```text
+┌──────────────────────────────────────────────────┐
+│ Object — a record type, e.g. PostCard │
+│ ├─ Field (name, type, label) │
+│ ├─ Field │
+│ └─ Relation (link to another object) │
+└──────────────────────────────────────────────────┘
+ │
+ ├── lives in your app, OR
+ │
+ ▼
+┌──────────────────────────────────────────────────┐
+│ Standard / other apps' objects │
+│ └─ Field added by your app via defineField │
+└──────────────────────────────────────────────────┘
+```
+
+## 이 섹션에서 다루는 내용
+
+<CardGroup cols={2}>
+ <Card title="개체" icon="table" href="/l/ko/developers/extend/apps/data/objects">
+ `defineObject` — 자체 필드를 가진 새로운 레코드 타입을 선언합니다.
+ </Card>
+ <Card title="객체 확장하기" icon="wand-magic-sparkles" href="/l/ko/developers/extend/apps/data/extending-objects">
+ `defineField` — 표준 개체 또는 다른 앱의 개체에 필드를 추가합니다.
+ </Card>
+ <Card title="관계" icon="diagram-project" href="/l/ko/developers/extend/apps/data/relations">
+ 개체 간의 양방향 `MANY_TO_ONE` / `ONE_TO_MANY` 연결입니다.
+ </Card>
+</CardGroup>
+
+## 엔터티 한눈에 보기
+
+| 엔터티 | 목적 | 정의 방식 |
+| ------ | --------------------------------------------------------------------------- | ------------------------------------------ |
+| **객체** | 고유한 필드를 가진 새로운 사용자 정의 레코드 타입(예: PostCard, Invoice) | `defineObject()` |
+| **필드** | 객체의 열 독립형 필드를 사용하면 직접 생성하지 않은 객체도 확장할 수 있습니다(예: Company에 `loyaltyTier` 추가). | `defineField()` |
+| **관계** | 두 객체 사이의 양방향 연결 — 양쪽 모두 필드로 선언됩니다. | `FieldType.RELATION`을 사용하는 `defineField()` |
+| **색인** | 객체 중 하나에 대해 반복적으로 실행되는 쿼리를 빠르게 하기 위한 데이터베이스 색인 | `defineIndex()` |
+
+SDK는 빌드 시 AST 분석을 통해 이를 감지하므로, 파일 구성은 전적으로 여러분에게 달려 있습니다. 권장 컨벤션은 `src/objects/`, `src/fields/`, `src/indexes/`입니다. 안정적인 `universalIdentifier` UUID가 배포 간 모든 것을 하나로 연결합니다.
+
+## 색인(선택 사항)
+
+앱은 반복적인 쿼리를 빠르게 유지하기 위해 객체와 함께 색인을 포함하여 배포할 수 있습니다. 가장 일반적인 사례는 자주 읽는 상태 열 또는 외래 키 열입니다.
+
+```ts src/indexes/post-card-status.index.ts
+import { defineIndex } from 'twenty-sdk/define';
+
+import {
+ POST_CARD_UNIVERSAL_IDENTIFIER,
+ STATUS_FIELD_UNIVERSAL_IDENTIFIER,
+} from '../objects/post-card.object';
+
+export default defineIndex({
+ universalIdentifier: 'b6e9d2a1-5a4c-46ca-9d52-42c8f02d1ff0',
+ objectUniversalIdentifier: POST_CARD_UNIVERSAL_IDENTIFIER,
+ fields: [
+ {
+ universalIdentifier: 'b6e9d2a1-5a4c-46ca-9d52-42c8f02d1ff1',
+ fieldUniversalIdentifier: STATUS_FIELD_UNIVERSAL_IDENTIFIER,
+ },
+ ],
+});
+```
+
+### 고유 색인
+
+`defineIndex`는 단일 열 및 다중 열 고유성 모두에 대해 `isUnique: true`를 허용합니다. 이것이 권장 기본 요소이며, `defineField({ isUnique: true })`는 사용이 중단(deprecated)되었고 향후 릴리스에서 제거될 예정입니다.
+
+```ts
+defineIndex({
+ universalIdentifier: '…',
+ objectUniversalIdentifier: PERSON_UNIVERSAL_IDENTIFIER,
+ isUnique: true,
+ fields: [{ universalIdentifier: '…', fieldUniversalIdentifier: EMAIL_FIELD_UNIVERSAL_IDENTIFIER }],
+});
+```
+
+### 기타 제약 조건
+
+* 부분 `WHERE` 절은 관리자 제어 하에 유지되며, 앱에서 이를 선언할 수 없습니다.
+* 각 객체에는 사용자 정의 색인이 최대 10개까지 허용됩니다(프레임워크 자체 색인은 포함되지 않음).
+
+`fields` 배열의 순서는 Postgres가 사용하는 순서대로 지정하세요. 전화번호부처럼 가장 왼쪽 열이 먼저 오도록 합니다. 색인은 공짜가 아닙니다. 테이블에 대한 모든 쓰기 작업은 색인을 갱신합니다. 해당 색인을 필요로 하는 쿼리가 있을 때에만 색인을 추가하세요.
+
+<Note>
+**Application Config** 또는 **Roles & Permissions**를 찾고 계신가요? 이러한 항목은 앱이 추가하는 데이터가 아니라 앱 자체를 설명하며, [Config](/l/ko/developers/extend/apps/config/overview) 아래에 있습니다. **Connections**(Linear, GitHub, Slack OAuth)를 찾고 계신가요? 이들은 로직 함수 *내부에서* 호출되기 위한 것이며, [Logic](/l/ko/developers/extend/apps/logic/connections) 아래에 있습니다.
+</Note>
diff --git a/packages/twenty-docs/l/ko/developers/extend/apps/data/relations.mdx b/packages/twenty-docs/l/ko/developers/extend/apps/data/relations.mdx
new file mode 100644
index 00000000000..531291a4a4f
--- /dev/null
+++ b/packages/twenty-docs/l/ko/developers/extend/apps/data/relations.mdx
@@ -0,0 +1,160 @@
+---
+title: 관계
+description: 양방향 MANY_TO_ONE / ONE_TO_MANY 관계로 객체들을 서로 연결합니다.
+icon: diagram-project
+---
+
+관계는 두 객체를 서로 연결합니다. Twenty에서는 관계가 항상 **양방향**입니다 — 모든 관계에는 두 개의 측면이 있으며, 각 측면은 서로를 참조하는 필드로 선언됩니다.
+
+| 관계 유형 | 설명 | 외래 키가 있나요? |
+| ------------- | ------------------------------- | -------------------- |
+| `MANY_TO_ONE` | 이 객체의 여러 레코드가 대상의 한 레코드를 가리킵니다 | 예 (`joinColumnName`) |
+| `ONE_TO_MANY` | 이 객체의 하나의 레코드가 대상의 여러 레코드를 가집니다 | 아니오 (역방향) |
+
+## 관계 작동 방식
+
+모든 관계에는 서로를 참조하는 **두 개의 필드**가 필요합니다:
+
+1. **MANY_TO_ONE** 측 — 외래 키를 보유한 객체에 존재합니다.
+2. **ONE_TO_MANY** 측 — 컬렉션을 소유한 객체에 존재합니다.
+
+두 필드 모두 `FieldType.RELATION`을 사용하며 `relationTargetFieldMetadataUniversalIdentifier`를 통해 서로를 교차 참조합니다.
+
+## 예시: Post Card에는 여러 수신자가 있습니다
+
+`PostCard`는 여러 `PostCardRecipient` 레코드에 전송될 수 있습니다. 각 수신자는 정확히 하나의 Post Card에 속합니다.
+
+**1단계: PostCard에서 ONE_TO_MANY 측을 정의합니다** ("one" 측):
+
+```ts src/fields/post-card-recipients-on-post-card.field.ts
+import { defineField, FieldType, RelationType } from 'twenty-sdk/define';
+import { POST_CARD_UNIVERSAL_IDENTIFIER } from '../objects/post-card.object';
+import { POST_CARD_RECIPIENT_UNIVERSAL_IDENTIFIER } from '../objects/post-card-recipient.object';
+
+// Export so the other side can reference it
+export const POST_CARD_RECIPIENTS_FIELD_ID = 'a1111111-1111-1111-1111-111111111111';
+// Import from the other side
+import { POST_CARD_FIELD_ID } from './post-card-on-post-card-recipient.field';
+
+export default defineField({
+ universalIdentifier: POST_CARD_RECIPIENTS_FIELD_ID,
+ objectUniversalIdentifier: POST_CARD_UNIVERSAL_IDENTIFIER,
+ type: FieldType.RELATION,
+ name: 'postCardRecipients',
+ label: 'Post Card Recipients',
+ icon: 'IconUsers',
+ relationTargetObjectMetadataUniversalIdentifier: POST_CARD_RECIPIENT_UNIVERSAL_IDENTIFIER,
+ relationTargetFieldMetadataUniversalIdentifier: POST_CARD_FIELD_ID,
+ universalSettings: {
+ relationType: RelationType.ONE_TO_MANY,
+ },
+});
+```
+
+**2단계: PostCardRecipient에서 MANY_TO_ONE 측을 정의합니다** ("many" 측 — 외래 키를 보유함):
+
+```ts src/fields/post-card-on-post-card-recipient.field.ts
+import { defineField, FieldType, RelationType, OnDeleteAction } from 'twenty-sdk/define';
+import { POST_CARD_UNIVERSAL_IDENTIFIER } from '../objects/post-card.object';
+import { POST_CARD_RECIPIENT_UNIVERSAL_IDENTIFIER } from '../objects/post-card-recipient.object';
+
+// Export so the other side can reference it
+export const POST_CARD_FIELD_ID = 'b2222222-2222-2222-2222-222222222222';
+// Import from the other side
+import { POST_CARD_RECIPIENTS_FIELD_ID } from './post-card-recipients-on-post-card.field';
+
+export default defineField({
+ universalIdentifier: POST_CARD_FIELD_ID,
+ objectUniversalIdentifier: POST_CARD_RECIPIENT_UNIVERSAL_IDENTIFIER,
+ type: FieldType.RELATION,
+ name: 'postCard',
+ label: 'Post Card',
+ icon: 'IconMail',
+ relationTargetObjectMetadataUniversalIdentifier: POST_CARD_UNIVERSAL_IDENTIFIER,
+ relationTargetFieldMetadataUniversalIdentifier: POST_CARD_RECIPIENTS_FIELD_ID,
+ universalSettings: {
+ relationType: RelationType.MANY_TO_ONE,
+ onDelete: OnDeleteAction.CASCADE,
+ joinColumnName: 'postCardId',
+ },
+});
+```
+
+<Note>
+**순환 임포트:** 두 관계 필드는 서로의 `universalIdentifier`를 참조합니다. 순환 임포트 문제를 피하려면, 각 파일에서 필드 ID를 명명된 상수로 export하고 다른 파일에서 import하세요. 빌드 시스템은 컴파일 시점에 이를 해결합니다.
+</Note>
+
+## 표준 객체와의 관계 설정
+
+내장 Twenty 객체(Person, Company 등)와 관계를 만들려면 `STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS`를 사용하세요:
+
+```ts src/fields/person-on-self-hosting-user.field.ts
+import {
+ defineField,
+ FieldType,
+ RelationType,
+ OnDeleteAction,
+ STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS,
+} from 'twenty-sdk/define';
+import { SELF_HOSTING_USER_UNIVERSAL_IDENTIFIER } from '../objects/self-hosting-user.object';
+
+export const PERSON_FIELD_ID = 'c3333333-3333-3333-3333-333333333333';
+export const SELF_HOSTING_USER_REVERSE_FIELD_ID = 'd4444444-4444-4444-4444-444444444444';
+
+export default defineField({
+ universalIdentifier: PERSON_FIELD_ID,
+ objectUniversalIdentifier: SELF_HOSTING_USER_UNIVERSAL_IDENTIFIER,
+ type: FieldType.RELATION,
+ name: 'person',
+ label: 'Person',
+ description: 'Person matching with the self hosting user',
+ isNullable: true,
+ relationTargetObjectMetadataUniversalIdentifier:
+ STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS.person.universalIdentifier,
+ relationTargetFieldMetadataUniversalIdentifier: SELF_HOSTING_USER_REVERSE_FIELD_ID,
+ universalSettings: {
+ relationType: RelationType.MANY_TO_ONE,
+ onDelete: OnDeleteAction.SET_NULL,
+ joinColumnName: 'personId',
+ },
+});
+```
+
+## 관계 필드 속성
+
+| 속성 | 필수 | 설명 |
+| ------------------------------------------------- | ---------------- | --------------------------------------------------------------------- |
+| `type` | 예 | `FieldType.RELATION`이어야 함 |
+| `relationTargetObjectMetadataUniversalIdentifier` | 예 | 대상 객체의 `universalIdentifier` |
+| `relationTargetFieldMetadataUniversalIdentifier` | 예 | 대상 객체의 일치하는 필드의 `universalIdentifier` |
+| `universalSettings.relationType` | 예 | `RelationType.MANY_TO_ONE` 또는 `RelationType.ONE_TO_MANY` |
+| `universalSettings.onDelete` | MANY_TO_ONE에만 해당 | 참조된 레코드가 삭제될 때의 동작: `CASCADE`, `SET_NULL`, `RESTRICT`, 또는 `NO_ACTION` |
+| `universalSettings.joinColumnName` | MANY_TO_ONE에만 해당 | 외래 키에 대한 데이터베이스 컬럼 이름(예: `postCardId`) |
+
+## 인라인 관계 필드
+
+[`defineObject`](/l/ko/developers/extend/apps/data/objects) 안에서 관계를 직접 선언할 수도 있습니다. 인라인인 경우에는 `objectUniversalIdentifier`를 생략하세요 — 상위 객체에서 상속됩니다:
+
+```ts
+export default defineObject({
+ universalIdentifier: '...',
+ nameSingular: 'postCardRecipient',
+ // ...
+ fields: [
+ {
+ universalIdentifier: POST_CARD_FIELD_ID,
+ type: FieldType.RELATION,
+ name: 'postCard',
+ label: 'Post Card',
+ relationTargetObjectMetadataUniversalIdentifier: POST_CARD_UNIVERSAL_IDENTIFIER,
+ relationTargetFieldMetadataUniversalIdentifier: POST_CARD_RECIPIENTS_FIELD_ID,
+ universalSettings: {
+ relationType: RelationType.MANY_TO_ONE,
+ onDelete: OnDeleteAction.CASCADE,
+ joinColumnName: 'postCardId',
+ },
+ },
+ // … other fields
+ ],
+});
+```
diff --git a/packages/twenty-docs/l/ko/developers/extend/apps/getting-started/concepts.mdx b/packages/twenty-docs/l/ko/developers/extend/apps/getting-started/concepts.mdx
new file mode 100644
index 00000000000..624314da635
--- /dev/null
+++ b/packages/twenty-docs/l/ko/developers/extend/apps/getting-started/concepts.mdx
@@ -0,0 +1,101 @@
+---
+title: 개념
+description: Twenty 앱이 작동하는 방식 — 엔티티 모델, 샌드박싱, 설치 라이프사이클.
+icon: sitemap
+---
+
+Twenty 앱은 사용자 정의 객체, 로직, UI 컴포넌트 및 AI 기능으로 워크스페이스를 확장하는 TypeScript 패키지입니다. 앱은 Twenty 플랫폼에서 완전한 샌드박싱과 권한 제어 하에 실행됩니다.
+
+## 앱 작동 방식
+
+앱은 `twenty-sdk` 패키지의 `defineEntity()` 함수를 사용해 선언된 **엔티티**의 모음입니다. SDK는 빌드 시점에 AST 분석을 통해 이러한 선언을 감지하고, 앱이 워크스페이스에 추가하는 내용을 완전하게 설명한 **매니페스트**를 생성합니다. 이 함수들은 빌드 시점에 구성을 검증하고 IDE 자동 완성과 타입 안정성을 제공합니다.
+
+```
+your-app/
+├── src/
+│ ├── application-config.ts ← defineApplication (required, one per app)
+│ ├── roles/ ← defineRole
+│ ├── objects/ ← defineObject
+│ ├── fields/ ← defineField
+│ ├── logic-functions/ ← defineLogicFunction
+│ ├── front-components/ ← defineFrontComponent
+│ ├── skills/ ← defineSkill
+│ ├── agents/ ← defineAgent
+│ ├── views/ ← defineView
+│ ├── navigation-menu-items/ ← defineNavigationMenuItem
+│ └── page-layouts/ ← definePageLayout
+├── public/ ← Static assets (images, icons)
+└── package.json
+```
+
+<Note>
+ **파일 구성은 사용자의 선택입니다.** 엔티티 감지는 AST 기반이며 — 파일 위치와 관계없이 SDK가 `export default defineEntity(...)` 호출을 찾습니다. 위의 폴더 구조는 관례이며 필수 사항은 아닙니다.
+</Note>
+
+## 엔티티 유형
+
+| 엔티티 | 목적 | 문서 |
+| --------------- | ------------------------- | ----------------------------------------------------------------------------- |
+| **애플리케이션** | 앱 식별, 기본 역할, 변수 | [Application Config](/l/ko/developers/extend/apps/config/application) |
+| **역할** | 객체와 필드에 대한 권한 세트 | [Roles & Permissions](/l/ko/developers/extend/apps/config/roles) |
+| **객체** | 필드가 있는 사용자 정의 레코드 타입 | [Objects](/l/ko/developers/extend/apps/data/objects) |
+| **필드** | 다른 앱의 객체에 필드를 추가 | [Extending Objects](/l/ko/developers/extend/apps/data/extending-objects) |
+| **관계** | 객체 간 양방향 링크 | [Relations](/l/ko/developers/extend/apps/data/relations) |
+| **로직 함수** | 트리거가 있는 서버 측 TypeScript | [로직 함수](/l/ko/developers/extend/apps/logic/logic-functions) |
+| **스킬** | 재사용 가능한 AI 에이전트 지침 | [스킬 및 에이전트](/l/ko/developers/extend/apps/logic/skills-and-agents) |
+| **에이전트** | 사용자 지정 프롬프트를 사용하는 AI 에이전트 | [스킬 및 에이전트](/l/ko/developers/extend/apps/logic/skills-and-agents) |
+| **연결 제공자** | 서드파티 API용 OAuth 자격 증명 | [Connections](/l/ko/developers/extend/apps/logic/connections) |
+| **뷰** | 사전 구성된 레코드 목록 뷰 | [Views](/l/ko/developers/extend/apps/layout/views) |
+| **내비게이션 메뉴 항목** | 사용자 정의 사이드바 항목 | [Navigation Menu Items](/l/ko/developers/extend/apps/layout/navigation-menu-items) |
+| **페이지 레이아웃** | 레코드 상세 페이지의 탭과 위젯 | [Page Layouts](/l/ko/developers/extend/apps/layout/page-layouts) |
+| **프런트 컴포넌트** | Twenty 내부의 샌드박스 React UI | [프런트 컴포넌트](/l/ko/developers/extend/apps/layout/front-components) |
+| **명령 메뉴 항목** | 빠른 작업 및 Cmd+K 항목 | [Command Menu Items](/l/ko/developers/extend/apps/layout/command-menu-items) |
+
+## 샌드박싱
+
+* **로직 함수**는 서버의 격리된 Node.js 프로세스에서 실행됩니다. 이들은 앱의 역할 권한 범위로 제한된 타입이 지정된 API 클라이언트를 통해서만 데이터에 접근합니다.
+* **프런트 컴포넌트**는 Remote DOM을 사용하는 Web Worker에서 실행됩니다 — 메인 페이지와는 샌드박스로 격리되어 있지만 네이티브 DOM 요소를 렌더링합니다(iframe이 아님). 이들은 메시지 전달 호스트 API를 통해 Twenty와 통신합니다.
+* **권한**은 API 수준에서 강제 적용됩니다. 런타임 토큰(`TWENTY_APP_ACCESS_TOKEN`)은 `defineApplication()`에 정의된 역할에서 파생됩니다.
+
+## 앱 라이프사이클
+
+```
+┌─────────────────────────────────────────────────────────┐
+│ Development │
+│ npx create-twenty-app → yarn twenty dev (live sync) │
+├─────────────────────────────────────────────────────────┤
+│ Build & Deploy │
+│ yarn twenty dev:build → yarn twenty app:publish │
+├─────────────────────────────────────────────────────────┤
+│ Install flow │
+│ upload → [pre-install] → metadata migration → │
+│ generate SDK → [post-install] │
+├─────────────────────────────────────────────────────────┤
+│ Publish │
+│ npm publish → appears in Twenty marketplace │
+└─────────────────────────────────────────────────────────┘
+```
+
+* **`yarn twenty dev`** — 소스 파일을 감시하고 연결된 Twenty 서버로 변경 사항을 실시간 동기화합니다. 스키마가 변경되면 타입이 지정된 API 클라이언트가 자동으로 재생성됩니다.
+* **`yarn twenty dev:build`** — TypeScript를 컴파일하고, 로직 함수와 프런트 컴포넌트를 esbuild로 번들링하며, 매니페스트를 생성합니다.
+* **사전/사후 설치 훅** — 설치 중에 실행되는 선택적 함수입니다. 자세한 내용은 [Install Hooks](/l/ko/developers/extend/apps/config/install-hooks)를 참조하세요.
+
+## 다음 단계
+
+<CardGroup cols={2}>
+ <Card title="설정" icon="screwdriver-wrench" href="/l/ko/developers/extend/apps/config/overview">
+ 애플리케이션 식별, 기본 역할, 설치 훅.
+ </Card>
+ <Card title="데이터" icon="database" href="/l/ko/developers/extend/apps/data/overview">
+ 객체, 필드, 양방향 관계.
+ </Card>
+ <Card title="로직" icon="bolt" href="/l/ko/developers/extend/apps/logic/overview">
+ 로직 함수, 스킬, 에이전트, OAuth 연결.
+ </Card>
+ <Card title="레이아웃" icon="table-columns" href="/l/ko/developers/extend/apps/layout/overview">
+ 뷰, 내비게이션, 페이지 레이아웃, 프런트 컴포넌트.
+ </Card>
+ <Card title="작업" icon="rocket" href="/l/ko/developers/extend/apps/operations/overview">
+ CLI, 테스트, 리모트, CI, 앱 게시.
+ </Card>
+</CardGroup>
diff --git a/packages/twenty-docs/l/ko/developers/extend/apps/getting-started/local-server.mdx b/packages/twenty-docs/l/ko/developers/extend/apps/getting-started/local-server.mdx
new file mode 100644
index 00000000000..71b3e97f5d9
--- /dev/null
+++ b/packages/twenty-docs/l/ko/developers/extend/apps/getting-started/local-server.mdx
@@ -0,0 +1,87 @@
+---
+title: 로컬 서버
+description: 로컬 Twenty Docker 서버를 관리합니다. 시작, 중지, 업그레이드, 병렬 테스트 인스턴스 및 수동 SDK 설정을 수행할 수 있습니다.
+icon: server
+---
+
+## 로컬 서버 관리
+
+로컬 Twenty 컨테이너를 제어하려면 `yarn twenty docker:*`를 사용하세요:
+
+| 명령 | 하는 일 |
+| -------------------------------------- | ----------------------------- |
+| `yarn twenty docker:start` | 서버 시작(필요하면 이미지를 가져옴) |
+| `yarn twenty docker:start 2.2.0` | 특정 서버 버전을 시작합니다 |
+| `yarn twenty docker:start --port 3030` | 사용자 지정 포트에서 시작 |
+| `yarn twenty docker:stop` | 서버 중지(데이터 보존) |
+| `yarn twenty docker:status` | URL, 버전 및 로그인 자격 증명 표시 |
+| `yarn twenty docker:logs` | 서버 로그 스트리밍 |
+| `yarn twenty docker:reset` | 데이터를 모두 삭제하고 새로 시작 |
+| `yarn twenty docker:upgrade` | `twenty-app-dev` 최신 이미지를 가져오기 |
+| `yarn twenty docker:upgrade 2.2.0` | 특정 버전으로 업그레이드합니다 |
+
+데이터는 두 개의 Docker 볼륨에 저장되어 재시작 후에도 유지됩니다(PostgreSQL은 `twenty-app-dev-data`, 파일은 `twenty-app-dev-storage`). `reset`을 사용하여 모든 것을 삭제하세요.
+
+## 서버 버전 고정하기
+
+버전을 전달하지 않으면, `docker:start`는 `package.json`의 앱 `engines.twenty` 범위에서 버전을 결정합니다. 이 범위는 앱이 설치될 때 서버가 검증에 사용하는 범위와 같습니다. 이 명령은 해당 범위를 만족하는 가장 최근에 게시된 `twenty-app-dev` 이미지를 시작하며, 해당 필드가 없거나 게시된 버전이 범위와 일치하지 않으면 `latest`로 대체합니다:
+
+```json filename="package.json"
+{
+ "engines": {
+ "twenty": ">=2.2.0"
+ }
+}
+```
+
+단일 실행에서만 범위를 재정의하려면 버전을 명시적으로 전달하세요: `yarn twenty docker:start 2.3.0`. 이미 다른 버전에서 컨테이너가 존재하는 경우, `docker:start`는 해당 컨테이너를 제자리에서 업그레이드합니다(데이터 볼륨을 유지하면서 컨테이너를 재생성).
+
+## 서버 이미지 업그레이드
+
+`yarn twenty docker:upgrade`는 최신 이미지를 가져와 다이제스트를 비교하고, 실제로 변경 사항이 있을 때만 컨테이너를 다시 생성합니다. 데이터 볼륨은 유지되며 — 컨테이너만 교체됩니다. 새 이미지를 가져왔고 컨테이너가 실행 중이었다면, 업그레이드는 자동으로 새 컨테이너를 시작합니다; 이후 `yarn twenty docker:start`를 실행하여 상태가 정상(healthy)이 될 때까지 기다리세요.
+
+```bash filename="Terminal"
+yarn twenty docker:upgrade # Latest
+yarn twenty docker:upgrade 2.2.0 # Specific version
+```
+
+`yarn twenty docker:status`로 실행 중인 버전을 확인하세요(컨테이너에 포함된 `APP_VERSION`을 표시합니다).
+
+## 병렬 테스트 인스턴스 실행
+
+완전히 분리된 두 번째 인스턴스를 관리하려면 모든 `docker:*` 명령에 `--test`를 전달하세요 — 메인 개발 데이터를 건드리지 않고 통합 테스트를 실행하거나 실험할 때 유용합니다:
+
+| 명령 | 하는 일 |
+| ----------------------------------- | ---------------------------- |
+| `yarn twenty docker:start --test` | 테스트 인스턴스를 시작합니다(기본 포트는 2021) |
+| `yarn twenty docker:stop --test` | 중지 |
+| `yarn twenty docker:status --test` | 상태 표시 |
+| `yarn twenty docker:logs --test` | 로그 스트리밍 |
+| `yarn twenty docker:reset --test` | 데이터 삭제 |
+| `yarn twenty docker:upgrade --test` | 이미지 업그레이드 |
+
+테스트 인스턴스는 자체 컨테이너(`twenty-app-dev-test`), 전용 볼륨(`twenty-app-dev-test-data`, `twenty-app-dev-test-storage`), 구성으로 실행되며, 메인 인스턴스와 충돌 없이 나란히 실행됩니다. `--test`를 `--port`와 함께 사용하여 2021을 재정의하세요.
+
+## 수동 설정(스캐폴더 없이)
+
+기존 프로젝트에 SDK를 추가하는 경우 스캐폴더 단계를 건너뜁니다:
+
+```bash filename="Terminal"
+yarn add twenty-sdk twenty-client-sdk
+```
+
+`package.json`에 스크립트를 추가하세요:
+
+```json filename="package.json"
+{
+ "scripts": {
+ "twenty": "twenty"
+ }
+}
+```
+
+이제 `yarn twenty dev`, `yarn twenty docker:start` 등을 실행할 수 있습니다.
+
+<Note>
+`twenty-sdk`를 전역으로 설치하지 마세요 — 각 프로젝트에 고정하여 각 앱이 자체 버전을 사용하도록 하세요.
+</Note>
diff --git a/packages/twenty-docs/l/ko/developers/extend/apps/getting-started/project-structure.mdx b/packages/twenty-docs/l/ko/developers/extend/apps/getting-started/project-structure.mdx
new file mode 100644
index 00000000000..47ad46a603e
--- /dev/null
+++ b/packages/twenty-docs/l/ko/developers/extend/apps/getting-started/project-structure.mdx
@@ -0,0 +1,61 @@
+---
+title: 프로젝트 구조
+description: 스캐폴딩된 Twenty 앱 안에 무엇이 들어 있는지 — 파일, 폴더, 그리고 각 요소의 역할을 설명합니다.
+icon: folder-tree
+---
+
+`npx create-twenty-app`으로 생성한 새 앱은 다음과 같은 구조입니다:
+
+```text filename="my-twenty-app/"
+my-twenty-app/
+ package.json
+ src/
+ application-config.ts # Required — your app's entry point
+ default-role.ts # Permissions for logic functions
+ constants/
+ universal-identifiers.ts # Auto-generated UUIDs and metadata
+ __tests__/
+ setup-test.ts
+ app-install.integration-test.ts
+ .github/workflows/ci.yml # GitHub Actions
+ public/ # Static assets
+ vitest.config.ts # Test runner config
+ tsconfig.json, tsconfig.spec.json
+ .nvmrc, .yarnrc.yml, .oxlintrc.json
+ README.md, LLMS.md
+```
+
+## 주요 파일
+
+| 파일 / 폴더 | 목적 |
+| ---------------------------------------- | -------------------------------- |
+| `src/application-config.ts` | **필수.** 앱의 기본 구성 파일입니다. |
+| `src/default-role.ts` | 로직 함수가 접근할 수 있는 범위를 제어하는 기본 역할 |
+| `src/constants/universal-identifiers.ts` | 자동 생성된 UUID와 앱 메타데이터(표시 이름, 설명). |
+| `src/__tests__/` | 통합 테스트(설정 + 예제 테스트). |
+| `public/` | 앱과 함께 제공되는 정적 에셋(이미지, 폰트). |
+
+<Note>
+**파일 구성은 사용자의 선택입니다.** 위 폴더들은 관례일 뿐이며, SDK는 파일 위치와 관계없이 `export default defineEntity(...)` 호출에 대한 AST 분석을 통해 엔티티를 감지합니다.
+</Note>
+
+## 의존성
+
+두 Twenty SDK 패키지는 `dependencies`가 아니라 `devDependencies` 아래에 속해야 합니다.
+
+```json filename="package.json"
+{
+ "dependencies": {},
+ "devDependencies": {
+ "twenty-client-sdk": "^2.13.0",
+ "twenty-sdk": "^2.13.0"
+ }
+}
+```
+
+* \*\*`twenty-sdk`\*\*는 `twenty` CLI와 빌드/스캐폴딩 도구를 제공합니다. 이 패키지는 개발 및 빌드 시점에만 실행되며, 배포된 앱의 런타임에서는 전혀 임포트되지 않습니다.
+* \*\*`twenty-client-sdk`\*\*는 앱 코드(`CoreApiClient`, `MetadataApiClient`, `RestApiClient`)에서 임포트되지만, 런타임에는 Twenty가 이를 제공합니다. 로직 함수는 생성된 SDK 레이어에서 이를 가져오고, 프런트엔드 컴포넌트는 서버에서 제공되는 모듈에서 이를 해석하여 가져옵니다. 설치된 사본은 타입 검사와 배포 시점 빌드에만 사용되므로, 배포된 번들에 포함되어 함께 제공될 필요가 없습니다.
+
+어느 한 패키지라도 `dependencies` 아래에 두면, 설치된 앱의 런타임 번들에 포함되어 쓸모없는 부하가 됩니다. `twenty build`는 둘 중 하나라도 여전히 `dependencies` 아래에 나열되어 있으면 경고를 출력합니다.
+
+앱의 실제 런타임 의존성(로직 함수가 런타임에 실제로 임포트하는 라이브러리)은 평소와 같이 `dependencies` 아래에 추가하세요.
diff --git a/packages/twenty-docs/l/ko/developers/extend/apps/getting-started/quick-start.mdx b/packages/twenty-docs/l/ko/developers/extend/apps/getting-started/quick-start.mdx
new file mode 100644
index 00000000000..c3b0aaa5bfe
--- /dev/null
+++ b/packages/twenty-docs/l/ko/developers/extend/apps/getting-started/quick-start.mdx
@@ -0,0 +1,176 @@
+---
+title: 빠른 시작
+icon: rocket
+description: 몇 분 만에 첫 번째 Twenty 앱을 만들어 보세요.
+---
+
+## 사전 준비
+
+* **Node.js 24+** — [여기에서 다운로드](https://nodejs.org/)
+* **Yarn 4** — Corepack을 통해 Node.js와 함께 제공됩니다. 활성화하려면: `corepack enable`
+* **Docker** — [여기에서 다운로드](https://www.docker.com/products/docker-desktop/). 로컬 Twenty 서버를 실행하려면 필요합니다. 이미 다른 곳에서 Twenty가 실행 중이라면 건너뛰세요.
+
+Twenty 앱을 빌드하는 과정은 세 단계로 이루어집니다. 스캐폴더는 이를 단일 해피 패스 명령으로 합쳐 주지만, 각 단계는 별개의 개념입니다 — 문제가 발생했을 때 현재 단계가 어디인지 알면 무엇을 고쳐야 하는지 파악할 수 있습니다.
+
+| 단계 | 하는 일 | 도구 | 결과 |
+| ------------ | ------------------------- | ----------------------------- | -------------------- |
+| **1. 스캐폴딩** | 앱의 소스 코드를 생성 | `npx create-twenty-app` | 디스크에 TypeScript 프로젝트 |
+| **2. 서버 실행** | 동기화 대상으로 사용할 Twenty 서버 시작 | Docker + `yarn twenty server` | 실행 중인 Twenty 인스턴스 |
+| **3. 동기화** | 코드를 서버와 실시간 동기화 | `yarn twenty dev` | 변경 사항이 UI에 표시됨 |
+
+---
+
+## 1단계 — 프로젝트 스캐폴딩
+
+템플릿에서 새 앱을 생성합니다:
+
+```bash filename="Terminal"
+npx create-twenty-app@latest my-twenty-app
+```
+
+이름과 설명을 묻는 프롬프트가 표시됩니다 — 기본값을 사용하려면 **Enter**를 누르세요. 이 명령은 `my-twenty-app/`에 시작용 `application-config.ts`, 기본 역할, CI 워크플로, 통합 테스트가 포함된 TypeScript 프로젝트를 생성합니다.
+
+**이 단계를 마치면:** 로컬 머신에 앱의 소스 코드가 준비됩니다. 아직 실행되지는 않았습니다 — 그건 2단계에서 진행합니다.
+
+---
+
+## 2단계 — 로컬 Twenty 서버 실행
+
+앱은 동기화할 Twenty 서버가 필요합니다. 이 서버는 Docker에서 로컬로 실행되는 완전한 Twenty 인스턴스입니다 — UI, GraphQL API, PostgreSQL을 포함합니다. 로컬 코드가 해당 서버로 정의를 업로드하면 UI에 표시됩니다.
+
+스캐폴더가 서버 시작 여부를 묻습니다:
+
+> **로컬 Twenty 인스턴스를 설정하시겠습니까?**
+
+* **Yes(권장)** — `twentycrm/twenty-app-dev` Docker 이미지를 가져와 포트 `2020`에서 시작합니다. 먼저 Docker가 실행 중인지 확인하세요.
+* **No** — 이미 연결하려는 Twenty 서버가 있는 경우 선택하세요. `yarn twenty remote:add`로 나중에 연결할 수 있습니다.
+
+<div style={{textAlign: 'center'}}>
+ <img src="/images/docs/developers/extends/apps/start-instance.png" alt="로컬 인스턴스를 시작할까요?" />
+</div>
+
+서버가 올라오면 로그인할 수 있도록 브라우저가 열립니다. 미리 준비된 데모 계정을 사용하세요:
+
+* **이메일:** `[email protected]`
+* **비밀번호:** `[email protected]`
+
+<div style={{textAlign: 'center'}}>
+ <img src="/images/docs/developers/extends/apps/login.png" alt="Twenty 로그인 화면" />
+</div>
+
+다음 화면에서 **Authorize**를 클릭하세요 — 그러면 CLI가 워크스페이스에 접근할 수 있게 됩니다.
+
+<div style={{textAlign: 'center'}}>
+ <img src="/images/docs/developers/extends/apps/authorize.png" alt="Twenty CLI 권한 부여 화면" />
+</div>
+
+권한 부여가 완료되면 터미널에 설정이 완료되었다는 메시지가 표시됩니다.
+
+<div style={{textAlign: 'center'}}>
+ <img src="/images/docs/developers/extends/apps/scaffolded.png" alt="앱 스캐폴딩 성공" />
+</div>
+
+**이 단계를 마치면:** [http://localhost:2020](http://localhost:2020)에서 Twenty 서버가 실행 중이며, CLI가 해당 서버로 동기화하도록 권한이 부여됩니다.
+
+<Note>
+Docker가 설치되어 있지 않거나 실행 중이 아니면, 스캐폴더가 OS에 맞는 올바른 시작 명령을 알려줍니다. Docker가 올라오면 `yarn twenty docker:start`로 이어서 진행할 수 있습니다 — 다시 스캐폴딩할 필요는 없습니다.
+</Note>
+
+---
+
+## 3단계 — 변경 사항 동기화
+
+이 단계는 대부분의 시간을 보내게 될 내부 루프입니다.
+
+```bash filename="Terminal"
+cd my-twenty-app
+yarn twenty dev
+```
+
+`src/`를 감시하며 변경될 때마다 다시 빌드하고, 결과를 서버에 동기화합니다. 파일을 수정해 저장하면 몇 초 안에 서버에 변경 사항이 반영됩니다. 터미널에서 실시간 상태 패널을 확인할 수 있습니다.
+
+더 자세한 출력(빌드 로그, 동기화 요청, 오류 트레이스)을 보려면 `--verbose`를 추가하세요.
+
+<div style={{textAlign: 'center'}}>
+ <img src="/images/docs/developers/extends/apps/dev.png" alt="개발 모드 터미널 출력" />
+</div>
+
+[http://localhost:2020/settings/applications#developer](http://localhost:2020/settings/applications#developer)를 엽니다. **Your Apps** 아래에 앱이 표시됩니다.
+
+<div style={{textAlign: 'center'}}>
+ <img src="/images/docs/developers/extends/apps/app-in-ui-1.png" alt="Your Apps 목록에 My twenty app이 표시됨" />
+</div>
+
+**My twenty app**을 클릭하여 **애플리케이션 등록**을 확인하세요 — 앱을 설명하는 서버 수준의 레코드입니다(이름, 식별자, OAuth 자격 증명, 소스). 하나의 등록은 동일한 서버의 여러 워크스페이스에 설치할 수 있습니다.
+
+<div style={{textAlign: 'center'}}>
+ <img src="/images/docs/developers/extends/apps/app-in-ui-2.png" alt="애플리케이션 등록 세부정보" />
+</div>
+
+워크스페이스 설치를 확인하려면 **View installed app**을 클릭하세요. **About** 탭에는 버전과 관리 옵션이 표시됩니다.
+
+<div style={{textAlign: 'center'}}>
+ <img src="/images/docs/developers/extends/apps/app-in-ui-3.png" alt="설치된 앱" />
+</div>
+
+**이 단계를 마치면:** 라이브 개발 루프가 준비됩니다. `src/`의 파일을 수정하면 UI에 반영됩니다.
+
+### CI 및 스크립트를 위한 1회성 동기화
+
+`--once`를 전달하면 한 번만 빌드 + 동기화를 실행하고 종료합니다 — 파이프라인은 동일하고, 워처는 없습니다:
+
+```bash filename="Terminal"
+yarn twenty dev --once
+```
+
+| 명령 | 동작 | 사용 시점 |
+| ---------------------------------- | ------------------------------------------------ | -------------------------------------- |
+| `yarn twenty dev` | 소스 파일을 감시하고 변경될 때마다 다시 동기화합니다. 중지할 때까지 계속 실행됩니다. | 대화형 로컬 개발. |
+| `yarn twenty dev --once` | 한 번만 빌드 + 동기화를 수행하고, 성공 시 `0`, 실패 시 `1`로 종료합니다. | CI, pre-commit 훅, AI 에이전트, 스크립트형 워크플로. |
+| `yarn twenty dev --once --dry-run` | 메타데이터 변경 사항을 **실제로 적용하지 않고** 빌드하고 출력합니다. | 커밋하기 전에 동기화가 어떤 변경을 수행할지 살펴봅니다. |
+
+두 모드 모두 인증된 리모트가 필요합니다. `--dry-run`에 대한 자세한 내용은 [동기화 및 복구](/l/ko/developers/extend/apps/operations/sync-and-recovery#previewing-changes-dry-run)를 참고하세요.
+
+### 개발 모드 옵션
+
+| 플래그 | 설명 |
+| ------------------------------------- | -------------------------------------------------------------------- |
+| `--once` | 한 번만 빌드하고 동기화한 다음 종료합니다. |
+| `--dry-run` | `--once`를 사용하면 메타데이터 변경 사항을 실제로 적용하지 않고 미리 볼 수 있습니다. 아무것도 기록하지 않습니다. |
+| `--debounceMs \<ms>` | 파일 변경 디바운스 지연 시간을 밀리초 단위로 설정합니다(기본값: `2000`). |
+| `--verbose` / `--debug` | 자세한 빌드 로그, 동기화 요청, 오류 추적을 표시합니다. |
+
+## 만들 수 있는 것
+
+앱은 **엔터티**로 구성됩니다 — 각 엔터티는 하나의 `export default`만 포함하는 TypeScript 파일로 정의됩니다:
+
+| 엔터티 | 하는 일 |
+| ------------- | ---------------------------------------------------------- |
+| **객체 & 필드** | 사용자 정의 데이터 모델(Post Card, Invoice 등) 타입이 지정된 필드 포함 |
+| **로직 함수** | HTTP 라우트, cron 스케줄 또는 데이터베이스 이벤트로 트리거되는 서버 측 TypeScript 코드 |
+| **프론트 컴포넌트** | Twenty의 UI(사이드 패널, 위젯, 명령 메뉴) 안에 렌더링되는 React 컴포넌트 |
+| **스킬 & 에이전트** | AI 기능 — 재사용 가능한 지침과 자율형 어시스턴트 |
+| **뷰 & 내비게이션** | 사전 구성된 목록 뷰와 사이드바 메뉴 항목 |
+| **페이지 레이아웃** | 탭과 위젯이 있는 사용자 정의 레코드 상세 페이지 |
+
+전체 참고 문서: [개념](/l/ko/developers/extend/apps/getting-started/concepts).
+
+## 다음 단계
+
+<CardGroup cols={2}>
+ <Card title="설정" icon="screwdriver-wrench" href="/l/ko/developers/extend/apps/config/overview">
+ 애플리케이션 ID, 기본 역할, 설치 훅, 공개 자산.
+ </Card>
+ <Card title="데이터" icon="database" href="/l/ko/developers/extend/apps/data/overview">
+ 객체, 필드, 그리고 양방향 관계.
+ </Card>
+ <Card title="로직" icon="bolt" href="/l/ko/developers/extend/apps/logic/overview">
+ 로직 함수, 스킬, 에이전트, OAuth 연결.
+ </Card>
+ <Card title="레이아웃" icon="table-columns" href="/l/ko/developers/extend/apps/layout/overview">
+ 뷰, 내비게이션, 페이지 레이아웃, 프론트 컴포넌트.
+ </Card>
+ <Card title="작업" icon="rocket" href="/l/ko/developers/extend/apps/operations/overview">
+ CLI, 테스트, 리모트, CI, 그리고 앱 게시.
+ </Card>
+</CardGroup>
diff --git a/packages/twenty-docs/l/ko/developers/extend/apps/getting-started/scaffolding.mdx b/packages/twenty-docs/l/ko/developers/extend/apps/getting-started/scaffolding.mdx
new file mode 100644
index 00000000000..87de2f32913
--- /dev/null
+++ b/packages/twenty-docs/l/ko/developers/extend/apps/getting-started/scaffolding.mdx
@@ -0,0 +1,58 @@
+---
+title: 스캐폴딩
+description: "`yarn twenty dev:add`를 사용해 엔티티 파일을 대화형으로 생성하여 객체, 필드, 뷰, 로직 함수 등을 추가하세요."
+icon: wand-magic-sparkles
+---
+
+엔티티 파일을 수동으로 만드는 대신, 대화형 스캐폴더를 사용하세요:
+
+```bash filename="Terminal"
+yarn twenty dev:add
+```
+
+이 도구는 엔티티 유형을 선택하도록 안내하고, 필요한 필드를 하나씩 진행한 다음, 안정적인 `universalIdentifier`와 올바른 `defineEntity()` 호출이 포함된 바로 사용할 수 있는 파일을 생성합니다.
+
+첫 번째 프롬프트를 건너뛰려면 엔티티 타입을 직접 전달할 수도 있습니다:
+
+```bash filename="Terminal"
+yarn twenty dev:add object
+yarn twenty dev:add logicFunction
+yarn twenty dev:add frontComponent
+```
+
+## 사용 가능한 엔티티 타입
+
+| 엔티티 유형 | 명령 | 생성된 파일 |
+| ----------- | ---------------------------------------- | ------------------------------------------------------- |
+| 객체 | `yarn twenty dev:add object` | `src/objects/\<name>.ts` |
+| 필드 | `yarn twenty dev:add field` | `src/fields/\<name>.ts` |
+| 로직 함수 | `yarn twenty dev:add logicFunction` | `src/logic-functions/\<name>.ts` |
+| 프런트 컴포넌트 | `yarn twenty dev:add frontComponent` | `src/front-components/\<name>.tsx` |
+| 역할 | `yarn twenty dev:add role` | `src/roles/\<name>.ts` |
+| 스킬 | `yarn twenty dev:add skill` | `src/skills/\<name>.ts` |
+| 에이전트 | `yarn twenty dev:add agent` | `src/agents/\<name>.ts` |
+| 뷰 | `yarn twenty dev:add view` | `src/views/\<name>.ts` |
+| 내비게이션 메뉴 항목 | `yarn twenty dev:add navigationMenuItem` | `src/navigation-menu-items/\<name>.ts` |
+| 페이지 레이아웃 | `yarn twenty dev:add pageLayout` | `src/page-layouts/\<name>.ts` |
+
+## 스캐폴더가 생성하는 것
+
+각 엔티티 타입은 자체 템플릿을 가집니다. 예를 들어, `yarn twenty dev:add object`는 다음을 묻습니다:
+
+1. **이름(단수)** — 예: `invoice`
+2. **이름(복수)** — 예: `invoices`
+3. **레이블(단수)** — 이름에서 자동으로 채워짐(예: `Invoice`)
+4. **레이블(복수)** — 자동으로 채워짐(예: `Invoices`)
+5. **뷰와 내비게이션 항목을 생성할까요?** — 예라고 답하면, 스캐폴더가 새 객체에 대한 일치하는 뷰와 사이드바 링크도 생성합니다.
+
+다른 엔티티 타입은 더 단순한 프롬프트를 사용하며 — 대부분 이름만 묻습니다.
+
+`field` 엔티티 타입은 더 자세합니다: 필드 이름, 레이블, 타입( `TEXT`, `NUMBER`, `SELECT`, `RELATION` 등 사용 가능한 모든 필드 타입 목록에서 선택), 그리고 대상 객체의 `universalIdentifier`를 묻습니다.
+
+## 사용자 지정 출력 경로
+
+`--path` 플래그를 사용해 생성된 파일을 사용자 지정 위치에 배치하세요:
+
+```bash filename="Terminal"
+yarn twenty dev:add logicFunction --path src/custom-folder
+```
diff --git a/packages/twenty-docs/l/ko/developers/extend/apps/getting-started/troubleshooting.mdx b/packages/twenty-docs/l/ko/developers/extend/apps/getting-started/troubleshooting.mdx
new file mode 100644
index 00000000000..6fd11094311
--- /dev/null
+++ b/packages/twenty-docs/l/ko/developers/extend/apps/getting-started/troubleshooting.mdx
@@ -0,0 +1,14 @@
+---
+title: 문제 해결
+description: 일반적인 첫 실행 문제 — Docker, Node 버전, Yarn, 의존성.
+icon: wrench
+---
+
+* **Docker 오류** — `yarn twenty docker:start`를 실행하기 전에 Docker Desktop(또는 데몬)이 실행 중인지 확인하세요. 오류 메시지에 OS에 맞는 올바른 시작 명령이 표시됩니다.
+* **Node 버전 오류** — 24 이상 필요. `node -v`로 확인하세요.
+* **Yarn 4 누락** — `corepack enable`을 실행하세요.
+* **의존성 문제** — `rm -rf node_modules && yarn install`.
+* **`twenty-sdk` v2.8.0으로 업그레이드한 후 오류 발생** — v2.8.0에서 `dependencies`에서 `devDependencies`로 이동했습니다. [프로젝트 구조 → Dependencies](/l/ko/developers/extend/apps/getting-started/project-structure#dependencies)를 참조하세요.
+* **`twenty build`는 `dependencies` 아래의 `twenty-client-sdk`에 대해 경고합니다** — 이는 실행 시 Twenty에서 제공되므로, `twenty-sdk`와 함께 `devDependencies`로 옮겨야 합니다. [프로젝트 구조 → Dependencies](/l/ko/developers/extend/apps/getting-started/project-structure#dependencies)를 참조하세요.
+
+막히셨나요? [Twenty Discord](https://discord.com/channels/1130383047699738754/1130386664812982322)에서 문의하세요.
diff --git a/packages/twenty-docs/l/ko/developers/extend/apps/layout/command-menu-items.mdx b/packages/twenty-docs/l/ko/developers/extend/apps/layout/command-menu-items.mdx
new file mode 100644
index 00000000000..081a5223b13
--- /dev/null
+++ b/packages/twenty-docs/l/ko/developers/extend/apps/layout/command-menu-items.mdx
@@ -0,0 +1,148 @@
+---
+title: 명령 메뉴 항목
+description: 프런트 컴포넌트를 빠른 작업 및 명령 메뉴(Cmd+K) 항목으로 노출하려면 `defineCommandMenuItem`을 사용합니다.
+icon: 터미널
+---
+
+**명령 메뉴 항목**은 사용자와 [프런트 컴포넌트](/l/ko/developers/extend/apps/layout/front-components) 사이를 연결하는 다리입니다. 이 항목은 Twenty의 명령 메뉴(Cmd+K)에 구성 요소를 등록하고, 선택적으로 페이지 오른쪽 상단 모서리에 고정된 빠른 작업 버튼으로도 등록합니다.
+
+```ts src/command-menu-items/open-dashboard.command-menu-item.ts
+import { defineCommandMenuItem } from 'twenty-sdk/define';
+
+export default defineCommandMenuItem({
+ universalIdentifier: 'a1b2c3d4-e5f6-7890-abcd-ef1234567890',
+ label: 'Open Dashboard',
+ shortLabel: 'Dashboard',
+ icon: 'IconLayoutDashboard',
+ isPinned: true,
+ availabilityType: 'GLOBAL',
+ frontComponentUniversalIdentifier: '74c526eb-cb68-4cf7-b05c-0dd8c288d948',
+});
+```
+
+## 구성 필드
+
+| 필드 | 필수 | 설명 |
+| --------------------------------------- | --- | ---------------------------------------------------------------------------------------------------------- |
+| `universalIdentifier` | 예 | 명령의 안정적인 고유 ID |
+| `label` | 예 | 명령 메뉴(Cmd+K)에 표시되는 전체 레이블 |
+| `frontComponentUniversalIdentifier` | 예 | 이 명령으로 열리는 프런트 컴포넌트의 `universalIdentifier` |
+| `shortLabel` | 아니요 | 고정된 빠른 작업 버튼에 표시되는 더 짧은 레이블 |
+| `icon` | 아니요 | 레이블 옆에 표시되는 아이콘 이름(예: `'IconBolt'`, `'IconSend'`) |
+| `isPinned` | 아니요 | `true`이면 페이지 우측 상단에 빠른 작업 버튼으로 명령을 표시합니다 |
+| `availabilityType` | 아니요 | 명령이 표시되는 위치를 제어합니다: 'GLOBAL'(항상 사용 가능), 'RECORD_SELECTION'(레코드가 선택된 경우에만), 'FALLBACK'(다른 명령이 일치하지 않을 때 표시) |
+| `availabilityObjectUniversalIdentifier` | 아니요 | 명령을 특정 객체 타입의 페이지로 제한합니다(예: Company 레코드에서만) |
+| `conditionalAvailabilityExpression` | 아니요 | 표시 여부를 동적으로 제어하는 불리언 표현식(아래 참조) |
+
+## 헤드리스 명령
+
+[헤드리스 프런트 컴포넌트](/l/ko/developers/extend/apps/layout/front-components#headless-vs-non-headless)와 짝을 이룬 명령 메뉴 항목은 원클릭 작업—코드 실행, 이동, 확인 후 실행—을 제공하는 가장 전형적인 방식입니다. 프런트 컴포넌트 페이지에서는 동작 후 언마운트 패턴을 처리하는 [SDK Command 구성 요소](/l/ko/developers/extend/apps/layout/front-components#sdk-command-components) (`Command`, `CommandLink`, `CommandModal`, `CommandOpenSidePanelPage`)를 다룹니다.
+
+일반적인 흐름:
+
+```tsx src/front-components/run-action.tsx
+import { defineFrontComponent } from 'twenty-sdk/define';
+import { Command } from 'twenty-sdk/command';
+import { CoreApiClient } from 'twenty-sdk/clients';
+
+const RunAction = () => {
+ const execute = async () => {
+ const client = new CoreApiClient();
+ await client.mutation({
+ createTask: {
+ __args: { data: { title: 'Created by my app' } },
+ id: true,
+ },
+ });
+ };
+
+ return <Command execute={execute} />;
+};
+
+export default defineFrontComponent({
+ universalIdentifier: 'e5f6a7b8-c9d0-1234-efab-345678901234',
+ name: 'run-action',
+ description: 'Creates a task from the command menu',
+ component: RunAction,
+ isHeadless: true,
+});
+```
+
+```ts src/command-menu-items/run-action.command-menu-item.ts
+import { defineCommandMenuItem } from 'twenty-sdk/define';
+
+export default defineCommandMenuItem({
+ universalIdentifier: 'f6a7b8c9-d0e1-2345-fabc-456789012345',
+ label: 'Run my action',
+ icon: 'IconPlayerPlay',
+ frontComponentUniversalIdentifier: 'e5f6a7b8-c9d0-1234-efab-345678901234',
+});
+```
+
+## 조건부 가용성 표현식
+
+`conditionalAvailabilityExpression` 필드를 사용하면 현재 페이지 컨텍스트에 따라 명령의 표시 시점을 제어할 수 있습니다. 표현식을 만들기 위해 `twenty-sdk`에서 타입이 지정된 변수와 연산자를 임포트하세요:
+
+```ts src/command-menu-items/bulk-update.command-menu-item.ts
+import {
+ defineCommandMenuItem,
+ objectPermissions,
+ everyEquals,
+} from 'twenty-sdk/define';
+
+export default defineCommandMenuItem({
+ universalIdentifier: '...',
+ label: 'Bulk Update',
+ availabilityType: 'RECORD_SELECTION',
+ frontComponentUniversalIdentifier: '...',
+ conditionalAvailabilityExpression: everyEquals(
+ objectPermissions,
+ 'canUpdateObjectRecords',
+ true,
+ ),
+});
+```
+
+<Note>
+ `RECORD_SELECTION`은 이미 비어 있지 않은 선택을 의미하므로, 특정 개수를 나타낼 때만(예: `>= 2`) `numberOfSelectedRecords`를 사용하세요.
+</Note>
+
+### 컨텍스트 변수
+
+이는 현재 페이지의 상태를 나타냅니다:
+
+| 변수 | 유형 | 설명 |
+| ------------------------------ | --------- | ------------------------------------------------- |
+| `pageType` | `string` | 현재 페이지 타입(예: 'RecordIndexPage', 'RecordShowPage') |
+| `isInSidePanel` | `boolean` | 컴포넌트가 사이드 패널에서 렌더링되는지 여부 |
+| `numberOfSelectedRecords` | `number` | 현재 선택된 레코드 수 |
+| `isSelectAll` | `boolean` | "전체 선택"이 활성화되었는지 여부 |
+| `selectedRecords` | `array` | 선택된 레코드 객체 |
+| `favoriteRecordIds` | `array` | 즐겨찾기된 레코드의 ID들 |
+| `objectPermissions` | `object` | 현재 객체 타입에 대한 권한 |
+| `targetObjectReadPermissions` | `object` | 대상 객체에 대한 읽기 권한 |
+| `targetObjectWritePermissions` | `object` | 대상 객체에 대한 쓰기 권한 |
+| `featureFlags` | `object` | 활성화된 기능 플래그 |
+| `objectMetadataItem` | `object` | 현재 객체 타입의 메타데이터 |
+| `hasAnySoftDeleteFilterOnView` | `boolean` | 현재 뷰에 소프트 삭제 필터가 있는지 여부 |
+
+### 연산자
+
+변수를 결합해 불리언 표현식을 만듭니다:
+
+| 연산자 | 설명 |
+| ----------------------------------- | --------------------------------------- |
+| `isDefined(value)` | 값이 null/undefined가 아니면 `true` |
+| `isNonEmptyString(value)` | 값이 비어 있지 않은 문자열이면 `true` |
+| `includes(array, value)` | 배열에 해당 값이 포함되어 있으면 `true` |
+| `includesEvery(array, prop, value)` | 모든 항목의 속성에 해당 값이 포함되어 있으면 `true` |
+| `every(array, prop)` | 모든 항목에서 해당 속성이 truthy이면 `true` |
+| `everyDefined(array, prop)` | 모든 항목에서 해당 속성이 정의되어 있으면 `true` |
+| `everyEquals(array, prop, value)` | 모든 항목에서 해당 속성이 그 값과 같으면 `true` |
+| `some(array, prop)` | 적어도 한 항목에서 해당 속성이 truthy이면 `true` |
+| `someDefined(array, prop)` | 적어도 한 항목에서 해당 속성이 정의되어 있으면 `true` |
+| `someEquals(array, prop, value)` | 적어도 한 항목에서 해당 속성이 그 값과 같으면 `true` |
+| `someNonEmptyString(array, prop)` | 적어도 한 항목에서 해당 속성이 비어 있지 않은 문자열이면 `true` |
+| `none(array, prop)` | 모든 항목에서 해당 속성이 falsy이면 `true` |
+| `noneDefined(array, prop)` | 모든 항목에서 해당 속성이 정의되지 않았으면 `true` |
+| `noneEquals(array, prop, value)` | 어떤 항목에서도 해당 속성이 그 값과 같지 않으면 `true` |
diff --git a/packages/twenty-docs/l/ko/developers/extend/apps/layout/front-components.mdx b/packages/twenty-docs/l/ko/developers/extend/apps/layout/front-components.mdx
new file mode 100644
index 00000000000..6a41c3972fd
--- /dev/null
+++ b/packages/twenty-docs/l/ko/developers/extend/apps/layout/front-components.mdx
@@ -0,0 +1,545 @@
+---
+title: 프런트 컴포넌트
+description: Twenty의 UI 내부에서 샌드박스 환경으로 격리된 채 렌더링되는 React 컴포넌트를 빌드하세요.
+icon: window-maximize
+---
+
+프런트 컴포넌트는 Twenty의 UI 내부에서 직접 렌더링되는 React 컴포넌트입니다. 이들은 Remote DOM을 사용하는 격리된 Web Worker에서 실행됩니다 — 코드는 샌드박스 처리되지만 iframe이 아닌 페이지 내에서 네이티브로 렌더링됩니다.
+
+## 프런트 컴포넌트를 사용할 수 있는 위치
+
+프런트 컴포넌트는 Twenty 내에서 두 위치에 렌더링될 수 있습니다:
+
+* **사이드 패널** — 비헤드리스 프런트 컴포넌트는 오른쪽 사이드 패널에서 열립니다. 이는 명령 메뉴에서 프런트 컴포넌트를 트리거할 때의 기본 동작입니다.
+* **위젯(대시보드 및 레코드 페이지)** — 프런트 컴포넌트를 [페이지 레이아웃](/l/ko/developers/extend/apps/layout/page-layouts) 내 위젯으로 삽입할 수 있습니다. 대시보드 또는 레코드 페이지 레이아웃을 구성할 때 사용자는 프런트 컴포넌트 위젯을 추가할 수 있습니다.
+
+프런트 컴포넌트만으로는 UI에서 직접 접근할 수 없으므로 *표시*해야 합니다. 이를 수행하는 두 가지 방법은 다음과 같습니다.
+
+* **[명령 메뉴 항목](/l/ko/developers/extend/apps/layout/command-menu-items)과 연결** — 명령 메뉴(Cmd+K)에 등록하고, 선택적으로 고정된 빠른 작업으로 등록합니다.
+* **[페이지 레이아웃](/l/ko/developers/extend/apps/layout/page-layouts)에 위젯으로 포함** — 레코드 상세 페이지 또는 대시보드에 배치합니다.
+
+## 기본 예제
+
+프런트 컴포넌트가 실제로 동작하는 모습을 가장 빨리 확인하는 방법은 [`defineCommandMenuItem`](/l/ko/developers/extend/apps/layout/command-menu-items)과 연결하여 페이지 오른쪽 상단에 빠른 작업 버튼으로 표시되게 하는 것입니다.
+
+```tsx src/front-components/hello-world.tsx
+import { defineFrontComponent } from 'twenty-sdk/define';
+
+const HelloWorld = () => {
+ return (
+ <div style={{ padding: '20px', fontFamily: 'sans-serif' }}>
+ <h1>Hello from my app!</h1>
+ <p>This component renders inside Twenty.</p>
+ </div>
+ );
+};
+
+export default defineFrontComponent({
+ universalIdentifier: '74c526eb-cb68-4cf7-b05c-0dd8c288d948',
+ name: 'hello-world',
+ description: 'A simple front component',
+ component: HelloWorld,
+});
+```
+
+```ts src/command-menu-items/hello-world.command-menu-item.ts
+import { defineCommandMenuItem } from 'twenty-sdk/define';
+
+export default defineCommandMenuItem({
+ universalIdentifier: 'd4e5f6a7-b8c9-0123-defa-456789012345',
+ shortLabel: 'Hello',
+ label: 'Hello World',
+ icon: 'IconBolt',
+ isPinned: true,
+ availabilityType: 'GLOBAL',
+ frontComponentUniversalIdentifier: '74c526eb-cb68-4cf7-b05c-0dd8c288d948',
+});
+```
+
+`yarn twenty dev`로 동기화한 후(또는 일회성으로 `yarn twenty dev --once`를 실행한 경우), 페이지 우측 상단에 빠른 작업이 표시됩니다:
+
+<div style={{textAlign: 'center'}}>
+ <img src="/images/docs/developers/extends/apps/quick-action.png" alt="우측 상단의 빠른 작업 버튼" />
+</div>
+
+클릭하면 컴포넌트를 인라인으로 렌더링합니다.
+
+## 구성 필드
+
+| 필드 | 필수 | 설명 |
+| --------------------- | --- | -------------------------------------- |
+| `universalIdentifier` | 예 | 이 컴포넌트의 안정적인 고유 ID |
+| `component` | 예 | React 컴포넌트 함수 |
+| `name` | 아니요 | 표시 이름 |
+| `description` | 아니요 | 컴포넌트가 수행하는 작업에 대한 설명 |
+| `isHeadless` | 아니요 | 컴포넌트에 보이는 UI가 없다면 `true`로 설정하세요(아래 참조) |
+
+## 프런트 컴포넌트를 페이지에 배치하기
+
+명령 외에도, 페이지 레이아웃에 위젯으로 추가하여 레코드 페이지에 프런트 컴포넌트를 직접 임베드할 수 있습니다. 자세한 내용은 [페이지 레이아웃](/l/ko/developers/extend/apps/layout/page-layouts)을 참조하세요.
+
+## 헤드리스 vs 비헤드리스
+
+프런트 컴포넌트는 `isHeadless` 옵션으로 제어되는 두 가지 렌더링 모드를 제공합니다:
+
+**비헤드리스(기본값)** — 컴포넌트가 가시적인 UI를 렌더링합니다. 명령 메뉴에서 트리거되면 사이드 패널에서 열립니다. `isHeadless`가 `false`이거나 생략된 경우의 기본 동작입니다.
+
+**헤드리스 (`isHeadless: true`)** — 컴포넌트가 백그라운드에서 보이지 않게 마운트됩니다. 사이드 패널을 열지 않습니다. 헤드리스 컴포넌트는 로직을 실행한 뒤 스스로 언마운트하는 작업에 맞게 설계되었습니다 — 예: 비동기 작업 실행, 페이지로 이동, 확인 모달 표시. 아래에 설명된 SDK Command 컴포넌트와 자연스럽게 짝을 이룹니다.
+
+```tsx src/front-components/sync-tracker.tsx
+import { defineFrontComponent } from 'twenty-sdk/define';
+import { useRecordId, enqueueSnackbar } from 'twenty-sdk/front-component';
+import { useEffect } from 'react';
+
+const SyncTracker = () => {
+ const recordId = useRecordId();
+
+ useEffect(() => {
+ enqueueSnackbar({ message: `Tracking record ${recordId}`, variant: 'info' });
+ }, [recordId]);
+
+ return null;
+};
+
+export default defineFrontComponent({
+ universalIdentifier: '...',
+ name: 'sync-tracker',
+ description: 'Tracks record views silently',
+ isHeadless: true,
+ component: SyncTracker,
+});
+```
+
+컴포넌트가 `null`을 반환하기 때문에, Twenty는 해당 컴포넌트에 대한 컨테이너 렌더링을 생략합니다 — 레이아웃에 빈 공간이 생기지 않습니다. 컴포넌트는 여전히 모든 훅과 호스트 통신 API에 접근할 수 있습니다.
+
+## SDK Command 컴포넌트
+
+`twenty-sdk` 패키지는 헤드리스 프런트 컴포넌트를 위해 설계된 네 가지 Command 헬퍼 컴포넌트를 제공합니다. 각 컴포넌트는 마운트 시 동작을 실행하고, 스낵바 알림을 표시하여 오류를 처리하며, 완료되면 프런트 컴포넌트를 자동으로 언마운트합니다.
+
+`twenty-sdk/command`에서 임포트하세요:
+
+* **`Command`** — `execute` prop을 통해 비동기 콜백을 실행합니다.
+* **`CommandLink`** — 앱 경로로 이동합니다. Props: `to`, `params`, `queryParams`, `options`.
+* **`CommandModal`** — 확인 모달을 엽니다. 사용자가 확인하면 `execute` 콜백을 실행합니다. Props: `title`, `subtitle`, `execute`, `confirmButtonText`, `confirmButtonAccent`.
+* **`CommandOpenSidePanelPage`** — 특정 사이드 패널 페이지를 엽니다. Props: `page`, `pageTitle`, `pageIcon`.
+
+`Command`를 사용해 명령 메뉴에서 동작을 실행하는 헤드리스 프런트 컴포넌트의 전체 예시는 다음과 같습니다:
+
+```tsx src/front-components/run-action.tsx
+import { defineFrontComponent } from 'twenty-sdk/define';
+import { Command } from 'twenty-sdk/command';
+import { CoreApiClient } from 'twenty-sdk/clients';
+
+const RunAction = () => {
+ const execute = async () => {
+ const client = new CoreApiClient();
+
+ await client.mutation({
+ createTask: {
+ __args: { data: { title: 'Created by my app' } },
+ id: true,
+ },
+ });
+ };
+
+ return <Command execute={execute} />;
+};
+
+export default defineFrontComponent({
+ universalIdentifier: 'e5f6a7b8-c9d0-1234-efab-345678901234',
+ name: 'run-action',
+ description: 'Creates a task from the command menu',
+ component: RunAction,
+ isHeadless: true,
+});
+```
+
+```ts src/command-menu-items/run-action.command-menu-item.ts
+import { defineCommandMenuItem } from 'twenty-sdk/define';
+
+export default defineCommandMenuItem({
+ universalIdentifier: 'f6a7b8c9-d0e1-2345-fabc-456789012345',
+ label: 'Run my action',
+ icon: 'IconPlayerPlay',
+ frontComponentUniversalIdentifier: 'e5f6a7b8-c9d0-1234-efab-345678901234',
+});
+```
+
+그리고 실행 전에 확인을 요청하기 위해 `CommandModal`을 사용하는 예시는 다음과 같습니다:
+
+```tsx src/front-components/delete-draft.tsx
+import { defineFrontComponent } from 'twenty-sdk/define';
+import { CommandModal } from 'twenty-sdk/command';
+
+const DeleteDraft = () => {
+ const execute = async () => {
+ // perform the deletion
+ };
+
+ return (
+ <CommandModal
+ title="Delete draft?"
+ subtitle="This action cannot be undone."
+ execute={execute}
+ confirmButtonText="Delete"
+ confirmButtonAccent="danger"
+ />
+ );
+};
+
+export default defineFrontComponent({
+ universalIdentifier: 'a7b8c9d0-e1f2-3456-abcd-567890123456',
+ name: 'delete-draft',
+ description: 'Deletes a draft with confirmation',
+ component: DeleteDraft,
+ isHeadless: true,
+});
+```
+
+## 로직 함수 호출하기
+
+Front 컴포넌트는 샌드박스된 Web Worker 안에서 브라우저 측에서 실행되고, [logic functions](/l/ko/developers/extend/apps/logic/logic-functions)는 서버 측에서 실행됩니다. 두 요소 사이에는 프로세스 내에서의 직접 호출이 없습니다. 대신, Front 컴포넌트는 HTTP를 통해 로직 함수에 접근합니다.
+
+`httpRouteTriggerSettings`로 선언된 로직 함수는 `${TWENTY_API_URL}/s\<path>`의 `/s/` 엔드포인트 아래에 노출됩니다. 여러분의 Front 컴포넌트는 `twenty-client-sdk/rest`의 `RestApiClient`를 사용해 해당 라우트를 호출하며, Twenty가 워커에 주입하는 `TWENTY_APP_ACCESS_TOKEN`으로 인증합니다.
+
+`RestApiClient`는 바로 이런 용도로 설계되었습니다. 이는 워커 환경에서 `TWENTY_API_URL`과 `TWENTY_APP_ACCESS_TOKEN`을 읽어 `Authorization: Bearer` 헤더를 추가하고, JSON을 직렬화 및 파싱하며, 토큰이나 URL이 없거나 응답이 2xx가 아닐 경우 `RestApiClientError`를 발생시켜, 여러분이 각 컴포넌트마다 이러한 보일러플레이트를 다시 구현하지 않아도 되도록 해 줍니다.
+
+헤드리스 Front 컴포넌트는 `Command` 컴포넌트를 통해 마운트 시점에 호출을 실행한 뒤, 자동으로 언마운트될 수 있습니다:
+
+```tsx src/front-components/sync-prs.tsx
+import { defineFrontComponent } from 'twenty-sdk/define';
+import { Command } from 'twenty-sdk/command';
+import { RestApiClient } from 'twenty-client-sdk/rest';
+
+const SyncPrs = () => {
+ const execute = async () => {
+ const client = new RestApiClient();
+
+ await client.post('/s/github/fetch-prs', {
+ owner: 'twentyhq',
+ repo: 'twenty',
+ });
+ };
+
+ return <Command execute={execute} />;
+};
+
+export default defineFrontComponent({
+ universalIdentifier: '...',
+ name: 'sync-prs',
+ description: 'Triggers the fetch-prs logic function',
+ isHeadless: true,
+ component: SyncPrs,
+});
+```
+
+클라이언트에 전달되는 경로는 라우트의 public 경로이며, 로직 함수의 `httpRouteTriggerSettings.path` 앞에 `/s`가 접두사로 붙습니다. `isAuthRequired: true`를 유지하세요. 클라이언트가 컴포넌트용으로 Twenty가 발행한 앱 액세스 토큰을 제공합니다:
+
+```ts src/logic-functions/fetch-prs.logic-function.ts
+import { defineLogicFunction } from 'twenty-sdk/define';
+import type { RoutePayload } from 'twenty-sdk/logic-function';
+
+const handler = async (event: RoutePayload) => {
+ const { owner, repo } = (event.body ?? {}) as { owner: string; repo: string };
+ // ...fetch from GitHub and persist records...
+ return { ok: true };
+};
+
+export default defineLogicFunction({
+ universalIdentifier: '...',
+ name: 'fetch-prs',
+ handler,
+ httpRouteTriggerSettings: {
+ path: '/github/fetch-prs',
+ httpMethod: 'POST',
+ isAuthRequired: true,
+ },
+});
+```
+
+<Note>
+`TWENTY_API_URL`과 `TWENTY_APP_ACCESS_TOKEN`은 자동으로 주입됩니다. 자세한 내용은 [Application variables](#application-variables)을 참고하세요. 비밀 애플리케이션 변수는 Front 컴포넌트에 절대 노출되지 않으므로, API 키 및 기타 민감한 로직은 Front 컴포넌트가 아니라 로직 함수 안에 유지해야 합니다.
+</Note>
+
+### RestApiClient 레퍼런스
+
+`RestApiClient`를 `twenty-client-sdk/rest`에서 import하세요. 이는 `CoreApiClient` 및 `MetadataApiClient`와 동일한 클라이언트 패밀리에 속하지만, GraphQL API 대신 앱의 HTTP 라우트를 대상으로 합니다.
+
+| 방법 | 설명 |
+| --------------------------------- | ------------------------------ |
+| `get(path, options?)` | `GET` 요청을 전송합니다. |
+| `post(path, body?, options?)` | `POST` 요청을 전송합니다. |
+| `put(path, body?, options?)` | `PUT` 요청을 전송합니다. |
+| `patch(path, body?, options?)` | `PATCH` 요청을 전송합니다. |
+| `delete(path, options?)` | `DELETE` 요청을 전송합니다. |
+| `request(method, path, options?)` | 임의의 HTTP 메서드를 사용하는 일반적인 요청입니다. |
+
+`options`는 `headers`, `query`(쿼리 문자열 파라미터의 레코드이며, nullish 값은 건너뜁니다), 그리고 `signal`을 통한 `AbortSignal`을 받습니다. `FormData`가 아닌 객체 `body`는 자동으로 JSON 직렬화됩니다. `401`이 발생하면 클라이언트는 호스트를 통해 한 번 액세스 토큰을 갱신한 뒤 요청을 재시도합니다.
+
+기본 URL과 토큰은 기본적으로 환경에서 자동으로 결정됩니다. 테스트 등에서 필요할 때는 생성자에 override를 전달하세요. 예를 들면 다음과 같습니다:
+
+```ts
+const client = new RestApiClient({
+ baseUrl: 'https://api.example.com',
+ token: 'my-token',
+});
+```
+
+실패한 요청은 `status`, `statusText`, `url`, 파싱된 `body`를 노출하는 `RestApiClientError`를 throw합니다:
+
+```tsx
+import { RestApiClient, RestApiClientError } from 'twenty-client-sdk/rest';
+
+const client = new RestApiClient();
+
+try {
+ const prs = await client.get('/s/github/fetch-prs', {
+ query: { state: 'open' },
+ });
+} catch (error) {
+ if (error instanceof RestApiClientError) {
+ console.error(error.status, error.body);
+ }
+}
+```
+
+## 런타임 컨텍스트에 접근하기
+
+컴포넌트 내부에서, 현재 사용자, 레코드, 컴포넌트 인스턴스에 접근하려면 SDK 훅을 사용하세요:
+
+```tsx src/front-components/record-info.tsx
+import { defineFrontComponent } from 'twenty-sdk/define';
+import {
+ useUserId,
+ useRecordId,
+ useFrontComponentId,
+} from 'twenty-sdk/front-component';
+
+const RecordInfo = () => {
+ const userId = useUserId();
+ const recordId = useRecordId();
+ const componentId = useFrontComponentId();
+
+ return (
+ <div>
+ <p>User: {userId}</p>
+ <p>Record: {recordId ?? 'No record context'}</p>
+ <p>Component: {componentId}</p>
+ </div>
+ );
+};
+
+export default defineFrontComponent({
+ universalIdentifier: 'b2c3d4e5-f6a7-8901-bcde-f23456789012',
+ name: 'record-info',
+ component: RecordInfo,
+});
+```
+
+사용 가능한 훅:
+
+| 훅 | 반환값 | 설명 |
+| --------------------------------------------- | --------------------- | ---------------------------------------------- |
+| `useUserId()` | `string` 또는 `null` | 현재 사용자의 ID |
+| `useSelectedRecordIds()` | `string[]` | 선택된 모든 기록 ID(선택된 기록이 없으면 빈 배열) |
+| `useRecordId()` | `string` 또는 `null` | **사용 중단됨.** 대신 `useSelectedRecordIds()`를 사용하세요 |
+| `useFrontComponentId()` | `string` | 이 컴포넌트 인스턴스의 ID |
+| `useColorScheme()` | `'light'` 또는 `'dark'` | 호스트 UI의 활성 색 구성표 (`System`은 이미 결정됨) |
+| `useFrontComponentExecutionContext(selector)` | 항목에 따라 다름 | 셀렉터 함수를 사용해 전체 실행 컨텍스트에 접근 |
+
+## 애플리케이션 변수
+
+[`defineApplication()`](/l/ko/developers/extend/apps/config/application)에서 `isSecret: false`로 정의된 애플리케이션 변수는 `getApplicationVariable` 유틸리티를 통해 프론트 컴포넌트 안에서 사용할 수 있습니다:
+
+```tsx src/front-components/greeting.tsx
+import { defineFrontComponent } from 'twenty-sdk/define';
+import { getApplicationVariable } from 'twenty-sdk/front-component';
+
+const Greeting = () => {
+ const recipientName = getApplicationVariable('DEFAULT_RECIPIENT_NAME') ?? 'World';
+
+ return <p>Hello, {recipientName}!</p>;
+};
+
+export default defineFrontComponent({
+ universalIdentifier: '...',
+ name: 'greeting',
+ component: Greeting,
+});
+```
+
+<Warning>
+비밀 변수(`isSecret: true`)는 프론트 컴포넌트에 **노출되지 않습니다**. 이 변수들은 서버 측에서 실행되는 [로직 함수](/l/ko/developers/extend/apps/logic/logic-functions)에서만 사용할 수 있습니다. 이는 API 키와 같은 민감한 값이 브라우저로 전송되는 것을 방지합니다.
+</Warning>
+
+다음 시스템 변수는 항상 `process.env`를 통해 사용할 수 있습니다:
+
+| 변수 | 설명 |
+| ------------------------- | ------------------------ |
+| `TWENTY_API_URL` | Twenty API의 기본 URL |
+| `TWENTY_APP_ACCESS_TOKEN` | 앱의 역할 범위로 제한된 단기간 유효한 토큰 |
+
+## 호스트 통신 API
+
+프런트 컴포넌트는 `twenty-sdk`의 함수를 사용해 내비게이션, 모달, 알림을 트리거할 수 있습니다:
+
+| 함수 | 설명 |
+| ----------------------------------------------- | ------------- |
+| `navigate(to, params?, queryParams?, options?)` | 앱 내 페이지로 이동 |
+| `openSidePanelPage(params)` | 사이드 패널 열기 |
+| `closeSidePanel()` | 사이드 패널을 닫습니다 |
+| `openCommandConfirmationModal(params)` | 확인 대화상자 표시 |
+| `enqueueSnackbar(params)` | 토스트 알림 표시 |
+| `unmountFrontComponent()` | 컴포넌트를 언마운트합니다 |
+| `updateProgress(progress)` | 진행률 표시기 업데이트 |
+
+호스트 API를 사용하여 동작이 완료된 후 스낵바를 표시하고 사이드 패널을 닫는 예시는 다음과 같습니다:
+
+```tsx src/front-components/archive-record.tsx
+import { defineFrontComponent } from 'twenty-sdk/define';
+import { useRecordId } from 'twenty-sdk/front-component';
+import { enqueueSnackbar, closeSidePanel } from 'twenty-sdk/front-component';
+import { CoreApiClient } from 'twenty-sdk/clients';
+
+const ArchiveRecord = () => {
+ const recordId = useRecordId();
+
+ const handleArchive = async () => {
+ const client = new CoreApiClient();
+
+ await client.mutation({
+ updateTask: {
+ __args: { id: recordId, data: { status: 'ARCHIVED' } },
+ id: true,
+ },
+ });
+
+ await enqueueSnackbar({
+ message: 'Record archived',
+ variant: 'success',
+ });
+
+ await closeSidePanel();
+ };
+
+ return (
+ <div style={{ padding: '20px' }}>
+ <p>Archive this record?</p>
+ <button onClick={handleArchive}>Archive</button>
+ </div>
+ );
+};
+
+export default defineFrontComponent({
+ universalIdentifier: 'c9d0e1f2-a3b4-5678-cdef-789012345678',
+ name: 'archive-record',
+ description: 'Archives the current record',
+ component: ArchiveRecord,
+});
+```
+
+### 여러 기록과의 작업
+
+여러 개의 선택된 기록을 처리하려면 `useSelectedRecordIds()`를 사용하세요. 이는 일괄 작업에 유용합니다:
+
+```tsx src/front-components/bulk-export.tsx
+import { defineFrontComponent, numberOfSelectedRecords } from 'twenty-sdk/define';
+import { useSelectedRecordIds } from 'twenty-sdk/front-component';
+import { enqueueSnackbar, closeSidePanel } from 'twenty-sdk/front-component';
+import { CoreApiClient } from 'twenty-sdk/clients';
+
+const BulkExport = () => {
+ const selectedRecordIds = useSelectedRecordIds();
+
+ const handleExport = async () => {
+ const client = new CoreApiClient();
+
+ for (const recordId of selectedRecordIds) {
+ await client.mutation({
+ updateTask: {
+ __args: { id: recordId, data: { exported: true } },
+ id: true,
+ },
+ });
+ }
+
+ await enqueueSnackbar({
+ message: `Exported ${selectedRecordIds.length} records`,
+ variant: 'success',
+ });
+
+ await closeSidePanel();
+ };
+
+ return (
+ <div style={{ padding: '20px' }}>
+ <p>Export {selectedRecordIds.length} selected record(s)?</p>
+ <button onClick={handleExport}>Export</button>
+ </div>
+ );
+};
+
+export default defineFrontComponent({
+ universalIdentifier: 'd0e1f2a3-b4c5-6789-defa-012345678901',
+ name: 'bulk-export',
+ description: 'Export selected records',
+ component: BulkExport,
+ command: {
+ universalIdentifier: 'd0e1f2a3-b4c5-6789-defa-012345678902',
+ label: 'Bulk Export',
+ availabilityType: 'RECORD_SELECTION',
+ conditionalAvailabilityExpression: numberOfSelectedRecords > 0,
+ },
+});
+```
+
+## 퍼블릭 에셋
+
+프런트 컴포넌트는 `getPublicAssetUrl`을 사용해 앱의 `public/` 디렉터리의 파일에 접근할 수 있습니다:
+
+```tsx
+import { defineFrontComponent } from 'twenty-sdk/define';
+import { getPublicAssetUrl } from 'twenty-sdk/utils';
+
+const Logo = () => <img src={getPublicAssetUrl('logo.png')} alt="Logo" />;
+
+export default defineFrontComponent({
+ universalIdentifier: '...',
+ name: 'logo',
+ component: Logo,
+});
+```
+
+자세한 내용은 [퍼블릭 에셋 섹션](/l/ko/developers/extend/apps/config/public-assets)을 참조하세요.
+
+## 스타일링
+
+프런트 컴포넌트는 여러 스타일링 방식을 지원합니다. 다음과 같은 방식을 사용할 수 있습니다:
+
+* **인라인 스타일** — `style={{ color: 'red' }}`
+* **Twenty UI 컴포넌트** — `twenty-sdk/ui`에서 임포트(버튼, 태그, 상태, 칩, 아바타 등)
+* **Emotion** — `@emotion/react`를 사용하는 CSS-in-JS
+* **Styled-components** — `styled.div` 패턴
+* **Tailwind CSS** — 유틸리티 클래스
+* React와 호환되는 **모든 CSS-in-JS 라이브러리**
+
+```tsx
+import { defineFrontComponent } from 'twenty-sdk/define';
+import { Button, Tag, Status } from 'twenty-sdk/ui';
+
+const StyledWidget = () => {
+ return (
+ <div style={{ padding: '16px', display: 'flex', gap: '8px' }}>
+ <Button title="Click me" onClick={() => alert('Clicked!')} />
+ <Tag text="Active" color="green" />
+ <Status color="green" text="Online" />
+ </div>
+ );
+};
+
+export default defineFrontComponent({
+ universalIdentifier: 'e5f6a7b8-c9d0-1234-efab-567890123456',
+ name: 'styled-widget',
+ component: StyledWidget,
+});
+```
diff --git a/packages/twenty-docs/l/ko/developers/extend/apps/layout/navigation-menu-items.mdx b/packages/twenty-docs/l/ko/developers/extend/apps/layout/navigation-menu-items.mdx
new file mode 100644
index 00000000000..24cf0d2871a
--- /dev/null
+++ b/packages/twenty-docs/l/ko/developers/extend/apps/layout/navigation-menu-items.mdx
@@ -0,0 +1,44 @@
+---
+title: 내비게이션 메뉴 항목
+description: 워크스페이스 사이드바에 사용자 지정 항목을 추가하여 저장된 보기나 외부 URL에 연결하세요.
+icon: bars
+---
+
+**내비게이션 메뉴 항목**은 왼쪽 사이드바의 항목입니다. `defineNavigationMenuItem()`을 사용해 사용자 지정 사이드바 링크를 추가하세요 — 일반적으로 배포하는 각 [보기](/l/ko/developers/extend/apps/layout/views)마다 하나씩 추가하거나 외부 URL을 가리키도록 설정합니다.
+
+```ts src/navigation-menu-items/example-navigation-menu-item.ts
+import { defineNavigationMenuItem, NavigationMenuItemType } from 'twenty-sdk/define';
+import { EXAMPLE_VIEW_UNIVERSAL_IDENTIFIER } from '../views/example-view';
+
+export default defineNavigationMenuItem({
+ universalIdentifier: '9327db91-afa1-41b6-bd9d-2b51a26efb4c',
+ name: 'example-navigation-menu-item',
+ icon: 'IconList',
+ color: 'blue',
+ position: 0,
+ type: NavigationMenuItemType.VIEW,
+ viewUniversalIdentifier: EXAMPLE_VIEW_UNIVERSAL_IDENTIFIER,
+});
+```
+
+## 핵심 요점
+
+* `type`은 메뉴 항목이 어디로 연결되는지를 결정합니다. 각 유형은 특정 식별자 필드와 짝을 이룹니다:
+
+ | 유형 | 하는 일 | 필수 필드 |
+ | ------------------------------------ | --------------------------- | -------------------------------------------------------------- |
+ | `NavigationMenuItemType.VIEW` | 저장된 보기를 엽니다 | `viewUniversalIdentifier` |
+ | `NavigationMenuItemType.LINK` | 외부 URL을 엽니다 | `link` |
+ | `NavigationMenuItemType.FOLDER` | 중첩된 항목들을 하나의 레이블 아래로 그룹화합니다 | `name` (그리고 하위 항목들은 `folderUniversalIdentifier`를 통해 폴더를 참조합니다) |
+ | `NavigationMenuItemType.OBJECT` | 오브젝트의 기본 인덱스 페이지를 엽니다 | `targetObjectUniversalIdentifier` |
+ | `NavigationMenuItemType.PAGE_LAYOUT` | 독립형 페이지 레이아웃을 엽니다 | `pageLayoutUniversalIdentifier` |
+
+* `position`은 사이드바에서의 정렬 순서를 제어합니다.
+
+* `icon`과 `color`는 선택 사항이며 항목의 표시 방식을 사용자 지정합니다.
+
+* `folderUniversalIdentifier`는 모든 항목에서 사용할 수 있으며, 이를 통해 해당 항목을 `FOLDER` 유형의 상위 항목 안에 중첩할 수 있습니다.
+
+<Note>
+**흔한 오류:** 연결된 보기와 내비게이션 메뉴 항목 없이 오브젝트를 생성하면 해당 오브젝트는 사용자에게 보이지 않습니다. 기술적/내부용 오브젝트가 아닌 한, 모든 사용자 지정 오브젝트에는 기본 보기와 이를 가리키는 사이드바 항목이 있어야 합니다.
+</Note>
diff --git a/packages/twenty-docs/l/ko/developers/extend/apps/layout/overview.mdx b/packages/twenty-docs/l/ko/developers/extend/apps/layout/overview.mdx
new file mode 100644
index 00000000000..c0f442ad1ab
--- /dev/null
+++ b/packages/twenty-docs/l/ko/developers/extend/apps/layout/overview.mdx
@@ -0,0 +1,56 @@
+---
+title: 개요
+description: Twenty의 UI에 앱을 배치하세요 — 사이드바 항목, 저장된 보기, 레코드 페이지 탭, 샌드박스된 React 컴포넌트.
+icon: table-columns
+---
+
+Twenty 앱의 **레이아웃 레이어**는 사용자가 보는 모든 것을 의미합니다. 앱이 사이드바 어디에 노출되는지, 어떤 목록 보기를 제공하는지, 레코드 상세 페이지가 어떻게 구성되는지, 그리고 어떤 커스텀 React 컴포넌트가 해당 페이지 내부에 렌더링되는지가 여기에 포함됩니다.
+
+```text
+ Sidebar Record list Record detail page
+ ─────── ─────────── ──────────────────
+ [📋 My View] ────▶ ┌──────────┐ ┌─────────────────────┐
+ [📋 Drafts ] │ Companies│ │ Tabs: [Overview ] │
+ [📋 Inbox ] │ ──────── │ │ [Notes ] │
+ ▲ │ Apple │ │ [Hello ]◀──── definePageLayoutTab
+ │ │ Acme │ │ │ adds a tab...
+ └ defineNavi- │ … │ │ ┌────────────────┐ │
+ gationMenu- └────▲─────┘ │ │ │ │
+ Item points │ │ │ React UI │◀── …with a
+ to a defineView │ │ │ (sandboxed in │ │ defineFrontComponent
+ └ defineView │ │ a Worker) │ │ widget inside
+ picks columns │ └────────────────┘ │
+ and filters └─────────────────────┘
+```
+
+## 이 섹션에서 다루는 내용
+
+<CardGroup cols={2}>
+ <Card title="보기" icon="list" href="/l/ko/developers/extend/apps/layout/views">
+ `defineView` — 표시 열, 필터, 그룹을 포함한 저장된 목록 구성입니다.
+ </Card>
+ <Card title="내비게이션 메뉴 항목" icon="bars" href="/l/ko/developers/extend/apps/layout/navigation-menu-items">
+ `defineNavigationMenuItem` — 보기 또는 외부 URL을 가리키는 사이드바 항목입니다.
+ </Card>
+ <Card title="페이지 레이아웃" icon="table-columns" href="/l/ko/developers/extend/apps/layout/page-layouts">
+ `definePageLayout` 및 `definePageLayoutTab` — 레코드 상세 페이지의 탭과 위젯을 정의합니다.
+ </Card>
+ <Card title="프런트 컴포넌트" icon="window-maximize" href="/l/ko/developers/extend/apps/layout/front-components">
+ `defineFrontComponent` — Twenty 내부에서 렌더링되는 샌드박스된 React 컴포넌트입니다.
+ </Card>
+ <Card title="명령 메뉴 항목" icon="터미널" href="/l/ko/developers/extend/apps/layout/command-menu-items">
+ `defineCommandMenuItem` — 프런트 컴포넌트를 Cmd+K 항목과 빠른 작업으로 등록합니다.
+ </Card>
+</CardGroup>
+
+## 앱이 노출되는 위치
+
+| 표시 위치 | 제어하는 항목 | 엔터티 |
+| ----------------- | --------------------------------------- | ----------------------------------------- |
+| **사이드바** | 저장된 보기 또는 외부 URL에 연결되는 커스텀 항목 | `defineNavigationMenuItem` |
+| **레코드 목록** | 오브젝트에 대한 저장된 구성 — 표시되는 열, 정렬 순서, 필터, 그룹 | `defineView` |
+| **레코드 상세 페이지** | 레코드 페이지(사용자 정의 오브젝트 또는 표준 오브젝트)의 탭과 위젯 | `definePageLayout`, `definePageLayoutTab` |
+| **위의 어느 위치 내부** | 커스텀 React 위젯 — 버튼, 폼, 대시보드, 통합 기능 | `defineFrontComponent` |
+| **명령 메뉴 (Cmd+K)** | 고정된 빠른 작업 또는 숨겨진 명령 | `defineCommandMenuItem` |
+
+프런트 컴포넌트는 Remote DOM을 사용하는 격리된 Web Worker 내부에서 실행됩니다. 이들은 페이지 안에서 네이티브하게 렌더링되지만(iframe 내부가 아님), 호스트 페이지나 DOM에 직접 접근할 수는 없습니다. Twenty와의 통신은 메시지 전달 호스트 API를 통해 이루어집니다.
diff --git a/packages/twenty-docs/l/ko/developers/extend/apps/layout/page-layouts.mdx b/packages/twenty-docs/l/ko/developers/extend/apps/layout/page-layouts.mdx
new file mode 100644
index 00000000000..3d869c674e2
--- /dev/null
+++ b/packages/twenty-docs/l/ko/developers/extend/apps/layout/page-layouts.mdx
@@ -0,0 +1,132 @@
+---
+title: 페이지 레이아웃
+description: "`definePageLayout` 및 `definePageLayoutTab`을 사용하여 레코드 상세 페이지의 탭, 위젯, 그리고 프런트 컴포넌트가 렌더링되는 위치를 사용자 지정합니다."
+icon: table-columns
+---
+
+**페이지 레이아웃**은 레코드의 상세 페이지가 어떻게 구성되는지를 제어합니다. 어떤 탭이 표시되고, 그 탭 안에 어떤 위젯이 포함되는지를 결정합니다. 소유한 객체에 대한 레이아웃을 선언하려면 `definePageLayout()`을 사용하고, 이미 존재하는 레이아웃(사용자 소유 또는 표준 Twenty 레이아웃)에 단일 탭을 추가하려면 `definePageLayoutTab()`을 사용합니다.
+
+| 사용 사례 | 엔터티 |
+| ---------------------------------------------------- | --------------------- |
+| 소유한 객체의 레코드 페이지에 대한 전체 레이아웃을 정의합니다. | `definePageLayout` |
+| 기존 레이아웃(자신이 소유한 객체의 레이아웃이든, 표준 레이아웃이든)에 탭 하나를 추가합니다. | `definePageLayoutTab` |
+
+## definePageLayout
+
+전체 상세 페이지를 소유할 때 사용합니다. 일반적으로 직접 정의한 사용자 지정 객체에 해당합니다.
+
+```ts src/page-layouts/example-record-page-layout.ts
+import { definePageLayout, PageLayoutTabLayoutMode } from 'twenty-sdk/define';
+import { EXAMPLE_OBJECT_UNIVERSAL_IDENTIFIER } from '../objects/example-object';
+import { HELLO_WORLD_FRONT_COMPONENT_UNIVERSAL_IDENTIFIER } from '../front-components/hello-world';
+
+export default definePageLayout({
+ universalIdentifier: '203aeb94-6701-46d6-9af1-be2bbcc9e134',
+ name: 'Example Record Page',
+ type: 'RECORD_PAGE',
+ objectUniversalIdentifier: EXAMPLE_OBJECT_UNIVERSAL_IDENTIFIER,
+ tabs: [
+ {
+ universalIdentifier: '6ed26b60-a51d-4ad7-86dd-1c04c7f3cac5',
+ title: 'Hello World',
+ position: 50,
+ icon: 'IconWorld',
+ layoutMode: PageLayoutTabLayoutMode.CANVAS,
+ widgets: [
+ {
+ universalIdentifier: 'aa4234e0-2e5f-4c02-a96a-573449e2351d',
+ title: 'Hello World',
+ type: 'FRONT_COMPONENT',
+ configuration: {
+ configurationType: 'FRONT_COMPONENT',
+ frontComponentUniversalIdentifier:
+ HELLO_WORLD_FRONT_COMPONENT_UNIVERSAL_IDENTIFIER,
+ },
+ },
+ ],
+ },
+ ],
+});
+```
+
+### 핵심 요점
+
+* `type`은 일반적으로 특정 객체의 상세 보기를 사용자 지정하기 위해 'RECORD_PAGE'입니다.
+* `objectUniversalIdentifier`는 이 레이아웃이 적용되는 객체를 지정합니다.
+* 각 `tab`은 `title`, `position`, `layoutMode`(`CANVAS`는 자유 형식 레이아웃)를 통해 페이지의 섹션을 정의합니다.
+* 탭 내부의 각 `widget`은 [front component](/l/ko/developers/extend/apps/layout/front-components), 관계 목록 또는 기타 기본 제공 위젯 타입을 렌더링할 수 있습니다.
+* 탭의 `position`은 탭의 순서를 제어합니다. 값을 더 높게 설정하면(예: 50) 기본 탭 뒤에 사용자 지정 탭을 배치할 수 있습니다.
+
+## definePageLayoutTab
+
+기존 레이아웃에 탭만 추가하려는 경우에 사용합니다. 예를 들어, 표준 Company 페이지에 분석 탭을 추가하거나, 자신이 소유한 객체의 레이아웃에 AI 요약 탭을 연결하는 경우입니다.
+
+```ts src/page-layouts/example-extra-tab.ts
+import {
+ definePageLayoutTab,
+ PageLayoutTabLayoutMode,
+ STANDARD_PAGE_LAYOUT_UNIVERSAL_IDENTIFIERS,
+} from 'twenty-sdk/define';
+import { HELLO_WORLD_FRONT_COMPONENT_UNIVERSAL_IDENTIFIER } from '../front-components/hello-world';
+
+export default definePageLayoutTab({
+ universalIdentifier: 'b1b2b3b4-b5b6-4000-8000-000000000001',
+ pageLayoutUniversalIdentifier:
+ STANDARD_PAGE_LAYOUT_UNIVERSAL_IDENTIFIERS.companyRecordPage
+ .universalIdentifier,
+ title: 'Hello World',
+ position: 1000,
+ icon: 'IconWorld',
+ layoutMode: PageLayoutTabLayoutMode.CANVAS,
+ widgets: [
+ {
+ universalIdentifier: 'b1b2b3b4-b5b6-4000-8000-000000000002',
+ title: 'Hello World',
+ type: 'FRONT_COMPONENT',
+ configuration: {
+ configurationType: 'FRONT_COMPONENT',
+ frontComponentUniversalIdentifier:
+ HELLO_WORLD_FRONT_COMPONENT_UNIVERSAL_IDENTIFIER,
+ },
+ },
+ ],
+});
+```
+
+### 핵심 요점
+
+* `pageLayoutUniversalIdentifier`는 **필수**이며, 설치 시점에 이미 존재하는 페이지 레이아웃을 가리켜야 합니다. 이는 표준 Twenty 레이아웃이거나, 사용자의 앱에서 정의한 레이아웃일 수 있습니다. 현재는 설치된 다른 앱이 소유한 레이아웃에 대한 크로스 앱 참조는 지원되지 않습니다. 상위 레이아웃이 없으면, 명확한 유효성 검사 오류와 함께 설치가 실패합니다.
+
+* 표준 Twenty 레이아웃의 경우 `twenty-sdk/define`에서 식별자를 가져옵니다:
+
+ ```ts
+ import { STANDARD_PAGE_LAYOUT_UNIVERSAL_IDENTIFIERS } from 'twenty-sdk/define';
+
+ // STANDARD_PAGE_LAYOUT_UNIVERSAL_IDENTIFIERS.companyRecordPage.universalIdentifier
+ // STANDARD_PAGE_LAYOUT_UNIVERSAL_IDENTIFIERS.personRecordPage.universalIdentifier
+ // STANDARD_PAGE_LAYOUT_UNIVERSAL_IDENTIFIERS.taskRecordPage.universalIdentifier
+ // STANDARD_PAGE_LAYOUT_UNIVERSAL_IDENTIFIERS.opportunityRecordPage.universalIdentifier
+ // STANDARD_PAGE_LAYOUT_UNIVERSAL_IDENTIFIERS.noteRecordPage.universalIdentifier
+ // …
+ ```
+
+ 각 레이아웃 항목은 `tabs`와 해당 `widgets`도 노출하므로, 모든 수준을 참조할 수 있습니다:
+
+ ```ts
+ STANDARD_PAGE_LAYOUT_UNIVERSAL_IDENTIFIERS.taskRecordPage.tabs.home.universalIdentifier
+ STANDARD_PAGE_LAYOUT_UNIVERSAL_IDENTIFIERS.taskRecordPage.tabs.home.widgets.fields.universalIdentifier
+ ```
+
+ 짧은 별칭인 `STANDARD_PAGE_LAYOUT`도 사용할 수 있습니다:
+
+ ```ts
+ import { STANDARD_PAGE_LAYOUT } from 'twenty-sdk/define';
+
+ STANDARD_PAGE_LAYOUT.companyRecordPage.universalIdentifier;
+ ```
+
+* `widgets`는 이 탭에만 범위가 국한됩니다. `definePageLayout`에 인라인으로 정의된 위젯과 완전히 동일한 방식으로 [front components](/l/ko/developers/extend/apps/layout/front-components), 뷰 등을 참조합니다.
+
+* `position`은 대상 레이아웃의 기존 탭과의 순서를 제어합니다. 기본 제공 탭을 기준으로 원하는 위치에 탭이 놓이도록 값을 선택하세요.
+
+* 기존 레이아웃에만 추가하려는 경우에는 `definePageLayout` 대신 이것을 사용하세요. 전체 레이아웃을 소유하는 경우에는 `definePageLayout`을 사용하세요.
diff --git a/packages/twenty-docs/l/ko/developers/extend/apps/layout/views.mdx b/packages/twenty-docs/l/ko/developers/extend/apps/layout/views.mdx
new file mode 100644
index 00000000000..17de1c48009
--- /dev/null
+++ b/packages/twenty-docs/l/ko/developers/extend/apps/layout/views.mdx
@@ -0,0 +1,97 @@
+---
+title: 보기
+description: 앱의 객체에 대해 열 순서, 필터, 그룹이 미리 구성된 저장된 보기를 제공하세요.
+icon: list
+---
+
+**보기**는 객체 레코드가 어떻게 표시될지에 대한 저장된 구성입니다. 어떤 필드가 표시되는지, 그 순서, 표시 여부, 적용된 필터나 그룹 등을 정의합니다. `defineView()`를 사용해 앱에 미리 구성된 보기를 포함할 수 있습니다. 일반적으로 생성하는 각 커스텀 객체마다 기본 목록 보기를 제공합니다.
+
+```ts src/views/example-view.ts
+import { defineView, ViewKey } from 'twenty-sdk/define';
+import { EXAMPLE_OBJECT_UNIVERSAL_IDENTIFIER } from '../objects/example-object';
+import { NAME_FIELD_UNIVERSAL_IDENTIFIER } from '../objects/example-object';
+
+export default defineView({
+ universalIdentifier: 'a1b2c3d4-e5f6-7890-abcd-ef1234567890',
+ name: 'All example items',
+ objectUniversalIdentifier: EXAMPLE_OBJECT_UNIVERSAL_IDENTIFIER,
+ icon: 'IconList',
+ key: ViewKey.INDEX,
+ position: 0,
+ fields: [
+ {
+ universalIdentifier: 'f926bdb7-6af7-4683-9a09-adbca56c29f0',
+ fieldMetadataUniversalIdentifier: NAME_FIELD_UNIVERSAL_IDENTIFIER,
+ position: 0,
+ isVisible: true,
+ size: 200,
+ },
+ ],
+});
+```
+
+## 핵심 요점
+
+* `objectUniversalIdentifier`는 이 뷰가 적용되는 객체를 지정합니다. 이 객체는 사용자가 정의한 커스텀 객체일 수도 있고, 표준 Twenty 객체일 수도 있습니다.
+* `key`는 보기 유형을 결정합니다. `ViewKey.INDEX`는 해당 객체의 기본 목록 보기입니다.
+* `fields`는 어떤 열을 어떤 순서로 표시할지를 제어합니다. 각 필드는 `fieldMetadataUniversalIdentifier`를 참조합니다.
+* 또한 더 고급 구성을 위해 `filters`, `filterGroups`, `groups`, `fieldGroups`를 선언할 수 있습니다.
+* `position`은 동일한 객체에 여러 뷰가 있을 때의 정렬 순서를 제어합니다.
+
+## 필터
+
+뷰는 미리 적용된 필터와 함께 제공될 수 있습니다. 각 필터에는 세 가지 요소가 있습니다: 필터링할 **필드**, **연산자**(어떻게 비교할지), 그리고 **값**(무엇과 비교할지). 세 가지가 모두 맞아야 하며, 필드 유형에 적용되지 않는 연산자를 사용하면 동기화 시 거부됩니다.
+
+```ts
+import { ViewFilterOperand } from 'twenty-shared/types';
+
+filters: [
+ {
+ universalIdentifier: '...',
+ fieldMetadataUniversalIdentifier: STATUS_FIELD_UNIVERSAL_IDENTIFIER,
+ operand: ViewFilterOperand.IS,
+ value: ['ACTIVE'],
+ },
+],
+```
+
+### 필드 유형별 지원되는 연산자
+
+| 필드 유형 | 지원되는 피연산자 |
+| -------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------ |
+| `TEXT`, `EMAILS`, `FULL_NAME`, `ADDRESS`, `LINKS`, `PHONES`, `RAW_JSON`, `FILES`, `ACTOR`, `ARRAY` | `CONTAINS`, `DOES_NOT_CONTAIN`, `IS_EMPTY`, `IS_NOT_EMPTY` |
+| `ACTOR.source`, `ACTOR.workspaceMemberId` | `IS`, `IS_NOT`, `IS_EMPTY`, `IS_NOT_EMPTY` |
+| `SELECT` | `IS`, `IS_NOT`, `IS_EMPTY`, `IS_NOT_EMPTY` |
+| `MULTI_SELECT` | `CONTAINS`, `DOES_NOT_CONTAIN`, `IS_EMPTY`, `IS_NOT_EMPTY` |
+| `RELATION` | `IS`, `IS_NOT`, `IS_EMPTY`, `IS_NOT_EMPTY` |
+| `NUMBER` | `IS`, `IS_NOT`, `GREATER_THAN_OR_EQUAL`, `LESS_THAN_OR_EQUAL`, `IS_EMPTY`, `IS_NOT_EMPTY` |
+| `RATING` | `IS`, `GREATER_THAN_OR_EQUAL`, `LESS_THAN_OR_EQUAL`, `IS_EMPTY`, `IS_NOT_EMPTY` |
+| `CURRENCY`, `CURRENCY.amountMicros` | `GREATER_THAN_OR_EQUAL`, `LESS_THAN_OR_EQUAL`, `IS`, `IS_NOT`, `IS_EMPTY`, `IS_NOT_EMPTY` |
+| `CURRENCY.currencyCode` | `IS`, `IS_NOT`, `IS_EMPTY`, `IS_NOT_EMPTY` |
+| `DATE`, `DATE_TIME` | `IS`, `IS_RELATIVE`, `IS_IN_PAST`, `IS_IN_FUTURE`, `IS_TODAY`, `IS_BEFORE`, `IS_AFTER`, `IS_EMPTY`, `IS_NOT_EMPTY` |
+| `BOOLEAN` | `IS` |
+| `UUID` | `IS`, `IS_NOT`, `IS_EMPTY`, `IS_NOT_EMPTY` |
+| `TS_VECTOR` | `VECTOR_SEARCH` |
+
+> 유사한 이름을 가진 필드 타입이라도 전혀 다른 피연산자를 사용할 수 있습니다. 대표적인 예로 `SELECT`와 `MULTI_SELECT`가 있습니다.
+
+### 피연산자별 값 구조
+
+`value` 필드는 항상 JSON으로 직렬화할 수 있는 값이지만, 기대되는 구조는 피연산자에 따라 달라집니다:
+
+| 피연산자 그룹 | 값 구조 | 예시 |
+| ----------------------------------------------------- | --------------------- | ------------------------ |
+| `SELECT`에서의 `IS`, `IS_NOT` | 옵션 키(문자열) 배열 | `['ACTIVE', 'PENDING']` |
+| `MULTI_SELECT`에서의 `CONTAINS`, `DOES_NOT_CONTAIN` | 옵션 키(문자열) 배열 | `['TAG_A']` |
+| `RELATION`에서의 `IS`, `IS_NOT` | 레코드 ID(uuid) 배열 | `['c5a1...']` |
+| 텍스트 계열 필드에서의 `CONTAINS`, `DOES_NOT_CONTAIN` | 문자열 | `'acme'` |
+| `NUMBER`에서의 `IS`, `IS_NOT` | 문자열(값) | `'5'` |
+| `RATING` / `UUID`에서의 `IS` | 문자열(값) | `'5'` |
+| `GREATER_THAN_OR_EQUAL`, `LESS_THAN_OR_EQUAL` | 문자열(경계값) | `'10'` |
+| `DATE` / `DATE_TIME`에서의 `IS`, `IS_BEFORE`, `IS_AFTER` | ISO 8601 문자열 | `'2025-01-01T00:00:00Z'` |
+| `IS_EMPTY`, `IS_NOT_EMPTY` | 빈 문자열 | `''` |
+| `BOOLEAN`에서의 `IS` | `'true'` 또는 `'false'` | `'true'` |
+
+## 보기가 UI에 표시되는 방식
+
+보기만으로는 사이드바에서 직접 접근할 수 없습니다. 사이드바에 표시하려면, 해당 보기의 `universalIdentifier`를 가리키는 `VIEW` 타입의 [탐색 메뉴 항목](/l/ko/developers/extend/apps/layout/navigation-menu-items)과 연결해야 합니다. 이것이 표준적인 패턴입니다. 일반적으로 각 커스텀 객체는 기본 보기와, 그 보기를 여는 사이드바 항목을 함께 제공합니다.
diff --git a/packages/twenty-docs/l/ko/developers/extend/apps/logic/connections.mdx b/packages/twenty-docs/l/ko/developers/extend/apps/logic/connections.mdx
new file mode 100644
index 00000000000..ec07b085df8
--- /dev/null
+++ b/packages/twenty-docs/l/ko/developers/extend/apps/logic/connections.mdx
@@ -0,0 +1,192 @@
+---
+title: 연결
+description: 앱이 OAuth를 통해 타사 서비스에서 사용자를 대신해 동작하도록 하세요.
+icon: plug
+---
+
+연결은 사용자가 외부 서비스(Linear, GitHub, Slack 등)에 대한 자격 증명을 보유하는 것을 말합니다. 앱은 해당 자격 증명을 **어떻게** 얻는지(즉, **연결 제공자**)를 선언하고, 런타임에 이를 사용해 서드파티 API에 인증된 호출을 수행합니다.
+
+현재는 OAuth 2.0만 지원됩니다. 향후 자격 증명 유형(개인 액세스 토큰, API 키, 기본 인증)은 동일한 인터페이스에 연동되며 — 이미 `defineConnectionProvider({ type: 'oauth', ... })`를 사용하는 앱은 마이그레이션이 필요하지 않습니다.
+
+<AccordionGroup>
+
+<Accordion title="defineConnectionProvider" description="앱의 연결을 얻는 방법을 선언합니다">
+
+연결 제공자는 앱에 필요한 OAuth 핸드셰이크를 설명합니다. 사용자가 앱 설정에서 "연결 추가"를 클릭하고 제공자의 동의 화면을 완료하면, 워크스페이스에 `ConnectedAccount` 행이 생성됩니다.
+
+정상 동작하려면 **두 개의 파일**이 필요합니다 — 연결 제공자, 그리고 OAuth 클라이언트 자격 증명을 보유하는 `defineApplication`의 해당 `serverVariables` 선언.
+
+```ts src/connection-providers/linear-connection.ts
+import { defineConnectionProvider } from 'twenty-sdk/define';
+
+export default defineConnectionProvider({
+ universalIdentifier: '9c7d1f5e-6a0b-4d44-be0c-3f8b5a9d4e6f',
+ name: 'linear',
+ displayName: 'Linear',
+ icon: 'IconBrandLinear',
+ type: 'oauth',
+ oauth: {
+ authorizationEndpoint: 'https://linear.app/oauth/authorize',
+ tokenEndpoint: 'https://api.linear.app/oauth/token',
+ scopes: ['read', 'write'],
+ // These must match keys in `defineApplication.serverVariables` below.
+ clientIdVariable: 'LINEAR_CLIENT_ID',
+ clientSecretVariable: 'LINEAR_CLIENT_SECRET',
+ // Optional: defaults to 'json'. Some providers (Linear, Slack) want
+ // 'form-urlencoded' for the token request.
+ tokenRequestContentType: 'form-urlencoded',
+ // Optional: defaults to true. Disable only if the provider rejects PKCE.
+ usePkce: false,
+ // Optional: extra query params on the authorize URL.
+ // authorizationParams: { prompt: 'consent' },
+ // Optional: provider's RFC 7009 token revocation endpoint, called on disconnect.
+ // revokeEndpoint: 'https://example.com/oauth/revoke',
+ },
+});
+```
+
+```ts src/application.config.ts
+import { defineApplication } from 'twenty-sdk/define';
+
+export default defineApplication({
+ universalIdentifier: '...',
+ displayName: 'Linear',
+ description: 'Connect Linear to Twenty.',
+ // OAuth client credentials live on the app registration (one OAuth app per
+ // Twenty server, configured by the admin) — not per-workspace. Declare them
+ // as serverVariables so the admin can fill them in once for all installs.
+ serverVariables: {
+ LINEAR_CLIENT_ID: {
+ description: 'OAuth client ID from your Linear OAuth application.',
+ isSecret: false,
+ isRequired: true,
+ },
+ LINEAR_CLIENT_SECRET: {
+ description: 'OAuth client secret from your Linear OAuth application.',
+ isSecret: true,
+ isRequired: true,
+ },
+ },
+});
+```
+
+핵심 요점:
+
+* `name`은 `listConnections({ providerName })`에서 사용하는 고유 식별자 문자열입니다(kebab-case, `^[a-z][a-z0-9-]*$`와 일치해야 함).
+* `displayName`은 앱별 설정 탭과 AI 도구 목록에 표시됩니다.
+* `clientIdVariable` / `clientSecretVariable`은 값이 아닌 **이름**이며, `defineApplication.serverVariables`에 선언된 키와 일치해야 합니다. 실제 `client_id`와 `client_secret`은 서버 관리자가 앱 등록 UI를 통해 입력하며, 저장소에 커밋되지 않습니다.
+* `serverVariables`(`applicationVariables` 아님)을 사용하세요 — OAuth 자격 증명은 서버 전체에 적용되며 Twenty 서버마다 하나의 OAuth 앱만 사용합니다.
+* 두 `serverVariables`가 모두 채워질 때까지, 앱별 설정 탭에는 "서버 관리자 필요" 힌트가 표시되고 "연결 추가" 버튼이 비활성화됩니다.
+* `type: 'oauth'`는 현재 지원되는 유일한 값입니다. 구분자는 전방 호환됩니다: 향후 유형(`'pat'`, `'api-key'`, ...) `oauth`와 함께 새로운 하위 구성 블록이 추가됩니다.
+
+제공자가 허용 목록에 추가해야 할 OAuth 콜백 URL은 다음과 같습니다:
+
+```
+https://<your-twenty-server>/auth/apps/callback
+```
+
+</Accordion>
+
+<Accordion title="listConnections / getConnection" description="로직 함수에서 연결 사용">
+
+로직 함수 핸들러 내부에서 `listConnections({ providerName })`는 지정된 제공자에 대한 이 앱의 `ConnectedAccount` 행을 갱신된 액세스 토큰과 함께 반환합니다.
+
+```ts src/logic-functions/handlers/create-linear-issue-handler.ts
+import { listConnections } from 'twenty-sdk/logic-function';
+
+export const createLinearIssueHandler = async (input: {
+ teamId?: string;
+ title?: string;
+}) => {
+ if (!input.teamId || !input.title) {
+ return { success: false, error: 'teamId and title are required' };
+ }
+
+ const connections = await listConnections({ providerName: 'linear' });
+
+ // Workspace-shared credentials win when present; fall back to the first
+ // user-visibility one. For HTTP-route triggers you typically pick the
+ // request user's connection via event.userWorkspaceId instead.
+ const connection =
+ connections.find((c) => c.visibility === 'workspace') ?? connections[0];
+
+ if (!connection) {
+ return {
+ success: false,
+ error:
+ 'Linear is not connected. Open the app settings and click "Add connection".',
+ };
+ }
+
+ // Use connection.accessToken to call the third-party API.
+ const response = await fetch('https://api.linear.app/graphql', {
+ method: 'POST',
+ headers: {
+ Authorization: `Bearer ${connection.accessToken}`,
+ 'Content-Type': 'application/json',
+ },
+ body: JSON.stringify({
+ query: `mutation { issueCreate(input: { teamId: "${input.teamId}", title: "${input.title}" }) { success } }`,
+ }),
+ });
+
+ return { success: response.ok };
+};
+```
+
+각 연결에는 다음이 포함됩니다:
+
+| 필드 | 설명 |
+| ----------------- | --------------------------------------------------------------- |
+| `id` | 고유한 행 ID; 단일 항목을 다시 가져오려면 `getConnection(id)`에 전달하세요. |
+| `visibility` | `'user'`(한 워크스페이스 구성원에게만 비공개) 또는 `'workspace'`(모든 구성원과 공유) |
+| `scopes` | 상위 제공자가 부여한 OAuth 권한(`visibility`와는 구별됨 — 서로 관련 없음) |
+| `userWorkspaceId` | 소유자의 userWorkspace ID — HTTP 경로 트리거에서 "요청 사용자의 연결"을 선택할 때 유용합니다 |
+| `accessToken` | 최신 OAuth 액세스 토큰(만료 시 자동으로 갱신됨) |
+| `name` / `handle` | 연결의 표시 이름(OAuth 콜백 시 자동으로 결정되며, 사용자가 이름을 변경할 수 있음) |
+| `authFailedAt` | 가장 최근 갱신이 실패했을 때 설정됩니다; 사용자가 다시 연결해야 합니다 |
+
+핵심 요점:
+
+* 제공자별로 필터링하려면 `{ providerName }`를 전달하세요; 생략하면 이 앱이 모든 제공자에서 보유한 모든 연결을 가져옵니다.
+* 서버는 반환하기 전에 액세스 토큰을 투명하게 갱신합니다. 핸들러는 항상 사용 가능한 토큰(또는 `authFailedAt`이 설정된 상태)을 보게 됩니다.
+* `getConnection(id)`는 단일 행 버전입니다.
+
+</Accordion>
+
+<Accordion title="사용자별 대 워크스페이스 공유 가시성" description="사용자가 비공개 자격 증명과 공유 자격 증명 사이를 선택하는 방법">
+
+사용자가 "연결 추가"를 클릭하면, 가시성을 선택하라는 프롬프트가 표시됩니다:
+
+* **나만 사용** — 해당 자격 증명은 연결한 사용자에게만 비공개입니다. 그 사용자를 대신해 호출되는 모든 로직 함수(`isAuthRequired: true`가 설정된 HTTP 경로 트리거)는 이를 볼 수 있습니다; cron 트리거와 데이터베이스 이벤트는 볼 수 없습니다.
+* **워크스페이스 공유** — 모든 워크스페이스 구성원이 해당 자격 증명을 사용할 수 있습니다. 요청 사용자가 없으므로 Cron/데이터베이스 트리거도 이를 볼 수 있습니다.
+
+각 핸들러에 맞는 유형을 사용하세요:
+
+```ts
+// HTTP-route trigger — prefer the request user's own connection.
+const conn =
+ connections.find((c) => c.userWorkspaceId === event.userWorkspaceId) ??
+ connections.find((c) => c.visibility === 'workspace');
+
+// Cron trigger — no request user; only shared credentials are sensible.
+const conn = connections.find((c) => c.visibility === 'workspace');
+```
+
+각 (사용자, 제공자)당 여러 연결이 허용되므로, 동일한 사용자가 "Personal Linear"와 "Work Linear"를 나란히 보유할 수 있습니다.
+
+</Accordion>
+
+<Accordion title="일회성 제공자 설정" description="서드파티 서비스에 OAuth 앱을 등록하세요">
+
+각 연결 제공자마다 서버 관리자가 먼저 서드파티에 OAuth 앱을 등록해야 합니다.
+
+1. 제공자의 개발자 설정으로 이동하세요(예: https://linear.app/settings/api/applications/new).
+2. **Redirect URI**를 `\<SERVER_URL>/auth/apps/callback`으로 설정하세요.
+3. 생성된 **Client ID**와 **Client Secret**을 복사하세요.
+4. 서버 관리자 권한으로 Twenty에서 설치된 앱을 열고 → 해당 `serverVariables`에 값을 설정하세요.
+5. 그런 다음 워크스페이스 구성원은 앱별 **연결** 섹션에서 연결을 추가할 수 있습니다.
+
+</Accordion>
+
+</AccordionGroup>
diff --git a/packages/twenty-docs/l/ko/developers/extend/apps/logic/logic-functions.mdx b/packages/twenty-docs/l/ko/developers/extend/apps/logic/logic-functions.mdx
new file mode 100644
index 00000000000..12cbb6a79e4
--- /dev/null
+++ b/packages/twenty-docs/l/ko/developers/extend/apps/logic/logic-functions.mdx
@@ -0,0 +1,514 @@
+---
+title: 로직 함수
+description: HTTP, cron 및 데이터베이스 이벤트 트리거를 사용하여 서버 측 TypeScript 함수를 정의합니다.
+icon: bolt
+---
+
+로직 함수는 Twenty 플랫폼에서 실행되는 서버 측 TypeScript 함수입니다. 이 함수들은 HTTP 요청, cron 스케줄 또는 데이터베이스 이벤트에 의해 트리거될 수 있으며 — AI 에이전트를 위한 도구로도 제공할 수 있습니다.
+
+<AccordionGroup>
+<Accordion title="defineLogicFunction" description="로직 함수와 해당 트리거 정의">
+
+각 함수 파일은 `defineLogicFunction()`을 사용해 핸들러와 선택적 트리거가 포함된 구성을 내보냅니다.
+
+```ts src/logic-functions/createPostCard.logic-function.ts
+import { defineLogicFunction } from 'twenty-sdk/define';
+import type { RoutePayload } from 'twenty-sdk/logic-function';
+import { CoreApiClient } from 'twenty-client-sdk/core';
+
+const handler = async (params: RoutePayload) => {
+ const client = new CoreApiClient();
+ const body = (params.body ?? {}) as { name?: string };
+ const name = body.name ?? process.env.DEFAULT_RECIPIENT_NAME ?? 'Hello world';
+
+ const result = await client.mutation({
+ createPostCard: {
+ __args: { data: { name } },
+ id: true,
+ name: true,
+ },
+ });
+ return result;
+};
+
+export default defineLogicFunction({
+ universalIdentifier: 'e56d363b-0bdc-4d8a-a393-6f0d1c75bdcf',
+ name: 'create-new-post-card',
+ timeoutSeconds: 2,
+ handler,
+ httpRouteTriggerSettings: {
+ path: '/post-card/create',
+ httpMethod: 'POST',
+ isAuthRequired: true,
+ },
+ /*databaseEventTriggerSettings: {
+ eventName: 'people.created',
+ },*/
+ /*cronTriggerSettings: {
+ pattern: '0 0 1 1 *',
+ },*/
+});
+```
+
+사용 가능한 트리거 유형:
+* **httpRoute**: **`/s/` 엔드포인트** 아래의 HTTP 경로와 메서드로 함수를 노출합니다:
+> 예: `path: '/post-card/create'`는 `https://your-twenty-server.com/s/post-card/create`에서 호출할 수 있습니다
+
+<Note>
+(헤드리스) 프런트 컴포넌트에서 라우트로 트리거되는 로직 함수를 호출하려면 [로직 함수 호출하기](/l/ko/developers/extend/apps/layout/front-components#calling-a-logic-function)를 참고하세요.
+</Note>
+* **cron**: CRON 식을 사용하여 예약된 일정으로 함수를 실행합니다.
+* **databaseEvent**: 워크스페이스 객체 라이프사이클 이벤트에서 실행됩니다. 이벤트 작업이 `updated`인 경우, 수신할 특정 필드를 `updatedFields` 배열에 지정할 수 있습니다. 정의하지 않거나 비워두면, 어떤 업데이트든 함수가 트리거됩니다.
+> 예: `person.updated`, `*.created`, `company.*`
+
+<Note>
+CLI를 사용해 함수를 수동으로 실행할 수도 있습니다:
+
+```bash filename="Terminal"
+yarn twenty dev:function:exec -n create-new-post-card -p '{"key": "value"}'
+```
+
+```bash filename="Terminal"
+yarn twenty dev:function:exec -u e56d363b-0bdc-4d8a-a393-6f0d1c75bdcf
+```
+
+다음으로 로그를 확인할 수 있습니다:
+
+```bash filename="Terminal"
+yarn twenty dev:function:logs
+```
+</Note>
+
+#### 라우트 트리거 페이로드
+
+라우트 트리거가 로직 함수를 호출하면, 함수는 [AWS HTTP API v2 형식](https://docs.aws.amazon.com/apigateway/latest/developerguide/http-api-develop-integrations-lambda.html)을 따르는 `RoutePayload` 객체를 받습니다.
+`twenty-sdk/logic-function`에서 `RoutePayload` 타입을 임포트하세요:
+
+```ts
+import type { RoutePayload } from 'twenty-sdk/logic-function';
+
+const handler = async (event: RoutePayload) => {
+ const { headers, queryStringParameters, pathParameters, body } = event;
+ const { method, path } = event.requestContext.http;
+
+ return { message: 'Success' };
+};
+```
+
+`RoutePayload` 타입은 다음과 같은 구조입니다:
+
+ | 속성 | 유형 | 설명 | 예시 |
+ | ---------------------------- | ------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------- |
+ | `headers` | `Record\<string, string \| undefined>` | HTTP 헤더(`forwardedRequestHeaders`에 나열된 항목만) | 아래 섹션 참조 |
+ | `queryStringParameters` | `Record\<string, string \| undefined>` | 쿼리 문자열 매개변수(여러 값은 쉼표로 연결됨) | `/users?ids=1&ids=2&ids=3&name=Alice` -> `{ ids: '1,2,3', name: 'Alice' }` |
+ | `pathParameters` | `Record\<string, string \| undefined>` | 라우트 패턴에서 추출된 경로 매개변수 | `/users/:id`, `/users/123` -> `{ id: '123' }` |
+ | `body` | `object \| null` | 파싱된 요청 본문(JSON) | `{ id: 1 }` -> `{ id: 1 }` |
+ | `rawBody` | `string \| undefined` | JSON 파싱 이전의 원본 UTF-8 요청 본문입니다. HMAC 스타일 웹훅 서명을 검증하는 데 유용합니다(예: GitHub의 `X-Hub-Signature-256`, Stripe). 런타임이 이를 보존하지 않은 경우에는 `undefined`입니다. | |
+ | `isBase64Encoded` | `boolean` | 본문이 base64로 인코딩되었는지 여부 | |
+ | `requestContext.http.method` | `string` | HTTP 메서드(GET, POST, PUT, PATCH, DELETE) | |
+ | `requestContext.http.path` | `string` | 원시 요청 경로 | |
+
+
+#### forwardedRequestHeaders
+
+기본적으로 보안상의 이유로 들어오는 요청의 HTTP 헤더는 로직 함수로 **전달되지 않습니다**.
+특정 헤더에 접근하려면 `forwardedRequestHeaders` 배열에 나열하세요:
+
+```ts
+export default defineLogicFunction({
+ universalIdentifier: 'e56d363b-0bdc-4d8a-a393-6f0d1c75bdcf',
+ name: 'webhook-handler',
+ handler,
+ httpRouteTriggerSettings: {
+ path: '/webhook',
+ httpMethod: 'POST',
+ isAuthRequired: false,
+ forwardedRequestHeaders: ['x-webhook-signature', 'content-type'],
+ },
+});
+```
+
+핸들러에서, 전달된 헤더에 다음과 같이 접근합니다:
+
+```ts
+const handler = async (event: RoutePayload) => {
+ const signature = event.headers['x-webhook-signature'];
+ const contentType = event.headers['content-type'];
+
+ // Validate webhook signature...
+ return { received: true };
+};
+```
+
+<Note>
+헤더 이름은 소문자로 정규화됩니다. 소문자 키를 사용해 접근하세요(예: `event.headers['content-type']`).
+</Note>
+
+#### 사용자 정의 HTTP 응답
+
+기본적으로, 핸들러에서 일반 값을 반환하면 해당 값이 `200` 응답으로 전송됩니다(객체는 JSON, 문자열은 `text/plain`). 상태 코드와 응답 헤더를 제어하려면 `twenty-sdk/logic-function`에서 `Response`를 반환하세요:
+
+```ts
+import { Response } from 'twenty-sdk/logic-function';
+
+const handler = async (event: RoutePayload) => {
+ return new Response('<h1>Hello</h1>', {
+ status: 201,
+ headers: { 'content-type': 'text/html' },
+ });
+};
+```
+
+보안상의 이유로, 응답 헤더는 허용 목록으로 제한됩니다. 목록에 없는 헤더(예: `Set-Cookie`, `Access-Control-Allow-Origin`과 같은 CORS 헤더, 또는 사용자 정의 `X-*` 헤더)는 응답이 전송되기 전에 조용히 제거됩니다. 허용되는 응답 헤더는 다음과 같습니다:
+
+* `content-type`
+* `content-language`
+* `content-disposition`
+* `cache-control`
+* `retry-after`
+
+<Note>
+상태 코드는 유효한 HTTP 상태 코드(100에서 599 사이)여야 합니다. 응답 헤더 이름은 대소문자를 구분하지 않습니다.
+</Note>
+
+#### 데이터베이스 이벤트 트리거 페이로드
+
+데이터베이스 이벤트 트리거가 로직 함수를 호출하면, 변경된 각 레코드마다 하나의 `DatabaseEventPayload`를 받습니다. 이 페이로드는 소스 워크스페이스와 오브젝트에 대한 메타데이터를 레코드 수준 이벤트와 결합합니다.
+
+```ts
+import type {
+ DatabaseEventPayload,
+ ObjectRecordCreateEvent,
+ ObjectRecordDestroyEvent,
+ ObjectRecordUpdateEvent,
+} from 'twenty-sdk/logic-function';
+
+type Person = {
+ id: string;
+ emails?: { primaryEmail?: string };
+};
+```
+
+페이로드에는 다음이 포함됩니다:
+
+| 속성 | 설명 |
+| ------------------------------------------------ | ------------------------------------------------------------------------------ |
+| `name` | `person.updated`와 같은 이벤트 이름입니다. |
+| `workspaceId` | 이벤트가 발생한 워크스페이스입니다. |
+| `objectMetadata` | 변경된 오브젝트에 대한 메타데이터입니다. |
+| `recordId` | 변경된 레코드의 ID입니다. |
+| `userId`, `userWorkspaceId`, `workspaceMemberId` | 워크스페이스 사용자가 이벤트를 발생시켰을 때의 액터 필드입니다. |
+| `properties` | 이벤트에 대한 레코드 데이터로, 작업 유형에 따라 `before`, `after`, `diff`, `updatedFields`를 포함합니다. |
+
+| 이벤트 | 레코드 데이터 |
+| ------------------ | -------------------------------------------------------------------------------------------------------------- |
+| `person.created` | `event.properties.after` |
+| `person.updated` | `event.properties.before`, `event.properties.after`, `event.properties.diff`, `event.properties.updatedFields` |
+| `person.destroyed` | `event.properties.before` |
+
+소프트 삭제의 경우, 레코드의 `deletedAt` 필드가 변경되므로 `.deleted`는 업데이트 스타일 구조를 따릅니다.
+영구 삭제의 경우 `.destroyed`를 사용하세요.
+
+<Note>
+`databaseEventTriggerSettings.updatedFields`는 어떤 업데이트 이벤트가 함수를 트리거할지 필터링합니다.
+`event.properties.updatedFields`는 현재 이벤트에서 실제로 어떤 필드가 변경되었는지 알려줍니다.
+</Note>
+
+생성 이벤트 예시:
+
+```ts
+type PersonCreatedEvent = DatabaseEventPayload<
+ ObjectRecordCreateEvent<Person>
+>;
+
+const handler = async (event: PersonCreatedEvent) => {
+ const person = event.properties.after;
+
+ return {
+ personId: event.recordId,
+ email: person.emails?.primaryEmail,
+ };
+};
+```
+
+업데이트 이벤트 예시:
+
+```ts
+type PersonUpdatedEvent = DatabaseEventPayload<
+ ObjectRecordUpdateEvent<Person>
+>;
+
+const handler = async (event: PersonUpdatedEvent) => {
+ const { before, after, diff, updatedFields } = event.properties;
+
+ return {
+ personId: event.recordId,
+ updatedFields,
+ previousEmail: before.emails?.primaryEmail,
+ currentEmail: after.emails?.primaryEmail,
+ emailDiff: diff.emails,
+ };
+};
+```
+
+이메일 업데이트에만 트리거되도록:
+
+```ts
+export default defineLogicFunction({
+ ...,
+ databaseEventTriggerSettings: {
+ eventName: 'person.updated',
+ updatedFields: ['emails'],
+ },
+});
+```
+
+삭제 이벤트 예시:
+
+```ts
+type PersonDestroyedEvent = DatabaseEventPayload<
+ ObjectRecordDestroyEvent<Person>
+>;
+
+const handler = async (event: PersonDestroyedEvent) => {
+ const personBeforeDestroy = event.properties.before;
+
+ return {
+ personId: event.recordId,
+ email: personBeforeDestroy.emails?.primaryEmail,
+ };
+};
+```
+
+#### 함수를 AI 도구 또는 워크플로 작업으로 노출하기
+
+로직 함수는 두 가지 영역에서 노출될 수 있으며, 각 영역마다 자체 트리거가 있습니다:
+
+* **`toolTriggerSettings`** — 이 설정을 사용하면 함수가 Twenty의 AI 기능(채팅, MCP, 함수 호출)에서 검색 가능해집니다. 표준 JSON 스키마(LLM이 기본적으로 이해하는 형식)를 사용합니다.
+* **`workflowActionTriggerSettings`** — 시각적 워크플로 빌더에서 함수를 단계로 나타나게 합니다. 빌더가 적절한 필드 에디터, 변수 선택기, 레이블을 렌더링할 수 있도록 Twenty의 풍부한 `InputSchema`를 사용합니다.
+
+함수는 둘 중 하나만 또는 둘 다 선택할 수 있습니다. 이들 설정은 `cronTriggerSettings`, `databaseEventTriggerSettings`, `httpRouteTriggerSettings`와 나란히 위치하며 — 패턴도 형태도 동일합니다.
+
+```ts src/logic-functions/enrich-company.logic-function.ts
+import { defineLogicFunction } from 'twenty-sdk/define';
+import { CoreApiClient } from 'twenty-client-sdk/core';
+
+const handler = async (params: { companyName: string; domain?: string }) => {
+ const client = new CoreApiClient();
+
+ const result = await client.mutation({
+ createTask: {
+ __args: {
+ data: {
+ title: `Enrich data for ${params.companyName}`,
+ body: `Domain: ${params.domain ?? 'unknown'}`,
+ },
+ },
+ id: true,
+ },
+ });
+
+ return { taskId: result.createTask.id };
+};
+
+export default defineLogicFunction({
+ universalIdentifier: 'f47ac10b-58cc-4372-a567-0e02b2c3d479',
+ name: 'enrich-company',
+ description: 'Enrich a company record with external data',
+ timeoutSeconds: 10,
+ handler,
+ toolTriggerSettings: {},
+});
+```
+
+핵심 요점:
+
+* 함수는 노출 방식을 혼합할 수 있습니다 — `toolTriggerSettings`와 `workflowActionTriggerSettings`를 모두 선언하여 채팅과 워크플로 빌더 모두에 노출할 수 있습니다.
+* `toolTriggerSettings.inputSchema`와 `workflowActionTriggerSettings.inputSchema`는 모두 선택 사항입니다. 생략되면 매니페스트 빌더가 핸들러 소스 코드에서 이를 추론합니다(AI 도구의 경우 JSON 스키마, 워크플로 작업의 경우 Twenty의 `InputSchema`). 더 풍부한 타입 지정을 원한다면 명시적으로 제공하세요 — 예를 들어 워크플로 빌더를 위해 `CURRENCY` 또는 `RELATION`처럼 `FieldMetadataType`을 인지하는 필드를 사용하거나, AI 에이전트가 읽을 수 있는 `description` 필드를 포함하려는 경우:
+
+```ts
+export default defineLogicFunction({
+ ...,
+ toolTriggerSettings: {
+ inputSchema: {
+ type: 'object',
+ properties: {
+ companyName: {
+ type: 'string',
+ description: 'The name of the company to enrich',
+ },
+ domain: {
+ type: 'string',
+ description: 'The company website domain (optional)',
+ },
+ },
+ required: ['companyName'],
+ },
+ },
+});
+```
+
+<Note>
+**좋은 `description`을 작성하세요.** AI 에이전트는 도구를 언제 사용할지 결정하기 위해 함수의 `description` 필드에 의존합니다. 도구가 무엇을 하는지와 언제 호출해야 하는지 구체적으로 작성하세요.
+</Note>
+
+</Accordion>
+</AccordionGroup>
+
+<Note>
+**설치 훅** — 사전 설치 및 사후 설치 핸들러 — 는 이 런타임을 공유하지만, 각각의 `define` 함수로 선언되며 트리거 설정을 받지 않습니다. `definePreInstallLogicFunction` 및 `definePostInstallLogicFunction` 에 대해서는 [설치 훅](/l/ko/developers/extend/apps/config/install-hooks)을 참고하세요.
+</Note>
+
+## 타입이 지정된 API 클라이언트(twenty-client-sdk)
+
+`twenty-client-sdk` 패키지는 로직 함수와 프런트 컴포넌트에서 Twenty API와 상호작용하기 위한 타입이 지정된 두 가지 GraphQL 클라이언트를 제공합니다.
+
+| 클라이언트 | 가져오기 | 엔드포인트 | 생성 여부? |
+| ------------------- | ---------------------------- | -------------------------------- | -------------- |
+| `CoreApiClient` | `twenty-client-sdk/core` | `/graphql` — 워크스페이스 데이터(레코드, 객체) | 예, 개발/빌드 시점 |
+| `MetadataApiClient` | `twenty-client-sdk/metadata` | `/metadata` — 워크스페이스 구성, 파일 업로드 | 아니오, 사전 빌드로 제공 |
+
+<AccordionGroup>
+<Accordion title="CoreApiClient" description="워크스페이스 데이터(레코드, 객체) 조회 및 변경">
+
+`CoreApiClient`는 워크스페이스 데이터를 조회하고 변경하는 데 사용하는 기본 클라이언트입니다. `yarn twenty dev` 또는 `yarn twenty dev:build` 중에 **워크스페이스 스키마로부터 생성되므로**, 객체와 필드에 정확히 맞는 완전한 타입 정보를 제공합니다.
+
+```ts
+import { CoreApiClient } from 'twenty-client-sdk/core';
+
+const client = new CoreApiClient();
+
+// Query records
+const { companies } = await client.query({
+ companies: {
+ edges: {
+ node: {
+ id: true,
+ name: true,
+ domainName: {
+ primaryLinkLabel: true,
+ primaryLinkUrl: true,
+ },
+ },
+ },
+ },
+});
+
+// Create a record
+const { createCompany } = await client.mutation({
+ createCompany: {
+ __args: {
+ data: {
+ name: 'Acme Corp',
+ },
+ },
+ id: true,
+ name: true,
+ },
+});
+```
+
+이 클라이언트는 선택 집합 구문을 사용합니다: 필드를 포함하려면 `true`를 전달하고, 인수에는 `__args`를 사용하며, 관계는 객체를 중첩합니다. 워크스페이스 스키마를 기반으로 완전한 자동 완성과 타입 검사를 제공합니다.
+
+<Note>
+**CoreApiClient는 개발/빌드 시점에 생성됩니다.** 먼저 `yarn twenty dev` 또는 `yarn twenty dev:build`를 실행하지 않고 사용하면 오류가 발생합니다. 생성은 자동으로 이루어지며 — CLI가 워크스페이스의 GraphQL 스키마를 분석하고 `@genql/cli`를 사용해 타입이 지정된 클라이언트를 생성합니다.
+</Note>
+
+#### 타입 주석을 위한 CoreSchema 사용
+
+`CoreSchema`는 워크스페이스 객체에 맞는 TypeScript 타입을 제공하며, 컴포넌트 상태나 함수 매개변수에 타입을 지정할 때 유용합니다:
+
+```ts
+import { CoreApiClient, CoreSchema } from 'twenty-client-sdk/core';
+import { useState } from 'react';
+
+const [company, setCompany] = useState<
+ Pick<CoreSchema.Company, 'id' | 'name'> | undefined
+>(undefined);
+
+const client = new CoreApiClient();
+const result = await client.query({
+ company: {
+ __args: { filter: { position: { eq: 1 } } },
+ id: true,
+ name: true,
+ },
+});
+setCompany(result.company);
+```
+
+</Accordion>
+<Accordion title="MetadataApiClient" description="워크스페이스 구성, 애플리케이션, 파일 업로드">
+
+`MetadataApiClient`는 SDK와 함께 사전 빌드된 상태로 제공됩니다(생성 필요 없음). 워크스페이스 구성, 애플리케이션 및 파일 업로드를 위해 `/metadata` 엔드포인트를 조회합니다.
+
+```ts
+import { MetadataApiClient } from 'twenty-client-sdk/metadata';
+
+const metadataClient = new MetadataApiClient();
+
+// List first 10 objects in the workspace
+const { objects } = await metadataClient.query({
+ objects: {
+ edges: {
+ node: {
+ id: true,
+ nameSingular: true,
+ namePlural: true,
+ labelSingular: true,
+ isCustom: true,
+ },
+ },
+ __args: {
+ filter: {},
+ paging: { first: 10 },
+ },
+ },
+});
+```
+
+#### 파일 업로드
+
+`MetadataApiClient`에는 파일 유형 필드에 파일을 첨부하기 위한 `uploadFile` 메서드가 포함되어 있습니다:
+
+```ts
+import { MetadataApiClient } from 'twenty-client-sdk/metadata';
+import * as fs from 'fs';
+
+const metadataClient = new MetadataApiClient();
+
+const fileBuffer = fs.readFileSync('./invoice.pdf');
+
+const uploadedFile = await metadataClient.uploadFile(
+ fileBuffer, // file contents as a Buffer
+ 'invoice.pdf', // filename
+ 'application/pdf', // MIME type
+ '58a0a314-d7ea-4865-9850-7fb84e72f30b', // field universalIdentifier
+);
+
+console.log(uploadedFile);
+// { id: '...', path: '...', size: 12345, createdAt: '...', url: 'https://...' }
+```
+
+| 매개변수 | 유형 | 설명 |
+| ---------------------------------- | -------- | --------------------------------------------- |
+| `fileBuffer` | `Buffer` | 원시 파일 내용 |
+| `filename` | `string` | 파일의 이름(저장 및 표시용) |
+| `contentType` | `string` | MIME 유형(생략하면 기본값은 `application/octet-stream`) |
+| `fieldMetadataUniversalIdentifier` | `string` | 객체의 파일 유형 필드의 `universalIdentifier` |
+
+핵심 요점:
+* 필드의 `universalIdentifier`(워크스페이스별 ID가 아님)를 사용하므로, 앱이 설치된 모든 워크스페이스에서 업로드 코드가 동작합니다.
+* 반환된 `url`은 업로드된 파일에 액세스하는 데 사용할 수 있는 서명된 URL입니다.
+
+</Accordion>
+</AccordionGroup>
+
+<Note>
+ 코드가 Twenty에서 실행될 때(로직 함수 또는 프런트 컴포넌트), 플랫폼이 자격 증명을 환경 변수로 주입합니다:
+
+ * `TWENTY_API_URL` — Twenty API의 기본 URL
+ * `TWENTY_APP_ACCESS_TOKEN` — 애플리케이션의 기본 함수 역할 범위로 제한된 단기 키
+
+ 클라이언트에 이를 전달할 필요가 없습니다 — 자동으로 `process.env`에서 읽습니다. API 키의 권한은 `defineApplicationRole()`으로 선언된 역할(또는 `application-config.ts`의 `defaultRoleUniversalIdentifier`를 통해 참조된 역할)에 의해 결정됩니다.
+</Note>
diff --git a/packages/twenty-docs/l/ko/developers/extend/apps/logic/overview.mdx b/packages/twenty-docs/l/ko/developers/extend/apps/logic/overview.mdx
new file mode 100644
index 00000000000..ff03921d968
--- /dev/null
+++ b/packages/twenty-docs/l/ko/developers/extend/apps/logic/overview.mdx
@@ -0,0 +1,55 @@
+---
+title: 개요
+description: HTTP 경로, 크론 스케줄, 데이터베이스 이벤트, AI 도구 또는 워크플로우 액션에 의해 트리거되어 Twenty 내부에서 실행되는 서버 사이드 TypeScript입니다.
+icon: bolt
+---
+
+Twenty 앱의 **로직 계층**은 *실행되는* 코드로, HTTP 요청, 크론 스케줄, 레코드 변경에 반응하는 서버 사이드 TypeScript 핸들러, 워크스페이스 내부에 존재하는 AI 스킬과 에이전트, 그리고 서드파티 서비스에서 사용자를 대신해 함수가 동작할 수 있도록 하는 OAuth 연결로 구성됩니다.
+
+```text
+ ┌─ HTTP route ──┐
+ │ Cron schedule │
+ │ Database event │ ┌────────────────────┐
+ triggers ─┤ AI tool call ├─────▶│ Logic function │
+ │ Workflow action │ │ (your handler) │
+ │ Manual exec │ └────────────────────┘
+ └────────────────────┘ │
+ ▼
+ ┌────────────────────────────┐
+ │ Twenty API (records) │
+ │ Third-party API │
+ │ (via Connection token) │
+ └────────────────────────────┘
+```
+
+## 이 섹션에서 다루는 내용
+
+<CardGroup cols={2}>
+ <Card title="로직 함수" icon="bolt" href="/l/ko/developers/extend/apps/logic/logic-functions">
+ 핵심 빌딩 블록 — 트리거 유형, 페이로드, 그리고 타입이 지정된 API 클라이언트입니다.
+ </Card>
+ <Card title="스킬 & 에이전트" icon="robot" href="/l/ko/developers/extend/apps/logic/skills-and-agents">
+ 재사용 가능한 AI 에이전트 지시문과 맞춤형 시스템 프롬프트를 사용하는 어시스턴트입니다.
+ </Card>
+ <Card title="연결" icon="plug" href="/l/ko/developers/extend/apps/logic/connections">
+ Linear, GitHub, Slack 등 서드파티 서비스를 위해 앱이 보유한 OAuth 자격 증명입니다.
+ </Card>
+</CardGroup>
+
+## 한눈에 보는 트리거 유형
+
+로직 함수는 하나 이상의 트리거를 선택합니다. 아래의 각 항목은 `defineLogicFunction()`의 개별 필드입니다:
+
+| 트리거 | 실행 시점 | 설정 |
+| -------------- | ---------------------------------------------- | ------------------------------- |
+| **HTTP 경로** | 요청이 `/s/\<path>` 엔드포인트에 도달할 때 | `httpRouteTriggerSettings` |
+| **크론** | CRON 표현식이 일치할 때 | `cronTriggerSettings` |
+| **데이터베이스 이벤트** | 워크스페이스 레코드가 생성, 업데이트 또는 삭제될 때 | `databaseEventTriggerSettings` |
+| **AI 도구** | Twenty AI 기능이 사용자의 함수를 호출하기로 결정할 때 | `toolTriggerSettings` |
+| **워크플로우 액션** | 워크플로우 단계가 사용자의 함수를 호출할 때 | `workflowActionTriggerSettings` |
+
+함수는 격리된 Node.js 프로세스의 샌드박스 환경에서 실행되며, [`defineApplication()`](/l/ko/developers/extend/apps/config/application)에 선언된 역할 범위에 맞춰 지정된 타입의 API 클라이언트를 통해 워크스페이스에 접근합니다.
+
+<Note>
+**설치 시점 후크** — 설치 전후에 실행되는 코드 — 는 동일한 런타임을 공유하지만, 별도의 define 함수들을 사용하며 [Config → Install Hooks](/l/ko/developers/extend/apps/config/install-hooks) 아래에 위치합니다.
+</Note>
diff --git a/packages/twenty-docs/l/ko/developers/extend/apps/logic/skills-and-agents.mdx b/packages/twenty-docs/l/ko/developers/extend/apps/logic/skills-and-agents.mdx
new file mode 100644
index 00000000000..b858c2bd339
--- /dev/null
+++ b/packages/twenty-docs/l/ko/developers/extend/apps/logic/skills-and-agents.mdx
@@ -0,0 +1,138 @@
+---
+title: 스킬 & 에이전트
+description: 앱용 AI 스킬 및 에이전트 정의.
+icon: robot
+---
+
+<Warning>
+ 스킬과 에이전트는 현재 알파 단계입니다. 해당 기능은 작동하지만 아직 발전 중입니다.
+</Warning>
+
+앱은 워크스페이스 내에서 동작하는 AI 기능을 정의할 수 있습니다 — 재사용 가능한 스킬 지침과 사용자 지정 시스템 프롬프트를 갖춘 에이전트.
+
+<AccordionGroup>
+<Accordion title="defineSkill" description="AI 에이전트 스킬 정의">
+
+스킬은 워크스페이스 내에서 AI 에이전트가 사용할 수 있는 재사용 가능한 지침과 기능을 정의합니다. `defineSkill()`을 사용해 내장 검증과 함께 스킬을 정의하세요:
+
+```ts src/skills/example-skill.ts
+import { defineSkill } from 'twenty-sdk/define';
+
+export default defineSkill({
+ universalIdentifier: 'a1b2c3d4-e5f6-7890-abcd-ef1234567890',
+ name: 'sales-outreach',
+ label: 'Sales Outreach',
+ description: 'Guides the AI agent through a structured sales outreach process',
+ icon: 'IconBrain',
+ content: `You are a sales outreach assistant. When reaching out to a prospect:
+1. Research the company and recent news
+2. Identify the prospect's role and likely pain points
+3. Draft a personalized message referencing specific details
+4. Keep the tone professional but conversational`,
+});
+```
+
+핵심 요점:
+* `name`은 스킬의 고유 식별자 문자열입니다(케밥 케이스 권장).
+* `label`은 UI에 표시되는 사람이 읽기 쉬운 표시 이름입니다.
+* `content`에는 스킬 지침이 포함됩니다 — 이는 AI 에이전트가 사용하는 텍스트입니다.
+* `icon` (선택 사항)은 UI에 표시되는 아이콘을 설정합니다.
+* `description` (선택 사항)은 스킬의 목적에 대한 추가 컨텍스트를 제공합니다.
+
+</Accordion>
+<Accordion title="defineAgent" description="사용자 지정 프롬프트로 AI 에이전트를 정의하세요">
+
+에이전트는 워크스페이스 내에서 동작하는 AI 비서입니다. `defineAgent()`를 사용하여 사용자 지정 시스템 프롬프트로 에이전트를 생성하세요:
+
+```ts src/agents/example-agent.ts
+import { defineAgent } from 'twenty-sdk/define';
+
+export default defineAgent({
+ universalIdentifier: 'b3c4d5e6-f7a8-9012-bcde-f34567890123',
+ name: 'sales-assistant',
+ label: 'Sales Assistant',
+ description: 'Helps the sales team draft outreach emails and research prospects',
+ icon: 'IconRobot',
+ prompt: 'You are a helpful sales assistant. Help users with their questions and tasks.',
+});
+```
+
+핵심 요점:
+* `name`은 에이전트의 고유 식별자 문자열입니다(케밥 케이스 권장).
+* `label`은 UI에 표시되는 표시 이름입니다.
+* `prompt`는 에이전트의 동작을 정의하는 시스템 프롬프트입니다.
+* `description` (선택 사항)은 에이전트가 수행하는 작업에 대한 컨텍스트를 제공합니다.
+* `icon` (선택 사항)은 UI에 표시되는 아이콘을 설정합니다.
+* `modelId` (선택 사항)은 에이전트가 사용하는 기본 AI 모델을 재정의합니다.
+* `responseFormat`(선택 사항)은 에이전트 출력의 형태를 제어합니다. 자유 형식 텍스트의 기본값은 `{ type: 'text' }`입니다. 구조화된 JSON 출력을 강제하려면 `{ type: 'json', schema }`를 사용하세요.
+
+기본적으로 에이전트는 자유 형식 텍스트를 반환합니다. 구조화된 출력을 받으려면, `responseFormat`을 `{ type: 'json' }`으로 설정하고 `schema`를 제공하세요:
+
+```ts src/agents/structured-agent.ts
+import { defineAgent } from 'twenty-sdk/define';
+
+export default defineAgent({
+ universalIdentifier: 'c4d5e6f7-a8b9-0123-cdef-456789012345',
+ name: 'lead-scorer',
+ label: 'Lead Scorer',
+ prompt: 'Score the lead and explain your reasoning.',
+ responseFormat: {
+ type: 'json',
+ schema: {
+ type: 'object',
+ properties: {
+ score: { type: 'number', description: 'Lead score from 0 to 100' },
+ summary: { type: 'string', description: 'Short reasoning for the score' },
+ },
+ required: ['score', 'summary'],
+ additionalProperties: false,
+ },
+ },
+});
+```
+
+스키마 참고:
+* 스키마는 단일 수준의 객체입니다. 각 속성의 `type`은 반드시 기본형(`string`, `number`, 또는 `boolean`)이어야 합니다. 중첩 객체와 배열은 지원되지 않습니다.
+* 각 속성의 `description`(선택 사항)은 해당 위치에 무엇을 넣어야 하는지 모델을 안내합니다.
+* `required` (선택 사항)은 모델이 항상 반환해야 하는 속성을 나열합니다.
+* `additionalProperties: false` (선택 사항)은 `properties`에 선언되지 않은 모든 속성을 금지합니다.
+
+</Accordion>
+<Accordion title="runAgent" description="로직 함수에서 에이전트를 실행">
+
+`runAgent()`를 사용하면 로직 함수가 앱의 에이전트(해당 skills 및 tools 포함) 중 하나를 실행할 수 있습니다. `defineAgent()`에 전달했던 `universalIdentifier`로 에이전트를 식별합니다:
+
+```ts src/logic-functions/run-enricher.ts
+import { runAgent } from 'twenty-sdk/logic-function';
+
+const { result, error, success } = await runAgent({
+ agentUniversalIdentifier: 'b3c4d5e6-f7a8-9012-bcde-f34567890123',
+ prompt: 'Enrich House Ad <recordId>: fill empty fields from its listing URL.',
+});
+```
+
+핵심 요점:
+* 에이전트는 **동기적으로** 실행되며, 자체 tools를 통해 레코드를 읽고/업데이트할 수 있습니다. 실행이 완료되면 `runAgent()`가 resolve됩니다.
+* 앱은 자신의 에이전트만 실행할 수 있습니다.
+* 앱의 [기본 역할](/l/ko/developers/extend/apps/config/roles)은 `AI` 권한 플래그를 부여해야 합니다. 이를 위해 `permissionFlagUniversalIdentifiers`에 `SystemPermissionFlag.AI`를 추가하거나, `canAccessAllTools: true`로 설정하세요.
+ 이 권한이 없으면 `runAgent()`는 권한 오류로 실패합니다.
+* 로직 함수에 충분히 큰 `timeoutSeconds`를 설정하세요. 에이전트 실행에는 여러 초가 걸릴 수 있습니다.
+* 실행이 완료되면 `success`는 `true`이고 `result`는 null이 아닙니다. 실패 시 `success`는 `false`, `result`는 `null`이며, `error`에 이유가 들어 있습니다(예: 실행 도중 워크스페이스의 AI 크레딧이 소진된 경우).
+
+```ts src/roles/default-role.ts
+import { defineApplicationRole, SystemPermissionFlag } from 'twenty-sdk/define';
+
+export default defineApplicationRole({
+ universalIdentifier: 'b648f87b-1d26-4961-b974-0908fd991061',
+ label: 'Default function role',
+ // runAgent() requires the AI permission flag on the app's default role.
+ permissionFlagUniversalIdentifiers: [SystemPermissionFlag.AI],
+});
+```
+
+<Warning>
+ **루프를 피하세요:** `*.updated` 데이터베이스 이벤트 트리거에서 `runAgent()`를 호출하고 에이전트가 동일한 레코드를 업데이트하는 경우, `updatedFields`를 에이전트가 절대 쓰지 않는 필드(예: 원본 URL)로 한정하거나, `runAgent()`를 호출하기 전에 대상 필드 중 어느 것이든 아직 비어 있는지 여부를 검사해 가드하세요.
+</Warning>
+
+</Accordion>
+</AccordionGroup>
diff --git a/packages/twenty-docs/l/ko/developers/extend/apps/operations/cli.mdx b/packages/twenty-docs/l/ko/developers/extend/apps/operations/cli.mdx
new file mode 100644
index 00000000000..43f93e4b06f
--- /dev/null
+++ b/packages/twenty-docs/l/ko/developers/extend/apps/operations/cli.mdx
@@ -0,0 +1,105 @@
+---
+title: CLI
+description: "`yarn twenty`는 함수를 실행하고, 로그를 스트리밍하며, 앱 설치를 관리하고, 리모트를 전환하기 위한 명령들을 제공합니다."
+icon: 터미널
+---
+
+`dev`, `dev:build`, `dev:add`, `dev:typecheck` 외에도, `yarn twenty` CLI는 함수 실행, 로그 보기, 앱 설치 관리용 명령을 제공합니다.
+
+## 함수 실행(`yarn twenty dev:function:exec`)
+
+HTTP, 크론, 데이터베이스 이벤트로 트리거하지 않고 로직 함수를 수동으로 실행하세요:
+
+```bash filename="Terminal"
+# Execute by function name
+yarn twenty dev:function:exec -n create-new-post-card
+
+# Execute by universalIdentifier
+yarn twenty dev:function:exec -u e56d363b-0bdc-4d8a-a393-6f0d1c75bdcf
+
+# Pass a JSON payload
+yarn twenty dev:function:exec -n create-new-post-card -p '{"name": "Hello"}'
+
+# Execute the post-install function
+yarn twenty dev:function:exec --postInstall
+```
+
+## 함수 로그 보기(`yarn twenty dev:function:logs`)
+
+앱의 로직 함수 실행 로그를 스트리밍합니다:
+
+```bash filename="Terminal"
+# Stream all function logs
+yarn twenty dev:function:logs
+
+# Filter by function name
+yarn twenty dev:function:logs -n create-new-post-card
+
+# Filter by universalIdentifier
+yarn twenty dev:function:logs -u e56d363b-0bdc-4d8a-a393-6f0d1c75bdcf
+```
+
+<Note>
+이는 Docker 컨테이너 로그를 표시하는 `yarn twenty docker:logs`와는 다릅니다. `yarn twenty dev:function:logs`는 Twenty 서버에서 앱의 함수 실행 로그를 표시합니다.
+</Note>
+
+## 타입이 지정된 클라이언트(`yarn twenty dev:generate-client`) 생성하기
+
+앱을 빌드하거나 동기화하지 않고, 활성 원격의 스키마로부터 타입이 지정된 API 클라이언트(`twenty-client-sdk`)를 다시 생성합니다. 이를 사용해 별도 리포지토리에 존재하는 백엔드 서비스처럼, Twenty 인스턴스와 통신하는 어떤 프로젝트에서든 타입이 지정된 클라이언트를 얻을 수 있습니다:
+
+```bash filename="Terminal"
+# In your project (no Twenty app definition required)
+yarn add twenty-sdk twenty-client-sdk
+
+# Connect to the Twenty instance to generate the client from
+yarn twenty remote:add
+
+# Generate the typed client into node_modules/twenty-client-sdk
+yarn twenty dev:generate-client
+```
+
+그런 다음 코드에서 클라이언트를 임포트하세요:
+
+```typescript
+import { CoreApiClient } from 'twenty-client-sdk/core';
+```
+
+데이터 모델이 변경될 때마다 생성된 타입을 갱신하려면 명령을 다시 실행하세요.
+
+<Note>
+클라이언트는 `node_modules` 내부에서 생성되므로, 코드와 함께 커밋되지 않습니다. 매번 설치 후(`postinstall` 스크립트나 CI 등) `yarn twenty dev:generate-client`를 실행하세요.
+</Note>
+
+## 앱 제거(`yarn twenty app:uninstall`)
+
+활성 워크스페이스에서 앱을 제거하세요:
+
+```bash filename="Terminal"
+yarn twenty app:uninstall
+
+# Skip the confirmation prompt
+yarn twenty app:uninstall --yes
+```
+
+## 리모트 관리
+
+**리모트**는 앱이 연결하는 Twenty 서버를 의미합니다. 설정 과정에서 스캐폴더가 자동으로 하나를 생성합니다. 언제든지 리모트를 추가하거나 전환할 수 있습니다.
+
+```bash filename="Terminal"
+# Add a new remote (opens a browser for OAuth login)
+yarn twenty remote:add
+
+# Connect to a local Twenty server (auto-detects port 2020 or 3000)
+yarn twenty remote:add --local
+
+# Add a remote non-interactively (useful for CI)
+yarn twenty remote:add --url https://your-twenty-server.com --api-key $TWENTY_API_KEY --as my-remote
+
+# List all configured remotes
+yarn twenty remote:list
+
+# Set the active remote
+yarn twenty remote:use <name>
+```
+
+자격 증명은 `~/.twenty/config.json`에 저장됩니다.
diff --git a/packages/twenty-docs/l/ko/developers/extend/apps/operations/overview.mdx b/packages/twenty-docs/l/ko/developers/extend/apps/operations/overview.mdx
new file mode 100644
index 00000000000..13808fbc8f8
--- /dev/null
+++ b/packages/twenty-docs/l/ko/developers/extend/apps/operations/overview.mdx
@@ -0,0 +1,32 @@
+---
+title: 개요
+description: 앱을 빌드하고, 테스트하며, 배포하세요 — CLI 명령, 통합 테스트, CI, 그리고 서버 또는 npm으로의 게시까지 포함됩니다.
+icon: rocket
+---
+
+\*\*운영 계층(operations layer)\*\*은 앱을 *사용하는 것*이 아니라 앱에 *수행하는* 모든 작업을 의미합니다. 예를 들어 CLI 명령 실행, 실제 Twenty 서버를 대상으로 한 통합 테스트 실행, CI 구성, 그리고 단일 서버에 배포되는 tarball로 또는 마켓플레이스에 등록되는 npm 패키지로 릴리스를 배포하는 작업 등이 여기에 포함됩니다.
+
+```text
+ develop ─▶ test ─▶ build ─▶ deploy / publish
+ ─────── ──── ───── ─────────────────
+ yarn yarn yarn yarn twenty app:publish --private (tarball → one server)
+ twenty test twenty
+ dev dev:build yarn twenty app:publish (npm → marketplace)
+```
+
+## 이 섹션에서 다루는 내용
+
+<CardGroup cols={2}>
+ <Card title="CLI" icon="터미널" href="/l/ko/developers/extend/apps/operations/cli">
+ `yarn twenty` 참고 — exec, logs, uninstall, remotes.
+ </Card>
+ <Card title="동기화 및 복구" icon="나침반" href="/l/ko/developers/extend/apps/operations/sync-and-recovery">
+ 동기화 차분을 읽을 때 어떤 명령을 사용할지와 복구 단계에 대해 다룹니다.
+ </Card>
+ <Card title="테스트" icon="flask" href="/l/ko/developers/extend/apps/operations/testing">
+ Vitest 설정, 통합 테스트, 타입 체크, CI 워크플로.
+ </Card>
+ <Card title="게시" icon="업로드" href="/l/ko/developers/extend/apps/operations/publishing">
+ 빌드, tarball 배포, npm 게시, 설치.
+ </Card>
+</CardGroup>
diff --git a/packages/twenty-docs/l/ko/developers/extend/apps/operations/publishing.mdx b/packages/twenty-docs/l/ko/developers/extend/apps/operations/publishing.mdx
new file mode 100644
index 00000000000..f6dac720869
--- /dev/null
+++ b/packages/twenty-docs/l/ko/developers/extend/apps/operations/publishing.mdx
@@ -0,0 +1,294 @@
+---
+title: 게시
+icon: 업로드
+description: Twenty 앱을 마켓플레이스에 배포하거나 내부에 배포하세요.
+---
+
+## 개요
+
+앱을 [로컬에서 빌드하고 테스트](/l/ko/developers/extend/apps/getting-started/concepts)하면, 배포 경로는 두 가지입니다:
+
+* **타르볼 배포** — 내부 또는 비공개 사용을 위해 특정 Twenty 서버에 앱을 직접 업로드합니다.
+* **npm에 게시** — 모든 워크스페이스가 검색하고 설치할 수 있도록 Twenty 마켓플레이스에 앱을 등재합니다.
+
+두 경로는 동일한 **build** 단계에서 시작합니다.
+
+## 앱 빌드
+
+앱을 컴파일하고 배포 준비가 된 `manifest.json`을 생성하려면 빌드 명령을 실행하세요:
+
+```bash filename="Terminal"
+yarn twenty dev:build
+```
+
+이는 TypeScript 소스를 컴파일하고, 로직 함수와 프런트 컴포넌트를 트랜스파일하며, 모든 항목을 `.twenty/output/`에 기록합니다. 수동 배포 또는 publish 명령을 위한 `.tgz` 패키지도 생성하려면 `--tarball`을 추가하세요.
+
+## 서버에 배포(타르볼)
+
+공개하고 싶지 않은 앱 — 독점 도구, 엔터프라이즈 전용 통합 또는 실험적 빌드 — 의 경우, 타르볼을 Twenty 서버에 직접 배포할 수 있습니다.
+
+### 사전 준비
+
+배포 전에 대상 서버를 가리키도록 구성된 원격이 필요합니다. 원격은 서버 URL과 인증 자격 증명을 로컬의 `~/.twenty/config.json`에 저장합니다.
+
+원격 추가:
+
+```bash filename="Terminal"
+yarn twenty remote:add --url https://your-twenty-server.com --as production
+```
+
+### 배포
+
+앱을 한 번에 빌드하여 서버에 업로드:
+
+```bash filename="Terminal"
+yarn twenty app:publish --private
+# To deploy to a specific remote:
+# yarn twenty app:publish --private --remote production
+```
+
+### 배포된 앱 공유
+
+<Warning>
+워크스페이스 간에 비공개(타르볼) 앱을 공유하는 것은 **엔터프라이즈** 기능입니다. 워크스페이스에 유효한 엔터프라이즈 키가 있을 때까지 **Distribution** 탭에는 공유 컨트롤 대신 업그레이드 프롬프트가 표시됩니다. 이를 활성화하려면 [설정 > 관리자 패널 > 엔터프라이즈](/settings/admin-panel#enterprise)로 이동하세요.
+</Warning>
+
+타르볼 앱은 공개 마켓플레이스에 나열되지 않으므로, 동일한 서버의 다른 워크스페이스는 탐색만으로는 이를 찾을 수 없습니다. 워크스페이스가 Enterprise 플랜을 사용 중이면, 배포된 앱을 다음과 같이 공유할 수 있습니다:
+
+1. **설정 > 애플리케이션 > 등록**으로 이동하여 앱을 엽니다
+2. **Distribution** 탭에서 **공유 링크 복사**를 클릭합니다
+3. 이 링크를 다른 워크스페이스의 사용자와 공유하세요 — 해당 앱의 설치 페이지로 바로 이동합니다
+
+공유 링크는 서버의 기본 URL(워크스페이스 하위 도메인 없이)을 사용하므로 서버의 모든 워크스페이스에서 동작합니다.
+
+### 버전 관리
+
+이미 배포된 타르볼 앱을 업데이트할 때, 서버는 `package.json`의 `version`이 현재 배포된 버전보다 [semver](https://semver.org) 순서 기준으로 엄격히 더 높아야 합니다. 동일한 버전을 다시 배포하거나 더 낮은 버전을 푸시하는 경우, 타르볼이 저장되기 전에 거부됩니다 — CLI에서 `VERSION_ALREADY_EXISTS` 오류가 표시됩니다.
+
+업데이트를 릴리스하려면:
+
+1. `package.json`의 `version` 필드를 올리세요(예: `1.2.3` → `1.2.4`, `1.3.0`, 또는 `2.0.0`)
+2. `yarn twenty app:publish --private`(또는 `yarn twenty app:publish --private --remote production`)를 실행합니다.
+3. 앱을 설치한 워크스페이스는 설정에서 사용 가능한 업그레이드를 확인할 수 있습니다
+
+<Note>
+프리릴리스 태그는 예상대로 동작합니다: `1.0.0-rc.1` → `1.0.0-rc.2`로 올리는 것은 허용되며, `1.0.0`과 같은 최종 릴리스는 `1.0.0-rc.5`보다 더 높은 버전으로 올바르게 인식됩니다. `package.json`의 버전은 유효한 semver 문자열이어야 합니다.
+</Note>
+
+{/* TODO: add screenshot of the Upgrade button */}
+
+### 서버 버전 호환성
+
+앱이 특정 Twenty 서버 버전에서 도입된 기능(예: v2.3.0에 추가된 OAuth 공급자)을 사용한다면, `package.json`의 `engines.twenty` 필드를 사용하여 앱에 필요한 최소 서버 버전을 선언해야 합니다:
+
+```json filename="package.json"
+{
+ "name": "twenty-my-app",
+ "version": "1.0.0",
+ "engines": {
+ "node": "^24.5.0",
+ "twenty": ">=2.3.0"
+ }
+}
+```
+
+값은 표준 [semver 범위](https://github.com/npm/node-semver#ranges)입니다. 일반적인 패턴:
+
+| 범위 | 의미 |
+| ---------------------------------- | -------------------------------------- |
+| `>=2.3.0` | 2.3.0 이상인 모든 서버 |
+| `>=2.3.0 \<3.0.0` | 2.3.0 이상이지만 다음 메이저 버전 미만 |
+| `^2.3.0` | `>=2.3.0 \<3.0.0`과 동일 |
+
+**배포 및 설치 시 동작:**
+
+* `engines.twenty`가 설정되어 있고 대상 서버의 버전이 해당 범위를 충족하지 않으면, 배포(tarball 업로드) 또는 설치가 `SERVER_VERSION_INCOMPATIBLE` 오류와 함께 거부되며 필요한 범위와 실제 서버 버전을 모두 나타내는 메시지가 표시됩니다.
+* `engines.twenty`가 **설정되어 있지 않으면**, 앱은 모든 서버 버전에서 허용됩니다(기존 앱과 하위 호환).
+* 서버에 `APP_VERSION`이 구성되어 있지 않으면, 검사가 생략됩니다.
+
+<Note>
+서버가 최종 검증을 수행합니다 — 타르볼 업로드와 워크스페이스 설치 모두에서 `engines.twenty`를 검증합니다. 타르볼을 별도 경로로 배포하거나 마켓플레이스에서 설치하더라도, 서버는 여전히 호환성을 강제합니다.
+</Note>
+
+## 자동화된 CI/CD (스캐폴드된 워크플로)
+
+`create-twenty-app`으로 생성된 앱은 `.github/workflows/` 아래에 기본으로 두 개의 GitHub Actions 워크플로가 포함되어 있습니다. 저장소를 GitHub에 푸시하는 즉시 실행할 준비가 되어 있습니다 — CI에는 추가 설정이 필요 없고, CD에는 단 하나의 시크릿만 필요합니다.
+
+### CI — `ci.yml`
+
+`main`으로의 푸시와 풀 리퀘스트마다 통합 테스트를 자동으로 실행합니다.
+
+**하는 일:**
+
+1. 앱의 소스 코드를 체크아웃합니다.
+2. `twentyhq/twenty/.github/actions/spawn-twenty-app-dev-test@main` 컴포지트 액션을 사용해 격리된 Twenty 테스트 인스턴스를 생성합니다(CI에서 `yarn twenty docker:start --test`와 동등합니다).
+3. Corepack을 활성화하고, `.nvmrc`에 따라 Node.js를 설정하며, `yarn install --immutable`로 의존성을 설치합니다.
+4. 생성된 인스턴스에서 `TWENTY_API_URL`과 `TWENTY_API_KEY`를 전달하여 실제 서버와 통신할 수 있도록 `yarn test`를 실행합니다.
+
+**구성 옵션:**
+
+* `TWENTY_VERSION`(환경 변수, 기본값 `latest`) — `ci.yml`에서 이 값을 수정하여 CI에서 사용하는 Twenty 서버 버전을 고정합니다.
+* 동시 실행은 `github.ref`로 그룹화되며, 새 푸시가 발생하면 진행 중인 실행을 취소합니다.
+
+시크릿이 필요하지 않습니다 — 테스트 인스턴스는 일시적이며 작업이 진행되는 동안에만 존재합니다.
+
+### CD — `cd.yml`
+
+매번 `main`으로 푸시될 때 구성된 Twenty 서버에 앱을 배포하며, `deploy` 라벨이 적용된 경우 풀 리퀘스트에서도 선택적으로 배포합니다.
+
+**하는 일:**
+
+1. 라벨이 지정된 PR의 경우 PR 헤드, 아니면 푸시된 커밋을 체크아웃합니다.
+2. `twentyhq/twenty/.github/actions/deploy-twenty-app@main`를 실행합니다 — CI에서의 `yarn twenty app:publish --private`에 해당합니다.
+3. `twentyhq/twenty/.github/actions/install-twenty-app@main`를 실행하여 새로 배포된 버전을 대상 워크스페이스에 설치합니다.
+
+**필수 구성:**
+
+| 설정 | 위치 | 목적 |
+| ----------------------- | --------------------------------------------------------- | ------------------------------------------------ |
+| `TWENTY_DEPLOY_URL` | `cd.yml`의 `env`(기본값 `http://localhost:3000`) | 배포 대상 Twenty 서버입니다. 처음 사용하기 전에 실제 서버 URL로 변경하세요. |
+| `TWENTY_DEPLOY_API_KEY` | GitHub 저장소 **Settings → Secrets and variables → Actions** | 대상 서버에서 배포 권한이 있는 API 키입니다. |
+
+<Note>
+기본 `TWENTY_DEPLOY_URL` 값 `http://localhost:3000`은 플레이스홀더이며 — GitHub 호스팅 러너에서는 아무 곳에도 도달하지 않습니다. CD를 활성화하기 전에 서버의 퍼블릭 URL로 업데이트하세요(또는 네트워크에 접근 가능한 셀프 호스티드 러너를 사용하세요).
+</Note>
+
+**PR에서 프리뷰 배포 트리거하기:**
+
+풀 리퀘스트에 `deploy` 라벨을 추가하세요. `cd.yml`의 `if:` 가드는 해당 PR의 헤드 커밋을 사용해 그 PR에 대한 잡을 실행하므로, 머지 전에 대상 서버에서 변경 사항을 검증할 수 있습니다.
+
+### 재사용 가능한 액션 고정하기
+
+두 워크플로 모두 `@main`의 재사용 가능한 액션을 참조하므로, `twentyhq/twenty` 저장소의 액션 업데이트가 자동으로 반영됩니다. 결정적 빌드를 원한다면, 각 `uses:` 줄에서 `@main`을 커밋 SHA 또는 릴리스 태그로 바꾸세요.
+
+## npm에 게시
+
+npm에 게시하면 Twenty 마켓플레이스에서 앱을 찾을 수 있게 됩니다. 모든 Twenty 워크스페이스는 UI에서 바로 마켓플레이스 앱을 탐색, 설치 및 업그레이드할 수 있습니다.
+
+### 요구 사항
+
+* [npm](https://www.npmjs.com) 계정
+* `package.json`의 `keywords` 배열에 있는 `twenty-app` 키워드(수동으로 추가하세요 — `create-twenty-app` 템플릿에 기본적으로 포함되어 있지 않습니다)
+
+```json filename="package.json"
+{
+ "name": "twenty-app-postcard-sender",
+ "version": "1.0.0",
+ "keywords": ["twenty-app"]
+}
+```
+
+### 마켓플레이스 메타데이터
+
+`defineApplication()` 구성은 마켓플레이스에서 앱이 표시되는 방식을 제어하는 선택적 필드를 지원합니다. `public/` 폴더의 이미지를 참조하려면 `logoUrl`과 `screenshots`를 사용하세요:
+
+```ts src/application-config.ts
+export default defineApplication({
+ universalIdentifier: '...',
+ displayName: 'My App',
+ description: 'A great app',
+ logoUrl: 'public/logo.png',
+ screenshots: [
+ 'public/screenshot-1.png',
+ 'public/screenshot-2.png',
+ ],
+});
+```
+
+마켓플레이스 필드 전체 목록(`author`, `category`, `aboutDescription`, `websiteUrl`, `termsUrl` 등)은 Building Apps 페이지의 [defineApplication 아코디언](/l/ko/developers/extend/apps/config/application#marketplace-metadata)을 참조하세요.
+
+#### 권장 스크린샷 크기
+
+마켓플레이스는 `screenshots`를 고정된 `8:5` 컨테이너에 렌더링합니다(예: `1600×1000 px`).
+
+<Note>
+어떤 종횡비의 스크린샷이든 전체가 표시되며 잘리지 않습니다. 그러나 `8:5`보다 훨씬 세로로 길거나 가로로 좁은 경우 양쪽에 빈 띠가 표시됩니다.
+</Note>
+
+### 게시
+
+```bash filename="Terminal"
+yarn twenty app:publish
+```
+
+특정 dist-tag(예: `beta` 또는 `next`)로 게시하려면:
+
+```bash filename="Terminal"
+yarn twenty app:publish --tag beta
+```
+
+### 마켓플레이스 검색 방식
+
+Twenty 서버는 npm 레지스트리에서 마켓플레이스 카탈로그를 **매시간** 동기화합니다.
+
+기다리지 않고 즉시 동기화를 트리거할 수 있습니다:
+
+```bash filename="Terminal"
+yarn twenty dev:catalog-sync
+# To target a specific remote:
+# yarn twenty dev:catalog-sync --remote production
+```
+
+마켓플레이스에 표시되는 메타데이터는 `defineApplication()` 구성에서 가져옵니다 — `displayName`, `description`, `author`, `category`, `logoUrl`, `screenshots`, `aboutDescription`, `websiteUrl`, `termsUrl` 같은 필드입니다.
+
+<Note>
+앱에서 `defineApplication()`에 `aboutDescription`을 정의하지 않으면, 마켓플레이스는 소개 페이지 콘텐츠로 npm에 게시된 패키지의 `README.md`를 자동으로 사용합니다. 즉, npm과 Twenty 마켓플레이스 모두에서 하나의 README만 관리하면 됩니다. 마켓플레이스에서 다른 설명을 사용하려면 `aboutDescription`을 명시적으로 설정하세요.
+</Note>
+
+### CI 게시
+
+모든 릴리스마다 자동으로 게시하려면 이 GitHub Actions 워크플로를 사용하세요([OIDC](https://docs.npmjs.com/trusted-publishers) 사용):
+
+```yaml filename=".github/workflows/publish.yml"
+name: Publish
+on:
+ release:
+ types: [published]
+
+permissions:
+ contents: read
+ id-token: write
+
+jobs:
+ publish:
+ runs-on: ubuntu-latest
+ steps:
+ - uses: actions/checkout@v4
+ - uses: actions/setup-node@v4
+ with:
+ node-version: "24"
+ registry-url: https://registry.npmjs.org
+ - run: yarn install --immutable
+ - run: npx twenty dev:build
+ - run: npm publish --provenance --access public
+ working-directory: .twenty/output
+```
+
+다른 CI 시스템(GitLab CI, CircleCI 등)에서도 동일한 세 가지 명령을 사용합니다: `yarn install`, `yarn twenty dev:build`, 그리고 `.twenty/output`에서 `npm publish`.
+
+<Note>
+**npm provenance**는 선택 사항이지만 권장됩니다. `--provenance` 옵션으로 게시하면 npm 목록에 신뢰 배지가 추가되어, 사용자가 공개 CI 파이프라인의 특정 커밋에서 패키지가 빌드되었는지 확인할 수 있습니다. 설정 방법은 [npm provenance 문서](https://docs.npmjs.com/generating-provenance-statements)를 참고하세요.
+</Note>
+
+## 앱 설치
+
+앱이 게시(npm)되었거나 배포(타르볼)되면, 워크스페이스는 UI를 통해 이를 설치할 수 있습니다.
+
+Twenty UI의 **설정 > 애플리케이션** 페이지로 이동하면 마켓플레이스 앱과 타르볼로 배포된 앱을 모두 탐색하고 설치할 수 있습니다.
+
+{/* TODO: add screenshot of the UI when the app is registered */}
+
+명령줄에서 앱을 설치할 수도 있습니다:
+
+```bash filename="Terminal"
+yarn twenty app:install
+```
+
+<Note>
+서버는 설치 시 semver 버전 규칙을 강제하며, 배포와 동일한 규칙을 적용합니다:
+
+* 워크스페이스에 이미 설치된 것과 동일한 버전을 설치하려고 하면 `APP_ALREADY_INSTALLED` 오류와 함께 거부됩니다.
+* 현재 설치된 것보다 낮은 버전을 설치하려고 하면 `CANNOT_DOWNGRADE_APPLICATION` 오류와 함께 거부됩니다.
+
+더 최신 버전을 설치하려면 먼저 배포하거나 게시한 다음 `yarn twenty app:install`을 다시 실행하세요.
+</Note>
diff --git a/packages/twenty-docs/l/ko/developers/extend/apps/operations/sync-and-recovery.mdx b/packages/twenty-docs/l/ko/developers/extend/apps/operations/sync-and-recovery.mdx
new file mode 100644
index 00000000000..d0d8dd45733
--- /dev/null
+++ b/packages/twenty-docs/l/ko/developers/extend/apps/operations/sync-and-recovery.mdx
@@ -0,0 +1,111 @@
+---
+title: 동기화 및 복구
+description: 언제 어떤 명령을 사용할지, 동기화 출력 결과를 읽는 방법, 로컬 메타데이터가 완전 초기화에 이르기 전에 드리프트할 때를 위한 복구 단계별 절차를 다룹니다.
+icon: 나침반
+---
+
+로컬 앱 개발은 **동기화**를 중심으로 이루어집니다. CLI는 매니페스트를 다시 빌드하고, 서버는 워크스페이스에 이미 있는 메타데이터와의 차이만 적용합니다. 이 페이지에서는 어떤 명령을 사용할지, 동기화로 무엇이 변경되었는지 읽는 방법, 그리고 로컬 상태가 일관되지 않아 보일 때 순서대로 무엇을 해야 하는지를 설명합니다.
+
+## 언제 어떤 명령을 사용할지
+
+<Note>
+일상적인 로컬 반복 개발에서는 거의 항상 `yarn twenty dev`를 사용하면 됩니다. 배포와 게시(publish)는 릴리스를 배포할 때 사용하는 것이며, 로컬 개발 루프용이 **아닙니다**.
+</Note>
+
+| 원하는 작업… | 명령 | 노트 |
+| ---------------------------- | ----------------------------------- | ------------------------------------------------------------------------------------------------------------------- |
+| 라이브 동기화로 로컬에서 반복 개발 | `yarn twenty dev` | 파일을 감시하고 변경될 때마다 동기화합니다. |
+| 한 번만 동기화하고 종료 (CI, 스크립트, 훅) | `yarn twenty dev --once` | 한 번 빌드 + 동기화한 뒤 종료합니다. |
+| 변경 사항을 **실제로 적용하지 않고** 미리 보기 | `yarn twenty dev --once --dry-run` | 차이를 계산해 출력만 하고, 아무것도 기록하지 않습니다. |
+| 워크스페이스에서 앱 제거 | `yarn twenty app:uninstall` | 프롬프트를 건너뛰려면 `--yes`를 추가하세요. |
+| 타르볼을 서버로 전송 | `yarn twenty app:publish --private` | `package.json`의 버전이 **엄격하게 더 높아야** 합니다. 자세한 내용은 [Publishing](/l/ko/developers/extend/apps/operations/publishing)을 참고하세요. |
+| 마켓플레이스(npm)에 게시 | `yarn twenty app:publish` | — |
+| 배포된 버전 설치 / 업그레이드 | `yarn twenty app:install` | 현재 배포된 버전을 설치합니다. |
+| 로컬 서버를 초기화하고 깨끗하게 시작 | `yarn twenty docker:reset` | 로컬 데이터 **전체**를 삭제합니다. 최후의 수단입니다. |
+
+### 로컬 동기화에는 버전 증가가 필요 없음
+
+엄격히 증가하는 `version` 규칙(`deploy` 시 `VERSION_ALREADY_EXISTS`, `install` 시 `APP_ALREADY_INSTALLED` / `CANNOT_DOWNGRADE_APPLICATION`)은 **`app:publish` / `app:install`**, 즉 릴리스 경로에만 적용됩니다. `yarn twenty dev`는 매니페스트를 제자리에서 동기화하므로 버전을 변경할 필요가 없습니다. 따라서 반복 개발을 위해 `package.json`을 수정할 필요가 없습니다. 로컬 변경을 테스트하기 위해 버전을 올리고 있다면, 개발 루프가 아니라 릴리스 경로를 사용하고 있는 것입니다.
+
+## 동기화 출력 읽기
+
+각 동기화는 적용된(또는 `--dry-run`일 경우 적용될) 메타데이터 변경 사항을 출력합니다.
+
+```text filename="Terminal"
+Metadata changes: 2 created, 1 updated, 1 deleted
+ created objectMetadata rocket
+ created fieldMetadata timelineActivities
+ updated fieldMetadata launchedAt
+ deleted pageLayout legacyTab
+✓ Synced
+```
+
+이 출력이 1차 진단 도구입니다. 어떤 객체, 필드, 레이아웃이 변경되었는지 정확히 알려주므로, UI를 확인하기 전에 동기화가 예상대로 동작했는지 검증할 수 있습니다.
+
+동기화가 단일 엔티티에서 실패하면, 오류 메시지에 문제의 엔티티와 그 `universalIdentifier`가 함께 표시됩니다. 예를 들면 다음과 같습니다.
+
+```text
+Migration action 'create' for 'fieldMetadata' (universalIdentifier: 2020...4337) failed
+```
+
+그 식별자를 사용해 매니페스트(필요하다면 워크스페이스)에서 해당 엔티티를 찾아, 어떤 것이 충돌하는지 추측하지 말고 정확히 확인하세요.
+
+## 변경 사항 미리 보기(dry run)
+
+`yarn twenty dev --once --dry-run`은 매니페스트를 빌드하고, 서버에 마이그레이션 계획을 요청한 뒤, 이를 출력만 합니다. **아무것도 실제로 적용하지 않습니다**. "이 동기화로 무엇이 바뀔까?"에 안전하게 답할 수 있는 방법으로, 실제로 적용하기 전에 확인할 수 있습니다.
+
+```bash filename="Terminal"
+yarn twenty dev --once --dry-run
+```
+
+```text filename="Terminal"
+Building manifest...
+Computing metadata diff (dry run, nothing will be applied)...
+Metadata changes: 1 created, 1 updated
+ created fieldMetadata timelineActivities
+ updated objectMetadata rocket
+✓ Dry run complete for My App — no changes were applied
+```
+
+dry run은 다음과 같습니다.
+
+* **아무것도 기록하지 않습니다**. 메타데이터 마이그레이션, 애플리케이션 레코드 업데이트, 기본 역할/탭 변경, API 클라이언트 생성이 모두 수행되지 않습니다.
+* 실제 동기화에서 적용될 **동일한 diff**를 반환하므로, 생성/업데이트/삭제되는 엔티티를 미리 검토할 수 있습니다.
+* 위험한 변경 전에, AI가 생성한 변경 사항을 검토할 때, 또는 예기치 않은 변경이 적용되려 하면 실패해야 하는 스크립트에서 유용합니다.
+
+<Note>
+dry run은 **메타데이터** 변경만 미리 보여 주며, 앱이 최소 한 번 이상 동기화된 상태(워크스페이스가 이 앱을 알고 있는 상태)여야 합니다. 한 번도 동기화된 적이 없는 앱에 대해 dry run을 실행하면, 서버는 앱이 설치되지 않았다고 보고합니다. 먼저 `yarn twenty dev`를 한 번 실행하세요.
+</Note>
+
+## 복구 단계별 절차
+
+로컬 메타데이터가 잘못된 것처럼 보일 때는, 아래 순서대로 단계를 진행하면서 문제가 해결되는 즉시 멈추세요. 각 단계는 이전 단계보다 더 많은 영향을 미칩니다.
+
+1. **재동기화.** `yarn twenty dev --once`를 다시 실행하세요. 동기화는 멱등적이므로, 깨끗한 매니페스트를 다시 실행해도 안전하며 일시적인 오류가 이 방식으로 해결되는 경우가 많습니다.
+2. **계획 미리 보기.** `yarn twenty dev --once --dry-run`을 실행해, 다음 동기화가 정확히 무엇을 변경하려 하는지 실제로 적용하지 않고 확인하세요.
+3. **명시적인 오류 읽기.** 동기화가 실패하면, 메시지에 포함된 메타데이터 타입과 `universalIdentifier`(위 참조)를 확인한 뒤, 매니페스트에서 해당 엔티티를 찾으세요. 충돌은 보통 중복되었거나 재사용된 식별자를 가리킵니다.
+4. **삭제 후 재설치.** `yarn twenty app:uninstall`을 실행한 뒤, 다시 동기화합니다(`yarn twenty dev`). 이 방법은 워크스페이스의 나머지 부분은 그대로 둔 채, 앱의 메타데이터를 깨끗한 상태에서 다시 구축합니다.
+5. **전체 초기화(최후의 수단).** `yarn twenty docker:reset`을 실행한 뒤, 다시 시드하고 재동기화합니다.
+
+<Warning>
+`yarn twenty docker:reset`은 로컬 인스턴스의 **모든** 데이터를 삭제합니다. 모든 워크스페이스, 레코드, 앱이 제거됩니다. 이전 단계들이 모두 실패했을 때에만 사용하세요.
+</Warning>
+
+<Note>
+메타데이터 오류가 발생했나요? [이슈를 생성](https://github.com/twentyhq/twenty/issues/new/choose)해 주세요. 이때 실패한 마이그레이션 메시지(메타데이터 타입과 `universalIdentifier` 포함), 동기화 시 출력된 `Metadata changes`, 그리고 실행한 명령들을 함께 첨부해 주세요.
+</Note>
+
+## 하나의 워크스페이스에서 동시 동기화 피하기
+
+동기화는 메타데이터 마이그레이션을 적용합니다. **동일한 워크스페이스에 대해 동시에** 여러 번 동기화, 배포, 설치 작업을 실행하면(예: 여러 터미널이나 AI 에이전트가 병렬로 반복 실행하는 경우), 마이그레이션이 서로 얽혀 메타데이터가 부분적으로만 적용된 상태로 남을 수 있습니다.
+
+서버는 이를 방지하기 위해 워크스페이스별로 동기화를 직렬화하지만, 그럼에도 중요한 메타데이터 작업은 동시에 실행하지 말고 **단일** 프로세스를 통해 순차적으로 실행하는 것이 좋습니다. 여러 에이전트로 개발을 오케스트레이션한다면, 이들의 sync/deploy/install 호출을 하나의 큐로 모아 한 번에 하나씩만 실행되도록 하세요.
+
+## 실패 유형 구분하기
+
+문제가 발생했을 때, 메타데이터 diff와 명시적인 오류를 통해 실패 지점을 파악할 수 있습니다.
+
+* **매니페스트 빌드 오류** — 동기화 전에 CLI가 실패합니다(`MANIFEST_BUILD_FAILED`, `TYPECHECK_FAILED`). 앱 소스를 수정하세요.
+* **동기화 / 마이그레이션 오류** — 빌드는 성공했지만 diff를 적용하는 데 실패하며, 메시지에 엔티티와 `universalIdentifier`가 표시됩니다. 충돌하는 메타데이터를 수정하세요.
+* **앱 코드 런타임 오류** — 동기화는 성공했지만 로직 함수나 컴포넌트가 런타임에 올바르게 동작하지 않는 경우입니다. [function logs](/l/ko/developers/extend/apps/operations/cli)를 확인하세요.
+* **로컬 인스턴스 상태** — 위의 어느 경우에도 해당하지 않지만 워크스페이스가 여전히 잘못되어 보이는 경우입니다. 복구 사다리를 순서대로 따라가세요.
diff --git a/packages/twenty-docs/l/ko/developers/extend/apps/operations/testing.mdx b/packages/twenty-docs/l/ko/developers/extend/apps/operations/testing.mdx
new file mode 100644
index 00000000000..c17fde0c148
--- /dev/null
+++ b/packages/twenty-docs/l/ko/developers/extend/apps/operations/testing.mdx
@@ -0,0 +1,301 @@
+---
+title: 테스트
+description: Vitest 설정, 실제 Twenty 서버를 대상으로 한 통합 테스트, 타입 검사, 그리고 GitHub Actions를 사용하는 CI.
+icon: flask
+---
+
+SDK는 테스트 코드에서 앱을 빌드, 배포, 설치 및 제거할 수 있는 프로그래매틱 API를 제공합니다. 이것을 [Vitest](https://vitest.dev/) 및 타입이 지정된 API 클라이언트와 함께 사용하면 실제 Twenty 서버를 대상으로 앱이 종단 간으로 동작하는지 검증하는 통합 테스트를 작성할 수 있습니다.
+
+## npm 패키지 사용
+
+앱에서 원하는 npm 패키지를 설치해 사용할 수 있습니다. 로직 함수와 프런트 컴포넌트는 모두 [esbuild](https://esbuild.github.io/)로 번들되며, 모든 의존성이 출력물에 인라인됩니다 — 런타임에는 `node_modules`가 필요하지 않습니다.
+
+### 패키지 설치
+
+```bash filename="Terminal"
+yarn add axios
+```
+
+그런 다음 코드에서 임포트하세요:
+
+```ts src/logic-functions/fetch-data.ts
+import { defineLogicFunction } from 'twenty-sdk/define';
+import axios from 'axios';
+
+const handler = async (): Promise<any> => {
+ const { data } = await axios.get('https://api.example.com/data');
+
+ return { data };
+};
+
+export default defineLogicFunction({
+ universalIdentifier: '...',
+ name: 'fetch-data',
+ description: 'Fetches data from an external API',
+ timeoutSeconds: 10,
+ handler,
+});
+```
+
+프런트 컴포넌트에서도 동일하게 작동합니다:
+
+```tsx src/front-components/chart.tsx
+import { defineFrontComponent } from 'twenty-sdk/define';
+import { format } from 'date-fns';
+
+const DateWidget = () => {
+ return <p>Today is {format(new Date(), 'MMMM do, yyyy')}</p>;
+};
+
+export default defineFrontComponent({
+ universalIdentifier: '...',
+ name: 'date-widget',
+ component: DateWidget,
+});
+```
+
+### 번들링 동작 방식
+
+빌드 단계에서는 esbuild를 사용하여 로직 함수와 프런트 컴포넌트마다 단일 자체 포함 파일을 생성합니다. 모든 임포트된 패키지는 번들에 인라인됩니다.
+
+**로직 함수**는 Node.js 환경에서 실행됩니다. Node 기본 모듈(`fs`, `path`, `crypto`, `http` 등) 을(를) 사용할 수 있으며 설치할 필요가 없습니다.
+
+**프런트 컴포넌트**는 Web Worker에서 실행됩니다. Node 기본 모듈은 사용할 수 없습니다 — 브라우저 환경에서 동작하는 브라우저 API와 npm 패키지만 사용할 수 있습니다.
+
+두 환경 모두에서 `twenty-client-sdk/core`와 `twenty-client-sdk/metadata`가 사전 제공 모듈로 사용 가능합니다 — 이는 번들되지 않고 서버가 런타임에 해석합니다.
+
+## 설정
+
+스캐폴딩된 앱에는 이미 Vitest가 포함되어 있습니다. 수동으로 설정하는 경우, 의존성을 설치하세요:
+
+```bash filename="Terminal"
+yarn add -D vitest vite-tsconfig-paths
+```
+
+앱 루트에 `vitest.config.ts`를 생성하세요:
+
+```ts vitest.config.ts
+import tsconfigPaths from 'vite-tsconfig-paths';
+import { defineConfig } from 'vitest/config';
+
+export default defineConfig({
+ plugins: [
+ tsconfigPaths({
+ projects: ['tsconfig.spec.json'],
+ ignoreConfigErrors: true,
+ }),
+ ],
+ test: {
+ testTimeout: 120_000,
+ hookTimeout: 120_000,
+ include: ['src/**/*.integration-test.ts'],
+ setupFiles: ['src/__tests__/setup-test.ts'],
+ env: {
+ TWENTY_API_URL: 'http://localhost:2020',
+ TWENTY_API_KEY: 'your-api-key',
+ },
+ },
+});
+```
+
+테스트 실행 전에 서버에 접근 가능한지 확인하는 설정 파일을 생성하세요:
+
+```ts src/__tests__/setup-test.ts
+import * as fs from 'fs';
+import * as os from 'os';
+import * as path from 'path';
+import { beforeAll } from 'vitest';
+
+const TWENTY_API_URL = process.env.TWENTY_API_URL ?? 'http://localhost:2020';
+const TEST_CONFIG_DIR = path.join(os.tmpdir(), '.twenty-sdk-test');
+
+beforeAll(async () => {
+ // Verify the server is running
+ const response = await fetch(`${TWENTY_API_URL}/healthz`);
+
+ if (!response.ok) {
+ throw new Error(
+ `Twenty server is not reachable at ${TWENTY_API_URL}. ` +
+ 'Start the server before running integration tests.',
+ );
+ }
+
+ // Write a temporary config for the SDK
+ fs.mkdirSync(TEST_CONFIG_DIR, { recursive: true });
+
+ fs.writeFileSync(
+ path.join(TEST_CONFIG_DIR, 'config.json'),
+ JSON.stringify({
+ remotes: {
+ local: {
+ apiUrl: process.env.TWENTY_API_URL,
+ apiKey: process.env.TWENTY_API_KEY,
+ },
+ },
+ defaultRemote: 'local',
+ }, null, 2),
+ );
+});
+```
+
+## 프로그래매틱 SDK API
+
+`twenty-sdk/cli` 서브 경로는 테스트 코드에서 직접 호출할 수 있는 함수를 내보냅니다:
+
+| 함수 | 설명 |
+| -------------- | --------------------- |
+| `appBuild` | 앱을 빌드하고 필요하면 타르볼로 패키징 |
+| `appDeploy` | 타르볼을 서버로 업로드 |
+| `appInstall` | 활성 워크스페이스에 앱 설치 |
+| `appUninstall` | 활성 워크스페이스에서 앱 제거 |
+
+각 함수는 `success: boolean`과 `data` 또는 `error`를 포함한 결과 객체를 반환합니다.
+
+## 통합 테스트 작성
+
+다음은 앱을 빌드, 배포, 설치한 후 워크스페이스에 표시되는지 검증하는 전체 예제입니다:
+
+```ts src/__tests__/app-install.integration-test.ts
+import { APPLICATION_UNIVERSAL_IDENTIFIER } from 'src/application-config';
+import { appBuild, appDeploy, appInstall, appUninstall } from 'twenty-sdk/cli';
+import { MetadataApiClient } from 'twenty-client-sdk/metadata';
+import { afterAll, beforeAll, describe, expect, it } from 'vitest';
+
+const APP_PATH = process.cwd();
+
+describe('App installation', () => {
+ beforeAll(async () => {
+ const buildResult = await appBuild({
+ appPath: APP_PATH,
+ tarball: true,
+ onProgress: (message: string) => console.log(`[build] ${message}`),
+ });
+
+ if (!buildResult.success) {
+ throw new Error(`Build failed: ${buildResult.error?.message}`);
+ }
+
+ const deployResult = await appDeploy({
+ tarballPath: buildResult.data.tarballPath!,
+ onProgress: (message: string) => console.log(`[deploy] ${message}`),
+ });
+
+ if (!deployResult.success) {
+ throw new Error(`Deploy failed: ${deployResult.error?.message}`);
+ }
+
+ const installResult = await appInstall({ appPath: APP_PATH });
+
+ if (!installResult.success) {
+ throw new Error(`Install failed: ${installResult.error?.message}`);
+ }
+ });
+
+ afterAll(async () => {
+ await appUninstall({ appPath: APP_PATH });
+ });
+
+ it('should find the installed app in the workspace', async () => {
+ const metadataClient = new MetadataApiClient();
+
+ const result = await metadataClient.query({
+ findManyApplications: {
+ id: true,
+ name: true,
+ universalIdentifier: true,
+ },
+ });
+
+ const installedApp = result.findManyApplications.find(
+ (app: { universalIdentifier: string }) =>
+ app.universalIdentifier === APPLICATION_UNIVERSAL_IDENTIFIER,
+ );
+
+ expect(installedApp).toBeDefined();
+ });
+});
+```
+
+## 테스트 실행
+
+로컬 Twenty 서버가 실행 중인지 확인한 다음, 다음을 실행하세요:
+
+```bash filename="Terminal"
+yarn test
+```
+
+또는 개발 중에는 워치 모드로 실행하세요:
+
+```bash filename="Terminal"
+yarn test:watch
+```
+
+## 타입 검사
+
+테스트를 실행하지 않고도 앱에 대해 타입 검사를 수행할 수 있습니다:
+
+```bash filename="Terminal"
+yarn twenty dev:typecheck
+```
+
+이는 `tsc --noEmit`를 실행하고 모든 타입 오류를 보고합니다.
+
+## GitHub Actions로 CI
+
+스캐폴더가 `.github/workflows/ci.yml`에 바로 사용할 수 있는 GitHub Actions 워크플로를 생성합니다. `main`으로의 푸시와 풀 리퀘스트마다 통합 테스트를 자동으로 실행합니다.
+
+워크플로:
+
+1. 코드를 체크아웃합니다
+2. `twentyhq/twenty/.github/actions/spawn-twenty-docker-image` 액션을 사용해 임시 Twenty 서버를 구동합니다
+3. `yarn install --immutable`로 종속성을 설치합니다
+4. 액션 출력에서 주입된 `TWENTY_API_URL` 및 `TWENTY_API_KEY`로 `yarn test`를 실행합니다
+
+```yaml .github/workflows/ci.yml
+name: CI
+
+on:
+ push:
+ branches:
+ - main
+ pull_request: {}
+
+env:
+ TWENTY_VERSION: latest
+
+jobs:
+ test:
+ runs-on: ubuntu-latest
+ steps:
+ - name: Checkout
+ uses: actions/checkout@v4
+
+ - name: Spawn Twenty instance
+ id: twenty
+ uses: twentyhq/twenty/.github/actions/spawn-twenty-docker-image@main
+ with:
+ twenty-version: ${{ env.TWENTY_VERSION }}
+ github-token: ${{ secrets.GITHUB_TOKEN }}
+
+ - name: Enable Corepack
+ run: corepack enable
+
+ - name: Setup Node.js
+ uses: actions/setup-node@v4
+ with:
+ node-version-file: '.nvmrc'
+ cache: 'yarn'
+
+ - name: Install dependencies
+ run: yarn install --immutable
+
+ - name: Run integration tests
+ run: yarn test
+ env:
+ TWENTY_API_URL: ${{ steps.twenty.outputs.server-url }}
+ TWENTY_API_KEY: ${{ steps.twenty.outputs.access-token }}
+```
+
+별도의 시크릿을 구성할 필요가 없습니다 — `spawn-twenty-docker-image` 액션이 러너 내에서 일시적인 Twenty 서버를 직접 시작하고 연결 정보를 출력합니다. `GITHUB_TOKEN` 시크릿은 GitHub에서 자동으로 제공됩니다.
+
+`latest` 대신 특정 Twenty 버전을 고정하려면 워크플로 상단의 `TWENTY_VERSION` 환경 변수를 변경하세요.
diff --git a/packages/twenty-docs/l/ko/developers/extend/capabilities/apis.mdx b/packages/twenty-docs/l/ko/developers/extend/capabilities/apis.mdx
index e5dc9555a0b..7aa80a7d475 100644
--- a/packages/twenty-docs/l/ko/developers/extend/capabilities/apis.mdx
+++ b/packages/twenty-docs/l/ko/developers/extend/capabilities/apis.mdx
@@ -17,7 +17,7 @@ Twenty는 귀하의 데이터 모델에 맞는 API를 특별히 생성합니다:
* **맞춤형 문서**: 작업 공간의 데이터 모델에 맞게 특별히 생성됩니다.
<Note>
- 맞춤형 API 문서는 API 키 생성 후 **설정 → API 및 웹훅**에서 확인할 수 있습니다. Twenty가 사용자 지정 데이터 모델에 맞는 API를 생성하므로, 문서는 귀하의 워크스페이스에 고유합니다.
+맞춤형 API 문서는 API 키 생성 후 **설정 → API 및 웹훅**에서 확인할 수 있습니다. Twenty가 사용자 지정 데이터 모델에 맞는 API를 생성하므로, 문서는 귀하의 워크스페이스에 고유합니다.
</Note>
## 두 가지 API 유형
@@ -81,14 +81,14 @@ Authorization: Bearer YOUR_API_KEY
<VimeoEmbed videoId="928786722" title="API 키 생성" />
<Warning>
- API 키는 민감한 데이터에 대한 액세스를 부여합니다. 신뢰할 수 없는 서비스와 공유하지 마세요. 유출되었으면 즉시 비활성화하고 새 키를 생성하세요.
+API 키는 민감한 데이터에 대한 액세스를 부여합니다. 신뢰할 수 없는 서비스와 공유하지 마세요. 유출되었으면 즉시 비활성화하고 새 키를 생성하세요.
</Warning>
### API 키에 역할 할당
보안을 강화하려면 액세스를 제한할 특정 역할을 할당하세요:
-1. **설정 → 역할**로 이동
+1. **설정 → 구성원 → 역할**로 이동하세요
2. 할당할 역할을 클릭하세요
3. **배정** 탭 열기
4. **API 키**에서 **+ API 키에 할당**을 클릭하세요
@@ -143,5 +143,5 @@ REST와 GraphQL 모두 배치 작업을 지원합니다:
| **배치 크기** | 호출당 기록 60개 |
<Tip>
- 처리량을 극대화하려면 배치 작업을 사용하세요 — 개별 요청 대신 단일 API 호출로 최대 60개의 기록을 처리할 수 있습니다.
+처리량을 극대화하려면 배치 작업을 사용하세요 — 개별 요청 대신 단일 API 호출로 최대 60개의 기록을 처리할 수 있습니다.
</Tip>
diff --git a/packages/twenty-docs/l/ko/developers/extend/capabilities/webhooks.mdx b/packages/twenty-docs/l/ko/developers/extend/capabilities/webhooks.mdx
index b3f02627797..2627127d1b1 100644
--- a/packages/twenty-docs/l/ko/developers/extend/capabilities/webhooks.mdx
+++ b/packages/twenty-docs/l/ko/developers/extend/capabilities/webhooks.mdx
@@ -62,7 +62,7 @@ Twenty는 다음 이벤트 유형에 대해 웹훅을 전송합니다:
| `타임스탬프` | 이벤트가 발생한 시각(UTC) |
<Note>
- 수신을 확인하기 위해 **2xx HTTP 상태**(200-299)로 응답하세요. 2xx가 아닌 응답은 전달 실패로 기록됩니다.
+수신을 확인하기 위해 **2xx HTTP 상태**(200-299)로 응답하세요. 2xx가 아닌 응답은 전달 실패로 기록됩니다.
</Note>
## 웹훅 검증
diff --git a/packages/twenty-docs/l/ko/developers/extend/extend.mdx b/packages/twenty-docs/l/ko/developers/extend/extend.mdx
index fe0c7ed47b7..6036789d2df 100644
--- a/packages/twenty-docs/l/ko/developers/extend/extend.mdx
+++ b/packages/twenty-docs/l/ko/developers/extend/extend.mdx
@@ -1,7 +1,6 @@
---
title: 확장
description: API, 웹훅 및 맞춤형 앱으로 Twenty의 기능을 확장하세요.
-redirect: /developers/introduction
---
<Frame>
@@ -16,20 +15,18 @@ Twenty는 확장 가능하도록 설계되었습니다. 당사의 API, 웹훅
* **API**: REST 또는 GraphQL을 사용해 프로그래밍 방식으로 CRM 데이터를 쿼리하고 수정하세요
* **웹훅**: Twenty에서 이벤트가 발생하면 실시간 알림을 받으세요
-* **앱**: Twenty의 기능을 확장하는 맞춤형 앱을 구축하세요 - 곧 제공됩니다!
+* **앱**: Twenty의 기능을 확장하는 맞춤형 앱을 구축하세요
## 시작하기
<CardGroup cols={2}>
- <Card title="API" icon="코드" href="/l/ko/developers/api">
+ <Card title="API" icon="코드" href="/l/ko/developers/extend/api">
프로그래밍 방식으로 Twenty에 연결하세요
</Card>
-
- <Card title="웹훅" icon="bell" href="/l/ko/developers/webhooks">
+ <Card title="웹훅" icon="bell" href="/l/ko/developers/extend/webhooks">
이벤트에 대한 실시간 알림을 받으세요
</Card>
-
- <Card title="앱" icon="puzzle-piece" href="/l/ko/developers/apps/apps">
- 코드로 사용자 지정을 구축하세요(알파)
+ <Card title="앱" icon="puzzle-piece" href="/l/ko/developers/extend/apps/getting-started">
+ 코드로 사용자 지정을 구축하세요
</Card>
</CardGroup>
diff --git a/packages/twenty-docs/l/ko/developers/extend/oauth.mdx b/packages/twenty-docs/l/ko/developers/extend/oauth.mdx
new file mode 100644
index 00000000000..3f45d28c8a0
--- /dev/null
+++ b/packages/twenty-docs/l/ko/developers/extend/oauth.mdx
@@ -0,0 +1,189 @@
+---
+title: OAuth
+icon: 키
+description: 서버 간 액세스를 위한 PKCE가 포함된 권한 부여 코드 플로우와 클라이언트 자격 증명.
+---
+
+Twenty는 사용자 대상 앱에는 권한 부여 코드 + PKCE를, 서버 간 액세스에는 클라이언트 자격 증명을 사용하여 OAuth 2.0을 구현합니다. 클라이언트는 [RFC 7591](https://datatracker.ietf.org/doc/html/rfc7591)에 따라 동적으로 등록되며 — 대시보드에서 수동 설정은 필요하지 않습니다.
+
+## OAuth 사용 시기
+
+| 시나리오 | 인증 방식 |
+| ------------------- | ---------------------------------------------------------------- |
+| 내부 스크립트, 자동화 | [API 키](/l/ko/developers/extend/api#authentication) |
+| 사용자를 대신하여 동작하는 외부 앱 | **OAuth — 권한 부여 코드** |
+| 서버 간, 사용자 컨텍스트 없음 | **OAuth — 클라이언트 자격 증명** |
+| UI 확장이 포함된 Twenty 앱 | [앱](/l/ko/developers/extend/apps/getting-started) (OAuth는 자동으로 처리됩니다) |
+
+## 클라이언트 등록
+
+Twenty는 [RFC 7591](https://datatracker.ietf.org/doc/html/rfc7591)에 따라 **동적 클라이언트 등록**을 지원합니다. 수동 설정이 필요 없습니다 — 프로그래밍 방식으로 등록하세요:
+
+```bash
+POST /oauth/register
+Content-Type: application/json
+
+{
+ "client_name": "My Integration",
+ "redirect_uris": ["https://myapp.com/callback"],
+ "grant_types": ["authorization_code"],
+ "token_endpoint_auth_method": "client_secret_post"
+}
+```
+
+**응답:**
+
+```json
+{
+ "client_id": "abc123",
+ "client_secret": "secret456",
+ "client_name": "My Integration",
+ "redirect_uris": ["https://myapp.com/callback"]
+}
+```
+
+<Warning>
+`client_secret`을 안전하게 저장하세요 — 나중에 다시 조회할 수 없습니다.
+</Warning>
+
+## 범위
+
+| 범위 | 액세스 |
+| ----- | ------------------------------------ |
+| `api` | Core 및 Metadata API에 대한 전체 읽기/쓰기 액세스 |
+| `프로필` | 인증된 사용자의 프로필 정보 읽기 |
+
+범위를 공백으로 구분된 문자열로 요청: `scope=api profile`
+
+## 권한 부여 코드 플로우
+
+앱이 Twenty 사용자를 대신해 동작할 때 이 플로우를 사용하세요.
+
+### 1. 사용자를 권한 부여 화면으로 리디렉션
+
+```
+GET /oauth/authorize?
+ client_id=YOUR_CLIENT_ID&
+ response_type=code&
+ redirect_uri=https://myapp.com/callback&
+ scope=api&
+ state=random_state_value&
+ code_challenge=CHALLENGE&
+ code_challenge_method=S256
+```
+
+| 매개변수 | 필수 | 설명 |
+| ----------------------- | --- | ------------------------------------------ |
+| `client_id` | 예 | 등록된 클라이언트 ID |
+| `response_type` | 예 | 반드시 `code`여야 합니다 |
+| `redirect_uri` | 예 | 등록된 리디렉션 URI와 일치해야 합니다 |
+| `scope` | 아니요 | 공백으로 구분된 범위(기본값은 `api`) |
+| `상태` | 권장 | CSRF 공격을 방지하기 위한 랜덤 문자열 |
+| `code_challenge` | 권장 | PKCE 챌린지(검증자 값의 SHA-256 해시, base64url 인코딩) |
+| `code_challenge_method` | 권장 | PKCE를 사용할 때는 `S256`이어야 합니다 |
+
+사용자는 동의 화면을 보고 액세스를 승인하거나 거부합니다.
+
+### 2. 콜백 처리
+
+권한 부여 후, Twenty는 귀하의 `redirect_uri`로 다시 리디렉션합니다:
+
+```
+https://myapp.com/callback?code=AUTH_CODE&state=random_state_value
+```
+
+`state`가 보낸 값과 일치하는지 확인하세요.
+
+### 3. 코드를 토큰으로 교환
+
+```bash
+POST /oauth/token
+Content-Type: application/x-www-form-urlencoded
+
+grant_type=authorization_code&
+code=AUTH_CODE&
+redirect_uri=https://myapp.com/callback&
+client_id=YOUR_CLIENT_ID&
+client_secret=YOUR_CLIENT_SECRET&
+code_verifier=YOUR_PKCE_VERIFIER
+```
+
+**응답:**
+
+```json
+{
+ "access_token": "eyJhbG...",
+ "token_type": "Bearer",
+ "expires_in": 3600,
+ "refresh_token": "dGhpcyBpcyBh..."
+}
+```
+
+### 4. 액세스 토큰 사용
+
+```bash
+GET /rest/companies
+Authorization: Bearer ACCESS_TOKEN
+```
+
+### 5. 만료 시 갱신
+
+```bash
+POST /oauth/token
+Content-Type: application/x-www-form-urlencoded
+
+grant_type=refresh_token&
+refresh_token=YOUR_REFRESH_TOKEN&
+client_id=YOUR_CLIENT_ID&
+client_secret=YOUR_CLIENT_SECRET
+```
+
+## 클라이언트 자격 증명 플로우
+
+사용자 상호작용이 없는 서버 간 통합의 경우:
+
+```bash
+POST /oauth/token
+Content-Type: application/x-www-form-urlencoded
+
+grant_type=client_credentials&
+client_id=YOUR_CLIENT_ID&
+client_secret=YOUR_CLIENT_SECRET&
+scope=api
+```
+
+반환된 토큰은 특정 사용자에 연결되지 않고 워크스페이스 수준의 액세스를 가집니다.
+
+## 서버 디스커버리
+
+Twenty는 표준 디스커버리 엔드포인트에서 OAuth 구성을 게시합니다:
+
+```
+GET /.well-known/oauth-authorization-server
+```
+
+이 엔드포인트는 모든 엔드포인트, 지원되는 그랜트 타입, 범위 및 기능을 반환하며 — 범용 OAuth 클라이언트를 구축하는 데 유용합니다.
+
+## API 엔드포인트 요약
+
+| 엔드포인트 | 목적 |
+| ----------------------------------------- | -------------- |
+| `/.well-known/oauth-authorization-server` | 서버 메타데이터 디스커버리 |
+| `/oauth/register` | 동적 클라이언트 등록 |
+| `/oauth/authorize` | 사용자 권한 부여 |
+| `/oauth/token` | 토큰 교환 및 갱신 |
+
+| 환경 | 기본 URL |
+| ---------- | ------------------------ |
+| **클라우드** | `https://api.twenty.com` |
+| **셀프 호스팅** | `https://{your-domain}` |
+
+## OAuth 대 API 키
+
+| | API 키 | OAuth |
+| ------------- | ------------- | ---------------- |
+| **설정** | 설정에서 생성 | 클라이언트 등록, 플로우 구현 |
+| **사용자 컨텍스트** | 없음(워크스페이스 수준) | 특정 사용자의 권한 |
+| **적합한 용도** | 스크립트, 내부 도구 | 외부 앱, 다중 사용자 통합 |
+| **토큰 로테이션** | 수동 | 리프레시 토큰으로 자동 |
+| **범위 지정 액세스** | 전체 API 액세스 | 범위를 통해 세분화된 액세스 |
diff --git a/packages/twenty-docs/l/ko/developers/extend/webhooks.mdx b/packages/twenty-docs/l/ko/developers/extend/webhooks.mdx
new file mode 100644
index 00000000000..11f27c3f8cf
--- /dev/null
+++ b/packages/twenty-docs/l/ko/developers/extend/webhooks.mdx
@@ -0,0 +1,117 @@
+---
+title: 웹훅
+icon: satellite-dish
+description: 레코드가 변경될 때 알림을 받으세요 — 생성, 업데이트, 삭제마다 귀하의 엔드포인트로 HTTP POST를 전송합니다.
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+레코드가 생성, 업데이트 또는 삭제될 때마다 Twenty가 귀하의 URL로 HTTP POST를 전송합니다. 사용자 지정 오브젝트를 포함한 모든 오브젝트 유형이 지원됩니다.
+
+## 웹훅 생성
+
+1. **설정 → API 및 웹훅 → 웹훅**으로 이동
+2. **+ 웹훅 생성** 클릭
+3. 웹훅 URL을 입력하세요(공개적으로 액세스 가능해야 함)
+4. **저장**을 클릭합니다
+
+웹훅이 즉시 활성화되어 알림 전송을 시작합니다.
+
+<VimeoEmbed videoId="928786708" title="웹훅 생성" />
+
+### 웹훅 관리
+
+**편집**: 웹훅을 클릭 → URL 업데이트 → **저장**
+
+**삭제**: 웹훅을 클릭 → **삭제** → 확인
+
+## 이벤트
+
+Twenty는 다음 이벤트 유형에 대해 웹훅을 전송합니다:
+
+| 이벤트 | 예시 |
+| ------------- | ---------------------------------------------------------- |
+| **레코드 생성됨** | `person.created`, `company.created`, `note.created` |
+| **레코드 업데이트됨** | `person.updated`, `company.updated`, `opportunity.updated` |
+| **레코드 삭제됨** | `person.deleted`, `company.deleted` |
+
+모든 이벤트 유형은 귀하의 웹훅 URL로 전송됩니다. 이벤트 필터링은 향후 릴리스에서 추가될 수 있습니다.
+
+## 페이로드 형식
+
+각 웹훅은 JSON 본문을 포함한 HTTP POST를 전송합니다:
+
+```json
+{
+ "event": "person.created",
+ "data": {
+ "id": "abc12345",
+ "firstName": "Alice",
+ "lastName": "Doe",
+ "email": "[email protected]",
+ "createdAt": "2025-02-10T15:30:45Z",
+ "createdBy": "user_123"
+ },
+ "timestamp": "2025-02-10T15:30:50Z"
+}
+```
+
+| 필드 | 설명 |
+| ----------- | -------------------------------- |
+| `event` | 무슨 일이 발생했는지(예: `person.created`) |
+| `data` | 생성/업데이트/삭제된 전체 레코드 |
+| `timestamp` | 이벤트가 발생한 시각(UTC) |
+
+<Note>
+수신을 확인하기 위해 **2xx HTTP 상태**(200-299)로 응답하세요. 2xx가 아닌 응답은 전달 실패로 기록됩니다.
+</Note>
+
+## 웹훅 검증
+
+Twenty는 보안을 위해 각 웹훅 요청에 서명합니다. 요청의 진위를 보장하기 위해 서명을 검증하세요.
+
+### 헤더
+
+| 헤더 | 설명 |
+| ---------------------------- | -------------- |
+| `X-Twenty-Webhook-Signature` | HMAC SHA256 서명 |
+| `X-Twenty-Webhook-Timestamp` | 요청 타임스탬프 |
+
+### 검증 단계
+
+1. `X-Twenty-Webhook-Timestamp`에서 타임스탬프를 가져옵니다
+2. 다음 문자열을 생성합니다: `{timestamp}:{JSON payload}`
+3. 웹훅 비밀을 사용하여 HMAC SHA256을 계산합니다
+4. `X-Twenty-Webhook-Signature`와 비교합니다
+
+### 예시(Node.js)
+
+```javascript
+const crypto = require("crypto");
+
+const timestamp = req.headers["x-twenty-webhook-timestamp"];
+const payload = JSON.stringify(req.body);
+const secret = "your-webhook-secret";
+
+const stringToSign = `${timestamp}:${payload}`;
+const expectedSignature = crypto
+ .createHmac("sha256", secret)
+ .update(stringToSign)
+ .digest("hex");
+
+const receivedSignature = req.headers["x-twenty-webhook-signature"];
+const isValid = crypto.timingSafeEqual(
+ Buffer.from(expectedSignature, "hex"),
+ Buffer.from(receivedSignature, "hex")
+);
+```
+
+## 웹훅 vs 워크플로
+
+| 방법 | 방향 | 사용 사례 |
+| ------------------ | --- | ---------------------------------- |
+| **웹훅** | OUT | 레코드 변경 사항을 외부 시스템에 자동으로 알립니다 |
+| **워크플로 + HTTP 요청** | OUT | 사용자 지정 로직(필터, 변환)으로 데이터를 외부로 전송합니다 |
+| **워크플로 웹훅 트리거** | IN | 외부 시스템에서 Twenty로 데이터를 수신합니다 |
+
+외부 데이터를 수신하려면 [웹훅 트리거 설정](/l/ko/user-guide/workflows/how-tos/connect-to-other-tools/set-up-a-webhook-trigger)을 참조하세요.
diff --git a/packages/twenty-docs/l/ko/developers/introduction.mdx b/packages/twenty-docs/l/ko/developers/introduction.mdx
index 67bbb98f0c4..3b46a652885 100644
--- a/packages/twenty-docs/l/ko/developers/introduction.mdx
+++ b/packages/twenty-docs/l/ko/developers/introduction.mdx
@@ -1,33 +1,28 @@
---
-title: 시작하기
-description: Twenty 개발자 문서에 오신 것을 환영합니다. 이 문서는 Twenty를 확장하고, 자체 호스팅하며, Twenty에 기여하는 데 필요한 자료를 제공합니다.
+title: 개발자
+description: 앱을 개발하거나, API를 사용하거나, 자체 호스팅하거나, 코드베이스에 기여하세요.
---
import { CardTitle } from "/snippets/card-title.mdx"
-<CardGroup cols={2}>
- <Card href="/l/ko/developers/api" icon="code">
- <CardTitle>API</CardTitle>
- REST 또는 GraphQL로 CRM 데이터를 쿼리하고 수정합니다.
- </Card>
-
- <Card href="/l/ko/developers/webhooks" icon="bell">
- <CardTitle>Webhooks</CardTitle>
- 이벤트 발생 시 실시간 알림을 받습니다.
+<CardGroup cols={3}>
+ <Card href="/l/ko/developers/extend/apps/getting-started" img="/images/user-guide/halftone/dev-apps.png">
+ <CardTitle>앱</CardTitle>
+ 커스텀 오브젝트, 서버 측 로직, UI 컴포넌트, AI 에이전트로 Twenty를 확장하세요 — 모두 TypeScript 패키지 형태입니다.
</Card>
- <Card href="/l/ko/developers/apps/apps" icon="puzzle-piece">
- <CardTitle>Apps</CardTitle>
- Twenty의 기능을 확장하는 맞춤형 애플리케이션을 구축하세요.
+ <Card href="/l/ko/developers/extend/api" img="/images/user-guide/halftone/dev-api.png">
+ <CardTitle>API</CardTitle>
+ REST 및 GraphQL API, 웹훅, 그리고 OAuth.
</Card>
- <Card href="/l/ko/developers/self-host/self-host" icon="desktop">
+ <Card href="/l/ko/developers/self-host/capabilities/docker-compose" img="/images/user-guide/halftone/dev-self-host.png">
<CardTitle>자체 호스팅</CardTitle>
- 자체 인프라에 Twenty를 배포하고 관리하세요.
+ 자체 인프라에서 Twenty를 실행하세요.
</Card>
- <Card href="/l/ko/developers/contribute/contribute" icon="github">
+ <Card href="/l/ko/developers/contribute/capabilities/local-setup" img="/images/user-guide/halftone/dev-contribute.png">
<CardTitle>기여</CardTitle>
- 오픈 소스 커뮤니티에 참여하고 Twenty에 기여하세요.
+ 로컬에서 모노레포를 설정하고 PR을 제출하세요.
</Card>
</CardGroup>
diff --git a/packages/twenty-docs/l/ko/developers/self-host/capabilities/docker-compose.mdx b/packages/twenty-docs/l/ko/developers/self-host/capabilities/docker-compose.mdx
index b56cab01092..092b76c7750 100644
--- a/packages/twenty-docs/l/ko/developers/self-host/capabilities/docker-compose.mdx
+++ b/packages/twenty-docs/l/ko/developers/self-host/capabilities/docker-compose.mdx
@@ -1,9 +1,10 @@
---
-title: Docker Compose로 1-클릭
+title: Docker Compose
+icon: docker
---
<Warning>
- Docker 컨테이너는 프로덕션 호스팅 또는 셀프 호스팅을 위한 것입니다. 기여를 원하시면 [로컬 설정](/l/ko/developers/contribute/capabilities/local-setup)을 확인하세요.
+Docker 컨테이너는 프로덕션 호스팅 또는 셀프 호스팅용입니다. 기여하려면 [로컬 설정](/l/ko/developers/contribute/capabilities/local-setup)을 확인하세요.
</Warning>
## 개요
@@ -12,7 +13,7 @@ title: Docker Compose로 1-클릭
**중요:** 이 가이드에서 명시적으로 언급된 설정만 수정하세요. 다른 구성을 변경하면 문제가 발생할 수 있습니다.
-고급 설정을 위해 [환경 변수 설정](/l/ko/developers/self-host/capabilities/setup) 문서를 참조하세요. 모든 환경 변수는 서버 및/또는 작업자 수준에서 docker-compose.yml 파일에 선언되어야 합니다.
+고급 설정을 위해 [환경 변수 설정](/l/ko/developers/self-host/capabilities/setup) 문서를 참조하세요. 모든 환경 변수는 변수에 따라 서버 및/또는 작업자 수준에서 `docker-compose.yml` 파일에 선언되어야 합니다.
## 시스템 요구 사항
@@ -50,7 +51,7 @@ VERSION=vx.y.z BRANCH=branch-name bash <(curl -sL https://raw.githubusercontent.
curl -o .env https://raw.githubusercontent.com/twentyhq/twenty/refs/heads/main/packages/twenty-docker/.env.example
```
-2. **비밀 토큰 생성**
+2. **암호화 키 생성하기**
고유한 랜덤 문자열을 생성하기 위해 다음 명령을 실행하세요:
@@ -58,16 +59,18 @@ VERSION=vx.y.z BRANCH=branch-name bash <(curl -sL https://raw.githubusercontent.
openssl rand -base64 32
```
- **중요:** 이 값을 비공개로 유지/공유하지 마십시오.
+ **중요:** 이 값을 비공개로 유지/공유하지 마십시오. `ENCRYPTION_KEY`를 잃어버리면 데이터베이스에 저장된 모든 비밀(예: OAuth 토큰, 애플리케이션 변수, TOTP 비밀 등)에 대한 액세스를 잃게 됩니다.
3. **`.env` 업데이트**
생성된 토큰으로 .env 파일의 플레이스홀더 값을 대체합니다.
```ini
- APP_SECRET=first_random_string
+ ENCRYPTION_KEY=random_string
```
+ 중단 없이 키를 회전하는 방법은 [키 회전 가이드](/l/ko/developers/self-host/capabilities/key-rotation)를 참조하세요.
+
4. **Postgres 비밀번호 설정**
.env 파일에서 특수 문자가 없는 강력한 비밀번호로 `PG_DATABASE_PASSWORD` 값을 업데이트하십시오.
diff --git a/packages/twenty-docs/l/ko/developers/self-host/capabilities/key-rotation.mdx b/packages/twenty-docs/l/ko/developers/self-host/capabilities/key-rotation.mdx
new file mode 100644
index 00000000000..2b5da648add
--- /dev/null
+++ b/packages/twenty-docs/l/ko/developers/self-host/capabilities/key-rotation.mdx
@@ -0,0 +1,60 @@
+---
+title: 키 로테이션
+icon: rotate
+---
+
+Twenty에는 서로 독립적인 키 계열이 두 가지 있습니다:
+
+* **JWT 서명 키** — 비대칭 ES256 키 페어(`kid` 태그 사용)로, `core."signingKey"`에 저장되며 액세스/리프레시 토큰을 서명하고 검증하는 데 사용됩니다.
+* **정지 상태 암호화 키** — OAuth 토큰, 애플리케이션 변수, 서명 키의 개인 키, 민감한 설정 값, `enc:v2:` 봉투 안의 TOTP 시크릿을 암호화하는 데 사용되는 `ENCRYPTION_KEY`입니다.
+
+`APP_SECRET`은 하위 호환성을 위해 유지되는 레거시 시크릿입니다. `ENCRYPTION_KEY`가 설정되지 않은 경우 정지 상태 암호화/세션 쿠키 폴백 역할을 하며, 기존 HS256 액세스 토큰을 계속 검증합니다. 이는 사용 중단 예정입니다.
+
+## JWT 서명 키
+
+각 키는 `publicKey`(이전에 발급된 토큰을 검증할 수 있도록 무기한 보관), 암호화된 `privateKey`(해당 키가 현재 키일 때만 사용), `isCurrent` 플래그(한 번에 정확히 한 행만 true), 선택적인 `revokedAt`를 가집니다.
+
+### 현재 키 회전
+
+옵트인하려면 `SIGNING_KEY_ROTATION_DAYS` 를 설정하세요. 그러면 일일 cron 작업이 기존 키가 해당 기준값보다 오래되면 새로운 현재 키를 발급합니다. 이전 키는 *폐기되지 않으므로*, 해당 키로 서명된 토큰은 계속 검증됩니다. 자동 회전을 사용하지 않으려면 변수를 설정하지 않은 상태로 두세요.
+
+<Note>자동 회전 기능은 v2.6+부터 제공됩니다.</Note>
+
+### 키 폐기(유출 / 비상 시에만)
+
+현재 키가 아닌 행에서 **Settings → Admin Panel → Signing keys → Revoke**를 수행합니다. 암호화된 개인 데이터를 삭제하고 `revokedAt`을 설정하며, 해당 `kid`로 서명된 모든 기존 토큰을 거부합니다.
+
+## `ENCRYPTION_KEY` 회전
+
+<Note>아래에 설명된 `secret-encryption:rotate` 커맨드는 v2.6+에서 제공됩니다.</Note>
+
+모든 암호화된 값은 `enc:v2:\<keyId>:\<payload>` 형식으로 래핑됩니다. 여기서 `\<keyId>`는 원시 키에서 파생된 8자리 16진수 접두사입니다. 회전 작업은 온라인으로 수행되며, 중단 후 재개할 수 있습니다.
+
+1. **새 키 생성**: `openssl rand -base64 32`.
+
+2. `.env`에 **두 키를 나란히 설정**한 다음, 재시작합니다:
+ ```ini
+ ENCRYPTION_KEY=NEW_VALUE
+ FALLBACK_ENCRYPTION_KEY=OLD_VALUE
+ ```
+ 새로 기록되는 데이터는 새 키를 사용하며, 기존 행은 폴백을 통해 계속 복호화됩니다.
+
+3. **기존 행 재암호화**:
+
+ ```bash
+ docker exec -it {server_container} yarn command:prod secret-encryption:rotate
+ ```
+
+ 이 커맨드는 여섯 개의 위치(`connected-account-tokens`, `application-variable`, `application-registration-variable`, `signing-key-private-keys`, `sensitive-config-storage`, `totp-secrets`)를 순회합니다. SQL 필터는 이미 새 `\<keyId>`로 암호화된 행을 건너뛰므로, 이 커맨드는 멱등성을 가집니다. 필요에 따라 중단하고 다시 실행해도 됩니다. 어떤 행이라도 실패하면 0이 아닌 코드로 종료되며, 재실행하여 재시도할 수 있습니다.
+
+ | 플래그 | 설명 |
+ | ---------------------------------------- | ---------------------------------------- |
+ | `-s, --site \<site>` | 단일 사이트로 범위를 제한합니다. |
+ | `-b, --batch-size \<n>` | 배치당 행 수(기본값 `200`, 최대 `5000`). |
+ | `-d, --dry-run` | 메모리에서 복호화 + 재암호화를 수행하고, `UPDATE`는 생략합니다. |
+
+4. `--dry-run` 결과 남은 행이 0이면 **폴백을 제거**합니다. `FALLBACK_ENCRYPTION_KEY`를 삭제하고 재시작합니다.
+
+## 레거시 `APP_SECRET` 지원
+
+`ENCRYPTION_KEY`를 설정하지 않은 오래된 인스턴스는 정지 상태 암호화 키(및 이로부터 파생된 세션 쿠키 시크릿)로 `APP_SECRET`을 사용합니다. 이 경로는 하위 호환성을 위해 유지되지만 **사용 중단 예정**입니다. 전용 `ENCRYPTION_KEY`를 설정하고 위의 회전 절차를 따라 이를 사용하지 않는 방식으로 마이그레이션하세요. `APP_SECRET` 자체는 기존 HS256 액세스 토큰을 검증하는 데 계속 사용됩니다.
diff --git a/packages/twenty-docs/l/ko/developers/self-host/capabilities/setup.mdx b/packages/twenty-docs/l/ko/developers/self-host/capabilities/setup.mdx
index e3e971d5192..1cf4a611e02 100644
--- a/packages/twenty-docs/l/ko/developers/self-host/capabilities/setup.mdx
+++ b/packages/twenty-docs/l/ko/developers/self-host/capabilities/setup.mdx
@@ -1,11 +1,12 @@
---
title: 설정
+icon: 톱니바퀴
---
# 구성 관리
<Warning>
- **처음 설치하시나요?** [Docker Compose 설치 가이드](/l/ko/developers/self-host/capabilities/docker-compose)를 따라 Twenty를 실행하고, 이곳으로 돌아와 구성을 진행하세요.
+**처음 설치하시나요?** [Docker Compose 설치 가이드](/l/ko/developers/self-host/capabilities/docker-compose)를 따라 Twenty를 실행하고, 이곳으로 돌아와 구성을 진행하세요.
</Warning>
Twenty는 다른 배포 요구에 맞추기 위해 **두 가지 구성 모드**를 제공합니다:
@@ -26,7 +27,7 @@ IS_CONFIG_VARIABLES_IN_DB_ENABLED=true # default
4. 변경 사항은 즉시 적용됩니다 (멀티 컨테이너 배포의 경우 15초 이내)
<Warning>
- **멀티 컨테이너 배포:** 데이터베이스 구성을 사용할 때 (`IS_CONFIG_VARIABLES_IN_DB_ENABLED=true`), 서버와 작업자 컨테이너 모두 동일한 데이터베이스에서 읽습니다. 관리자 패널의 변경은 둘 다 자동으로 영향을 미쳐 환경 변수를 컨테이너 간에 복제할 필요가 없습니다 (인프라 변수 제외).
+**멀티 컨테이너 배포:** 데이터베이스 구성을 사용할 때 (`IS_CONFIG_VARIABLES_IN_DB_ENABLED=true`), 서버와 작업자 컨테이너 모두 동일한 데이터베이스에서 읽습니다. 관리자 패널의 변경은 둘 다 자동으로 영향을 미쳐 환경 변수를 컨테이너 간에 복제할 필요가 없습니다 (인프라 변수 제외).
</Warning>
**관리자 패널에서 구성할 수 있는 내용:**
@@ -41,12 +42,27 @@ IS_CONFIG_VARIABLES_IN_DB_ENABLED=true # default
![관리자 패널 구성 변수](/images/user-guide/setup/admin-panel-config-variables.png)
<Warning>
- 각 변수는 **설정 → 관리자 패널 → 구성 변수**의 관리자 패널에 설명과 함께 문서화되어 있습니다.
- 데이터베이스 연결 (`PG_DATABASE_URL`), 서버 URL (`SERVER_URL`), 앱 비밀 (`APP_SECRET`)과 같은 일부 인프라 설정은 `.env` 파일을 통해서만 구성할 수 있습니다.
+각 변수는 **설정 → 관리자 패널 → 구성 변수**의 관리자 패널에 설명과 함께 문서화되어 있습니다.
+데이터베이스 연결(`PG_DATABASE_URL`), 서버 URL(`SERVER_URL`), 비밀 값(`ENCRYPTION_KEY`, `FALLBACK_ENCRYPTION_KEY`)과 같은 일부 인프라 설정은 `.env` 파일을 통해서만 구성할 수 있습니다.
- [완전한 기술적 참조 →](https://github.com/twentyhq/twenty/blob/main/packages/twenty-server/src/engine/core-modules/twenty-config/config-variables.ts)
+[완전한 기술적 참조 →](https://github.com/twentyhq/twenty/blob/main/packages/twenty-server/src/engine/core-modules/twenty-config/config-variables.ts)
</Warning>
+## 암호화 키
+
+Twenty는 환경 변수로만 설정할 수 있는 암호화 키를 두 개 사용합니다:
+
+| 변수 | 목적 | 필수 |
+| ------------------------- | ----------------------------------------------------------------------------------- | --------------------------------------------------------- |
+| `ENCRYPTION_KEY` | 휴지 상태의 비밀(OAuth 토큰, 애플리케이션 변수, 서명 키 개인 키, TOTP 비밀, 민감한 구성 값)을 암호화하는 데 사용되는 기본 키입니다. | 새로운 설치의 경우 예(레거시 설치는 대신 `APP_SECRET`에 의존할 수 있습니다 — 아래 참조) |
+| `FALLBACK_ENCRYPTION_KEY` | 검증 전용 키입니다. 회전 중 기존 행을 계속 복호화할 수 있도록, *이전* `ENCRYPTION_KEY`로 설정합니다. | 회전 중에만 |
+
+하위 호환을 위해 `ENCRYPTION_KEY`가 설정되지 않은 경우, Twenty는 휴지 상태 암호화에 대해 `APP_SECRET`을 대신 사용하여 기존 배포의 레거시 동작과 일치합니다. 새로운 설치에서는 항상 전용 `ENCRYPTION_KEY`를 설정해야 합니다.
+
+`openssl rand -base64 32`로 값을 생성한 뒤 비밀 관리자, 봉인된 구성 등 안전한 위치에 저장하세요. `ENCRYPTION_KEY`를 분실하면 데이터베이스에 저장된 모든 비밀에 대한 접근을 잃게 됩니다.
+
+중단 없이 `ENCRYPTION_KEY`를 회전하는 방법은 [키 회전 가이드](/l/ko/developers/self-host/capabilities/key-rotation)를 참고하세요.
+
## 2. 환경 전용 구성
```bash
@@ -93,7 +109,7 @@ DEFAULT_SUBDOMAIN=app # default value
* 서브도메인 및 사용자 지정 도메인과 같은 워크스페이스 전용 설정이 워크스페이스 설정에서 제공됩니다
<Warning>
- **환경 전용 설정:** `IS_MULTIWORKSPACE_ENABLED`는 `.env` 파일을 통해서만 구성할 수 있으며 재시작이 필요합니다. 관리자 패널을 통해 변경할 수 없습니다.
+**환경 전용 설정:** `IS_MULTIWORKSPACE_ENABLED`는 `.env` 파일을 통해서만 구성할 수 있으며 재시작이 필요합니다. 관리자 패널을 통해 변경할 수 없습니다.
</Warning>
### 멀티 워크스페이스를 위한 DNS 구성
@@ -149,7 +165,7 @@ IS_WORKSPACE_CREATION_LIMITED_TO_SERVER_ADMINS=true
* `AUTH_GOOGLE_APIS_CALLBACK_URL=https://{your-domain}/auth/google-apis/get-access-token`
<Warning>
- **환경 전용 모드:** `IS_CONFIG_VARIABLES_IN_DB_ENABLED=false`로 설정한 경우, `.env` 파일에 이러한 변수를 추가하세요.
+**환경 전용 모드:** `IS_CONFIG_VARIABLES_IN_DB_ENABLED=false`로 설정한 경우, `.env` 파일에 이러한 변수를 추가하세요.
</Warning>
**필요한 범위** (자동 구성됨):
@@ -168,7 +184,7 @@ IS_WORKSPACE_CREATION_LIMITED_TO_SERVER_ADMINS=true
## Microsoft 365 통합
<Warning>
- 사용자는 캘린더 및 메시징 API를 사용하려면 [Microsoft 365 라이선스](https://admin.microsoft.com/Adminportal/Home)를 보유해야 합니다. 없이는 Twenty에서 계정을 동기화할 수 없습니다.
+사용자는 캘린더 및 메시징 API를 사용하려면 [Microsoft 365 라이선스](https://admin.microsoft.com/Adminportal/Home)를 보유해야 합니다. 없이는 Twenty에서 계정을 동기화할 수 없습니다.
</Warning>
### Microsoft Azure에 프로젝트 생성
@@ -211,7 +227,7 @@ Microsoft Azure 콘솔에서 "권한"에서 다음 API를 활성화하세요:
* `AUTH_MICROSOFT_APIS_CALLBACK_URL=https://{your-domain}/auth/microsoft-apis/get-access-token`
<Warning>
- **환경 전용 모드:** `IS_CONFIG_VARIABLES_IN_DB_ENABLED=false`로 설정한 경우, `.env` 파일에 이러한 변수를 추가하세요.
+**환경 전용 모드:** `IS_CONFIG_VARIABLES_IN_DB_ENABLED=false`로 설정한 경우, `.env` 파일에 이러한 변수를 추가하세요.
</Warning>
### 범위 구성
@@ -256,82 +272,111 @@ yarn command:prod cron:workflow:automated-cron-trigger
3. SMTP 설정을 구성하세요:
<ArticleTabs label1="Gmail" label2="오피스365" label3="Smtp4dev">
+
<ArticleTab>
- [App Password](https://support.google.com/accounts/answer/185833)를 프로비저닝해야 합니다.
- * EMAIL_DRIVER=smtp
- * EMAIL_SMTP_HOST=smtp.gmail.com
- * EMAIL_SMTP_PORT=465
- * EMAIL_SMTP_USER=gmail_email_address
- * EMAIL_SMTP_PASSWORD='gmail_app_password'
+ [App Password](https://support.google.com/accounts/answer/185833)를 프로비저닝해야 합니다.
+ * EMAIL_DRIVER=smtp
+ * EMAIL_SMTP_HOST=smtp.gmail.com
+ * EMAIL_SMTP_PORT=465
+ * EMAIL_SMTP_USER=gmail_email_address
+ * EMAIL_SMTP_PASSWORD='gmail_app_password'
+
</ArticleTab>
<ArticleTab>
- 2단계 인증을 사용 중인 경우, [앱 비밀번호](https://support.microsoft.com/en-us/account-billing/manage-app-passwords-for-two-step-verification-d6dc8c6d-4bf7-4851-ad95-6d07799387e9)를 발급받아야 합니다.
- * EMAIL_DRIVER=smtp
- * EMAIL_SMTP_HOST=smtp.office365.com
- * EMAIL_SMTP_PORT=587
- * EMAIL_SMTP_USER=office365_email_address
- * EMAIL_SMTP_PASSWORD='office365_password'
+ 2단계 인증을 사용 중인 경우, [앱 비밀번호](https://support.microsoft.com/en-us/account-billing/manage-app-passwords-for-two-step-verification-d6dc8c6d-4bf7-4851-ad95-6d07799387e9)를 발급받아야 합니다.
+ * EMAIL_DRIVER=smtp
+ * EMAIL_SMTP_HOST=smtp.office365.com
+ * EMAIL_SMTP_PORT=587
+ * EMAIL_SMTP_USER=office365_email_address
+ * EMAIL_SMTP_PASSWORD='office365_password'
+
</ArticleTab>
<ArticleTab>
- **smtp4dev**는 개발 및 테스트를 위한 가상의 SMTP 이메일 서버입니다.
-
- * smtp4dev 이미지를 실행하세요: `docker run --rm -it -p 8090:80 -p 2525:25 rnwood/smtp4dev`
- * smtp4dev UI에 여기에 접근하세요: [http://localhost:8090](http://localhost:8090)
- * 다음 변수를 설정하세요:
- * EMAIL_DRIVER=smtp
- * EMAIL_SMTP_HOST=localhost
- * EMAIL_SMTP_PORT=2525
+
+ **smtp4dev**는 개발 및 테스트를 위한 가상의 SMTP 이메일 서버입니다.
+ * smtp4dev 이미지를 실행하세요: `docker run --rm -it -p 8090:80 -p 2525:25 rnwood/smtp4dev`
+ * smtp4dev UI에 여기에 접근하세요: [http://localhost:8090](http://localhost:8090)
+ * 다음 변수를 설정하세요:
+ * EMAIL_DRIVER=smtp
+ * EMAIL_SMTP_HOST=localhost
+ * EMAIL_SMTP_PORT=2525
+
</ArticleTab>
+
</ArticleTabs>
<Warning>
- **환경 전용 모드:** `IS_CONFIG_VARIABLES_IN_DB_ENABLED=false`로 설정한 경우, `.env` 파일에 이러한 변수를 추가하세요.
+**환경 전용 모드:** `IS_CONFIG_VARIABLES_IN_DB_ENABLED=false`로 설정한 경우, `.env` 파일에 이러한 변수를 추가하세요.
</Warning>
-## 로직 함수
+## S3 저장소
+
+<Warning>
+기본적으로 Twenty는 업로드된 파일을 로컬 파일 시스템에 저장합니다. 프로덕션 배포에서는 S3 또는 S3 호환 서비스(MinIO, DigitalOcean Spaces 등)를 사용하세요. 컨테이너 재시작 시에도 파일이 유지되고, 여러 서버 인스턴스에 걸쳐 확장될 수 있도록 하기 위함입니다.
+</Warning>
+
+`STORAGE_TYPE=S_3`를 설정하고 관리자 패널 또는 `.env`를 통해 `STORAGE_S3_*` 변수를 구성하세요. 전체 S3 변수 목록은 [config-variables.ts 참조](https://github.com/twentyhq/twenty/blob/main/packages/twenty-server/src/engine/core-modules/twenty-config/config-variables.ts)를 확인하세요.
+
+CORS에 의존하는 기능(예: 브라우저 내 파일 다운로드)과 함께 S3를 사용할 때에는, 버킷의 CORS 구성에서 Twenty 프런트엔드 오리진을 허용하도록 하세요.
-Twenty는 워크플로 및 사용자 지정 로직을 위해 로직 함수를 지원합니다. `SERVERLESS_TYPE` 환경 변수를 통해 실행 환경을 구성합니다.
+## 로직 함수 및 코드 인터프리터
+
+Twenty는 워크플로를 위한 로직 함수와 AI 데이터 분석을 위한 코드 인터프리터를 지원합니다. 두 기능 모두 사용자 제공 코드를 실행하며, 보안을 위해 명시적인 구성이 필요합니다.
+
+### 보안 기본값
+
+**프로덕션 (NODE_ENV=production):** 로직 함수와 코드 인터프리터는 기본값이 **비활성화됨**입니다. 이러한 기능이 필요하다면 `LOGIC_FUNCTION_TYPE` 및 `CODE_INTERPRETER_TYPE`로 명시적으로 활성화해야 합니다.
+
+**개발 (NODE_ENV=development):** 로컬에서 실행할 때 편의를 위해 둘 다 기본값이 **LOCAL**입니다.
<Warning>
- **보안 공지:** 로컬 드라이버 (`SERVERLESS_TYPE=LOCAL`)는 샌드박싱 없이 호스트의 Node.js 프로세스에서 코드를 직접 실행합니다. 개발 환경에서 신뢰할 수 있는 코드에만 사용해야 합니다. 신뢰할 수 없는 코드를 처리하는 프로덕션 배포의 경우 `SERVERLESS_TYPE=LAMBDA` 또는 `SERVERLESS_TYPE=DISABLED` 사용을 강력히 권장합니다.
+**보안 공지:** 로컬 드라이버 (`LOGIC_FUNCTION_TYPE=LOCAL` 또는 `CODE_INTERPRETER_TYPE=LOCAL`)는 샌드박싱 없이 호스트의 Node.js 프로세스에서 코드를 직접 실행합니다. 개발 환경에서 신뢰할 수 있는 코드에만 사용해야 합니다. 신뢰할 수 없는 코드를 처리하는 프로덕션 배포에서는 `LOGIC_FUNCTION_TYPE=LAMBDA` 또는 `CODE_INTERPRETER_TYPE=E2B`(샌드박싱 적용)을 사용하거나 비활성화 상태로 유지하세요.
</Warning>
-### 사용 가능한 드라이버
+### 로직 함수 - 사용 가능한 드라이버
-| 드라이버 | 환경 변수 | 사용 사례 | 보안 수준 |
-| ------ | -------------------------- | ------------------------- | --------------- |
-| 비활성화 | `SERVERLESS_TYPE=DISABLED` | 로직 함수를 완전히 비활성화 | 해당 없음 |
-| 로컬 | `SERVERLESS_TYPE=LOCAL` | 개발 및 신뢰할 수 있는 환경 | 낮음 (샌드박싱 없음) |
-| Lambda | `SERVERLESS_TYPE=LAMBDA` | 신뢰할 수 없는 코드를 처리하는 프로덕션 환경 | 높음 (하드웨어 수준 격리) |
+| 드라이버 | 환경 변수 | 사용 사례 | 보안 수준 |
+| ------ | ------------------------------ | ------------------------- | --------------- |
+| 비활성화 | `LOGIC_FUNCTION_TYPE=DISABLED` | 로직 함수를 완전히 비활성화 | 해당 없음 |
+| 로컬 | `LOGIC_FUNCTION_TYPE=LOCAL` | 개발 및 신뢰할 수 있는 환경 | 낮음 (샌드박싱 없음) |
+| Lambda | `LOGIC_FUNCTION_TYPE=LAMBDA` | 신뢰할 수 없는 코드를 처리하는 프로덕션 환경 | 높음 (하드웨어 수준 격리) |
-### 권장 구성
+### 로직 함수 - 권장 구성
**개발:**
```bash
-SERVERLESS_TYPE=LOCAL # default
+LOGIC_FUNCTION_TYPE=LOCAL # default when NODE_ENV=development
```
**프로덕션(AWS):**
```bash
-SERVERLESS_TYPE=LAMBDA
-SERVERLESS_LAMBDA_REGION=us-east-1
-SERVERLESS_LAMBDA_ROLE=arn:aws:iam::123456789:role/your-lambda-role
-SERVERLESS_LAMBDA_ACCESS_KEY_ID=your-access-key
-SERVERLESS_LAMBDA_SECRET_ACCESS_KEY=your-secret-key
+LOGIC_FUNCTION_TYPE=LAMBDA
+LOGIC_FUNCTION_LAMBDA_REGION=us-east-1
+LOGIC_FUNCTION_LAMBDA_ROLE=arn:aws:iam::123456789:role/your-lambda-role
+LOGIC_FUNCTION_LAMBDA_ACCESS_KEY_ID=your-access-key
+LOGIC_FUNCTION_LAMBDA_SECRET_ACCESS_KEY=your-secret-key
```
**로직 함수를 비활성화하려면:**
```bash
-SERVERLESS_TYPE=DISABLED
+LOGIC_FUNCTION_TYPE=DISABLED # default when NODE_ENV=production
```
+### 코드 인터프리터 - 사용 가능한 드라이버
+
+| 드라이버 | 환경 변수 | 사용 사례 | 보안 수준 |
+| ---- | -------------------------------- | ------------------ | ------------- |
+| 비활성화 | `CODE_INTERPRETER_TYPE=DISABLED` | AI 코드 실행 비활성화 | 해당 없음 |
+| 로컬 | `CODE_INTERPRETER_TYPE=LOCAL` | 개발 전용 | 낮음 (샌드박싱 없음) |
+| E2B | `CODE_INTERPRETER_TYPE=E_2_B` | 샌드박스 실행을 사용하는 프로덕션 | 높음 (격리된 샌드박스) |
+
<Note>
- `SERVERLESS_TYPE=DISABLED`를 사용하는 경우 로직 함수를 실행하려는 모든 시도는 오류를 반환합니다. 로직 함수 기능 없이 Twenty를 실행하려는 경우 유용합니다.
+`LOGIC_FUNCTION_TYPE=DISABLED` 또는 `CODE_INTERPRETER_TYPE=DISABLED`를 사용하는 경우, 모든 실행 시도는 오류를 반환합니다. 이러한 기능 없이 Twenty를 실행하려는 경우 유용합니다.
</Note>
diff --git a/packages/twenty-docs/l/ko/developers/self-host/capabilities/troubleshooting.mdx b/packages/twenty-docs/l/ko/developers/self-host/capabilities/troubleshooting.mdx
index 8639dff3383..c3c2ef5eba0 100644
--- a/packages/twenty-docs/l/ko/developers/self-host/capabilities/troubleshooting.mdx
+++ b/packages/twenty-docs/l/ko/developers/self-host/capabilities/troubleshooting.mdx
@@ -1,5 +1,6 @@
---
title: 문제 해결
+icon: wrench
---
## 문제 해결
@@ -53,7 +54,7 @@ Twenty 설치 중에 적절한 스키마, 확장, 사용자를 사용하여 post
#### 저장 시 린트가 작동하지 않음
-Oxc 확장 (`oxc.oxc-vscode`) 프로그램이 설치된 상태에서는 기본 설정으로 작동해야 합니다. 작동하지 않으면 vscode 설정(개발 컨테이너 범위)에 다음을 추가해 보세요:
+This should work out of the box with the Oxc extension (`oxc.oxc-vscode`) installed. 작동하지 않으면 vscode 설정(개발 컨테이너 범위)에 다음을 추가해 보세요:
```
"editor.codeActionsOnSave": {
@@ -166,6 +167,10 @@ plugins: [
데이터베이스 컨테이너에서 관리자 패널에 액세스하기 위해 `UPDATE core."user" SET "canAccessFullAdminPanel" = TRUE WHERE email = '[email protected]';`을 실행하십시오.
+#### 워크플로우를 실행하면 다음 오류로 실행이 실패합니다: "로직 함수 실행이 비활성화되었습니다. 활성화하려면 LOGIC_FUNCTION_TYPE을 LOCAL 또는 LAMBDA로 설정하세요."
+
+프로덕션 환경에서는 로직 함수가 기본적으로 비활성화되어 있습니다. 이를 활성화하려면 `LOGIC_FUNCTION_TYPE` 환경 변수를 `LOCAL` 또는 `LAMBDA`로 설정하세요. 이는 환경 변수를 통해서나 관리자 패널의 데이터베이스 변수를 통해 구성할 수 있습니다. 자세한 내용은 [로직 함수 설정 가이드](/l/ko/developers/self-host/capabilities/setup#logic-functions-available-drivers)를 참조하세요.
+
### 1-클릭 Docker 구성
#### 로그인할 수 없음
diff --git a/packages/twenty-docs/l/ko/developers/self-host/capabilities/upgrade-guide.mdx b/packages/twenty-docs/l/ko/developers/self-host/capabilities/upgrade-guide.mdx
index f2936c39ae5..196bd44b4bb 100644
--- a/packages/twenty-docs/l/ko/developers/self-host/capabilities/upgrade-guide.mdx
+++ b/packages/twenty-docs/l/ko/developers/self-host/capabilities/upgrade-guide.mdx
@@ -1,372 +1,102 @@
---
title: 업그레이드 가이드
+icon: arrow-up-right-dots
---
## 일반 가이드라인
-**업그레이드 프로세스를 시작하기 전에 다음 명령을 실행하여 데이터베이스를 반드시 백업하십시오**: `docker exec -it {db_container_name_or_id} pg_dumpall -U {postgres_user} > databases_backup.sql`.
-
-백업을 복원하려면 `cat databases_backup.sql | docker exec -i {db_container_name_or_id} psql -U {postgres_user}`를 실행하십시오.
-
-Docker Compose를 사용한 경우, 다음 단계를 따르십시오:
-
-1. Twenty가 실행되고 있는 호스트의 터미널에서 Twenty를 종료하십시오: `docker compose down`
-
-2. `TAG` 값을 docker-compose와 가까운 .env 파일에 변경하여 버전을 업그레이드하십시오. ( `v0.53`과 같은 `major.minor` 버전 사용을 권장합니다 )
-
-3. `docker compose up -d`로 Twenty를 다시 온라인 상태로 전환하십시오.
-
-여러 버전으로 인스턴스를 업그레이드하려는 경우, 예를 들어 v0.33.0에서 v0.35.0으로 업그레이드하려면 v0.33.0에서 v0.34.0으로, 그런 다음 v0.34.0에서 v0.35.0으로 업그레이드하십시오.
-
-**각 버전 업그레이드 후마다 백업이 손상되지 않았는지 확인하십시오.**
-
-## 버전별 업그레이드 단계
-
-## v1.0
-
-안녕하세요 Twenty v1.0! 🎉
-
-## v0.60
-
-### 성능 개선
-
-메타데이터 API와의 모든 상호작용이 최적화되어, 특히 객체 메타데이터 조작 및 워크스페이스 생성 작업에서 성능이 향상되었습니다.
-
-데이터베이스 쿼리보다는 캐시 히트를 우선시하도록 캐싱 전략을 재구성하여 메타데이터 API 작업의 성능을 대폭 향상시켰습니다.
-
-업그레이드 후 실행 중 문제가 발생하면 캐시를 플러시하여 최신 변경 사항과 동기화해야 할 수도 있습니다. twenty-server 컨테이너에서 이 명령을 실행하십시오:
+**업그레이드 프로세스를 시작하기 전에 항상 데이터베이스를 백업하십시오** 다음 명령을 실행하세요:
```bash
-yarn command:prod cache:flush
+docker exec -it {db_container_name_or_id} pg_dumpall -U {postgres_user} > databases_backup.sql
```
-### v0.55
-
-Twenty 인스턴스를 v0.55 이미지로 업그레이드하십시오.
-
-이제 명령어를 실행할 필요가 없으며, 새로운 이미지는 모든 필요한 마이그레이션을 자동으로 처리할 것입니다.
-
-### `사용자에게 권한이 없습니다` 오류
-
-업그레이드 후 대부분의 요청에서 권한 오류가 발생하면 캐시를 플러시하여 최신 권한을 다시 계산해야 할 수도 있습니다.
-
-`twenty-server` 컨테이너에서 실행하십시오:
+백업에서 복원하려면:
```bash
-yarn command:prod cache:flush
-```
-
-이 문제는 이 Twenty 버전에만 해당하며, 향후 업그레이드에서는 필요하지 않을 것입니다.
-
-### v0.54
-
-버전 `0.53` 이후로 수동 작업이 필요하지 않습니다.
-
-#### 메타데이터 스키마 사용 중단
-
-`metadata` 스키마를 `core` 스키마로 병합하여 `TypeORM`에서 데이터 검색을 간소화했습니다.
-`migrate` 명령 단계를 `upgrade` 명령과 통합했습니다. 서버/작업자 컨테이너 내에서 `migrate`를 수동으로 실행하지 않는 것을 권장합니다.
-
-### Since v0.53
-
-`0.53`부터 업그레이드는 `DockerFile` 내에서 프로그래밍 방식으로 수행되므로 앞으로는 수동으로 명령을 실행할 필요가 없습니다.
-
-인스턴스를 순차적으로 업그레이드하고 주요 버전을 건너뛰지 마십시오(e.g. `0.43.3`에서 `0.44.0`으로의 업그레이드는 가능하지만 `0.43.1`에서 `0.45.0`으로의 업그레이드는 불가능), 그렇지 않으면 워크스페이스 버전 비동기화가 발생하여 런타임 오류 및 기능 누락이 발생할 수 있습니다.
-
-워크스페이스가 올바르게 마이그레이션되었는지 확인하려면 `core.workspace` 테이블에서 데이터베이스의 버전을 검토할 수 있습니다.
-
-항상 현재 Twenty 인스턴스의 `주.소` 버전 범위 내에 있어야 하며, 인스턴스 버전은 admin 패널에서 볼 수 있습니다(`/설정/admin-panel`, 사용자가 데이터베이스에서 `canAccessFullAdminPanel` 속성이 true로 설정된 경우 접근 가능) 또는 `twenty-server` 컨테이너에서 `echo $APP_VERSION`을 실행하여 확인할 수 있습니다.
-
-비동기화된 워크스페이스 버전을 수정하려면 해당 Twenty 버전의 관련 업그레이드 가이드를 따르고 원하는 버전에 도달할 때까지 순차적으로 업그레이드해야 합니다.
-
-#### `auditLog` 제거
-
-auditLog 표준 객체를 제거했으며, 이로 인해 이 마이그레이션 이후 백업 크기가 상당히 줄어들 수 있습니다.
-
-### v0.51 to v0.52
-
-Twenty 인스턴스를 v0.52 이미지로 업그레이드하십시오.
-
-```
-yarn database:migrate:prod
-yarn command:prod upgrade
-```
-
-#### 버전이 `0.52.0`과 `0.52.6` 사이에 차단된 워크스페이스가 있습니다.
-
-불행히도 `0.52.0` 및 `0.52.6`은 dockerHub에서 완전히 삭제되었습니다.
-데이터베이스의 워크스페이스 버전을 `0.51.0`으로 수동 업데이트하고 바로 위 업그레이드 가이드를 따라 Twenty 버전 `0.52.11`로 업그레이드해야 합니다.
-
-### v0.50 to v0.51
-
-Twenty 인스턴스를 v0.51 이미지로 업그레이드하십시오.
-
-```
-yarn database:migrate:prod
-yarn command:prod upgrade
-```
-
-### v0.44.0 to v0.50.0
-
-Twenty 인스턴스를 v0.50.0 이미지로 업그레이드하십시오.
-
-```
-yarn database:migrate:prod
-yarn command:prod upgrade
-```
-
-#### Docker-compose.yml 변경
-
-이 버전은 `worker` 서비스가 `server-local-data` 볼륨에 접근할 수 있도록 `docker-compose.yml` 변경을 포함합니다.
-로컬 `docker-compose.yml`을 [v0.50.0 docker-compose.yml](https://github.com/twentyhq/twenty/blob/v0.50.0/packages/twenty-docker/docker-compose.yml)로 업데이트하십시오.
-
-### v0.43.0 to v0.44.0
-
-Twenty 인스턴스를 v0.44.0 이미지로 업그레이드하십시오.
-
-```
-yarn database:migrate:prod
-yarn command:prod upgrade
-```
-
-### v0.42.0 to v0.43.0
-
-Twenty 인스턴스를 v0.43.0 이미지로 업그레이드하십시오.
-
-```
-yarn database:migrate:prod
-yarn command:prod upgrade
-```
-
-이 버전에서는 docker-compose.yml 이미지가 postgres:16으로 전환되었습니다.
-
-#### (옵션 1) 데이터베이스 마이그레이션
-
-기존 postgres-spilo 이미지를 유지해도 되지만, docker-compose.yml에서 버전을 0.43.0으로 고정해야 합니다.
-
-#### (옵션 2) 데이터베이스 마이그레이션
-
-데이터베이스를 새로운 postgres:16 이미지로 마이그레이션하려면, 다음 단계를 따르십시오:
-
-1. 이전 postgres-spilo 컨테이너에서 데이터베이스를 덤프하십시오.
-
-```
-docker exec -it twenty-db-1 sh
-pg_dump -U {YOUR_POSTGRES_USER} -d {YOUR_POSTGRES_DB} > databases_backup.sql
-exit
-docker cp twenty-db-1:/home/postgres/databases_backup.sql .
-```
-
-덤프 파일이 비어 있지 않은지 확인하십시오.
-
-2. docker-compose.yml을 postgres:16 이미지를 사용하도록 [docker-compose.yml](https://raw.githubusercontent.com/twentyhq/twenty/main/packages/twenty-docker/docker-compose.yml) 파일에 따라 업그레이드하십시오.
-
-3. 새로운 postgres:16 컨테이너에 데이터베이스를 복원하십시오.
-
+cat databases_backup.sql | docker exec -i {db_container_name_or_id} psql -U {postgres_user}
```
-docker cp databases_backup.sql twenty-db-1:/databases_backup.sql
-docker exec -it twenty-db-1 sh
-psql -U {YOUR_POSTGRES_USER} -d {YOUR_POSTGRES_DB} -f databases_backup.sql
-exit
-```
-
-### v0.41.0 to v0.42.0
-Twenty 인스턴스를 v0.42.0 이미지로 업그레이드하십시오.
+Docker Compose를 사용하는 경우 다음 단계를 따르십시오:
-```
-yarn database:migrate:prod
-yarn command:prod upgrade-0.42
-```
-
-**환경 변수**
+1. Twenty 중지: `docker compose down`
+2. `docker-compose.yml` 옆에 있는 `.env` 파일에서 `TAG` 값을 변경하십시오
+3. Twenty 시작: `docker compose up -d`
-* 삭제됨: `FRONT_PORT`, `FRONT_PROTOCOL`, `FRONT_DOMAIN`, `PORT`
-* 추가됨: `FRONTEND_URL`, `NODE_PORT`, `MAX_NUMBER_OF_WORKSPACES_DELETED_PER_EXECUTION`, `MESSAGING_PROVIDER_MICROSOFT_ENABLED`, `CALENDAR_PROVIDER_MICROSOFT_ENABLED`, `IS_MICROSOFT_SYNC_ENABLED`
+서버는 시작 시 필요한 모든 업그레이드 마이그레이션을 자동으로 실행합니다. 수동 명령은 필요하지 않습니다.
-### v0.40.0 to v0.41.0
+## 교차 버전 업그레이드(v1.22+)
-Twenty 인스턴스를 v0.41.0 이미지로 업그레이드하십시오.
+**v1.22**부터 Twenty는 교차 버전 업그레이드를 지원합니다. 지원되는 어떤 버전에서든 각 중간 버전을 거치지 않고 최신 릴리스로 바로 이동할 수 있습니다.
-```
-yarn database:migrate:prod
-yarn command:prod upgrade-0.41
-```
+예를 들어, v1.22에서 v2.0으로 바로 업그레이드하는 것이 완전히 지원됩니다.
-**환경 변수**
+## v2.5+로 업그레이드 — 저장 상태 암호화 엔벨로프
-* 삭제됨: `AUTH_MICROSOFT_TENANT_ID`
+**v2.5**부터 Twenty는 저장 상태의 시크릿(OAuth 토큰, 애플리케이션 변수, 서명 키의 개인 키, 민감한 설정값, TOTP 시크릿)을 버전이 지정된 `enc:v2:` 엔벨로프에 담아, `ENCRYPTION_KEY`(또는 `ENCRYPTION_KEY`가 설정되지 않은 경우 `APP_SECRET`)로 암호화해 저장합니다.
-### v0.35.0 to v0.40.0
+v2.5에서 첫 부팅 시, 기존 행을 새로운 엔벨로프에 백필하는 속도가 느린 업그레이드 명령이 실행됩니다. 이는 멱등적이어서 — 서버를 중단했다가 다시 시작해도 중단된 지점부터 재개되지만 — 대규모 데이터베이스에서는 시간이 오래 걸릴 수 있습니다. `upgrade:status`로 진행 상황을 모니터링할 수 있습니다.
-Twenty 인스턴스를 v0.40.0 이미지로 업그레이드하십시오.
-
-```
-yarn database:migrate:prod
-yarn command:prod upgrade-0.40
-```
-
-**환경 변수**
-
-* 추가됨: `IS_EMAIL_VERIFICATION_REQUIRED`, `EMAIL_VERIFICATION_TOKEN_EXPIRES_IN`, `WORKFLOW_EXEC_THROTTLE_LIMIT`, `WORKFLOW_EXEC_THROTTLE_TTL`
-
-### v0.34.0 to v0.35.0
-
-Twenty 인스턴스를 v0.35.0 이미지로 업그레이드하십시오.
-
-```
-yarn database:migrate:prod
-yarn command:prod upgrade-0.35
-```
-
-`yarn database:migrate:prod` 명령은 데이터베이스 구조(핵심 및 메타데이터 스키마)에 마이그레이션을 적용합니다. `yarn command:prod upgrade-0.35`는 모든 워크스페이스의 데이터 마이그레이션을 처리합니다.
-
-**환경 변수**
-
-* `ENABLE_DB_MIGRATIONS`를 `DISABLE_DB_MIGRATIONS`로 교체했습니다(기본값은 이제 `false`이며, 별도의 설정이 필요하지 않을 것입니다.)
-
-### v0.33.0 to v0.34.0
-
-Twenty 인스턴스를 v0.34.0 이미지로 업그레이드하십시오.
-
-```
-yarn database:migrate:prod
-yarn command:prod upgrade-0.34
-```
-
-`yarn database:migrate:prod` 명령은 데이터베이스 구조(핵심 및 메타데이터 스키마)에 마이그레이션을 적용합니다. `yarn command:prod upgrade-0.34`는 모든 워크스페이스의 데이터 마이그레이션을 처리합니다.
-
-**환경 변수**
-
-* 삭제됨: `FRONT_BASE_URL`
-* 추가됨: `FRONT_DOMAIN`, `FRONT_PROTOCOL`, `FRONT_PORT`
-
-프런트엔드 URL을 처리하는 방식을 업데이트했습니다.
-이제 `FRONT_DOMAIN`, `FRONT_PROTOCOL` 및 `FRONT_PORT` 변수를 사용하여 프런트엔드 URL을 설정할 수 있습니다.
-`FRONT_DOMAIN`이 설정되지 않은 경우 프런트엔드 URL은 `SERVER_URL`로 대체됩니다.
-
-### v0.32.0 to v0.33.0
-
-Twenty 인스턴스를 v0.33.0 이미지로 업그레이드하십시오.
-
-```
-yarn command:prod cache:flush
-yarn database:migrate:prod
-yarn command:prod upgrade-0.33
-```
+백필이 처음부터 해당 키로 행을 기록할 수 있도록, v2.5 업그레이드 **이전에** 전용 `ENCRYPTION_KEY`를 설정해야 합니다. 백필 이후에 키를 변경하려면 [키 회전](/l/ko/developers/self-host/capabilities/key-rotation)이 필요합니다.
-`yarn command:prod cache:flush` 명령은 Redis 캐시를 플러시합니다.
-`yarn database:migrate:prod` 명령은 데이터베이스 구조(핵심 및 메타데이터 스키마)에 마이그레이션을 적용합니다. `yarn command:prod upgrade-0.33`는 모든 워크스페이스의 데이터 마이그레이션을 처리합니다.
+## 시크릿 및 서명 키 회전
-이 버전부터 DB용으로 twenty-postgres 이미지가 폐기되어 twenty-postgres-spilo가 대신 사용되었습니다.
-twenty-postgres 이미지를 계속 사용하려면, docker-compose.yml에서 `twentycrm/twenty-postgres:${TAG}`를 `twentycrm/twenty-postgres`로 교체하십시오.
+`ENCRYPTION_KEY` 회전, JWT 서명 키 회전, 유출된 서명 키 폐기와 같은 일상 운영 작업에 대해서는 전용 [키 회전 가이드](/l/ko/developers/self-host/capabilities/key-rotation)를 참조하세요.
-### v0.31.0 to v0.32.0
+## 업그레이드 상태 확인
-Twenty 인스턴스를 v0.32.0 이미지로 업그레이드하십시오.
+`upgrade:status` 명령을 사용하면 인스턴스 및 워크스페이스 마이그레이션의 현재 상태를 확인할 수 있습니다. 업그레이드 문제를 디버깅하거나 지원 요청을 제출할 때 유용합니다.
-**스키마 및 데이터 마이그레이션**
+서버 컨테이너에서 실행하십시오:
-```
-yarn database:migrate:prod
-yarn command:prod upgrade-0.32
-```
-
-`yarn database:migrate:prod` 명령은 데이터베이스 구조(핵심 및 메타데이터 스키마)에 마이그레이션을 적용합니다. `yarn command:prod upgrade-0.32`는 모든 워크스페이스의 데이터 마이그레이션을 처리합니다.
-
-**환경 변수**
-
-Redis 연결을 처리하는 방식을 업데이트했습니다.
-
-* 삭제됨: `REDIS_HOST`, `REDIS_PORT`, `REDIS_USERNAME`, `REDIS_PASSWORD`
-* 추가됨: `REDIS_URL`
-
-`.env` 파일을 업데이트하여 개별 Redis 연결 매개변수 대신 새 `REDIS_URL` 변수를 사용하십시오.
-
-JWT 토큰을 처리하는 방식도 간소화했습니다.
-
-* 삭제됨: `ACCESS_TOKEN_SECRET`, `LOGIN_TOKEN_SECRET`, `REFRESH_TOKEN_SECRET`, `FILE_TOKEN_SECRET`
-* 추가됨: `APP_SECRET`
-
-.env 파일을 업데이트하여 개별 토큰 비밀 대신 새로운 `APP_SECRET` 변수를 사용하십시오 (이전 비밀을 그대로 사용하거나 새 임의 문자열을 생성할 수 있습니다.)
-
-**연결된 계정**
-
-Google 이메일 및 캘린더 동기화를 위해 연결된 계정을 사용하는 경우, Google 관리 콘솔에서 [People API](https://developers.google.com/people)를 활성화해야 합니다.
-
-### v0.30.0 to v0.31.0
-
-Twenty 인스턴스를 v0.31.0 이미지로 업그레이드하십시오.
-
-**스키마 및 데이터 마이그레이션**:
-
-```
-yarn database:migrate:prod
-yarn command:prod upgrade-0.31
+```bash
+docker exec -it {server_container_name_or_id} yarn command:prod upgrade:status
```
-`yarn database:migrate:prod` 명령은 데이터베이스 구조(핵심 및 메타데이터 스키마)에 마이그레이션을 적용합니다. `yarn command:prod upgrade-0.31`는 모든 워크스페이스의 데이터 마이그레이션을 처리합니다.
+출력 예:
-### v0.24.0 to v0.30.0
+```sh
+APP_VERSION: v1.23.0
-Twenty 인스턴스를 v0.30.0 이미지로 업그레이드하십시오.
+Instance
+ Inferred version: 1.23.0
+ Latest command: 1.23.0_DropWorkspaceVersionColumnFastInstanceCommand_1785000000000
+ Status: Up to date
+ Executed by: v1.23.0
+ At: 2026-04-16T11:43:58.823Z
-**중대한 변경 사항**:
-성능을 개선하기 위해, 이제 Twenty는 redis 캐시 구성이 필요합니다. [docker-compose.yml](https://raw.githubusercontent.com/twentyhq/twenty/main/packages/twenty-docker/docker-compose.yml)을 업데이트하여 이를 반영했습니다.
-구성을 업데이트하고 환경 변수를 적절히 업데이트하십시오:
+Workspace
+ Apple (20202020-1c25-4d02-bf25-6aeccf7ea419)
+ Inferred version: 1.23.0
+ Latest command: 1.23.0_UpdateGlobalObjectContextCommandMenuItemsCommand_1780000005000
+ Status: Up to date
+ Executed by: v1.23.0
+ At: 2026-04-16T11:44:09.361Z
+Summary
+ Instance: Up to date
+ Workspaces: 1 up to date, 0 behind, 0 failed (1 total)
```
-REDIS_HOST={your-redis-host}
-REDIS_PORT={your-redis-port}
-CACHE_STORAGE_TYPE=redis
-```
-
-**스키마 및 데이터 마이그레이션**:
-
-```
-yarn database:migrate:prod
-yarn command:prod upgrade-0.30
-```
-
-`yarn database:migrate:prod` 명령은 데이터베이스 구조(핵심 및 메타데이터 스키마)에 마이그레이션을 적용합니다. `yarn command:prod upgrade-0.30`는 모든 워크스페이스의 데이터 마이그레이션을 처리합니다.
-
-### v0.23.0 to v0.24.0
-
-Twenty 인스턴스를 v0.24.0 이미지로 업그레이드하십시오.
-
-다음 명령어를 실행하십시오:
-```
-yarn database:migrate:prod
-yarn command:prod upgrade-0.24
-```
+### 옵션
-`yarn database:migrate:prod` 명령은 데이터베이스 구조(핵심 및 메타데이터 스키마)에 마이그레이션을 적용합니다. `yarn command:prod upgrade-0.24`는 모든 워크스페이스의 데이터 마이그레이션을 처리합니다.
+| 플래그 | 설명 |
+| ------------------------- | ---------------------------------------- |
+| `-w, --workspace-id <id>` | 특정 워크스페이스로 필터링합니다. 여러 번 지정할 수 있습니다. |
+| `-f, --failed-only` | 최신 상태의 워크스페이스는 숨기고, 뒤처졌거나 실패한 항목만 표시합니다. |
-### v0.22.0 to v0.23.0
+## 문제 해결
-Twenty 인스턴스를 v0.23.0 이미지로 업그레이드하십시오.
+일부 워크스페이스에서 업그레이드가 실패하면 서버는 실패한 단계 이후로 진행하지 않습니다. 서버를 다시 시작하면(`docker compose up -d`) 중단된 지점부터 업그레이드를 다시 시도합니다.
-다음 명령어를 실행하십시오:
+문제를 빠르게 식별하려면 다음을 실행하십시오:
+```bash
+docker exec -it {server_container_name_or_id} yarn command:prod upgrade:status --failed-only
```
-yarn database:migrate:prod
-yarn command:prod upgrade-0.23
-```
-
-`yarn database:migrate:prod` 명령은 데이터베이스에 마이그레이션을 적용합니다.
-`yarn command:prod upgrade-0.23`는 데이터 마이그레이션을 처리하며, 활동을 작업/노트로 전송하는 것도 포함합니다.
-### v0.21.0 to v0.22.0
+이는 뒤처졌거나 실패한 워크스페이스만 표시하고 각 실패에 대한 오류 메시지도 함께 표시합니다.
-Twenty 인스턴스를 v0.22.0 이미지로 업그레이드하십시오.
-
-다음 명령어를 실행하십시오:
-
-```
-yarn database:migrate:prod
-yarn command:prod upgrade-0.22
-```
+## v1.22 이전
-`yarn database:migrate:prod` 명령은 데이터베이스에 마이그레이션을 적용합니다.
-`yarn command:prod upgrade-0.22` 명령은 새 객체 defaultRequestInstrumentationOptions에 적응하기 위한 특정 데이터 변환을 적용합니다.
+인스턴스가 v1.22보다 오래된 경우, v1.22에 도달할 때까지 각 주요 태그 버전(v1.6에서 v1.7, 이어서 v1.7에서 v1.8 등)을 순차적으로 업그레이드해야 합니다. 그 이후에는 최신 버전으로 바로 업그레이드할 수 있습니다.
diff --git a/packages/twenty-docs/l/ko/navigation.json b/packages/twenty-docs/l/ko/navigation.json
index 4b27d9e5ce7..1f013466e42 100644
--- a/packages/twenty-docs/l/ko/navigation.json
+++ b/packages/twenty-docs/l/ko/navigation.json
@@ -1,24 +1,27 @@
{
"tabs": {
+ "gettingStarted": {
+ "label": "시작하기",
+ "groups": {
+ "welcome": {
+ "label": "환영합니다"
+ },
+ "coreConcepts": {
+ "label": "핵심 개념"
+ }
+ }
+ },
"userGuide": {
"label": "사용자 안내서",
"groups": {
- "discoverTwenty": {
- "label": "Twenty 알아보기",
- "groups": {
- "gettingStartedCapabilities": {
- "label": "기능"
- },
- "gettingStartedHowTos": {
- "label": "사용 방법"
- }
- }
+ "userGuideOverview": {
+ "label": "개요"
},
"dataModel": {
"label": "데이터 모델",
"groups": {
- "dataModelCapabilities": {
- "label": "기능"
+ "dataModelReference": {
+ "label": "참고"
},
"dataModelHowTos": {
"label": "사용 방법"
@@ -28,8 +31,8 @@
"dataMigration": {
"label": "데이터 마이그레이션",
"groups": {
- "dataMigrationCapabilities": {
- "label": "기능"
+ "dataMigrationReference": {
+ "label": "참고"
},
"dataMigrationHowTos": {
"label": "사용 방법"
@@ -39,8 +42,8 @@
"calendarEmails": {
"label": "캘린더 및 이메일",
"groups": {
- "calendarEmailsCapabilities": {
- "label": "기능"
+ "calendarEmailsReference": {
+ "label": "참고"
},
"calendarEmailsHowTos": {
"label": "사용 방법"
@@ -50,8 +53,8 @@
"workflows": {
"label": "워크플로우",
"groups": {
- "workflowsCapabilities": {
- "label": "기능"
+ "workflowsReference": {
+ "label": "참고"
},
"workflowsHowTos": {
"label": "사용 방법",
@@ -75,21 +78,26 @@
"ai": {
"label": "AI",
"groups": {
- "aiCapabilities": {
- "label": "기능"
+ "aiReference": {
+ "label": "참고"
},
"aiHowTos": {
"label": "사용 방법"
}
}
},
- "viewsPipelines": {
- "label": "뷰 및 파이프라인",
+ "layout": {
+ "label": "레이아웃",
"groups": {
- "viewsPipelinesCapabilities": {
- "label": "기능"
+ "layoutReference": {
+ "label": "참고",
+ "groups": {
+ "layoutViews": {
+ "label": "보기"
+ }
+ }
},
- "viewsPipelinesHowTos": {
+ "layoutHowTos": {
"label": "사용 방법"
}
}
@@ -97,8 +105,8 @@
"dashboards": {
"label": "대시보드",
"groups": {
- "dashboardsCapabilities": {
- "label": "기능"
+ "dashboardsReference": {
+ "label": "참고"
},
"dashboardsHowTos": {
"label": "사용 방법"
@@ -108,8 +116,8 @@
"permissionsAccess": {
"label": "권한 및 접근",
"groups": {
- "permissionsAccessCapabilities": {
- "label": "기능"
+ "permissionsAccessReference": {
+ "label": "참고"
},
"permissionsAccessHowTos": {
"label": "사용 방법"
@@ -119,8 +127,8 @@
"billing": {
"label": "청구",
"groups": {
- "billingCapabilities": {
- "label": "기능"
+ "billingReference": {
+ "label": "참고"
},
"billingHowTos": {
"label": "사용 방법"
@@ -130,8 +138,8 @@
"settings": {
"label": "설정",
"groups": {
- "settingsCapabilities": {
- "label": "기능"
+ "settingsReference": {
+ "label": "참고"
},
"settingsHowTos": {
"label": "사용 방법"
@@ -143,59 +151,40 @@
"developers": {
"label": "개발자",
"groups": {
- "developersGroup": {
- "label": "개발자"
+ "developersOverview": {
+ "label": "개요"
},
- "extend": {
- "label": "확장",
+ "apps": {
+ "label": "앱",
"groups": {
- "extendCapabilities": {
- "label": "기능"
+ "appsGettingStarted": {
+ "label": "시작하기"
+ },
+ "appsConfig": {
+ "label": "설정"
+ },
+ "appsData": {
+ "label": "데이터"
+ },
+ "appsLogic": {
+ "label": "로직"
+ },
+ "appsLayout": {
+ "label": "레이아웃"
+ },
+ "appsOperations": {
+ "label": "작업"
}
}
},
+ "api": {
+ "label": "API"
+ },
"selfHost": {
- "label": "셀프 호스팅",
- "groups": {
- "selfHostCapabilities": {
- "label": "기능"
- }
- }
+ "label": "셀프 호스팅"
},
"contribute": {
- "label": "기여",
- "groups": {
- "contributeCapabilities": {
- "label": "기능",
- "groups": {
- "frontendDevelopment": {
- "label": "프론트엔드 개발",
- "groups": {
- "twentyUi": {
- "label": "Twenty UI",
- "groups": {
- "display": {
- "label": "표시"
- },
- "feedback": {
- "label": "피드백"
- },
- "input": {
- "label": "입력"
- },
- "navigation": {
- "label": "네비게이션"
- }
- }
- }
- }
- },
- "backendDevelopment": {
- "label": "백엔드 개발"
- }
- }
- }
- }
+ "label": "기여"
}
}
}
diff --git a/packages/twenty-docs/l/ko/twenty-ui/display/app-tooltip.mdx b/packages/twenty-docs/l/ko/twenty-ui/display/app-tooltip.mdx
index fc529bfb998..95dd53b6b90 100644
--- a/packages/twenty-docs/l/ko/twenty-ui/display/app-tooltip.mdx
+++ b/packages/twenty-docs/l/ko/twenty-ui/display/app-tooltip.mdx
@@ -1,5 +1,6 @@
---
title: 앱 툴팁
+icon: 메시지
---
<Frame>
@@ -9,46 +10,54 @@ title: 앱 툴팁
요소와 상호작용할 때 추가 정보를 표시하는 간단한 메시지입니다.
<Tabs>
- <Tab title="사용법">
- ```jsx
- import { AppTooltip } from "@/ui/display/tooltip/AppTooltip";
-
- export const MyComponent = () => {
- return (
- <>
- <p id="hoverText" style={{ display: "inline-block" }}>
- Customer Insights
- </p>
- <AppTooltip
- className
- anchorSelect="#hoverText"
- content="Explore customer behavior and preferences"
- delayHide={0}
- offset={6}
- noArrow={false}
- isOpen={true}
- place="bottom"
- positionStrategy="absolute"
- />
- </>
- );
- };
- ```
- </Tab>
-
- <Tab title="프로퍼티">
- | 프로퍼티 | 유형 | 설명 |
- | ------ | --------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
- | 클래스 네임 | 문자열 | 추가 스타일링을 위한 선택적 CSS 클래스 |
- | 앵커 선택 | CSS 선택자 | 툴팁 앵커(툴팁을 트리거하는 요소)의 선택자 |
- | 내용 | 문자열 | 툴팁 내에 표시할 내용을 입력하세요 |
- | 지연 숨기기 | 숫자 | 커서가 앵커를 떠난 후 툴팁이 숨겨지기까지의 지연 시간(초) |
- | 오프셋 | 숫자 | 툴팁 위치 조건을 위한 픽셀 단위의 오프셋 |
- | 화살표 없음 | 부울 | `true`이면 툴팁의 화살표가 숨겨집니다 |
- | 열림 여부 | 부울 | `true`이면 툴팁이 기본적으로 열려 있습니다 |
- | 위치 | `react-tooltip`의 `PlacesType` 문자열 | 툴팁의 배치를 지정합니다. 값으로는 `bottom`, `left`, `right`, `top`, `top-start`, `top-end`, `right-start`, `right-end`, `bottom-start`, `bottom-end`, `left-start`, `left-end` 등이 있습니다. |
- | 위치 전략 | `react-tooltip`의 `PositionStrategy` 문자열 | 툴팁에 대한 위치 전략입니다. 두 가지 값: `absolute` 및 `fixed` |
- </Tab>
+<Tab title="사용법">
+
+```jsx
+import { AppTooltip } from "@/ui/display/tooltip/AppTooltip";
+
+export const MyComponent = () => {
+ return (
+ <>
+ <p id="hoverText" style={{ display: "inline-block" }}>
+ Customer Insights
+ </p>
+ <AppTooltip
+ className
+ anchorSelect="#hoverText"
+ content="Explore customer behavior and preferences"
+ delayHide={0}
+ offset={6}
+ noArrow={false}
+ isOpen={true}
+ place="bottom"
+ positionStrategy="absolute"
+ />
+ </>
+ );
+};
+```
+
+</Tab>
+
+<Tab title="프로퍼티">
+
+
+| 프로퍼티 | 유형 | 설명 |
+| ------ | --------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| 클래스 네임 | 문자열 | 추가 스타일링을 위한 선택적 CSS 클래스 |
+| 앵커 선택 | CSS 선택자 | 툴팁 앵커(툴팁을 트리거하는 요소)의 선택자 |
+| 내용 | 문자열 | 툴팁 내에 표시할 내용을 입력하세요 |
+| 지연 숨기기 | 숫자 | 커서가 앵커를 떠난 후 툴팁이 숨겨지기까지의 지연 시간(초) |
+| 오프셋 | 숫자 | 툴팁 위치 조건을 위한 픽셀 단위의 오프셋 |
+| 화살표 없음 | 부울 | `true`이면 툴팁의 화살표가 숨겨집니다 |
+| 열림 여부 | 부울 | `true`이면 툴팁이 기본적으로 열려 있습니다 |
+| 위치 | `react-tooltip`의 `PlacesType` 문자열 | 툴팁의 배치를 지정합니다. 값으로는 `bottom`, `left`, `right`, `top`, `top-start`, `top-end`, `right-start`, `right-end`, `bottom-start`, `bottom-end`, `left-start`, `left-end` 등이 있습니다. |
+| 위치 전략 | `react-tooltip`의 `PositionStrategy` 문자열 | 툴팁에 대한 위치 전략입니다. 두 가지 값: `absolute` 및 `fixed` |
+
+
+
+</Tab>
+
</Tabs>
## 툴팁이 포함된 오버플로 텍스트
@@ -56,22 +65,30 @@ title: 앱 툴팁
텍스트가 넘칠 경우 처리하고 툴팁을 표시합니다.
<Tabs>
- <Tab title="사용법">
- ```jsx
- import { OverflowingTextWithTooltip } from 'twenty-ui/display';
-
- export const MyComponent = () => {
- const crmTaskDescription =
- 'Follow up with client regarding their recent product inquiry. Discuss pricing options, address any concerns, and provide additional product information. Record the details of the conversation in the CRM for future reference.';
-
- return <OverflowingTextWithTooltip text={crmTaskDescription} />;
- };
- ```
- </Tab>
-
- <Tab title="프로퍼티">
- | 프로퍼티 | 유형 | 설명 |
- | ---- | --- | -------------------------- |
- | 텍스트 | 문자열 | 오버플로 텍스트 영역에 표시할 내용을 입력하세요 |
- </Tab>
+<Tab title="사용법">
+
+```jsx
+import { OverflowingTextWithTooltip } from 'twenty-ui/display';
+
+export const MyComponent = () => {
+ const crmTaskDescription =
+ 'Follow up with client regarding their recent product inquiry. Discuss pricing options, address any concerns, and provide additional product information. Record the details of the conversation in the CRM for future reference.';
+
+ return <OverflowingTextWithTooltip text={crmTaskDescription} />;
+};
+```
+
+</Tab>
+
+<Tab title="프로퍼티">
+
+
+| 프로퍼티 | 유형 | 설명 |
+| ---- | --- | -------------------------- |
+| 텍스트 | 문자열 | 오버플로 텍스트 영역에 표시할 내용을 입력하세요 |
+
+
+
+</Tab>
+
</Tabs>
diff --git a/packages/twenty-docs/l/ko/twenty-ui/display/checkmark.mdx b/packages/twenty-docs/l/ko/twenty-ui/display/checkmark.mdx
index 069b78b98c3..e2ffe109956 100644
--- a/packages/twenty-docs/l/ko/twenty-ui/display/checkmark.mdx
+++ b/packages/twenty-docs/l/ko/twenty-ui/display/checkmark.mdx
@@ -1,5 +1,6 @@
---
title: 체크마크
+icon: circle-check
---
<Frame>
@@ -9,19 +10,25 @@ title: 체크마크
성공하거나 완료된 작업을 나타냅니다.
<Tabs>
- <Tab title="사용법">
- ```jsx
- import { Checkmark } from 'twenty-ui/display';
-
- export const MyComponent = () => {
- return <Checkmark />;
- };
- ```
- </Tab>
-
- <Tab title="프로퍼티">
- `React.ComponentPropsWithoutRef<'div'>` 를 확장하며 일반 `div` 요소의 모든 속성을 수용합니다.
- </Tab>
+<Tab title="사용법">
+
+```jsx
+import { Checkmark } from 'twenty-ui/display';
+
+export const MyComponent = () => {
+ return <Checkmark />;
+};
+```
+
+
+</Tab>
+
+<Tab title="프로퍼티">
+
+`React.ComponentPropsWithoutRef<'div'>` 를 확장하며 일반 `div` 요소의 모든 속성을 수용합니다.
+
+</Tab>
+
</Tabs>
## 애니메이션 체크마크
@@ -29,29 +36,38 @@ title: 체크마크
애니메이션 기능이 추가된 체크마크 아이콘을 나타냅니다.
<Tabs>
- <Tab title="사용법">
- ```jsx
- import { AnimatedCheckmark } from 'twenty-ui/display';
-
- export const MyComponent = () => {
- return (
- <AnimatedCheckmark
- isAnimating={true}
- color="green"
- duration={0.5}
- size={30}
- />
- );
- };
- ```
- </Tab>
-
- <Tab title="프로퍼티">
- | 프로퍼티 | 유형 | 설명 | 기본값 |
- | ----------- | --- | -------------------------- | ----- |
- | isAnimating | 부울 | 체크마크가 애니메이션 중인지 여부를 제어합니다. | 거짓 |
- | 색상 | 문자열 | 체크마크의 색상 | |
- | 지속 시간 | 숫자 | 애니메이션의 지속 시간(초) | 0.5초 |
- | 크기 | 숫자 | 체크마크의 크기 | 28 픽셀 |
- </Tab>
+
+<Tab title="사용법">
+
+```jsx
+import { AnimatedCheckmark } from 'twenty-ui/display';
+
+export const MyComponent = () => {
+ return (
+ <AnimatedCheckmark
+ isAnimating={true}
+ color="green"
+ duration={0.5}
+ size={30}
+ />
+ );
+};
+```
+
+</Tab>
+
+<Tab title="프로퍼티">
+
+
+| 프로퍼티 | 유형 | 설명 | 기본값 |
+| ----------- | --- | -------------------------- | ----- |
+| isAnimating | 부울 | 체크마크가 애니메이션 중인지 여부를 제어합니다. | 거짓 |
+| 색상 | 문자열 | 체크마크의 색상 | |
+| 지속 시간 | 숫자 | 애니메이션의 지속 시간(초) | 0.5초 |
+| 크기 | 숫자 | 체크마크의 크기 | 28 픽셀 |
+
+
+
+</Tab>
+
</Tabs>
diff --git a/packages/twenty-docs/l/ko/twenty-ui/display/chip.mdx b/packages/twenty-docs/l/ko/twenty-ui/display/chip.mdx
index 05a11fbf2d1..344e9567e33 100644
--- a/packages/twenty-docs/l/ko/twenty-ui/display/chip.mdx
+++ b/packages/twenty-docs/l/ko/twenty-ui/display/chip.mdx
@@ -9,40 +9,48 @@ title: 칩
레이블, 선택적 왼쪽 및 오른쪽 컴포넌트, 다양한 스타일 옵션을 갖춘 시각적 요소로, 레이블과 태그를 표시하는 클릭 가능 또는 클릭 불가 컨테이너로 사용할 수 있습니다.
<Tabs>
- <Tab title="사용법">
- ```jsx
- import { Chip } from 'twenty-ui/components';
-
- export const MyComponent = () => {
- return (
- <Chip
- size="large"
- label="클릭 가능한 칩"
- clickable={true}
- variant="highlighted"
- accent="text-primary"
- leftComponent
- rightComponent
- maxWidth="200px"
- className
- />
- );
- };
-
- ```
- </Tab>
-
- <Tab title="프로퍼티">
- | 프로퍼티 | 유형 | 설명 |
- | ------------ | ----------------------- | --------------------------------------------------------- |
- | linkToEntity | 문자열 | 엔티티에 대한 링크 |
- | entityId | 문자열 | 엔티티의 고유 식별자 |
- | 이름 | 문자열 | 엔티티의 이름 |
- | pictureUrl | 문자열 | 사진", |
- | avatarType | 아바타 유형 | 표시할 아바타의 유형입니다. 두 가지 옵션이 있습니다: `rounded`와 `squared` |
- | 변형 | `EntityChipVariant` 열거형 | 표시할 엔티티 칩의 변형입니다. 두 가지 옵션이 있습니다: `regular`와 `transparent` |
- | 왼쪽 아이콘 | 아이콘 컴포넌트 | 아이콘을 나타내는 React 컴포넌트입니다. 칩의 왼쪽에 표시됩니다. |
- </Tab>
+
+<Tab title="사용법">
+
+```jsx
+import { Chip } from 'twenty-ui/components';
+
+export const MyComponent = () => {
+ return (
+ <Chip
+ size="large"
+ label="클릭 가능한 칩"
+ clickable={true}
+ variant="highlighted"
+ accent="text-primary"
+ leftComponent
+ rightComponent
+ maxWidth="200px"
+ className
+ />
+ );
+};
+
+```
+
+</Tab>
+
+<Tab title="프로퍼티">
+
+
+| 프로퍼티 | 유형 | 설명 |
+| ------------ | ----------------------- | --------------------------------------------------------- |
+| linkToEntity | 문자열 | 엔티티에 대한 링크 |
+| entityId | 문자열 | 엔티티의 고유 식별자 |
+| 이름 | 문자열 | 엔티티의 이름 |
+| pictureUrl | 문자열 | 사진", |
+| avatarType | 아바타 유형 | 표시할 아바타의 유형입니다. 두 가지 옵션이 있습니다: `rounded`와 `squared` |
+| 변형 | `EntityChipVariant` 열거형 | 표시할 엔티티 칩의 변형입니다. 두 가지 옵션이 있습니다: `regular`와 `transparent` |
+| 왼쪽 아이콘 | 아이콘 컴포넌트 | 아이콘을 나타내는 React 컴포넌트입니다. 칩의 왼쪽에 표시됩니다. |
+
+
+
+</Tab>
</Tabs>
## 예시
@@ -99,39 +107,47 @@ export const MyComponent = () => {
엔티티에 대한 정보를 표시하기 위한 칩 유사 요소입니다.
<Tabs>
- <Tab title="사용법">
- ```jsx
- import { BrowserRouter as Router } from 'react-router-dom';
- import { IconTwentyStar } from 'twenty-ui/display';
- import { Chip } from 'twenty-ui/components';
-
- export const MyComponent = () => {
- return (
- <Router>
- <Chip
- linkToEntity="/entity-link"
- entityId="entityTest"
- name="엔터티 이름"
- pictureUrl=""
- avatarType="rounded"
- variant="regular"
- LeftIcon={IconTwentyStar}
- />
- </Router>
- );
- };
- ```
- </Tab>
-
- <Tab title="프로퍼티">
- | 프로퍼티 | 유형 | 설명 |
- | ------------ | ----------------------- | --------------------------------------------------------- |
- | linkToEntity | 문자열 | 엔티티에 대한 링크 |
- | entityId | 문자열 | 엔티티의 고유 식별자 |
- | 이름 | 문자열 | 엔티티의 이름 |
- | pictureUrl | 문자열 | 사진", |
- | avatarType | 아바타 유형 | 표시할 아바타의 유형입니다. 두 가지 옵션이 있습니다: `rounded`와 `squared` |
- | 변형 | `EntityChipVariant` 열거형 | 표시할 엔티티 칩의 변형입니다. 두 가지 옵션이 있습니다: `regular`와 `transparent` |
- | 왼쪽 아이콘 | 아이콘 컴포넌트 | 아이콘을 나타내는 React 컴포넌트입니다. 칩의 왼쪽에 표시됩니다. |
- </Tab>
+
+<Tab title="사용법">
+
+```jsx
+import { BrowserRouter as Router } from 'react-router-dom';
+import { IconTwentyStar } from 'twenty-ui/display';
+import { Chip } from 'twenty-ui/components';
+
+export const MyComponent = () => {
+ return (
+ <Router>
+ <Chip
+ linkToEntity="/entity-link"
+ entityId="entityTest"
+ name="엔터티 이름"
+ pictureUrl=""
+ avatarType="rounded"
+ variant="regular"
+ LeftIcon={IconTwentyStar}
+ />
+ </Router>
+ );
+};
+```
+
+</Tab>
+
+<Tab title="프로퍼티">
+
+
+| 프로퍼티 | 유형 | 설명 |
+| ------------ | ----------------------- | --------------------------------------------------------- |
+| linkToEntity | 문자열 | 엔티티에 대한 링크 |
+| entityId | 문자열 | 엔티티의 고유 식별자 |
+| 이름 | 문자열 | 엔티티의 이름 |
+| pictureUrl | 문자열 | 사진", |
+| avatarType | 아바타 유형 | 표시할 아바타의 유형입니다. 두 가지 옵션이 있습니다: `rounded`와 `squared` |
+| 변형 | `EntityChipVariant` 열거형 | 표시할 엔티티 칩의 변형입니다. 두 가지 옵션이 있습니다: `regular`와 `transparent` |
+| 왼쪽 아이콘 | 아이콘 컴포넌트 | 아이콘을 나타내는 React 컴포넌트입니다. 칩의 왼쪽에 표시됩니다. |
+
+
+
+</Tab>
</Tabs>
diff --git a/packages/twenty-docs/l/ko/twenty-ui/display/icons.mdx b/packages/twenty-docs/l/ko/twenty-ui/display/icons.mdx
index d31a6cf7e31..e125728f7aa 100644
--- a/packages/twenty-docs/l/ko/twenty-ui/display/icons.mdx
+++ b/packages/twenty-docs/l/ko/twenty-ui/display/icons.mdx
@@ -1,5 +1,6 @@
---
title: 아이콘들
+icon: 아이콘
---
<Frame>
@@ -13,35 +14,44 @@ title: 아이콘들
앱 전반에 걸쳐 React에 타블러 아이콘을 사용합니다.
<Tabs>
- <Tab title="설치">
- <br />
-
- ```
- yarn add @tabler/icons-react
- ```
- </Tab>
-
- <Tab title="프로퍼티">
- 각 아이콘을 컴포넌트로 가져올 수 있습니다. 다음은 예시입니다:
-
- <br />
-
- ```jsx
- import { IconArrowLeft } from "@tabler/icons-react";
-
- export const MyComponent = () => {
- return <IconArrowLeft color="red" size={48} />;
- };
- ```
- </Tab>
-
- <Tab title="프로퍼티">
- | 프로퍼티 | 유형 | 설명 | 기본값 |
- | ---- | --- | ------------------ | ------------ |
- | 크기 | 숫자 | 픽셀 단위의 아이콘 높이와 너비 | 24 |
- | 색상 | 문자열 | 아이콘의 색상 | currentColor |
- | 스트로크 | 숫자 | 픽셀 단위의 아이콘 스트로크 너비 | 2 |
- </Tab>
+
+<Tab title="설치">
+<br />
+
+```
+yarn add @tabler/icons-react
+```
+
+</Tab>
+
+<Tab title="프로퍼티">
+
+각 아이콘을 컴포넌트로 가져올 수 있습니다. 다음은 예시입니다:
+<br />
+
+```jsx
+import { IconArrowLeft } from "@tabler/icons-react";
+
+export const MyComponent = () => {
+ return <IconArrowLeft color="red" size={48} />;
+};
+```
+
+</Tab>
+
+<Tab title="프로퍼티">
+
+
+| 프로퍼티 | 유형 | 설명 | 기본값 |
+| ---- | --- | ------------------ | ------------ |
+| 크기 | 숫자 | 픽셀 단위의 아이콘 높이와 너비 | 24 |
+| 색상 | 문자열 | 아이콘의 색상 | currentColor |
+| 스트로크 | 숫자 | 픽셀 단위의 아이콘 스트로크 너비 | 2 |
+
+
+
+</Tab>
+
</Tabs>
## 커스텀 아이콘
@@ -53,20 +63,29 @@ title: 아이콘들
주소록 아이콘을 표시합니다.
<Tabs>
- <Tab title="사용법">
- ```jsx
- import { IconAddressBook } from 'twenty-ui/display';
-
- export const MyComponent = () => {
- return <IconAddressBook size={24} stroke={2} />;
- };
- ```
- </Tab>
-
- <Tab title="프로퍼티">
- | 프로퍼티 | 유형 | 설명 | 기본값 |
- | ---- | -- | ------------------ | --- |
- | 크기 | 숫자 | 픽셀 단위의 아이콘 높이와 너비 | 24 |
- | 스트로크 | 숫자 | 픽셀 단위의 아이콘 스트로크 너비 | 2 |
- </Tab>
+
+<Tab title="사용법">
+
+```jsx
+import { IconAddressBook } from 'twenty-ui/display';
+
+export const MyComponent = () => {
+ return <IconAddressBook size={24} stroke={2} />;
+};
+```
+
+</Tab>
+
+<Tab title="프로퍼티">
+
+
+| 프로퍼티 | 유형 | 설명 | 기본값 |
+| ---- | -- | ------------------ | --- |
+| 크기 | 숫자 | 픽셀 단위의 아이콘 높이와 너비 | 24 |
+| 스트로크 | 숫자 | 픽셀 단위의 아이콘 스트로크 너비 | 2 |
+
+
+
+</Tab>
+
</Tabs>
diff --git a/packages/twenty-docs/l/ko/twenty-ui/display/soon-pill.mdx b/packages/twenty-docs/l/ko/twenty-ui/display/soon-pill.mdx
index b41e78b2953..2d0db1366d3 100644
--- a/packages/twenty-docs/l/ko/twenty-ui/display/soon-pill.mdx
+++ b/packages/twenty-docs/l/ko/twenty-ui/display/soon-pill.mdx
@@ -2,7 +2,6 @@
title: 제공 예정 배지
---
-
무언가가 곧 제공될 것임을 나타내는 작은 배지 또는 "pill"입니다.
```jsx
diff --git a/packages/twenty-docs/l/ko/twenty-ui/display/tag.mdx b/packages/twenty-docs/l/ko/twenty-ui/display/tag.mdx
index e8d6bd53573..eff374330b7 100644
--- a/packages/twenty-docs/l/ko/twenty-ui/display/tag.mdx
+++ b/packages/twenty-docs/l/ko/twenty-ui/display/tag.mdx
@@ -1,34 +1,43 @@
---
title: 태그
+icon: 태그
---
-
콘텐츠를 시각적으로 분류하거나 라벨을 붙이는 구성 요소입니다.
<Tabs>
- <Tab title="사용법">
- ```jsx
- import { Tag } from "@/ui/display/tag/components/Tag";
-
- export const MyComponent = () => {
- return (
- <Tag
- className
- color="red"
- text="긴급"
- onClick={() => console.log("click")}
- />
- );
- };
- ```
- </Tab>
-
- <Tab title="프로퍼티">
- | 프로퍼티 | 유형 | 설명 |
- | ------- | --- | ----------------------------------------------------------------------------------- |
- | 클래스 네임 | 문자열 | 추가 스타일링을 위한 선택적 이름 |
- | 색상 | 문자열 | 태그의 색상. 옵션은 `녹색`, `터키옥색`, `하늘색`, `파랑`, `보라색`, `핑크`, `빨강`, `오렌지`, `노랑`, `회색`을 포함합니다. |
- | 텍스트 | 문자열 | 태그의 콘텐츠 |
- | onClick | 함수 | 사용자가 태그를 클릭할 때 호출되는 선택적 함수 |
- </Tab>
+
+<Tab title="사용법">
+
+```jsx
+import { Tag } from "@/ui/display/tag/components/Tag";
+
+export const MyComponent = () => {
+ return (
+ <Tag
+ className
+ color="red"
+ text="긴급"
+ onClick={() => console.log("click")}
+ />
+ );
+};
+```
+
+</Tab>
+
+<Tab title="프로퍼티">
+
+
+| 프로퍼티 | 유형 | 설명 |
+| ------- | --- | ----------------------------------------------------------------------------------- |
+| 클래스 네임 | 문자열 | 추가 스타일링을 위한 선택적 이름 |
+| 색상 | 문자열 | 태그의 색상. 옵션은 `녹색`, `터키옥색`, `하늘색`, `파랑`, `보라색`, `핑크`, `빨강`, `오렌지`, `노랑`, `회색`을 포함합니다. |
+| 텍스트 | 문자열 | 태그의 콘텐츠 |
+| onClick | 함수 | 사용자가 태그를 클릭할 때 호출되는 선택적 함수 |
+
+
+
+</Tab>
+
</Tabs>
diff --git a/packages/twenty-docs/l/ko/twenty-ui/input/block-editor.mdx b/packages/twenty-docs/l/ko/twenty-ui/input/block-editor.mdx
index 3147b7b3a81..9c5959e60b0 100644
--- a/packages/twenty-docs/l/ko/twenty-ui/input/block-editor.mdx
+++ b/packages/twenty-docs/l/ko/twenty-ui/input/block-editor.mdx
@@ -9,22 +9,28 @@ title: 블록 편집기
사용자는 [BlockNote](https://www.blocknotejs.org/)의 블록 기반 리치 텍스트 편집기를 사용해 콘텐츠 블록을 편집하고 볼 수 있습니다.
<Tabs>
- <Tab title="사용법">
- ```jsx
- import { useBlockNote } from "@blocknote/react";
- import { BlockEditor } from "@/ui/input/editor/components/BlockEditor";
-
- export const MyComponent = () => {
- const BlockNoteEditor = useBlockNote();
-
- return <BlockEditor editor={BlockNoteEditor} />;
- };
- ```
- </Tab>
-
- <Tab title="프로퍼티">
- | 프로퍼티 | 유형 | 설명 |
- | ---- | ----------------- | ----------------- |
- | 편집기 | `BlockNoteEditor` | 블록 편집기 인스턴스 또는 구성 |
- </Tab>
+<Tab title="사용법">
+
+```jsx
+import { useBlockNote } from "@blocknote/react";
+import { BlockEditor } from "@/ui/input/editor/components/BlockEditor";
+
+export const MyComponent = () => {
+ const BlockNoteEditor = useBlockNote();
+
+ return <BlockEditor editor={BlockNoteEditor} />;
+};
+```
+
+</Tab>
+<Tab title="프로퍼티">
+
+
+| 프로퍼티 | 유형 | 설명 |
+| ---- | ----------------- | ----------------- |
+| 편집기 | `BlockNoteEditor` | 블록 편집기 인스턴스 또는 구성 |
+
+
+
+</Tab>
</Tabs>
diff --git a/packages/twenty-docs/l/ko/twenty-ui/input/buttons.mdx b/packages/twenty-docs/l/ko/twenty-ui/input/buttons.mdx
index aff0737a521..b1e9e3d5295 100644
--- a/packages/twenty-docs/l/ko/twenty-ui/input/buttons.mdx
+++ b/packages/twenty-docs/l/ko/twenty-ui/input/buttons.mdx
@@ -1,5 +1,6 @@
---
title: 버튼들
+icon: 손 모양 포인터
---
<Frame>
@@ -11,428 +12,511 @@ title: 버튼들
## 버튼
<Tabs>
- <Tab title="사용법">
- ```jsx
- import { Button } from "@/ui/input/button/components/Button";
-
- export const MyComponent = () => {
- return (
- <Button
- className
- Icon={null}
- title="제목"
- fullWidth={false}
- variant="primary"
- size="medium"
- position="standalone"
- accent="default"
- soon={false}
- disabled={false}
- focus={true}
- onClick={() => console.log("click")}
- />
- );
- };
- ```
- </Tab>
-
- <Tab title="프로퍼티">
- | 프로퍼티 | 유형 | 설명 |
- | --------- | --------------------- | -------------------------------------------------------------------------------------------- |
- | 클래스 네임 | 문자열 | 추가 스타일을 위한 선택적 클래스 이름 |
- | 아이콘 | `React.ComponentType` | 버튼 내에 표시되는 선택적 아이콘 구성 요소 |
- | 제목 | 문자열 | 버튼의 텍스트 내용 |
- | fullWidth | 부울 | 버튼이 컨테이너의 전체 너비를 차지할 것인지 정의합니다 |
- | 변형 | 문자열 | 버튼의 시각적 스타일 변형. 옵션에는 `primary`, `secondary` 및 `tertiary`가 포함됩니다 |
- | 크기 | 문자열 | 버튼의 크기. 두 가지 옵션이 있습니다: `small` 및 `medium` |
- | 위치 | 문자열 | 버튼의 위치가 형제 요소와의 관계에서 어디에 존재하는지 나타냅니다. 옵션에는: `standalone`, `left`, `right`, 및 `middle`가 포함됩니다 |
- | 강조 | 문자열 | 버튼의 강조 색상. 옵션에는: `default`, `blue`, 및 `danger`가 포함됩니다 |
- | 곧 | 부울 | 버튼이 "곧 출시"로 표시되는지 여부를 나타냅니다 (예: 곧 출시할 기능) |
- | 비활성 | 부울 | 버튼이 비활성 상태인지 여부를 지정합니다 |
- | 포커스 | 부울 | 버튼에 포커스가 있는지 나타냅니다 |
- | onClick | function | 사용자가 버튼을 클릭할 때 트리거되는 콜백 함수 |
- </Tab>
+
+<Tab title="사용법">
+
+```jsx
+import { Button } from "@/ui/input/button/components/Button";
+
+export const MyComponent = () => {
+ return (
+ <Button
+ className
+ Icon={null}
+ title="제목"
+ fullWidth={false}
+ variant="primary"
+ size="medium"
+ position="standalone"
+ accent="default"
+ soon={false}
+ disabled={false}
+ focus={true}
+ onClick={() => console.log("click")}
+ />
+ );
+};
+```
+</Tab>
+
+<Tab title="프로퍼티">
+
+
+| 프로퍼티 | 유형 | 설명 |
+| --------- | --------------------- | -------------------------------------------------------------------------------------------- |
+| 클래스 네임 | 문자열 | 추가 스타일을 위한 선택적 클래스 이름 |
+| 아이콘 | `React.ComponentType` | 버튼 내에 표시되는 선택적 아이콘 구성 요소 |
+| 제목 | 문자열 | 버튼의 텍스트 내용 |
+| fullWidth | 부울 | 버튼이 컨테이너의 전체 너비를 차지할 것인지 정의합니다 |
+| 변형 | 문자열 | 버튼의 시각적 스타일 변형. 옵션에는 `primary`, `secondary` 및 `tertiary`가 포함됩니다 |
+| 크기 | 문자열 | 버튼의 크기. 두 가지 옵션이 있습니다: `small` 및 `medium` |
+| 위치 | 문자열 | 버튼의 위치가 형제 요소와의 관계에서 어디에 존재하는지 나타냅니다. 옵션에는: `standalone`, `left`, `right`, 및 `middle`가 포함됩니다 |
+| 강조 | 문자열 | 버튼의 강조 색상. 옵션에는: `default`, `blue`, 및 `danger`가 포함됩니다 |
+| 곧 | 부울 | 버튼이 "곧 출시"로 표시되는지 여부를 나타냅니다 (예: 곧 출시할 기능) |
+| 비활성 | 부울 | 버튼이 비활성 상태인지 여부를 지정합니다 |
+| 포커스 | 부울 | 버튼에 포커스가 있는지 나타냅니다 |
+| onClick | function | 사용자가 버튼을 클릭할 때 트리거되는 콜백 함수 |
+
+
+
+
+</Tab>
+
</Tabs>
## 버튼 그룹
<Tabs>
- <Tab title="사용법">
- ```jsx
- import { Button } from "@/ui/input/button/components/Button";
- import { ButtonGroup } from "@/ui/input/button/components/ButtonGroup";
-
- export const MyComponent = () => {
- return (
- <ButtonGroup variant="primary" size="large" accent="blue" className>
- <Button
- className
- Icon={null}
- title="버튼 1"
- fullWidth={false}
- variant="primary"
- size="medium"
- position="standalone"
- accent="blue"
- soon={false}
- disabled={false}
- focus={false}
- onClick={() => console.log("click")}
- />
- <Button
- className
- Icon={null}
- title="버튼 2"
- fullWidth={false}
- variant="secondary"
- size="medium"
- position="left"
- accent="blue"
- soon={false}
- disabled={false}
- focus={false}
- onClick={() => console.log("click")}
- />
- <Button
- className
- Icon={null}
- title="버튼 3"
- fullWidth={false}
- variant="tertiary"
- size="medium"
- position="right"
- accent="blue"
- soon={false}
- disabled={false}
- focus={false}
- onClick={() => console.log("click")}
- />
- </ButtonGroup>
- );
- };
-
- ```
- </Tab>
-
- <Tab title="프로퍼티">
- | 프로퍼티 | 유형 | 설명 |
- | -------- | --------- | --------------------------------------------------------------------- |
- | 변형 | 문자열 | 그룹 내 버튼의 시각적 스타일 변형. 옵션에는 `primary`, `secondary`, 및 `tertiary`가 포함됩니다 |
- | 크기 | 문자열 | 그룹 내 버튼의 크기. 두 가지 옵션이 있습니다: `medium` 및 `small` |
- | 강조 | 문자열 | 그룹 내 버튼의 강조 색상. 옵션에는 `default`, `blue` 및 `danger`가 포함됩니다 |
- | 클래스 네임 | 문자열 | 추가 스타일을 위한 선택적 클래스 이름 |
- | children | ReactNode | 그룹 내 각 버튼을 나타내는 React 요소의 배열 |
- </Tab>
+<Tab title="사용법">
+```jsx
+import { Button } from "@/ui/input/button/components/Button";
+import { ButtonGroup } from "@/ui/input/button/components/ButtonGroup";
+
+export const MyComponent = () => {
+ return (
+ <ButtonGroup variant="primary" size="large" accent="blue" className>
+ <Button
+ className
+ Icon={null}
+ title="버튼 1"
+ fullWidth={false}
+ variant="primary"
+ size="medium"
+ position="standalone"
+ accent="blue"
+ soon={false}
+ disabled={false}
+ focus={false}
+ onClick={() => console.log("click")}
+ />
+ <Button
+ className
+ Icon={null}
+ title="버튼 2"
+ fullWidth={false}
+ variant="secondary"
+ size="medium"
+ position="left"
+ accent="blue"
+ soon={false}
+ disabled={false}
+ focus={false}
+ onClick={() => console.log("click")}
+ />
+ <Button
+ className
+ Icon={null}
+ title="버튼 3"
+ fullWidth={false}
+ variant="tertiary"
+ size="medium"
+ position="right"
+ accent="blue"
+ soon={false}
+ disabled={false}
+ focus={false}
+ onClick={() => console.log("click")}
+ />
+ </ButtonGroup>
+ );
+};
+
+```
+</Tab>
+
+<Tab title="프로퍼티">
+
+
+| 프로퍼티 | 유형 | 설명 |
+| -------- | --------- | --------------------------------------------------------------------- |
+| 변형 | 문자열 | 그룹 내 버튼의 시각적 스타일 변형. 옵션에는 `primary`, `secondary`, 및 `tertiary`가 포함됩니다 |
+| 크기 | 문자열 | 그룹 내 버튼의 크기. 두 가지 옵션이 있습니다: `medium` 및 `small` |
+| 강조 | 문자열 | 그룹 내 버튼의 강조 색상. 옵션에는 `default`, `blue` 및 `danger`가 포함됩니다 |
+| 클래스 네임 | 문자열 | 추가 스타일을 위한 선택적 클래스 이름 |
+| children | ReactNode | 그룹 내 각 버튼을 나타내는 React 요소의 배열 |
+
+
+
+</Tab>
</Tabs>
## 떠 있는 버튼
<Tabs>
- <Tab title="사용법">
- ```jsx
- import { FloatingButton } from "@/ui/input/button/components/FloatingButton";
- import { IconSearch } from "@tabler/icons-react";
-
- export const MyComponent = () => {
- return (
- <FloatingButton
- className
- Icon={IconSearch}
- title="제목"
- size="medium"
- position="standalone"
- applyShadow={true}
- applyBlur={true}
- disabled={false}
- focus={true}
- />
- );
- };
- ```
- </Tab>
-
- <Tab title="프로퍼티">
- | 프로퍼티 | 유형 | 설명 |
- | ------ | --------------------- | -------------------------------------------------------------------------------------------- |
- | 클래스 네임 | 문자열 | 추가 스타일을 위한 선택적 이름 |
- | 아이콘 | `React.ComponentType` | 버튼 내에 표시되는 선택적 아이콘 구성 요소 |
- | 제목 | 문자열 | 버튼의 텍스트 내용 |
- | 크기 | 문자열 | 버튼의 크기. 두 가지 옵션이 있습니다: `small` 및 `medium` |
- | 위치 | 문자열 | 버튼의 위치가 형제 요소와의 관계에서 어디에 존재하는지 나타냅니다. 옵션에는: `standalone`, `left`, `middle`, 및 `right`가 포함됩니다 |
- | 그림자 적용 | 부울 | 버튼에 그림자를 적용할지 여부를 결정합니다 |
- | 블러 적용 | 부울 | 버튼에 블러 효과를 적용할지 여부를 결정합니다 |
- | 비활성 | 부울 | 버튼이 비활성 상태인지 여부를 결정합니다 |
- | 포커스 | 부울 | 버튼에 포커스가 있는지 나타냅니다 |
- </Tab>
+<Tab title="사용법">
+
+```jsx
+import { FloatingButton } from "@/ui/input/button/components/FloatingButton";
+import { IconSearch } from "@tabler/icons-react";
+
+export const MyComponent = () => {
+ return (
+ <FloatingButton
+ className
+ Icon={IconSearch}
+ title="제목"
+ size="medium"
+ position="standalone"
+ applyShadow={true}
+ applyBlur={true}
+ disabled={false}
+ focus={true}
+ />
+ );
+};
+```
+
+</Tab>
+
+<Tab title="프로퍼티">
+
+
+| 프로퍼티 | 유형 | 설명 |
+| ------ | --------------------- | -------------------------------------------------------------------------------------------- |
+| 클래스 네임 | 문자열 | 추가 스타일을 위한 선택적 이름 |
+| 아이콘 | `React.ComponentType` | 버튼 내에 표시되는 선택적 아이콘 구성 요소 |
+| 제목 | 문자열 | 버튼의 텍스트 내용 |
+| 크기 | 문자열 | 버튼의 크기. 두 가지 옵션이 있습니다: `small` 및 `medium` |
+| 위치 | 문자열 | 버튼의 위치가 형제 요소와의 관계에서 어디에 존재하는지 나타냅니다. 옵션에는: `standalone`, `left`, `middle`, 및 `right`가 포함됩니다 |
+| 그림자 적용 | 부울 | 버튼에 그림자를 적용할지 여부를 결정합니다 |
+| 블러 적용 | 부울 | 버튼에 블러 효과를 적용할지 여부를 결정합니다 |
+| 비활성 | 부울 | 버튼이 비활성 상태인지 여부를 결정합니다 |
+| 포커스 | 부울 | 버튼에 포커스가 있는지 나타냅니다 |
+
+
+
+</Tab>
</Tabs>
## 떠 있는 버튼 그룹
<Tabs>
- <Tab title="사용법">
- ```jsx
- import { FloatingButton } from "@/ui/input/button/components/FloatingButton";
- import { FloatingButtonGroup } from "@/ui/input/button/components/FloatingButtonGroup";
- import { IconClipboardText, IconCheckbox } from "@tabler/icons-react";
-
- export const MyComponent = () => {
- return (
- <FloatingButtonGroup size="small">
- <FloatingButton
- className
- Icon={IconClipboardText}
- title
- size="small"
- position="standalone"
- applyShadow={true}
- applyBlur={true}
- disabled={false}
- focus={true}
- />
- <FloatingButton
- className
- Icon={IconCheckbox}
- title
- size="small"
- position="standalone"
- applyShadow={true}
- applyBlur={true}
- disabled={false}
- />
- </FloatingButtonGroup>
- );
- };
- ```
- </Tab>
-
- <Tab title="프로퍼티">
- | 프로퍼티 | 유형 | 설명 | 기본값 |
- | -------- | --------- | ----------------------------------------- | --- |
- | 크기 | 문자열 | 버튼의 크기. 두 가지 옵션이 있습니다: `small` 및 `medium` | 작은 |
- | children | ReactNode | 그룹 내 각 버튼을 나타내는 React 요소의 배열 | |
- </Tab>
+<Tab title="사용법">
+
+```jsx
+import { FloatingButton } from "@/ui/input/button/components/FloatingButton";
+import { FloatingButtonGroup } from "@/ui/input/button/components/FloatingButtonGroup";
+import { IconClipboardText, IconCheckbox } from "@tabler/icons-react";
+
+export const MyComponent = () => {
+ return (
+ <FloatingButtonGroup size="small">
+ <FloatingButton
+ className
+ Icon={IconClipboardText}
+ title
+ size="small"
+ position="standalone"
+ applyShadow={true}
+ applyBlur={true}
+ disabled={false}
+ focus={true}
+ />
+ <FloatingButton
+ className
+ Icon={IconCheckbox}
+ title
+ size="small"
+ position="standalone"
+ applyShadow={true}
+ applyBlur={true}
+ disabled={false}
+ />
+ </FloatingButtonGroup>
+ );
+};
+```
+
+</Tab>
+
+<Tab title="프로퍼티">
+
+
+| 프로퍼티 | 유형 | 설명 | 기본값 |
+| -------- | --------- | ----------------------------------------- | --- |
+| 크기 | 문자열 | 버튼의 크기. 두 가지 옵션이 있습니다: `small` 및 `medium` | 작은 |
+| children | ReactNode | 그룹 내 각 버튼을 나타내는 React 요소의 배열 | |
+
+
+
+</Tab>
+
</Tabs>
## 떠 있는 아이콘 버튼
<Tabs>
- <Tab title="사용법">
- ```jsx
- import { FloatingIconButton } from "@/ui/input/button/components/FloatingIconButton";
- import { IconSearch } from "@tabler/icons-react";
-
- export const MyComponent = () => {
- return (
- <FloatingIconButton
- className
- Icon={IconSearch}
- size="small"
- position="standalone"
- applyShadow={true}
- applyBlur={true}
- disabled={false}
- focus={false}
- onClick={() => console.log("click")}
- isActive={true}
- />
- );
- };
- ```
- </Tab>
-
- <Tab title="프로퍼티">
- | 프로퍼티 | 유형 | 설명 |
- | ---------- | --------------------- | -------------------------------------------------------------------------------------------- |
- | 클래스 네임 | 문자열 | 추가 스타일을 위한 선택적 이름 |
- | 아이콘 | `React.ComponentType` | 버튼 내에 표시되는 선택적 아이콘 구성 요소 |
- | 크기 | 문자열 | 버튼의 크기. 두 가지 옵션이 있습니다: `small` 및 `medium` |
- | 위치 | 문자열 | 버튼의 위치가 형제 요소와의 관계에서 어디에 존재하는지 나타냅니다. 옵션에는: `standalone`, `left`, `right`, 및 `middle`가 포함됩니다 |
- | 그림자 적용 | 부울 | 버튼에 그림자를 적용할지 여부를 결정합니다 |
- | 블러 적용 | 부울 | 버튼에 블러 효과를 적용할지 여부를 결정합니다 |
- | 비활성 | 부울 | 버튼이 비활성 상태인지 여부를 결정합니다 |
- | 포커스 | 부울 | 버튼에 포커스가 있는지 나타냅니다 |
- | onClick | function | 사용자가 버튼을 클릭할 때 트리거되는 콜백 함수 |
- | 활성 상태인지 여부 | 부울 | 버튼이 활성 상태인지 여부를 결정합니다 |
- </Tab>
+<Tab title="사용법">
+
+```jsx
+import { FloatingIconButton } from "@/ui/input/button/components/FloatingIconButton";
+import { IconSearch } from "@tabler/icons-react";
+
+export const MyComponent = () => {
+ return (
+ <FloatingIconButton
+ className
+ Icon={IconSearch}
+ size="small"
+ position="standalone"
+ applyShadow={true}
+ applyBlur={true}
+ disabled={false}
+ focus={false}
+ onClick={() => console.log("click")}
+ isActive={true}
+ />
+ );
+};
+```
+
+</Tab>
+
+<Tab title="프로퍼티">
+
+
+| 프로퍼티 | 유형 | 설명 |
+| ---------- | --------------------- | -------------------------------------------------------------------------------------------- |
+| 클래스 네임 | 문자열 | 추가 스타일을 위한 선택적 이름 |
+| 아이콘 | `React.ComponentType` | 버튼 내에 표시되는 선택적 아이콘 구성 요소 |
+| 크기 | 문자열 | 버튼의 크기. 두 가지 옵션이 있습니다: `small` 및 `medium` |
+| 위치 | 문자열 | 버튼의 위치가 형제 요소와의 관계에서 어디에 존재하는지 나타냅니다. 옵션에는: `standalone`, `left`, `right`, 및 `middle`가 포함됩니다 |
+| 그림자 적용 | 부울 | 버튼에 그림자를 적용할지 여부를 결정합니다 |
+| 블러 적용 | 부울 | 버튼에 블러 효과를 적용할지 여부를 결정합니다 |
+| 비활성 | 부울 | 버튼이 비활성 상태인지 여부를 결정합니다 |
+| 포커스 | 부울 | 버튼에 포커스가 있는지 나타냅니다 |
+| onClick | function | 사용자가 버튼을 클릭할 때 트리거되는 콜백 함수 |
+| 활성 상태인지 여부 | 부울 | 버튼이 활성 상태인지 여부를 결정합니다 |
+
+
+
+</Tab>
+
</Tabs>
## 떠 있는 아이콘 버튼 그룹
<Tabs>
- <Tab title="사용법">
- ```jsx
- import { FloatingIconButtonGroup } from "@/ui/input/button/components/FloatingIconButtonGroup";
- import { IconClipboardText, IconCheckbox } from "@tabler/icons-react";
-
- export const MyComponent = () => {
- const iconButtons = [
- {
- Icon: IconClipboardText,
- onClick: () => console.log("Button 1 clicked"),
- isActive: true,
- },
- {
- Icon: IconCheckbox,
- onClick: () => console.log("Button 2 clicked"),
- isActive: true,
- },
- ];
-
- return (
- <FloatingIconButtonGroup
- className
- size="small"
- iconButtons={iconButtons} />
- );
- };
-
- ```
- </Tab>
-
- <Tab title="프로퍼티">
- | 프로퍼티 | 유형 | 설명 |
- | ------ | --- | --------------------------------------------------------------------------------------------------------- |
- | 클래스 네임 | 문자열 | 추가 스타일을 위한 선택적 이름 |
- | 크기 | 문자열 | 버튼의 크기. 두 가지 옵션이 있습니다: `small` 및 `medium` |
- | 아이콘 버튼 | 배열 | 그룹 내 각 아이콘 버튼을 나타내는 객체의 배열. 각 객체에는 버튼에 표시할 아이콘 컴포넌트, 사용자가 버튼을 클릭할 때 호출할 함수, 그리고 버튼이 활성 상태인지 여부를 포함해야 합니다. |
- </Tab>
+<Tab title="사용법">
+
+```jsx
+import { FloatingIconButtonGroup } from "@/ui/input/button/components/FloatingIconButtonGroup";
+import { IconClipboardText, IconCheckbox } from "@tabler/icons-react";
+
+export const MyComponent = () => {
+ const iconButtons = [
+ {
+ Icon: IconClipboardText,
+ onClick: () => console.log("Button 1 clicked"),
+ isActive: true,
+ },
+ {
+ Icon: IconCheckbox,
+ onClick: () => console.log("Button 2 clicked"),
+ isActive: true,
+ },
+ ];
+
+ return (
+ <FloatingIconButtonGroup
+ className
+ size="small"
+ iconButtons={iconButtons} />
+ );
+};
+
+```
+
+</Tab>
+
+<Tab title="프로퍼티">
+
+
+| 프로퍼티 | 유형 | 설명 |
+| ------ | --- | --------------------------------------------------------------------------------------------------------- |
+| 클래스 네임 | 문자열 | 추가 스타일을 위한 선택적 이름 |
+| 크기 | 문자열 | 버튼의 크기. 두 가지 옵션이 있습니다: `small` 및 `medium` |
+| 아이콘 버튼 | 배열 | 그룹 내 각 아이콘 버튼을 나타내는 객체의 배열. 각 객체에는 버튼에 표시할 아이콘 컴포넌트, 사용자가 버튼을 클릭할 때 호출할 함수, 그리고 버튼이 활성 상태인지 여부를 포함해야 합니다. |
+
+
+
+</Tab>
+
</Tabs>
## 라이트 버튼
<Tabs>
- <Tab title="사용법">
- ```jsx
- import { LightButton } from "@/ui/input/button/components/LightButton";
+<Tab title="사용법">
+
+```jsx
+import { LightButton } from "@/ui/input/button/components/LightButton";
+
+export const MyComponent = () => {
+ return <LightButton
+ className
+ icon={null}
+ title="제목"
+ accent="secondary"
+ active={false}
+ disabled={false}
+ focus={true}
+ onClick={()=>console.log('click')}
+ />;
+};
+```
+
+
+</Tab>
+
+<Tab title="프로퍼티">
+
- export const MyComponent = () => {
- return <LightButton
+| 프로퍼티 | 유형 | 설명 |
+| ------- | ----------------- | ------------------------------------------------ |
+| 클래스 네임 | 문자열 | 추가 스타일을 위한 선택적 이름 |
+| 아이콘 | `React.ReactNode` | 버튼에 표시할 아이콘 |
+| 제목 | 문자열 | 버튼의 텍스트 내용 |
+| 강조 | 문자열 | 버튼의 강조 색상. 옵션에는: `secondary` 및 `tertiary`가 포함됩니다 |
+| 활성 | 부울 | 버튼이 활성 상태인지 여부를 결정합니다 |
+| 비활성 | 부울 | 버튼이 비활성 상태인지 여부를 결정합니다 |
+| 포커스 | 부울 | 버튼에 포커스가 있는지 나타냅니다 |
+| onClick | 기능 | 사용자가 버튼을 클릭할 때 트리거되는 콜백 함수 |
+
+
+
+
+</Tab>
+
+</Tabs>
+
+## 라이트 아이콘 버튼
+
+<Tabs>
+<Tab title="사용법">
+
+```jsx
+import { LightIconButton } from "@/ui/input/button/components/LightIconButton";
+import { IconSearch } from "@tabler/icons-react";
+
+export const MyComponent = () => {
+ return (
+ <LightIconButton
className
- icon={null}
+ testId="test1"
+ Icon={IconSearch}
title="제목"
+ size="small"
accent="secondary"
- active={false}
+ active={true}
disabled={false}
focus={true}
- onClick={()=>console.log('click')}
- />;
- };
- ```
- </Tab>
-
- <Tab title="프로퍼티">
- | 프로퍼티 | 유형 | 설명 |
- | ------- | ----------------- | ------------------------------------------------ |
- | 클래스 네임 | 문자열 | 추가 스타일을 위한 선택적 이름 |
- | 아이콘 | `React.ReactNode` | 버튼에 표시할 아이콘 |
- | 제목 | 문자열 | 버튼의 텍스트 내용 |
- | 강조 | 문자열 | 버튼의 강조 색상. 옵션에는: `secondary` 및 `tertiary`가 포함됩니다 |
- | 활성 | 부울 | 버튼이 활성 상태인지 여부를 결정합니다 |
- | 비활성 | 부울 | 버튼이 비활성 상태인지 여부를 결정합니다 |
- | 포커스 | 부울 | 버튼에 포커스가 있는지 나타냅니다 |
- | onClick | 기능 | 사용자가 버튼을 클릭할 때 트리거되는 콜백 함수 |
- </Tab>
-</Tabs>
+ onClick={() => console.log("click")}
+ />
+ );
+};
+```
-## 라이트 아이콘 버튼
-<Tabs>
- <Tab title="사용법">
- ```jsx
- import { LightIconButton } from "@/ui/input/button/components/LightIconButton";
- import { IconSearch } from "@tabler/icons-react";
-
- export const MyComponent = () => {
- return (
- <LightIconButton
- className
- testId="test1"
- Icon={IconSearch}
- title="제목"
- size="small"
- accent="secondary"
- active={true}
- disabled={false}
- focus={true}
- onClick={() => console.log("click")}
- />
- );
- };
- ```
- </Tab>
-
- <Tab title="프로퍼티">
- | 프로퍼티 | 유형 | 설명 |
- | ------- | --------------------- | ------------------------------------------------ |
- | 클래스 네임 | 문자열 | 추가 스타일을 위한 선택적 이름 |
- | 테스트ID | 문자열 | 버튼의 테스트 식별자 |
- | 아이콘 | `React.ComponentType` | 버튼 내에 표시되는 선택적 아이콘 구성 요소 |
- | 제목 | 문자열 | 버튼의 텍스트 내용 |
- | 크기 | 문자열 | 버튼의 크기. 두 가지 옵션이 있습니다: `small` 및 `medium` |
- | 강조 | 문자열 | 버튼의 강조 색상. 옵션에는: `secondary` 및 `tertiary`가 포함됩니다 |
- | 활성 | 부울 | 버튼이 활성 상태인지 여부를 결정합니다 |
- | 비활성 | 부울 | 버튼이 비활성 상태인지 여부를 결정합니다 |
- | 포커스 | 부울 | 버튼에 포커스가 있는지 나타냅니다 |
- | onClick | 기능 | 사용자가 버튼을 클릭할 때 트리거되는 콜백 함수 |
- </Tab>
+</Tab>
+
+<Tab title="프로퍼티">
+
+
+| 프로퍼티 | 유형 | 설명 |
+| ------- | --------------------- | ------------------------------------------------ |
+| 클래스 네임 | 문자열 | 추가 스타일을 위한 선택적 이름 |
+| 테스트ID | 문자열 | 버튼의 테스트 식별자 |
+| 아이콘 | `React.ComponentType` | 버튼 내에 표시되는 선택적 아이콘 구성 요소 |
+| 제목 | 문자열 | 버튼의 텍스트 내용 |
+| 크기 | 문자열 | 버튼의 크기. 두 가지 옵션이 있습니다: `small` 및 `medium` |
+| 강조 | 문자열 | 버튼의 강조 색상. 옵션에는: `secondary` 및 `tertiary`가 포함됩니다 |
+| 활성 | 부울 | 버튼이 활성 상태인지 여부를 결정합니다 |
+| 비활성 | 부울 | 버튼이 비활성 상태인지 여부를 결정합니다 |
+| 포커스 | 부울 | 버튼에 포커스가 있는지 나타냅니다 |
+| onClick | 기능 | 사용자가 버튼을 클릭할 때 트리거되는 콜백 함수 |
+
+
+
+</Tab>
+
</Tabs>
## 메인 버튼
<Tabs>
- <Tab title="사용법">
- ```jsx
- import { MainButton } from "@/ui/input/button/components/MainButton";
- import { IconCheckbox } from "@tabler/icons-react";
-
- export const MyComponent = () => {
- return (
- <MainButton
- title="체크박스"
- fullWidth={false}
- variant="primary"
- soon={false}
- Icon={IconCheckbox}
- />
- );
- };
- ```
- </Tab>
-
- <Tab title="프로퍼티">
- | 프로퍼티 | 유형 | 설명 |
- | ----------------- | -------------------------------- | --------------------------------------------------- |
- | 제목 | 문자열 | 버튼의 텍스트 내용 |
- | 전체 폭 | 부울 | 버튼이 컨테이너의 전체 너비를 차지할 것인지 정의합니다 |
- | 변형 | 문자열 | 버튼의 시각적 스타일 변형. 옵션에는 `primary` 및 `secondary`가 포함됩니다 |
- | 곧 | 부울 | 버튼이 "곧 출시"로 표시되는지 여부를 나타냅니다 (예: 곧 출시할 기능) |
- | 아이콘 | `React.ComponentType` | 버튼 내에 표시되는 선택적 아이콘 구성 요소 |
- | React `button` 속성 | `React.ComponentProps<'button'>` | 모든 표준 HTML 버튼 속성을 지원합니다 |
- </Tab>
+<Tab title="사용법">
+
+```jsx
+import { MainButton } from "@/ui/input/button/components/MainButton";
+import { IconCheckbox } from "@tabler/icons-react";
+
+export const MyComponent = () => {
+ return (
+ <MainButton
+ title="체크박스"
+ fullWidth={false}
+ variant="primary"
+ soon={false}
+ Icon={IconCheckbox}
+ />
+ );
+};
+```
+
+
+</Tab>
+
+<Tab title="프로퍼티">
+
+
+| 프로퍼티 | 유형 | 설명 |
+| ----------------- | -------------------------------- | --------------------------------------------------- |
+| 제목 | 문자열 | 버튼의 텍스트 내용 |
+| 전체 폭 | 부울 | 버튼이 컨테이너의 전체 너비를 차지할 것인지 정의합니다 |
+| 변형 | 문자열 | 버튼의 시각적 스타일 변형. 옵션에는 `primary` 및 `secondary`가 포함됩니다 |
+| 곧 | 부울 | 버튼이 "곧 출시"로 표시되는지 여부를 나타냅니다 (예: 곧 출시할 기능) |
+| 아이콘 | `React.ComponentType` | 버튼 내에 표시되는 선택적 아이콘 구성 요소 |
+| React `button` 속성 | `React.ComponentProps<'button'>` | 모든 표준 HTML 버튼 속성을 지원합니다 |
+
+
+
+
+</Tab>
+
</Tabs>
## 둥근 아이콘 버튼
<Tabs>
- <Tab title="사용법">
- ```jsx
- import { RoundedIconButton } from "@/ui/input/button/components/RoundedIconButton";
- import { IconSearch } from "@tabler/icons-react";
-
- export const MyComponent = () => {
- return (
- <RoundedIconButton
- Icon={IconSearch}
- />
- );
- };
- ```
- </Tab>
-
- <Tab title="프로퍼티">
- | 프로퍼티 | 유형 | 설명 |
- | ----------------- | ----------------------------------------------- | -- |
- | 아이콘 | `React.ComponentType` | |
- | React `button` 속성 | `React.ButtonHTMLAttributes<HTMLButtonElement>` | |
- </Tab>
+<Tab title="사용법">
+
+```jsx
+import { RoundedIconButton } from "@/ui/input/button/components/RoundedIconButton";
+import { IconSearch } from "@tabler/icons-react";
+
+export const MyComponent = () => {
+ return (
+ <RoundedIconButton
+ Icon={IconSearch}
+ />
+ );
+};
+```
+
+
+</Tab>
+
+<Tab title="프로퍼티">
+
+
+| 프로퍼티 | 유형 | 설명 |
+| ----------------- | ----------------------------------------------- | -- |
+| 아이콘 | `React.ComponentType` | |
+| React `button` 속성 | `React.ButtonHTMLAttributes<HTMLButtonElement>` | |
+
+
+
+</Tab>
+
</Tabs>
diff --git a/packages/twenty-docs/l/ko/twenty-ui/input/checkbox.mdx b/packages/twenty-docs/l/ko/twenty-ui/input/checkbox.mdx
index 27178f64985..5be3c09ac63 100644
--- a/packages/twenty-docs/l/ko/twenty-ui/input/checkbox.mdx
+++ b/packages/twenty-docs/l/ko/twenty-ui/input/checkbox.mdx
@@ -1,5 +1,6 @@
---
title: 체크박스
+icon: square-check
---
<Frame>
@@ -9,35 +10,41 @@ title: 체크박스
사용자가 여러 옵션 중 여러 값을 선택해야 할 때 사용됩니다.
<Tabs>
- <Tab title="사용법">
- ```jsx
- import { Checkbox } from "twenty-ui/display";
-
- export const MyComponent = () => {
- return (
- <Checkbox
- checked={true}
- indeterminate={false}
- onChange={() => console.log("onChange function fired")}
- onCheckedChange={() => console.log("onCheckedChange function fired")}
- variant="primary"
- size="small"
- shape="squared"
- />
- );
- };
- ```
- </Tab>
-
- <Tab title="프로퍼티">
- | 프로퍼티 | 유형 | 설명 |
- | --------------- | --- | ----------------------------------------------------------------- |
- | 체크됨 | 부울 | 체크박스가 체크된 상태인지 나타냅니다 |
- | 불확정 | 부울 | 체크박스가 불확정 상태(체크되지 않음과 체크됨의 중간)에 있는지 나타냅니다 |
- | onChange | 함수 | 체크박스 상태가 변경될 때 호출할 콜백 함수입니다. |
- | onCheckedChange | 함수 | `checked` 상태가 변경될 때 호출할 콜백 함수입니다. |
- | 변형 | 문자열 | 박스의 시각적 스타일 변형입니다. 옵션에는 `primary`, `secondary`, `tertiary`가 포함됩니다 |
- | 크기 | 문자열 | 체크박스의 크기입니다. 두 가지 옵션이 있습니다: `small`과 `large` |
- | 모양 | 문자열 | 체크박스의 모양입니다. 두 가지 옵션이 있습니다: `squared`와 `rounded` |
- </Tab>
+<Tab title="사용법">
+
+```jsx
+import { Checkbox } from "twenty-ui/display";
+
+export const MyComponent = () => {
+ return (
+ <Checkbox
+ checked={true}
+ indeterminate={false}
+ onChange={() => console.log("onChange function fired")}
+ onCheckedChange={() => console.log("onCheckedChange function fired")}
+ variant="primary"
+ size="small"
+ shape="squared"
+ />
+ );
+};
+```
+
+</Tab>
+<Tab title="프로퍼티">
+
+
+| 프로퍼티 | 유형 | 설명 |
+| --------------- | --- | ----------------------------------------------------------------- |
+| 체크됨 | 부울 | 체크박스가 체크된 상태인지 나타냅니다 |
+| 불확정 | 부울 | 체크박스가 불확정 상태(체크되지 않음과 체크됨의 중간)에 있는지 나타냅니다 |
+| onChange | 함수 | 체크박스 상태가 변경될 때 호출할 콜백 함수입니다. |
+| onCheckedChange | 함수 | `checked` 상태가 변경될 때 호출할 콜백 함수입니다. |
+| 변형 | 문자열 | 박스의 시각적 스타일 변형입니다. 옵션에는 `primary`, `secondary`, `tertiary`가 포함됩니다 |
+| 크기 | 문자열 | 체크박스의 크기입니다. 두 가지 옵션이 있습니다: `small`과 `large` |
+| 모양 | 문자열 | 체크박스의 모양입니다. 두 가지 옵션이 있습니다: `squared`와 `rounded` |
+
+
+
+</Tab>
</Tabs>
diff --git a/packages/twenty-docs/l/ko/twenty-ui/input/color-scheme.mdx b/packages/twenty-docs/l/ko/twenty-ui/input/color-scheme.mdx
index 17552b390e6..0c11a6f6251 100644
--- a/packages/twenty-docs/l/ko/twenty-ui/input/color-scheme.mdx
+++ b/packages/twenty-docs/l/ko/twenty-ui/input/color-scheme.mdx
@@ -1,5 +1,6 @@
---
title: 색 구성표
+icon: 팔레트
---
<Frame>
@@ -11,28 +12,36 @@ title: 색 구성표
다양한 색상 구성표를 나타내며, 밝은 테마와 어두운 테마를 위해 특별히 설계되었습니다.
<Tabs>
- <Tab title="사용법">
- ```jsx
- import { ColorSchemeCard } from "twenty-ui/display";
-
- export const MyComponent = () => {
- return (
- <ColorSchemeCard
- variant="Dark"
- selected={true}
- />
- );
- };
- ```
- </Tab>
-
- <Tab title="프로퍼티">
- | 프로퍼티 | 유형 | 설명 | 기본값 |
- | ----- | --------------------------------------- | --------------------------------------------------- | --- |
- | 변형 | 문자열 | 색상 구성표 변형. 옵션에는 `Dark`, `Light`, 및 `System`이 포함됩니다. | 라이트 |
- | 선택됨 | 부울 | `true`이면 선택한 색상 구성표를 나타내는 체크 표시가 나타납니다. | |
- | 추가 속성 | `React.ComponentPropsWithoutRef<'div'>` | 기본 HTML `div` 요소 속성 | |
- </Tab>
+<Tab title="사용법">
+
+```jsx
+import { ColorSchemeCard } from "twenty-ui/display";
+
+export const MyComponent = () => {
+ return (
+ <ColorSchemeCard
+ variant="Dark"
+ selected={true}
+ />
+ );
+};
+```
+
+</Tab>
+
+<Tab title="프로퍼티">
+
+
+| 프로퍼티 | 유형 | 설명 | 기본값 |
+| ----- | --------------------------------------- | --------------------------------------------------- | --- |
+| 변형 | 문자열 | 색상 구성표 변형. 옵션에는 `Dark`, `Light`, 및 `System`이 포함됩니다. | 라이트 |
+| 선택됨 | 부울 | `true`이면 선택한 색상 구성표를 나타내는 체크 표시가 나타납니다. | |
+| 추가 속성 | `React.ComponentPropsWithoutRef<'div'>` | 기본 HTML `div` 요소 속성 | |
+
+
+
+</Tab>
+
</Tabs>
## 색상 구성표 선택기
@@ -40,23 +49,31 @@ title: 색 구성표
사용자가 다양한 색상 구성표를 선택할 수 있도록 합니다.
<Tabs>
- <Tab title="사용법">
- ```jsx
- import { ColorSchemePicker } from "twenty-ui/display";
-
- export const MyComponent = () => {
- return <ColorSchemePicker
- value="Dark"
- onChange
- />;
- };
- ```
- </Tab>
-
- <Tab title="프로퍼티">
- | 프로퍼티 | 유형 | 설명 |
- | -------- | ------- | ----------------------------- |
- | 값 | `색 구성표` | 현재 선택된 색상 구성표 |
- | onChange | 함수 | 사용자가 색상 구성표를 선택할 때 트리거할 콜백 함수 |
- </Tab>
+<Tab title="사용법">
+
+```jsx
+import { ColorSchemePicker } from "twenty-ui/display";
+
+export const MyComponent = () => {
+ return <ColorSchemePicker
+ value="Dark"
+ onChange
+ />;
+};
+```
+
+</Tab>
+
+<Tab title="프로퍼티">
+
+
+| 프로퍼티 | 유형 | 설명 |
+| -------- | ------- | ----------------------------- |
+| 값 | `색 구성표` | 현재 선택된 색상 구성표 |
+| onChange | 함수 | 사용자가 색상 구성표를 선택할 때 트리거할 콜백 함수 |
+
+
+
+</Tab>
+
</Tabs>
diff --git a/packages/twenty-docs/l/ko/twenty-ui/input/icon-picker.mdx b/packages/twenty-docs/l/ko/twenty-ui/input/icon-picker.mdx
index cb1ca6c3764..3c238bf0564 100644
--- a/packages/twenty-docs/l/ko/twenty-ui/input/icon-picker.mdx
+++ b/packages/twenty-docs/l/ko/twenty-ui/input/icon-picker.mdx
@@ -9,40 +9,49 @@ title: 아이콘 선택기
드롭다운 기반의 아이콘 선택기로 사용자가 목록에서 아이콘을 선택할 수 있습니다.
<Tabs>
- <Tab title="사용법">
- ```jsx
- import React, { useState } from "react";
- import { IconPicker } from "@/ui/input/components/IconPicker";
-
- export const MyComponent = () => {
-
- const [selectedIcon, setSelectedIcon] = useState("");
- const handleIconChange = ({ iconKey, Icon }) => {
- console.log("Selected Icon:", iconKey);
- setSelectedIcon(iconKey);
- };
-
- return (
- <IconPicker
- disabled={false}
- onChange={handleIconChange}
- selectedIconKey={selectedIcon}
- variant="primary"
- />
- );
- };
- ```
- </Tab>
-
- <Tab title="프로퍼티">
- | 프로퍼티 | 유형 | 설명 |
- | -------------- | --- | -------------------------------------------------------------------------- |
- | 비활성화됨 | 부울 | `true`로 설정하면 아이콘 선택기가 비활성화됩니다. |
- | onChange | 함수 | 사용자가 아이콘을 선택할 때 호출되는 콜백 함수입니다. `iconKey`와 `Icon` 속성을 포함한 객체를 수신합니다. |
- | 선택된 아이콘 키 | 문자열 | 처음 선택된 아이콘의 키입니다. |
- | onClickOutside | 함수 | 사용자가 드롭다운 외부를 클릭했을 때 호출되는 콜백 함수입니다. |
- | onClose | 함수 | 드롭다운이 닫힐 때 호출되는 콜백 함수입니다. |
- | onOpen | 함수 | 드롭다운이 열릴 때 호출되는 콜백 함수입니다. |
- | 변형 | 문자열 | 클릭 가능한 아이콘의 시각적 스타일 변형입니다. 옵션에는 `primary`, `secondary`, `tertiary`가 포함됩니다. |
- </Tab>
+
+<Tab title="사용법">
+
+```jsx
+import React, { useState } from "react";
+import { IconPicker } from "@/ui/input/components/IconPicker";
+
+export const MyComponent = () => {
+
+ const [selectedIcon, setSelectedIcon] = useState("");
+ const handleIconChange = ({ iconKey, Icon }) => {
+ console.log("Selected Icon:", iconKey);
+ setSelectedIcon(iconKey);
+ };
+
+ return (
+ <IconPicker
+ disabled={false}
+ onChange={handleIconChange}
+ selectedIconKey={selectedIcon}
+ variant="primary"
+ />
+ );
+};
+```
+
+
+</Tab>
+<Tab title="프로퍼티">
+
+
+| 프로퍼티 | 유형 | 설명 |
+| -------------- | --- | -------------------------------------------------------------------------- |
+| 비활성화됨 | 부울 | `true`로 설정하면 아이콘 선택기가 비활성화됩니다. |
+| onChange | 함수 | 사용자가 아이콘을 선택할 때 호출되는 콜백 함수입니다. `iconKey`와 `Icon` 속성을 포함한 객체를 수신합니다. |
+| 선택된 아이콘 키 | 문자열 | 처음 선택된 아이콘의 키입니다. |
+| onClickOutside | 함수 | 사용자가 드롭다운 외부를 클릭했을 때 호출되는 콜백 함수입니다. |
+| onClose | 함수 | 드롭다운이 닫힐 때 호출되는 콜백 함수입니다. |
+| onOpen | 함수 | 드롭다운이 열릴 때 호출되는 콜백 함수입니다. |
+| 변형 | 문자열 | 클릭 가능한 아이콘의 시각적 스타일 변형입니다. 옵션에는 `primary`, `secondary`, `tertiary`가 포함됩니다. |
+
+
+
+
+</Tab>
</Tabs>
diff --git a/packages/twenty-docs/l/ko/twenty-ui/input/image-input.mdx b/packages/twenty-docs/l/ko/twenty-ui/input/image-input.mdx
index 35086304dac..f6e39100016 100644
--- a/packages/twenty-docs/l/ko/twenty-ui/input/image-input.mdx
+++ b/packages/twenty-docs/l/ko/twenty-ui/input/image-input.mdx
@@ -9,25 +9,32 @@ title: 이미지 입력
사용자가 이미지를 업로드하고 제거할 수 있도록 합니다.
<Tabs>
- <Tab title="사용법">
- ```jsx
- import { ImageInput } from "@/ui/input/components/ImageInput";
-
- export const MyComponent = () => {
- return <ImageInput/>;
- };
- ```
- </Tab>
-
- <Tab title="프로퍼티">
- | 프로퍼티 | 유형 | 설명 |
- | ------------ | --- | ----------------------------------------------------- |
- | 사진 | 문자열 | 이미지 소스 URL |
- | onUpload | 함수 | 사용자가 새 이미지를 업로드할 때 호출되는 함수입니다. `File` 객체를 매개변수로 받습니다. |
- | onRemove | 함수 | 사용자가 제거 버튼을 클릭할 때 호출되는 함수입니다. |
- | onAbort | 함수 | 사용자가 이미지 업로드 중 중단 버튼을 클릭할 때 호출되는 함수입니다. |
- | isUploading | 부울 | 이미지가 현재 업로드 중인지 여부를 나타냅니다. |
- | errorMessage | 문자열 | 이미지 입력 아래에 표시할 선택적 오류 메시지입니다. |
- | disabled | 부울 | `true`인 경우 전체 입력이 비활성화되고 버튼을 클릭할 수 없습니다. |
- </Tab>
+<Tab title="사용법">
+
+```jsx
+import { ImageInput } from "@/ui/input/components/ImageInput";
+
+export const MyComponent = () => {
+ return <ImageInput/>;
+};
+```
+
+</Tab>
+<Tab title="프로퍼티">
+
+
+| 프로퍼티 | 유형 | 설명 |
+| ------------ | --- | ----------------------------------------------------- |
+| 사진 | 문자열 | 이미지 소스 URL |
+| onUpload | 함수 | 사용자가 새 이미지를 업로드할 때 호출되는 함수입니다. `File` 객체를 매개변수로 받습니다. |
+| onRemove | 함수 | 사용자가 제거 버튼을 클릭할 때 호출되는 함수입니다. |
+| onAbort | 함수 | 사용자가 이미지 업로드 중 중단 버튼을 클릭할 때 호출되는 함수입니다. |
+| isUploading | 부울 | 이미지가 현재 업로드 중인지 여부를 나타냅니다. |
+| errorMessage | 문자열 | 이미지 입력 아래에 표시할 선택적 오류 메시지입니다. |
+| disabled | 부울 | `true`인 경우 전체 입력이 비활성화되고 버튼을 클릭할 수 없습니다. |
+
+
+
+
+</Tab>
</Tabs>
diff --git a/packages/twenty-docs/l/ko/twenty-ui/input/radio.mdx b/packages/twenty-docs/l/ko/twenty-ui/input/radio.mdx
index 38224032998..199a1a83bef 100644
--- a/packages/twenty-docs/l/ko/twenty-ui/input/radio.mdx
+++ b/packages/twenty-docs/l/ko/twenty-ui/input/radio.mdx
@@ -1,5 +1,6 @@
---
title: 라디오
+icon: circle-dot
---
<Frame>
@@ -9,50 +10,58 @@ title: 라디오
사용자가 여러 옵션 중에서 하나만 선택할 수 있을 때 사용됩니다.
<Tabs>
- <Tab title="사용법">
- ```jsx
- import { Radio } from "twenty-ui/display";
-
- export const MyComponent = () => {
-
- const handleRadioChange = (event) => {
- console.log("Radio button changed:", event.target.checked);
- };
-
- const handleCheckedChange = (checked) => {
- console.log("Checked state changed:", checked);
- };
-
-
- return (
- <Radio
- checked={true}
- value="Option 1"
- onChange={handleRadioChange}
- onCheckedChange={handleCheckedChange}
- size="large"
- disabled={false}
- labelPosition="right"
- />
- );
- };
-
- ```
- </Tab>
-
- <Tab title="프로퍼티">
- | 프로퍼티 | 유형 | 설명 |
- | --------------- | -------------- | ----------------------------------------------------- |
- | 스타일 | `React.CSS` 속성 | 컴포넌트의 추가 인라인 스타일 |
- | 클래스 네임 | 문자열 | 추가 스타일링을 위한 선택적 CSS 클래스 |
- | 체크됨 | 부울 | 라디오 버튼이 체크되었는지 여부를 나타냅니다 |
- | 값 | 문자열 | 라디오 버튼과 연결된 라벨 또는 텍스트 |
- | onChange | 함수 | 선택된 라디오 버튼이 변경될 때 호출되는 기능 |
- | onCheckedChange | 함수 | 라디오 버튼의 `체크` 상태가 변경될 때 호출되는 기능 |
- | 크기 | 문자열 | 라디오 버튼의 크기입니다. 옵션에는 `large`와 `small`이 포함됩니다 |
- | 비활성화됨 | 부울 | `참`이면 라디오 버튼이 비활성화되어 클릭할 수 없습니다 |
- | 라벨 위치 | 문자열 | 라벨 텍스트의 라디오 버튼에 대한 상대 위치입니다. 두 가지 옵션: `left`와 `right` |
- </Tab>
+<Tab title="사용법">
+
+```jsx
+import { Radio } from "twenty-ui/display";
+
+export const MyComponent = () => {
+
+ const handleRadioChange = (event) => {
+ console.log("Radio button changed:", event.target.checked);
+ };
+
+ const handleCheckedChange = (checked) => {
+ console.log("Checked state changed:", checked);
+ };
+
+
+ return (
+ <Radio
+ checked={true}
+ value="Option 1"
+ onChange={handleRadioChange}
+ onCheckedChange={handleCheckedChange}
+ size="large"
+ disabled={false}
+ labelPosition="right"
+ />
+ );
+};
+
+```
+
+
+</Tab>
+<Tab title="프로퍼티">
+
+
+| 프로퍼티 | 유형 | 설명 |
+| --------------- | -------------- | ----------------------------------------------------- |
+| 스타일 | `React.CSS` 속성 | 컴포넌트의 추가 인라인 스타일 |
+| 클래스 네임 | 문자열 | 추가 스타일링을 위한 선택적 CSS 클래스 |
+| 체크됨 | 부울 | 라디오 버튼이 체크되었는지 여부를 나타냅니다 |
+| 값 | 문자열 | 라디오 버튼과 연결된 라벨 또는 텍스트 |
+| onChange | 함수 | 선택된 라디오 버튼이 변경될 때 호출되는 기능 |
+| onCheckedChange | 함수 | 라디오 버튼의 `체크` 상태가 변경될 때 호출되는 기능 |
+| 크기 | 문자열 | 라디오 버튼의 크기입니다. 옵션에는 `large`와 `small`이 포함됩니다 |
+| 비활성화됨 | 부울 | `참`이면 라디오 버튼이 비활성화되어 클릭할 수 없습니다 |
+| 라벨 위치 | 문자열 | 라벨 텍스트의 라디오 버튼에 대한 상대 위치입니다. 두 가지 옵션: `left`와 `right` |
+
+
+
+
+</Tab>
</Tabs>
## 라디오 그룹
@@ -60,37 +69,45 @@ title: 라디오
관련된 라디오 버튼들을 그룹화합니다.
<Tabs>
- <Tab title="사용법">
- ```jsx
- import React, { useState } from "react";
- import { Radio, RadioGroup } from "twenty-ui/display";
-
- export const MyComponent = () => {
-
- const [selectedValue, setSelectedValue] = useState("Option 1");
-
- const handleChange = (event) => {
- setSelectedValue(event.target.value);
- };
-
- return (
- <RadioGroup value={selectedValue} onChange={handleChange}>
- <Radio value="Option 1" />
- <Radio value="Option 2" />
- <Radio value="Option 3" />
- </RadioGroup>
- );
- };
-
- ```
- </Tab>
-
- <Tab title="프로퍼티">
- | 프로퍼티 | 유형 | 설명 |
- | ------------- | ----------------- | -------------------------------------------------- |
- | 값 | 문자열 | 현재 선택된 라디오 버튼의 값 |
- | onChange | 기능 | 라디오 버튼이 변경될 때 트리거되는 콜백 기능 |
- | onValueChange | 기능 | 그룹에서 선택된 값이 변경될 때 트리거되는 콜백 기능. |
- | 자식 | `React.ReactNode` | Radio와 같은 React 컴포넌트를 자식으로 Radio Group에 전달할 수 있습니다 |
- </Tab>
+<Tab title="사용법">
+
+```jsx
+import React, { useState } from "react";
+import { Radio, RadioGroup } from "twenty-ui/display";
+
+export const MyComponent = () => {
+
+ const [selectedValue, setSelectedValue] = useState("Option 1");
+
+ const handleChange = (event) => {
+ setSelectedValue(event.target.value);
+ };
+
+ return (
+ <RadioGroup value={selectedValue} onChange={handleChange}>
+ <Radio value="Option 1" />
+ <Radio value="Option 2" />
+ <Radio value="Option 3" />
+ </RadioGroup>
+ );
+};
+
+```
+
+</Tab>
+<Tab title="프로퍼티">
+
+
+| 프로퍼티 | 유형 | 설명 |
+| ------------- | ----------------- | -------------------------------------------------- |
+| 값 | 문자열 | 현재 선택된 라디오 버튼의 값 |
+| onChange | 기능 | 라디오 버튼이 변경될 때 트리거되는 콜백 기능 |
+| onValueChange | 기능 | 그룹에서 선택된 값이 변경될 때 트리거되는 콜백 기능. |
+| 자식 | `React.ReactNode` | Radio와 같은 React 컴포넌트를 자식으로 Radio Group에 전달할 수 있습니다 |
+
+
+
+
+</Tab>
+
</Tabs>
diff --git a/packages/twenty-docs/l/ko/twenty-ui/input/select.mdx b/packages/twenty-docs/l/ko/twenty-ui/input/select.mdx
index bfd6961ef1d..f81e1ca4967 100644
--- a/packages/twenty-docs/l/ko/twenty-ui/input/select.mdx
+++ b/packages/twenty-docs/l/ko/twenty-ui/input/select.mdx
@@ -9,39 +9,46 @@ title: 선택
사용자가 미리 정의된 옵션 목록에서 값을 선택할 수 있도록 합니다.
<Tabs>
- <Tab title="사용법">
- ```jsx
- import { IconTwentyStar } from 'twenty-ui/display';
-
- import { Select } from '@/ui/input/components/Select';
-
- export const MyComponent = () => {
-
- return (
- <Select
- className
- disabled={false}
- label="옵션을 선택하세요"
- options={[
- { value: 'option1', label: '옵션 A', Icon: IconTwentyStar },
- { value: 'option2', label: '옵션 B', Icon: IconTwentyStar },
- ]}
- value="option1"
- />
- );
- };
-
- ```
- </Tab>
-
- <Tab title="프로퍼티">
- | 프로퍼티 | 유형 | 설명 |
- | -------- | --- | ---------------------------------------------------------------------------------------------- |
- | 클래스 네임 | 문자열 | 추가 스타일링을 위한 선택적 CSS 클래스 |
- | disabled | 부울 | `true`로 설정하면 사용자는 이 구성 요소와 상호작용할 수 없습니다. |
- | 라벨 | 문자열 | `선택` 구성 요소의 목적을 설명하는 라벨 |
- | onChange | 함수 | 선택된 값이 변경될 때 호출되는 함수 |
- | 옵션 | 배열 | `선택된` 구성 요소에 사용할 수 있는 옵션들을 나타냅니다. 각 객체에는 `값`(고유 식별자), `라벨`(고유 식별자) 및 선택적 `아이콘`이 포함된 객체의 배열입니다. |
- | 값 | 문자열 | 현재 선택된 값을 나타냅니다. `옵션` 배열에서 하나의 `값` 속성과 일치해야 합니다. |
- </Tab>
+<Tab title="사용법">
+
+```jsx
+import { IconTwentyStar } from 'twenty-ui/display';
+
+import { Select } from '@/ui/input/components/Select';
+
+export const MyComponent = () => {
+
+ return (
+ <Select
+ className
+ disabled={false}
+ label="옵션을 선택하세요"
+ options={[
+ { value: 'option1', label: '옵션 A', Icon: IconTwentyStar },
+ { value: 'option2', label: '옵션 B', Icon: IconTwentyStar },
+ ]}
+ value="option1"
+ />
+ );
+};
+
+```
+
+</Tab>
+<Tab title="프로퍼티">
+
+
+| 프로퍼티 | 유형 | 설명 |
+| -------- | --- | ---------------------------------------------------------------------------------------------- |
+| 클래스 네임 | 문자열 | 추가 스타일링을 위한 선택적 CSS 클래스 |
+| disabled | 부울 | `true`로 설정하면 사용자는 이 구성 요소와 상호작용할 수 없습니다. |
+| 라벨 | 문자열 | `선택` 구성 요소의 목적을 설명하는 라벨 |
+| onChange | 함수 | 선택된 값이 변경될 때 호출되는 함수 |
+| 옵션 | 배열 | `선택된` 구성 요소에 사용할 수 있는 옵션들을 나타냅니다. 각 객체에는 `값`(고유 식별자), `라벨`(고유 식별자) 및 선택적 `아이콘`이 포함된 객체의 배열입니다. |
+| 값 | 문자열 | 현재 선택된 값을 나타냅니다. `옵션` 배열에서 하나의 `값` 속성과 일치해야 합니다. |
+
+
+
+
+</Tab>
</Tabs>
diff --git a/packages/twenty-docs/l/ko/twenty-ui/input/text.mdx b/packages/twenty-docs/l/ko/twenty-ui/input/text.mdx
index 0feeba10a97..39874e4f4bb 100644
--- a/packages/twenty-docs/l/ko/twenty-ui/input/text.mdx
+++ b/packages/twenty-docs/l/ko/twenty-ui/input/text.mdx
@@ -11,49 +11,61 @@ title: 텍스트
사용자가 텍스트를 입력하고 편집할 수 있습니다.
<Tabs>
- <Tab title="사용법">
- ```jsx
- import { TextInput } from "@/ui/input/components/TextInput";
-
- export const MyComponent = () => {
- const handleChange = (text) => {
- console.log("입력 변경됨:", text);
- };
-
- const handleKeyDown = (event) => {
- console.log("키가 눌림:", event.key);
- };
-
- return (
- <TextInput
- className
- label="사용자 이름"
- onChange={handleChange}
- fullWidth={false}
- disableHotkeys={false}
- error="유효하지 않은 사용자 이름"
- onKeyDown={handleKeyDown}
- RightIcon={null}
- />
- );
- };
- ```
- </Tab>
-
- <Tab title="프로퍼티">
- | 프로퍼티 | 유형 | 설명 |
- | -------------- | ------------- | -------------------------------------------------------------- |
- | 클래스 네임 | 문자열 | 추가 스타일링을 위한 선택적 이름 |
- | 레이블 | 문자열 | 입력의 레이블을 나타냅니다. |
- | onChange | function | 입력 값이 변경될 때 호출되는 함수 |
- | fullWidth | 부울 | 입력이 너비의 100%를 차지해야 하는지 여부를 나타냅니다. |
- | disableHotkeys | 부울 | 입력에 대해 단축키가 활성화되었는지 여부를 나타냅니다. |
- | 오류 | 문자열 | 표시될 오류 메시지를 나타냅니다. 제공되면 입력의 오른쪽에 오류 아이콘도 추가됩니다 |
- | onKeyDown | function | 입력 필드가 포커스될 때 키가 눌린 경우 호출됩니다. `React.KeyboardEvent`를 인수로 받습니다. |
- | RightIcon | IconComponent | 입력 오른쪽에 표시되는 선택적 아이콘 컴포넌트 |
-
- 이 컴포넌트는 다른 HTML 입력 요소 속성도 허용합니다.
- </Tab>
+
+<Tab title="사용법">
+
+```jsx
+import { TextInput } from "@/ui/input/components/TextInput";
+
+export const MyComponent = () => {
+ const handleChange = (text) => {
+ console.log("입력 변경됨:", text);
+ };
+
+ const handleKeyDown = (event) => {
+ console.log("키가 눌림:", event.key);
+ };
+
+ return (
+ <TextInput
+ className
+ label="사용자 이름"
+ onChange={handleChange}
+ fullWidth={false}
+ disableHotkeys={false}
+ error="유효하지 않은 사용자 이름"
+ onKeyDown={handleKeyDown}
+ RightIcon={null}
+ />
+ );
+};
+
+```
+
+
+</Tab>
+
+<Tab title="프로퍼티">
+
+
+| 프로퍼티 | 유형 | 설명 |
+| -------------- | ------------- | -------------------------------------------------------------- |
+| 클래스 네임 | 문자열 | 추가 스타일링을 위한 선택적 이름 |
+| 레이블 | 문자열 | 입력의 레이블을 나타냅니다. |
+| onChange | function | 입력 값이 변경될 때 호출되는 함수 |
+| fullWidth | 부울 | 입력이 너비의 100%를 차지해야 하는지 여부를 나타냅니다. |
+| disableHotkeys | 부울 | 입력에 대해 단축키가 활성화되었는지 여부를 나타냅니다. |
+| 오류 | 문자열 | 표시될 오류 메시지를 나타냅니다. 제공되면 입력의 오른쪽에 오류 아이콘도 추가됩니다 |
+| onKeyDown | function | 입력 필드가 포커스될 때 키가 눌린 경우 호출됩니다. `React.KeyboardEvent`를 인수로 받습니다. |
+| RightIcon | IconComponent | 입력 오른쪽에 표시되는 선택적 아이콘 컴포넌트 |
+
+
+
+
+이 컴포넌트는 다른 HTML 입력 요소 속성도 허용합니다.
+
+</Tab>
+
</Tabs>
## 자동 크기 조정 텍스트 입력
@@ -61,37 +73,48 @@ title: 텍스트
내용에 따라 자동으로 높이가 조정되는 텍스트 입력 컴포넌트.
<Tabs>
- <Tab title="사용법">
- ```jsx
- import { AutosizeTextInput } from "@/ui/input/components/AutosizeTextInput";
-
- export const MyComponent = () => {
- return (
- <AutosizeTextInput
- onValidate={() => console.log("onValidate 함수 실행됨")}
- minRows={1}
- placeholder="댓글을 작성하세요"
- onFocus={() => console.log("onFocus 함수 실행됨")}
- variant="icon"
- buttonTitle
- value="작업: "
- />
- );
- };
- ```
- </Tab>
-
- <Tab title="프로퍼티">
- | 프로퍼티 | 유형 | 설명 |
- | ----------- | -------- | ------------------------------------------------ |
- | onValidate | function | 사용자가 입력을 검증할 때 트리거하려는 콜백 함수 |
- | minRows | 숫자 | 텍스트 영역의 최소 행 수 |
- | placeholder | 문자열 | 텍스트 영역이 비어 있을 때 표시할 자리 표시자 텍스트 |
- | onFocus | function | 텍스트 영역에 초점이 맞춰졌을 때 트리거하려는 콜백 함수 |
- | variant | 문자열 | 입력의 변형. 옵션에는 `default`, `icon`, `button`이 포함됩니다. |
- | buttonTitle | 문자열 | (버튼 변형에만 적용됨) 버튼의 제목 |
- | 값 | 문자열 | 텍스트 영역의 초기 값 |
- </Tab>
+
+<Tab title="사용법">
+
+```jsx
+import { AutosizeTextInput } from "@/ui/input/components/AutosizeTextInput";
+
+export const MyComponent = () => {
+ return (
+ <AutosizeTextInput
+ onValidate={() => console.log("onValidate 함수 실행됨")}
+ minRows={1}
+ placeholder="댓글을 작성하세요"
+ onFocus={() => console.log("onFocus 함수 실행됨")}
+ variant="icon"
+ buttonTitle
+ value="작업: "
+ />
+ );
+};
+```
+
+
+</Tab>
+
+<Tab title="프로퍼티">
+
+
+| 프로퍼티 | 유형 | 설명 |
+| ----------- | -------- | ------------------------------------------------ |
+| onValidate | function | 사용자가 입력을 검증할 때 트리거하려는 콜백 함수 |
+| minRows | 숫자 | 텍스트 영역의 최소 행 수 |
+| placeholder | 문자열 | 텍스트 영역이 비어 있을 때 표시할 자리 표시자 텍스트 |
+| onFocus | function | 텍스트 영역에 초점이 맞춰졌을 때 트리거하려는 콜백 함수 |
+| variant | 문자열 | 입력의 변형. 옵션에는 `default`, `icon`, `button`이 포함됩니다. |
+| buttonTitle | 문자열 | (버튼 변형에만 적용됨) 버튼의 제목 |
+| 값 | 문자열 | 텍스트 영역의 초기 값 |
+
+
+
+
+</Tab>
+
</Tabs>
## 텍스트 영역
@@ -99,31 +122,40 @@ title: 텍스트
다중 라인 텍스트 입력을 만들 수 있습니다.
<Tabs>
- <Tab title="사용법">
- ```jsx
- import { TextArea } from "@/ui/input/components/TextArea";
-
- export const MyComponent = () => {
- return (
- <TextArea
- disabled={false}
- minRows={4}
- onChange={()=>console.log('onChange 함수 실행됨')}
- placeholder="여기에 텍스트를 입력하세요"
- value=""
- />
- );
- };
- ```
- </Tab>
-
- <Tab title="프로퍼티">
- | 프로퍼티 | 유형 | 설명 |
- | ----------- | --- | ------------------------------ |
- | disabled | 부울 | 텍스트 영역이 비활성화되어 있는지 여부를 나타냅니다. |
- | minRows | 숫자 | 텍스트 영역의 최소 표시 행 수. |
- | onChange | 기능 | 텍스트 영역의 내용이 변경될 때 호출되는 콜백 함수 |
- | placeholder | 문자열 | 텍스트 영역이 비어 있을 때 표시할 자리 표시자 텍스트 |
- | 값 | 문자열 | 텍스트 영역의 현재 값 |
- </Tab>
+<Tab title="사용법">
+
+```jsx
+import { TextArea } from "@/ui/input/components/TextArea";
+
+export const MyComponent = () => {
+ return (
+ <TextArea
+ disabled={false}
+ minRows={4}
+ onChange={()=>console.log('onChange 함수 실행됨')}
+ placeholder="여기에 텍스트를 입력하세요"
+ value=""
+ />
+ );
+};
+```
+
+
+</Tab>
+
+<Tab title="프로퍼티">
+
+
+| 프로퍼티 | 유형 | 설명 |
+| ----------- | --- | ------------------------------ |
+| disabled | 부울 | 텍스트 영역이 비활성화되어 있는지 여부를 나타냅니다. |
+| minRows | 숫자 | 텍스트 영역의 최소 표시 행 수. |
+| onChange | 기능 | 텍스트 영역의 내용이 변경될 때 호출되는 콜백 함수 |
+| placeholder | 문자열 | 텍스트 영역이 비어 있을 때 표시할 자리 표시자 텍스트 |
+| 값 | 문자열 | 텍스트 영역의 현재 값 |
+
+
+
+
+</Tab>
</Tabs>
diff --git a/packages/twenty-docs/l/ko/twenty-ui/input/toggle.mdx b/packages/twenty-docs/l/ko/twenty-ui/input/toggle.mdx
index d27f505de93..dca67ddc9a5 100644
--- a/packages/twenty-docs/l/ko/twenty-ui/input/toggle.mdx
+++ b/packages/twenty-docs/l/ko/twenty-ui/input/toggle.mdx
@@ -1,32 +1,38 @@
---
title: 토글
+icon: toggle-on
---
-
<Tabs>
- <Tab title="사용법">
- ```jsx
- import { Toggle } from "twenty-ui/input";
-
- export const MyComponent = () => {
- return (
- <Toggle
- value = {true}
- onChange = {()=>console.log('On Change event')}
- color="green"
- toggleSize = "medium"
- />
- );
- };
- ```
- </Tab>
-
- <Tab title="프로퍼티">
- | 프로퍼티 | 유형 | 설명 | 기본값 |
- | -------- | -------- | -------------------------------------------------------- | ------------ |
- | 값 | 부울 | 현재 토글의 상태 | `거짓` |
- | onChange | function | 토글 상태가 변경될 때 호출되는 콜백 함수 | |
- | 색상 | 문자열 | Color of the toggle when it\ | s blue color |
- | 토글 크기 | 문자열 | 토글의 크기는 높이와 너비에 영향을 미칩니다. 옵션은 'small'과 'medium' 두 가지입니다. | 중간 |
- </Tab>
+<Tab title="사용법">
+
+```jsx
+import { Toggle } from "twenty-ui/input";
+
+export const MyComponent = () => {
+ return (
+ <Toggle
+ value = {true}
+ onChange = {()=>console.log('On Change event')}
+ color="green"
+ toggleSize = "medium"
+ />
+ );
+};
+```
+
+</Tab>
+<Tab title="프로퍼티">
+
+
+| 프로퍼티 | 유형 | 설명 | 기본값 |
+| -------- | -------- | -------------------------------------------------------- | ------------ |
+| 값 | 부울 | 현재 토글의 상태 | `거짓` |
+| onChange | function | 토글 상태가 변경될 때 호출되는 콜백 함수 | |
+| 색상 | 문자열 | Color of the toggle when it\ | s blue color |
+| 토글 크기 | 문자열 | 토글의 크기는 높이와 너비에 영향을 미칩니다. 옵션은 'small'과 'medium' 두 가지입니다. | 중간 |
+
+
+
+</Tab>
</Tabs>
diff --git a/packages/twenty-docs/l/ko/twenty-ui/introduction.mdx b/packages/twenty-docs/l/ko/twenty-ui/introduction.mdx
index b04c9dcba6a..e6ba6f4fc43 100644
--- a/packages/twenty-docs/l/ko/twenty-ui/introduction.mdx
+++ b/packages/twenty-docs/l/ko/twenty-ui/introduction.mdx
@@ -1,5 +1,6 @@
---
title: 개요
+icon: 팔레트
description: Twenty CRM을 위한 구성 요소 라이브러리
---
diff --git a/packages/twenty-docs/l/ko/twenty-ui/navigation.mdx b/packages/twenty-docs/l/ko/twenty-ui/navigation.mdx
index 6bbcecb832a..f327730f266 100644
--- a/packages/twenty-docs/l/ko/twenty-ui/navigation.mdx
+++ b/packages/twenty-docs/l/ko/twenty-ui/navigation.mdx
@@ -1,5 +1,6 @@
---
title: 네비게이션
+icon: 나침반
---
<Frame>
diff --git a/packages/twenty-docs/l/ko/twenty-ui/navigation/breadcrumb.mdx b/packages/twenty-docs/l/ko/twenty-ui/navigation/breadcrumb.mdx
index f9c2ab287d8..ecb05048b36 100644
--- a/packages/twenty-docs/l/ko/twenty-ui/navigation/breadcrumb.mdx
+++ b/packages/twenty-docs/l/ko/twenty-ui/navigation/breadcrumb.mdx
@@ -9,32 +9,38 @@ title: Breadcrumb
브레드크럼 내비게이션 바를 렌더링합니다.
<Tabs>
- <Tab title="사용법">
- ```jsx
- import { BrowserRouter } from "react-router-dom";
- import { Breadcrumb } from "@/ui/navigation/bread-crumb/components/Breadcrumb";
-
- export const MyComponent = () => {
- const breadcrumbLinks = [
- { children: "Home", href: "/" },
- { children: "Category", href: "/category" },
- { children: "Subcategory", href: "/category/subcategory" },
- { children: "Current Page" },
- ];
-
- return (
- <BrowserRouter>
- <Breadcrumb className links={breadcrumbLinks} />
- </BrowserRouter>
- )
- };
- ```
- </Tab>
-
- <Tab title="프로퍼티">
- | 프로퍼티 | 유형 | 설명 |
- | ------ | --- | ------------------------------------------------------------------------------------------------------ |
- | 클래스 네임 | 문자열 | 추가 스타일을 위한 선택적 클래스 이름 |
- | 링크 | 배열 | 각 브레드크럼 링크를 나타내는 객체의 배열. 각 객체는 `children` 속성(링크의 텍스트 콘텐츠)과 선택적 `href` 속성(링크를 클릭할 때 이동할 URL)을 가지고 있습니다. |
- </Tab>
+<Tab title="사용법">
+
+```jsx
+import { BrowserRouter } from "react-router-dom";
+import { Breadcrumb } from "@/ui/navigation/bread-crumb/components/Breadcrumb";
+
+export const MyComponent = () => {
+ const breadcrumbLinks = [
+ { children: "Home", href: "/" },
+ { children: "Category", href: "/category" },
+ { children: "Subcategory", href: "/category/subcategory" },
+ { children: "Current Page" },
+ ];
+
+ return (
+ <BrowserRouter>
+ <Breadcrumb className links={breadcrumbLinks} />
+ </BrowserRouter>
+ )
+};
+```
+
+</Tab>
+<Tab title="프로퍼티">
+
+
+| 프로퍼티 | 유형 | 설명 |
+| ------ | --- | ------------------------------------------------------------------------------------------------------ |
+| 클래스 네임 | 문자열 | 추가 스타일을 위한 선택적 클래스 이름 |
+| 링크 | 배열 | 각 브레드크럼 링크를 나타내는 객체의 배열. 각 객체는 `children` 속성(링크의 텍스트 콘텐츠)과 선택적 `href` 속성(링크를 클릭할 때 이동할 URL)을 가지고 있습니다. |
+
+
+
+</Tab>
</Tabs>
diff --git a/packages/twenty-docs/l/ko/twenty-ui/navigation/links.mdx b/packages/twenty-docs/l/ko/twenty-ui/navigation/links.mdx
index b296cdf5bb8..b6899862a7e 100644
--- a/packages/twenty-docs/l/ko/twenty-ui/navigation/links.mdx
+++ b/packages/twenty-docs/l/ko/twenty-ui/navigation/links.mdx
@@ -1,5 +1,6 @@
---
title: 링크
+icon: 링크
---
<Frame>
@@ -11,40 +12,49 @@ title: 링크
연락처 정보를 표시하기 위한 스타일화된 링크 구성 요소입니다.
<Tabs>
- <Tab title="사용법">
- ```jsx
- import { BrowserRouter as Router } from 'react-router-dom';
-
- import { ContactLink } from 'twenty-ui/navigation';
-
- export const MyComponent = () => {
- const handleLinkClick = (event) => {
- console.log('Contact link clicked!', event);
- };
-
- return (
- <Router>
- <ContactLink
- className
- href="mailto:[email protected]"
- onClick={handleLinkClick}
- >
- </ContactLink>
- </Router>
- );
- };
- ```
- </Tab>
-
- <Tab title="프로퍼티">
- | 프로퍼티 | 유형 | 설명 |
- | -------- | ----------------- | --------------------- |
- | 클래스 네임 | 문자열 | 추가 스타일을 위한 선택적 이름 |
- | href | 문자열 | 링크의 대상 URL 또는 경로 |
- | onClick | function | 링크가 클릭될 때 트리거되는 콜백 함수 |
- | children | `React.ReactNode` | 링크 내부에 표시할 콘텐츠 |
- </Tab>
+<Tab title="사용법">
+
+```jsx
+import { BrowserRouter as Router } from 'react-router-dom';
+
+import { ContactLink } from 'twenty-ui/navigation';
+
+export const MyComponent = () => {
+ const handleLinkClick = (event) => {
+ console.log('Contact link clicked!', event);
+ };
+
+ return (
+ <Router>
+ <ContactLink
+ className
+ href="mailto:[email protected]"
+ onClick={handleLinkClick}
+ >
+ </ContactLink>
+ </Router>
+ );
+};
+```
+
+
+</Tab>
+<Tab title="프로퍼티">
+
+
+| 프로퍼티 | 유형 | 설명 |
+| -------- | ----------------- | --------------------- |
+| 클래스 네임 | 문자열 | 추가 스타일을 위한 선택적 이름 |
+| href | 문자열 | 링크의 대상 URL 또는 경로 |
+| onClick | function | 링크가 클릭될 때 트리거되는 콜백 함수 |
+| children | `React.ReactNode` | 링크 내부에 표시할 콘텐츠 |
+
+
+
+
+</Tab>
+
</Tabs>
## 원시 링크
@@ -52,36 +62,44 @@ title: 링크
링크를 표시하기 위한 스타일화된 링크 구성 요소입니다.
<Tabs>
- <Tab title="사용법">
- ```jsx
- import { RawLink } from "/navigation";
- import { BrowserRouter as Router } from "react-router-dom";
-
- export const MyComponent = () => {
- const handleLinkClick = (event) => {
- console.log("Contact link clicked!", event);
- };
-
- return (
- <Router>
- <RawLink className href="/contact" onClick={handleLinkClick}>
- Contact Us
- </RawLink>
- </Router>
- );
- };
-
- ```
- </Tab>
-
- <Tab title="프로퍼티">
- | 프로퍼티 | 유형 | 설명 |
- | -------- | ----------------- | --------------------- |
- | 클래스 네임 | 문자열 | 추가 스타일을 위한 선택적 이름 |
- | href | 문자열 | 링크의 대상 URL 또는 경로 |
- | onClick | function | 링크가 클릭될 때 트리거되는 콜백 함수 |
- | children | `React.ReactNode` | 링크 내부에 표시할 콘텐츠 |
- </Tab>
+<Tab title="사용법">
+
+```jsx
+import { RawLink } from "/navigation";
+import { BrowserRouter as Router } from "react-router-dom";
+
+export const MyComponent = () => {
+ const handleLinkClick = (event) => {
+ console.log("Contact link clicked!", event);
+ };
+
+ return (
+ <Router>
+ <RawLink className href="/contact" onClick={handleLinkClick}>
+ Contact Us
+ </RawLink>
+ </Router>
+ );
+};
+
+```
+
+
+</Tab>
+<Tab title="프로퍼티">
+
+
+| 프로퍼티 | 유형 | 설명 |
+| -------- | ----------------- | --------------------- |
+| 클래스 네임 | 문자열 | 추가 스타일을 위한 선택적 이름 |
+| href | 문자열 | 링크의 대상 URL 또는 경로 |
+| onClick | function | 링크가 클릭될 때 트리거되는 콜백 함수 |
+| children | `React.ReactNode` | 링크 내부에 표시할 콘텐츠 |
+
+
+
+
+</Tab>
</Tabs>
## 둥근 링크
@@ -89,34 +107,41 @@ title: 링크
Chip 구성 요소가 있는 라운드 스타일 링크입니다.
<Tabs>
- <Tab title="사용법">
- ```jsx
- import { RoundedLink } from "/navigation";
- import { BrowserRouter as Router } from "react-router-dom";
-
- export const MyComponent = () => {
- const handleLinkClick = (event) => {
- console.log("Contact link clicked!", event);
- };
-
- return (
- <Router>
- <RoundedLink href="/contact" onClick={handleLinkClick}>
- Contact Us
- </RoundedLink>
- </Router>
- );
- };
- ```
- </Tab>
-
- <Tab title="프로퍼티">
- | 프로퍼티 | 유형 | 설명 |
- | -------- | ----------------- | --------------------- |
- | href | 문자열 | 링크의 대상 URL 또는 경로 |
- | children | `React.ReactNode` | 링크 내부에 표시할 콘텐츠 |
- | onClick | 기능 | 링크가 클릭될 때 트리거되는 콜백 함수 |
- </Tab>
+<Tab title="사용법">
+
+```jsx
+import { RoundedLink } from "/navigation";
+import { BrowserRouter as Router } from "react-router-dom";
+
+export const MyComponent = () => {
+ const handleLinkClick = (event) => {
+ console.log("Contact link clicked!", event);
+ };
+
+ return (
+ <Router>
+ <RoundedLink href="/contact" onClick={handleLinkClick}>
+ Contact Us
+ </RoundedLink>
+ </Router>
+ );
+};
+```
+
+</Tab>
+
+<Tab title="프로퍼티">
+
+
+| 프로퍼티 | 유형 | 설명 |
+| -------- | ----------------- | --------------------- |
+| href | 문자열 | 링크의 대상 URL 또는 경로 |
+| children | `React.ReactNode` | 링크 내부에 표시할 콘텐츠 |
+| onClick | 기능 | 링크가 클릭될 때 트리거되는 콜백 함수 |
+
+
+
+</Tab>
</Tabs>
## 소셜 링크
@@ -124,30 +149,37 @@ Chip 구성 요소가 있는 라운드 스타일 링크입니다.
URL, LinkedIn 및 X(또는 Twitter)와 같은 다양한 소셜 링크 유형을 지원하는 스타일화된 소셜 링크입니다.
<Tabs>
- <Tab title="사용법">
- ```jsx
- import { SocialLink } from "twenty-ui/navigation";
- import { BrowserRouter as Router } from "react-router-dom";
-
- export const MyComponent = () => {
- return (
- <Router>
- <SocialLink
- type="twitter"
- href="https://twitter.com/twentycrm"
- ></SocialLink>
- </Router>
- );
- };
- ```
- </Tab>
-
- <Tab title="프로퍼티">
- | 프로퍼티 | 유형 | 설명 |
- | -------- | ----------------- | ------------------------------------------------------- |
- | href | 문자열 | 링크의 대상 URL 또는 경로 |
- | children | `React.ReactNode` | 링크 내부에 표시할 콘텐츠 |
- | 유형 | 문자열 | 소셜 링크 유형입니다. 옵션은 다음과 같습니다: `url`, `LinkedIn`, `Twitter` |
- | onClick | 기능 | 링크를 클릭할 때 호출되는 콜백 함수 |
- </Tab>
+<Tab title="사용법">
+
+```jsx
+import { SocialLink } from "twenty-ui/navigation";
+import { BrowserRouter as Router } from "react-router-dom";
+
+export const MyComponent = () => {
+ return (
+ <Router>
+ <SocialLink
+ type="twitter"
+ href="https://twitter.com/twentycrm"
+ ></SocialLink>
+ </Router>
+ );
+};
+```
+
+</Tab>
+<Tab title="프로퍼티">
+
+
+| 프로퍼티 | 유형 | 설명 |
+| -------- | ----------------- | ------------------------------------------------------- |
+| href | 문자열 | 링크의 대상 URL 또는 경로 |
+| children | `React.ReactNode` | 링크 내부에 표시할 콘텐츠 |
+| 유형 | 문자열 | 소셜 링크 유형입니다. 옵션은 다음과 같습니다: `url`, `LinkedIn`, `Twitter` |
+| onClick | 기능 | 링크를 클릭할 때 호출되는 콜백 함수 |
+
+
+
+
+</Tab>
</Tabs>
diff --git a/packages/twenty-docs/l/ko/twenty-ui/navigation/menu-item.mdx b/packages/twenty-docs/l/ko/twenty-ui/navigation/menu-item.mdx
index 5ae60427d5f..4d18c6425e7 100644
--- a/packages/twenty-docs/l/ko/twenty-ui/navigation/menu-item.mdx
+++ b/packages/twenty-docs/l/ko/twenty-ui/navigation/menu-item.mdx
@@ -1,54 +1,62 @@
---
title: 메뉴 항목
+icon: bars
---
-
메뉴 또는 탐색 목록에서 사용할 수 있도록 설계된 다용도 메뉴 항목입니다.
<Tabs>
- <Tab title="사용법">
- ```jsx
- import { IconBell } from "@tabler/icons-react";
- import { IconAlertCircle } from "@tabler/icons-react";
- import { MenuItem } from "twenty-ui/display";
-
- export const MyComponent = () => {
- const handleMenuItemClick = (event) => {
- console.log("Menu item clicked!", event);
- };
-
- const handleButtonClick = (event) => {
- console.log("Icon button clicked!", event);
- };
-
- return (
- <MenuItem
- LeftIcon={IconBell}
- accent="default"
- text="Menu item text"
- iconButtons={[{ Icon: IconAlertCircle, onClick: handleButtonClick }]}
- isTooltipOpen={true}
- testId="menu-item-1"
- onClick={handleMenuItemClick}
- className
- />
- );
- };
- ```
- </Tab>
-
- <Tab title="프로퍼티">
- | 프로퍼티 | 유형 | 설명 |
- | -------- | -------- | ----------------------------------------------------------------------- |
- | 왼쪽 아이콘 | 아이콘 컴포넌트 | 메뉴 항목의 텍스트 앞에 표시되는 선택적 왼쪽 아이콘 |
- | 강조 | 문자열 | 메뉴 항목의 강조 색상을 지정합니다. 옵션에는: `default`, `danger`, 및 `placeholder`가 포함됩니다. |
- | 텍스트 | 문자열 | 메뉴 항목의 텍스트 콘텐츠 |
- | 아이콘 버튼 | 배열 | 메뉴 항목과 연결된 추가 아이콘 버튼을 나타내는 객체 배열 |
- | 툴팁 열림 여부 | 부울 | 메뉴 항목과 연결된 툴팁의 가시성을 제어합니다 |
- | 테스트ID | 문자열 | 테스트용 데이터-testid 속성 |
- | 클릭 시 | function | 메뉴 항목을 클릭할 때 트리거되는 콜백 함수 |
- | 클래스 네임 | 문자열 | 추가 스타일링을 위한 선택적 이름 |
- </Tab>
+<Tab title="사용법">
+
+```jsx
+import { IconBell } from "@tabler/icons-react";
+import { IconAlertCircle } from "@tabler/icons-react";
+import { MenuItem } from "twenty-ui/display";
+
+export const MyComponent = () => {
+ const handleMenuItemClick = (event) => {
+ console.log("Menu item clicked!", event);
+ };
+
+ const handleButtonClick = (event) => {
+ console.log("Icon button clicked!", event);
+ };
+
+ return (
+ <MenuItem
+ LeftIcon={IconBell}
+ accent="default"
+ text="Menu item text"
+ iconButtons={[{ Icon: IconAlertCircle, onClick: handleButtonClick }]}
+ isTooltipOpen={true}
+ testId="menu-item-1"
+ onClick={handleMenuItemClick}
+ className
+ />
+ );
+};
+```
+
+
+</Tab>
+<Tab title="프로퍼티">
+
+
+| 프로퍼티 | 유형 | 설명 |
+| -------- | -------- | ----------------------------------------------------------------------- |
+| 왼쪽 아이콘 | 아이콘 컴포넌트 | 메뉴 항목의 텍스트 앞에 표시되는 선택적 왼쪽 아이콘 |
+| 강조 | 문자열 | 메뉴 항목의 강조 색상을 지정합니다. 옵션에는: `default`, `danger`, 및 `placeholder`가 포함됩니다. |
+| 텍스트 | 문자열 | 메뉴 항목의 텍스트 콘텐츠 |
+| 아이콘 버튼 | 배열 | 메뉴 항목과 연결된 추가 아이콘 버튼을 나타내는 객체 배열 |
+| 툴팁 열림 여부 | 부울 | 메뉴 항목과 연결된 툴팁의 가시성을 제어합니다 |
+| 테스트ID | 문자열 | 테스트용 데이터-testid 속성 |
+| 클릭 시 | function | 메뉴 항목을 클릭할 때 트리거되는 콜백 함수 |
+| 클래스 네임 | 문자열 | 추가 스타일링을 위한 선택적 이름 |
+
+
+
+
+</Tab>
</Tabs>
## 변형
@@ -60,42 +68,49 @@ title: 메뉴 항목
키보드 단축키를 나타내기 위한 명령 스타일 메뉴 항목
<Tabs>
- <Tab title="사용법">
- ```jsx
- import { IconBell } from "@tabler/icons-react";
- import { MenuItemCommand } from "twenty-ui/display";
-
- export const MyComponent = () => {
- const handleCommandClick = () => {
- console.log("Command clicked!");
- };
-
- return (
- <MenuItemCommand
- LeftIcon={IconBell}
- text="First Option"
- firstHotKey="⌘"
- secondHotKey="1"
- isSelected={true}
- onClick={handleCommandClick}
- className
- />
- );
- };
- ```
- </Tab>
-
- <Tab title="프로퍼티">
- | 프로퍼티 | 유형 | 설명 |
- | -------- | -------- | ------------------------------- |
- | 왼쪽 아이콘 | 아이콘 컴포넌트 | 메뉴 항목의 텍스트 앞에 표시되는 선택적 왼쪽 아이콘 |
- | 텍스트 | 문자열 | 메뉴 항목의 텍스트 콘텐츠 |
- | 첫 번째 단축키 | 문자열 | 명령어와 연결된 첫 번째 키보드 단축키 |
- | 두 번째 단축키 | 문자열 | 명령어와 연결된 두 번째 키보드 단축키 |
- | 선택됨 | 부울 | 메뉴 항목이 선택되었거나 강조 되었는지 여부를 나타냅니다 |
- | 클릭 시 | 함수 | 메뉴 항목을 클릭할 때 트리거되는 콜백 함수 |
- | 클래스 네임 | 문자열 | 추가 스타일링을 위한 선택적 이름 |
- </Tab>
+<Tab title="사용법">
+
+```jsx
+import { IconBell } from "@tabler/icons-react";
+import { MenuItemCommand } from "twenty-ui/display";
+
+export const MyComponent = () => {
+ const handleCommandClick = () => {
+ console.log("Command clicked!");
+ };
+
+ return (
+ <MenuItemCommand
+ LeftIcon={IconBell}
+ text="First Option"
+ firstHotKey="⌘"
+ secondHotKey="1"
+ isSelected={true}
+ onClick={handleCommandClick}
+ className
+ />
+ );
+};
+```
+
+
+</Tab>
+<Tab title="프로퍼티">
+
+
+| 프로퍼티 | 유형 | 설명 |
+| -------- | -------- | ------------------------------- |
+| 왼쪽 아이콘 | 아이콘 컴포넌트 | 메뉴 항목의 텍스트 앞에 표시되는 선택적 왼쪽 아이콘 |
+| 텍스트 | 문자열 | 메뉴 항목의 텍스트 콘텐츠 |
+| 첫 번째 단축키 | 문자열 | 명령어와 연결된 첫 번째 키보드 단축키 |
+| 두 번째 단축키 | 문자열 | 명령어와 연결된 두 번째 키보드 단축키 |
+| 선택됨 | 부울 | 메뉴 항목이 선택되었거나 강조 되었는지 여부를 나타냅니다 |
+| 클릭 시 | 함수 | 메뉴 항목을 클릭할 때 트리거되는 콜백 함수 |
+| 클래스 네임 | 문자열 | 추가 스타일링을 위한 선택적 이름 |
+
+
+
+</Tab>
</Tabs>
### 드래그 가능한
@@ -103,45 +118,52 @@ title: 메뉴 항목
아이콘 버튼을 통해 추가 작업을 수행할 수 있도록 드래그 가능한 메뉴 항목 컴포넌트
<Tabs>
- <Tab title="사용법">
- ```jsx
- import { IconBell } from "@tabler/icons-react";
- import { IconAlertCircle } from "@tabler/icons-react";
- import { MenuItemDraggable } from "twenty-ui/display";
-
- export const MyComponent = () => {
- const handleMenuItemClick = (event) => {
- console.log("Menu item clicked!", event);
- };
-
- return (
- <MenuItemDraggable
- LeftIcon={IconBell}
- accent="default"
- iconButtons={[{ Icon: IconAlertCircle, onClick: handleButtonClick }]}
- isTooltipOpen={false}
- onClick={handleMenuItemClick}
- text="Menu item draggable"
- isDragDisabled={false}
- className
- />
- );
- };
- ```
- </Tab>
-
- <Tab title="프로퍼티">
- | 프로퍼티 | 유형 | 설명 |
- | -------- | -------- | ----------------------------------------------- |
- | 왼쪽 아이콘 | 아이콘 컴포넌트 | 메뉴 항목의 텍스트 앞에 표시되는 선택적 왼쪽 아이콘 |
- | 강조 | 문자열 | 메뉴 항목의 강조 색상입니다. 기본, 플레이스홀더, 위험 중 하나가 될 수 있습니다. |
- | 아이콘 버튼 | 배열 | 메뉴 항목과 연결된 추가 아이콘 버튼을 나타내는 객체 배열 |
- | 툴팁 열림 여부 | 부울 | 메뉴 항목과 연결된 툴팁의 가시성을 제어합니다 |
- | 클릭 시 | 함수 | 링크가 클릭될 때 트리거되는 콜백 함수 |
- | 텍스트 | 문자열 | 메뉴 항목의 텍스트 콘텐츠 |
- | 드래그 비활성화 | 부울 | 드래그가 비활성화 되었는지 여부를 나타냅니다 |
- | 클래스 네임 | 문자열 | 추가 스타일링을 위한 선택적 이름 |
- </Tab>
+<Tab title="사용법">
+
+```jsx
+import { IconBell } from "@tabler/icons-react";
+import { IconAlertCircle } from "@tabler/icons-react";
+import { MenuItemDraggable } from "twenty-ui/display";
+
+export const MyComponent = () => {
+ const handleMenuItemClick = (event) => {
+ console.log("Menu item clicked!", event);
+ };
+
+ return (
+ <MenuItemDraggable
+ LeftIcon={IconBell}
+ accent="default"
+ iconButtons={[{ Icon: IconAlertCircle, onClick: handleButtonClick }]}
+ isTooltipOpen={false}
+ onClick={handleMenuItemClick}
+ text="Menu item draggable"
+ isDragDisabled={false}
+ className
+ />
+ );
+};
+```
+
+</Tab>
+<Tab title="프로퍼티">
+
+
+| 프로퍼티 | 유형 | 설명 |
+| -------- | -------- | ----------------------------------------------- |
+| 왼쪽 아이콘 | 아이콘 컴포넌트 | 메뉴 항목의 텍스트 앞에 표시되는 선택적 왼쪽 아이콘 |
+| 강조 | 문자열 | 메뉴 항목의 강조 색상입니다. 기본, 플레이스홀더, 위험 중 하나가 될 수 있습니다. |
+| 아이콘 버튼 | 배열 | 메뉴 항목과 연결된 추가 아이콘 버튼을 나타내는 객체 배열 |
+| 툴팁 열림 여부 | 부울 | 메뉴 항목과 연결된 툴팁의 가시성을 제어합니다 |
+| 클릭 시 | 함수 | 링크가 클릭될 때 트리거되는 콜백 함수 |
+| 텍스트 | 문자열 | 메뉴 항목의 텍스트 콘텐츠 |
+| 드래그 비활성화 | 부울 | 드래그가 비활성화 되었는지 여부를 나타냅니다 |
+| 클래스 네임 | 문자열 | 추가 스타일링을 위한 선택적 이름 |
+
+
+
+
+</Tab>
</Tabs>
### 다중 선택
@@ -149,34 +171,41 @@ title: 메뉴 항목
체크박스와 연결된 멀티 선택 기능을 구현하는 방법을 제공합니다.
<Tabs>
- <Tab title="사용법">
- ```jsx
- import { IconBell } from "@tabler/icons-react";
- import { MenuItemMultiSelect } from "twenty-ui/display";
-
- export const MyComponent = () => {
-
- return (
- <MenuItemMultiSelect
- LeftIcon={IconBell}
- text="First Option"
- selected={false}
- className
- />
- );
- };
- ```
- </Tab>
-
- <Tab title="프로퍼티">
- | 프로퍼티 | 유형 | 설명 |
- | ------- | -------- | ----------------------------- |
- | 왼쪽 아이콘 | 아이콘 컴포넌트 | 메뉴 항목의 텍스트 앞에 표시되는 선택적 왼쪽 아이콘 |
- | 텍스트 | 문자열 | 메뉴 항목의 텍스트 콘텐츠 |
- | 선택됨 | 부울 | 메뉴 항목이 선택(체크)되었는지 여부를 나타냅니다 |
- | 선택 변경 시 | 함수 | 체크박스 상태가 변경되었을 때 호출되는 콜백 함수 |
- | 클래스 네임 | 문자열 | 추가 스타일링을 위한 선택적 이름 |
- </Tab>
+<Tab title="사용법">
+
+```jsx
+import { IconBell } from "@tabler/icons-react";
+import { MenuItemMultiSelect } from "twenty-ui/display";
+
+export const MyComponent = () => {
+
+ return (
+ <MenuItemMultiSelect
+ LeftIcon={IconBell}
+ text="First Option"
+ selected={false}
+ className
+ />
+ );
+};
+```
+
+</Tab>
+<Tab title="프로퍼티">
+
+
+| 프로퍼티 | 유형 | 설명 |
+| ------- | -------- | ----------------------------- |
+| 왼쪽 아이콘 | 아이콘 컴포넌트 | 메뉴 항목의 텍스트 앞에 표시되는 선택적 왼쪽 아이콘 |
+| 텍스트 | 문자열 | 메뉴 항목의 텍스트 콘텐츠 |
+| 선택됨 | 부울 | 메뉴 항목이 선택(체크)되었는지 여부를 나타냅니다 |
+| 선택 변경 시 | 함수 | 체크박스 상태가 변경되었을 때 호출되는 콜백 함수 |
+| 클래스 네임 | 문자열 | 추가 스타일링을 위한 선택적 이름 |
+
+
+
+
+</Tab>
</Tabs>
### 다중 선택 아바타
@@ -184,35 +213,42 @@ title: 메뉴 항목
아바타, 선택할 수 있는 체크박스를 포함한 다중 선택 메뉴 아이템
<Tabs>
- <Tab title="사용법">
- ```jsx
- import { MenuItemMultiSelectAvatar } from "twenty-ui/display";
-
- export const MyComponent = () => {
- const imageUrl =
- "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAYABgAAD/4QCMRXhpZgAATU0AKgAAAAgABQESAAMAAAABAAEAAAEaAAUAAAABAAAASgEbAAUAAAABAAAAUgEoAAMAAAABAAIAAIdpAAQAAAABAAAAWgAAAAAAAABgAAAAAQAAAGAAAAABAAOgAQADAAAAAQABAACgAgAEAAAAAQAAABSgAwAEAAAAAQAAABQAAAAA/8AAEQgAFAAUAwEiAAIRAQMRAf/EAB8AAAEFAQEBAQEBAAAAAAAAAAABAgMEBQYHCAkKC//EALUQAAIBAwMCBAMFBQQEAAABfQECAwAEEQUSITFBBhNRYQcicRQygZGhCCNCscEVUtHwJDNicoIJChYXGBkaJSYnKCkqNDU2Nzg5OkNERUZHSElKU1RVVldYWVpjZGVmZ2hpanN0dXZ3eHl6g4SFhoeIiYqSk5SVlpeYmZqio6Slpqeoqaqys7S1tre4ubrCw8TFxsfIycrS09TV1tfY2drh4uPk5ebn6Onq8fLz9PX29/j5+v/EAB8BAAMBAQEBAQEBAQEAAAAAAAABAgMEBQYHCAkKC//EALURAAIBAgQEAwQHBQQEAAECdwABAgMRBAUhMQYSQVEHYXETIjKBCBRCkaGxwQkjM1LwFWJy0QoWJDThJfEXGBkaJicoKSo1Njc4OTpDREVGR0hJSlNUVVZXWFlaY2RlZmdoaWpzdHV2d3h5eoKDhIWGh4iJipKTlJWWl5iZmqKjpKWmp6ipqrKztLW2t7i5usLDxMXGx8jJytLT1NXW19jZ2uLj5OXm5+jp6vLz9PX29/j5+v/bAEMACwgICggHCwoJCg0MCw0RHBIRDw8RIhkaFBwpJCsqKCQnJy0yQDctMD0wJyc4TDk9Q0VISUgrNk9VTkZUQEdIRf/bAEMBDA0NEQ8RIRISIUUuJy5FRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRf/dAAQAAv/aAAwDAQACEQMRAD8Ava1q728otYY98joSCTgZrnbXWdTtrhrfVZXWLafmcAEkdgR/hVltQku9Q8+OIEBcGOT+ID0PY1ka1KH2u8ToqnPLbmIqG7u6LtbQ7RXBRec4Uck9eKXcPWsKDWVnhWSL5kYcFelSf2m3901POh8jP//QoyIAnTuKpXsY82NsksUyWPU5q/L9z8RVK++/F/uCsVsaEURwgA4HtT9x9TUcf3KfUGh//9k=";
-
- return (
- <MenuItemMultiSelectAvatar
- avatar={<img src={imageUrl} alt="Avatar" />}
- text="First Option"
- selected={false}
- className
- />
- );
- };
- ```
- </Tab>
-
- <Tab title="프로퍼티">
- | 프로퍼티 | 유형 | 설명 |
- | ------- | ----------- | --------------------------- |
- | 아바타 | `ReactNode` | 메뉴 항목의 왼쪽에 표시될 아바타 또는 아이콘 |
- | 텍스트 | 문자열 | 메뉴 항목의 텍스트 콘텐츠 |
- | 선택됨 | 부울 | 메뉴 항목이 선택(체크)되었는지 여부를 나타냅니다 |
- | 선택 변경 시 | 함수 | 체크박스 상태가 변경되었을 때 호출되는 콜백 함수 |
- | 클래스 네임 | 문자열 | 추가 스타일링을 위한 선택적 이름 |
- </Tab>
+<Tab title="사용법">
+
+```jsx
+import { MenuItemMultiSelectAvatar } from "twenty-ui/display";
+
+export const MyComponent = () => {
+ const imageUrl =
+ "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAYABgAAD/4QCMRXhpZgAATU0AKgAAAAgABQESAAMAAAABAAEAAAEaAAUAAAABAAAASgEbAAUAAAABAAAAUgEoAAMAAAABAAIAAIdpAAQAAAABAAAAWgAAAAAAAABgAAAAAQAAAGAAAAABAAOgAQADAAAAAQABAACgAgAEAAAAAQAAABSgAwAEAAAAAQAAABQAAAAA/8AAEQgAFAAUAwEiAAIRAQMRAf/EAB8AAAEFAQEBAQEBAAAAAAAAAAABAgMEBQYHCAkKC//EALUQAAIBAwMCBAMFBQQEAAABfQECAwAEEQUSITFBBhNRYQcicRQygZGhCCNCscEVUtHwJDNicoIJChYXGBkaJSYnKCkqNDU2Nzg5OkNERUZHSElKU1RVVldYWVpjZGVmZ2hpanN0dXZ3eHl6g4SFhoeIiYqSk5SVlpeYmZqio6Slpqeoqaqys7S1tre4ubrCw8TFxsfIycrS09TV1tfY2drh4uPk5ebn6Onq8fLz9PX29/j5+v/EAB8BAAMBAQEBAQEBAQEAAAAAAAABAgMEBQYHCAkKC//EALURAAIBAgQEAwQHBQQEAAECdwABAgMRBAUhMQYSQVEHYXETIjKBCBRCkaGxwQkjM1LwFWJy0QoWJDThJfEXGBkaJicoKSo1Njc4OTpDREVGR0hJSlNUVVZXWFlaY2RlZmdoaWpzdHV2d3h5eoKDhIWGh4iJipKTlJWWl5iZmqKjpKWmp6ipqrKztLW2t7i5usLDxMXGx8jJytLT1NXW19jZ2uLj5OXm5+jp6vLz9PX29/j5+v/bAEMACwgICggHCwoJCg0MCw0RHBIRDw8RIhkaFBwpJCsqKCQnJy0yQDctMD0wJyc4TDk9Q0VISUgrNk9VTkZUQEdIRf/bAEMBDA0NEQ8RIRISIUUuJy5FRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRf/dAAQAAv/aAAwDAQACEQMRAD8Ava1q728otYY98joSCTgZrnbXWdTtrhrfVZXWLafmcAEkdgR/hVltQku9Q8+OIEBcGOT+ID0PY1ka1KH2u8ToqnPLbmIqG7u6LtbQ7RXBRec4Uck9eKXcPWsKDWVnhWSL5kYcFelSf2m3901POh8jP//QoyIAnTuKpXsY82NsksUyWPU5q/L9z8RVK++/F/uCsVsaEURwgA4HtT9x9TUcf3KfUGh//9k=";
+
+ return (
+ <MenuItemMultiSelectAvatar
+ avatar={<img src={imageUrl} alt="Avatar" />}
+ text="First Option"
+ selected={false}
+ className
+ />
+ );
+};
+```
+
+</Tab>
+<Tab title="프로퍼티">
+
+
+| 프로퍼티 | 유형 | 설명 |
+| ------- | ----------- | --------------------------- |
+| 아바타 | `ReactNode` | 메뉴 항목의 왼쪽에 표시될 아바타 또는 아이콘 |
+| 텍스트 | 문자열 | 메뉴 항목의 텍스트 콘텐츠 |
+| 선택됨 | 부울 | 메뉴 항목이 선택(체크)되었는지 여부를 나타냅니다 |
+| 선택 변경 시 | 함수 | 체크박스 상태가 변경되었을 때 호출되는 콜백 함수 |
+| 클래스 네임 | 문자열 | 추가 스타일링을 위한 선택적 이름 |
+
+
+
+
+</Tab>
</Tabs>
### 탐색
@@ -220,36 +256,43 @@ title: 메뉴 항목
왼쪽에 선택적 아이콘, 텍스트 콘텐츠 및 오른쪽 화살표 아이콘을 포함한 메뉴 항목
<Tabs>
- <Tab title="사용법">
- ```jsx
- import { IconBell } from "@tabler/icons-react";
- import { MenuItemNavigate } from "twenty-ui/display";
-
- export const MyComponent = () => {
- const handleNavigation = () => {
- console.log("Navigate to another page");
- };
-
- return (
- <MenuItemNavigate
- LeftIcon={IconBell}
- text="First Option"
- onClick={handleNavigation}
- className
- />
- );
- };
- ```
- </Tab>
-
- <Tab title="프로퍼티">
- | 프로퍼티 | 유형 | 설명 |
- | ------- | -------- | ----------------------------- |
- | 왼쪽 아이콘 | 아이콘 컴포넌트 | 메뉴 항목의 텍스트 앞에 표시되는 선택적 왼쪽 아이콘 |
- | 텍스트 | 문자열 | 메뉴 항목의 텍스트 콘텐츠 |
- | onClick | 함수 | 메뉴 항목을 클릭할 때 트리거되는 콜백 함수 |
- | 클래스 네임 | 문자열 | 추가 스타일링을 위한 선택적 이름 |
- </Tab>
+<Tab title="사용법">
+
+```jsx
+import { IconBell } from "@tabler/icons-react";
+import { MenuItemNavigate } from "twenty-ui/display";
+
+export const MyComponent = () => {
+ const handleNavigation = () => {
+ console.log("Navigate to another page");
+ };
+
+ return (
+ <MenuItemNavigate
+ LeftIcon={IconBell}
+ text="First Option"
+ onClick={handleNavigation}
+ className
+ />
+ );
+};
+```
+
+</Tab>
+<Tab title="프로퍼티">
+
+
+| 프로퍼티 | 유형 | 설명 |
+| ------- | -------- | ----------------------------- |
+| 왼쪽 아이콘 | 아이콘 컴포넌트 | 메뉴 항목의 텍스트 앞에 표시되는 선택적 왼쪽 아이콘 |
+| 텍스트 | 문자열 | 메뉴 항목의 텍스트 콘텐츠 |
+| onClick | 함수 | 메뉴 항목을 클릭할 때 트리거되는 콜백 함수 |
+| 클래스 네임 | 문자열 | 추가 스타일링을 위한 선택적 이름 |
+
+
+
+
+</Tab>
</Tabs>
### 선택
@@ -257,42 +300,49 @@ title: 메뉴 항목
선택적 왼쪽 콘텐츠(아이콘 및 텍스트)와 상태 표시기(체크 아이콘)를 포함한 선택 가능한 메뉴 항목
<Tabs>
- <Tab title="사용법">
- ```jsx
- import { IconBell } from "@tabler/icons-react";
- import { MenuItemSelect } from "twenty-ui/display";
-
- export const MyComponent = () => {
- const handleSelection = () => {
- console.log("Menu item selected");
- };
-
- return (
- <MenuItemSelect
- LeftIcon={IconBell}
- text="First Option"
- selected={true}
- disabled={false}
- hovered={false}
- onClick={handleSelection}
- className
- />
- );
- };
- ```
- </Tab>
-
- <Tab title="프로퍼티">
- | 프로퍼티 | 유형 | 설명 |
- | -------- | -------- | ------------------------------- |
- | 왼쪽 아이콘 | 아이콘 컴포넌트 | 메뉴 항목의 텍스트 앞에 표시되는 선택적 왼쪽 아이콘 |
- | 텍스트 | 문자열 | 메뉴 항목의 텍스트 콘텐츠 |
- | 선택됨 | 부울 | 메뉴 항목이 선택(체크)되었는지 여부를 나타냅니다 |
- | disabled | 부울 | 메뉴 항목이 비활성화 되었는지 여부를 나타냅니다 |
- | 호버됨 | 부울 | 메뉴 항목이 현재 마우스 오버 상태인지 여부를 나타냅니다 |
- | onClick | 함수 | 메뉴 항목을 클릭할 때 트리거되는 콜백 함수 |
- | 클래스 네임 | 문자열 | 추가 스타일링을 위한 선택적 이름 |
- </Tab>
+<Tab title="사용법">
+
+```jsx
+import { IconBell } from "@tabler/icons-react";
+import { MenuItemSelect } from "twenty-ui/display";
+
+export const MyComponent = () => {
+ const handleSelection = () => {
+ console.log("Menu item selected");
+ };
+
+ return (
+ <MenuItemSelect
+ LeftIcon={IconBell}
+ text="First Option"
+ selected={true}
+ disabled={false}
+ hovered={false}
+ onClick={handleSelection}
+ className
+ />
+ );
+};
+```
+
+</Tab>
+<Tab title="프로퍼티">
+
+
+| 프로퍼티 | 유형 | 설명 |
+| -------- | -------- | ------------------------------- |
+| 왼쪽 아이콘 | 아이콘 컴포넌트 | 메뉴 항목의 텍스트 앞에 표시되는 선택적 왼쪽 아이콘 |
+| 텍스트 | 문자열 | 메뉴 항목의 텍스트 콘텐츠 |
+| 선택됨 | 부울 | 메뉴 항목이 선택(체크)되었는지 여부를 나타냅니다 |
+| disabled | 부울 | 메뉴 항목이 비활성화 되었는지 여부를 나타냅니다 |
+| 호버됨 | 부울 | 메뉴 항목이 현재 마우스 오버 상태인지 여부를 나타냅니다 |
+| onClick | 함수 | 메뉴 항목을 클릭할 때 트리거되는 콜백 함수 |
+| 클래스 네임 | 문자열 | 추가 스타일링을 위한 선택적 이름 |
+
+
+
+
+</Tab>
</Tabs>
### 선택 아바타
@@ -300,47 +350,54 @@ title: 메뉴 항목
아바타가 있는 선택 가능한 메뉴 항목으로, 선택적 왼쪽 콘텐츠(아바타 및 텍스트)와 선택 상태 표시기(체크 아이콘)를 포함합니다.
<Tabs>
- <Tab title="사용법">
- ```jsx
- import { MenuItemSelectAvatar } from "twenty-ui/display";
-
- export const MyComponent = () => {
- const imageUrl =
- "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAYABgAAD/4QCMRXhpZgAATU0AKgAAAAgABQESAAMAAAABAAEAAAEaAAUAAAABAAAASgEbAAUAAAABAAAAUgEoAAMAAAABAAIAAIdpAAQAAAABAAAAWgAAAAAAAABgAAAAAQAAAGAAAAABAAOgAQADAAAAAQABAACgAgAEAAAAAQAAABSgAwAEAAAAAQAAABQAAAAA/8AAEQgAFAAUAwEiAAIRAQMRAf/EAB8AAAEFAQEBAQEBAAAAAAAAAAABAgMEBQYHCAkKC//EALUQAAIBAwMCBAMFBQQEAAABfQECAwAEEQUSITFBBhNRYQcicRQygZGhCCNCscEVUtHwJDNicoIJChYXGBkaJSYnKCkqNDU2Nzg5OkNERUZHSElKU1RVVldYWVpjZGVmZ2hpanN0dXZ3eHl6g4SFhoeIiYqSk5SVlpeYmZqio6Slpqeoqaqys7S1tre4ubrCw8TFxsfIycrS09TV1tfY2drh4uPk5ebn6Onq8fLz9PX29/j5+v/EAB8BAAMBAQEBAQEBAQEAAAAAAAABAgMEBQYHCAkKC//EALURAAIBAgQEAwQHBQQEAAECdwABAgMRBAUhMQYSQVEHYXETIjKBCBRCkaGxwQkjM1LwFWJy0QoWJDThJfEXGBkaJicoKSo1Njc4OTpDREVGR0hJSlNUVVZXWFlaY2RlZmdoaWpzdHV2d3h5eoKDhIWGh4iJipKTlJWWl5iZmqKjpKWmp6ipqrKztLW2t7i5usLDxMXGx8jJytLT1NXW19jZ2uLj5OXm5+jp6vLz9PX29/j5+v/bAEMACwgICggHCwoJCg0MCw0RHBIRDw8RIhkaFBwpJCsqKCQnJy0yQDctMD0wJyc4TDk9Q0VISUgrNk9VTkZUQEdIRf/bAEMBDA0NEQ8RIRISIUUuJy5FRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRf/dAAQAAv/aAAwDAQACEQMRAD8Ava1q728otYY98joSCTgZrnbXWdTtrhrfVZXWLafmcAEkdgR/hVltQku9Q8+OIEBcGOT+ID0PY1ka1KH2u8ToqnPLbmIqG7u6LtbQ7RXBRec4Uck9eKXcPWsKDWVnhWSL5kYcFelSf2m3901POh8jP//QoyIAnTuKpXsY82NsksUyWPU5q/L9z8RVK++/F/uCsVsaEURwgA4HtT9x9TUcf3KfUGh//9k=";
-
- const handleSelection = () => {
- console.log("Menu item selected");
- };
-
- return (
- <MenuItemSelectAvatar
- avatar={<img src={imageUrl} alt="Avatar" />}
- text="First Option"
- selected={true}
- disabled={false}
- hovered={false}
- testId="menu-item-test"
- onClick={handleSelection}
- className
- />
- );
- };
-
- ```
- </Tab>
-
- <Tab title="프로퍼티">
- | 프로퍼티 | 유형 | 설명 |
- | -------- | ----------- | ------------------------------- |
- | 아바타 | `ReactNode` | 메뉴 항목의 왼쪽에 표시될 아바타 또는 아이콘 |
- | 텍스트 | 문자열 | 메뉴 항목의 텍스트 콘텐츠 |
- | 선택됨 | 부울 | 메뉴 항목이 선택(체크)되었는지 여부를 나타냅니다 |
- | disabled | 부울 | 메뉴 항목이 비활성화 되었는지 여부를 나타냅니다 |
- | 호버됨 | 부울 | 메뉴 항목이 현재 마우스 오버 상태인지 여부를 나타냅니다 |
- | 테스트ID | 문자열 | 테스트 목적의 데이터-testid 속성 |
- | onClick | 함수 | 메뉴 항목을 클릭할 때 트리거되는 콜백 함수 |
- | 클래스 네임 | 문자열 | 추가 스타일링을 위한 선택적 이름 |
- </Tab>
+<Tab title="사용법">
+
+```jsx
+import { MenuItemSelectAvatar } from "twenty-ui/display";
+
+export const MyComponent = () => {
+ const imageUrl =
+ "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAYABgAAD/4QCMRXhpZgAATU0AKgAAAAgABQESAAMAAAABAAEAAAEaAAUAAAABAAAASgEbAAUAAAABAAAAUgEoAAMAAAABAAIAAIdpAAQAAAABAAAAWgAAAAAAAABgAAAAAQAAAGAAAAABAAOgAQADAAAAAQABAACgAgAEAAAAAQAAABSgAwAEAAAAAQAAABQAAAAA/8AAEQgAFAAUAwEiAAIRAQMRAf/EAB8AAAEFAQEBAQEBAAAAAAAAAAABAgMEBQYHCAkKC//EALUQAAIBAwMCBAMFBQQEAAABfQECAwAEEQUSITFBBhNRYQcicRQygZGhCCNCscEVUtHwJDNicoIJChYXGBkaJSYnKCkqNDU2Nzg5OkNERUZHSElKU1RVVldYWVpjZGVmZ2hpanN0dXZ3eHl6g4SFhoeIiYqSk5SVlpeYmZqio6Slpqeoqaqys7S1tre4ubrCw8TFxsfIycrS09TV1tfY2drh4uPk5ebn6Onq8fLz9PX29/j5+v/EAB8BAAMBAQEBAQEBAQEAAAAAAAABAgMEBQYHCAkKC//EALURAAIBAgQEAwQHBQQEAAECdwABAgMRBAUhMQYSQVEHYXETIjKBCBRCkaGxwQkjM1LwFWJy0QoWJDThJfEXGBkaJicoKSo1Njc4OTpDREVGR0hJSlNUVVZXWFlaY2RlZmdoaWpzdHV2d3h5eoKDhIWGh4iJipKTlJWWl5iZmqKjpKWmp6ipqrKztLW2t7i5usLDxMXGx8jJytLT1NXW19jZ2uLj5OXm5+jp6vLz9PX29/j5+v/bAEMACwgICggHCwoJCg0MCw0RHBIRDw8RIhkaFBwpJCsqKCQnJy0yQDctMD0wJyc4TDk9Q0VISUgrNk9VTkZUQEdIRf/bAEMBDA0NEQ8RIRISIUUuJy5FRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRf/dAAQAAv/aAAwDAQACEQMRAD8Ava1q728otYY98joSCTgZrnbXWdTtrhrfVZXWLafmcAEkdgR/hVltQku9Q8+OIEBcGOT+ID0PY1ka1KH2u8ToqnPLbmIqG7u6LtbQ7RXBRec4Uck9eKXcPWsKDWVnhWSL5kYcFelSf2m3901POh8jP//QoyIAnTuKpXsY82NsksUyWPU5q/L9z8RVK++/F/uCsVsaEURwgA4HtT9x9TUcf3KfUGh//9k=";
+
+ const handleSelection = () => {
+ console.log("Menu item selected");
+ };
+
+ return (
+ <MenuItemSelectAvatar
+ avatar={<img src={imageUrl} alt="Avatar" />}
+ text="First Option"
+ selected={true}
+ disabled={false}
+ hovered={false}
+ testId="menu-item-test"
+ onClick={handleSelection}
+ className
+ />
+ );
+};
+
+```
+
+</Tab>
+<Tab title="프로퍼티">
+
+
+| 프로퍼티 | 유형 | 설명 |
+| -------- | ----------- | ------------------------------- |
+| 아바타 | `ReactNode` | 메뉴 항목의 왼쪽에 표시될 아바타 또는 아이콘 |
+| 텍스트 | 문자열 | 메뉴 항목의 텍스트 콘텐츠 |
+| 선택됨 | 부울 | 메뉴 항목이 선택(체크)되었는지 여부를 나타냅니다 |
+| disabled | 부울 | 메뉴 항목이 비활성화 되었는지 여부를 나타냅니다 |
+| 호버됨 | 부울 | 메뉴 항목이 현재 마우스 오버 상태인지 여부를 나타냅니다 |
+| 테스트ID | 문자열 | 테스트 목적의 데이터-testid 속성 |
+| onClick | 함수 | 메뉴 항목을 클릭할 때 트리거되는 콜백 함수 |
+| 클래스 네임 | 문자열 | 추가 스타일링을 위한 선택적 이름 |
+
+
+
+
+</Tab>
</Tabs>
### 색상 선택
@@ -348,41 +405,48 @@ title: 메뉴 항목
사용자가 메뉴에서 색상을 선택하도록 하는 시나리오를 위한 색상 샘플이 있는 선택 가능한 메뉴 항목.
<Tabs>
- <Tab title="사용법">
- ```jsx
- import { MenuItemSelectColor } from "twenty-ui/display";
-
- export const MyComponent = () => {
- const handleSelection = () => {
- console.log("Menu item selected");
- };
-
- return (
- <MenuItemSelectColor
- color="green"
- selected={true}
- disabled={false}
- hovered={true}
- variant="default"
- onClick={handleSelection}
- className
- />
- );
- };
- ```
- </Tab>
-
- <Tab title="프로퍼티">
- | 프로퍼티 | 유형 | 설명 |
- | -------- | --- | ------------------------------------------------------------------------------------------------------------------------------ |
- | 색상 | 문자열 | 메뉴 항목에 샘플로 표시할 테마 색상입니다. 옵션에는 `green`, `turquoise`, `sky`, `blue`, `purple`, `pink`, `red`, `orange`, `yellow`, `gray`가 포함됩니다. |
- | 선택됨 | 부울 | 메뉴 항목이 선택(체크)되었는지를 나타냅니다. |
- | disabled | 부울 | 메뉴 항목이 비활성화되었는지를 나타냅니다. |
- | 호버됨 | 부울 | 메뉴 항목에 현재 커서가 오버되어 있는지를 나타냅니다. |
- | 변형 | 문자열 | 색상 샘플의 변형입니다. `default` 또는 `pipeline` 중 하나일 수 있습니다. |
- | 클릭 시 | 함수 | 메뉴 항목을 클릭할 때 트리거되는 콜백 함수 |
- | 클래스 네임 | 문자열 | 추가 스타일링을 위한 선택적 이름 |
- </Tab>
+<Tab title="사용법">
+
+```jsx
+import { MenuItemSelectColor } from "twenty-ui/display";
+
+export const MyComponent = () => {
+ const handleSelection = () => {
+ console.log("Menu item selected");
+ };
+
+ return (
+ <MenuItemSelectColor
+ color="green"
+ selected={true}
+ disabled={false}
+ hovered={true}
+ variant="default"
+ onClick={handleSelection}
+ className
+ />
+ );
+};
+```
+
+</Tab>
+<Tab title="프로퍼티">
+
+
+| 프로퍼티 | 유형 | 설명 |
+| -------- | --- | ------------------------------------------------------------------------------------------------------------------------------ |
+| 색상 | 문자열 | 메뉴 항목에 샘플로 표시할 테마 색상입니다. 옵션에는 `green`, `turquoise`, `sky`, `blue`, `purple`, `pink`, `red`, `orange`, `yellow`, `gray`가 포함됩니다. |
+| 선택됨 | 부울 | 메뉴 항목이 선택(체크)되었는지를 나타냅니다. |
+| disabled | 부울 | 메뉴 항목이 비활성화되었는지를 나타냅니다. |
+| 호버됨 | 부울 | 메뉴 항목에 현재 커서가 오버되어 있는지를 나타냅니다. |
+| 변형 | 문자열 | 색상 샘플의 변형입니다. `default` 또는 `pipeline` 중 하나일 수 있습니다. |
+| 클릭 시 | 함수 | 메뉴 항목을 클릭할 때 트리거되는 콜백 함수 |
+| 클래스 네임 | 문자열 | 추가 스타일링을 위한 선택적 이름 |
+
+
+
+
+</Tab>
</Tabs>
### 전환
@@ -390,35 +454,42 @@ title: 메뉴 항목
사용자가 특정 기능을 활성화하거나 비활성화할 수 있도록 전환 스위치가 있는 메뉴 항목
<Tabs>
- <Tab title="사용법">
- ```jsx
- import { IconBell } from '@tabler/icons-react';
-
- import { MenuItemToggle } from 'twenty-ui/display';
-
- export const MyComponent = () => {
-
- return (
- <MenuItemToggle
- LeftIcon={IconBell}
- text="First Option"
- toggled={true}
- toggleSize="small"
- className
- />
- );
- };
- ```
- </Tab>
-
- <Tab title="프로퍼티">
- | 프로퍼티 | 유형 | 설명 |
- | -------------- | -------- | ------------------------------------- |
- | 왼쪽 아이콘 | 아이콘 컴포넌트 | 메뉴 항목의 텍스트 앞에 표시되는 선택적 왼쪽 아이콘 |
- | 텍스트 | 문자열 | 메뉴 항목의 텍스트 콘텐츠 |
- | 토글됨 | 부울 | 전환 스위치가 "켬"인지 "끔"인지 상태를 나타냅니다. |
- | onToggleChange | 함수 | 토글 스위치 상태가 변경될 때 트리거되는 콜백 함수 |
- | 토글 크기 | 문자열 | 토글 스위치의 크기입니다. 다음 두 가지 중 하나일 수 있습니다 \ |
- | 클래스 네임 | 문자열 | 추가 스타일링을 위한 선택적 이름 |
- </Tab>
+<Tab title="사용법">
+
+```jsx
+import { IconBell } from '@tabler/icons-react';
+
+import { MenuItemToggle } from 'twenty-ui/display';
+
+export const MyComponent = () => {
+
+ return (
+ <MenuItemToggle
+ LeftIcon={IconBell}
+ text="First Option"
+ toggled={true}
+ toggleSize="small"
+ className
+ />
+ );
+};
+```
+
+</Tab>
+<Tab title="프로퍼티">
+
+
+| 프로퍼티 | 유형 | 설명 |
+| -------------- | -------- | ------------------------------------- |
+| 왼쪽 아이콘 | 아이콘 컴포넌트 | 메뉴 항목의 텍스트 앞에 표시되는 선택적 왼쪽 아이콘 |
+| 텍스트 | 문자열 | 메뉴 항목의 텍스트 콘텐츠 |
+| 토글됨 | 부울 | 전환 스위치가 "켬"인지 "끔"인지 상태를 나타냅니다. |
+| onToggleChange | 함수 | 토글 스위치 상태가 변경될 때 트리거되는 콜백 함수 |
+| 토글 크기 | 문자열 | 토글 스위치의 크기입니다. 다음 두 가지 중 하나일 수 있습니다 \ |
+| 클래스 네임 | 문자열 | 추가 스타일링을 위한 선택적 이름 |
+
+
+
+
+</Tab>
</Tabs>
diff --git a/packages/twenty-docs/l/ko/twenty-ui/navigation/navigation-bar.mdx b/packages/twenty-docs/l/ko/twenty-ui/navigation/navigation-bar.mdx
index 180f20a867e..eb1e8484fa7 100644
--- a/packages/twenty-docs/l/ko/twenty-ui/navigation/navigation-bar.mdx
+++ b/packages/twenty-docs/l/ko/twenty-ui/navigation/navigation-bar.mdx
@@ -1,45 +1,52 @@
---
title: 내비게이션 바
+icon: bars
---
-
여러 `NavigationBarItem` 구성 요소를 포함하는 탐색 막대를 렌더링합니다.
<Tabs>
- <Tab title="사용법">
- ```jsx
- import { IconHome, IconUser, IconSettings } from '@tabler/icons-react';
- import { NavigationBar } from "@/ui/navigation/navigation-bar/components/NavigationBar";
-
- export const MyComponent = () => {
-
- const navigationItems = [
- {
- name: "Home",
- Icon: IconHome,
- onClick: () => console.log("Home clicked"),
- },
- {
- name: "Profile",
- Icon: IconUser,
- onClick: () => console.log("Profile clicked"),
- },
- {
- name: "Settings",
- Icon: IconSettings,
- onClick: () => console.log("Settings clicked"),
- },
- ];
-
- return <NavigationBar activeItemName="Home" items={navigationItems}/>;
- };
- ```
- </Tab>
-
- <Tab title="프로퍼티">
- | 프로퍼티 | 유형 | 설명 |
- | -------------- | --- | ------------------------------------------------------------------------------------------------- |
- | activeItemName | 문자열 | 현재 활성화된 탐색 항목의 이름 |
- | 항목 | 배열 | 각 탐색 항목을 나타내는 객체 배열입니다. 각 객체에는 항목의 `name`, 표시할 `Icon` 구성 요소 및 항목이 클릭될 때 호출되는 `onClick` 함수가 포함됩니다. |
- </Tab>
+<Tab title="사용법">
+
+```jsx
+import { IconHome, IconUser, IconSettings } from '@tabler/icons-react';
+import { NavigationBar } from "@/ui/navigation/navigation-bar/components/NavigationBar";
+
+export const MyComponent = () => {
+
+ const navigationItems = [
+ {
+ name: "Home",
+ Icon: IconHome,
+ onClick: () => console.log("Home clicked"),
+ },
+ {
+ name: "Profile",
+ Icon: IconUser,
+ onClick: () => console.log("Profile clicked"),
+ },
+ {
+ name: "Settings",
+ Icon: IconSettings,
+ onClick: () => console.log("Settings clicked"),
+ },
+ ];
+
+ return <NavigationBar activeItemName="Home" items={navigationItems}/>;
+};
+```
+
+</Tab>
+<Tab title="프로퍼티">
+
+
+| 프로퍼티 | 유형 | 설명 |
+| -------------- | --- | ------------------------------------------------------------------------------------------------- |
+| activeItemName | 문자열 | 현재 활성화된 탐색 항목의 이름 |
+| 항목 | 배열 | 각 탐색 항목을 나타내는 객체 배열입니다. 각 객체에는 항목의 `name`, 표시할 `Icon` 구성 요소 및 항목이 클릭될 때 호출되는 `onClick` 함수가 포함됩니다. |
+
+
+
+
+</Tab>
</Tabs>
diff --git a/packages/twenty-docs/l/ko/twenty-ui/navigation/step-bar.mdx b/packages/twenty-docs/l/ko/twenty-ui/navigation/step-bar.mdx
index 3a354767fb6..dd68e593f80 100644
--- a/packages/twenty-docs/l/ko/twenty-ui/navigation/step-bar.mdx
+++ b/packages/twenty-docs/l/ko/twenty-ui/navigation/step-bar.mdx
@@ -9,25 +9,33 @@ title: 단계 막대
활성 단계가 강조 표시되어 있는 다단계 진행 상황을 표시합니다. 각각의 `Step` 구성 요소로 표현되는 단계를 포함하는 컨테이너를 렌더링합니다.
<Tabs>
- <Tab title="사용법">
- ```jsx
- import { StepBar } from "@/ui/navigation/step-bar/components/StepBar";
-
- export const MyComponent = () => {
- return (
- <StepBar activeStep={2}>
- <StepBar.Step>Step 1</StepBar.Step>
- <StepBar.Step>Step 2</StepBar.Step>
- <StepBar.Step>Step 3</StepBar.Step>
- </StepBar>
- );
- };
- ```
- </Tab>
-
- <Tab title="프로퍼티">
- | 프로퍼티 | 유형 | 설명 |
- | ---------- | -- | --------------------------------------------------- |
- | activeStep | 숫자 | 현재 활성 단계의 인덱스입니다. 어느 단계가 시각적으로 강조 표시되어야 하는지를 결정합니다. |
- </Tab>
+<Tab title="사용법">
+
+```jsx
+import { StepBar } from "@/ui/navigation/step-bar/components/StepBar";
+
+export const MyComponent = () => {
+ return (
+ <StepBar activeStep={2}>
+ <StepBar.Step>Step 1</StepBar.Step>
+ <StepBar.Step>Step 2</StepBar.Step>
+ <StepBar.Step>Step 3</StepBar.Step>
+ </StepBar>
+ );
+};
+```
+
+</Tab>
+
+<Tab title="프로퍼티">
+
+
+| 프로퍼티 | 유형 | 설명 |
+| ---------- | -- | --------------------------------------------------- |
+| activeStep | 숫자 | 현재 활성 단계의 인덱스입니다. 어느 단계가 시각적으로 강조 표시되어야 하는지를 결정합니다. |
+
+
+
+
+</Tab>
</Tabs>
diff --git a/packages/twenty-docs/l/ko/twenty-ui/progress-bar.mdx b/packages/twenty-docs/l/ko/twenty-ui/progress-bar.mdx
index 8f4a719f68e..d3485ada026 100644
--- a/packages/twenty-docs/l/ko/twenty-ui/progress-bar.mdx
+++ b/packages/twenty-docs/l/ko/twenty-ui/progress-bar.mdx
@@ -2,39 +2,46 @@
title: 피드백
---
-
진행 또는 카운트다운을 나타내며 오른쪽에서 왼쪽으로 이동합니다.
<Tabs>
- <Tab title="사용법">
- ```jsx
- import { ProgressBar } from "twenty-ui/feedback";
-
- export const MyComponent = () => {
- return (
- <ProgressBar
- duration={6000}
- delay={0}
- easing="easeInOut"
- barHeight={10}
- barColor="#4bb543"
- autoStart={true}
- />
- );
- };
- ```
- </Tab>
-
- <Tab title="프로퍼티">
- | 프로퍼티 | 유형 | 설명 | 기본값 |
- | --------- | --- | ------------------------------------------------ | --------- |
- | 지속 시간 | 숫자 | 진행 표시줄 애니메이션의 전체 지속시간 (밀리초 단위) | 3 |
- | 지연 | 숫자 | 진행 표시줄 애니메이션 시작 지연 시간 (밀리초 단위) | 0 |
- | 이징 | 문자열 | 진행 표시줄 애니메이션을 위한 이징 함수 | easeInOut |
- | barHeight | 숫자 | 바의 높이 (픽셀 단위) | 24 |
- | barColor | 문자열 | 바의 색상 | gray80 |
- | autoStart | 부울 | `true`이면, 컴포넌트가 마운트될 때 진행 표시줄 애니메이션이 자동으로 시작됩니다. | `참` |
- </Tab>
+
+<Tab title="사용법">
+
+```jsx
+import { ProgressBar } from "twenty-ui/feedback";
+
+export const MyComponent = () => {
+ return (
+ <ProgressBar
+ duration={6000}
+ delay={0}
+ easing="easeInOut"
+ barHeight={10}
+ barColor="#4bb543"
+ autoStart={true}
+ />
+ );
+};
+```
+
+</Tab>
+
+<Tab title="프로퍼티">
+
+
+| 프로퍼티 | 유형 | 설명 | 기본값 |
+| --------- | --- | ------------------------------------------------ | --------- |
+| 지속 시간 | 숫자 | 진행 표시줄 애니메이션의 전체 지속시간 (밀리초 단위) | 3 |
+| 지연 | 숫자 | 진행 표시줄 애니메이션 시작 지연 시간 (밀리초 단위) | 0 |
+| 이징 | 문자열 | 진행 표시줄 애니메이션을 위한 이징 함수 | easeInOut |
+| barHeight | 숫자 | 바의 높이 (픽셀 단위) | 24 |
+| barColor | 문자열 | 바의 색상 | gray80 |
+| autoStart | 부울 | `true`이면, 컴포넌트가 마운트될 때 진행 표시줄 애니메이션이 자동으로 시작됩니다. | `참` |
+
+
+
+</Tab>
</Tabs>
## 원형 진행 표시줄
@@ -42,21 +49,30 @@ title: 피드백
작업의 진행 상황을 나타내며, 로딩 화면이나 진행 중인 프로세스를 사용자에게 전달하고자 할 때 자주 사용됩니다.
<Tabs>
- <Tab title="사용법">
- ```jsx
- import { CircularProgressBar } from "@/ui/feedback/progress-bar/components/CircularProgressBar";
-
- export const MyComponent = () => {
- return <CircularProgressBar size={80} barWidth={6} barColor="green" />;
- };
- ```
- </Tab>
-
- <Tab title="프로퍼티">
- | 프로퍼티 | 유형 | 설명 | 기본값 |
- | -------- | --- | ------------- | ------------ |
- | 크기 | 숫자 | 원형 진행 표시줄의 크기 | 50 |
- | barWidth | 숫자 | 진행 표시줄 선의 너비 | 5 |
- | barColor | 문자열 | 진행 표시줄의 색상 | currentColor |
- </Tab>
+
+<Tab title="사용법">
+
+```jsx
+import { CircularProgressBar } from "@/ui/feedback/progress-bar/components/CircularProgressBar";
+
+export const MyComponent = () => {
+ return <CircularProgressBar size={80} barWidth={6} barColor="green" />;
+};
+```
+
+</Tab>
+
+<Tab title="프로퍼티">
+
+
+| 프로퍼티 | 유형 | 설명 | 기본값 |
+| -------- | --- | ------------- | ------------ |
+| 크기 | 숫자 | 원형 진행 표시줄의 크기 | 50 |
+| barWidth | 숫자 | 진행 표시줄 선의 너비 | 5 |
+| barColor | 문자열 | 진행 표시줄의 색상 | currentColor |
+
+
+
+</Tab>
+
</Tabs>
diff --git a/packages/twenty-docs/l/ko/user-guide/ai/capabilities/ai-agents.mdx b/packages/twenty-docs/l/ko/user-guide/ai/capabilities/ai-agents.mdx
index cd30dd70cbf..af29a347d46 100644
--- a/packages/twenty-docs/l/ko/user-guide/ai/capabilities/ai-agents.mdx
+++ b/packages/twenty-docs/l/ko/user-guide/ai/capabilities/ai-agents.mdx
@@ -4,7 +4,7 @@ description: 자동화 워크플로우에 AI 기능을 직접 통합합니다.
---
<Note>
- 이 기능은 현재 개발 중이며 곧 베타로 제공될 예정입니다.
+이 기능은 현재 개발 중이며 곧 베타로 제공될 예정입니다.
</Note>
## 개요
diff --git a/packages/twenty-docs/l/ko/user-guide/ai/capabilities/ai-chatbot.mdx b/packages/twenty-docs/l/ko/user-guide/ai/capabilities/ai-chatbot.mdx
index 8740de40704..3bad03e6375 100644
--- a/packages/twenty-docs/l/ko/user-guide/ai/capabilities/ai-chatbot.mdx
+++ b/packages/twenty-docs/l/ko/user-guide/ai/capabilities/ai-chatbot.mdx
@@ -4,7 +4,7 @@ description: 자연어로 CRM 데이터와 상호작용할 수 있도록 도와
---
<Note>
- 이 기능은 현재 개발 중이며 곧 베타로 제공될 예정입니다.
+이 기능은 현재 개발 중이며 곧 베타로 제공될 예정입니다.
</Note>
## 개요
diff --git a/packages/twenty-docs/l/ko/user-guide/ai/capabilities/mcp.mdx b/packages/twenty-docs/l/ko/user-guide/ai/capabilities/mcp.mdx
new file mode 100644
index 00000000000..b70a5fea599
--- /dev/null
+++ b/packages/twenty-docs/l/ko/user-guide/ai/capabilities/mcp.mdx
@@ -0,0 +1,141 @@
+---
+title: MCP 서버
+description: Model Context Protocol을 사용하여 AI 어시스턴트를 Twenty 워크스페이스에 연결하세요.
+---
+
+<Warning>
+MCP는 현재 **알파** 단계이며 일부 워크스페이스에서만 사용할 수 있습니다. 아직 귀하의 워크스페이스에서 활성화되지 않았을 수 있습니다.
+</Warning>
+
+Twenty는 Claude Desktop, Claude Code, Cursor, ChatGPT 등 AI 어시스턴트가 자연어로 CRM 데이터를 읽고 쓸 수 있도록 [MCP](https://modelcontextprotocol.io/) 서버를 제공합니다.
+
+MCP 엔드포인트로 **워크스페이스 URL**(Twenty에 접속할 때 사용하는 URL)을 사용하세요. Twenty Cloud에서는 워크스페이스 URL이 `https://{mycompany}.twenty.com` 또는 커스텀 도메인일 수 있습니다. 서버는 다음 위치에서 사용할 수 있습니다:
+
+| 환경 | MCP 엔드포인트 |
+| ---------- | -------------------------------------------------------------------------- |
+| **클라우드** | `https://{your-workspace-url}/mcp` (예: `https://mycompany.twenty.com/mcp`) |
+| **셀프 호스팅** | `https://{your-domain}/mcp` |
+
+## 인증 방법
+
+MCP 클라이언트를 인증하는 방법은 두 가지입니다: **OAuth**(권장) 또는 **API Key**.
+
+### 옵션 A — OAuth(권장)
+
+OAuth를 사용하면 MCP 클라이언트가 로그인할 수 있도록 브라우저 창을 엽니다. 비밀 값이 구성 파일에 저장되지 않으며, 토큰은 자동으로 갱신됩니다.
+
+<Note>
+OAuth를 사용하려면 [MCP Authorization 사양](https://modelcontextprotocol.io/specification/2025-03-26/basic/authorization)을 지원하는 MCP 클라이언트가 필요합니다. Claude Desktop, Claude Code, Cursor, ChatGPT가 이를 지원합니다.
+</Note>
+
+다음을 MCP 클라이언트 구성에 추가하고 `{your-workspace-url}`를 워크스페이스 호스트로 바꾸세요(예: `mycompany.twenty.com`):
+
+```json
+{
+ "mcpServers": {
+ "twenty": {
+ "type": "streamable-http",
+ "url": "https://{your-workspace-url}/mcp"
+ }
+ }
+}
+```
+
+이것으로 완료입니다 — API 키는 필요하지 않습니다. 클라이언트가 처음 연결되면 다음을 수행합니다:
+
+1. `/.well-known/oauth-protected-resource` 및 `/.well-known/oauth-authorization-server`를 통해 Twenty의 OAuth 메타데이터를 발견합니다
+2. 동적 클라이언트 등록(RFC 7591)을 통해 OAuth 클라이언트로 등록합니다
+3. 액세스 권한 부여를 위해 브라우저를 엽니다
+4. 토큰을 수신하고 MCP 서버에 연결합니다
+
+이후 연결에서는 저장된 토큰을 재사용하고 자동으로 갱신합니다.
+
+### 옵션 B — API Key
+
+MCP 클라이언트가 OAuth를 지원하지 않거나 정적 자격 증명을 선호하는 경우, `Authorization` 헤더에 API 키를 전달하세요:
+
+```json
+{
+ "mcpServers": {
+ "twenty": {
+ "type": "streamable-http",
+ "url": "https://{your-workspace-url}/mcp",
+ "headers": {
+ "Authorization": "Bearer YOUR_API_KEY"
+ }
+ }
+ }
+}
+```
+
+<Warning>
+API 키는 워크스페이스 데이터에 대한 액세스를 부여합니다. 버전 관리와 공유 도트파일에 포함하지 마세요.
+</Warning>
+
+API 키를 생성하려면 **Settings > APIs & Webhooks > + Create key**로 이동하세요. 자세한 내용은 [API](/l/ko/developers/extend/api#create-an-api-key)를 참조하세요.
+
+## 빠른 시작
+
+### 1. 구성 복사
+
+Twenty에서 **Settings > AI > More > MCP Server**로 이동하세요. 인증 방법(OAuth 또는 API Key)을 선택하고, JSON 스니펫(이미 워크스페이스 URL이 포함되어 있습니다)을 복사하여 MCP 클라이언트의 구성 파일에 붙여넣으세요.
+
+| 클라이언트 | 구성 파일 위치 |
+| ------------------ | -------------------------------------------------------------------------------------------------------------------------------------------- |
+| **Claude Desktop** | `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) 또는 `%APPDATA%\Claude\claude_desktop_config.json` (Windows) |
+| **Claude Code** | `~/.claude.json` (사용자) 또는 `.mcp.json` (프로젝트) |
+| **Cursor** | 프로젝트의 `.cursor/mcp.json`, 또는 전역 `~/.cursor/mcp.json` |
+| **ChatGPT** | **Settings > Apps & Connectors > Advanced settings**에서 Developer Mode를 켠 다음, **Settings > Apps & Connectors**의 **Create**를 사용해 MCP 서버를 추가하세요 |
+
+### 2. 연결
+
+MCP 클라이언트를 다시 시작하세요(또는 구성을 다시 로드하세요). OAuth를 사용 중이라면 액세스 권한 부여를 위해 Twenty로 리디렉션됩니다. API 키를 사용하는 경우 즉시 연결됩니다.
+
+### 3. 사용 시작하기
+
+AI 어시스턴트에게 CRM과 상호작용하도록 요청하세요:
+
+* *"가장 최근에 생성된 회사 5개를 보여줘"*
+* *"Acme Corp에 Jane Doe라는 새 사람을 생성해줘"*
+* *"1만 달러를 초과하는 열려 있는 모든 영업 기회를 찾아줘"*
+
+## 사용 가능한 도구
+
+연결되면 MCP 서버는 Twenty API를 미러링하는 도구들을 제공합니다. 권장 워크플로는 다음과 같습니다:
+
+1. **`learn_tools`** — 특정 도구의 입력 스키마를 가져오기
+2. **`execute_tool`** — 도구 실행
+
+도구 이름을 기억할 필요가 없습니다. AI 어시스턴트에게 무엇을 할 수 있는지 물어보면 `learn_tools`를 자동으로 호출합니다.
+
+## 권한
+
+MCP 연결은 인증된 사용자(OAuth)의 권한 또는 API 키에 할당된 역할을 상속합니다. MCP 서버가 수행할 수 있는 작업을 제한하려면:
+
+* **OAuth**: 사용자의 워크스페이스 역할이 적용됩니다.
+* **API Key**: **Settings > Roles**에서 API 키에 역할을 할당하세요. 자세한 내용은 [권한](/l/ko/user-guide/permissions-access/capabilities/permissions)을 참조하세요.
+
+## 자가 호스팅 구성
+
+자가 호스팅 인스턴스의 경우 `{your-workspace-url}`을 서버 URL로 바꾸세요. 환경의 `SERVER_URL`이 Twenty 인스턴스의 공개 URL과 일치하는지 확인하세요 — 이는 OAuth 디스커버리 메타데이터를 생성하는 데 사용됩니다.
+
+```bash
+SERVER_URL=https://twenty.yourcompany.com
+```
+
+MCP 엔드포인트, OAuth 엔드포인트, 디스커버리 메타데이터는 모두 이 값을 기반으로 생성됩니다.
+
+## 문제 해결
+
+**"Unauthorized" 또는 401 오류**
+
+* OAuth: MCP 클라이언트에 저장된 토큰을 삭제하고 다시 연결하여 재승인하세요.
+* API Key: 키가 유효하며 만료되지 않았는지 확인하세요. 필요하다면 다시 생성하세요.
+
+**OAuth 플로우에서 브라우저가 열리지 않음**
+
+* MCP 클라이언트가 MCP Authorization을 지원하는지 확인하세요. 지원하지 않는 경우 API Key 방식으로 대체하세요.
+
+**연결 시간 초과**
+
+* 로컬 머신에서 MCP 엔드포인트 URL에 접근 가능한지 확인하세요. 자가 호스팅 인스턴스의 경우, 서버가 실행 중인지와 `SERVER_URL`이 올바르게 설정되어 있는지 확인하세요.
diff --git a/packages/twenty-docs/l/ko/user-guide/ai/capabilities/permissions-access-control.mdx b/packages/twenty-docs/l/ko/user-guide/ai/capabilities/permissions-access-control.mdx
index 3000589dc0a..4e4f827ded5 100644
--- a/packages/twenty-docs/l/ko/user-guide/ai/capabilities/permissions-access-control.mdx
+++ b/packages/twenty-docs/l/ko/user-guide/ai/capabilities/permissions-access-control.mdx
@@ -9,7 +9,7 @@ AI 에이전트는 기존 권한 구조를 준수합니다. 이는 워크스페
## AI 에이전트에 역할 할당
-1. **설정 → 역할**로 이동
+1. **설정 → 구성원 → 역할**로 이동하세요
2. 할당할 역할 클릭
3. **배정** 탭 열기
4. **AI Agents**에서 **+ Assign to AI agent**를 클릭합니다
@@ -26,7 +26,7 @@ AI 에이전트는 기존 권한 구조를 준수합니다. 이는 워크스페
| **감사 가능성** | 어떤 에이전트가 어떤 작업을 수행했는지 추적합니다 |
<Note>
- 워크플로 내에서 실행되는 AI 에이전트의 경우, 역할 할당은 워크플로에 더 광범위한 권한이 있더라도 해당 에이전트가 의도된 범위를 벗어난 데이터에 액세스하거나 수정하지 못하도록 보장합니다.
+워크플로 내에서 실행되는 AI 에이전트의 경우, 역할 할당은 워크플로에 더 광범위한 권한이 있더라도 해당 에이전트가 의도된 범위를 벗어난 데이터에 액세스하거나 수정하지 못하도록 보장합니다.
</Note>
## 관련
diff --git a/packages/twenty-docs/l/ko/user-guide/ai/how-tos/ai-faq.mdx b/packages/twenty-docs/l/ko/user-guide/ai/how-tos/ai-faq.mdx
index 06fda314adc..ad575d64151 100644
--- a/packages/twenty-docs/l/ko/user-guide/ai/how-tos/ai-faq.mdx
+++ b/packages/twenty-docs/l/ko/user-guide/ai/how-tos/ai-faq.mdx
@@ -4,6 +4,7 @@ description: Twenty의 AI 기능에 관한 자주 묻는 질문입니다.
---
<AccordionGroup>
+
<Accordion title="AI 기능은 언제 사용할 수 있나요?">
AI 기능은 현재 개발 중이며 곧 베타로 출시될 예정입니다. 업데이트 소식을 계속 지켜봐 주세요!
</Accordion>
@@ -16,7 +17,7 @@ description: Twenty의 AI 기능에 관한 자주 묻는 질문입니다.
</Accordion>
<Accordion title="AI 에이전트가 내 모든 데이터에 액세스할 수 있나요?">
- AI 에이전트는 권한 시스템 하에서 작동합니다. **설정 → 역할**에서 AI 에이전트에 특정 역할을 할당하여, 액세스할 수 있는 데이터와 수행할 수 있는 작업을 완전히 제어할 수 있습니다.
+ AI 에이전트는 권한 시스템 하에서 작동합니다. **Settings → Members → Roles**에서 AI 에이전트에 특정 역할을 할당하여, 액세스할 수 있는 데이터와 수행할 수 있는 작업을 완전히 제어할 수 있습니다.
</Accordion>
<Accordion title="AI 크레딧은 어떻게 작동하나요?">
@@ -26,4 +27,5 @@ description: Twenty의 AI 기능에 관한 자주 묻는 질문입니다.
<Accordion title="내 AI 모델을 사용할 수 있나요?">
초기에는 Twenty가 기본 제공 AI 모델을 사용합니다. 사용자 피드백에 따라 향후 릴리스에서 맞춤형 또는 외부 AI 모델에 대한 지원이 추가될 수 있습니다.
</Accordion>
+
</AccordionGroup>
diff --git a/packages/twenty-docs/l/ko/user-guide/ai/overview.mdx b/packages/twenty-docs/l/ko/user-guide/ai/overview.mdx
index c31f9eecb68..0df72b6789b 100644
--- a/packages/twenty-docs/l/ko/user-guide/ai/overview.mdx
+++ b/packages/twenty-docs/l/ko/user-guide/ai/overview.mdx
@@ -48,7 +48,7 @@ AI 기반 액션과 자율 에이전트로 워크플로우를 확장하세요.
AI 에이전트는 기존 권한 시스템을 통해 관리됩니다:
-1. **설정 → 역할**로 이동
+1. **설정 → 구성원 → 역할**로 이동하세요
2. 각 AI 에이전트가 액세스할 수 있는 데이터를 설정
3. 객체별 읽기/쓰기 권한을 설정
@@ -59,4 +59,4 @@ AI 에이전트는 기존 권한 시스템을 통해 관리됩니다:
AI 기능이 제공되면 이 섹션을 업데이트하겠습니다. 그동안:
* 개발 업데이트를 받아보려면 저희 [GitHub](https://github.com/twentyhq/twenty)를 팔로우하세요
-* 피드백과 기능 요청을 공유하려면 저희 [Discord](https://discord.gg/twenty)에 참여하세요
+* 피드백과 기능 요청을 공유하려면 저희 [Discord](https://discord.gg/UfGNZJfAG6)에 참여하세요
diff --git a/packages/twenty-docs/l/ko/user-guide/billing/capabilities/credits.mdx b/packages/twenty-docs/l/ko/user-guide/billing/capabilities/credits.mdx
index 4b55dc9157b..71d27e658eb 100644
--- a/packages/twenty-docs/l/ko/user-guide/billing/capabilities/credits.mdx
+++ b/packages/twenty-docs/l/ko/user-guide/billing/capabilities/credits.mdx
@@ -1,25 +1,32 @@
---
-title: 워크플로우 크레딧
-description: 워크플로우 크레딧, 소모량 및 추가 구매 방법 이해하기.
+title: 크레딧
+description: 크레딧이 워크플로우, AI 에이전트, AI 챗봇을 어떻게 구동하는지 — 그리고 잔액을 관리하는 방법.
---
## 개요
-워크플로우 크레딧은 Twenty에서 자동화를 지원합니다. 각 워크플로우 동작은 그 복잡성에 따라 크레딧을 소모합니다.
+크레딧은 워크플로우 자동화와 AI 기능을 구동합니다. 워크플로우 액션이 실행될 때, 워크플로우 내에서 AI 에이전트가 작업을 처리할 때, 그리고 AI 채팅 내에서 크레딧이 소모됩니다.
## 크레딧 할당
크레딧은 플랜이 아니라 청구 주기에 따라 결정됩니다:
-| 청구 주기 | 크레딧 |
-| ----- | ------ |
-| 월간 | 월 500만 |
-| 연간 | 연 5천만 |
+| 청구 주기 | 크레딧 |
+| ----- | ---- |
+| 월간 | 월 5 |
+| 연간 | 연 50 |
<Note>
- 월 500만 크레딧은 비용을 걱정하지 않고 자동화를 실행할 수 있도록 설계되었습니다. 표준 동작을 사용하는 대부분의 워크플로우에는 이 정도로 충분합니다. 고급 코드 노드나 AI 기반 기능을 실행할 때에만 추가 크레딧이 필요합니다.
+월 5개의 크레딧은 비용을 걱정하지 않고 자동화를 실행할 수 있도록 설계되었습니다. 표준 동작을 사용하는 대부분의 워크플로우에는 이 정도로 충분합니다. 고급 코드 노드나 AI 기반 기능을 실행할 때에만 추가 크레딧이 필요합니다.
</Note>
+## 크레딧 이월
+
+결제 기간 말에 사용하지 않은 크레딧은 자동으로 다음 기간으로 이월됩니다.
+
+* **한도**: 이월 가능한 크레딧은 한 기간의 전체 할당량으로 제한되므로, 기간당 요금제가 제공하는 크레딧보다 더 많이 이월할 수 없습니다.
+* **표시**: 이월 크레딧이 있으면 **설정 → 결제**에서 별도의 **이월 크레딧** 항목으로 표시되며, 그 옆에 **총 사용 가능** 잔액이 함께 표시됩니다.
+
## 크레딧 소모
동작에 따라 소모되는 크레딧 양이 다릅니다:
@@ -28,9 +35,9 @@ description: 워크플로우 크레딧, 소모량 및 추가 구매 방법 이
| ----------------------------- | ----------- |
| **기본 작업** (검색, 업데이트, 레코드 생성) | 최소 |
| **복잡한 작업** (코드 노드, 외부 API 호출) | 더 많은 크레딧 소모 |
-| **AI 프롬프트** (곧 제공 예정) | 사용량에 따라 변동 |
+| **AI 프롬프트 & AI 채팅** | 사용량에 따라 변동 |
-작업흐름이 실행될 때 크레딧은 실시간으로 차감됩니다.
+워크플로우가 실행될 때 크레딧은 실시간으로 차감됩니다.
## 사용량 모니터링
diff --git a/packages/twenty-docs/l/ko/user-guide/billing/capabilities/pricing-plans.mdx b/packages/twenty-docs/l/ko/user-guide/billing/capabilities/pricing-plans.mdx
index 28440b6bb6c..f332f733f29 100644
--- a/packages/twenty-docs/l/ko/user-guide/billing/capabilities/pricing-plans.mdx
+++ b/packages/twenty-docs/l/ko/user-guide/billing/capabilities/pricing-plans.mdx
@@ -19,7 +19,7 @@ Twenty는 클라우드 호스팅이든 셀프 호스팅이든, 모든 규모의
* 표준 지원
<Note>
- 프리미엄 기능(SSO 및 행 수준 권한)은 Pro 요금제에 포함되지 않습니다.
+프리미엄 기능(SSO, 행 수준 권한, AI 사용 데이터)은 Pro 플랜에 포함되지 않습니다.
</Note>
### 조직(클라우드)
@@ -27,7 +27,7 @@ Twenty는 클라우드 호스팅이든 셀프 호스팅이든, 모든 규모의
고급 기능이 필요한 대규모 팀용:
* Pro의 모든 기능
-* **프리미엄 기능**: SSO 통합 및 행 수준 권한
+* **프리미엄 기능**: SSO 통합, 행 수준 권한, AI 사용 데이터
* 우선 지원
## 셀프 호스팅 요금제
@@ -45,7 +45,7 @@ Twenty는 클라우드 호스팅이든 셀프 호스팅이든, 모든 규모의
셀프 호스팅하면서 프리미엄 기능이 필요한 팀용:
* Pro의 모든 기능
-* **프리미엄 기능**: SSO 통합 및 행 수준 권한
+* **프리미엄 기능**: SSO 통합, 행 수준 권한, AI 사용 데이터
* Twenty 팀의 지원
* 배포 전에 커스텀 코드를 오픈 소스로 공개할 필요 없음
@@ -55,6 +55,7 @@ Twenty는 클라우드 호스팅이든 셀프 호스팅이든, 모든 규모의
* **SSO 통합**: ID 공급자와의 싱글 사인온
* **행 수준 권한**: 레코드 수준의 세밀한 액세스 제어
+* **AI 사용 데이터**: 워크스페이스 전반의 AI 사용량을 추적하세요
## 요금제 전환
@@ -77,3 +78,15 @@ Twenty는 클라우드 호스팅이든 셀프 호스팅이든, 모든 규모의
### 월간 결제로 전환
월간 결제로 되돌리려면 지원팀에 문의하세요.
+
+## Organization(셀프 호스팅)용 엔터프라이즈 키 받기
+
+Organization(셀프 호스팅) 플랜을 사용하려면 엔터프라이즈 키를 받아야 합니다:
+
+1. **설정 → 관리자 패널 → 엔터프라이즈**로 이동하세요
+
+<img src="/images/user-guide/billing/enterprise-key.png" alt="엔터프라이즈 키" />
+
+2. **엔터프라이즈 키 받기**를 클릭하세요
+3. Stripe로 리디렉션되면 결제 정보를 입력하고 확인하세요
+4. 엔터프라이즈 키가 표시되면 이를 엔터프라이즈 설정 페이지에 붙여넣고 Organization 라이선스를 활성화하세요
diff --git a/packages/twenty-docs/l/ko/user-guide/billing/how-tos/billing-faq.mdx b/packages/twenty-docs/l/ko/user-guide/billing/how-tos/billing-faq.mdx
index 4dee8e0b9e6..dc04abea4e0 100644
--- a/packages/twenty-docs/l/ko/user-guide/billing/how-tos/billing-faq.mdx
+++ b/packages/twenty-docs/l/ko/user-guide/billing/how-tos/billing-faq.mdx
@@ -6,81 +6,83 @@ description: Twenty 요금 및 결제에 관한 자주 묻는 질문입니다.
## 가격
<AccordionGroup>
- <Accordion title="자기 호스팅 시 Twenty를 무료로 사용할 수 있나요?">
- 네, 자기 호스팅할 때 Twenty를 무료로 사용할 수 있습니다. 당사 코어 팀의 지원을 제외하고 Pro (Cloud) 플랜에 포함된 모든 기능을 이용할 수 있습니다. 지원은 Discord 커뮤니티를 통해 제공됩니다.
-
- 자가 호스팅을 원하고 Premium 기능(SSO 및 행 수준 권한)이 필요하다면, 유료 Organization (Self-Hosted) 라이선스를 선택할 수 있습니다. 여기에는 Twenty 팀의 지원도 포함되며, 배포 전에 커스텀 코드를 오픈 소스로 공개해야 하는 요구 사항이 제거됩니다.
- </Accordion>
-
- <Accordion title="Premium 기능에는 무엇이 있나요?">
- Premium 기능은 Organization 플랜(Cloud 또는 Self-Hosted)에서만 제공됩니다:
-
- * **SSO 통합**: 아이덴티티 공급자와의 단일 로그인
- * **행 수준 권한**: 레코드 수준에서의 세밀한 액세스 제어
- </Accordion>
-
- <Accordion title="보기 전용 사용자에게 무료 좌석을 제공하나요?">
- 무료 좌석은 제공되지 않습니다. 가격은 사용자당 책정되며, 각 사용자는 Twenty에 접근하기 위해 라이센스가 필요합니다.
- </Accordion>
-
- <Accordion title="내 구독을 Organization 플랜으로 어디에서 전환할 수 있나요?">
- `설정 → 청구`에서 가능합니다. 그 다음, `조직으로 전환`을 클릭하십시오.
- </Accordion>
-
- <Accordion title="내 구독을 Pro 플랜으로 어디에서 전환할 수 있나요?">
- 현재 UI를 통해 쉽게 수행할 방법이 없으므로 지원에 직접 문의해 주세요.
- </Accordion>
-
- <Accordion title="내 구독을 연간 요금제로 어디에서 전환할 수 있나요?">
- `설정 → 청구`에서 가능합니다. 그 다음, `연간으로 전환`을 클릭하십시오.
- </Accordion>
-
- <Accordion title="내 구독을 월간 요금제로 어디에서 전환할 수 있나요?">
- 현재 UI를 통해 쉽게 수행할 방법이 없으므로 지원에 직접 문의해 주세요.
- </Accordion>
-
- <Accordion title="크레딧 사용량은 어디에서 확인할 수 있나요?">
- `설정 → 청구`에서 확인할 수 있습니다.
- </Accordion>
-
- <Accordion title="워크플로 크레딧은 얼마나 있나요?">
- 크레딧 수는 플랜이 아니라 청구 주기에 따라 달라집니다:
-
- * **월간 구독**: 월 500만 크레딧
- * **연간 구독**: 연 5,000만 크레딧
- </Accordion>
-
- <Accordion title="워크플로 크레딧 소모는 어떻게 이루어지나요?">
- 각 워크플로우 동작은 그 복잡성에 따라 크레딧을 소모합니다:
-
- * **기본 내부 작업**(예: 검색, 업데이트, 레코드 생성)은 아주 적은 크레딧을 소모합니다
- * **더 복잡한 작업**(코드 노드 및 외부 서비스에 대한 요청 등)은 더 많은 크레딧을 소모합니다
- * **AI 프롬프트** (곧 제공 예정) 사용량에 따라 더 많은 크레딧을 소비하게 됩니다.
-
- 작업흐름이 실행될 때 크레딧은 실시간으로 차감됩니다. 소비 및 남은 크레딧을 추적하기 위해 **설정 → 청구**에서 사용 내용을 모니터링할 수 있습니다.
- </Accordion>
-
- <Accordion title="워크플로 크레딧을 더 구매할 수 있나요?">
- `설정 → 청구`에서 추가 크레딧을 구매할 수 있습니다.
- </Accordion>
+<Accordion title="자기 호스팅 시 Twenty를 무료로 사용할 수 있나요?">
+네, 자기 호스팅할 때 Twenty를 무료로 사용할 수 있습니다. 당사 코어 팀의 지원을 제외하고 Pro (Cloud) 플랜에 포함된 모든 기능을 이용할 수 있습니다. 지원은 Discord 커뮤니티를 통해 제공됩니다.
+
+자가 호스팅을 원하고 Premium 기능(SSO 및 행 수준 권한)이 필요하다면, 유료 Organization (Self-Hosted) 라이선스를 선택할 수 있습니다. 여기에는 Twenty 팀의 지원도 포함되며, 배포 전에 커스텀 코드를 오픈 소스로 공개해야 하는 요구 사항이 제거됩니다.
+</Accordion>
+
+<Accordion title="Premium 기능에는 무엇이 있나요?">
+Premium 기능은 Organization 플랜(Cloud 또는 Self-Hosted)에서만 제공됩니다:
+* **SSO 통합**: 아이덴티티 공급자와의 단일 로그인
+* **행 수준 권한**: 레코드 수준에서의 세밀한 액세스 제어
+* **AI 사용 데이터**: 워크스페이스 전반의 AI 사용량을 추적하세요
+</Accordion>
+
+<Accordion title="클라우드의 Organization 플랜과 셀프 호스티드의 Organization 플랜은 동일한가요?">
+동일한 프리미엄 기능을 제공합니다. 클라우드 구독은 셀프 호스티드 배포에 사용할 수 없습니다. 셀프 호스티드는 Enterprise 키가 필요합니다.
+</Accordion>
+
+<Accordion title="보기 전용 사용자에게 무료 좌석을 제공하나요?">
+무료 좌석은 제공되지 않습니다. 가격은 사용자당 책정되며, 각 사용자는 Twenty에 접근하기 위해 라이센스가 필요합니다.
+</Accordion>
+
+<Accordion title="내 구독을 Organization 플랜으로 어디에서 전환할 수 있나요?">
+`설정 → 청구`에서 가능합니다. 그 다음, `조직으로 전환`을 클릭하십시오.
+</Accordion>
+
+<Accordion title="내 구독을 Pro 플랜으로 어디에서 전환할 수 있나요?">
+현재 UI를 통해 쉽게 수행할 방법이 없으므로 지원에 직접 문의해 주세요.
+</Accordion>
+
+<Accordion title="내 구독을 연간 요금제로 어디에서 전환할 수 있나요?">
+`설정 → 청구`에서 가능합니다. 그 다음, `연간으로 전환`을 클릭하십시오.
+</Accordion>
+
+<Accordion title="내 구독을 월간 요금제로 어디에서 전환할 수 있나요?">
+현재 UI를 통해 쉽게 수행할 방법이 없으므로 지원에 직접 문의해 주세요.
+</Accordion>
+
+<Accordion title="크레딧 사용량은 어디에서 확인할 수 있나요?">
+`설정 → 청구`에서 확인할 수 있습니다.
+</Accordion>
+
+<Accordion title="워크플로 크레딧은 얼마나 있나요?">
+크레딧 수는 플랜이 아니라 청구 주기에 따라 달라집니다:
+* **월간 구독**: 월 5 크레딧
+* **연간 구독**: 연 50 크레딧
+</Accordion>
+
+<Accordion title="워크플로 크레딧 소모는 어떻게 이루어지나요?">
+각 워크플로우 동작은 그 복잡성에 따라 크레딧을 소모합니다:
+* **기본 내부 작업**(예: 검색, 업데이트, 레코드 생성)은 아주 적은 크레딧을 소모합니다
+* **더 복잡한 작업**(코드 노드 및 외부 서비스에 대한 요청 등)은 더 많은 크레딧을 소모합니다
+* **AI 프롬프트** (곧 제공 예정) 사용량에 따라 더 많은 크레딧을 소비하게 됩니다.
+
+작업흐름이 실행될 때 크레딧은 실시간으로 차감됩니다. 소비 및 남은 크레딧을 추적하기 위해 **설정 → 청구**에서 사용 내용을 모니터링할 수 있습니다.
+</Accordion>
+
+<Accordion title="워크플로 크레딧을 더 구매할 수 있나요?">
+`설정 → 청구`에서 추가 크레딧을 구매할 수 있습니다.
+</Accordion>
</AccordionGroup>
## 청구
<AccordionGroup>
- <Accordion title="청구 세부 정보는 어디에서 관리할 수 있나요?">
- `설정 → 청구`에서 가능합니다.
- </Accordion>
+<Accordion title="청구 세부 정보는 어디에서 관리할 수 있나요?">
+`설정 → 청구`에서 가능합니다.
+</Accordion>
- <Accordion title="결제 수단은 어디에서 업데이트할 수 있나요?">
- `설정 → 청구`에서 가능합니다. 그 다음, `청구 세부 정보 보기`를 클릭하십시오. 새 지불 방법을 추가할 수 있습니다.
- </Accordion>
+<Accordion title="결제 수단은 어디에서 업데이트할 수 있나요?">
+`설정 → 청구`에서 가능합니다. 그 다음, `청구 세부 정보 보기`를 클릭하십시오. 새 지불 방법을 추가할 수 있습니다.
+</Accordion>
- <Accordion title="청구 정보는 어디에서 업데이트할 수 있나요?">
- `설정 → 청구`에서 가능합니다. 그 다음, `청구 세부 정보 보기`를 클릭하십시오. 청구 정보를 편집할 수 있습니다.
- </Accordion>
+<Accordion title="청구 정보는 어디에서 업데이트할 수 있나요?">
+`설정 → 청구`에서 가능합니다. 그 다음, `청구 세부 정보 보기`를 클릭하십시오. 청구 정보를 편집할 수 있습니다.
+</Accordion>
- <Accordion title="청구서는 어디에서 확인할 수 있나요?">
- `설정 → 청구`에서 가능합니다. 그 다음, `청구 세부 정보 보기`를 클릭하십시오. 화면 하단에서 모든 인보이스를 볼 수 있습니다.
- </Accordion>
+<Accordion title="청구서는 어디에서 확인할 수 있나요?">
+`설정 → 청구`에서 가능합니다. 그 다음, `청구 세부 정보 보기`를 클릭하십시오. 화면 하단에서 모든 인보이스를 볼 수 있습니다.
+</Accordion>
</AccordionGroup>
diff --git a/packages/twenty-docs/l/ko/user-guide/billing/overview.mdx b/packages/twenty-docs/l/ko/user-guide/billing/overview.mdx
index 993f72d8591..6043e5073a4 100644
--- a/packages/twenty-docs/l/ko/user-guide/billing/overview.mdx
+++ b/packages/twenty-docs/l/ko/user-guide/billing/overview.mdx
@@ -3,7 +3,6 @@ title: 청구
description: Twenty의 요금제를 이해하고 구독을 관리하세요.
---
-
Twenty는 팀의 요구에 맞는 유연한 요금제를 제공합니다. **설정 → 결제**에서 구독을 관리하고 워크플로 크레딧을 확인하며 청구서를 확인할 수 있습니다.
## 이 섹션의 내용
@@ -12,7 +11,6 @@ Twenty는 팀의 요구에 맞는 유연한 요금제를 제공합니다. **설
<Card title="요금제" icon="tags" href="/l/ko/user-guide/billing/capabilities/pricing-plans">
Twenty의 요금제와 포함된 내용을 알아보세요.
</Card>
-
<Card title="FAQ" icon="circle-question" href="/l/ko/user-guide/billing/how-tos/billing-faq">
요금 및 결제에 관한 자주 묻는 질문입니다.
</Card>
diff --git a/packages/twenty-docs/l/ko/user-guide/calendar-emails/how-tos/can-i-send-emails-from-twenty.mdx b/packages/twenty-docs/l/ko/user-guide/calendar-emails/how-tos/can-i-send-emails-from-twenty.mdx
index 817ff456a78..d0db9c63740 100644
--- a/packages/twenty-docs/l/ko/user-guide/calendar-emails/how-tos/can-i-send-emails-from-twenty.mdx
+++ b/packages/twenty-docs/l/ko/user-guide/calendar-emails/how-tos/can-i-send-emails-from-twenty.mdx
@@ -34,7 +34,7 @@ Twenty에서는 수동으로 이메일을 보낼 수 없지만, **워크플로
이메일 시퀀스와 뉴스레터의 경우, Twenty를 전용 이메일 마케팅 도구와 연결하기 위해 워크플로우를 사용할 것을 권장합니다.
<Warning>
- 도메인 평판을 보호하기 위해 대량 이메일은 사서함에서 직접 보내지 말아야 합니다. 대량 커뮤니케이션에는 전용 도구를 사용하세요.
+도메인 평판을 보호하기 위해 대량 이메일은 사서함에서 직접 보내지 말아야 합니다. 대량 커뮤니케이션에는 전용 도구를 사용하세요.
</Warning>
→ 설정 방법은 [워크플로우에서 이메일을 보내는 방법](/l/ko/user-guide/workflows/capabilities/send-emails-from-workflows)을 참조하세요
diff --git a/packages/twenty-docs/l/ko/user-guide/calendar-emails/overview.mdx b/packages/twenty-docs/l/ko/user-guide/calendar-emails/overview.mdx
index 01d71203550..20011ecca0b 100644
--- a/packages/twenty-docs/l/ko/user-guide/calendar-emails/overview.mdx
+++ b/packages/twenty-docs/l/ko/user-guide/calendar-emails/overview.mdx
@@ -3,7 +3,6 @@ title: 캘린더 및 이메일
description: Twenty에 이메일과 캘린더 계정을 연결하세요.
---
-
## 연결 옵션
### Google 계정 (Gmail 및 Google 캘린더)
@@ -26,15 +25,25 @@ description: Twenty에 이메일과 캘린더 계정을 연결하세요.
6. 캘린더 동기화 설정(가시성, 자동 생성)을 구성한 뒤 → **계정 추가**를 클릭
7. 이메일과 캘린더 이벤트가 자동으로 동기화되기 시작합니다.
-### SMTP/CalDAV 설정 (다른 공급자)
+### IMAP/SMTP/CalDAV 설정 (다른 공급자)
다른 이메일 및 캘린더 공급자의 경우:
1. **설정 → 계정**으로 이동
-2. 이메일을 위한 SMTP 설정을 구성합니다.
+2. 수신 이메일을 동기화하려면 IMAP 설정을 구성하고, 이메일을 보내려면 SMTP 설정을 구성하세요.
3. 캘린더를 위한 CalDAV 설정을 구성합니다.
4. 연결을 테스트하세요.
+<Note>
+**에어갭 또는 내부 네트워크에서의 셀프 호스팅**: 기본적으로 Twenty는 사설/내부 IP 주소로의 아웃바운드 연결을 거부합니다(SSRF 보호). 메일 또는 캘린더 서버가 로컬/사설 IP(예: LAN의 온프레미스 서버)에서 실행 중인 경우, 해당 서버로의 연결은 차단됩니다. 이를 허용하려면 서버에서 다음 환경 변수를 설정하세요:
+
+```
+OUTBOUND_HTTP_SAFE_MODE_ENABLED=false
+```
+
+이 설정은 **모든** 아웃바운드 요청(HTTP 워크플로 작업, 웹훅, IMAP/SMTP/CalDAV 연결)에 대해 안전 모드를 비활성화하므로, SSRF 보호가 필요하지 않은 신뢰할 수 있고 격리된 네트워크에서만 설정해야 합니다.
+</Note>
+
### 다중 메일박스
* **무제한 계정**: 사용자당 여러 이메일 계정 연결
@@ -42,7 +51,7 @@ description: Twenty에 이메일과 캘린더 계정을 연결하세요.
* **동기화 설정**: 메일박스 별 다른 설정 구성
<Warning>
- 실제 메일박스만 연결할 수 있습니다 (예: 자신의 인박스를 가진 [email protected]). 다른 메일박스로 전달되는 이메일 별칭은 Twenty에 연결할 수 없습니다.
+실제 메일박스만 연결할 수 있습니다 (예: 자신의 인박스를 가진 [email protected]). 다른 메일박스로 전달되는 이메일 별칭은 Twenty에 연결할 수 없습니다.
</Warning>
## 이메일 구성
@@ -60,10 +69,19 @@ description: Twenty에 이메일과 캘린더 계정을 연결하세요.
* **비활성화됨**: 자동 연락처 생성 없음
* **발송 및 수신 메시지용**: 모든 외부 이메일 상호작용에 대해 연락처 생성
* **발송 메시지용**: 발송하는 이메일에 대해서만 연락처 생성
-* **참고**: 내부 이메일 (같은 도메인)은 개인 정보 보호 유지를 위해 동기화되지 않습니다.
+* **참고**: 기본적으로 내부 이메일(모든 참여자가 동일한 도메인을 사용하는 이메일)은 프라이버시 보호를 위해 동기화되지 않습니다.
<Note>활성화하면 연락처는 이메일 도메인을 기준으로 해당 회사 레코드에 자동으로 연결됩니다. 아직 회사가 존재하지 않으면 Twenty가 생성합니다.</Note>
+<Note>
+**내부 이메일 동기화**: "내부 이메일이 동기화되지 않음" 동작이 기본값이지만, 이를 해제할 수 있습니다. 해당 토글은 고급 설정에 있습니다:
+1. **설정**을 열고 설정 페이지 하단에서 **고급** 토글을 활성화하세요.
+2. **일반 → 보안**으로 이동하세요.
+3. 모든 참여자가 동일한 도메인을 사용하는 이메일을 포함하려면 **내부 이메일 동기화** 토글을 활성화하세요.
+
+이 설정은 워크스페이스 전체에 적용됩니다(대학이나 공유 도메인 조직에 유용).
+</Note>
+
### 메시지 폴더 선택으로 동기화할 이메일 제어
Twenty와 동기화할 이메일 폴더 제어:
@@ -80,7 +98,7 @@ Twenty와 동기화할 이메일 폴더 제어:
**동기화되는 항목:**
* **외부 이메일**: 선택한 폴더에서 외부 연락처와의 모든 이메일
-* **내부 이메일**: 동기화되지 않음 (같은 도메인 이메일은 비공개 유지)
+* **내부 이메일**: 기본적으로 동기화되지 않음(같은 도메인 이메일은 비공개로 유지). 워크스페이스 전체에 포함하려면 **설정** 하단에서 **고급** 토글을 활성화한 후, **일반 → 보안**에서 **내부 이메일 동기화**를 켜세요.
* **첨부 파일**: 2026년 상반기 제공 예정
**참고**: 선택적 동기화를 위한 CC 이메일 주소를 제공하지 않습니다. 대신에 위의 메시지 폴더 기능을 사용하여 Twenty와 동기화할 이메일을 동일한 수준으로 제어할 수 있습니다.
@@ -117,7 +135,7 @@ Twenty와 동기화할 이메일 폴더 제어:
**5분마다 업데이트**: 초기 가져오기를 마친 후 5분마다 이메일 및 캘린더 데이터가 자동으로 동기화됩니다.
<Note>
- **초기 동기화 소요 시간**: 캘린더 동기화는 빠르게 완료됩니다(보통 몇 분 이내에), 반면 메일박스가 큰 경우 이메일 동기화에는 더 오래 걸립니다. Twenty는 분당 약 **400건의 메시지**를 가져옵니다(Gmail API의 속도 제한으로 제한됨). 따라서 10,000개의 이메일이 있는 메일박스는 약 25분이 걸립니다. 캘린더 이벤트의 연락처가 이메일 연락처보다 먼저 표시되어도 걱정하지 마세요. 이는 정상적인 동작입니다.
+**초기 동기화 소요 시간**: 캘린더 동기화는 빠르게 완료됩니다(보통 몇 분 이내에), 반면 메일박스가 큰 경우 이메일 동기화에는 더 오래 걸립니다. Twenty는 분당 약 **400건의 메시지**를 가져옵니다(Gmail API의 속도 제한으로 제한됨). 따라서 10,000개의 이메일이 있는 메일박스는 약 25분이 걸립니다. 캘린더 이벤트의 연락처가 이메일 연락처보다 먼저 표시되어도 걱정하지 마세요. 이는 정상적인 동작입니다.
</Note>
## 다음 단계
diff --git a/packages/twenty-docs/l/ko/user-guide/dashboards/capabilities/chart-settings.mdx b/packages/twenty-docs/l/ko/user-guide/dashboards/capabilities/chart-settings.mdx
index 3dba3fcd063..74230e2d4ec 100644
--- a/packages/twenty-docs/l/ko/user-guide/dashboards/capabilities/chart-settings.mdx
+++ b/packages/twenty-docs/l/ko/user-guide/dashboards/capabilities/chart-settings.mdx
@@ -23,7 +23,7 @@ import { ChartIcon } from '/snippets/chart-icon.mdx';
* **스타일**: 색상, 레이블, 시각적 옵션
<Note>
- 일부 설정은 다른 설정이 구성되었을 때만 표시됩니다. 예를 들어, **날짜 세분성**은 날짜 필드를 선택했을 때만 표시됩니다.
+일부 설정은 다른 설정이 구성되었을 때만 표시됩니다. 예를 들어, **날짜 세분성**은 날짜 필드를 선택했을 때만 표시됩니다.
</Note>
---
@@ -58,11 +58,11 @@ import { ChartIcon } from '/snippets/chart-icon.mdx';
<img src="/images/user-guide/dashboard/dashboard-chart-settings-filters.png" alt="필터" />
<Tip>
- 날짜 필드의 경우, 자동으로 업데이트되는 "지난 7일" 또는 "이번 달"과 같은 동적 필터를 만들려면 **Is relative**를 사용해 보세요.
+날짜 필드의 경우, 자동으로 업데이트되는 "지난 7일" 또는 "이번 달"과 같은 동적 필터를 만들려면 **Is relative**를 사용해 보세요.
</Tip>
<Tip>
- 고급 필터를 지원합니다—여러 필터 규칙을 추가하고 **And** 또는 **Or** 로직으로 결합하세요.
+고급 필터를 지원합니다—여러 필터 규칙을 추가하고 **And** 또는 **Or** 로직으로 결합하세요.
</Tip>
---
@@ -110,11 +110,11 @@ X축의 범주 순서를 제어합니다.
**팁**: 파이프라인 단계에는 **위치**를 사용하여 영업 프로세스 순서(Lead → Qualified → Proposal → Won)대로 표시하세요.
<Note>
- 표시되는 옵션은 필드 유형에 따라 다릅니다. Select 필드는 모든 옵션을 제공하지만 날짜 및 텍스트 필드는 더 적습니다.
+표시되는 옵션은 필드 유형에 따라 다릅니다. Select 필드는 모든 옵션을 제공하지만 날짜 및 텍스트 필드는 더 적습니다.
</Note>
<Tip>
- 수동 정렬에서는 범주를 드래그해 사용자 지정 순서를 만들 수 있습니다—특정 세그먼트를 강조하거나 데이터로 스토리를 전달하는 데 완벽합니다.
+수동 정렬에서는 범주를 드래그해 사용자 지정 순서를 만들 수 있습니다—특정 세그먼트를 강조하거나 데이터로 스토리를 전달하는 데 완벽합니다.
</Tip>
### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}> <ChartIcon icon="eye-off" />0 값 제외 </span>
@@ -147,7 +147,7 @@ Boolean 필드에는 true/false 개수 옵션이 추가됩니다. 날짜 필드
<img src="/images/user-guide/dashboard/dashboard-chart-settings-y-data-on-display.png" alt="표시된 데이터" />
<Note>
- 표시되는 옵션은 필드 및 차트 유형에 따라 다릅니다. 예상한 연산이 보이지 않으면 필드 유형을 확인하세요.
+표시되는 옵션은 필드 및 차트 유형에 따라 다릅니다. 예상한 연산이 보이지 않으면 필드 유형을 확인하세요.
</Note>
### 비율
@@ -222,7 +222,7 @@ Y축의 최소/최대 값을 고정합니다.
차트의 색 구성표를 설정합니다. 다양한 색상 팔레트 중에서 선택합니다.
<Note>
- Select 필드로 그룹화하는 경우 차트는 필드 설정에서 각 옵션에 정의된 색상을 자동으로 사용합니다.
+Select 필드로 그룹화하는 경우 차트는 필드 설정에서 각 옵션에 정의된 색상을 자동으로 사용합니다.
</Note>
### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}> <ChartIcon icon="gizmo" />축 이름 </span>
@@ -256,7 +256,7 @@ Y축의 최소/최대 값을 고정합니다.
* **꺼짐**: 범례를 표시하지 않음
<Tip>
- **범례 항목 위에 마우스를 올리면** 해당 그룹이 강조 표시됩니다. **클릭**하여 차트에서 일시적으로 숨깁니다.
+**범례 항목 위에 마우스를 올리면** 해당 그룹이 강조 표시됩니다. **클릭**하여 차트에서 일시적으로 숨깁니다.
</Tip>
---
diff --git a/packages/twenty-docs/l/ko/user-guide/dashboards/capabilities/dashboards.mdx b/packages/twenty-docs/l/ko/user-guide/dashboards/capabilities/dashboards.mdx
index 37465f80ba7..5dd5a7cc5ea 100644
--- a/packages/twenty-docs/l/ko/user-guide/dashboards/capabilities/dashboards.mdx
+++ b/packages/twenty-docs/l/ko/user-guide/dashboards/capabilities/dashboards.mdx
@@ -84,9 +84,9 @@ Twenty의 대시보드는 계층 구조로 구성됩니다: **대시보드 →
현재 대시보드는 보는 사람의 시간대를 기준으로 데이터를 표시합니다. 즉, 동일한 대시보드라도 지역이 다른 팀 구성원에게는 서로 다른 지표가 표시될 수 있습니다(예: APAC vs. US).
<Note>
- **곧 제공 예정**: 모든 사용자가 위치와 관계없이 일관된 데이터를 볼 수 있도록 대시보드별로 특정 시간대를 설정하는 기능을 추가할 예정입니다.
+**곧 제공 예정**: 모든 사용자가 위치와 관계없이 일관된 데이터를 볼 수 있도록 대시보드별로 특정 시간대를 설정하는 기능을 추가할 예정입니다.
</Note>
<Note>
- **곧 제공 예정**: 대시보드 수준의 필터를 통해 모든 위젯에 한 번에 필터를 적용할 수 있어 데이터를 더 빠르게 탐색할 수 있습니다.
+**곧 제공 예정**: 대시보드 수준의 필터를 통해 모든 위젯에 한 번에 필터를 적용할 수 있어 데이터를 더 빠르게 탐색할 수 있습니다.
</Note>
diff --git a/packages/twenty-docs/l/ko/user-guide/dashboards/capabilities/widgets.mdx b/packages/twenty-docs/l/ko/user-guide/dashboards/capabilities/widgets.mdx
index 825dfd04f5c..35d4d5fae4e 100644
--- a/packages/twenty-docs/l/ko/user-guide/dashboards/capabilities/widgets.mdx
+++ b/packages/twenty-docs/l/ko/user-guide/dashboards/capabilities/widgets.mdx
@@ -14,7 +14,7 @@ Twenty는 CRM 데이터를 시각화할 수 있는 다양한 위젯 유형을
데이터를 가로 또는 세로 막대로 표시합니다.
<Frame>
- <img src="/images/user-guide/dashboard/dashboard-widget-bar-chart.png" alt="막대 차트" />
+<img src="/images/user-guide/dashboard/dashboard-widget-bar-chart.png" alt="막대 차트" />
</Frame>
**적합한 용도:**
@@ -30,7 +30,7 @@ Twenty는 CRM 데이터를 시각화할 수 있는 다양한 위젯 유형을
* 월별 추가된 연락처
<Note>
- **표시 제한**: 막대 차트는 막대 최대 100개를 표시할 수 있으며, Group By를 사용하는 경우 막대당 최대 50개의 그룹을 표시할 수 있습니다. 경고 "Undisplayed data: max X bars per chart"가 표시되면, 필터를 추가해 데이터 범위를 좁히거나 그룹화를 변경하세요(예: 일 단위 대신 주 단위로 그룹화).
+**표시 제한**: 막대 차트는 막대 최대 100개를 표시할 수 있으며, Group By를 사용하는 경우 막대당 최대 50개의 그룹을 표시할 수 있습니다. 경고 "Undisplayed data: max X bars per chart"가 표시되면, 필터를 추가해 데이터 범위를 좁히거나 그룹화를 변경하세요(예: 일 단위 대신 주 단위로 그룹화).
</Note>
### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}><ChartIcon icon="chart-pie" />파이 차트</span>
@@ -38,7 +38,7 @@ Twenty는 CRM 데이터를 시각화할 수 있는 다양한 위젯 유형을
전체 대비 비율을 표시합니다.
<Frame>
- <img src="/images/user-guide/dashboard/dashboard-widget-pie-chart.png" alt="파이 차트" />
+<img src="/images/user-guide/dashboard/dashboard-widget-pie-chart.png" alt="파이 차트" />
</Frame>
**적합한 용도:**
@@ -58,7 +58,7 @@ Twenty는 CRM 데이터를 시각화할 수 있는 다양한 위젯 유형을
시간에 따른 추세를 표시합니다.
<Frame>
- <img src="/images/user-guide/dashboard/dashboard-widget-line-chart.png" alt="선형 차트" />
+<img src="/images/user-guide/dashboard/dashboard-widget-line-chart.png" alt="선형 차트" />
</Frame>
**적합한 용도:**
@@ -78,7 +78,7 @@ Twenty는 CRM 데이터를 시각화할 수 있는 다양한 위젯 유형을
단일 핵심 값을 눈에 띄게 표시합니다.
<Frame>
- <img src="/images/user-guide/dashboard/dashboard-widget-aggregate-chart.png" alt="집계 차트" />
+<img src="/images/user-guide/dashboard/dashboard-widget-aggregate-chart.png" alt="집계 차트" />
</Frame>
**적합한 용도:**
@@ -103,7 +103,7 @@ Twenty는 CRM 데이터를 시각화할 수 있는 다양한 위젯 유형을
대시보드에 외부 도구와 콘텐츠를 직접 삽입합니다.
<Frame>
- <img src="/images/user-guide/dashboard/dashboard-widget-iframe.png" alt="iFrame" />
+<img src="/images/user-guide/dashboard/dashboard-widget-iframe.png" alt="iFrame" />
</Frame>
**적합한 용도:**
@@ -123,7 +123,7 @@ Twenty는 CRM 데이터를 시각화할 수 있는 다양한 위젯 유형을
대시보드에 서식 있는 텍스트와 콘텐츠를 직접 추가하세요.
<Frame>
- <img src="/images/user-guide/dashboard/dashboard-widget-rich-text.png" alt="서식 있는 텍스트" />
+<img src="/images/user-guide/dashboard/dashboard-widget-rich-text.png" alt="서식 있는 텍스트" />
</Frame>
**적합한 용도:**
@@ -139,7 +139,7 @@ Twenty는 CRM 데이터를 시각화할 수 있는 다양한 위젯 유형을
* Markdown 스타일 편집
<Note>
- **곧 제공 예정**: 게이지 차트와 표는 아직 사용할 수 없지만 로드맵에 포함되어 있습니다.
+**곧 제공 예정**: 게이지 차트와 표는 아직 사용할 수 없지만 로드맵에 포함되어 있습니다.
</Note>
### 위젯 복제
diff --git a/packages/twenty-docs/l/ko/user-guide/dashboards/how-tos/dashboards-faq.mdx b/packages/twenty-docs/l/ko/user-guide/dashboards/how-tos/dashboards-faq.mdx
index de90677ba2d..b2d1cb042b0 100644
--- a/packages/twenty-docs/l/ko/user-guide/dashboards/how-tos/dashboards-faq.mdx
+++ b/packages/twenty-docs/l/ko/user-guide/dashboards/how-tos/dashboards-faq.mdx
@@ -47,7 +47,6 @@ description: Twenty의 대시보드에 관한 자주 묻는 질문입니다.
<Accordion title="대시보드 데이터는 얼마나 자주 새로고침되나요?">
CRM 데이터가 변경되면 위젯이 자동으로 업데이트됩니다:
-
* 대부분의 지표는 실시간으로 업데이트됩니다
* 필요 시 새로고침 버튼을 눌러 수동으로 업데이트하세요
* 추세 분석을 위해 과거 데이터가 보존됩니다
diff --git a/packages/twenty-docs/l/ko/user-guide/dashboards/overview.mdx b/packages/twenty-docs/l/ko/user-guide/dashboards/overview.mdx
index 05a9ab6bece..f69ba60823e 100644
--- a/packages/twenty-docs/l/ko/user-guide/dashboards/overview.mdx
+++ b/packages/twenty-docs/l/ko/user-guide/dashboards/overview.mdx
@@ -3,9 +3,8 @@ title: 대시보드
description: Twenty에서 보고 및 대시보드의 기본을 알아보세요.
---
-
<Note>
- 대시보드는 현재 베타 단계입니다. 해당 기능은 **설정 → 업데이트 → 얼리 액세스**에서 활성화할 수 있습니다.
+대시보드는 현재 베타 단계입니다. 해당 기능은 **설정 → 업데이트 → 얼리 액세스**에서 활성화할 수 있습니다.
</Note>
## 대시보드 이해하기
@@ -41,10 +40,9 @@ Twenty의 대시보드는 핵심 성과 지표를 추적하고 CRM 데이터에
* 서식 있는 텍스트
<Note>
- **현재 제한 사항**:
-
- * 대시보드 내보내기와 외부 사용자(Twenty 비사용자)와의 공유는 현재 제공되지 않습니다.
- * 게이지 차트와 표는 아직 제공되지 않습니다.
+**현재 제한 사항**:
+* 대시보드 내보내기와 외부 사용자(Twenty 비사용자)와의 공유는 현재 제공되지 않습니다.
+* 게이지 차트와 표는 아직 제공되지 않습니다.
</Note>
## 시작하기
diff --git a/packages/twenty-docs/l/ko/user-guide/data-migration/capabilities/field-mapping.mdx b/packages/twenty-docs/l/ko/user-guide/data-migration/capabilities/field-mapping.mdx
index 316bcd92d50..1bd0f40b058 100644
--- a/packages/twenty-docs/l/ko/user-guide/data-migration/capabilities/field-mapping.mdx
+++ b/packages/twenty-docs/l/ko/user-guide/data-migration/capabilities/field-mapping.mdx
@@ -56,7 +56,7 @@ Address는 여러 열로 구성된 중첩 필드입니다. 일부는 비워 둘
다음 형식을 사용하세요:
```
-[\"value1\",\"value2\"]
+["value1","value2"]
```
### 부울 필드
@@ -94,7 +94,7 @@ Address는 여러 열로 구성된 중첩 필드입니다. 일부는 비워 둘
* 추가 이메일의 경우: 기본 이메일은 **Emails / Primary Email**을 사용하고, **Emails / Additional Emails**에는 다음 형식을 사용하세요:
```
```
### ID 필드
@@ -113,7 +113,7 @@ Address는 여러 열로 구성된 중첩 필드입니다. 일부는 비워 둘
유효한 JSON 형식을 사용하세요:
```
-{\"key\":\"value\",\"key2\":\"value2\"}
+{"key":"value","key2":"value2"}
```
### 링크 필드
@@ -125,7 +125,7 @@ Address는 여러 열로 구성된 중첩 필드입니다. 일부는 비워 둘
* 보조 링크의 경우 **Links / Secondary Links** 열을 사용하고 다음 형식을 사용하세요:
```
-[{\"url\":\"https://twenty.com\",\"label\":\"Twenty\"}]
+[{"url":"https://twenty.com","label":"Twenty"}]
```
### 다중 선택 필드
@@ -133,7 +133,7 @@ Address는 여러 열로 구성된 중첩 필드입니다. 일부는 비워 둘
표시 라벨이 아니라 **API 이름**을 다음 형식으로 사용하세요:
```
-[\"VALUE1\",\"VALUE2\"]
+["VALUE1","VALUE2"]
```
API 이름을 찾는 위치는 [여기](#finding-api-names-for-select-fields)를 참고하세요.
@@ -141,9 +141,9 @@ API 이름을 찾는 위치는 [여기](#finding-api-names-for-select-fields)를
<Note>새 선택 옵션은 가져오기로 자동 생성되지 않습니다. 가져오기 전에 **설정 → 데이터 모델**에서 추가해야 합니다.</Note>
<Warning>
- **가져오기는 추가하지 않고 덮어씁니다.**
+**가져오기는 추가하지 않고 덮어씁니다.**
- 레코드에 이미 `VALUE2`와 `VALUE3`가 선택되어 있고 `[\"VALUE1\"]`을 가져오면, 가져온 후 해당 레코드에는 `VALUE1`만 남습니다. 이전 선택 항목은 병합되지 않고 대체됩니다.
+레코드에 이미 `VALUE2`와 `VALUE3`가 선택되어 있고 `["VALUE1"]`을 가져오면, 가져온 후 해당 레코드에는 `VALUE1`만 남습니다. 이전 선택 항목은 병합되지 않고 대체됩니다.
</Warning>
### 숫자 필드
diff --git a/packages/twenty-docs/l/ko/user-guide/data-migration/capabilities/file-formats.mdx b/packages/twenty-docs/l/ko/user-guide/data-migration/capabilities/file-formats.mdx
index 3c8198b37c7..dcc3f931020 100644
--- a/packages/twenty-docs/l/ko/user-guide/data-migration/capabilities/file-formats.mdx
+++ b/packages/twenty-docs/l/ko/user-guide/data-migration/capabilities/file-formats.mdx
@@ -25,7 +25,7 @@ Twenty는 가져오기를 위해 세 가지 파일 형식을 지원합니다:
## CSV 모범 사례
* **구분 기호**: 쉼표(`,`) 또는 세미콜론(`;`)을 사용하세요
-* **텍스트 한정 기호**: 쉼표가 포함된 텍스트에는 큰따옴표(`\"`)를 사용하세요
+* **텍스트 한정 기호**: 쉼표가 포함된 텍스트에는 큰따옴표(`"`)를 사용하세요
* **줄 바꿈**: Windows(CRLF) 또는 Unix(LF) 모두 지원
* **빈 값**: 셀을 비워 두고, "NULL"이나 "N/A"는 사용하지 마세요
diff --git a/packages/twenty-docs/l/ko/user-guide/data-migration/capabilities/import-relations.mdx b/packages/twenty-docs/l/ko/user-guide/data-migration/capabilities/import-relations.mdx
index 120bbdd76be..920bb419fa8 100644
--- a/packages/twenty-docs/l/ko/user-guide/data-migration/capabilities/import-relations.mdx
+++ b/packages/twenty-docs/l/ko/user-guide/data-migration/capabilities/import-relations.mdx
@@ -44,12 +44,12 @@ Twenty는 하나의 레코드가 여러 다른 레코드에 연결되는 표준
<img src="/images/user-guide/fields/one-to-many-morph.png" style={{width:'100%'}} />
<Warning>
- **가져오기/내보내기 제한사항**: 여러 객체 유형을 가리키는 관계(예: 노트 → 사람/회사/기회)는 CSV 가져오기나 내보내기에서 **아직 지원되지 않습니다**.
+**가져오기/내보내기 제한사항**: 여러 객체 유형을 가리키는 관계(예: 노트 → 사람/회사/기회)는 CSV 가져오기나 내보내기에서 **아직 지원되지 않습니다**.
- * **가져오기**: 각 측이 단일 객체 유형을 가리키는 일대다 관계만 가져올 수 있습니다
- * **내보내기**: 여러 객체 유형을 가리키는 관계의 열은 현재 비워 둡니다
+* **가져오기**: 각 측이 단일 객체 유형을 가리키는 일대다 관계만 가져올 수 있습니다
+* **내보내기**: 여러 객체 유형을 가리키는 관계의 열은 현재 비워 둡니다
- 이는 로드맵에 포함되어 있습니다.
+이는 로드맵에 포함되어 있습니다.
</Warning>
### 현재 지원되지 않는 사항
@@ -137,12 +137,12 @@ Jane,Doe,[email protected],https://widgets.co
## 가져오기 순서 규칙
<Warning>
- **항상 "one" 쪽을 먼저 가져오세요!**
+**항상 "one" 쪽을 먼저 가져오세요!**
- 1. **회사** 먼저(종속성 없음)
- 2. **사람** 두 번째(회사에 연결됨)
- 3. **기회** 세 번째(회사/사람에 연결됨)
- 4. **사용자 지정 객체**는 종속성에 따라 순서대로
+1. **회사** 먼저(종속성 없음)
+2. **사람** 두 번째(회사에 연결됨)
+3. **기회** 세 번째(회사/사람에 연결됨)
+4. **사용자 지정 객체**는 종속성에 따라 순서대로
- 참조하려면 상위 레코드가 먼저 존재해야 합니다.
+참조하려면 상위 레코드가 먼저 존재해야 합니다.
</Warning>
diff --git a/packages/twenty-docs/l/ko/user-guide/data-migration/capabilities/uniqueness-constraints.mdx b/packages/twenty-docs/l/ko/user-guide/data-migration/capabilities/uniqueness-constraints.mdx
index 6379b280e41..5d01cf37c67 100644
--- a/packages/twenty-docs/l/ko/user-guide/data-migration/capabilities/uniqueness-constraints.mdx
+++ b/packages/twenty-docs/l/ko/user-guide/data-migration/capabilities/uniqueness-constraints.mdx
@@ -50,9 +50,9 @@ Twenty는 중복 레코드를 방지하고 데이터 무결성을 보장하기
### 소프트 삭제된 레코드
<Warning>
- **삭제된 레코드도 고유성에 포함됩니다.**
+**삭제된 레코드도 고유성에 포함됩니다.**
- 소프트 삭제된 레코드는(Command Menu → See deleted records에서 확인 가능) 고유성 검사에 포함됩니다. 삭제된 레코드와 동일한 고유 값을 가진 레코드를 가져오면, 삭제된 레코드는 새 데이터로 **복원**됩니다.
+소프트 삭제된 레코드는(Command Menu → See deleted records에서 확인 가능) 고유성 검사에 포함됩니다. 삭제된 레코드와 동일한 고유 값을 가진 레코드를 가져오면, 삭제된 레코드는 새 데이터로 **복원**됩니다.
</Warning>
## 가져오기 중 중복 감지
diff --git a/packages/twenty-docs/l/ko/user-guide/data-migration/how-tos/export-your-data.mdx b/packages/twenty-docs/l/ko/user-guide/data-migration/how-tos/export-your-data.mdx
index 7cd281b0e4c..46194a768b6 100644
--- a/packages/twenty-docs/l/ko/user-guide/data-migration/how-tos/export-your-data.mdx
+++ b/packages/twenty-docs/l/ko/user-guide/data-migration/how-tos/export-your-data.mdx
@@ -24,7 +24,7 @@ import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
* **표시된 열**만 내보내집니다
* **필터링된 레코드**만 내보내집니다(현재 보기 기준)
-<Note>더 큰 내보내기(20,000개 이상의 레코드)에는 필터를 사용해 배치로 내보내거나 [API](/l/ko/developers/api)를 사용하세요.</Note>
+<Note>더 큰 내보내기(20,000개 이상의 레코드)에는 필터를 사용해 배치로 내보내거나 [API](/l/ko/developers/extend/api)를 사용하세요.</Note>
### 권한
@@ -148,7 +148,7 @@ API에는 레코드 수 한도가 없습니다:
2. GraphQL API를 사용해 레코드를 쿼리하세요
3. 애플리케이션에서 결과를 처리하세요
-참고: [API 문서](/l/ko/developers/api)
+참고: [API 문서](/l/ko/developers/extend/api)
## 팁 및 모범 사례
@@ -206,4 +206,4 @@ API에는 레코드 수 한도가 없습니다:
* [기존 레코드를 업데이트하는 방법](/l/ko/user-guide/data-migration/how-tos/update-existing-records-via-import) — 내보낸 파일을 편집한 뒤 다시 가져오세요
* [API로 데이터 가져오는 방법](/l/ko/user-guide/data-migration/how-tos/import-data-via-api) — 대용량 데이터셋용
-* [API 문서](/l/ko/developers/api) — 맞춤 내보내기 워크플로우를 구축하세요
+* [API 문서](/l/ko/developers/extend/api) — 맞춤 내보내기 워크플로우를 구축하세요
diff --git a/packages/twenty-docs/l/ko/user-guide/data-migration/how-tos/fix-import-errors.mdx b/packages/twenty-docs/l/ko/user-guide/data-migration/how-tos/fix-import-errors.mdx
index 5a44d6e0494..be0345835b6 100644
--- a/packages/twenty-docs/l/ko/user-guide/data-migration/how-tos/fix-import-errors.mdx
+++ b/packages/twenty-docs/l/ko/user-guide/data-migration/how-tos/fix-import-errors.mdx
@@ -71,12 +71,12 @@ description: CSV 가져오기 오류를 해결하기 위한 종합적인 문제
3. Twenty가 중복을 생성하는 대신 기존 레코드를 업데이트합니다
<Note>
- **고유 필드도 업데이트할 수 있습니다.**
+**고유 필드도 업데이트할 수 있습니다.**
- * `id`는 유지하고 `email`만 변경하면 → 이메일이 업데이트됩니다
- * `email`은 유지하고 `id`만 변경하면 → id가 업데이트됩니다
+* `id`는 유지하고 `email`만 변경하면 → 이메일이 업데이트됩니다
+* `email`은 유지하고 `id`만 변경하면 → id가 업데이트됩니다
- 하나의 고유 식별자만 일치해도 Twenty가 레코드를 업데이트합니다.
+하나의 고유 식별자만 일치해도 Twenty가 레코드를 업데이트합니다.
</Note>
### 이 오류를 방지하는 방법
@@ -88,9 +88,9 @@ description: CSV 가져오기 오류를 해결하기 위한 종합적인 문제
3. 레코드가 Twenty에 이미 존재하는지 확인
<Warning>
- **소프트 삭제된 레코드도 고유성에 포함됩니다.**
+**소프트 삭제된 레코드도 고유성에 포함됩니다.**
- Command 메뉴 → 삭제된 레코드 보기를 확인하세요. 그곳의 레코드도 여전히 고유성을 강제합니다. 완전히 삭제하거나 복원한 뒤 업데이트하세요.
+Command 메뉴 → 삭제된 레코드 보기를 확인하세요. 그곳의 레코드도 여전히 고유성을 강제합니다. 완전히 삭제하거나 복원한 뒤 업데이트하세요.
</Warning>
자세한 내용: [고유성 제약 조건](/l/ko/user-guide/data-migration/capabilities/uniqueness-constraints)
@@ -140,12 +140,12 @@ description: CSV 가져오기 오류를 해결하기 위한 종합적인 문제
#### 날짜
**문제:** 인식되지 않는 날짜 형식
-**해결:** 파일 전체에서 일관된 형식을 사용하세요
+**해결:** 파일 전체에서 `YYYY-MM-DD` 형식을 일관되게 사용하세요
```
-✓ 2024-03-15 (YYYY-MM-DD - recommended)
-✓ 03/15/2024 (MM/DD/YYYY)
-✓ 15/03/2024 (DD/MM/YYYY)
+✓ 2024-03-15 (YYYY-MM-DD)
+❌ 03/15/2024 (MM/DD/YYYY)
+❌ 15/03/2024 (DD/MM/YYYY)
```
#### 전화
@@ -296,9 +296,9 @@ Twenty에 존재하지 않는 레코드에 연결하려고 하고 있습니다.
* 오타 및 대소문자 구분 여부를 확인하세요
<Warning>
- **존재하지 않는 레코드를 참조하면 가져오기는 실패합니다.**
+**존재하지 않는 레코드를 참조하면 가져오기는 실패합니다.**
- 항상 상위 객체를 먼저 가져오세요.
+항상 상위 객체를 먼저 가져오세요.
</Warning>
자세한 내용: [관계 가져오기](/l/ko/user-guide/data-migration/capabilities/import-relations)
@@ -372,9 +372,9 @@ Twenty에 존재하지 않는 레코드에 연결하려고 하고 있습니다.
3. Twenty에 가입할 때 사용한 것과 동일한 이메일을 사용하세요
<Warning>
- **가져오기를 진행하기 전에 사용자가 초대를 수락해야 합니다.**
+**가져오기를 진행하기 전에 사용자가 초대를 수락해야 합니다.**
- 사용자가 초대를 수락하지 않은 경우, 해당 사용자를 참조하는 레코드의 사용자 관계가 비어 있게 됩니다.
+사용자가 초대를 수락하지 않은 경우, 해당 사용자를 참조하는 레코드의 사용자 관계가 비어 있게 됩니다.
</Warning>
---
diff --git a/packages/twenty-docs/l/ko/user-guide/data-migration/how-tos/import-companies-via-csv.mdx b/packages/twenty-docs/l/ko/user-guide/data-migration/how-tos/import-companies-via-csv.mdx
index 62670a7d6ad..f67ea03f2ef 100644
--- a/packages/twenty-docs/l/ko/user-guide/data-migration/how-tos/import-companies-via-csv.mdx
+++ b/packages/twenty-docs/l/ko/user-guide/data-migration/how-tos/import-companies-via-csv.mdx
@@ -12,23 +12,23 @@ description: Twenty로 회사를 가져오는 포괄적인 단계별 가이드.
### 사전 준비 체크리스트
<Check>
- 파일이 CSV, XLSX 또는 XLS 형식임
+파일이 CSV, XLSX 또는 XLS 형식임
</Check>
<Check>
- 파일의 레코드가 10,000개 미만임
+파일의 레코드가 10,000개 미만임
</Check>
<Check>
- 파일에 중복된 도메인이 없음
+파일에 중복된 도메인이 없음
</Check>
<Check>
- 모든 사용자 정의 필드가 **Settings → Data Model**에 존재함
+모든 사용자 정의 필드가 **Settings → Data Model**에 존재함
</Check>
<Note>
- 10,000개 이상의 회사를 가져와야 하나요? 여러 파일로 분할하거나 [API 가져오기](/l/ko/user-guide/data-migration/how-tos/import-data-via-api)를 사용하세요.
+10,000개 이상의 회사를 가져와야 하나요? 여러 파일로 분할하거나 [API 가져오기](/l/ko/user-guide/data-migration/how-tos/import-data-via-api)를 사용하세요.
</Note>
## 1단계: 회사 데이터 준비
@@ -46,9 +46,9 @@ description: Twenty로 회사를 가져오는 포괄적인 단계별 가이드.
### 도메인 형식
<Warning>
- **도메인에는 `https://domain.com` 형식을 사용하세요.**
+**도메인에는 `https://domain.com` 형식을 사용하세요.**
- 이는 이메일/캘린더 동기화로 회사가 자동 생성될 때 사용하는 형식과 일치하여, 이후 중복을 방지합니다.
+이는 이메일/캘린더 동기화로 회사가 자동 생성될 때 사용하는 형식과 일치하여, 이후 중복을 방지합니다.
</Warning>
**도메인 열:**
@@ -74,7 +74,7 @@ Widget Co,https://widgets.co,widgets.co,New York,USA,50
```
<Note>
- **전문가 팁:** 가져오기 중에 **Download sample file**을 클릭하여 Twenty가 기대하는 정확한 열 이름을 확인하세요.
+**전문가 팁:** 가져오기 중에 **Download sample file**을 클릭하여 Twenty가 기대하는 정확한 열 이름을 확인하세요.
</Note>
## 2단계: 가져오기 기능에 액세스
@@ -123,7 +123,7 @@ Twenty가 열을 필드에 자동으로 매칭하려고 시도합니다. 검토
3. 필요하면 새 옵션을 만드세요
<Note>
- 선택 옵션은 표시 레이블이 아니라 **API 이름**을 사용합니다. API 이름을 보려면 **Settings → Data Model**에서 **Advanced mode**를 활성화하세요.
+선택 옵션은 표시 레이블이 아니라 **API 이름**을 사용합니다. API 이름을 보려면 **Settings → Data Model**에서 **Advanced mode**를 활성화하세요.
</Note>
## 6단계: 오류 검토 및 수정
diff --git a/packages/twenty-docs/l/ko/user-guide/data-migration/how-tos/import-contacts-via-csv.mdx b/packages/twenty-docs/l/ko/user-guide/data-migration/how-tos/import-contacts-via-csv.mdx
index 95e8af1d9ae..6f68a23ed70 100644
--- a/packages/twenty-docs/l/ko/user-guide/data-migration/how-tos/import-contacts-via-csv.mdx
+++ b/packages/twenty-docs/l/ko/user-guide/data-migration/how-tos/import-contacts-via-csv.mdx
@@ -12,29 +12,29 @@ description: Twenty로 사람/연락처를 가져오는 포괄적인 단계별
### 사전 준비 체크리스트
<Check>
- 파일이 CSV, XLSX 또는 XLS 형식임
+파일이 CSV, XLSX 또는 XLS 형식임
</Check>
<Check>
- 파일의 레코드가 10,000개 미만임
+파일의 레코드가 10,000개 미만임
</Check>
<Check>
- 파일에 중복된 이메일 주소가 없음
+파일에 중복된 이메일 주소가 없음
</Check>
<Check>
- **회사를 먼저 가져옴**(사람을 회사에 연결하는 경우)
+**회사를 먼저 가져옴**(사람을 회사에 연결하는 경우)
</Check>
<Check>
- 모든 사용자 정의 필드가 **Settings → Data Model**에 존재함
+모든 사용자 정의 필드가 **Settings → Data Model**에 존재함
</Check>
<Warning>
- **사람보다 회사를 먼저 가져오기**
+**사람보다 회사를 먼저 가져오기**
- 사람을 회사에 연결하려면 먼저 회사를 가져오세요. 참조하려면 회사가 먼저 존재해야 합니다.
+사람을 회사에 연결하려면 먼저 회사를 가져오세요. 참조하려면 회사가 먼저 존재해야 합니다.
</Warning>
## 1단계: 연락처 데이터 준비
@@ -58,7 +58,7 @@ description: Twenty로 사람/연락처를 가져오는 포괄적인 단계별
* 추가 이메일은 **Emails / Additional Emails** 열을 사용하세요:
```
```
### 전화 형식
@@ -81,7 +81,7 @@ description: Twenty로 사람/연락처를 가져오는 포괄적인 단계별
| `companyId` | UUID | `c776ee49-f608-4a77-8cc8-6fe96ae1e43f` |
<Note>
- **도메인 URL 형식을 사용하세요**(`https://acme.com`), 라벨은 사용하지 마세요. 이는 Twenty에서 회사가 저장되는 방식과 일치합니다.
+**도메인 URL 형식을 사용하세요**(`https://acme.com`), 라벨은 사용하지 마세요. 이는 Twenty에서 회사가 저장되는 방식과 일치합니다.
</Note>
### CSV 예시 구조
@@ -93,7 +93,7 @@ Jane,Doe,[email protected],CTO,https://widgets.co,2125551234,US
```
<Note>
- **전문가 팁:** 가져오기 중에 **Download sample file**을 클릭하거나 기존 People 몇 명을 내보내 Twenty가 기대하는 정확한 열 이름을 확인하세요.
+**전문가 팁:** 가져오기 중에 **Download sample file**을 클릭하거나 기존 People 몇 명을 내보내 Twenty가 기대하는 정확한 열 이름을 확인하세요.
</Note>
## 2단계: 가져오기 기능에 액세스
@@ -145,9 +145,9 @@ Twenty가 열을 필드에 자동으로 매칭하려고 시도합니다. 검토
3. Twenty가 각 사람을 일치하는 회사에 연결합니다
<Warning>
- **관계에는 고유 식별자를 하나만 매핑하세요.**
+**관계에는 고유 식별자를 하나만 매핑하세요.**
- `companyId`와 `companyDomain`을 둘 다 매핑하지 마세요. 하나만 선택하세요—사람이 읽기 쉬우므로 도메인을 권장합니다.
+`companyId`와 `companyDomain`을 둘 다 매핑하지 마세요. 하나만 선택하세요—사람이 읽기 쉬우므로 도메인을 권장합니다.
</Warning>
## 5단계: 선택 필드 값 매핑
@@ -159,7 +159,7 @@ Twenty가 열을 필드에 자동으로 매칭하려고 시도합니다. 검토
3. 필요하면 새 옵션을 만드세요
<Note>
- 선택 옵션은 표시 레이블이 아니라 **API 이름**을 사용합니다. API 이름을 보려면 **Settings → Data Model**에서 **Advanced mode**를 활성화하세요.
+선택 옵션은 표시 레이블이 아니라 **API 이름**을 사용합니다. API 이름을 보려면 **Settings → Data Model**에서 **Advanced mode**를 활성화하세요.
</Note>
## 6단계: 오류 검토 및 수정
diff --git a/packages/twenty-docs/l/ko/user-guide/data-migration/how-tos/import-data-via-api.mdx b/packages/twenty-docs/l/ko/user-guide/data-migration/how-tos/import-data-via-api.mdx
index 99bafe9a2c4..21489589624 100644
--- a/packages/twenty-docs/l/ko/user-guide/data-migration/how-tos/import-data-via-api.mdx
+++ b/packages/twenty-docs/l/ko/user-guide/data-migration/how-tos/import-data-via-api.mdx
@@ -32,9 +32,9 @@ Twenty는 프로그램 방식의 데이터 가져오기를 위해 **GraphQL**
| **최대 처리량** | ~6,000 레코드/분 |
<Warning>
- **이 한도를 기준으로 가져오기 계획을 수립하세요.**
+**이 한도를 기준으로 가져오기 계획을 수립하세요.**
- 최대 처리량 기준으로 100,000개 레코드를 가져오는 데 약 17분이 소요됩니다. 오류 처리와 재시도를 위한 여유 시간을 추가하세요.
+최대 처리량 기준으로 100,000개 레코드를 가져오는 데 약 17분이 소요됩니다. 오류 처리와 재시도를 위한 여유 시간을 추가하세요.
</Warning>
## 시작하기
@@ -48,19 +48,19 @@ Twenty는 프로그램 방식의 데이터 가져오기를 위해 **GraphQL**
5. 안전하게 보관하세요.
<Warning>
- **API 키를 비공개로 유지하세요.**
+**API 키를 비공개로 유지하세요.**
- API 키를 가진 누구나 워크스페이스 데이터에 접근하고 수정할 수 있습니다. 코드 저장소에 커밋하거나 공개적으로 공유하지 마세요.
+API 키를 가진 누구나 워크스페이스 데이터에 접근하고 수정할 수 있습니다. 코드 저장소에 커밋하거나 공개적으로 공유하지 마세요.
</Warning>
### 2단계: 사용할 API 선택
Twenty는 두 가지 유형의 API를 지원합니다:
-| API | 적합한 용도 | 문서 |
-| ----------- | ----------------------------- | ---------------------------------------------- |
-| **GraphQL** | 유연한 쿼리, 연관 데이터 조회, 복잡한 작업에 적합 | [API 문서](/l/ko/developers/api) |
-| **REST** | 단순한 CRUD 작업, 익숙한 REST 패턴 | [API 문서](/l/ko/developers/api) |
+| API | 적합한 용도 | 문서 |
+| ----------- | ----------------------------- | -------------------------------- |
+| **GraphQL** | 유연한 쿼리, 연관 데이터 조회, 복잡한 작업에 적합 | [API 문서](/l/ko/developers/extend/api) |
+| **REST** | 단순한 CRUD 작업, 익숙한 REST 패턴 | [API 문서](/l/ko/developers/extend/api) |
두 API 모두 다음을 지원합니다:
@@ -173,4 +173,4 @@ GraphQL API는 **배치 업서트**를 지원합니다 — 레코드가 있으
전체 구현 세부정보, 코드 예제, 스키마 참조는 다음을 확인하세요:
-* [API 문서](/l/ko/developers/api)
+* [API 문서](/l/ko/developers/extend/api)
diff --git a/packages/twenty-docs/l/ko/user-guide/data-migration/how-tos/import-relations-between-objects-via-csv.mdx b/packages/twenty-docs/l/ko/user-guide/data-migration/how-tos/import-relations-between-objects-via-csv.mdx
index 6577d38a103..d81216f774e 100644
--- a/packages/twenty-docs/l/ko/user-guide/data-migration/how-tos/import-relations-between-objects-via-csv.mdx
+++ b/packages/twenty-docs/l/ko/user-guide/data-migration/how-tos/import-relations-between-objects-via-csv.mdx
@@ -51,9 +51,9 @@ description: CSV 가져오기 중 레코드 연결에 대한 완전한 단계별
4. **작업/노트**(위 항목 중 하나에 연결)
<Warning>
- **상위 레코드가 존재하지 않으면 가져오기는 실패합니다.**
+**상위 레코드가 존재하지 않으면 가져오기는 실패합니다.**
- 회사 참조가 있는 사람을 가져오기 전에 항상 회사를 먼저 가져왔는지 확인하세요.
+회사 참조가 있는 사람을 가져오기 전에 항상 회사를 먼저 가져왔는지 확인하세요.
</Warning>
## 3단계: 상위의 고유 식별자 확인
@@ -117,9 +117,9 @@ Bob,Johnson,[email protected],Developer,https://techstart.io
| ID | UUID | `c776ee49-f608-4a77-8cc8-6fe96ae1e43f` |
<Warning>
- **도메인 형식이 중요합니다!**
+**도메인 형식이 중요합니다!**
- `https://domain.com`을 사용하세요(`domain.com`만 사용하지 마세요). 이는 Twenty가 회사 도메인을 저장하는 방식과 일치하며, 매칭 오류를 방지합니다.
+`https://domain.com`을 사용하세요(`domain.com`만 사용하지 마세요). 이는 Twenty가 회사 도메인을 저장하는 방식과 일치하며, 매칭 오류를 방지합니다.
</Warning>
### 중요 규칙
@@ -178,7 +178,6 @@ Review proposal,[email protected]
<AccordionGroup>
<Accordion title="상위 레코드에 도메인이나 이메일이 없으면 어떻게 하나요?">
다음 두 가지 옵션이 있습니다:
-
1. Twenty의 `id`를 사용하세요(상위 레코드를 내보내 ID를 가져오세요)
2. 데이터 모델에 사용자 지정 고유 필드를 만들어 이전 시스템의 외부 ID를 저장하세요
</Accordion>
@@ -197,7 +196,6 @@ Review proposal,[email protected]
<Accordion title="상위 레코드가 존재하지 않으면 어떻게 되나요?">
해당 행에 대해 가져오기가 오류를 표시합니다. 다음 두 가지 방법 중 하나로 가능합니다:
-
* 상위 레코드를 먼저 가져온 뒤 다시 가져오세요
* 참조 값을 수정하세요
* 가져오기에서 해당 행을 제거하세요
@@ -205,7 +203,6 @@ Review proposal,[email protected]
<Accordion title="관계가 올바르게 연결되지 않는 이유는 무엇인가요?">
일반적인 원인:
-
* 잘못된 형식(도메인은 `https://domain.com`을 사용)
* 대소문자 불일치(정확한 철자 확인)
* 상위가 존재하지 않음(상위를 먼저 가져오기)
@@ -214,9 +211,9 @@ Review proposal,[email protected]
</AccordionGroup>
<Warning>
- **기억하세요: 소프트 삭제된 레코드도 고유성에 포함됩니다.**
+**기억하세요: 소프트 삭제된 레코드도 고유성에 포함됩니다.**
- 레코드가 존재하는 것처럼 보이는데도 "not found" 오류가 발생한다면, Command Menu → See deleted records를 확인하세요. 상위가 소프트 삭제되었을 수 있습니다.
+레코드가 존재하는 것처럼 보이는데도 "not found" 오류가 발생한다면, Command Menu → See deleted records를 확인하세요. 상위가 소프트 삭제되었을 수 있습니다.
</Warning>
## 문제 해결
diff --git a/packages/twenty-docs/l/ko/user-guide/data-migration/how-tos/migrating-from-other-crms.mdx b/packages/twenty-docs/l/ko/user-guide/data-migration/how-tos/migrating-from-other-crms.mdx
index 7b0eb026388..62c963d4186 100644
--- a/packages/twenty-docs/l/ko/user-guide/data-migration/how-tos/migrating-from-other-crms.mdx
+++ b/packages/twenty-docs/l/ko/user-guide/data-migration/how-tos/migrating-from-other-crms.mdx
@@ -59,17 +59,17 @@ description: 어떤 CRM에서든 데이터를 Twenty로 마이그레이션하는
4. 필드 설정(고유, 필수, 선택 옵션 등)을 구성하세요
<Warning>
- **가져오기 전에 필드가 존재해야 합니다.**
+**가져오기 전에 필드가 존재해야 합니다.**
- CSV 가져오기는 필드가 아니라 레코드를 생성합니다. 가져오기 전에 **설정 → 데이터 모델**에서 사용자 지정 필드를 생성하세요.
+CSV 가져오기는 필드가 아니라 레코드를 생성합니다. 가져오기 전에 **설정 → 데이터 모델**에서 사용자 지정 필드를 생성하세요.
</Warning>
### 팀 초대
<Warning>
- **데이터를 가져오기 전에 사용자를 초대하세요.**
+**데이터를 가져오기 전에 사용자를 초대하세요.**
- 데이터에 사용자 참조(계정 소유자, 담당자 등)가 포함되어 있다면, 가져오기 전에 해당 사용자가 Twenty에 존재해야 합니다. 그렇지 않으면 해당 관계를 매핑할 수 없습니다.
+데이터에 사용자 참조(계정 소유자, 담당자 등)가 포함되어 있다면, 가져오기 전에 해당 사용자가 Twenty에 존재해야 합니다. 그렇지 않으면 해당 관계를 매핑할 수 없습니다.
</Warning>
1. **설정 → 구성원**으로 이동하세요.
@@ -116,9 +116,9 @@ description: 어떤 CRM에서든 데이터를 Twenty로 마이그레이션하는
| **선택 필드** | 표시 레이블이 아니라 API 이름을 사용하세요 |
<Warning>
- **도메인 형식이 중요합니다.**
+**도메인 형식이 중요합니다.**
- `https://domain.com`을 사용하세요(`domain.com` 또는 `www.domain.com`은 사용하지 마세요). 이는 Twenty의 형식과 일치하며 이메일/캘린더 동기화를 연결할 때 중복을 방지합니다.
+`https://domain.com`을 사용하세요(`domain.com` 또는 `www.domain.com`은 사용하지 마세요). 이는 Twenty의 형식과 일치하며 이메일/캘린더 동기화를 연결할 때 중복을 방지합니다.
</Warning>
모든 필드 유형에 대한 전체 형식 요구 사항은 [CSV 파일 준비 방법](/l/ko/user-guide/data-migration/how-tos/prepare-your-csv-files)을 참조하세요.
@@ -149,17 +149,16 @@ Jane,Doe,[email protected],https://widgets.co
## 6단계: Twenty로 가져오기
<Warning>
- **가져오기 순서가 중요합니다!**
+**가져오기 순서가 중요합니다!**
- 항상 다음 순서로 가져오세요:
+항상 다음 순서로 가져오세요:
+1. **회사** 먼저(종속성 없음)
+2. 그다음 **사람**(회사에 연결)
+3. **기회** 세 번째(회사/사람에 연결)
+4. **노트와 작업**(레코드에 연결)
+5. **사용자 지정 객체**(종속성에 따름)
- 1. **회사** 먼저(종속성 없음)
- 2. 그다음 **사람**(회사에 연결)
- 3. **기회** 세 번째(회사/사람에 연결)
- 4. **노트와 작업**(레코드에 연결)
- 5. **사용자 지정 객체**(종속성에 따름)
-
- 참조하려면 상위 레코드가 먼저 존재해야 합니다.
+참조하려면 상위 레코드가 먼저 존재해야 합니다.
</Warning>
### 각 객체 가져오기
@@ -215,7 +214,7 @@ Jane,Doe,[email protected],https://widgets.co
### 역할 및 권한 구성
-* **설정 → 역할**에서 역할을 설정하세요
+* **설정 → 구성원 → 역할**에서 역할을 설정하세요
* 적절한 역할에 사용자를 할당하세요
### 이메일 및 캘린더 연결
diff --git a/packages/twenty-docs/l/ko/user-guide/data-migration/how-tos/migrating-from-self-hosted-to-cloud.mdx b/packages/twenty-docs/l/ko/user-guide/data-migration/how-tos/migrating-from-self-hosted-to-cloud.mdx
index d08241ed7d0..39be6ecb281 100644
--- a/packages/twenty-docs/l/ko/user-guide/data-migration/how-tos/migrating-from-self-hosted-to-cloud.mdx
+++ b/packages/twenty-docs/l/ko/user-guide/data-migration/how-tos/migrating-from-self-hosted-to-cloud.mdx
@@ -29,9 +29,9 @@ description: Twenty 자가 호스팅 인스턴스를 Twenty Cloud로 마이그
## 3단계: 모든 사용자 초대
<Warning>
- **중요: 데이터를 가져오기 전에 사용자를 초대하세요.**
+**중요: 데이터를 가져오기 전에 사용자를 초대하세요.**
- 사용자가 참조되는 레코드(예: Account Owner 필드)를 가져오기 전에 초대를 수락해야 합니다. 사용자가 아직 존재하지 않으면 해당 관계를 매핑할 수 없습니다.
+사용자가 참조되는 레코드(예: Account Owner 필드)를 가져오기 전에 초대를 수락해야 합니다. 사용자가 아직 존재하지 않으면 해당 관계를 매핑할 수 없습니다.
</Warning>
1. 클라우드 인스턴스에서 **설정 → 멤버**로 이동하세요
@@ -127,7 +127,7 @@ Acme Corp,https://acme.com,[email protected]
### 역할 및 권한
-* **설정 → 역할**에서 역할을 구성하세요
+* **설정 → 구성원 → 역할**에서 역할을 설정하세요
* 적절한 역할에 사용자를 할당하세요
### 통합
diff --git a/packages/twenty-docs/l/ko/user-guide/data-migration/how-tos/prepare-your-csv-files.mdx b/packages/twenty-docs/l/ko/user-guide/data-migration/how-tos/prepare-your-csv-files.mdx
index f1f382a858d..06f0bfedef8 100644
--- a/packages/twenty-docs/l/ko/user-guide/data-migration/how-tos/prepare-your-csv-files.mdx
+++ b/packages/twenty-docs/l/ko/user-guide/data-migration/how-tos/prepare-your-csv-files.mdx
@@ -103,8 +103,6 @@ Address는 여러 열로 구성된 **중첩 필드**이며(일부는 비워 둘
파일 전체에서 일관된 형식을 사용하세요:
* `YYYY-MM-DD` (권장): `2024-03-15`
-* `MM/DD/YYYY`: `03/15/2024`
-* `DD/MM/YYYY`: `15/03/2024`
* ISO 8601: `2024-03-15T10:30:00Z`
### 숫자 필드
@@ -146,7 +144,7 @@ Address는 여러 열로 구성된 **중첩 필드**이며(일부는 비워 둘
배열 형식으로 API 이름을 사용:
```
-[\"VALUE1\",\"VALUE2\"]
+["VALUE1","VALUE2"]
```
### 배열 필드
@@ -154,7 +152,7 @@ Address는 여러 열로 구성된 **중첩 필드**이며(일부는 비워 둘
JSON 배열 형식 사용:
```
-[\"value1\",\"value2\"]
+["value1","value2"]
```
### 평점 필드
@@ -171,7 +169,7 @@ JSON 배열 형식 사용:
보조 링크의 경우 **Links / Secondary Links** 열을 사용하세요:
```
-[{\"url\":\"https://twenty.com\",\"label\":\"Twenty\"}]
+[{"url":"https://twenty.com","label":"Twenty"}]
```
### JSON 필드
@@ -179,7 +177,7 @@ JSON 배열 형식 사용:
유효한 JSON 형식을 사용:
```
-{\"key\":\"value\",\"key2\":\"value2\"}
+{"key":"value","key2":"value2"}
```
### ID 필드
@@ -210,15 +208,14 @@ Jane,Doe,[email protected],https://widgets.co
* 워크스페이스 구성원은 이름이 아닌 **이메일**을 사용하세요
<Warning>
- **가져오기 순서가 중요합니다!**
+**가져오기 순서가 중요합니다!**
- "one" 측을 "many" 측보다 먼저 가져오세요:
+"one" 측을 "many" 측보다 먼저 가져오세요:
+1. **회사** 먼저
+2. **연락처** 두 번째(회사 참조 포함)
+3. **기회** 세 번째
- 1. **회사** 먼저
- 2. **연락처** 두 번째(회사 참조 포함)
- 3. **기회** 세 번째
-
- 참조하려면 상위 레코드가 먼저 존재해야 합니다.
+참조하려면 상위 레코드가 먼저 존재해야 합니다.
</Warning>
자세한 지침은 [관계 가져오기 방법](/l/ko/user-guide/data-migration/how-tos/import-relations-between-objects-via-csv)을 참조하세요.
diff --git a/packages/twenty-docs/l/ko/user-guide/data-migration/how-tos/update-existing-records-via-import.mdx b/packages/twenty-docs/l/ko/user-guide/data-migration/how-tos/update-existing-records-via-import.mdx
index 7e0d0ea6ff8..4c0e9830cac 100644
--- a/packages/twenty-docs/l/ko/user-guide/data-migration/how-tos/update-existing-records-via-import.mdx
+++ b/packages/twenty-docs/l/ko/user-guide/data-migration/how-tos/update-existing-records-via-import.mdx
@@ -25,11 +25,11 @@ description: CSV 가져오기를 사용해 레코드를 일괄 업데이트하
| 파일에 없음 | **생성** 새 레코드(자동 생성된 ID 포함) |
<Warning>
- **다중 선택 필드는 병합되지 않고 덮어써집니다.**
+**다중 선택 필드는 병합되지 않고 덮어써집니다.**
- 레코드에 `Option A`와 `Option B`가 선택되어 있고 `[\"Option C\"]`를 가져오면, 가져온 후 해당 레코드에는 `Option C`만 남습니다. 가져오면 이전 선택 항목이 모두 대체됩니다 — 기존 선택에 추가되지 않습니다.
+레코드에 `Option A`와 `Option B`가 선택되어 있고 `["Option C"]`를 가져오면, 가져온 후 해당 레코드에는 `Option C`만 남습니다. 가져오면 이전 선택 항목이 모두 대체됩니다 — 기존 선택에 추가되지 않습니다.
- 기존 값을 유지하려면 가져오기에 모두 포함하세요: `[\"Option A\",\"Option B\",\"Option C\"]`
+기존 값을 유지하려면 가져오기에 모두 포함하세요: `["Option A","Option B","Option C"]`
</Warning>
## 1단계: 현재 데이터 내보내기
@@ -80,9 +80,9 @@ id,email,firstName,lastName,jobTitle
```
<Warning>
- **고유 식별자 값을 변경하지 마세요.**
+**고유 식별자 값을 변경하지 마세요.**
- `[email protected]`을 `[email protected]`으로 변경하면 Twenty는 기존 레코드를 업데이트하는 대신 새 레코드를 생성합니다.
+`[email protected]`을 `[email protected]`으로 변경하면 Twenty는 기존 레코드를 업데이트하는 대신 새 레코드를 생성합니다.
</Warning>
## 3단계: 업데이트된 파일 가져오기
diff --git a/packages/twenty-docs/l/ko/user-guide/data-migration/overview.mdx b/packages/twenty-docs/l/ko/user-guide/data-migration/overview.mdx
index 935a6e72efe..0ccfca8b12d 100644
--- a/packages/twenty-docs/l/ko/user-guide/data-migration/overview.mdx
+++ b/packages/twenty-docs/l/ko/user-guide/data-migration/overview.mdx
@@ -5,7 +5,6 @@ description: CSV 파일 또는 API를 통해 CRM 데이터를 가져오고 내
import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
-
## 가져오기 방법
Twenty는 데이터를 가져오는 두 가지 주요 방법을 지원합니다:
@@ -40,16 +39,15 @@ CSV 가져오기 기능을 사용하여 객체 간의 관계를 가져올 수
<Note>**삭제된 레코드도 고유성에 포함됩니다.** 소프트 삭제된 레코드(Command Menu → See deleted records에서 표시됨) 역시 고유성 검사에 포함됩니다. 삭제된 레코드와 동일한 고유 값을 가진 레코드를 가져오면, 해당 삭제된 레코드가 복원됩니다.</Note>
<Warning>
- **가져오기 순서가 중요합니다!**
-
- 연관된 객체를 가져올 때 파일을 다음 순서로 업로드하세요:
+**가져오기 순서가 중요합니다!**
- 1. **Companies** 먼저(일대다 관계의 '1' 측)
- 2. **People** 두 번째(companyId를 통해 회사에 연결)
- 3. **Opportunities** 세 번째(회사/People에 연결)
- 4. 관계가 있는 **사용자 지정 객체**는 마지막
+연관된 객체를 가져올 때 파일을 다음 순서로 업로드하세요:
+1. **Companies** 먼저(일대다 관계의 '1' 측)
+2. **People** 두 번째(companyId를 통해 회사에 연결)
+3. **Opportunities** 세 번째(회사/People에 연결)
+4. 관계가 있는 **사용자 지정 객체**는 마지막
- 왜 그런가요? 일대다 관계의 '1' 측은 참조하기 전에 먼저 존재해야 합니다. 예를 들어, 해당 회사의 ID로 Person을 가져오기 전에 Company 레코드가 먼저 존재해야 합니다.
+왜 그런가요? 일대다 관계의 '1' 측은 참조하기 전에 먼저 존재해야 합니다. 예를 들어, 해당 회사의 ID로 Person을 가져오기 전에 Company 레코드가 먼저 존재해야 합니다.
</Warning>
단계별 진행 방법은 [이 문서](/l/ko/user-guide/data-migration/how-tos/import-relations-between-objects-via-csv)를 참고하세요.
diff --git a/packages/twenty-docs/l/ko/user-guide/data-model/capabilities/fields.mdx b/packages/twenty-docs/l/ko/user-guide/data-model/capabilities/fields.mdx
index 4b238df85c0..7e0555645f2 100644
--- a/packages/twenty-docs/l/ko/user-guide/data-model/capabilities/fields.mdx
+++ b/packages/twenty-docs/l/ko/user-guide/data-model/capabilities/fields.mdx
@@ -101,6 +101,10 @@ Twenty는 다양한 필드 유형을 지원합니다:
고유성을 설정할 때 오류가 발생하면 데이터(삭제된 레코드를 포함하여)에서 중복 값을 확인하세요.
+## 인덱스 (고급)
+
+데이터베이스 인덱스는 자동으로 관리되며, 직접 추가해야 하는 경우는 드물고 실수하기 쉽습니다. 고급 모드를 켜면, 필요한 경우를 대비해 각 오브젝트의 `Settings → Data Model → <object>` 아래에 **Indexes** 섹션이 생깁니다.
+
## 필드 구성 모범 사례
### 명명 규칙 및 제한 사항
diff --git a/packages/twenty-docs/l/ko/user-guide/data-model/capabilities/relation-fields.mdx b/packages/twenty-docs/l/ko/user-guide/data-model/capabilities/relation-fields.mdx
index 7a388cefc25..e365f22a6df 100644
--- a/packages/twenty-docs/l/ko/user-guide/data-model/capabilities/relation-fields.mdx
+++ b/packages/twenty-docs/l/ko/user-guide/data-model/capabilities/relation-fields.mdx
@@ -30,7 +30,7 @@ description: 관계 필드를 사용하여 서로 다른 객체의 레코드를
<img src="/images/user-guide/fields/one-to-many-morph.png" style={{width:'100%'}} />
<Warning>
- **가져오기/내보내기 제한 사항**: 여러 객체 유형을 가리키는 관계는 CSV 가져오기/내보내기에서 아직 지원되지 않습니다. 이는 로드맵에 포함되어 있습니다.
+**가져오기/내보내기 제한 사항**: 여러 객체 유형을 가리키는 관계는 CSV 가져오기/내보내기에서 아직 지원되지 않습니다. 이는 로드맵에 포함되어 있습니다.
</Warning>
### 다대다
@@ -44,7 +44,7 @@ description: 관계 필드를 사용하여 서로 다른 객체의 레코드를
<img src="/images/user-guide/fields/junction-relation-diagram.png" style={{width:'100%'}} />
<Warning>
- **실험실 기능**: 사용하려면 **Settings → Updates → Lab**에서 연결 관계를 활성화해야 합니다.
+**실험실 기능**: 사용하려면 **Settings → Updates → Lab**에서 연결 관계를 활성화해야 합니다.
</Warning>
자세한 단계별 가이드는 [다대다 관계 생성 방법](/l/ko/user-guide/data-model/how-tos/create-many-to-many-relations)을 참조하세요.
diff --git a/packages/twenty-docs/l/ko/user-guide/data-model/how-tos/create-custom-fields.mdx b/packages/twenty-docs/l/ko/user-guide/data-model/how-tos/create-custom-fields.mdx
index b6292c4ea12..44dfd391dc8 100644
--- a/packages/twenty-docs/l/ko/user-guide/data-model/how-tos/create-custom-fields.mdx
+++ b/packages/twenty-docs/l/ko/user-guide/data-model/how-tos/create-custom-fields.mdx
@@ -35,7 +35,7 @@ description: 모든 객체에 사용자 정의 필드를 추가하는 단계별
3. 드래그하여 옵션 순서를 변경합니다
<Note>
- **가져오기에는 API 이름을 사용하세요.** API 이름을 보려면 설정에서 **고급 모드**를 활성화하세요. [필드 매핑](/l/ko/user-guide/data-migration/capabilities/field-mapping)을 참조하세요.
+**가져오기에는 API 이름을 사용하세요.** API 이름을 보려면 설정에서 **고급 모드**를 활성화하세요. [필드 매핑](/l/ko/user-guide/data-migration/capabilities/field-mapping)을 참조하세요.
</Note>
### 통화 필드의 경우
@@ -51,7 +51,7 @@ description: 모든 객체에 사용자 정의 필드를 추가하는 단계별
레코드 전체에서 중복 값을 방지하려면 **고유**를 전환합니다.
<Note>
- 중복이 존재하면(삭제된 레코드를 포함) 오류가 발생합니다. 먼저 중복을 정리하세요.
+중복이 존재하면(삭제된 레코드를 포함) 오류가 발생합니다. 먼저 중복을 정리하세요.
</Note>
### 기본값 설정
diff --git a/packages/twenty-docs/l/ko/user-guide/data-model/how-tos/create-custom-objects.mdx b/packages/twenty-docs/l/ko/user-guide/data-model/how-tos/create-custom-objects.mdx
index 05df00eac94..ebfbeec76f1 100644
--- a/packages/twenty-docs/l/ko/user-guide/data-model/how-tos/create-custom-objects.mdx
+++ b/packages/twenty-docs/l/ko/user-guide/data-model/how-tos/create-custom-objects.mdx
@@ -6,7 +6,7 @@ description: Twenty에서 사용자 정의 객체를 생성하는 단계별 가
사용자 정의 객체를 사용하면 표준 객체에서 다루지 않는, 비즈니스에 고유한 정보를 저장할 수 있습니다. 예: 프로젝트, 제품, 티켓 또는 리스팅.
<Note>
- **객체가 필요한지 필드가 필요한지 확신이 없나요?** 자세한 내용은 [데이터 모델 이해](/l/ko/user-guide/data-model/overview)를 참조하세요.
+**객체가 필요한지 필드가 필요한지 확신이 없나요?** 자세한 내용은 [데이터 모델 이해](/l/ko/user-guide/data-model/overview)를 참조하세요.
</Note>
## 단계
diff --git a/packages/twenty-docs/l/ko/user-guide/data-model/how-tos/create-many-to-many-relations.mdx b/packages/twenty-docs/l/ko/user-guide/data-model/how-tos/create-many-to-many-relations.mdx
index 547574b10aa..1731b717379 100644
--- a/packages/twenty-docs/l/ko/user-guide/data-model/how-tos/create-many-to-many-relations.mdx
+++ b/packages/twenty-docs/l/ko/user-guide/data-model/how-tos/create-many-to-many-relations.mdx
@@ -6,11 +6,11 @@ description: 정션 오브젝트를 사용하여 양쪽에서 여러 항목이
다대다 관계를 사용하면 양쪽에서 여러 레코드를 연결할 수 있습니다. 예: 여러 사람은 여러 프로젝트에서 작업할 수 있으며, 각 프로젝트에는 많은 사람이 포함될 수 있습니다.
<Warning>
- **Lab 기능**: 정션 관계는 현재 Lab에서 제공됩니다. 이 가이드를 진행하기 전에 **Settings → Updates → Lab**에서 이를 활성화하세요.
+**Lab 기능**: 정션 관계는 현재 Lab에서 제공됩니다. 이 가이드를 진행하기 전에 **Settings → Updates → Lab**에서 이를 활성화하세요.
</Warning>
<Note>
- 이 기능을 사용하려면 **Advanced mode**도 활성화되어 있어야 합니다(설정 오른쪽 하단의 토글).
+이 기능을 사용하려면 **Advanced mode**도 활성화되어 있어야 합니다(설정 오른쪽 하단의 토글).
</Note>
## 다대다 관계를 사용할 때
@@ -53,38 +53,45 @@ People ←→ Project Assignments ←→ Projects
1. **설정 → 데이터 모델**로 이동
2. **+ 새 객체**를 클릭합니다
3. 설명을 담은 이름을 지정하세요(예: "Project Assignment", "Team Member", "Product Order")
-4. **저장**을 클릭합니다
+4. "이름 필드 생성을 건너뛰기"를 켭니다
+
+<img src="/images/user-guide/fields/new-pivot-object.png" alt="새 피벗 오브젝트" />
+
+5. **저장**을 클릭합니다
<Tip>
- **명명 규칙**: "Project Assignment" 또는 "Team Membership"처럼 관계를 설명하는 이름을 사용하세요. 이렇게 하면 데이터 모델을 더 쉽게 이해할 수 있습니다.
+**명명 규칙**: "Project Assignment" 또는 "Team Membership"처럼 관계를 설명하는 이름을 사용하세요. 이렇게 하면 데이터 모델을 더 쉽게 이해할 수 있습니다.
</Tip>
-## 2단계: 정션 오브젝트에서 관계 생성
+## 2단계: 오브젝트와 정션 간 관계 만들기
-연결하려는 두 오브젝트를 대상으로 정션 오브젝트에서 관계 필드를 추가하세요.
+두 개의 오브젝트 각각에서 정션 오브젝트로 관계 필드를 추가합니다.
-### 첫 번째 관계(정션 → 오브젝트 A)
+### 첫 번째 관계(오브젝트 A → 정션)
-1. **Settings → Data Model**에서 정션 오브젝트를 선택하세요
-2. **+ 필드 추가**를 클릭합니다
-3. 필드 유형으로 **Relation**을 선택하세요
-4. 첫 번째 오브젝트를 선택하세요(예: "People")
-5. 관계 유형을 **Many-to-One**으로 설정하세요(여러 할당이 한 사람에 연결될 수 있음)
-6. 필드 이름 지정:
- * 정션의 필드: 예: "Person"
+1. **Settings → Data Model**에서 첫 번째 오브젝트를 선택하세요
+2. **+ 관계 추가**를 클릭합니다
+3. 정션 오브젝트를 선택하세요(예: "Project Assignments")
+4. 관계 유형을 **One-To-Many**로 설정합니다(한 사람이 여러 할당에 연결될 수 있음)
+5. 필드 이름 지정:
* People의 필드: 예: "Project Assignments"
-7. **저장**을 클릭합니다
+ * 정션의 필드: 예: "Person"
+6. **저장**을 클릭합니다
-### 두 번째 관계(정션 → 오브젝트 B)
+### 두 번째 관계(오브젝트 B → 정션)
-1. 정션 오브젝트에서 **+ Add Field**를 클릭하세요
-2. 필드 유형으로 **Relation**을 선택하세요
-3. 두 번째 오브젝트를 선택하세요(예: "Projects")
-4. 관계 유형을 **Many-to-One**으로 설정하세요
-5. 필드 이름 지정:
+1. **Settings → Data Model**에서 두 번째 오브젝트를 선택하세요
+2. **+ 관계 추가**를 클릭합니다
+3. 정션 오브젝트를 선택하세요(예: "Project Assignments")
+4. 관계 유형을 **One-To-Many**로 설정합니다(하나의 프로젝트가 여러 할당에 연결될 수 있음)
+5. \*\*"This is a relation to a Junction Object"\*\*를 활성화하세요
+
+<img src="/images/user-guide/fields/junction-relation-toggle.png" style={{width:'100%'}} />
+
+6. 필드 이름 지정:
* 정션의 필드: 예: "Project"
* Projects의 필드: 예: "Team Members"
-6. **저장**을 클릭합니다
+7. **저장**을 클릭합니다
## 3단계: 정션 관계 표시 구성
@@ -98,18 +105,6 @@ People ←→ Project Assignments ←→ Projects
6. **Target relation**을 선택하세요(예: "Project" — 반대편을 가리키는 정션의 필드)
7. **저장**을 클릭합니다
-{/* TODO: Add image
-<img src="/images/user-guide/fields/junction-relation-toggle.png" style={{width:'100%'}}/>
-*/}
-
-다른 오브젝트에 대해서도 반복하세요:
-
-1. Data Model에서 "Projects"를 선택하세요
-2. "Team Members" 관계 필드를 편집하세요
-3. 정션 토글을 활성화하세요
-4. 대상 관계로 "Person"을 선택하세요
-5. 저장
-
## 결과
구성 후:
@@ -130,15 +125,15 @@ People ←→ Project Assignments ←→ Projects
### 관계 추가
-1. **Project Assignment → People**
- * 유형: Many-to-One
- * Assignment의 필드: "Person"
+1. **People → Project Assignment**
+ * 유형: One-to-Many
* People의 필드: "Project Assignments"
+ * Assignment의 필드: "Person"
-2. **Project Assignment → Projects**
- * 유형: Many-to-One
- * Assignment의 필드: "Project"
+2. **Projects → Project Assignment**
+ * 유형: One-to-Many
* Projects의 필드: "Team Members"
+ * Assignment의 필드: "Project"
### 정션 표시 구성
diff --git a/packages/twenty-docs/l/ko/user-guide/data-model/how-tos/create-relation-fields.mdx b/packages/twenty-docs/l/ko/user-guide/data-model/how-tos/create-relation-fields.mdx
index 7f31ab602a6..77038d75eab 100644
--- a/packages/twenty-docs/l/ko/user-guide/data-model/how-tos/create-relation-fields.mdx
+++ b/packages/twenty-docs/l/ko/user-guide/data-model/how-tos/create-relation-fields.mdx
@@ -6,7 +6,7 @@ description: 관계 필드를 사용하여 객체를 연결하는 단계별 가
관계 필드는 서로 다른 객체의 레코드를 연결합니다—예: 사람을 회사에 연결.
<Note>
- **관계 이름은 생성 후 변경할 수 없습니다** (API에 영향을 줍니다). 이름을 신중하게 계획하세요.
+**관계 이름은 생성 후 변경할 수 없습니다** (API에 영향을 줍니다). 이름을 신중하게 계획하세요.
</Note>
## 시작하기 전에
@@ -51,7 +51,7 @@ description: 관계 필드를 사용하여 객체를 연결하는 단계별 가
연결은 유지되지만 숨겨집니다. 복원하려면 다시 활성화하세요.
<Note>
- **관계를 삭제해도 레코드는 삭제되지 않습니다.** 둘 사이의 연결만 제거됩니다.
+**관계를 삭제해도 레코드는 삭제되지 않습니다.** 둘 사이의 연결만 제거됩니다.
</Note>
## 관련 항목
diff --git a/packages/twenty-docs/l/ko/user-guide/data-model/how-tos/data-model-faq.mdx b/packages/twenty-docs/l/ko/user-guide/data-model/how-tos/data-model-faq.mdx
index b13914d44a2..cf395793b1a 100644
--- a/packages/twenty-docs/l/ko/user-guide/data-model/how-tos/data-model-faq.mdx
+++ b/packages/twenty-docs/l/ko/user-guide/data-model/how-tos/data-model-faq.mdx
@@ -6,148 +6,147 @@ description: Twenty의 데이터 모델에 대한 자주 묻는 질문입니다.
## 객체 관리
<AccordionGroup>
- <Accordion title="사용자 정의 객체를 삭제할 수 있나요?">
- 예, 사용자 정의 객체는 삭제할 수 있습니다. 먼저 비활성화할 수도 있습니다. 이렇게 하면 데이터는 보존하면서 객체와 그 데이터를 인터페이스에서 숨깁니다.
- </Accordion>
+<Accordion title="사용자 정의 객체를 삭제할 수 있나요?">
+예, 사용자 정의 객체는 삭제할 수 있습니다. 먼저 비활성화할 수도 있습니다. 이렇게 하면 데이터는 보존하면서 객체와 그 데이터를 인터페이스에서 숨깁니다.
+</Accordion>
- <Accordion title="표준 객체(사람, 회사 등)를 삭제할 수 있습니까?">
- 아니요, 표준 객체는 삭제할 수 없습니다. 비활성화만 할 수 있으며, 인터페이스에서는 숨겨지지만 데이터는 보존됩니다.
- </Accordion>
+<Accordion title="표준 객체(사람, 회사 등)를 삭제할 수 있습니까?">
+아니요, 표준 객체는 삭제할 수 없습니다. 비활성화만 할 수 있으며, 인터페이스에서는 숨겨지지만 데이터는 보존됩니다.
+</Accordion>
- <Accordion title="사용자 정의 객체는 몇 개까지 만들 수 있나요?">
- 필요한 만큼 사용자 정의 객체와 필드를 만들 수 있으며, 가격은 변동하지 않습니다.
- </Accordion>
+<Accordion title="사용자 정의 객체는 몇 개까지 만들 수 있나요?">
+필요한 만큼 사용자 정의 객체와 필드를 만들 수 있으며, 가격은 변동하지 않습니다.
+</Accordion>
- <Accordion title="표준 객체의 이름을 바꿀 수 있나요?">
- 표준 객체(사람, 회사, 기회)의 레이블은 변경할 수 있지만, API 이름은 변경할 수 없습니다. 모든 Twenty 워크스페이스에서의 일관성을 위해 API 이름은 고정되어 있습니다.
- </Accordion>
+<Accordion title="표준 객체의 이름을 바꿀 수 있나요?">
+표준 객체(사람, 회사, 기회)의 레이블은 변경할 수 있지만, API 이름은 변경할 수 없습니다. 모든 Twenty 워크스페이스에서의 일관성을 위해 API 이름은 고정되어 있습니다.
+</Accordion>
- <Accordion title="객체의 아이콘을 변경할 수 있나요?">
- 예, **설정 → 데이터 모델**에서 표준 객체와 사용자 정의 객체 모두의 아이콘을 변경할 수 있습니다.
- </Accordion>
+<Accordion title="객체의 아이콘을 변경할 수 있나요?">
+예, **설정 → 데이터 모델**에서 표준 객체와 사용자 정의 객체 모두의 아이콘을 변경할 수 있습니다.
+</Accordion>
- <Accordion title="왼쪽 탐색 모음에서 객체 순서를 변경할 수 있습니까?">
- 아직 안 됩니다. 탐색의 객체 순서는 현재 고정되어 있으며, 이 기능은 향후 릴리스에 계획되어 있습니다.
- </Accordion>
+<Accordion title="왼쪽 탐색 모음에서 객체 순서를 변경할 수 있습니까?">
+아직 안 됩니다. 탐색의 객체 순서는 현재 고정되어 있으며, 이 기능은 향후 릴리스에 계획되어 있습니다.
+</Accordion>
- <Accordion title="왼쪽 탐색 모음에서 객체를 숨길 수 있습니까?">
- 모든 활성 객체는 탐색에 나타납니다. **설정 → 데이터 모델**에서 필요 없는 객체를 비활성화할 수 있습니다.
- </Accordion>
+<Accordion title="왼쪽 탐색 모음에서 객체를 숨길 수 있습니까?">
+모든 활성 객체는 탐색에 나타납니다. **설정 → 데이터 모델**에서 필요 없는 객체를 비활성화할 수 있습니다.
+</Accordion>
</AccordionGroup>
## 필드 기능
<AccordionGroup>
- <Accordion title="생성 후에 필드 유형을 변경할 수 있나요?">
- 아니요, 생성 후에는 필드 유형을 변경할 수 없습니다. 다른 유형이 필요하다면 올바른 유형의 새 필드를 만들고 데이터를 마이그레이션한 다음 이전 필드를 비활성화하세요.
- </Accordion>
-
- <Accordion title="단수 및 복수 이름이 필요한 이유는 무엇입니까?">
- 우리의 GraphQL API는 다양한 작업에서 두 형식을 모두 사용합니다:
-
- * 단일 기록 작업을 위한 `createPerson` (단수)
- * 대량 작업을 위한 `createPeople` (복수)
-
- 단수 및 복수 형식이 동일할 때 제한이 있지만, 개발자 경험을 향상시킵니다.
- </Accordion>
-
- <Accordion title="왜 일부 필드 이름은 보호됩니까?">
- `Type` 또는 `Application`과 같은 특정 필드 이름은 시스템 사용을 위해 예약되어 있습니다. 대신 `Category` 또는 `Classification`과 같은 대체 이름을 선택하세요.
- </Accordion>
-
- <Accordion title="필드를 비활성화하면 어떻게 되나요?">
- * 필드는 인터페이스에서 숨겨집니다
- * 기존 데이터는 보존됩니다
- * API를 통해 해당 필드에 계속 액세스할 수 있습니다
- * 기존 관계는 유지되지만 새 관계를 생성할 수는 없습니다
- * 필드는 나중에 다시 활성화할 수 있습니다
- </Accordion>
-
- <Accordion title="필드를 필수로 설정할 수 있나요?">
- 현재는 사용자 정의 필드를 필수로 설정할 수 없습니다. 모든 필드는 빈 값을 허용합니다. 필드가 비어 있을 때 알림을 보내거나 동작을 차단하는 워크플로우를 사용해 필수 필드를 강제할 수 있습니다.
- </Accordion>
-
- <Accordion title="고유와 필수의 차이는 무엇인가요?">
- * **고유**: 두 레코드가 이 필드에 동일한 값을 가질 수 없습니다
- * **필수**: 필드에 값이 있어야 합니다(현재 사용자 정의 필드에서는 지원되지 않음)
- </Accordion>
-
- <Accordion title="수식 필드를 만들 수 있습니까?">
- 수식 필드는 **2026년 1분기**에 제공될 예정입니다. 현재는 워크플로를 사용하여 필드 값을 자동으로 계산하고 업데이트할 수 있습니다.
- </Accordion>
-
- <Accordion title="내 객체에 중첩 필드를 가질 수 있습니까?">
- 중첩 필드는 **2026년 1분기**에 제공될 예정입니다. 현재로서는 관련 객체의 필드 값을 가져오려면 워크플로를 사용할 수 있습니다. 예를 들어, 회사의 산업을 사람 기록에 표시하려면 사람에 대한 사용자 정의 필드를 만들고 워크플로를 사용하여 값을 동기화하세요.
- </Accordion>
-
- <Accordion title="객체 내에서 필드를 정렬할 수 있습니까?">
- 필드 정렬은 **2025년 4분기**에 사용자 정의 레이아웃과 함께 제공될 예정입니다. 현재 필드는 알파벳 순으로 표시됩니다.
- </Accordion>
+<Accordion title="생성 후에 필드 유형을 변경할 수 있나요?">
+아니요, 생성 후에는 필드 유형을 변경할 수 없습니다. 다른 유형이 필요하다면 올바른 유형의 새 필드를 만들고 데이터를 마이그레이션한 다음 이전 필드를 비활성화하세요.
+</Accordion>
+
+
+<Accordion title="단수 및 복수 이름이 필요한 이유는 무엇입니까?">
+우리의 GraphQL API는 다양한 작업에서 두 형식을 모두 사용합니다:
+* 단일 기록 작업을 위한 `createPerson` (단수)
+* 대량 작업을 위한 `createPeople` (복수)
+
+단수 및 복수 형식이 동일할 때 제한이 있지만, 개발자 경험을 향상시킵니다.
+</Accordion>
+
+<Accordion title="왜 일부 필드 이름은 보호됩니까?">
+`Type` 또는 `Application`과 같은 특정 필드 이름은 시스템 사용을 위해 예약되어 있습니다. 대신 `Category` 또는 `Classification`과 같은 대체 이름을 선택하세요.
+</Accordion>
+
+<Accordion title="필드를 비활성화하면 어떻게 되나요?">
+* 필드는 인터페이스에서 숨겨집니다
+* 기존 데이터는 보존됩니다
+* API를 통해 해당 필드에 계속 액세스할 수 있습니다
+* 기존 관계는 유지되지만 새 관계를 생성할 수는 없습니다
+* 필드는 나중에 다시 활성화할 수 있습니다
+</Accordion>
+
+<Accordion title="필드를 필수로 설정할 수 있나요?">
+현재는 사용자 정의 필드를 필수로 설정할 수 없습니다. 모든 필드는 빈 값을 허용합니다. 필드가 비어 있을 때 알림을 보내거나 동작을 차단하는 워크플로우를 사용해 필수 필드를 강제할 수 있습니다.
+</Accordion>
+
+<Accordion title="고유와 필수의 차이는 무엇인가요?">
+* **고유**: 두 레코드가 이 필드에 동일한 값을 가질 수 없습니다
+* **필수**: 필드에 값이 있어야 합니다(현재 사용자 정의 필드에서는 지원되지 않음)
+</Accordion>
+
+<Accordion title="수식 필드를 만들 수 있습니까?">
+수식 필드는 **2026년 1분기**에 제공될 예정입니다. 현재는 워크플로를 사용하여 필드 값을 자동으로 계산하고 업데이트할 수 있습니다.
+</Accordion>
+
+<Accordion title="내 객체에 중첩 필드를 가질 수 있습니까?">
+중첩 필드는 **2026년 1분기**에 제공될 예정입니다. 현재로서는 관련 객체의 필드 값을 가져오려면 워크플로를 사용할 수 있습니다. 예를 들어, 회사의 산업을 사람 기록에 표시하려면 사람에 대한 사용자 정의 필드를 만들고 워크플로를 사용하여 값을 동기화하세요.
+</Accordion>
+
+<Accordion title="객체 내에서 필드를 정렬할 수 있습니까?">
+필드 정렬은 **2025년 4분기**에 사용자 정의 레이아웃과 함께 제공될 예정입니다. 현재 필드는 알파벳 순으로 표시됩니다.
+</Accordion>
</AccordionGroup>
## 관계
<AccordionGroup>
- <Accordion title="같은 객체를 가리키는 관계를 만들 수 있나요?">
- 예! 자기 참조 관계가 지원되며, 계정 계층 구조와 같은 사용 사례에 권장됩니다. 예를 들어, 상위/하위 계정을 추적하기 위해 회사에서 회사로의 관계를 생성하세요.
- </Accordion>
+<Accordion title="같은 객체를 가리키는 관계를 만들 수 있나요?">
+예! 자기 참조 관계가 지원되며, 계정 계층 구조와 같은 사용 사례에 권장됩니다. 예를 들어, 상위/하위 계정을 추적하기 위해 회사에서 회사로의 관계를 생성하세요.
+</Accordion>
- <Accordion title="다대다 관계를 만들 수 있습니까?">
- 다대다 관계는 **2026년 상반기**에 제공될 예정입니다. 현재는 우회 방법으로 두 개의 1대다 관계를 가진 중간 객체를 만드세요.
+<Accordion title="다대다 관계를 만들 수 있습니까?">
+다대다 관계는 **2026년 상반기**에 제공될 예정입니다. 현재는 우회 방법으로 두 개의 1대다 관계를 가진 중간 객체를 만드세요.
- 예를 들어 People과 Projects를 연결(다대다)하려면 "Project Assignments" 객체를 만들고 다음을 포함하세요:
+예를 들어 People과 Projects를 연결(다대다)하려면 "Project Assignments" 객체를 만들고 다음을 포함하세요:
+* People에 대한 관계(여러 할당 → 한 사람)
+* Projects에 대한 관계(여러 할당 → 한 프로젝트)
+</Accordion>
- * People에 대한 관계(여러 할당 → 한 사람)
- * Projects에 대한 관계(여러 할당 → 한 프로젝트)
- </Accordion>
+<Accordion title="여러 객체 유형에 대한 관계(Morph 관계)란 무엇인가요?">
+이는 하나의 필드를 통해 하나의 객체가 여러 서로 다른 객체 유형과 관계를 맺을 수 있도록 합니다. 예를 들어, 노트는 동시에 사람, 회사, 기회에 첨부될 수 있습니다.
- <Accordion title="여러 객체 유형에 대한 관계(Morph 관계)란 무엇인가요?">
- 이는 하나의 필드를 통해 하나의 객체가 여러 서로 다른 객체 유형과 관계를 맺을 수 있도록 합니다. 예를 들어, 노트는 동시에 사람, 회사, 기회에 첨부될 수 있습니다.
+각 노트는 동시에 한 사람, 한 회사, 한 기회에 연결됩니다.
- 각 노트는 동시에 한 사람, 한 회사, 한 기회에 연결됩니다.
+자세한 내용은 [관계 필드](/l/ko/user-guide/data-model/capabilities/relation-fields)에서 확인하세요.
+</Accordion>
- 자세한 내용은 [관계 필드](/l/ko/user-guide/data-model/capabilities/relation-fields)에서 확인하세요.
- </Accordion>
+<Accordion title="동일한 두 객체 간에 여러 관계를 만들 수 있나요?">
+예, 동일한 두 객체 간에 여러 관계를 생성할 수 있습니다. 예를 들어, 회사는 사람에 대해 "Primary Contact"와 "Billing Contact" 관계를 모두 가질 수 있습니다.
+</Accordion>
- <Accordion title="동일한 두 객체 간에 여러 관계를 만들 수 있나요?">
- 예, 동일한 두 객체 간에 여러 관계를 생성할 수 있습니다. 예를 들어, 회사는 사람에 대해 "Primary Contact"와 "Billing Contact" 관계를 모두 가질 수 있습니다.
- </Accordion>
+<Accordion title="레코드를 삭제하면 관계는 어떻게 되나요?">
+레코드를 삭제하면 관련 레코드에서 관계 링크가 제거됩니다. 관련 레코드 자체는 삭제되지 않습니다.
+</Accordion>
- <Accordion title="레코드를 삭제하면 관계는 어떻게 되나요?">
- 레코드를 삭제하면 관련 레코드에서 관계 링크가 제거됩니다. 관련 레코드 자체는 삭제되지 않습니다.
- </Accordion>
-
- <Accordion title="순환 관계를 만들 수 있나요?">
- 기술적으로는 가능하지만, 순환 관계(A → B → C → A)는 혼란을 초래하고 성능 문제를 일으킬 수 있으므로 피하는 것이 좋습니다.
- </Accordion>
+<Accordion title="순환 관계를 만들 수 있나요?">
+기술적으로는 가능하지만, 순환 관계(A → B → C → A)는 혼란을 초래하고 성능 문제를 일으킬 수 있으므로 피하는 것이 좋습니다.
+</Accordion>
</AccordionGroup>
## 접속 및 권한
<AccordionGroup>
- <Accordion title="내 데이터 모델을 어디서 보고 편집할 수 있습니까?">
- **설정 → 데이터 모델**로 이동하여 모든 객체와 필드를 보고 편집하세요.
- </Accordion>
+<Accordion title="내 데이터 모델을 어디서 보고 편집할 수 있습니까?">
+**설정 → 데이터 모델**로 이동하여 모든 객체와 필드를 보고 편집하세요.
+</Accordion>
- <Accordion title="왜 설정에서 데이터 모델을 볼 수 없습니까?">
- 워크스페이스 관리자에게 문의하세요. 데이터 모델 접근은 보통 관리자에게만 제한됩니다.
- </Accordion>
+<Accordion title="왜 설정에서 데이터 모델을 볼 수 없습니까?">
+워크스페이스 관리자에게 문의하세요. 데이터 모델 접근은 보통 관리자에게만 제한됩니다.
+</Accordion>
</AccordionGroup>
## 데이터 관리
<AccordionGroup>
- <Accordion title="보유할 수 있는 레코드 수에 제한이 있나요?">
- 레코드 수에 대한 하드 제한은 없습니다. 하지만 매우 큰 데이터 세트는 일부 보기에서 성능에 영향을 줄 수 있습니다. 필터와 보기를 사용해 대규모 데이터 세트를 효과적으로 관리하세요.
- </Accordion>
+<Accordion title="보유할 수 있는 레코드 수에 제한이 있나요?">
+레코드 수에 대한 하드 제한은 없습니다. 하지만 매우 큰 데이터 세트는 일부 보기에서 성능에 영향을 줄 수 있습니다. 필터와 보기를 사용해 대규모 데이터 세트를 효과적으로 관리하세요.
+</Accordion>
- <Accordion title="사용자 정의 객체로 데이터를 가져올 수 있나요?">
- 예, 사용자 정의 객체를 포함한 모든 객체에 CSV 데이터를 가져올 수 있습니다. 가져오기 프로세스는 사용자 정의 필드에 대한 필드 매핑을 지원합니다. 자세한 내용은 [CSV 파일 준비 방법](/l/ko/user-guide/data-migration/how-tos/prepare-your-csv-files)을 참조하세요.
- </Accordion>
+<Accordion title="사용자 정의 객체로 데이터를 가져올 수 있나요?">
+예, 사용자 정의 객체를 포함한 모든 객체에 CSV 데이터를 가져올 수 있습니다. 가져오기 프로세스는 사용자 정의 필드에 대한 필드 매핑을 지원합니다. 자세한 내용은 [CSV 파일 준비 방법](/l/ko/user-guide/data-migration/how-tos/prepare-your-csv-files)을 참조하세요.
+</Accordion>
- <Accordion title="내 데이터 모델 구성 정보를 내보낼 수 있나요?">
- 현재 데이터 모델 구성에 대한 내장된 내보내기 기능은 없습니다. 워크스페이스 간에 데이터 모델을 마이그레이션해야 하는 경우 지원팀에 문의하세요.
- </Accordion>
+<Accordion title="내 데이터 모델 구성 정보를 내보낼 수 있나요?">
+현재 데이터 모델 구성에 대한 내장된 내보내기 기능은 없습니다. 워크스페이스 간에 데이터 모델을 마이그레이션해야 하는 경우 지원팀에 문의하세요.
+</Accordion>
</AccordionGroup>
## 추가 도움이 필요하십니까?
diff --git a/packages/twenty-docs/l/ko/user-guide/data-model/overview.mdx b/packages/twenty-docs/l/ko/user-guide/data-model/overview.mdx
index 64764b4accb..313cf0d8c63 100644
--- a/packages/twenty-docs/l/ko/user-guide/data-model/overview.mdx
+++ b/packages/twenty-docs/l/ko/user-guide/data-model/overview.mdx
@@ -3,7 +3,6 @@ title: 데이터 모델
description: 데이터 모델이 무엇이며 귀사의 비즈니스에 맞는 모델을 설계하는 방법을 알아보세요.
---
-
## 데이터 모델이란 무엇입니까?
데이터 모델은 CRM에서 정보가 조직되는 방식을 정의하는 구조입니다. 고객 데이터의 **청사진**이라고 생각하세요 — 한 번 설계한 다음 실제 데이터로 채웁니다.
@@ -126,9 +125,9 @@ Twenty는 완전한 유연성을 제공합니다:
## 사람, 회사 및 기회에 대한 특별 참고 사항
<Warning>
- **이메일 및 캘린더 동기화는 사람, 회사 및 기회에서만 작동합니다.**
+**이메일 및 캘린더 동기화는 사람, 회사 및 기회에서만 작동합니다.**
- 메일함/캘린더에서 동기화된 이메일과 미팅에 액세스할 수 있는 유일한 객체입니다. 가능한 한 많이 사용할 것을 권장합니다.
+메일함/캘린더에서 동기화된 이메일과 미팅에 액세스할 수 있는 유일한 객체입니다. 가능한 한 많이 사용할 것을 권장합니다.
</Warning>
**모범 사례:**
@@ -158,9 +157,9 @@ Twenty는 완전한 유연성을 제공합니다:
4. 임의의 객체를 클릭하여 해당 필드를 보고 편집하세요
<Note>
- **설정에서 데이터 모델이 보이지 않나요?**
+**설정에서 데이터 모델이 보이지 않나요?**
- 데이터 모델에 대한 액세스는 보통 관리자에게만 제한됩니다. 액세스가 필요하면 워크스페이스 관리자에게 문의하세요.
+데이터 모델에 대한 액세스는 보통 관리자에게만 제한됩니다. 액세스가 필요하면 워크스페이스 관리자에게 문의하세요.
</Note>
## 다음 단계
diff --git a/packages/twenty-docs/l/ko/user-guide/getting-started/capabilities/what-is-twenty.mdx b/packages/twenty-docs/l/ko/user-guide/getting-started/capabilities/what-is-twenty.mdx
index eb79aeb580a..e01ecbed973 100644
--- a/packages/twenty-docs/l/ko/user-guide/getting-started/capabilities/what-is-twenty.mdx
+++ b/packages/twenty-docs/l/ko/user-guide/getting-started/capabilities/what-is-twenty.mdx
@@ -35,7 +35,7 @@ description: Twenty는 비즈니스에 필요한 것을 정확히 만들 수 있
* **대시보드:** 맞춤형 보고서와 시각화를 통해 성과를 추적하세요. [대시보드 보기](/l/ko/user-guide/dashboards/overview).
* **권한 및 액세스:** 역할 기반 권한을 통해 누가 데이터를 보기, 편집, 관리할 수 있는지 제어하세요. [액세스 구성](/l/ko/user-guide/permissions-access/overview).
* **노트 및 작업:** 더 나은 협업을 위해 레코드에 연결된 노트와 작업을 생성하세요.
-* **API 및 웹훅:** 다른 앱과 연결하고 맞춤형 통합을 구축하세요. [통합 시작하기](/l/ko/developers/api).
+* **API 및 웹훅:** 다른 앱과 연결하고 맞춤형 통합을 구축하세요. [통합 시작하기](/l/ko/developers/extend/api).
## 지금 가입하세요
diff --git a/packages/twenty-docs/l/ko/user-guide/introduction.mdx b/packages/twenty-docs/l/ko/user-guide/introduction.mdx
index 7fdbb3656e9..a9822075654 100644
--- a/packages/twenty-docs/l/ko/user-guide/introduction.mdx
+++ b/packages/twenty-docs/l/ko/user-guide/introduction.mdx
@@ -1,16 +1,11 @@
---
-title: Twenty 알아보기
+title: 사용자 안내서
description: 고급 구성과 모범 사례를 위한 리소스인 Twenty 사용자 가이드에 오신 것을 환영합니다.
---
import { CardTitle } from "/snippets/card-title.mdx"
<CardGroup cols={3}>
- <Card href="/l/ko/user-guide/getting-started/capabilities/what-is-twenty" img="/images/user-guide/api/api.png">
- <CardTitle>Twenty 알아보기</CardTitle>
- Twenty가 무엇이며 비즈니스에 어떻게 도움이 되는지 알아보세요.
- </Card>
-
<Card href="/l/ko/user-guide/data-model/overview" img="/images/user-guide/halftone/data-model.png">
<CardTitle>데이터 모델</CardTitle>
비즈니스 프로세스에 맞게 데이터 모델을 사용자 정의하세요.
@@ -36,9 +31,9 @@ import { CardTitle } from "/snippets/card-title.mdx"
AI 에이전트로 팀을 강화하세요.
</Card>
- <Card href="/l/ko/user-guide/views-pipelines/overview" img="/images/user-guide/halftone/layout.png">
- <CardTitle>보기 및 파이프라인</CardTitle>
- 실행 가능한 보기와 파이프라인으로 데이터를 구성하세요.
+ <Card href="/l/ko/user-guide/layout/overview" img="/images/user-guide/halftone/layout.png">
+ <CardTitle>레이아웃</CardTitle>
+ 탐색, 보기 및 레코드 페이지 사용자 지정.
</Card>
<Card href="/l/ko/user-guide/dashboards/overview" img="/images/user-guide/halftone/dashboards.png">
@@ -60,4 +55,5 @@ import { CardTitle } from "/snippets/card-title.mdx"
<CardTitle>설정</CardTitle>
워크스페이스 기본 설정을 구성하세요.
</Card>
+
</CardGroup>
diff --git a/packages/twenty-docs/l/ko/user-guide/layout/capabilities/navigation.mdx b/packages/twenty-docs/l/ko/user-guide/layout/capabilities/navigation.mdx
new file mode 100644
index 00000000000..0ec795bb758
--- /dev/null
+++ b/packages/twenty-docs/l/ko/user-guide/layout/capabilities/navigation.mdx
@@ -0,0 +1,38 @@
+---
+title: 네비게이션
+description: 팀의 작업 방식에 맞게 왼쪽 사이드바를 사용자 지정하세요.
+---
+
+왼쪽 사이드바는 Twenty를 탐색하는 기본 방법입니다. 완전히 사용자 지정할 수 있습니다 — 어떤 설정 페이지도 열 필요 없이 워크플로에 맞게 재구성할 수 있습니다.
+
+## 항목 재정렬
+
+사이드바의 어떤 항목이든 끌어서 놓아 위치를 변경하세요. 순서는 사용자별로 저장되므로 팀원마다 자신의 사이드바를 구성할 수 있습니다.
+
+## 폴더
+
+관련 항목을 폴더로 묶으세요. 예를 들어 파이프라인 보기를 담은 "영업" 폴더, 티켓용 "지원" 폴더, 내부 객체용 "운영" 폴더를 만들 수 있습니다.
+
+폴더를 만들려면 사이드바에서 마우스 오른쪽 버튼을 클릭하거나 `+` 버튼을 사용하세요.
+
+## 객체 숨기기
+
+사용하지 않는 객체는 사이드바에서 숨길 수 있습니다. 삭제되는 것이 아닙니다 — 단지 보이지 않게 될 뿐입니다. 설정 > 데이터 모델에서 언제든 다시 표시할 수 있습니다.
+
+## 즐겨찾기
+
+사이드바 상단의 즐겨찾기 섹션에 보기, 레코드 또는 검색을 고정하여 한 번의 클릭으로 접근하세요. 즐겨찾기는 개인별입니다 — 각 사용자가 자신만의 즐겨찾기를 관리합니다.
+
+## 사용자 지정 링크
+
+외부 도구에 대한 링크를 사이드바에 직접 추가하세요. 팀 위키, 다른 도구의 대시보드 또는 팀이 자주 사용하는 모든 URL을 링크하는 데 유용합니다.
+
+## 명령 메뉴
+
+`Cmd+K`(또는 `Ctrl+K`)를 눌러 명령 메뉴를 여세요 — 사이드바를 탐색하지 않고도 어떤 레코드, 보기 또는 작업으로도 빠르게 이동할 수 있는 빠른 액세스 검색창입니다.
+
+## 사이드바 사용자 정의
+
+사이드바를 사용자 정의하려면 사이드바의 "Workspace" 섹션 위에 마우스를 올린 다음 렌치 아이콘을 클릭하세요.
+
+<img src="/images/user-guide/layout/navigation-edit-icon.png" alt="내비게이션 편집 아이콘" />
diff --git a/packages/twenty-docs/l/ko/user-guide/layout/capabilities/record-pages.mdx b/packages/twenty-docs/l/ko/user-guide/layout/capabilities/record-pages.mdx
new file mode 100644
index 00000000000..1f2e262151d
--- /dev/null
+++ b/packages/twenty-docs/l/ko/user-guide/layout/capabilities/record-pages.mdx
@@ -0,0 +1,61 @@
+---
+title: 레코드 페이지
+description: 탭과 위젯으로 개별 레코드 상세 페이지의 레이아웃을 사용자 지정하세요.
+---
+
+## 개요
+
+Twenty에서 레코드를 열면 상세 페이지는 **탭**과 **위젯**으로 구성됩니다. 둘 다 오브젝트 유형별로 완전히 사용자 지정할 수 있습니다.
+
+## 탭
+
+각 레코드 페이지에는 여러 개의 탭을 둘 수 있습니다 — 브라우저의 탭과 비슷합니다. 이를 사용해 레코드의 다양한 측면을 구성하세요. 예를 들어 회사 레코드에는 개요, 커뮤니케이션, 작업, 파일용 탭이 있을 수 있습니다.
+
+다음을 수행할 수 있습니다:
+
+* 탭 추가 및 제거
+* 탭 이름 변경
+* 드래그하여 탭 재정렬
+* 기본으로 표시할 탭 설정
+
+## 위젯
+
+위젯은 각 탭 내부의 기본 구성 요소입니다. 사용 가능한 위젯 유형:
+
+| 위젯 | 표시 내용 |
+| ------------- | ---------------- |
+| **필드** | 레코드 필드(그룹 또는 개별) |
+| **관련 레코드** | 관계로 연결된 레코드 표 |
+| **이메일** | 연결된 계정의 이메일 기록 |
+| **캘린더** | 레코드와 연관된 캘린더 이벤트 |
+| **타임라인** | 활동 및 이벤트 기록 |
+| **작업** | 연관된 작업 |
+| **노트** | 서식 있는 텍스트 노트 |
+| **파일** | 파일 첨부 |
+| **차트** | 관련 레코드의 시각적 데이터 |
+| **iFrame** | 임베드된 외부 콘텐츠 |
+| **서식 있는 텍스트** | 정적 콘텐츠 또는 설명 |
+
+## 레코드 페이지 맞춤 설정
+
+1. 임의의 레코드를 여세요
+2. `Cmd+K`를 누른 다음 "Edit record page layout"을 검색하세요
+
+또는
+
+1. 설정 > 데이터 모델 > 원하는 오브젝트 > 레이아웃으로 이동하세요
+
+2. 해당 오브젝트에서 "레코드 페이지 사용자 지정" 버튼을 클릭하세요
+
+3. 이제 맞춤 설정 모드입니다:
+ * **위젯 추가** — 위젯 선택기에서
+ * **위젯 드래그**하여 그리드에서 재배치하세요
+ * **위젯 크기 조절** — 가장자리를 드래그하세요
+ * **필드 구성** — 각 위젯에 표시되는 필드를 설정하세요
+ * **탭 관리** — 추가, 제거, 이름 변경, 재정렬
+
+4. 변경 내용을 저장하세요 — 해당 오브젝트 유형의 모든 레코드에 적용됩니다
+
+## 필드 가시성
+
+필드 위젯에서 어떤 필드를 표시할지와 표시 순서를 제어할 수 있습니다. 이를 통해 집중된 레이아웃을 만들 수 있습니다 — 예를 들어 개요 탭에는 가장 중요한 필드만 표시하고, 자세한 필드는 별도의 탭에 배치할 수 있습니다.
diff --git a/packages/twenty-docs/l/ko/user-guide/layout/overview.mdx b/packages/twenty-docs/l/ko/user-guide/layout/overview.mdx
new file mode 100644
index 00000000000..ab91725cbe7
--- /dev/null
+++ b/packages/twenty-docs/l/ko/user-guide/layout/overview.mdx
@@ -0,0 +1,45 @@
+---
+title: 레이아웃
+description: Twenty에서 탐색하고 둘러보며 레코드를 보는 방식을 사용자 지정하세요.
+---
+
+Twenty의 레이아웃은 세 가지 수준에서 사용자 지정할 수 있습니다: 앱을 탐색하는 방식, 레코드 목록을 살펴보는 방식, 개별 레코드를 열 때 보이는 내용.
+
+## 네비게이션
+
+왼쪽 사이드바는 완전히 사용자 지정할 수 있습니다. 다음을 수행할 수 있습니다:
+
+* **항목 재정렬** — 끌어서 놓기하여 순서를 바꿉니다
+* **폴더 만들기** — 관련 개체와 보기를 그룹화합니다
+* **개체 숨기기** — 사용하지 않는 개체를 숨깁니다
+* **사용자 지정 링크 추가** — 외부 도구에 대한 링크를 추가합니다
+* **즐겨찾기 고정** — 보기, 레코드 또는 검색에 빠르게 액세스할 수 있도록 고정합니다
+
+[네비게이션 참조 →](/l/ko/user-guide/layout/capabilities/navigation)
+
+## 보기
+
+보기는 레코드 목록의 표시 방식을 제어합니다. Twenty는 세 가지 유형의 보기를 지원합니다:
+
+| 보기 | 적합한 용도 |
+| ------- | ------------------------------------ |
+| **테이블** | 여러 레코드를 한 번에 다룰 때 — 스프레드시트 스타일의 행과 열 |
+| **칸반** | 파이프라인 추적 — 단계별로 구성된 카드를 끌어서 놓으며 관리 |
+| **캘린더** | 시간 기반 계획 — 날짜 필드를 기준으로 레코드를 배치 |
+
+각 보기는 자체 필터, 정렬, 필드 가시성, 그룹화 구성을 저장합니다. 보기는 워크스페이스와 공유하거나 비공개로 유지할 수 있습니다.
+
+[테이블 보기 →](/l/ko/user-guide/views-pipelines/capabilities/table-views) · [칸반 보기 →](/l/ko/user-guide/views-pipelines/capabilities/kanban-views) · [캘린더 보기 →](/l/ko/user-guide/views-pipelines/capabilities/calendar-view)
+
+## 레코드 페이지
+
+레코드를 열면 상세 페이지는 구성 가능한 탭과 위젯으로 구성됩니다. 다음을 수행할 수 있습니다:
+
+* **탭 추가, 제거 및 재정렬** — 모든 레코드 유형에서 수행할 수 있습니다
+* **위젯 구성** — 필드, 관련 레코드, 이메일, 타임라인, 캘린더, 작업, 노트, 파일, 차트, iframes 등
+* **위젯 끌어 이동 및 크기 조절** — 그리드 레이아웃에서 수행할 수 있습니다
+* **위젯별 필드 가시성 제어**
+
+명령 메뉴(`Cmd+K` → "레코드 페이지 레이아웃 편집")에서 레이아웃 사용자 지정 모드로 진입하세요.
+
+[레코드 페이지 참조 →](/l/ko/user-guide/layout/capabilities/record-pages)
diff --git a/packages/twenty-docs/l/ko/user-guide/permissions-access/capabilities/permissions.mdx b/packages/twenty-docs/l/ko/user-guide/permissions-access/capabilities/permissions.mdx
index 759acbbcef6..15471968638 100644
--- a/packages/twenty-docs/l/ko/user-guide/permissions-access/capabilities/permissions.mdx
+++ b/packages/twenty-docs/l/ko/user-guide/permissions-access/capabilities/permissions.mdx
@@ -13,7 +13,7 @@ Twenty의 권한 시스템은 세 가지 주요 영역에 대한 접근을 제
새로운 역할 생성하기:
-1. **설정 → 역할**로 이동
+1. **설정 → 구성원 → 역할**로 이동하세요
2. **모든 역할**에서 **+ 역할 생성** 클릭
3. 역할 이름 입력
4. 기본 **권한** 탭에서 [권한을 구성합니다](#customize-permissions)
@@ -23,26 +23,26 @@ Twenty의 권한 시스템은 세 가지 주요 영역에 대한 접근을 제
역할을 삭제하려면:
-1. **설정 → 역할**로 이동
+1. **설정 → 구성원 → 역할**로 이동하세요
2. 제거하려는 역할을 클릭합니다
3. **설정** 탭 열고 **역할 삭제** 클릭
4. 모달에서 **확인** 클릭
<Note>
- 역할이 삭제되면, 해당 역할이 할당된 워크스페이스 구성원은 기본 역할로 자동 재할당됩니다. **Admin** 역할을 제외한 모든 역할을 삭제할 수 있습니다. **Admin** 역할에는 항상 최소 한 명의 구성원이 할당되어 있어야 합니다.
+역할이 삭제되면, 해당 역할이 할당된 워크스페이스 구성원은 기본 역할로 자동 재할당됩니다. **Admin** 역할을 제외한 모든 역할을 삭제할 수 있습니다. **Admin** 역할에는 항상 최소 한 명의 구성원이 할당되어 있어야 합니다.
</Note>
## 구성원에게 역할 할당
### 현재 할당 보기
-* **설정 → 역할**로 이동
+* **설정 → 구성원 → 역할**로 이동하세요
* 모든 역할과 각 역할에 지정된 멤버 수 확인
* 어떤 회원이 어떤 역할을 가지고 있는지 보기
### 구성원에게 역할 할당
-1. **설정 → 역할**로 이동
+1. **설정 → 구성원 → 역할**로 이동하세요
2. 할당할 역할 클릭
3. **배정** 탭 열기
4. **+ 멤버에게 할당** 클릭
@@ -51,13 +51,13 @@ Twenty의 권한 시스템은 세 가지 주요 영역에 대한 접근을 제
### 기본 역할 설정
-1. **설정 → 역할**로 이동
+1. **설정 → 구성원 → 역할**로 이동하세요
2. **옵션** 섹션에서 **기본 역할**을 찾습니다
3. 새로운 멤버가 자동으로 받을 역할 선택
4. 새 작업 공간 회원이 가입 시 이 역할이 할당됩니다.
<Note>
- 기존 워크스페이스 구성원에게만 역할을 할당할 수 있습니다. To invite new members, use [Member Management](/l/ko/user-guide/settings/capabilities/member-management).
+기존 워크스페이스 구성원에게만 역할을 할당할 수 있습니다. To invite new members, use [Member Management](/l/ko/user-guide/settings/capabilities/member-management).
</Note>
## 권한 사용자 정의
@@ -82,7 +82,7 @@ Twenty의 권한 시스템은 세 가지 주요 영역에 대한 접근을 제
이 역할의 기본 동작이 무엇이어야 하는지에 따라 선택 또는 선택 해제합니다.
<Note>
- **예시 — 인턴 역할**: 인턴은 기본적으로 모든 객체를 볼 수 있지만 수정할 수는 없어야 합니다. "모든 객체에서 레코드 보기"를 활성화하고, "모든 객체에서 레코드 편집"은 선택 해제 상태로 둡니다.
+**예시 — 인턴 역할**: 인턴은 기본적으로 모든 객체를 볼 수 있지만 수정할 수는 없어야 합니다. "모든 객체에서 레코드 보기"를 활성화하고, "모든 객체에서 레코드 편집"은 선택 해제 상태로 둡니다.
</Note>
#### 객체 수준 예외 추가
@@ -98,6 +98,22 @@ Twenty의 권한 시스템은 세 가지 주요 영역에 대한 접근을 제
| Opportunities → "레코드 보기" 비활성화 | 인턴은 Opportunities 객체를 전혀 볼 수 없습니다 |
| People → "레코드 수정" 활성화 | 인턴은 People 레코드를 수정할 수 있습니다(다른 객체는 불가) |
+### 행 수준 권한
+
+<Note>
+행 수준 권한은 **Organization** 요금제(Cloud 및 Self-Hosted)에서 제공되는 **Premium 기능**입니다.
+</Note>
+
+행 수준 권한을 사용하면 동적 기준을 기반으로 역할이 볼 수 있거나 편집할 수 있는 개별 레코드를 제한할 수 있습니다. 객체 유형 전체에 적용되는 객체 권한과 달리, 행 수준 권한은 각 레코드를 개별적으로 평가합니다.
+
+**사용 예시:**
+
+* 영업 담당자는 자신에게 할당된 영업 기회만 볼 수 있습니다.
+* 관리자는 자신의 지역에 있는 모든 레코드를 볼 수 있습니다.
+* 지원 담당자는 자신에게 할당된 티켓만 볼 수 있습니다.
+
+행 수준 권한을 구성하려면 역할을 연 다음 **Objects** 탭으로 이동하여 **Row-Level** 섹션을 사용해 특정 객체에 대한 필터 조건을 정의합니다.
+
### 필드 권한
각 객체 수준 규칙 내에서 더 나아가 특정 필드에 대한 접근을 제어하기 위해 **필드 수준 권한**을 구성할 수 있습니다.
@@ -145,7 +161,7 @@ People 수정 권한이 있는 인턴 역할의 경우, 특정 필드를 제한
* 또는 특정 권한을 개별적으로 활성화합니다(예: API 키 생성, 워크스페이스 환경설정, 역할 할당, 데이터 모델 구성, 보안 설정, 워크플로 관리)
<Note>
- **현재 제한 사항**: 워크플로를 수동으로 트리거하려면 현재 워크플로 관리 권한이 필요합니다. 이 동작은 향후 릴리스에서 변경될 수 있습니다.
+**현재 제한 사항**: 워크플로를 수동으로 트리거하려면 현재 워크플로 관리 권한이 필요합니다. 이 동작은 향후 릴리스에서 변경될 수 있습니다.
</Note>
### 워크스페이스 작업 권한
@@ -168,7 +184,7 @@ People 수정 권한이 있는 인턴 역할의 경우, 특정 필드를 제한
### API 키에 역할 할당
-1. **설정 → 역할**로 이동
+1. **설정 → 구성원 → 역할**로 이동하세요
2. 할당할 역할 클릭
3. **배정** 탭 열기
4. **API 키**에서 **+ Assign to API key**를 클릭합니다
@@ -178,12 +194,12 @@ People 수정 권한이 있는 인턴 역할의 경우, 특정 필드를 제한
이제 해당 API 키는 그 역할에 정의된 모든 권한을 상속받습니다. 이 키로 수행되는 모든 API 호출은 그에 따라 제한됩니다.
<Note>
- 역할이 할당되지 않은 API 키는 기본 권한을 사용합니다. 보안을 강화하려면 운영 환경의 API 키에 항상 특정 역할을 할당하세요.
+역할이 할당되지 않은 API 키는 기본 권한을 사용합니다. 보안을 강화하려면 운영 환경의 API 키에 항상 특정 역할을 할당하세요.
</Note>
### AI 에이전트에 역할 할당
-1. **설정 → 역할**로 이동
+1. **설정 → 구성원 → 역할**로 이동하세요
2. 할당할 역할 클릭
3. **배정** 탭 열기
4. **AI 에이전트**에서 **+ Assign to AI agent**를 클릭합니다
@@ -193,5 +209,5 @@ People 수정 권한이 있는 인턴 역할의 경우, 특정 필드를 제한
AI 에이전트는 할당된 역할에서 허용한 데이터와 작업에만 접근하고 수행할 수 있습니다.
<Note>
- 워크플로 내에서 실행되는 AI 에이전트의 경우, 워크플로에 더 넓은 권한이 있더라도 에이전트가 의도된 범위를 벗어난 데이터에 접근하거나 수정할 수 없도록 보장합니다.
+워크플로 내에서 실행되는 AI 에이전트의 경우, 워크플로에 더 넓은 권한이 있더라도 에이전트가 의도된 범위를 벗어난 데이터에 접근하거나 수정할 수 없도록 보장합니다.
</Note>
diff --git a/packages/twenty-docs/l/ko/user-guide/permissions-access/capabilities/sso-configuration.mdx b/packages/twenty-docs/l/ko/user-guide/permissions-access/capabilities/sso-configuration.mdx
index 51b2cfaf175..de2d645e484 100644
--- a/packages/twenty-docs/l/ko/user-guide/permissions-access/capabilities/sso-configuration.mdx
+++ b/packages/twenty-docs/l/ko/user-guide/permissions-access/capabilities/sso-configuration.mdx
@@ -28,7 +28,7 @@ Twenty는 다음 제공자와 SSO를 지원합니다:
* Twenty 워크스페이스에 대한 관리자 권한
<Note>
- **SSO 설정을 원하는 셀프 호스팅 사용자**는 [email protected]으로 문의하세요
+**SSO 설정을 원하는 셀프 호스팅 사용자**는 [email protected]으로 문의하세요
</Note>
### 구성 단계
diff --git a/packages/twenty-docs/l/ko/user-guide/permissions-access/how-tos/permissions-faq.mdx b/packages/twenty-docs/l/ko/user-guide/permissions-access/how-tos/permissions-faq.mdx
index 1a16f674516..0c4dd75a68c 100644
--- a/packages/twenty-docs/l/ko/user-guide/permissions-access/how-tos/permissions-faq.mdx
+++ b/packages/twenty-docs/l/ko/user-guide/permissions-access/how-tos/permissions-faq.mdx
@@ -6,121 +6,115 @@ description: 역할과 권한에 관한 자주 묻는 질문입니다.
## 역할
<AccordionGroup>
- <Accordion title="Twenty에는 기본적으로 어떤 역할이 제공되나요?">
- Twenty에는 기본적으로 **Admin** 및 **Member** 역할이 포함됩니다. 팀의 필요에 따라 추가 사용자 지정 역할을 만들 수 있습니다(예: 영업 담당자, 관리자, 읽기 전용 사용자).
- </Accordion>
+<Accordion title="Twenty에는 기본적으로 어떤 역할이 제공되나요?">
+Twenty에는 기본적으로 **Admin** 및 **Member** 역할이 포함됩니다. 팀의 필요에 따라 추가 사용자 지정 역할을 만들 수 있습니다(예: 영업 담당자, 관리자, 읽기 전용 사용자).
+</Accordion>
- <Accordion title="Admin 역할을 삭제할 수 있나요?">
- 아니요, Admin 역할은 삭제할 수 없습니다. Admin 역할에는 항상 최소 한 명의 구성원이 할당되어 있어야 합니다.
- </Accordion>
+<Accordion title="Admin 역할을 삭제할 수 있나요?">
+아니요, Admin 역할은 삭제할 수 없습니다. Admin 역할에는 항상 최소 한 명의 구성원이 할당되어 있어야 합니다.
+</Accordion>
- <Accordion title="역할을 삭제하면 어떻게 되나요?">
- 해당 역할이 할당된 워크스페이스 구성원은 기본 역할로 자동 재할당됩니다.
- </Accordion>
+<Accordion title="역할을 삭제하면 어떻게 되나요?">
+해당 역할이 할당된 워크스페이스 구성원은 기본 역할로 자동 재할당됩니다.
+</Accordion>
- <Accordion title="신규 구성원에게 기본 역할을 어떻게 설정하나요?">
- **Settings → Roles**로 이동하여 **Default Role** 옵션을 찾은 뒤, 신규 구성원이 가입할 때 자동으로 부여될 역할을 선택하세요.
- </Accordion>
+<Accordion title="신규 구성원에게 기본 역할을 어떻게 설정하나요?">
+**설정 → 구성원 → 역할**로 이동하여 **Default Role** 옵션을 찾은 뒤, 신규 구성원이 가입할 때 자동으로 부여될 역할을 선택하세요.
+</Accordion>
- <Accordion title="한 사용자에게 여러 역할을 할당할 수 있나요?">
- 아니요, 각 사용자는 한 번에 하나의 역할만 가질 수 있습니다. 권한 조합이 필요하다면 사용자 지정 역할을 생성하세요.
- </Accordion>
+<Accordion title="한 사용자에게 여러 역할을 할당할 수 있나요?">
+아니요, 각 사용자는 한 번에 하나의 역할만 가질 수 있습니다. 권한 조합이 필요하다면 사용자 지정 역할을 생성하세요.
+</Accordion>
</AccordionGroup>
## 권한
<AccordionGroup>
- <Accordion title="객체 권한과 필드 권한의 차이점은 무엇인가요?">
- * **객체 권한**: 전체 레코드에 대한 액세스를 제어합니다(예: People 레코드를 보기/편집/삭제 가능)
- * **필드 권한**: 객체 내 특정 필드에 대한 액세스를 제어합니다(예: Salary 필드는 볼 수만 있고 편집은 불가)
-
- 필드 권한은 민감한 데이터에 대해 더 세밀한 제어를 가능하게 합니다.
- </Accordion>
-
- <Accordion title="권한 재정의는 어떻게 작동하나요?">
- 권한은 전역 설정에서 구체적 설정으로 계단식으로 적용됩니다:
-
- 1. **All Objects**는 모든 객체에 대한 기준을 설정합니다
- 2. **Object-Level Permissions**는 특정 객체에 대해 전역 설정을 재정의할 수 있습니다
- 3. **Field-Level Permissions**는 특정 필드에 대해 객체 설정을 재정의할 수 있습니다
-
- 보다 구체적인 설정이 항상 우선합니다.
- </Accordion>
-
- <Accordion title="다양한 권한 수준은 무엇을 의미하나요?">
- 객체의 경우:
-
- * **See Records**: 목록 및 상세 페이지에서 레코드를 조회
- * **Edit Records**: 기존 레코드 수정
- * **Delete Records**: 레코드를 소프트 삭제(복원 가능)
- * **Destroy Records**: 레코드를 영구 삭제
-
- 필드의 경우:
-
- * **See Field**: 필드 값 조회
- * **Edit Field**: 필드 값 수정
- * **No Access**: 필드가 완전히 숨겨짐
- </Accordion>
-
- <Accordion title="특정 레코드에 대한 액세스를 제한할 수 있나요(행 수준 권한)?">
- 행 수준 권한은 2026년 1분기까지 **Organization** 요금제에서 제공될 예정입니다. 이를 통해 기준에 따라 특정 레코드에 대한 액세스를 제한할 수 있습니다(예: 자신의 영업 기회만 보기).
- </Accordion>
-
- <Accordion title="일부 사용자에 대해 필드를 읽기 전용으로 설정하려면 어떻게 하나요?">
- 1. **설정 → 역할**로 이동
- 2. 역할을 선택합니다
- 3. 해당 필드가 포함된 객체로 이동합니다
- 4. 필드 권한을 **See Field**로 설정합니다(**Edit Field** 없이)
- </Accordion>
+<Accordion title="객체 권한과 필드 권한의 차이점은 무엇인가요?">
+* **객체 권한**: 전체 레코드에 대한 액세스를 제어합니다(예: People 레코드를 보기/편집/삭제 가능)
+* **필드 권한**: 객체 내 특정 필드에 대한 액세스를 제어합니다(예: Salary 필드는 볼 수만 있고 편집은 불가)
+
+필드 권한은 민감한 데이터에 대해 더 세밀한 제어를 가능하게 합니다.
+</Accordion>
+
+<Accordion title="권한 재정의는 어떻게 작동하나요?">
+권한은 전역 설정에서 구체적 설정으로 계단식으로 적용됩니다:
+1. **All Objects**는 모든 객체에 대한 기준을 설정합니다
+2. **Object-Level Permissions**는 특정 객체에 대해 전역 설정을 재정의할 수 있습니다
+3. **Field-Level Permissions**는 특정 필드에 대해 객체 설정을 재정의할 수 있습니다
+
+보다 구체적인 설정이 항상 우선합니다.
+</Accordion>
+
+<Accordion title="다양한 권한 수준은 무엇을 의미하나요?">
+객체의 경우:
+* **See Records**: 목록 및 상세 페이지에서 레코드를 조회
+* **Edit Records**: 기존 레코드 수정
+* **Delete Records**: 레코드를 소프트 삭제(복원 가능)
+* **Destroy Records**: 레코드를 영구 삭제
+
+필드의 경우:
+* **See Field**: 필드 값 조회
+* **Edit Field**: 필드 값 수정
+* **No Access**: 필드가 완전히 숨겨짐
+</Accordion>
+
+<Accordion title="특정 레코드에 대한 액세스를 제한할 수 있나요(행 수준 권한)?">
+행 수준 권한은 **Organization** 요금제에서 제공됩니다. 이를 통해 기준에 따라 특정 레코드에 대한 액세스를 제한할 수 있습니다(예: 자신의 영업 기회만 보기).
+</Accordion>
+
+<Accordion title="일부 사용자에 대해 필드를 읽기 전용으로 설정하려면 어떻게 하나요?">
+1. **설정 → 구성원 → 역할**로 이동하세요
+2. 역할을 선택합니다
+3. 해당 필드가 포함된 객체로 이동합니다
+4. 필드 권한을 **See Field**로 설정합니다(**Edit Field** 없이)
+</Accordion>
</AccordionGroup>
## 설정 및 작업
<AccordionGroup>
- <Accordion title="사용할 수 있는 설정 권한은 무엇인가요?">
- 다음에 대한 액세스를 제어할 수 있습니다:
-
- * API 키 생성
- * 워크스페이스 환경설정
- * 역할 할당
- * 데이터 모델 구성
- * 보안 설정
- * 워크플로우 관리
-
- **Settings All Access**를 사용하여 전체 액세스를 부여하거나, 특정 권한만 활성화하세요.
- </Accordion>
-
- <Accordion title="사용할 수 있는 작업 권한은 무엇인가요?">
- 다음을 제어할 수 있습니다:
-
- * **Send Email**: Twenty에서 이메일을 보낼 수 있음
- * **Import CSV**: CSV를 통해 데이터를 가져올 수 있음
- * **Export CSV**: 데이터를 CSV로 내보낼 수 있음
-
- **Application All Access**를 사용하여 모든 작업을 허용하거나, 필요한 항목만 활성화하세요.
- </Accordion>
+<Accordion title="사용할 수 있는 설정 권한은 무엇인가요?">
+다음에 대한 액세스를 제어할 수 있습니다:
+* API 키 생성
+* 워크스페이스 환경설정
+* 역할 할당
+* 데이터 모델 구성
+* 보안 설정
+* 워크플로우 관리
+
+**Settings All Access**를 사용하여 전체 액세스를 부여하거나, 특정 권한만 활성화하세요.
+</Accordion>
+
+<Accordion title="사용할 수 있는 작업 권한은 무엇인가요?">
+다음을 제어할 수 있습니다:
+* **Send Email**: Twenty에서 이메일을 보낼 수 있음
+* **Import CSV**: CSV를 통해 데이터를 가져올 수 있음
+* **Export CSV**: 데이터를 CSV로 내보낼 수 있음
+
+**Application All Access**를 사용하여 모든 작업을 허용하거나, 필요한 항목만 활성화하세요.
+</Accordion>
</AccordionGroup>
## SSO
<AccordionGroup>
- <Accordion title="모든 요금제에서 SSO를 사용할 수 있나요?">
- 아니요, SSO는 **Organization** 요금제에서만 제공되는 프리미엄 기능입니다.
- </Accordion>
-
- <Accordion title="어떤 아이덴티티 제공자가 지원되나요?">
- Twenty는 다음을 지원합니다:
-
- * **SAML 2.0**(대부분의 엔터프라이즈 아이덴티티 제공자와 호환)
- * **Google Workspace**
- * **Microsoft Entra ID**(이전 명칭: Azure AD)
- </Accordion>
-
- <Accordion title="Just-in-Time(JIT) 프로비저닝이란 무엇인가요?">
- JIT 프로비저닝을 사용하면, 사용자가 SSO로 처음 로그인할 때 Twenty에 사용자 계정이 자동으로 생성됩니다. 기본 역할이 자동으로 할당됩니다.
- </Accordion>
-
- <Accordion title="모든 사용자에게 SSO를 필수로 적용할 수 있나요?">
- 예. SSO 구성이 완료되면, 아이덴티티 제공자를 통한 인증을 강제하기 위해 SSO 사용자에 대한 비밀번호 로그인을 비활성화할 수 있습니다.
- </Accordion>
+<Accordion title="모든 요금제에서 SSO를 사용할 수 있나요?">
+아니요, SSO는 **Organization** 요금제에서만 제공되는 프리미엄 기능입니다.
+</Accordion>
+
+<Accordion title="어떤 아이덴티티 제공자가 지원되나요?">
+Twenty는 다음을 지원합니다:
+* **SAML 2.0**(대부분의 엔터프라이즈 아이덴티티 제공자와 호환)
+* **Google Workspace**
+* **Microsoft Entra ID**(이전 명칭: Azure AD)
+</Accordion>
+
+<Accordion title="Just-in-Time(JIT) 프로비저닝이란 무엇인가요?">
+JIT 프로비저닝을 사용하면, 사용자가 SSO로 처음 로그인할 때 Twenty에 사용자 계정이 자동으로 생성됩니다. 기본 역할이 자동으로 할당됩니다.
+</Accordion>
+
+<Accordion title="모든 사용자에게 SSO를 필수로 적용할 수 있나요?">
+예. SSO 구성이 완료되면, 아이덴티티 제공자를 통한 인증을 강제하기 위해 SSO 사용자에 대한 비밀번호 로그인을 비활성화할 수 있습니다.
+</Accordion>
</AccordionGroup>
diff --git a/packages/twenty-docs/l/ko/user-guide/permissions-access/overview.mdx b/packages/twenty-docs/l/ko/user-guide/permissions-access/overview.mdx
index fc0f2e62788..009afbd11ef 100644
--- a/packages/twenty-docs/l/ko/user-guide/permissions-access/overview.mdx
+++ b/packages/twenty-docs/l/ko/user-guide/permissions-access/overview.mdx
@@ -3,7 +3,6 @@ title: 권한 및 액세스
description: 워크스페이스에서 역할, 권한 및 액세스 제어를 관리합니다.
---
-
Twenty의 권한 시스템을 통해 워크스페이스에서 누가 데이터에 액세스하고 수정할 수 있는지 제어할 수 있습니다. 역할을 만들고 권한을 부여하며 보안 액세스를 위해 SSO를 구성하세요.
## 이 섹션의 내용
@@ -12,11 +11,9 @@ Twenty의 권한 시스템을 통해 워크스페이스에서 누가 데이터
<Card title="권한" icon="lock" href="/l/ko/user-guide/permissions-access/capabilities/permissions">
역할을 만들고 객체, 필드 및 설정 권한을 구성하세요.
</Card>
-
<Card title="SSO 구성" icon="키" href="/l/ko/user-guide/permissions-access/capabilities/sso-configuration">
ID 공급자와 함께 Single Sign-On(SSO)을 설정하세요.
</Card>
-
<Card title="자주 묻는 질문" icon="circle-question" href="/l/ko/user-guide/permissions-access/how-tos/permissions-faq">
역할, 권한 및 SSO에 대한 자주 묻는 질문.
</Card>
diff --git a/packages/twenty-docs/l/ko/user-guide/settings/capabilities/domains-settings.mdx b/packages/twenty-docs/l/ko/user-guide/settings/capabilities/domains-settings.mdx
index f7a54e833ab..958749a9885 100644
--- a/packages/twenty-docs/l/ko/user-guide/settings/capabilities/domains-settings.mdx
+++ b/packages/twenty-docs/l/ko/user-guide/settings/capabilities/domains-settings.mdx
@@ -3,10 +3,12 @@ title: 도메인 설정
description: 작업 공간 도메인, 승인된 액세스 도메인 및 퍼블릭 도메인을 구성하세요.
---
-**설정 → 도메인**에서 도메인 설정을 구성하세요.
+도메인 설정은 구성하려는 항목에 따라 세 가지 위치에 있습니다.
## 워크스페이스 도메인
+**설정 → 일반 → 워크스페이스 도메인**에서 구성하세요.
+
하위 도메인 이름을 편집하거나 작업 공간에 사용자 지정 도메인을 설정하세요.
### 도메인 사용자 지정
@@ -19,6 +21,8 @@ description: 작업 공간 도메인, 승인된 액세스 도메인 및 퍼블
## 승인된 도메인
+**설정 → 구성원 → 초대**에서 구성하세요.
+
이 도메인의 이메일 주소를 가진 사람은 이 작업 공간에 자동으로 가입할 수 있습니다.
### 승인된 액세스 도메인 추가
@@ -30,18 +34,21 @@ description: 작업 공간 도메인, 승인된 액세스 도메인 및 퍼블
구성이 완료되면 해당 도메인의 이메일 주소를 가진 사람은 직접 초대 없이 작업 공간에 가입할 수 있습니다.
<Note>
- 작업 공간을 귀 조직으로 제한하면서 팀 전체가 자가 등록할 수 있도록 하는 데 유용합니다.
+작업 공간을 귀 조직으로 제한하면서 팀 전체가 자가 등록할 수 있도록 하는 데 유용합니다.
</Note>
## 공개 도메인
-이 도메인에서 완벽하고 안전한 호스팅 환경을 제공하십시오.
+**설정 → 앱 → 개발자**에서 구성하세요.
+
+이 도메인에서 완벽하고 안전한 호스팅 환경을 제공하십시오. 퍼블릭 도메인은 특정 앱에 바인딩할 수 있습니다. 이렇게 바인딩하면 해당 앱의 HTTP 라우팅 로직 함수만 이 도메인에서 접근할 수 있습니다. 바인딩을 비워 두면 워크스페이스의 모든 HTTP 라우트가 노출됩니다.
### 퍼블릭 도메인 추가
1. **퍼블릭 도메인 추가**를 클릭하세요
2. 사용할 도메인을 입력하세요
-3. 안내에 따라 DNS 설정을 구성하세요
-4. 도메인을 검증하세요
+3. 선택적으로 앱에 바인딩하기
+4. 안내에 따라 DNS 설정을 구성하세요
+5. 도메인을 검증하세요
퍼블릭 도메인에는 SSL 인증서가 자동으로 발급됩니다.
diff --git a/packages/twenty-docs/l/ko/user-guide/settings/capabilities/member-management.mdx b/packages/twenty-docs/l/ko/user-guide/settings/capabilities/member-management.mdx
index b13569db0a1..1919841c5ce 100644
--- a/packages/twenty-docs/l/ko/user-guide/settings/capabilities/member-management.mdx
+++ b/packages/twenty-docs/l/ko/user-guide/settings/capabilities/member-management.mdx
@@ -59,11 +59,11 @@ description: 팀원을 초대하고 워크스페이스 접근 권한을 관리
2. 워크스페이스에서 제거하려면 **삭제**를 클릭하세요.
<Warning>
- 제거된 구성원은 즉시 접근 권한을 잃습니다. 해당 구성원의 데이터(레코드, 노트, 작업)는 워크스페이스에 남아 있습니다.
+제거된 구성원은 즉시 접근 권한을 잃습니다. 해당 구성원의 데이터(레코드, 노트, 작업)는 워크스페이스에 남아 있습니다.
</Warning>
<Warning>
- **이메일 동기화도 제거됩니다.** 삭제된 사용자가 특정 이메일을 동기화한 유일한 사용자였다면 해당 이메일은 워크스페이스에서 영구적으로 제거됩니다.
+**이메일 동기화도 제거됩니다.** 삭제된 사용자가 특정 이메일을 동기화한 유일한 사용자였다면 해당 이메일은 워크스페이스에서 영구적으로 제거됩니다.
</Warning>
## 보류 중인 초대
@@ -77,7 +77,7 @@ description: 팀원을 초대하고 워크스페이스 접근 권한을 관리
팀원이 이메일 도메인에 따라 자동으로 참여할 수 있도록 허용합니다:
-1. **설정 → 도메인**으로 이동하세요.
+1. **설정 → 구성원 → 초대**로 이동하세요
2. 회사 도메인을 추가하세요(예: `yourcompany.com`).
3. 해당 이메일 도메인을 가진 사람은 초대 없이 참여할 수 있습니다.
diff --git a/packages/twenty-docs/l/ko/user-guide/settings/capabilities/profile-settings.mdx b/packages/twenty-docs/l/ko/user-guide/settings/capabilities/profile-settings.mdx
index a1cca266cda..0f645072927 100644
--- a/packages/twenty-docs/l/ko/user-guide/settings/capabilities/profile-settings.mdx
+++ b/packages/twenty-docs/l/ko/user-guide/settings/capabilities/profile-settings.mdx
@@ -32,7 +32,7 @@ description: 개인 프로필 및 보안 설정을 관리합니다.
### 계정 삭제
<Warning>
- 계정을 삭제하면 모든 워크스페이스에 대한 접근이 영구적으로 제거됩니다. 이 작업은 취소할 수 없으며, 특정 팀에서만 나가고자 한다면 개별 워크스페이스를 먼저 떠나는 것을 고려해야 합니다.
+계정을 삭제하면 모든 워크스페이스에 대한 접근이 영구적으로 제거됩니다. 이 작업은 취소할 수 없으며, 특정 팀에서만 나가고자 한다면 개별 워크스페이스를 먼저 떠나는 것을 고려해야 합니다.
</Warning>
계정을 삭제하려면:
diff --git a/packages/twenty-docs/l/ko/user-guide/settings/capabilities/updates-settings.mdx b/packages/twenty-docs/l/ko/user-guide/settings/capabilities/updates-settings.mdx
index 3391d232b67..e4f28574522 100644
--- a/packages/twenty-docs/l/ko/user-guide/settings/capabilities/updates-settings.mdx
+++ b/packages/twenty-docs/l/ko/user-guide/settings/capabilities/updates-settings.mdx
@@ -24,7 +24,7 @@ description: Twenty에서 얼리 액세스 기능을 활성화하세요.
5. 해당 기능이 즉시 사용 가능해집니다
<Note>
- 얼리 액세스 기능은 사용자 피드백에 따라 변경될 수 있습니다. 여러분의 피드백은 Twenty를 개선하는 데 도움이 됩니다!
+얼리 액세스 기능은 사용자 피드백에 따라 변경될 수 있습니다. 여러분의 피드백은 Twenty를 개선하는 데 도움이 됩니다!
</Note>
## 기능 피드백
diff --git a/packages/twenty-docs/l/ko/user-guide/settings/capabilities/workspace-settings.mdx b/packages/twenty-docs/l/ko/user-guide/settings/capabilities/workspace-settings.mdx
index 7c35a3da299..09c774f1cce 100644
--- a/packages/twenty-docs/l/ko/user-guide/settings/capabilities/workspace-settings.mdx
+++ b/packages/twenty-docs/l/ko/user-guide/settings/capabilities/workspace-settings.mdx
@@ -19,7 +19,7 @@ description: 작업 공간 이름과 브랜딩을 사용자 지정합니다.
## 위험 구역
<Warning>
- 작업 공간을 삭제하면 모든 데이터가 영구적으로 제거되며 되돌릴 수 없습니다. 모든 작업 공간 데이터가 영원히 손실되며, 모든 구성원이 즉시 접근 권한을 잃게 되며, 이 작업은 되돌릴 수 없습니다.
+작업 공간을 삭제하면 모든 데이터가 영구적으로 제거되며 되돌릴 수 없습니다. 모든 작업 공간 데이터가 영원히 손실되며, 모든 구성원이 즉시 접근 권한을 잃게 되며, 이 작업은 되돌릴 수 없습니다.
</Warning>
작업 공간을 삭제하려면:
diff --git a/packages/twenty-docs/l/ko/user-guide/settings/how-tos/settings-faq.mdx b/packages/twenty-docs/l/ko/user-guide/settings/how-tos/settings-faq.mdx
index 5d4ac7c1a58..8107644abf5 100644
--- a/packages/twenty-docs/l/ko/user-guide/settings/how-tos/settings-faq.mdx
+++ b/packages/twenty-docs/l/ko/user-guide/settings/how-tos/settings-faq.mdx
@@ -6,165 +6,165 @@ description: Twenty 설정에 대한 자주 묻는 질문입니다.
## 작업 공간 설정
<AccordionGroup>
- <Accordion title="워크스페이스 이름은 어떻게 변경하나요?">
- 1. **설정 → 일반**으로 이동하세요.
- 2. 워크스페이스 이름 필드를 찾으세요.
- 3. 새 이름을 입력하세요.
- 4. 변경 사항은 자동으로 저장됩니다.
- </Accordion>
-
- <Accordion title="워크스페이스 로고는 어떻게 변경하나요?">
- 1. **설정 → 일반**으로 이동하세요.
- 2. 현재 로고 또는 업로드 영역을 클릭하세요.
- 3. 10MB 이하의 PNG, JPEG 또는 GIF 이미지를 선택하세요.
- 4. 로고가 즉시 업데이트됩니다.
- </Accordion>
-
- <Accordion title="여러 개의 워크스페이스를 가질 수 있나요?">
- 네, 여러 워크스페이스를 생성하고 멤버가 될 수 있습니다. 각 워크스페이스는 고유한 데이터, 설정 및 구독을 가집니다.
- </Accordion>
-
- <Accordion title="워크스페이스를 삭제하려면 어떻게 해야 하나요?">
- 1. **설정 → 일반**으로 이동하세요.
- 2. 위험 구역까지 스크롤하세요.
- 3. **워크스페이스 삭제**를 클릭하세요.
- 4. 삭제를 확인하세요.
-
- 참고: 이 작업은 모든 데이터를 영구적으로 삭제하며 되돌릴 수 없습니다.
- </Accordion>
-
- <Accordion title="워크스페이스를 여러 개 실수로 생성했습니다. 어떻게 해야 하나요?">
- 필요하지 않은 워크스페이스는 **설정 → 일반 → 워크스페이스 삭제**에서 삭제하세요.
-
- <Warning>
- **계정**을 삭제하지 마세요(설정 → 프로필에서 접근 가능): 계정은 모든 워크스페이스에서 공유됩니다. 계정을 삭제하면 모든 워크스페이스에 대한 액세스가 제거됩니다.
- </Warning>
- </Accordion>
-
- <Accordion title="삭제하지 않고 워크스페이스를 비활성화하려면 어떻게 하나요?">
- 워크스페이스를 일시적으로 비활성화하려는 경우(영구 삭제가 아님) **설정 → 결제**로 이동하여 **플랜 취소**를 클릭하세요. 데이터는 유예 기간 동안 보존됩니다.
- </Accordion>
+<Accordion title="워크스페이스 이름은 어떻게 변경하나요?">
+1. **설정 → 일반**으로 이동하세요.
+2. 워크스페이스 이름 필드를 찾으세요.
+3. 새 이름을 입력하세요.
+4. 변경 사항은 자동으로 저장됩니다.
+</Accordion>
+
+<Accordion title="워크스페이스 로고는 어떻게 변경하나요?">
+1. **설정 → 일반**으로 이동하세요.
+2. 현재 로고 또는 업로드 영역을 클릭하세요.
+3. 10MB 이하의 PNG, JPEG 또는 GIF 이미지를 선택하세요.
+4. 로고가 즉시 업데이트됩니다.
+</Accordion>
+
+<Accordion title="여러 개의 워크스페이스를 가질 수 있나요?">
+네, 여러 워크스페이스를 생성하고 멤버가 될 수 있습니다. 각 워크스페이스는 고유한 데이터, 설정 및 구독을 가집니다.
+</Accordion>
+
+<Accordion title="워크스페이스를 삭제하려면 어떻게 해야 하나요?">
+1. **설정 → 일반**으로 이동하세요.
+2. 위험 구역까지 스크롤하세요.
+3. **워크스페이스 삭제**를 클릭하세요.
+4. 삭제를 확인하세요.
+
+참고: 이 작업은 모든 데이터를 영구적으로 삭제하며 되돌릴 수 없습니다.
+</Accordion>
+
+<Accordion title="워크스페이스를 여러 개 실수로 생성했습니다. 어떻게 해야 하나요?">
+필요하지 않은 워크스페이스는 **설정 → 일반 → 워크스페이스 삭제**에서 삭제하세요.
+
+<Warning>
+**계정**을 삭제하지 마세요(설정 → 프로필에서 접근 가능): 계정은 모든 워크스페이스에서 공유됩니다. 계정을 삭제하면 모든 워크스페이스에 대한 액세스가 제거됩니다.
+</Warning>
+</Accordion>
+
+<Accordion title="삭제하지 않고 워크스페이스를 비활성화하려면 어떻게 하나요?">
+워크스페이스를 일시적으로 비활성화하려는 경우(영구 삭제가 아님) **설정 → 결제**로 이동하여 **플랜 취소**를 클릭하세요. 데이터는 유예 기간 동안 보존됩니다.
+</Accordion>
</AccordionGroup>
## 프로필 설정
<AccordionGroup>
- <Accordion title="비밀번호는 어떻게 변경하나요?">
- 1. **설정 → 프로필**로 이동하세요.
- 2. 비밀번호 섹션을 찾으세요.
- 3. 현재 비밀번호를 입력하세요.
- 4. 새 비밀번호를 입력하세요.
- 5. 변경 사항을 저장하세요.
- </Accordion>
-
- <Accordion title="2단계 인증은 어떻게 활성화하나요?">
- 1. **설정 → 프로필**로 이동하세요.
- 2. 2단계 인증 섹션을 찾으세요.
- 3. **2FA 활성화** 클릭
- 4. 인증 앱으로 QR 코드를 스캔합니다
- 5. 인증 코드를 입력하세요.
- </Accordion>
-
- <Accordion title="이메일 주소를 변경할 수 있나요?">
- 이메일 주소를 변경하려면 [[email protected]](mailto:[email protected])으로 문의해 주세요.
- </Accordion>
-
- <Accordion title="계정을 삭제하려면 어떻게 해야 하나요?">
- 1. **설정 → 프로필**로 이동하세요.
- 2. 위험 구역까지 스크롤하세요.
- 3. **계정 삭제** 클릭
- 4. 이메일 주소를 입력하여 확인하세요.
-
- 참고: 이 작업은 모든 워크스페이스에 대한 액세스를 제거하고 연결된 계정에서 동기화된 모든 이메일을 삭제합니다.
- </Accordion>
+<Accordion title="비밀번호는 어떻게 변경하나요?">
+1. **설정 → 프로필**로 이동하세요.
+2. 비밀번호 섹션을 찾으세요.
+3. 현재 비밀번호를 입력하세요.
+4. 새 비밀번호를 입력하세요.
+5. 변경 사항을 저장하세요.
+</Accordion>
+
+<Accordion title="2단계 인증은 어떻게 활성화하나요?">
+1. **설정 → 프로필**로 이동하세요.
+2. 2단계 인증 섹션을 찾으세요.
+3. **2FA 활성화** 클릭
+4. 인증 앱으로 QR 코드를 스캔합니다
+5. 인증 코드를 입력하세요.
+</Accordion>
+
+<Accordion title="이메일 주소를 변경할 수 있나요?">
+이메일 주소를 변경하려면 [[email protected]](mailto:[email protected])으로 문의해 주세요.
+</Accordion>
+
+<Accordion title="계정을 삭제하려면 어떻게 해야 하나요?">
+1. **설정 → 프로필**로 이동하세요.
+2. 위험 구역까지 스크롤하세요.
+3. **계정 삭제** 클릭
+4. 이메일 주소를 입력하여 확인하세요.
+
+참고: 이 작업은 모든 워크스페이스에 대한 액세스를 제거하고 연결된 계정에서 동기화된 모든 이메일을 삭제합니다.
+</Accordion>
</AccordionGroup>
## 경험 설정
<AccordionGroup>
- <Accordion title="밝은 모드와 어두운 모드 간 전환은 어떻게 하나요?">
- 1. **설정 → 환경**으로 이동하세요.
- 2. 테마 섹션을 찾으세요.
- 3. 밝은 모드, 어두운 모드 또는 시스템을 선택하세요.
- </Accordion>
-
- <Accordion title="날짜 형식은 어떻게 변경하나요?">
- 1. **설정 → 환경**으로 이동하세요.
- 2. 날짜 형식 항목을 찾으세요.
- 3. 선호하는 형식을 선택하세요.
- 4. 변경 사항이 즉시 적용됩니다.
- </Accordion>
-
- <Accordion title="시간대는 어떻게 변경하나요?">
- 1. **설정 → 환경**으로 이동하세요.
- 2. 시간대 항목을 찾으세요.
- 3. 사용 중인 지역 시간대를 선택하세요.
- 4. 모든 타임스탬프가 조정됩니다.
- </Accordion>
-
- <Accordion title="언어를 변경할 수 있나요?">
- 1. **설정 → 환경**으로 이동하세요.
- 2. 언어 항목을 찾으세요.
- 3. 사용 가능한 언어 중에서 선택하세요.
- 4. 인터페이스가 선택한 언어로 업데이트됩니다.
- </Accordion>
+<Accordion title="밝은 모드와 어두운 모드 간 전환은 어떻게 하나요?">
+1. **설정 → 환경**으로 이동하세요.
+2. 테마 섹션을 찾으세요.
+3. 밝은 모드, 어두운 모드 또는 시스템을 선택하세요.
+</Accordion>
+
+<Accordion title="날짜 형식은 어떻게 변경하나요?">
+1. **설정 → 환경**으로 이동하세요.
+2. 날짜 형식 항목을 찾으세요.
+3. 선호하는 형식을 선택하세요.
+4. 변경 사항이 즉시 적용됩니다.
+</Accordion>
+
+<Accordion title="시간대는 어떻게 변경하나요?">
+1. **설정 → 환경**으로 이동하세요.
+2. 시간대 항목을 찾으세요.
+3. 사용 중인 지역 시간대를 선택하세요.
+4. 모든 타임스탬프가 조정됩니다.
+</Accordion>
+
+<Accordion title="언어를 변경할 수 있나요?">
+1. **설정 → 환경**으로 이동하세요.
+2. 언어 항목을 찾으세요.
+3. 사용 가능한 언어 중에서 선택하세요.
+4. 인터페이스가 선택한 언어로 업데이트됩니다.
+</Accordion>
</AccordionGroup>
## 계정 설정
<AccordionGroup>
- <Accordion title="이메일 계정은 어떻게 연결하나요?">
- 1. **설정 → 계정**으로 이동
- 2. **계정 추가**를 클릭
- 3. Google 또는 Microsoft를 선택하세요.
- 4. 액세스 권한을 승인하세요.
- 5. 동기화 설정을 구성하세요.
- </Accordion>
-
- <Accordion title="여러 이메일 계정을 연결할 수 있나요?">
- 네, 여러 이메일 계정을 연결할 수 있습니다. **설정 → 계정**으로 이동하여 필요한 계정을 추가하세요.
- </Accordion>
-
- <Accordion title="이메일 계정 연결을 해제하려면 어떻게 하나요?">
- 1. **설정 → 계정**으로 이동
- 2. 제거할 계정을 찾으세요.
- 3. **연결 해제**를 클릭하세요.
- 4. 작업을 확인하세요.
- </Accordion>
+<Accordion title="이메일 계정은 어떻게 연결하나요?">
+1. **설정 → 계정**으로 이동
+2. **계정 추가**를 클릭
+3. Google 또는 Microsoft를 선택하세요.
+4. 액세스 권한을 승인하세요.
+5. 동기화 설정을 구성하세요.
+</Accordion>
+
+<Accordion title="여러 이메일 계정을 연결할 수 있나요?">
+네, 여러 이메일 계정을 연결할 수 있습니다. **설정 → 계정**으로 이동하여 필요한 계정을 추가하세요.
+</Accordion>
+
+<Accordion title="이메일 계정 연결을 해제하려면 어떻게 하나요?">
+1. **설정 → 계정**으로 이동
+2. 제거할 계정을 찾으세요.
+3. **연결 해제**를 클릭하세요.
+4. 작업을 확인하세요.
+</Accordion>
</AccordionGroup>
## 도메인
<AccordionGroup>
- <Accordion title="워크스페이스 도메인을 맞춤 설정할 수 있나요?">
- 예! **설정 → 도메인**으로 이동하여 **도메인 사용자 지정**을 클릭하세요. 다음 두 가지 옵션이 있습니다:
+<Accordion title="워크스페이스 도메인을 맞춤 설정할 수 있나요?">
+예! **설정 → 일반 → 워크스페이스 도메인**으로 이동하여 **도메인 사용자 지정**을 클릭하세요. 다음 두 가지 옵션이 있습니다:
- * **서브도메인**: `yourcompany.twenty.com`과 같은 Twenty 서브도메인을 사용합니다.
- * **사용자 지정 도메인**: `crm.yourcompany.com`과 같은 본인 소유 도메인을 사용합니다(DNS 구성이 필요).
+* **서브도메인**: `yourcompany.twenty.com`과 같은 Twenty 서브도메인을 사용합니다.
+* **사용자 지정 도메인**: `crm.yourcompany.com`과 같은 본인 소유 도메인을 사용합니다(DNS 구성이 필요).
- 서브도메인은 빠르게 설정할 수 있고, 사용자 지정 도메인은 팀에 완전한 브랜드 경험을 제공합니다.
- </Accordion>
+서브도메인은 빠르게 설정할 수 있고, 사용자 지정 도메인은 팀에 완전한 브랜드 경험을 제공합니다.
+</Accordion>
- <Accordion title="승인된 접근 도메인은 어떻게 작동하나요?">
- 승인된 접근 도메인을 구성하면 회사 이메일 주소를 가진 팀원이 워크스페이스에 자동으로 참여할 수 있습니다. **설정 → 도메인**으로 이동하여 회사 도메인(예: `yourcompany.com`)을 추가하세요.
- </Accordion>
+<Accordion title="승인된 접근 도메인은 어떻게 작동하나요?">
+승인된 접근 도메인을 구성하면 회사 이메일 주소를 가진 팀원이 워크스페이스에 자동으로 참여할 수 있습니다. **설정 → 구성원 → 초대**로 이동하여 회사 도메인(예: `yourcompany.com`)을 추가하세요.
+</Accordion>
</AccordionGroup>
## 얼리 액세스 기능
<AccordionGroup>
- <Accordion title="얼리 액세스 기능이란 무엇인가요?">
- 얼리 액세스 기능은 일반 출시 전에 테스트 중인 기능입니다. 현재는 **대시보드**만 얼리 액세스로 제공됩니다. 사용자 피드백에 따라 변경될 수 있습니다.
- </Accordion>
-
- <Accordion title="얼리 액세스 기능을 사용해도 안전한가요?">
- 얼리 액세스 기능은 정상적으로 동작하지만 사용자 피드백에 따라 변경될 수 있습니다. 사용해도 안전하지만 일반 제공 이전에 변경될 수 있습니다.
- </Accordion>
-
- <Accordion title="얼리 액세스 기능은 어떻게 활성화하나요?">
- 1. **설정 → 업데이트 → 얼리 액세스**로 이동하세요
- 2. 원하는 기능을 찾으세요.
- 3. 토글하여 활성화하세요.
- 4. 해당 기능이 즉시 사용 가능해집니다.
- </Accordion>
+<Accordion title="얼리 액세스 기능이란 무엇인가요?">
+얼리 액세스 기능은 일반 출시 전에 테스트 중인 기능입니다. 현재는 **대시보드**만 얼리 액세스로 제공됩니다. 사용자 피드백에 따라 변경될 수 있습니다.
+</Accordion>
+
+<Accordion title="얼리 액세스 기능을 사용해도 안전한가요?">
+얼리 액세스 기능은 정상적으로 동작하지만 사용자 피드백에 따라 변경될 수 있습니다. 사용해도 안전하지만 일반 제공 이전에 변경될 수 있습니다.
+</Accordion>
+
+<Accordion title="얼리 액세스 기능은 어떻게 활성화하나요?">
+1. **설정 → 업데이트 → 얼리 액세스**로 이동하세요
+2. 원하는 기능을 찾으세요.
+3. 토글하여 활성화하세요.
+4. 해당 기능이 즉시 사용 가능해집니다.
+</Accordion>
</AccordionGroup>
diff --git a/packages/twenty-docs/l/ko/user-guide/settings/overview.mdx b/packages/twenty-docs/l/ko/user-guide/settings/overview.mdx
index c8402aa3eae..056ae91b9ce 100644
--- a/packages/twenty-docs/l/ko/user-guide/settings/overview.mdx
+++ b/packages/twenty-docs/l/ko/user-guide/settings/overview.mdx
@@ -3,7 +3,6 @@ title: 설정
description: 필수 구성으로 Twenty 워크스페이스를 설정하세요.
---
-
## 초기 설정
워크스페이스를 처음 만들 때 구성해야 할 몇 가지 핵심 설정이 있습니다.
@@ -45,7 +44,7 @@ description: 필수 구성으로 Twenty 워크스페이스를 설정하세요.
4. 적절한 역할을 할당하세요
<Note>
- 팀을 초대하기 전에 **설정 → 역할**에서 기본 역할을 확인하세요. 새 구성원은 가입하면 이 역할이 자동으로 할당됩니다.
+팀을 초대하기 전에 **설정 → 구성원 → 역할**에서 기본 역할을 확인하세요. 새 구성원은 가입하면 이 역할이 자동으로 할당됩니다.
</Note>
## 워크스페이스 설정 체크리스트
diff --git a/packages/twenty-docs/l/ko/user-guide/views-pipelines/capabilities/table-views.mdx b/packages/twenty-docs/l/ko/user-guide/views-pipelines/capabilities/table-views.mdx
index f35a45cf65b..dfec3de966c 100644
--- a/packages/twenty-docs/l/ko/user-guide/views-pipelines/capabilities/table-views.mdx
+++ b/packages/twenty-docs/l/ko/user-guide/views-pipelines/capabilities/table-views.mdx
@@ -38,7 +38,7 @@ description: 스프레드시트와 유사한 목록 형식으로 데이터를
* 작업을 상태별로 그룹화
<Note>
- **최상의 성능을 위해 표시되는 그룹을 10~15개로 제한하세요.** 더 필요하다면 대신 대시보드를 사용하는 것을 고려하세요.
+**최상의 성능을 위해 표시되는 그룹을 10~15개로 제한하세요.** 더 필요하다면 대신 대시보드를 사용하는 것을 고려하세요.
</Note>
### 열 너비
diff --git a/packages/twenty-docs/l/ko/user-guide/views-pipelines/capabilities/view-settings.mdx b/packages/twenty-docs/l/ko/user-guide/views-pipelines/capabilities/view-settings.mdx
index 25df099b1bb..c31222f0428 100644
--- a/packages/twenty-docs/l/ko/user-guide/views-pipelines/capabilities/view-settings.mdx
+++ b/packages/twenty-docs/l/ko/user-guide/views-pipelines/capabilities/view-settings.mdx
@@ -21,7 +21,7 @@ description: 보기의 가시성, 이름, 아이콘 및 구성을 관리하세
3. **워크스페이스** 또는 **비공개**를 선택하세요.
<Note>
- 기본 "All [Object Name]" 보기는 가시성을 변경할 수 없습니다.
+기본 "All [Object Name]" 보기는 가시성을 변경할 수 없습니다.
</Note>
## 보기 이름 변경
@@ -65,7 +65,7 @@ description: 보기의 가시성, 이름, 아이콘 및 구성을 관리하세
4. 삭제를 확인하세요.
<Warning>
- 삭제된 보기는 복구할 수 없습니다.
+삭제된 보기는 복구할 수 없습니다.
</Warning>
## 관련 항목
diff --git a/packages/twenty-docs/l/ko/user-guide/views-pipelines/how-tos/create-a-table-view-with-grouping.mdx b/packages/twenty-docs/l/ko/user-guide/views-pipelines/how-tos/create-a-table-view-with-grouping.mdx
index cb7cd779db1..093f580323d 100644
--- a/packages/twenty-docs/l/ko/user-guide/views-pipelines/how-tos/create-a-table-view-with-grouping.mdx
+++ b/packages/twenty-docs/l/ko/user-guide/views-pipelines/how-tos/create-a-table-view-with-grouping.mdx
@@ -32,7 +32,7 @@ import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
뷰에서 숨기려면 그룹 옆의 **눈 아이콘**을 클릭하세요.
<Note>
- **최상의 성능을 위해 표시되는 그룹을 10~15개로 제한하세요.** 더 필요하다면 대신 대시보드를 사용하는 것을 고려하세요.
+**최상의 성능을 위해 표시되는 그룹을 10~15개로 제한하세요.** 더 필요하다면 대신 대시보드를 사용하는 것을 고려하세요.
</Note>
## 예: 업종별 회사
diff --git a/packages/twenty-docs/l/ko/user-guide/views-pipelines/how-tos/set-up-a-sales-pipeline.mdx b/packages/twenty-docs/l/ko/user-guide/views-pipelines/how-tos/set-up-a-sales-pipeline.mdx
index d08d2b1e716..ea7ff04a760 100644
--- a/packages/twenty-docs/l/ko/user-guide/views-pipelines/how-tos/set-up-a-sales-pipeline.mdx
+++ b/packages/twenty-docs/l/ko/user-guide/views-pipelines/how-tos/set-up-a-sales-pipeline.mdx
@@ -31,7 +31,7 @@ Twenty의 영업 파이프라인은 기회 객체의 칸반 보기로, 각 열
| **Closed Lost** | 거래 실패 |
<Note>
- **5-7개 단계가 최적입니다.** 단계가 너무 많으면 파이프라인을 한눈에 파악하기 어렵고, 너무 적으면 거래 진행 상황의 가시성이 떨어집니다.
+**5-7개 단계가 최적입니다.** 단계가 너무 많으면 파이프라인을 한눈에 파악하기 어렵고, 너무 적으면 거래 진행 상황의 가시성이 떨어집니다.
</Note>
## 2단계: 파이프라인 보기 만들기
diff --git a/packages/twenty-docs/l/ko/user-guide/views-pipelines/how-tos/show-expected-amount-in-pipeline.mdx b/packages/twenty-docs/l/ko/user-guide/views-pipelines/how-tos/show-expected-amount-in-pipeline.mdx
index e313a96671d..9b9c62a7106 100644
--- a/packages/twenty-docs/l/ko/user-guide/views-pipelines/how-tos/show-expected-amount-in-pipeline.mdx
+++ b/packages/twenty-docs/l/ko/user-guide/views-pipelines/how-tos/show-expected-amount-in-pipeline.mdx
@@ -6,7 +6,7 @@ description: 단계별 확률을 기준으로 거래 금액에 가중치를 적
예상 금액은 계산된 값입니다: **Amount × Probability**. 이는 거래의 성사 가능성에 따른 가중치를 적용해 매출을 예측하는 데 도움이 됩니다.
<Tip>
- 이는 워크플로를 사용하여 [수식 필드](/l/ko/user-guide/workflows/how-tos/crm-automations/formula-fields)를 만드는 예시입니다.
+이는 워크플로를 사용하여 [수식 필드](/l/ko/user-guide/workflows/how-tos/crm-automations/formula-fields)를 만드는 예시입니다.
</Tip>
이 가이드는 파이프라인에서 예상 금액을 계산하고 표시하는 데 필요한 사용자 정의 필드와 워크플로를 설정하는 방법을 안내합니다.
@@ -38,7 +38,7 @@ Opportunities 객체에 사용자 정의 필드 두 개가 필요합니다.
사용자가 이러한 계산된 필드를 수동으로 편집하지 못하게 하려면:
-1. **설정 → 역할**로 이동
+1. **설정 → 구성원 → 역할**로 이동하세요
2. 구성할 역할을 선택합니다.
3. Opportunities 객체를 찾습니다.
4. **Probability** 및 **Expected Amount** 필드를 읽기 전용으로 설정합니다.
@@ -76,7 +76,7 @@ Opportunities 객체에 사용자 정의 필드 두 개가 필요합니다.
| Closed Lost | 0% |
<Note>
- 새 분기를 만들려면 워크플로 캔버스를 마우스 오른쪽 버튼으로 클릭하고 **New action**을 클릭합니다. 그런 다음 이전 노드에서 이 새 액션으로 화살표를 드래그하여 이전 노드와 연결합니다.
+새 분기를 만들려면 워크플로 캔버스를 마우스 오른쪽 버튼으로 클릭하고 **New action**을 클릭합니다. 그런 다음 이전 노드에서 이 새 액션으로 화살표를 드래그하여 이전 노드와 연결합니다.
</Note>
각 단계에 대해:
diff --git a/packages/twenty-docs/l/ko/user-guide/views-pipelines/how-tos/track-time-in-stage.mdx b/packages/twenty-docs/l/ko/user-guide/views-pipelines/how-tos/track-time-in-stage.mdx
index 7241f2380ed..5303b573c70 100644
--- a/packages/twenty-docs/l/ko/user-guide/views-pipelines/how-tos/track-time-in-stage.mdx
+++ b/packages/twenty-docs/l/ko/user-guide/views-pipelines/how-tos/track-time-in-stage.mdx
@@ -4,7 +4,7 @@ description: 영업 기회가 각 단계에 진입한 시점을 추적하여 거
---
<Tip>
- 이는 워크플로를 사용해 [수식 필드](/l/ko/user-guide/workflows/how-tos/crm-automations/formula-fields)를 만드는 예시로, 특히 날짜 계산에 관한 내용입니다.
+이는 워크플로를 사용해 [수식 필드](/l/ko/user-guide/workflows/how-tos/crm-automations/formula-fields)를 만드는 예시로, 특히 날짜 계산에 관한 내용입니다.
</Tip>
영업 기회가 각 단계에 진입한 시점을 추적하면 병목을 파악하고 거래 속도를 측정할 수 있습니다.
@@ -54,14 +54,14 @@ description: 영업 기회가 각 단계에 진입한 시점을 추적하여 거
* Days in Negotiation
<Note>
- "Closed Won"과 "Closed Lost"는 마지막 단계이므로 "Days in" 필드는 필요하지 않습니다.
+"Closed Won"과 "Closed Lost"는 마지막 단계이므로 "Days in" 필드는 필요하지 않습니다.
</Note>
### 선택 사항: 필드를 읽기 전용으로 설정
사용자가 이 계산된 필드를 수동으로 편집하지 못하게 하려면:
-1. **설정 → 역할**로 이동
+1. **설정 → 구성원 → 역할**로 이동하세요
2. 구성할 역할을 선택합니다
3. Opportunities 오브젝트를 찾습니다
4. "Last Entered" 및 "Days in" 필드를 읽기 전용으로 설정합니다
@@ -88,7 +88,7 @@ description: 영업 기회가 각 단계에 진입한 시점을 추적하여 거
### 각 단계에 대한 브랜치 추가
<Note>
- 새 브랜치를 만들려면 워크플로 캔버스에서 마우스 오른쪽 버튼을 클릭하고 **New action**을 클릭합니다. 그런 다음 이전 노드에서 이 새 액션으로 화살표를 끌어 이전 노드와 이 액션을 연결합니다.
+새 브랜치를 만들려면 워크플로 캔버스에서 마우스 오른쪽 버튼을 클릭하고 **New action**을 클릭합니다. 그런 다음 이전 노드에서 이 새 액션으로 화살표를 끌어 이전 노드와 이 액션을 연결합니다.
</Note>
---
diff --git a/packages/twenty-docs/l/ko/user-guide/views-pipelines/overview.mdx b/packages/twenty-docs/l/ko/user-guide/views-pipelines/overview.mdx
index d585869f103..84ce691300b 100644
--- a/packages/twenty-docs/l/ko/user-guide/views-pipelines/overview.mdx
+++ b/packages/twenty-docs/l/ko/user-guide/views-pipelines/overview.mdx
@@ -5,7 +5,6 @@ description: Twenty에서 보기를 생성하고 관리하는 방법을 알아
import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
-
## 보기 이해하기
보기는 데이터가 어떻게 표시될지를 결정하는 저장된 구성입니다. 각 보기는 다음을 고유하게 가질 수 있습니다:
@@ -106,7 +105,7 @@ import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
5. 삭제를 확인합니다.
<Warning>
- 삭제된 보기는 복구할 수 없습니다. 확인하기 전에 제거할지 반드시 확인하세요.
+삭제된 보기는 복구할 수 없습니다. 확인하기 전에 제거할지 반드시 확인하세요.
</Warning>
## 뷰 가시성
@@ -122,7 +121,7 @@ import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
* **비공개**: 본인에게만 표시
<Note>
- 기본 "모든 [객체 이름]" 보기는 가시성을 변경할 수 없습니다.
+기본 "모든 [객체 이름]" 보기는 가시성을 변경할 수 없습니다.
</Note>
## 다음 단계
diff --git a/packages/twenty-docs/l/ko/user-guide/workflows/capabilities/send-emails-from-workflows.mdx b/packages/twenty-docs/l/ko/user-guide/workflows/capabilities/send-emails-from-workflows.mdx
index 39bed8f00f1..a5d4d6989b9 100644
--- a/packages/twenty-docs/l/ko/user-guide/workflows/capabilities/send-emails-from-workflows.mdx
+++ b/packages/twenty-docs/l/ko/user-guide/workflows/capabilities/send-emails-from-workflows.mdx
@@ -135,7 +135,7 @@ The Team
| **이벤트 확인** | 이벤트 세부 정보 또는 일정 |
<Note>
- 첨부 파일은 정적입니다—모든 수신자에게 동일한 파일이 전송됩니다. 개인화된 견적서와 같은 동적 문서의 경우 [로직 함수](/l/ko/user-guide/workflows/how-tos/connect-to-other-tools/generate-pdf-from-twenty)를 사용하여 파일을 생성하고 첨부합니다.
+첨부 파일은 정적입니다—모든 수신자에게 동일한 파일이 전송됩니다. 개인화된 견적서와 같은 동적 문서의 경우 [로직 함수](/l/ko/user-guide/workflows/how-tos/connect-to-other-tools/generate-pdf-from-twenty)를 사용하여 파일을 생성하고 첨부합니다.
</Note>
## 모범 사례
diff --git a/packages/twenty-docs/l/ko/user-guide/workflows/capabilities/use-branches-in-workflows.mdx b/packages/twenty-docs/l/ko/user-guide/workflows/capabilities/use-branches-in-workflows.mdx
index 2ae5d6e7620..ed4c8739dce 100644
--- a/packages/twenty-docs/l/ko/user-guide/workflows/capabilities/use-branches-in-workflows.mdx
+++ b/packages/twenty-docs/l/ko/user-guide/workflows/capabilities/use-branches-in-workflows.mdx
@@ -42,7 +42,7 @@ description: 분기가 어떻게 작동하는지와 어떤 경로가 실행될
## 분기 생성
<Note>
- 기존 단계에서 새 분기를 만들려면 해당 단계의 **+** 버튼을 클릭하고 액션을 추가하세요. \*\*+\*\*를 여러 번 클릭하여 여러 분기를 추가할 수 있습니다.
+기존 단계에서 새 분기를 만들려면 해당 단계의 **+** 버튼을 클릭하고 액션을 추가하세요. \*\*+\*\*를 여러 번 클릭하여 여러 분기를 추가할 수 있습니다.
</Note>
1. 워크플로우 편집기에서 분기를 만들고자 하는 단계를 선택하세요
diff --git a/packages/twenty-docs/l/ko/user-guide/workflows/capabilities/workflow-actions.mdx b/packages/twenty-docs/l/ko/user-guide/workflows/capabilities/workflow-actions.mdx
index 07e37d10b78..05c393c2ca6 100644
--- a/packages/twenty-docs/l/ko/user-guide/workflows/capabilities/workflow-actions.mdx
+++ b/packages/twenty-docs/l/ko/user-guide/workflows/capabilities/workflow-actions.mdx
@@ -10,9 +10,9 @@ import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
트리거가 발생한 후의 동작 정의. 여러 동작을 서로 연결해 복잡한 자동화를 구축할 수 있습니다.
<Tip>
- * 변수 선택기(`(x+)` 아이콘)을 클릭하여 이전 단계의 사용 가능한 데이터를 탐색하세요.
- * 어떤 입력 필드 위에 마우스를 올려두면 변수가 어느 단계에서 왔는지 확인할 수 있습니다 — 동일한 필드(예: ID)가 여러 이전 단계에 존재하는 경우 유용합니다.
- * 유지 관리를 쉽게 하려면 각 동작에 설명적인 이름을 지정하세요.
+* 변수 선택기(`(x+)` 아이콘)을 클릭하여 이전 단계의 사용 가능한 데이터를 탐색하세요.
+* 어떤 입력 필드 위에 마우스를 올려두면 변수가 어느 단계에서 왔는지 확인할 수 있습니다 — 동일한 필드(예: ID)가 여러 이전 단계에 존재하는 경우 유용합니다.
+* 유지 관리를 쉽게 하려면 각 동작에 설명적인 이름을 지정하세요.
</Tip>
## 레코드 동작
@@ -71,7 +71,7 @@ import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
**출력**: 매칭된 레코드를 반환하여 다음 단계에서 사용 가능.
<Note>
- **제한**: Search Records는 최대 **200개 레코드**를 반환합니다. 더 많이 처리해야 하는 경우, 결과를 줄이기 위해 특정 필터를 추가하거나 예약된 워크플로를 사용해 배치로 처리하세요.
+**제한**: Search Records는 최대 **200개 레코드**를 반환합니다. 더 많이 처리해야 하는 경우, 결과를 줄이기 위해 특정 필터를 추가하거나 예약된 워크플로를 사용해 배치로 처리하세요.
</Note>
**모범 사례**: Search Records 이후 [분기](/l/ko/user-guide/workflows/capabilities/workflow-branches)를 사용하여 "발견됨" vs "찾을 수 없음" 시나리오를 처리하세요.
@@ -89,7 +89,7 @@ import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
* 필드 값을 입력하세요. 고유 식별자 중 최소 하나는 반드시 입력하세요.
<Note>
- **고유 식별자를 하나만 추가하면 일치가 더 잘 작동하는 경우가 많습니다.** 예를 들어 아래 스크린샷은 도메인을 기준으로 회사를 일치시킵니다. ID가 반드시 필요한 것은 아닙니다.
+**고유 식별자를 하나만 추가하면 일치가 더 잘 작동하는 경우가 많습니다.** 예를 들어 아래 스크린샷은 도메인을 기준으로 회사를 일치시킵니다. ID가 반드시 필요한 것은 아닙니다.
</Note>
<img src="/images/user-guide/workflows/upsert_simple_identifier.png" style={{width:'100%'}} />
@@ -116,8 +116,8 @@ import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
* 반복 내에서 각 레코드에 대해 수행할 액션 정의.
<Note>
- - 이터레이터 내에 여러 작업을 추가할 수 있습니다.
- - 이터레이터 내부에 분기를 사용할 때, 각 분기의 마지막 단계가 루프를 닫도록 이터레이터로 다시 연결되는지 확인하세요.
+- 이터레이터 내에 여러 작업을 추가할 수 있습니다.
+- 이터레이터 내부에 분기를 사용할 때, 각 분기의 마지막 단계가 루프를 닫도록 이터레이터로 다시 연결되는지 확인하세요.
</Note>
* `Current Item` 필드에 접근: 현재 처리 중인 레코드의 필드를 사용하려면 **Iterator** 단계에서 **Current item**을 선택하세요. 해당 레코드에서 사용 가능한 필드 목록이 표시되며, 이후 작업에서 사용하도록 선택할 수 있습니다.
@@ -135,8 +135,8 @@ import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
* 다음 단계로 전달할 레코드 구성
<Note>
- 1. **출력**: 필터 노드는 데이터를 반환하지 않으며 게이트 역할을 합니다. 조건을 충족하면 워크플로우가 계속됩니다. 그렇지 않으면 해당 분기에서 워크플로우가 중지됩니다.
- 2. 숫자 필드에서 `IS` 연산자를 사용할 수 있습니다. 이는 `EQUAL`과 동일하게 동작합니다.
+1. **출력**: 필터 노드는 데이터를 반환하지 않으며 게이트 역할을 합니다. 조건을 충족하면 워크플로우가 계속됩니다. 그렇지 않으면 해당 분기에서 워크플로우가 중지됩니다.
+2. 숫자 필드에서 `IS` 연산자를 사용할 수 있습니다. 이는 `EQUAL`과 동일하게 동작합니다.
</Note>
### 지연
@@ -167,7 +167,7 @@ import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
* 영업시간에 작업을 예약
<Note>
- 예약 날짜는 과거일 수 없습니다. 이전 단계의 날짜 필드를 사용했고 그 날짜가 이미 지났다면, 워크플로우가 실패합니다.
+예약 날짜는 과거일 수 없습니다. 이전 단계의 날짜 필드를 사용했고 그 날짜가 이미 지났다면, 워크플로우가 실패합니다.
</Note>
**제한 및 크레딧**:
@@ -190,7 +190,7 @@ import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
* 발신 이메일 계정을 선택합니다
<Note>
- 자신의 Twenty 계정과 동기화된 메일함에서만 이메일을 보낼 수 있습니다. 다른 팀원의 메일함(예: 계정 소유자의 이메일)에서 보내는 기능은 향후 지원 예정입니다.
+자신의 Twenty 계정과 동기화된 메일함에서만 이메일을 보낼 수 있습니다. 다른 팀원의 메일함(예: 계정 소유자의 이메일)에서 보내는 기능은 향후 지원 예정입니다.
</Note>
이후 모든 단계에서 개인화를 위해 이전 단계의 변수를 참조할 수 있습니다.
@@ -198,14 +198,14 @@ import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
* 수신자 이메일 주소 입력.
<Note>
- 현재는 수신자를 한 명만 지정할 수 있습니다.
+현재는 수신자를 한 명만 지정할 수 있습니다.
</Note>
* 제목 설정.
* 메시지 본문 작성. 링크 서식 지정, 번호 매기기 목록 및 글머리 기호 목록 생성, 첨부 파일 추가가 가능합니다.
<Note>
- 현재는 HTML 서명을 추가할 수 없습니다.
+현재는 HTML 서명을 추가할 수 없습니다.
</Note>
### 양식
@@ -213,7 +213,7 @@ import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
워크플로우 실행 중에 양식을 표시하여 사용자 입력을 수집합니다. 이 응답은 이후 단계에서 입력을 기반으로 레코드 생성, 이메일 전송 또는 기타 작업 수행에 사용할 수 있습니다.
<Warning>
- **양식은 수동 트리거 전용으로 설계되었습니다**. 다른 트리거 (레코드 생성, 업데이트 등)와 함께하는 워크플로우의 경우, 형식은 워크플로우 실행 인터페이스를 통해서만 접근 가능하여 기대와 달라짐. 2026년 자동 워크플로우에서 양식을 적절히 지원하기 위한 알림 센터가 출시될 예정입니다.
+**양식은 수동 트리거 전용으로 설계되었습니다**. 다른 트리거 (레코드 생성, 업데이트 등)와 함께하는 워크플로우의 경우, 형식은 워크플로우 실행 인터페이스를 통해서만 접근 가능하여 기대와 달라짐. 2026년 자동 워크플로우에서 양식을 적절히 지원하기 위한 알림 센터가 출시될 예정입니다.
</Warning>
**구성**:
@@ -234,7 +234,7 @@ import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
* 사이드 패널에 표시된 양식을 작성하고 `Submit`을 클릭하세요.
<Note>
- 필드를 필수로 지정할 수 없습니다.
+필드를 필수로 지정할 수 없습니다.
</Note>
<VimeoEmbed videoId="1147277989" title="동영상 시연" />
@@ -256,15 +256,15 @@ import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
* 해당 단계에서 코드를 직접 테스트하세요
<Note>
- 코드에서 외부 API 키를 사용해야 하는 경우, 함수 본문에 직접 입력해야 합니다. You cannot configure API keys elsewhere and reference them in the logic function.
+코드에서 외부 API 키를 사용해야 하는 경우, 함수 본문에 직접 입력해야 합니다. You cannot configure API keys elsewhere and reference them in the logic function.
</Note>
<Tip>
- **배열을 다루고 있나요?** 외부 시스템이나 이전 단계에서 전달된 배열이 문자열로 올 수 있습니다. 해결 방법은 [Code 액션에서 배열 처리하기](/l/ko/user-guide/workflows/how-tos/advanced-configurations/handle-arrays-in-code-actions)를 참조하세요.
+**배열을 다루고 있나요?** 외부 시스템이나 이전 단계에서 전달된 배열이 문자열로 올 수 있습니다. 해결 방법은 [Code 액션에서 배열 처리하기](/l/ko/user-guide/workflows/how-tos/advanced-configurations/handle-arrays-in-code-actions)를 참조하세요.
</Tip>
<Tip>
- 코드 편집기 오른쪽 상단의 사각형 아이콘을 클릭하여 전체 화면으로 표시하세요 — 기본 편집기 너비가 제한되어 있어 유용합니다.
+코드 편집기 오른쪽 상단의 사각형 아이콘을 클릭하여 전체 화면으로 표시하세요 — 기본 편집기 너비가 제한되어 있어 유용합니다.
</Tip>
### HTTP 요청
@@ -303,9 +303,9 @@ import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
**출력**: AI 에이전트의 응답을 이후 단계에서 사용할 수 있습니다. 에이전트에 구조화된 출력 스키마가 있는 경우 응답은 해당 형식을 따릅니다.
<Note>
- AI 에이전트 작업은 사용된 AI 모델에 따라 워크플로우 크레딧을 소모합니다. 자세한 내용은 [워크플로우 크레딧](/l/ko/user-guide/workflows/capabilities/workflow-credits)을 참조하세요.
+AI 에이전트 작업은 사용된 AI 모델에 따라 워크플로우 크레딧을 소모합니다. 자세한 내용은 [워크플로우 크레딧](/l/ko/user-guide/workflows/capabilities/workflow-credits)을 참조하세요.
</Note>
<Note>
- AI 에이전트는 역할 기반 권한을 준수합니다. **설정 → 역할**에서 에이전트에 특정 역할을 할당해, 액세스할 수 있는 데이터를 제어할 수 있습니다. 자세한 내용은 [권한](/l/ko/user-guide/permissions-access/capabilities/permissions)을 참조하세요.
+AI 에이전트는 역할 기반 권한을 준수합니다. **설정 → 멤버 → 역할**에서 에이전트에 특정 역할을 할당해 액세스할 수 있는 데이터를 제어할 수 있습니다. 자세한 내용은 [권한](/l/ko/user-guide/permissions-access/capabilities/permissions)을 참조하세요.
</Note>
diff --git a/packages/twenty-docs/l/ko/user-guide/workflows/capabilities/workflow-branches.mdx b/packages/twenty-docs/l/ko/user-guide/workflows/capabilities/workflow-branches.mdx
index 39c3850071a..d98fbfc8db4 100644
--- a/packages/twenty-docs/l/ko/user-guide/workflows/capabilities/workflow-branches.mdx
+++ b/packages/twenty-docs/l/ko/user-guide/workflows/capabilities/workflow-branches.mdx
@@ -22,7 +22,7 @@ description: 워크플로우에서 병렬 경로와 조건부 로직을 생성
5. 같은 노드에서 더 많은 분기를 추가하려면 이 과정을 반복하세요
<Note>
- 각 분기는 독립적입니다. 분기를 추가해도 해당 노드의 다른 기존 경로에는 영향을 주지 않습니다.
+각 분기는 독립적입니다. 분기를 추가해도 해당 노드의 다른 기존 경로에는 영향을 주지 않습니다.
</Note>
### 시각적 레이아웃
@@ -55,7 +55,7 @@ description: 워크플로우에서 병렬 경로와 조건부 로직을 생성
* **옵션 2: 분기를 수동으로 병합**\n 워크플로우를 만들 때 여러 분기를 동일한 다운스트림 작업에 수동으로 연결할 수 있습니다. 각 분기의 끝에서 공통 노드로 화살표를 드래그하기만 하면 됩니다.
<Note>
- 실행을 일시 중지하려면 [Delay](/l/ko/user-guide/workflows/capabilities/workflow-actions#delay) 노드를 사용할 수 있지만, 현재는 "다른 분기가 끝날 때까지" 대기하도록 설정할 수 없습니다.
+실행을 일시 중지하려면 [Delay](/l/ko/user-guide/workflows/capabilities/workflow-actions#delay) 노드를 사용할 수 있지만, 현재는 "다른 분기가 끝날 때까지" 대기하도록 설정할 수 없습니다.
</Note>
## 관련 항목
diff --git a/packages/twenty-docs/l/ko/user-guide/workflows/capabilities/workflow-credits.mdx b/packages/twenty-docs/l/ko/user-guide/workflows/capabilities/workflow-credits.mdx
index 46194d8b7cd..f87c375fdce 100644
--- a/packages/twenty-docs/l/ko/user-guide/workflows/capabilities/workflow-credits.mdx
+++ b/packages/twenty-docs/l/ko/user-guide/workflows/capabilities/workflow-credits.mdx
@@ -9,13 +9,13 @@ description: 워크플로우 크레딧 소모 및 관리 이해하기.
워크플로우 크레딧은 요금제 티어가 아니라 청구 주기에 따라 할당됩니다:
-| 청구 주기 | 크레딧 |
-| --------- | ------------- |
-| **월간 구독** | 매월 500만 크레딧 |
-| **연간 구독** | 매년 5,000만 크레딧 |
+| 청구 주기 | 크레딧 |
+| --------- | --------- |
+| **월간 구독** | 매월 5 크레딧 |
+| **연간 구독** | 매년 50 크레딧 |
<Note>
- 표준 자동화에는 매월 500만 크레딧이면 넉넉합니다. 대부분의 팀은 일반적인 워크플로우 사용으로 이 한도를 초과하지 않습니다. 추가 크레딧은 주로 고급 Code 작업 및 AI 기반 워크플로우에 필요합니다.
+표준 자동화에는 매월 5 크레딧이면 넉넉합니다. 대부분의 팀은 일반적인 워크플로우 사용으로 이 한도를 초과하지 않습니다. 추가 크레딧은 주로 고급 Code 작업 및 AI 기반 워크플로우에 필요합니다.
</Note>
## 크레딧 소비 방식 이해
diff --git a/packages/twenty-docs/l/ko/user-guide/workflows/capabilities/workflow-triggers.mdx b/packages/twenty-docs/l/ko/user-guide/workflows/capabilities/workflow-triggers.mdx
index 6f06050b644..ddbff424e08 100644
--- a/packages/twenty-docs/l/ko/user-guide/workflows/capabilities/workflow-triggers.mdx
+++ b/packages/twenty-docs/l/ko/user-guide/workflows/capabilities/workflow-triggers.mdx
@@ -10,14 +10,13 @@ description: 워크플로우를 시작하는 다양한 트리거에 대해 알
<img src="/images/user-guide/workflows/workflow_triggers.png" style={{width:'100%'}} />
<Tip>
- **고급 객체도 지원됩니다!** 표준 CRM 객체(사람, 회사, 영업 기회) 외에도 다음 대상으로 워크플로우를 트리거하고 작업을 수행할 수 있습니다:
+**고급 객체도 지원됩니다!** 표준 CRM 객체(사람, 회사, 영업 기회) 외에도 다음 대상으로 워크플로우를 트리거하고 작업을 수행할 수 있습니다:
+* 워크스페이스 구성원
+* 캘린더 이벤트
+* 메시지(이메일)
+* 작업, 노트 및 기타 많은 시스템 객체
- * 워크스페이스 구성원
- * 캘린더 이벤트
- * 메시지(이메일)
- * 작업, 노트 및 기타 많은 시스템 객체
-
- 이렇게 하면 캘린더 이벤트가 생성될 때 팀 구성원에게 알림을 보내거나, 수신 이메일을 자동으로 처리하는 등의 강력한 자동화를 구현할 수 있습니다.
+이렇게 하면 캘린더 이벤트가 생성될 때 팀 구성원에게 알림을 보내거나, 수신 이메일을 자동으로 처리하는 등의 강력한 자동화를 구현할 수 있습니다.
</Tip>
## 레코드 생성됨
@@ -27,9 +26,9 @@ description: 워크플로우를 시작하는 다양한 트리거에 대해 알
**구성**: 새 레코드를 모니터링할 객체 유형을 선택합니다.
<Note>
- * 이 트리거는 CSV, 메일박스 및 캘린더 동기화, API로 생성된 레코드에 적합합니다.
- * **수동으로 생성된 레코드에는 권장되지 않습니다**: 이 트리거를 사용하면 레코드가 생성되는 즉시 워크플로우가 시작됩니다. Twenty UI는 실시간 자동 저장을 제공하므로(레코드를 저장하기 위한 별도의 편집 모드와 검증 단계가 없습니다), 사용자가 모든 필드를 입력하기 전에 워크플로우가 트리거될 수 있습니다.
- 수동으로 생성된 레코드에서 이 워크플로우를 트리거하려면, 대신 트리거 `Record is created or updated`를 사용하는 것이 좋습니다.
+* 이 트리거는 CSV, 메일박스 및 캘린더 동기화, API로 생성된 레코드에 적합합니다.
+* **수동으로 생성된 레코드에는 권장되지 않습니다**: 이 트리거를 사용하면 레코드가 생성되는 즉시 워크플로우가 시작됩니다. Twenty UI는 실시간 자동 저장을 제공하므로(레코드를 저장하기 위한 별도의 편집 모드와 검증 단계가 없습니다), 사용자가 모든 필드를 입력하기 전에 워크플로우가 트리거될 수 있습니다.
+ 수동으로 생성된 레코드에서 이 워크플로우를 트리거하려면, 대신 트리거 `Record is created or updated`를 사용하는 것이 좋습니다.
</Note>
## 레코드 업데이트됨
@@ -82,7 +81,7 @@ description: 워크플로우를 시작하는 다양한 트리거에 대해 알
* **대량 처리**: 선택된 레코드가 워크플로우로 전달됩니다. 지정된 객체에 대해 구성되어 있습니다. 여러 개의 레코드를 선택한 후 워크플로우를 시작할 수 있습니다. 워크플로우는 전체 레코드 목록을 입력으로 하여 한 번 실행됩니다. 이는 워크플로우에 [이터레이터 작업](/l/ko/user-guide/workflows/capabilities/workflow-actions#iterator)이 포함되어야 함을 의미합니다.
<Note>
- 이 방식은 더 고급이며, 워크플로우 실행 횟수를 최적화하려는 사용자에게 가장 적합합니다.
+이 방식은 더 고급이며, 워크플로우 실행 횟수를 최적화하려는 사용자에게 가장 적합합니다.
</Note>
<img src="/images/user-guide/workflows/manual_trigger.png" style={{width:'100%'}} />
@@ -108,7 +107,7 @@ description: 워크플로우를 시작하는 다양한 트리거에 대해 알
* 값을 입력하거나 고급 스케줄링을 위한 사용자 정의 크론 표현식을 사용
<Note>
- **시간대**: 예약된 워크플로우는 **UTC**로 실행됩니다. 일일 일정의 시간을 설정할 때는 로컬 시간을 UTC로 변환하세요.
+**시간대**: 예약된 워크플로우는 **UTC**로 실행됩니다. 일일 일정의 시간을 설정할 때는 로컬 시간을 UTC로 변환하세요.
</Note>
## 외부 트리거: 웹훅
diff --git a/packages/twenty-docs/l/ko/user-guide/workflows/how-tos/advanced-configurations/handle-arrays-in-code-actions.mdx b/packages/twenty-docs/l/ko/user-guide/workflows/how-tos/advanced-configurations/handle-arrays-in-code-actions.mdx
index b5b0d5654e6..acac7272497 100644
--- a/packages/twenty-docs/l/ko/user-guide/workflows/how-tos/advanced-configurations/handle-arrays-in-code-actions.mdx
+++ b/packages/twenty-docs/l/ko/user-guide/workflows/how-tos/advanced-configurations/handle-arrays-in-code-actions.mdx
@@ -74,9 +74,9 @@ export const main = async (params: {
Code 노드는 배열 대신 구조화된 객체를 반환합니다. 이후 단계에서는 변수 선택기에서 `answer.firstname` 및 `answer.name`과 같은 개별 필드를 선택할 수 있습니다.
<Note>
- 향후 업데이트에서 배열 처리를 더 쉽게 만들기 위해 적극적으로 개선하고 있습니다.
+향후 업데이트에서 배열 처리를 더 쉽게 만들기 위해 적극적으로 개선하고 있습니다.
</Note>
<Tip>
- 코드 편집기 오른쪽 상단의 사각형 아이콘을 클릭하여 전체 화면으로 표시하세요 — 기본 편집기 너비가 제한되어 있어 유용합니다.
+코드 편집기 오른쪽 상단의 사각형 아이콘을 클릭하여 전체 화면으로 표시하세요 — 기본 편집기 너비가 제한되어 있어 유용합니다.
</Tip>
diff --git a/packages/twenty-docs/l/ko/user-guide/workflows/how-tos/connect-to-other-tools/bring-product-data-in-twenty.mdx b/packages/twenty-docs/l/ko/user-guide/workflows/how-tos/connect-to-other-tools/bring-product-data-in-twenty.mdx
index ec2e5a5c623..8ded6937134 100644
--- a/packages/twenty-docs/l/ko/user-guide/workflows/how-tos/connect-to-other-tools/bring-product-data-in-twenty.mdx
+++ b/packages/twenty-docs/l/ko/user-guide/workflows/how-tos/connect-to-other-tools/bring-product-data-in-twenty.mdx
@@ -54,7 +54,7 @@ export const main = async () => {
```
<Tip>
- `updated_at >= last X minutes`로 필터링하여 최근에 변경된 레코드만 가져옵니다. 동기화를 효율적으로 유지할 수 있습니다.
+`updated_at >= last X minutes`로 필터링하여 최근에 변경된 레코드만 가져옵니다. 동기화를 효율적으로 유지할 수 있습니다.
</Tip>
## 단계 3: 데이터 형식 지정(선택)
@@ -163,7 +163,7 @@ export const main = async (params: { deals: any }) => {
| **Price** | `{{iterator.item.price}}` |
<Tip>
- 생성과 업데이트를 위한 분기 흐름을 따로 만들기보다 **Upsert**(업데이트 또는 생성)를 사용하세요. 구현이 더 빠르고 디버깅이 더 쉽습니다.
+생성과 업데이트를 위한 분기 흐름을 따로 만들기보다 **Upsert**(업데이트 또는 생성)를 사용하세요. 구현이 더 빠르고 디버깅이 더 쉽습니다.
</Tip>
## 사용 예시
diff --git a/packages/twenty-docs/l/ko/user-guide/workflows/how-tos/connect-to-other-tools/bring-typeform-submissions-in-twenty.mdx b/packages/twenty-docs/l/ko/user-guide/workflows/how-tos/connect-to-other-tools/bring-typeform-submissions-in-twenty.mdx
index 92f31375564..a315932cea9 100644
--- a/packages/twenty-docs/l/ko/user-guide/workflows/how-tos/connect-to-other-tools/bring-typeform-submissions-in-twenty.mdx
+++ b/packages/twenty-docs/l/ko/user-guide/workflows/how-tos/connect-to-other-tools/bring-typeform-submissions-in-twenty.mdx
@@ -103,7 +103,7 @@ export const main = async (params: {
이후 단계에서는 변수 선택기에서 `contact.firstName` 및 `contact.email`과 같은 개별 필드를 선택할 수 있습니다.
<Tip>
- 배열 처리에 대한 자세한 내용은 [Code 액션에서 배열 처리하기](/l/ko/user-guide/workflows/how-tos/advanced-configurations/handle-arrays-in-code-actions)를 참조하세요.
+배열 처리에 대한 자세한 내용은 [Code 액션에서 배열 처리하기](/l/ko/user-guide/workflows/how-tos/advanced-configurations/handle-arrays-in-code-actions)를 참조하세요.
</Tip>
### 5단계: 레코드 생성
diff --git a/packages/twenty-docs/l/ko/user-guide/workflows/how-tos/connect-to-other-tools/generate-pdf-from-twenty.mdx b/packages/twenty-docs/l/ko/user-guide/workflows/how-tos/connect-to-other-tools/generate-pdf-from-twenty.mdx
index 669c3dfa7e4..1efb81d2314 100644
--- a/packages/twenty-docs/l/ko/user-guide/workflows/how-tos/connect-to-other-tools/generate-pdf-from-twenty.mdx
+++ b/packages/twenty-docs/l/ko/user-guide/workflows/how-tos/connect-to-other-tools/generate-pdf-from-twenty.mdx
@@ -29,7 +29,7 @@ Twenty에서 PDF를 자동으로 생성하거나 가져와 레코드에 첨부
3. PDF를 첨부할 객체를 선택하세요(예: **Company** 또는 **Opportunity**).
<Tip>
- 수동 트리거를 사용하면 사용자가 레코드를 선택한 후 우측 상단에 표시되는 버튼으로 이 워크플로우를 실행해 PDF를 생성하고 첨부할 수 있습니다.
+수동 트리거를 사용하면 사용자가 레코드를 선택한 후 우측 상단에 표시되는 버튼으로 이 워크플로우를 실행해 PDF를 생성하고 첨부할 수 있습니다.
</Tip>
### 2단계: 로직 함수 추가
@@ -45,7 +45,7 @@ Twenty에서 PDF를 자동으로 생성하거나 가져와 레코드에 첨부
| `companyId` | `{{trigger.object.id}}` |
<Note>
- 다른 객체(Person, Opportunity 등)에 첨부하는 경우 해당 매개변수 이름을 바꾸고(예: `personId`, `opportunityId`) 로직 함수를 업데이트하세요.
+다른 객체(Person, Opportunity 등)에 첨부하는 경우 해당 매개변수 이름을 바꾸고(예: `personId`, `opportunityId`) 로직 함수를 업데이트하세요.
</Note>
#### 로직 함수 코드
@@ -55,11 +55,12 @@ export const main = async (
params: { companyId: string },
) => {
const { companyId } = params;
-
- // Replace with your Twenty GraphQL endpoint
+ // Replace with your Twenty GraphQL endpoints (/metadata for metadata and files or /graphql for your records)
// Cloud: https://api.twenty.com/graphql
// Self-hosted: https://your-domain.com/graphql
- const graphqlEndpoint = 'https://api.twenty.com/graphql';
+
+ const metadataGraphqlEndpoint = 'https://api.twenty.com/metadata';
+ const dataGraphqlEndpoint = 'https://api.twenty.com/graphql';
// Replace with your API key from Settings → APIs
const authToken = 'YOUR_API_KEY';
@@ -79,11 +80,40 @@ export const main = async (
const pdfBlob = await pdfResponse.blob();
const pdfFile = new File([pdfBlob], filename, { type: 'application/pdf' });
- // Step 2: Upload the file via GraphQL multipart upload
+ const fieldMetadataIdQuery = `
+ query FindUploadFileFieldMetadataId {
+ objects {
+ edges {
+ node {
+ nameSingular
+ fieldsList {
+ id
+ name
+ }
+ }
+ }
+ }
+ }
+ `;
+
+ // Step 2: Find a fieldMetadataId of "Attachment file" field in Attachments object with GraphQL API
+ const response = await fetch(metadataGraphqlEndpoint, {
+ method: 'POST',
+ headers: {
+ Authorization: `Bearer ${authToken}`
+ },
+ body: {
+ query: fieldMetadataIdQuery,
+ }
+ });
+ const result = await response.json();
+ const uploadFileFieldMetadataId = result.data.objects.edges.find(object => object.node.nameSingular === 'attachment').node.fieldsList.find(field => field.name === 'file').id;
+
+ // Step 3: Upload the file via GraphQL multipart upload
const uploadMutation = `
- mutation UploadFile($file: Upload!, $fileFolder: FileFolder) {
- uploadFile(file: $file, fileFolder: $fileFolder) {
- path
+ mutation UploadFilesFieldFile($file: Upload!, $fieldMetadataId: String!) {
+ uploadFilesFieldFile(file: $file, fieldMetadataId: $fieldMetadataId) {
+ id
}
}
`;
@@ -91,12 +121,12 @@ export const main = async (
const uploadForm = new FormData();
uploadForm.append('operations', JSON.stringify({
query: uploadMutation,
- variables: { file: null, fileFolder: 'Attachment' },
+ variables: { file: null, fieldMetadataId: uploadFileFieldMetadataId },
}));
uploadForm.append('map', JSON.stringify({ '0': ['variables.file'] }));
uploadForm.append('0', pdfFile);
- const uploadResponse = await fetch(graphqlEndpoint, {
+ const uploadResponse = await fetch(metadataGraphqlEndpoint, {
method: 'POST',
headers: { Authorization: `Bearer ${authToken}` },
body: uploadForm,
@@ -108,15 +138,15 @@ export const main = async (
throw new Error(`Upload failed: ${uploadResult.errors[0].message}`);
}
- const filePath = uploadResult.data?.uploadFile?.path;
+ const fileId = uploadResult.data?.uploadFilesFieldFile?.id;
- if (!filePath) {
- throw new Error('No file path returned from upload');
+ if (!fileId) {
+ throw new Error('No file id returned from upload');
}
- // Step 3: Create the attachment linked to the company
+ // Step 4: Create the attachment linked to the company
const attachmentMutation = `
- mutation CreateAttachment($data: AttachmentCreateInput!) {
+ mutation CreateOneAttachment($data: AttachmentCreateInput!) {
createAttachment(data: $data) {
id
name
@@ -124,7 +154,7 @@ export const main = async (
}
`;
- const attachmentResponse = await fetch(graphqlEndpoint, {
+ const attachmentResponse = await fetch(dataGraphqlEndpoint, {
method: 'POST',
headers: {
Authorization: `Bearer ${authToken}`,
@@ -135,8 +165,13 @@ export const main = async (
variables: {
data: {
name: filename,
- fullPath: filePath,
- companyId,
+ targetCompanyId: companyId,
+ file: [
+ {
+ fileId: fileId,
+ label: filename
+ }
+ ]
},
},
}),
@@ -156,14 +191,14 @@ export const main = async (
#### 다른 객체에 첨부하려면
-`companyId`를 해당 필드로 바꾸세요:
+`targetCompanyId`를 해당 필드로 바꾸세요:
-| 개체 | 필드 이름 |
-| --------- | -------------------- |
-| 회사 | `companyId` |
-| 사람 | `personId` |
-| 기회 | `opportunityId` |
-| 사용자 지정 개체 | `yourCustomObjectId` |
+| 개체 | 필드 이름 |
+| --------- | -------------------------- |
+| 회사 | `targetCompanyId` |
+| 사람 | `targetPersonId` |
+| 기회 | `targetOpportunityId` |
+| 사용자 지정 개체 | `targetYourCustomObjectId` |
함수 매개변수와 첨부 생성 mutation의 `variables.data` 객체를 모두 업데이트하세요.
diff --git a/packages/twenty-docs/l/ko/user-guide/workflows/how-tos/connect-to-other-tools/generate-quote-or-invoice-from-twenty.mdx b/packages/twenty-docs/l/ko/user-guide/workflows/how-tos/connect-to-other-tools/generate-quote-or-invoice-from-twenty.mdx
index 8b9c676e5c6..463d0537f19 100644
--- a/packages/twenty-docs/l/ko/user-guide/workflows/how-tos/connect-to-other-tools/generate-quote-or-invoice-from-twenty.mdx
+++ b/packages/twenty-docs/l/ko/user-guide/workflows/how-tos/connect-to-other-tools/generate-quote-or-invoice-from-twenty.mdx
@@ -30,7 +30,7 @@ description: 거래가 성사되면 외부 도구에서 인보이스를 자동
| **값** | `CLOSED_WON` (또는 사용 중인 스테이지 이름) |
<Tip>
- 트리거는 모든 기회 업데이트에서 실행됩니다. 필터는 스테이지가 Closed Won으로 변경될 때만 워크플로우가 계속 진행되도록 보장합니다.
+트리거는 모든 기회 업데이트에서 실행됩니다. 필터는 스테이지가 Closed Won으로 변경될 때만 워크플로우가 계속 진행되도록 보장합니다.
</Tip>
## 단계 3: 회사 세부정보 가져오기
diff --git a/packages/twenty-docs/l/ko/user-guide/workflows/how-tos/connect-to-other-tools/set-up-a-webhook-trigger.mdx b/packages/twenty-docs/l/ko/user-guide/workflows/how-tos/connect-to-other-tools/set-up-a-webhook-trigger.mdx
index a79d4a174b1..869d79e4c17 100644
--- a/packages/twenty-docs/l/ko/user-guide/workflows/how-tos/connect-to-other-tools/set-up-a-webhook-trigger.mdx
+++ b/packages/twenty-docs/l/ko/user-guide/workflows/how-tos/connect-to-other-tools/set-up-a-webhook-trigger.mdx
@@ -161,7 +161,7 @@ export const main = async (params: { items: any }) => {
이제 이후 단계에서 `product.name` 및 `product.qty`를 개별적으로 선택할 수 있습니다.
<Tip>
- 배열 처리에 대한 자세한 내용은 [Code 액션에서 배열 처리하기](/l/ko/user-guide/workflows/how-tos/advanced-configurations/handle-arrays-in-code-actions)를 참조하세요.
+배열 처리에 대한 자세한 내용은 [Code 액션에서 배열 처리하기](/l/ko/user-guide/workflows/how-tos/advanced-configurations/handle-arrays-in-code-actions)를 참조하세요.
</Tip>
## 관련 항목
diff --git a/packages/twenty-docs/l/ko/user-guide/workflows/how-tos/crm-automations/auto-reply-to-inbound-emails.mdx b/packages/twenty-docs/l/ko/user-guide/workflows/how-tos/crm-automations/auto-reply-to-inbound-emails.mdx
new file mode 100644
index 00000000000..ee6dae3cd9f
--- /dev/null
+++ b/packages/twenty-docs/l/ko/user-guide/workflows/how-tos/crm-automations/auto-reply-to-inbound-emails.mdx
@@ -0,0 +1,121 @@
+---
+title: 수신 이메일 자동 회신
+description: AI를 사용해 수신 이메일을 분류하고 스레드형 답장을 자동으로 보내는 워크플로를 구축하세요.
+---
+
+수신 이메일에 몇 시간이 아니라 몇 초 만에 응답하세요. 이 워크플로는 AI 에이전트를 사용해 잡음(뉴스레터, 스팸, 자동 회신)을 거르고 실제 메시지에는 개인화된 응답 초안을 작성한 다음, 원본 대화 내에서 스레드형 답장으로 전송합니다.
+
+## 이메일 스레드 작동 방식
+
+모든 이메일에는 숨겨진 `Message-ID` 헤더가 있으며, 이는 발신자의 메일 서버가 부여하는 고유한 식별자입니다. 이메일에 회신할 때, 메일 클라이언트는 해당 지문을 참조하는 `In-Reply-To` 헤더를 설정합니다. Gmail, Outlook 및 기타 모든 클라이언트가 메시지를 스레드로 묶는 방식입니다.
+
+Twenty에서는 그 지문이 Message 객체의 `headerMessageId`로 저장됩니다. 워크플로우가 이를 가져와 Send Email 작업의 In-Reply-To 필드에 전달합니다.
+
+## 워크플로우 구성
+
+### 1단계: 새 워크플로우 생성
+
+**설정 -> 워크플로우**로 이동한 다음 **+ 새 워크플로우**를 클릭하세요.
+
+### 2단계: 수신 메시지에 트리거 설정
+
+**When a Record is Created**를 선택하고 **Messages**를 선택하세요.
+
+이메일이 Twenty에 도착할 때마다 이 트리거가 실행됩니다.
+
+<img src="/images/user-guide/workflows/auto-reply/workflow-overview.png" style={{width:'100%'}} />
+
+### 3단계: 발신자 찾기
+
+**Search Records** 작업을 추가합니다.
+
+발신자 주소는 메시지 자체에 있지 않고 — 연결된 Message Participant 레코드에 있습니다.
+
+| 필드 | 값 |
+| ------ | ------------------------------- |
+| **객체** | 메시지 참가자 |
+| **필터** | Message **값이** `{{trigger.id}}` |
+| **필터** | Role **값이** From |
+| **제한** | 1 |
+
+이렇게 하면 발신자의 이메일은 `handle`에, 이름은 `displayName`에 담깁니다.
+
+<img src="/images/user-guide/workflows/auto-reply/find-sender.png" style={{width:'100%'}} />
+
+### 4단계: AI 분류 및 회신 초안 작성
+
+**AI Agent** 작업을 추가합니다. 이 단일 단계는 두 가지를 수행합니다: 이메일에 회신할지 여부를 결정하고, 필요하다면 회신 내용을 작성합니다.
+
+다음과 같은 프롬프트를 사용하세요:
+
+```
+You are an email triage assistant for a sales team. Read the following
+inbound email and decide if it deserves a reply.
+
+Subject: {{trigger.subject}}
+Body: {{trigger.text}}
+From: {{Find Sender.first.displayName}} ({{Find Sender.first.handle}})
+
+If this email is spam, a newsletter, an automated notification, or
+otherwise does not need a human reply, respond with exactly: SKIP
+
+Otherwise, write a short, professional reply (3-4 sentences max) that:
+- Acknowledges their specific message
+- Lets them know someone from the team will follow up shortly
+- Is warm but not overly casual
+
+Respond with only the reply text, no subject line or greeting prefix.
+```
+
+AI Agent는 다음 단계에서 참조할 수 있도록 `response` 필드에 응답을 출력합니다.
+
+<img src="/images/user-guide/workflows/auto-reply/ai-triage.png" style={{width:'100%'}} />
+
+### 5단계: AI 결정에 따라 분기
+
+**If/Else** 작업을 추가하여 AI가 회신할지 건너뛸지를 확인합니다.
+
+| 필드 | 값 |
+| ----------- | ---------------------------------------- |
+| **조건** | AI Agent `response`에 `SKIP`이 **포함되지 않음** |
+| **참인 경우** | Send Email로 계속 |
+| **그렇지 않으면** | 아무것도 하지 않음(워크플로우 종료) |
+
+스팸, 뉴스레터, 자동 생성된 메시지는 제외됩니다. 그 외 모든 항목은 다음 단계로 이동합니다.
+
+<img src="/images/user-guide/workflows/auto-reply/should-reply.png" style={{width:'100%'}} />
+
+### 6단계: 스레드형 회신 보내기
+
+"if true" 분기에서 **Send Email** 작업을 추가합니다. **Advanced options**를 클릭한 다음 **Add In-Reply-To**를 클릭합니다.
+
+| 필드 | 값 |
+| --------------- | -------------------------------------- |
+| **받는 사람** | `{{Find Sender.first.handle}}` |
+| **제목** | `Re: {{trigger.subject}}` |
+| **Body** | `{{AI Triage & Draft Reply.response}}` |
+| **In-Reply-To** | `{{trigger.headerMessageId}}` |
+
+In-Reply-To 필드는 이 메시지를 새 대화가 아닌 회신으로 인식하게 합니다. 수신자는 Gmail, Outlook 등 모든 클라이언트에서 원본 이메일 아래에 스레드로 묶인 상태로 보게 됩니다.
+
+<img src="/images/user-guide/workflows/auto-reply/send-email.png" style={{width:'100%'}} />
+
+<Tip>
+**In-Reply-To**에는 트리거에서 전달된 `message.headerMessageId`가 필요합니다 — 이는 수신자 주소가 아니라 이메일의 고유한 지문입니다. 비워 두면 이메일은 여전히 전송되지만 독립된 메시지로 보내집니다.
+</Tip>
+
+<Warning>
+Gmail은 제목 줄을 사용하여 메시지를 스레드로 그룹화합니다. Gmail이 원래 스레드 내에 회신을 표시하려면 제목이 `Re:`(콜론과 공백 포함)로 시작해야 합니다. 이 표시가 없으면, In-Reply-To 헤더가 올바르게 설정되어 있어도 회신은 별도의 대화로 표시됩니다.
+</Warning>
+
+### 7단계: 테스트 및 활성화
+
+**Test**를 클릭한 다음 메일 클라이언트를 확인하세요. 회신은 원본 메시지 아래에 스레드로 표시되어야 합니다.
+
+만족스러우면 활성화하세요.
+
+## 확장 아이디어
+
+* **VIP에게만 회신** — 발신자의 도메인을 확인하거나 Twenty의 연락처로 존재하는지 확인하는 분기를 추가하세요
+* **의도별 라우팅** — 영업 문의와 지원 요청을 다르게 처리하도록 별도의 AI Agent 프롬프트를 사용하세요
+* **회신 전 정보 보강** — 보다 개인화된 회신을 위해 발신자의 회사나 거래 이력을 AI 프롬프트에 포함하도록 Search Records 단계를 추가하세요
diff --git a/packages/twenty-docs/l/ko/user-guide/workflows/how-tos/crm-automations/display-number-of-emails-received.mdx b/packages/twenty-docs/l/ko/user-guide/workflows/how-tos/crm-automations/display-number-of-emails-received.mdx
index 9ba807f1c7a..3c7380183da 100644
--- a/packages/twenty-docs/l/ko/user-guide/workflows/how-tos/crm-automations/display-number-of-emails-received.mdx
+++ b/packages/twenty-docs/l/ko/user-guide/workflows/how-tos/crm-automations/display-number-of-emails-received.mdx
@@ -30,7 +30,7 @@ import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
3. **Message Participants**를 선택합니다(고급 객체에 있음)
<Note>
- Message Participant는 메시지 ID와 사람 ID의 조합으로, 메시지마다 하나의 고유 레코드를 생성합니다. 이는 발신자(또는 수신자)의 이메일 주소가 들어 있는 `handle` 필드에 접근할 수 있으므로 메시지를 직접 추적하는 것보다 더 쉽습니다.
+Message Participant는 메시지 ID와 사람 ID의 조합으로, 메시지마다 하나의 고유 레코드를 생성합니다. 이는 발신자(또는 수신자)의 이메일 주소가 들어 있는 `handle` 필드에 접근할 수 있으므로 메시지를 직접 추적하는 것보다 더 쉽습니다.
</Note>
### 2단계: Role 기준으로 필터링
@@ -50,7 +50,7 @@ import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
해당 이메일 주소에서 보낸 모든 메시지를 찾아 총 개수를 구합니다.
<Note>
- Search Records 액션은 최대 200개의 레코드만 반환합니다. 그러나 개별 레코드가 아니라 `totalCount` 값만 사용하므로, 이 단계는 해당 사람이 보낸 이메일의 총 개수를 반환합니다.
+Search Records 액션은 최대 200개의 레코드만 반환합니다. 그러나 개별 레코드가 아니라 `totalCount` 값만 사용하므로, 이 단계는 해당 사람이 보낸 이메일의 총 개수를 반환합니다.
</Note>
### 4단계: Create or Update Record 액션으로 사람 레코드를 업데이트합니다
@@ -58,7 +58,7 @@ import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
1. **레코드 생성 또는 업데이트** 액션을 추가합니다
<Warning>
- 여기서는 **Update Record** 대신 **Upsert Record**를 사용하세요. 이렇게 하면 이전 단계의 레코드 ID가 없어도 `handle` 필드(이메일 주소)로 사람을 식별할 수 있습니다.
+여기서는 **Update Record** 대신 **Upsert Record**를 사용하세요. 이렇게 하면 이전 단계의 레코드 ID가 없어도 `handle` 필드(이메일 주소)로 사람을 식별할 수 있습니다.
</Warning>
2. 객체로 **People**를 선택합니다
diff --git a/packages/twenty-docs/l/ko/user-guide/workflows/how-tos/crm-automations/display-related-record-data.mdx b/packages/twenty-docs/l/ko/user-guide/workflows/how-tos/crm-automations/display-related-record-data.mdx
index 0fafba7b32c..e48a22c6eb0 100644
--- a/packages/twenty-docs/l/ko/user-guide/workflows/how-tos/crm-automations/display-related-record-data.mdx
+++ b/packages/twenty-docs/l/ko/user-guide/workflows/how-tos/crm-automations/display-related-record-data.mdx
@@ -95,7 +95,7 @@ description: "워크플로우를 사용해 관련 레코드의 데이터를 표
* 회사 규모: `{{searchRecords[0].employees}}`
<Note>
- **작업 및 노트 제한 사항**: 작업과 노트의 관계는 다대다로 하드코딩되어 있으며, 워크플로우 트리거 또는 액션에서 아직 사용할 수 없습니다. 이러한 관계에 액세스하려면 대신 [API](/l/ko/developers/api)를 사용하세요.
+**작업 및 노트 제한 사항**: 작업과 노트의 관계는 다대다로 하드코딩되어 있으며, 워크플로우 트리거 또는 액션에서 아직 사용할 수 없습니다. 이러한 관계에 액세스하려면 대신 [API](/l/ko/developers/extend/api)를 사용하세요.
</Note>
## 양방향 동기화
@@ -117,7 +117,7 @@ description: "워크플로우를 사용해 관련 레코드의 데이터를 표
2. **레코드 업데이트**: 회사의 기본 담당자를 이 사람으로 설정
<Note>
- 무한 루프를 피하기 위해 양방향 동기화에 주의하세요. 업데이트하기 전에 값이 실제로 변경되었는지 필터로 확인하세요.
+무한 루프를 피하기 위해 양방향 동기화에 주의하세요. 업데이트하기 전에 값이 실제로 변경되었는지 필터로 확인하세요.
</Note>
## 복잡한 매핑에 코드 사용
diff --git a/packages/twenty-docs/l/ko/user-guide/workflows/how-tos/crm-automations/formula-fields.mdx b/packages/twenty-docs/l/ko/user-guide/workflows/how-tos/crm-automations/formula-fields.mdx
index e36d0ca1274..24bc8e52aca 100644
--- a/packages/twenty-docs/l/ko/user-guide/workflows/how-tos/crm-automations/formula-fields.mdx
+++ b/packages/twenty-docs/l/ko/user-guide/workflows/how-tos/crm-automations/formula-fields.mdx
@@ -16,7 +16,7 @@ Twenty는 아직 네이티브 수식 필드를 지원하지 않습니다(2026년
| **리드 점수** | 여러 기준을 기반으로 한 점수 |
<Tip>
- 파이프라인 단계에서 시간을 추적하는 전체 예시는 [각 단계에서 기회가 머무는 기간 추적하기](/l/ko/user-guide/views-pipelines/how-tos/track-time-in-stage)를 참조하세요.
+파이프라인 단계에서 시간을 추적하는 전체 예시는 [각 단계에서 기회가 머무는 기간 추적하기](/l/ko/user-guide/views-pipelines/how-tos/track-time-in-stage)를 참조하세요.
</Tip>
## 기본 수식: 연결
@@ -105,7 +105,7 @@ export const main = async (params) => {
3. **레코드 업데이트**: Days Until Due를 `{{code.daysUntilDue}}`(으)로 설정
<Note>
- 음수 값은 기한이 지난 작업을 의미합니다. 이 필드를 사용하여 긴급도에 따라 작업을 필터링하거나 정렬할 수 있습니다.
+음수 값은 기한이 지난 작업을 의미합니다. 이 필드를 사용하여 긴급도에 따라 작업을 필터링하거나 정렬할 수 있습니다.
</Note>
## 조건 수식: 리드 점수
diff --git a/packages/twenty-docs/l/ko/user-guide/workflows/how-tos/crm-automations/notify-teammates-of-note-to-review.mdx b/packages/twenty-docs/l/ko/user-guide/workflows/how-tos/crm-automations/notify-teammates-of-note-to-review.mdx
index 6b5ff522940..fad18f9a707 100644
--- a/packages/twenty-docs/l/ko/user-guide/workflows/how-tos/crm-automations/notify-teammates-of-note-to-review.mdx
+++ b/packages/twenty-docs/l/ko/user-guide/workflows/how-tos/crm-automations/notify-teammates-of-note-to-review.mdx
@@ -6,7 +6,7 @@ description: 노트 검토를 위해 동료를 지정할 때 자동 이메일
import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
<Note>
- **노트에서 팀원을 직접 태그하는 기능은 아직 지원되지 않습니다.** 이 기능은 2026년 하반기에 제공될 예정입니다. 그동안 이 워크플로우가 실질적인 대안을 제공합니다.
+**노트에서 팀원을 직접 태그하는 기능은 아직 지원되지 않습니다.** 이 기능은 2026년 하반기에 제공될 예정입니다. 그동안 이 워크플로우가 실질적인 대안을 제공합니다.
</Note>
## 과제
@@ -22,7 +22,7 @@ import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
3. 워크플로우가 검토자에게 노트 링크가 포함된 이메일을 자동으로 보냅니다
<Warning>
- **제한 사항**: 이 방법은 필드당 한 명의 검토자만 지정할 수 있습니다. 여러 사람에게 알림이 필요하다면 추가 관계 필드를 생성하세요(예: 검토자 1, 검토자 2). 한 번에 많은 공동 작업자를 태그해야 하는 경우 확장성이 떨어집니다.
+**제한 사항**: 이 방법은 필드당 한 명의 검토자만 지정할 수 있습니다. 여러 사람에게 알림이 필요하다면 추가 관계 필드를 생성하세요(예: 검토자 1, 검토자 2). 한 번에 많은 공동 작업자를 태그해야 하는 경우 확장성이 떨어집니다.
</Warning>
## 단계별 설정
@@ -101,7 +101,7 @@ Twenty
```
<Note>
- `yourSubDomain`을 실제 Twenty 워크스페이스 서브도메인으로 바꾸세요.
+`yourSubDomain`을 실제 Twenty 워크스페이스 서브도메인으로 바꾸세요.
</Note>
#### 테스트 및 활성화
diff --git a/packages/twenty-docs/l/ko/user-guide/workflows/how-tos/crm-automations/send-email-alerts-with-tasks-due.mdx b/packages/twenty-docs/l/ko/user-guide/workflows/how-tos/crm-automations/send-email-alerts-with-tasks-due.mdx
index a8d2bd0aa7e..ea8bcd0a04a 100644
--- a/packages/twenty-docs/l/ko/user-guide/workflows/how-tos/crm-automations/send-email-alerts-with-tasks-due.mdx
+++ b/packages/twenty-docs/l/ko/user-guide/workflows/how-tos/crm-automations/send-email-alerts-with-tasks-due.mdx
@@ -79,7 +79,7 @@ export const main = async (params: {
```
<Note>
- `yourSubDomain`을 실제 Twenty 워크스페이스 서브도메인으로 바꾸세요.
+`yourSubDomain`을 실제 Twenty 워크스페이스 서브도메인으로 바꾸세요.
</Note>
### 6단계: 이메일 보내기(이터레이터 내부)
diff --git a/packages/twenty-docs/l/ko/user-guide/workflows/how-tos/need-more-help/workflow-troubleshooting.mdx b/packages/twenty-docs/l/ko/user-guide/workflows/how-tos/need-more-help/workflow-troubleshooting.mdx
index 8bb8151ff64..8f369d57152 100644
--- a/packages/twenty-docs/l/ko/user-guide/workflows/how-tos/need-more-help/workflow-troubleshooting.mdx
+++ b/packages/twenty-docs/l/ko/user-guide/workflows/how-tos/need-more-help/workflow-troubleshooting.mdx
@@ -41,7 +41,7 @@ description: 일반적인 워크플로우 문제와 해결 방법.
* 빈 값이 아닌 완전한 데이터를 얻을 수 있습니다
<Tip>
- 레코드당 한 번만 워크플로우를 실행하려면, `createdAt equals updatedAt`(첫 저장)과 같은 필드를 확인하는 필터 액션을 추가하거나, 워크플로우가 이미 실행되었는지 추적하기 위해 사용자 지정 체크박스 필드를 사용하세요.
+레코드당 한 번만 워크플로우를 실행하려면, `createdAt equals updatedAt`(첫 저장)과 같은 필드를 확인하는 필터 액션을 추가하거나, 워크플로우가 이미 실행되었는지 추적하기 위해 사용자 지정 체크박스 필드를 사용하세요.
</Tip>
### 액션 실패
diff --git a/packages/twenty-docs/l/ko/user-guide/workflows/how-tos/need-more-help/workflows-faq.mdx b/packages/twenty-docs/l/ko/user-guide/workflows/how-tos/need-more-help/workflows-faq.mdx
index 04fe83c770d..a17015b9b25 100644
--- a/packages/twenty-docs/l/ko/user-guide/workflows/how-tos/need-more-help/workflows-faq.mdx
+++ b/packages/twenty-docs/l/ko/user-guide/workflows/how-tos/need-more-help/workflows-faq.mdx
@@ -4,10 +4,11 @@ description: Frequently asked questions about workflows in Twenty.
---
<AccordionGroup>
+
<Accordion title="Why can't I activate a workflow?">
This is likely a permissions issue. You need access to workflows to create and activate them.
- **Solution**: Contact your workspace administrator to grant you workflow access under **Settings → Roles**.
+ **해결 방법**: 워크스페이스 관리자에게 문의하여 **Settings → Members → Roles**에서 워크플로 액세스 권한을 부여받으세요.
If you don't see the Workflows section at all in your sidebar, this confirms it's a permissions issue.
</Accordion>
@@ -27,7 +28,6 @@ description: Frequently asked questions about workflows in Twenty.
<Accordion title="What's the difference between Single, Global, and Bulk manual triggers?">
| 유형 | Records Required | Workflow 실행들 |
| -- | ---------------- | ------------ |
-
\| **Global** | None | Once, no record input |
\| **Single** | One or more selected | Once per selected record |
\| **Bulk** | One or more selected | Once, with all records as array |
@@ -61,7 +61,6 @@ description: Frequently asked questions about workflows in Twenty.
**Yes**, branches run in parallel by default.
If you want only one branch to execute:
-
* Add a **Filter** action at the start of each branch
* Set opposite conditions (e.g., Branch A: status = "Open", Branch B: status ≠ "Open")
@@ -72,7 +71,6 @@ description: Frequently asked questions about workflows in Twenty.
**Yes**. After your parallel branches complete, you can add a step that both branches connect to.
In the workflow editor:
-
1. Complete your branched actions
2. Add a new step after the branches
3. Drag connections from the end of each branch to this new step
@@ -84,7 +82,6 @@ description: Frequently asked questions about workflows in Twenty.
**Search Records returns a maximum of 200 records.**
If you need to process more:
-
* Add more specific filters to reduce results
* Use scheduled workflows to process in batches
* Consider using the API for bulk operations
@@ -102,12 +99,10 @@ description: Frequently asked questions about workflows in Twenty.
Every action produces output data that can be used in subsequent steps.
**To reference previous step data**:
-
* Use the variable picker when configuring a field
* Or type `{{stepName.fieldName}}` directly
**예시**:
-
* Trigger data: `{{trigger.object.email}}`
* Search results: `{{searchRecords[0].name}}`
* Code output: `{{code.calculatedValue}}`
@@ -123,7 +118,6 @@ description: Frequently asked questions about workflows in Twenty.
3. **Wrong variable selected**: Make sure you select the array itself, not a single record
**Correct setup**:
-
1. Search Records (returns array)
2. Filter: length > 0
3. Iterator: select `{{searchRecords}}`
@@ -138,7 +132,6 @@ description: Frequently asked questions about workflows in Twenty.
If your code exceeds this limit, the action will fail with a timeout error.
**Tips to avoid timeouts**:
-
* Break large operations into smaller chunks using Iterator
* Avoid heavy computations; use external services via HTTP Request for intensive processing
* Optimize your code to reduce execution time
@@ -149,12 +142,10 @@ description: Frequently asked questions about workflows in Twenty.
Workflow runs show the execution history and help you debug issues.
**Access runs**:
-
* In workflow editor → **Runs** panel on the right
* Or go to **Workflow Runs** in the sidebar
**Understanding a run**:
-
* **Status**: Running, Completed, Failed, Waiting
* **Steps**: See which steps executed and their output
* **Errors**: Click failed steps to see error messages
@@ -171,13 +162,11 @@ description: Frequently asked questions about workflows in Twenty.
If you exceed this limit, workflows are immediately marked as failed and won't appear in your runs list as expected.
**Common scenarios that hit this limit**:
-
* Selecting more than 5,000 records with a Single manual trigger
* Multiple workflows running simultaneously across your workspace
* High-frequency automated triggers (e.g., Record Updated on a busy object)
**해결책**:
-
* Use **Bulk** triggers instead of Single to process many records in one run
* Space out large batch operations
* Use filters to reduce trigger frequency
@@ -189,7 +178,6 @@ description: Frequently asked questions about workflows in Twenty.
| Limit | 값 | Behavior |
| ----- | - | -------- |
-
\| **Soft limit** | 100 runs/minute | Runs queue in "Not Started" status, processed gradually |
\| **Hard limit** | 5,000 runs/hour | Runs immediately fail |
@@ -198,7 +186,6 @@ description: Frequently asked questions about workflows in Twenty.
**Hard limit (5,000/hr)**: This applies to your entire workspace. If all your workflows combined exceed 5,000 runs in an hour, additional runs will fail immediately.
**Tips to stay within limits**:
-
* Use Bulk triggers with Iterator instead of Single triggers for large batches
* Combine related automations into fewer workflows
* Use scheduled workflows to spread load over time
@@ -208,13 +195,11 @@ description: Frequently asked questions about workflows in Twenty.
**No, there is no automatic retry functionality at the moment.**
If a workflow run fails, you'll need to:
-
1. Review the error in **Settings → Workflows → [Your Workflow] → Runs**
2. Fix the issue (data, configuration, or external service)
3. Manually trigger the workflow again on the affected record(s)
**Tips to reduce failures**:
-
* Add **Filter** nodes to validate data before actions
* Use **Search Records** to check if related records exist
* Test thoroughly with a few records before bulk operations
@@ -226,14 +211,12 @@ description: Frequently asked questions about workflows in Twenty.
**Yes, if your workflows are triggered by record creation or updates.**
When you import data via CSV, each record created or updated can trigger workflows. A large import (thousands of records) could:
-
* Hit the 5,000 runs/hour limit
* Consume significant workflow credits
* Send unexpected emails or notifications
* Create duplicate tasks or records
**Before a mass import**:
-
1. Go to **Settings → Workflows**
2. Identify workflows triggered by the object you're importing
3. **Deactivate** them temporarily
@@ -251,4 +234,5 @@ description: Frequently asked questions about workflows in Twenty.
This will automatically rearrange all nodes into a clean, organized layout.
</Accordion>
+
</AccordionGroup>
diff --git a/packages/twenty-docs/l/ko/user-guide/workflows/overview.mdx b/packages/twenty-docs/l/ko/user-guide/workflows/overview.mdx
index 740ecc1d5f9..b576cc0e80c 100644
--- a/packages/twenty-docs/l/ko/user-guide/workflows/overview.mdx
+++ b/packages/twenty-docs/l/ko/user-guide/workflows/overview.mdx
@@ -3,7 +3,6 @@ title: 워크플로우
description: Twenty에서 자동화를 구축하는 방법을 알아보세요.
---
-
## 워크플로우의 중요성
Twenty는 사용자가 최대한 유연성을 누릴 수 있도록 설계되었습니다. 정해진 기능에 비즈니스 프로세스를 맞추는 대신, 워크플로우를 통해 귀사만의 고유한 비즈니스 사례를 지원할 수 있는 CRM 자동화를 빌드할 수 있습니다.
diff --git a/packages/twenty-docs/l/pt/user-guide/data-migration/capabilities/field-mapping.mdx b/packages/twenty-docs/l/pt/user-guide/data-migration/capabilities/field-mapping.mdx
index f498d1f09ed..2d7910af6dd 100644
--- a/packages/twenty-docs/l/pt/user-guide/data-migration/capabilities/field-mapping.mdx
+++ b/packages/twenty-docs/l/pt/user-guide/data-migration/capabilities/field-mapping.mdx
@@ -56,7 +56,7 @@ Endereço é um campo aninhado com várias colunas. Algumas podem ficar em branc
Use o seguinte formato:
```
-[\"value1\",\"value2\"]
+["value1","value2"]
```
### Campos Booleanos
@@ -94,7 +94,7 @@ Formatos suportados:
* Para e-mails adicionais: use **E-mails / E-mail principal** para o e-mail principal e **E-mails / E-mails adicionais** com este formato:
```
```
### Campos de ID
@@ -113,7 +113,7 @@ Casos de uso para mapear uma coluna `id`:
Use um formato JSON válido:
```
-{\"key\":\"value\",\"key2\":\"value2\"}
+{"key":"value","key2":"value2"}
```
### Campos de Links
@@ -125,7 +125,7 @@ Semelhante aos campos de Domínio:
* Para links secundários, use a coluna **Links / Links Secundários** com este formato:
```
-[{\"url\":\"https://twenty.com\",\"label\":\"Twenty\"}]
+[{"url":"https://twenty.com","label":"Twenty"}]
```
### Campos de Seleção Múltipla
@@ -133,7 +133,7 @@ Semelhante aos campos de Domínio:
Use os **nomes da API** (não os rótulos de exibição) no seguinte formato:
```
-[\"VALUE1\",\"VALUE2\"]
+["VALUE1","VALUE2"]
```
Veja [aqui](#finding-api-names-for-select-fields) onde encontrar os nomes da API.
@@ -143,7 +143,7 @@ Veja [aqui](#finding-api-names-for-select-fields) onde encontrar os nomes da API
<Warning>
**A importação substitui; não adiciona.**
-Se um registro já tiver `VALUE2` e `VALUE3` selecionados e você importar `[\"VALUE1\"]`, o registro terá apenas `VALUE1` após a importação. As seleções anteriores são substituídas, não mescladas.
+Se um registro já tiver `VALUE2` e `VALUE3` selecionados e você importar `["VALUE1"]`, o registro terá apenas `VALUE1` após a importação. As seleções anteriores são substituídas, não mescladas.
</Warning>
### Campos Numéricos
diff --git a/packages/twenty-docs/l/pt/user-guide/data-migration/capabilities/file-formats.mdx b/packages/twenty-docs/l/pt/user-guide/data-migration/capabilities/file-formats.mdx
index e95ef0d5e47..3aa659967a9 100644
--- a/packages/twenty-docs/l/pt/user-guide/data-migration/capabilities/file-formats.mdx
+++ b/packages/twenty-docs/l/pt/user-guide/data-migration/capabilities/file-formats.mdx
@@ -25,7 +25,7 @@ O Twenty suporta três formatos de ficheiro para importação:
## Melhores Práticas para CSV
* **Delimitador**: Utilize vírgula (`,`) ou ponto e vírgula (`;`)
-* **Qualificador de texto**: Utilize aspas duplas (`\"`) para texto que contenha vírgulas
+* **Qualificador de texto**: Utilize aspas duplas (`"`) para texto que contenha vírgulas
* **Finais de linha**: Windows (CRLF) ou Unix (LF), ambos são suportados
* **Valores vazios**: Deixe as células em branco, não utilize "NULL" ou "N/A"
diff --git a/packages/twenty-docs/l/pt/user-guide/data-migration/how-tos/update-existing-records-via-import.mdx b/packages/twenty-docs/l/pt/user-guide/data-migration/how-tos/update-existing-records-via-import.mdx
index 64239c3ee90..34e98a6e93e 100644
--- a/packages/twenty-docs/l/pt/user-guide/data-migration/how-tos/update-existing-records-via-import.mdx
+++ b/packages/twenty-docs/l/pt/user-guide/data-migration/how-tos/update-existing-records-via-import.mdx
@@ -27,9 +27,9 @@ Quando importar um ficheiro que contenha um **identificador único** que corresp
<Warning>
**Os campos de seleção múltipla são substituídos, não combinados.**
-Se um registo tiver `Option A` e `Option B` selecionadas, e importar `[\"Option C\"]`, o registo terá apenas `Option C` após a importação. A importação substitui todas as seleções anteriores — não as adiciona.
+Se um registo tiver `Option A` e `Option B` selecionadas, e importar `["Option C"]`, o registo terá apenas `Option C` após a importação. A importação substitui todas as seleções anteriores — não as adiciona.
-Para manter os valores existentes, inclua-os todos na sua importação: `[\"Option A\",\"Option B\",\"Option C\"]`
+Para manter os valores existentes, inclua-os todos na sua importação: `["Option A","Option B","Option C"]`
</Warning>
## Passo 1: Exportar os Seus Dados Atuais
diff --git a/packages/twenty-docs/l/ro/user-guide/data-migration/capabilities/file-formats.mdx b/packages/twenty-docs/l/ro/user-guide/data-migration/capabilities/file-formats.mdx
index 81fc33eeac5..b7ecfb74831 100644
--- a/packages/twenty-docs/l/ro/user-guide/data-migration/capabilities/file-formats.mdx
+++ b/packages/twenty-docs/l/ro/user-guide/data-migration/capabilities/file-formats.mdx
@@ -25,7 +25,7 @@ Twenty acceptă trei formate de fișier pentru import:
## Cele mai bune practici pentru CSV
* **Delimitator**: utilizați virgula (`,`) sau punct și virgulă (`;`)
-* **Calificator de text**: utilizați ghilimele duble (`\"`) pentru text care conține virgule
+* **Calificator de text**: utilizați ghilimele duble (`"`) pentru text care conține virgule
* **Sfârșituri de linie**: Windows (CRLF) sau Unix (LF), ambele sunt acceptate
* **Valori goale**: Lăsați celulele necompletate, nu folosiți "NULL" sau "N/A"
diff --git a/packages/twenty-docs/l/ro/user-guide/workflows/how-tos/advanced-configurations/handle-arrays-in-code-actions.mdx b/packages/twenty-docs/l/ro/user-guide/workflows/how-tos/advanced-configurations/handle-arrays-in-code-actions.mdx
index fd69860f470..d36d0fe8e22 100644
--- a/packages/twenty-docs/l/ro/user-guide/workflows/how-tos/advanced-configurations/handle-arrays-in-code-actions.mdx
+++ b/packages/twenty-docs/l/ro/user-guide/workflows/how-tos/advanced-configurations/handle-arrays-in-code-actions.mdx
@@ -39,7 +39,7 @@ export const main = async (params: {
};
```
-Linia esențială `typeof users === \"string\" ? JSON.parse(users) : users` verifică dacă intrarea este un șir, o parsează dacă este necesar sau o folosește direct dacă este deja un tablou.
+Linia esențială `typeof users === "string" ? JSON.parse(users) : users` verifică dacă intrarea este un șir, o parsează dacă este necesar sau o folosește direct dacă este deja un tablou.
## Extragerea câmpurilor individuale din tablouri
diff --git a/packages/twenty-docs/l/ru/user-guide/data-migration/capabilities/field-mapping.mdx b/packages/twenty-docs/l/ru/user-guide/data-migration/capabilities/field-mapping.mdx
index 035af20a296..6b6a646fd79 100644
--- a/packages/twenty-docs/l/ru/user-guide/data-migration/capabilities/field-mapping.mdx
+++ b/packages/twenty-docs/l/ru/user-guide/data-migration/capabilities/field-mapping.mdx
@@ -143,7 +143,7 @@ Twenty пытается сопоставлять столбцы на основ
<Warning>
**Импорт перезаписывает, а не добавляет.**
-Если у записи уже выбраны `VALUE2` и `VALUE3`, а вы импортируете `[\"VALUE1\"]`, после импорта у записи останется только `VALUE1`. Предыдущие выбранные значения заменяются, а не объединяются.
+Если у записи уже выбраны `VALUE2` и `VALUE3`, а вы импортируете `["VALUE1"]`, после импорта у записи останется только `VALUE1`. Предыдущие выбранные значения заменяются, а не объединяются.
</Warning>
### Числовые поля
diff --git a/packages/twenty-docs/l/ru/user-guide/data-migration/capabilities/file-formats.mdx b/packages/twenty-docs/l/ru/user-guide/data-migration/capabilities/file-formats.mdx
index b23ff06244c..326cd9ddb7b 100644
--- a/packages/twenty-docs/l/ru/user-guide/data-migration/capabilities/file-formats.mdx
+++ b/packages/twenty-docs/l/ru/user-guide/data-migration/capabilities/file-formats.mdx
@@ -25,7 +25,7 @@ Twenty поддерживает три формата файлов для имп
## Лучшие практики CSV
* **Разделитель**: используйте запятую (`,`) или точку с запятой (`;`)
-* **Квалификатор текста**: используйте двойные кавычки (`\"`) для текста, содержащего запятые
+* **Квалификатор текста**: используйте двойные кавычки (`"`) для текста, содержащего запятые
* **Окончания строк**: поддерживаются оба варианта — Windows (CRLF) и Unix (LF)
* **Пустые значения**: оставляйте ячейки пустыми, не используйте "NULL" или "N/A"
diff --git a/packages/twenty-docs/l/ru/user-guide/data-migration/how-tos/prepare-your-csv-files.mdx b/packages/twenty-docs/l/ru/user-guide/data-migration/how-tos/prepare-your-csv-files.mdx
index edfc0b92c6f..344626ca1e6 100644
--- a/packages/twenty-docs/l/ru/user-guide/data-migration/how-tos/prepare-your-csv-files.mdx
+++ b/packages/twenty-docs/l/ru/user-guide/data-migration/how-tos/prepare-your-csv-files.mdx
@@ -65,7 +65,7 @@ Twenty требует уникальности для некоторых пол
* Для дополнительных адресов используйте этот формат в столбце **Emails / Additional Emails**:
```
```
### Поля домена
diff --git a/packages/twenty-docs/l/tr/developers/contribute/capabilities/frontend-development/style-guide.mdx b/packages/twenty-docs/l/tr/developers/contribute/capabilities/frontend-development/style-guide.mdx
index 8108fb4ed53..a1572a40ac5 100644
--- a/packages/twenty-docs/l/tr/developers/contribute/capabilities/frontend-development/style-guide.mdx
+++ b/packages/twenty-docs/l/tr/developers/contribute/capabilities/frontend-development/style-guide.mdx
@@ -198,7 +198,7 @@ Bileşenleri [Linaria styled](https://github.com/callstack/linaria) ile stillend
```tsx
// ❌ Kötü
-<div className=\"my-class\">Hello World</div>
+<div className="my-class">Hello World</div>
```
```tsx
diff --git a/packages/twenty-docs/l/tr/twenty-ui/input/text.mdx b/packages/twenty-docs/l/tr/twenty-ui/input/text.mdx
index 7e0b2db38b2..b09a0c55a99 100644
--- a/packages/twenty-docs/l/tr/twenty-ui/input/text.mdx
+++ b/packages/twenty-docs/l/tr/twenty-ui/input/text.mdx
@@ -39,7 +39,7 @@ export const MyComponent = () => {
/>
);
};
-},{
+
```
diff --git a/packages/twenty-docs/l/tr/user-guide/data-migration/how-tos/prepare-your-csv-files.mdx b/packages/twenty-docs/l/tr/user-guide/data-migration/how-tos/prepare-your-csv-files.mdx
index 4ea4adaa812..43e79e6c84c 100644
--- a/packages/twenty-docs/l/tr/user-guide/data-migration/how-tos/prepare-your-csv-files.mdx
+++ b/packages/twenty-docs/l/tr/user-guide/data-migration/how-tos/prepare-your-csv-files.mdx
@@ -65,7 +65,7 @@ Farklı alan türleri belirli biçimler gerektirir. İşte eksiksiz başvuru:
* Ek e-postalar için, **E-postalar / Ek E-postalar** sütununda şu biçimi kullanın:
```
```
### Alan Adı Alanları
diff --git a/packages/twenty-docs/l/zh/twenty-ui/input/text.mdx b/packages/twenty-docs/l/zh/twenty-ui/input/text.mdx
index 488bade5363..726f50b9e2b 100644
--- a/packages/twenty-docs/l/zh/twenty-ui/input/text.mdx
+++ b/packages/twenty-docs/l/zh/twenty-ui/input/text.mdx
@@ -39,7 +39,7 @@ export const MyComponent = () => {
/>
);
};
-},{
+
```
diff --git a/packages/twenty-docs/l/zh/user-guide/data-migration/capabilities/file-formats.mdx b/packages/twenty-docs/l/zh/user-guide/data-migration/capabilities/file-formats.mdx
index 789d8171d7c..1870ba48a4b 100644
--- a/packages/twenty-docs/l/zh/user-guide/data-migration/capabilities/file-formats.mdx
+++ b/packages/twenty-docs/l/zh/user-guide/data-migration/capabilities/file-formats.mdx
@@ -25,7 +25,7 @@ Twenty 支持三种导入文件格式:
## CSV 最佳实践
* **分隔符**:使用逗号(`,`)或分号(`;`)
-* **文本限定符**:对于包含逗号的文本,请使用双引号(`\"`)
+* **文本限定符**:对于包含逗号的文本,请使用双引号(`"`)
* **行结束符**:支持 Windows(CRLF)或 Unix(LF)
* **空值**:将单元格留空,不要使用 "NULL" 或 "N/A"
diff --git a/packages/twenty-docs/l/zh/user-guide/workflows/how-tos/connect-to-other-tools/bring-product-data-in-twenty.mdx b/packages/twenty-docs/l/zh/user-guide/workflows/how-tos/connect-to-other-tools/bring-product-data-in-twenty.mdx
index db6ef148371..bed1caffe08 100644
--- a/packages/twenty-docs/l/zh/user-guide/workflows/how-tos/connect-to-other-tools/bring-product-data-in-twenty.mdx
+++ b/packages/twenty-docs/l/zh/user-guide/workflows/how-tos/connect-to-other-tools/bring-product-data-in-twenty.mdx
@@ -133,14 +133,14 @@ export const main = async (params: { deals: any }) => {
### 常见转换
-| 源格式 | 目标格式 | 代码 |
-| -------------------- | ---------------- | ------------------------------------------ |
-| `"true"` / `"false"` | `true` / `false` | `v === true \\|\\| v === \"true\"` |
-| `\"123.45\"` | `123.45` | `parseFloat(value)` |
-| `\"active\"` | `\"ACTIVE\"` | `value.toUpperCase()` |
-| `1704067200` (Unix) | ISO 日期 | `new Date(v * 1000).toISOString()` |
-| `\"$1,234.56\"` | `1234.56` | `parseFloat(v.replace(/[^0-9.-]/g, \"\"))` |
-| `null` / `undefined` | `\"\"` | `value \\|\\| \"\"` |
+| 源格式 | 目标格式 | 代码 |
+| -------------------- | ---------------- | ---------------------------------------- |
+| `"true"` / `"false"` | `true` / `false` | `v === true \\|\\| v === "true"` |
+| `"123.45"` | `123.45` | `parseFloat(value)` |
+| `"active"` | `"ACTIVE"` | `value.toUpperCase()` |
+| `1704067200` (Unix) | ISO 日期 | `new Date(v * 1000).toISOString()` |
+| `"$1,234.56"` | `1234.56` | `parseFloat(v.replace(/[^0-9.-]/g, ""))` |
+| `null` / `undefined` | `""` | `value \\|\\| ""` |
## 步骤 4:遍历产品