The open alternative to Salesforce, designed for AI.
TypeScript crmcrm-systemcustomergood-first-issuegraphqlhacktoberfestjavascriptmarketingmonoreponestjsopen-sourcepostgresqlreactreactjssalestypescriptweb
i18n - docs translations (#24064)
github-actions[bot]da8029e15ff9
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.mdxindex 233560283dc..6ee9f15cb61 100644--- a/packages/twenty-docs/l/ar/developers/extend/apps/config/application.mdx+++ b/packages/twenty-docs/l/ar/developers/extend/apps/config/application.mdx@@ -37,6 +37,7 @@ export default defineApplication({* يتم اكتشاف دوال ما قبل التثبيت وما بعد التثبيت وإلغاء التثبيت تلقائيًا أثناء بناء البيان — لا حاجة للإشارة إليها في `defineApplication()`.* لا يزال تمرير `defaultRoleUniversalIdentifier` بشكل صريح مدعومًا من أجل التوافق مع الإصدارات السابقة، ولكنه مُهمل لصالح `defineApplicationRole()`.* `serverVariables` هي تكوينات وأسرار بنطاق المثيل (مثل مفاتيح واجهة برمجة التطبيقات). على عكس `applicationVariables`، فهي لا تصرح عن أي قيمة في ملف manifest — حيث يقوم مشغّل مساحة العمل بملئها من إعدادات التطبيق، ويتم حقنها في دوال المنطق فقط بعد تعيينها.+* كلا نوعي المتغير يقبلان `isDeprecated: true`. استخدم ذلك لإيقاف استخدام متغير بدلاً من حذفه: إبقاء المفتاح معلناً يحافظ على القيمة المخزنة (حذفه يدمّر القيمة التي أدخلها المشغّل)، ولا يزال يتم حقن المتغير، بحيث يمكن لشفرتك أن تعتمد عليه كخيار احتياطي — `process.env.NEW_API_KEY ?? process.env.API_KEY`. A deprecated variable disappears from the app's settings once it has no value, and never counts toward the app's configuration check, so `isDeprecated` beats `isRequired`.* لعرض واجهة مستخدم مخصّصة لإعدادات التكوين داخل علامة تبويب **Settings** في التطبيق (بدلًا من قسم تكوين المتغيّرات الافتراضي)، صرّح بمكوّن واجهة أمامية باستخدام [`defineSettingsFrontComponent()`](/l/ar/developers/extend/apps/layout/front-components#custom-settings-component) في ملفه الخاص. يُسمح بواحد فقط لكل تطبيق. الأقسام التي يديرها النظام (الترقية التلقائية، App URL، الاتصالات) تظل مرئية دائمًا.## أنواع المتغيرات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.mdxindex 9263ffb560e..26f40156a7b 100644--- 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@@ -603,7 +603,7 @@ export default defineFrontComponent({## مشاركة التبعيات عبر مكوّنات الواجهة الأمامية-افتراضيًا، يضمّن كل مكوّن واجهة أمامية نسخته الخاصة من المكتبات التي يستوردها، لذا فإن تطبيقًا يحتوي على خمسة مكوّنات يشحن React خمس مرات. صرّح بالتبعيات المشتركة في ملف `package.json` الخاص بتطبيقك لبناء تلك المكتبات مرة واحدة وجعل كل مكوّن في التطبيق يحمّلها من ملف واحد مخزَّن في الذاكرة المخبئية:+افتراضيًا، يضمّن كل مكوّن واجهة أمامية نسخته الخاصة من المكتبات التي يستوردها، لذا فإن تطبيقًا يحتوي على خمسة مكوّنات سيتضمّن React خمس مرات. صرّح بالتبعيات المشتركة في ملف `package.json` الخاص بتطبيقك لبناء تلك المكتبات مرة واحدة وجعل كل مكوّن في التطبيق يحمّلها من ملف واحد مخزَّن في الذاكرة المخبئية:```json package.json{@@ -632,7 +632,7 @@ export default defineFrontComponent({بعض الأمور التي يجب معرفتها:-* **حزمة تبعيات مشتركة واحدة لكل تطبيق.** يتم إنشاء الحزمة من تبعيات تطبيقك نفسه، بحيث تحتفظ بالتحكم الكامل في الإصدارات التي تشحنها.+* **حزمة تبعيات مشتركة واحدة لكل تطبيق.** يتم إنشاء الحزمة من تبعيات تطبيقك نفسه، بحيث تحتفظ بالتحكم الكامل في الإصدارات التي تُصدِرها.* **اسرد المعرّفات (specifiers) الدقيقة التي تستوردها.** يُعَدّ `twenty-ui/input` و `twenty-ui/display` مدخلين منفصلين؛ اسم الحزمة وحده لا يشمل المسارات الفرعية. إدراج `react` يغطي تلقائيًا `react/jsx-runtime`.* **شارك `react-dom/client` جنبًا إلى جنب مع `react`.** كل مكوّن يقوم بعملية التصيير من خلال `createRoot`، لذا فإن تركه خارجًا يعني أن كل مكوّن ما زال يضمّن React DOM داخل حزمتِه الخاصة.* **الحزمة مُخزَّنة في الذاكرة المخبئية.** يتم تقديمها عبر عنوان URL يعتمد على قيمة تجزئة المحتوى (content-hash) مع ذاكرة مخبئية ثابتة طويلة الأجل، لذا يتم تنزيلها مرة واحدة وإعادة استخدامها عبر جميع مكوّنات التطبيق حتى تتغيّر إحدى تبعياتها.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.mdxindex 97060154641..5bbde8d1a64 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@@ -109,7 +109,7 @@ curl http://localhost:3000### جعل Twenty متاحاً للوصول الخارجي-افتراضياً، يعمل Twenty على `localhost` على المنفذ `3000`. للوصول إليه عبر نطاق خارجي أو عنوان IP، تحتاج إلى تكوين `SERVER_URL` في ملف `.env`.+افتراضياً، يعمل Twenty على `localhost` على المنفذ `3000`. تقوم واجهة المستخدم بحل واجهة برمجة التطبيقات (API) من مصدر المتصفح نفسه، لذلك يتم تحميلها من أي اسم مضيف يصل إلى الحاوية — لكن يجب مع ذلك تعيين `SERVER_URL` إلى عنوان URL العام الخاص بك: يستخدمه الخادم للروابط المُنشأة (رسائل البريد الإلكتروني، استدعاءات OAuth) ولاكتشاف HTTPS لملفات تعريف الارتباط الآمنة.#### فهم `SERVER_URL`@@ -229,7 +229,7 @@ docker exec twenty-postgres pg_dump -U postgres twenty > backup_$(date +%Y%m%d).1. إيقاف التطبيق:```bash-docker compose stop twenty-server twenty-front+docker compose stop server worker```2. استعادة قاعدة البيانات: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.mdxindex 5da9f95d0f2..85e2abce735 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@@ -392,15 +392,19 @@ LOGIC_FUNCTION_TYPE=DISABLED # default when NODE_ENV=productionينطبق فقط إذا كنت لا تدع الواجهة الخلفية تقوم بخدمة الواجهة الأمامية. عمليات النشر ذات الأصل نفسه لا تحتاج إلى أي شيء هنا.صرّح بجميع أصول المتصفحات التي تتواصل مع واجهة برمجة التطبيقات (API)، مفصولة بفواصل. `SERVER_URL`-و`FRONTEND_URL` موثوق بهما بالفعل.+و`FRONTEND_URL` موثوق بهما بالفعل. يقوم الخادم بتسجيل تحذير عندما يتصل به متصفح+من مصدر (origin) غير مصرح به.```bashAUTH_COOKIE_ALLOWED_ORIGINS=https://app.example.com```<Warning>-الترقية إلى إصدار يستخدم جلسات ملفات تعريف الارتباط تجعل هذا إعدادًا مطلوبًا. الواجهة الأمامية-ترسل الآن بيانات الاعتماد مع كل طلب، وتقوم المتصفحات برفض الاستجابة التي تحتوي على بيانات اعتماد إذا جاءت من مصدر غير مصرح به، لذلك يفشل التطبيق في التحميل حتى تقوم بتعيين هذا الإعداد.+ترسل الواجهة الأمامية بيانات الاعتماد مع كل طلب، وتقوم المتصفحات برفض الاستجابة التي تحتوي على بيانات اعتماد إذا جاءت من مصدر غير مصرح به، لذلك يفشل التطبيق في التحميل حتى تقوم بتعيين هذا الإعداد.</Warning>إذا كان المضيفان على نطاقات قابلة للتسجيل مختلفة (وليس مجرد نطاقات فرعية مختلفة)، قم أيضًا بتعيين `AUTH_COOKIE_SAME_SITE=none`، والذي يتطلب HTTPS.++مع تمكين ميزة تعدد مساحات العمل، لا تقم بإدراج كل نطاق فرعي لمساحة العمل هنا.+بدلًا من ذلك، قم بتوجيه مسارات واجهة برمجة التطبيقات (API) (`/graphql`، `/metadata`، `/rest`، `/auth/`،+`/client-config`، `/file`) إلى الواجهة الخلفية على كل اسم مضيف لمساحة عمل، بحيث تبقى كل مساحة عمل من نفس المصدر (same-origin) — هكذا تعمل Twenty Cloud.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.mdxindex a78dd3274aa..418c04c1420 100644--- a/packages/twenty-docs/l/cs/developers/extend/apps/config/application.mdx+++ b/packages/twenty-docs/l/cs/developers/extend/apps/config/application.mdx@@ -37,6 +37,7 @@ Poznámky:* Předinstalační, postinstalační a odinstalač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()`.* `serverVariables` představují konfiguraci a tajné údaje vázané na instanci (např. klíče API). Na rozdíl od `applicationVariables` neuvádějí v manifestu žádnou hodnotu — operátor pracovního prostoru je vyplní v nastavení aplikace a do logických funkcí jsou injektovány až poté, co jsou nastaveny.+* Oba druhy proměnných přijímají `isDeprecated: true`. Použijte ji k vyřazení proměnné namísto jejího smazání: ponechání deklarovaného klíče zachová uloženou hodnotu (smazání ji zničí, tedy hodnotu, kterou operátor zadal) a proměnná je stále injektována, takže váš kód se k ní může vrátit — `process.env.NEW_API_KEY ?? process.env.API_KEY`. A deprecated variable disappears from the app's settings once it has no value, and never counts toward the app's configuration check, so `isDeprecated` beats `isRequired`.* Chcete-li vykreslit vlastní konfigurační uživatelské rozhraní na kartě **Settings** aplikace (namísto výchozí sekce pro konfiguraci proměnných), deklarujte frontovou komponentu pomocí [`defineSettingsFrontComponent()`](/l/cs/developers/extend/apps/layout/front-components#custom-settings-component) v jejím vlastním souboru. Na jednu aplikaci je povolena pouze jedna instance. Sekce spravované systémem (automatická aktualizace, App URL, připojení) zůstávají vždy viditelné.## Typy proměnnýchdiff --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.mdxindex 0283c338197..8b22bc35c15 100644--- 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@@ -34,23 +34,23 @@ your-app/## 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) |-| **Sdílené závislosti** | Závislosti sdílené front komponentami aplikace, deklarované v package.json | [Sdílené závislosti](/l/cs/developers/extend/apps/layout/front-components#sharing-dependencies-across-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) |+| 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) |+| **Sdílené závislosti** | Závislosti sdílené frontendovými komponentami aplikace, definované v souboru package.json | [Sdílené závislosti](/l/cs/developers/extend/apps/layout/front-components#sharing-dependencies-across-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)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.mdxindex f2ee696c948..f444c872956 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@@ -109,7 +109,7 @@ curl http://localhost:3000### Otevření Twenty pro Externí Přístup-Ve výchozím nastavení běží Twenty na `localhost` na portu `3000`. Pro přístup přes externí doménu nebo IP adresu musíte nakonfigurovat `SERVER_URL` ve vašem `.env` souboru.+Ve výchozím nastavení běží Twenty na `localhost` na portu `3000`. UI řeší API z vlastního původu prohlížeče, takže se načítá z libovolného hostnamu, který dosáhne na kontejner — ale přesto nastavte `SERVER_URL` na svou veřejnou URL: server ji používá pro generované odkazy (e-maily, OAuth callbacky) a k detekci HTTPS pro zabezpečené cookies.#### Porozumění `SERVER_URL`@@ -229,7 +229,7 @@ Přidejte do svého crontabu (`crontab -e`):1. Zastavte aplikaci:```bash-docker compose stop twenty-server twenty-front+docker compose stop server worker```2. Obnovte databázi: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.mdxindex 24654194352..fd82c0e6169 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@@ -393,15 +393,21 @@ Platí pouze v případě, že back-end neposkytuje front-end. Nasazení se stejzde nic nepotřebují.Uveďte každý původ prohlížeče, který komunikuje s API, oddělený čárkami. `SERVER_URL`-a `FRONTEND_URL` jsou již důvěryhodné.+a `FRONTEND_URL` jsou již důvěryhodné. Server zapisuje varování do logu, když jej prohlížeč+volá z nedeklarovaného původu.```bashAUTH_COOKIE_ALLOWED_ORIGINS=https://app.example.com```<Warning>-Aktualizace na verzi s relacemi pomocí souborů cookie to vyžaduje. Front-end-nyní posílá přihlašovací údaje u každého požadavku a prohlížeče odmítají odpověď s přihlašovacími údaji z nedeklarovaného původu, takže se aplikace nenačte, dokud to nenastavíte.+Front-end odesílá přihlašovací údaje u každého požadavku a prohlížeče odmítnou+odpověď s přihlašovacími údaji z nedeklarovaného původu, takže se aplikace nenačte, dokud toto nenastavíte.</Warning>Pokud jsou dva hostitelé na různých registrovatelných doménách (nejen na různých subdoménách), nastavte také `AUTH_COOKIE_SAME_SITE=none`, což vyžaduje HTTPS.++Pokud je povolen vícepracovní prostředí (multi-workspace), neuvádějte zde každý dílčí doménový název pracovního prostoru.+Místo toho směrujte API cesty (`/graphql`, `/metadata`, `/rest`, `/auth/`,+`/client-config`, `/file`) na back-end na každém hostiteli pracovního prostoru, takže každý+pracovní prostor zůstává stejného původu (same-origin) — takto běží Twenty Cloud.diff --git a/packages/twenty-docs/l/de/developers/extend/apps/config/application.mdx b/packages/twenty-docs/l/de/developers/extend/apps/config/application.mdxindex d24387d02cf..7319b54d546 100644--- a/packages/twenty-docs/l/de/developers/extend/apps/config/application.mdx+++ b/packages/twenty-docs/l/de/developers/extend/apps/config/application.mdx@@ -37,6 +37,7 @@ Notizen:* Pre-Installations-, Post-Installations- und Deinstallationsfunktionen werden während des Manifest-Builds automatisch erkannt — Sie müssen sie in `defineApplication()` nicht referenzieren.* Die explizite Übergabe von `defaultRoleUniversalIdentifier` wird für die Abwärtskompatibilität weiterhin unterstützt, ist jedoch zugunsten von `defineApplicationRole()` veraltet.* `serverVariables` sind instanzbezogene Konfigurationen und Geheimnisse (z. B. API-Schlüssel). Im Gegensatz zu `applicationVariables` haben sie im Manifest keinen Wert definiert – die Workspace-Operatorin bzw. der Workspace-Operator trägt sie in den App-Einstellungen ein, und sie werden erst dann in Logikfunktionen eingespeist, wenn sie gesetzt sind.+* Beide Arten von Variablen akzeptieren `isDeprecated: true`. Verwenden Sie dies, um eine Variable außer Betrieb zu nehmen, anstatt sie zu löschen: Wenn der Schlüssel deklariert bleibt, wird der gespeicherte Wert beibehalten (beim Löschen wird der vom Operator eingegebene Wert zerstört), und die Variable wird weiterhin injiziert, sodass Ihr Code darauf zurückfallen kann — `process.env.NEW_API_KEY ?? process.env.API_KEY`. Eine veraltete Variable verschwindet aus den App-Einstellungen, sobald sie keinen Wert mehr hat, und wird niemals bei der Konfigurationsprüfung der App berücksichtigt, sodass `isDeprecated` gegenüber `isRequired` Vorrang hat.* Um eine benutzerdefinierte Konfigurationsoberfläche im Tab **Settings** der App anzuzeigen (anstelle des standardmäßigen Variablenkonfigurationsbereichs), deklarieren Sie eine Front-Komponente mit [`defineSettingsFrontComponent()`](/l/de/developers/extend/apps/layout/front-components#custom-settings-component) in einer eigenen Datei. Pro App ist nur eine zulässig. Systemverwaltete Bereiche (Auto-Upgrade, App-URL, Verbindungen) bleiben immer sichtbar.## Variablentypendiff --git a/packages/twenty-docs/l/de/developers/extend/apps/getting-started/concepts.mdx b/packages/twenty-docs/l/de/developers/extend/apps/getting-started/concepts.mdxindex afdb52c447d..9dc37b519ea 100644--- a/packages/twenty-docs/l/de/developers/extend/apps/getting-started/concepts.mdx+++ b/packages/twenty-docs/l/de/developers/extend/apps/getting-started/concepts.mdx@@ -34,23 +34,23 @@ your-app/## Entitätstypen-| Entität | Zweck | Dokumentation |-| ----------------------------- | ------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------- |-| **Anwendung** | App-Identität, Standardrolle, Variablen | [Anwendungskonfiguration](/l/de/developers/extend/apps/config/application) |-| **Rolle** | Berechtigungssätze für Objekte und Felder | [Rollen & Berechtigungen](/l/de/developers/extend/apps/config/roles) |-| **Objekt** | Benutzerdefinierte Datensatztypen mit Feldern | [Objekte](/l/de/developers/extend/apps/data/objects) |-| **Feld** | Felder zu Objekten aus anderen Apps hinzufügen | [Objekte erweitern](/l/de/developers/extend/apps/data/extending-objects) |-| **Beziehung** | Bidirektionale Verknüpfungen zwischen Objekten | [Beziehungen](/l/de/developers/extend/apps/data/relations) |-| **Logikfunktion** | Serverseitiges TypeScript mit Triggern | [Logikfunktionen](/l/de/developers/extend/apps/logic/logic-functions) |-| **Skill** | Wiederverwendbare Anweisungen für KI-Agenten | [Skills & Agenten](/l/de/developers/extend/apps/logic/skills-and-agents) |-| **Agent** | KI-Assistenten mit benutzerdefinierten Prompts | [Skills & Agenten](/l/de/developers/extend/apps/logic/skills-and-agents) |-| **Verbindungsanbieter** | OAuth-Zugangsdaten für Drittanbieter-APIs | [Verbindungen](/l/de/developers/extend/apps/logic/connections) |-| **Ansicht** | Vorkonfigurierte Listenansichten für Datensätze | [Ansichten](/l/de/developers/extend/apps/layout/views) |-| **Navigationsmenüeintrag** | Benutzerdefinierte Seitenleisten-Einträge | [Navigationsmenüeinträge](/l/de/developers/extend/apps/layout/navigation-menu-items) |-| **Seitenlayout** | Tabs und Widgets auf der Detailseite eines Datensatzes | [Seiten-Layouts](/l/de/developers/extend/apps/layout/page-layouts) |-| **Frontend-Komponente** | Isolierte React-UI innerhalb von Twenty | [Frontend-Komponenten](/l/de/developers/extend/apps/layout/front-components) |-| **Gemeinsame Abhängigkeiten** | Vom Frontend der App gemeinsam genutzte Abhängigkeiten, die in package.json deklariert sind | [Gemeinsame Abhängigkeiten](/l/de/developers/extend/apps/layout/front-components#sharing-dependencies-across-front-components) |-| **Befehlsmenü-Eintrag** | Schnellaktionen und Cmd+K-Einträge | [Befehlsmenü-Einträge](/l/de/developers/extend/apps/layout/command-menu-items) |+| Entität | Zweck | Dokumentation |+| ----------------------------- | ----------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------- |+| **Anwendung** | App-Identität, Standardrolle, Variablen | [Anwendungskonfiguration](/l/de/developers/extend/apps/config/application) |+| **Rolle** | Berechtigungssätze für Objekte und Felder | [Rollen & Berechtigungen](/l/de/developers/extend/apps/config/roles) |+| **Objekt** | Benutzerdefinierte Datensatztypen mit Feldern | [Objekte](/l/de/developers/extend/apps/data/objects) |+| **Feld** | Felder zu Objekten aus anderen Apps hinzufügen | [Objekte erweitern](/l/de/developers/extend/apps/data/extending-objects) |+| **Beziehung** | Bidirektionale Verknüpfungen zwischen Objekten | [Beziehungen](/l/de/developers/extend/apps/data/relations) |+| **Logikfunktion** | Serverseitiges TypeScript mit Triggern | [Logikfunktionen](/l/de/developers/extend/apps/logic/logic-functions) |+| **Skill** | Wiederverwendbare Anweisungen für KI-Agenten | [Skills & Agenten](/l/de/developers/extend/apps/logic/skills-and-agents) |+| **Agent** | KI-Assistenten mit benutzerdefinierten Prompts | [Skills & Agenten](/l/de/developers/extend/apps/logic/skills-and-agents) |+| **Verbindungsanbieter** | OAuth-Zugangsdaten für Drittanbieter-APIs | [Verbindungen](/l/de/developers/extend/apps/logic/connections) |+| **Ansicht** | Vorkonfigurierte Listenansichten für Datensätze | [Ansichten](/l/de/developers/extend/apps/layout/views) |+| **Navigationsmenüeintrag** | Benutzerdefinierte Seitenleisten-Einträge | [Navigationsmenüeinträge](/l/de/developers/extend/apps/layout/navigation-menu-items) |+| **Seitenlayout** | Tabs und Widgets auf der Detailseite eines Datensatzes | [Seiten-Layouts](/l/de/developers/extend/apps/layout/page-layouts) |+| **Frontend-Komponente** | Isolierte React-UI innerhalb von Twenty | [Frontend-Komponenten](/l/de/developers/extend/apps/layout/front-components) |+| **Gemeinsame Abhängigkeiten** | Von den Frontend-Komponenten der App gemeinsam genutzte Abhängigkeiten, die in package.json deklariert sind | [Gemeinsame Abhängigkeiten](/l/de/developers/extend/apps/layout/front-components#sharing-dependencies-across-front-components) |+| **Befehlsmenü-Eintrag** | Schnellaktionen und Cmd+K-Einträge | [Befehlsmenü-Einträge](/l/de/developers/extend/apps/layout/command-menu-items) |## Sandboxingdiff --git a/packages/twenty-docs/l/de/developers/self-host/capabilities/docker-compose.mdx b/packages/twenty-docs/l/de/developers/self-host/capabilities/docker-compose.mdxindex fd3942323ae..e1de7ad36d3 100644--- a/packages/twenty-docs/l/de/developers/self-host/capabilities/docker-compose.mdx+++ b/packages/twenty-docs/l/de/developers/self-host/capabilities/docker-compose.mdx@@ -109,7 +109,7 @@ curl http://localhost:3000### Twenty für externen Zugriff freigeben-Standardmäßig läuft Twenty auf `localhost` an Port `3000`. Um über eine externe Domain oder IP-Adresse darauf zuzugreifen, müssen Sie die `SERVER_URL` in Ihrer `.env`-Datei konfigurieren.+Standardmäßig läuft Twenty auf `localhost` an Port `3000`. Die UI ruft die API vom ursprünglichen Ursprung des Browsers auf, sodass sie von jedem Hostnamen geladen wird, der den Container erreicht – setze jedoch trotzdem `SERVER_URL` auf deine öffentliche URL: Der Server verwendet sie für generierte Links (E-Mails, OAuth-Callbacks) und zur Erkennung von HTTPS für sichere Cookies.#### Erläuterung von `SERVER_URL`@@ -229,7 +229,7 @@ Zu Ihrer Crontab hinzufügen (`crontab -e`):1. Anwendung stoppen:```bash-docker compose stop twenty-server twenty-front+docker compose stop server worker```2. Datenbank wiederherstellen:diff --git a/packages/twenty-docs/l/de/developers/self-host/capabilities/setup.mdx b/packages/twenty-docs/l/de/developers/self-host/capabilities/setup.mdxindex 490d15b0d7d..8322ee875f3 100644--- a/packages/twenty-docs/l/de/developers/self-host/capabilities/setup.mdx+++ b/packages/twenty-docs/l/de/developers/self-host/capabilities/setup.mdx@@ -393,14 +393,22 @@ Nur relevant, wenn Sie das Frontend nicht vom Backend ausliefern lassen. Same-OrBereitstellungen benötigen hier nichts.Geben Sie alle Browser-Ursprünge an, die mit der API kommunizieren, kommagetrennt. `SERVER_URL`-und `FRONTEND_URL` sind bereits vertrauenswürdig.+und `FRONTEND_URL` sind bereits vertrauenswürdig. Der Server protokolliert eine Warnung, wenn ein Browser+diese aus nicht deklariertem Ursprung aufruft.```bashAUTH_COOKIE_ALLOWED_ORIGINS=https://app.example.com```<Warning>-Ein Upgrade auf eine Version mit Cookie-Sitzungen macht dies erforderlich. Das Frontend sendet nun bei jeder Anfrage Anmeldedaten, und Browser lehnen eine Antwort mit Anmeldedaten von einem nicht deklarierten Ursprung ab, sodass die App nicht geladen wird, bis Sie dies festgelegt haben.+Das Frontend sendet Anmeldeinformationen auf jeder Anfrage, und Browser lehnen eine+Anmeldebestätigung von nicht angemeldeter Herkunft ab, so dass die App nicht geladen werden kann, bis+Sie dies gesetzt haben.</Warning>Wenn sich die beiden Hosts auf unterschiedlichen registrierbaren Domains befinden (nicht nur auf unterschiedlichen Subdomains), setzen Sie außerdem `AUTH_COOKIE_SAME_SITE=none`, was HTTPS erfordert.++Wenn Multiworkspace aktiviert ist, listet hier nicht jede Workspace-Subdomain auf.+Stattdessen Route API Pfade (`/graphql`, `/metadata`, `/rest`, `/auth/`,+`/client-config`, `/file`) in das Backend jedes Hostnamens des Arbeitsbereichs, also bleibt jeder+Arbeitsbereich gleich — so läuft 20 Cloud.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.mdxindex 1bc20476704..50f3ca8efe8 100644--- a/packages/twenty-docs/l/es/developers/extend/apps/config/application.mdx+++ b/packages/twenty-docs/l/es/developers/extend/apps/config/application.mdx@@ -37,6 +37,7 @@ Notas:* Las funciones de preinstalación, posinstalación y desinstalació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()`.* `serverVariables` son configuraciones y secretos con ámbito de instancia (por ejemplo, claves de API). A diferencia de `applicationVariables`, no declaran ningún valor en el manifiesto: el operador del espacio de trabajo los completa desde la configuración de la aplicación, y se inyectan en las funciones lógicas solo una vez que se han establecido.+* Ambos tipos de variable aceptan `isDeprecated: true`. Úsala para retirar una variable en lugar de eliminarla: mantener la clave declarada conserva el valor almacenado (eliminarla destruye el valor que el operador introdujo), y la variable sigue siendo inyectada, por lo que tu código puede recurrir a ella — `process.env.NEW_API_KEY ?? process.env.API_KEY`. Una variable obsoleta desaparece de la configuración de la app una vez que no tiene ningún valor y nunca cuenta para la verificación de configuración de la app, por lo que `isDeprecated` tiene prioridad sobre `isRequired`.* Para mostrar una interfaz de configuración personalizada dentro de la pestaña **Settings** de la aplicación (en lugar de la sección predeterminada de configuración de variables), declara un componente de frontend con [`defineSettingsFrontComponent()`](/l/es/developers/extend/apps/layout/front-components#custom-settings-component) en su propio archivo. Solo se permite uno por aplicación. Las secciones gestionadas por el sistema (actualización automática, App URL, conexiones) siempre permanecen visibles.## Tipos de variablesdiff --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.mdxindex 9d851d19f61..c79c4f4c7f3 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@@ -109,7 +109,7 @@ curl http://localhost:3000### Exponer Twenty para acceso externo-Por defecto, Twenty se ejecuta en `localhost` en el puerto `3000`. Para acceder a él mediante un dominio externo o dirección IP, necesitas configurar `SERVER_URL` en tu archivo `.env`.+Por defecto, Twenty se ejecuta en `localhost` en el puerto `3000`. La interfaz de usuario resuelve la API desde el propio origen del navegador, por lo que se carga desde cualquier nombre de host que llegue al contenedor, pero aun así establece `SERVER_URL` en tu URL pública: el servidor la usa para los enlaces generados (correos electrónicos, callbacks de OAuth) y para detectar HTTPS para las cookies seguras.#### Entendiendo `SERVER_URL`@@ -229,7 +229,7 @@ Añade a tu crontab (`crontab -e`):1. Detén la aplicación:```bash-docker compose stop twenty-server twenty-front+docker compose stop server worker```2. Restaura la base de datos: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.mdxindex b90eacffa9a..366b570dee0 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@@ -393,17 +393,23 @@ Solo es relevante si no permites que el back-end sirva el front-end. Las implemeno necesitan nada aquí.Declara cada origen de navegador que se comunique con la API, separados por comas. `SERVER_URL`-y `FRONTEND_URL` ya son de confianza.+y `FRONTEND_URL` ya son de confianza. El servidor registra una advertencia cuando un navegador+lo llama desde un origen no declarado.```bashAUTH_COOKIE_ALLOWED_ORIGINS=https://app.example.com```<Warning>-Actualizar a una versión con sesiones mediante cookies hace que esto sea obligatorio. El front-end-ahora envía credenciales en cada solicitud, y los navegadores rechazan una respuesta con credenciales-desde un origen no declarado, por lo que la aplicación no se carga hasta que configures esto.+El front-end envía credenciales en cada solicitud, y los navegadores rechazan una+respuesta con credenciales desde un origen no declarado, por lo que la aplicación no se carga hasta+que configures esto.</Warning>Si los dos hosts están en dominios registrables diferentes (no solo ensubdominios distintos), también establece `AUTH_COOKIE_SAME_SITE=none`, lo cual requiere HTTPS.++Con el modo multi-workspace habilitado, no incluyas aquí cada subdominio de workspace.+En su lugar, enruta las rutas de la API (`/graphql`, `/metadata`, `/rest`, `/auth/`,+`/client-config`, `/file`) al back-end en cada nombre de host de workspace, de modo que cada+workspace permanezca con el mismo origen; así es como Twenty Cloud se ejecuta.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.mdxindex ce86aa31aa9..6d9b78c9e64 100644--- 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@@ -34,23 +34,23 @@ your-app/## 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) |-| **Dépendances partagées** | Dépendances partagées par les composants front de l’application, déclarées dans package.json | [Dépendances partagées](/l/fr/developers/extend/apps/layout/front-components#sharing-dependencies-across-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) |+| 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) |+| **Dépendances partagées** | Dépendances partagées par les composants frontaux de l’application, déclarées dans package.json | [Dépendances partagées](/l/fr/developers/extend/apps/layout/front-components#sharing-dependencies-across-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 à sablediff --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.mdxindex 50f69f0cdb1..333ece354c0 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@@ -109,7 +109,7 @@ curl http://localhost:3000### Exposer Twenty à un Accès Externe-Par défaut, Twenty fonctionne sur `localhost` au port `3000`. Pour y accéder via un domaine externe ou une adresse IP, vous devez configurer le `SERVER_URL` dans votre fichier `.env`.+Par défaut, Twenty fonctionne sur `localhost` au port `3000`. L’interface utilisateur résout l’API à partir de l’origine propre du navigateur, elle se charge donc à partir de n’importe quel nom d’hôte qui atteint le conteneur — mais définissez tout de même `SERVER_URL` sur votre URL publique : le serveur l’utilise pour les liens générés (e‑mails, callbacks OAuth) et pour détecter le HTTPS pour les cookies sécurisés.#### Comprendre `SERVER_URL`@@ -229,7 +229,7 @@ Ajoutez à votre crontab (`crontab -e`) :1. Arrêtez l'application :```bash-docker compose stop twenty-server twenty-front+docker compose stop server worker```2. Restaurez la base de données :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.mdxindex 7c028f6c0d8..f92dd961a0e 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@@ -393,16 +393,21 @@ Uniquement pertinent si le back-end ne sert pas l’interface front-end. Les dén’ont besoin de rien ici.Déclarez toutes les origines de navigateur qui communiquent avec l’API, séparées par des virgules. `SERVER_URL`-et `FRONTEND_URL` sont déjà approuvées.+et `FRONTEND_URL` sont déjà approuvées. Le serveur consigne un avertissement lorsque un navigateur+l’appelle depuis une origine non déclarée.```bashAUTH_COOKIE_ALLOWED_ORIGINS=https://app.example.com```<Warning>-La mise à niveau vers une version avec des sessions par cookie rend ce paramètre obligatoire. Le front-end-envoie désormais les identifiants à chaque requête, et les navigateurs rejettent une réponse avec des identifiants-provenant d’une origine non déclarée, de sorte que l’application ne parvient pas à se charger tant que vous n’avez pas défini ce paramètre.+Le front-end envoie les identifiants à chaque requête, et les navigateurs rejettent une+réponse avec des identifiants provenant d’une origine non déclarée, de sorte que l’application ne parvient pas à se charger tant que vous n’avez pas défini ce paramètre.</Warning>Si les deux hôtes se trouvent sur des domaines enregistrables différents (et pas seulement sur des sous-domaines différents), définissez également `AUTH_COOKIE_SAME_SITE=none`, ce qui nécessite HTTPS.++Avec le mode multi-workspace activé, ne répertoriez pas ici chaque sous-domaine de workspace.+Au lieu de cela, acheminez les chemins d’API (`/graphql`, `/metadata`, `/rest`, `/auth/`,+`/client-config`, `/file`) vers le back-end sur chaque nom d’hôte de workspace, afin que chaque+workspace reste en same-origin — c’est ainsi que Twenty Cloud fonctionne.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.mdxindex ac53fcb3b7d..7cc73cf640f 100644--- a/packages/twenty-docs/l/it/developers/extend/apps/config/application.mdx+++ b/packages/twenty-docs/l/it/developers/extend/apps/config/application.mdx@@ -37,6 +37,7 @@ Note:* Le funzioni di pre-installazione, post-installazione e disinstallazione 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()`.* `serverVariables` sono configurazioni e segreti con ambito di istanza (ad esempio chiavi API). A differenza di `applicationVariables`, non dichiarano alcun valore nel manifest — l’operatore dello spazio di lavoro li compila dalle impostazioni dell’app e vengono iniettati nelle funzioni di logica solo una volta impostati.+* Entrambi i tipi di variabile accettano `isDeprecated: true`. Usala per ritirare una variabile invece di eliminarla: mantenere la chiave dichiarata preserva il valore memorizzato (eliminandola si distrugge il valore inserito dall'operatore) e la variabile è ancora iniettata, così il tuo codice può ripiegare su di essa — `process.env.NEW_API_KEY ?? process.env.API_KEY`. Una variabile deprecata scompare dalle impostazioni dell'app non appena non ha più un valore e non viene mai conteggiata nel controllo di configurazione dell'app, quindi `isDeprecated` prevale su `isRequired`.* Per eseguire il rendering di un'interfaccia di configurazione personalizzata all'interno della scheda **Settings** dell'app (al posto della sezione predefinita di configurazione delle variabili), dichiara un front component con [`defineSettingsFrontComponent()`](/l/it/developers/extend/apps/layout/front-components#custom-settings-component) in un proprio file. Ne è consentito solo uno per app. Le sezioni gestite dal sistema (auto-upgrade, App URL, connessioni) rimangono sempre visibili.## Tipi di variabilidiff --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.mdxindex 19c71479b05..8baf96d2878 100644--- 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@@ -34,23 +34,23 @@ your-app/## 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) |-| **Dipendenze condivise** | Dipendenze condivise dai componenti front dell'app, dichiarate in package.json | [Dipendenze condivise](/l/it/developers/extend/apps/layout/front-components#sharing-dependencies-across-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) |+| 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) |+| **Dipendenze condivise** | Dipendenze condivise dai componenti front-end dell'app, dichiarate in package.json | [Dipendenze condivise](/l/it/developers/extend/apps/layout/front-components#sharing-dependencies-across-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) |## Sandboxingdiff --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.mdxindex 80ee84d18e6..7a4b4b0218a 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@@ -109,7 +109,7 @@ curl http://localhost:3000### Esponi Twenty per Accesso Esterno-Per impostazione predefinita, Twenty gira su `localhost` alla porta `3000`. Per accedervi tramite un dominio esterno o indirizzo IP devi configurare il `SERVER_URL` nel tuo file `.env`.+Per impostazione predefinita, Twenty gira su `localhost` alla porta `3000`. L'interfaccia utente risolve l'API dall'origine del browser, quindi viene caricata da qualsiasi hostname che raggiunga il container — ma imposta comunque `SERVER_URL` sul tuo URL pubblico: il server lo usa per i link generati (email, callback OAuth) e per rilevare l'HTTPS per i cookie sicuri.#### Comprendere `SERVER_URL`@@ -229,7 +229,7 @@ Aggiungi al tuo crontab (`crontab -e`):1. Arresta l'applicazione:```bash-docker compose stop twenty-server twenty-front+docker compose stop server worker```2. Ripristina il database: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.mdxindex 6d819a7fc53..e1764bd1a05 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@@ -392,17 +392,23 @@ Rilevante solo se il back-end non serve il front-end. Le distribuzioni con la stnon richiedono nulla qui.Dichiara tutte le origini del browser che comunicano con l'API, separate da virgole. `SERVER_URL`-e `FRONTEND_URL` sono già considerate attendibili.+e `FRONTEND_URL` sono già considerate attendibili. Il server registra un avviso quando un browser+lo chiama da origine non dichiarata.```bashAUTH_COOKIE_ALLOWED_ORIGINS=https://app.example.com```<Warning>-L'aggiornamento a una versione con sessioni tramite cookie rende questo obbligatorio. Il front-end-ora invia le credenziali con ogni richiesta e i browser rifiutano una risposta con credenziali-proveniente da un'origine non dichiarata, quindi l'app non riesce a caricarsi finché non imposti questo valore.+Il front-end invia le credenziali su ogni richiesta, e i browser rifiutano una risposta credenziale+da un'origine non dichiarata, quindi l'applicazione non riesce a caricare fino a quando+hai impostato questo.</Warning>Se i due host si trovano su domini registrabili diversi (non solo sottodominidiversi), imposta anche `AUTH_COOKIE_SAME_SITE=none`, che richiede HTTPS.++Con multi-workspace abilitato, non elencare ogni sottodominio workspace qui.+Invece, percorsi percorsi API (`/graphql`, `/metadata`, `/rest`, `/auth/`,+`/client-config`, `/file`) al back-end su ogni hostname di workspace, quindi ogni workspace+rimane la stessa origine — così funziona Twenty Cloud.diff --git a/packages/twenty-docs/l/ja/developers/extend/apps/config/application.mdx b/packages/twenty-docs/l/ja/developers/extend/apps/config/application.mdxindex aece79ef830..7c982fb1ffa 100644--- a/packages/twenty-docs/l/ja/developers/extend/apps/config/application.mdx+++ b/packages/twenty-docs/l/ja/developers/extend/apps/config/application.mdx@@ -37,6 +37,7 @@ export default defineApplication({* プレインストール関数、ポストインストール関数、およびアンインストール関数は、マニフェストのビルド中に自動的に検出されるため、`defineApplication()` で参照する必要はありません。* 後方互換性のために `defaultRoleUniversalIdentifier` を明示的に渡すことも依然としてサポートされていますが、`defineApplicationRole()` が推奨されるため、非推奨となっています。* `serverVariables` はインスタンス単位の構成およびシークレット(例: API キー)です。 `applicationVariables` と異なり、マニフェスト内で値は宣言されません。ワークスペースのオペレーターがアプリの設定からそれらを入力し、設定された時点でのみロジック関数に注入されます。+* どちらの種類の変数も `isDeprecated: true` を受け付けます。 変数を削除する代わりに廃止するためにこれを使用します。キーの宣言を残しておくことで保存されている値が保持されます(削除するとオペレーターが入力した値は失われます)。また、その変数は依然としてインジェクトされるため、コードは `process.env.NEW_API_KEY ?? process.env.API_KEY` にフォールバックできます。 非推奨の変数は値がなくなるとアプリの設定から消え、アプリの構成チェックにも一切カウントされません。そのため、`isDeprecated` は `isRequired` より優先されます。* アプリの **Settings** タブ内で(デフォルトの変数設定セクションの代わりに)カスタム設定 UI をレンダーするには、専用のファイル内で [`defineSettingsFrontComponent()`](/l/ja/developers/extend/apps/layout/front-components#custom-settings-component) を使用してフロントコンポーネントを宣言します。 アプリごとに 1 つのみ許可されています。 システム管理のセクション(自動アップグレード、App URL、接続)は常に表示されます。## 変数の型diff --git a/packages/twenty-docs/l/ja/developers/self-host/capabilities/docker-compose.mdx b/packages/twenty-docs/l/ja/developers/self-host/capabilities/docker-compose.mdxindex 79f81213001..3c61fe0aa86 100644--- a/packages/twenty-docs/l/ja/developers/self-host/capabilities/docker-compose.mdx+++ b/packages/twenty-docs/l/ja/developers/self-host/capabilities/docker-compose.mdx@@ -109,7 +109,7 @@ curl http://localhost:3000### Twentyを外部アクセスに公開-デフォルトでは、Twentyはポート`3000`で`localhost`上で動作します。 外部ドメインまたはIPアドレス経由でアクセスするには、`.env`ファイルで`SERVER_URL`を構成する必要があります。 外部ドメインまたはIPアドレス経由でアクセスするには、`.env`ファイルで`SERVER_URL`を構成する必要があります。+デフォルトでは、Twentyはポート`3000`で`localhost`上で動作します。 外部ドメインまたはIPアドレス経由でアクセスするには、`.env`ファイルで`SERVER_URL`を構成する必要があります。 UI はブラウザー自身のオリジンから API を解決するため、コンテナに到達できる任意のホスト名から読み込まれます。ただし、`SERVER_URL` には必ずパブリック URL を設定してください。サーバーは、生成されるリンク(メール、OAuth コールバック)や、安全な Cookie のための HTTPS 検出にそれを使用します。#### `SERVER_URL`の理解@@ -229,7 +229,7 @@ crontab に追加 (`crontab -e`):1. アプリケーションを停止します:```bash-docker compose stop twenty-server twenty-front+docker compose stop server worker```2. データベースを復元します:diff --git a/packages/twenty-docs/l/ja/developers/self-host/capabilities/setup.mdx b/packages/twenty-docs/l/ja/developers/self-host/capabilities/setup.mdxindex ee9066fea66..191e49880f3 100644--- a/packages/twenty-docs/l/ja/developers/self-host/capabilities/setup.mdx+++ b/packages/twenty-docs/l/ja/developers/self-host/capabilities/setup.mdx@@ -393,15 +393,17 @@ LOGIC_FUNCTION_TYPE=DISABLED # default when NODE_ENV=productionバックエンドにフロントエンドを配信させない場合にのみ関連します。 同一オリジンでのデプロイの場合、ここで設定する必要はありません。API と通信するすべてのブラウザーオリジンを、カンマ区切りで指定してください。 `SERVER_URL`-および `FRONTEND_URL` は既に信頼済みです。+および `FRONTEND_URL` は既に信頼済みです。 ブラウザーが宣言されていないオリジンからサーバーを呼び出すと、サーバーは警告をログに記録します。```bashAUTH_COOKIE_ALLOWED_ORIGINS=https://app.example.com```<Warning>-Cookie セッションを使用するバージョンにアップグレードすると、これが必須になります。 フロントエンドは-すべてのリクエストでクレデンシャルを送信し、ブラウザーは宣言されていないオリジンからのクレデンシャル付きレスポンスを拒否するため、この設定を行うまでアプリは読み込めません。+フロントエンドはすべてのリクエストでクレデンシャルを送信し、ブラウザーは宣言されていないオリジンからのクレデンシャル付きレスポンスを拒否するため、この設定を行うまでアプリは読み込めません。</Warning>2 つのホストが異なる登録可能ドメイン(単なる異なるサブドメインではない)の場合は、`AUTH_COOKIE_SAME_SITE=none` も設定してください。これは HTTPS を必須とします。++マルチワークスペースが有効な場合、ここにすべてのワークスペースのサブドメインを列挙しないでください。+代わりに、各ワークスペースのホスト名ごとに API パス(`/graphql`、`/metadata`、`/rest`、`/auth/`、`/client-config`、`/file`)をバックエンドへルーティングし、すべてのワークスペースが same-origin を維持するようにします。これは Twenty Cloud が動作している方式です。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.mdxindex bec6b4c19be..93ac668600f 100644--- a/packages/twenty-docs/l/ko/developers/extend/apps/config/application.mdx+++ b/packages/twenty-docs/l/ko/developers/extend/apps/config/application.mdx@@ -37,6 +37,7 @@ export default defineApplication({* 설치 전, 설치 후, 제거 함수는 매니페스트 빌드 중 자동으로 감지됩니다 — `defineApplication()`에서 별도로 참조할 필요가 없습니다.* 하위 호환성을 위해 `defaultRoleUniversalIdentifier`를 명시적으로 전달하는 방식도 계속 지원되지만, 이제는 `defineApplicationRole()` 사용을 권장하며 이전 방식은 더 이상 권장되지 않습니다.* `serverVariables`는 인스턴스 범위의 구성 및 비밀(예: API 키)입니다. `applicationVariables`와 달리, 매니페스트에는 값을 선언하지 않으며, 워크스페이스 운영자가 앱 설정에서 값을 채워 넣으면 설정된 이후에만 로직 함수에 주입됩니다.+* 두 종류의 변수 모두 `isDeprecated: true`를 허용합니다. 변수를 삭제하는 대신 사용 중지할 때 사용하십시오. 키 선언을 유지하면 저장된 값이 보존되고(삭제하면 운영자가 입력한 값이 사라집니다), 변수는 여전히 주입되므로 코드에서 `process.env.NEW_API_KEY ?? process.env.API_KEY`로 폴백할 수 있습니다. 더 이상 사용되지 않는 변수는 값이 없어지면 앱 설정에서 사라지며, 앱의 구성 검사에 절대 포함되지 않습니다. 따라서 `isDeprecated`가 `isRequired`보다 우선합니다.* 앱의 **Settings** 탭에서 기본 변수 구성 섹션 대신 사용자 지정 구성 UI를 렌더링하려면, 별도의 파일에서 [`defineSettingsFrontComponent()`](/l/ko/developers/extend/apps/layout/front-components#custom-settings-component)를 사용하여 프론트 컴포넌트를 선언하세요. 앱당 하나만 허용됩니다. 시스템에서 관리하는 섹션(auto-upgrade, App URL, connections)은 항상 표시된 상태로 유지됩니다.## 변수 유형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.mdxindex 0a89d44ce58..3d4a9bbb757 100644--- 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@@ -49,7 +49,7 @@ your-app/| **내비게이션 메뉴 항목** | 사용자 정의 사이드바 항목 | [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) |-| **공유 의존성** | 앱의 프론트 컴포넌트에서 공유되며 package.json에 선언된 의존성 | [공유 의존성](/l/ko/developers/extend/apps/layout/front-components#sharing-dependencies-across-front-components) |+| **공유 의존성** | 앱의 프런트 컴포넌트에서 공유되고 package.json에 선언된 의존성 | [공유 의존성](/l/ko/developers/extend/apps/layout/front-components#sharing-dependencies-across-front-components) || **명령 메뉴 항목** | 빠른 작업 및 Cmd+K 항목 | [Command Menu Items](/l/ko/developers/extend/apps/layout/command-menu-items) |## 샌드박싱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.mdxindex d556773e2df..8ceb00f3949 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@@ -109,7 +109,7 @@ curl http://localhost:3000### Twenty를 외부 액세스에 노출-기본적으로 Twenty는 `localhost`의 포트 `3000`에서 실행됩니다. 외부 도메인 또는 IP 주소로 액세스하려면 `.env` 파일의 `SERVER_URL`을 구성해야 합니다.+기본적으로 Twenty는 `localhost`의 포트 `3000`에서 실행됩니다. UI는 브라우저 자체의 origin에서 API를 확인하므로, 컨테이너에 도달할 수 있는 어떤 호스트명에서도 로드됩니다. 하지만 여전히 `SERVER_URL`은 공개용 URL로 설정해야 합니다. 서버는 이를 생성된 링크(이메일, OAuth 콜백)와 HTTPS 감지(보안 쿠키용)에 사용합니다.#### `SERVER_URL` 이해하기@@ -229,7 +229,7 @@ crontab에 추가하세요 (`crontab -e`):1. 애플리케이션을 중지하세요:```bash-docker compose stop twenty-server twenty-front+docker compose stop server worker```2. 데이터베이스를 복원하세요: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.mdxindex 71e0687a4d4..be87c8fa5c9 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@@ -393,15 +393,19 @@ LOGIC_FUNCTION_TYPE=DISABLED # default when NODE_ENV=production배포의 경우 여기에서 추가로 설정할 내용이 없습니다.API와 통신하는 모든 브라우저 오리진을 쉼표로 구분하여 선언하세요. `SERVER_URL`-과 `FRONTEND_URL`은 이미 신뢰된 상태입니다.+과 `FRONTEND_URL`은 이미 신뢰된 상태입니다. 브라우저가 선언되지 않은 오리진에서 서버를 호출하면,+서버는 경고를 로그에 기록합니다.```bashAUTH_COOKIE_ALLOWED_ORIGINS=https://app.example.com```<Warning>-쿠키 세션을 사용하는 버전으로 업그레이드하면, 이 설정이 필수입니다. 프런트엔드는-이제 모든 요청에 자격 증명을 함께 보내고, 브라우저는 선언되지 않은 오리진에서 오는 자격 증명 포함 응답을 거부하므로, 이 값을 설정하기 전까지 앱이 로드되지 않습니다.+프런트엔드는 모든 요청에 자격 증명을 함께 보내고, 브라우저는 선언되지 않은 오리진에서 오는 자격 증명 포함 응답을 거부하므로, 이 값을 설정하기 전까지 앱이 로드되지 않습니다.</Warning>두 호스트가 서로 다른 등록 가능한 도메인(단순히 서로 다른 서브도메인이 아닌 경우)에 있다면, `AUTH_COOKIE_SAME_SITE=none`도 설정해야 하며, 이때는 HTTPS가 필요합니다.++멀티 워크스페이스가 활성화된 경우, 여기에는 모든 워크스페이스 서브도메인을 나열하지 마세요.+대신, 각 워크스페이스 호스트 이름에서 API 경로(`/graphql`, `/metadata`, `/rest`, `/auth/`,+`/client-config`, `/file`)를 백엔드로 라우팅하여 모든 워크스페이스가 동일 오리진을 유지하도록 하세요. Twenty Cloud는 이렇게 동작합니다.diff --git a/packages/twenty-docs/l/ro/developers/extend/apps/config/application.mdx b/packages/twenty-docs/l/ro/developers/extend/apps/config/application.mdxindex a0705592d26..5437625c1c8 100644--- a/packages/twenty-docs/l/ro/developers/extend/apps/config/application.mdx+++ b/packages/twenty-docs/l/ro/developers/extend/apps/config/application.mdx@@ -37,6 +37,7 @@ Notițe:* Funcțiile de pre-instalare, post-instalare și dezinstalare sunt detectate automat în timpul construirii manifestului — nu este nevoie să faceți referire la ele în `defineApplication()`.* Transmiterea explicită a `defaultRoleUniversalIdentifier` este în continuare acceptată pentru compatibilitate retroactivă, dar este considerată învechită în favoarea `defineApplicationRole()`.* `serverVariables` sunt configurări și secrete la nivel de instanță (de ex. chei API). Spre deosebire de `applicationVariables`, ele nu declară nicio valoare în manifest — operatorul spațiului de lucru le completează din setările aplicației și sunt injectate în funcțiile de logică doar după ce au fost setate.+* Ambele tipuri de variabile acceptă `isDeprecated: true`. Folosește-l pentru a retrage o variabilă în loc să o ștergi: păstrarea cheii declarate conservă valoarea stocată (ștergerea ei distruge valoarea introdusă de operator), iar variabila este în continuare injectată, astfel încât codul tău poate reveni la ea — `process.env.NEW_API_KEY ?? process.env.API_KEY`. O variabilă învechită dispare din setările aplicației odată ce nu mai are nicio valoare și nu este niciodată luată în calcul la verificarea configurației aplicației, astfel încât `isDeprecated` are prioritate față de `isRequired`.* Pentru a afișa o interfață de configurare personalizată în fila **Settings** a aplicației (în locul secțiunii implicite de configurare a variabilelor), declară un front component cu [`defineSettingsFrontComponent()`](/l/ro/developers/extend/apps/layout/front-components#custom-settings-component) într-un fișier separat. Este permis doar unul per aplicație. Secțiunile gestionate de sistem (auto-upgrade, App URL, connections) rămân întotdeauna vizibile.## Tipuri de variabilediff --git a/packages/twenty-docs/l/ro/developers/self-host/capabilities/docker-compose.mdx b/packages/twenty-docs/l/ro/developers/self-host/capabilities/docker-compose.mdxindex 31d1211761a..8367f396cbd 100644--- a/packages/twenty-docs/l/ro/developers/self-host/capabilities/docker-compose.mdx+++ b/packages/twenty-docs/l/ro/developers/self-host/capabilities/docker-compose.mdx@@ -109,7 +109,7 @@ curl http://localhost:3000### Expuneți Twenty pentru Acces Extern-Implicit, Twenty rulează pe `localhost` la portul `3000`. Pentru a-l accesa printr-un domeniu extern sau adresă IP, trebuie să configurați `SERVER_URL` în fișierul dvs. `.env`.+Implicit, Twenty rulează pe `localhost` la portul `3000`. Interfața de utilizator rezolvă API-ul din origin-ul propriu al browserului, astfel încât se încarcă de pe orice hostname care ajunge la container — dar setează în continuare `SERVER_URL` la URL-ul tău public: serverul îl folosește pentru linkuri generate (emailuri, callback-uri OAuth) și pentru a detecta HTTPS pentru cookie-uri securizate.#### Înțelegerea `SERVER_URL`@@ -229,7 +229,7 @@ Adăugați în crontab-ul dvs. (`crontab -e`):1. Opriți aplicația:```bash-docker compose stop twenty-server twenty-front+docker compose stop server worker```2. Restaurați baza de date:diff --git a/packages/twenty-docs/l/ro/developers/self-host/capabilities/setup.mdx b/packages/twenty-docs/l/ro/developers/self-host/capabilities/setup.mdxindex 3a2edfbf810..ae64ecbfa03 100644--- a/packages/twenty-docs/l/ro/developers/self-host/capabilities/setup.mdx+++ b/packages/twenty-docs/l/ro/developers/self-host/capabilities/setup.mdx@@ -393,17 +393,22 @@ Este relevant doar dacă nu lași back-end-ul să servească front-end-ul. Implenu au nevoie de nimic aici.Declară fiecare origine de browser care comunică cu API-ul, separate prin virgulă. `SERVER_URL`-și `FRONTEND_URL` sunt deja de încredere.+și `FRONTEND_URL` sunt deja de încredere. Serverul înregistrează un avertisment în jurnale atunci când un browser+îl apelează dintr-o origine nedeclarată.```bashAUTH_COOKIE_ALLOWED_ORIGINS=https://app.example.com```<Warning>-Actualizarea la o versiune cu sesiuni bazate pe cookie face ca acest lucru să fie obligatoriu. Partea de front-end-acum trimite datele de autentificare la fiecare cerere, iar browserele resping un răspuns cu date de autentificare+Partea de front-end trimite datele de autentificare la fiecare cerere, iar browserele resping un răspuns cu date de autentificareprovenit de la o origine nedeclarată, astfel încât aplicația nu se încarcă până când nu configurați această opțiune.</Warning>Dacă cele două gazde se află pe domenii înregistrabile diferite (nu doar pesubdomenii diferite), setați, de asemenea, `AUTH_COOKIE_SAME_SITE=none`, ceea ce necesită HTTPS.++Cu multi-workspace activat, nu lista fiecare subdomeniu de workspace aici.+În schimb, direcționați căile API (`/graphql`, `/metadata`, `/rest`, `/auth/`,+`/client-config`, `/file`) către back-end pe fiecare hostname de workspace, astfel încât fiecare+workspace să rămână de aceeași origine — acesta este modul în care rulează Twenty Cloud.diff --git a/packages/twenty-docs/l/tr/developers/extend/apps/config/application.mdx b/packages/twenty-docs/l/tr/developers/extend/apps/config/application.mdxindex 1bcd6a2fbbc..f116ba955de 100644--- a/packages/twenty-docs/l/tr/developers/extend/apps/config/application.mdx+++ b/packages/twenty-docs/l/tr/developers/extend/apps/config/application.mdx@@ -37,6 +37,7 @@ Notlar:* Kurulum öncesi, kurulum sonrası ve kaldırma fonksiyonları manifest derlemesi sırasında otomatik olarak algılanır — bunlara `defineApplication()` içinde referans vermeniz gerekmez.* Geriye dönük uyumluluk için `defaultRoleUniversalIdentifier` değerini açıkça geçmek hâlâ desteklenmektedir, ancak `defineApplicationRole()` lehine kullanımdan kaldırılmıştır.* `serverVariables`, API anahtarları gibi örnek düzeyindeki yapılandırmalar ve gizli bilgilerdir. `applicationVariables`'ın aksine, manifest içinde herhangi bir değer belirtmezler — çalışma alanı operatörü bunları uygulamanın ayarlarından doldurur ve yalnızca ayarlandıklarında mantık fonksiyonlarına enjekte edilirler.+* Her iki tür değişken de `isDeprecated: true` kabul eder. Bir değişkeni silmek yerine devre dışı bırakmak için kullanın: anahtarın tanımlı kalması, saklanan değeri korur (silmek, operatörün girdiği değeri yok eder) ve değişken hâlâ enjekte edilir, böylece kodunuz buna geri dönebilir — `process.env.NEW_API_KEY ?? process.env.API_KEY`. Artık kullanılmayan bir değişkenin değeri kalmadığında uygulamanın ayarlarından kaybolur ve hiçbir zaman uygulamanın yapılandırma kontrolüne dahil edilmez; bu yüzden `isDeprecated`, `isRequired` seçeneğine üstün gelir.* Uygulamanın **Ayarlar** sekmesinde (varsayılan değişken yapılandırma bölümünün yerine) özel bir yapılandırma arayüzü oluşturmak için, kendi dosyasında [`defineSettingsFrontComponent()`](/l/tr/developers/extend/apps/layout/front-components#custom-settings-component) ile bir ön bileşen tanımlayın. Her uygulama için yalnızca bir tane olabilir. Sistem tarafından yönetilen bölümler (otomatik yükseltme, App URL, bağlantılar) her zaman görünür durumda kalır.## Değişken türleridiff --git a/packages/twenty-docs/l/tr/developers/self-host/capabilities/docker-compose.mdx b/packages/twenty-docs/l/tr/developers/self-host/capabilities/docker-compose.mdxindex fc97e731226..d53cf2758ab 100644--- a/packages/twenty-docs/l/tr/developers/self-host/capabilities/docker-compose.mdx+++ b/packages/twenty-docs/l/tr/developers/self-host/capabilities/docker-compose.mdx@@ -109,7 +109,7 @@ curl http://localhost:3000### Twenty'yi Dış Erişime Açma-Varsayılan olarak, Twenty `localhost` üzerinde `3000` portunda çalışır. Harici bir alan adı veya IP adresi aracılığıyla erişim sağlamak için `.env` dosyanızda `SERVER_URL`'i yapılandırmanız gerekir.+Varsayılan olarak, Twenty `localhost` üzerinde `3000` portunda çalışır. UI, API'yi tarayıcının kendi origin'inden çözümler; bu nedenle container'a erişen herhangi bir hostname'den yüklenir — ancak yine de `SERVER_URL` değerini genel (public) URL'inize ayarlayın: sunucu bunu oluşturulan bağlantılar (e-postalar, OAuth geri aramaları) ve güvenli çerezler için HTTPS'i algılamak amacıyla kullanır.#### `SERVER_URL`'a Genel Bakış@@ -229,7 +229,7 @@ crontab'ınıza ekleyin (`crontab -e`):1. Uygulamayı durdurun:```bash-docker compose stop twenty-server twenty-front+docker compose stop server worker```2. Veritabanını geri yükleyin:diff --git a/packages/twenty-docs/l/tr/developers/self-host/capabilities/setup.mdx b/packages/twenty-docs/l/tr/developers/self-host/capabilities/setup.mdxindex 94f4cb95abe..a9e5cd121ea 100644--- a/packages/twenty-docs/l/tr/developers/self-host/capabilities/setup.mdx+++ b/packages/twenty-docs/l/tr/developers/self-host/capabilities/setup.mdx@@ -392,17 +392,21 @@ LOGIC_FUNCTION_TYPE=DISABLED # default when NODE_ENV=productionYalnızca arka ucun (back-end) ön ucu (front-end) sunmasına izin vermiyorsanız geçerlidir. Aynı kökene (same-origin) sahip dağıtımlar için burada hiçbir şeye gerek yoktur.API ile iletişim kuran her tarayıcı kökenini (origin) virgülle ayırarak belirtin. `SERVER_URL`-ve `FRONTEND_URL` zaten güvenilirdir.+ve `FRONTEND_URL` zaten güvenilirdir. Bir tarayıcı bildirilmeyen bir kökenden+çağrı yaptığında sunucu bir uyarı kaydeder.```bashAUTH_COOKIE_ALLOWED_ORIGINS=https://app.example.com```<Warning>-Tanımlama bilgisi oturumlarına sahip bir sürüme yükseltme yapmak, bunun gerekli olmasına neden olur. Ön uç-artık her istekte kimlik bilgileri gönderiyor ve tarayıcılar, bildirilmemiş bir kökenden gelen kimlik bilgileri içeren-yanıtı reddediyor; bu nedenle uygulama, bunu ayarlayana kadar yüklenemez.+Ön uç her istekte kimlik bilgileri gönderir ve tarayıcılar, bildirilmeyen bir kökenden gelen kimlik bilgileri içeren+yanıtı reddeder, bu nedenle uygulama, siz bunu ayarlayana kadar yüklenemez.</Warning>İki ana makine farklı kayıt edilebilir etki alanlarındaysa (sadece farklıalt etki alanları değilse), ayrıca HTTPS gerektiren `AUTH_COOKIE_SAME_SITE=none` değişkenini de ayarlayın.++Çoklu çalışma alanı etkinleştirildiğinde, burada her çalışma alanı alt etki alanını listelemeyin.+Bunun yerine, API yollarını (`/graphql`, `/metadata`, `/rest`, `/auth/`,+`/client-config`, `/file`) her çalışma alanı ana makine adında arka uca yönlendirin; böylece her çalışma alanı aynı kökende kalır — Twenty Cloud tam olarak böyle çalışır.